From e25f65b406ad6bff39f3a1d1c494a7305acb9c6d Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Thu, 4 May 2023 15:41:19 -0500
Subject: [PATCH 0001/1120] [TST] Make jpl units instantiated with datetimes
 consistent with mpl converters

---
 lib/matplotlib/testing/jpl_units/EpochConverter.py | 4 +---
 lib/matplotlib/tests/test_axes.py                  | 8 ++++----
 lib/matplotlib/tests/test_units.py                 | 4 ++--
 3 files changed, 7 insertions(+), 9 deletions(-)

diff --git a/lib/matplotlib/testing/jpl_units/EpochConverter.py b/lib/matplotlib/testing/jpl_units/EpochConverter.py
index f42d7b71d041..1edc2acf2b24 100644
--- a/lib/matplotlib/testing/jpl_units/EpochConverter.py
+++ b/lib/matplotlib/testing/jpl_units/EpochConverter.py
@@ -12,9 +12,7 @@ class EpochConverter(units.ConversionInterface):
     classes.
     """
 
-    # julian date reference for "Jan 1, 0001" minus 1 day because
-    # Matplotlib really wants "Jan 0, 0001"
-    jdRef = 1721425.5 - 1
+    jdRef = 1721425.5
 
     @staticmethod
     def axisinfo(unit, axis):
diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index 0d6877f1e364..5743e9ef3964 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -856,8 +856,8 @@ def test_axvspan_epoch():
     units.register()
 
     # generate some data
-    t0 = units.Epoch("ET", dt=datetime.datetime(2009, 1, 20))
-    tf = units.Epoch("ET", dt=datetime.datetime(2009, 1, 21))
+    t0 = units.Epoch("ET", dt=datetime.datetime(2009, 1, 21))
+    tf = units.Epoch("ET", dt=datetime.datetime(2009, 1, 22))
     dt = units.Duration("ET", units.day.convert("sec"))
 
     ax = plt.gca()
@@ -871,8 +871,8 @@ def test_axhspan_epoch():
     units.register()
 
     # generate some data
-    t0 = units.Epoch("ET", dt=datetime.datetime(2009, 1, 20))
-    tf = units.Epoch("ET", dt=datetime.datetime(2009, 1, 21))
+    t0 = units.Epoch("ET", dt=datetime.datetime(2009, 1, 21))
+    tf = units.Epoch("ET", dt=datetime.datetime(2009, 1, 22))
     dt = units.Duration("ET", units.day.convert("sec"))
 
     ax = plt.gca()
diff --git a/lib/matplotlib/tests/test_units.py b/lib/matplotlib/tests/test_units.py
index d3b8c5a71643..c1fad6476648 100644
--- a/lib/matplotlib/tests/test_units.py
+++ b/lib/matplotlib/tests/test_units.py
@@ -134,7 +134,7 @@ def test_jpl_bar_units():
     day = units.Duration("ET", 24.0 * 60.0 * 60.0)
     x = [0 * units.km, 1 * units.km, 2 * units.km]
     w = [1 * day, 2 * day, 3 * day]
-    b = units.Epoch("ET", dt=datetime(2009, 4, 25))
+    b = units.Epoch("ET", dt=datetime(2009, 4, 26))
     fig, ax = plt.subplots()
     ax.bar(x, w, bottom=b)
     ax.set_ylim([b - 1 * day, b + w[-1] + (1.001) * day])
@@ -149,7 +149,7 @@ def test_jpl_barh_units():
     day = units.Duration("ET", 24.0 * 60.0 * 60.0)
     x = [0 * units.km, 1 * units.km, 2 * units.km]
     w = [1 * day, 2 * day, 3 * day]
-    b = units.Epoch("ET", dt=datetime(2009, 4, 25))
+    b = units.Epoch("ET", dt=datetime(2009, 4, 26))
 
     fig, ax = plt.subplots()
     ax.barh(x, w, left=b)

From 231704fc6d70c8a57d23aa3aadcc1c7bdcf88726 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Thu, 4 May 2023 16:06:45 -0500
Subject: [PATCH 0002/1120] [TST] Add unit test for consistency of datetime
 units between mpl.dates and jpl_units

---
 lib/matplotlib/tests/test_units.py | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/lib/matplotlib/tests/test_units.py b/lib/matplotlib/tests/test_units.py
index c1fad6476648..fa8e5709db64 100644
--- a/lib/matplotlib/tests/test_units.py
+++ b/lib/matplotlib/tests/test_units.py
@@ -156,6 +156,17 @@ def test_jpl_barh_units():
     ax.set_xlim([b - 1 * day, b + w[-1] + (1.001) * day])
 
 
+def test_jpl_datetime_units_consistent():
+    import matplotlib.testing.jpl_units as units
+    units.register()
+
+    dt = datetime(2009, 4, 26)
+    jpl = units.Epoch("ET", dt=dt)
+    dt_conv = munits.registry.get_converter(dt).convert(dt, None, None)
+    jpl_conv = munits.registry.get_converter(jpl).convert(jpl, None, None)
+    assert dt_conv == jpl_conv
+
+
 def test_empty_arrays():
     # Check that plotting an empty array with a dtype works
     plt.scatter(np.array([], dtype='datetime64[ns]'), np.array([]))

From 8d6519c32cede57e0f43bd8a7d1cdff378e93141 Mon Sep 17 00:00:00 2001
From: patel-zeel <patel_zeel@iitgn.ac.in>
Date: Sun, 14 May 2023 20:24:16 +0530
Subject: [PATCH 0003/1120] update _unpack_to_numpy to handle JAX and PyTorch
 arrays

---
 lib/matplotlib/cbook.py | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/cbook.py b/lib/matplotlib/cbook.py
index ae78eab8318d..1bbe04150a3b 100644
--- a/lib/matplotlib/cbook.py
+++ b/lib/matplotlib/cbook.py
@@ -2237,7 +2237,10 @@ def _picklable_class_constructor(mixin_class, fmt, attr_name, base_class):
 def _unpack_to_numpy(x):
     """Internal helper to extract data from e.g. pandas and xarray objects."""
     if isinstance(x, np.ndarray):
-        # If numpy, return directly
+        # If numpy array, return directly
+        return x
+    if isinstance(x, np.generic):
+        # If numpy scalar, return directly
         return x
     if hasattr(x, 'to_numpy'):
         # Assume that any to_numpy() method actually returns a numpy array
@@ -2248,6 +2251,12 @@ def _unpack_to_numpy(x):
         # so in this case we do not want to return a function
         if isinstance(xtmp, np.ndarray):
             return xtmp
+    if hasattr(x, '__array__'):
+        # Assume that any to __array__() method returns a numpy array (e.g. TensorFlow, JAX or PyTorch arrays)
+        x = x.__array__()
+        # Anything that doesn't return ndarray via __array__() method will be filtered by the following check
+        if isinstance(x, np.ndarray):
+            return x
     return x
 
 

From 7b992fab40dfebb263af6bd1b3f82116bda8ee8e Mon Sep 17 00:00:00 2001
From: patel-zeel <patel_zeel@iitgn.ac.in>
Date: Sun, 14 May 2023 20:50:35 +0530
Subject: [PATCH 0004/1120] update _unpack_to_numpy to handle JAX and PyTorch
 arrays

---
 lib/matplotlib/cbook.py | 398 +++++++++++++++++++++++-----------------
 1 file changed, 230 insertions(+), 168 deletions(-)

diff --git a/lib/matplotlib/cbook.py b/lib/matplotlib/cbook.py
index ae78eab8318d..d214e328ae73 100644
--- a/lib/matplotlib/cbook.py
+++ b/lib/matplotlib/cbook.py
@@ -52,6 +52,7 @@ def _get_running_interactive_framework():
     if Gtk:
         if Gtk.MAJOR_VERSION == 4:
             from gi.repository import GLib
+
             if GLib.main_depth():
                 return "gtk4"
         if Gtk.MAJOR_VERSION == 3 and Gtk.main_level():
@@ -187,9 +188,14 @@ def __getstate__(self):
             **vars(self),
             # In general, callbacks may not be pickled, so we just drop them,
             # unless directed otherwise by self._pickled_cids.
-            "callbacks": {s: {cid: proxy() for cid, proxy in d.items()
-                              if cid in self._pickled_cids}
-                          for s, d in self.callbacks.items()},
+            "callbacks": {
+                s: {
+                    cid: proxy()
+                    for cid, proxy in d.items()
+                    if cid in self._pickled_cids
+                }
+                for s, d in self.callbacks.items()
+            },
             # It is simpler to reconstruct this from callbacks in __setstate__.
             "_func_cid_map": None,
         }
@@ -197,12 +203,16 @@ def __getstate__(self):
     def __setstate__(self, state):
         vars(self).update(state)
         self.callbacks = {
-            s: {cid: _weak_or_strong_ref(func, self._remove_proxy)
-                for cid, func in d.items()}
-            for s, d in self.callbacks.items()}
+            s: {
+                cid: _weak_or_strong_ref(func, self._remove_proxy)
+                for cid, func in d.items()
+            }
+            for s, d in self.callbacks.items()
+        }
         self._func_cid_map = {
             s: {proxy: cid for cid, proxy in d.items()}
-            for s, d in self.callbacks.items()}
+            for s, d in self.callbacks.items()
+        }
 
     def connect(self, signal, func):
         """Register *func* to be called when signal *signal* is generated."""
@@ -357,8 +367,8 @@ def __repr__(self):
 
 
 def _local_over_kwdict(
-        local_var, kwargs, *keys,
-        warning_cls=_api.MatplotlibDeprecationWarning):
+    local_var, kwargs, *keys, warning_cls=_api.MatplotlibDeprecationWarning
+):
     out = local_var
     for key in keys:
         kwarg_val = kwargs.pop(key, None)
@@ -366,8 +376,9 @@ def _local_over_kwdict(
             if out is None:
                 out = kwarg_val
             else:
-                _api.warn_external(f'"{key}" keyword argument will be ignored',
-                                   warning_cls)
+                _api.warn_external(
+                    f'"{key}" keyword argument will be ignored', warning_cls
+                )
     return out
 
 
@@ -380,15 +391,15 @@ def strip_math(s):
     if len(s) >= 2 and s[0] == s[-1] == "$":
         s = s[1:-1]
         for tex, plain in [
-                (r"\times", "x"),  # Specifically for Formatter support.
-                (r"\mathdefault", ""),
-                (r"\rm", ""),
-                (r"\cal", ""),
-                (r"\tt", ""),
-                (r"\it", ""),
-                ("\\", ""),
-                ("{", ""),
-                ("}", ""),
+            (r"\times", "x"),  # Specifically for Formatter support.
+            (r"\mathdefault", ""),
+            (r"\rm", ""),
+            (r"\cal", ""),
+            (r"\tt", ""),
+            (r"\it", ""),
+            ("\\", ""),
+            ("{", ""),
+            ("}", ""),
         ]:
             s = s.replace(tex, plain)
     return s
@@ -399,7 +410,7 @@ def _strip_comment(s):
     pos = 0
     while True:
         quote_pos = s.find('"', pos)
-        hash_pos = s.find('#', pos)
+        hash_pos = s.find("#", pos)
         if quote_pos < 0:
             without_comment = s if hash_pos < 0 else s[:hash_pos]
             return without_comment.strip()
@@ -410,13 +421,14 @@ def _strip_comment(s):
             if closing_quote_pos < 0:
                 raise ValueError(
                     f"Missing closing quote in: {s!r}. If you need a double-"
-                    'quote inside a string, use escaping: e.g. "the \" char"')
+                    'quote inside a string, use escaping: e.g. "the " char"'
+                )
             pos = closing_quote_pos + 1  # behind closing quote
 
 
 def is_writable_file_like(obj):
     """Return whether *obj* looks like a file object with a *write* method."""
-    return callable(getattr(obj, 'write', None))
+    return callable(getattr(obj, "write", None))
 
 
 def file_requires_unicode(x):
@@ -425,14 +437,14 @@ def file_requires_unicode(x):
     written to it.
     """
     try:
-        x.write(b'')
+        x.write(b"")
     except TypeError:
         return True
     else:
         return False
 
 
-def to_filehandle(fname, flag='r', return_opened=False, encoding=None):
+def to_filehandle(fname, flag="r", return_opened=False, encoding=None):
     """
     Convert a path to an open file handle or pass-through a file-like object.
 
@@ -464,21 +476,22 @@ def to_filehandle(fname, flag='r', return_opened=False, encoding=None):
     if isinstance(fname, os.PathLike):
         fname = os.fspath(fname)
     if isinstance(fname, str):
-        if fname.endswith('.gz'):
+        if fname.endswith(".gz"):
             fh = gzip.open(fname, flag)
-        elif fname.endswith('.bz2'):
+        elif fname.endswith(".bz2"):
             # python may not be compiled with bz2 support,
             # bury import until we need it
             import bz2
+
             fh = bz2.BZ2File(fname, flag)
         else:
             fh = open(fname, flag, encoding=encoding)
         opened = True
-    elif hasattr(fname, 'seek'):
+    elif hasattr(fname, "seek"):
         fh = fname
         opened = False
     else:
-        raise ValueError('fname must be a PathLike or file handle')
+        raise ValueError("fname must be a PathLike or file handle")
     if return_opened:
         return fh, opened
     return fh
@@ -496,7 +509,8 @@ def is_scalar_or_string(val):
 
 
 @_api.delete_parameter(
-    "3.8", "np_load", alternative="open(get_sample_data(..., asfileobj=False))")
+    "3.8", "np_load", alternative="open(get_sample_data(..., asfileobj=False))"
+)
 def get_sample_data(fname, asfileobj=True, *, np_load=True):
     """
     Return a sample data file.  *fname* is a path relative to the
@@ -510,20 +524,20 @@ def get_sample_data(fname, asfileobj=True, *, np_load=True):
     filename ends with .npy or .npz, and *asfileobj* is `True`, the file is
     loaded with `numpy.load`.
     """
-    path = _get_data_path('sample_data', fname)
+    path = _get_data_path("sample_data", fname)
     if asfileobj:
         suffix = path.suffix.lower()
-        if suffix == '.gz':
+        if suffix == ".gz":
             return gzip.open(path)
-        elif suffix in ['.npy', '.npz']:
+        elif suffix in [".npy", ".npz"]:
             if np_load:
                 return np.load(path)
             else:
-                return path.open('rb')
-        elif suffix in ['.csv', '.xrc', '.txt']:
-            return path.open('r')
+                return path.open("rb")
+        elif suffix in [".csv", ".xrc", ".txt"]:
+            return path.open("r")
         else:
-            return path.open('rb')
+            return path.open("rb")
     else:
         return str(path)
 
@@ -600,7 +614,7 @@ def push(self, o):
 
         *o* is returned.
         """
-        self._elements = self._elements[:self._pos + 1] + [o]
+        self._elements = self._elements[: self._pos + 1] + [o]
         self._pos = len(self._elements) - 1
         return self()
 
@@ -634,7 +648,7 @@ def bubble(self, o):
             If *o* is not in the stack.
         """
         if o not in self._elements:
-            raise ValueError('Given element not contained in the stack')
+            raise ValueError("Given element not contained in the stack")
         old_elements = self._elements.copy()
         self.clear()
         top_elements = []
@@ -657,7 +671,7 @@ def remove(self, o):
             If *o* is not in the stack.
         """
         if o not in self._elements:
-            raise ValueError('Given element not contained in the stack')
+            raise ValueError("Given element not contained in the stack")
         old_elements = self._elements.copy()
         self.clear()
         for elem in old_elements:
@@ -670,7 +684,7 @@ def safe_masked_invalid(x, copy=False):
     if not x.dtype.isnative:
         # If we have already made a copy, do the byteswap in place, else make a
         # copy with the byte order swapped.
-        x = x.byteswap(inplace=copy).newbyteorder('N')  # Swap to native order.
+        x = x.byteswap(inplace=copy).newbyteorder("N")  # Swap to native order.
     try:
         xm = np.ma.masked_invalid(x, copy=False)
         xm.shrink_mask()
@@ -784,7 +798,8 @@ class Grouper:
 
     def __init__(self, init=()):
         self._mapping = weakref.WeakKeyDictionary(
-            {x: weakref.WeakSet([x]) for x in init})
+            {x: weakref.WeakSet([x]) for x in init}
+        )
 
     def __getstate__(self):
         return {
@@ -797,7 +812,8 @@ def __setstate__(self, state):
         vars(self).update(state)
         # Convert strong refs to weak ones.
         self._mapping = weakref.WeakKeyDictionary(
-            {k: weakref.WeakSet(v) for k, v in self._mapping.items()})
+            {k: weakref.WeakSet(v) for k, v in self._mapping.items()}
+        )
 
     def __contains__(self, item):
         return item in self._mapping
@@ -824,7 +840,7 @@ def join(self, a, *args):
 
     def joined(self, a, b):
         """Return whether *a* and *b* are members of the same set."""
-        return (self._mapping.get(a, object()) is self._mapping.get(b))
+        return self._mapping.get(a, object()) is self._mapping.get(b)
 
     def remove(self, a):
         set_a = self._mapping.pop(a, None)
@@ -850,11 +866,20 @@ def get_siblings(self, a):
 class GrouperView:
     """Immutable view over a `.Grouper`."""
 
-    def __init__(self, grouper): self._grouper = grouper
-    def __contains__(self, item): return item in self._grouper
-    def __iter__(self): return iter(self._grouper)
-    def joined(self, a, b): return self._grouper.joined(a, b)
-    def get_siblings(self, a): return self._grouper.get_siblings(a)
+    def __init__(self, grouper):
+        self._grouper = grouper
+
+    def __contains__(self, item):
+        return item in self._grouper
+
+    def __iter__(self):
+        return iter(self._grouper)
+
+    def joined(self, a, b):
+        return self._grouper.joined(a, b)
+
+    def get_siblings(self, a):
+        return self._grouper.get_siblings(a)
 
 
 def simple_linear_interpolation(a, steps):
@@ -877,8 +902,9 @@ def simple_linear_interpolation(a, steps):
     fps = a.reshape((len(a), -1))
     xp = np.arange(len(a)) * steps
     x = np.arange((len(a) - 1) * steps + 1)
-    return (np.column_stack([np.interp(x, xp, fp) for fp in fps.T])
-            .reshape((len(x),) + a.shape[1:]))
+    return np.column_stack([np.interp(x, xp, fp) for fp in fps.T]).reshape(
+        (len(x),) + a.shape[1:]
+    )
 
 
 def delete_masked_points(*args):
@@ -996,7 +1022,7 @@ def _combine_masks(*args):
     nrecs = len(args[0])
     margs = []  # Output args; some may be modified.
     seqlist = [False] * len(args)  # Flags: True if output will be masked.
-    masks = []    # List of masks.
+    masks = []  # List of masks.
     for i, x in enumerate(args):
         if is_scalar_or_string(x) or len(x) != nrecs:
             margs.append(x)  # Leave it unmodified.
@@ -1023,8 +1049,7 @@ def _combine_masks(*args):
     return margs
 
 
-def boxplot_stats(X, whis=1.5, bootstrap=None, labels=None,
-                  autorange=False):
+def boxplot_stats(X, whis=1.5, bootstrap=None, labels=None, autorange=False):
     r"""
     Return a list of dictionaries of statistics used to draw a series of box
     and whisker plots using `~.Axes.bxp`.
@@ -1123,7 +1148,6 @@ def _compute_conf_interval(data, med, iqr, bootstrap):
             notch_min = CI[0]
             notch_max = CI[1]
         else:
-
             N = len(data)
             notch_min = med - 1.57 * iqr / np.sqrt(N)
             notch_max = med + 1.57 * iqr / np.sqrt(N)
@@ -1144,11 +1168,10 @@ def _compute_conf_interval(data, med, iqr, bootstrap):
 
     input_whis = whis
     for ii, (x, label) in enumerate(zip(X, labels)):
-
         # empty dict
         stats = {}
         if label is not None:
-            stats['label'] = label
+            stats["label"] = label
 
         # restore whis to the input values in case it got changed in the loop
         whis = input_whis
@@ -1158,74 +1181,76 @@ def _compute_conf_interval(data, med, iqr, bootstrap):
 
         # if empty, bail
         if len(x) == 0:
-            stats['fliers'] = np.array([])
-            stats['mean'] = np.nan
-            stats['med'] = np.nan
-            stats['q1'] = np.nan
-            stats['q3'] = np.nan
-            stats['iqr'] = np.nan
-            stats['cilo'] = np.nan
-            stats['cihi'] = np.nan
-            stats['whislo'] = np.nan
-            stats['whishi'] = np.nan
+            stats["fliers"] = np.array([])
+            stats["mean"] = np.nan
+            stats["med"] = np.nan
+            stats["q1"] = np.nan
+            stats["q3"] = np.nan
+            stats["iqr"] = np.nan
+            stats["cilo"] = np.nan
+            stats["cihi"] = np.nan
+            stats["whislo"] = np.nan
+            stats["whishi"] = np.nan
             continue
 
         # up-convert to an array, just to be safe
         x = np.asarray(x)
 
         # arithmetic mean
-        stats['mean'] = np.mean(x)
+        stats["mean"] = np.mean(x)
 
         # medians and quartiles
         q1, med, q3 = np.percentile(x, [25, 50, 75])
 
         # interquartile range
-        stats['iqr'] = q3 - q1
-        if stats['iqr'] == 0 and autorange:
+        stats["iqr"] = q3 - q1
+        if stats["iqr"] == 0 and autorange:
             whis = (0, 100)
 
         # conf. interval around median
-        stats['cilo'], stats['cihi'] = _compute_conf_interval(
-            x, med, stats['iqr'], bootstrap
+        stats["cilo"], stats["cihi"] = _compute_conf_interval(
+            x, med, stats["iqr"], bootstrap
         )
 
         # lowest/highest non-outliers
         if np.iterable(whis) and not isinstance(whis, str):
             loval, hival = np.percentile(x, whis)
         elif np.isreal(whis):
-            loval = q1 - whis * stats['iqr']
-            hival = q3 + whis * stats['iqr']
+            loval = q1 - whis * stats["iqr"]
+            hival = q3 + whis * stats["iqr"]
         else:
-            raise ValueError('whis must be a float or list of percentiles')
+            raise ValueError("whis must be a float or list of percentiles")
 
         # get high extreme
         wiskhi = x[x <= hival]
         if len(wiskhi) == 0 or np.max(wiskhi) < q3:
-            stats['whishi'] = q3
+            stats["whishi"] = q3
         else:
-            stats['whishi'] = np.max(wiskhi)
+            stats["whishi"] = np.max(wiskhi)
 
         # get low extreme
         wisklo = x[x >= loval]
         if len(wisklo) == 0 or np.min(wisklo) > q1:
-            stats['whislo'] = q1
+            stats["whislo"] = q1
         else:
-            stats['whislo'] = np.min(wisklo)
+            stats["whislo"] = np.min(wisklo)
 
         # compute a single array of outliers
-        stats['fliers'] = np.concatenate([
-            x[x < stats['whislo']],
-            x[x > stats['whishi']],
-        ])
+        stats["fliers"] = np.concatenate(
+            [
+                x[x < stats["whislo"]],
+                x[x > stats["whishi"]],
+            ]
+        )
 
         # add in the remaining stats
-        stats['q1'], stats['med'], stats['q3'] = q1, med, q3
+        stats["q1"], stats["med"], stats["q3"] = q1, med, q3
 
     return bxpstats
 
 
 #: Maps short codes for line style to their full name used by backends.
-ls_mapper = {'-': 'solid', '--': 'dashed', '-.': 'dashdot', ':': 'dotted'}
+ls_mapper = {"-": "solid", "--": "dashed", "-.": "dashdot", ":": "dotted"}
 #: Maps full names for line styles used by backends to their short codes.
 ls_mapper_r = {v: k for k, v in ls_mapper.items()}
 
@@ -1241,7 +1266,7 @@ def contiguous_regions(mask):
         return []
 
     # Find the indices of region changes, and correct offset
-    idx, = np.nonzero(mask[:-1] != mask[1:])
+    (idx,) = np.nonzero(mask[:-1] != mask[1:])
     idx += 1
 
     # List operations are faster for moderately sized arrays
@@ -1264,8 +1289,8 @@ def is_math_text(s):
     non-escaped dollar signs.
     """
     s = str(s)
-    dollar_count = s.count(r'$') - s.count(r'\$')
-    even_dollars = (dollar_count > 0 and dollar_count % 2 == 0)
+    dollar_count = s.count(r"$") - s.count(r"\$")
+    even_dollars = dollar_count > 0 and dollar_count % 2 == 0
     return even_dollars
 
 
@@ -1274,7 +1299,7 @@ def _to_unmasked_float_array(x):
     Convert a sequence to a float array; if input was a masked array, masked
     values are converted to nans.
     """
-    if hasattr(x, 'mask'):
+    if hasattr(x, "mask"):
         return np.ma.asarray(x, float).filled(np.nan)
     else:
         return np.asarray(x, float)
@@ -1287,9 +1312,7 @@ def _check_1d(x):
     # plot requires `shape` and `ndim`.  If passed an
     # object that doesn't provide them, then force to numpy array.
     # Note this will strip unit information.
-    if (not hasattr(x, 'shape') or
-            not hasattr(x, 'ndim') or
-            len(x.shape) < 1):
+    if not hasattr(x, "shape") or not hasattr(x, "ndim") or len(x.shape) < 1:
         return np.atleast_1d(x)
     else:
         return x
@@ -1323,7 +1346,7 @@ def _reshape_2D(X, name):
             # 2D array, or 1D array of iterables: flatten them first.
             return [np.reshape(x, -1) for x in X]
         else:
-            raise ValueError(f'{name} must have 2 or fewer dimensions')
+            raise ValueError(f"{name} must have 2 or fewer dimensions")
 
     # Iterate over list of iterables.
     if len(X) == 0:
@@ -1344,7 +1367,7 @@ def _reshape_2D(X, name):
         xi = np.asanyarray(xi)
         nd = np.ndim(xi)
         if nd > 1:
-            raise ValueError(f'{name} must have 2 or fewer dimensions')
+            raise ValueError(f"{name} must have 2 or fewer dimensions")
         result.append(xi.reshape(-1))
 
     if is_1d:
@@ -1422,11 +1445,13 @@ def violin_stats(X, method, points=100, quantiles=None):
 
     # quantiles should have the same size as dataset
     if len(X) != len(quantiles):
-        raise ValueError("List of violinplot statistics and quantiles values"
-                         " must have the same length")
+        raise ValueError(
+            "List of violinplot statistics and quantiles values"
+            " must have the same length"
+        )
 
     # Zip x and quantiles
-    for (x, q) in zip(X, quantiles):
+    for x, q in zip(X, quantiles):
         # Dictionary of results for this distribution
         stats = {}
 
@@ -1437,15 +1462,15 @@ def violin_stats(X, method, points=100, quantiles=None):
 
         # Evaluate the kernel density estimate
         coords = np.linspace(min_val, max_val, points)
-        stats['vals'] = method(x, coords)
-        stats['coords'] = coords
+        stats["vals"] = method(x, coords)
+        stats["coords"] = coords
 
         # Store additional statistics for this distribution
-        stats['mean'] = np.mean(x)
-        stats['median'] = np.median(x)
-        stats['min'] = min_val
-        stats['max'] = max_val
-        stats['quantiles'] = np.atleast_1d(quantile_val)
+        stats["mean"] = np.mean(x)
+        stats["median"] = np.median(x)
+        stats["min"] = min_val
+        stats["max"] = max_val
+        stats["quantiles"] = np.atleast_1d(quantile_val)
 
         # Append to output
         vpstats.append(stats)
@@ -1565,11 +1590,13 @@ def pts_to_midstep(x, *args):
     return steps
 
 
-STEP_LOOKUP_MAP = {'default': lambda x, y: (x, y),
-                   'steps': pts_to_prestep,
-                   'steps-pre': pts_to_prestep,
-                   'steps-post': pts_to_poststep,
-                   'steps-mid': pts_to_midstep}
+STEP_LOOKUP_MAP = {
+    "default": lambda x, y: (x, y),
+    "steps": pts_to_prestep,
+    "steps-pre": pts_to_prestep,
+    "steps-post": pts_to_poststep,
+    "steps-mid": pts_to_midstep,
+}
 
 
 def index_of(y):
@@ -1604,7 +1631,7 @@ def index_of(y):
         pass
     else:
         return np.arange(y.shape[0], dtype=float), y
-    raise ValueError('Input could not be cast to an at-least-1D NumPy array')
+    raise ValueError("Input could not be cast to an at-least-1D NumPy array")
 
 
 def safe_first_element(obj):
@@ -1627,6 +1654,7 @@ def _safe_first_finite(obj, *, skip_nonfinite=True):
     This is a type-independent way of obtaining the first finite element, supporting
     both index access and the iterator protocol.
     """
+
     def safe_isfinite(val):
         if val is None:
             return False
@@ -1636,6 +1664,7 @@ def safe_isfinite(val):
             # This is something that NumPy cannot make heads or tails of,
             # assume "finite"
             return True
+
     if skip_nonfinite is False:
         if isinstance(obj, collections.abc.Iterator):
             # needed to accept `array.flat` as input.
@@ -1647,15 +1676,13 @@ def safe_isfinite(val):
                 return obj[0]
             except TypeError:
                 pass
-            raise RuntimeError("matplotlib does not support generators "
-                               "as input")
+            raise RuntimeError("matplotlib does not support generators " "as input")
         return next(iter(obj))
     elif isinstance(obj, np.flatiter):
         # TODO do the finite filtering on this
         return obj[0]
     elif isinstance(obj, collections.abc.Iterator):
-        raise RuntimeError("matplotlib does not "
-                           "support generators as input")
+        raise RuntimeError("matplotlib does not " "support generators as input")
     else:
         return next((val for val in obj if safe_isfinite(val)), safe_first_element(obj))
 
@@ -1664,8 +1691,7 @@ def sanitize_sequence(data):
     """
     Convert dictview objects to list. Other inputs are returned unchanged.
     """
-    return (list(data) if isinstance(data, collections.abc.MappingView)
-            else data)
+    return list(data) if isinstance(data, collections.abc.MappingView) else data
 
 
 def normalize_kwargs(kw, alias_mapping=None):
@@ -1703,21 +1729,28 @@ def normalize_kwargs(kw, alias_mapping=None):
     # deal with default value of alias_mapping
     if alias_mapping is None:
         alias_mapping = dict()
-    elif (isinstance(alias_mapping, type) and issubclass(alias_mapping, Artist)
-          or isinstance(alias_mapping, Artist)):
+    elif (
+        isinstance(alias_mapping, type)
+        and issubclass(alias_mapping, Artist)
+        or isinstance(alias_mapping, Artist)
+    ):
         alias_mapping = getattr(alias_mapping, "_alias_map", {})
 
-    to_canonical = {alias: canonical
-                    for canonical, alias_list in alias_mapping.items()
-                    for alias in alias_list}
+    to_canonical = {
+        alias: canonical
+        for canonical, alias_list in alias_mapping.items()
+        for alias in alias_list
+    }
     canonical_to_seen = {}
     ret = {}  # output dictionary
 
     for k, v in kw.items():
         canonical = to_canonical.get(k, k)
         if canonical in canonical_to_seen:
-            raise TypeError(f"Got both {canonical_to_seen[canonical]!r} and "
-                            f"{k!r}, which are aliases of one another")
+            raise TypeError(
+                f"Got both {canonical_to_seen[canonical]!r} and "
+                f"{k!r}, which are aliases of one another"
+            )
         canonical_to_seen[canonical] = k
         ret[canonical] = v
 
@@ -1751,12 +1784,15 @@ def _lock_path(path):
         except FileExistsError:
             time.sleep(sleeptime)
     else:
-        raise TimeoutError("""\
+        raise TimeoutError(
+            """\
 Lock error: Matplotlib failed to acquire the following lock file:
     {}
 This maybe due to another process holding this lock file.  If you are sure no
 other Matplotlib process is running, remove this file and try again.""".format(
-            lock_path))
+                lock_path
+            )
+        )
     try:
         yield
     finally:
@@ -1764,8 +1800,8 @@ def _lock_path(path):
 
 
 def _topmost_artist(
-        artists,
-        _cached_max=functools.partial(max, key=operator.attrgetter("zorder"))):
+    artists, _cached_max=functools.partial(max, key=operator.attrgetter("zorder"))
+):
     """
     Get the topmost artist of a list.
 
@@ -1827,14 +1863,16 @@ def _array_perimeter(arr):
     """
     # note we use Python's half-open ranges to avoid repeating
     # the corners
-    forward = np.s_[0:-1]      # [0 ... -1)
+    forward = np.s_[0:-1]  # [0 ... -1)
     backward = np.s_[-1:0:-1]  # [-1 ... 0)
-    return np.concatenate((
-        arr[0, forward],
-        arr[forward, -1],
-        arr[-1, backward],
-        arr[backward, 0],
-    ))
+    return np.concatenate(
+        (
+            arr[0, forward],
+            arr[forward, -1],
+            arr[-1, backward],
+            arr[backward, 0],
+        )
+    )
 
 
 def _unfold(arr, axis, size, step):
@@ -1881,10 +1919,9 @@ def _unfold(arr, axis, size, step):
     new_strides = [*arr.strides, arr.strides[axis]]
     new_shape[axis] = (new_shape[axis] - size) // step + 1
     new_strides[axis] = new_strides[axis] * step
-    return np.lib.stride_tricks.as_strided(arr,
-                                           shape=new_shape,
-                                           strides=new_strides,
-                                           writeable=False)
+    return np.lib.stride_tricks.as_strided(
+        arr, shape=new_shape, strides=new_strides, writeable=False
+    )
 
 
 def _array_patch_perimeters(x, rstride, cstride):
@@ -1932,8 +1969,9 @@ def _array_patch_perimeters(x, rstride, cstride):
     bottom = _unfold(x[rstride::rstride, 1:], 1, cstride, cstride)[..., ::-1]
     right = _unfold(x[:-1, cstride::cstride], 0, rstride, rstride)
     left = _unfold(x[1:, :-1:cstride], 0, rstride, rstride)[..., ::-1]
-    return (np.concatenate((top, right, bottom, left), axis=2)
-              .reshape(-1, 2 * (rstride + cstride)))
+    return np.concatenate((top, right, bottom, left), axis=2).reshape(
+        -1, 2 * (rstride + cstride)
+    )
 
 
 @contextlib.contextmanager
@@ -2010,16 +2048,16 @@ def _premultiplied_argb32_to_unmultiplied_rgba8888(buf):
     Convert a premultiplied ARGB32 buffer to an unmultiplied RGBA8888 buffer.
     """
     rgba = np.take(  # .take() ensures C-contiguity of the result.
-        buf,
-        [2, 1, 0, 3] if sys.byteorder == "little" else [1, 2, 3, 0], axis=2)
+        buf, [2, 1, 0, 3] if sys.byteorder == "little" else [1, 2, 3, 0], axis=2
+    )
     rgb = rgba[..., :-1]
     alpha = rgba[..., -1]
     # Un-premultiply alpha.  The formula is the same as in cairo-png.c.
     mask = alpha != 0
     for channel in np.rollaxis(rgb, -1):
-        channel[mask] = (
-            (channel[mask].astype(int) * 255 + alpha[mask] // 2)
-            // alpha[mask])
+        channel[mask] = (channel[mask].astype(int) * 255 + alpha[mask] // 2) // alpha[
+            mask
+        ]
     return rgba
 
 
@@ -2038,8 +2076,8 @@ def _unmultiplied_rgba8888_to_premultiplied_argb32(rgba8888):
     # Only bother premultiplying when the alpha channel is not fully opaque,
     # as the cost is not negligible.  The unsafe cast is needed to do the
     # multiplication in-place in an integer buffer.
-    if alpha8.min() != 0xff:
-        np.multiply(rgb24, alpha8 / 0xff, out=rgb24, casting="unsafe")
+    if alpha8.min() != 0xFF:
+        np.multiply(rgb24, alpha8 / 0xFF, out=rgb24, casting="unsafe")
     return argb32
 
 
@@ -2051,8 +2089,8 @@ def _get_nonzero_slices(buf):
     that encloses all non-zero entries in *buf*.  If *buf* is fully zero, then
     ``(slice(0, 0), slice(0, 0))`` is returned.
     """
-    x_nz, = buf.any(axis=0).nonzero()
-    y_nz, = buf.any(axis=1).nonzero()
+    (x_nz,) = buf.any(axis=0).nonzero()
+    (y_nz,) = buf.any(axis=1).nonzero()
     if len(x_nz) and len(y_nz):
         l, r = x_nz[[0, -1]]
         b, t = y_nz[[0, -1]]
@@ -2063,8 +2101,11 @@ def _get_nonzero_slices(buf):
 
 def _pformat_subprocess(command):
     """Pretty-format a subprocess command for printing/logging purposes."""
-    return (command if isinstance(command, str)
-            else " ".join(shlex.quote(os.fspath(arg)) for arg in command))
+    return (
+        command
+        if isinstance(command, str)
+        else " ".join(shlex.quote(os.fspath(arg)) for arg in command)
+    )
 
 
 def _check_and_log_subprocess(command, logger, **kwargs):
@@ -2077,7 +2118,7 @@ def _check_and_log_subprocess(command, logger, **kwargs):
     Regardless of the return code, the command is logged at DEBUG level on
     *logger*.  In case of success, the output is likewise logged.
     """
-    logger.debug('%s', _pformat_subprocess(command))
+    logger.debug("%s", _pformat_subprocess(command))
     proc = subprocess.run(command, capture_output=True, **kwargs)
     if proc.returncode:
         stdout = proc.stdout
@@ -2092,7 +2133,8 @@ def _check_and_log_subprocess(command, logger, **kwargs):
             f"failed and generated the following output:\n"
             f"{stdout}\n"
             f"and the following error:\n"
-            f"{stderr}")
+            f"{stderr}"
+        )
     if proc.stdout:
         logger.debug("stdout:\n%s", proc.stdout)
     if proc.stderr:
@@ -2105,8 +2147,11 @@ def _backend_module_name(name):
     Convert a backend name (either a standard backend -- "Agg", "TkAgg", ... --
     or a custom backend -- "module://...") to the corresponding module name).
     """
-    return (name[9:] if name.startswith("module://")
-            else f"matplotlib.backends.backend_{name.lower()}")
+    return (
+        name[9:]
+        if name.startswith("module://")
+        else f"matplotlib.backends.backend_{name.lower()}"
+    )
 
 
 def _setup_new_guiapp():
@@ -2119,8 +2164,7 @@ def _setup_new_guiapp():
     try:
         _c_internal_utils.Win32_GetCurrentProcessExplicitAppUserModelID()
     except OSError:
-        _c_internal_utils.Win32_SetCurrentProcessExplicitAppUserModelID(
-            "matplotlib")
+        _c_internal_utils.Win32_SetCurrentProcessExplicitAppUserModelID("matplotlib")
 
 
 def _format_approx(number, precision):
@@ -2128,7 +2172,7 @@ def _format_approx(number, precision):
     Format the number with at most the number of decimals given as precision.
     Remove trailing zeros and possibly the decimal point.
     """
-    return f'{number:.{precision}f}'.rstrip('0').rstrip('.') or '0'
+    return f"{number:.{precision}f}".rstrip("0").rstrip(".") or "0"
 
 
 def _g_sig_digits(value, delta):
@@ -2146,10 +2190,15 @@ def _g_sig_digits(value, delta):
     # is 4 significant digits.  A value of 0 contributes 1 "digit" before the
     # decimal point.
     # For inf or nan, the precision doesn't matter.
-    return max(
-        0,
-        (math.floor(math.log10(abs(value))) + 1 if value else 1)
-        - math.floor(math.log10(delta))) if math.isfinite(value) else 0
+    return (
+        max(
+            0,
+            (math.floor(math.log10(abs(value))) + 1 if value else 1)
+            - math.floor(math.log10(delta)),
+        )
+        if math.isfinite(value)
+        else 0
+    )
 
 
 def _unikey_or_keysym_to_mplkey(unikey, keysym):
@@ -2214,9 +2263,11 @@ class subcls(mixin_class, base_class):
             __module__ = mixin_class.__module__
 
             def __reduce__(self):
-                return (_picklable_class_constructor,
-                        (mixin_class, fmt, attr_name, base_class),
-                        self.__getstate__())
+                return (
+                    _picklable_class_constructor,
+                    (mixin_class, fmt, attr_name, base_class),
+                    self.__getstate__(),
+                )
 
         subcls.__name__ = subcls.__qualname__ = fmt.format(base_class.__name__)
         if attr_name is not None:
@@ -2237,17 +2288,28 @@ def _picklable_class_constructor(mixin_class, fmt, attr_name, base_class):
 def _unpack_to_numpy(x):
     """Internal helper to extract data from e.g. pandas and xarray objects."""
     if isinstance(x, np.ndarray):
-        # If numpy, return directly
+        # If numpy array, return directly
+        return x
+    if isinstance(x, np.generic):
+        # If numpy scalar, return directly
         return x
-    if hasattr(x, 'to_numpy'):
+    if hasattr(x, "to_numpy"):
         # Assume that any to_numpy() method actually returns a numpy array
         return x.to_numpy()
-    if hasattr(x, 'values'):
+    if hasattr(x, "values"):
         xtmp = x.values
         # For example a dict has a 'values' attribute, but it is not a property
         # so in this case we do not want to return a function
         if isinstance(xtmp, np.ndarray):
             return xtmp
+    if hasattr(x, "__array__"):
+        # Assume that any to __array__() method returns a numpy array
+        # (e.g. TensorFlow, JAX or PyTorch arrays)
+        x = x.__array__()
+        # Anything that doesn't return ndarray via __array__() method,
+        # will be filtered by the following check
+        if isinstance(x, np.ndarray):
+            return x
     return x
 
 

From 2cd9857370b38c2bebc7b62fbd7d9998287a7ee0 Mon Sep 17 00:00:00 2001
From: patel-zeel <patel_zeel@iitgn.ac.in>
Date: Mon, 15 May 2023 01:30:04 +0530
Subject: [PATCH 0005/1120] roll back to previous clean changes

---
 lib/matplotlib/cbook.py | 395 +++++++++++++++++-----------------------
 1 file changed, 172 insertions(+), 223 deletions(-)

diff --git a/lib/matplotlib/cbook.py b/lib/matplotlib/cbook.py
index d214e328ae73..03678b0a968b 100644
--- a/lib/matplotlib/cbook.py
+++ b/lib/matplotlib/cbook.py
@@ -52,7 +52,6 @@ def _get_running_interactive_framework():
     if Gtk:
         if Gtk.MAJOR_VERSION == 4:
             from gi.repository import GLib
-
             if GLib.main_depth():
                 return "gtk4"
         if Gtk.MAJOR_VERSION == 3 and Gtk.main_level():
@@ -188,14 +187,9 @@ def __getstate__(self):
             **vars(self),
             # In general, callbacks may not be pickled, so we just drop them,
             # unless directed otherwise by self._pickled_cids.
-            "callbacks": {
-                s: {
-                    cid: proxy()
-                    for cid, proxy in d.items()
-                    if cid in self._pickled_cids
-                }
-                for s, d in self.callbacks.items()
-            },
+            "callbacks": {s: {cid: proxy() for cid, proxy in d.items()
+                              if cid in self._pickled_cids}
+                          for s, d in self.callbacks.items()},
             # It is simpler to reconstruct this from callbacks in __setstate__.
             "_func_cid_map": None,
         }
@@ -203,16 +197,12 @@ def __getstate__(self):
     def __setstate__(self, state):
         vars(self).update(state)
         self.callbacks = {
-            s: {
-                cid: _weak_or_strong_ref(func, self._remove_proxy)
-                for cid, func in d.items()
-            }
-            for s, d in self.callbacks.items()
-        }
+            s: {cid: _weak_or_strong_ref(func, self._remove_proxy)
+                for cid, func in d.items()}
+            for s, d in self.callbacks.items()}
         self._func_cid_map = {
             s: {proxy: cid for cid, proxy in d.items()}
-            for s, d in self.callbacks.items()
-        }
+            for s, d in self.callbacks.items()}
 
     def connect(self, signal, func):
         """Register *func* to be called when signal *signal* is generated."""
@@ -367,8 +357,8 @@ def __repr__(self):
 
 
 def _local_over_kwdict(
-    local_var, kwargs, *keys, warning_cls=_api.MatplotlibDeprecationWarning
-):
+        local_var, kwargs, *keys,
+        warning_cls=_api.MatplotlibDeprecationWarning):
     out = local_var
     for key in keys:
         kwarg_val = kwargs.pop(key, None)
@@ -376,9 +366,8 @@ def _local_over_kwdict(
             if out is None:
                 out = kwarg_val
             else:
-                _api.warn_external(
-                    f'"{key}" keyword argument will be ignored', warning_cls
-                )
+                _api.warn_external(f'"{key}" keyword argument will be ignored',
+                                   warning_cls)
     return out
 
 
@@ -391,15 +380,15 @@ def strip_math(s):
     if len(s) >= 2 and s[0] == s[-1] == "$":
         s = s[1:-1]
         for tex, plain in [
-            (r"\times", "x"),  # Specifically for Formatter support.
-            (r"\mathdefault", ""),
-            (r"\rm", ""),
-            (r"\cal", ""),
-            (r"\tt", ""),
-            (r"\it", ""),
-            ("\\", ""),
-            ("{", ""),
-            ("}", ""),
+                (r"\times", "x"),  # Specifically for Formatter support.
+                (r"\mathdefault", ""),
+                (r"\rm", ""),
+                (r"\cal", ""),
+                (r"\tt", ""),
+                (r"\it", ""),
+                ("\\", ""),
+                ("{", ""),
+                ("}", ""),
         ]:
             s = s.replace(tex, plain)
     return s
@@ -410,7 +399,7 @@ def _strip_comment(s):
     pos = 0
     while True:
         quote_pos = s.find('"', pos)
-        hash_pos = s.find("#", pos)
+        hash_pos = s.find('#', pos)
         if quote_pos < 0:
             without_comment = s if hash_pos < 0 else s[:hash_pos]
             return without_comment.strip()
@@ -421,14 +410,13 @@ def _strip_comment(s):
             if closing_quote_pos < 0:
                 raise ValueError(
                     f"Missing closing quote in: {s!r}. If you need a double-"
-                    'quote inside a string, use escaping: e.g. "the " char"'
-                )
+                    'quote inside a string, use escaping: e.g. "the \" char"')
             pos = closing_quote_pos + 1  # behind closing quote
 
 
 def is_writable_file_like(obj):
     """Return whether *obj* looks like a file object with a *write* method."""
-    return callable(getattr(obj, "write", None))
+    return callable(getattr(obj, 'write', None))
 
 
 def file_requires_unicode(x):
@@ -437,14 +425,14 @@ def file_requires_unicode(x):
     written to it.
     """
     try:
-        x.write(b"")
+        x.write(b'')
     except TypeError:
         return True
     else:
         return False
 
 
-def to_filehandle(fname, flag="r", return_opened=False, encoding=None):
+def to_filehandle(fname, flag='r', return_opened=False, encoding=None):
     """
     Convert a path to an open file handle or pass-through a file-like object.
 
@@ -476,22 +464,21 @@ def to_filehandle(fname, flag="r", return_opened=False, encoding=None):
     if isinstance(fname, os.PathLike):
         fname = os.fspath(fname)
     if isinstance(fname, str):
-        if fname.endswith(".gz"):
+        if fname.endswith('.gz'):
             fh = gzip.open(fname, flag)
-        elif fname.endswith(".bz2"):
+        elif fname.endswith('.bz2'):
             # python may not be compiled with bz2 support,
             # bury import until we need it
             import bz2
-
             fh = bz2.BZ2File(fname, flag)
         else:
             fh = open(fname, flag, encoding=encoding)
         opened = True
-    elif hasattr(fname, "seek"):
+    elif hasattr(fname, 'seek'):
         fh = fname
         opened = False
     else:
-        raise ValueError("fname must be a PathLike or file handle")
+        raise ValueError('fname must be a PathLike or file handle')
     if return_opened:
         return fh, opened
     return fh
@@ -509,8 +496,7 @@ def is_scalar_or_string(val):
 
 
 @_api.delete_parameter(
-    "3.8", "np_load", alternative="open(get_sample_data(..., asfileobj=False))"
-)
+    "3.8", "np_load", alternative="open(get_sample_data(..., asfileobj=False))")
 def get_sample_data(fname, asfileobj=True, *, np_load=True):
     """
     Return a sample data file.  *fname* is a path relative to the
@@ -524,20 +510,20 @@ def get_sample_data(fname, asfileobj=True, *, np_load=True):
     filename ends with .npy or .npz, and *asfileobj* is `True`, the file is
     loaded with `numpy.load`.
     """
-    path = _get_data_path("sample_data", fname)
+    path = _get_data_path('sample_data', fname)
     if asfileobj:
         suffix = path.suffix.lower()
-        if suffix == ".gz":
+        if suffix == '.gz':
             return gzip.open(path)
-        elif suffix in [".npy", ".npz"]:
+        elif suffix in ['.npy', '.npz']:
             if np_load:
                 return np.load(path)
             else:
-                return path.open("rb")
-        elif suffix in [".csv", ".xrc", ".txt"]:
-            return path.open("r")
+                return path.open('rb')
+        elif suffix in ['.csv', '.xrc', '.txt']:
+            return path.open('r')
         else:
-            return path.open("rb")
+            return path.open('rb')
     else:
         return str(path)
 
@@ -614,7 +600,7 @@ def push(self, o):
 
         *o* is returned.
         """
-        self._elements = self._elements[: self._pos + 1] + [o]
+        self._elements = self._elements[:self._pos + 1] + [o]
         self._pos = len(self._elements) - 1
         return self()
 
@@ -648,7 +634,7 @@ def bubble(self, o):
             If *o* is not in the stack.
         """
         if o not in self._elements:
-            raise ValueError("Given element not contained in the stack")
+            raise ValueError('Given element not contained in the stack')
         old_elements = self._elements.copy()
         self.clear()
         top_elements = []
@@ -671,7 +657,7 @@ def remove(self, o):
             If *o* is not in the stack.
         """
         if o not in self._elements:
-            raise ValueError("Given element not contained in the stack")
+            raise ValueError('Given element not contained in the stack')
         old_elements = self._elements.copy()
         self.clear()
         for elem in old_elements:
@@ -684,7 +670,7 @@ def safe_masked_invalid(x, copy=False):
     if not x.dtype.isnative:
         # If we have already made a copy, do the byteswap in place, else make a
         # copy with the byte order swapped.
-        x = x.byteswap(inplace=copy).newbyteorder("N")  # Swap to native order.
+        x = x.byteswap(inplace=copy).newbyteorder('N')  # Swap to native order.
     try:
         xm = np.ma.masked_invalid(x, copy=False)
         xm.shrink_mask()
@@ -798,8 +784,7 @@ class Grouper:
 
     def __init__(self, init=()):
         self._mapping = weakref.WeakKeyDictionary(
-            {x: weakref.WeakSet([x]) for x in init}
-        )
+            {x: weakref.WeakSet([x]) for x in init})
 
     def __getstate__(self):
         return {
@@ -812,8 +797,7 @@ def __setstate__(self, state):
         vars(self).update(state)
         # Convert strong refs to weak ones.
         self._mapping = weakref.WeakKeyDictionary(
-            {k: weakref.WeakSet(v) for k, v in self._mapping.items()}
-        )
+            {k: weakref.WeakSet(v) for k, v in self._mapping.items()})
 
     def __contains__(self, item):
         return item in self._mapping
@@ -840,7 +824,7 @@ def join(self, a, *args):
 
     def joined(self, a, b):
         """Return whether *a* and *b* are members of the same set."""
-        return self._mapping.get(a, object()) is self._mapping.get(b)
+        return (self._mapping.get(a, object()) is self._mapping.get(b))
 
     def remove(self, a):
         set_a = self._mapping.pop(a, None)
@@ -866,20 +850,11 @@ def get_siblings(self, a):
 class GrouperView:
     """Immutable view over a `.Grouper`."""
 
-    def __init__(self, grouper):
-        self._grouper = grouper
-
-    def __contains__(self, item):
-        return item in self._grouper
-
-    def __iter__(self):
-        return iter(self._grouper)
-
-    def joined(self, a, b):
-        return self._grouper.joined(a, b)
-
-    def get_siblings(self, a):
-        return self._grouper.get_siblings(a)
+    def __init__(self, grouper): self._grouper = grouper
+    def __contains__(self, item): return item in self._grouper
+    def __iter__(self): return iter(self._grouper)
+    def joined(self, a, b): return self._grouper.joined(a, b)
+    def get_siblings(self, a): return self._grouper.get_siblings(a)
 
 
 def simple_linear_interpolation(a, steps):
@@ -902,9 +877,8 @@ def simple_linear_interpolation(a, steps):
     fps = a.reshape((len(a), -1))
     xp = np.arange(len(a)) * steps
     x = np.arange((len(a) - 1) * steps + 1)
-    return np.column_stack([np.interp(x, xp, fp) for fp in fps.T]).reshape(
-        (len(x),) + a.shape[1:]
-    )
+    return (np.column_stack([np.interp(x, xp, fp) for fp in fps.T])
+            .reshape((len(x),) + a.shape[1:]))
 
 
 def delete_masked_points(*args):
@@ -1022,7 +996,7 @@ def _combine_masks(*args):
     nrecs = len(args[0])
     margs = []  # Output args; some may be modified.
     seqlist = [False] * len(args)  # Flags: True if output will be masked.
-    masks = []  # List of masks.
+    masks = []    # List of masks.
     for i, x in enumerate(args):
         if is_scalar_or_string(x) or len(x) != nrecs:
             margs.append(x)  # Leave it unmodified.
@@ -1049,7 +1023,8 @@ def _combine_masks(*args):
     return margs
 
 
-def boxplot_stats(X, whis=1.5, bootstrap=None, labels=None, autorange=False):
+def boxplot_stats(X, whis=1.5, bootstrap=None, labels=None,
+                  autorange=False):
     r"""
     Return a list of dictionaries of statistics used to draw a series of box
     and whisker plots using `~.Axes.bxp`.
@@ -1148,6 +1123,7 @@ def _compute_conf_interval(data, med, iqr, bootstrap):
             notch_min = CI[0]
             notch_max = CI[1]
         else:
+
             N = len(data)
             notch_min = med - 1.57 * iqr / np.sqrt(N)
             notch_max = med + 1.57 * iqr / np.sqrt(N)
@@ -1168,10 +1144,11 @@ def _compute_conf_interval(data, med, iqr, bootstrap):
 
     input_whis = whis
     for ii, (x, label) in enumerate(zip(X, labels)):
+
         # empty dict
         stats = {}
         if label is not None:
-            stats["label"] = label
+            stats['label'] = label
 
         # restore whis to the input values in case it got changed in the loop
         whis = input_whis
@@ -1181,76 +1158,74 @@ def _compute_conf_interval(data, med, iqr, bootstrap):
 
         # if empty, bail
         if len(x) == 0:
-            stats["fliers"] = np.array([])
-            stats["mean"] = np.nan
-            stats["med"] = np.nan
-            stats["q1"] = np.nan
-            stats["q3"] = np.nan
-            stats["iqr"] = np.nan
-            stats["cilo"] = np.nan
-            stats["cihi"] = np.nan
-            stats["whislo"] = np.nan
-            stats["whishi"] = np.nan
+            stats['fliers'] = np.array([])
+            stats['mean'] = np.nan
+            stats['med'] = np.nan
+            stats['q1'] = np.nan
+            stats['q3'] = np.nan
+            stats['iqr'] = np.nan
+            stats['cilo'] = np.nan
+            stats['cihi'] = np.nan
+            stats['whislo'] = np.nan
+            stats['whishi'] = np.nan
             continue
 
         # up-convert to an array, just to be safe
         x = np.asarray(x)
 
         # arithmetic mean
-        stats["mean"] = np.mean(x)
+        stats['mean'] = np.mean(x)
 
         # medians and quartiles
         q1, med, q3 = np.percentile(x, [25, 50, 75])
 
         # interquartile range
-        stats["iqr"] = q3 - q1
-        if stats["iqr"] == 0 and autorange:
+        stats['iqr'] = q3 - q1
+        if stats['iqr'] == 0 and autorange:
             whis = (0, 100)
 
         # conf. interval around median
-        stats["cilo"], stats["cihi"] = _compute_conf_interval(
-            x, med, stats["iqr"], bootstrap
+        stats['cilo'], stats['cihi'] = _compute_conf_interval(
+            x, med, stats['iqr'], bootstrap
         )
 
         # lowest/highest non-outliers
         if np.iterable(whis) and not isinstance(whis, str):
             loval, hival = np.percentile(x, whis)
         elif np.isreal(whis):
-            loval = q1 - whis * stats["iqr"]
-            hival = q3 + whis * stats["iqr"]
+            loval = q1 - whis * stats['iqr']
+            hival = q3 + whis * stats['iqr']
         else:
-            raise ValueError("whis must be a float or list of percentiles")
+            raise ValueError('whis must be a float or list of percentiles')
 
         # get high extreme
         wiskhi = x[x <= hival]
         if len(wiskhi) == 0 or np.max(wiskhi) < q3:
-            stats["whishi"] = q3
+            stats['whishi'] = q3
         else:
-            stats["whishi"] = np.max(wiskhi)
+            stats['whishi'] = np.max(wiskhi)
 
         # get low extreme
         wisklo = x[x >= loval]
         if len(wisklo) == 0 or np.min(wisklo) > q1:
-            stats["whislo"] = q1
+            stats['whislo'] = q1
         else:
-            stats["whislo"] = np.min(wisklo)
+            stats['whislo'] = np.min(wisklo)
 
         # compute a single array of outliers
-        stats["fliers"] = np.concatenate(
-            [
-                x[x < stats["whislo"]],
-                x[x > stats["whishi"]],
-            ]
-        )
+        stats['fliers'] = np.concatenate([
+            x[x < stats['whislo']],
+            x[x > stats['whishi']],
+        ])
 
         # add in the remaining stats
-        stats["q1"], stats["med"], stats["q3"] = q1, med, q3
+        stats['q1'], stats['med'], stats['q3'] = q1, med, q3
 
     return bxpstats
 
 
 #: Maps short codes for line style to their full name used by backends.
-ls_mapper = {"-": "solid", "--": "dashed", "-.": "dashdot", ":": "dotted"}
+ls_mapper = {'-': 'solid', '--': 'dashed', '-.': 'dashdot', ':': 'dotted'}
 #: Maps full names for line styles used by backends to their short codes.
 ls_mapper_r = {v: k for k, v in ls_mapper.items()}
 
@@ -1266,7 +1241,7 @@ def contiguous_regions(mask):
         return []
 
     # Find the indices of region changes, and correct offset
-    (idx,) = np.nonzero(mask[:-1] != mask[1:])
+    idx, = np.nonzero(mask[:-1] != mask[1:])
     idx += 1
 
     # List operations are faster for moderately sized arrays
@@ -1289,8 +1264,8 @@ def is_math_text(s):
     non-escaped dollar signs.
     """
     s = str(s)
-    dollar_count = s.count(r"$") - s.count(r"\$")
-    even_dollars = dollar_count > 0 and dollar_count % 2 == 0
+    dollar_count = s.count(r'$') - s.count(r'\$')
+    even_dollars = (dollar_count > 0 and dollar_count % 2 == 0)
     return even_dollars
 
 
@@ -1299,7 +1274,7 @@ def _to_unmasked_float_array(x):
     Convert a sequence to a float array; if input was a masked array, masked
     values are converted to nans.
     """
-    if hasattr(x, "mask"):
+    if hasattr(x, 'mask'):
         return np.ma.asarray(x, float).filled(np.nan)
     else:
         return np.asarray(x, float)
@@ -1312,7 +1287,9 @@ def _check_1d(x):
     # plot requires `shape` and `ndim`.  If passed an
     # object that doesn't provide them, then force to numpy array.
     # Note this will strip unit information.
-    if not hasattr(x, "shape") or not hasattr(x, "ndim") or len(x.shape) < 1:
+    if (not hasattr(x, 'shape') or
+            not hasattr(x, 'ndim') or
+            len(x.shape) < 1):
         return np.atleast_1d(x)
     else:
         return x
@@ -1346,7 +1323,7 @@ def _reshape_2D(X, name):
             # 2D array, or 1D array of iterables: flatten them first.
             return [np.reshape(x, -1) for x in X]
         else:
-            raise ValueError(f"{name} must have 2 or fewer dimensions")
+            raise ValueError(f'{name} must have 2 or fewer dimensions')
 
     # Iterate over list of iterables.
     if len(X) == 0:
@@ -1367,7 +1344,7 @@ def _reshape_2D(X, name):
         xi = np.asanyarray(xi)
         nd = np.ndim(xi)
         if nd > 1:
-            raise ValueError(f"{name} must have 2 or fewer dimensions")
+            raise ValueError(f'{name} must have 2 or fewer dimensions')
         result.append(xi.reshape(-1))
 
     if is_1d:
@@ -1445,13 +1422,11 @@ def violin_stats(X, method, points=100, quantiles=None):
 
     # quantiles should have the same size as dataset
     if len(X) != len(quantiles):
-        raise ValueError(
-            "List of violinplot statistics and quantiles values"
-            " must have the same length"
-        )
+        raise ValueError("List of violinplot statistics and quantiles values"
+                         " must have the same length")
 
     # Zip x and quantiles
-    for x, q in zip(X, quantiles):
+    for (x, q) in zip(X, quantiles):
         # Dictionary of results for this distribution
         stats = {}
 
@@ -1462,15 +1437,15 @@ def violin_stats(X, method, points=100, quantiles=None):
 
         # Evaluate the kernel density estimate
         coords = np.linspace(min_val, max_val, points)
-        stats["vals"] = method(x, coords)
-        stats["coords"] = coords
+        stats['vals'] = method(x, coords)
+        stats['coords'] = coords
 
         # Store additional statistics for this distribution
-        stats["mean"] = np.mean(x)
-        stats["median"] = np.median(x)
-        stats["min"] = min_val
-        stats["max"] = max_val
-        stats["quantiles"] = np.atleast_1d(quantile_val)
+        stats['mean'] = np.mean(x)
+        stats['median'] = np.median(x)
+        stats['min'] = min_val
+        stats['max'] = max_val
+        stats['quantiles'] = np.atleast_1d(quantile_val)
 
         # Append to output
         vpstats.append(stats)
@@ -1590,13 +1565,11 @@ def pts_to_midstep(x, *args):
     return steps
 
 
-STEP_LOOKUP_MAP = {
-    "default": lambda x, y: (x, y),
-    "steps": pts_to_prestep,
-    "steps-pre": pts_to_prestep,
-    "steps-post": pts_to_poststep,
-    "steps-mid": pts_to_midstep,
-}
+STEP_LOOKUP_MAP = {'default': lambda x, y: (x, y),
+                   'steps': pts_to_prestep,
+                   'steps-pre': pts_to_prestep,
+                   'steps-post': pts_to_poststep,
+                   'steps-mid': pts_to_midstep}
 
 
 def index_of(y):
@@ -1631,7 +1604,7 @@ def index_of(y):
         pass
     else:
         return np.arange(y.shape[0], dtype=float), y
-    raise ValueError("Input could not be cast to an at-least-1D NumPy array")
+    raise ValueError('Input could not be cast to an at-least-1D NumPy array')
 
 
 def safe_first_element(obj):
@@ -1654,7 +1627,6 @@ def _safe_first_finite(obj, *, skip_nonfinite=True):
     This is a type-independent way of obtaining the first finite element, supporting
     both index access and the iterator protocol.
     """
-
     def safe_isfinite(val):
         if val is None:
             return False
@@ -1664,7 +1636,6 @@ def safe_isfinite(val):
             # This is something that NumPy cannot make heads or tails of,
             # assume "finite"
             return True
-
     if skip_nonfinite is False:
         if isinstance(obj, collections.abc.Iterator):
             # needed to accept `array.flat` as input.
@@ -1676,13 +1647,15 @@ def safe_isfinite(val):
                 return obj[0]
             except TypeError:
                 pass
-            raise RuntimeError("matplotlib does not support generators " "as input")
+            raise RuntimeError("matplotlib does not support generators "
+                               "as input")
         return next(iter(obj))
     elif isinstance(obj, np.flatiter):
         # TODO do the finite filtering on this
         return obj[0]
     elif isinstance(obj, collections.abc.Iterator):
-        raise RuntimeError("matplotlib does not " "support generators as input")
+        raise RuntimeError("matplotlib does not "
+                           "support generators as input")
     else:
         return next((val for val in obj if safe_isfinite(val)), safe_first_element(obj))
 
@@ -1691,7 +1664,8 @@ def sanitize_sequence(data):
     """
     Convert dictview objects to list. Other inputs are returned unchanged.
     """
-    return list(data) if isinstance(data, collections.abc.MappingView) else data
+    return (list(data) if isinstance(data, collections.abc.MappingView)
+            else data)
 
 
 def normalize_kwargs(kw, alias_mapping=None):
@@ -1729,28 +1703,21 @@ def normalize_kwargs(kw, alias_mapping=None):
     # deal with default value of alias_mapping
     if alias_mapping is None:
         alias_mapping = dict()
-    elif (
-        isinstance(alias_mapping, type)
-        and issubclass(alias_mapping, Artist)
-        or isinstance(alias_mapping, Artist)
-    ):
+    elif (isinstance(alias_mapping, type) and issubclass(alias_mapping, Artist)
+          or isinstance(alias_mapping, Artist)):
         alias_mapping = getattr(alias_mapping, "_alias_map", {})
 
-    to_canonical = {
-        alias: canonical
-        for canonical, alias_list in alias_mapping.items()
-        for alias in alias_list
-    }
+    to_canonical = {alias: canonical
+                    for canonical, alias_list in alias_mapping.items()
+                    for alias in alias_list}
     canonical_to_seen = {}
     ret = {}  # output dictionary
 
     for k, v in kw.items():
         canonical = to_canonical.get(k, k)
         if canonical in canonical_to_seen:
-            raise TypeError(
-                f"Got both {canonical_to_seen[canonical]!r} and "
-                f"{k!r}, which are aliases of one another"
-            )
+            raise TypeError(f"Got both {canonical_to_seen[canonical]!r} and "
+                            f"{k!r}, which are aliases of one another")
         canonical_to_seen[canonical] = k
         ret[canonical] = v
 
@@ -1784,15 +1751,12 @@ def _lock_path(path):
         except FileExistsError:
             time.sleep(sleeptime)
     else:
-        raise TimeoutError(
-            """\
+        raise TimeoutError("""\
 Lock error: Matplotlib failed to acquire the following lock file:
     {}
 This maybe due to another process holding this lock file.  If you are sure no
 other Matplotlib process is running, remove this file and try again.""".format(
-                lock_path
-            )
-        )
+            lock_path))
     try:
         yield
     finally:
@@ -1800,8 +1764,8 @@ def _lock_path(path):
 
 
 def _topmost_artist(
-    artists, _cached_max=functools.partial(max, key=operator.attrgetter("zorder"))
-):
+        artists,
+        _cached_max=functools.partial(max, key=operator.attrgetter("zorder"))):
     """
     Get the topmost artist of a list.
 
@@ -1863,16 +1827,14 @@ def _array_perimeter(arr):
     """
     # note we use Python's half-open ranges to avoid repeating
     # the corners
-    forward = np.s_[0:-1]  # [0 ... -1)
+    forward = np.s_[0:-1]      # [0 ... -1)
     backward = np.s_[-1:0:-1]  # [-1 ... 0)
-    return np.concatenate(
-        (
-            arr[0, forward],
-            arr[forward, -1],
-            arr[-1, backward],
-            arr[backward, 0],
-        )
-    )
+    return np.concatenate((
+        arr[0, forward],
+        arr[forward, -1],
+        arr[-1, backward],
+        arr[backward, 0],
+    ))
 
 
 def _unfold(arr, axis, size, step):
@@ -1919,9 +1881,10 @@ def _unfold(arr, axis, size, step):
     new_strides = [*arr.strides, arr.strides[axis]]
     new_shape[axis] = (new_shape[axis] - size) // step + 1
     new_strides[axis] = new_strides[axis] * step
-    return np.lib.stride_tricks.as_strided(
-        arr, shape=new_shape, strides=new_strides, writeable=False
-    )
+    return np.lib.stride_tricks.as_strided(arr,
+                                           shape=new_shape,
+                                           strides=new_strides,
+                                           writeable=False)
 
 
 def _array_patch_perimeters(x, rstride, cstride):
@@ -1969,9 +1932,8 @@ def _array_patch_perimeters(x, rstride, cstride):
     bottom = _unfold(x[rstride::rstride, 1:], 1, cstride, cstride)[..., ::-1]
     right = _unfold(x[:-1, cstride::cstride], 0, rstride, rstride)
     left = _unfold(x[1:, :-1:cstride], 0, rstride, rstride)[..., ::-1]
-    return np.concatenate((top, right, bottom, left), axis=2).reshape(
-        -1, 2 * (rstride + cstride)
-    )
+    return (np.concatenate((top, right, bottom, left), axis=2)
+              .reshape(-1, 2 * (rstride + cstride)))
 
 
 @contextlib.contextmanager
@@ -2048,16 +2010,16 @@ def _premultiplied_argb32_to_unmultiplied_rgba8888(buf):
     Convert a premultiplied ARGB32 buffer to an unmultiplied RGBA8888 buffer.
     """
     rgba = np.take(  # .take() ensures C-contiguity of the result.
-        buf, [2, 1, 0, 3] if sys.byteorder == "little" else [1, 2, 3, 0], axis=2
-    )
+        buf,
+        [2, 1, 0, 3] if sys.byteorder == "little" else [1, 2, 3, 0], axis=2)
     rgb = rgba[..., :-1]
     alpha = rgba[..., -1]
     # Un-premultiply alpha.  The formula is the same as in cairo-png.c.
     mask = alpha != 0
     for channel in np.rollaxis(rgb, -1):
-        channel[mask] = (channel[mask].astype(int) * 255 + alpha[mask] // 2) // alpha[
-            mask
-        ]
+        channel[mask] = (
+            (channel[mask].astype(int) * 255 + alpha[mask] // 2)
+            // alpha[mask])
     return rgba
 
 
@@ -2076,8 +2038,8 @@ def _unmultiplied_rgba8888_to_premultiplied_argb32(rgba8888):
     # Only bother premultiplying when the alpha channel is not fully opaque,
     # as the cost is not negligible.  The unsafe cast is needed to do the
     # multiplication in-place in an integer buffer.
-    if alpha8.min() != 0xFF:
-        np.multiply(rgb24, alpha8 / 0xFF, out=rgb24, casting="unsafe")
+    if alpha8.min() != 0xff:
+        np.multiply(rgb24, alpha8 / 0xff, out=rgb24, casting="unsafe")
     return argb32
 
 
@@ -2089,8 +2051,8 @@ def _get_nonzero_slices(buf):
     that encloses all non-zero entries in *buf*.  If *buf* is fully zero, then
     ``(slice(0, 0), slice(0, 0))`` is returned.
     """
-    (x_nz,) = buf.any(axis=0).nonzero()
-    (y_nz,) = buf.any(axis=1).nonzero()
+    x_nz, = buf.any(axis=0).nonzero()
+    y_nz, = buf.any(axis=1).nonzero()
     if len(x_nz) and len(y_nz):
         l, r = x_nz[[0, -1]]
         b, t = y_nz[[0, -1]]
@@ -2101,11 +2063,8 @@ def _get_nonzero_slices(buf):
 
 def _pformat_subprocess(command):
     """Pretty-format a subprocess command for printing/logging purposes."""
-    return (
-        command
-        if isinstance(command, str)
-        else " ".join(shlex.quote(os.fspath(arg)) for arg in command)
-    )
+    return (command if isinstance(command, str)
+            else " ".join(shlex.quote(os.fspath(arg)) for arg in command))
 
 
 def _check_and_log_subprocess(command, logger, **kwargs):
@@ -2118,7 +2077,7 @@ def _check_and_log_subprocess(command, logger, **kwargs):
     Regardless of the return code, the command is logged at DEBUG level on
     *logger*.  In case of success, the output is likewise logged.
     """
-    logger.debug("%s", _pformat_subprocess(command))
+    logger.debug('%s', _pformat_subprocess(command))
     proc = subprocess.run(command, capture_output=True, **kwargs)
     if proc.returncode:
         stdout = proc.stdout
@@ -2133,8 +2092,7 @@ def _check_and_log_subprocess(command, logger, **kwargs):
             f"failed and generated the following output:\n"
             f"{stdout}\n"
             f"and the following error:\n"
-            f"{stderr}"
-        )
+            f"{stderr}")
     if proc.stdout:
         logger.debug("stdout:\n%s", proc.stdout)
     if proc.stderr:
@@ -2147,11 +2105,8 @@ def _backend_module_name(name):
     Convert a backend name (either a standard backend -- "Agg", "TkAgg", ... --
     or a custom backend -- "module://...") to the corresponding module name).
     """
-    return (
-        name[9:]
-        if name.startswith("module://")
-        else f"matplotlib.backends.backend_{name.lower()}"
-    )
+    return (name[9:] if name.startswith("module://")
+            else f"matplotlib.backends.backend_{name.lower()}")
 
 
 def _setup_new_guiapp():
@@ -2164,7 +2119,8 @@ def _setup_new_guiapp():
     try:
         _c_internal_utils.Win32_GetCurrentProcessExplicitAppUserModelID()
     except OSError:
-        _c_internal_utils.Win32_SetCurrentProcessExplicitAppUserModelID("matplotlib")
+        _c_internal_utils.Win32_SetCurrentProcessExplicitAppUserModelID(
+            "matplotlib")
 
 
 def _format_approx(number, precision):
@@ -2172,7 +2128,7 @@ def _format_approx(number, precision):
     Format the number with at most the number of decimals given as precision.
     Remove trailing zeros and possibly the decimal point.
     """
-    return f"{number:.{precision}f}".rstrip("0").rstrip(".") or "0"
+    return f'{number:.{precision}f}'.rstrip('0').rstrip('.') or '0'
 
 
 def _g_sig_digits(value, delta):
@@ -2190,15 +2146,10 @@ def _g_sig_digits(value, delta):
     # is 4 significant digits.  A value of 0 contributes 1 "digit" before the
     # decimal point.
     # For inf or nan, the precision doesn't matter.
-    return (
-        max(
-            0,
-            (math.floor(math.log10(abs(value))) + 1 if value else 1)
-            - math.floor(math.log10(delta)),
-        )
-        if math.isfinite(value)
-        else 0
-    )
+    return max(
+        0,
+        (math.floor(math.log10(abs(value))) + 1 if value else 1)
+        - math.floor(math.log10(delta))) if math.isfinite(value) else 0
 
 
 def _unikey_or_keysym_to_mplkey(unikey, keysym):
@@ -2263,11 +2214,9 @@ class subcls(mixin_class, base_class):
             __module__ = mixin_class.__module__
 
             def __reduce__(self):
-                return (
-                    _picklable_class_constructor,
-                    (mixin_class, fmt, attr_name, base_class),
-                    self.__getstate__(),
-                )
+                return (_picklable_class_constructor,
+                        (mixin_class, fmt, attr_name, base_class),
+                        self.__getstate__())
 
         subcls.__name__ = subcls.__qualname__ = fmt.format(base_class.__name__)
         if attr_name is not None:
@@ -2293,23 +2242,23 @@ def _unpack_to_numpy(x):
     if isinstance(x, np.generic):
         # If numpy scalar, return directly
         return x
-    if hasattr(x, "to_numpy"):
+    if hasattr(x, 'to_numpy'):
         # Assume that any to_numpy() method actually returns a numpy array
         return x.to_numpy()
-    if hasattr(x, "values"):
+    if hasattr(x, 'values'):
         xtmp = x.values
         # For example a dict has a 'values' attribute, but it is not a property
         # so in this case we do not want to return a function
         if isinstance(xtmp, np.ndarray):
             return xtmp
-    if hasattr(x, "__array__"):
+    if hasattr(x, '__array__'):
         # Assume that any to __array__() method returns a numpy array
         # (e.g. TensorFlow, JAX or PyTorch arrays)
-        x = x.__array__()
-        # Anything that doesn't return ndarray via __array__() method,
+        xtmp = x.__array__()
+        # Anything that doesn't return ndarray via __array__() method
         # will be filtered by the following check
-        if isinstance(x, np.ndarray):
-            return x
+        if isinstance(xtmp, np.ndarray):
+            return xtmp
     return x
 
 

From 519ace87c9994ac8c3d3310e950e5da94f2ab044 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Wed, 17 May 2023 23:44:17 +0200
Subject: [PATCH 0006/1120] Tweak transforms tutorial.

- In the Axes coordinates example, point to the "labelling subplots"
  example which is arguably a better approach for labelling (it ensures
  that the labels stay aligned even if the axes have different widths).
  The current example in the tutorial is still useful for pedagogical
  purposes, though.
- Shorten the entries in the transformations tables to avoid having
  overly long lines.
---
 .../artists/transforms_tutorial.py            | 111 +++++++++---------
 1 file changed, 54 insertions(+), 57 deletions(-)

diff --git a/galleries/users_explain/artists/transforms_tutorial.py b/galleries/users_explain/artists/transforms_tutorial.py
index c6e71ad111d7..a39cf7a30192 100644
--- a/galleries/users_explain/artists/transforms_tutorial.py
+++ b/galleries/users_explain/artists/transforms_tutorial.py
@@ -23,55 +23,51 @@
 :class:`~matplotlib.figure.SubFigure` instance.
 
 
-+----------------+-----------------------------------+---------------------------------------------------+
-|Coordinate      |Description                        |Transformation object                              |
-|system          |                                   |from system to display                             |
-+================+===================================+===================================================+
-|"data"          |The coordinate system of the data  |``ax.transData``                                   |
-|                |in the Axes.                       |                                                   |
-+----------------+-----------------------------------+---------------------------------------------------+
-|"axes"          |The coordinate system of the       |``ax.transAxes``                                   |
-|                |`~matplotlib.axes.Axes`; (0, 0)    |                                                   |
-|                |is bottom left of the axes, and    |                                                   |
-|                |(1, 1) is top right of the axes.   |                                                   |
-+----------------+-----------------------------------+---------------------------------------------------+
-|"subfigure"     |The coordinate system of the       |``subfigure.transSubfigure``                       |
-|                |`.SubFigure`; (0, 0) is bottom left|                                                   |
-|                |of the subfigure, and (1, 1) is top|                                                   |
-|                |right of the subfigure.  If a      |                                                   |
-|                |figure has no subfigures, this is  |                                                   |
-|                |the same as ``transFigure``.       |                                                   |
-+----------------+-----------------------------------+---------------------------------------------------+
-|"figure"        |The coordinate system of the       |``fig.transFigure``                                |
-|                |`.Figure`; (0, 0) is bottom left   |                                                   |
-|                |of the figure, and (1, 1) is top   |                                                   |
-|                |right of the figure.               |                                                   |
-+----------------+-----------------------------------+---------------------------------------------------+
-|"figure-inches" |The coordinate system of the       |``fig.dpi_scale_trans``                            |
-|                |`.Figure` in inches; (0, 0) is     |                                                   |
-|                |bottom left of the figure, and     |                                                   |
-|                |(width, height) is the top right   |                                                   |
-|                |of the figure in inches.           |                                                   |
-+----------------+-----------------------------------+---------------------------------------------------+
-|"xaxis",        |Blended coordinate systems, using  |``ax.get_xaxis_transform()``,                      |
-|"yaxis"         |data coordinates on one direction  |``ax.get_yaxis_transform()``                       |
-|                |and axes coordinates on the other. |                                                   |
-+----------------+-----------------------------------+---------------------------------------------------+
-|"display"       |The native coordinate system of the|`None`, or                                         |
-|                |output ; (0, 0) is the bottom left |:class:`~matplotlib.transforms.IdentityTransform()`|
-|                |of the window, and (width, height) |                                                   |
-|                |is top right of the output in      |                                                   |
-|                |"display units".                   |                                                   |
-|                |                                   |                                                   |
-|                |The exact interpretation of the    |                                                   |
-|                |units depends on the back end. For |                                                   |
-|                |example it is pixels for Agg and   |                                                   |
-|                |points for svg/pdf.                |                                                   |
-+----------------+-----------------------------------+---------------------------------------------------+
-
-
-
-
++----------------+-----------------------------------+-----------------------------+
+|Coordinate      |Description                        |Transformation object        |
+|system          |                                   |from system to display       |
++================+===================================+=============================+
+|"data"          |The coordinate system of the data  |``ax.transData``             |
+|                |in the Axes.                       |                             |
++----------------+-----------------------------------+-----------------------------+
+|"axes"          |The coordinate system of the       |``ax.transAxes``             |
+|                |`~matplotlib.axes.Axes`; (0, 0)    |                             |
+|                |is bottom left of the axes, and    |                             |
+|                |(1, 1) is top right of the axes.   |                             |
++----------------+-----------------------------------+-----------------------------+
+|"subfigure"     |The coordinate system of the       |``subfigure.transSubfigure`` |
+|                |`.SubFigure`; (0, 0) is bottom left|                             |
+|                |of the subfigure, and (1, 1) is top|                             |
+|                |right of the subfigure.  If a      |                             |
+|                |figure has no subfigures, this is  |                             |
+|                |the same as ``transFigure``.       |                             |
++----------------+-----------------------------------+-----------------------------+
+|"figure"        |The coordinate system of the       |``fig.transFigure``          |
+|                |`.Figure`; (0, 0) is bottom left   |                             |
+|                |of the figure, and (1, 1) is top   |                             |
+|                |right of the figure.               |                             |
++----------------+-----------------------------------+-----------------------------+
+|"figure-inches" |The coordinate system of the       |``fig.dpi_scale_trans``      |
+|                |`.Figure` in inches; (0, 0) is     |                             |
+|                |bottom left of the figure, and     |                             |
+|                |(width, height) is the top right   |                             |
+|                |of the figure in inches.           |                             |
++----------------+-----------------------------------+-----------------------------+
+|"xaxis",        |Blended coordinate systems, using  |``ax.get_xaxis_transform()``,|
+|"yaxis"         |data coordinates on one direction  |``ax.get_yaxis_transform()`` |
+|                |and axes coordinates on the other. |                             |
++----------------+-----------------------------------+-----------------------------+
+|"display"       |The native coordinate system of the|`None`, or                   |
+|                |output ; (0, 0) is the bottom left |`.IdentityTransform()`       |
+|                |of the window, and (width, height) |                             |
+|                |is top right of the output in      |                             |
+|                |"display units".                   |                             |
+|                |                                   |                             |
+|                |The exact interpretation of the    |                             |
+|                |units depends on the back end. For |                             |
+|                |example it is pixels for Agg and   |                             |
+|                |points for svg/pdf.                |                             |
++----------------+-----------------------------------+-----------------------------+
 
 The `~matplotlib.transforms.Transform` objects are naive to the source and
 destination coordinate systems, however the objects referred to in the table
@@ -247,14 +243,15 @@
 #
 # After the *data* coordinate system, *axes* is probably the second most
 # useful coordinate system.  Here the point (0, 0) is the bottom left of
-# your axes or subplot, (0.5, 0.5) is the center, and (1.0, 1.0) is the
-# top right.  You can also refer to points outside the range, so (-0.1,
-# 1.1) is to the left and above your axes.  This coordinate system is
-# extremely useful when placing text in your axes, because you often
-# want a text bubble in a fixed, location, e.g., the upper left of the axes
-# pane, and have that location remain fixed when you pan or zoom.  Here
-# is a simple example that creates four panels and labels them 'A', 'B',
-# 'C', 'D' as you often see in journals.
+# your axes or subplot, (0.5, 0.5) is the center, and (1.0, 1.0) is the top
+# right.  You can also refer to points outside the range, so (-0.1, 1.1)
+# is to the left and above your axes.  This coordinate system is extremely
+# useful when placing text in your axes, because you often want a text bubble
+# in a fixed, location, e.g., the upper left of the axes pane, and have that
+# location remain fixed when you pan or zoom.  Here is a simple example that
+# creates four panels and labels them 'A', 'B', 'C', 'D' as you often see in
+# journals.  A more sophisticated approach for such labeling is presented at
+# :doc:`/gallery/text_labels_and_annotations/label_subplots`.
 
 fig = plt.figure()
 for i, label in enumerate(('A', 'B', 'C', 'D')):

From 00eb561042e74ae4b1102381c820f4cf811053d4 Mon Sep 17 00:00:00 2001
From: melissawm <melissawm@gmail.com>
Date: Mon, 26 Jun 2023 18:13:30 -0300
Subject: [PATCH 0007/1120] DOC: Add documentation on codespaces usage

---
 .devcontainer/devcontainer.json |  19 +++---
 doc/devel/codespaces.md         | 107 ++++++++++++++++++++++++++++++++
 doc/devel/contribute.rst        |  97 +++++++++++++++++++++++------
 3 files changed, 196 insertions(+), 27 deletions(-)
 create mode 100644 doc/devel/codespaces.md

diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
index 87d381c9a68b..a43a383536a1 100644
--- a/.devcontainer/devcontainer.json
+++ b/.devcontainer/devcontainer.json
@@ -1,4 +1,3 @@
-
 {
   "hostRequirements": {
     "memory": "8gb",
@@ -22,11 +21,17 @@
         "ms-vscode.live-server"
       ],
       "settings": {}
+    },
+    "codespaces": {
+      "openFiles": [
+        "README.md",
+        "doc/devel/codespaces.md"
+      ]
     }
-},
-"portsAttributes": {
-	"6080": {
-		"label": "desktop"
-	}
-}
+  },
+  "portsAttributes": {
+    "6080": {
+      "label": "desktop"
+    }
+  }
 }
diff --git a/doc/devel/codespaces.md b/doc/devel/codespaces.md
new file mode 100644
index 000000000000..3a41aae560a3
--- /dev/null
+++ b/doc/devel/codespaces.md
@@ -0,0 +1,107 @@
+# Contributing to Matplotlib using GitHub codespaces
+
+You've discovered a bug or something else you want to change
+in Matplotlib — excellent!
+
+You've worked out a way to fix it — even better!
+
+You want to tell us about it — best of all!
+
+This project is a community effort, and everyone is welcome to contribute.
+Everyone within the community is expected to abide by our
+[Code of Conduct](../../CODE_OF_CONDUCT.md).
+
+## GitHub codespaces contribution workflow
+
+The preferred way to contribute to Matplotlib is to fork the main
+repository at https://github.com/matplotlib/matplotlib, then submit a "pull
+request" (PR). You can do this by cloning a copy of the Maplotlib repository to
+your own computer, or alternatively using
+[GitHub Codespaces](https://docs.github.com/codespaces) (a cloud-based
+in-browser development environment, that comes with the appropriated setup to
+contribute to Matplotlib).
+
+A brief overview of the workflows is as follows.
+
+1. Go to the GitHub web interface
+2. Fork the [project repository](https://github.com/matplotlib/matplotlib):
+3. Open codespaces on your fork by clicking on the green "Code" button on the
+   GitHub web interface and selecting the "Codespaces" tab. Next, click on "Open
+   codespaces on <your fork name>". You will be able to change branches later,
+   so you can select the default `main` branch.
+
+   After the codespace is created, you will be taken to a new browser tab where
+   you can use the terminal to activate a pre-defined conda environment called
+   `mpl-dev`:
+
+   ```
+   conda activate mpl-dev
+   ```
+
+4. Install the local version of Matplotlib with:
+
+   ```
+   python -m pip install -e .
+   ```
+
+   (See [Setting up Matplotlib for development](https://matplotlib.org/devdocs/devel/development_setup.html)
+   for detailed instructions.)
+
+5. Create a branch to hold your changes:
+
+   ```
+   git checkout -b my-feature origin/main
+   ```
+
+   and start making changes. Never work in the `main` branch!
+
+6. Work on this task using Git to do the version control. Codespaces persist for
+   some time (check the [documentation for details](https://docs.github.com/codespaces/getting-started/the-codespace-lifecycle))
+   and can be managed on https://github.com/codespaces. When you're done editing
+   e.g., `lib/matplotlib/collections.py`, do:
+
+   ```
+   git add lib/matplotlib/collections.py
+   git commit
+   ```
+
+   to record your changes in Git, then push them to your GitHub fork with:
+
+   ```
+   git push -u origin my-feature
+   ```
+
+Finally, go to the web page of your fork of the Matplotlib repo, and click
+'Pull request' to send your changes to the maintainers for review.
+
+## Other stuff you may want to do
+
+* If you need to run tests to verify your changes before sending your PR, you
+  can run (in your `mpl-dev` conda environment):
+
+  ```
+  pytest
+  ```
+
+* If you need to build the documentation, you can move to the `doc` folder and
+  run (in your `mpl-dev` conda environment):
+
+  ```
+  cd doc
+  make html
+  ```
+
+* If you need to open a GUI window with Matplotlib output, our Codespaces
+  configuration includes a
+  [light-weight Fluxbox-based desktop](https://github.com/devcontainers/features/tree/main/src/desktop-lite).
+  You can use it by connecting to this desktop via your web browser. To do this:
+
+  1. Press `F1` or `Ctrl/Cmd+Shift+P` and select `Ports: Focus on Ports View` in
+     VS Code to bring it into focus. Open the ports view in your tool, select
+     the `noVNC` port, and click the Globe icon.
+  2. In the browser that appears, click the Connect button and enter the desktop
+     password (`vscode` by default).
+
+  Check the
+  [GitHub instructions](https://github.com/devcontainers/features/tree/main/src/desktop-lite#connecting-to-the-desktop)
+  for more details on connecting to the desktop.
diff --git a/doc/devel/contribute.rst b/doc/devel/contribute.rst
index c6e1a2199fae..2f8ed9271e10 100644
--- a/doc/devel/contribute.rst
+++ b/doc/devel/contribute.rst
@@ -222,39 +222,96 @@ How to contribute
 
 The preferred way to contribute to Matplotlib is to fork the `main
 repository <https://github.com/matplotlib/matplotlib/>`__ on GitHub,
-then submit a "pull request" (PR).
+then submit a "pull request" (PR). You can do this by cloning a copy of the
+Maplotlib repository to your own computer, or alternatively using
+`GitHub Codespaces <https://docs.github.com/codespaces>`_ (a cloud-based
+in-browser development environment, that comes with the appropriated setup to
+contribute to Matplotlib).
 
-A brief overview is:
+A brief overview of the workflows is as follows.
 
-1. `Create an account <https://github.com/join>`_ on GitHub if you do not
-   already have one.
+.. tab-set::
 
-2. Fork the `project repository <https://github.com/matplotlib/matplotlib>`_:
-   click on the 'Fork' button near the top of the page. This creates a copy of
-   the code under your account on the GitHub server.
+    .. tab-item:: Local development
 
-3. Clone this copy to your local disk::
+        1. `Create an account <https://github.com/join>`_ on GitHub if you do
+           not already have one.
 
-      git clone https://github.com/<YOUR GITHUB USERNAME>/matplotlib.git
+        2. Fork the
+           `project repository <https://github.com/matplotlib/matplotlib>`_:
+           click on the 'Fork' button near the top of the page. This creates a
+           copy of the code under your account on the GitHub server.
 
-4. Enter the directory and install the local version of Matplotlib.
-   See :ref:`installing_for_devs` for instructions
+        3. Clone this copy to your local disk::
 
-5. Create a branch to hold your changes::
+             git clone https://github.com/<YOUR GITHUB USERNAME>/matplotlib.git
 
-      git checkout -b my-feature origin/main
+        4. Enter the directory and install the local version of Matplotlib.
+           See :ref:`installing_for_devs` for instructions
 
-   and start making changes. Never work in the ``main`` branch!
+        5. Create a branch to hold your changes::
 
-6. Work on this copy, on your computer, using Git to do the version control.
-   When you're done editing e.g., ``lib/matplotlib/collections.py``, do::
+             git checkout -b my-feature origin/main
 
-      git add lib/matplotlib/collections.py
-      git commit
+           and start making changes. Never work in the ``main`` branch!
 
-   to record your changes in Git, then push them to GitHub with::
+        6. Work on this copy, on your computer, using Git to do the version
+           control. When you're done editing e.g.,
+           ``lib/matplotlib/collections.py``, do::
 
-      git push -u origin my-feature
+             git add lib/matplotlib/collections.py
+             git commit
+
+           to record your changes in Git, then push them to GitHub with::
+
+             git push -u origin my-feature
+
+    .. tab-item:: Using GitHub Codespaces
+
+        1. `Create an account <https://github.com/join>`_ on GitHub if you do
+           not already have one.
+
+        2. Fork the
+           `project repository <https://github.com/matplotlib/matplotlib>`_:
+           click on the 'Fork' button near the top of the page. This creates a
+           copy of the code under your account on the GitHub server.
+
+        3. Open codespaces on your fork by clicking on the green "Code" button
+           on the GitHub web interface and selecting the "Codespaces" tab. Next,
+           click on "Open codespaces on <your fork name>". You will be able to
+           change branches later, so you can select the default ``main`` branch.
+
+           After the codespace is created, you will be taken to a new browser
+           tab where you can use the terminal to activate a pre-defined conda
+           environment called ``mpl-dev``::
+
+            conda activate mpl-dev
+
+        4. Install the local version of Matplotlib with::
+
+             python -m pip install -e .
+
+           (See :ref:`installing_for_devs` for detailed instructions.)
+
+        5. Create a branch to hold your changes::
+
+             git checkout -b my-feature origin/main
+
+           and start making changes. Never work in the ``main`` branch!
+
+        6. Work on this task using Git to do the version control. Codespaces
+           persist for some time (check the `documentation for details
+           <https://docs.github.com/codespaces/getting-started/the-codespace-lifecycle>`_)
+           and can be managed on https://github.com/codespaces. When you're done
+           editing e.g., ``lib/matplotlib/collections.py``, do::
+
+             git add lib/matplotlib/collections.py
+             git commit
+
+           to record your changes in Git, then push them to your GitHub fork
+           with::
+
+             git push -u origin my-feature
 
 Finally, go to the web page of your fork of the Matplotlib repo, and click
 'Pull request' to send your changes to the maintainers for review.

From a28db8665683188cb30d985618935813199500ea Mon Sep 17 00:00:00 2001
From: melissawm <melissawm@gmail.com>
Date: Mon, 26 Jun 2023 20:12:03 -0300
Subject: [PATCH 0008/1120] MAINT: Fix port forwarding for desktop on
 codespaces

---
 .devcontainer/devcontainer.json | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
index a43a383536a1..814c066c43b1 100644
--- a/.devcontainer/devcontainer.json
+++ b/.devcontainer/devcontainer.json
@@ -12,6 +12,12 @@
   },
   "onCreateCommand": ".devcontainer/setup.sh",
   "postCreateCommand": "",
+  "forwardPorts": [6080],
+  "portsAttributes": {
+    "6080": {
+      "label": "desktop"
+    }
+  },
   "customizations": {
     "vscode": {
       "extensions": [
@@ -28,10 +34,5 @@
         "doc/devel/codespaces.md"
       ]
     }
-  },
-  "portsAttributes": {
-    "6080": {
-      "label": "desktop"
-    }
   }
 }

From c50f62bc7530e877b718c0929f3302ec9172aad3 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 3 Jul 2023 20:07:23 +0000
Subject: [PATCH 0009/1120] [pre-commit.ci] pre-commit autoupdate
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

updates:
- [github.com/codespell-project/codespell: v2.2.4 → v2.2.5](https://github.com/codespell-project/codespell/compare/v2.2.4...v2.2.5)
---
 .pre-commit-config.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 198624ec9911..e213bf188f4c 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -34,7 +34,7 @@ repos:
         additional_dependencies: [pydocstyle>5.1.0, flake8-docstrings>1.4.0, flake8-force]
         args: ["--docstring-convention=all"]
   - repo: https://github.com/codespell-project/codespell
-    rev: v2.2.4
+    rev: v2.2.5
     hooks:
       - id: codespell
         files: ^.*\.(py|c|cpp|h|m|md|rst|yml)$

From fcf75ddbe535fe6a562efbe88f928437b2cd43a6 Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Fri, 23 Jun 2023 12:23:49 +0200
Subject: [PATCH 0010/1120] Synchronize mathtext docs and handling

---
 doc/sphinxext/math_symbol_table.py            | 98 ++++++++-----------
 .../next_whats_new/mathtext_documentation.rst |  5 +
 .../mathtext_relation_operators.rst           |  2 -
 lib/matplotlib/_mathtext.py                   | 75 +++++++++++---
 lib/matplotlib/_mathtext_data.py              |  6 +-
 lib/matplotlib/tests/test_mathtext.py         |  2 +-
 6 files changed, 109 insertions(+), 79 deletions(-)
 create mode 100644 doc/users/next_whats_new/mathtext_documentation.rst

diff --git a/doc/sphinxext/math_symbol_table.py b/doc/sphinxext/math_symbol_table.py
index 74b1ac638d73..a195e073831f 100644
--- a/doc/sphinxext/math_symbol_table.py
+++ b/doc/sphinxext/math_symbol_table.py
@@ -1,7 +1,11 @@
+import re
 from docutils.parsers.rst import Directive
 
 from matplotlib import _mathtext, _mathtext_data
 
+bb_pattern = re.compile("Bbb[A-Z]")
+scr_pattern = re.compile("scr[a-zA-Z]")
+frak_pattern = re.compile("frak[A-Z]")
 
 symbols = [
     ["Lower-case Greek",
@@ -18,6 +22,9 @@
     ["Hebrew",
      6,
      (r"\aleph", r"\beth", r"\gimel", r"\daleth")],
+    ["Latin named characters",
+     6,
+     r"""\aa \AA \ae \AE \oe \OE \O \o \thorn \Thorn \ss \eth \dh \DH""".split()],
     ["Delimiters",
      5,
      _mathtext.Parser._delims],
@@ -27,71 +34,42 @@
     ["Standard function names",
      5,
      {fr"\{fn}" for fn in _mathtext.Parser._function_names}],
-    ["Binary operation and relation symbols",
+    ["Binary operation symbols",
+     4,
+     _mathtext.Parser._binary_operators],
+    ["Relation symbols",
      4,
-     r"""\ast \pm \slash \cap \star \mp \cup \cdot \uplus
-     \triangleleft \circ \odot \sqcap \triangleright \bullet \ominus
-     \sqcup \bigcirc \oplus \wedge \diamond \oslash \vee
-     \bigtriangledown \times \otimes \dag \bigtriangleup \div \wr
-     \ddag \barwedge \veebar \boxplus \curlywedge \curlyvee \boxminus
-     \Cap \Cup \boxtimes \bot \top \dotplus \boxdot \intercal
-     \rightthreetimes \divideontimes \leftthreetimes \equiv \leq \geq
-     \perp \cong \prec \succ \mid \neq \preceq \succeq \parallel \sim
-     \ll \gg \bowtie \simeq \subset \supset \Join \approx \subseteq
-     \supseteq \ltimes \asymp \sqsubset \sqsupset \rtimes \doteq
-     \sqsubseteq \sqsupseteq \smile \propto \dashv \vdash \frown
-     \models \in \ni \notin \approxeq \leqq \geqq \lessgtr \leqslant
-     \geqslant \lesseqgtr \backsim \lessapprox \gtrapprox \lesseqqgtr
-     \backsimeq \lll \ggg \gtreqqless \triangleq \lessdot \gtrdot
-     \gtreqless \circeq \lesssim \gtrsim \gtrless \bumpeq \eqslantless
-     \eqslantgtr \backepsilon \Bumpeq \precsim \succsim \between
-     \doteqdot \precapprox \succapprox \pitchfork \Subset \Supset
-     \fallingdotseq \subseteqq \supseteqq \risingdotseq \sqsubset
-     \sqsupset \varpropto \preccurlyeq \succcurlyeq \Vdash \therefore
-     \curlyeqprec \curlyeqsucc \vDash \because \blacktriangleleft
-     \blacktriangleright \Vvdash \eqcirc \trianglelefteq
-     \trianglerighteq \neq \vartriangleleft \vartriangleright \ncong
-     \nleq \ngeq \nsubseteq \nmid \nsupseteq \nparallel \nless \ngtr
-     \nprec \nsucc \subsetneq \nsim \supsetneq \nVDash \precnapprox
-     \succnapprox \subsetneqq \nvDash \precnsim \succnsim \supsetneqq
-     \nvdash \lnapprox \gnapprox \ntriangleleft \ntrianglelefteq
-     \lneqq \gneqq \ntriangleright \lnsim \gnsim \ntrianglerighteq
-     \coloneq \eqsim \nequiv \napprox \nsupset \doublebarwedge \nVdash
-     \Doteq \nsubset \eqcolon \ne
-     """.split()],
+     _mathtext.Parser._relation_symbols],
     ["Arrow symbols",
      4,
-     r"""\leftarrow \longleftarrow \uparrow \Leftarrow \Longleftarrow
-     \Uparrow \rightarrow \longrightarrow \downarrow \Rightarrow
-     \Longrightarrow \Downarrow \leftrightarrow \updownarrow
-     \longleftrightarrow \updownarrow \Leftrightarrow
-     \Longleftrightarrow \Updownarrow \mapsto \longmapsto \nearrow
-     \hookleftarrow \hookrightarrow \searrow \leftharpoonup
-     \rightharpoonup \swarrow \leftharpoondown \rightharpoondown
-     \nwarrow \rightleftharpoons \leadsto \dashrightarrow
-     \dashleftarrow \leftleftarrows \leftrightarrows \Lleftarrow
-     \Rrightarrow \twoheadleftarrow \leftarrowtail \looparrowleft
-     \leftrightharpoons \curvearrowleft \circlearrowleft \Lsh
-     \upuparrows \upharpoonleft \downharpoonleft \multimap
-     \leftrightsquigarrow \rightrightarrows \rightleftarrows
-     \rightrightarrows \rightleftarrows \twoheadrightarrow
-     \rightarrowtail \looparrowright \rightleftharpoons
-     \curvearrowright \circlearrowright \Rsh \downdownarrows
-     \upharpoonright \downharpoonright \rightsquigarrow \nleftarrow
-     \nrightarrow \nLeftarrow \nRightarrow \nleftrightarrow
-     \nLeftrightarrow \to \Swarrow \Searrow \Nwarrow \Nearrow
-     \leftsquigarrow
-     """.split()],
+     _mathtext.Parser._arrow_symbols],
+    ["Dot symbols",
+     4,
+     r"""\cdots \vdots \ldots \ddots \adots \Colon \therefore \because""".split()],
+    ["Black-board characters",
+     6,
+     [fr"\{symbol}" for symbol in _mathtext_data.tex2uni
+      if re.match(bb_pattern, symbol)]],
+    ["Script characters",
+     6,
+     [fr"\{symbol}" for symbol in _mathtext_data.tex2uni
+      if re.match(scr_pattern, symbol)]],
+    ["Fraktur characters",
+     6,
+     [fr"\{symbol}" for symbol in _mathtext_data.tex2uni
+      if re.match(frak_pattern, symbol)]],
     ["Miscellaneous symbols",
      4,
      r"""\neg \infty \forall \wp \exists \bigstar \angle \partial
-     \nexists \measuredangle \eth \emptyset \sphericalangle \clubsuit
+     \nexists \measuredangle \emptyset \sphericalangle \clubsuit
      \varnothing \complement \diamondsuit \imath \Finv \triangledown
-     \heartsuit \jmath \Game \spadesuit \ell \hbar \vartriangle \cdots
-     \hslash \vdots \blacksquare \ldots \blacktriangle \ddots \sharp
+     \heartsuit \jmath \Game \spadesuit \ell \hbar \vartriangle
+     \hslash \blacksquare \blacktriangle \sharp \increment
      \prime \blacktriangledown \Im \flat \backprime \Re \natural
-     \circledS \P \copyright \ss \circledR \S \yen \AA \checkmark \$
-     \cent \triangle \QED \sinewave \nabla \mho""".split()]
+     \circledS \P \copyright \circledR \S \yen \checkmark \$
+     \cent \triangle \QED \sinewave \dag \ddag \perthousand
+     \lambdabar \L \l \degree \danger \maltese
+     \i \hermitmatrix \sterling \nabla \mho""".split()],
 ]
 
 
@@ -165,7 +143,9 @@ def setup(app):
                 if sym[1:] not in _mathtext_data.tex2uni:
                     print(sym)
 
+    # Add accents
+    all_symbols.update({v[1:]: k for k, v in _mathtext.Parser._accent_map.items()})
     print("SYMBOLS NOT IN TABLE:")
-    for sym in _mathtext_data.tex2uni:
+    for sym, val in _mathtext_data.tex2uni.items():
         if sym not in all_symbols:
-            print(sym)
+            print(f"{sym} = {chr(val)}")
diff --git a/doc/users/next_whats_new/mathtext_documentation.rst b/doc/users/next_whats_new/mathtext_documentation.rst
new file mode 100644
index 000000000000..2b7cd51b702c
--- /dev/null
+++ b/doc/users/next_whats_new/mathtext_documentation.rst
@@ -0,0 +1,5 @@
+``mathtext`` documentation improvements
+---------------------------------------
+
+The documentation is updated to take information directly from the parser. This
+means that (almost) all supported symbols, operators etc are shown at :ref:`mathtext`.
diff --git a/doc/users/next_whats_new/mathtext_relation_operators.rst b/doc/users/next_whats_new/mathtext_relation_operators.rst
index 7bc7f47bdddc..1f9773a845df 100644
--- a/doc/users/next_whats_new/mathtext_relation_operators.rst
+++ b/doc/users/next_whats_new/mathtext_relation_operators.rst
@@ -5,5 +5,3 @@ There has been a number of operators added and corrected when a Unicode font is
 In addition, correct spacing has been added to a number of the previous operators.
 Especially, the characters used for ``\gnapprox``, ``\lnapprox``, ``\leftangle``, and
 ``\rightangle`` have been corrected.
-
-All supported operators can be seen at :ref:`mathtext`.
diff --git a/lib/matplotlib/_mathtext.py b/lib/matplotlib/_mathtext.py
index d86385e94589..7a8cd0ae96fa 100644
--- a/lib/matplotlib/_mathtext.py
+++ b/lib/matplotlib/_mathtext.py
@@ -1734,7 +1734,17 @@ class _MathStyle(enum.Enum):
       \cap            \triangleleft            \dagger
       \cup            \triangleright           \ddagger
       \uplus          \lhd                     \amalg
-      \dotplus        \dotminus'''.split())
+      \dotplus        \dotminus                \Cap
+      \Cup            \barwedge                \boxdot
+      \boxminus       \boxplus                 \boxtimes
+      \curlyvee       \curlywedge              \divideontimes
+      \doublebarwedge \leftthreetimes          \rightthreetimes
+      \slash          \veebar                  \barvee
+      \cupdot         \intercal                \amalg
+      \circledcirc    \circleddash             \circledast
+      \boxbar         \obar                    \merge
+      \minuscolon     \dotsminusdots
+      '''.split())
 
     _relation_symbols = set(r'''
       = < > :
@@ -1768,21 +1778,54 @@ class _MathStyle(enum.Enum):
       \triangleright     \ntriangleleft      \ntriangleright
       \trianglelefteq    \ntrianglelefteq    \trianglerighteq
       \ntrianglerighteq  \blacktriangleleft  \blacktriangleright
-      \equalparallel     \measuredrightangle \varlrtriangle
-      '''.split())
-
-    _arrow_symbols = set(r'''
-      \leftarrow              \longleftarrow           \uparrow
-      \Leftarrow              \Longleftarrow           \Uparrow
-      \rightarrow             \longrightarrow          \downarrow
-      \Rightarrow             \Longrightarrow          \Downarrow
-      \leftrightarrow         \longleftrightarrow      \updownarrow
-      \Leftrightarrow         \Longleftrightarrow      \Updownarrow
-      \mapsto                 \longmapsto              \nearrow
-      \hookleftarrow          \hookrightarrow          \searrow
-      \leftharpoonup          \rightharpoonup          \swarrow
-      \leftharpoondown        \rightharpoondown        \nwarrow
-      \rightleftharpoons      \leadsto'''.split())
+      \equalparallel     \measuredrightangle \lrtriangle
+      \Doteq        \Bumpeq       \Subset      \Supset
+      \backepsilon  \because      \therefore   \bot
+      \top          \bumpeq       \circeq      \coloneq
+      \curlyeqprec  \curlyeqsucc  \eqcirc      \eqcolon
+      \eqsim        \fallingdotseq \gtrdot     \gtrless
+      \ltimes       \rtimes       \lessdot     \ne
+      \ncong        \nequiv       \ngeq        \ngtr
+      \nleq         \nless        \nmid        \notin
+      \nprec        \nsubset      \nsubseteq   \nsucc
+      \nsupset      \nsupseteq    \pitchfork   \preccurlyeq
+      \risingdotseq \subsetneq    \succcurlyeq \supsetneq
+      \varpropto    \vartriangleleft \scurel
+      \vartriangleright \rightangle \equal     \backcong
+      \eqdef        \wedgeq       \questeq     \between
+      \veeeq        \disin        \varisins    \isins
+      \isindot      \varisinobar  \isinobar    \isinvb
+      \isinE        \nisd         \varnis      \nis
+      \varniobar    \niobar       \bagmember   \ratio
+      \Equiv        \stareq       \measeq      \arceq
+      \rightassert  \rightModels  \smallin     \smallowns
+      \notsmallowns'''.split())
+
+    _arrow_symbols = set(r"""
+     \leftarrow \longleftarrow \uparrow \Leftarrow \Longleftarrow
+     \Uparrow \rightarrow \longrightarrow \downarrow \Rightarrow
+     \Longrightarrow \Downarrow \leftrightarrow \updownarrow
+     \longleftrightarrow \updownarrow \Leftrightarrow
+     \Longleftrightarrow \Updownarrow \mapsto \longmapsto \nearrow
+     \hookleftarrow \hookrightarrow \searrow \leftharpoonup
+     \rightharpoonup \swarrow \leftharpoondown \rightharpoondown
+     \nwarrow \rightleftharpoons \leadsto \dashrightarrow
+     \dashleftarrow \leftleftarrows \leftrightarrows \Lleftarrow
+     \Rrightarrow \twoheadleftarrow \leftarrowtail \looparrowleft
+     \leftrightharpoons \curvearrowleft \circlearrowleft \Lsh
+     \upuparrows \upharpoonleft \downharpoonleft \multimap
+     \leftrightsquigarrow \rightrightarrows \rightleftarrows
+     \rightrightarrows \rightleftarrows \twoheadrightarrow
+     \rightarrowtail \looparrowright \rightleftharpoons
+     \curvearrowright \circlearrowright \Rsh \downdownarrows
+     \upharpoonright \downharpoonright \rightsquigarrow \nleftarrow
+     \nrightarrow \nLeftarrow \nRightarrow \nleftrightarrow
+     \nLeftrightarrow \to \Swarrow \Searrow \Nwarrow \Nearrow
+     \leftsquigarrow \overleftarrow \overleftrightarrow \cwopencirclearrow
+     \downzigzagarrow \cupleftarrow \rightzigzagarrow \twoheaddownarrow
+     \updownarrowbar \twoheaduparrow \rightarrowbar \updownarrows
+     \barleftarrow \mapsfrom \mapsdown \mapsup \Ldsh \Rdsh
+     """.split())
 
     _spaced_symbols = _binary_operators | _relation_symbols | _arrow_symbols
 
diff --git a/lib/matplotlib/_mathtext_data.py b/lib/matplotlib/_mathtext_data.py
index 40ba4f96f103..8d1bffc57570 100644
--- a/lib/matplotlib/_mathtext_data.py
+++ b/lib/matplotlib/_mathtext_data.py
@@ -800,6 +800,8 @@
     'eta'                      : 951,
     'forall'                   : 8704,
     'eth'                      : 240,
+    'dh'                       : 240,
+    'DH'                       : 208,
     'colon'                    : 58,
     'sqcup'                    : 8852,
     'bigsqcup'                 : 10758,
@@ -1066,7 +1068,7 @@
     'hermitmatrix'             : 8889,
     'barvee'                   : 8893,
     'measuredrightangle'       : 8894,
-    'varlrtriangle'            : 8895,
+    'lrtriangle'               : 8895,
     'equalparallel'            : 8917,
     'npreccurlyeq'             : 8928,
     'nsucccurlyeq'             : 8929,
@@ -1090,6 +1092,8 @@
     'bagmember'                : 8959,
     'triangle'                 : 9651,
     'iiiint'                   : 10764,
+    'amalg'                    : 10815,
+    'merge'                    : 10837,
 }
 
 # Each element is a 4-tuple of the form:
diff --git a/lib/matplotlib/tests/test_mathtext.py b/lib/matplotlib/tests/test_mathtext.py
index dab981f29a23..bae09c7dbe95 100644
--- a/lib/matplotlib/tests/test_mathtext.py
+++ b/lib/matplotlib/tests/test_mathtext.py
@@ -525,7 +525,7 @@ def test_mathtext_operators():
     \ngtrsim \nlessgtr \ngtrless
     \cupleftarrow \oequal \rightassert
     \rightModels \hermitmatrix \barvee
-    \measuredrightangle \varlrtriangle
+    \measuredrightangle \lrtriangle
     \equalparallel \npreccurlyeq \nsucccurlyeq
     \nsqsubseteq \nsqsupseteq \sqsubsetneq
     \sqsupsetneq  \disin \varisins

From 24c7333be2934a0dce9cae51af59b6a2a5759e0f Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Thu, 27 Jul 2023 23:17:14 -0500
Subject: [PATCH 0011/1120] Add aas (abbrev for antialiaseds) to codespell
 ignores

---
 ci/codespell-ignore-words.txt | 1 +
 1 file changed, 1 insertion(+)

diff --git a/ci/codespell-ignore-words.txt b/ci/codespell-ignore-words.txt
index a450473ab3e4..1a29d054cdc3 100644
--- a/ci/codespell-ignore-words.txt
+++ b/ci/codespell-ignore-words.txt
@@ -1,3 +1,4 @@
+aas
 ans
 axises
 ba

From 6dfdc023153cb76df74963c9e417c12248c7fb5b Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 9 Aug 2023 18:52:42 -0400
Subject: [PATCH 0012/1120] MNT: Remove consider argument from
 Legend._find_best_position

It is never passed in explicitly, and this is otherwise private.
---
 lib/matplotlib/legend.py | 19 ++++++-------------
 1 file changed, 6 insertions(+), 13 deletions(-)

diff --git a/lib/matplotlib/legend.py b/lib/matplotlib/legend.py
index 18bb7242e34e..7855fa095482 100644
--- a/lib/matplotlib/legend.py
+++ b/lib/matplotlib/legend.py
@@ -1158,13 +1158,8 @@ def _get_anchored_bbox(self, loc, bbox, parentbbox, renderer):
             loc, bbox, parentbbox,
             self.borderaxespad * renderer.points_to_pixels(self._fontsize))
 
-    def _find_best_position(self, width, height, renderer, consider=None):
-        """
-        Determine the best location to place the legend.
-
-        *consider* is a list of ``(x, y)`` pairs to consider as a potential
-        lower-left corner of the legend. All are display coords.
-        """
+    def _find_best_position(self, width, height, renderer):
+        """Determine the best location to place the legend."""
         assert self.isaxes  # always holds, as this is only called internally
 
         start_time = time.perf_counter()
@@ -1172,14 +1167,12 @@ def _find_best_position(self, width, height, renderer, consider=None):
         bboxes, lines, offsets = self._auto_legend_data()
 
         bbox = Bbox.from_bounds(0, 0, width, height)
-        if consider is None:
-            consider = [self._get_anchored_bbox(x, bbox,
-                                                self.get_bbox_to_anchor(),
-                                                renderer)
-                        for x in range(1, len(self.codes))]
 
         candidates = []
-        for idx, (l, b) in enumerate(consider):
+        for idx in range(1, len(self.codes)):
+            l, b = self._get_anchored_bbox(idx, bbox,
+                                           self.get_bbox_to_anchor(),
+                                           renderer)
             legendBox = Bbox.from_bounds(l, b, width, height)
             badness = 0
             # XXX TODO: If markers are present, it would be good to take them

From 35163568b388aa0cd699ac88877c3f6916b7bb37 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 9 Aug 2023 23:24:47 -0400
Subject: [PATCH 0013/1120] Ensure legend(loc='best') warning is always
 triggered

If a candidate location was picked, then that would be returned directly
without warning even if it took just as long.
---
 lib/matplotlib/legend.py | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/legend.py b/lib/matplotlib/legend.py
index 7855fa095482..18d0ee913237 100644
--- a/lib/matplotlib/legend.py
+++ b/lib/matplotlib/legend.py
@@ -1174,7 +1174,6 @@ def _find_best_position(self, width, height, renderer):
                                            self.get_bbox_to_anchor(),
                                            renderer)
             legendBox = Bbox.from_bounds(l, b, width, height)
-            badness = 0
             # XXX TODO: If markers are present, it would be good to take them
             # into account when checking vertex overlaps in the next line.
             badness = (sum(legendBox.count_contains(line.vertices)
@@ -1183,10 +1182,10 @@ def _find_best_position(self, width, height, renderer):
                        + legendBox.count_overlaps(bboxes)
                        + sum(line.intersects_bbox(legendBox, filled=False)
                              for line in lines))
-            if badness == 0:
-                return l, b
             # Include the index to favor lower codes in case of a tie.
             candidates.append((badness, idx, (l, b)))
+            if badness == 0:
+                break
 
         _, _, (l, b) = min(candidates)
 

From 3cc6610597ee16a0cce39f7b033ae529972177e7 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 10 Aug 2023 00:09:53 -0400
Subject: [PATCH 0014/1120] TST: Improve test for Legend(loc='best') warning

By patching the timer instead of using actually large data, we can both
a) speed up these tests (~7.5s vs <0.2s for both), and b) consistently
trigger the warning even on systems which are fast (such as the M1
systems on Cirrus.)

Also, copy the test data from `test_legend_auto3`, which correctly hits
all candidate locations for the 'best' legend locator without having to
fill up the entire Axes with data.
---
 lib/matplotlib/tests/test_legend.py | 38 ++++++++++++++++++++---------
 1 file changed, 27 insertions(+), 11 deletions(-)

diff --git a/lib/matplotlib/tests/test_legend.py b/lib/matplotlib/tests/test_legend.py
index 759ac6aadaff..1549354ba56b 100644
--- a/lib/matplotlib/tests/test_legend.py
+++ b/lib/matplotlib/tests/test_legend.py
@@ -1,5 +1,7 @@
 import collections
+import itertools
 import platform
+import time
 from unittest import mock
 import warnings
 
@@ -1109,29 +1111,43 @@ def test_usetex_no_warn(caplog):
     assert "Font family ['serif'] not found." not in caplog.text
 
 
-def test_warn_big_data_best_loc():
+def test_warn_big_data_best_loc(monkeypatch):
+    # Force _find_best_position to think it took a long time.
+    counter = itertools.count(0, step=1.5)
+    monkeypatch.setattr(time, 'perf_counter', lambda: next(counter))
+
     fig, ax = plt.subplots()
     fig.canvas.draw()  # So that we can call draw_artist later.
-    for idx in range(1000):
-        ax.plot(np.arange(5000), label=idx)
+
+    # Place line across all possible legend locations.
+    x = [0.9, 0.1, 0.1, 0.9, 0.9, 0.5]
+    y = [0.95, 0.95, 0.05, 0.05, 0.5, 0.5]
+    ax.plot(x, y, 'o-', label='line')
+
     with rc_context({'legend.loc': 'best'}):
         legend = ax.legend()
-    with pytest.warns(UserWarning) as records:
+    with pytest.warns(UserWarning,
+                      match='Creating legend with loc="best" can be slow with large '
+                      'amounts of data.') as records:
         fig.draw_artist(legend)  # Don't bother drawing the lines -- it's slow.
     # The _find_best_position method of Legend is called twice, duplicating
     # the warning message.
     assert len(records) == 2
-    for record in records:
-        assert str(record.message) == (
-            'Creating legend with loc="best" can be slow with large '
-            'amounts of data.')
 
 
-def test_no_warn_big_data_when_loc_specified():
+def test_no_warn_big_data_when_loc_specified(monkeypatch):
+    # Force _find_best_position to think it took a long time.
+    counter = itertools.count(0, step=1.5)
+    monkeypatch.setattr(time, 'perf_counter', lambda: next(counter))
+
     fig, ax = plt.subplots()
     fig.canvas.draw()
-    for idx in range(1000):
-        ax.plot(np.arange(5000), label=idx)
+
+    # Place line across all possible legend locations.
+    x = [0.9, 0.1, 0.1, 0.9, 0.9, 0.5]
+    y = [0.95, 0.95, 0.05, 0.05, 0.5, 0.5]
+    ax.plot(x, y, 'o-', label='line')
+
     legend = ax.legend('best')
     fig.draw_artist(legend)  # Check that no warning is emitted.
 

From af3780d90c894156de47b0d01b0285b086c44d34 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Wed, 9 Aug 2023 20:00:39 -0400
Subject: [PATCH 0015/1120] print theme versions

---
 doc/conf.py | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/doc/conf.py b/doc/conf.py
index 1d6c352435e2..4658f0059068 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -144,6 +144,14 @@ def _check_dependencies():
         raise ImportError(
             "The following dependencies are missing to build the "
             f"documentation: {', '.join(missing)}")
+
+    # debug sphinx-pydata-theme and mpl-theme-version
+    if 'mpl_sphinx_theme' not in missing:
+        import pydata_sphinx_theme
+        import mpl_sphinx_theme
+        print(f"pydata sphinx theme: {pydata_sphinx_theme.__version__}")
+        print(f"mpl sphinx theme: {mpl_sphinx_theme.__version__}")
+
     if shutil.which('dot') is None:
         raise OSError(
             "No binary named dot - graphviz must be installed to build the "

From 09ab594011cd5c7712c03a2b6a5348d3c224ab9c Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Wed, 19 Jul 2023 04:12:07 +0200
Subject: [PATCH 0016/1120] Test some untested Locator code and code
 improvements

---
 lib/matplotlib/tests/test_ticker.py | 51 ++++++++++++++++++++++
 lib/matplotlib/ticker.py            | 67 +++++++++++------------------
 2 files changed, 76 insertions(+), 42 deletions(-)

diff --git a/lib/matplotlib/tests/test_ticker.py b/lib/matplotlib/tests/test_ticker.py
index 9a1c8f0f5881..52a78055bfb1 100644
--- a/lib/matplotlib/tests/test_ticker.py
+++ b/lib/matplotlib/tests/test_ticker.py
@@ -38,6 +38,27 @@ def test_integer(self, vmin, vmax, steps, expected):
         loc = mticker.MaxNLocator(nbins=5, integer=True, steps=steps)
         assert_almost_equal(loc.tick_values(vmin, vmax), expected)
 
+    @pytest.mark.parametrize('kwargs, errortype, match', [
+        ({'foo': 0}, TypeError,
+         re.escape("set_params() got an unexpected keyword argument 'foo'")),
+        ({'steps': [2, 1]}, ValueError, "steps argument must be an increasing"),
+        ({'steps': 2}, ValueError, "steps argument must be an increasing"),
+        ({'steps': [2, 11]}, ValueError, "steps argument must be an increasing"),
+    ])
+    def test_errors(self, kwargs, errortype, match):
+        with pytest.raises(errortype, match=match):
+            mticker.MaxNLocator(**kwargs)
+
+    @pytest.mark.parametrize('steps, result', [
+        ([1, 2, 10], [1, 2, 10]),
+        ([2, 10], [1, 2, 10]),
+        ([1, 2], [1, 2, 10]),
+        ([2], [1, 2, 10]),
+    ])
+    def test_padding(self, steps, result):
+        loc = mticker.MaxNLocator(steps=steps)
+        assert (loc._steps == result).all()
+
 
 class TestLinearLocator:
     def test_basic(self):
@@ -45,6 +66,10 @@ def test_basic(self):
         test_value = np.array([-0.8, -0.3, 0.2])
         assert_almost_equal(loc.tick_values(-0.8, 0.2), test_value)
 
+    def test_zero_numticks(self):
+        loc = mticker.LinearLocator(numticks=0)
+        loc.tick_values(-0.8, 0.2) == []
+
     def test_set_params(self):
         """
         Create linear locator with presets={}, numticks=2 and change it to
@@ -55,6 +80,15 @@ def test_set_params(self):
         assert loc.numticks == 8
         assert loc.presets == {(0, 1): []}
 
+    def test_presets(self):
+        loc = mticker.LinearLocator(presets={(1, 2): [1, 1.25, 1.75],
+                                             (0, 2): [0.5, 1.5]})
+        assert loc.tick_values(1, 2) == [1, 1.25, 1.75]
+        assert loc.tick_values(2, 1) == [1, 1.25, 1.75]
+        assert loc.tick_values(0, 2) == [0.5, 1.5]
+        assert loc.tick_values(0.0, 2.0) == [0.5, 1.5]
+        assert (loc.tick_values(0, 1) == np.linspace(0, 1, 11)).all()
+
 
 class TestMultipleLocator:
     def test_basic(self):
@@ -590,6 +624,23 @@ def test_values(self, vmin, vmax, expected):
         ticks = sym.tick_values(vmin=vmin, vmax=vmax)
         assert_array_equal(ticks, expected)
 
+    def test_subs(self):
+        sym = mticker.SymmetricalLogLocator(base=10, linthresh=1, subs=[2.0, 4.0])
+        sym.create_dummy_axis()
+        sym.axis.set_view_interval(-10, 10)
+        assert (sym() == [-20., -40.,  -2.,  -4.,   0.,   2.,   4.,  20.,  40.]).all()
+
+    def test_extending(self):
+        sym = mticker.SymmetricalLogLocator(base=10, linthresh=1)
+        sym.create_dummy_axis()
+        sym.axis.set_view_interval(8, 9)
+        assert (sym() == [1.0]).all()
+        sym.axis.set_view_interval(8, 12)
+        assert (sym() == [1.0, 10.0]).all()
+        assert sym.view_limits(10, 10) == (1, 100)
+        assert sym.view_limits(-10, -10) == (-100, -1)
+        assert sym.view_limits(0, 0) == (-0.001, 0.001)
+
 
 class TestAsinhLocator:
     def test_init(self):
diff --git a/lib/matplotlib/ticker.py b/lib/matplotlib/ticker.py
index b4793929de9b..df848ef04ad8 100644
--- a/lib/matplotlib/ticker.py
+++ b/lib/matplotlib/ticker.py
@@ -657,12 +657,12 @@ def format_data(self, value):
         # docstring inherited
         e = math.floor(math.log10(abs(value)))
         s = round(value / 10**e, 10)
-        exponent = self._format_maybe_minus_and_locale("%d", e)
         significand = self._format_maybe_minus_and_locale(
             "%d" if s % 1 == 0 else "%1.10g", s)
         if e == 0:
             return significand
-        elif self._useMathText or self._usetex:
+        exponent = self._format_maybe_minus_and_locale("%d", e)
+        if self._useMathText or self._usetex:
             exponent = "10^{%s}" % exponent
             return (exponent if s == 1  # reformat 1x10^y as 10^y
                     else rf"{significand} \times {exponent}")
@@ -675,7 +675,6 @@ def get_offset(self):
         """
         if len(self.locs) == 0:
             return ''
-        s = ''
         if self.orderOfMagnitude or self.offset:
             offsetStr = ''
             sciNotStr = ''
@@ -694,8 +693,8 @@ def get_offset(self):
                 s = fr'${sciNotStr}\mathdefault{{{offsetStr}}}$'
             else:
                 s = ''.join((sciNotStr, offsetStr))
-
-        return self.fix_minus(s)
+            return self.fix_minus(s)
+        return ''
 
     def set_locs(self, locs):
         # docstring inherited
@@ -1055,9 +1054,6 @@ def _non_decade_format(self, sign_string, base, fx, usetex):
 
     def __call__(self, x, pos=None):
         # docstring inherited
-        usetex = mpl.rcParams['text.usetex']
-        min_exp = mpl.rcParams['axes.formatter.min_exponent']
-
         if x == 0:  # Symlog
             return r'$\mathdefault{0}$'
 
@@ -1070,23 +1066,25 @@ def __call__(self, x, pos=None):
         is_x_decade = _is_close_to_int(fx)
         exponent = round(fx) if is_x_decade else np.floor(fx)
         coeff = round(b ** (fx - exponent))
-        if is_x_decade:
-            fx = round(fx)
 
         if self.labelOnlyBase and not is_x_decade:
             return ''
         if self._sublabels is not None and coeff not in self._sublabels:
             return ''
 
+        if is_x_decade:
+            fx = round(fx)
+
         # use string formatting of the base if it is not an integer
         if b % 1 == 0.0:
             base = '%d' % b
         else:
             base = '%s' % b
 
-        if abs(fx) < min_exp:
+        if abs(fx) < mpl.rcParams['axes.formatter.min_exponent']:
             return r'$\mathdefault{%s%g}$' % (sign_string, x)
         elif not is_x_decade:
+            usetex = mpl.rcParams['text.usetex']
             return self._non_decade_format(sign_string, base, fx, usetex)
         else:
             return r'$\mathdefault{%s%s^{%d}}$' % (sign_string, base, fx)
@@ -1554,7 +1552,7 @@ def symbol(self):
         symbol = self._symbol
         if not symbol:
             symbol = ''
-        elif mpl.rcParams['text.usetex'] and not self._is_latex:
+        elif not self._is_latex and mpl.rcParams['text.usetex']:
             # Source: http://www.personal.ceu.hu/tex/specchar.htm
             # Backslash must be first for this to work correctly since
             # it keeps getting added in
@@ -1801,8 +1799,6 @@ def __call__(self):
 
     def tick_values(self, vmin, vmax):
         vmin, vmax = mtransforms.nonsingular(vmin, vmax, expander=0.05)
-        if vmax < vmin:
-            vmin, vmax = vmax, vmin
 
         if (vmin, vmax) in self.presets:
             return self.presets[(vmin, vmax)]
@@ -2356,13 +2352,13 @@ def tick_values(self, vmin, vmax):
         numdec = math.floor(log_vmax) - math.ceil(log_vmin)
 
         if isinstance(self._subs, str):
-            _first = 2.0 if self._subs == 'auto' else 1.0
             if numdec > 10 or b < 3:
                 if self._subs == 'auto':
                     return np.array([])  # no minor or major ticks
                 else:
                     subs = np.array([1.0])  # major ticks
             else:
+                _first = 2.0 if self._subs == 'auto' else 1.0
                 subs = np.arange(_first, b)
         else:
             subs = self._subs
@@ -2386,23 +2382,14 @@ def tick_values(self, vmin, vmax):
         decades = np.arange(math.floor(log_vmin) - stride,
                             math.ceil(log_vmax) + 2 * stride, stride)
 
-        if hasattr(self, '_transform'):
-            ticklocs = self._transform.inverted().transform(decades)
-            if have_subs:
-                if stride == 1:
-                    ticklocs = np.ravel(np.outer(subs, ticklocs))
-                else:
-                    # No ticklocs if we have >1 decade between major ticks.
-                    ticklocs = np.array([])
-        else:
-            if have_subs:
-                if stride == 1:
-                    ticklocs = np.concatenate(
-                        [subs * decade_start for decade_start in b ** decades])
-                else:
-                    ticklocs = np.array([])
+        if have_subs:
+            if stride == 1:
+                ticklocs = np.concatenate(
+                    [subs * decade_start for decade_start in b ** decades])
             else:
-                ticklocs = b ** decades
+                ticklocs = np.array([])
+        else:
+            ticklocs = b ** decades
 
         _log.debug('ticklocs %r', ticklocs)
         if (len(subs) > 1
@@ -2422,8 +2409,8 @@ def view_limits(self, vmin, vmax):
         vmin, vmax = self.nonsingular(vmin, vmax)
 
         if mpl.rcParams['axes.autolimit_mode'] == 'round_numbers':
-            vmin = _decade_less_equal(vmin, self._base)
-            vmax = _decade_greater_equal(vmax, self._base)
+            vmin = _decade_less_equal(vmin, b)
+            vmax = _decade_greater_equal(vmax, b)
 
         return vmin, vmax
 
@@ -2503,7 +2490,6 @@ def __call__(self):
         return self.tick_values(vmin, vmax)
 
     def tick_values(self, vmin, vmax):
-        base = self._base
         linthresh = self._linthresh
 
         if vmax < vmin:
@@ -2540,6 +2526,8 @@ def tick_values(self, vmin, vmax):
         # Check if linear range is present
         has_b = (has_a and vmax > -linthresh) or (has_c and vmin < linthresh)
 
+        base = self._base
+
         def get_log_range(lo, hi):
             lo = np.floor(np.log(lo) / np.log(base))
             hi = np.ceil(np.log(hi) / np.log(base))
@@ -2573,11 +2561,7 @@ def get_log_range(lo, hi):
         if has_c:
             decades.extend(base ** (np.arange(c_lo, c_hi, stride)))
 
-        # Add the subticks if requested
-        if self._subs is None:
-            subs = np.arange(2.0, base)
-        else:
-            subs = np.asarray(self._subs)
+        subs = np.asarray(self._subs)
 
         if len(subs) > 1 or subs[0] != 1.0:
             ticklocs = []
@@ -2604,8 +2588,7 @@ def view_limits(self, vmin, vmax):
                 vmin = _decade_less(vmin, b)
                 vmax = _decade_greater(vmax, b)
 
-        result = mtransforms.nonsingular(vmin, vmax)
-        return result
+        return mtransforms.nonsingular(vmin, vmax)
 
 
 class AsinhLocator(Locator):
@@ -2773,7 +2756,7 @@ def tick_values(self, vmin, vmax):
         # linscale: ... 1e-3 1e-2 1e-1 1/2 1-1e-1 1-1e-2 1-1e-3 ...
         # b-scale : ... -3   -2   -1   0   1      2      3      ...
         def ideal_ticks(x):
-            return 10 ** x if x < 0 else 1 - (10 ** (-x)) if x > 0 else 1 / 2
+            return 10 ** x if x < 0 else 1 - (10 ** (-x)) if x > 0 else 0.5
 
         vmin, vmax = self.nonsingular(vmin, vmax)
         binf = int(

From a3b58b2f2a361dc3fac27bffea91b8638383e709 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 10 Aug 2023 16:55:14 -0400
Subject: [PATCH 0017/1120] DOC: Remove unused image rotator

The use of the rotator was dropped in #26332. Currently, it causes an
exception on every page, because there is no 'image_rotator' element,
but this is only visible in the console or, if you have the inspector
open, it'll start the debugger.
---
 doc/_static/image-rotator.js | 46 ------------------------------------
 doc/conf.py                  |  1 -
 2 files changed, 47 deletions(-)
 delete mode 100644 doc/_static/image-rotator.js

diff --git a/doc/_static/image-rotator.js b/doc/_static/image-rotator.js
deleted file mode 100644
index f056b5b0c254..000000000000
--- a/doc/_static/image-rotator.js
+++ /dev/null
@@ -1,46 +0,0 @@
-// accessible JavaScript tab switcher
-// modified from https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/Tab_Role
-
-function getRandomInt(max) {
-  return Math.floor(Math.random() * max);
-}
-
-var images_rotate = [
-    {"image": "sphx_glr_plot_001_2_00x.png", "caption": "plot(x, y)", "link": "plot_types/basic/plot.html"},
-    {"image": "sphx_glr_fill_between_001_2_00x.png", "caption": "fill_between(x, y1, y2)", "link": "plot_types/basic/fill_between.html"},
-    {"image": "sphx_glr_scatter_plot_001_2_00x.png", "caption": "scatter(x, y)", "link": "plot_types/basic/scatter_plot.html"},
-    {"image": "sphx_glr_pcolormesh_001_2_00x.png", "caption": "pcolormesh(X, Y, Z)", "link": "plot_types/arrays/pcolormesh.html"},
-    {"image": "sphx_glr_contourf_001_2_00x.png", "caption": "contourf(X, Y, Z)", "link": "plot_types/arrays/contourf.html"},
-    {"image": "sphx_glr_stairs_001_2_00x.png", "caption": "stairs(y)", "link": "plot_types/basic/stairs.html"},
-    {"image": "sphx_glr_streamplot_001_2_00x.png", "caption": "streamplot(X, Y, U, V)", "link": "plot_types/arrays/streamplot.html"},
-    {"image": "sphx_glr_bar_001_2_00x.png", "caption": "bar(x, height) / barh(y, width)", "link": "plot_types/basic/bar.html"},
-    {"image": "sphx_glr_hist_plot_001_2_00x.png", "caption": "hist(x)", "link": "plot_types/stats/hist_plot.html"},
-    {"image": "sphx_glr_imshow_001_2_00x.png", "caption": "imshow(Z)", "link": "plot_types/arrays/imshow.html"},
-];
-
-document.addEventListener("DOMContentLoaded", function(event) {
-  ///////////////////////////////////////
-  // rotate images in images-rotate directory:
-  var ind = getRandomInt(images_rotate.length);
-  var info = images_rotate[ind];
-  var img_src = "../_images/" + info.image;
-  var caption = info.caption;
-  var link = "https://matplotlib.org/stable/" + info.link;
-  var html = '<a href="' + link + '">' +
-    '<img class="imrot-img" src="' + img_src + '" aria-labelledby="sample-plot-caption"/>' +
-    '<div class="imrot-cap" id="sample-plot-caption">' + caption + '</div>' +
-    '</a>';
-document.getElementById('image_rotator').innerHTML = html;
-
-  ind = getRandomInt(images_rotate.length);
-  info = images_rotate[ind];
-  img_src = "../_images/" + info.image;
-  caption = info.caption;
-  link = "https://matplotlib.org/stable/" + info.link;
-  html = '<a href="' + link + '">' +
-  '<img class="imrot-img" src="' + img_src + '" aria-labelledby="sample-plot-caption"/>' +
-  '<div class="imrot-cap" id="sample-plot-caption">' + caption + '</div>' +
-  '</a>';
-document.getElementById('image_rotator2').innerHTML = html;
-
-});
diff --git a/doc/conf.py b/doc/conf.py
index 4658f0059068..65781e694958 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -785,5 +785,4 @@ def setup(app):
         bld_type = 'rel'
     app.add_config_value('skip_sub_dirs', 0, '')
     app.add_config_value('releaselevel', bld_type, 'env')
-    app.add_js_file('image-rotator.js')
     app.connect('html-page-context', add_html_cache_busting, priority=1000)

From 897549be1a0da4963c009a6772c9a3dce2374563 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 10 Aug 2023 17:50:48 -0400
Subject: [PATCH 0018/1120] Import PIL.Image explicitly over PIL

We seem to use `PIL.Image.*` pretty often while only importing `PIL`.
This mostly works, but seems to be by fluke depending on what may or may
not have imported `PIL.Image`.

For example, if you have a file that just does `import
matplotlib.widgets` (which itself imports only `PIL`), then `mypy` will
crash due to incomplete `PIL`.
---
 lib/matplotlib/axes/_axes.pyi         | 2 +-
 lib/matplotlib/backends/backend_wx.py | 2 +-
 lib/matplotlib/image.py               | 1 +
 lib/matplotlib/image.pyi              | 2 +-
 lib/matplotlib/pyplot.py              | 2 +-
 lib/matplotlib/widgets.pyi            | 2 +-
 6 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.pyi b/lib/matplotlib/axes/_axes.pyi
index bdd29684925d..30c0622b89f5 100644
--- a/lib/matplotlib/axes/_axes.pyi
+++ b/lib/matplotlib/axes/_axes.pyi
@@ -30,7 +30,7 @@ import matplotlib.stackplot as mstack
 import matplotlib.streamplot as mstream
 
 import datetime
-import PIL
+import PIL.Image
 from collections.abc import Callable, Sequence
 from typing import Any, Literal, overload
 import numpy as np
diff --git a/lib/matplotlib/backends/backend_wx.py b/lib/matplotlib/backends/backend_wx.py
index a2952557edce..218be8947695 100644
--- a/lib/matplotlib/backends/backend_wx.py
+++ b/lib/matplotlib/backends/backend_wx.py
@@ -15,7 +15,7 @@
 import weakref
 
 import numpy as np
-import PIL
+import PIL.Image
 
 import matplotlib as mpl
 from matplotlib.backend_bases import (
diff --git a/lib/matplotlib/image.py b/lib/matplotlib/image.py
index 55126c9c0f38..757f0ba3476e 100644
--- a/lib/matplotlib/image.py
+++ b/lib/matplotlib/image.py
@@ -10,6 +10,7 @@
 import warnings
 
 import numpy as np
+import PIL.Image
 import PIL.PngImagePlugin
 
 import matplotlib as mpl
diff --git a/lib/matplotlib/image.pyi b/lib/matplotlib/image.pyi
index d39490457eae..426e34ec83c9 100644
--- a/lib/matplotlib/image.pyi
+++ b/lib/matplotlib/image.pyi
@@ -5,7 +5,7 @@ from typing import Any, BinaryIO, Literal
 
 import numpy as np
 from numpy.typing import ArrayLike, NDArray
-import PIL  # type: ignore
+import PIL.Image
 
 import matplotlib.artist as martist
 from matplotlib.axes import Axes
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 11a998334b6e..415d5c042241 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -88,7 +88,7 @@
     from typing import Any, BinaryIO, Literal, TypeVar
     from typing_extensions import ParamSpec
 
-    import PIL
+    import PIL.Image
     from numpy.typing import ArrayLike
 
     from matplotlib.axis import Tick
diff --git a/lib/matplotlib/widgets.pyi b/lib/matplotlib/widgets.pyi
index 8af25957e9d1..00c2d0da8a7e 100644
--- a/lib/matplotlib/widgets.pyi
+++ b/lib/matplotlib/widgets.pyi
@@ -7,7 +7,7 @@ from .lines import Line2D
 from .patches import Circle, Polygon, Rectangle
 from .text import Text
 
-import PIL
+import PIL.Image
 
 from collections.abc import Callable, Collection, Iterable, Sequence
 from typing import Any, Literal

From ee02182c54628301f7e2359d597d121299600c17 Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Sat, 24 Jun 2023 15:04:41 +0200
Subject: [PATCH 0019/1120] Do not space symbols in limits

---
 doc/sphinxext/math_symbol_table.py            |  9 +++++----
 doc/users/next_whats_new/mathtext_spacing.rst |  5 +++++
 lib/matplotlib/_mathtext.py                   | 12 +++++++-----
 lib/matplotlib/_mathtext_data.py              |  4 ++--
 lib/matplotlib/tests/test_mathtext.py         |  2 +-
 5 files changed, 20 insertions(+), 12 deletions(-)
 create mode 100644 doc/users/next_whats_new/mathtext_spacing.rst

diff --git a/doc/sphinxext/math_symbol_table.py b/doc/sphinxext/math_symbol_table.py
index a195e073831f..ee1022e75fef 100644
--- a/doc/sphinxext/math_symbol_table.py
+++ b/doc/sphinxext/math_symbol_table.py
@@ -67,8 +67,8 @@
      \hslash \blacksquare \blacktriangle \sharp \increment
      \prime \blacktriangledown \Im \flat \backprime \Re \natural
      \circledS \P \copyright \circledR \S \yen \checkmark \$
-     \cent \triangle \QED \sinewave \dag \ddag \perthousand
-     \lambdabar \L \l \degree \danger \maltese
+     \cent \triangle \QED \sinewave \dag \ddag \perthousand \ac
+     \lambdabar \L \l \degree \danger \maltese \clubsuitopen
      \i \hermitmatrix \sterling \nabla \mho""".split()],
 ]
 
@@ -76,14 +76,14 @@
 def run(state_machine):
 
     def render_symbol(sym, ignore_variant=False):
-        if ignore_variant and sym != r"\varnothing":
+        if ignore_variant and sym not in (r"\varnothing", r"\varlrtriangle"):
             sym = sym.replace(r"\var", "\\")
         if sym.startswith("\\"):
             sym = sym.lstrip("\\")
             if sym not in (_mathtext.Parser._overunder_functions |
                            _mathtext.Parser._function_names):
                 sym = chr(_mathtext_data.tex2uni[sym])
-        return f'\\{sym}' if sym in ('\\', '|') else sym
+        return f'\\{sym}' if sym in ('\\', '|', '+', '-', '*') else sym
 
     lines = []
     for category, columns, syms in symbols:
@@ -145,6 +145,7 @@ def setup(app):
 
     # Add accents
     all_symbols.update({v[1:]: k for k, v in _mathtext.Parser._accent_map.items()})
+    all_symbols.update({v: v for v in _mathtext.Parser._wide_accents})
     print("SYMBOLS NOT IN TABLE:")
     for sym, val in _mathtext_data.tex2uni.items():
         if sym not in all_symbols:
diff --git a/doc/users/next_whats_new/mathtext_spacing.rst b/doc/users/next_whats_new/mathtext_spacing.rst
new file mode 100644
index 000000000000..42da810c3a39
--- /dev/null
+++ b/doc/users/next_whats_new/mathtext_spacing.rst
@@ -0,0 +1,5 @@
+``mathtext`` spacing corrections
+--------------------------------
+
+As consequence of the updated documentation, the spacing on a number of relational and
+operator symbols were classified like that and therefore will be spaced properly.
diff --git a/lib/matplotlib/_mathtext.py b/lib/matplotlib/_mathtext.py
index 7a8cd0ae96fa..395c011f11b7 100644
--- a/lib/matplotlib/_mathtext.py
+++ b/lib/matplotlib/_mathtext.py
@@ -1778,7 +1778,7 @@ class _MathStyle(enum.Enum):
       \triangleright     \ntriangleleft      \ntriangleright
       \trianglelefteq    \ntrianglelefteq    \trianglerighteq
       \ntrianglerighteq  \blacktriangleleft  \blacktriangleright
-      \equalparallel     \measuredrightangle \lrtriangle
+      \equalparallel     \measuredrightangle \varlrtriangle
       \Doteq        \Bumpeq       \Subset      \Supset
       \backepsilon  \because      \therefore   \bot
       \top          \bumpeq       \circeq      \coloneq
@@ -1799,7 +1799,7 @@ class _MathStyle(enum.Enum):
       \varniobar    \niobar       \bagmember   \ratio
       \Equiv        \stareq       \measeq      \arceq
       \rightassert  \rightModels  \smallin     \smallowns
-      \notsmallowns'''.split())
+      \notsmallowns \nsimeq'''.split())
 
     _arrow_symbols = set(r"""
      \leftarrow \longleftarrow \uparrow \Leftarrow \Longleftarrow
@@ -2154,9 +2154,11 @@ def symbol(self, s, loc, toks):
             # such as ${ -2}$, $ -2$, or $   -2$.
             prev_char = next((c for c in s[:loc][::-1] if c != ' '), '')
             # Binary operators at start of string should not be spaced
-            if (c in self._binary_operators and
-                    (len(s[:loc].split()) == 0 or prev_char == '{' or
-                     prev_char in self._left_delims)):
+            # Also, operators in sub- or superscripts should not be spaced
+            if (self._in_subscript_or_superscript or (
+                    c in self._binary_operators and (
+                    len(s[:loc].split()) == 0 or prev_char == '{' or
+                    prev_char in self._left_delims))):
                 return [char]
             else:
                 return [Hlist([self._make_space(0.2),
diff --git a/lib/matplotlib/_mathtext_data.py b/lib/matplotlib/_mathtext_data.py
index 8d1bffc57570..d37cdff22e57 100644
--- a/lib/matplotlib/_mathtext_data.py
+++ b/lib/matplotlib/_mathtext_data.py
@@ -910,7 +910,7 @@
     'O'                        : 216,
     'hookleftarrow'            : 8617,
     'trianglerighteq'          : 8885,
-    'nsime'                    : 8772,
+    'nsimeq'                   : 8772,
     'oe'                       : 339,
     'nwarrow'                  : 8598,
     'o'                        : 248,
@@ -1068,7 +1068,7 @@
     'hermitmatrix'             : 8889,
     'barvee'                   : 8893,
     'measuredrightangle'       : 8894,
-    'lrtriangle'               : 8895,
+    'varlrtriangle'            : 8895,
     'equalparallel'            : 8917,
     'npreccurlyeq'             : 8928,
     'nsucccurlyeq'             : 8929,
diff --git a/lib/matplotlib/tests/test_mathtext.py b/lib/matplotlib/tests/test_mathtext.py
index bae09c7dbe95..dab981f29a23 100644
--- a/lib/matplotlib/tests/test_mathtext.py
+++ b/lib/matplotlib/tests/test_mathtext.py
@@ -525,7 +525,7 @@ def test_mathtext_operators():
     \ngtrsim \nlessgtr \ngtrless
     \cupleftarrow \oequal \rightassert
     \rightModels \hermitmatrix \barvee
-    \measuredrightangle \lrtriangle
+    \measuredrightangle \varlrtriangle
     \equalparallel \npreccurlyeq \nsucccurlyeq
     \nsqsubseteq \nsqsupseteq \sqsubsetneq
     \sqsupsetneq  \disin \varisins

From a01fbaeba4bdefc2ff6782bac73a9a03b8a9bce7 Mon Sep 17 00:00:00 2001
From: Adam Turner <9087854+aa-turner@users.noreply.github.com>
Date: Fri, 11 Aug 2023 01:48:00 +0100
Subject: [PATCH 0020/1120] Disable ``add_html_cache_busting`` on Sphinx 7.1+

---
 doc/conf.py | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/doc/conf.py b/doc/conf.py
index 65781e694958..66b367c9e267 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -19,6 +19,8 @@
 import sys
 from urllib.parse import urlsplit, urlunsplit
 import warnings
+
+import sphinx
 import yaml
 
 import matplotlib
@@ -408,6 +410,9 @@ def add_html_cache_busting(app, pagename, templatename, context, doctree):
     This adds the Matplotlib version as a query to the link reference in the
     HTML, if the path is not absolute (i.e., it comes from the `_static`
     directory) and doesn't already have a query.
+
+    .. note:: Sphinx 7.1 provides asset checksums; so this hook only runs on
+              Sphinx 7.0 and earlier.
     """
     from sphinx.builders.html import Stylesheet, JavaScript
 
@@ -785,4 +790,5 @@ def setup(app):
         bld_type = 'rel'
     app.add_config_value('skip_sub_dirs', 0, '')
     app.add_config_value('releaselevel', bld_type, 'env')
-    app.connect('html-page-context', add_html_cache_busting, priority=1000)
+    if sphinx.version_info[:2] < (7, 1):
+        app.connect('html-page-context', add_html_cache_busting, priority=1000)

From 9a089fb03e92b7419e40b16b1fb1ce172c29e116 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Melissa=20Weber=20Mendon=C3=A7a?= <melissawm@gmail.com>
Date: Fri, 11 Aug 2023 11:07:11 -0300
Subject: [PATCH 0021/1120] Addressing reviewer's comments

* Reducing duplication by linking out to contribute guide
* Rewording instructions and adding notes on codespaces-specific workflows
---
 doc/devel/codespaces.md  | 106 ++-------------------------------------
 doc/devel/contribute.rst | 100 +++++++++++++++++-------------------
 2 files changed, 51 insertions(+), 155 deletions(-)

diff --git a/doc/devel/codespaces.md b/doc/devel/codespaces.md
index 3a41aae560a3..f0a4f96ba249 100644
--- a/doc/devel/codespaces.md
+++ b/doc/devel/codespaces.md
@@ -1,107 +1,9 @@
 # Contributing to Matplotlib using GitHub codespaces
 
-You've discovered a bug or something else you want to change
-in Matplotlib — excellent!
+For a general overview of contributing to Matplotlib, see https://matplotlib.org/devdocs/devel/index.html
 
-You've worked out a way to fix it — even better!
+For instructions on how to submit Pull Requests using GitHub codespaces, see https://matplotlib.org/devdocs/devel/contribute.html#contributing-code
 
-You want to tell us about it — best of all!
+For instructions on running tests to verify your changes, see https://matplotlib.org/devdocs/devel/testing.html
 
-This project is a community effort, and everyone is welcome to contribute.
-Everyone within the community is expected to abide by our
-[Code of Conduct](../../CODE_OF_CONDUCT.md).
-
-## GitHub codespaces contribution workflow
-
-The preferred way to contribute to Matplotlib is to fork the main
-repository at https://github.com/matplotlib/matplotlib, then submit a "pull
-request" (PR). You can do this by cloning a copy of the Maplotlib repository to
-your own computer, or alternatively using
-[GitHub Codespaces](https://docs.github.com/codespaces) (a cloud-based
-in-browser development environment, that comes with the appropriated setup to
-contribute to Matplotlib).
-
-A brief overview of the workflows is as follows.
-
-1. Go to the GitHub web interface
-2. Fork the [project repository](https://github.com/matplotlib/matplotlib):
-3. Open codespaces on your fork by clicking on the green "Code" button on the
-   GitHub web interface and selecting the "Codespaces" tab. Next, click on "Open
-   codespaces on <your fork name>". You will be able to change branches later,
-   so you can select the default `main` branch.
-
-   After the codespace is created, you will be taken to a new browser tab where
-   you can use the terminal to activate a pre-defined conda environment called
-   `mpl-dev`:
-
-   ```
-   conda activate mpl-dev
-   ```
-
-4. Install the local version of Matplotlib with:
-
-   ```
-   python -m pip install -e .
-   ```
-
-   (See [Setting up Matplotlib for development](https://matplotlib.org/devdocs/devel/development_setup.html)
-   for detailed instructions.)
-
-5. Create a branch to hold your changes:
-
-   ```
-   git checkout -b my-feature origin/main
-   ```
-
-   and start making changes. Never work in the `main` branch!
-
-6. Work on this task using Git to do the version control. Codespaces persist for
-   some time (check the [documentation for details](https://docs.github.com/codespaces/getting-started/the-codespace-lifecycle))
-   and can be managed on https://github.com/codespaces. When you're done editing
-   e.g., `lib/matplotlib/collections.py`, do:
-
-   ```
-   git add lib/matplotlib/collections.py
-   git commit
-   ```
-
-   to record your changes in Git, then push them to your GitHub fork with:
-
-   ```
-   git push -u origin my-feature
-   ```
-
-Finally, go to the web page of your fork of the Matplotlib repo, and click
-'Pull request' to send your changes to the maintainers for review.
-
-## Other stuff you may want to do
-
-* If you need to run tests to verify your changes before sending your PR, you
-  can run (in your `mpl-dev` conda environment):
-
-  ```
-  pytest
-  ```
-
-* If you need to build the documentation, you can move to the `doc` folder and
-  run (in your `mpl-dev` conda environment):
-
-  ```
-  cd doc
-  make html
-  ```
-
-* If you need to open a GUI window with Matplotlib output, our Codespaces
-  configuration includes a
-  [light-weight Fluxbox-based desktop](https://github.com/devcontainers/features/tree/main/src/desktop-lite).
-  You can use it by connecting to this desktop via your web browser. To do this:
-
-  1. Press `F1` or `Ctrl/Cmd+Shift+P` and select `Ports: Focus on Ports View` in
-     VS Code to bring it into focus. Open the ports view in your tool, select
-     the `noVNC` port, and click the Globe icon.
-  2. In the browser that appears, click the Connect button and enter the desktop
-     password (`vscode` by default).
-
-  Check the
-  [GitHub instructions](https://github.com/devcontainers/features/tree/main/src/desktop-lite#connecting-to-the-desktop)
-  for more details on connecting to the desktop.
+For instructions on building the Matplotlib documentation, see https://matplotlib.org/devdocs/devel/document.html#documenting-matplotlib
diff --git a/doc/devel/contribute.rst b/doc/devel/contribute.rst
index 2f8ed9271e10..62e4d50af8c5 100644
--- a/doc/devel/contribute.rst
+++ b/doc/devel/contribute.rst
@@ -230,55 +230,26 @@ contribute to Matplotlib).
 
 A brief overview of the workflows is as follows.
 
-.. tab-set::
+1. `Create an account <https://github.com/join>`_ on GitHub if you do not
+   already have one.
 
-    .. tab-item:: Local development
+2. Fork the `project repository <https://github.com/matplotlib/matplotlib>`_:
+   click on the 'Fork' button near the top of the page. This creates a copy of
+   the code under your account on the GitHub server.
 
-        1. `Create an account <https://github.com/join>`_ on GitHub if you do
-           not already have one.
+.. tab-set::
 
-        2. Fork the
-           `project repository <https://github.com/matplotlib/matplotlib>`_:
-           click on the 'Fork' button near the top of the page. This creates a
-           copy of the code under your account on the GitHub server.
+    .. tab-item:: Local development
 
         3. Clone this copy to your local disk::
 
              git clone https://github.com/<YOUR GITHUB USERNAME>/matplotlib.git
 
-        4. Enter the directory and install the local version of Matplotlib.
-           See :ref:`installing_for_devs` for instructions
-
-        5. Create a branch to hold your changes::
-
-             git checkout -b my-feature origin/main
-
-           and start making changes. Never work in the ``main`` branch!
-
-        6. Work on this copy, on your computer, using Git to do the version
-           control. When you're done editing e.g.,
-           ``lib/matplotlib/collections.py``, do::
-
-             git add lib/matplotlib/collections.py
-             git commit
-
-           to record your changes in Git, then push them to GitHub with::
-
-             git push -u origin my-feature
-
     .. tab-item:: Using GitHub Codespaces
 
-        1. `Create an account <https://github.com/join>`_ on GitHub if you do
-           not already have one.
-
-        2. Fork the
-           `project repository <https://github.com/matplotlib/matplotlib>`_:
-           click on the 'Fork' button near the top of the page. This creates a
-           copy of the code under your account on the GitHub server.
-
         3. Open codespaces on your fork by clicking on the green "Code" button
            on the GitHub web interface and selecting the "Codespaces" tab. Next,
-           click on "Open codespaces on <your fork name>". You will be able to
+           click on "Open codespaces on <your branch name>". You will be able to
            change branches later, so you can select the default ``main`` branch.
 
            After the codespace is created, you will be taken to a new browser
@@ -287,31 +258,30 @@ A brief overview of the workflows is as follows.
 
             conda activate mpl-dev
 
-        4. Install the local version of Matplotlib with::
+4. Install the local version of Matplotlib with::
 
-             python -m pip install -e .
+     python -m pip install -e .
 
-           (See :ref:`installing_for_devs` for detailed instructions.)
+   (See :ref:`installing_for_devs` for detailed instructions.)
 
-        5. Create a branch to hold your changes::
+5. Create a branch to hold your changes::
 
-             git checkout -b my-feature origin/main
+     git checkout -b my-feature origin/main
 
-           and start making changes. Never work in the ``main`` branch!
+   and start making changes. Never work in the ``main`` branch!
 
-        6. Work on this task using Git to do the version control. Codespaces
-           persist for some time (check the `documentation for details
-           <https://docs.github.com/codespaces/getting-started/the-codespace-lifecycle>`_)
-           and can be managed on https://github.com/codespaces. When you're done
-           editing e.g., ``lib/matplotlib/collections.py``, do::
+6. Work on this task using Git to do the version control. Codespaces persist for
+   some time (check the `documentation for details
+   <https://docs.github.com/codespaces/getting-started/the-codespace-lifecycle>`_)
+   and can be managed on https://github.com/codespaces. When you're done editing
+   e.g., ``lib/matplotlib/collections.py``, do::
 
-             git add lib/matplotlib/collections.py
-             git commit
+     git add lib/matplotlib/collections.py
+     git commit
 
-           to record your changes in Git, then push them to your GitHub fork
-           with::
+   to record your changes in Git, then push them to your GitHub fork with::
 
-             git push -u origin my-feature
+     git push -u origin my-feature
 
 Finally, go to the web page of your fork of the Matplotlib repo, and click
 'Pull request' to send your changes to the maintainers for review.
@@ -319,6 +289,30 @@ Finally, go to the web page of your fork of the Matplotlib repo, and click
 For more detailed instructions on how to set up Matplotlib for development and
 best practices for contribution, see :ref:`installing_for_devs`.
 
+.. note:: GitHub Codespaces workflows
+
+  * If you need to open a GUI window with Matplotlib output on Codespaces, our
+    configuration includes a `light-weight Fluxbox-based desktop
+    <https://github.com/devcontainers/features/tree/main/src/desktop-lite>`_.
+    You can use it by connecting to this desktop via your web browser. To do
+    this:
+
+    1. Press ``F1`` or ``Ctrl/Cmd+Shift+P`` and select
+       ``Ports: Focus on Ports View`` in the VSCode session to bring it into
+       focus. Open the ports view in your tool, select the ``noVNC`` port, and
+       click the Globe icon.
+    2. In the browser that appears, click the Connect button and enter the desktop
+       password (``vscode`` by default).
+
+    Check the `GitHub instructions
+    <https://github.com/devcontainers/features/tree/main/src/desktop-lite#connecting-to-the-desktop>`_
+    for more details on connecting to the desktop.
+
+  * If you also built the documentation pages, you can view them using
+    Codespaces. Use the "Extensions" icon in the activity bar to install the
+    "Live Server" extension. Locate the ``doc/build/html`` folder in the
+    Explorer, right click the file you want to open and select "Open with Live
+    Server."
 
 .. _contributing_documentation:
 

From 97c999cdb73a49c26f6aa949b3c3cac8c9cd5830 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Melissa=20Weber=20Mendon=C3=A7a?= <melissawm@gmail.com>
Date: Fri, 11 Aug 2023 12:28:58 -0300
Subject: [PATCH 0022/1120] Fix Codespaces admonition title

---
 doc/devel/contribute.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/devel/contribute.rst b/doc/devel/contribute.rst
index 62e4d50af8c5..48aabfae286a 100644
--- a/doc/devel/contribute.rst
+++ b/doc/devel/contribute.rst
@@ -289,7 +289,7 @@ Finally, go to the web page of your fork of the Matplotlib repo, and click
 For more detailed instructions on how to set up Matplotlib for development and
 best practices for contribution, see :ref:`installing_for_devs`.
 
-.. note:: GitHub Codespaces workflows
+.. admonition:: GitHub Codespaces workflows
 
   * If you need to open a GUI window with Matplotlib output on Codespaces, our
     configuration includes a `light-weight Fluxbox-based desktop

From 06ceba5e8539e44e6390043f4434a0638cd6de78 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Melissa=20Weber=20Mendon=C3=A7a?= <melissawm@gmail.com>
Date: Fri, 11 Aug 2023 12:33:39 -0300
Subject: [PATCH 0023/1120] Add plausible analytics to the documentation pages

The Plausible service instance is provided by the Scientific Python project.
---
 doc/conf.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/doc/conf.py b/doc/conf.py
index 66b367c9e267..21da93ee6f58 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -484,7 +484,10 @@ def js_tag_with_cache_busting(js):
 }
 include_analytics = is_release_build
 if include_analytics:
-    html_theme_options["analytics"] = {"google_analytics_id": "UA-55954603-1"}
+    html_theme_options["analytics"] = {
+        "plausible_analytics_domain": "matplotlib.org",
+        "plausible_analytics_url": "https://views.scientific-python.org/js/script.js"
+    }
 
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,

From 1d56e654e269ba8b05304794d756cce664c5958f Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 11 Aug 2023 05:13:38 -0400
Subject: [PATCH 0024/1120] TST: Increase some tolerances for non-x86 arches

---
 lib/matplotlib/tests/test_axes.py             | 2 +-
 lib/mpl_toolkits/mplot3d/tests/test_axes3d.py | 5 ++++-
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index ac9dd0787a43..f1074d38e567 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -2502,7 +2502,7 @@ def test_contour_hatching():
 
 @image_comparison(
     ['contour_colorbar'], style='mpl20',
-    tol=0.02 if platform.machine() in ('aarch64', 'ppc64le', 's390x') else 0)
+    tol=0.54 if platform.machine() in ('aarch64', 'ppc64le', 's390x') else 0)
 def test_contour_colorbar():
     x, y, z = contour_dat()
 
diff --git a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
index ad04b12526c2..644e2f245812 100644
--- a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
@@ -1,5 +1,6 @@
 import functools
 import itertools
+import platform
 
 import pytest
 
@@ -217,7 +218,9 @@ def test_bar3d_lightsource():
     np.testing.assert_array_max_ulp(color, collection._facecolor3d[1::6], 4)
 
 
-@mpl3d_image_comparison(['contour3d.png'], style='mpl20')
+@mpl3d_image_comparison(
+    ['contour3d.png'], style='mpl20',
+    tol=0.002 if platform.machine() in ('aarch64', 'ppc64le', 's390x') else 0)
 def test_contour3d():
     fig = plt.figure()
     ax = fig.add_subplot(projection='3d')

From 029f852ade2b50821701abe16f571e4e84b72bfe Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Fri, 11 Aug 2023 20:21:30 -0500
Subject: [PATCH 0025/1120] TYP: Add overload to specify output of
 Colormap.__call__ when possible

Closes #26501
---
 lib/matplotlib/colors.pyi | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/lib/matplotlib/colors.pyi b/lib/matplotlib/colors.pyi
index 354250a7bd22..9bb1725f4f78 100644
--- a/lib/matplotlib/colors.pyi
+++ b/lib/matplotlib/colors.pyi
@@ -69,6 +69,15 @@ class Colormap:
     N: int
     colorbar_extend: bool
     def __init__(self, name: str, N: int = ...) -> None: ...
+    @overload
+    def __call__(
+        self, X: Sequence[float] | np.ndarray, alpha: ArrayLike | None = ..., bytes: bool = ...
+    ) -> np.ndarray: ...
+    @overload
+    def __call__(
+        self, X: float, alpha: float | None = ..., bytes: bool = ...
+    ) -> tuple[float, float, float, float]: ...
+    @overload
     def __call__(
         self, X: ArrayLike, alpha: ArrayLike | None = ..., bytes: bool = ...
     ) -> tuple[float, float, float, float] | np.ndarray: ...

From f9d4000c1db8852392a57e93d93431e8edd813ce Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Sat, 12 Aug 2023 19:38:06 +0200
Subject: [PATCH 0026/1120] Update/tweak SpanSelector docs.

---
 lib/matplotlib/widgets.py | 28 +++++++---------------------
 1 file changed, 7 insertions(+), 21 deletions(-)

diff --git a/lib/matplotlib/widgets.py b/lib/matplotlib/widgets.py
index 00397104d624..b0d026e3095b 100644
--- a/lib/matplotlib/widgets.py
+++ b/lib/matplotlib/widgets.py
@@ -2548,12 +2548,9 @@ class SpanSelector(_SelectorWidget):
     ----------
     ax : `~matplotlib.axes.Axes`
 
-    onselect : callable
+    onselect : callable with signature ``func(min: float, max: float)``
         A callback function that is called after a release event and the
         selection is created, changed or removed.
-        It must have the signature::
-
-            def on_select(min: float, max: float) -> Any
 
     direction : {"horizontal", "vertical"}
         The direction along which to draw the span selector.
@@ -2564,22 +2561,14 @@ def on_select(min: float, max: float) -> Any
 
     useblit : bool, default: False
         If True, use the backend-dependent blitting features for faster
-        canvas updates. See the tutorial :ref:`blitting`
-        for details.
+        canvas updates. See the tutorial :ref:`blitting` for details.
 
-    props : dict, optional
+    props : dict, default: {'facecolor': 'red', 'alpha': 0.5}
         Dictionary of `matplotlib.patches.Patch` properties.
-        Default::
-
-            dict(facecolor='red', alpha=0.5)
 
-    onmove_callback : func(min, max), min/max are floats, default: None
+    onmove_callback : callable with signature ``func(min: float, max: float)``, optional
         Called on mouse move while the span is being selected.
 
-    span_stays : bool, default: False
-        If True, the span stays visible after the mouse is released.
-        Deprecated, use *interactive* instead.
-
     interactive : bool, default: False
         Whether to draw a set of handles that allow interaction with the
         widget after it is drawn.
@@ -2593,8 +2582,7 @@ def on_select(min: float, max: float) -> Any
         properties.
 
     grab_range : float, default: 10
-        Distance in pixels within which the interactive tool handles can be
-        activated.
+        Distance in pixels within which the interactive tool handles can be activated.
 
     state_modifier_keys : dict, optional
         Keyboard modifiers which affect the widget's behavior.  Values
@@ -2603,12 +2591,10 @@ def on_select(min: float, max: float) -> Any
         - "clear": Clear the current shape, default: "escape".
 
     drag_from_anywhere : bool, default: False
-        If `True`, the widget can be moved by clicking anywhere within
-        its bounds.
+        If `True`, the widget can be moved by clicking anywhere within its bounds.
 
     ignore_event_outside : bool, default: False
-        If `True`, the event triggered outside the span selector will be
-        ignored.
+        If `True`, the event triggered outside the span selector will be ignored.
 
     snap_values : 1D array-like, optional
         Snap the selector edges to the given values.

From ff16da1b92ce4258b1d9c5fbfec8d5dbef8e3d25 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Sun, 13 Aug 2023 15:32:25 +0200
Subject: [PATCH 0027/1120] Clarify interaction between params of
 get_path_collection_extents.

That master_transform is ignored is clear looking at the implementation
in _path.h (the `if (Ntransforms)` branch drops master_transform;
compare with the implementation of point_in_path_collection).  One can
also compare
```
from matplotlib.path import *; from matplotlib.transforms import *
get_path_collection_extents(
    Affine2D().scale(2, 3), [Path([(1, 2), (3, 4)])],
    [], [(0, 0)], IdentityTransform())
get_path_collection_extents(
    Affine2D().scale(2, 3), [Path([(1, 2), (3, 4)])],
    [IdentityTransform()], [(0, 0)], IdentityTransform())
```
---
 lib/matplotlib/path.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/lib/matplotlib/path.py b/lib/matplotlib/path.py
index a687db923c3c..e72eb1a9ca73 100644
--- a/lib/matplotlib/path.py
+++ b/lib/matplotlib/path.py
@@ -1063,6 +1063,7 @@ def get_path_collection_extents(
         Global transformation applied to all paths.
     paths : list of `Path`
     transforms : list of `~matplotlib.transforms.Affine2DBase`
+        If non-empty, this overrides *master_transform*.
     offsets : (N, 2) array-like
     offset_transform : `~matplotlib.transforms.Affine2DBase`
         Transform applied to the offsets before offsetting the path.

From d0642b219efa2d6edd7310fe7abb8be1be0d54fa Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Tue, 18 Oct 2022 11:52:32 +0200
Subject: [PATCH 0028/1120] List the webagg_core module in the sphinx docs.

---
 doc/api/backend_webagg_core_api.rst            | 8 ++++++++
 doc/api/index_backend_api.rst                  | 1 +
 doc/api/prev_api_changes/api_changes_2.1.0.rst | 2 +-
 lib/matplotlib/backend_bases.py                | 8 ++++----
 lib/matplotlib/backends/backend_webagg.py      | 4 +---
 lib/matplotlib/backends/backend_webagg_core.py | 4 +---
 6 files changed, 16 insertions(+), 11 deletions(-)
 create mode 100644 doc/api/backend_webagg_core_api.rst

diff --git a/doc/api/backend_webagg_core_api.rst b/doc/api/backend_webagg_core_api.rst
new file mode 100644
index 000000000000..0d1e58dd8f9f
--- /dev/null
+++ b/doc/api/backend_webagg_core_api.rst
@@ -0,0 +1,8 @@
+*******************************************
+``matplotlib.backends.backend_webagg_core``
+*******************************************
+
+.. automodule:: matplotlib.backends.backend_webagg_core
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/doc/api/index_backend_api.rst b/doc/api/index_backend_api.rst
index 639d96a9a0dd..6012f71c52a4 100644
--- a/doc/api/index_backend_api.rst
+++ b/doc/api/index_backend_api.rst
@@ -20,5 +20,6 @@
    backend_qt_api.rst
    backend_svg_api.rst
    backend_tk_api.rst
+   backend_webagg_core_api.rst
    backend_webagg_api.rst
    backend_wx_api.rst
diff --git a/doc/api/prev_api_changes/api_changes_2.1.0.rst b/doc/api/prev_api_changes/api_changes_2.1.0.rst
index 39ea78bdf587..7d72d95783bb 100644
--- a/doc/api/prev_api_changes/api_changes_2.1.0.rst
+++ b/doc/api/prev_api_changes/api_changes_2.1.0.rst
@@ -296,7 +296,7 @@ Third-party backends should also migrate to the ``*_dashes`` methods.
 ``NavigationToolbar2.dynamic_update``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Use :meth:`.draw_idle` method on the ``Canvas`` instance instead.
+Use `~.FigureCanvasBase.draw_idle` method on the ``Canvas`` instance instead.
 
 
 Testing
diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
index 840082cc91ea..36c72af3c696 100644
--- a/lib/matplotlib/backend_bases.py
+++ b/lib/matplotlib/backend_bases.py
@@ -1116,10 +1116,10 @@ def __init__(self, interval=None, callbacks=None):
             The time between timer events in milliseconds.  Will be stored as
             ``timer.interval``.
         callbacks : list[tuple[callable, tuple, dict]]
-            List of (func, args, kwargs) tuples that will be called upon
-            timer events.  This list is accessible as ``timer.callbacks`` and
-            can be manipulated directly, or the functions `add_callback` and
-            `remove_callback` can be used.
+            List of (func, args, kwargs) tuples that will be called upon timer
+            events.  This list is accessible as ``timer.callbacks`` and can be
+            manipulated directly, or the functions `~.TimerBase.add_callback`
+            and `~.TimerBase.remove_callback` can be used.
         """
         self.callbacks = [] if callbacks is None else callbacks.copy()
         # Set .interval and not ._interval to go through the property setter.
diff --git a/lib/matplotlib/backends/backend_webagg.py b/lib/matplotlib/backends/backend_webagg.py
index 27c6a885a69f..14c0b525fb8f 100644
--- a/lib/matplotlib/backends/backend_webagg.py
+++ b/lib/matplotlib/backends/backend_webagg.py
@@ -1,6 +1,4 @@
-"""
-Displays Agg images in the browser, with interactivity
-"""
+"""Displays Agg images in the browser, with interactivity."""
 
 # The WebAgg backend is divided into two modules:
 #
diff --git a/lib/matplotlib/backends/backend_webagg_core.py b/lib/matplotlib/backends/backend_webagg_core.py
index 4c7a553f0d2d..4ceac1699543 100644
--- a/lib/matplotlib/backends/backend_webagg_core.py
+++ b/lib/matplotlib/backends/backend_webagg_core.py
@@ -1,6 +1,4 @@
-"""
-Displays Agg images in the browser, with interactivity
-"""
+"""Displays Agg images in the browser, with interactivity."""
 # The WebAgg backend is divided into two modules:
 #
 # - `backend_webagg_core.py` contains code necessary to embed a WebAgg

From e2d45d56ca84372158938caf3a6bc3cb982583e5 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Sun, 13 Aug 2023 19:26:18 +0200
Subject: [PATCH 0029/1120] Replace reference to %pylab by %matplotlib.

... as %pylab is deprecated, and %matplotlib is really the relevant mode
here.
---
 lib/matplotlib/backend_bases.py | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
index 840082cc91ea..009410593b34 100644
--- a/lib/matplotlib/backend_bases.py
+++ b/lib/matplotlib/backend_bases.py
@@ -3412,9 +3412,9 @@ def show(cls, *, block=None):
         """
         Show all figures.
 
-        `show` blocks by calling `mainloop` if *block* is ``True``, or if it
-        is ``None`` and we are neither in IPython's ``%pylab`` mode, nor in
-        `interactive` mode.
+        `show` blocks by calling `mainloop` if *block* is ``True``, or if it is
+        ``None`` and we are not in `interactive` mode and if IPython's
+        ``%matplotlib`` integration has not been activated.
         """
         managers = Gcf.get_all_fig_managers()
         if not managers:
@@ -3427,9 +3427,9 @@ def show(cls, *, block=None):
         if cls.mainloop is None:
             return
         if block is None:
-            # Hack: Are we in IPython's %pylab mode?  In pylab mode, IPython
-            # (>= 0.10) tacks a _needmain attribute onto pyplot.show (always
-            # set to False).
+            # Hack: Is IPython's %matplotlib integration activated?  If so,
+            # IPython's activate_matplotlib (>= 0.10) tacks a _needmain
+            # attribute onto pyplot.show (always set to False).
             pyplot_show = getattr(sys.modules.get("matplotlib.pyplot"), "show", None)
             ipython_pylab = hasattr(pyplot_show, "_needmain")
             block = not ipython_pylab and not is_interactive()

From 69d796ac50fe6095ba9451c07a1dce668213cae5 Mon Sep 17 00:00:00 2001
From: Ratnabali Dutta <ratnabalidutta26@gmail.com>
Date: Mon, 14 Aug 2023 14:52:12 +0530
Subject: [PATCH 0030/1120] Fix mathtext mismatched braces

---
 lib/matplotlib/_mathtext.py           | 3 ++-
 lib/matplotlib/tests/test_mathtext.py | 4 +++-
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/_mathtext.py b/lib/matplotlib/_mathtext.py
index 25a825b7b0d9..4761ea7fc626 100644
--- a/lib/matplotlib/_mathtext.py
+++ b/lib/matplotlib/_mathtext.py
@@ -2030,7 +2030,8 @@ def main(self, s, loc, toks):
         return [Hlist(toks)]
 
     def math_string(self, s, loc, toks):
-        return self._math_expression.parseString(toks[0][1:-1])
+        return self._math_expression.parseString(toks[0][1:-1],
+                                                 parseAll=True)
 
     def math(self, s, loc, toks):
         hlist = Hlist(toks)
diff --git a/lib/matplotlib/tests/test_mathtext.py b/lib/matplotlib/tests/test_mathtext.py
index d80312495d91..ba30b9be214a 100644
--- a/lib/matplotlib/tests/test_mathtext.py
+++ b/lib/matplotlib/tests/test_mathtext.py
@@ -320,6 +320,7 @@ def test_fontinfo():
         (r'$a^2^2$', r'Double superscript'),
         (r'$a_2_2$', r'Double subscript'),
         (r'$a^2_a^2$', r'Double superscript'),
+        (r'$a = {b$', r'Expected end of text'),
     ],
     ids=[
         'hspace without value',
@@ -347,7 +348,8 @@ def test_fontinfo():
         'unknown symbol',
         'double superscript',
         'double subscript',
-        'super on sub without braces'
+        'super on sub without braces',
+        'math string with no closing braces'
     ]
 )
 def test_mathtext_exceptions(math, msg):

From 1fa70c69f7d7b42e41d0dea53e9792a33548c4eb Mon Sep 17 00:00:00 2001
From: Talha Irfan <engineer.khan@live.com>
Date: Mon, 14 Aug 2023 20:38:30 +0500
Subject: [PATCH 0031/1120] Replaced list with tuple in pyplot for axes

---
 lib/matplotlib/pyplot.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 415d5c042241..c804adc93cf6 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -1134,7 +1134,7 @@ def figlegend(*args, **kwargs) -> Legend:
 
 @_docstring.dedent_interpd
 def axes(
-    arg: None | tuple[float, float, float, float] = None,
+    arg: None | tuple(float, float, float, float) = None,
     **kwargs
 ) -> matplotlib.axes.Axes:
     """
@@ -1153,7 +1153,7 @@ def axes(
 
         - *None*: A new full window Axes is added using
           ``subplot(**kwargs)``.
-        - 4-tuple of floats *rect* = ``[left, bottom, width, height]``.
+        - 4-tuple of floats *rect* = ``(left, bottom, width, height)``.
           A new Axes is added with dimensions *rect* in normalized
           (0, 1) units using `~.Figure.add_axes` on the current figure.
 

From 8c3a9c02faa261be891a48adb723a562be1e6744 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Melissa=20Weber=20Mendon=C3=A7a?= <melissawm@gmail.com>
Date: Fri, 11 Aug 2023 18:48:49 -0300
Subject: [PATCH 0032/1120] Fix headings, wording and numbered list in
 codespaces docs

Co-authored-by: marbled-toast <69227427+marbled-toast@users.noreply.github.com>
Co-authored-by: hannah <story645@gmail.com>
---
 doc/devel/codespaces.md  |  8 ++---
 doc/devel/contribute.rst | 78 +++++++++++++++++++++-------------------
 2 files changed, 45 insertions(+), 41 deletions(-)

diff --git a/doc/devel/codespaces.md b/doc/devel/codespaces.md
index f0a4f96ba249..cb002c9b2e6e 100644
--- a/doc/devel/codespaces.md
+++ b/doc/devel/codespaces.md
@@ -1,9 +1,9 @@
 # Contributing to Matplotlib using GitHub codespaces
 
-For a general overview of contributing to Matplotlib, see https://matplotlib.org/devdocs/devel/index.html
+* For a general overview of contributing to Matplotlib, see https://matplotlib.org/devdocs/devel/index.html
 
-For instructions on how to submit Pull Requests using GitHub codespaces, see https://matplotlib.org/devdocs/devel/contribute.html#contributing-code
+* For instructions on how to submit Pull Requests using GitHub codespaces, see https://matplotlib.org/devdocs/devel/contribute.html#contributing-code
 
-For instructions on running tests to verify your changes, see https://matplotlib.org/devdocs/devel/testing.html
+* For instructions on running tests to verify your changes, see https://matplotlib.org/devdocs/devel/testing.html
 
-For instructions on building the Matplotlib documentation, see https://matplotlib.org/devdocs/devel/document.html#documenting-matplotlib
+* For instructions on building the Matplotlib documentation, see https://matplotlib.org/devdocs/devel/document.html#documenting-matplotlib
diff --git a/doc/devel/contribute.rst b/doc/devel/contribute.rst
index 48aabfae286a..4e03e0b2c811 100644
--- a/doc/devel/contribute.rst
+++ b/doc/devel/contribute.rst
@@ -224,11 +224,11 @@ The preferred way to contribute to Matplotlib is to fork the `main
 repository <https://github.com/matplotlib/matplotlib/>`__ on GitHub,
 then submit a "pull request" (PR). You can do this by cloning a copy of the
 Maplotlib repository to your own computer, or alternatively using
-`GitHub Codespaces <https://docs.github.com/codespaces>`_ (a cloud-based
-in-browser development environment, that comes with the appropriated setup to
-contribute to Matplotlib).
+`GitHub Codespaces <https://docs.github.com/codespaces>`_, a cloud-based
+in-browser development environment that comes with the appropriated setup to
+contribute to Matplotlib.
 
-A brief overview of the workflows is as follows.
+A brief overview of the workflow is as follows.
 
 1. `Create an account <https://github.com/join>`_ on GitHub if you do not
    already have one.
@@ -247,22 +247,27 @@ A brief overview of the workflows is as follows.
 
     .. tab-item:: Using GitHub Codespaces
 
-        3. Open codespaces on your fork by clicking on the green "Code" button
-           on the GitHub web interface and selecting the "Codespaces" tab. Next,
-           click on "Open codespaces on <your branch name>". You will be able to
-           change branches later, so you can select the default ``main`` branch.
+        3. Check out the Matplotlib repository and activate your development
+           environment:
 
-           After the codespace is created, you will be taken to a new browser
-           tab where you can use the terminal to activate a pre-defined conda
-           environment called ``mpl-dev``::
+           a. Open codespaces on your fork by clicking on the green "Code"
+              button on the GitHub web interface and selecting the "Codespaces"
+              tab. Next, click on "Open codespaces on <your branch name>". You
+              will be able to change branches later, so you can select the
+              default ``main`` branch.
+
+           b. After the codespace is created, you will be taken to a new browser
+              tab where you can use the terminal to activate a pre-defined conda
+              environment called ``mpl-dev``::
+
+                conda activate mpl-dev
 
-            conda activate mpl-dev
 
 4. Install the local version of Matplotlib with::
 
      python -m pip install -e .
 
-   (See :ref:`installing_for_devs` for detailed instructions.)
+   See :ref:`installing_for_devs` for detailed instructions.
 
 5. Create a branch to hold your changes::
 
@@ -289,30 +294,29 @@ Finally, go to the web page of your fork of the Matplotlib repo, and click
 For more detailed instructions on how to set up Matplotlib for development and
 best practices for contribution, see :ref:`installing_for_devs`.
 
-.. admonition:: GitHub Codespaces workflows
-
-  * If you need to open a GUI window with Matplotlib output on Codespaces, our
-    configuration includes a `light-weight Fluxbox-based desktop
-    <https://github.com/devcontainers/features/tree/main/src/desktop-lite>`_.
-    You can use it by connecting to this desktop via your web browser. To do
-    this:
-
-    1. Press ``F1`` or ``Ctrl/Cmd+Shift+P`` and select
-       ``Ports: Focus on Ports View`` in the VSCode session to bring it into
-       focus. Open the ports view in your tool, select the ``noVNC`` port, and
-       click the Globe icon.
-    2. In the browser that appears, click the Connect button and enter the desktop
-       password (``vscode`` by default).
-
-    Check the `GitHub instructions
-    <https://github.com/devcontainers/features/tree/main/src/desktop-lite#connecting-to-the-desktop>`_
-    for more details on connecting to the desktop.
-
-  * If you also built the documentation pages, you can view them using
-    Codespaces. Use the "Extensions" icon in the activity bar to install the
-    "Live Server" extension. Locate the ``doc/build/html`` folder in the
-    Explorer, right click the file you want to open and select "Open with Live
-    Server."
+GitHub Codespaces workflows
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* If you need to open a GUI window with Matplotlib output on Codespaces, our
+  configuration includes a `light-weight Fluxbox-based desktop
+  <https://github.com/devcontainers/features/tree/main/src/desktop-lite>`_.
+  You can use it by connecting to this desktop via your web browser. To do this:
+
+  1. Press ``F1`` or ``Ctrl/Cmd+Shift+P`` and select
+     ``Ports: Focus on Ports View`` in the VSCode session to bring it into
+     focus. Open the ports view in your tool, select the ``noVNC`` port, and
+     click the Globe icon.
+  2. In the browser that appears, click the Connect button and enter the desktop
+     password (``vscode`` by default).
+
+  Check the `GitHub instructions
+  <https://github.com/devcontainers/features/tree/main/src/desktop-lite#connecting-to-the-desktop>`_
+  for more details on connecting to the desktop.
+
+* If you also built the documentation pages, you can view them using Codespaces.
+  Use the "Extensions" icon in the activity bar to install the "Live Server"
+  extension. Locate the ``doc/build/html`` folder in the Explorer, right click
+  the file you want to open and select "Open with Live Server."
 
 .. _contributing_documentation:
 

From 204e971de6cca36faa8b8b5a458c686d06e0f0bc Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 11 Aug 2023 22:29:14 -0400
Subject: [PATCH 0033/1120] ci: Use new name for WQY-ZenHei font package

---
 .github/workflows/tests.yml | 8 ++++----
 azure-pipelines.yml         | 5 +++--
 2 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 2a67c7ffcbfb..a8514e22530d 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -102,7 +102,9 @@ jobs:
               cm-super \
               dvipng \
               ffmpeg \
+              fonts-freefont-otf \
               fonts-noto-cjk \
+              fonts-wqy-zenhei \
               gdb \
               gir1.2-gtk-3.0 \
               graphviz \
@@ -123,8 +125,6 @@ jobs:
               libxcb-render-util0 \
               libxcb-xinerama0 \
               lmodern \
-              fonts-freefont-otf \
-              texlive-pictures \
               pkg-config \
               qtbase5-dev \
               texlive-fonts-recommended \
@@ -132,8 +132,8 @@ jobs:
               texlive-latex-extra \
               texlive-latex-recommended \
               texlive-luatex \
-              texlive-xetex \
-              ttf-wqy-zenhei
+              texlive-pictures \
+              texlive-xetex
             if [[ "${{ matrix.os }}" = ubuntu-20.04 ]]; then
               sudo apt-get install -yy libopengl0
             else  # ubuntu-22.04
diff --git a/azure-pipelines.yml b/azure-pipelines.yml
index bb38804ae121..027923cdc3e9 100644
--- a/azure-pipelines.yml
+++ b/azure-pipelines.yml
@@ -97,6 +97,7 @@ stages:
               dvipng \
               ffmpeg \
               fonts-noto-cjk \
+              fonts-wqy-zenhei \
               gdb \
               gir1.2-gtk-3.0 \
               graphviz \
@@ -111,8 +112,8 @@ stages:
               texlive-latex-base \
               texlive-latex-extra \
               texlive-latex-recommended \
-              texlive-xetex texlive-luatex \
-              ttf-wqy-zenhei
+              texlive-luatex \
+              texlive-xetex
             ;;
           darwin)
             brew install --cask xquartz

From c774216be27350aef5b6b28ec7ade0b09915a9bb Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 11 Aug 2023 22:32:26 -0400
Subject: [PATCH 0034/1120] ci: Don't install recommended packages on Ubuntu

We don't need the optional packages and save a little download/install
time.
---
 .github/workflows/tests.yml | 13 +++++++------
 azure-pipelines.yml         |  2 +-
 2 files changed, 8 insertions(+), 7 deletions(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index a8514e22530d..2314f65225a9 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -97,7 +97,7 @@ jobs:
           Linux)
             echo 'Acquire::Retries "3";' | sudo tee /etc/apt/apt.conf.d/80-retries
             sudo apt-get update -yy
-            sudo apt-get install -yy \
+            sudo apt-get install -yy --no-install-recommends \
               ccache \
               cm-super \
               dvipng \
@@ -135,9 +135,10 @@ jobs:
               texlive-pictures \
               texlive-xetex
             if [[ "${{ matrix.os }}" = ubuntu-20.04 ]]; then
-              sudo apt-get install -yy libopengl0
+              sudo apt-get install -yy --no-install-recommends libopengl0
             else  # ubuntu-22.04
-              sudo apt-get install -yy gir1.2-gtk-4.0 libnotify4
+              sudo apt-get install -yy --no-install-recommends \
+                gir1.2-gtk-4.0 libnotify4
             fi
             ;;
           macOS)
@@ -178,10 +179,10 @@ jobs:
             ~/.cache/matplotlib
             !~/.cache/matplotlib/tex.cache
             !~/.cache/matplotlib/test_cache
-          key: 3-${{ runner.os }}-py${{ matrix.python-version }}-mpl-${{ github.ref }}-${{ github.sha }}
+          key: 4-${{ runner.os }}-py${{ matrix.python-version }}-mpl-${{ github.ref }}-${{ github.sha }}
           restore-keys: |
-            3-${{ runner.os }}-py${{ matrix.python-version }}-mpl-${{ github.ref }}-
-            3-${{ runner.os }}-py${{ matrix.python-version }}-mpl-
+            4-${{ runner.os }}-py${{ matrix.python-version }}-mpl-${{ github.ref }}-
+            4-${{ runner.os }}-py${{ matrix.python-version }}-mpl-
 
       - name: Install Python dependencies
         run: |
diff --git a/azure-pipelines.yml b/azure-pipelines.yml
index 027923cdc3e9..7d00e499fd18 100644
--- a/azure-pipelines.yml
+++ b/azure-pipelines.yml
@@ -92,7 +92,7 @@ stages:
           linux)
             echo 'Acquire::Retries "3";' | sudo tee /etc/apt/apt.conf.d/80-retries
             sudo apt update
-            sudo apt install \
+            sudo apt install --no-install-recommends \
               cm-super \
               dvipng \
               ffmpeg \

From 4f6681b474b4da57959175563ec9276d4e0e25ee Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 14 Aug 2023 19:59:11 +0000
Subject: [PATCH 0035/1120] Bump pypa/cibuildwheel from 2.14.1 to 2.15.0

Bumps [pypa/cibuildwheel](https://github.com/pypa/cibuildwheel) from 2.14.1 to 2.15.0.
- [Release notes](https://github.com/pypa/cibuildwheel/releases)
- [Changelog](https://github.com/pypa/cibuildwheel/blob/main/docs/changelog.md)
- [Commits](https://github.com/pypa/cibuildwheel/compare/f21bb8376a051ffb6cb5604b28ccaef7b90e8ab7...39a63b5912f086dd459cf6fcb13dcdd3fe3bc24d)

---
updated-dependencies:
- dependency-name: pypa/cibuildwheel
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 .github/workflows/cibuildwheel.yml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index abcd97592ad6..58b96d38c883 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -136,7 +136,7 @@ jobs:
           path: dist/
 
       - name: Build wheels for CPython 3.11
-        uses: pypa/cibuildwheel@f21bb8376a051ffb6cb5604b28ccaef7b90e8ab7 # v2.14.1
+        uses: pypa/cibuildwheel@39a63b5912f086dd459cf6fcb13dcdd3fe3bc24d # v2.15.0
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -144,7 +144,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.10
-        uses: pypa/cibuildwheel@f21bb8376a051ffb6cb5604b28ccaef7b90e8ab7 # v2.14.1
+        uses: pypa/cibuildwheel@39a63b5912f086dd459cf6fcb13dcdd3fe3bc24d # v2.15.0
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -152,7 +152,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.9
-        uses: pypa/cibuildwheel@f21bb8376a051ffb6cb5604b28ccaef7b90e8ab7 # v2.14.1
+        uses: pypa/cibuildwheel@39a63b5912f086dd459cf6fcb13dcdd3fe3bc24d # v2.15.0
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -160,7 +160,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for PyPy
-        uses: pypa/cibuildwheel@f21bb8376a051ffb6cb5604b28ccaef7b90e8ab7 # v2.14.1
+        uses: pypa/cibuildwheel@39a63b5912f086dd459cf6fcb13dcdd3fe3bc24d # v2.15.0
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:

From 34c7e524fa2b8862ecb4e47b72cb68f439dfdfda Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Melissa=20Weber=20Mendon=C3=A7a?= <melissawm@gmail.com>
Date: Mon, 14 Aug 2023 18:22:28 -0300
Subject: [PATCH 0036/1120] Add bullet points to codespaces instructions

---
 doc/devel/contribute.rst | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/doc/devel/contribute.rst b/doc/devel/contribute.rst
index 4e03e0b2c811..994d5448b876 100644
--- a/doc/devel/contribute.rst
+++ b/doc/devel/contribute.rst
@@ -250,17 +250,17 @@ A brief overview of the workflow is as follows.
         3. Check out the Matplotlib repository and activate your development
            environment:
 
-           a. Open codespaces on your fork by clicking on the green "Code"
-              button on the GitHub web interface and selecting the "Codespaces"
-              tab. Next, click on "Open codespaces on <your branch name>". You
-              will be able to change branches later, so you can select the
-              default ``main`` branch.
+           * Open codespaces on your fork by clicking on the green "Code" button
+             on the GitHub web interface and selecting the "Codespaces" tab.
+           * Next, click on "Open codespaces on <your branch name>". You will be
+             able to change branches later, so you can select the default
+             ``main`` branch.
+           * After the codespace is created, you will be taken to a new browser
+             tab where you can use the terminal to activate a pre-defined conda
+             environment called ``mpl-dev``::
 
-           b. After the codespace is created, you will be taken to a new browser
-              tab where you can use the terminal to activate a pre-defined conda
-              environment called ``mpl-dev``::
+               conda activate mpl-dev
 
-                conda activate mpl-dev
 
 
 4. Install the local version of Matplotlib with::

From 09b8ee83aafb260d7c1127e46b7c84f0b8f28908 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Mon, 14 Aug 2023 20:38:24 -0400
Subject: [PATCH 0037/1120] Fix MathText antialiasing

I think an accident during confict resolution of #26168 incorrectly
overwrote antialias settings for MathText. This puts the `_val_or_rc`
call in the correct location.

Also, re-arrange the tests to better catch this error.
---
 lib/matplotlib/_mathtext.py                   |   3 +-
 lib/matplotlib/mathtext.py                    |   3 +-
 .../baseline_images/test_text/antialiased.png | Bin 3143 -> 3045 bytes
 lib/matplotlib/tests/test_text.py             |  76 +++++-------------
 4 files changed, 20 insertions(+), 62 deletions(-)

diff --git a/lib/matplotlib/_mathtext.py b/lib/matplotlib/_mathtext.py
index 25a825b7b0d9..5073bdde0ff2 100644
--- a/lib/matplotlib/_mathtext.py
+++ b/lib/matplotlib/_mathtext.py
@@ -106,7 +106,7 @@ def to_vector(self):
               for x1, y1, x2, y2 in self.rects]
         return VectorParse(w, h + d, d, gs, rs)
 
-    def to_raster(self, antialiased=None):
+    def to_raster(self, *, antialiased):
         # Metrics y's and mathtext y's are oriented in opposite directions,
         # hence the switch between ymin and ymax.
         xmin = min([*[ox + info.metrics.xmin for ox, oy, info in self.glyphs],
@@ -128,7 +128,6 @@ def to_raster(self, antialiased=None):
         # old approach and keeps baseline images backcompat.
         shifted = ship(self.box, (-xmin, -ymin))
 
-        antialiased = mpl.rcParams['text.antialiased']
         for ox, oy, info in shifted.glyphs:
             info.font.draw_glyph_to_bitmap(
                 image, ox, oy - info.metrics.iceberg, info.glyph,
diff --git a/lib/matplotlib/mathtext.py b/lib/matplotlib/mathtext.py
index 7f639d2c0987..e25b76c4037c 100644
--- a/lib/matplotlib/mathtext.py
+++ b/lib/matplotlib/mathtext.py
@@ -75,8 +75,7 @@ def parse(self, s, dpi=72, prop=None, *, antialiased=None):
         # is mutable; key the cache using an internal copy (see
         # text._get_text_metrics_with_cache for a similar case).
         prop = prop.copy() if prop is not None else None
-        if antialiased is None:
-            antialiased = mpl.rcParams['text.antialiased']
+        antialiased = mpl._val_or_rc(antialiased, 'text.antialiased')
         return self._parse_cached(s, dpi, prop, antialiased)
 
     @functools.lru_cache(50)
diff --git a/lib/matplotlib/tests/baseline_images/test_text/antialiased.png b/lib/matplotlib/tests/baseline_images/test_text/antialiased.png
index 11ba1b082df94b965371f44699a556afdb09b6a6..06c007591d966acc6a2ef96fcf2429bc823d88a6 100644
GIT binary patch
literal 3045
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

literal 3143
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
Xi@U~2IX9xfp8#ZxyoM<I#U<w7c;(w8

diff --git a/lib/matplotlib/tests/test_text.py b/lib/matplotlib/tests/test_text.py
index 45bc2d2cc24d..7222d5b00cf7 100644
--- a/lib/matplotlib/tests/test_text.py
+++ b/lib/matplotlib/tests/test_text.py
@@ -186,19 +186,23 @@ def draw_box(ax, tt):
     ax.text(1.2, 0.1, 'Bot align, rot20', color='C2')
 
 
-@image_comparison(['antialiased.png'])
+@image_comparison(['antialiased.png'], style='mpl20')
 def test_antialiasing():
-    mpl.rcParams['text.antialiased'] = True
+    mpl.rcParams['text.antialiased'] = False  # Passed arguments should override.
 
     fig = plt.figure(figsize=(5.25, 0.75))
-    fig.text(0.5, 0.75, "antialiased", horizontalalignment='center',
-             verticalalignment='center')
-    fig.text(0.5, 0.25, r"$\sqrt{x}$", horizontalalignment='center',
-             verticalalignment='center')
-    # NOTE: We don't need to restore the rcParams here, because the
-    # test cleanup will do it for us.  In fact, if we do it here, it
-    # will turn antialiasing back off before the images are actually
-    # rendered.
+    fig.text(0.3, 0.75, "antialiased", horizontalalignment='center',
+             verticalalignment='center', antialiased=True)
+    fig.text(0.3, 0.25, r"$\sqrt{x}$", horizontalalignment='center',
+             verticalalignment='center', antialiased=True)
+
+    mpl.rcParams['text.antialiased'] = True  # Passed arguments should override.
+    fig.text(0.7, 0.75, "not antialiased", horizontalalignment='center',
+             verticalalignment='center', antialiased=False)
+    fig.text(0.7, 0.25, r"$\sqrt{x}$", horizontalalignment='center',
+             verticalalignment='center', antialiased=False)
+
+    mpl.rcParams['text.antialiased'] = False  # Should not affect existing text.
 
 
 def test_afm_kerning():
@@ -914,29 +918,18 @@ def test_annotate_offset_fontsize():
     assert str(points_coords) == str(fontsize_coords)
 
 
-def test_set_antialiased():
+def test_get_set_antialiased():
     txt = Text(.5, .5, "foo\nbar")
     assert txt._antialiased == mpl.rcParams['text.antialiased']
+    assert txt.get_antialiased() == mpl.rcParams['text.antialiased']
 
     txt.set_antialiased(True)
     assert txt._antialiased is True
+    assert txt.get_antialiased() == txt._antialiased
 
     txt.set_antialiased(False)
     assert txt._antialiased is False
-
-
-def test_get_antialiased():
-
-    txt2 = Text(.5, .5, "foo\nbar", antialiased=True)
-    assert txt2._antialiased is True
-    assert txt2.get_antialiased() == txt2._antialiased
-
-    txt3 = Text(.5, .5, "foo\nbar", antialiased=False)
-    assert txt3._antialiased is False
-    assert txt3.get_antialiased() == txt3._antialiased
-
-    txt4 = Text(.5, .5, "foo\nbar")
-    assert txt4.get_antialiased() == mpl.rcParams['text.antialiased']
+    assert txt.get_antialiased() == txt._antialiased
 
 
 def test_annotation_antialiased():
@@ -957,39 +950,6 @@ def test_annotation_antialiased():
     assert annot4._antialiased == mpl.rcParams['text.antialiased']
 
 
-@check_figures_equal()
-def test_text_antialiased_off_default_vs_manual(fig_test, fig_ref):
-    fig_test.text(0.5, 0.5, '6 inches x 2 inches',
-                             antialiased=False)
-
-    mpl.rcParams['text.antialiased'] = False
-    fig_ref.text(0.5, 0.5, '6 inches x 2 inches')
-
-
-@check_figures_equal()
-def test_text_antialiased_on_default_vs_manual(fig_test, fig_ref):
-    fig_test.text(0.5, 0.5, '6 inches x 2 inches', antialiased=True)
-
-    mpl.rcParams['text.antialiased'] = True
-    fig_ref.text(0.5, 0.5, '6 inches x 2 inches')
-
-
-@check_figures_equal()
-def test_text_math_antialiased_on_default_vs_manual(fig_test, fig_ref):
-    fig_test.text(0.5, 0.5, r"OutsideMath $I\'m \sqrt{2}$", antialiased=True)
-
-    mpl.rcParams['text.antialiased'] = True
-    fig_ref.text(0.5, 0.5, r"OutsideMath $I\'m \sqrt{2}$")
-
-
-@check_figures_equal()
-def test_text_math_antialiased_off_default_vs_manual(fig_test, fig_ref):
-    fig_test.text(0.5, 0.5, r"OutsideMath $I\'m \sqrt{2}$", antialiased=False)
-
-    mpl.rcParams['text.antialiased'] = False
-    fig_ref.text(0.5, 0.5, r"OutsideMath $I\'m \sqrt{2}$")
-
-
 @check_figures_equal(extensions=["png"])
 def test_annotate_and_offsetfrom_copy_input(fig_test, fig_ref):
     # Both approaches place the text (10, 0) pixels away from the center of the line.

From 66866741561800254f07d096ba417c259f99e487 Mon Sep 17 00:00:00 2001
From: Haoying Zhang <stevezhang1999@gmail.com>
Date: Tue, 15 Aug 2023 14:23:56 -0400
Subject: [PATCH 0038/1120] fix input check in Poly3DCollection.__init__

---
 lib/mpl_toolkits/mplot3d/art3d.py             |  2 +-
 lib/mpl_toolkits/mplot3d/tests/test_axes3d.py | 10 ++++++++++
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/lib/mpl_toolkits/mplot3d/art3d.py b/lib/mpl_toolkits/mplot3d/art3d.py
index 0888853df37e..a41485f62529 100644
--- a/lib/mpl_toolkits/mplot3d/art3d.py
+++ b/lib/mpl_toolkits/mplot3d/art3d.py
@@ -905,7 +905,7 @@ def __init__(self, verts, *args, zsort='average', shade=False,
                 kwargs['edgecolors'] = _shade_colors(
                     edgecolors, normals, lightsource
                 )
-            if facecolors is None and edgecolors in None:
+            if facecolors is None and edgecolors is None:
                 raise ValueError(
                     "You must provide facecolors, edgecolors, or both for "
                     "shade to work.")
diff --git a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
index 644e2f245812..1f8764cbab9d 100644
--- a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
@@ -2260,3 +2260,13 @@ def test_surface3d_zsort_inf():
 
     ax.plot_surface(x, y, z, cmap='jet')
     ax.view_init(elev=45, azim=145)
+
+
+def test_Poly3DCollection_init_value_error():
+    # smoke test to ensure the input check works
+    # GH#26420
+    with pytest.raises(ValueError,
+                       match='You must provide facecolors, edgecolors, '
+                        'or both for shade to work.'):
+        poly = np.array([[0, 0, 1], [0, 1, 1], [0, 0, 0]], float)
+        c = art3d.Poly3DCollection([poly], shade=True)

From f37329bef3dfb28019fca524f03b40aa1a0ebc9c Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Sun, 13 Aug 2023 15:09:32 +0200
Subject: [PATCH 0039/1120] Tweak shape repr in _api.check_shape error message.

Fill in "None" dims *from the end* with the letters N, M, L, K, ... so
as to get e.g. "(N, 2)", "(M, 2, N)", "(L, M, N)", etc.
---
 lib/matplotlib/_api/__init__.py  |  8 +++-----
 lib/matplotlib/tests/test_api.py | 18 ++++++++++--------
 2 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/lib/matplotlib/_api/__init__.py b/lib/matplotlib/_api/__init__.py
index ee00665c4f1d..13319d867dc5 100644
--- a/lib/matplotlib/_api/__init__.py
+++ b/lib/matplotlib/_api/__init__.py
@@ -151,12 +151,10 @@ def check_shape(shape, /, **kwargs):
         if (len(data_shape) != len(shape)
                 or any(s != t and t is not None for s, t in zip(data_shape, shape))):
             dim_labels = iter(itertools.chain(
-                'MNLIJKLH',
+                'NMLKJIH',
                 (f"D{i}" for i in itertools.count())))
-            text_shape = ", ".join(str(n)
-                                   if n is not None
-                                   else next(dim_labels)
-                                   for n in shape)
+            text_shape = ", ".join([str(n) if n is not None else next(dim_labels)
+                                    for n in shape[::-1]][::-1])
             if len(shape) == 1:
                 text_shape += ","
 
diff --git a/lib/matplotlib/tests/test_api.py b/lib/matplotlib/tests/test_api.py
index 34549efb0534..8b0f1e70114e 100644
--- a/lib/matplotlib/tests/test_api.py
+++ b/lib/matplotlib/tests/test_api.py
@@ -17,17 +17,19 @@
 T = TypeVar('T')
 
 
-@pytest.mark.parametrize('target,test_shape',
-                         [((None, ), (1, 3)),
-                          ((None, 3), (1,)),
-                          ((None, 3), (1, 2)),
-                          ((1, 5), (1, 9)),
-                          ((None, 2, None), (1, 3, 1))
+@pytest.mark.parametrize('target,shape_repr,test_shape',
+                         [((None, ), "(N,)", (1, 3)),
+                          ((None, 3), "(N, 3)", (1,)),
+                          ((None, 3), "(N, 3)", (1, 2)),
+                          ((1, 5), "(1, 5)", (1, 9)),
+                          ((None, 2, None), "(M, 2, N)", (1, 3, 1))
                           ])
 def test_check_shape(target: tuple[int | None, ...],
+                     shape_repr: str,
                      test_shape: tuple[int, ...]) -> None:
-    error_pattern = (f"^'aardvark' must be {len(target)}D.*" +
-                     re.escape(f'has shape {test_shape}'))
+    error_pattern = "^" + re.escape(
+        f"'aardvark' must be {len(target)}D with shape {shape_repr}, but your input "
+        f"has shape {test_shape}")
     data = np.zeros(test_shape)
     with pytest.raises(ValueError, match=error_pattern):
         _api.check_shape(target, aardvark=data)

From 7f65d6b58e2cef2445f6b8778381dd3a56937dd1 Mon Sep 17 00:00:00 2001
From: Ratnabali Dutta <ratnabalidutta26@gmail.com>
Date: Tue, 15 Aug 2023 15:56:35 +0530
Subject: [PATCH 0040/1120] Add unclosed group to grammar

Co-authored-by: Kyle Sunden <git@ksunden.space>
---
 lib/matplotlib/_mathtext.py           | 5 +++++
 lib/matplotlib/tests/test_mathtext.py | 4 ++--
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/_mathtext.py b/lib/matplotlib/_mathtext.py
index 4761ea7fc626..73cb0ae1189d 100644
--- a/lib/matplotlib/_mathtext.py
+++ b/lib/matplotlib/_mathtext.py
@@ -1894,6 +1894,7 @@ def csnames(group, names):
         p.function = csnames("name", self._function_names)
 
         p.group = p.start_group + ZeroOrMore(p.token)("group") + p.end_group
+        p.unclosed_group = (p.start_group + ZeroOrMore(p.token)("group") + StringEnd())
 
         p.frac  = cmd(r"\frac", p.required_group("num") + p.required_group("den"))
         p.dfrac = cmd(r"\dfrac", p.required_group("num") + p.required_group("den"))
@@ -1942,6 +1943,7 @@ def csnames(group, names):
         p.token <<= (
             p.simple
             | p.auto_delim
+            | p.unclosed_group
             | p.unknown_symbol  # Must be last
         )
 
@@ -2251,6 +2253,9 @@ def end_group(self, s, loc, toks):
         self.pop_state()
         return []
 
+    def unclosed_group(self, s, loc, toks):
+        raise ParseFatalException(s, len(s), "Expected '}'")
+
     def font(self, s, loc, toks):
         self.get_state().font = toks["font"]
         return []
diff --git a/lib/matplotlib/tests/test_mathtext.py b/lib/matplotlib/tests/test_mathtext.py
index ba30b9be214a..133469b00d8e 100644
--- a/lib/matplotlib/tests/test_mathtext.py
+++ b/lib/matplotlib/tests/test_mathtext.py
@@ -320,7 +320,7 @@ def test_fontinfo():
         (r'$a^2^2$', r'Double superscript'),
         (r'$a_2_2$', r'Double subscript'),
         (r'$a^2_a^2$', r'Double superscript'),
-        (r'$a = {b$', r'Expected end of text'),
+        (r'$a = {b$', r"Expected '}'"),
     ],
     ids=[
         'hspace without value',
@@ -349,7 +349,7 @@ def test_fontinfo():
         'double superscript',
         'double subscript',
         'super on sub without braces',
-        'math string with no closing braces'
+        'unclosed group'
     ]
 )
 def test_mathtext_exceptions(math, msg):

From e2149458614532d765d5cb75db7f15d07e64aae8 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 16 Aug 2023 03:23:33 -0400
Subject: [PATCH 0041/1120] TYP: Add overload for FT2Font.get_sfnt_table

---
 lib/matplotlib/ft2font.pyi            | 135 ++++++++++-
 lib/matplotlib/tests/test_mathtext.py |   1 +
 src/ft2font_wrapper.cpp               | 323 ++++++++------------------
 3 files changed, 234 insertions(+), 225 deletions(-)

diff --git a/lib/matplotlib/ft2font.pyi b/lib/matplotlib/ft2font.pyi
index fb74fd676f5b..8a99f7a4f2f7 100644
--- a/lib/matplotlib/ft2font.pyi
+++ b/lib/matplotlib/ft2font.pyi
@@ -1,4 +1,4 @@
-from typing import BinaryIO, Literal
+from typing import BinaryIO, Literal, TypedDict, overload
 
 import numpy as np
 from numpy.typing import NDArray
@@ -42,6 +42,122 @@ SCALABLE: int
 SFNT: int
 VERTICAL: int
 
+class _SfntHeadDict(TypedDict):
+    version: tuple[int, int]
+    fontRevision: tuple[int, int]
+    checkSumAdjustment: int
+    magicNumber: int
+    flags: int
+    unitsPerEm: int
+    created: tuple[int, int]
+    modified: tuple[int, int]
+    xMin: int
+    yMin: int
+    xMax: int
+    yMax: int
+    macStyle: int
+    lowestRecPPEM: int
+    fontDirectionHint: int
+    indexToLocFormat: int
+    glyphDataFormat: int
+
+class _SfntMaxpDict(TypedDict):
+    version: tuple[int, int]
+    numGlyphs: int
+    maxPoints: int
+    maxContours: int
+    maxComponentPoints: int
+    maxComponentContours: int
+    maxZones: int
+    maxTwilightPoints: int
+    maxStorage: int
+    maxFunctionDefs: int
+    maxInstructionDefs: int
+    maxStackElements: int
+    maxSizeOfInstructions: int
+    maxComponentElements: int
+    maxComponentDepth: int
+
+class _SfntOs2Dict(TypedDict):
+    version: int
+    xAvgCharWidth: int
+    usWeightClass: int
+    usWidthClass: int
+    fsType: int
+    ySubscriptXSize: int
+    ySubscriptYSize: int
+    ySubscriptXOffset: int
+    ySubscriptYOffset: int
+    ySuperscriptXSize: int
+    ySuperscriptYSize: int
+    ySuperscriptXOffset: int
+    ySuperscriptYOffset: int
+    yStrikeoutSize: int
+    yStrikeoutPosition: int
+    sFamilyClass: int
+    panose: bytes
+    ulCharRange: tuple[int, int, int, int]
+    achVendID: bytes
+    fsSelection: int
+    fsFirstCharIndex: int
+    fsLastCharIndex: int
+
+class _SfntHheaDict(TypedDict):
+    version: tuple[int, int]
+    ascent: int
+    descent: int
+    lineGap: int
+    advanceWidthMax: int
+    minLeftBearing: int
+    minRightBearing: int
+    xMaxExtent: int
+    caretSlopeRise: int
+    caretSlopeRun: int
+    caretOffset: int
+    metricDataFormat: int
+    numOfLongHorMetrics: int
+
+class _SfntVheaDict(TypedDict):
+    version: tuple[int, int]
+    vertTypoAscender: int
+    vertTypoDescender: int
+    vertTypoLineGap: int
+    advanceHeightMax: int
+    minTopSideBearing: int
+    minBottomSizeBearing: int
+    yMaxExtent: int
+    caretSlopeRise: int
+    caretSlopeRun: int
+    caretOffset: int
+    metricDataFormat: int
+    numOfLongVerMetrics: int
+
+class _SfntPostDict(TypedDict):
+    format: tuple[int, int]
+    italicAngle: tuple[int, int]
+    underlinePosition: int
+    underlineThickness: int
+    isFixedPitch: int
+    minMemType42: int
+    maxMemType42: int
+    minMemType1: int
+    maxMemType1: int
+
+class _SfntPcltDict(TypedDict):
+    version: tuple[int, int]
+    fontNumber: int
+    pitch: int
+    xHeight: int
+    style: int
+    typeFamily: int
+    capHeight: int
+    symbolSet: int
+    typeFace: bytes
+    characterComplement: bytes
+    strokeWeight: int
+    widthType: int
+    serifStyle: int
+
 class FT2Font:
     ascender: int
     bbox: tuple[int, int, int, int]
@@ -92,9 +208,20 @@ class FT2Font:
         self,
     ) -> tuple[str, str, str, str, str, int, int, int, int]: ...
     def get_sfnt(self) -> dict[tuple[int, int, int, int], bytes]: ...
-    def get_sfnt_table(
-        self, name: Literal["head", "maxp", "OS/2", "hhea", "vhea", "post", "pclt"]
-    ) -> dict[str, tuple[int, int, int, int] | tuple[int, int] | int | bytes]: ...
+    @overload
+    def get_sfnt_table(self, name: Literal["head"]) -> _SfntHeadDict | None: ...
+    @overload
+    def get_sfnt_table(self, name: Literal["maxp"]) -> _SfntMaxpDict | None: ...
+    @overload
+    def get_sfnt_table(self, name: Literal["OS/2"]) -> _SfntOs2Dict | None: ...
+    @overload
+    def get_sfnt_table(self, name: Literal["hhea"]) -> _SfntHheaDict | None: ...
+    @overload
+    def get_sfnt_table(self, name: Literal["vhea"]) -> _SfntVheaDict | None: ...
+    @overload
+    def get_sfnt_table(self, name: Literal["post"]) -> _SfntPostDict | None: ...
+    @overload
+    def get_sfnt_table(self, name: Literal["pclt"]) -> _SfntPcltDict | None: ...
     def get_width_height(self) -> tuple[int, int]: ...
     def get_xys(self, antialiased: bool = ...) -> NDArray[np.float64]: ...
     def load_char(self, charcode: int, flags: int = ...) -> Glyph: ...
diff --git a/lib/matplotlib/tests/test_mathtext.py b/lib/matplotlib/tests/test_mathtext.py
index d80312495d91..68c198ecd0e9 100644
--- a/lib/matplotlib/tests/test_mathtext.py
+++ b/lib/matplotlib/tests/test_mathtext.py
@@ -281,6 +281,7 @@ def test_fontinfo():
     fontpath = mpl.font_manager.findfont("DejaVu Sans")
     font = mpl.ft2font.FT2Font(fontpath)
     table = font.get_sfnt_table("head")
+    assert table is not None
     assert table['version'] == (1, 0)
 
 
diff --git a/src/ft2font_wrapper.cpp b/src/ft2font_wrapper.cpp
index 872f9c0a6023..7888a9c212a5 100644
--- a/src/ft2font_wrapper.cpp
+++ b/src/ft2font_wrapper.cpp
@@ -1118,44 +1118,23 @@ static PyObject *PyFT2Font_get_sfnt_table(PyFT2Font *self, PyObject *args)
             "s:(l,l), s:(l,l), s:h, s:h, s:h, s:h, s:H, s:H, s:h, s:h, s:h}";
         TT_Header *t = (TT_Header *)table;
         return Py_BuildValue(head_dict,
-                             "version",
-                             FIXED_MAJOR(t->Table_Version),
-                             FIXED_MINOR(t->Table_Version),
-                             "fontRevision",
-                             FIXED_MAJOR(t->Font_Revision),
-                             FIXED_MINOR(t->Font_Revision),
-                             "checkSumAdjustment",
-                             t->CheckSum_Adjust,
-                             "magicNumber",
-                             t->Magic_Number,
-                             "flags",
-                             t->Flags,
-                             "unitsPerEm",
-                             t->Units_Per_EM,
-                             "created",
-                             t->Created[0],
-                             t->Created[1],
-                             "modified",
-                             t->Modified[0],
-                             t->Modified[1],
-                             "xMin",
-                             t->xMin,
-                             "yMin",
-                             t->yMin,
-                             "xMax",
-                             t->xMax,
-                             "yMax",
-                             t->yMax,
-                             "macStyle",
-                             t->Mac_Style,
-                             "lowestRecPPEM",
-                             t->Lowest_Rec_PPEM,
-                             "fontDirectionHint",
-                             t->Font_Direction,
-                             "indexToLocFormat",
-                             t->Index_To_Loc_Format,
-                             "glyphDataFormat",
-                             t->Glyph_Data_Format);
+                             "version", FIXED_MAJOR(t->Table_Version), FIXED_MINOR(t->Table_Version),
+                             "fontRevision", FIXED_MAJOR(t->Font_Revision), FIXED_MINOR(t->Font_Revision),
+                             "checkSumAdjustment", t->CheckSum_Adjust,
+                             "magicNumber", t->Magic_Number,
+                             "flags", t->Flags,
+                             "unitsPerEm", t->Units_Per_EM,
+                             "created", t->Created[0], t->Created[1],
+                             "modified", t->Modified[0], t->Modified[1],
+                             "xMin", t->xMin,
+                             "yMin", t->yMin,
+                             "xMax", t->xMax,
+                             "yMax", t->yMax,
+                             "macStyle", t->Mac_Style,
+                             "lowestRecPPEM", t->Lowest_Rec_PPEM,
+                             "fontDirectionHint", t->Font_Direction,
+                             "indexToLocFormat", t->Index_To_Loc_Format,
+                             "glyphDataFormat", t->Glyph_Data_Format);
     }
     case 1: {
         char maxp_dict[] =
@@ -1163,37 +1142,21 @@ static PyObject *PyFT2Font_get_sfnt_table(PyFT2Font *self, PyObject *args)
             "s:H, s:H, s:H, s:H, s:H, s:H, s:H, s:H}";
         TT_MaxProfile *t = (TT_MaxProfile *)table;
         return Py_BuildValue(maxp_dict,
-                             "version",
-                             FIXED_MAJOR(t->version),
-                             FIXED_MINOR(t->version),
-                             "numGlyphs",
-                             t->numGlyphs,
-                             "maxPoints",
-                             t->maxPoints,
-                             "maxContours",
-                             t->maxContours,
-                             "maxComponentPoints",
-                             t->maxCompositePoints,
-                             "maxComponentContours",
-                             t->maxCompositeContours,
-                             "maxZones",
-                             t->maxZones,
-                             "maxTwilightPoints",
-                             t->maxTwilightPoints,
-                             "maxStorage",
-                             t->maxStorage,
-                             "maxFunctionDefs",
-                             t->maxFunctionDefs,
-                             "maxInstructionDefs",
-                             t->maxInstructionDefs,
-                             "maxStackElements",
-                             t->maxStackElements,
-                             "maxSizeOfInstructions",
-                             t->maxSizeOfInstructions,
-                             "maxComponentElements",
-                             t->maxComponentElements,
-                             "maxComponentDepth",
-                             t->maxComponentDepth);
+                             "version", FIXED_MAJOR(t->version), FIXED_MINOR(t->version),
+                             "numGlyphs", t->numGlyphs,
+                             "maxPoints", t->maxPoints,
+                             "maxContours", t->maxContours,
+                             "maxComponentPoints", t->maxCompositePoints,
+                             "maxComponentContours", t->maxCompositeContours,
+                             "maxZones", t->maxZones,
+                             "maxTwilightPoints", t->maxTwilightPoints,
+                             "maxStorage", t->maxStorage,
+                             "maxFunctionDefs", t->maxFunctionDefs,
+                             "maxInstructionDefs", t->maxInstructionDefs,
+                             "maxStackElements", t->maxStackElements,
+                             "maxSizeOfInstructions", t->maxSizeOfInstructions,
+                             "maxComponentElements", t->maxComponentElements,
+                             "maxComponentDepth", t->maxComponentDepth);
     }
     case 2: {
         char os_2_dict[] =
@@ -1202,55 +1165,28 @@ static PyObject *PyFT2Font_get_sfnt_table(PyFT2Font *self, PyObject *args)
             "s:y#, s:H, s:H, s:H}";
         TT_OS2 *t = (TT_OS2 *)table;
         return Py_BuildValue(os_2_dict,
-                             "version",
-                             t->version,
-                             "xAvgCharWidth",
-                             t->xAvgCharWidth,
-                             "usWeightClass",
-                             t->usWeightClass,
-                             "usWidthClass",
-                             t->usWidthClass,
-                             "fsType",
-                             t->fsType,
-                             "ySubscriptXSize",
-                             t->ySubscriptXSize,
-                             "ySubscriptYSize",
-                             t->ySubscriptYSize,
-                             "ySubscriptXOffset",
-                             t->ySubscriptXOffset,
-                             "ySubscriptYOffset",
-                             t->ySubscriptYOffset,
-                             "ySuperscriptXSize",
-                             t->ySuperscriptXSize,
-                             "ySuperscriptYSize",
-                             t->ySuperscriptYSize,
-                             "ySuperscriptXOffset",
-                             t->ySuperscriptXOffset,
-                             "ySuperscriptYOffset",
-                             t->ySuperscriptYOffset,
-                             "yStrikeoutSize",
-                             t->yStrikeoutSize,
-                             "yStrikeoutPosition",
-                             t->yStrikeoutPosition,
-                             "sFamilyClass",
-                             t->sFamilyClass,
-                             "panose",
-                             t->panose,
-                             Py_ssize_t(10),
-                             "ulCharRange",
-                             t->ulUnicodeRange1,
-                             t->ulUnicodeRange2,
-                             t->ulUnicodeRange3,
-                             t->ulUnicodeRange4,
-                             "achVendID",
-                             t->achVendID,
-                             Py_ssize_t(4),
-                             "fsSelection",
-                             t->fsSelection,
-                             "fsFirstCharIndex",
-                             t->usFirstCharIndex,
-                             "fsLastCharIndex",
-                             t->usLastCharIndex);
+                             "version", t->version,
+                             "xAvgCharWidth", t->xAvgCharWidth,
+                             "usWeightClass", t->usWeightClass,
+                             "usWidthClass", t->usWidthClass,
+                             "fsType", t->fsType,
+                             "ySubscriptXSize", t->ySubscriptXSize,
+                             "ySubscriptYSize", t->ySubscriptYSize,
+                             "ySubscriptXOffset", t->ySubscriptXOffset,
+                             "ySubscriptYOffset", t->ySubscriptYOffset,
+                             "ySuperscriptXSize", t->ySuperscriptXSize,
+                             "ySuperscriptYSize", t->ySuperscriptYSize,
+                             "ySuperscriptXOffset", t->ySuperscriptXOffset,
+                             "ySuperscriptYOffset", t->ySuperscriptYOffset,
+                             "yStrikeoutSize", t->yStrikeoutSize,
+                             "yStrikeoutPosition", t->yStrikeoutPosition,
+                             "sFamilyClass", t->sFamilyClass,
+                             "panose", t->panose, Py_ssize_t(10),
+                             "ulCharRange", t->ulUnicodeRange1, t->ulUnicodeRange2, t->ulUnicodeRange3, t->ulUnicodeRange4,
+                             "achVendID", t->achVendID, Py_ssize_t(4),
+                             "fsSelection", t->fsSelection,
+                             "fsFirstCharIndex", t->usFirstCharIndex,
+                             "fsLastCharIndex", t->usLastCharIndex);
     }
     case 3: {
         char hhea_dict[] =
@@ -1258,33 +1194,19 @@ static PyObject *PyFT2Font_get_sfnt_table(PyFT2Font *self, PyObject *args)
             "s:h, s:h, s:h, s:h, s:H}";
         TT_HoriHeader *t = (TT_HoriHeader *)table;
         return Py_BuildValue(hhea_dict,
-                             "version",
-                             FIXED_MAJOR(t->Version),
-                             FIXED_MINOR(t->Version),
-                             "ascent",
-                             t->Ascender,
-                             "descent",
-                             t->Descender,
-                             "lineGap",
-                             t->Line_Gap,
-                             "advanceWidthMax",
-                             t->advance_Width_Max,
-                             "minLeftBearing",
-                             t->min_Left_Side_Bearing,
-                             "minRightBearing",
-                             t->min_Right_Side_Bearing,
-                             "xMaxExtent",
-                             t->xMax_Extent,
-                             "caretSlopeRise",
-                             t->caret_Slope_Rise,
-                             "caretSlopeRun",
-                             t->caret_Slope_Run,
-                             "caretOffset",
-                             t->caret_Offset,
-                             "metricDataFormat",
-                             t->metric_Data_Format,
-                             "numOfLongHorMetrics",
-                             t->number_Of_HMetrics);
+                             "version", FIXED_MAJOR(t->Version), FIXED_MINOR(t->Version),
+                             "ascent", t->Ascender,
+                             "descent", t->Descender,
+                             "lineGap", t->Line_Gap,
+                             "advanceWidthMax", t->advance_Width_Max,
+                             "minLeftBearing", t->min_Left_Side_Bearing,
+                             "minRightBearing", t->min_Right_Side_Bearing,
+                             "xMaxExtent", t->xMax_Extent,
+                             "caretSlopeRise", t->caret_Slope_Rise,
+                             "caretSlopeRun", t->caret_Slope_Run,
+                             "caretOffset", t->caret_Offset,
+                             "metricDataFormat", t->metric_Data_Format,
+                             "numOfLongHorMetrics", t->number_Of_HMetrics);
     }
     case 4: {
         char vhea_dict[] =
@@ -1292,58 +1214,33 @@ static PyObject *PyFT2Font_get_sfnt_table(PyFT2Font *self, PyObject *args)
             "s:h, s:h, s:h, s:h, s:H}";
         TT_VertHeader *t = (TT_VertHeader *)table;
         return Py_BuildValue(vhea_dict,
-                             "version",
-                             FIXED_MAJOR(t->Version),
-                             FIXED_MINOR(t->Version),
-                             "vertTypoAscender",
-                             t->Ascender,
-                             "vertTypoDescender",
-                             t->Descender,
-                             "vertTypoLineGap",
-                             t->Line_Gap,
-                             "advanceHeightMax",
-                             t->advance_Height_Max,
-                             "minTopSideBearing",
-                             t->min_Top_Side_Bearing,
-                             "minBottomSizeBearing",
-                             t->min_Bottom_Side_Bearing,
-                             "yMaxExtent",
-                             t->yMax_Extent,
-                             "caretSlopeRise",
-                             t->caret_Slope_Rise,
-                             "caretSlopeRun",
-                             t->caret_Slope_Run,
-                             "caretOffset",
-                             t->caret_Offset,
-                             "metricDataFormat",
-                             t->metric_Data_Format,
-                             "numOfLongVerMetrics",
-                             t->number_Of_VMetrics);
+                             "version", FIXED_MAJOR(t->Version), FIXED_MINOR(t->Version),
+                             "vertTypoAscender", t->Ascender,
+                             "vertTypoDescender", t->Descender,
+                             "vertTypoLineGap", t->Line_Gap,
+                             "advanceHeightMax", t->advance_Height_Max,
+                             "minTopSideBearing", t->min_Top_Side_Bearing,
+                             "minBottomSizeBearing", t->min_Bottom_Side_Bearing,
+                             "yMaxExtent", t->yMax_Extent,
+                             "caretSlopeRise", t->caret_Slope_Rise,
+                             "caretSlopeRun", t->caret_Slope_Run,
+                             "caretOffset", t->caret_Offset,
+                             "metricDataFormat", t->metric_Data_Format,
+                             "numOfLongVerMetrics", t->number_Of_VMetrics);
     }
     case 5: {
         char post_dict[] = "{s:(h,H), s:(h,H), s:h, s:h, s:k, s:k, s:k, s:k, s:k}";
         TT_Postscript *t = (TT_Postscript *)table;
         return Py_BuildValue(post_dict,
-                             "format",
-                             FIXED_MAJOR(t->FormatType),
-                             FIXED_MINOR(t->FormatType),
-                             "italicAngle",
-                             FIXED_MAJOR(t->italicAngle),
-                             FIXED_MINOR(t->italicAngle),
-                             "underlinePosition",
-                             t->underlinePosition,
-                             "underlineThickness",
-                             t->underlineThickness,
-                             "isFixedPitch",
-                             t->isFixedPitch,
-                             "minMemType42",
-                             t->minMemType42,
-                             "maxMemType42",
-                             t->maxMemType42,
-                             "minMemType1",
-                             t->minMemType1,
-                             "maxMemType1",
-                             t->maxMemType1);
+                             "format", FIXED_MAJOR(t->FormatType), FIXED_MINOR(t->FormatType),
+                             "italicAngle", FIXED_MAJOR(t->italicAngle), FIXED_MINOR(t->italicAngle),
+                             "underlinePosition", t->underlinePosition,
+                             "underlineThickness", t->underlineThickness,
+                             "isFixedPitch", t->isFixedPitch,
+                             "minMemType42", t->minMemType42,
+                             "maxMemType42", t->maxMemType42,
+                             "minMemType1", t->minMemType1,
+                             "maxMemType1", t->maxMemType1);
     }
     case 6: {
         char pclt_dict[] =
@@ -1351,35 +1248,19 @@ static PyObject *PyFT2Font_get_sfnt_table(PyFT2Font *self, PyObject *args)
             "s:b, s:b}";
         TT_PCLT *t = (TT_PCLT *)table;
         return Py_BuildValue(pclt_dict,
-                             "version",
-                             FIXED_MAJOR(t->Version),
-                             FIXED_MINOR(t->Version),
-                             "fontNumber",
-                             t->FontNumber,
-                             "pitch",
-                             t->Pitch,
-                             "xHeight",
-                             t->xHeight,
-                             "style",
-                             t->Style,
-                             "typeFamily",
-                             t->TypeFamily,
-                             "capHeight",
-                             t->CapHeight,
-                             "symbolSet",
-                             t->SymbolSet,
-                             "typeFace",
-                             t->TypeFace,
-                             Py_ssize_t(16),
-                             "characterComplement",
-                             t->CharacterComplement,
-                             Py_ssize_t(8),
-                             "strokeWeight",
-                             t->StrokeWeight,
-                             "widthType",
-                             t->WidthType,
-                             "serifStyle",
-                             t->SerifStyle);
+                             "version", FIXED_MAJOR(t->Version), FIXED_MINOR(t->Version),
+                             "fontNumber", t->FontNumber,
+                             "pitch", t->Pitch,
+                             "xHeight", t->xHeight,
+                             "style", t->Style,
+                             "typeFamily", t->TypeFamily,
+                             "capHeight", t->CapHeight,
+                             "symbolSet", t->SymbolSet,
+                             "typeFace", t->TypeFace, Py_ssize_t(16),
+                             "characterComplement", t->CharacterComplement, Py_ssize_t(8),
+                             "strokeWeight", t->StrokeWeight,
+                             "widthType", t->WidthType,
+                             "serifStyle", t->SerifStyle);
     }
     default:
         Py_RETURN_NONE;

From 7173482aa2fd07ae8b733261010a7339996d241c Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 16 Aug 2023 05:51:47 -0400
Subject: [PATCH 0042/1120] TYP: Fix type of Glyph.bbox

It is in fact a read-only property, not a method.
---
 lib/matplotlib/ft2font.pyi | 1 +
 1 file changed, 1 insertion(+)

diff --git a/lib/matplotlib/ft2font.pyi b/lib/matplotlib/ft2font.pyi
index 8a99f7a4f2f7..6a0716e993a5 100644
--- a/lib/matplotlib/ft2font.pyi
+++ b/lib/matplotlib/ft2font.pyi
@@ -249,4 +249,5 @@ class Glyph:
     vertBearingY: int
     vertAdvance: int
 
+    @property
     def bbox(self) -> tuple[int, int, int, int]: ...

From a7307af66f891f15fd6c166137f5016cab4e473c Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 18 Aug 2023 01:53:59 -0400
Subject: [PATCH 0043/1120] Add ninja to Cygwin builder

Since there are no contourpy wheels, it must be built from source, and
pre-packaged ninja is better than trying to build from sdist.
---
 .github/workflows/cygwin.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/cygwin.yml b/.github/workflows/cygwin.yml
index 652a09e45953..67b1af162914 100644
--- a/.github/workflows/cygwin.yml
+++ b/.github/workflows/cygwin.yml
@@ -86,7 +86,7 @@ jobs:
         with:
           packages: >-
             ccache gcc-g++ gdb git graphviz libcairo-devel libffi-devel
-            libgeos-devel libQt5Core-devel pkgconf libglib2.0-devel
+            libgeos-devel libQt5Core-devel pkgconf libglib2.0-devel ninja
             noto-cjk-fonts
             python3${{ matrix.python-minor-version }}-devel
             python3${{ matrix.python-minor-version }}-pip

From e5d01aa4774f03a41736d863710802ee28791afb Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 18 Aug 2023 03:28:58 -0400
Subject: [PATCH 0044/1120] Fix size inferral when using cairocffi

With that package, rectangles appear to just be tuples, not named tuples
like with pycairo.

Fixes #26523
---
 lib/matplotlib/backends/backend_cairo.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/backends/backend_cairo.py b/lib/matplotlib/backends/backend_cairo.py
index c733f3f9d3d7..421d857b0a03 100644
--- a/lib/matplotlib/backends/backend_cairo.py
+++ b/lib/matplotlib/backends/backend_cairo.py
@@ -95,7 +95,7 @@ def set_context(self, ctx):
             rect, *rest = ctx.copy_clip_rectangle_list()
             if rest:
                 raise TypeError("Cannot infer surface size")
-            size = rect.width, rect.height
+            _, _, *size = rect
             ctx.restore()
         self.gc.ctx = ctx
         self.width, self.height = size

From 3dc34576a0e70981860146a712bcc0a91812afdf Mon Sep 17 00:00:00 2001
From: Ratnabali Dutta <ratnabalidutta26@gmail.com>
Date: Fri, 18 Aug 2023 15:23:57 +0530
Subject: [PATCH 0045/1120] update changes

---
 lib/matplotlib/_mathtext.py           | 3 +--
 lib/matplotlib/tests/test_mathtext.py | 2 +-
 2 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/_mathtext.py b/lib/matplotlib/_mathtext.py
index 73cb0ae1189d..24aab9046e27 100644
--- a/lib/matplotlib/_mathtext.py
+++ b/lib/matplotlib/_mathtext.py
@@ -2032,8 +2032,7 @@ def main(self, s, loc, toks):
         return [Hlist(toks)]
 
     def math_string(self, s, loc, toks):
-        return self._math_expression.parseString(toks[0][1:-1],
-                                                 parseAll=True)
+        return self._math_expression.parseString(toks[0][1:-1], parseAll=True)
 
     def math(self, s, loc, toks):
         hlist = Hlist(toks)
diff --git a/lib/matplotlib/tests/test_mathtext.py b/lib/matplotlib/tests/test_mathtext.py
index 133469b00d8e..5a9e8a8b9264 100644
--- a/lib/matplotlib/tests/test_mathtext.py
+++ b/lib/matplotlib/tests/test_mathtext.py
@@ -349,7 +349,7 @@ def test_fontinfo():
         'double superscript',
         'double subscript',
         'super on sub without braces',
-        'unclosed group'
+        'unclosed group',
     ]
 )
 def test_mathtext_exceptions(math, msg):

From 7ea04e7d96d69b509ec60272242e5ad3f3e5de7d Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 18 Aug 2023 22:44:54 -0400
Subject: [PATCH 0046/1120] Install contourpy without build isolation on Cygwin

---
 .github/workflows/cygwin.yml | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/cygwin.yml b/.github/workflows/cygwin.yml
index 67b1af162914..b4b30b57dab1 100644
--- a/.github/workflows/cygwin.yml
+++ b/.github/workflows/cygwin.yml
@@ -177,7 +177,10 @@ jobs:
           python -m pip install --upgrade pip 'setuptools<60' wheel
           python -m pip install kiwisolver 'numpy!=1.21.*' pillow importlib_resources
           grep -v -F -e psutil requirements/testing/all.txt >requirements_test.txt
-          python -m pip install --upgrade 'contourpy>=1.0.1' cycler fonttools \
+          python -m pip install meson-python pybind11
+          export PATH="/usr/local/bin:$PATH"
+          python -m pip install --no-build-isolation 'contourpy>=1.0.1'
+          python -m pip install --upgrade cycler fonttools \
               packaging pyparsing python-dateutil setuptools-scm \
               -r requirements_test.txt sphinx ipython
           python -m pip install --upgrade pycairo 'cairocffi>=0.8' PyGObject &&

From b0d66a080a85aec59febfe7f98ed8af98369a17f Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Sat, 19 Aug 2023 04:22:43 -0400
Subject: [PATCH 0047/1120] Remove NumPy abs overrides from pylab

NumPy added abs in 1.26, which we don't want when we import * from it.

Fixes #26553
---
 lib/matplotlib/pylab.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/lib/matplotlib/pylab.py b/lib/matplotlib/pylab.py
index 684021b2e977..77eb6506d87f 100644
--- a/lib/matplotlib/pylab.py
+++ b/lib/matplotlib/pylab.py
@@ -59,6 +59,7 @@
 # "from numpy.random import *" above
 bytes = __import__("builtins").bytes
 # We also don't want the numpy version of these functions
+abs = __import__("builtins").abs
 max = __import__("builtins").max
 min = __import__("builtins").min
 round = __import__("builtins").round

From ef5689faafabf5aba9ea71010a0ac1f79e6ae326 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Mon, 21 Aug 2023 12:59:08 -0500
Subject: [PATCH 0048/1120] MAINT: Numpy 2.0 deprecations for row_stack and
 in1d

Part of #26422, xref numpy/numpy#24445
---
 lib/matplotlib/axes/_axes.py               | 6 +++---
 lib/matplotlib/axes/_base.py               | 2 +-
 lib/matplotlib/contour.py                  | 6 +++---
 lib/matplotlib/projections/polar.py        | 2 +-
 lib/matplotlib/stackplot.py                | 2 +-
 lib/matplotlib/tests/test_triangulation.py | 2 +-
 lib/mpl_toolkits/mplot3d/art3d.py          | 4 ++--
 7 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 036d4f284fe5..4bd1e83d2f5a 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -3674,7 +3674,7 @@ def apply_mask(arrays, mask):
             #     elow, ehigh = np.broadcast_to(...)
             #     return dep - elow * ~lolims, dep + ehigh * ~uplims
             # except that broadcast_to would strip units.
-            low, high = dep + np.row_stack([-(1 - lolims), 1 - uplims]) * err
+            low, high = dep + np.vstack([-(1 - lolims), 1 - uplims]) * err
             barcols.append(lines_func(
                 *apply_mask([indep, low, high], everymask), **eb_lines_style))
             if self.name == "polar" and dep_axis == "x":
@@ -5471,8 +5471,8 @@ def get_interp_point(idx):
         collection = mcoll.PolyCollection(polys, **kwargs)
 
         # now update the datalim and autoscale
-        pts = np.row_stack([np.column_stack([ind[where], dep1[where]]),
-                            np.column_stack([ind[where], dep2[where]])])
+        pts = np.vstack([np.column_stack([ind[where], dep1[where]]),
+                         np.column_stack([ind[where], dep2[where]])])
         if ind_dir == "y":
             pts = pts[:, ::-1]
 
diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index 3796d9bbe508..b55ce7e99886 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -2403,7 +2403,7 @@ def _update_patch_limits(self, patch):
             vertices.append(curve([0, *dzeros, 1]))
 
         if len(vertices):
-            vertices = np.row_stack(vertices)
+            vertices = np.vstack(vertices)
 
         patch_trf = patch.get_transform()
         updatex, updatey = patch_trf.contains_branch_seperately(self.transData)
diff --git a/lib/matplotlib/contour.py b/lib/matplotlib/contour.py
index 79f66b896131..f148d35618dd 100644
--- a/lib/matplotlib/contour.py
+++ b/lib/matplotlib/contour.py
@@ -511,13 +511,13 @@ def calc_label_rot_and_inline(self, slc, ind, lw, lc=None, spacing=5):
             if closed:
                 # This will remove contour if shorter than label
                 if all(i != -1 for i in I):
-                    nlc.append(np.row_stack([xy2, lc[I[1]:I[0]+1], xy1]))
+                    nlc.append(np.vstack([xy2, lc[I[1]:I[0]+1], xy1]))
             else:
                 # These will remove pieces of contour if they have length zero
                 if I[0] != -1:
-                    nlc.append(np.row_stack([lc[:I[0]+1], xy1]))
+                    nlc.append(np.vstack([lc[:I[0]+1], xy1]))
                 if I[1] != -1:
-                    nlc.append(np.row_stack([xy2, lc[I[1]:]]))
+                    nlc.append(np.vstack([xy2, lc[I[1]:]]))
 
             # The current implementation removes contours completely
             # covered by labels.  Uncomment line below to keep
diff --git a/lib/matplotlib/projections/polar.py b/lib/matplotlib/projections/polar.py
index e4a99a01a774..0bff320e5728 100644
--- a/lib/matplotlib/projections/polar.py
+++ b/lib/matplotlib/projections/polar.py
@@ -121,7 +121,7 @@ def transform_path_non_affine(self, path):
                         codes.extend(arc.codes[1:])
                 else:  # Interpolate.
                     trs = cbook.simple_linear_interpolation(
-                        np.row_stack([(last_t, last_r), trs]),
+                        np.vstack([(last_t, last_r), trs]),
                         path._interpolation_steps)[1:]
                     xys.extend(self.transform_non_affine(trs))
                     codes.extend([Path.LINETO] * len(trs))
diff --git a/lib/matplotlib/stackplot.py b/lib/matplotlib/stackplot.py
index c97a21e029f9..2629593683e5 100644
--- a/lib/matplotlib/stackplot.py
+++ b/lib/matplotlib/stackplot.py
@@ -68,7 +68,7 @@ def stackplot(axes, x, *args,
         stacked area plot.
     """
 
-    y = np.row_stack(args)
+    y = np.vstack(args)
 
     labels = iter(labels)
     if colors is not None:
diff --git a/lib/matplotlib/tests/test_triangulation.py b/lib/matplotlib/tests/test_triangulation.py
index 682a0fbe4b75..14c591abd4e5 100644
--- a/lib/matplotlib/tests/test_triangulation.py
+++ b/lib/matplotlib/tests/test_triangulation.py
@@ -1035,7 +1035,7 @@ def test_trirefine():
     x_verif, y_verif = np.meshgrid(x_verif, x_verif)
     x_verif = x_verif.ravel()
     y_verif = y_verif.ravel()
-    ind1d = np.in1d(np.around(x_verif*(2.5+y_verif), 8),
+    ind1d = np.isin(np.around(x_verif*(2.5+y_verif), 8),
                     np.around(x_refi*(2.5+y_refi), 8))
     assert_array_equal(ind1d, True)
 
diff --git a/lib/mpl_toolkits/mplot3d/art3d.py b/lib/mpl_toolkits/mplot3d/art3d.py
index a41485f62529..ac6e841f5019 100644
--- a/lib/mpl_toolkits/mplot3d/art3d.py
+++ b/lib/mpl_toolkits/mplot3d/art3d.py
@@ -942,8 +942,8 @@ def set_zsort(self, zsort):
     def get_vector(self, segments3d):
         """Optimize points for projection."""
         if len(segments3d):
-            xs, ys, zs = np.row_stack(segments3d).T
-        else:  # row_stack can't stack zero arrays.
+            xs, ys, zs = np.vstack(segments3d).T
+        else:  # vstack can't stack zero arrays.
             xs, ys, zs = [], [], []
         ones = np.ones(len(xs))
         self._vec = np.array([xs, ys, zs, ones])

From 813e41a89f96dcd040a1f49726f8cc5659da6acb Mon Sep 17 00:00:00 2001
From: Prajwal Agrawal <61898798+kidkoder432@users.noreply.github.com>
Date: Mon, 21 Aug 2023 13:26:58 -0700
Subject: [PATCH 0049/1120] Boxplot fix median line extending past box
 boundaries (#26462)

Closes #19409.

- Set the default capstyles (solid and dashed) for median and mean lines in boxplots to "butt".
  I also modieifed the behaviror for setting the capstyle for median lines to obey the user's preference
  instead of overriding it.
- The boxplot PDFs were using the wrong capstyle, so I modified the references to use the butt captyle.
- Fixed a small typo in `bxp()`
- Added a new test for the median line (from PR #23335)

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>
---
 lib/matplotlib/axes/_axes.py                  |  13 ++++++++++++-
 .../baseline_images/test_axes/boxplot.pdf     | Bin 5781 -> 5702 bytes
 .../boxplot_autorange_false_whiskers.png      | Bin 5730 -> 5784 bytes
 .../boxplot_autorange_true_whiskers.png       | Bin 5391 -> 5447 bytes
 .../test_axes/boxplot_custom_capwidths.png    | Bin 2855 -> 2837 bytes
 .../boxplot_mod_artists_after_plotting.png    | Bin 1255 -> 1317 bytes
 .../test_axes/boxplot_no_inverted_whisker.png | Bin 1392 -> 1440 bytes
 .../test_axes/boxplot_rc_parameters.pdf       | Bin 3218 -> 3076 bytes
 .../test_axes/boxplot_rc_parameters.png       | Bin 7709 -> 7768 bytes
 .../baseline_images/test_axes/boxplot_sym.png | Bin 1254 -> 1304 bytes
 .../test_axes/boxplot_sym2.png                | Bin 5318 -> 5318 bytes
 .../test_axes/boxplot_with_CIarray.png        | Bin 2194 -> 2246 bytes
 .../test_axes/bxp_baseline.png                | Bin 2681 -> 2735 bytes
 .../test_axes/bxp_custom_capwidth.png         | Bin 2765 -> 2735 bytes
 .../test_axes/bxp_custom_capwidths.png        | Bin 2826 -> 2797 bytes
 .../test_axes/bxp_custombox.png               | Bin 2676 -> 2729 bytes
 .../test_axes/bxp_customcap.png               | Bin 2055 -> 2109 bytes
 .../test_axes/bxp_customoutlier.png           | Bin 1989 -> 2042 bytes
 .../test_axes/bxp_custompatchartist.png       | Bin 13592 -> 13548 bytes
 .../test_axes/bxp_custompositions.png         | Bin 1968 -> 2019 bytes
 .../test_axes/bxp_customwhisker.png           | Bin 2073 -> 2126 bytes
 .../test_axes/bxp_customwidths.png            | Bin 2078 -> 2133 bytes
 .../test_axes/bxp_horizontal.png              | Bin 2408 -> 2444 bytes
 .../test_axes/bxp_no_flier_stats.png          | Bin 1403 -> 1453 bytes
 .../baseline_images/test_axes/bxp_nobox.png   | Bin 1866 -> 1920 bytes
 .../baseline_images/test_axes/bxp_nocaps.png  | Bin 1877 -> 1932 bytes
 .../test_axes/bxp_patchartist.png             | Bin 2065 -> 2037 bytes
 .../test_axes/bxp_percentilewhis.png          | Bin 2894 -> 2945 bytes
 .../test_axes/bxp_rangewhis.png               | Bin 2135 -> 2187 bytes
 .../test_axes/bxp_scalarwidth.png             | Bin 1960 -> 2013 bytes
 .../test_axes/bxp_with_xlabels.png            | Bin 2721 -> 2774 bytes
 .../test_axes/bxp_with_ylabels.png            | Bin 3072 -> 3108 bytes
 .../test_axes/bxp_withmean_custompoint.png    | Bin 2226 -> 2280 bytes
 .../test_axes/bxp_withmean_line.png           | Bin 2158 -> 2210 bytes
 .../test_axes/bxp_withmean_point.png          | Bin 2163 -> 2218 bytes
 .../test_axes/bxp_withnotch.png               | Bin 4728 -> 4782 bytes
 lib/matplotlib/tests/test_axes.py             |   9 +++++++++
 37 files changed, 21 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 036d4f284fe5..4d5907503f09 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -4095,7 +4095,7 @@ def bxp(self, bxpstats, positions=None, widths=None, vert=True,
 
         capwidths : float or array-like, default: None
           Either a scalar or a vector and sets the width of each cap.
-          The default is ``0.5*(with of the box)``, see *widths*.
+          The default is ``0.5*(width of the box)``, see *widths*.
 
         vert : bool, default: True
           If `True` (default), makes the boxes vertical.
@@ -4147,6 +4147,17 @@ def bxp(self, bxpstats, positions=None, widths=None, vert=True,
         --------
         .. plot:: gallery/statistics/bxp.py
         """
+        # Clamp median line to edge of box by default.
+        medianprops = {
+            "solid_capstyle": "butt",
+            "dash_capstyle": "butt",
+            **(medianprops or {}),
+        }
+        meanprops = {
+            "solid_capstyle": "butt",
+            "dash_capstyle": "butt",
+            **(meanprops or {}),
+        }
 
         # lists of artists to be output
         whiskers = []
diff --git a/lib/matplotlib/tests/baseline_images/test_axes/boxplot.pdf b/lib/matplotlib/tests/baseline_images/test_axes/boxplot.pdf
index 55264db5d1f9c8cbc0452970dbcbfa75ce213e00..c34dddea28c99e48841bb810eae77351088161de 100644
GIT binary patch
delta 3396
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
Dv$+8#

literal 5781
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

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/boxplot_autorange_false_whiskers.png b/lib/matplotlib/tests/baseline_images/test_axes/boxplot_autorange_false_whiskers.png
index 05ae97248c8f84608ca5131a6e3a56564b54932b..14675de05163b4883150b10b6b128dfa9331dcd1 100644
GIT binary patch
literal 5784
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
U>G5aJ0sL57+FO+T!~4g70t>JRCIA2c

literal 5730
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
T3#>x`{G2v9Yn*?=`QBdvzT5V<

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/boxplot_autorange_true_whiskers.png b/lib/matplotlib/tests/baseline_images/test_axes/boxplot_autorange_true_whiskers.png
index 2ef5936b2db7f4e3afbbba74803f4d9bdc90af71..c6f11f0411aefe16a380107a225bb497740ddc5e 100644
GIT binary patch
literal 5447
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
Zq<B8OX)w#-_W<}gX77wC_~z`De*#y?LTdm3

literal 5391
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
E0g}KcRR910

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/boxplot_custom_capwidths.png b/lib/matplotlib/tests/baseline_images/test_axes/boxplot_custom_capwidths.png
index 7bccd2c18e977a4e2871886373f7eaf518d7a1c3..6282584ca548edebc8e26374a529c669a5d0674e 100644
GIT binary patch
delta 2499
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

literal 2855
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
NU}xoM$+Yl0|2x<90?hyb

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/boxplot_mod_artists_after_plotting.png b/lib/matplotlib/tests/baseline_images/test_axes/boxplot_mod_artists_after_plotting.png
index 1a7553254c60c20661efbe3c77f7354dce5f5588..fc91c7911723c0ee3c9f688177e7c7b37a1e0f99 100644
GIT binary patch
delta 848
zcmV-W1F!t&38e~<B!4+{MObuGZ)S9NVRB^vO<{C!Y;SaIX<{IDWpZ<AZ*DOzFfK4G
zAZT=SaC15@FKuCTaBOdMY-wUHZ*pfZK;N5F00009a7bBm000Ij000Ij0Zmlc#{d8X
zl1W5CRCt{2-7#xhXB5ZblVT{wgm$f#1P>krcga)__EJngh(b0E4S3C*HIPBt^dT|^
z+{GH)$;$;n4H3>_uPH&8LO_`cB{ZS9M6c`r^Q=O;XVFhb7oqpTdc9s35b2xN0|4y^
zlQ9D;lMn(Df7n*bi(g$`)nc)zot>SQW5AuVTCHk09M)hk`0Cecx&bT}i&`$1Ek}Sm
zXSrO~VzJoBwVG`JXJ==%TrR8Yy4v60Z#4!)a}NN5HQNAu>O*@r00<@kR8>{q_cfVJ
zs_*;Oqp(2&K=plJv)QbUj*e<Jn~6XW0iaG#Pis6LKiA&gUX91&n$PF0M`A++fI2)p
ztm$-G7Z(>bolfiE;Gp$LY={6*UDwrUG^&%6lNyai)pcF#k=T%?KLzIQld1tU5I8$K
z^Vd_*m<<4eITrwe*^?myJChIs29qxW9)J1U%X<6A+kbrQ{QA6}{P5(n&wcdWqk8(|
z)2}re4G2J(FTH_}Umw?tpI>Zn8d?*8d*<1%&+6vG&8?n$etllYua9r_-0iLHdj8Y%
zTRoR{1mK>z`Eb+ZQ~b8!pe;86A(#!|p1FK?+2qss^4;aeugQNW0Qbz}?;raLz&^j`
zD*yx&00<@k5KI6dn45t2%&XsDeev=0>+^d5=lff|_QP)<e)gxr+gsbWdQI9AfP3c6
zFK=3p!2gJ^lTZVelm7t`lUxHle^6Cbec#t)GVw1>VFZBc`@UwgSsfi6)oeBsfgl1v
zot~c7cs#DXy}cTb$2FhNTaUzs2mp0>cv#cvv@R|#YC4_P!NEc6k=PIcpt`QB(P&gB
zCnq%;jjHRq)+4bY&HfaWyQS+oZ~Q>c1%P0_0zj~)=K`!&D_a13qVN0KH{IRc$hDf@
z0~ij6EicdC{1syN0ovQ$-QC!GqiFyJgFy`jgO(%k2`4sXd9Yru*R6*D+HeyPlW+qz
a7W)XDQP0J>S}ec-0000<MNUMnLSTaUQ<9kg

delta 759
zcmV<T0to%33g-!sB!2{RLP=Bz2nYy#2xN!=000SaNLh0L00t%i00t%jpA$MG000Du
zNkl<Zc%1FsF>70A6vyF{VkpLh&e0O^;K6VgPxW9e#q@({)6js|%vl2&q)i_pW58Xk
z!JV{R5L6IB7JDwim_k6E3L!M1I7F}G|MRRux@XZ(M;D>@(FbO;*%T1zhmqhze@@Gb
zUtL|*a=EO%y}g!Wz`b&Fb5n<hhcy@szWKG9ZUD>WvexT$%Msw-S+Cc%TrRhAt!5j*
z<>h6q*X!!Ku8xn7Ta5wH+yj7M%{Bm^`p}*Y0D=hsRaMpZeN85l>ifR+C~T1cP<`Lm
zY&NUY)6<&GW+D(o0H}+LiyDu|K6P+#P~-8q=JR>$k=POepoYU?O{ddZtyVRiPV404
zr1eN_i2zVt*VSk=s`K;n8jVKPbzSR`*pj9{1?K*f-~luQxV*gdlNbVPfAz<!diU46
z|9ot5y{MxnN1uJ})1RK!v!9=RtI=pc0K$Cf4Se?ItX}^5a*NZ@ngBd7&wqbjw;yir
z^xVbuqR!r&-RZfzJG=Gbmlt<>F6{`w19SV~w#ldXUBf|JZURCu8^8neHEaCWUYGBW
z06Z{9PmX*A;D7TK0D=hsHv|&^2qpj!%uT=t=JlVizxep#dQtEHet)Oee*EL(&;C?+
zcW3ubuSr`1@W8zN?QQE3_>TArla2$GlWzkNlbHiOe^pi0_kB$!6aUf_MgXY3?`t-j
z)#>SJ&1N$Z2qFN~#l=O9$KyIUIH>V>T=V(7^+;@q08qo>u%^>#tyZg=PN#Kpa?*Mv
zwnPA^uIp+v8rAvvd5uP+>bkD=NNh>7KLzD}>AKDvKag_)AegTJ5UlCB05>-`wgC7<
z-}kk@How1>Yc;(GaCmsw^74G--w?YG(BA(3{?^_bO#?6(3~DeKv>bs?II$_qqs?Zs
pX*~qchMRzs@c|%{a03<=*gr_N&zKp6t4{y`002ovPDHLkV1k66eYOAq

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/boxplot_no_inverted_whisker.png b/lib/matplotlib/tests/baseline_images/test_axes/boxplot_no_inverted_whisker.png
index ec7107aea08054c5b134f4975eb5611ce26195bf..803db84f2dc241c328f176b79e0117310ba07973 100644
GIT binary patch
literal 1440
zcmeAS@N?(olHy`uVBq!ia0y~yU<5K54sfsm$=7f9rU5C-64!{5;QX|b^2DN42H(Vz
zf}H%4oXjMJvecsD%=|n<Jp(-h9fgdNl7eC@ef?ax0=@jAbbW{Wvx9+#a29w(7Beug
zse>@1Z^(_~3=FKio-U3d6?5L+HO!6<mpS&Z{<e-<3Ll5_0ReHI@{eWg)y7|{GcF5V
zxN+uX#)*X7UjjG1KBn;B+!7;jMZi%(!l?bh$`!$iEh&YQt7Z0|-z@c0#^6`sxrsIB
z{cpc5i*{HtKiZ!m!<|8427`kEV?zQH!$B5?CQb$xVFnI01_2+UB;>Zp{Q323*R|KB
zwlzOCJT-aX_w&ccWLX)RD=9`l-zA&IGOoG)`c{sa?sA6mb7`Abeyy@S72zAs@c#b(
z_3K`*djEUc<%WoJ3<?pK8Q#2oyH!T+Q6wYKH49d)YD-+PdGltewuN6qBmyrp{9t*I
zC(*WW+UeA}bLLzr+9}eg5XNxj=uy|RX`64|zrX%wPT2J6)7LIP;vvHnbo}`7tr0q}
zUcFi+*6k`QE4y``kn%>R1-sU*epwRr{P}a!xqho(@46P8q~g1u<H+5MrE|^e6trR9
zj@Znwr|$2q=VvcOToyg>^=s+rhl+8V{TYAl`|j(IaYmAXC0nYY{QW(UYfX6%ynB}i
zR4`8$9B|L}Gb+wtZ*nk*hM6|Q*?}XCmEm9w7sJ6dz%Vst0CRysZOPJ-5XK;IMp1!f
zGZSj~Kg)AiwJJ-Z&C1&PvpMJEJO>~<N^g2;QBlz8r$H=DCfpA9zkmJm@^aYW&z;@f
z-LuZ7ZQZ{=e)G*Wdiwg&{+$yom>2Z*_h)a6xN`MssIFMIm6cVNt*YB2pt-Mi&GK7b
zT2~i$`Q?^f>#~8Om)=x;&?;xXry6^`@-h1+RwTE4wqf9SHZeiqj2J`HO(us8%i>uc
z-LC%kr}FNdJ2hXQufDp<uI5L<>id6RTwH8rWAo?H`LeRIS4X?WxBuF^<+2IG?6b$T
z9!T%rxpU>^%a<=6pL_oK;{KEWpYs5H&)fj^{dZuPh%&Ggvq6FfEiD$CE3klY_P6&3
zYVZHnGB9}t)Vot!pvjcCVK?JK-SaGa((C>{jlDX5|8~jg@_h_<jO+hzj{bUE{&D~B
z>FG@WI%JrfK*?K<gXy4+umH#xpvXz%W;mF`s4xQ<ZP366sRO2gX95CE;4}yh1slN^
z^D4i-y1F)gchuTfA3l5tTYvZF&7EI&Y*A+TerC3Le%{|(KWpNaFJFGY!0b-xHeht#
zZ2;pnkqp1~l^3w|?v&&JM>SghI>YR!Fe4pkCz@k`p$|+Hpxg&dI8b+?XURLf90!px
z)SJk*JZn@CIAaV<kRVS2%>}ydjpJ)hgLTvO<FDP`p1=Rc=BrtupMU;Yy}tI-6HnXf
zZ*Qu7d)a2O9S}>Xxp$!E6fk813j=6~Y*^Ob&@XTQEg|5?83UfhvJ=dC4;(z`c>3Yb
zBlU{!cCGv9bK~}H>9>0?nlMa0xkPQU=V{FkGxxoZ_HPvYyX9`)_O<GaTOI-fm&6hV
dQYQTtfBQm6R<Z2BI$&wZ;OXk;vd$@?2>_xBN3Q??

literal 1392
zcmeAS@N?(olHy`uVBq!ia0y~yU<5K54sfsm$=7f9rU5CIVkgfK4j`!ENa+CbISV`@
ziy0W$)IgYVzOa=t0|Tp&r;B4q#hkZy4YQ-eWsW_p_tKa#!BT;V(b;Cky`#5f-<-X$
zb-v^5X${BH{M?<{vM;xv2<uX>KC$en7;hT~)4>UrEY9MkS}hZF{EGTtf3FNvp3m%N
zf6j8!`<>hG=51$n`L*&ZOG6n8LlY+hi!cL+8iRljgTf332Lr~21SW=qL`l4<JAH8d
zx^-E5<E}Te^GEqH=S}UGx4-u9U!AYoWO=)=%c2LW_O3gdcDabF;B}7K?5OqE7x!E(
zVg2y$@9$T;*8SR-Z^_&7l!u|ol=r~9cX_8DD$WxHxn|X>EQvNNTidmX5>fuGf~LF;
z{tS8Ti4s{mW3GMtSg1SQTaY7()nV@Z`PXyIR`1=rch=do(!#=vRbD+u6ctKKN<zAi
zF4EK2&)yhu<>AA`*P4bx+6=2+@0#VeytJ$=?DESkyVhmfs=8hJ((Q0ZF7|rmWA;r<
zFmIc3A9#IzeeFG-Uej2{nAq5@GIEbhe~T=5UwxmY<=7lXhYiaZE55&r1-drwGJ{Rs
zpB+y>2%HxK2ju7b4FYGF9TjHi!UFY-q5{iipxJh;4GCck0%s%{z+7Mm%P=_^Xftp;
z6A);MWJC@2VsnMiP*Wb~x%1}zn%z=pt^j1~PCspBXSeQYktUPlEY=0@e^>qblDYcf
z&m%v7R-R4UeCzh@)i-m(#KpzeE<fTihcUq2-F<6>&Z|$KHi>n+%F4-Yn<u0UH0f$-
ztnc#6R@T<5UzSA0Uf&87%`CI6n7W%WfAYH5dp<JXWI}RFr5ppxXAc98G;W52IgAPs
zm-U%G{<W?Dw`bk@_4|K)zM2&(Z&$P9;`_QE9};C{WNJR9TU%RyeRQ;2`fuE=OsR&m
zY007==ElayUq5;B<cr7Wo`1f0{K;)g=7xlGz{CcO>(90f9BHf!2Z6x~3JmmAc!!tc
zAPCR;Yh7^v`#vt7UXb2*Y%K}C%n$M$GEN&azMpY;{{MBqK7TiR{As^3L;0Db_WQ5o
z@Be4`Z%6&v*V`|;KaI9zX#pi^8v&N4N;P0~0Hb0XFe-pi2J&n)#09_v4^jt;BWRRC
zazUli1=-K9uCA8eU$!;s>cN8td*gO*-dy~+Fw>pk-3;^mdv|_p{rq!}pP%2p$2mLR
z0z+xWZbn5Aj@ZobrS|;;4yj^e0hVG84vaj--sE6#9%v_;V}N1329g!qfvJfL?k@EF
zxl>x82^mAZiJWu6X)zs`&_JGq#Nmy<*Mt*d^yBxf*`9yD?qmAutE--U{uv(s`^m}4
zRo~v+?4KpYYr@;0d*H{O#-CH19YApc3lU#_MtR$+CkGdNn3*WyX04Df)$sT4-)V<G
zcm8*}QyTkt=7!z7t#4H?&SX%V><KIarUgGRuD!o~9+UDeP@%I{opH-UU~(s`#Q7~=
Yt{}9@IOh+rOl4s3boFyt=akR{0OZCV$p8QV

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/boxplot_rc_parameters.pdf b/lib/matplotlib/tests/baseline_images/test_axes/boxplot_rc_parameters.pdf
index 57e0fb494244d76b183d3dad0085ee7349b1689f..cc9433bebd313f1293aa9870e5d6aeb2a0b01d2a 100644
GIT binary patch
delta 1932
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
Dl=n7f

delta 2151
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

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/boxplot_rc_parameters.png b/lib/matplotlib/tests/baseline_images/test_axes/boxplot_rc_parameters.png
index 61507b39c9cce326cf34fd29e146daec43a5b8b8..07b8a5da72473a8afa77098d113ff82dbf3c3db6 100644
GIT binary patch
literal 7768
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

literal 7709
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

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/boxplot_sym.png b/lib/matplotlib/tests/baseline_images/test_axes/boxplot_sym.png
index 7037ca022975858205dc08a0acb4e6dc8d3dcf42..9ac36a98b2aec08c703b021e17645863e051d13b 100644
GIT binary patch
literal 1304
zcmeAS@N?(olHy`uVBq!ia0y~yU<5K54sfsm$=7f9rU5C-64!{5;QX|b^2DN42H(Vz
zf}H%4oXjMJvecsD%=|n<Jp(-h9fgdNl7eC@ef?ax0=@jAbbW{Wvx9+#a29w(7Beug
zse>@1Z^(_~3=Ax-o-U3d6?5L+-Ix^}E_3|j<ZaEW`EtIF$E28;^zZ#)n```AmPP9I
zO<CqD_VbMSOZ63+9lH-)a6HtMW>jH3tIO(Y%LES3X{93n?dEHWC%)sX|M>LYYVPNE
zYwYHWD_rv5D$a04nL)sZL16}ig8^eh0u#eQ7KSEH1{Prk4mF}A_Fu93m|&p6&(FW~
zX3n&~fB#0EZkYS|%a;(Vxqg;5HZ@<1L-#W6*uP(Y^2sI7gc6?ns7)>^FW)}3ICM9Y
zg|+qXXZsu9e&oSr=c>INU&7|pTj@VO{_%6+?**~z>|#P=0`)dW%w^bf;YVRip56T`
zacoC*u00e3n^DaD!Rc-Dw?oO>j_ZV}Gw452y!_6f`|3_s9Ddu7#VEnUmTDq()yg&?
zhS6cm+#3=sD-Mg25CYi4>^GBxK{$iJnSDTv#k8w+Y=16({r%TyuHXFr_QQ#mwzj%U
zr(DX~>b3p$+O1nGy3+!?Ds_|?vVZ;JzWVy>spI|f+H2KjN3J=qi|MpFwwOytkGjr0
zn|A+ijfKp#xb@%9o|o!%+qq{?&Dy0$4ZF_@HmIIW+q|_t`rp0j6Ti+l`fLYgfSfs|
zAaJId!Mp1JXZxjpe*XSdfBG0u<qe4x&-(wrvo-hs-FWZ*zo$<p`x<qh#Svw3EK!%f
ze*Jpr{Qi5r&%Arx9-B@RIjv*n&M?hHu3x+^&wSQfplb@bF_YPR#_Lz!e?MJfRcrUJ
z$b44V>d;+x^MH<zH0cgHlPt&>F<Ji#FebmE$7EWv0LL>fhNhbmEKNI^aKtjvNjoi`
z0b-gs1Af!4-ealJK4(97`p3sVe(tEfpcgK`PHUaU^vE@S3~?EMEcDFh=V$3RCyBi-
zfOvK%YsJEEj@1thZzqeb7H$y#G$FHm#?e=IfXM_i->tb-&Cq;s!JT{ertRIkH_E$V
zu8CCdsgEB&hMf!j>bhX@;>DM8%(C?omH*v;_~OZvC7--1xHnta+3C&oOV@tB$?yc*
z-lP97_n*?4_BqdP{`qWurWJ>s9f-`)XzBTlefOGg0{gGsss)x(44$rjF6*2UngBt2
B)}jCa

delta 865
zcmbQi^^9|ZN<B-llV=DA5Y%v_bTBY5a29w(7Beugsev%#d|@kP1_qW6PZ!6KiaBrZ
z?#+%4mpT4$a!^;iS$|y465k`;=KObet8M<z-gvC4%)R*^`+3IvrP=I~JW(NgJR_Xd
zn$4A8Eb=o|RB_6`7Wk)jo~C%>J5KwL5AUt!etx&aifOLc#M^Fe_SdZn*I(D}@9$5|
z&tL!M{rl@tY&mnEKYxBHYwM|p4<D|czxtKvfy0NLC41dWr!z#Sn@COl{rh+CoYl8P
z58S+Y)BHbgPG9=ue~c1dVQ*a*Y=89Ua;2mlZ+zcu_OnHQKkj<eRW$SHBbEf$!^;zQ
z{;i3wmK50>(H70Xp~fI^M)yG1EcUZAkLUD7>i98)JyE>;&7k|}PS(kaOyUw7vKU`{
ztx7eJxMF1+5X0!OW$g_KmKBFZCkrxZOjcmBH7VVF*GR5EzVG+nI!jwy-KA5CN=ia*
zy)9e2^yo~}?w~WtVvG@&uE($NTOPb_-8!wcYO^DCCQoD%tDkfE=uy|1K5F;>?z#Vd
zy5I88XU~_Fm!E$6^l7%PZeQe@eugudMl*H(-v0D`UysgloomN+8CZnDPWE9?n8Dy+
zz}S#r#@3i{k9o%B_51$>pPIj4|Nr(iy+EzKj?cb)-~aw}`~80r@ACh@n!=wQ=Wnz*
zLjF8l=VUG>p89953oP&6xpU^vpVxOY_HEg{`?r*LSE|@+WrkuYzIJ2#?b2tT%{cmN
z2WvwD6T?9kh9*v!6V9A(@P1XcJJm*RzfAp3>9ZFv24-%*y>*&c`ZXOd!~RH?1kZf|
zw-4(~doG5g3*_)#M}-;M3><060vt@wxF+*4X#>MijJK8%A{@`a0Tz|^3au9Yu-4*#
zNnD%%;pvZ`Ic|=r-?MJVqL{Re7K{-WKV(Ma+26kw$97a_+CzvP#oQYfJ##F6W;i=p
ztXsH2wDQCj+cQapd5n`7MZ&_~+BU?k4}bUW-Klfu{MM=-2$SMrTY51g=SfUxJd2f`
zonCcywdwQ?V*lS4loS;ORjTf3jWm(!1*Sl=B0cHmH5a4**#BK|Cduyovdb^Gd{b($
jvSDeNyn)$F>>u;nJKwG5<+U0EGZ2HPtDnm{r-UW|57B?r

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/boxplot_sym2.png b/lib/matplotlib/tests/baseline_images/test_axes/boxplot_sym2.png
index c9a1e8826741566eca6188aa2904570fc7443be6..a3095f5dc26fbae36dffe3e4f51839759689688f 100644
GIT binary patch
literal 5318
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
V+J3>fB>=uYJ?!mHJ9z5CUjdVWKWG2|

literal 5318
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
Y-?zb>H`rUu0^oJn58>N*FzWI@0QC1CHvj+t

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/boxplot_with_CIarray.png b/lib/matplotlib/tests/baseline_images/test_axes/boxplot_with_CIarray.png
index 3bf1c27df9478cdf419f14c946c2641b251be52c..d830e2355492a2c3c4b106010e29f4c83b941109 100644
GIT binary patch
delta 1834
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
Yzd^uJ)RE9oUjP6A07*qoM6N<$g4}qNsQ>@~

delta 1789
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

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/bxp_baseline.png b/lib/matplotlib/tests/baseline_images/test_axes/bxp_baseline.png
index fdaf2e157961fcd1209458cc4f083ab97c08290e..44de05620d1947c2dca92d52cab49994822ca653 100644
GIT binary patch
delta 2496
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

literal 2681
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
Y-1BNSKc8rV{vCna{sT@lhmhod0mK5s>;M1&

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/bxp_custom_capwidth.png b/lib/matplotlib/tests/baseline_images/test_axes/bxp_custom_capwidth.png
index cf5bc41bdbee463d255deebdac378f45f434bd2b..2e7c530beecfad9b7e8ce47f48e91566fc2b0af8 100644
GIT binary patch
delta 2518
zcmYjS3pmql8-F&-mSR(pa#~r)>m8DMi6NDDND@LuNX}U~CTtFG@r}2S<)gx=<V@bB
zIYx{riW-Ju<xSXHlygqsfAwA8_x-QyxvuAa?*IK9?%(hJ-7n>;<o=0+8K&=3-K&S!
z#p`Ng{ldb?p+-77!Jc8{ppdX2e=mH<6<-}Q{@pX_NotfGE-IX_480`j3{O<THuNy;
zI6T%)38yU}zM~Z-tEG1DV|ANP($pmzJBRBIA`Zgz{&BDP_GWFB>x3wU?h6T;2kdON
zo=%j^{A?DD)f3%&(sV<a`S)LHQ(sEs9H%$d-odBhHVBO#Yr=jZFYv|q6&GL=KqdhY
zi2^OUa5^4Fpqs)_l-(qm^>5?WCr_UAAE^(=cL6V-t5;o=m6Zbm18FhZMX;H*MZR!t
zWznjL`@<U%;gqq8rhfW#v4+JeV=}ouyQnU<JTUzBElCEQ&Do1RpUnkJ<SL04X(Nz-
z)EqPUt}aw6p(T93fwwd$Hp3ux@7ncxeQm|yz<~_P5++{)XptvgDbLT%`MrG-ESQ>l
zy|h#-%m_FNfZSk1WYzWS*AMFJ-!CZGBN}3I!iff+vY28sqg<!RNY*9((~2)&zOX~Q
zLhEHwzuyZp%3Vs?fYGSMiVUZo*k`+epq14h>VW~pTlnIIz1W`%y|8?I%sCUv;vd{1
zpbZ}$;|l6@CIM*skshF%3c%LC^|0p^l)-rg{wA>Xz698+_QT)za&RzPMwL)rU9HC}
zd>@Gb0<WMTo1#+;@r`U5gp(*XLIYlazckud5_G6c0x9!*2A)*^pt2Iraf}CMq?qOL
zEThX~Nw_HrJ7v3IdOFfg7AL_1N)~cx5{U#Y@CvQ7`uKdtWElmY#eJ1~B(rPWEz4fN
zDiSVfo*y3%Tl+4o+O42~MJNdcf;VZ3hqsw7_v9Gf4|%$L!uM4UF$NVi0&{DQBL(s*
z`_FpB7S;sv1RZILmDWdFNlnp?LqSd>BO@;;7n$`DqB~Hw$L8a)fdl0!b8Dw>V^Luc
zAfl0m!_~+{C6nm6`!%VfqwXBJ{tltc`_6PVtxPL%m{noMpGt;f^*CmXq1<ou=fy16
zSqlpbfk@=2PQOgDKRIx#Yy7XWXBrwB`-r)@x#?-Li1-c;r^dG@kL?~FL;j-i&QQc}
z_JDBbc6X<W(ag(J;rX=Nn|x|Vx<`UHlvf49sVPsoG(wp&CFn0Rik|Zu+nGCdflRjR
z$ulVv)Sy+2d!YpV5;yYc<=yblgVm)Ssc;x3RP|8a1?EsD=TxOdOFKKgm0?`dcvhWG
zTvf-WfaE6AOUCIBAWludTG(Ha(Em?^jm;Zz>LAAd$S?CB0;an<wzI9h;4N8Cn8VmW
zfB)B%*@>PqDZtxveaXrOEZrMUQ7FPBnhv563i7T%TU#3{d53nd(}niLvz2bI`}%I-
zrbe5t)kl5xa<+h>h<>m~wY9}5DVyb_HszX9+^51^+uGWoRDK_$>Gbu^e6^#~=_zX`
z6yDQ%;n+;8{h3z8j66bYsq&EsKjA<H<qm_v(`jD4x3V}boEP#urIA=fx;FgK!Gpza
z_%dhh(z-gAyN80`3^9F8zcZp^`ej>+{*VV;F89U6?47%Jxdj$C!oGbZHpQ+uRa8_^
zzTX)da*0#LkToBJ!Kbke-<DTj@EamT_GiwVaSlOa;prxlZZAJh2++0TVQLr(3nbG<
z8X}=w`1fykXzm~gqD%`53y()mk5)W+{Co9wj6vCjZ|v|f?O%Vb_<U~jIZI1R+_a)(
z)y++ovBwOqju~H$`7o~|0b6>^9)&OUM!+lgEy%arc%om5p`#9z+j<=Vs?MaSqcM*p
zfkMYsK=rhhpmM0xb79c5oB{*aUqhoBa-Kj!13+^W>c_kTlARx=3WEZ9@u!*1mzJ__
zP18Qb3UQ@9kG_rS9S8Xrw{NV{=2*=)HlE(5B(3LBjGT@!%uA;yig$1lj$D{8O<c;C
zAa@EJkzdmX^<lBK(+D@~AmsbDSdI6)Z^9_B{}%`A&wKOHDukF?f$EIr4yl0PVAA|G
z*5k(x=j6BU0ZLj~U1jTh8}<8c_??~xkCG+KLE9v-V-{cXsZC39_lkt?g<>;HaBLhU
zAyo$0`Rq||KisL6ISBGah=8m?FjF8xxOuB#&MQD~62FzMiIk^^4S6ECWwnn~cjY()
zRK|ml<~66p#6&H5+Uc#xe5-;@Ev>ByCoC-;wdKRtSFaXw{iV_9G6yXPHsZ>Hh)dTv
z<+M(@a>d>plVo5_)k=~FG#c$rcD7xCT`#xjRE;-BCU~UYadvh#ASkF0ZMvHO>$xXM
z21-;+5@jK{#X+mkL2Dl|z|YUF&dsUX*&#HP`E>nzVAHil+qAR|<w_<~zq|nEus_3q
znutUTK0c?rIy*ZrtE{VPY#?(sqiW?`k-8=(6)}XWx;n%0D~6)s8gU2mY%-yupxeA<
zg`6cYJeIE+&>8wL80$BACEe6CGcg<JhNx|nXV1({t}T?8@(58gX18q~mhvE_b>aM}
z45`7=#<rCPK)ykoL=Qk}?F^~*e`P!nV$lyK{f9`hkd1)k{S-`$4QPv!`X8~xJ|&dB
zZ-3syHlk5-0vBZG<{GdtoyU$*a>!dCmU)}C=o*Q8>Ca|i-R*4_mkLLDc)_W}<VSV2
z#cWYRMm7Mg@<l0=QsT3fQ1G8*wS_{9Xw<H*u6L4PLk*QsPg2U2G=s|Jqc_4FON4rD
z`b{}GRYD?r!ntB$VWGZT`uSz>xTdB=T(@}d@Q8>3pB&BQnO!)7Wls72tS%qkaX@Zc
zDFR!zY}u`>>{#s_MzZQxF^wz#@WJzCcXutmQ2nNgiC7!vXM0Q=AhUUG;cndOS4*Bx
zQtJwEc5~}vvy-I$ND$hWE_`~asB9c%Cm|tGX<hQ%ml6BW;)V=#OdS+Q$<px{h~&pk
z)Ti1-se%#*s}hG7;kyi`CMSEp&kN_5Cm7=G6%PgVw$paj_;b~Hg$^R9;X}^~2%7WW
z*|Z3IpSU>97xtB$F^XHQ71{?3@OVXsLq;bdd4Udm(b<^{wTXG|DO3NrxY2M!gITo>
zf@gHJ>vD{Hs7+{SO0WrYsNB6Vs$k1bd~sD(Pq?9DL%8r?7kzze8XI#4f0>+_d4!wl
zFFQM2d-?v~0Rfydps)YUn+#W1SGTNqz8Kwdhy}8Mu836IIoJ#fZ%=Q@8gSPH&__IO
Ld#v*4`GkK1{M?=7

delta 2546
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

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/bxp_custom_capwidths.png b/lib/matplotlib/tests/baseline_images/test_axes/bxp_custom_capwidths.png
index 936bd18a2b6c01191ebf98e6a0c2ddd0cdf964c8..1d8e44ccbecdb94928bdb69fb260565574209929 100644
GIT binary patch
delta 2588
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

literal 2826
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

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/bxp_custombox.png b/lib/matplotlib/tests/baseline_images/test_axes/bxp_custombox.png
index 19e3731575c70f368ed50d1de701567ed8a359a2..587ac5e68b431636d3c63a71ea12af6d96544809 100644
GIT binary patch
literal 2729
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

literal 2676
zcmbtWX;f3!7Cwo97(rqg4HZ!l3dBUFQWQ)86(XZ)1cM+bq)ajtP{uIHBo?p~6e>ex
zG-Z@QCV?mpNcuoP86$&$ObG#GFhD{t_Q&h{_txrJ>zupKch5d&f9LLXzkS=<(nK7A
zLI42738rU=0Kgy<FhoV5ah}us6Z8=BHzJTkp%y0Uk^s&3_?nXa0T5B%>9AbMlSctS
z$PmsLl7g~0A8@7)?x@#Gx$~C$jhvhY&dCWKl@TG|RsAG0q~|U9W4p2u+a-}DrHMf!
zG|wWnFK5&)S{~D+y^xZ5gTJ&}{W#lYoEG~?QT{p7)ZLx+@sqNL_b;~G&6a6uE_XL3
zll8;&)BE$h>}h>2uh%y$EDQ~l`Kl`b#25n*w;x1a6#`CjFd%pCUrg7g@2W@eH)@~M
z)!pE4tln({ep8E!)*KGU!^6X`rJM#^T%Iy(4qdlAc<|uic-UlzK+vL8cnI{DJN#&7
zb_Wq_)P5EGB+P-;)YQb-8#pOg;2D)Pn6+LX3@IWFtn<-K?Ng^p&`cwVsg4;K&}pwS
z_xJaoo1N`uvFuk4<AuRHCoeCHm)9<Md3mYH+_7_XlrShzKMW#K0fB)fBsF(eSCc{_
z!NI}dVSK<bZCDg4ARxfa&CRr=qy&XRB?^?D&{W_sjk%ebgz&Zs+8$9K;#^K~v;uf)
zS{9mvfP*UqeFj#-7WklF?bh|BNnr6v?Lx3xbSM0+P|dMI$b1Aqn<!wMfP)ji03ha!
zLZ0{q0ok4~(DvVVBWNske&Iut-IXi*45Xf#0LGoEDT;-;`A#sBl9DlaOJ5Vkpe6R8
zmW71{y{^tSRU3z^5C{Z}d^ikXA=l#W?hAyTnVCngUccUzBAOay47`ogCHQ<k>d>M7
zt*xgJo<Fi_Wo1=TUHxNkZ|}o+KMEmtPX;AZ0T*7X>oYR5H1RqH?*w_++1VwAPvmB0
zy=#k?(9zR7KowPTfay~=NJ&XajS<@|D0%tXni{DP(*)M@=g~z)McUfh1$4UVaSSF-
zp(kC5YJ4{?PNbM=;#Gz29UA(*v8gG)S)+YyY>a;8)xf}|vHcDfJ<<#YBQiNTxu(AU
zQGWhWaWSzNg;X+~B^~7Aa>m)&SuOoMbWU%3yXnkf2SVG@($de5(tWO9H%&#vMpxf(
zAs4N#-hkTKrhdXRHoG(=B;;LRUr~1U!Lsu5KQ5u;6l^fO0gPH|IVf1B&LqA(A|K(z
zlKvq#RRT=z3KZ^Cu@s8dg@6drNKtbuE6=M}4R77L)vcR-O-oBFA2O{*Mp-P9tLrp<
z{r3kCboBMvo^Ce`!KD4vi{I#Ux<s#)MhyPAd~(`o(zL%b>cD~90wu-UpuPDwl^jzd
zos@V45J!E9J02b?If{;{h)AiFeznj|lBK?3i;^^;r)9s7X1_|34_TdiuL47w-94NO
zEh3SIY0i5!UPMVoea)UqCs^g<$NM?bSMgsHDq06dwVx9m3nPq5A{o3Ngn-z@EaL>X
z`{-=narc{R6QNY<)Ou%&jm>F+d2K}N4YQ#S$G0~Zym{Od1s-3&b_@w@ZJ4i?=PRat
z&?=5C-)FgYolc&}gIHo${D+69rlzG`;m=DdS{eu9s+%s4_=XDxmm)_zz0ws<Z+%&p
z#ddD<#>cNxXT{ikHuPrxoU^~`>~M5j3f2pqT2p(GS21_l!gKyjuBt8Y#kv7Dm+N>^
zXk(+Gx!GzoH|O36E@HV2+kGe^3uBUt!)`z4ESwKq$P#RGKYXt1Cm2rE^Cm~C6)fXm
zEDepl)}Dj2#)V4(nMK4}+m{`QqZ89a`c~qg1TM`{=4_}aGIWsaIWe1Oq4H*Xsd{g^
zQz^+GV-Wn&doZ}dCGR@Ch<NkKlN^CC&WE3F7SpQzYGh>D&)K$tV>qHq8#t>co?$e2
zd+W<=@iH?uJ-s(RI9QS*JeJs1CCOXb<SyLHUO%rqq!79HbZhAY-3j|OvdsfmIt?y5
zdBoyReat5MzPNV1EJXs$HU;<k9CN;yCXGi>ic2!Z`kALodh|;IkBwC)K1O#aK(H%C
zrtRgqIln>IhU+vQ5#4zC=157#cj~})SwJCwtWNy7A^EAT<^>Tzaoq^B(YSXuSi>4Y
zQCZHfsMspLb1<^&{3p%4QegjP^S-d|9}XAouz!<m{P>yar}x{q|GgKKUE&KDU_u}L
zl-s7!ge&XU>*e5}A?<mCf<}TSAbxks;Xf|*SJuc>Y7eJ%EAP;@ptTXRPN*oTXiZ<C
zl{5KS&-xq-w%@I5nfBne)tXPQtm}D5Q$T_B&Bm-Zi+W~Nbt?Q&Zd7>I=eo`ib=(bp
z)a01j+wD(Zh)$|K?s(g<``I?@CuPSWHo?5WkuJNWD!8wX&-^CSZh%UA-1<JEVSB@b
z*Y$V<J0#z^x_Gq1ozZL%7-~i3m#t8rhFZQW_rsdXu177B-`Jl^la8GHiOU;jZnU&8
zV;y$riUZlOa5BbKGpsW;P2Md*8iq_@W{TxjE3t4I-a^1nHP+wY8uDw%YpaA-z72o;
z*J*>s(!8EZJ2Edwt2dG3HM{18yRX~iK`ZnvHxbJdi<Ii<l*M|4e$zc%r?v6v0aibG
zt$FR{Y!erwcj8tKF0hXM^~*%6x3rdGIXYIS8?U=e(mbYmhaZfFb~?r~Jy*K?cuIvk
zt8(_34rXG9hu@cEmVDd6Uf2kIL7qC0q^eIWvmt@{)UxBc@tS32Qzo^WzSEX^FRpQ4
zLrh)ajUTJo<^*=UW^G(Xz>*>}6sJ6dP+Wsjk!Y4ccz+B1D%||7$}We#KATlPj{itY
zcEj5)9{N<2e!>%YLNi-vS+N5F@KoggqvDq;!N9<P^*zc%8worKM7lpK7ePxQ9@>bH
zHPfUS0zr8D`(2-Y76o!L+F<#n6`q0G2MO2L9}W^yF=I&Cc7PyFWL8FIX7{sa&s4ZR
z-rgRQ?9bIoI=Z@^L0_&};m+~TY}$iKd3pbDA)Suv-t`Y5RDdcCX{Z}OTdDm+C}p7S
zcZ8DszxYI)q8^FkeUe4kjS&)$<nyVhsEd_`ZL&LIWQYif<->s(R7>rMZe>9c%rjU{
zxYreb4aN{j3NfP=r;-3zl^GUsP!EAFh=mmT`xGr0tS$O`n1qCco*3wCuljSiQ^O6^
z)YYAGG`UAfEl5t@H$CrnEVfH=Ne}Z!Vc|>Wlf%OMB8!TYb#!!s$+i!z7poNR6TgUk
tlY7((m7J22Vk`m2%l!%e_vO^~Ze$vzd?EOJKU6jX!dc5R<wj1?e*wAQx>f)H

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/bxp_customcap.png b/lib/matplotlib/tests/baseline_images/test_axes/bxp_customcap.png
index cced1e51566ea4566d213974d34356acae0cea11..3323a7e4e1ec2e2d80a77805728de25308f7837a 100644
GIT binary patch
literal 2109
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

literal 2055
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

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/bxp_customoutlier.png b/lib/matplotlib/tests/baseline_images/test_axes/bxp_customoutlier.png
index 698bc40f15c23c27e5ab506cdabe8451f36b2946..901309e6fa62bc9c7fcc56d100e7ff04e323acdc 100644
GIT binary patch
delta 1818
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
O40wC&cW>BD$^Hj*|0tUP

delta 1749
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
Mr@IfM$?Z(`U%?vp%m4rY

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/bxp_custompatchartist.png b/lib/matplotlib/tests/baseline_images/test_axes/bxp_custompatchartist.png
index 32c9229da00a7bd06fa94c96292891d7f3d380df..234f2941bdc0d47f5961e7b1d38ba18d52de8793 100644
GIT binary patch
literal 13548
zcmeHuXIN9)*6yMR3IcXeDJmc$(tAe{As`^3cM$2)dv79w2oeiO6$~J~ql6L!1(Bu!
z1Zkm2FQIqHok6$mbB^bH-~I0WbD!t_*c+3z)+}SZ;~npqYb5-ZiaZs?843u3s9*}$
z;SfX|2th<c2g$%Uf?xW-gFm9KayqW+4i>H+rq1S&vZ<@%T?f~@*0;~On>)K$JJ|Db
z@o@26IcMeS>gXcI&29JV1}+C@OKur#f;t%FkfVaG3k1=a68<B4EuCo%K?1t4>sK{A
z6Xym3JfC^^;TN@!DJYyfL_~~aWo5s5PQc{Jha9*QPaa1}lmJGBV=vC#P4SJ5{?{-5
zhCS|O2CvfFP$K4eVl$=cEtAMow!6IrS!uW76xIqs*C-VHkBP9M6%?EU@FEkW_HunJ
ziN5o`QtgdyPJ&GpG+x4N-~GpyE3i26cgqs0V1bS|(x!;PU!IzSf#6Tnc?f(GxepzL
zpdmWqa}X40_Wv*ZpO_>LmO&Z!@&5h$uG5|D>6w`v=g+@$6$RE+UXV~tN=ibFL~uNf
zn;h4pBXT^fk|dVi-*3=i4(zTb;xuw^yfwiRb(r~JpxNW(WG?n4s;4nArf<(c(1OLi
zdegD-aq5&t!|M=zNKd)LjT>Y{N1(t%4P(u3`ujH+Uw!(dc=FV#?9$RsS9aiA=I29R
z$(E=G;g{*DIr#b2Q*S*uDFZ<l54K@*_q`tWUwEDDDhV|7^4+_un%deqSy?bqQBl1L
z=X3-DaWgj5sg44mB`PaB8-Dd_kXC_FUY~uXa*lR^7WkN*oqaR*zSA{`{=hsbF%<V2
zd{JsYAa?TPN$d7x$?4hI&SXg+4Gj&X+sxOa#0>9}WEuitBT!)Y9Y@Do2M!##eEBk_
zElK=YoTn*+m6er(xw(0EPEN;geOTTg_4rOJVeYoq`T1IAX0PVacz@%KC&>5juiN#O
z!WyF()ZN_5QYm<i2uK!511m?kwhDF|EG_mlnl-*NA_Z2Uk9qQh83x9z{61O~-53>8
zy?^uVu}{xFH8*$2(numxQ_o|~WMyT0i_IS{Eiacjk15KYyj^t!B7z*R!{LZ>yS@y=
zO82bX+?MVG23lH#4^uJnj72CS(xZoi$)MWvV`F2zMP_016%&kkIz_iPMmIM%315II
zsI<Zs>*(TmUp}ITc+@I<*^c~h%McQYWXaPj`{a6>=bkN?3!;|=X0$&*4qV5VPef0W
ze;$HNMuvYFA<*SVxTaFlLFbz0ip~Yv>JX7az~G9&jC$4HW%iYGLU~5jdf+4Q0-xcT
zK#_BR{ziYhWYeBX>n~RjQGPifLFRgtC~lIBoLuwPt(R$O7v}ma)WgGRza9Xv)&Ltt
zp~M)ZeB<U!bV8PeIRc@f(&=d%K_Q{(y=~ljs5DIR=FQFw<pkH+9$o;Qv)M;vB!Jaw
zO_i0E5lGwoig84AqZFe!bsz&+{7_+HB0UUlXgI*i6zwPBP7jIi-^`(%uVG}A%;-IN
zo{EZUlkx1CGnnU``cG3*3Z8LjpZPT?3<m2hw@YxJ>rF2%<};>s)YW}K_#n^db&u>w
zEgxyE+Uwk04O7!pMI|NWSYpUb%g897LEL?^Hi$&8=yoU{A7AP14-{QpUDg0Qm$|ux
z4KD;XNAmKR$($915**o%ybWF!eiKXrU1w!wweHH+%xH#qsC$S(@^Cy1LJ+FuB|r*l
zBtV1UF4F%S7vximi{YW6p_e&11r0&ws(rxfnLP1=>vkGNSpBD#7L7|M;5TmEpK=D5
z5^6US2(b-K{I{0S!qRa7f`Uy!tbtwI*x0~TRHC%<4YC0AI?Rb4kZ6I80DSzr$R;~S
zO#oS=rlzL#0Lsl9=Y!38bXNGXprB@Tb+z}}H_I{*>~lRuvLFC5nn@i`J8`__9n#{1
zE}{UPoIG*D>T9m9jje6ROaWSIr)Ot#`B_p@UPq?t%))T}UGn-fiRf>@yqN^zDJoJ!
z@2wV;-TlTl_pL-8P-t(7Wi&uShB1DtTg-hn4n(nXEX5Gt1pw=M|K$X%0s;*GDoNa9
z8a0#OQEJ`cI^foAJ<*n=S7Px9Cjz+>0-(OPx0eM57N~f0CFR($<Ht3%w8np7a(4DE
zEat}JUmQ^3lKJbw{Hi5I7-oK;lJG<&Sz&JO%}Nj48UuMPwJT9H5#Z;GsE3t-eSLjh
zJv|~jI{yAO7Hx?zTAtkc%>+?GxBxrb^_AOsQV&(H4~k2WJFd?Uc#prZEH!JSu1g7h
zyZo?^5E*ZmmYfMzT<>>@29OrqS=`z2y)UB=T%+iL^;^fa`1!7Uk@u=*cz0@n?(N%q
zEe?@^)f?+`_p`GvSL1ha+SjfHb45W#>*)1roGufwp+o>)h<J$Z?HZMare?a&d_|+j
zqgx=#0GC<p(ojN$?}mn6g2iUtx`g~zVmb4UoT*b;cmPSDwjgrGTeh}2eEj@wTPxN%
z^=R7(oYHwHDo6<{LyP5bZH*VK@d<6nKYD?bSf+4yQeGP4Gq}tMs5`5yO!LV_!?(xo
znwZFxShjzC!Ed?J@6tYX|ExWaj<s)v>)xIp$azDbgg-M)A8P>woU2<hd5kph&=51z
z=7VJ4C79phL*vdQkHJmxXz8^cGvL_Dm0_9y9qdMf@L>%RDFe{}{P`9l`p~~;!O;uu
z1)t;N&w#wMIeriPKPw~SzE3D|E$QcP-`LqPLoV!IUS2h$CfvkBm+tlyUR_;X?XC1E
zn1VOR%`(0e9`qb##hvsXeI&dUMFNp_e0s*g3Zs!&sAa|NELF7owRzCb%0chXju@pv
zCSl^ZDnOIr-kW2wW$tr&*r>MNGTX8Myg%#3i$=~qbnfS&5h|yGTeVanAtBzwp|mS=
z4gvbyRSUs@YL#Q}HD3`G)g}0vWr|#SBS<S(Cp9wiFi0HN+NHL0S*DVG=GB~?i<|g(
zsSgHv$`<(qN^Q@U#8zor&4!V!QyjRM58O@&uGQ%-)LeOAsrRZ4_y}^rCs*sYE#>wD
z*@P%Pe}345vG1+ZEAWNQ%gd3%sKCbBXIyCn$oBU7J{g@NCc9YE6PKA_kAkgZ1JHo5
z&j6m7N)2Pg<QrDfE#Jx7+w=FEQZmNa7F1^(pgc9%k+N6H&k>NHh{hiw;A@4-b&<aI
ztV7izVx3})l<1~Jk?}%AL`12}gbLQJ24vOC931L~h79PTcbB=6&;d;I2O@<-fot3&
z9(ir8y+QjmT`W*e5VHOdaWXqU|7*5pPRofyL&eO{h%yH^cQ>$Xh4v+rn2d~zFbv4;
zE=`SQOwoi8B$bI&fWwdFK!I}3&dw|_H#axbJZi>&ViBY*tP?aVL(2n+-2I*CU7L7S
z^~>+7`TI+S1Q9jwC!gO*#SL7obf3d8M@!VDGX|OyXur|0|9jc(4-v!B9p4Z1Jp3zD
z9Hyqmd_TbExMy+T2y{g53GEPdKA=gEBtVXYZaPXzO4?Xi(Jd}}`}hE6cwJQ`k)Dwe
zwXyk-mRn0tulGR;`7$A!-*f~C?=n04>GgJfb@f*xBO^}uDmroEbAi~LH*d7h3fp%A
zAyno#d`)s^q5hQ~Ywd=a+(%BrD9XyM4^li9hOXurqm8gT<HBWknh<J!MmKMQ3>8br
z-I*!=-W$6U$v!I2o;}m6bkB32@3+q9sbbGPSi#E4X?N3jomJ`i0!kFr1VbM0>x=>7
z=4-a?2mH6^ymuBGS0`UZPfum0XzA*nKF>3xbCh@?jECIua2zw~+10f*kgb%Pnwo&Z
z({OfPS}@z)-Bnao)eZ<idwYBLP?z7bv&&OdRMcs5xtCKQJmJt#3vF<M9X(|k@LM0K
zSzv>Kr?*-xrAEc6A)ZCxj177zUmb+&_S_rerA1ZWk>fR^5Okb|=ty9DT_`0hELwVR
zgOw>@B%IB+kqElT2#T1LFeZN;#0pqxHX4mx*8#Kdts3LIJm`UN0u|2!Oj)@LASmpt
z)O;mQib2d(VST^@>qznud}$341s(#~pW5u!75@~FM5v>KzoFc6K(vVM(78ZFCL_#{
zSmf2B4Ow8irX(4t7EUS?#(U{2=PSd--63*mk*X1&g`syxrBhBCLkAg&U)H~Md#tas
zcmR42_9I_7LJ2(ptB5lBKnoqIr=tUT`+rM191dm-s;Q9zTt$Uuq7I|dA_4WBSS}P*
zOVCFzUWo3n2@7|-!oax9Hz4{T5Jv1LD5&tFpum_yfNyU^at<9;fWg!h6(gqjz!weo
z_SM55SMksC3F5g8BvntLX~^`<OqmDHs3RSW5J~sXLg?V*(bQ2f*R9VB+uQN$S!I=)
zh!gXaIptYeyCJ*vjY6fuhnXtT=IHp!cvhI<u3@%ac2`A^3j+CM_(`@y4wF=Qewm8h
zfE@xk7-ZBX)RjHq3y4u;g1xKkD;1MIR;vKqh(NlKOlb6J<mB&h!Qd|1C2MbH!IP=g
zR~uy;Sz%x%Fs$ZV?kg~xIeP~G!xl$@vN`ww+&zFFRh>MJ_X$C^B7|nP3Tl*9yZkgT
z7IUJD*3a&8tJ$t&m3ni@1H4P5cBFA<q}B|vo|QFgm@pQ*uQlUn&8D?u)&6Tnu!Pmg
zWPR6W4{a(YpN=<!sko|Q7^2g2T#Yb@?6xJV-PhPPe;HxF8HW1C!KDFBZ`XECFym^;
zdiEWk@HIhv9<p_-SBVKzS+lq{Y$gq6!-Pmz>tZa*-0{_l<*`=n;i~fZLH#nM^B2ds
zd!mPuC%iHq#=Wi^E(E#wBt<BpMnok#sq5?KAP~p8Iy+y#ecR(I`hefa;mv|~Lig8d
zHOn^1v^Oo0Rp<g;)CI$MNll7%n7kO$)<UTXhFN^v>0+cO!Qni+_xz)iOD6CJCba`@
zS}tIYaOI=-@;7z=-h<L&?|O0#9h0wjjsX|GBWe94T|Egd@9=$D0q&RZH0DBU^W!$E
z>w^K!H?8%GJNsG7+?ATguSeNgMei_Zn=9^y#I&pPFfZ+VwP(M&e%WWbeso)Imoq;Z
z&D}sTbcu(Itk$!#Uq2vIOcjRkZd>0d-@C0J%p2=6<6yj8Gi*kaB!x7yjC!<~b2}v{
zm57z~;`DSbC6mugzryP$7tUvkupQe&DtwFxm1aLyH?H!qN|IC5dG;wRW_`lk;9vlp
zrJpm7`6R7U2_JJ~hH{jIyWCdj0-Id2Fn9cujGGbk;+&#Od;Qk5btxyZCbC;T_BFv`
z%=qCKaP7&L%~g}cP~6m996%)y7P{d*T<oyxXN@CgvC{%R_R|k2;=DS=flAa5AfTu_
zVAT#ddvSMt(nVS~Cnz=GmOKt`V`63ETl19Y4FJ6b$i=&y864r!vYF|c#&{I&jC|a_
zh(q0LITfStS=|Z%+okTt)Rn^7pXZ1j>)T3*Iiou^CCc=z_@Uiy_16ns^pEZJ&Znmv
z4(6fNlVZBAu*0$6uTQmzX5FdOaFKr$;j*zO*5PwQ+Iq(}uWdW37_O}CvdJLM>^ILQ
zw>8nF$|22x)nOobK&Z);2nxjFKy=w{Ek>`lZN}u4#`T=iZ~36_Sd@p3^Fq7%S9;oV
z+ZE$`4!B$hxXm@l7iqWqp(V-Pv{G%!L9PL~%R;rf@DaQ9##Z@MHD=wuT643bH8kj4
zlVU4;6TzC%{2*cH%2dMG7{aq!*$mXH#It!W*zEaj9Fvh~iLzF<M$Mh@VtC2mh6#D;
zdg;t!uU^@DTt15w*?nZxpi%h_Ngz0|;K`_#|5Dpwk9sO2!YG!H-r8GtlemLIZ1iB$
zCIzFmu^T4uPXaC?p8Y%}`{m)dvi32iM%f55#``2na3__bst5|~T7~jbX2}@S2?LUY
z5Rs6mQ}MX@9joGWbUy8bf{|P(%NZGiBYjJ;Jxju^7$)|`lix)HM+G@<BBEUBPx~k6
zn#%Zow;Y=RTlqBMJ9UqlL4IY>!B0tE>?WA(?j|`ok>iPAA@V}NdC|K|4xPQ#PKg$w
zesT!c?vfNbDWSoVIwWnwsFJ8DJq<%ZhpAug`pVtuy9kyfCJB5-{Z{SgK$`>`w~X~j
z<j2stGUc-RM#d?Tv{#l<iirDF=Lux^O4zw!W^&F%eBlC#EXmJ(%8Q+#l8`6ZkL4oE
zWma}r_#pr>8eqBi^{+#(omWNBQiMi+U4(Zi8TE!dsg8~R9@^HFBg$IfAd@`N<g=Sw
z6=E0jMpAXKxpgUCjM>3sO)hFqlF18yU15+Tk2Xs3^97vn@W;M^-59gV?J+lx=DuBZ
zFSMBZaF4bgbNhPLN36EX<)w8WqwmYr{l3FJU^tWnH{7x{OJN|Htsq@#P)V6K%CF3D
zaJXYhWql{f!+&ANGr*c8Yu&eC{oBAym2Hhc-*Od2`|{<g&6M^P#*IZq!oTCyJv@7_
z6pVK=Bu{91((HJq3*(nx)Hj~evhYb6@JpKTI%y=^N2Z!EritE*-M?pdMYT#-zvF)N
z?yEU%&#@HaS=f^Q0^WYPRCjQ`o@q&<pl-X4+kOSZm?+^p%M@T&v!04O>6NTKoHV~F
z4o31T*wZ4+jeqTxlGzGUK>MC;s>ibWL&^4>g|?)C+71gZ)f(UB1#C|1l9BZG)>}X2
zklb+%<(1W{1zcT*bb;H)%FV0~gSHF>hF=T%-fIoN@HZUU&Kz;}OTEE)X~N+N9jPSQ
zyE7~mx)|v*`RAo<66j8B_w}NLv-2imgavy%05EQfaJvb^w7H)~xmPcmV0Usqz7E^v
zjG?S4fiw3>HOkVC*D*{zK6V_LQ-VCt?Of1NH5G#oTVu@1!E=pS+*OC)#(4Vck~FQo
zt37%$V&`!EV`1cS2>xXgj7G1Lg6>|oxXy$FzZLP-p)Z2t9`-|tV%|P}>lC}PA$|o4
z(L3R%yG*c?ydP+HCD9Ir1uV*nEBNXX44?oC3j<Ga-eGv7O6>KGC$mh4CBDNZ$jJpn
ztrfx#89Xa3@JdlEmwp{De#e|`A%=P?e*lZ2wKpgTK7Amg+35_v_ln7O+(EJrTU~Fu
zY@N*0r~3%uBj2v@#&^B4zWX4m4J>&(KAoLLYO*r9)7-0LdF6YnFoy$bN^yjl_v#m0
z`f#R<MGBqTHQuAHk2b5#$MrRKV*{r2ol2U99-o+>=@|O_atcoT4vgc~ags{HD?{nf
zz0+CzrT*XeS_@q(@zYnbrn&d7X<HiFp-xQbo;lrr8!QRcu#>^6+995gQtUtw_=D0?
zQQ81)L}|$-V5oSmM~cq#Ms`||Wy4vf*}$klYQODTBDa-zz*P4ovK&lgWRuhF=8hjE
z`b=CN9sYnSBAtjOts+NPKRc(Z-yC(!WLC@@Eao|N&Dqq3l1He#Y{f^GglT>;$3gFa
z=Do@4lgiq`i=TT3vgHF7Da+gwzyvl4NEm)awWcD7tHh7Taa321MD-QeqUmPh*fco&
zY@Q$xX3r80HAq#Yc1K+IR(7mnbAiD^t`_+>k6%&mYj^}ohPzJ^&TH;{OJNsg?sjDl
zGTAm68gl{U(X1SM>>w;079XFO%c9iY29^|-j=gOk{wTcA?FOBpnSE38Wxu89J%w-T
zC4g$l4U*j4R?@sWp1qfcr=<mj6-gspS6aSU(N+=W<irmRMcNScHD3QLINtqv@FfPn
zK_jTsd%|xmaRpsalU*{=7SF|c<bGA^q}(!rs~Yw;sHmxKR1W<z$i5X{+O}}pImbs#
zv}yL<0h2X;;m7o5CSN#mea?1}w%TgYm38r54--0+pY~7B;<8(ER-Ua_t7@AQ+!SG<
zl(#;ZllDyx0D`oSoP>X^k#pbrM}p+L<BahpXqEf*({Ehg-El@dm2}I#$fk>WFM6$<
zhU~tvow{8q<^Fun100V)oCFX9#7yhWJl)=G&&lrsOZnodwbj#>WWapFeA~nX>}ky6
z`=8cTU~(hKJz!Gya-jgtI+cRFm{_OqXG@UU3jKI^%mQ|bGcDx*WC~_h*#Ny;FC$M7
zOp&IGdB}u+d#Y9M&hIDNlEu%?1q&M<x+@Qr2F{sXm^`y=3lxPJdMCZigE%N<E+pvm
z_Nd1{_^NP4UeWi!oR%ZNEwK1sa=<OS1MI1&K=)HmacDm7(hq|bSh=hH-4OEUt=<He
z_}wHmH1l^z+SYOdCkKOK-QdX>e&yaOn`h1$x?<f{_wF(sZULTZf<1X<xbP!Ag@iy>
zKSA<bv;$d*-E(h!VKF7=z<lS2`2>^gBHiB+0$?B7FAv;hI)1e~4x8E$RysXn+@0D%
zkW!8*D?49aQLKk5#|Asqf;nn}YJLOp9Hd7eiiLzk5#41zK7ntTfNCIt&nElA<;9}n
z01AJuOs?dV+%KbtrDq;_(<5~;IG-22lk4kOQf09DJZe`ro|B<+hKsY+$mW;L`|JJz
z5M=ksI=}Sg5Gf@P!!N?TIx;!T5$Pe+@*e>kE%bF)arYi@0J6oTSz6@Eqr>(^KP<Pc
zzh*oBHLn+Y8(b4%L<mVNM@EH3CH!7qqP6H3E>GZia{aw`SARLTIVHIOH{hMKlu0lX
zYCBz$O*OkR1=fw&-S@PxWpCoY7z41TdAdcGZ__bzU9mMwSh>b_ld27D?N~=TY48t(
z(9TotLy)-dD0I{lJW%#qnvsqYs5NqTQ5@sM@_Rc615XwH*bOMcR<*JCny4@WwQuVq
z6Ycs+f&BeR%HT=;_-cVaJ^4ZO!_wu;8h5AK+h+x=Wv#P{JFZBQL_Pkos8~LB);~OD
z-vo=@YZu36CAumdpFj9biY~55+8-?9??@A&00$qJuUyfvw$7S@vwV}@_w7#&*W7D+
z548nsr}8=n-R#OvM-J9FGmne<8~Xm~q>wNIv48lXa7CCR{B|&)z0uFs)*rOd*|M25
zFMj)t^_x=K9{}&+_O&Z}>mmAc*YiON`=%>d^Xe%Wgl=R|49KV;P~H@dG0~ICQ2xZ=
zc?ShQ5|T4Z1bb#ZNl!1a<Zvtg4J&N1^dIcv4+?PWPaz=RvwHGfvGbi5O*)+NGnEl6
z^v(L)A0d^HoXO@;qwCc{AmdaQ44zR8`B_w{@7z9!fn}Ou?csm3%&)kN>^!Z9zWc&L
z2PKPgEnk^V^01k@%XKW4o{q4kl>EK?eJGlUE6FR@T`bBkO0*^=hD}e-eWr<~|D1B_
zWABj%l<<q`m$<DFoi-D=8A%ejAMQM78xB)?hs#yMb?dQ~?`lqVg{&5}4;Fi2cS`up
zRM<>&+1)n2jxmu(kX4Xh>-I`pf!!BXJluQ6prgyczbKzKJfD}{xpl%$Q!~4wz75(?
z%qd;VYFt?%w>Ld`E9PA-`QEmVH;!GrUM(JJm<=Cc!)bz&VahpDpU*aYT56TuFliN+
zp%hM8zC+-wAWE|f$^3?j2J|#A{L%<N3dg|It@%Rx1y|$SF_-5#wjCFhUzC1uWq0EB
zi*QvkP0dh!K`2}%=W$<Y$-Ff^ZDR@HI=&<>e9q5tff*G6(kHUBDN8Rt{$km;ijf57
zDZGLHm7*~RdY~qXc#k5Ih#mtbLcV8FR#p)*ywPv);=G;LdL^r&H5gY1QGLDLZ>xZH
z7ifZ!+Yv~)c<!dUu~{{d(^6SmxY<r0mEMXG4j5a$pPH^MsBQ>`ax~UKZ?&pb&ndFk
z*BN4Ty5rtc1f8f@ZuV;r(8e#>>xv#mtyj6eeI-X}xxz>JnTV|(L+ihoIFFilZ*7jV
zMA464o4B@>nar=}s1$ojX9KrwQn|vWiN^3dh`)c1HU;2)-*COh`wPzwSs2+#f-HMX
zh!T@ZjpE(r?26F>k*k;Z=tP{qRF$^Wsl^o)Ni+G_K7cM+PtB%#FFN3Fl;>}Zn=7>k
zY^kHf9vV+7mn>f(X(R*$&@@1lb<%Vfbl1HgqyRbobmIa4%2TZdzjI-KU6Oxr$VnMW
z<W0qJ_om+P{34~vS%lc!&aPcH5)*lo-76aq(s>~|ovrXGI1javwI5&?rbCV8rhuFQ
zn}I@;aSrh;|C4}W>lp3X6KAKGWbM@R-2KL|D>TLH#M89n0mcu%4%9oE$dQpSS&62m
ziDCpOeFEsVM}_@9tyt0SwBL+9M!PRDJ`)e@4t(L#B}gW1bQ+rss(}T_Fzrp8e`cG(
zqM5leFPO#Stt`sN<H=r0W)gI1dtag8K1Ff>B6BCJ?Rk#A-m~w#eNriQHxlrjEKOsp
zr4l%x@F_Vyj|OcPiev)h!*$B&e3y~S8{~!GjNa{2BMi1zVMP6a7N|sUD4Y%6G=f(W
z8A=tkBer!E<jDKcJeP#VXDdp!re+GJla`rt*b4QhziV(N*$sa%Q6n&Zk3SD!nu!Q*
zkcDFYxzRx3^y$+L(>>T?<95kK>Vdu#lid4nw?}7?UD5)Ea_2fh0SnH)%Ge%k2~ClR
zTg+s+NvoN<r-DEe2T0}K8POVW8(?hZUpKpG4<s*Q4&KTjn7hE?3{&;%v($*&eVd`@
z**f7+he7X7dk<`u<G(&TJ+9>!;=Csm4m^D))7%z5<y<y~@BgHBlyd;1Z8Z0}v7W8M
zN(cUB_Cnd9PeF#N*Lx6{G09i*J~gX*JEI5?aOFBtZDpiICIcj!vT|}ZhGTAk+VTeo
zKEm3+SlWBWB58p}rk%^f1PC&AY-4Y9$FV4@#OKattwkv`wLWFkFS!BFCrEODUQn0M
zRW*3n6sH9>4&tU_tfuc`v~7$&vngFTe&lXF&<j0YU*gPATa~2~?+>}@_8w??se=YZ
z0YN?5NZ1lIfbcnnsmagaWHdwRoru-+Qz7(1aJ*Ooz|+Aw$vN+;a;-T@0`x=XFiYG4
zy5xN{@mwFgegqx8m>ud^WLQm*6d2<cHV}l}s~Tm!jSt+}HF<+T_%A5Va9sAB<*mlp
zfVr%2Y61(T1g#M<eq!qTfJe^9y1qRafbF3l^rK|)0*DJEYt0qXjR?XXzvRk!FOD*G
zUr;i}h4Ld)d{<uSiI}B=OT%?0CIpCop_e0}F$*A^r=)yJ@{eSO^v(%gto!;x?Qn#f
zlDA^%A(jtylrL|9@Y_(NJS($MIo&s1HjBj@uG;-phe6=1w|Ar8MeMYYA<XwZs^MnT
z;e!ak@lT7)AFc@!B##~n85Xd{U*=jy&~o1G>ox&O553z7m!|tbX>)f|3GVIe{ddXA
zdF1Tzqs1%nn}f>{$&e4B_7UxHF7@iVJf`EVT{X^S-TaU{yP_F$Py8CN>kaOBVK6(-
zS|hhGzjkz<?kfXI+zeOI7!%76b6+W2u^<8xsr7}Bya#%BF5b)<GLX`qev6ahOsVV#
z_Aay<Py12nMECTh^xtgQQ@{Y%?q}axcTyQrMxdUDYYLO4y)}lVI-Z$GyeA{+^VB{V
zUL=jqtI3o4Q+5aPb@D!2N@ol;p&ZDW!}O(iUMna^6Qn6XT!fLpzR;YF#@3yt{JRwT
zOLV^x@X3lAaEpCzL9kZFO~i8xOWRK@O6b(T61|dYxKI%CS8e%MqBs78JTa!6l7B+U
z;k!rxYGoq@Uoozl;_yoo@93fQ{-}B+Tn)zXyV$LF!<0-p4o_6>U2sS_`xwM}+oWJH
zry-`9R<N_Cm#f-eXlZTp-N&LL>ZNk~sq}}Z^k`C^PX{n}eN{{{j4^A!o=~K^eti&}
zJZ%@aUEfoPiS81Ti;B6>o@Iw13%h`05<k9KX=Y>-;cL%+Y-9aR>EzDKbnNE^)7fZa
z7j2h+Km(zY+fY_X%*9(<ecrA~I+t|~9x7F6R?fJ$*~g+ed1u2xqu4Opdh0ck!f$lU
z!*(@5<+RkAnQD87G=4=7cG3n{q0icvP8%I?3m#gt{OOG0`gP1gQHu9P<CNX6#Lu28
zaCiCL1b0kC=ReU%#WCsSAm%VH*F|9`w`OUuY3+LpoQTT;lYT1T9&nW->smXLVJ4uz
z^-XlFM(Q>mC%DzgzgeF$fnr0fBx!$D$o`x!Yg@L{Y^<eDtH1YC>%Z}xU;3@}6&9*`
za5%awN0Ho?mYd)h(ELtZU%=cvPU|O^K1&K-wZo9Rw|rHf@lUIpz1A^CdQIK(Nv}_D
zn6}(Z-}JNO#QgpigQT+}v{NjJMYpEdr);Kd)LgWe7j&L!_ZfFRg{cb!Z25xY%L0--
z^3rp*L428avhymH+3MNc?Apo@$ofp0oMD-eJ>S)o8Ev0{bR@@<r_z$fx>>qn11@?6
zVMg6$E(MyPUBPI^QyEce(m?E$oEaN$jM-_~jDI1dZt2}V+4IdzPs*|aaqNlfYzr^d
zVJfTPmXENZ^o&>mZnI=iD|5JVA#WKgXqy|E4{@B8V7tb)ve4dbJsM%GD}I)1>0zx!
zhaBlg3mD!C^+1FV?@d0oV|NU+;RUZ!mFkx7)ruTN5L{jA^nsd-Ug%|cxfW>n$<E4B
zb8-SAkiHDuvmM35bTD|NYfXE#C=;7kP#|eNwp*i*LON9K*!$ht6c)6Mub|WqaoZCL
z;WYWF+TXVPD3cQStQG$Saj1qNz8@8}!`{l~PaW>Db%>hyXOz(ySp2Ah3FggcQ%PbH
z*e~m^g9AIV*z`=K?U$ApHWEI=W|6x^-9cYTP$OUD-D)x7;((d{DjlvCISy#ssMxj!
zq(3Z@UekYECQ~W3ah3BUA7C^>i2*uSu9=&sgV*wcA|kJ4!>CW=E)@ISynYMSU?4|Z
z=oPu^)N1i%mBHAR=s48KqJx!5FrT4`j7>=I!i&mDZ%%T*b?kwNU+%xUn6dAm_22a0
zh5485u}Ci!Z3(eUit-&D?w46XO`eV!h<To`U}<;PaV2LiMzegggIRx%Trd5AE`0py
z$MWr_LRUML?>+UI>B|#H7fwvw8-+0O^qncVmdzb;{OV)ZIRp0d!*%ZX;L|aj_}KXL
z%@>%K(vQ#aMJ1ReQ8@heo#p@&1w9e|rNr2Hq}OTqS|_-e)rS6x(2cfs#(a0$`LuOl
zX2*_9zxHRP3K{V72)rcE$#JWH(mzGM_<>@Gj&w};L2rg0;XPg}1KcU9h;O82=Xp?$
z&QWK|f;V1wHye#_wP7#nirHW|X&bKZWCG1S(&av7rYfCUP_X-Q|3HQwdXSU2LO+Hy
z-mu#n(Kk_fAt3ibls0%X(b~ng`-brjzq2#u4z>s!r#+Jt^x4=2Cs^71%+BONK;vVJ
z_&Y3YEP7jp*J)dHcy`=DeBgR=JFl3h8%^ppwSQXQ#lI)cWHDE1(ilHM$*q+V2-K>A
zDy%!ZN}|L3J(Zyu1Q{3^kXQvh&p#!(Q<9RE-b^?td#M9KT-*R);N|P8N4s<Z6GQa^
zFWCoT@DeBt)C6NLu{k5r(%I;M<f}yxH1vqj6nJ&|LYnR2#cSHHfsY49re_$C%Wv2P
zf^@*y2%$l>=)hrc>;KD5#4qlk0>hC71*(32e)YJpdee|D!mDj+jzH!@^X60L78ca_
zrq)(L!($L=$2$tin{;F-Q-oft4^T-IF-5U}F5aVNl%Aw;IQ%IBaT^8f5y)!_nnC`h
zL+~Hll)xl}7xkf3XN6wZ)EN1!&;RWBBfPEtj}3+N2O4U@B;k>e2t{NNxcT_$e|``D
zAD-t2ul<gz{fc@k)CuS<GC7%1P(UDZ!;74Tab?#7d5YU8x3siWO_H{D19W@U-KRQR
zYFbYgT5k&M5zj>q`OC}7hJc=q8@oHJGu_eCUV?&xm$|qYS0@heNP&J9lhh9nX>&3%
zEZ(=z%*|<nj@_lDrKj=nV%hDK=Qj3lAdFw|-Y{TyHMZgmbXE2^Xh;8#jp(m#>FQ?H
z)m?k`{CPYV=w&o{e=zV>Ay`&dcegEWusTBt*n*B1^n(27ae(Fj+yeiqHg5>H?K*JF
zU%j{g^TGagmLFwTVd1Ux^z^^h`cLOd;Gr9l|3!!Pe``qq)etoLDl=0av=uS?555Z_
z_ro(}0jF?)ejkl?(3V0@bj0!czx5(y;7=-3d-PX-QFmWoPD8^D&^pO3DCnk<0=ihP
z5N@!xwti(4Ub(k5!|fsnK~JoRPya(V9@x?U5a$1}p_b6iTATRqVGAOdf#|d8&z`E)
z<?aGw>FkLgZ4#cHVD(TW6}bK%wg<(@LasWXL+iEnNIrURtJ#1GGAVtFBxja`NFkHp
zQ3PY;2@rRIhoY3cdEkF;(4Yq#c@gx6QJ({t{MohrAAWriMaae!l$4r!dNv>~3Cu!0
zM8_k45JY>}e%CeVfd9A8?=#tzuQCjvJxCk;oMAAx$E$Db>Lt=z-pSe7r!3%?1ZVPr
zRU<VlEi*wEiE^wdsSDI-0$S}eRg&P|-l${8j@^vqw+Bro&Mq!)BkvDcPOw$n>+a*M
z8nky>U0wT!A2W10g6^ZMw{NHY`2B(zXsJ%z3K|yMZ$PR1@S(e}>lvC(*o+(OqaH;3
ze$?H54|q~TO)d55(-R%(CiDy5m7)9N&!-&%ORMGm@hgS@|JxJ-VE*u{oH#s9=Tim=
U8Jx2>Fen6*Q@Ngh%_R7L0Zs97761SM

literal 13592
zcmeHuXH-+`y6yxOR1_2o2q+37(h`ak=@!6Hm0k>>^xi@TgCZg#AShkH5;_D>dJ9cZ
zS|CV~u7DW2^v?aJy2{>b?S1w=_x!nIoF5EEX6D!4`n>P=B<Q-T!omGa`ymKAh`M%F
z9fBzRAc$gkFBNzq+}=M5{%K<5bTJwZ<{0-|&SsFxEsUeB1IE_s_GvdWXBR66dm)4n
zg5TLh0O9E1f)NoELztSm@$*=i3Y!TC3W(k2=RIwS!8p2zBawE$k3~2*TOc2?3<ZGs
z_c>nEbAcebTks!6noOz{1YNL3UA?5~@qBs!>k+x+yYpR#{@S(E1V88oThM*VYQJ+z
z$l%vTmXj%&%mVN51&a;(<6U3OGX(?jG<}FMrbp;$QFK%Oq;;x&@`=KHbsd7MibOBz
z>U~DG(^qBZpH^L5le-+TvC(jm)3GQ&?*3C^0&#q;7=QEJ#g#J-E|+H*l89S(hV~_n
zds0G>pAfwY1K6lvkQ}rdf*cP}9D<-Kf!(s;S;HZS0)kks{O=e4FCtMEKv$WHNJ?gD
zq^fdBNul@c+n3S=<m%u*?m00rK{}>$^JU#t(e9ePej|<(AGyZH#$pk>An0**&=JlH
z*lnK<Gsa60OW@)n1{Kcw;_>4HwVgm;MeHoJJV>O&sN@VA<*-;?p|6mj;9frnQWiuQ
zRgQhFUlG&N(n?QDyJlu)mZAg}WGvWCT#)RLQ`Y|Ms2dv_yFcJ^7DNg0qa3%*_rO}e
z_+Mz9e=idRQ6D^bFg+zjzNMw5v8AOmLo4&yvuCEIyvm2Pfwed)ySf(ar=ck@Z($m^
zvoWpz);t7!)Iy`}N-roMq8w&)<U9mbnSuw|u9IEq#l^bb%TqUWbfTB1KE3|(<#x6~
zQRty>duMhF(kjzaL(1o_T)D!{%d6?+l;<|npI%o-GbvkJTg#0^>iGIr(6UO~F1hiK
zJN#H%UPUD&E-r4dY8TyVP10G8bLXr(QdGp<redtEtq*8D47v;~x#}?3c?8Y|U-C5~
ztU;Ppf_9k=NMZP4fB#LCy07mR2WyzGv>VG5><?9kGqtnT@7$?8b!YX~K{~pPQ_QDM
zbw%+RXkNemLMv1IM8=^b0nlE^k3AwHBHyl0WV*LN2`I1<F+4x-41WldUQg>hc>1C7
zp$ia13)ImTdQt*2Td`t2))>j2ggk#9exP~d#;sg&<)iggk9XOPLVh0_$0Y9lQVS;s
z2Zz<tL}yBq-<g}c_CnAwBP>Q9F$m(1bvigK=6Db&_bJ^^AwbW6xhuK~f>8Ehdnj(!
z?mrF5c6N3GF@B5_w!v&n7umGL3Byta$|94XItt+QEIPldq{rPR_cvAS)qRK<c6t%K
zx5`xX!UbGS&E;bZ3^wDf35v?)xd?t>*5II>-QAOOpKEQYYnh%C^eA>ishuA`rlqH&
z=p^U-keev=+qYkd*!AK}8bX2T)L##PzT5>;qqVWOk2;HXX%UY0kz8Kuae}5~fzSiT
zzJ67Vn3$YIu6ax?<c&Z*KVCK{u#TKxSXi2?rL*zy=vnERo69Y<{q*YIJ<4qTg2vw`
zRZ>(W725UX+jJu$qoX%U{hFGZ3cv@c^>42)_(4%;pwLTNT9J<)J<`<HHZMI2F%~^~
zw12uM?+P_7OIu?kPh@!b%SaxbjLJ$w3Ad^1a&iG=dWxIokMEwK?tM?ub6?_a)v@P<
zl4C5;X>KkqRHjaj2%5@oU)6Db;Fcz^3qql1fJs4O55OT|b)Ej7_(F^d_%k;*x4NEQ
zEEyy-NS?2HL6V3${8USfMcdpw<?_oXf`Wp|(I9pVQne1jz72^5{zqF#i9tZnp##9z
zGSbs;xVXG^c5x}N?&Joh7mJ{gWyz)73tj&=o((xw0V5N`mzL^Jc4c>L4DH;p>o2~M
zo}LcW*s(yA$pOx8)ew3zBQ1>|ea^4xp+R-XuA&GE{!ef?$<4j~)`F<*?OitLF%lBq
zaGY27#q;MZ3DUm$fpo0q5{zBLn=L@RV%Z?@sHmu{k0G(?V@=UE#6&4LgeFRP=liTV
zZ_P&&KIWM;XliJflxjlJhhei`{u=L~7-3(zW<K3tqS0-HtuSwnc{!OwFqCkg`Pd>l
zG$ldncM@oAICpv34W$m$O@Cx7^?qI5RoHw&cNtRy{fY5%aw@3f4x9dFc_0{(e;>$`
zQ?4G7@4aFVkHAy#B9YxQ17*Gq6uG<5RU@(thy6axd_fF{hSCZP3x`N*gW#d}*1Ubs
zfl1)wv|x5VU`Kt0cFeK6JcfK%LYgW1E4+&;S1M*<ncbJ6aT;eRIt)=%IUPH8tT)dj
zaHe9#5JVT7(S<#G_8hod2s`pj$#|ks{KjgJN!WKUiF<s*PL59dVzC00%U@=Tm@_gn
zm+sQ}$b#%sDn?l+y}evSu=CxE`M$Z82@=n6FCDC3c-|r5%WG?Ey@hu1O9Wo1iV7G7
zh#FDAy1q8Yz79O)b*-r1IoNHwH<_B%=enJpU1M|eM{-AMHth~Rfq)Ev#Ap#)5ZWiF
zE#9H>lY35EkMQODve4ebo$cA3uGy`@SuP0)128U5aI7ZM*x%njPRJs(_4&ou42B+;
zL<c=yS1XP*B`>TvT!vVvb?*4xF^Dz>A=sRls1kh|Ql@0x=xJE|sG&wyGFp$ADV@X{
zd2fDiVC^1oAIc89v-o<wUbOPoi<+R%jcXf4w`hkMHUE?cV-Mwd2Xu9HWfT|ph;n9u
z{8La+(9d%eI(HY3N1(!~l9WCWi7O|my$?eT#<dR)T3cGS4OV!oL<^p|y#iH`Q{oYx
z;Ar-xAKXCzh|$j0=RkSQRZ}B9$D@hZ?S;w_V<hG2LHd>bdmxE^*KV|;vhqh@Ag@3S
zT6e>A;nA5}8!J2l0^cM0YIA8Q4mkvQ2T<BGGBJ^qkQF$KL{E8S#bU&R2M?5^?>F&Y
zyr{P_=$&(x41B6m8-Ft$<p1oOCF(?(o$|BfLGM{DXXiH`1O+Je`gthjdHYH4Y%WBX
z>sU@jQ-K|v%bA$4K6d=LHHi16Tg!cLS_U68N=th&R>jSQ_5&Fq%%a?9&V24Z)mQBF
z8a%Lm!L59u)UTmB67edy%&)Jn&-dvFnUd-pp(iHQz`jHdj_DwIGQmOrb08}?P#NQb
zY5Lu}6uxUsMqR+O@BuUo6GBOAkA--!_~!&HGr%Xsi@Px2S*n2C$Pp|1$97XFOXp#S
zf8~<ONuR*LKrKT<{QA1r_Fd}CV$AloN-+cf;PIJb`+K-VzLH}t5=%^<cBiPs=R1!n
zg7jhuQlj~z-Hx9QL*EOvG&L=OKL9=EUIWqVEIAJ3_tB9&V#81WmFM8%3etkA*h)%D
zB5+_4G<Iu=u<QXK#H<+P_JW2HVkrdiZftxUK2zmrOe&v2VcLrqe$`ceW<P=h4tLhB
zuTZ7TZMqbEi!O5`w=1xYsnb;n+EVQD8$sC5>z6o>y&t!lr<{7n7~}LJgvCz<Xwh>1
z-VrhETM$4WzWPApNZtK2GaQqJpmQaIgNDK)BBAS^zP`QyqrgZ*T|+}*Ym-AM>O3Ex
z-AAIoCk)EYmDJbEM@B`du6Ac<XKSHQAMRt(k69@WRXKd@?oI_doB;V(Ki@L^l;>!;
zKsLScmpr!7C@@P}VWHbcqJ+oXi>@4_9EUp#@%p70a!e)S94F;zKP7;px?PA;qVwNr
zkmWBjGPtwRW!fMxUeIA2Jg$AeKO!nh1V6h$N>=h5fD3^+o7<m}uub;6gv}I>&`N!;
zJK{B!*Ra^{LQF3&e}0J3F>5cys$I-3G1}(C_d?d!*Plg2rHqc6y1Ke@UA*Wyng<Le
zIW^VB*jTorqQaKiAPtXKO-@eE8ogN4*&V+iYGMp+J_09Fi~tesl+o%_92o7p{5EOn
zBsCP{1C-$dU>`54bR<*)v9_8jy~H)-1RxX0bX6AZujC?doQWP^BEn?WMxR!Wz{rT=
zkROpfOp*-+@ALvc|FE|$Sbb+vZD&-17UEw6WzH%tCB+(85c@&al_4yF_M|v&W0ru$
zQJ8{<05w#dt!HEm6gYpJ@S!z9LP5UTcA!+tpveBD=i`fhV2Z=g$@&+%n<7ATqpGJN
zV=l@UwTwq6qw?^pcUEgzPw9P^@|YV=OCml(Lc8fG+HUoWzvs(ZrG#$p_48xb{k{jP
z1G`Yj{XzphymjEf|1Dmix)gR9izTdYY$!<62G&w#!f>Bi8&bH{6vYSPGm9qxK|*MH
z0P@oggQox%1N6`Cz^VG2|L4=ZJ(BymxVRKiC;>DTc&!*t`TqjD{1u6WKw?zPBDUAB
zT=8F?8L$DM3i7+b{?8bQ!dVh?Gf<V4Y0bl^NxEPu9~Duvb*odj+sfF|c(kWJv_9Nq
zrD#S+$vyaNy7vnM*A`cCQ4iG!jG&MD!RdqS4P8Z@nH8z%h>xN@sij}Vml9_q&n8TW
zC$AT-hnq0>GQ%%MVC?6fPsB}rlxpKcS(EMCx4X938${eLOn7`NJ_}Zo1=H?d3FJW8
zN!hW7RrA8=jG|qtEt}eK^O^Kg0yBqQRKA|5&vb%U;r2*`hz&7_n1=CA@AcZ&Cz(qv
zju<Sp?|99=&zs$<FI&t(Vy}|Sr)}1hBJGi#%oejx^Yy}}OH_({ZI<5W6-jQDtrK-b
zQ4w*ik}0I=Wb3Kb=eU;j`9V5zR4Ueew5PAKKp%deWM1L4EDg_58AW)OueY;4udq1i
zP;N8Y6Sm#$z0?-w5Sg!MCxy)hv-G-r5o(uN@z>Wc@Hnen^ZYM$UE}-r{OH#E>6w`t
zR#xfOHa1%7>bFZ->Q3Yo8F*B**vx)P6B<9&DPb-rJ=o2L4o9@aA_6v&*%L^@F1XRN
zWRGhTQb@kolNa5vHlxL!Lbw?Ua+_89d4)I;Iq?&rl7#b|&bGes&n8eWMUyj+D>itu
zV^w=K$(qq0KQXL{M|^BUnBlH12;p4(!^4IIl;Xm93ouG{Ql$A3pePA8Y`s=2sp|UZ
z<k8m0l7wsp#Wvr@*zNaqcQmj8nd7s;d6Z&QkMC0Ow<A`%hSKpG5xBvHipp$4Pn2=<
zSpRxo_Zx@No-3(z<epfQkxhJ$g`>xHR8UZ<_(sh*K7nDMtNPiik)!f8Nk{kT<;`)*
zUG6DA5x!z^Rv|P&gk%2u=3|=AYLD)h1-K+f&|A5gkM`uJhd1D_5e{wR-Y<Mra3SS$
zg`0rar4vO*F0VdiTe=x}!c*oVm$R+B;^@f5j^yX$j)vuyYBM>AWmkO_6r+noFJ}{w
zvs+JaEwGLqCXt04=Y6%JT_$Hgt%prM$f<A{?U5jCc&~4Uby+*EI&^+oIeCzlPPMs6
zaCo_BraLR!pn%Yc;rQ<KEkA#K(r5)evR9~w@)WgB^pj6)&NMkiK>K#ENv`|Ll^vTQ
z_!wY?G}tpGE5_Lk-14#s-3H0MyGVRI$@%$BWlQcEJa6JS<R;?d&L>>tjI@uop3Txi
zA!Lj!)?2?Rs9^EJYdh&vnjM`t?=-YtOWL`Sw|%R{h5J2%Upo-ifQkSbxWA}Gr>kPT
zq0fz3!$Y4GgM;ky-rX$U!_c=L9J|9aUKCukOiEb~LyL*dA9wj4b<1`VX+HRvrY|G{
z%OhC0#2{p`9$=@8V(%_8TS5(O4^wMBF+&{KjdHUt<c>lJqviXLnko%tr9G*ev|}=;
zf({vXx0Y#3(Mj^ZaW;>i(oDZiRyRvECoEOde)~4vcEr_n;+rrU<#T{mDZ$s*c8wYW
z2;W#)A?MZI)LIPJT}KdKu<HY}6CUq@AoB=X?KUhcVDv*C;N-h|UUme&VrYrSpOp>`
zJbF;_0Cf~DqMzO~GO}{oCH|;s-WcmqxWJ|m5q8S>YGG=bk-T#g`605rQ4w{)ulRJ~
z7&33nAugGq{)Okg3&d%y9dq_1SyFIb`fZKh>iPGGHc=jK&8juhJ_YfxZ(C|I+3X1^
zJVA7YoBsYFK3<C7)zj6H(tzD&u%7%RcIj<RB{!;cV@)lDg?U!*7D?&I_w45vLIXny
z)49@v-d-Z^!b%aXbP3qLTfV@&;b7R|F0VdXvt0VMG~6T%bE>^vNPz=YJD3ZHyH5-k
zM_iX(-<<Raul`*9O>O}!9mbyUh$@lY!8dmo{So@eh-bLE-5rs2)CSuWUv4!6M9=ww
zCg8ICq({k`8FKn%`e0Mb{N?e{&cujrne)Vj(F!N+!RqDr8;P8=k;gq-(BUg(>+B87
z31L1yY-eXX3uzioSw^myi_PC5%8vFVQg}*9&AaXB4kAO*V#}R{?-!(y^W&X~k2cp5
z8P>dV@^6YQ8++pr#Ndy5-rVX%;~#9MqgI?30!)l1pSZ8)mv>ZP#}Zh@W!i^&WhW$t
z#(nKq#AoA>#P5<hq=j-thiV4F3TmU9W1fb|I^GkiYVl*8iKQLjo7rjx9Z#CdCl{S<
zZ)k<ClniuxC+d)e3mxY2^$c5>v0uQ5mASB?k(R+Y5$CB{TS86dY7M<w#LCuA$v}s>
zXBi!~4xT4irtE`~x8=n9yq$3)1`pOXx4d!B$U*WTVLo4Pu!vdu8$1)T0Q=4At$gT~
zKh|h;V10_7xWHZEGS0dP-qFbE7oQ)uep@cuS}AaAsN-~|loqqE6mqj7mpr|s>RBXR
zR_9%@u++5f8{f|@)sds*GsKPT7PW4^=e#Wvbg6CRP}Zf0c#f@v&rDxl<6|%75i%+)
zUiW&l`WpEAHh8NM?=PsUy~QlCku6sY=$853hd%b|8Dc6KmXHvBGwmXYxrOKtSLG78
zR4Q)3w9K|5-a>q|DT7&59N6W~gEWbcpnrO9zK`izAstm{n&zlG<AaJ@39Rb|Dk@&@
zd$p=gmk(BpW8*I!*-IIQ7a+L!kAM8sJzl2s&4GE!Th42g&s^Ex_jSXwn~UR{Db<w`
z7dYB?##>c`%ikSsEuXt{yCylbCF1Jp(<#;il2fShKq_HjE8U=dHzV_N%#sv~WN^I_
zW@emo;i}}B0kz3s(QKX1&6hjI#6k#m$8&v^cl+PoV(Mki$7LuUoQ6&KwFR!Paw$99
zW;fbm!+6-2kCY#HY96gN@n$p2N6K|FyOAgeLc-Z|=e<JMzt>(cq@d}MK6ejn-M!f>
z(0Y4R&4<Tc<OEYx&DItZ(<wo;;^`h~Mll(s_Nu22rO#wzV#PHkqmkXpN<|wvtx*{}
zt6{FL%bh7oPKn9k)qI6vK`(5Y9pvW^Y|UutSjoR3D}FI)=Ot55cH6XP$)zam+ucXK
zi>R!1VXoO{(*I=Jr|xtMT9)e;N$`t3PuHobg{Sm-yQG5-L43v=F%NrQ=rYN&>6aSh
zC#T5s4W#f;)aSfaYp*gP50~Ar7VpFLWoC9_x<LG@j>0+~f*MX+`o93EC~VN69m5f`
z7fu3G7BU(JVPJvRc)hs!73^$0^EW}T4bcR!jSH~|jzikb=$A8~R=SM`Z~61>44(#F
zuQsYn45r7fmYJ&P(6b(Rv}7RdUeYUS&vK&kc6|AP^a;9cS<e%mzmAj>lW94ucMC}9
znxZmkanzJU&&$ocNk)u!>#&QGt@8bBp_*?@E=sK!GV#v1`!gY_@oYM`s?JY33dlH7
zSR)+VOdgCI>?j2yONd)F9Cmx=>1bQieyAC3awp_u2=_)b_QvaEm39jvYRGe1I6=z2
z3&e5$se`{J;a_fWu=F_JyT_q4V$~R|zSr-!;Z_<Qnt~3Aq?9-~peKfRNpJApJ#B5&
zRQWUb(baFS^2HVW?N}W%!{nUp&#V&}${-#pd}m3YuH4X+Ozi=S8*dmJ*KZdG{16)3
z+&88LW=5vA501LKq7X64DiO{pYTX~tDn*Mad|0lon#;7o2mf(8$`^ZVS&v-mjxq8z
zsF<&u+tXPT3$_>6s+iPM^3>-3D_hnB%{{Dy^2g<t4CTM;M!#xV;4mg+?N}@C$C)sn
zs{v78KW|?mU$aPEr`}MBrr!&k)qE<<sCDuA-wiXvnSNWLp@|H?4Wy(iX|Vo*Qzrf0
zTZVXG3BMM6JKic^HmssU*?0Jd9quiy-|Y43U0fw%?WYrDhk<W_Q?H(sa=Gw_uz9y4
z>5VRx9eX})!Up8<8yH9}RR#vMp^tmaXYg%3^o=h+zX^8p(fCmXcm;Y^keI0{91q-c
z;}Pp?xY{QC)qT3$rgNccSE*YfI5NBYgM7~=>#^2c48HyRCuzo*JefNhPg8#E@7L%y
z%AbzM=VEbfrF;?{Cs9iZ9+ZbA{&?%Vjd<VD>3gt|<&Lqk?3Vq_;{hVHTIwd?ucX4;
z_<V;Ps1U~8&nkl6e+~jW1hRaMp8Gu|TT+1CRXJFH(QF~UZ_`xTSw2O6X74k>1(N!0
zVE4H{&vl$=$nwWxQHhuPZ*RoF;@kg*X0heb{$sl0%NBZ}n5mhv0$vNynx(A%u}dc!
zgYD`|P`=+!;W4wE(zGy2qT;jLe=U}6%)*Sz>`}5m?N1{DfEM{Dv4<S6&jX<l_{fIA
zicMEncJGii(5%?02oaxIZ}C&&_J3^8*<$qX1ebF<Q}!3)0wcejc(VLlGCh&v99n7l
zhbay9pK$q$Fo3F}6XLQTB`ZbRk$aMoFRBkDZN)}?<rV%JHDN`4-geBV8N_hpo}@T*
zR{<Ehf<s_pTBe3V4q1`^@Gom)Pf&RE&yt4i;GgkX<3OPbIO3n|)a+u@-;LCXFks7h
zqs|evz1@s@D)KCni?f9!H2j<OaA~Oj-KeO34B26D%YH1yAkOiJq=E5BoDx6vhdy^#
z38ZCYsNc8|-q_fv9L@G&`-dX}6L_^Evz1@az1NlQnz!on>npNFWOaTD#*L9~p|&Ic
zFhNi5Eq^8^rhNBV!;a)@Z?MX{H~$Q`8eVpg8gqPAK;`=@`@nKka*6soz0FQcWom6T
zV6!s$DvtG&KB;e|%48?MJ+X`ZlML)A_P72a2m<i;Bg4Q!Mm<%r>1*?i2~8#Hlc5pQ
z{&znY5nQo9l=Ul@zzGPp+~tC)4v<CPxGBw<>h`YI(1@Rqw)&Gvk(~cdn$by-IjQy)
zT5Ec6UT(WcmI$Qf!nBe^-rx8Y0-QVk)}};-TvNJ`M)=sMnJ0*N_6oOdw7y7Sa2*FV
z)h?mshE(qt60q^p_q393Jk3RA+3>nk-Ia|H-w<E&XQy7=2zVp1`^&v&pU;e~EGt#G
zZF^U^Ul(`wBH-^Rl$k3RT^I|k0nk2w-o{8{I^m6T&&IYkd4*7-BBN{ca?B+<9?@V0
zV#Jiqr&RZy$>UqAYB-zmSp3)dVAl{7CIl63Bkhob*Pc#rqpH&B!xa#v@#E4M=1jkc
zxcEC+{i#V&rWOp>;&5YLH>i0GKa$3P8bh6wERb5TZZhBQe8O-!{Y=(;j<=NSXi}7d
zf=AAfS+Vm{13P6&AGKn2Vi66+$6R#MygSaR#J_n5280W%lxC-0)9ZMn4C4FC6E3c^
zQ&wKzq)u|b7eu#=x!Yg&dOImH#?WsGr{E<?KITQ7n}m*!3&)nq=i6Ky9T=`wc1ZuU
z$hpgJgdh^|+-EU3@`n#8O%LOFgm8Sb-bpwfICUuDi&fQzmaI@%i_&MsG3TsaMqP_D
z1Cv_%j&R0p%r4_s<t4KR)$S-;=~Ogf&Zxq(_Oo^&2PHGy4Y|y8i<OurnVx=QddlX0
zr(`E^h$K^~rcLWVBY`|QW83*E*0-4wQ}rQt@m*5Ii?STTl?9=%K;*?8R&N)_^)wd0
zg;*4{)ewfLC2(PyN@|TAt|`GzEEH{&c>;$E4KExZy!?D7U}Ho0f-M~4dd@`J?>w@e
z-PDL2jfw%&Y-Mk}W@u4r;$sOo!Mw2$WOHS=EJ{u%YJwoW!SKfQov4h07iczjb$+Uo
z>6j{iUnKxChw=5Sp;vmri~dWK1@B2G-@bc`GwOE=JWkZN{oTy_YZC6<^FJm_gHuKY
zxqavj!si(YwDGv+H+EqOD$$xz{Br8|Kr}xi!l=6*4*R~LowsoB9@c#gg}<Co3=Sm`
zk@z>cdE6rBMMyFa{6mJ?N!A-kdIzH&im{`WM9i6bS31n3?Bu><#7J}9o{d_N{j;p}
z+7YWsaR?3s42b|}@S^g1g?<D3)eME4n%_WNxUI`KPj7Rh0`(z7*Mvch>#wJ*QZh?6
zY26jE-#0N*;(QueYrQ{0!W|v+n<u946$wH0g_|5Tm9Vk%w&*cUM-(i)`g|qzm=uNm
z3oco8)h?~|DsLU7b=HpLx_7U5a0A`_?CH(FL!Q;8gjoP(6!6izzJOaC__{G8BZJh|
z_Jpj?#!EPtWqDov&5Q^-yrc@QwU_(#wpK&B7iac_cOL2CbG6QhYRQ|soqHaJ5mRD}
zU`H<Rq5+D!HYZ6GLf4rdqYaFVjZMFP9tZ9)Ok7#;J5k4{i)(wjlla}Y!!Yj(QZo7R
z_!8CRKBa7_OBeE$SbGH&i1>~0N6wFwqfPoh%%Ob0Td;l{=$>u&aUqz0Nx|!J4<I@R
z^_un**rFFN<YTqvE~;6U26X#Wo`~9>McTKaXE*84vA66yMbD2rJk_PhuX@a*xODZC
zdN#VeyYa^1Y$=iub<||xGqNo`iaSvwt8imRqbpwlI1U5(18HK@Cz&%9PEVJ|FSiGO
zH8X=ur^1F7N6Fk}q`@J~52VvZSt69vb#j(~A`#(nC+$cwN#ZY=1F2Rc&sbTLG{=;a
z>`NaPe`tDkim+ymf)Vz8GnXhiWL(h#(-8T?BdSy0*c64=C7F6g*}f>OHdCyhF*9fz
z)V2oKvvh#gq!g!WS|15vO!aPEIKhs@={BR;p$Cv_L&*=2*m^Kg2w)spm+1Vp<miw6
zov@YvL&t<=>WQ|`7>{_5Q`_%x<4c=WN2D>^BHi-j51<KSri0U@S4dwJ=(fU})af(S
z`aBXg*(m~}<loyY*CmT|IcG~0-W?xYR=eFKa}9v<hao|_;(efM`EDKminB@wjy%B@
z$SyVMH56ar;*#M7jrH~h8N8ej16-dV4p4~z_;!>C3YMesh&@L@cSS}jmJi$UbFN%h
z^P~Q^2O<*b?I=-sbChWU4-ZmRl4__9ZI(V*rsCTf$7)|G`vX4@o37$SD(CL0K7db=
zhZlItzU!VT=rWrDhJY_0>{wm)<nW|z&Fq0}_-K_2zP&@e8I?cUBoEx=cF`GZM?6b>
z{%2?)OH)^W^*(QfdF5<5IFoco^6twsk8j!;R_K>R4Iax$Ht3yynv|B@N4hVeNG(At
z|FiG`H473cq!u>h^LC!MJg2NK3i|{Ue}|Zl<TaDx_W&Fu>Rx|yU;*!Lg-@n%d?%T{
zu)R@mdvHIPzvhcxFbH>Wv2@!6J1=+w)KBA7M7iIf`(Y1IB?N5Lu77TSy?-ShzxxOX
zPd)Wzm#;nETGIk*Ye#te?C|^vdP<NyuZl`9JqyLarIO*~lfk9Yr(W43!tjAybX*o+
zdBS4=LO$Md^KXGQKxIGiZ3ED-fZd~fUQUIM6y5b*Qi{JS6EDU5eP`eOUbX&)G}KdY
z=Vf@5xS|H%J6(!etYh5@KW@s${|B4|>iF9&pAyGE+F7OZ-I)s@3g;_vUJhR&9#nK~
zQP){yss^fz3}&(hU86xUX3w3?>!Uro)Slj9i}P|c*@0?G2OSh$UDb6!dtIpAe5#`&
zJPb6VzE38Ei*n7Elzx3LpgwxhwT0B?I67it!G?8fZfXh7;gh4>+3wO#V12Vl%_I$1
z8D#sQf3EB(2<br@OGY6f>$Mj2XSEbFJ_foqx3lkTsG=gpPi)h`jn;S>M7sKr$C$7F
zf<p&r64kjZEYZnSs;Vc8d(GY;yOB8?WO&onch)9aO1D4Y!cAnhDkyzt$N}7Zk%su4
z`-(+MGLog>^-6EcZ1CaA;5diYgo}(vp!ABr`?ZXZPgXp^I`FqR#jUw-;^2c<>rMeq
zQEF}n-=0d);h%TKV+B$03K84|lWqFhtBpDz`&*(2raM2%yzH1Fwm<3(dP(H+tovi_
zKha2<rwPjk7SmpCz2$E7tZ7uOe&9yFBJuUxCs!Hu8>-=CXUdl#TAi#o$)5QNSe>Gp
zs*a&~B8Wr582Z+mxW#9f0=J@!<T5kUtVWxYIaa;Ttn{B0$c_iLPRjOC@HHEzHCx46
z&sueZppK6APB=@RBiC9>wx!AFFDR_P8#FpkZajO;^w@a`VS`j}waJh+=2H7XSH)}B
z+9nfnlp>C|-UJQGMdzj_{U;@|Z%O84<)ITNCA^h+zT&T|-;M}PxR_G?`4V5;v5Wi4
z`#0ZwwP@C9U1SMp4LCYMN6u)@Jm6#DKYsPw{Zng0uD!+c3|*}cf;X=iza_I#n!d#m
zgwR)6VzCwea7zvl8miYRdU*}7x1R4sg>BAC6gZ91B3MLT{Jgo$_;Di}M0RE=&@0^D
z3gu_rd+$p@X!l~!_+V;Ij+E8dR;58%vP1d2w6E<uQDOH7B{T;9uG=F1e8#^j*W%`%
zg>Afunf~7Z_F=fW1CX-ArLKFw>VJu?-P8a>{iu=;Am08gRYA8{$3-W)l`a;)yO14%
zn-~5~Bn?u5M;EVfLdD$0`t2TA{^;*LCgR5AgoIz{1GFrvU+5OkWEP~lE)Y_K^JJC{
zVk)keNpIfbYlh=ATxMe^!eHJMfCLu+5$sAJ?TJ~oH@?bOub0-}lw-*Ce7xn<V&1-V
z(g;Iw1Zv>Wm644%n?yd=(Z>nzh^WY{uM&$Ldmzde@C6jCc?Rq@MMdfh`B|=qKKPet
zMYT}nt74*z6$meLQ+Hf}1WAvXnPp2~!8FqDlD28nj%<8Bzd_^k<DcAQPDJ6GLRh?4
z^D*1cF?cQgMOw0BwB{2IvsC%Qg`vHu?v|(Y^a$G(<nt4s=CLJm`cJr86oYNoSS5I}
zV|X|?<O?^c1C!<6vJpK?^x~4vj46lNt|d*ZyYMA!6{nn2NvN95GRkcoGSA&(3pWYc
zgsG~I`Pce;rKQM=O213EbI2$Q3cYfDd(VyTo2lSJE~7$&`-8By{PWl$LC0e}m+e0<
ziG=a(tkN{D^_^8xP$?a&iFt?>LMz@Z?>giArG#^7serZX%co!!z}9k#j8Dw$U!>WI
zBdi{e=}1x5K+OagOM@ISRM5__6Z$;vLZ`beu--9c;)yj6&~=<>eAs{KG?%~!_o=LW
zy|_pbo6(T~A%@WMq$f{?B}9PFd`f31)dmd;pB<UJDlSxPhhXHzmYU#B&NBdP!WJPe
zGlV(ebfudSf}$C^A^jHxWm;jIi>cPru)g`vABX&!f+5ShQ8UN4I_a=!JJMdCT@F0j
z13`p+!0vdyW?vuMSu5UN5B%}aAq21l_o_1-Mw>ijD7`#TGdX=+$7uF+0zu{FzB+nL
z2nArQ2J;z1|9`WJn~!$vQ9ie|wKXw2%ep4ULd%>5F3XK=btzZ^0Ab|3kdVtL9}-E#
zpuj<2%R?*yD)Ay*NB4)6Cx|)K{Crw}eC|9Bhda-~@eXqWyf#t;sB?cI4*qxV*#DV;
z_~RZGkRVQgh8*LrU4Tj=1Ydan^K1X&uHXC-neyCgKnnr2fR&}?dkh!khyt_?Yg=2E
zr3KnklHWFFE&24`T(z>YGVwzA1zmwy{0}mVSOVhI{=izmJh*_Sg*M}UvR6Xa)+W1i
zSUVPeUPudm&7m>A4QLNlmzAP;Z`j#QrzLd*HcLv%Il#l=5f*k;He!&SgL!Y4;rR`N
z%053}Mz{z=_a2-BeC2=3Pj3KZ7DYKZIc^>v0F8h09{!Qf1=x}N)-bu|-_8Sw6n{^E
zZ}2my21fniF{qUK_tOI2wfTR4vcInKk8P=+d#w`qhfWjN`D3R43A(<}I}8PMPTs*G
zhl!b4VXNGqnr?ktLLXL&zJ6~^BH*OZQJx-t_%F2x6>q{cmMC7mSG~QxH)L{ha?}7#
zvyn*Dv9_K7WFzRbF8l(CM5-^RcdtDtdh@F_Fva%Wf`1{k{%2H@|ImJa5^!U<QfT}x
z{%f-ZTp1a_*8zvu($^RNI-X-hxT8$W{7JNmAt1o_tl;~9b3BMY5c-yzpPw&~Q#asP
zdoa3$398a{Lea?w1O9E**#-_NMn2f@p0Y$Q8t2nX5*L&i1oQ%GZ<(2!b06K$#m-)f
zxd<-Y?Eul01-8lY|MIsNEdIbR0UtCyD+|={V94uwmMSOXP~aJVA%p+bN?@Ho)yujo
z4q_M{{P3e3owrcf<bNG-LEAbzIZ%y&FLZMsIC(apMS@MnA!_%2g+glq=~^{GJQ@5L
zf#dAi7=%U5{n}fA@J_A^I?~#z=DhC*!DQge#N@PRVrgk9=G`%!^8)QHnV&(33<R9o
zmLxdw)SH@`iY?L9x|R=uROuERoKuv^gB7r^Hw5Ph1Rnpx>*~^yak#WMZ`1)XDMhJz
z_wbS%pg{oqFd%mX1S~%jT|hPe-=D1f>mTdvuv(AMuNPLD!R7&><W#TXFB{+cKgg^y
AJOBUy

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/bxp_custompositions.png b/lib/matplotlib/tests/baseline_images/test_axes/bxp_custompositions.png
index 4333291d745f0d0c84162ee8de58f652939c0b37..6c9d4a8e2a67358276cd758585fd7f1fd2124d75 100644
GIT binary patch
literal 2019
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

literal 1968
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
DRBAEz

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/bxp_customwhisker.png b/lib/matplotlib/tests/baseline_images/test_axes/bxp_customwhisker.png
index d7c586645809a1edf26007f74158444aab3694ea..efd3a3e136c90ed9b0b5632253ca030be732f61c 100644
GIT binary patch
literal 2126
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
AU;qFB

literal 2073
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

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/bxp_customwidths.png b/lib/matplotlib/tests/baseline_images/test_axes/bxp_customwidths.png
index 63f37ded24c05241cfca41d79cd1e7fef56c38c4..d7d8bb26428125786f9a36d99dd9db0b361c77a7 100644
GIT binary patch
literal 2133
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

literal 2078
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
Af&c&j

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/bxp_horizontal.png b/lib/matplotlib/tests/baseline_images/test_axes/bxp_horizontal.png
index 0c2c9935f29e5c95f5fc71eb171d5ce8382bc9b7..210dea2413977e75595274aef2f2c50670423c6a 100644
GIT binary patch
literal 2444
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
Yho7Yc8*#Ll(9Q^W?7+EJI1_&RH`sbRZU6uP

literal 2408
zcmb_edo)yQ8-E9BVq7L2$=4aAa2&ZreQu$`7)_HRVhq9=P9Z0g`!JP=2!$?kOOZ4#
zsSFyX4hgwV3?@Y8XpBh+!?=9g$!e`{owdHT&N|;-Yd?EG`~BnD@AJDnZ@e82EhV8S
z0RWJ~*jOG100zAR23#D9JU*QWJ;Z_zVjSSm6$$sg0_B?mZJdJu5La8fVL5Wfs?awH
zjO77`(7XJB{WkcsN^w(Xl~(NiGZL-f8pd#+rX3gd9Zn5)5>y)CjURMaWC-@)Gk1C9
zIVWUx1<M)}-)#9w<#2{5CeH);PVX=&&9sHNk==ji=8gA83xu3j#rEYhZBxxn#Ua%L
z0ZstBn9PF#+93dbhXW4<7(l23$|*6Rn+QNG5-@Z{fP(ekSX`yKE-fv&wi502_4TzI
zfm$<%^B^N5gS5J`oLb8HipcHr8y5(AIdDe3k(rreMc?)o7hF3a5{aW>*_-2ITJ%6g
zDB^$B$GO8}hP8BbikVylJ?q`8%X4)Dk{<U4t#%;0d9&pu@k2<8ERSUT@`d-)7e%e=
zrEx<zCFmDkSEB-66TWRpJ^@U8{#=cM$zAjE*3E-6nwsKyNZnyWYjL>*02HJ|fSk09
z%&cI_iyk_4uy)cU^Y?i&Jz~C%i(nZ^T2LJ`Z~Y8o^1pns!{hPQ5%VRrkqh^dlBCod
zvnPf9Y&NsGIbm*YPHjXW)4&6YNwMdu?(+21a5V$L`(H8o`N6rur=7k_QxQ34<gR>l
za#|~Kc3BugCkq|XX!NwHPT6e4F{)#FllM~^?IBhz-}b?txouG#EwCJkIBAM<DnGe>
z*kIT}`z9e-x6Ic-@srsy9=ozU@9yvK&xH_huZ!wlT6%#pi&W_Cr`xLC&`h^&_TB?U
z+d`&S&ahLSp(uzguddd_gs-m9QKq4}PNi-}Rh(JVqg;|px~&zL)W1NjvjiUX<KyG2
zhdx{%3zM6=x_U?>d&89m&k{5v=A*(ktcFNRE0K^)+0>}F=a!uqVED>HEk=nU${mY;
zcq1IQm)zRlPL}=?pVab_xXd+hf@?1LpV2Sdt%9XV{yl#Em6-yYvJ||Vn`0q!TewNl
zWl4T?%~pnG<yFfak61h}XUS+ZI9S5uKJ4?8uFIP)*q8GH6=kv?K5_|*M0^%mC%G<V
zV1U3<{h&D4_yNuUI2_J3nR2FA>C(po7T8@w^CuuEuxhJ<F&cS@6(^%a8f*J;KY7t0
z#hg9RQhlSoZyQ938<WD4jK(c9WcP@O2p4DP&cVUKq{iEmLd`7_#wI3AF1JYH@~e(U
zFC89Eu?>iK_!^|Oa9opBFsCcoCFoE1ngQvri)RcJ&B=uShJKn&{q32{8lKta(b^be
zL&J{F&Q80^e)?mRU+->EPPL)Ag!@i~x;A)r&MI8Lf39jGJf_wvztf_$&fV)eR_%ml
zdRmjW0~B$E(Zbu_dx{R`<?{Ldn6B>b^q!uc*gN?*&#Ozxh<J{NW*3r-skRU9k&MY7
zsbynf&0{lnva-4-CLT{OEOk`&tktARQi?{y2B~!vx+`%D54X8(%_A7Vv-}nh87L+6
z3Ka7IeSST&a9ZrLp5eNQgvu+Ax=<aJCrgj+cJ(!%H=@J`Y>l^k{X{xo4J0;S{5iFi
z@jRyNgZ4l5qK~RC3*JsoKQYe29ld!3s<z6er?$z(TRN1o(ADDNXi$JHWFD*No8Z6V
z9Pu{`+us#-QNTE!C>;X((+YbXHh6@Dux8;3DsyMQ6lel<b#;jI@bc(O|2_eu{Mg`m
zY`xzad4FhuXD&x-Cu>|#Dvnz6&nhbNZ|b<8_VI~>BThZa7WXqyZ04LRX$*Wc5Kw~}
zR_6zsl##o94R&ILLSgvKA4y%@r#p)rG;a@0UOFdFvD|?a>@(Vx*35arLq=^*vKD2l
zn@2U-7p3*ESi3Mh9<RT*7w#>TKhnJo_z92~j~CsCtS4YO&H~8VR=HktUjkpWfCsb%
zW%;XBD41&fiqs&KWVS+%x1Iot=rzM{7s1|kEbg9(`0`DtD6VO$jrV<aV<4Q7#tp6^
z6QY7FgOs=be{|~nO{b^-wXV~S?>fcH&{cs7lS_K%w=a%u6K0=z)NP}_olN+0%JD>{
zbxck^6e+8z;f0GCzSfg{Y`5XV=xF^cJTTEq`J^fQO3|3G)+}o2VL)ZEPkVOLj44a?
z2*StbJ2cjU+ER%1Os0KSR#uUnM&Nsb+#`L8b$*_!_E<Qgu%G{&hg|Fls1#+NO|s4}
zZE-3-(c0SjQ@SnYy0o-3iA1V*W~>@YTI@*uB=i}Xq9rtpzza4de-|5L4qvB&ft+@W
zME~Gm#!do(@T<T7?iA;O0}oMRVvC%x?CFIUL?55MCMLy^X6@9~y?ND=0P$+ZG>W@Q
z(Fcq&yLH5_{e}?x*#Y*3SW$wecx@MbDRBZiJ6wfk@|2dvo2M?+ydn1-7g|Tu=O7EY
z0qxE4iT=C4#(@}YC0okdB=dsbhEt8}qwcTM`z@CTv~_gOM@CMZ6Z05>+EP_jRsNV`
z0P1S*@zIFI<@WjMpy-;nIkh3oy7}p|th$w{g`oUU^F?KrQ>nTBBOdR0Df&G5GQU@m
z<!)cilp25V3k@1qHw=2wxz6>od)?N2dLs<>&khy6(J<SI6t}{j_b;KN62MsDEK3f0
GT>KBB79n*2

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/bxp_no_flier_stats.png b/lib/matplotlib/tests/baseline_images/test_axes/bxp_no_flier_stats.png
index 87bb56b464b623601a9bee70ccaa73cdf20ca86d..df216d72ca12f5a2a45ada4cbd933469bf5fdabe 100644
GIT binary patch
delta 1145
zcmYk6c}&x19LC?$mQw^GDbgKO+yG61c32#j)PrlG$Y^y%EL5=tY;BuT3kdU9I^vcv
zMbl)UT*W!bkTYDtQfWu9Tc{Kx_f?3&N?BJF+BpicACS2H@lD>mN50Sde4h8UIXAi7
z{tOBe#n44mK3kM`LC6A>3nBrRFXHB0#EDtL+#EiS7(@sn;Bna^ksvobIQYtk4MBWi
zRxnv#Nd*8n3F1?80kHSqE(C=(p#cDmO*nO&mS1I>ZTkwJwO_OFcZnyWt<9s$1MkJ<
zUJ5&UTj9~A4M#ulv?iroLmuaHF=IScY<%Xy6OSpf5>%92Q@zQ4wH3MO8__<nQDmr`
ztPY+wiPOjre9oD{@GThuedNxNGqgD&d|6gj);Y;F&d<vic`A8tZ|_Lav6e~hn62wx
z5~zIk@NqMz$A$1EV|<j|J~_BO>EPgSRV+SRI&goHN5*r2dm_M905Sm~VcG%py>zss
zF0JXTWo2c>Xi+E>;nC4sdXB%p|J8zmo)*Tm6GHCg6DDZ5Q3$ORacX}WWHA^FQvqLm
z8oVADajW{Z)gGu(KuR%sGL0^wtsI%NiZ&FXcb=TU==Oh~fMy<^3zus!#HVU3K<xvL
zeme^2?O<kRX5^ZZ*I6J>1ny0fEOH;x(L|~S8@_~&MNc3lxvG|yat5EBjNAuMoOK2y
zX<kl5?D=hAASNn0y3b~=t*J4tufq$4`T6wj?ryz;qkPN49Wxzt&?UQ784QNGPc@`k
zU15Qqk&OjgoAq@q-(~&oFhrvxCCtCz@&k^cQzXeDe5A$V-Ec$sRx9|?dRXO&sY&^!
z#(Qr)aM$|cP$391A;VrOBcYB$t<T>F1oXeLywf!-XRH_Kqn4IKHf(dq&q2|Y8QP#(
zR$CO1evuym>G-@y^}6Ivz3$D|NeEnple})EO}3DYg|BhnjE?^#!u!_qBtWI-OUGhu
zToo+hI0u6`@E;r4RVRS@$n-6s3Lq$B^`8w!4rE(fqs7I=nXjAs`}@tafl^2E$!U{y
z7E+uKS~eORG|B^as5>re%ZuN2JQ@3<F>_6a1-0zJ%-&cV3pepgSt9Ywi@TQ+L9$Qf
z#fFC=f6!4S%%7_PK2mMC8455p^Q%>MG9o$<YD@(@9`CX;y?ZJ$*$@0M_NP}drZnae
z1qpG&5hBL8aMfLR2&RJtZuZ4pFh?y6dD|~IXId0cH^RdmdV*vQc+q*T$+)nvFuI(V
zm)ChdC_{N&C`>6YFSkvQ-e-24c3@9@tbI8Tqfdne!EB&cu{cMz-A+(pGkTnXdb`CL
z@V`mep<Hiw>0LO~gOZ(|yS9BuT7|)G&v2UC=nC0&efS7qjQ4oWyY9`l4#2u|{dei^
zzJ=X`l_NLF{8=*9Vx`DhQGuA2@xVNUeU>uaY$_E}kOVkS`lr#dRTL3r5-YCA0?<*I
ZK0vgxpJ-nDT!#M$kPwq}s`&&{`Y&uD@Tvd+

delta 1095
zcmZ3>{hMooN<B-llV=DA5Y%v_bTBY5a29w(7Beugsev%#d|@kP1_oAHPZ!6KiaBrZ
zZuEPdCUN}X_mI09+}uH8DogYxMnnX>TOfY1+Tm1%-U4Nz?-#gVoRC!zo92<YBBir+
zVyn?|@93>cQy&OC-~6|Jo}tr5;~&RgpZEKdy7^`fR|or-*w?ZQw*)7?)tj8h%3r_X
zeRSTRmoHaddtE9kBeUfWuf&w=*RRhy|J-!;*{b_tmpK#m#)V%m)h%aaTmE`i)cWhy
zH-Ul=9z0lZ?%cVojS)Z{9jUwwO`HrY!VDa03<5q33K5rAGZ>TrjrscH$B$=UfB*h%
zWpDrge73r}dTC|l&h@dkIT;s-%Uc$#YOAmQ@aMjr?)1~UcI~?L`QDp(3>Ugr%3A~{
zLX4b!Mf1QF@tlO~YN8D*=alDh-@GAqUZUNTH9>2e?1kiRiN^`ZcCU$K$ji^q-Ws*_
zmQ8>fL&vo@MhosUwtSoA$51CIajS@n;ovN`2VcHydHPIo9w$SS>EC)ihwG)w7}y>@
zdbB7mF7Dpn@8{2-FD)+qyl%g(jm?_fyLac`-5U4PNMQcAiOuON*w39l?VaEM7#Kc#
z_q^9L;cfW;@A8G~2aTUFr)#ZYbTIf1#KH_L(r={>h=|Sm^@}I;a9m}Yg<G{~0vEUc
zO6~JJ?ZFHjX@UYxGZ_?S=rh+lf|Nr-?o239hN&T89TV6LcyP`*-5_v=h2dZfTT6l(
zER1ht)Qe1c_~Yks`&D`SzJ1<Ted&7okLP>Yy%>IMiLd{^aNoZ#r{CQ#{~7(Y*dy;|
znE(8RS^MWdUOWe6wuAG^Wc9-rO&DUY*Sp^5o?umGB(r!f!?Fz@Sl0G_yV(#NQPFfw
zhsnu+u_1wp;UEhvcFk`6W?1&%;lqW`KL6bP@7vFxJNx?j?)|;j-rjzHS2T-YLz~&`
zv%CM7?Top0^=fE;wX@Q4aC!jx^J8Z1+SG{SFXo#v*qx0!R?++Iw8I8(`I*W|tCks`
zoWZcb&g^K2Z~CN-92^JTtQmn0I4_;cpks6Jxh3nwhr0C<n;GuhyLT;XYu47v1wIS{
zYj5f^>56rS&1U;|sf6jpu63Xo1%~W369zdRrd&|qnnFVJ8juN$>PY4WP~ctr@^Ha5
zhGnmR{n{lbFMoeeU44E0>8GF0zJ{jF{@BOyZof+s+Rh%d;qzlunBnRGiWBC9JeJAR
znJk<UK~kxAfFZYfMH_q8h4y8PFLs^V%Mfj`;HEgx%V*|7A`BjIz-*BdWX_bkyK!08
z@5v8Y^u*SNfpS#()~L5{yNi684d$P(zJKigWK~u}ma}P_Gbcx}+KSmTR{qV}_SfLU
RTVOH4;OXk;vd$@?2>?hY-+}-D

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/bxp_nobox.png b/lib/matplotlib/tests/baseline_images/test_axes/bxp_nobox.png
index 89a7112dc853ace96042e529402a59e86abad6ab..11a23c2ecedf3030a344c975b4dca66763411f70 100644
GIT binary patch
literal 1920
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

literal 1866
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

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/bxp_nocaps.png b/lib/matplotlib/tests/baseline_images/test_axes/bxp_nocaps.png
index 4d8b9c38e0870810500a3e0a1b3763bd9d0b357c..76bb606ba6c5be8bc896d6d17d56a8c4bd3a9c30 100644
GIT binary patch
literal 1932
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

literal 1877
zcmbVNc{G%37=LG&X=aeEBxFW0PMVa`ZL(xdCJdn=Stf*WQ;KF>MvWz6#@ePSTM|VW
zU6b~a7CDq`BNZ)f87fPbl62p3+<Uv{{&VmB&UxPF`M&o#-}ijK-}C(56c_4d1)K&B
z0H8pzw{-;o0Yf0dpy4|B;bstYvJuu4cMQDPn7||O9vg1IJpuqUQEG^MRg+~fn55WR
zxksJ(@WRMmYrEEik^C#-#4}EfVMw`PL6sA~>M%2VaFL3RMEGpM9on8Q*GDzmtHMnM
zTm4fHm&G4GuI4a+kkQ64T+daFkea>sjWjILsofsj)ATjgqNXXvt!eMfkj38o2nPQ=
zk}fG}Q3Xo#5kMV&IY1WBc>wT~0mldlR@(t^9|J_{|6%i+*8brPyv4xSnET{Vui^%U
z0+))43inF!woA0N_!S}GM(kHwzQrM0(G!ex^U>qSddp`(Eo&$*w1&@b4r*WkVf+LL
zt?_Djg@`dmAOfspUItx~A;=p5`W8xdNKDKQN_JviV^co@xY=jhnwpw=`TBM~dPJ4j
zaBv{!&d7+sBsX16O|4xL8M%MIO7xbsI)JmBv~nfGSVQvuy<^c6doGt-SYoWo=ZF?)
zq$PEK5T>W6x9_>)a64sXza61~r;%nS!B1-%BeG8CTze-dn8)$H+i9MGLd<z5%f6+;
zkH3&gK_<5gCSax(a)<>dXLFH%!|$^^M!g6=8rcDXT=)mP4b4$zooyw~>$Ed$oKb#C
zpy3{TFg0}zmeMH}W8>mq+7kL+H=kawA&-t8?Mu;Ruvi|KXe)-xEdgQC<2>`W?ry#=
zBP`76+d+$A9$_&FK~B1;?se(J)VEtq7OP`u(&5_#etvTFSbtVh{m%XiO{9Tb4#Y1a
z!YzMeZ0p;%L>(p1vX0ieIx7i&CM`|jCi{!4rlw}GVqED8j=0jV%=JS5mrw65x*M2~
z$ry9JW6yhf^3Vx!utc~{OitQ3Gl*O9m^JIypOlOn<?2!*+3fP-;^J0q`O(++xZlUt
zMBns%xwx4)fTQo)wMi@%clY*+$H!}EG@7;ZLmH_B$-3?{9&Mgxw+yZauD@t;<3IG~
zpJ$ZT=^stez3_B*&`);Rx+WVoJbC@vpV4b#)Ya3|IXYSm$&F+(&leRfJ7ALA(q?eZ
zERU<X)dRFzylXjNvP64EL|#~%b5;>7kSRefQq_#h)TE*ewGB8bM;LD?B%x4f?fi<W
z1W=2f-9PH7eMS+#F){B>E&<>Sg=zW%Gcsh{C0r0@W+m{H6?Jx=pm})MIKN4LzS}ru
z*Bfl=y``Yhm&v^Dv(4amYm#~@SKE?u%>1s4<J|n9<TwulUAz4f5rP89J?bki^MUgc
z1lzAY7>WG6@dO;N8PnBtQa@Gn=~IL?I6VA$B*4elw`Xc-m7!r|R8&;i?cDr)@pabF
z!N|~4)m=E=Zl_Pf3&!iN-nh{&kuZqj3i046?@2@3SQ2?OtE1knZ=Svy8wGgBnOG&8
zr`SYVx1Oc^u3(xDQ8}<Sx0MEr!o$o8$#7`ycVRK=0r~_w4+lqF5gH1p7tMn<*SUNS
z$H)M7tCQuQ9Xk?1Z+d^P@(?Atvij;CYW20`LzO-*vLHw}`EFJ8__HC_p%)+Vjc>E2
z?|UwOk#KA%){z@fC$m3xuz*|&kh6YE43REBNG1F#EvDQwu0=W;KZwq8Ayz#Bibn4g
zKFZtMyT2}B-j!Pu)6>%#R5?2ghtq0&bG#Q~u8>?WA1t$33xk9ei<+vv8mo8@eHkp|
zS+c)pqob<7tC<!2rI2e%M^iNe+YG{h3ln*HMHsjXeW5@Z^RINxvkK%m61QaQwhsea
z6!4Ur_*oQmd2wh6@CzqG?DPPg6arwVq~-vz`ls~`ysA$wEa6nTAP631Wo6Q^MF#M;
zLI$KPltQ^3gXRvKAsU(#@j0QD@+eLFjQfj}Svfu?t1ltQvC$+fwbe>Z`UW;yb~bfR
zrY~c_#zI7IkTPIf*ZXjPEB03gBB{5AQZD6P%CSIIY4t=zLtSM>g(n((KdMXFv+6+s
z!lhEY7Qc+5LUAp6(!ee+zZ<ToGP!R@jn~SP!8SN8&=I<=BXr$K0TgM&H-XEOVlrzp
smY#BGGgdIif}O()|JQl(!$~uP9z&WjgVC4e;kgJXo2a%G*7W$_0h!758~^|S

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/bxp_patchartist.png b/lib/matplotlib/tests/baseline_images/test_axes/bxp_patchartist.png
index e41e21f3e50c221f2e01a1cccfeafa53f1ce0208..9b027f3bacd2b9f3b091a607a7e1304fab578a9f 100644
GIT binary patch
delta 1696
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
D>7wf9

delta 1766
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
HH!kOYdXE0R

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/bxp_percentilewhis.png b/lib/matplotlib/tests/baseline_images/test_axes/bxp_percentilewhis.png
index 93921f74e49f2276e0b9a4c47ee9afde5112a23f..29853ae8d778de8c749ad9914d250101cc9ca1ab 100644
GIT binary patch
literal 2945
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
Ww4xYmd^@xq26nrhtg9^jPyHPu$UF-G

literal 2894
zcmb7GdpMM78-M0t#-TyYrW#~qa%h#-h#ZE|kr+iP8D}}}FtsX$$*?6lNTLZb*_z2T
zBO>E!EXJlpF_mPnP9btGhjF%VyZe2+`~9)k_1)L?ywCey&vU)kec#vb_q%^d2b}g|
z6mg0G0F1reE*Ah`&?^wjqoC)|NO>T%AtQF!yUIfmBY!Lr`c^n@cQgV3l<wCBV`D9J
z08kva-(~B1=JrUtbFfC!`kK$){`yF|>!p-b>*^$KTGxS1>8l8zbJa#2*zWhbp0VV#
zra7rBv6{R7qfFLoa#`F5HNzum!Cf0RC~@&g->W(ptazT%Dn+HazEHF;-Z65T@uYTJ
zIj*=R!<^V3V?*Z+HN@IC&>I#c87-P6?)kdFDb&~#fCzaY_C<oOt#ELBEeveG0)WOI
z0F<E=FRld4r~luvpryAecJ7m2{i|04pKG+tj-pcZ`F#H1=;-0-=;+=WV;o>JrZd)C
z$LM#;C^un*x`l<G2`yS+^XAQi!^5uo_g||u20`maU?)$X&a|@XvdUyKpI$+UTT7Gy
z@fHl6Qj90BG4gU%MRFZN){?*-Wn0y}1Ns9muIp_2Mv<oi3j}0MT|K?@`oNONF|UB)
zqZA4yV+&6k2@YJWsIcyvI9p#|Z@`xDOG}$i+GBDR<lj}v7y-uXD2|T$H)`*l!)Cp?
zN+#oGE7)^!l?l3dKmUWWU)3gos#2S%Ux@#6zoU@oCVfvTl_P@cUxcGiHeY!Ne~mnO
znbICX-HP~U3*Asijpr+%_R8Qu*&p?v9^*}aRlaS71b$T`;@WC#oNChb>nq!zL<BAN
ztDA-A-Mzb${`2PqD@kJ(y@IzmFDqD<B_}IqTb+Hoi|3>RRFn3iCt6pCC#*=by*Dgk
zm#oZC8<|rq;1Q|&v~@(Rq@={F)Rb~74fv68l<l3|T<yh$2?-8|EBdhJW?;qG_sdI*
zJgo)ODPutea;ED?l}V}pwNE9@UX4_GIY-52VQW)tOrkfb{EEr+cY<^H7s;BI8yK-t
z$+TBO6N!n{bINniA6%4m9w~8eO2X<nvd*U!^H|zP*8}M1K0f5IurS=(wRVd}O0_;a
zjr^}Rkw8-aYgpE!C=~FC_#Jb2x#u-CQ-l11(3qHCPZ|`ifTbMo>FL2~Xt?U$c+=H|
z*Jd6#+KF_$YZGogJK4B@3aVgeq_p#9|Jk~}A2y}$8!Djme8dvauoQBv#%rVU$y5{?
z-FG(U+)Ot*+cMIrCRvl{rb+WV1gu115%p6;%~QW98PR4+AKx}_Mn!L7`H$<IJS->n
z#tbYiox`Z8)Ob+NK!tK$c-38d2ZG`7-<fbh4LCSB;MCO*a$KCDa?`&(VnQV9*w1~;
zqMw}o(pRV~hbQF9iNAa)+Q&()>nqygDI#>rwpmy_2rYTA#yiHDLQz-QMj~a;T{Hk8
zYuv$^96iYd!M>E<`92PTe%I8*dG>5KV}7Jmbb2K7+~QPop)wkeye@#7Y}>{=%;&lA
z@;IE`(bL0kE-0-r{h53JzTTysh`gP_u&tJse7{F|7cR(Y+MM&a@09(PUb)EiEIYl}
zw@kFLk;o8m6qNt`^vJ<SZXV0CT~$A}LMU^itKi|+HzUFW#v`WDuZ%_56bC?fmb>%f
z<D#OXzGl|TJ`Ay={;^OvI8;#C5gu~ADD>N{ukwP%38%UQP>fL(sF9J8gfVp#UrQ<Z
z%&u)`Qmu~De5cG1FsVnV5sY^0G@Q$sUL{Tl33AoeU3pBJ`K|%bx<Y#tYHd{@K1d*<
z1eySdAFuqr(qcU%LxGUy48Z=z6Rhg-wM0mxOkl8!-~Gv~p3^=i!`_~<dwyFoWmoN8
z*}jYA*h_%?bcr#cRkt|dF*DY-thJj+SnhRO$v_!&NSuw<D}|@<gER?fBKXmRG=w*I
znRg_sKeU83x>zC#yG7WoR|ClZkV3-}3Ryiy)*eY+f?xaLi2!P8*lanKN-d?TY3u-N
zUHMJIh1Ne{v)2vdQH`(#P>STIKZ(-1jdi1V?Fxy#h21XP9Mv1c3dT@ngG%2SJh44o
z@D2qUo$j3AVSqX}n;Akw!v9Tk4NKJHXr{)-KUqeOLdYFzF5p*IE-!nvy?K*+LvR1{
zLpZ~ofS`)Nok;3kbqC^PUHZ3~85!3JjLA29aqHGOb6k=>90x*!$H2|q{jF4bYg78A
ze*iQ+eRcW5mzSbbL+|H??%%(^8foix5nYJ+JEFroEAkO&<vc#$;qv9nq2b~0Az0@I
z<($<OJcY^I29tnfqW5eLfyd+7m$*~X_w9x>JqiNyR96*Zo7wW%aT1B-tBDhv?tY8d
z9yOWglx@L*VrqVTdHYQBxT82<;dgECO;yNM3Pb$`YlxLY{{`)s059*V|4mwbV7jC~
zz4ln|e8s0CpQP7tpUw)#Cbi2$HuQk;2}g0InYlTSX38&*mTk(a5B2kl2jt)@qljB<
zwjOe6kGD7b%j`nJIx=pdB~UjBL$QCl=g#>FhIfYJ9xN8i%UoJ+@llQ^ORVPwb8~Yp
z6Xvv_NiWc_MD3ZcC~BcSK-aq)_53k)OiZxxbkq(*XzZMt8TVx@&GuWw%oK9DTt^o2
zgc;tiC|VYtZOw3(kYu-=*w*<%p=skrTMsy17wV)%^t2$nUBoF4k_?WvmvJ59Z^7`o
z3<g6KHTA&jY~O0n@~A`Q<>k=90CW)ISzoC6l9_mQY@Vk+Gc_D!*W-oaS7=J7z12Ph
z&37gqB7(Nqqh#q<5*43Y&7_9JRR&I310frpRUCyHAIN`9vyn3`vH<VHIoVlR2d&vb
z6AI(<d<3&zPyA63i?_p>vB8NyRQhlM97r|3@()Q?EX+`F)&{GR>m6(T58|;vp(c=f
z?9t|wC+qaPrLWQqg>uG3=6QeO!6K>J3(L?F_xg8L5SliArc~Ln@bZw7aXLCW?BM1N
zCw!X_w#@C)$7S#496*+ZkSrA_gEkAH9V*Ld(_u6-Op|&msLlS_ASlfDSDK(%^4v6m
zVXih!nC%Mb#bC9ukKKneczIRRn=qJL96BB-6QdLgMWQ;4tym`>pE%MRYyw1OWjZ#`
zTP?ye3tDJ1D^{`n`4*Oz{_E6JyFoCWegyI)hBZaLoT>x~{<C>%^?)%R6broN{-Vhz
z7vaeKSY`9TK;FlXA01h5Q?ktHgTGu*5}oKt_~e57^3tes09q!Vd-Me=%)Y*W^nDxC
zUj{UCXl>BUJ~cVujKN?sws5rfTYWyCtY!1CyW6*sW71nL>u9XeilvFJ9B|VDIsLU0
zR*eBB_sYts`)w8<=R^$}K)3GY=Tlfl-tTir(T=R5u;z!JH^$~e!-YN0xc6u#2C`9k
z#Gr;?A0P2a1I)|5A4IXs73;0e_=wWN48Bp!%*=dy#GCPTur&6Wyh>i%Ry{l{xb*BN
zH8nLC%c+?D?8wQUYc_-Jk)4OOu!x=wLdKU`y-YT{d2lc^RC4F;-MgvxqGh8YveEVg
zeuxGiBsSI6U2>;VDXh5V4Uj>6^FL1KU(Dj7@=W;o+lLNTu7?aUu;1;p>){Tc_}>7x
CnjIGa

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/bxp_rangewhis.png b/lib/matplotlib/tests/baseline_images/test_axes/bxp_rangewhis.png
index bb1997317252800308e8a5d3ccec9c12541c9503..d9dc4379c6ae270ea116aa412a00c4c5a9f0f71b 100644
GIT binary patch
literal 2187
zcmbtWdsI@{9^Qb0ijSsALaM7%mZhQQ<ReECD=oN%TqP{^CYo4UN+mw?0bXOq%FG(4
z@#Z6Q6wSeExR%cW-!WNPNT{il+89}*6iWG=L+Pyg<F0krx_|u6IeYKlWAFWa``agj
zO4(^-fHMF97?F1E@Bsh@eFCu_5_*olZU}>3TiBla*uJbVc3kiYCfF0qK6aGFJ{lfk
z5z9Og9nOl{WNUA0ztQ3_n|&<W)y^*RF9%!Ji9>co#bsY8iT<%&`=bFsT4@coht}N=
z0O}oShX*Y_?{)u!Bfd{?ZK{!UpQ!VvmwAv-F(`wz=RHbRKQqi5ARSsYZMV$fi(anq
z3<b{JcI9xRamByRASBezeJwue4E&s4BvE2!xh-U{$mw2wpY&w?+!fN~ee&e=YzOX9
z106XksT*hzYFPOc{u;2(Gte7wzR>{;EDT`10N{NAIKlr<^Pnwi{++5gHZCsa_YSj5
zQoth%duXe(sT(oqq>X&o_=|^YR+*dI<nFG`L)z2GB^NADxr3_@%LY}|KIPxv4F_Rc
zUc*|3j$dj<{Qgi!$1oZPQeVe_Y7bp#f+oPeL%AO?x|zcLt5&W|(oEgIf6g}O*O_}q
zq*AHBzdx?4E6D=@(YR0-T40VO6zR5NUYn*^Uk~f`<r4d|2EhL8It%#2J(@t=J>x{I
zixJ1Cyv51lr=|gd3Hlba{LL^}a~S~5dO&Oshr9tW9J&ql(;&-3LaE@uaLwoAi_J=?
z5?Y3DY?@nw60;}>@t6&)#>ljDRpNi$R?Iatw`p+a^3AH<1RXBGZgcnV4D3j^xS{)5
zm5$q>j9$^(*GH?6`PB74ZfoN~d%Tupcc8v=YN|G9J8V3I1*2Y<?_IwPa{14#Tcx26
z<$<>R*gAoYU*-Cx?_<jZ0=(%NPZ1B*iBQ1BZ`~3KtVq2Ig}kpXFDxvKR!&pDl-WeG
zSfh6@*`*kv#3*hcYDvb9E+xAwqH0;Dm!qR&iA*MA4O}Fbq+xNy<w<BxLj&RY+k~9E
zOuVga1e56*BubGD4-b3K^J&(qB%=5$1)LEZOMjm<H$3+KeL`kd)^toffa$&3{4^Zn
zu9)KlP*Txi3}_yFDXWOsjN_-I3h2|NgR?mq8Ty3Oxq5lI?rC#G5vzY=LGV9aGQEa|
zYfVLKmu3*pjebk*$E=Lfsfy<%JWJR0M#2qO^x%ou-zeg$?0$H9(JMpi7Rxk4{@1^l
z60!Rt-Gbvg5fGLs5Ec{!N6O&@XdzWYP-@|R0Ry~$K&CwbixfBvhyT?#vl5#;J=;|1
zld|Q<A>&=t!e_(X+fM_c!XR~K`_zbN#yx6E@vHe;{y|-}*-wor=c0}W9Q*d?lu<@J
z73LB;5rAqw7&@kp<t1A^?Y%<>!QFB2%HueQk`Tcb2y`Pm63%NJm0$Os1zG-rQi(+3
zYko2$<f=TpaS2>pMBzuj)RaoYnGU(&5aLYrS9%PrDVV}^(Rq=($Gs-WM8homqs&_U
zO&i=iymUcX-I9wu=R38Izrct+`f64v!orYg^%S=p4*MTYI#-AI3DY!V3O}dIdn;rH
zAufRM1`n>ut~oh7%Oa{iBb!%o(Ghv2a&}r{HKyq8^|`rEeIy<b#_{0gM6JQ8w1}#I
zPii!d&d&VYT(iB_rkR<UO4U$%En9gZs2MiSWr>h#H}8TG(uLL8-?`?W^B4R8sY7Lu
zsIs_tO=jjStD0v0T;2&1m+dlP1P6QA*w|d7S6GRf=cfnf(Hb3{zBdAR_md~STMPYa
z0_p26KAf4UZ)<O#b#>!_cNicP3V$1UYn56Uri%6^it$lsV{F?g;s;9L!Bb2Cbn3M#
z;AW=By%Q#Mb#Zz3$3%YqsuHPk>_A~b!Q)4d9$A#~L}ooBa7OjbA9o@MP=xk;FKR<E
z3R0>CwfZ183;4RAKlZonhXSl2TND?b#r79F<D}0hu6k)wus(;p8J^0~&GZO{0@}if
zpE;vt;o_*jc{M7(wg`oZ(|C%exss*V0GM%#K-UInxx7FM2G$QE@0Lio)8#$4VB+}=
zm@|m!6KovF*s*$i)9Kc$mK$<+Be&A2P2*;kTie51hg963jU>lGOUS0ykel4IIph+g
z1Lge3Vf*(2sgfP&4d<*Vaz|4I^s1Vga(cz{L~FuH%^&$EYVro^6NVD4lM|*V1#~~Z
zi8s&xF85X5<$D*Z)k<Hvblmd=;>v;R71Z^RjMWs79~hgMRNc67<;iVUT>&}hegUDP
zwbhg9V5W^~IH^%TZA5&G`XE#ziMV8v<x*Ej5bo!HGXfQ=Irc2=v0M&ml6DeL1_tO3
zxn14+Tq>`cB!l!umFi~HKz;cN=cwuevf_tJmtx}M%OD0p=_UPjaTCLmF9|0ncju5>
zC)iV%bJ*!qi%Rx98&6>M*Or)=Z+!vP@;`7OmXKdSNP0&t@gdy{iw+feMAzh5D&LMg
zsEt=$9qLhM2?4eY;yt8Ta;Z2~D<E1RKDj>@?}r7%KWV;l-!jIFX(_dN1pOEQk|$+H
I<u*pzpMdM0jQ{`u

delta 1909
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

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/bxp_scalarwidth.png b/lib/matplotlib/tests/baseline_images/test_axes/bxp_scalarwidth.png
index aaa8846321953e87443efbe6541f5030dff401bd..38a0563aeb0f657734bf642fe6dc1a57262af081 100644
GIT binary patch
literal 2013
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
SPD2vBY5~oGZeMQelkhKw1xDlm

literal 1960
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

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/bxp_with_xlabels.png b/lib/matplotlib/tests/baseline_images/test_axes/bxp_with_xlabels.png
index a47dc0a47d214cf92b52e527cce84d6fced7be2e..f864ac1c4267e5b242ea71a46e8e415314eceebb 100644
GIT binary patch
literal 2774
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

literal 2721
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
ak7{$6yr(LrXN;j56A-NIEtwW);{FQ?`OU}x

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/bxp_with_ylabels.png b/lib/matplotlib/tests/baseline_images/test_axes/bxp_with_ylabels.png
index b65a77e86687f554237bd9ff3b836d6f3bcd4c0a..af0fb83ddd221896d7c9e0cfe8699208c5886c23 100644
GIT binary patch
literal 3108
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
Xd{I*HC6_p`V+U+3?9IzhdfoUJc+H*6

delta 2700
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
Aod5s;

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/bxp_withmean_custompoint.png b/lib/matplotlib/tests/baseline_images/test_axes/bxp_withmean_custompoint.png
index 45a0fac0fe81bd48dccb75e7454d21762805df73..fe7b0d37fb12559f3dc54c41f7a5e1132e830c3e 100644
GIT binary patch
delta 1913
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

delta 1883
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
JBU|6({{nBXcMkvn

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/bxp_withmean_line.png b/lib/matplotlib/tests/baseline_images/test_axes/bxp_withmean_line.png
index 966cc5a559cd7c787d8a4fde8fcc674c793bb5e3..279a9dd1c8b5a90e80593a12d22bd3d587ed51f1 100644
GIT binary patch
delta 1984
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
O1&pK44%Kv4(*FQ4!+VDS

delta 1963
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
IPOSL<06RWmrvLx|

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/bxp_withmean_point.png b/lib/matplotlib/tests/baseline_images/test_axes/bxp_withmean_point.png
index 9d47676beee5b6c2f317eb3ab2510bd274378123..ad938d741ac92d314c0b4bff6ec18693c445f54f 100644
GIT binary patch
literal 2218
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

literal 2163
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
J*J$I%_&5D8g}wj)

diff --git a/lib/matplotlib/tests/baseline_images/test_axes/bxp_withnotch.png b/lib/matplotlib/tests/baseline_images/test_axes/bxp_withnotch.png
index 1eae658a2ac01bfe6e5af8f9f8f52dba7662f624..63542a4007bdd15756b0cd2ca2090c52fd5d9f02 100644
GIT binary patch
literal 4782
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

literal 4728
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
a4$bdMG@0Bn6%HO9K?qeHl`18Rm;VCSV$Od6

diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index f1074d38e567..0fcb2eb26cbb 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -3223,6 +3223,15 @@ def test_bxp_customwhisker():
         whiskerprops=dict(linestyle='-', color='m', lw=3)))
 
 
+@check_figures_equal()
+def test_boxplot_median_bound_by_box(fig_test, fig_ref):
+    data = np.arange(3)
+    medianprops_test = {"linewidth": 12}
+    medianprops_ref = {**medianprops_test, "solid_capstyle": "butt"}
+    fig_test.subplots().boxplot(data,  medianprops=medianprops_test)
+    fig_ref.subplots().boxplot(data, medianprops=medianprops_ref)
+
+
 @image_comparison(['bxp_withnotch.png'],
                   remove_text=True,
                   savefig_kwarg={'dpi': 40},

From eb689899acf95a046a7dd7b925c4f86715fd9618 Mon Sep 17 00:00:00 2001
From: Amirreza Aflakparast <84932095+AmirAflak@users.noreply.github.com>
Date: Tue, 22 Aug 2023 01:32:01 +0330
Subject: [PATCH 0050/1120] refactor: constant "ncols" to variables

---
 galleries/examples/color/named_colors.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/galleries/examples/color/named_colors.py b/galleries/examples/color/named_colors.py
index c6cba68ab434..0181e0f06742 100644
--- a/galleries/examples/color/named_colors.py
+++ b/galleries/examples/color/named_colors.py
@@ -42,14 +42,14 @@ def plot_colortable(colors, *, ncols=4, sort_colors=True):
     n = len(names)
     nrows = math.ceil(n / ncols)
 
-    width = cell_width * 4 + 2 * margin
+    width = cell_width * ncols + 2 * margin
     height = cell_height * nrows + 2 * margin
     dpi = 72
 
     fig, ax = plt.subplots(figsize=(width / dpi, height / dpi), dpi=dpi)
     fig.subplots_adjust(margin/width, margin/height,
                         (width-margin)/width, (height-margin)/height)
-    ax.set_xlim(0, cell_width * 4)
+    ax.set_xlim(0, cell_width * ncols)
     ax.set_ylim(cell_height * (nrows-0.5), -cell_height/2.)
     ax.yaxis.set_visible(False)
     ax.xaxis.set_visible(False)

From c6bd8340f573fdc7d13ef304f5bddb4c29320378 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Tue, 22 Aug 2023 02:10:31 -0400
Subject: [PATCH 0051/1120] codespace link in devel

---
 doc/devel/index.rst | 64 +++++++++++++++++++++++----------------------
 1 file changed, 33 insertions(+), 31 deletions(-)

diff --git a/doc/devel/index.rst b/doc/devel/index.rst
index 1146df77adf2..a49290dd8994 100644
--- a/doc/devel/index.rst
+++ b/doc/devel/index.rst
@@ -12,53 +12,55 @@ and implementing new features, helping the community...
 New contributors
 ================
 
-.. card::
-
-   .. grid:: 1 1 2 2
-      :class-row: sd-align-minor-center
+.. grid:: 1 1 2 2
+   :class-row: sd-align-minor-center
 
-      .. grid-item::
-         :class: sd-fs-5
+   .. grid-item::
+      :class: sd-fs-5
 
-         :octicon:`info;1em;sd-text-info` :ref:`Where should I start? <start-contributing>`
+      :octicon:`info;1em;sd-text-info` :ref:`Where should I start? <start-contributing>`
 
-         :octicon:`question;1em;sd-text-info` :ref:`Where should I ask questions? <get_connected>`
+      :octicon:`question;1em;sd-text-info` :ref:`Where should I ask questions? <get_connected>`
 
-         :octicon:`issue-opened;1em;sd-text-info` :ref:`What are "good-first-issues"? <new_contributors>`
+      :octicon:`issue-opened;1em;sd-text-info` :ref:`What are "good-first-issues"? <new_contributors>`
 
-         :octicon:`git-pull-request;1em;sd-text-info` :ref:`How do I claim an issue? <managing_issues_prs>`
+      :octicon:`git-pull-request;1em;sd-text-info` :ref:`How do I claim an issue? <managing_issues_prs>`
 
-         .. :octicon:`codespaces;1em;sd-text-info` placeholder for codespaces link
+      :octicon:`codespaces;1em;sd-text-info` :ref:`How do I start a pull request? <how-to-contribute>`
 
-      .. grid-item::
+   .. grid-item::
 
-         .. grid:: 1
-            :gutter: 1
-            :class-row: sd-fs-5
+      .. grid:: 1
+         :gutter: 1
+         :class-row: sd-fs-5
 
-            .. grid-item-card::
-               :link: request-a-new-feature
-               :link-type: ref
+         .. grid-item-card::
+            :link: request-a-new-feature
+            :link-type: ref
+            :shadow: none
 
-               :octicon:`light-bulb;1em;sd-text-info` Request new feature
+            :octicon:`light-bulb;1em;sd-text-info` Request new feature
 
-            .. grid-item-card::
-               :link: submitting-a-bug-report
-               :link-type: ref
+         .. grid-item-card::
+            :link: submitting-a-bug-report
+            :link-type: ref
+            :shadow: none
 
-               :octicon:`bug;1em;sd-text-info` Submit bug report
+            :octicon:`bug;1em;sd-text-info` Submit bug report
 
-            .. grid-item-card::
-               :link: contributing-code
-               :link-type: ref
+         .. grid-item-card::
+            :link: contributing-code
+            :link-type: ref
+            :shadow: none
 
-               :octicon:`code;1em;sd-text-info` Contribute code
+            :octicon:`code;1em;sd-text-info` Contribute code
 
-            .. grid-item-card::
-               :link: documenting-matplotlib
-               :link-type: ref
+         .. grid-item-card::
+            :link: documenting-matplotlib
+            :link-type: ref
+            :shadow: none
 
-               :octicon:`note;1em;sd-text-info` Write documentation
+            :octicon:`note;1em;sd-text-info` Write documentation
 
 If you are new to contributing, we recommend that you first read our
 :ref:`contributing guide<contributing>`. If you are contributing code or

From 704f0a0ada323553d5b076210d3c6db65af1d5b5 Mon Sep 17 00:00:00 2001
From: Amirreza Aflakparast <84932095+AmirAflak@users.noreply.github.com>
Date: Tue, 22 Aug 2023 20:11:10 +0330
Subject: [PATCH 0052/1120] [Doc]: match 3D plot types with others (#26571)

match 3D plot types with others
---
 galleries/plot_types/3D/scatter3d_simple.py | 6 +++---
 galleries/plot_types/3D/surface3d_simple.py | 2 +-
 galleries/plot_types/3D/trisurf3d_simple.py | 6 +++---
 galleries/plot_types/3D/voxels_simple.py    | 6 +++---
 galleries/plot_types/3D/wire3d_simple.py    | 6 +++---
 5 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/galleries/plot_types/3D/scatter3d_simple.py b/galleries/plot_types/3D/scatter3d_simple.py
index 023a46448ccf..27ffb6abf748 100644
--- a/galleries/plot_types/3D/scatter3d_simple.py
+++ b/galleries/plot_types/3D/scatter3d_simple.py
@@ -1,7 +1,7 @@
 """
-==============
-3D scatterplot
-==============
+===================
+scatter(xs, ys, zs)
+===================
 
 See `~mpl_toolkits.mplot3d.axes3d.Axes3D.scatter`.
 """
diff --git a/galleries/plot_types/3D/surface3d_simple.py b/galleries/plot_types/3D/surface3d_simple.py
index b421469b821d..04f74d5edd14 100644
--- a/galleries/plot_types/3D/surface3d_simple.py
+++ b/galleries/plot_types/3D/surface3d_simple.py
@@ -1,6 +1,6 @@
 """
 =====================
-3D surface
+plot_surface(X, Y, Z)
 =====================
 
 See `~mpl_toolkits.mplot3d.axes3d.Axes3D.plot_surface`.
diff --git a/galleries/plot_types/3D/trisurf3d_simple.py b/galleries/plot_types/3D/trisurf3d_simple.py
index 6bf3dc0835d5..b32bd3ebc69a 100644
--- a/galleries/plot_types/3D/trisurf3d_simple.py
+++ b/galleries/plot_types/3D/trisurf3d_simple.py
@@ -1,7 +1,7 @@
 """
-======================
-Triangular 3D surfaces
-======================
+=====================
+plot_trisurf(x, y, z)
+=====================
 
 See `~mpl_toolkits.mplot3d.axes3d.Axes3D.plot_trisurf`.
 """
diff --git a/galleries/plot_types/3D/voxels_simple.py b/galleries/plot_types/3D/voxels_simple.py
index c3473e108969..05ce238b0935 100644
--- a/galleries/plot_types/3D/voxels_simple.py
+++ b/galleries/plot_types/3D/voxels_simple.py
@@ -1,7 +1,7 @@
 """
-==========================
-3D voxel / volumetric plot
-==========================
+=========================
+voxels([x, y, z], filled)
+=========================
 
 See `~mpl_toolkits.mplot3d.axes3d.Axes3D.voxels`.
 """
diff --git a/galleries/plot_types/3D/wire3d_simple.py b/galleries/plot_types/3D/wire3d_simple.py
index 8ce1a460617e..1ab847f3ecf4 100644
--- a/galleries/plot_types/3D/wire3d_simple.py
+++ b/galleries/plot_types/3D/wire3d_simple.py
@@ -1,7 +1,7 @@
 """
-=================
-3D wireframe plot
-=================
+=======================
+plot_wireframe(X, Y, Z)
+=======================
 
 See `~mpl_toolkits.mplot3d.axes3d.Axes3D.plot_wireframe`.
 """

From 0d7d3873da4273be3cf38b892e29e224e91daef9 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 18 Aug 2023 01:33:30 -0400
Subject: [PATCH 0053/1120] Use sys.platform over os.name

mypy does not recognize the latter [1], and there is a typing failure on
Windows because of `os.geteuid`.

[1] https://github.com/python/mypy/issues/13002
---
 lib/matplotlib/dviread.py                         | 2 +-
 lib/matplotlib/tests/test_animation.py            | 3 ++-
 lib/matplotlib/tests/test_backend_webagg.py       | 2 +-
 lib/matplotlib/tests/test_backends_interactive.py | 2 +-
 lib/matplotlib/tests/test_matplotlib.py           | 6 +++---
 5 files changed, 8 insertions(+), 7 deletions(-)

diff --git a/lib/matplotlib/dviread.py b/lib/matplotlib/dviread.py
index c00d05de0723..b2177e5087bc 100644
--- a/lib/matplotlib/dviread.py
+++ b/lib/matplotlib/dviread.py
@@ -1086,7 +1086,7 @@ def find_tex_file(filename):
     if lk:
         path = lk.search(filename)
     else:
-        if os.name == 'nt':
+        if sys.platform == 'win32':
             # On Windows only, kpathsea can use utf-8 for cmd args and output.
             # The `command_line_encoding` environment variable is set to force
             # it to always use utf-8 encoding.  See Matplotlib issue #11848.
diff --git a/lib/matplotlib/tests/test_animation.py b/lib/matplotlib/tests/test_animation.py
index 750b9b32dd24..a4de96d77b62 100644
--- a/lib/matplotlib/tests/test_animation.py
+++ b/lib/matplotlib/tests/test_animation.py
@@ -2,6 +2,7 @@
 from pathlib import Path
 import platform
 import re
+import shutil
 import subprocess
 import sys
 import weakref
@@ -318,7 +319,7 @@ def test_cleanup_temporaries(method_name, tmpdir, anim):
         assert list(Path(str(tmpdir)).iterdir()) == []
 
 
-@pytest.mark.skipif(os.name != "posix", reason="requires a POSIX OS")
+@pytest.mark.skipif(shutil.which("/bin/sh") is None, reason="requires a POSIX OS")
 def test_failing_ffmpeg(tmpdir, monkeypatch, anim):
     """
     Test that we correctly raise a CalledProcessError when ffmpeg fails.
diff --git a/lib/matplotlib/tests/test_backend_webagg.py b/lib/matplotlib/tests/test_backend_webagg.py
index 992827863b01..237a279c6352 100644
--- a/lib/matplotlib/tests/test_backend_webagg.py
+++ b/lib/matplotlib/tests/test_backend_webagg.py
@@ -11,7 +11,7 @@ def test_webagg_fallback(backend):
     if backend == "nbagg":
         pytest.importorskip("IPython")
     env = dict(os.environ)
-    if os.name != "nt":
+    if sys.platform != "win32":
         env["DISPLAY"] = ""
 
     env["MPLBACKEND"] = backend
diff --git a/lib/matplotlib/tests/test_backends_interactive.py b/lib/matplotlib/tests/test_backends_interactive.py
index b5f4db4efde6..4e088bd3fa1b 100644
--- a/lib/matplotlib/tests/test_backends_interactive.py
+++ b/lib/matplotlib/tests/test_backends_interactive.py
@@ -473,7 +473,7 @@ def test_cross_Qt_imports():
 
 @pytest.mark.skipif('TF_BUILD' in os.environ,
                     reason="this test fails an azure for unknown reasons")
-@pytest.mark.skipif(os.name == "nt", reason="Cannot send SIGINT on Windows.")
+@pytest.mark.skipif(sys.platform == "win32", reason="Cannot send SIGINT on Windows.")
 def test_webagg():
     pytest.importorskip("tornado")
     proc = subprocess.Popen(
diff --git a/lib/matplotlib/tests/test_matplotlib.py b/lib/matplotlib/tests/test_matplotlib.py
index f30d678a52f0..ac1c3455c3d9 100644
--- a/lib/matplotlib/tests/test_matplotlib.py
+++ b/lib/matplotlib/tests/test_matplotlib.py
@@ -17,9 +17,9 @@ def test_parse_to_version_info(version_str, version_tuple):
     assert matplotlib._parse_to_version_info(version_str) == version_tuple
 
 
-@pytest.mark.skipif(
-    os.name == "nt", reason="chmod() doesn't work as is on Windows")
-@pytest.mark.skipif(os.name != "nt" and os.geteuid() == 0,
+@pytest.mark.skipif(sys.platform == "win32",
+                    reason="chmod() doesn't work as is on Windows")
+@pytest.mark.skipif(sys.platform != "win32" and os.geteuid() == 0,
                     reason="chmod() doesn't work as root")
 def test_tmpconfigdir_warning(tmpdir):
     """Test that a warning is emitted if a temporary configdir must be used."""

From 0e9984a760eb903830f59ff0526ad85c6ceee4dc Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Tue, 22 Aug 2023 19:51:04 -0400
Subject: [PATCH 0054/1120] added __pycache__ to .gitignore

---
 .gitignore | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.gitignore b/.gitignore
index 74080f6c50ae..9c6bb2263c99 100644
--- a/.gitignore
+++ b/.gitignore
@@ -92,6 +92,7 @@ doc/.mpl_skip_subdirs.yaml
 *.py,cover
 cover/
 .noseids
+__pycache__
 
 # Conda files #
 ###############

From 863cf89966af5e6597d35812912c46c548f3d970 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Mon, 21 Aug 2023 22:37:11 -0400
Subject: [PATCH 0055/1120] clarify pre-commits and editing workflow

---
 doc/devel/development_setup.rst    | 23 +++++++++++++++------
 doc/devel/development_workflow.rst | 32 +++++++++++-------------------
 2 files changed, 29 insertions(+), 26 deletions(-)

diff --git a/doc/devel/development_setup.rst b/doc/devel/development_setup.rst
index 8625eaa60042..f42662849339 100644
--- a/doc/devel/development_setup.rst
+++ b/doc/devel/development_setup.rst
@@ -164,16 +164,27 @@ true for ``*.py`` files.  If you change the C-extension source (which might
 also happen if you change branches) you will have to re-run
 ``python -m pip install -ve .``
 
-Install pre-commit hooks (optional)
-===================================
-`pre-commit <https://pre-commit.com/>`_ hooks automatically check flake8 and
-other style issues when you run ``git commit``. The hooks are defined in the
-top level ``.pre-commit-config.yaml`` file. To install the hooks ::
+Install pre-commit hooks
+========================
+`pre-commit <https://pre-commit.com/>`_ hooks save time in the review process by
+identifying issues with the code before a pull request is formally opened. Most
+hooks can also aide in fixing the errors, and the checks should have
+corresponding :ref:`development workflow <development-workflow>` and
+:ref:`pull request <pr-guidelines>` guidelines. Hooks are configured in
+`.pre-commit-config.yaml <https://github.com/matplotlib/matplotlib/blob/main/.pre-commit-config.yaml?>`_
+and include checks for spelling and formatting, flake 8 conformity, accidentally
+committed files, import order, and incorrect branching.
+
+Install pre-commit hooks ::
 
     python -m pip install pre-commit
     pre-commit install
 
-The hooks can also be run manually. All the hooks can be run, in order as
+Hooks are run automatically after the ``git commit`` stage of the
+:ref:`editing workflow<edit-flow>`. When a hook has found and fixed an error in a
+file, that file must be *staged and committed* again.
+
+Hooks can also be run manually. All the hooks can be run, in order as
 listed in ``.pre-commit-config.yaml``, against the full codebase with ::
 
     pre-commit run --all-files
diff --git a/doc/devel/development_workflow.rst b/doc/devel/development_workflow.rst
index e9858cdecd2d..0d3a4c590de2 100644
--- a/doc/devel/development_workflow.rst
+++ b/doc/devel/development_workflow.rst
@@ -95,20 +95,8 @@ request and open a new pull request from the renamed branch. See
 The editing workflow
 ====================
 
-Overview
---------
-
-::
-
-   # hack hack
-   git add my_new_file
-   git commit -am 'NF - some message'
-   git push
-
-In more detail
---------------
-
 #. Make some changes
+#. Save the changes
 #. See which files have changed with ``git status``.
    You'll see a listing like this one:
 
@@ -129,13 +117,17 @@ In more detail
 
 #. Check what the actual changes are with ``git diff``.
 #. Add any new files to version control ``git add new_file_name``.
-#. To commit all modified files into the local copy of your repo,, do
-   ``git commit -am 'A commit message'``.  Note the ``-am`` options to
-   ``commit``. The ``m`` flag just signals that you're going to type a
-   message on the command line.  The ``a`` flag — you can just take on
-   faith — or see `why the -a flag?`_. The
-   `git commit <https://git-scm.com/docs/git-commit>`_ manual page might also be
-   useful.
+#. To commit **all** modified files into the local copy of your repo, type:
+
+   .. code-block:: bash
+
+      git commit -am 'A commit message'
+
+   Note the ``-am`` options to ``commit``. The ``m`` flag signals that you are
+   going to type a message on the command line.  The ``a`` flag stages every
+   file that has been modified, except files listed in ``.gitignore``. For more
+   information, see `why the -a flag?`_ and the
+   `git commit <https://git-scm.com/docs/git-commit>`_  manual page.
 #. To push the changes up to your forked repo on GitHub, do a ``git
    push``.
 

From f566213258ee0d08426ba12448c454e83842ae82 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Wed, 23 Aug 2023 21:28:04 +0200
Subject: [PATCH 0056/1120] Deduplicate test for toolbar button icon LA mode.

This seems to have been accidentally duplicated in 7e2d904 (perhaps a
merge problem).
---
 lib/matplotlib/tests/test_backends_interactive.py | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/lib/matplotlib/tests/test_backends_interactive.py b/lib/matplotlib/tests/test_backends_interactive.py
index b5f4db4efde6..678cfc80ef71 100644
--- a/lib/matplotlib/tests/test_backends_interactive.py
+++ b/lib/matplotlib/tests/test_backends_interactive.py
@@ -206,10 +206,6 @@ def check_alt_backend(alt_backend):
 
     assert fig.canvas.manager.get_window_title() == "Figure 1"
 
-    if mpl.rcParams["toolbar"] == "toolmanager":
-        # test toolbar button icon LA mode see GH issue 25174
-        _test_toolbar_button_la_mode_icon(fig)
-
     if mpl.rcParams["toolbar"] == "toolmanager":
         # test toolbar button icon LA mode see GH issue 25174
         _test_toolbar_button_la_mode_icon(fig)

From ebef650cd7741853b4f23265c024ef622b17eda6 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Wed, 23 Aug 2023 16:01:00 -0500
Subject: [PATCH 0057/1120] Switch to hstack for consistency

---
 lib/matplotlib/axes/_axes.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 4bd1e83d2f5a..93a60c332cf4 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -5471,8 +5471,8 @@ def get_interp_point(idx):
         collection = mcoll.PolyCollection(polys, **kwargs)
 
         # now update the datalim and autoscale
-        pts = np.vstack([np.column_stack([ind[where], dep1[where]]),
-                         np.column_stack([ind[where], dep2[where]])])
+        pts = np.vstack([np.hstack([ind[where, None], dep1[where, None]]),
+                         np.hstack([ind[where, None], dep2[where, None]])])
         if ind_dir == "y":
             pts = pts[:, ::-1]
 

From 3981bb36cdeab38572e12d1ed327b1db9b086b28 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Thu, 24 Aug 2023 10:45:01 +0200
Subject: [PATCH 0058/1120] Fix ToolBase.figure property setter.

The property must be defined to use self.set_figure as the setter, and
not the other way round; otherwise, subclasses that override set_figure
(such as ToolToggleBase) won't override the setter on the property.
---
 lib/matplotlib/backend_tools.py | 15 +++++++--------
 1 file changed, 7 insertions(+), 8 deletions(-)

diff --git a/lib/matplotlib/backend_tools.py b/lib/matplotlib/backend_tools.py
index 4df80ef5bda6..ac2a20f1ffa9 100644
--- a/lib/matplotlib/backend_tools.py
+++ b/lib/matplotlib/backend_tools.py
@@ -118,16 +118,15 @@ def __init__(self, toolmanager, name):
         lambda self: self._figure.canvas if self._figure is not None else None,
         doc="The canvas of the figure affected by this tool, or None.")
 
-    @property
-    def figure(self):
-        """The Figure affected by this tool, or None."""
-        return self._figure
-
-    @figure.setter
-    def figure(self, figure):
+    def set_figure(self, figure):
         self._figure = figure
 
-    set_figure = figure.fset
+    figure = property(
+        lambda self: self._figure,
+        # The setter must explicitly call self.set_figure so that subclasses can
+        # meaningfully override it.
+        lambda self, figure: self.set_figure(figure),
+        doc="The Figure affected by this tool, or None.")
 
     def _make_classic_style_pseudo_toolbar(self):
         """

From 63f1dfaf2942e8fb3e5f93b7534af564ff5acb3d Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Tue, 13 Dec 2022 14:47:08 +0100
Subject: [PATCH 0059/1120] Test with Python 3.12

---
 .github/workflows/tests.yml | 34 ++++++++++++++++++++++++----------
 1 file changed, 24 insertions(+), 10 deletions(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 2314f65225a9..53b700b96255 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -56,6 +56,7 @@ jobs:
             pyside2-ver: '==5.15.1'  # oldest version with working Py3.9 wheel.
             pyside6-ver: '==6.0.0'
             delete-font-cache: true
+            no-build-isolation: true
           - os: ubuntu-20.04
             python-version: 3.9
             extra-requirements: '-r requirements/testing/extra.txt'
@@ -76,6 +77,11 @@ jobs:
             # https://bugreports.qt.io/projects/PYSIDE/issues/PYSIDE-2346
             pyside6-ver: '!=6.5.1'
             extra-requirements: '-r requirements/testing/extra.txt'
+          - os: ubuntu-22.04
+            python-version: '3.12-dev'
+            pyside6-ver: '!=6.5.1'
+            pre: true
+            no-build-isolation: true
           - os: macos-latest
             python-version: 3.9
             # https://bugreports.qt.io/projects/PYSIDE/issues/PYSIDE-2346
@@ -191,8 +197,10 @@ jobs:
           python -m pip install --upgrade pip setuptools wheel
 
           # Install pre-release versions during our weekly upcoming dependency tests.
+          # Also install for 3.12 to get working NumPy (remove when 1.26 is released)
           if [[ "${{ github.event_name == 'schedule' &&
-                     matrix.name-suffix != '(Minimum Versions)' }}" = "true" ]]; then
+                     matrix.name-suffix != '(Minimum Versions)' }}" = "true"
+                || "${{ matrix.pre }}" = "true" ]]; then
             PRE="--pre"
           fi
 
@@ -204,7 +212,7 @@ jobs:
             ${{ matrix.extra-requirements }}
 
           # Preinstall pybind11 on no-build-isolation builds.
-          if [[ "${{ matrix.name-suffix }}" == '(Minimum Versions)' ]]; then
+          if [[ "${{ matrix.no-build-isolation }}" == 'true' ]]; then
             python -m pip install 'pybind11>=2.6'
           fi
 
@@ -232,7 +240,8 @@ jobs:
             python -c 'import PyQt5.QtCore' &&
             echo 'PyQt5 is available' ||
             echo 'PyQt5 is not available'
-          if [[ "${{ runner.os }}" != 'macOS' ]]; then
+          if [[ "${{ runner.os }}" != 'macOS'
+                && "${{ matrix.python-version != '3.12-dev'}}" = "true" ]]; then
             python -mpip install --upgrade pyside2${{ matrix.pyside2-ver }} &&
               python -c 'import PySide2.QtCore' &&
               echo 'PySide2 is available' ||
@@ -243,18 +252,23 @@ jobs:
               python -c 'import PyQt6.QtCore' &&
               echo 'PyQt6 is available' ||
               echo 'PyQt6 is not available'
+          fi
+          if [[ "${{ runner.os }}" != 'macOS'
+                && "${{ matrix.python-version != '3.12-dev'}}" = "true" ]]; then
             python -mpip install --upgrade pyside6${{ matrix.pyside6-ver }} &&
               python -c 'import PySide6.QtCore' &&
               echo 'PySide6 is available' ||
               echo 'PySide6 is not available'
           fi
 
-          python -mpip install --upgrade \
-            -f "https://extras.wxpython.org/wxPython4/extras/linux/gtk3/${{ matrix.os }}" \
-            wxPython &&
-            python -c 'import wx' &&
-            echo 'wxPython is available' ||
-            echo 'wxPython is not available'
+          if [[ "${{ matrix.python-version != '3.12-dev'}}" = "true" ]]; then
+            python -mpip install --upgrade \
+              -f "https://extras.wxpython.org/wxPython4/extras/linux/gtk3/${{ matrix.os }}" \
+              wxPython &&
+              python -c 'import wx' &&
+              echo 'wxPython is available' ||
+              echo 'wxPython is not available'
+          fi
 
       - name: Install the nightly dependencies
         # Only install the nightly dependencies during the scheduled event
@@ -289,7 +303,7 @@ jobs:
 
           cat mplsetup.cfg
 
-          if [[ "${{ matrix.name-suffix }}" == '(Minimum Versions)' ]]; then
+          if [[ "${{ matrix.no-build-isolation }}" == 'true' ]]; then
             # Minimum versions run does not use build isolation so that it
             # builds against the pre-installed minver dependencies.
             python -m pip install --no-deps --no-build-isolation -ve .

From a63dfaf727fa2ac14faf35f0f404318720bf3183 Mon Sep 17 00:00:00 2001
From: turnipseason <100782385+turnipseason@users.noreply.github.com>
Date: Fri, 25 Aug 2023 00:30:32 +0300
Subject: [PATCH 0060/1120] Added get_xmargin(), get_ymargin() and
 get_zmargin() and tests. (#26293)

Co-authored-by: Evgenii Radchenko <ge53fah@mytum.de>
---
 doc/api/axes_api.rst                          |  2 ++
 doc/api/toolkits/mplot3d/axes3d.rst           |  1 +
 doc/users/next_whats_new/margin_getters.rst   |  4 +++
 lib/matplotlib/axes/_base.py                  | 32 +++++++++++++++++++
 lib/matplotlib/axes/_base.pyi                 |  2 ++
 lib/matplotlib/tests/test_axes.py             |  8 +++++
 lib/mpl_toolkits/mplot3d/axes3d.py            | 16 ++++++++++
 lib/mpl_toolkits/mplot3d/tests/test_axes3d.py |  9 ++++++
 8 files changed, 74 insertions(+)
 create mode 100644 doc/users/next_whats_new/margin_getters.rst

diff --git a/doc/api/axes_api.rst b/doc/api/axes_api.rst
index 3457368fa51c..8b01a120da5b 100644
--- a/doc/api/axes_api.rst
+++ b/doc/api/axes_api.rst
@@ -335,6 +335,8 @@ Autoscaling and margins
    Axes.use_sticky_edges
 
    Axes.margins
+   Axes.get_xmargin
+   Axes.get_ymargin
    Axes.set_xmargin
    Axes.set_ymargin
 
diff --git a/doc/api/toolkits/mplot3d/axes3d.rst b/doc/api/toolkits/mplot3d/axes3d.rst
index f6d8e2529896..b581494e4883 100644
--- a/doc/api/toolkits/mplot3d/axes3d.rst
+++ b/doc/api/toolkits/mplot3d/axes3d.rst
@@ -137,6 +137,7 @@ Autoscaling and margins
    :template: autosummary.rst
    :nosignatures:
 
+   get_zmargin
    set_zmargin
    margins
    autoscale
diff --git a/doc/users/next_whats_new/margin_getters.rst b/doc/users/next_whats_new/margin_getters.rst
new file mode 100644
index 000000000000..c43709a17d52
--- /dev/null
+++ b/doc/users/next_whats_new/margin_getters.rst
@@ -0,0 +1,4 @@
+Getters for xmargin, ymargin and zmargin
+----------------------------------------
+``.Axes.get_xmargin()``, ``.Axes.get_ymargin()`` and ``.Axes3D.get_zmargin()`` methods have been added to return
+the margin values set by ``.Axes.set_xmargin()``, ``.Axes.set_ymargin()`` and ``.Axes3D.set_zmargin()``, respectively.
diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index 3796d9bbe508..ad06e6d552bc 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -2617,6 +2617,38 @@ def use_sticky_edges(self, b):
         self._use_sticky_edges = bool(b)
         # No effect until next autoscaling, which will mark the Axes as stale.
 
+    def get_xmargin(self):
+        """
+        Retrieve autoscaling margin of the x-axis.
+
+        .. versionadded:: 3.9
+
+        Returns
+        -------
+        xmargin : float
+
+        See Also
+        --------
+        matplotlib.axes.Axes.set_xmargin
+        """
+        return self._xmargin
+
+    def get_ymargin(self):
+        """
+        Retrieve autoscaling margin of the y-axis.
+
+        .. versionadded:: 3.9
+
+        Returns
+        -------
+        ymargin : float
+
+        See Also
+        --------
+        matplotlib.axes.Axes.set_ymargin
+        """
+        return self._ymargin
+
     def set_xmargin(self, m):
         """
         Set padding of X data limits prior to autoscaling.
diff --git a/lib/matplotlib/axes/_base.pyi b/lib/matplotlib/axes/_base.pyi
index d41ecae1803c..e3644585296d 100644
--- a/lib/matplotlib/axes/_base.pyi
+++ b/lib/matplotlib/axes/_base.pyi
@@ -242,6 +242,8 @@ class _AxesBase(martist.Artist):
     def use_sticky_edges(self) -> bool: ...
     @use_sticky_edges.setter
     def use_sticky_edges(self, b: bool) -> None: ...
+    def get_xmargin(self) -> float: ...
+    def get_ymargin(self) -> float: ...
     def set_xmargin(self, m: float) -> None: ...
     def set_ymargin(self, m: float) -> None: ...
 
diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index 0fcb2eb26cbb..6dea39a702fc 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -6153,6 +6153,14 @@ def test_margins():
                               ymax + (ymax - ymin) * 0.5)
 
 
+def test_margin_getters():
+    fig = plt.figure()
+    ax = fig.add_subplot()
+    ax.margins(0.2, 0.3)
+    assert ax.get_xmargin() == 0.2
+    assert ax.get_ymargin() == 0.3
+
+
 def test_set_margin_updates_limits():
     mpl.style.use("default")
     fig, ax = plt.subplots()
diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index aeb6a66d2c98..e7abdc0767b5 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -513,6 +513,22 @@ def update_datalim(self, xys, **kwargs):
     get_autoscalez_on = _axis_method_wrapper("zaxis", "_get_autoscale_on")
     set_autoscalez_on = _axis_method_wrapper("zaxis", "_set_autoscale_on")
 
+    def get_zmargin(self):
+        """
+        Retrieve autoscaling margin of the z-axis.
+
+        .. versionadded:: 3.9
+
+        Returns
+        -------
+        zmargin : float
+
+        See Also
+        --------
+        mpl_toolkits.mplot3d.axes3d.Axes3D.set_zmargin
+        """
+        return self._zmargin
+
     def set_zmargin(self, m):
         """
         Set padding of Z data limits prior to autoscaling.
diff --git a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
index 1f8764cbab9d..df9f2ae52fd7 100644
--- a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
@@ -1994,6 +1994,15 @@ def test_margins():
     assert ax.margins() == (0, 0.1, 0)
 
 
+def test_margin_getters():
+    fig = plt.figure()
+    ax = fig.add_subplot(projection='3d')
+    ax.margins(0.1, 0.2, 0.3)
+    assert ax.get_xmargin() == 0.1
+    assert ax.get_ymargin() == 0.2
+    assert ax.get_zmargin() == 0.3
+
+
 @pytest.mark.parametrize('err, args, kwargs, match', (
         (ValueError, (-1,), {}, r'margin must be greater than -0\.5'),
         (ValueError, (1, -1, 1), {}, r'margin must be greater than -0\.5'),

From f699d50bcef31106dfaa1dbd03b8921f2b238d23 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Wed, 23 Aug 2023 23:53:55 +0200
Subject: [PATCH 0061/1120] Support standard formatters in axisartist.

Ideally, axisartist-specific formatters (and locators) should be
deprecated and removed in the future.
---
 .../next_whats_new/stdfmt-axisartist.rst      |   3 +++
 lib/mpl_toolkits/axisartist/floating_axes.py  |   8 +++---
 lib/mpl_toolkits/axisartist/grid_finder.py    |  23 ++++++++++++++----
 .../axisartist/grid_helper_curvelinear.py     |   8 +++---
 .../polar_box.png                             | Bin 62526 -> 64346 bytes
 .../tests/test_grid_helper_curvelinear.py     |  20 +++++++--------
 6 files changed, 38 insertions(+), 24 deletions(-)
 create mode 100644 doc/users/next_whats_new/stdfmt-axisartist.rst

diff --git a/doc/users/next_whats_new/stdfmt-axisartist.rst b/doc/users/next_whats_new/stdfmt-axisartist.rst
new file mode 100644
index 000000000000..9cb014413042
--- /dev/null
+++ b/doc/users/next_whats_new/stdfmt-axisartist.rst
@@ -0,0 +1,3 @@
+``axisartist`` can now be used together with standard ``Formatters``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+... instead of being limited to axisartist-specific ones.
diff --git a/lib/mpl_toolkits/axisartist/floating_axes.py b/lib/mpl_toolkits/axisartist/floating_axes.py
index 97dafe98c694..306ae2c5139a 100644
--- a/lib/mpl_toolkits/axisartist/floating_axes.py
+++ b/lib/mpl_toolkits/axisartist/floating_axes.py
@@ -222,10 +222,10 @@ def _update_grid(self, x1, y1, x2, y2):
         grid_info["lon_info"] = lon_levs, lon_n, lon_factor
         grid_info["lat_info"] = lat_levs, lat_n, lat_factor
 
-        grid_info["lon_labels"] = grid_finder.tick_formatter1(
-            "bottom", lon_factor, lon_levs)
-        grid_info["lat_labels"] = grid_finder.tick_formatter2(
-            "bottom", lat_factor, lat_levs)
+        grid_info["lon_labels"] = grid_finder._format_ticks(
+            1, "bottom", lon_factor, lon_levs)
+        grid_info["lat_labels"] = grid_finder._format_ticks(
+            2, "bottom", lat_factor, lat_levs)
 
         lon_values = lon_levs[:lon_n] / lon_factor
         lat_values = lat_levs[:lat_n] / lat_factor
diff --git a/lib/mpl_toolkits/axisartist/grid_finder.py b/lib/mpl_toolkits/axisartist/grid_finder.py
index f969b011c4cd..18a48b8e8ccf 100644
--- a/lib/mpl_toolkits/axisartist/grid_finder.py
+++ b/lib/mpl_toolkits/axisartist/grid_finder.py
@@ -1,6 +1,6 @@
 import numpy as np
 
-from matplotlib import ticker as mticker
+from matplotlib import ticker as mticker, _api
 from matplotlib.transforms import Bbox, Transform
 
 
@@ -150,6 +150,19 @@ def __init__(self,
         self.tick_formatter2 = tick_formatter2
         self.set_transform(transform)
 
+    def _format_ticks(self, idx, direction, factor, levels):
+        """
+        Helper to support both standard formatters (inheriting from
+        `.mticker.Formatter`) and axisartist-specific ones; should be called instead of
+        directly calling ``self.tick_formatter1`` and ``self.tick_formatter2``.  This
+        method should be considered as a temporary workaround which will be removed in
+        the future at the same time as axisartist-specific formatters.
+        """
+        fmt = _api.check_getitem(
+            {1: self.tick_formatter1, 2: self.tick_formatter2}, idx=idx)
+        return (fmt.format_ticks(levels) if isinstance(fmt, mticker.Formatter)
+                else fmt(direction, factor, levels))
+
     def get_grid_info(self, x1, y1, x2, y2):
         """
         lon_values, lat_values : list of grid values. if integer is given,
@@ -192,14 +205,14 @@ def get_grid_info(self, x1, y1, x2, y2):
         tck_labels = grid_info["lon"]["tick_labels"] = {}
         for direction in ["left", "bottom", "right", "top"]:
             levs = grid_info["lon"]["tick_levels"][direction]
-            tck_labels[direction] = self.tick_formatter1(
-                direction, lon_factor, levs)
+            tck_labels[direction] = self._format_ticks(
+                1, direction, lon_factor, levs)
 
         tck_labels = grid_info["lat"]["tick_labels"] = {}
         for direction in ["left", "bottom", "right", "top"]:
             levs = grid_info["lat"]["tick_levels"][direction]
-            tck_labels[direction] = self.tick_formatter2(
-                direction, lat_factor, levs)
+            tck_labels[direction] = self._format_ticks(
+                2, direction, lat_factor, levs)
 
         return grid_info
 
diff --git a/lib/mpl_toolkits/axisartist/grid_helper_curvelinear.py b/lib/mpl_toolkits/axisartist/grid_helper_curvelinear.py
index ae17452b6c58..f76fd84b55fe 100644
--- a/lib/mpl_toolkits/axisartist/grid_helper_curvelinear.py
+++ b/lib/mpl_toolkits/axisartist/grid_helper_curvelinear.py
@@ -137,10 +137,10 @@ def update_lim(self, axes):
             "extremes": (lon_min, lon_max, lat_min, lat_max),
             "lon_info": (lon_levs, lon_n, np.asarray(lon_factor)),
             "lat_info": (lat_levs, lat_n, np.asarray(lat_factor)),
-            "lon_labels": grid_finder.tick_formatter1(
-                "bottom", lon_factor, lon_levs),
-            "lat_labels": grid_finder.tick_formatter2(
-                "bottom", lat_factor, lat_levs),
+            "lon_labels": grid_finder._format_ticks(
+                1, "bottom", lon_factor, lon_levs),
+            "lat_labels": grid_finder._format_ticks(
+                2, "bottom", lat_factor, lat_levs),
             "line_xy": (xx, yy),
         }
 
diff --git a/lib/mpl_toolkits/axisartist/tests/baseline_images/test_grid_helper_curvelinear/polar_box.png b/lib/mpl_toolkits/axisartist/tests/baseline_images/test_grid_helper_curvelinear/polar_box.png
index 04e8ceecd2cb57557a08bb1c6d7845316dd35328..8909355e9af8ac0d66827e13bd7674c8f0b82fed 100644
GIT binary patch
literal 64346
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%0Du}-Th;9
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
JnQ`_3{|mGCE0zEN

literal 62526
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
D6*yjU

diff --git a/lib/mpl_toolkits/axisartist/tests/test_grid_helper_curvelinear.py b/lib/mpl_toolkits/axisartist/tests/test_grid_helper_curvelinear.py
index 037836afec6a..eb7673fa1fa7 100644
--- a/lib/mpl_toolkits/axisartist/tests/test_grid_helper_curvelinear.py
+++ b/lib/mpl_toolkits/axisartist/tests/test_grid_helper_curvelinear.py
@@ -3,6 +3,7 @@
 import matplotlib.pyplot as plt
 from matplotlib.path import Path
 from matplotlib.projections import PolarAxes
+from matplotlib.ticker import FuncFormatter
 from matplotlib.transforms import Affine2D, Transform
 from matplotlib.testing.decorators import image_comparison
 
@@ -75,11 +76,8 @@ def inverted(self):
     ax1.grid(True)
 
 
-# Remove tol & kerning_factor when this test image is regenerated.
-@image_comparison(['polar_box.png'], style='default', tol=0.27)
+@image_comparison(['polar_box.png'], style='default', tol=0.02)
 def test_polar_box():
-    plt.rcParams['text.kerning_factor'] = 6
-
     fig = plt.figure(figsize=(5, 5))
 
     # PolarAxes.PolarTransform takes radian. However, we want our coordinate
@@ -95,13 +93,13 @@ def test_polar_box():
                                                      lon_minmax=None,
                                                      lat_minmax=(0, np.inf))
 
-    grid_locator1 = angle_helper.LocatorDMS(12)
-    tick_formatter1 = angle_helper.FormatterDMS()
-
-    grid_helper = GridHelperCurveLinear(tr,
-                                        extreme_finder=extreme_finder,
-                                        grid_locator1=grid_locator1,
-                                        tick_formatter1=tick_formatter1)
+    grid_helper = GridHelperCurveLinear(
+        tr,
+        extreme_finder=extreme_finder,
+        grid_locator1=angle_helper.LocatorDMS(12),
+        tick_formatter1=angle_helper.FormatterDMS(),
+        tick_formatter2=FuncFormatter(lambda x, p: "eight" if x == 8 else f"{int(x)}"),
+    )
 
     ax1 = SubplotHost(fig, 1, 1, 1, grid_helper=grid_helper)
 

From d03fce04be26da3643428df32d6efa65660694b4 Mon Sep 17 00:00:00 2001
From: Devilsaint <anshul.suresh99@gmail.com>
Date: Mon, 21 Aug 2023 22:51:30 +0530
Subject: [PATCH 0062/1120] [doc]: added section Verify installation

[doc]: added section Verify Installation

[doc]: added section Verify installation
---
 doc/devel/development_setup.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/doc/devel/development_setup.rst b/doc/devel/development_setup.rst
index f42662849339..4d277fca2ab4 100644
--- a/doc/devel/development_setup.rst
+++ b/doc/devel/development_setup.rst
@@ -164,6 +164,22 @@ true for ``*.py`` files.  If you change the C-extension source (which might
 also happen if you change branches) you will have to re-run
 ``python -m pip install -ve .``
 
+Verify the Installation
+=======================
+
+Run the following command to make sure you have correctly installed Matplotlib in editable mode.
+The command should be run when the virtual environment is activated ::
+
+    python -c "import matplotlib; print(matplotlib.__file__)"
+
+This command should return : ``<matplotlib_local_repo>\lib\matplotlib\__init__.py``
+
+We encourage you to run tests and build docs to verify that the code installed correctly and that the docs build cleanly,
+so that when you make code or document related changes you are aware of the existing issues beforehand.
+
+   * Run test cases to verify installation :ref:`testing`
+   * Verify documentation build :ref:`documenting-matplotlib`
+
 Install pre-commit hooks
 ========================
 `pre-commit <https://pre-commit.com/>`_ hooks save time in the review process by

From 71eed55bd95d99dc32c6b3ca3f70093eb8498177 Mon Sep 17 00:00:00 2001
From: Ruth Comer <ruth.comer@metoffice.gov.uk>
Date: Fri, 25 Aug 2023 12:09:45 +0100
Subject: [PATCH 0063/1120] FIX: array labelcolor for Tick

---
 lib/matplotlib/axis.py            |  2 +-
 lib/matplotlib/tests/test_axis.py | 10 ++++++++++
 2 files changed, 11 insertions(+), 1 deletion(-)
 create mode 100644 lib/matplotlib/tests/test_axis.py

diff --git a/lib/matplotlib/axis.py b/lib/matplotlib/axis.py
index 0ace31916ca9..77bd34df69c5 100644
--- a/lib/matplotlib/axis.py
+++ b/lib/matplotlib/axis.py
@@ -129,7 +129,7 @@ def __init__(
         if labelcolor is None:
             labelcolor = mpl.rcParams[f"{name}.labelcolor"]
 
-        if labelcolor == 'inherit':
+        if cbook._str_equal(labelcolor, 'inherit'):
             # inherit from tick color
             labelcolor = mpl.rcParams[f"{name}.color"]
 
diff --git a/lib/matplotlib/tests/test_axis.py b/lib/matplotlib/tests/test_axis.py
new file mode 100644
index 000000000000..97b5f88dede1
--- /dev/null
+++ b/lib/matplotlib/tests/test_axis.py
@@ -0,0 +1,10 @@
+import numpy as np
+
+import matplotlib.pyplot as plt
+from matplotlib.axis import XTick
+
+
+def test_tick_labelcolor_array():
+    # Smoke test that we can instantiate a Tick with labelcolor as array.
+    ax = plt.axes()
+    XTick(ax, 0, labelcolor=np.array([1, 0, 0, 1]))

From ce385fe4464b3ffc866fe2faf8d44e14d0c8f0c6 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Fri, 25 Aug 2023 10:33:11 -0500
Subject: [PATCH 0064/1120] Avoid checking limits when updating both min and
 max for contours

closes #26531
---
 lib/matplotlib/contour.py | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/lib/matplotlib/contour.py b/lib/matplotlib/contour.py
index 79f66b896131..aa3041ddce9b 100644
--- a/lib/matplotlib/contour.py
+++ b/lib/matplotlib/contour.py
@@ -887,11 +887,12 @@ def __init__(self, ax, *args,
         self.set_cmap(cmap)
         if norm is not None:
             self.set_norm(norm)
-        if vmin is not None:
-            self.norm.vmin = vmin
-        if vmax is not None:
-            self.norm.vmax = vmax
-        self._process_colors()
+        with self.norm.callbacks.blocked(signal="changed"):
+            if vmin is not None:
+                self.norm.vmin = vmin
+            if vmax is not None:
+                self.norm.vmax = vmax
+            self._process_colors()
 
         if self._paths is None:
             self._paths = self._make_paths_from_contour_generator()

From e46342eea0c33366bdd66b2b4eeb2554a79b9ede Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 25 Aug 2023 23:46:51 -0400
Subject: [PATCH 0065/1120] ci: Install GTK4 from brew on macOS

We try to install PyGObject everywhere, but this doesn't work because
GTK itself is not available from PyPI.
---
 .github/workflows/tests.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 2314f65225a9..a99afd5e3fa8 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -144,7 +144,7 @@ jobs:
           macOS)
             brew install ccache
             brew tap homebrew/cask-fonts
-            brew install font-noto-sans-cjk
+            brew install font-noto-sans-cjk gobject-introspection gtk4
             ;;
           esac
 

From 8b056ac2b5324604ad1291ecbbc89e0d3280ac94 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Sat, 26 Aug 2023 00:46:10 -0400
Subject: [PATCH 0066/1120] ci: Also check GTK4 when testing PyGObject
 availability

---
 .github/workflows/tests.yml | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index a99afd5e3fa8..274b963c0602 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -219,10 +219,14 @@ jobs:
           # libraries cannot be loaded at runtime, so an actual import is a
           # better check).
           # PyGObject, pycairo, and cariocffi do not install on OSX 10.12.
-           python -m pip install --upgrade pycairo 'cairocffi>=0.8' PyGObject &&
-             python -c 'import gi; gi.require_version("Gtk", "3.0"); from gi.repository import Gtk' &&
-             echo 'PyGObject is available' ||
-             echo 'PyGObject is not available'
+          python -m pip install --upgrade pycairo 'cairocffi>=0.8' PyGObject &&
+            (
+              python -c 'import gi; gi.require_version("Gtk", "4.0"); from gi.repository import Gtk' &&
+              echo 'PyGObject 4 is available' || echo 'PyGObject 4 is not available'
+            ) && (
+              python -c 'import gi; gi.require_version("Gtk", "3.0"); from gi.repository import Gtk' &&
+              echo 'PyGObject 3 is available' || echo 'PyGObject 3 is not available'
+            )
 
           # There are no functioning wheels available for OSX 10.12 (as of
           # Sept 2020) for either pyqt5 (there are only wheels for 10.13+) or

From 6caa6836a48ad44b6a91a962ba2eedee1c99c9c0 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 23 Aug 2023 16:03:39 -0400
Subject: [PATCH 0067/1120] MNT: Enable wheels for Python 3.12

---
 .github/workflows/cibuildwheel.yml | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 58b96d38c883..8c45ef95990b 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -135,6 +135,28 @@ jobs:
           name: sdist
           path: dist/
 
+      - name: Build wheels for CPython 3.12
+        uses: pypa/cibuildwheel@39a63b5912f086dd459cf6fcb13dcdd3fe3bc24d # v2.15.0
+        with:
+          package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
+        env:
+          CIBW_BUILD: "cp312-*"
+          CIBW_ARCHS: ${{ matrix.cibw_archs }}
+          # Remove this once NumPy with Python 3.12 wheels is not pre-release.
+          CIBW_BEFORE_BUILD: >-
+            pip install certifi "pybind11>=2.6" "setuptools>=42" "setuptools_scm>=7" &&
+            pip install --pre "numpy>=1.25" &&
+            rm -rf {package}/build
+          CIBW_BEFORE_BUILD_WINDOWS: >-
+            pip install certifi delvewheel "pybind11>=2.6" "setuptools>=42" "setuptools_scm>=7" &&
+            pip install --pre "numpy>=1.25" &&
+            rm -rf {package}/build
+          CIBW_ENVIRONMENT: PIP_NO_BUILD_ISOLATION=0
+          # Remove this once contourpy has Python 3.12 wheels.
+          CIBW_BEFORE_TEST: >-
+            pip install "meson>=1.2.0" "meson-python>=0.13.1" "ninja" "pybind11>=2.10.4" &&
+            pip install --pre "numpy>=1.25"
+
       - name: Build wheels for CPython 3.11
         uses: pypa/cibuildwheel@39a63b5912f086dd459cf6fcb13dcdd3fe3bc24d # v2.15.0
         with:

From f9f673fb48c1c2282daee93ddfc81bf8e8053e61 Mon Sep 17 00:00:00 2001
From: jsdodge <4602669+jsdodge@users.noreply.github.com>
Date: Sat, 26 Aug 2023 06:10:20 -0700
Subject: [PATCH 0068/1120] [Doc] Revise histogram features example (Closes
 #26604) (#26606)

* [Doc] Revise histogram features example (Addresses Issue #26604)

Remove reference to IQ scores and "Smarts" in figure; modify distribution parameters; update RNG syntax

* Update histogram_features.py

Wrap title string

* Fix trailing whitespace

* Restore RNG seed to 19680801
---
 .../examples/statistics/histogram_features.py     | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/galleries/examples/statistics/histogram_features.py b/galleries/examples/statistics/histogram_features.py
index 354ef1a3b55e..21f74fd1ac44 100644
--- a/galleries/examples/statistics/histogram_features.py
+++ b/galleries/examples/statistics/histogram_features.py
@@ -20,14 +20,14 @@
 import matplotlib.pyplot as plt
 import numpy as np
 
-np.random.seed(19680801)
+rng = np.random.default_rng(19680801)
 
 # example data
-mu = 100  # mean of distribution
-sigma = 15  # standard deviation of distribution
-x = mu + sigma * np.random.randn(437)
+mu = 106  # mean of distribution
+sigma = 17  # standard deviation of distribution
+x = rng.normal(loc=mu, scale=sigma, size=420)
 
-num_bins = 50
+num_bins = 42
 
 fig, ax = plt.subplots()
 
@@ -38,9 +38,10 @@
 y = ((1 / (np.sqrt(2 * np.pi) * sigma)) *
      np.exp(-0.5 * (1 / sigma * (bins - mu))**2))
 ax.plot(bins, y, '--')
-ax.set_xlabel('Smarts')
+ax.set_xlabel('Value')
 ax.set_ylabel('Probability density')
-ax.set_title(r'Histogram of IQ: $\mu=100$, $\sigma=15$')
+ax.set_title('Histogram of normal distribution sample: '
+             fr'$\mu={mu:.0f}$, $\sigma={sigma:.0f}$')
 
 # Tweak spacing to prevent clipping of ylabel
 fig.tight_layout()

From 66c02bc16dfabd9fa3a2b8b8f08ca5d751d3297c Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Sat, 26 Aug 2023 22:15:16 +0200
Subject: [PATCH 0069/1120] Cleanup AutoMinorLocator implementation.

No change to logic, only rewriting things in a slightly more compact
manner, and making the `len(majorlocs) < 2` case tested more explicitly
than via an IndexError.
---
 lib/matplotlib/ticker.py | 45 ++++++++++++++--------------------------
 1 file changed, 16 insertions(+), 29 deletions(-)

diff --git a/lib/matplotlib/ticker.py b/lib/matplotlib/ticker.py
index b4793929de9b..8dc79d4c0f30 100644
--- a/lib/matplotlib/ticker.py
+++ b/lib/matplotlib/ticker.py
@@ -2893,6 +2893,7 @@ class AutoMinorLocator(Locator):
     Dynamically find minor tick positions based on the positions of
     major ticks. The scale must be linear with major ticks evenly spaced.
     """
+
     def __init__(self, n=None):
         """
         *n* is the number of subdivisions of the interval between
@@ -2908,47 +2909,33 @@ def __init__(self, n=None):
         self.ndivs = n
 
     def __call__(self):
-        """Return the locations of the ticks."""
+        # docstring inherited
         if self.axis.get_scale() == 'log':
-            _api.warn_external('AutoMinorLocator does not work with '
-                               'logarithmic scale')
+            _api.warn_external('AutoMinorLocator does not work on logarithmic scales')
             return []
 
         majorlocs = self.axis.get_majorticklocs()
-        try:
-            majorstep = majorlocs[1] - majorlocs[0]
-        except IndexError:
-            # Need at least two major ticks to find minor tick locations
-            # TODO: Figure out a way to still be able to display minor
-            # ticks without two major ticks visible. For now, just display
-            # no ticks at all.
+        if len(majorlocs) < 2:
+            # Need at least two major ticks to find minor tick locations.
+            # TODO: Figure out a way to still be able to display minor ticks with less
+            # than two major ticks visible. For now, just display no ticks at all.
             return []
+        majorstep = majorlocs[1] - majorlocs[0]
 
         if self.ndivs is None:
-
-            if self.axis.axis_name == 'y':
-                self.ndivs = mpl.rcParams['ytick.minor.ndivs']
-            else:
-                # for x and z axis
-                self.ndivs = mpl.rcParams['xtick.minor.ndivs']
+            self.ndivs = mpl.rcParams[
+                'ytick.minor.ndivs' if self.axis.axis_name == 'y'
+                else 'xtick.minor.ndivs']  # for x and z axis
 
         if self.ndivs == 'auto':
-
-            majorstep_no_exponent = 10 ** (np.log10(majorstep) % 1)
-
-            if np.isclose(majorstep_no_exponent, [1.0, 2.5, 5.0, 10.0]).any():
-                ndivs = 5
-            else:
-                ndivs = 4
+            majorstep_mantissa = 10 ** (np.log10(majorstep) % 1)
+            ndivs = 5 if np.isclose(majorstep_mantissa, [1, 2.5, 5, 10]).any() else 4
         else:
             ndivs = self.ndivs
 
         minorstep = majorstep / ndivs
 
-        vmin, vmax = self.axis.get_view_interval()
-        if vmin > vmax:
-            vmin, vmax = vmax, vmin
-
+        vmin, vmax = sorted(self.axis.get_view_interval())
         t0 = majorlocs[0]
         tmin = round((vmin - t0) / minorstep)
         tmax = round((vmax - t0) / minorstep) + 1
@@ -2957,5 +2944,5 @@ def __call__(self):
         return self.raise_if_exceeds(locs)
 
     def tick_values(self, vmin, vmax):
-        raise NotImplementedError('Cannot get tick locations for a '
-                                  '%s type.' % type(self))
+        raise NotImplementedError(
+            f"Cannot get tick locations for a {type(self).__name__}")

From 0da1b6c80ff067a158af07d5d65fc1e01efdd8cc Mon Sep 17 00:00:00 2001
From: Scott Shambaugh <scottshambaugh@users.noreply.github.com>
Date: Sat, 29 Apr 2023 01:16:15 -0600
Subject: [PATCH 0070/1120] Implement exact 3d plot limits

Fix remaining large image diffs

Fix remaining large image diffs

Fix the rest of the tests

Fix docs error

Code review updates

Code review updates

Fix docs error

One more constant

Tweaks

Keep fixing CI errors

Docstrings

Update baseline images

More test images

Images

Test new scaling factor

Test new scaling factor

Test for exact limits

Cleanup

Tests

Update doc/users/next_whats_new/3d_axis_limits.rst

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>

rebase fixes

Apply suggestions from code review

Co-authored-by: Oscar Gustafsson <oscar.gustafsson@gmail.com>

Code review cleanup

Merge conflicts and better comments

Merge conflicts and better comments
---
 doc/api/toolkits/mplot3d/axes3d.rst           |   6 +
 doc/users/next_whats_new/3d_axis_limits.rst   |  18 +
 lib/matplotlib/axis.py                        |  19 +-
 lib/matplotlib/mpl-data/matplotlibrc          |   5 +-
 .../mpl-data/stylelib/classic.mplstyle        |   3 +-
 lib/matplotlib/rcsetup.py                     |   6 +-
 lib/matplotlib/tests/test_collections.py      |   1 +
 lib/matplotlib/ticker.py                      |   5 +
 lib/mpl_toolkits/mplot3d/axes3d.py            | 466 +++++++++++++++---
 lib/mpl_toolkits/mplot3d/axis3d.py            |  37 +-
 lib/mpl_toolkits/mplot3d/tests/test_axes3d.py |  41 +-
 11 files changed, 493 insertions(+), 114 deletions(-)
 create mode 100644 doc/users/next_whats_new/3d_axis_limits.rst

diff --git a/doc/api/toolkits/mplot3d/axes3d.rst b/doc/api/toolkits/mplot3d/axes3d.rst
index b581494e4883..f99074fd9c8a 100644
--- a/doc/api/toolkits/mplot3d/axes3d.rst
+++ b/doc/api/toolkits/mplot3d/axes3d.rst
@@ -92,12 +92,18 @@ Axis limits and direction
 
    get_zaxis
    get_xlim
+   set_xlim
    get_ylim
+   set_ylim
    get_zlim
    set_zlim
    get_w_lims
    invert_zaxis
    zaxis_inverted
+   get_xbound
+   set_xbound
+   get_ybound
+   set_ybound
    get_zbound
    set_zbound
 
diff --git a/doc/users/next_whats_new/3d_axis_limits.rst b/doc/users/next_whats_new/3d_axis_limits.rst
new file mode 100644
index 000000000000..7e7d6b2e5133
--- /dev/null
+++ b/doc/users/next_whats_new/3d_axis_limits.rst
@@ -0,0 +1,18 @@
+Setting 3D axis limits now set the limits exactly
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Previously, setting the limits of a 3D axis would always add a small margin to
+the limits. Limits are now set exactly by default. The newly introduced rcparam
+``axes3d.automargin`` can be used to revert to the old behavior where margin is
+automatically added.
+
+.. plot::
+    :include-source: true
+    :alt: Example of the new behavior of 3D axis limits, and how setting the rcparam reverts to the old behavior.
+
+    import matplotlib.pyplot as plt
+    fig, axs = plt.subplots(1, 2, subplot_kw={'projection': '3d'})
+    plt.rcParams['axes3d.automargin'] = False  # the default in 3.9.0
+    axs[0].set(xlim=(0, 1), ylim=(0, 1), zlim=(0, 1), title='New Behavior')
+    plt.rcParams['axes3d.automargin'] = True
+    axs[1].set(xlim=(0, 1), ylim=(0, 1), zlim=(0, 1), title='Old Behavior')
diff --git a/lib/matplotlib/axis.py b/lib/matplotlib/axis.py
index 0ace31916ca9..f0824dc4ed56 100644
--- a/lib/matplotlib/axis.py
+++ b/lib/matplotlib/axis.py
@@ -855,13 +855,14 @@ def _get_autoscale_on(self):
     def _set_autoscale_on(self, b):
         """
         Set whether this Axis is autoscaled when drawing or by
-        `.Axes.autoscale_view`.
+        `.Axes.autoscale_view`. If b is None, then the value is not changed.
 
         Parameters
         ----------
         b : bool
         """
-        self._autoscale_on = b
+        if b is not None:
+            self._autoscale_on = b
 
     def get_children(self):
         return [self.label, self.offsetText,
@@ -1244,8 +1245,7 @@ def _set_lim(self, v0, v1, *, emit=True, auto):
         # Mark viewlims as no longer stale without triggering an autoscale.
         for ax in self._get_shared_axes():
             ax._stale_viewlims[name] = False
-        if auto is not None:
-            self._set_autoscale_on(bool(auto))
+        self._set_autoscale_on(auto)
 
         if emit:
             self.axes.callbacks.process(f"{name}lim_changed", self.axes)
@@ -1292,6 +1292,17 @@ def _update_ticks(self):
         if view_low > view_high:
             view_low, view_high = view_high, view_low
 
+        if (hasattr(self, "axes") and self.axes.name == '3d'
+                and mpl.rcParams['axes3d.automargin']):
+            # In mpl3.8, the margin was 1/48. Due to the change in automargin
+            # behavior in mpl3.9, we need to adjust this to compensate for a
+            # zoom factor of 2/48, giving us a 23/24 modifier. So the new
+            # margin is 0.019965277777777776 = 1/48*23/24.
+            margin = 0.019965277777777776
+            delta = view_high - view_low
+            view_high = view_high - delta * margin
+            view_low = view_low + delta * margin
+
         interval_t = self.get_transform().transform([view_low, view_high])
 
         ticks_to_draw = []
diff --git a/lib/matplotlib/mpl-data/matplotlibrc b/lib/matplotlib/mpl-data/matplotlibrc
index 2c53651da3d6..a097c98429d1 100644
--- a/lib/matplotlib/mpl-data/matplotlibrc
+++ b/lib/matplotlib/mpl-data/matplotlibrc
@@ -425,8 +425,9 @@
 #axes.autolimit_mode: data  # If "data", use axes.xmargin and axes.ymargin as is.
                             # If "round_numbers", after application of margins, axis
                             # limits are further expanded to the nearest "round" number.
-#polaraxes.grid: True  # display grid on polar axes
-#axes3d.grid:    True  # display grid on 3D axes
+#polaraxes.grid:    True   # display grid on polar axes
+#axes3d.grid:       True   # display grid on 3D axes
+#axes3d.automargin: False  # automatically add margin when manually setting 3D axis limits
 
 #axes3d.xaxis.panecolor:    (0.95, 0.95, 0.95, 0.5)  # background pane on 3D axes
 #axes3d.yaxis.panecolor:    (0.90, 0.90, 0.90, 0.5)  # background pane on 3D axes
diff --git a/lib/matplotlib/mpl-data/stylelib/classic.mplstyle b/lib/matplotlib/mpl-data/stylelib/classic.mplstyle
index 09a38df282f1..8923ce6f0497 100644
--- a/lib/matplotlib/mpl-data/stylelib/classic.mplstyle
+++ b/lib/matplotlib/mpl-data/stylelib/classic.mplstyle
@@ -223,7 +223,8 @@ axes.spines.left    : True
 axes.spines.right   : True
 axes.spines.top     : True
 polaraxes.grid      : True    # display grid on polar axes
-axes3d.grid         : True    # display grid on 3d axes
+axes3d.grid         : True    # display grid on 3D axes
+axes3d.automargin   : False   # automatically add margin when manually setting 3D axis limits
 
 date.autoformatter.year   : %Y
 date.autoformatter.month  : %b %Y
diff --git a/lib/matplotlib/rcsetup.py b/lib/matplotlib/rcsetup.py
index 276bb9f812a9..dda293f89401 100644
--- a/lib/matplotlib/rcsetup.py
+++ b/lib/matplotlib/rcsetup.py
@@ -1094,8 +1094,10 @@ def _convert_validator_spec(key, conv):
     "axes.ymargin": _validate_greaterthan_minushalf,  # margin added to yaxis
     "axes.zmargin": _validate_greaterthan_minushalf,  # margin added to zaxis
 
-    "polaraxes.grid": validate_bool,  # display polar grid or not
-    "axes3d.grid":    validate_bool,  # display 3d grid
+    "polaraxes.grid":    validate_bool,  # display polar grid or not
+    "axes3d.grid":       validate_bool,  # display 3d grid
+    "axes3d.automargin": validate_bool,  # automatically add margin when
+                                         # manually setting 3D axis limits
 
     "axes3d.xaxis.panecolor":    validate_color,  # 3d background pane
     "axes3d.yaxis.panecolor":    validate_color,  # 3d background pane
diff --git a/lib/matplotlib/tests/test_collections.py b/lib/matplotlib/tests/test_collections.py
index 43bbea34a2e5..1f7c104a4c07 100644
--- a/lib/matplotlib/tests/test_collections.py
+++ b/lib/matplotlib/tests/test_collections.py
@@ -401,6 +401,7 @@ def test_EllipseCollection():
 @image_comparison(['polycollection_close.png'], remove_text=True, style='mpl20')
 def test_polycollection_close():
     from mpl_toolkits.mplot3d import Axes3D  # type: ignore
+    plt.rcParams['axes3d.automargin'] = True
 
     vertsQuad = [
         [[0., 0.], [0., 1.], [1., 1.], [1., 0.]],
diff --git a/lib/matplotlib/ticker.py b/lib/matplotlib/ticker.py
index 8dc79d4c0f30..d6a48e9bb637 100644
--- a/lib/matplotlib/ticker.py
+++ b/lib/matplotlib/ticker.py
@@ -2106,6 +2106,11 @@ def _raw_ticks(self, vmin, vmax):
             steps = steps[igood]
 
         raw_step = ((_vmax - _vmin) / nbins)
+        if hasattr(self.axis, "axes") and self.axis.axes.name == '3d':
+            # Due to the change in automargin behavior in mpl3.9, we need to
+            # adjust the raw step to match the mpl3.8 appearance. The zoom
+            # factor of 2/48, gives us the 23/24 modifier.
+            raw_step = raw_step * 23/24
         large_steps = steps >= raw_step
         if mpl.rcParams['axes.autolimit_mode'] == 'round_numbers':
             # Classic round_numbers mode may require a larger step.
diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index e7abdc0767b5..b995b5a2a057 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -21,7 +21,6 @@
 import matplotlib as mpl
 from matplotlib import _api, cbook, _docstring, _preprocess_data
 import matplotlib.artist as martist
-import matplotlib.axes as maxes
 import matplotlib.collections as mcoll
 import matplotlib.colors as mcolors
 import matplotlib.image as mimage
@@ -133,7 +132,9 @@ def __init__(
 
         self.xy_viewLim = Bbox.unit()
         self.zz_viewLim = Bbox.unit()
-        self.xy_dataLim = Bbox.unit()
+        xymargin = 0.05 * 10/11  # match mpl3.8 appearance
+        self.xy_dataLim = Bbox([[xymargin, xymargin],
+                                [1 - xymargin, 1 - xymargin]])
         # z-limits are encoded in the x-component of the Bbox, y is un-used
         self.zz_dataLim = Bbox.unit()
 
@@ -166,6 +167,9 @@ def __init__(
         self.M = None
         self.invM = None
 
+        self._view_margin = 1/48  # default value to match mpl3.8
+        self.autoscale_view()
+
         # func used to format z -- fall back on major formatters
         self.fmt_zdata = None
 
@@ -345,7 +349,8 @@ def set_aspect(self, aspect, adjustable=None, anchor=None, share=False):
                                              self.set_ylim3d,
                                              self.set_zlim3d)):
                     if i in ax_indices:
-                        set_lim(mean[i] - deltas[i]/2., mean[i] + deltas[i]/2.)
+                        set_lim(mean[i] - deltas[i]/2., mean[i] + deltas[i]/2.,
+                                auto=True, view_margin=None)
             else:  # 'box'
                 # Change the box aspect such that the ratio of the length of
                 # the unmodified axis to the length of the diagonal
@@ -413,8 +418,11 @@ def set_box_aspect(self, aspect, *, zoom=1):
         else:
             aspect = np.asarray(aspect, dtype=float)
             _api.check_shape((3,), aspect=aspect)
-        # default scale tuned to match the mpl32 appearance.
-        aspect *= 1.8294640721620434 * zoom / np.linalg.norm(aspect)
+        # The scale 1.8294640721620434 is tuned to match the mpl3.2 appearance.
+        # The 25/24 factor is to compensate for the change in automargin
+        # behavior in mpl3.9. This comes from the padding of 1/48 on both sides
+        # of the axes in mpl3.8.
+        aspect *= 1.8294640721620434 * 25/24 * zoom / np.linalg.norm(aspect)
 
         self._box_aspect = aspect
         self.stale = True
@@ -601,17 +609,17 @@ def autoscale(self, enable=True, axis='both', tight=None):
             scalez = True
         else:
             if axis in ['x', 'both']:
-                self.set_autoscalex_on(bool(enable))
+                self.set_autoscalex_on(enable)
                 scalex = self.get_autoscalex_on()
             else:
                 scalex = False
             if axis in ['y', 'both']:
-                self.set_autoscaley_on(bool(enable))
+                self.set_autoscaley_on(enable)
                 scaley = self.get_autoscaley_on()
             else:
                 scaley = False
             if axis in ['z', 'both']:
-                self.set_autoscalez_on(bool(enable))
+                self.set_autoscalez_on(enable)
                 scalez = self.get_autoscalez_on()
             else:
                 scalez = False
@@ -636,8 +644,8 @@ def auto_scale_xyz(self, X, Y, Z=None, had_data=None):
         # Let autoscale_view figure out how to use this data.
         self.autoscale_view()
 
-    def autoscale_view(self, tight=None, scalex=True, scaley=True,
-                       scalez=True):
+    def autoscale_view(self, tight=None,
+                       scalex=True, scaley=True, scalez=True):
         """
         Autoscale the view limits using the data limits.
 
@@ -669,7 +677,7 @@ def autoscale_view(self, tight=None, scalex=True, scaley=True,
                 x1 += delta
             if not _tight:
                 x0, x1 = xlocator.view_limits(x0, x1)
-            self.set_xbound(x0, x1)
+            self.set_xbound(x0, x1, self._view_margin)
 
         if scaley and self.get_autoscaley_on():
             y0, y1 = self.xy_dataLim.intervaly
@@ -681,7 +689,7 @@ def autoscale_view(self, tight=None, scalex=True, scaley=True,
                 y1 += delta
             if not _tight:
                 y0, y1 = ylocator.view_limits(y0, y1)
-            self.set_ybound(y0, y1)
+            self.set_ybound(y0, y1, self._view_margin)
 
         if scalez and self.get_autoscalez_on():
             z0, z1 = self.zz_dataLim.intervalx
@@ -693,7 +701,7 @@ def autoscale_view(self, tight=None, scalex=True, scaley=True,
                 z1 += delta
             if not _tight:
                 z0, z1 = zlocator.view_limits(z0, z1)
-            self.set_zbound(z0, z1)
+            self.set_zbound(z0, z1, self._view_margin)
 
     def get_w_lims(self):
         """Get 3D world limits."""
@@ -702,28 +710,347 @@ def get_w_lims(self):
         minz, maxz = self.get_zlim3d()
         return minx, maxx, miny, maxy, minz, maxz
 
-    # set_xlim, set_ylim are directly inherited from base Axes.
+    def _set_bound3d(self, get_bound, set_lim, axis_inverted,
+                     lower=None, upper=None, view_margin=None):
+        """
+        Set 3D axis bounds.
+        """
+        if upper is None and np.iterable(lower):
+            lower, upper = lower
+
+        old_lower, old_upper = get_bound()
+        if lower is None:
+            lower = old_lower
+        if upper is None:
+            upper = old_upper
+
+        set_lim(sorted((lower, upper), reverse=bool(axis_inverted())),
+                auto=None, view_margin=view_margin)
+
+    def set_xbound(self, lower=None, upper=None, view_margin=None):
+        """
+        Set the lower and upper numerical bounds of the x-axis.
+
+        This method will honor axis inversion regardless of parameter order.
+        It will not change the autoscaling setting (`.get_autoscalex_on()`).
+
+        Parameters
+        ----------
+        lower, upper : float or None
+            The lower and upper bounds. If *None*, the respective axis bound
+            is not modified.
+        view_margin : float or None
+            The margin to apply to the bounds. If *None*, the margin is handled
+            by `.set_xlim`.
+
+        See Also
+        --------
+        get_xbound
+        get_xlim, set_xlim
+        invert_xaxis, xaxis_inverted
+        """
+        self._set_bound3d(self.get_xbound, self.set_xlim, self.xaxis_inverted,
+                          lower, upper, view_margin)
+
+    def set_ybound(self, lower=None, upper=None, view_margin=None):
+        """
+        Set the lower and upper numerical bounds of the y-axis.
+
+        This method will honor axis inversion regardless of parameter order.
+        It will not change the autoscaling setting (`.get_autoscaley_on()`).
+
+        Parameters
+        ----------
+        lower, upper : float or None
+            The lower and upper bounds. If *None*, the respective axis bound
+            is not modified.
+        view_margin : float or None
+            The margin to apply to the bounds. If *None*, the margin is handled
+            by `.set_ylim`.
+
+        See Also
+        --------
+        get_ybound
+        get_ylim, set_ylim
+        invert_yaxis, yaxis_inverted
+        """
+        self._set_bound3d(self.get_ybound, self.set_ylim, self.yaxis_inverted,
+                          lower, upper, view_margin)
+
+    def set_zbound(self, lower=None, upper=None, view_margin=None):
+        """
+        Set the lower and upper numerical bounds of the z-axis.
+        This method will honor axis inversion regardless of parameter order.
+        It will not change the autoscaling setting (`.get_autoscaley_on()`).
+
+        Parameters
+        ----------
+        lower, upper : float or None
+            The lower and upper bounds. If *None*, the respective axis bound
+            is not modified.
+        view_margin : float or None
+            The margin to apply to the bounds. If *None*, the margin is handled
+            by `.set_zlim`.
+
+        See Also
+        --------
+        get_zbound
+        get_zlim, set_zlim
+        invert_zaxis, zaxis_inverted
+        """
+        self._set_bound3d(self.get_zbound, self.set_zlim, self.zaxis_inverted,
+                          lower, upper, view_margin)
+
+    def _set_lim3d(self, axis, lower=None, upper=None, *, emit=True,
+                   auto=False, view_margin=None, axmin=None, axmax=None):
+        """
+        Set 3D axis limits.
+        """
+        if upper is None:
+            if np.iterable(lower):
+                lower, upper = lower
+            elif axmax is None:
+                upper = axis.get_view_interval()[1]
+        if lower is None and axmin is None:
+            lower = axis.get_view_interval()[0]
+        if axmin is not None:
+            if lower is not None:
+                raise TypeError("Cannot pass both 'lower' and 'min'")
+            lower = axmin
+        if axmax is not None:
+            if upper is not None:
+                raise TypeError("Cannot pass both 'upper' and 'max'")
+            upper = axmax
+        if np.isinf(lower) or np.isinf(upper):
+            raise ValueError(f"Axis limits {lower}, {upper} cannot be infinite")
+        if view_margin is None:
+            if mpl.rcParams['axes3d.automargin']:
+                view_margin = self._view_margin
+            else:
+                view_margin = 0
+        delta = (upper - lower) * view_margin
+        lower -= delta
+        upper += delta
+        return axis._set_lim(lower, upper, emit=emit, auto=auto)
+
+    def set_xlim(self, left=None, right=None, *, emit=True, auto=False,
+                 view_margin=None, xmin=None, xmax=None):
+        """
+        Set the 3D x-axis view limits.
+
+        Parameters
+        ----------
+        left : float, optional
+            The left xlim in data coordinates. Passing *None* leaves the
+            limit unchanged.
+
+            The left and right xlims may also be passed as the tuple
+            (*left*, *right*) as the first positional argument (or as
+            the *left* keyword argument).
+
+            .. ACCEPTS: (left: float, right: float)
+
+        right : float, optional
+            The right xlim in data coordinates. Passing *None* leaves the
+            limit unchanged.
+
+        emit : bool, default: True
+            Whether to notify observers of limit change.
+
+        auto : bool or None, default: False
+            Whether to turn on autoscaling of the x-axis. *True* turns on,
+            *False* turns off, *None* leaves unchanged.
+
+        view_margin : float, optional
+            The additional margin to apply to the limits.
+
+        xmin, xmax : float, optional
+            They are equivalent to left and right respectively, and it is an
+            error to pass both *xmin* and *left* or *xmax* and *right*.
+
+        Returns
+        -------
+        left, right : (float, float)
+            The new x-axis limits in data coordinates.
+
+        See Also
+        --------
+        get_xlim
+        set_xbound, get_xbound
+        invert_xaxis, xaxis_inverted
+
+        Notes
+        -----
+        The *left* value may be greater than the *right* value, in which
+        case the x-axis values will decrease from *left* to *right*.
+
+        Examples
+        --------
+        >>> set_xlim(left, right)
+        >>> set_xlim((left, right))
+        >>> left, right = set_xlim(left, right)
+
+        One limit may be left unchanged.
+
+        >>> set_xlim(right=right_lim)
+
+        Limits may be passed in reverse order to flip the direction of
+        the x-axis. For example, suppose ``x`` represents depth of the
+        ocean in m. The x-axis limits might be set like the following
+        so 5000 m depth is at the left of the plot and the surface,
+        0 m, is at the right.
+
+        >>> set_xlim(5000, 0)
+        """
+        return self._set_lim3d(self.xaxis, left, right, emit=emit, auto=auto,
+                               view_margin=view_margin, axmin=xmin, axmax=xmax)
+
+    def set_ylim(self, bottom=None, top=None, *, emit=True, auto=False,
+                 view_margin=None, ymin=None, ymax=None):
+        """
+        Set the 3D y-axis view limits.
+
+        Parameters
+        ----------
+        bottom : float, optional
+            The bottom ylim in data coordinates. Passing *None* leaves the
+            limit unchanged.
+
+            The bottom and top ylims may also be passed as the tuple
+            (*bottom*, *top*) as the first positional argument (or as
+            the *bottom* keyword argument).
+
+            .. ACCEPTS: (bottom: float, top: float)
+
+        top : float, optional
+            The top ylim in data coordinates. Passing *None* leaves the
+            limit unchanged.
+
+        emit : bool, default: True
+            Whether to notify observers of limit change.
+
+        auto : bool or None, default: False
+            Whether to turn on autoscaling of the y-axis. *True* turns on,
+            *False* turns off, *None* leaves unchanged.
+
+        view_margin : float, optional
+            The additional margin to apply to the limits.
+
+        ymin, ymax : float, optional
+            They are equivalent to bottom and top respectively, and it is an
+            error to pass both *ymin* and *bottom* or *ymax* and *top*.
+
+        Returns
+        -------
+        bottom, top : (float, float)
+            The new y-axis limits in data coordinates.
+
+        See Also
+        --------
+        get_ylim
+        set_ybound, get_ybound
+        invert_yaxis, yaxis_inverted
+
+        Notes
+        -----
+        The *bottom* value may be greater than the *top* value, in which
+        case the y-axis values will decrease from *bottom* to *top*.
+
+        Examples
+        --------
+        >>> set_ylim(bottom, top)
+        >>> set_ylim((bottom, top))
+        >>> bottom, top = set_ylim(bottom, top)
+
+        One limit may be left unchanged.
+
+        >>> set_ylim(top=top_lim)
+
+        Limits may be passed in reverse order to flip the direction of
+        the y-axis. For example, suppose ``y`` represents depth of the
+        ocean in m. The y-axis limits might be set like the following
+        so 5000 m depth is at the bottom of the plot and the surface,
+        0 m, is at the top.
+
+        >>> set_ylim(5000, 0)
+        """
+        return self._set_lim3d(self.yaxis, bottom, top, emit=emit, auto=auto,
+                               view_margin=view_margin, axmin=ymin, axmax=ymax)
+
     def set_zlim(self, bottom=None, top=None, *, emit=True, auto=False,
-                 zmin=None, zmax=None):
-        """
-        Set 3D z limits.
-
-        See `.Axes.set_ylim` for full documentation
-        """
-        if top is None and np.iterable(bottom):
-            bottom, top = bottom
-        if zmin is not None:
-            if bottom is not None:
-                raise TypeError("Cannot pass both 'bottom' and 'zmin'")
-            bottom = zmin
-        if zmax is not None:
-            if top is not None:
-                raise TypeError("Cannot pass both 'top' and 'zmax'")
-            top = zmax
-        return self.zaxis._set_lim(bottom, top, emit=emit, auto=auto)
-
-    set_xlim3d = maxes.Axes.set_xlim
-    set_ylim3d = maxes.Axes.set_ylim
+                 view_margin=None, zmin=None, zmax=None):
+        """
+        Set the 3D z-axis view limits.
+
+        Parameters
+        ----------
+        bottom : float, optional
+            The bottom zlim in data coordinates. Passing *None* leaves the
+            limit unchanged.
+
+            The bottom and top zlims may also be passed as the tuple
+            (*bottom*, *top*) as the first positional argument (or as
+            the *bottom* keyword argument).
+
+            .. ACCEPTS: (bottom: float, top: float)
+
+        top : float, optional
+            The top zlim in data coordinates. Passing *None* leaves the
+            limit unchanged.
+
+        emit : bool, default: True
+            Whether to notify observers of limit change.
+
+        auto : bool or None, default: False
+            Whether to turn on autoscaling of the z-axis. *True* turns on,
+            *False* turns off, *None* leaves unchanged.
+
+        view_margin : float, optional
+            The additional margin to apply to the limits.
+
+        zmin, zmax : float, optional
+            They are equivalent to bottom and top respectively, and it is an
+            error to pass both *zmin* and *bottom* or *zmax* and *top*.
+
+        Returns
+        -------
+        bottom, top : (float, float)
+            The new z-axis limits in data coordinates.
+
+        See Also
+        --------
+        get_zlim
+        set_zbound, get_zbound
+        invert_zaxis, zaxis_inverted
+
+        Notes
+        -----
+        The *bottom* value may be greater than the *top* value, in which
+        case the z-axis values will decrease from *bottom* to *top*.
+
+        Examples
+        --------
+        >>> set_zlim(bottom, top)
+        >>> set_zlim((bottom, top))
+        >>> bottom, top = set_zlim(bottom, top)
+
+        One limit may be left unchanged.
+
+        >>> set_zlim(top=top_lim)
+
+        Limits may be passed in reverse order to flip the direction of
+        the z-axis. For example, suppose ``z`` represents depth of the
+        ocean in m. The z-axis limits might be set like the following
+        so 5000 m depth is at the bottom of the plot and the surface,
+        0 m, is at the top.
+
+        >>> set_zlim(5000, 0)
+        """
+        return self._set_lim3d(self.zaxis, bottom, top, emit=emit, auto=auto,
+                               view_margin=view_margin, axmin=zmin, axmax=zmax)
+
+    set_xlim3d = set_xlim
+    set_ylim3d = set_ylim
     set_zlim3d = set_zlim
 
     def get_xlim(self):
@@ -1049,6 +1376,15 @@ def clear(self):
             self._zmargin = mpl.rcParams['axes.zmargin']
         else:
             self._zmargin = 0.
+
+        xymargin = 0.05 * 10/11  # match mpl3.8 appearance
+        self.xy_dataLim = Bbox([[xymargin, xymargin],
+                                [1 - xymargin, 1 - xymargin]])
+        # z-limits are encoded in the x-component of the Bbox, y is un-used
+        self.zz_dataLim = Bbox.unit()
+        self._view_margin = 1/48  # default value to match mpl3.8
+        self.autoscale_view()
+
         self.grid(mpl.rcParams['axes3d.grid'])
 
     def _button_press(self, event):
@@ -1177,7 +1513,7 @@ def _calc_coord(self, xv, yv, renderer=None):
         # Get the pane locations for each of the axes
         pane_locs = []
         for axis in self._axis_map.values():
-            xys, loc = axis.active_pane(renderer)
+            xys, loc = axis.active_pane()
             pane_locs.append(loc)
 
         # Find the distance to the nearest pane by projecting the view vector
@@ -1289,9 +1625,9 @@ def drag_pan(self, button, key, x, y):
         dz = (maxz - minz) * duvw_projected[2]
 
         # Set the new axis limits
-        self.set_xlim3d(minx + dx, maxx + dx)
-        self.set_ylim3d(miny + dy, maxy + dy)
-        self.set_zlim3d(minz + dz, maxz + dz)
+        self.set_xlim3d(minx + dx, maxx + dx, auto=None)
+        self.set_ylim3d(miny + dy, maxy + dy, auto=None)
+        self.set_zlim3d(minz + dz, maxz + dz, auto=None)
 
     def _calc_view_axes(self, eye):
         """
@@ -1420,9 +1756,9 @@ def _scale_axis_limits(self, scale_x, scale_y, scale_z):
         cx, cy, cz, dx, dy, dz = self._get_w_centers_ranges()
 
         # Set the scaled axis limits
-        self.set_xlim3d(cx - dx*scale_x/2, cx + dx*scale_x/2)
-        self.set_ylim3d(cy - dy*scale_y/2, cy + dy*scale_y/2)
-        self.set_zlim3d(cz - dz*scale_z/2, cz + dz*scale_z/2)
+        self.set_xlim3d(cx - dx*scale_x/2, cx + dx*scale_x/2, auto=None)
+        self.set_ylim3d(cy - dy*scale_y/2, cy + dy*scale_y/2, auto=None)
+        self.set_zlim3d(cz - dz*scale_z/2, cz + dz*scale_z/2, auto=None)
 
     def _get_w_centers_ranges(self):
         """Get 3D world centers and axis ranges."""
@@ -1531,43 +1867,11 @@ def get_zbound(self):
         get_zlim, set_zlim
         invert_zaxis, zaxis_inverted
         """
-        bottom, top = self.get_zlim()
-        if bottom < top:
-            return bottom, top
+        lower, upper = self.get_zlim()
+        if lower < upper:
+            return lower, upper
         else:
-            return top, bottom
-
-    def set_zbound(self, lower=None, upper=None):
-        """
-        Set the lower and upper numerical bounds of the z-axis.
-
-        This method will honor axes inversion regardless of parameter order.
-        It will not change the autoscaling setting (`.get_autoscalez_on()`).
-
-        Parameters
-        ----------
-        lower, upper : float or None
-            The lower and upper bounds. If *None*, the respective axis bound
-            is not modified.
-
-        See Also
-        --------
-        get_zbound
-        get_zlim, set_zlim
-        invert_zaxis, zaxis_inverted
-        """
-        if upper is None and np.iterable(lower):
-            lower, upper = lower
-
-        old_lower, old_upper = self.get_zbound()
-        if lower is None:
-            lower = old_lower
-        if upper is None:
-            upper = old_upper
-
-        self.set_zlim(sorted((lower, upper),
-                             reverse=bool(self.zaxis_inverted())),
-                      auto=None)
+            return upper, lower
 
     def text(self, x, y, z, s, zdir=None, **kwargs):
         """
@@ -3052,10 +3356,10 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None, fmt='',
             lower limits. In that case a caret symbol is used to indicate
             this. *lims*-arguments may be scalars, or array-likes of the same
             length as the errors. To use limits with inverted axes,
-            `~.Axes.set_xlim` or `~.Axes.set_ylim` must be called before
-            `errorbar`. Note the tricky parameter names: setting e.g.
-            *ylolims* to True means that the y-value is a *lower* limit of the
-            True value, so, only an *upward*-pointing arrow will be drawn!
+            `~.set_xlim`, `~.set_ylim`, or `~.set_zlim` must be
+            called before `errorbar`. Note the tricky parameter names: setting
+            e.g. *ylolims* to True means that the y-value is a *lower* limit of
+            the True value, so, only an *upward*-pointing arrow will be drawn!
 
         xuplims, yuplims, zuplims : bool, default: False
             Same as above, but for controlling the upper limits.
diff --git a/lib/mpl_toolkits/mplot3d/axis3d.py b/lib/mpl_toolkits/mplot3d/axis3d.py
index 58792deae963..5c102437db85 100644
--- a/lib/mpl_toolkits/mplot3d/axis3d.py
+++ b/lib/mpl_toolkits/mplot3d/axis3d.py
@@ -276,21 +276,13 @@ def get_rotate_label(self, text):
         else:
             return len(text) > 4
 
-    def _get_coord_info(self, renderer):
+    def _get_coord_info(self):
         mins, maxs = np.array([
             self.axes.get_xbound(),
             self.axes.get_ybound(),
             self.axes.get_zbound(),
         ]).T
 
-        # Get the mean value for each bound:
-        centers = 0.5 * (maxs + mins)
-
-        # Add a small offset between min/max point and the edge of the plot:
-        deltas = (maxs - mins) / 12
-        mins -= 0.25 * deltas
-        maxs += 0.25 * deltas
-
         # Project the bounds along the current position of the cube:
         bounds = mins[0], maxs[0], mins[1], maxs[1], mins[2], maxs[2]
         bounds_proj = self.axes._tunit_cube(bounds, self.axes.M)
@@ -314,7 +306,17 @@ def _get_coord_info(self, renderer):
             elif vertical == 0:  # looking at YZ plane
                 highs = np.array([highs[0], False, False])
 
-        return mins, maxs, centers, deltas, bounds_proj, highs
+        return mins, maxs, bounds_proj, highs
+
+    def _calc_centers_deltas(self, maxs, mins):
+        centers = 0.5 * (maxs + mins)
+        # In mpl3.8, the scale factor was 1/12. mpl3.9 changes this to
+        # 1/12 * 24/25 = 0.08 to compensate for the change in automargin
+        # behavior and keep appearance the same. The 24/25 factor is from the
+        # 1/48 padding added to each side of the axis in mpl3.8.
+        scale = 0.08
+        deltas = (maxs - mins) * scale
+        return centers, deltas
 
     def _get_axis_line_edge_points(self, minmax, maxmin, position=None):
         """Get the edge points for the black bolded axis line."""
@@ -409,8 +411,8 @@ def _get_tickdir(self, position):
         tickdir = np.roll(info_i, -j)[np.roll(tickdirs_base, j)][i]
         return tickdir
 
-    def active_pane(self, renderer):
-        mins, maxs, centers, deltas, tc, highs = self._get_coord_info(renderer)
+    def active_pane(self):
+        mins, maxs, tc, highs = self._get_coord_info()
         info = self._axinfo
         index = info['i']
         if not highs[index]:
@@ -431,7 +433,7 @@ def draw_pane(self, renderer):
         renderer : `~matplotlib.backend_bases.RendererBase` subclass
         """
         renderer.open_group('pane3d', gid=self.get_gid())
-        xys, loc = self.active_pane(renderer)
+        xys, loc = self.active_pane()
         self.pane.xy = xys[:, :2]
         self.pane.draw(renderer)
         renderer.close_group('pane3d')
@@ -446,6 +448,10 @@ def _draw_ticks(self, renderer, edgep1, centers, deltas, highs,
         ticks = self._update_ticks()
         info = self._axinfo
         index = info["i"]
+        juggled = info["juggled"]
+
+        mins, maxs, tc, highs = self._get_coord_info()
+        centers, deltas = self._calc_centers_deltas(maxs, mins)
 
         # Draw ticks:
         tickdir = self._get_tickdir(pos)
@@ -575,7 +581,8 @@ def draw(self, renderer):
         renderer.open_group("axis3d", gid=self.get_gid())
 
         # Get general axis information:
-        mins, maxs, centers, deltas, tc, highs = self._get_coord_info(renderer)
+        mins, maxs, tc, highs = self._get_coord_info()
+        centers, deltas = self._calc_centers_deltas(maxs, mins)
 
         # Calculate offset distances
         # A rough estimate; points are ambiguous since 3D plots rotate
@@ -645,7 +652,7 @@ def draw_grid(self, renderer):
             info = self._axinfo
             index = info["i"]
 
-            mins, maxs, _, _, _, highs = self._get_coord_info(renderer)
+            mins, maxs, tc, highs = self._get_coord_info()
 
             minmax = np.where(highs, maxs, mins)
             maxmin = np.where(~highs, maxs, mins)
diff --git a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
index df9f2ae52fd7..75f0e2261907 100644
--- a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
@@ -222,6 +222,7 @@ def test_bar3d_lightsource():
     ['contour3d.png'], style='mpl20',
     tol=0.002 if platform.machine() in ('aarch64', 'ppc64le', 's390x') else 0)
 def test_contour3d():
+    plt.rcParams['axes3d.automargin'] = True  # Remove when image is regenerated
     fig = plt.figure()
     ax = fig.add_subplot(projection='3d')
     X, Y, Z = axes3d.get_test_data(0.05)
@@ -233,6 +234,7 @@ def test_contour3d():
 
 @mpl3d_image_comparison(['contour3d_extend3d.png'], style='mpl20')
 def test_contour3d_extend3d():
+    plt.rcParams['axes3d.automargin'] = True  # Remove when image is regenerated
     fig = plt.figure()
     ax = fig.add_subplot(projection='3d')
     X, Y, Z = axes3d.get_test_data(0.05)
@@ -244,6 +246,7 @@ def test_contour3d_extend3d():
 
 @mpl3d_image_comparison(['contourf3d.png'], style='mpl20')
 def test_contourf3d():
+    plt.rcParams['axes3d.automargin'] = True  # Remove when image is regenerated
     fig = plt.figure()
     ax = fig.add_subplot(projection='3d')
     X, Y, Z = axes3d.get_test_data(0.05)
@@ -257,6 +260,7 @@ def test_contourf3d():
 
 @mpl3d_image_comparison(['contourf3d_fill.png'], style='mpl20')
 def test_contourf3d_fill():
+    plt.rcParams['axes3d.automargin'] = True  # Remove when image is regenerated
     fig = plt.figure()
     ax = fig.add_subplot(projection='3d')
     X, Y = np.meshgrid(np.arange(-2, 2, 0.25), np.arange(-2, 2, 0.25))
@@ -300,6 +304,7 @@ def test_contourf3d_extend(fig_test, fig_ref, extend, levels):
 
 @mpl3d_image_comparison(['tricontour.png'], tol=0.02, style='mpl20')
 def test_tricontour():
+    plt.rcParams['axes3d.automargin'] = True  # Remove when image is regenerated
     fig = plt.figure()
 
     np.random.seed(19680801)
@@ -369,6 +374,7 @@ def f(t):
     t1 = np.arange(0.0, 5.0, 0.1)
     t2 = np.arange(0.0, 5.0, 0.02)
 
+    plt.rcParams['axes3d.automargin'] = True  # Remove when image is regenerated
     fig = plt.figure(figsize=plt.figaspect(2.))
     ax = fig.add_subplot(2, 1, 1)
     ax.plot(t1, f(t1), 'bo', t2, f(t2), 'k--', markerfacecolor='green')
@@ -400,6 +406,7 @@ def test_tight_layout_text(fig_test, fig_ref):
 
 @mpl3d_image_comparison(['scatter3d.png'], style='mpl20')
 def test_scatter3d():
+    plt.rcParams['axes3d.automargin'] = True  # Remove when image is regenerated
     fig = plt.figure()
     ax = fig.add_subplot(projection='3d')
     ax.scatter(np.arange(10), np.arange(10), np.arange(10),
@@ -413,6 +420,7 @@ def test_scatter3d():
 
 @mpl3d_image_comparison(['scatter3d_color.png'], style='mpl20')
 def test_scatter3d_color():
+    plt.rcParams['axes3d.automargin'] = True  # Remove when image is regenerated
     fig = plt.figure()
     ax = fig.add_subplot(projection='3d')
 
@@ -597,12 +605,14 @@ def test_surface3d():
     Z = np.sin(R)
     surf = ax.plot_surface(X, Y, Z, rcount=40, ccount=40, cmap=cm.coolwarm,
                            lw=0, antialiased=False)
+    plt.rcParams['axes3d.automargin'] = True  # Remove when image is regenerated
     ax.set_zlim(-1.01, 1.01)
     fig.colorbar(surf, shrink=0.5, aspect=5)
 
 
 @image_comparison(['surface3d_label_offset_tick_position.png'], style='mpl20')
 def test_surface3d_label_offset_tick_position():
+    plt.rcParams['axes3d.automargin'] = True  # Remove when image is regenerated
     ax = plt.figure().add_subplot(projection="3d")
 
     x, y = np.mgrid[0:6 * np.pi:0.25, 0:4 * np.pi:0.25]
@@ -627,6 +637,7 @@ def test_surface3d_shaded():
     Z = np.sin(R)
     ax.plot_surface(X, Y, Z, rstride=5, cstride=5,
                     color=[0.25, 1, 0.25], lw=1, antialiased=False)
+    plt.rcParams['axes3d.automargin'] = True  # Remove when image is regenerated
     ax.set_zlim(-1.01, 1.01)
 
 
@@ -695,6 +706,7 @@ def test_text3d():
 
     ax.text(1, 1, 1, "red", color='red')
     ax.text2D(0.05, 0.95, "2D Text", transform=ax.transAxes)
+    plt.rcParams['axes3d.automargin'] = True  # Remove when image is regenerated
     ax.set_xlim3d(0, 10)
     ax.set_ylim3d(0, 10)
     ax.set_zlim3d(0, 10)
@@ -808,6 +820,7 @@ def test_mixedsamplesraises():
 
 @mpl3d_image_comparison(['quiver3d.png'], style='mpl20')
 def test_quiver3d():
+    plt.rcParams['axes3d.automargin'] = True  # Remove when image is regenerated
     fig = plt.figure()
     ax = fig.add_subplot(projection='3d')
     pivots = ['tip', 'middle', 'tail']
@@ -976,6 +989,7 @@ def test_add_collection3d_zs_array():
 
     assert line is not None
 
+    plt.rcParams['axes3d.automargin'] = True  # Remove when image is regenerated
     ax.set_xlim(-5, 5)
     ax.set_ylim(-4, 6)
     ax.set_zlim(-2, 2)
@@ -1002,6 +1016,7 @@ def test_add_collection3d_zs_scalar():
 
     assert line is not None
 
+    plt.rcParams['axes3d.automargin'] = True  # Remove when image is regenerated
     ax.set_xlim(-5, 5)
     ax.set_ylim(-4, 6)
     ax.set_zlim(0, 2)
@@ -1027,7 +1042,7 @@ def test_axes3d_labelpad():
 
     # Tick labels also respect tick.pad (also from rcParams)
     for i, tick in enumerate(ax.yaxis.get_major_ticks()):
-        tick.set_pad(tick.get_pad() - i * 5)
+        tick.set_pad(tick.get_pad() + 5 - i * 5)
 
 
 @mpl3d_image_comparison(['axes3d_cla.png'], remove_text=False, style='mpl20')
@@ -1123,6 +1138,7 @@ def test_proj_axes_cube():
     for x, y, t in zip(txs, tys, ts):
         ax.text(x, y, t)
 
+    plt.rcParams['axes3d.automargin'] = True  # Remove when image is regenerated
     ax.set_xlim(-0.2, 0.2)
     ax.set_ylim(-0.2, 0.2)
 
@@ -1152,6 +1168,7 @@ def test_proj_axes_cube_ortho():
     for x, y, t in zip(txs, tys, ts):
         ax.text(x, y, t)
 
+    plt.rcParams['axes3d.automargin'] = True  # Remove when image is regenerated
     ax.set_xlim(-200, 200)
     ax.set_ylim(-200, 200)
 
@@ -1171,6 +1188,7 @@ def test_world():
 def test_autoscale():
     fig, ax = plt.subplots(subplot_kw={"projection": "3d"})
     assert ax.get_zscale() == 'linear'
+    ax._view_margin = 0
     ax.margins(x=0, y=.1, z=.2)
     ax.plot([0, 1], [0, 1], [0, 1])
     assert ax.get_w_lims() == (0, 1, -.1, 1.1, -.2, 1.2)
@@ -1555,6 +1573,7 @@ def test_errorbar3d():
 
 @image_comparison(['stem3d.png'], style='mpl20', tol=0.003)
 def test_stem3d():
+    plt.rcParams['axes3d.automargin'] = True  # Remove when image is regenerated
     fig, axs = plt.subplots(2, 3, figsize=(8, 6),
                             constrained_layout=True,
                             subplot_kw={'projection': '3d'})
@@ -1639,6 +1658,7 @@ def test_colorbar_pos():
 def test_inverted_zaxis():
     fig = plt.figure()
     ax = fig.add_subplot(projection='3d')
+    ax.set_zlim(0, 1)
     assert not ax.zaxis_inverted()
     assert ax.get_zlim() == (0, 1)
     assert ax.get_zbound() == (0, 1)
@@ -1671,17 +1691,17 @@ def test_inverted_zaxis():
 def test_set_zlim():
     fig = plt.figure()
     ax = fig.add_subplot(projection='3d')
-    assert ax.get_zlim() == (0, 1)
+    assert np.allclose(ax.get_zlim(), (-1/48, 49/48))
     ax.set_zlim(zmax=2)
-    assert ax.get_zlim() == (0, 2)
+    assert np.allclose(ax.get_zlim(), (-1/48, 2))
     ax.set_zlim(zmin=1)
     assert ax.get_zlim() == (1, 2)
 
     with pytest.raises(
-            TypeError, match="Cannot pass both 'bottom' and 'zmin'"):
+            TypeError, match="Cannot pass both 'lower' and 'min'"):
         ax.set_zlim(bottom=0, zmin=1)
     with pytest.raises(
-            TypeError, match="Cannot pass both 'top' and 'zmax'"):
+            TypeError, match="Cannot pass both 'upper' and 'max'"):
         ax.set_zlim(top=0, zmax=1)
 
 
@@ -1755,13 +1775,13 @@ def convert_lim(dmin, dmax):
                           ("zoom", MouseButton.LEFT, 'x',  # zoom in
                           ((-0.01, 0.10), (-0.03, 0.08), (-0.06, 0.06))),
                           ("zoom", MouseButton.LEFT, 'y',  # zoom in
-                          ((-0.07, 0.04), (-0.03, 0.08), (0.00, 0.11))),
+                          ((-0.07, 0.05), (-0.04, 0.08), (0.00, 0.12))),
                           ("zoom", MouseButton.RIGHT, None,  # zoom out
-                          ((-0.09, 0.15), (-0.07, 0.17), (-0.06, 0.18))),
+                          ((-0.09, 0.15), (-0.08, 0.17), (-0.07, 0.18))),
                           ("pan", MouseButton.LEFT, None,
-                          ((-0.70, -0.58), (-1.03, -0.91), (-1.27, -1.15))),
+                          ((-0.70, -0.58), (-1.04, -0.91), (-1.27, -1.15))),
                           ("pan", MouseButton.LEFT, 'x',
-                          ((-0.96, -0.84), (-0.58, -0.46), (-0.06, 0.06))),
+                          ((-0.97, -0.84), (-0.58, -0.46), (-0.06, 0.06))),
                           ("pan", MouseButton.LEFT, 'y',
                           ((0.20, 0.32), (-0.51, -0.39), (-1.27, -1.15)))])
 def test_toolbar_zoom_pan(tool, button, key, expected):
@@ -1859,6 +1879,7 @@ def test_subfigure_simple():
 @image_comparison(baseline_images=['computed_zorder'], remove_text=True,
                   extensions=['png'], style=('mpl20'))
 def test_computed_zorder():
+    plt.rcParams['axes3d.automargin'] = True  # Remove when image is regenerated
     fig = plt.figure()
     ax1 = fig.add_subplot(221, projection='3d')
     ax2 = fig.add_subplot(222, projection='3d')
@@ -2063,6 +2084,7 @@ def test_pathpatch_3d(fig_test, fig_ref):
                   remove_text=True,
                   style='mpl20')
 def test_scatter_spiral():
+    plt.rcParams['axes3d.automargin'] = True  # Remove when image is regenerated
     fig = plt.figure()
     ax = fig.add_subplot(projection='3d')
     th = np.linspace(0, 2 * np.pi * 6, 256)
@@ -2260,6 +2282,7 @@ def test_scatter_masked_color():
 
 @mpl3d_image_comparison(['surface3d_zsort_inf.png'], style='mpl20')
 def test_surface3d_zsort_inf():
+    plt.rcParams['axes3d.automargin'] = True  # Remove when image is regenerated
     fig = plt.figure()
     ax = fig.add_subplot(projection='3d')
 

From a84c911fbf96244bca104caed58ca962212c3c88 Mon Sep 17 00:00:00 2001
From: Kritika Verma <95202116+SunSummoner@users.noreply.github.com>
Date: Mon, 28 Aug 2023 07:25:22 +0530
Subject: [PATCH 0071/1120] Resolves #26421 Added an example for fig comparison
 decorator (#26538)

Added an example for figure comparison decorator to testing documentation
---
 doc/devel/testing.rst | 29 ++++++++++++++++++++++++-----
 1 file changed, 24 insertions(+), 5 deletions(-)

diff --git a/doc/devel/testing.rst b/doc/devel/testing.rst
index 06296f5dc701..3b84e4aa859c 100644
--- a/doc/devel/testing.rst
+++ b/doc/devel/testing.rst
@@ -122,6 +122,12 @@ case :file:`lib/matplotlib/tests/baseline_images/test_lines`).  Put this new
 file under source code revision control (with ``git add``).  When rerunning
 the tests, they should now pass.
 
+It is preferred that new tests use ``style='mpl20'`` as this leads to smaller
+figures and reflects the newer look of default Matplotlib plots. Also, if the
+texts (labels, tick labels, etc) are not really part of what is tested, use
+``remove_text=True`` as this will lead to smaller figures and reduce possible
+issues with font mismatch on different platforms.
+
 Baseline images take a lot of space in the Matplotlib repository.
 An alternative approach for image comparison tests is to use the
 `~matplotlib.testing.decorators.check_figures_equal` decorator, which should be
@@ -130,11 +136,24 @@ images on the figures using two different methods (the tested method and the
 baseline method).  The decorator will arrange for setting up the figures and
 then collect the drawn results and compare them.
 
-It is preferred that new tests use ``style='mpl20'`` as this leads to smaller
-figures and reflects the newer look of default Matplotlib plots. Also, if the
-texts (labels, tick labels, etc) are not really part of what is tested, use
-``remove_text=True`` as this will lead to smaller figures and reduce possible
-issues with font mismatch on different platforms.
+For example, this test compares two different methods to draw the same
+circle: plotting a circle using a `matplotlib.patches.Circle` patch
+vs plotting the circle using the parametric equation of a circle ::
+
+   from matplotlib.testing.decorators import check_figures_equal
+   import matplotib.patches as mpatches
+   import matplotlib.pyplot as plt
+   import numpy as np
+
+   @check_figures_equal(extensions=['png'], tol=100)
+   def test_parametric_circle_plot(fig_test, fig_ref):
+       red_circle_ref = mpatches.Circle((0, 0), 0.2, color='r', clip_on=False)
+       fig_ref.add_artist(red_circle_ref)
+       theta = np.linspace(0, 2 * np.pi, 150)
+       radius = 0.4
+       fig_test.plot(radius * np.cos(theta), radius * np.sin(theta), color='r')
+
+Both comparison decorators have a tolerance argument ``tol`` that is used to specify the tolerance for difference in color value between the two images, where 255 is the maximal difference. The test fails if the average pixel difference is greater than this value.
 
 See the documentation of `~matplotlib.testing.decorators.image_comparison` and
 `~matplotlib.testing.decorators.check_figures_equal` for additional information

From bd0da748bd376015bdf5c6296a4fa6d0d08080fd Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Mon, 28 Aug 2023 12:12:09 +0200
Subject: [PATCH 0072/1120] Properly disconnect machinery when removing child
 axes.

---
 lib/matplotlib/axes/_base.py      |  3 ++-
 lib/matplotlib/figure.py          | 18 ++++++++++++++++--
 lib/matplotlib/tests/test_axes.py |  8 ++++++++
 3 files changed, 26 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index 3796d9bbe508..740c59bd85df 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -2237,7 +2237,8 @@ def add_child_axes(self, ax):
         ax.stale_callback = martist._stale_axes_callback
 
         self.child_axes.append(ax)
-        ax._remove_method = self.child_axes.remove
+        ax._remove_method = functools.partial(
+            self.figure._remove_axes, owners=[self.child_axes])
         self.stale = True
         return ax
 
diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
index ce263c3d8d1c..4361ef655c81 100644
--- a/lib/matplotlib/figure.py
+++ b/lib/matplotlib/figure.py
@@ -936,11 +936,25 @@ def delaxes(self, ax):
         """
         Remove the `~.axes.Axes` *ax* from the figure; update the current Axes.
         """
+        self._remove_axes(ax, owners=[self._axstack, self._localaxes])
+
+    def _remove_axes(self, ax, owners):
+        """
+        Common helper for removal of standard axes (via delaxes) and of child axes.
+
+        Parameters
+        ----------
+        ax : `~.AxesBase`
+            The Axes to remove.
+        owners
+            List of objects (list or _AxesStack) "owning" the axes, from which the Axes
+            will be remove()d.
+        """
+        for owner in owners:
+            owner.remove(ax)
 
-        self._axstack.remove(ax)
         self._axobservers.process("_axes_change_event", self)
         self.stale = True
-        self._localaxes.remove(ax)
         self.canvas.release_mouse(ax)
 
         for name in ax._axis_names:  # Break link between any shared axes
diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index 0fcb2eb26cbb..c78be0ee9cbe 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -8679,6 +8679,14 @@ def test_cla_clears_children_axes_and_fig():
         assert art.figure is None
 
 
+def test_child_axes_removal():
+    fig, ax = plt.subplots()
+    marginal = ax.inset_axes([1, 0, .1, 1], sharey=ax)
+    marginal_twin = marginal.twinx()
+    marginal.remove()
+    ax.set(xlim=(-1, 1), ylim=(10, 20))
+
+
 def test_scatter_color_repr_error():
 
     def get_next_color():

From bd33e37006f2059b3bd59035c01f637f93b4226f Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Tue, 29 Aug 2023 14:16:38 +0200
Subject: [PATCH 0073/1120] [Doc] Improve DSP-related examples

---
 .../specgram_demo.py                          | 22 +++++++-----
 .../examples/lines_bars_and_markers/cohere.py |  7 ++--
 .../lines_bars_and_markers/csd_demo.py        | 15 ++++----
 .../lines_bars_and_markers/psd_demo.py        | 16 +++++----
 .../lines_bars_and_markers/spectrum_demo.py   | 34 +++++++++----------
 .../xcorr_acorr_demo.py                       |  8 +++--
 6 files changed, 55 insertions(+), 47 deletions(-)

diff --git a/galleries/examples/images_contours_and_fields/specgram_demo.py b/galleries/examples/images_contours_and_fields/specgram_demo.py
index ef1799c4429f..5add9172cf2a 100644
--- a/galleries/examples/images_contours_and_fields/specgram_demo.py
+++ b/galleries/examples/images_contours_and_fields/specgram_demo.py
@@ -1,9 +1,9 @@
 """
-================
-Spectrogram Demo
-================
+===========
+Spectrogram
+===========
 
-Demo of a spectrogram plot (`~.axes.Axes.specgram`).
+Plotting a spectrogram using `~.Axes.specgram`.
 """
 import matplotlib.pyplot as plt
 import numpy as np
@@ -12,7 +12,7 @@
 np.random.seed(19680801)
 
 dt = 0.0005
-t = np.arange(0.0, 20.0, dt)
+t = np.arange(0.0, 20.5, dt)
 s1 = np.sin(2 * np.pi * 100 * t)
 s2 = 2 * np.sin(2 * np.pi * 400 * t)
 
@@ -24,16 +24,22 @@
 
 x = s1 + s2 + nse  # the signal
 NFFT = 1024  # the length of the windowing segments
-Fs = int(1.0 / dt)  # the sampling frequency
+Fs = 1/dt  # the sampling frequency
 
-fig, (ax1, ax2) = plt.subplots(nrows=2)
+fig, (ax1, ax2) = plt.subplots(nrows=2, sharex=True)
 ax1.plot(t, x)
-Pxx, freqs, bins, im = ax2.specgram(x, NFFT=NFFT, Fs=Fs, noverlap=900)
+ax1.set_ylabel('Signal')
+
+Pxx, freqs, bins, im = ax2.specgram(x, NFFT=NFFT, Fs=Fs)
 # The `specgram` method returns 4 objects. They are:
 # - Pxx: the periodogram
 # - freqs: the frequency vector
 # - bins: the centers of the time bins
 # - im: the .image.AxesImage instance representing the data in the plot
+ax2.set_xlabel('Time (s)')
+ax2.set_ylabel('Frequency (Hz)')
+ax2.set_xlim(0, 20)
+
 plt.show()
 
 # %%
diff --git a/galleries/examples/lines_bars_and_markers/cohere.py b/galleries/examples/lines_bars_and_markers/cohere.py
index cd6a11566afa..64124e37645e 100644
--- a/galleries/examples/lines_bars_and_markers/cohere.py
+++ b/galleries/examples/lines_bars_and_markers/cohere.py
@@ -3,7 +3,7 @@
 Plotting the coherence of two signals
 =====================================
 
-An example showing how to plot the coherence of two signals.
+An example showing how to plot the coherence of two signals using `~.Axes.cohere`.
 """
 import matplotlib.pyplot as plt
 import numpy as np
@@ -20,15 +20,14 @@
 s1 = np.sin(2 * np.pi * 10 * t) + nse1
 s2 = np.sin(2 * np.pi * 10 * t) + nse2
 
-fig, axs = plt.subplots(2, 1)
+fig, axs = plt.subplots(2, 1, layout='constrained')
 axs[0].plot(t, s1, t, s2)
 axs[0].set_xlim(0, 2)
-axs[0].set_xlabel('Time')
+axs[0].set_xlabel('Time (s)')
 axs[0].set_ylabel('s1 and s2')
 axs[0].grid(True)
 
 cxy, f = axs[1].cohere(s1, s2, 256, 1. / dt)
 axs[1].set_ylabel('Coherence')
 
-fig.tight_layout()
 plt.show()
diff --git a/galleries/examples/lines_bars_and_markers/csd_demo.py b/galleries/examples/lines_bars_and_markers/csd_demo.py
index 8bba858df574..b2d903ae0885 100644
--- a/galleries/examples/lines_bars_and_markers/csd_demo.py
+++ b/galleries/examples/lines_bars_and_markers/csd_demo.py
@@ -1,16 +1,14 @@
 """
-========
-CSD Demo
-========
+============================
+Cross spectral density (CSD)
+============================
 
-Compute the cross spectral density of two signals
+Plot the cross spectral density (CSD) of two signals using `~.Axes.csd`.
 """
 import matplotlib.pyplot as plt
 import numpy as np
 
-fig, (ax1, ax2) = plt.subplots(2, 1)
-# make a little extra space between the subplots
-fig.subplots_adjust(hspace=0.5)
+fig, (ax1, ax2) = plt.subplots(2, 1, layout='constrained')
 
 dt = 0.01
 t = np.arange(0, 30, dt)
@@ -32,10 +30,11 @@
 
 ax1.plot(t, s1, t, s2)
 ax1.set_xlim(0, 5)
-ax1.set_xlabel('Time')
+ax1.set_xlabel('Time (s)')
 ax1.set_ylabel('s1 and s2')
 ax1.grid(True)
 
 cxy, f = ax2.csd(s1, s2, 256, 1. / dt)
 ax2.set_ylabel('CSD (dB)')
+
 plt.show()
diff --git a/galleries/examples/lines_bars_and_markers/psd_demo.py b/galleries/examples/lines_bars_and_markers/psd_demo.py
index 0d2bc7df0906..52587fd6d7bf 100644
--- a/galleries/examples/lines_bars_and_markers/psd_demo.py
+++ b/galleries/examples/lines_bars_and_markers/psd_demo.py
@@ -1,9 +1,9 @@
 """
-========
-Psd Demo
-========
+============================
+Power spectral density (PSD)
+============================
 
-Plotting Power Spectral Density (PSD) in Matplotlib.
+Plotting power spectral density (PSD) using `~.Axes.psd`.
 
 The PSD is a common plot in the field of signal processing. NumPy has
 many useful libraries for computing a PSD. Below we demo a few examples
@@ -26,8 +26,10 @@
 cnse = cnse[:len(t)]
 s = 0.1 * np.sin(2 * np.pi * t) + cnse
 
-fig, (ax0, ax1) = plt.subplots(2, 1)
+fig, (ax0, ax1) = plt.subplots(2, 1, layout='constrained')
 ax0.plot(t, s)
+ax0.set_xlabel('Time (s)')
+ax0.set_ylabel('Signal')
 ax1.psd(s, 512, 1 / dt)
 
 plt.show()
@@ -64,8 +66,8 @@
 ], layout='constrained')
 
 axs['signal'].plot(t, y)
-axs['signal'].set_xlabel('time [s]')
-axs['signal'].set_ylabel('signal')
+axs['signal'].set_xlabel('Time (s)')
+axs['signal'].set_ylabel('Signal')
 
 # Plot the PSD with different amounts of zero padding. This uses the entire
 # time series at once
diff --git a/galleries/examples/lines_bars_and_markers/spectrum_demo.py b/galleries/examples/lines_bars_and_markers/spectrum_demo.py
index 6f9ba3e1d7d0..147d802b6eff 100644
--- a/galleries/examples/lines_bars_and_markers/spectrum_demo.py
+++ b/galleries/examples/lines_bars_and_markers/spectrum_demo.py
@@ -1,6 +1,6 @@
 """
 ========================
-Spectrum Representations
+Spectrum representations
 ========================
 
 The plots show different spectrum representations of a sine signal with
@@ -24,28 +24,28 @@
 
 s = 0.1 * np.sin(4 * np.pi * t) + cnse  # the signal
 
-fig, axs = plt.subplots(nrows=3, ncols=2, figsize=(7, 7))
+fig = plt.figure(figsize=(7, 7), layout='constrained')
+axs = fig.subplot_mosaic([["signal", "signal"],
+                          ["magnitude", "log_magnitude"],
+                          ["phase", "angle"]])
 
 # plot time signal:
-axs[0, 0].set_title("Signal")
-axs[0, 0].plot(t, s, color='C0')
-axs[0, 0].set_xlabel("Time")
-axs[0, 0].set_ylabel("Amplitude")
+axs["signal"].set_title("Signal")
+axs["signal"].plot(t, s, color='C0')
+axs["signal"].set_xlabel("Time (s)")
+axs["signal"].set_ylabel("Amplitude")
 
 # plot different spectrum types:
-axs[1, 0].set_title("Magnitude Spectrum")
-axs[1, 0].magnitude_spectrum(s, Fs=Fs, color='C1')
+axs["magnitude"].set_title("Magnitude Spectrum")
+axs["magnitude"].magnitude_spectrum(s, Fs=Fs, color='C1')
 
-axs[1, 1].set_title("Log. Magnitude Spectrum")
-axs[1, 1].magnitude_spectrum(s, Fs=Fs, scale='dB', color='C1')
+axs["log_magnitude"].set_title("Log. Magnitude Spectrum")
+axs["log_magnitude"].magnitude_spectrum(s, Fs=Fs, scale='dB', color='C1')
 
-axs[2, 0].set_title("Phase Spectrum ")
-axs[2, 0].phase_spectrum(s, Fs=Fs, color='C2')
+axs["phase"].set_title("Phase Spectrum ")
+axs["phase"].phase_spectrum(s, Fs=Fs, color='C2')
 
-axs[2, 1].set_title("Angle Spectrum")
-axs[2, 1].angle_spectrum(s, Fs=Fs, color='C2')
+axs["angle"].set_title("Angle Spectrum")
+axs["angle"].angle_spectrum(s, Fs=Fs, color='C2')
 
-axs[0, 1].remove()  # don't display empty ax
-
-fig.tight_layout()
 plt.show()
diff --git a/galleries/examples/lines_bars_and_markers/xcorr_acorr_demo.py b/galleries/examples/lines_bars_and_markers/xcorr_acorr_demo.py
index 6789f65bf6d6..eff0d7269a49 100644
--- a/galleries/examples/lines_bars_and_markers/xcorr_acorr_demo.py
+++ b/galleries/examples/lines_bars_and_markers/xcorr_acorr_demo.py
@@ -1,7 +1,7 @@
 """
-================================
-Cross- and Auto-Correlation Demo
-================================
+===========================
+Cross- and auto-correlation
+===========================
 
 Example use of cross-correlation (`~.Axes.xcorr`) and auto-correlation
 (`~.Axes.acorr`) plots.
@@ -17,9 +17,11 @@
 fig, [ax1, ax2] = plt.subplots(2, 1, sharex=True)
 ax1.xcorr(x, y, usevlines=True, maxlags=50, normed=True, lw=2)
 ax1.grid(True)
+ax1.set_title('Cross-correlation (xcorr)')
 
 ax2.acorr(x, usevlines=True, normed=True, maxlags=50, lw=2)
 ax2.grid(True)
+ax2.set_title('Auto-correlation (acorr)')
 
 plt.show()
 

From a2adf8b43c39fcead2f20835c93a1461e60946d8 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Tue, 29 Aug 2023 02:18:19 +0200
Subject: [PATCH 0074/1120] [DOC] Clarify some tick-related docstrings

Apply suggestions from code review

Co-authored-by: hannah <story645@gmail.com>
---
 lib/matplotlib/axes/_base.py | 65 +++++++++++++++++++++---------------
 lib/matplotlib/axis.py       | 11 ++++--
 2 files changed, 47 insertions(+), 29 deletions(-)

diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index 9c1dc99107e7..e000eab92d62 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -2019,26 +2019,30 @@ def axis(self, arg=None, /, *, emit=True, **kwargs):
             If a bool, turns axis lines and labels on or off. If a string,
             possible values are:
 
-            ======== ==========================================================
-            Value    Description
-            ======== ==========================================================
-            'on'     Turn on axis lines and labels. Same as ``True``.
-            'off'    Turn off axis lines and labels. Same as ``False``.
-            'equal'  Set equal scaling (i.e., make circles circular) by
-                     changing axis limits. This is the same as
-                     ``ax.set_aspect('equal', adjustable='datalim')``.
-                     Explicit data limits may not be respected in this case.
-            'scaled' Set equal scaling (i.e., make circles circular) by
-                     changing dimensions of the plot box. This is the same as
-                     ``ax.set_aspect('equal', adjustable='box', anchor='C')``.
-                     Additionally, further autoscaling will be disabled.
-            'tight'  Set limits just large enough to show all data, then
-                     disable further autoscaling.
-            'auto'   Automatic scaling (fill plot box with data).
-            'image'  'scaled' with axis limits equal to data limits.
-            'square' Square plot; similar to 'scaled', but initially forcing
-                     ``xmax-xmin == ymax-ymin``.
-            ======== ==========================================================
+            ================ ===========================================================
+            Value            Description
+            ================ ===========================================================
+            'off' or `False` Hide all axis decorations, i.e. axis labels, spines,
+                             tick marks, tick labels, and grid lines.
+                             This is the same as `~.Axes.set_axis_off()`.
+            'on' or `True`   Do not hide all axis decorations, i.e. axis labels, spines,
+                             tick marks, tick labels, and grid lines.
+                             This is the same as `~.Axes.set_axis_on()`.
+            'equal'          Set equal scaling (i.e., make circles circular) by
+                             changing the axis limits. This is the same as
+                             ``ax.set_aspect('equal', adjustable='datalim')``.
+                             Explicit data limits may not be respected in this case.
+            'scaled'         Set equal scaling (i.e., make circles circular) by
+                             changing dimensions of the plot box. This is the same as
+                             ``ax.set_aspect('equal', adjustable='box', anchor='C')``.
+                             Additionally, further autoscaling will be disabled.
+            'tight'          Set limits just large enough to show all data, then
+                             disable further autoscaling.
+            'auto'           Automatic scaling (fill plot box with data).
+            'image'          'scaled' with axis limits equal to data limits.
+            'square'         Square plot; similar to 'scaled', but initially forcing
+                             ``xmax-xmin == ymax-ymin``.
+            ================ ===========================================================
 
         emit : bool, default: True
             Whether observers are notified of the axis limit change.
@@ -3423,18 +3427,25 @@ def tick_params(self, axis='both', **kwargs):
 
     def set_axis_off(self):
         """
-        Turn the x- and y-axis off.
+        Hide all visual components of the x- and y-axis.
 
-        This affects the axis lines, ticks, ticklabels, grid and axis labels.
+        This sets a flag to suppress drawing of all axis decorations, i.e.
+        axis labels, axis spines, and the axis tick component (tick markers,
+        tick labels, and grid lines). Individual visibility settings of these
+        components are ignored as long as `set_axis_off()` is in effect.
         """
         self.axison = False
         self.stale = True
 
     def set_axis_on(self):
         """
-        Turn the x- and y-axis on.
+        Do not hide all visual components of the x- and y-axis.
 
-        This affects the axis lines, ticks, ticklabels, grid and axis labels.
+        This reverts the effect of a prior `.set_axis_off()` call. Whether the
+        individual axis decorations are drawn is controlled by their respective
+        visibility settings.
+
+        This is on by default.
         """
         self.axison = True
         self.stale = True
@@ -3681,7 +3692,8 @@ def set_xlim(self, left=None, right=None, *, emit=True, auto=False,
     get_xscale = _axis_method_wrapper("xaxis", "get_scale")
     set_xscale = _axis_method_wrapper("xaxis", "_set_axes_scale")
     get_xticks = _axis_method_wrapper("xaxis", "get_ticklocs")
-    set_xticks = _axis_method_wrapper("xaxis", "set_ticks")
+    set_xticks = _axis_method_wrapper("xaxis", "set_ticks",
+                                      doc_sub={'set_ticks': 'set_xticks'})
     get_xmajorticklabels = _axis_method_wrapper("xaxis", "get_majorticklabels")
     get_xminorticklabels = _axis_method_wrapper("xaxis", "get_minorticklabels")
     get_xticklabels = _axis_method_wrapper("xaxis", "get_ticklabels")
@@ -3912,7 +3924,8 @@ def set_ylim(self, bottom=None, top=None, *, emit=True, auto=False,
     get_yscale = _axis_method_wrapper("yaxis", "get_scale")
     set_yscale = _axis_method_wrapper("yaxis", "_set_axes_scale")
     get_yticks = _axis_method_wrapper("yaxis", "get_ticklocs")
-    set_yticks = _axis_method_wrapper("yaxis", "set_ticks")
+    set_yticks = _axis_method_wrapper("yaxis", "set_ticks",
+                                      doc_sub={'set_ticks': 'set_yticks'})
     get_ymajorticklabels = _axis_method_wrapper("yaxis", "get_majorticklabels")
     get_yminorticklabels = _axis_method_wrapper("yaxis", "get_minorticklabels")
     get_yticklabels = _axis_method_wrapper("yaxis", "get_ticklabels")
diff --git a/lib/matplotlib/axis.py b/lib/matplotlib/axis.py
index 77bd34df69c5..56d4e6b77dc6 100644
--- a/lib/matplotlib/axis.py
+++ b/lib/matplotlib/axis.py
@@ -2090,7 +2090,7 @@ def _set_tick_locations(self, ticks, *, minor=False):
 
     def set_ticks(self, ticks, labels=None, *, minor=False, **kwargs):
         """
-        Set this Axis' tick locations and optionally labels.
+        Set this Axis' tick locations and optionally tick labels.
 
         If necessary, the view limits of the Axis are expanded so that all
         given ticks are visible.
@@ -2103,14 +2103,19 @@ def set_ticks(self, ticks, labels=None, *, minor=False, **kwargs):
 
             The values may be either floats or in axis units.
 
+            Pass an empty list to remove all ticks::
+
+                set_ticks([])
+
             Some tick formatters will not label arbitrary tick positions;
             e.g. log formatters only label decade ticks by default. In
             such a case you can set a formatter explicitly on the axis
             using `.Axis.set_major_formatter` or provide formatted
             *labels* yourself.
         labels : list of str, optional
-            List of tick labels. If not set, the labels are generated with
-            the axis tick `.Formatter`.
+            Tick labels for each location in *ticks*. *labels* must be of the same
+            length as *ticks*. If not set, the labels are generate using the axis
+            tick `.Formatter`.
         minor : bool, default: False
             If ``False``, set the major ticks; if ``True``, the minor ticks.
         **kwargs

From a4b81b10d181e11d734f88e2e308d897e77c37ce Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Wed, 30 Aug 2023 09:23:47 +0200
Subject: [PATCH 0075/1120] [Doc] Shorten documentation links

---
 lib/matplotlib/widgets.py | 44 +++++++++++++++++++--------------------
 1 file changed, 21 insertions(+), 23 deletions(-)

diff --git a/lib/matplotlib/widgets.py b/lib/matplotlib/widgets.py
index b0d026e3095b..0a31a9dd2529 100644
--- a/lib/matplotlib/widgets.py
+++ b/lib/matplotlib/widgets.py
@@ -3,7 +3,7 @@
 ===================
 
 Widgets that are designed to work for any of the GUI backends.
-All of these widgets require you to predefine a `matplotlib.axes.Axes`
+All of these widgets require you to predefine an `~.axes.Axes`
 instance and pass that as the first parameter.  Matplotlib doesn't try to
 be too smart with respect to layout -- you will have to figure out how
 wide and tall you want your Axes to be to accommodate your widget.
@@ -170,9 +170,9 @@ class Button(AxesWidget):
     Attributes
     ----------
     ax
-        The `matplotlib.axes.Axes` the button renders into.
+        The `~.axes.Axes` the button renders into.
     label
-        A `matplotlib.text.Text` instance.
+        A `.Text` instance.
     color
         The color of the button when not hovering.
     hovercolor
@@ -190,7 +190,7 @@ def __init__(self, ax, label, image=None,
             The button text.
         image : array-like or PIL Image
             The image to place in the button, if not *None*.  The parameter is
-            directly forwarded to `~matplotlib.axes.Axes.imshow`.
+            directly forwarded to `~.axes.Axes.imshow`.
         color : color
             The color of the button when not activated.
         hovercolor : color
@@ -1007,9 +1007,9 @@ class CheckButtons(AxesWidget):
     ax : `~matplotlib.axes.Axes`
         The parent Axes for the widget.
 
-    labels : list of `.Text`
+    labels : list of `~matplotlib.text.Text`
 
-    rectangles : list of `.Rectangle`
+    rectangles : list of `~matplotlib.patches.Rectangle`
 
     lines : list of (`.Line2D`, `.Line2D`) pairs
         List of lines for the x's in the checkboxes.  These lines exist for
@@ -1019,7 +1019,7 @@ class CheckButtons(AxesWidget):
     def __init__(self, ax, labels, actives=None, *, useblit=True,
                  label_props=None, frame_props=None, check_props=None):
         """
-        Add check buttons to `matplotlib.axes.Axes` instance *ax*.
+        Add check buttons to `~.axes.Axes` instance *ax*.
 
         Parameters
         ----------
@@ -1876,16 +1876,16 @@ def circles(self):
 
 class SubplotTool(Widget):
     """
-    A tool to adjust the subplot params of a `matplotlib.figure.Figure`.
+    A tool to adjust the subplot params of a `.Figure`.
     """
 
     def __init__(self, targetfig, toolfig):
         """
         Parameters
         ----------
-        targetfig : `.Figure`
+        targetfig : `~matplotlib.figure.Figure`
             The figure instance to adjust.
-        toolfig : `.Figure`
+        toolfig : `~matplotlib.figure.Figure`
             The figure instance to embed the subplot tool into.
         """
 
@@ -2051,7 +2051,7 @@ class MultiCursor(Widget):
     canvas : object
         This parameter is entirely unused and only kept for back-compatibility.
 
-    axes : list of `matplotlib.axes.Axes`
+    axes : list of `~matplotlib.axes.Axes`
         The `~.axes.Axes` to attach the cursor to.
 
     useblit : bool, default: True
@@ -2564,7 +2564,7 @@ class SpanSelector(_SelectorWidget):
         canvas updates. See the tutorial :ref:`blitting` for details.
 
     props : dict, default: {'facecolor': 'red', 'alpha': 0.5}
-        Dictionary of `matplotlib.patches.Patch` properties.
+        Dictionary of `.Patch` properties.
 
     onmove_callback : callable with signature ``func(min: float, max: float)``, optional
         Called on mouse move while the span is being selected.
@@ -2578,8 +2578,7 @@ class SpanSelector(_SelectorWidget):
 
     handle_props : dict, default: None
         Properties of the handle lines at the edges of the span. Only used
-        when *interactive* is True. See `matplotlib.lines.Line2D` for valid
-        properties.
+        when *interactive* is True. See `.Line2D` for valid properties.
 
     grab_range : float, default: 10
         Distance in pixels within which the interactive tool handles can be activated.
@@ -2951,7 +2950,7 @@ class ToolLineHandles:
     direction : {"horizontal", "vertical"}
         Direction of handles, either 'vertical' or 'horizontal'
     line_props : dict, optional
-        Additional line properties. See `matplotlib.lines.Line2D`.
+        Additional line properties. See `.Line2D`.
     useblit : bool, default: True
         Whether to use blitting for faster drawing (if supported by the
         backend). See the tutorial :ref:`blitting`
@@ -3060,9 +3059,9 @@ class ToolHandles:
     x, y : 1D arrays
         Coordinates of control handles.
     marker : str, default: 'o'
-        Shape of marker used to display handle. See `matplotlib.pyplot.plot`.
+        Shape of marker used to display handle. See `~.pyplot.plot`.
     marker_props : dict, optional
-        Additional marker properties. See `matplotlib.lines.Line2D`.
+        Additional marker properties. See `.Line2D`.
     useblit : bool, default: True
         Whether to use blitting for faster drawing (if supported by the
         backend). See the tutorial :ref:`blitting`
@@ -3147,7 +3146,7 @@ def onselect(eclick: MouseEvent, erelease: MouseEvent)
 
     props : dict, optional
         Properties with which the __ARTIST_NAME__ is drawn. See
-        `matplotlib.patches.Patch` for valid properties.
+        `.Patch` for valid properties.
         Default:
 
         ``dict(facecolor='red', edgecolor='black', alpha=0.2, fill=True)``
@@ -3165,7 +3164,7 @@ def onselect(eclick: MouseEvent, erelease: MouseEvent)
 
     handle_props : dict, optional
         Properties with which the interactive handles (marker artists) are
-        drawn. See the marker arguments in `matplotlib.lines.Line2D` for valid
+        drawn. See the marker arguments in `.Line2D` for valid
         properties.  Default values are defined in ``mpl.rcParams`` except for
         the default value of ``markeredgecolor`` which will be the same as the
         ``edgecolor`` property in *props*.
@@ -3765,7 +3764,7 @@ def onselect(verts):
         backend). See the tutorial :ref:`blitting`
         for details.
     props : dict, optional
-        Properties with which the line is drawn, see `matplotlib.lines.Line2D`
+        Properties with which the line is drawn, see `.Line2D`
         for valid properties. Default values are defined in ``mpl.rcParams``.
     button : `.MouseButton` or list of `.MouseButton`, optional
         The mouse buttons used for rectangle selection.  Default is ``None``,
@@ -3842,15 +3841,14 @@ class PolygonSelector(_SelectorWidget):
         for details.
 
     props : dict, optional
-        Properties with which the line is drawn, see `matplotlib.lines.Line2D`
-        for valid properties.
+        Properties with which the line is drawn, see `.Line2D` for valid properties.
         Default::
 
             dict(color='k', linestyle='-', linewidth=2, alpha=0.5)
 
     handle_props : dict, optional
         Artist properties for the markers drawn at the vertices of the polygon.
-        See the marker arguments in `matplotlib.lines.Line2D` for valid
+        See the marker arguments in `.Line2D` for valid
         properties.  Default values are defined in ``mpl.rcParams`` except for
         the default value of ``markeredgecolor`` which will be the same as the
         ``color`` property in *props*.

From d598ecbc454a154c57ed767b9328c67b04489feb Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 18 Aug 2023 01:18:10 -0400
Subject: [PATCH 0076/1120] TST: Ensure test_webagg subprocess is terminated

If the final communication times out or asserts, there is nothing to
enforce that the subprocess is killed.
---
 .../tests/test_backends_interactive.py        | 37 ++++++++++---------
 1 file changed, 20 insertions(+), 17 deletions(-)

diff --git a/lib/matplotlib/tests/test_backends_interactive.py b/lib/matplotlib/tests/test_backends_interactive.py
index 7341ebd3277a..dbc0f0928b74 100644
--- a/lib/matplotlib/tests/test_backends_interactive.py
+++ b/lib/matplotlib/tests/test_backends_interactive.py
@@ -477,24 +477,27 @@ def test_webagg():
          inspect.getsource(_test_interactive_impl)
          + "\n_test_interactive_impl()", "{}"],
         env={**os.environ, "MPLBACKEND": "webagg", "SOURCE_DATE_EPOCH": "0"})
-    url = "http://{}:{}".format(
-        mpl.rcParams["webagg.address"], mpl.rcParams["webagg.port"])
+    url = f'http://{mpl.rcParams["webagg.address"]}:{mpl.rcParams["webagg.port"]}'
     timeout = time.perf_counter() + _test_timeout
-    while True:
-        try:
-            retcode = proc.poll()
-            # check that the subprocess for the server is not dead
-            assert retcode is None
-            conn = urllib.request.urlopen(url)
-            break
-        except urllib.error.URLError:
-            if time.perf_counter() > timeout:
-                pytest.fail("Failed to connect to the webagg server.")
-            else:
-                continue
-    conn.close()
-    proc.send_signal(signal.SIGINT)
-    assert proc.wait(timeout=_test_timeout) == 0
+    try:
+        while True:
+            try:
+                retcode = proc.poll()
+                # check that the subprocess for the server is not dead
+                assert retcode is None
+                conn = urllib.request.urlopen(url)
+                break
+            except urllib.error.URLError:
+                if time.perf_counter() > timeout:
+                    pytest.fail("Failed to connect to the webagg server.")
+                else:
+                    continue
+        conn.close()
+        proc.send_signal(signal.SIGINT)
+        assert proc.wait(timeout=_test_timeout) == 0
+    finally:
+        if proc.poll() is None:
+            proc.kill()
 
 
 def _lazy_headless():

From 23d101a28e00e21723b7718a4fce99a727dff2d9 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Wed, 30 Aug 2023 12:05:01 +0200
Subject: [PATCH 0077/1120] Do not configure axes properties via subplots(...,
 subplot_kw={...})

While technical possible, this is an anti-pattern IMHO.
We should keep Axes creation and customization separate.

Extracted from #14411.
---
 .../examples/shapes_and_collections/ellipse_demo.py | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/galleries/examples/shapes_and_collections/ellipse_demo.py b/galleries/examples/shapes_and_collections/ellipse_demo.py
index 22de6998418d..0d7e72a1100d 100644
--- a/galleries/examples/shapes_and_collections/ellipse_demo.py
+++ b/galleries/examples/shapes_and_collections/ellipse_demo.py
@@ -22,16 +22,15 @@
                 angle=np.random.rand() * 360)
         for i in range(NUM)]
 
-fig, ax = plt.subplots(subplot_kw={'aspect': 'equal'})
+fig, ax = plt.subplots()
+ax.set(xlim=(0, 10), ylim=(0, 10), aspect="equal")
+
 for e in ells:
     ax.add_artist(e)
     e.set_clip_box(ax.bbox)
     e.set_alpha(np.random.rand())
     e.set_facecolor(np.random.rand(3))
 
-ax.set_xlim(0, 10)
-ax.set_ylim(0, 10)
-
 plt.show()
 
 # %%
@@ -45,15 +44,13 @@
 angle_step = 45  # degrees
 angles = np.arange(0, 180, angle_step)
 
-fig, ax = plt.subplots(subplot_kw={'aspect': 'equal'})
+fig, ax = plt.subplots()
+ax.set(xlim=(-2.2, 2.2), ylim=(-2.2, 2.2), aspect="equal")
 
 for angle in angles:
     ellipse = Ellipse((0, 0), 4, 2, angle=angle, alpha=0.1)
     ax.add_artist(ellipse)
 
-ax.set_xlim(-2.2, 2.2)
-ax.set_ylim(-2.2, 2.2)
-
 plt.show()
 
 # %%

From 8e88d1baebb6ccd75755ff82c6e8bf34499f9dcd Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Wed, 30 Aug 2023 12:25:55 +0200
Subject: [PATCH 0078/1120] [Doc] Improve set_layout_engine docs

---
 lib/matplotlib/figure.py | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
index 4361ef655c81..8f80658f8708 100644
--- a/lib/matplotlib/figure.py
+++ b/lib/matplotlib/figure.py
@@ -2475,7 +2475,7 @@ def __init__(self,
 
             - 'tight': Use the tight layout mechanism. This is a relatively
               simple algorithm that adjusts the subplot parameters so that
-              decorations do not overlap. See `.Figure.set_tight_layout` for
+              decorations do not overlap. See `.set_tight_layout` for
               further details.
 
             - 'none': Do not use a layout engine.
@@ -2618,8 +2618,7 @@ def set_layout_engine(self, layout=None, **kwargs):
 
         Parameters
         ----------
-        layout: {'constrained', 'compressed', 'tight', 'none'} or \
-`LayoutEngine` or None
+        layout : {'constrained', 'compressed', 'tight', 'none', `.LayoutEngine`, None}
 
             - 'constrained' will use `~.ConstrainedLayoutEngine`
             - 'compressed' will also use `~.ConstrainedLayoutEngine`, but with
@@ -2628,6 +2627,8 @@ def set_layout_engine(self, layout=None, **kwargs):
             - 'tight' uses `~.TightLayoutEngine`
             - 'none' removes layout engine.
 
+            If a `.LayoutEngine` instance, that instance will be used.
+
             If `None`, the behavior is controlled by :rc:`figure.autolayout`
             (which if `True` behaves as if 'tight' was passed) and
             :rc:`figure.constrained_layout.use` (which if `True` behaves as if
@@ -2637,7 +2638,7 @@ def set_layout_engine(self, layout=None, **kwargs):
             Users and libraries can define their own layout engines and pass
             the instance directly as well.
 
-        kwargs: dict
+        **kwargs
             The keyword arguments are passed to the layout engine to set things
             like padding and margin sizes.  Only used if *layout* is a string.
 

From 319bb03de1f686b31e7131749bc0f600d0494b02 Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Wed, 30 Aug 2023 13:17:23 +0200
Subject: [PATCH 0079/1120] [Doc] Add ACCEPTS for some Axes set methods

---
 lib/matplotlib/axes/_base.py | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index e000eab92d62..d5114d595ad5 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -1554,10 +1554,12 @@ def set_prop_cycle(self, *args, **kwargs):
 
         Parameters
         ----------
-        cycler : Cycler
+        cycler : `~cycler.Cycler`
             Set the given Cycler. *None* resets to the cycle defined by the
             current style.
 
+            .. ACCEPTS: `~cycler.Cycler`
+
         label : str
             The property key. Must be a valid `.Artist` property.
             For example, 'color' or 'linestyle'. Aliases are allowed,
@@ -3553,6 +3555,8 @@ def set_xbound(self, lower=None, upper=None):
             The lower and upper bounds. If *None*, the respective axis bound
             is not modified.
 
+            .. ACCEPTS: (lower: float, upper: float)
+
         See Also
         --------
         get_xbound
@@ -3626,7 +3630,7 @@ def set_xlim(self, left=None, right=None, *, emit=True, auto=False,
             (*left*, *right*) as the first positional argument (or as
             the *left* keyword argument).
 
-            .. ACCEPTS: (bottom: float, top: float)
+            .. ACCEPTS: (left: float, right: float)
 
         right : float, optional
             The right xlim in data coordinates. Passing *None* leaves the
@@ -3802,6 +3806,8 @@ def set_ybound(self, lower=None, upper=None):
             The lower and upper bounds. If *None*, the respective axis bound
             is not modified.
 
+         .. ACCEPTS: (lower: float, upper: float)
+
         See Also
         --------
         get_ybound

From afce3038565af3947e9965533345f7e5a3380155 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Wed, 30 Aug 2023 13:28:03 +0200
Subject: [PATCH 0080/1120] Update lib/matplotlib/pyplot.py

---
 lib/matplotlib/pyplot.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index c804adc93cf6..04fdcbc744c9 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -1134,7 +1134,7 @@ def figlegend(*args, **kwargs) -> Legend:
 
 @_docstring.dedent_interpd
 def axes(
-    arg: None | tuple(float, float, float, float) = None,
+    arg: None | tuple[float, float, float, float] = None,
     **kwargs
 ) -> matplotlib.axes.Axes:
     """

From 9ee4377df3a30a07636792cc37777e9e3e64a9c2 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Thu, 24 Aug 2023 21:38:44 -0500
Subject: [PATCH 0081/1120] Squeeze post-converted values when validating
 limits

Closes #26596

Ensures that ndarrays can be passed to  later on. In this particular case, we know that we expect a single value.
---
 lib/matplotlib/axes/_base.py          |  2 ++
 lib/matplotlib/tests/test_category.py | 12 ++++++++++++
 2 files changed, 14 insertions(+)

diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index 3796d9bbe508..cbc7cc0adf41 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -3562,6 +3562,8 @@ def _validate_converted_limits(self, limit, convert):
         """
         if limit is not None:
             converted_limit = convert(limit)
+            if isinstance(converted_limit, np.ndarray):
+                converted_limit = converted_limit.squeeze()
             if (isinstance(converted_limit, Real)
                     and not np.isfinite(converted_limit)):
                 raise ValueError("Axis limits cannot be NaN or Inf")
diff --git a/lib/matplotlib/tests/test_category.py b/lib/matplotlib/tests/test_category.py
index 87dece6346f7..fd4aec88b574 100644
--- a/lib/matplotlib/tests/test_category.py
+++ b/lib/matplotlib/tests/test_category.py
@@ -1,4 +1,6 @@
 """Catch all for categorical functions"""
+import warnings
+
 import pytest
 import numpy as np
 
@@ -309,3 +311,13 @@ def test_hist():
     n, bins, patches = ax.hist(['a', 'b', 'a', 'c', 'ff'])
     assert n.shape == (10,)
     np.testing.assert_allclose(n, [2., 0., 0., 1., 0., 0., 1., 0., 0., 1.])
+
+
+def test_set_lim():
+    # Numpy 1.25 deprecated casting [2.] to float, catch_warnings added to error
+    # with numpy 1.25 and prior to the change from gh-26597
+    # can be removed once the minimum numpy version has expired the warning
+    f, ax = plt.subplots()
+    ax.plot(["a", "b", "c", "d"], [1, 2, 3, 4])
+    with warnings.catch_warnings():
+        ax.set_xlim("b", "c")

From 23aef2f9ec6ed6365162eaa1d0805dcb2fec24be Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Wed, 30 Aug 2023 21:30:36 +0200
Subject: [PATCH 0082/1120] Use standard method for closing QApp when last
 window is closed.

setQuitOnLastWindowClosed(True) should be equivalent to
lastWindowClosed.connect(quit), but is more introspectable (e.g.
third-parties can check the value of quitOnLastWindowClosed()).

AFAICT the code used lastWindowClosed.connect(quit) because it dates
back to Qt3, where setQuitOnLastWindowClosed did not exist yet.
---
 lib/matplotlib/backends/backend_qt.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/backends/backend_qt.py b/lib/matplotlib/backends/backend_qt.py
index 62d7a9358544..4b3783bc87ca 100644
--- a/lib/matplotlib/backends/backend_qt.py
+++ b/lib/matplotlib/backends/backend_qt.py
@@ -140,7 +140,7 @@ def _create_qApp():
             image = str(cbook._get_data_path('images/matplotlib.svg'))
             icon = QtGui.QIcon(image)
             app.setWindowIcon(icon)
-        app.lastWindowClosed.connect(app.quit)
+        app.setQuitOnLastWindowClosed(True)
         cbook._setup_new_guiapp()
         if qt_version == 5:
             app.setAttribute(QtCore.Qt.AA_UseHighDpiPixmaps)

From b50753ce2db412abc705961fe0921736ada5eec8 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Mon, 14 Aug 2023 14:57:50 -0400
Subject: [PATCH 0083/1120] Remove unused parameters to parse actions

Pyparsing allows you to leave out the parameters (starting from the
left) if they are unused.
---
 lib/matplotlib/_mathtext.py | 49 +++++++++++++++++--------------------
 1 file changed, 23 insertions(+), 26 deletions(-)

diff --git a/lib/matplotlib/_mathtext.py b/lib/matplotlib/_mathtext.py
index 5b4e8ed20db3..ba0f1d4aa81d 100644
--- a/lib/matplotlib/_mathtext.py
+++ b/lib/matplotlib/_mathtext.py
@@ -2070,18 +2070,18 @@ def push_state(self):
         """Push a new `State` onto the stack, copying the current state."""
         self._state_stack.append(self.get_state().copy())
 
-    def main(self, s, loc, toks):
+    def main(self, toks):
         return [Hlist(toks)]
 
-    def math_string(self, s, loc, toks):
+    def math_string(self, toks):
         return self._math_expression.parseString(toks[0][1:-1], parseAll=True)
 
-    def math(self, s, loc, toks):
+    def math(self, toks):
         hlist = Hlist(toks)
         self.pop_state()
         return [hlist]
 
-    def non_math(self, s, loc, toks):
+    def non_math(self, toks):
         s = toks[0].replace(r'\$', '$')
         symbols = [Char(c, self.get_state()) for c in s]
         hlist = Hlist(symbols)
@@ -2092,7 +2092,7 @@ def non_math(self, s, loc, toks):
 
     float_literal = staticmethod(pyparsing_common.convertToFloat)
 
-    def text(self, s, loc, toks):
+    def text(self, toks):
         self.push_state()
         state = self.get_state()
         state.font = 'rm'
@@ -2132,12 +2132,12 @@ def _make_space(self, percentage):
         r'\!':         -0.16667,  # -3/18 em = -3 mu
     }
 
-    def space(self, s, loc, toks):
+    def space(self, toks):
         num = self._space_widths[toks["space"]]
         box = self._make_space(num)
         return [box]
 
-    def customspace(self, s, loc, toks):
+    def customspace(self, toks):
         return [self._make_space(toks["space"])]
 
     def symbol(self, s, loc, toks):
@@ -2215,7 +2215,7 @@ def unknown_symbol(self, s, loc, toks):
 
     _wide_accents = set(r"widehat widetilde widebar".split())
 
-    def accent(self, s, loc, toks):
+    def accent(self, toks):
         state = self.get_state()
         thickness = state.get_current_underline_thickness()
         accent = toks["accent"]
@@ -2276,30 +2276,30 @@ def operatorname(self, s, loc, toks):
 
         return Hlist(hlist_list)
 
-    def start_group(self, s, loc, toks):
+    def start_group(self, toks):
         self.push_state()
         # Deal with LaTeX-style font tokens
         if toks.get("font"):
             self.get_state().font = toks.get("font")
         return []
 
-    def group(self, s, loc, toks):
+    def group(self, toks):
         grp = Hlist(toks.get("group", []))
         return [grp]
 
-    def required_group(self, s, loc, toks):
+    def required_group(self, toks):
         return Hlist(toks.get("group", []))
 
     optional_group = required_group
 
-    def end_group(self, s, loc, toks):
+    def end_group(self):
         self.pop_state()
         return []
 
     def unclosed_group(self, s, loc, toks):
         raise ParseFatalException(s, len(s), "Expected '}'")
 
-    def font(self, s, loc, toks):
+    def font(self, toks):
         self.get_state().font = toks["font"]
         return []
 
@@ -2320,9 +2320,6 @@ def is_slanted(self, nucleus):
             return nucleus.is_slanted()
         return False
 
-    def is_between_brackets(self, s, loc):
-        return False
-
     def subsuper(self, s, loc, toks):
         nucleus = toks.get("nucleus", Hbox(0))
         subsuper = toks.get("subsuper", [])
@@ -2523,26 +2520,26 @@ def _genfrac(self, ldelim, rdelim, rule, style, num, den):
             return self._auto_sized_delimiter(ldelim, result, rdelim)
         return result
 
-    def style_literal(self, s, loc, toks):
+    def style_literal(self, toks):
         return self._MathStyle(int(toks["style_literal"]))
 
-    def genfrac(self, s, loc, toks):
+    def genfrac(self, toks):
         return self._genfrac(
             toks.get("ldelim", ""), toks.get("rdelim", ""),
             toks["rulesize"], toks.get("style", self._MathStyle.TEXTSTYLE),
             toks["num"], toks["den"])
 
-    def frac(self, s, loc, toks):
+    def frac(self, toks):
         return self._genfrac(
             "", "", self.get_state().get_current_underline_thickness(),
             self._MathStyle.TEXTSTYLE, toks["num"], toks["den"])
 
-    def dfrac(self, s, loc, toks):
+    def dfrac(self, toks):
         return self._genfrac(
             "", "", self.get_state().get_current_underline_thickness(),
             self._MathStyle.DISPLAYSTYLE, toks["num"], toks["den"])
 
-    def binom(self, s, loc, toks):
+    def binom(self, toks):
         return self._genfrac(
             "(", ")", 0,
             self._MathStyle.TEXTSTYLE, toks["num"], toks["den"])
@@ -2579,7 +2576,7 @@ def _genset(self, s, loc, toks):
 
     overset = underset = _genset
 
-    def sqrt(self, s, loc, toks):
+    def sqrt(self, toks):
         root = toks.get("root")
         body = toks["value"]
         state = self.get_state()
@@ -2619,7 +2616,7 @@ def sqrt(self, s, loc, toks):
                        rightside])               # Body
         return [hlist]
 
-    def overline(self, s, loc, toks):
+    def overline(self, toks):
         body = toks["body"]
 
         state = self.get_state()
@@ -2670,14 +2667,14 @@ def _auto_sized_delimiter(self, front, middle, back):
         hlist = Hlist(parts)
         return hlist
 
-    def auto_delim(self, s, loc, toks):
+    def auto_delim(self, toks):
         return self._auto_sized_delimiter(
             toks["left"],
             # if "mid" in toks ... can be removed when requiring pyparsing 3.
             toks["mid"].asList() if "mid" in toks else [],
             toks["right"])
 
-    def boldsymbol(self, s, loc, toks):
+    def boldsymbol(self, toks):
         self.push_state()
         state = self.get_state()
         hlist = []
@@ -2703,7 +2700,7 @@ def boldsymbol(self, s, loc, toks):
 
         return Hlist(hlist)
 
-    def substack(self, s, loc, toks):
+    def substack(self, toks):
         parts = toks["parts"]
         state = self.get_state()
         thickness = state.get_current_underline_thickness()

From 03651fc6cd6c025c12896d5a2c8ba1921d628d48 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Wed, 30 Aug 2023 22:25:19 +0200
Subject: [PATCH 0084/1120] [DOC] Remove "Discouraged" notices that have been
 superseded by deprecation

---
 lib/matplotlib/figure.py | 14 ++------------
 1 file changed, 2 insertions(+), 12 deletions(-)

diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
index 4361ef655c81..5c115c868187 100644
--- a/lib/matplotlib/figure.py
+++ b/lib/matplotlib/figure.py
@@ -2788,12 +2788,7 @@ def get_tight_layout(self):
                      pending=True)
     def set_tight_layout(self, tight):
         """
-        [*Discouraged*] Set whether and how `.tight_layout` is called when
-        drawing.
-
-        .. admonition:: Discouraged
-
-            This method is discouraged in favor of `~.set_layout_engine`.
+        Set whether and how `.tight_layout` is called when drawing.
 
         Parameters
         ----------
@@ -2822,8 +2817,7 @@ def get_constrained_layout(self):
                      pending=True)
     def set_constrained_layout(self, constrained):
         """
-        [*Discouraged*] Set whether ``constrained_layout`` is used upon
-        drawing.
+        Set whether ``constrained_layout`` is used upon drawing.
 
         If None, :rc:`figure.constrained_layout.use` value will be used.
 
@@ -2832,10 +2826,6 @@ def set_constrained_layout(self, constrained):
         overridden.  These pads are in inches and default to 3.0/72.0.
         ``w_pad`` is the width padding and ``h_pad`` is the height padding.
 
-        .. admonition:: Discouraged
-
-            This method is discouraged in favor of `~.set_layout_engine`.
-
         Parameters
         ----------
         constrained : bool or dict or None

From 63cfa1685dc0c39934f7cffcb8de256931540b2d Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 16 Aug 2023 03:58:53 -0400
Subject: [PATCH 0085/1120] TYP: Add typed classes around mathtext data objects

---
 lib/matplotlib/_mathtext.py | 149 ++++++++++++++++++++++++++----------
 1 file changed, 108 insertions(+), 41 deletions(-)

diff --git a/lib/matplotlib/_mathtext.py b/lib/matplotlib/_mathtext.py
index ba0f1d4aa81d..3dd165a11555 100644
--- a/lib/matplotlib/_mathtext.py
+++ b/lib/matplotlib/_mathtext.py
@@ -2,8 +2,9 @@
 Implementation details for :mod:`.mathtext`.
 """
 
+from __future__ import annotations
+
 import copy
-from collections import namedtuple
 import enum
 import functools
 import logging
@@ -12,6 +13,8 @@
 import types
 import unicodedata
 import string
+import typing as T
+from typing import NamedTuple
 
 import numpy as np
 from pyparsing import (
@@ -34,6 +37,9 @@
 else:
     from pyparsing import nested_expr
 
+if T.TYPE_CHECKING:
+    from .ft2font import FT2Font, Glyph
+
 ParserElement.enablePackrat()
 _log = logging.getLogger("matplotlib.mathtext")
 
@@ -64,24 +70,49 @@ def get_unicode_index(symbol):  # Publicly exported.
             ) from err
 
 
-VectorParse = namedtuple("VectorParse", "width height depth glyphs rects",
-                         module="matplotlib.mathtext")
-VectorParse.__doc__ = r"""
-The namedtuple type returned by ``MathTextParser("path").parse(...)``.
+class VectorParse(NamedTuple):
+    """
+    The namedtuple type returned by ``MathTextParser("path").parse(...)``.
 
-This tuple contains the global metrics (*width*, *height*, *depth*), a list of
-*glyphs* (including their positions) and of *rect*\angles.
-"""
+    Attributes
+    ----------
+    width, height, depth : float
+        The global metrics.
+    glyphs : list
+        The glyphs including their positions.
+    rect : list
+        The list of rectangles.
+    """
+    width: float
+    height: float
+    depth: float
+    glyphs: list[tuple[FT2Font, float, int, float, float]]
+    rects: list[tuple[float, float, float, float]]
 
+VectorParse.__module__ = "matplotlib.mathtext"
 
-RasterParse = namedtuple("RasterParse", "ox oy width height depth image",
-                         module="matplotlib.mathtext")
-RasterParse.__doc__ = r"""
-The namedtuple type returned by ``MathTextParser("agg").parse(...)``.
 
-This tuple contains the global metrics (*width*, *height*, *depth*), and a
-raster *image*.  The offsets *ox*, *oy* are always zero.
-"""
+class RasterParse(NamedTuple):
+    """
+    The namedtuple type returned by ``MathTextParser("agg").parse(...)``.
+
+    Attributes
+    ----------
+    ox, oy : float
+        The offsets are always zero.
+    width, height, depth : float
+        The global metrics.
+    image : FT2Image
+        A raster image.
+    """
+    ox: float
+    oy: float
+    width: float
+    height: float
+    depth: float
+    image: FT2Image
+
+RasterParse.__module__ = "matplotlib.mathtext"
 
 
 class Output:
@@ -143,6 +174,48 @@ def to_raster(self, *, antialiased):
         return RasterParse(0, 0, w, h + d, d, image)
 
 
+class FontMetrics(NamedTuple):
+    """
+    Metrics of a font.
+
+    Attributes
+    ----------
+    advance : float
+        The advance distance (in points) of the glyph.
+    height : float
+        The height of the glyph in points.
+    width : float
+        The width of the glyph in points.
+    xmin, xmax, ymin, ymax : float
+        The ink rectangle of the glyph.
+    iceberg : float
+        The distance from the baseline to the top of the glyph. (This corresponds to
+        TeX's definition of "height".)
+    slanted : bool
+        Whether the glyph should be considered as "slanted" (currently used for kerning
+        sub/superscripts).
+    """
+    advance: float
+    height: float
+    width: float
+    xmin: float
+    xmax: float
+    ymin: float
+    ymax: float
+    iceberg: float
+    slanted: bool
+
+
+class FontInfo(NamedTuple):
+    font: FT2Font
+    fontsize: float
+    postscript_name: str
+    metrics: FontMetrics
+    num: int
+    glyph: Glyph
+    offset: float
+
+
 class Fonts:
     """
     An abstract base class for a system of fonts to use for mathtext.
@@ -197,19 +270,7 @@ def get_metrics(self, font, font_class, sym, fontsize, dpi):
 
         Returns
         -------
-        object
-
-            The returned object has the following attributes (all floats,
-            except *slanted*):
-
-            - *advance*: The advance distance (in points) of the glyph.
-            - *height*: The height of the glyph in points.
-            - *width*: The width of the glyph in points.
-            - *xmin*, *xmax*, *ymin*, *ymax*: The ink rectangle of the glyph
-            - *iceberg*: The distance from the baseline to the top of the
-              glyph.  (This corresponds to TeX's definition of "height".)
-            - *slanted*: Whether the glyph should be considered as "slanted"
-              (currently used for kerning sub/superscripts).
+        FontMetrics
         """
         info = self._get_info(font, font_class, sym, fontsize, dpi)
         return info.metrics
@@ -295,7 +356,7 @@ def _get_info(self, fontname, font_class, sym, fontsize, dpi):
 
         xmin, ymin, xmax, ymax = [val/64.0 for val in glyph.bbox]
         offset = self._get_offset(font, glyph, fontsize, dpi)
-        metrics = types.SimpleNamespace(
+        metrics = FontMetrics(
             advance = glyph.linearHoriAdvance/65536.0,
             height  = glyph.height/64.0,
             width   = glyph.width/64.0,
@@ -308,7 +369,7 @@ def _get_info(self, fontname, font_class, sym, fontsize, dpi):
             slanted = slanted
             )
 
-        return types.SimpleNamespace(
+        return FontInfo(
             font            = font,
             fontsize        = fontsize,
             postscript_name = font.postscript_name,
@@ -810,33 +871,33 @@ class FontConstantsBase:
     be reliably retrieved from the font metrics in the font itself.
     """
     # Percentage of x-height of additional horiz. space after sub/superscripts
-    script_space = 0.05
+    script_space: T.ClassVar[float] = 0.05
 
     # Percentage of x-height that sub/superscripts drop below the baseline
-    subdrop = 0.4
+    subdrop: T.ClassVar[float] = 0.4
 
     # Percentage of x-height that superscripts are raised from the baseline
-    sup1 = 0.7
+    sup1: T.ClassVar[float] = 0.7
 
     # Percentage of x-height that subscripts drop below the baseline
-    sub1 = 0.3
+    sub1: T.ClassVar[float] = 0.3
 
     # Percentage of x-height that subscripts drop below the baseline when a
     # superscript is present
-    sub2 = 0.5
+    sub2: T.ClassVar[float] = 0.5
 
     # Percentage of x-height that sub/superscripts are offset relative to the
     # nucleus edge for non-slanted nuclei
-    delta = 0.025
+    delta: T.ClassVar[float] = 0.025
 
     # Additional percentage of last character height above 2/3 of the
     # x-height that superscripts are offset relative to the subscript
     # for slanted nuclei
-    delta_slanted = 0.2
+    delta_slanted: T.ClassVar[float] = 0.2
 
     # Percentage of x-height that superscripts and subscripts are offset for
     # integrals
-    delta_integral = 0.1
+    delta_integral: T.ClassVar[float] = 0.1
 
 
 class ComputerModernFontConstants(FontConstantsBase):
@@ -1333,8 +1394,14 @@ def __init__(self, state):
         super().__init__(thickness, np.inf, np.inf, state)
 
 
-_GlueSpec = namedtuple(
-    "_GlueSpec", "width stretch stretch_order shrink shrink_order")
+class _GlueSpec(NamedTuple):
+    width: float
+    stretch: float
+    stretch_order: int
+    shrink: float
+    shrink_order: int
+
+
 _GlueSpec._named = {  # type: ignore[attr-defined]
     'fil':         _GlueSpec(0., 1., 1, 0., 0),
     'fill':        _GlueSpec(0., 1., 2, 0., 0),
@@ -1358,7 +1425,7 @@ class Glue(Node):
     def __init__(self, glue_type):
         super().__init__()
         if isinstance(glue_type, str):
-            glue_spec = _GlueSpec._named[glue_type]
+            glue_spec = _GlueSpec._named[glue_type]  # type: ignore[attr-defined]
         elif isinstance(glue_type, _GlueSpec):
             glue_spec = glue_type
         else:

From 7c8ed22173f5880107cb2125ba16c21d6ee36bd0 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 16 Aug 2023 04:48:46 -0400
Subject: [PATCH 0086/1120] Add abstract methods and ABC on Fonts classes

mypy rightfully complains that these methods called in the base class
don't exist, so correctly indicate what should be implemented there.

The ABC is not strictly necessary, but it helps with understanding as a
lot of these have code that makes them seem like _not_ an ABC.
---
 lib/matplotlib/_mathtext.py | 24 +++++++++++++++++-------
 1 file changed, 17 insertions(+), 7 deletions(-)

diff --git a/lib/matplotlib/_mathtext.py b/lib/matplotlib/_mathtext.py
index 3dd165a11555..e41fdee5444c 100644
--- a/lib/matplotlib/_mathtext.py
+++ b/lib/matplotlib/_mathtext.py
@@ -4,6 +4,7 @@
 
 from __future__ import annotations
 
+import abc
 import copy
 import enum
 import functools
@@ -216,7 +217,7 @@ class FontInfo(NamedTuple):
     offset: float
 
 
-class Fonts:
+class Fonts(abc.ABC):
     """
     An abstract base class for a system of fonts to use for mathtext.
 
@@ -248,6 +249,13 @@ def get_kern(self, font1, fontclass1, sym1, fontsize1,
         """
         return 0.
 
+    def _get_font(self, font: str) -> FT2Font:
+        raise NotImplementedError
+
+    def _get_info(self, font: str, font_class: str, sym: str, fontsize: float,
+                  dpi: float) -> FontInfo:
+        raise NotImplementedError
+
     def get_metrics(self, font, font_class, sym, fontsize, dpi):
         r"""
         Parameters
@@ -313,7 +321,7 @@ def get_sized_alternatives_for_symbol(self, fontname, sym):
         return [(fontname, sym)]
 
 
-class TruetypeFonts(Fonts):
+class TruetypeFonts(Fonts, metaclass=abc.ABCMeta):
     """
     A generic base class for all font setups that use Truetype fonts
     (through FT2Font).
@@ -324,6 +332,7 @@ def __init__(self, *args, **kwargs):
         # Per-instance cache.
         self._get_info = functools.cache(self._get_info)
         self._fonts = {}
+        self.fontmap: dict[str | int, str] = {}
 
         filename = findfont(self.default_font_prop)
         default_font = get_font(filename)
@@ -348,6 +357,10 @@ def _get_offset(self, font, glyph, fontsize, dpi):
             return (glyph.height / 64 / 2) + (fontsize/3 * dpi/72)
         return 0.
 
+    def _get_glyph(self, fontname: str, font_class: str,
+                   sym: str) -> tuple[FT2Font, int, bool]:
+        raise NotImplementedError
+
     # The return value of _get_info is cached per-instance.
     def _get_info(self, fontname, font_class, sym, fontsize, dpi):
         font, num, slanted = self._get_glyph(fontname, font_class, sym)
@@ -429,7 +442,6 @@ def __init__(self, *args, **kwargs):
         self._stix_fallback = StixFonts(*args, **kwargs)
 
         super().__init__(*args, **kwargs)
-        self.fontmap = {}
         for key, val in self._fontmap.items():
             fullpath = findfont(val)
             self.fontmap[key] = fullpath
@@ -543,7 +555,6 @@ def __init__(self, *args, **kwargs):
         self._fallback_font = font_cls(*args, **kwargs) if font_cls else None
 
         super().__init__(*args, **kwargs)
-        self.fontmap = {}
         for texfont in "cal rm tt it bf sf bfit".split():
             prop = mpl.rcParams['mathtext.' + texfont]
             font = findfont(prop)
@@ -641,7 +652,8 @@ def get_sized_alternatives_for_symbol(self, fontname, sym):
         return [(fontname, sym)]
 
 
-class DejaVuFonts(UnicodeFonts):
+class DejaVuFonts(UnicodeFonts, metaclass=abc.ABCMeta):
+    _fontmap: dict[str | int, str] = {}
 
     def __init__(self, *args, **kwargs):
         # This must come first so the backend's owner is set correctly
@@ -651,7 +663,6 @@ def __init__(self, *args, **kwargs):
             self._fallback_font = StixSansFonts(*args, **kwargs)
         self.bakoma = BakomaFonts(*args, **kwargs)
         TruetypeFonts.__init__(self, *args, **kwargs)
-        self.fontmap = {}
         # Include Stix sized alternatives for glyphs
         self._fontmap.update({
             1: 'STIXSizeOneSym',
@@ -749,7 +760,6 @@ class StixFonts(UnicodeFonts):
 
     def __init__(self, *args, **kwargs):
         TruetypeFonts.__init__(self, *args, **kwargs)
-        self.fontmap = {}
         for key, name in self._fontmap.items():
             fullpath = findfont(name)
             self.fontmap[key] = fullpath

From d0eca17a75906e47636166debf63f4e729b97e2f Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 16 Aug 2023 05:38:17 -0400
Subject: [PATCH 0087/1120] Re-arrange some mathtext code to avoid variable
 reuse

---
 lib/matplotlib/_mathtext.py | 53 +++++++++++++++++++++----------------
 1 file changed, 30 insertions(+), 23 deletions(-)

diff --git a/lib/matplotlib/_mathtext.py b/lib/matplotlib/_mathtext.py
index e41fdee5444c..10e591d55ca6 100644
--- a/lib/matplotlib/_mathtext.py
+++ b/lib/matplotlib/_mathtext.py
@@ -768,21 +768,25 @@ def __init__(self, *args, **kwargs):
     def _map_virtual_font(self, fontname, font_class, uniindex):
         # Handle these "fonts" that are actually embedded in
         # other fonts.
-        mapping = stix_virtual_fonts.get(fontname)
-        if (self._sans and mapping is None
+        font_mapping = stix_virtual_fonts.get(fontname)
+        if (self._sans and font_mapping is None
                 and fontname not in ('regular', 'default')):
-            mapping = stix_virtual_fonts['sf']
+            font_mapping = stix_virtual_fonts['sf']
             doing_sans_conversion = True
         else:
             doing_sans_conversion = False
 
-        if mapping is not None:
-            if isinstance(mapping, dict):
-                try:
-                    mapping = mapping[font_class]
-                except KeyError:
-                    mapping = mapping['rm']
+        if isinstance(font_mapping, dict):
+            try:
+                mapping = font_mapping[font_class]
+            except KeyError:
+                mapping = font_mapping['rm']
+        elif isinstance(font_mapping, list):
+            mapping = font_mapping
+        else:
+            mapping = None
 
+        if mapping is not None:
             # Binary search for the source glyph
             lo = 0
             hi = len(mapping)
@@ -1965,11 +1969,14 @@ def csnames(group, names):
                     ends_with_alpha.append(name)
                 else:
                     ends_with_nonalpha.append(name)
-            return Regex(r"\\(?P<{}>(?:{})(?![A-Za-z]){})".format(
-                group,
-                "|".join(map(re.escape, ends_with_alpha)),
-                "".join(f"|{s}" for s in map(re.escape, ends_with_nonalpha)),
-            ))
+            return Regex(
+                r"\\(?P<{group}>(?:{alpha})(?![A-Za-z]){additional}{nonalpha})".format(
+                    group=group,
+                    alpha="|".join(map(re.escape, ends_with_alpha)),
+                    additional="|" if ends_with_nonalpha else "",
+                    nonalpha="|".join(map(re.escape, ends_with_nonalpha)),
+                )
+            )
 
         p.float_literal  = Regex(r"[-+]?([0-9]+\.?[0-9]*|\.[0-9]+)")
         p.space          = oneOf(self._space_widths)("space")
@@ -2458,9 +2465,9 @@ def subsuper(self, s, loc, toks):
                 hlist.hpack(width, 'exactly')
                 vlist.extend([Vbox(0, vgap), hlist])
                 shift = hlist.height + vgap + nucleus.depth
-            vlist = Vlist(vlist)
-            vlist.shift_amount = shift
-            result = Hlist([vlist])
+            vlt = Vlist(vlist)
+            vlt.shift_amount = shift
+            result = Hlist([vlt])
             return [result]
 
         # We remove kerning on the last character for consistency (otherwise
@@ -2781,20 +2788,20 @@ def substack(self, toks):
         parts = toks["parts"]
         state = self.get_state()
         thickness = state.get_current_underline_thickness()
-        vlist = []
 
         hlist = [Hlist(k) for k in parts[0]]
         max_width = max(map(lambda c: c.width, hlist))
 
+        vlist = []
         for sub in hlist:
             cp = HCentered([sub])
             cp.hpack(max_width, 'exactly')
             vlist.append(cp)
 
-        vlist = [val for pair in zip(vlist,
-                                     [Vbox(0, thickness * 2)] *
-                                     len(vlist)) for val in pair]
-        del vlist[-1]
-        vlt = Vlist(vlist)
+        stack = [val
+                 for pair in zip(vlist, [Vbox(0, thickness * 2)] * len(vlist))
+                 for val in pair]
+        del stack[-1]
+        vlt = Vlist(stack)
         result = [Hlist([vlt])]
         return result

From 2bd74a6fe39490bdaf031f3ada183c487b2ecd31 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 16 Aug 2023 05:49:51 -0400
Subject: [PATCH 0088/1120] mathtext: Make pyparsing cache reset more explicit

Just as enabling the packrat cache occurs on the class overall, so does
the reset.
---
 lib/matplotlib/_mathtext.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/_mathtext.py b/lib/matplotlib/_mathtext.py
index 10e591d55ca6..5df366de8f6b 100644
--- a/lib/matplotlib/_mathtext.py
+++ b/lib/matplotlib/_mathtext.py
@@ -2139,7 +2139,7 @@ def parse(self, s, fonts_object, fontsize, dpi):
         self._in_subscript_or_superscript = False
         # prevent operator spacing from leaking into a new expression
         self._em_width_cache = {}
-        self._expression.resetCache()
+        ParserElement.resetCache()
         return result[0]
 
     def get_state(self):

From a5f8ec4b3a520b35117b2ee197aea40bc6db9df7 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 16 Aug 2023 05:10:21 -0400
Subject: [PATCH 0089/1120] TYP: Add type hints to all mathtext internals

---
 lib/matplotlib/_mathtext.py      | 418 +++++++++++++++++--------------
 lib/matplotlib/_mathtext_data.py |   6 +-
 2 files changed, 236 insertions(+), 188 deletions(-)

diff --git a/lib/matplotlib/_mathtext.py b/lib/matplotlib/_mathtext.py
index 5df366de8f6b..b23cb67116ed 100644
--- a/lib/matplotlib/_mathtext.py
+++ b/lib/matplotlib/_mathtext.py
@@ -29,7 +29,7 @@
 from ._mathtext_data import (
     latex_to_bakoma, stix_glyph_fixes, stix_virtual_fonts, tex2uni)
 from .font_manager import FontProperties, findfont, get_font
-from .ft2font import FT2Image, KERNING_DEFAULT
+from .ft2font import FT2Font, FT2Image, KERNING_DEFAULT
 
 from packaging.version import parse as parse_version
 from pyparsing import __version__ as pyparsing_version
@@ -39,7 +39,8 @@
     from pyparsing import nested_expr
 
 if T.TYPE_CHECKING:
-    from .ft2font import FT2Font, Glyph
+    from collections.abc import Iterable
+    from .ft2font import Glyph
 
 ParserElement.enablePackrat()
 _log = logging.getLogger("matplotlib.mathtext")
@@ -49,7 +50,7 @@
 # FONTS
 
 
-def get_unicode_index(symbol):  # Publicly exported.
+def get_unicode_index(symbol: str) -> int:  # Publicly exported.
     r"""
     Return the integer index (from the Unicode table) of *symbol*.
 
@@ -124,12 +125,12 @@ class Output:
     a `RasterParse` by `.MathTextParser.parse`.
     """
 
-    def __init__(self, box):
+    def __init__(self, box: Box):
         self.box = box
-        self.glyphs = []  # (ox, oy, info)
-        self.rects = []  # (x1, y1, x2, y2)
+        self.glyphs: list[tuple[float, float, FontInfo]] = []  # (ox, oy, info)
+        self.rects: list[tuple[float, float, float, float]] = []  # (x1, y1, x2, y2)
 
-    def to_vector(self):
+    def to_vector(self) -> VectorParse:
         w, h, d = map(
             np.ceil, [self.box.width, self.box.height, self.box.depth])
         gs = [(info.font, info.fontsize, info.num, ox, h - oy + info.offset)
@@ -138,7 +139,7 @@ def to_vector(self):
               for x1, y1, x2, y2 in self.rects]
         return VectorParse(w, h + d, d, gs, rs)
 
-    def to_raster(self, *, antialiased):
+    def to_raster(self, *, antialiased: bool) -> RasterParse:
         # Metrics y's and mathtext y's are oriented in opposite directions,
         # hence the switch between ymin and ymax.
         xmin = min([*[ox + info.metrics.xmin for ox, oy, info in self.glyphs],
@@ -226,7 +227,7 @@ class Fonts(abc.ABC):
     to do the actual drawing.
     """
 
-    def __init__(self, default_font_prop, load_glyph_flags):
+    def __init__(self, default_font_prop: FontProperties, load_glyph_flags: int):
         """
         Parameters
         ----------
@@ -240,8 +241,9 @@ def __init__(self, default_font_prop, load_glyph_flags):
         self.default_font_prop = default_font_prop
         self.load_glyph_flags = load_glyph_flags
 
-    def get_kern(self, font1, fontclass1, sym1, fontsize1,
-                 font2, fontclass2, sym2, fontsize2, dpi):
+    def get_kern(self, font1: str, fontclass1: str, sym1: str, fontsize1: float,
+                 font2: str, fontclass2: str, sym2: str, fontsize2: float,
+                 dpi: float) -> float:
         """
         Get the kerning distance for font between *sym1* and *sym2*.
 
@@ -256,7 +258,8 @@ def _get_info(self, font: str, font_class: str, sym: str, fontsize: float,
                   dpi: float) -> FontInfo:
         raise NotImplementedError
 
-    def get_metrics(self, font, font_class, sym, fontsize, dpi):
+    def get_metrics(self, font: str, font_class: str, sym: str, fontsize: float,
+                    dpi: float) -> FontMetrics:
         r"""
         Parameters
         ----------
@@ -283,8 +286,8 @@ def get_metrics(self, font, font_class, sym, fontsize, dpi):
         info = self._get_info(font, font_class, sym, fontsize, dpi)
         return info.metrics
 
-    def render_glyph(
-            self, output, ox, oy, font, font_class, sym, fontsize, dpi):
+    def render_glyph(self, output: Output, ox: float, oy: float, font: str,
+                     font_class: str, sym: str, fontsize: float, dpi: float) -> None:
         """
         At position (*ox*, *oy*), draw the glyph specified by the remaining
         parameters (see `get_metrics` for their detailed description).
@@ -292,26 +295,28 @@ def render_glyph(
         info = self._get_info(font, font_class, sym, fontsize, dpi)
         output.glyphs.append((ox, oy, info))
 
-    def render_rect_filled(self, output, x1, y1, x2, y2):
+    def render_rect_filled(self, output: Output,
+                           x1: float, y1: float, x2: float, y2: float) -> None:
         """
         Draw a filled rectangle from (*x1*, *y1*) to (*x2*, *y2*).
         """
         output.rects.append((x1, y1, x2, y2))
 
-    def get_xheight(self, font, fontsize, dpi):
+    def get_xheight(self, font: str, fontsize: float, dpi: float) -> float:
         """
         Get the xheight for the given *font* and *fontsize*.
         """
         raise NotImplementedError()
 
-    def get_underline_thickness(self, font, fontsize, dpi):
+    def get_underline_thickness(self, font: str, fontsize: float, dpi: float) -> float:
         """
         Get the line thickness that matches the given font.  Used as a
         base unit for drawing lines such as in a fraction or radical.
         """
         raise NotImplementedError()
 
-    def get_sized_alternatives_for_symbol(self, fontname, sym):
+    def get_sized_alternatives_for_symbol(self, fontname: str,
+                                          sym: str) -> list[tuple[str, str]]:
         """
         Override if your font provides multiple sizes of the same
         symbol.  Should return a list of symbols matching *sym* in
@@ -327,10 +332,10 @@ class TruetypeFonts(Fonts, metaclass=abc.ABCMeta):
     (through FT2Font).
     """
 
-    def __init__(self, *args, **kwargs):
-        super().__init__(*args, **kwargs)
+    def __init__(self, default_font_prop: FontProperties, load_glyph_flags: int):
+        super().__init__(default_font_prop, load_glyph_flags)
         # Per-instance cache.
-        self._get_info = functools.cache(self._get_info)
+        self._get_info = functools.cache(self._get_info)  # type: ignore[method-assign]
         self._fonts = {}
         self.fontmap: dict[str | int, str] = {}
 
@@ -339,20 +344,23 @@ def __init__(self, *args, **kwargs):
         self._fonts['default'] = default_font
         self._fonts['regular'] = default_font
 
-    def _get_font(self, font):
+    def _get_font(self, font: str | int) -> FT2Font:
         if font in self.fontmap:
             basename = self.fontmap[font]
         else:
-            basename = font
+            # NOTE: An int is only passed by subclasses which have placed int keys into
+            # `self.fontmap`, so we must cast this to confirm it to typing.
+            basename = T.cast(str, font)
         cached_font = self._fonts.get(basename)
         if cached_font is None and os.path.exists(basename):
             cached_font = get_font(basename)
             self._fonts[basename] = cached_font
             self._fonts[cached_font.postscript_name] = cached_font
             self._fonts[cached_font.postscript_name.lower()] = cached_font
-        return cached_font
+        return T.cast(FT2Font, cached_font)  # FIXME: Not sure this is guaranteed.
 
-    def _get_offset(self, font, glyph, fontsize, dpi):
+    def _get_offset(self, font: FT2Font, glyph: Glyph, fontsize: float,
+                    dpi: float) -> float:
         if font.postscript_name == 'Cmex10':
             return (glyph.height / 64 / 2) + (fontsize/3 * dpi/72)
         return 0.
@@ -362,7 +370,8 @@ def _get_glyph(self, fontname: str, font_class: str,
         raise NotImplementedError
 
     # The return value of _get_info is cached per-instance.
-    def _get_info(self, fontname, font_class, sym, fontsize, dpi):
+    def _get_info(self, fontname: str, font_class: str, sym: str, fontsize: float,
+                  dpi: float) -> FontInfo:
         font, num, slanted = self._get_glyph(fontname, font_class, sym)
         font.set_size(fontsize, dpi)
         glyph = font.load_char(num, flags=self.load_glyph_flags)
@@ -392,7 +401,7 @@ def _get_info(self, fontname, font_class, sym, fontsize, dpi):
             offset          = offset
             )
 
-    def get_xheight(self, fontname, fontsize, dpi):
+    def get_xheight(self, fontname: str, fontsize: float, dpi: float) -> float:
         font = self._get_font(fontname)
         font.set_size(fontsize, dpi)
         pclt = font.get_sfnt_table('pclt')
@@ -404,14 +413,15 @@ def get_xheight(self, fontname, fontsize, dpi):
         xHeight = (pclt['xHeight'] / 64.0) * (fontsize / 12.0) * (dpi / 100.0)
         return xHeight
 
-    def get_underline_thickness(self, font, fontsize, dpi):
+    def get_underline_thickness(self, font: str, fontsize: float, dpi: float) -> float:
         # This function used to grab underline thickness from the font
         # metrics, but that information is just too un-reliable, so it
         # is now hardcoded.
         return ((0.75 / 12.0) * fontsize * dpi) / 72.0
 
-    def get_kern(self, font1, fontclass1, sym1, fontsize1,
-                 font2, fontclass2, sym2, fontsize2, dpi):
+    def get_kern(self, font1: str, fontclass1: str, sym1: str, fontsize1: float,
+                 font2: str, fontclass2: str, sym2: str, fontsize2: float,
+                 dpi: float) -> float:
         if font1 == font2 and fontsize1 == fontsize2:
             info1 = self._get_info(font1, fontclass1, sym1, fontsize1, dpi)
             info2 = self._get_info(font2, fontclass2, sym2, fontsize2, dpi)
@@ -438,10 +448,10 @@ class BakomaFonts(TruetypeFonts):
         'ex':  'cmex10',
     }
 
-    def __init__(self, *args, **kwargs):
-        self._stix_fallback = StixFonts(*args, **kwargs)
+    def __init__(self, default_font_prop: FontProperties, load_glyph_flags: int):
+        self._stix_fallback = StixFonts(default_font_prop, load_glyph_flags)
 
-        super().__init__(*args, **kwargs)
+        super().__init__(default_font_prop, load_glyph_flags)
         for key, val in self._fontmap.items():
             fullpath = findfont(val)
             self.fontmap[key] = fullpath
@@ -449,7 +459,8 @@ def __init__(self, *args, **kwargs):
 
     _slanted_symbols = set(r"\int \oint".split())
 
-    def _get_glyph(self, fontname, font_class, sym):
+    def _get_glyph(self, fontname: str, font_class: str,
+                   sym: str) -> tuple[FT2Font, int, bool]:
         font = None
         if fontname in self.fontmap and sym in latex_to_bakoma:
             basename, num = latex_to_bakoma[sym]
@@ -521,7 +532,8 @@ def _get_glyph(self, fontname, font_class, sym):
                           (r'\]', ']')]:
         _size_alternatives[alias] = _size_alternatives[target]
 
-    def get_sized_alternatives_for_symbol(self, fontname, sym):
+    def get_sized_alternatives_for_symbol(self, fontname: str,
+                                          sym: str) -> list[tuple[str, str]]:
         return self._size_alternatives.get(sym, [(fontname, sym)])
 
 
@@ -545,16 +557,18 @@ class UnicodeFonts(TruetypeFonts):
         0x2212: 0x00A1,  # Minus sign.
     }
 
-    def __init__(self, *args, **kwargs):
+    def __init__(self, default_font_prop: FontProperties, load_glyph_flags: int):
         # This must come first so the backend's owner is set correctly
         fallback_rc = mpl.rcParams['mathtext.fallback']
-        font_cls = {'stix': StixFonts,
-                    'stixsans': StixSansFonts,
-                    'cm': BakomaFonts
-                    }.get(fallback_rc)
-        self._fallback_font = font_cls(*args, **kwargs) if font_cls else None
-
-        super().__init__(*args, **kwargs)
+        font_cls: type[TruetypeFonts] | None = {
+            'stix': StixFonts,
+            'stixsans': StixSansFonts,
+            'cm': BakomaFonts
+        }.get(fallback_rc)
+        self._fallback_font = (font_cls(default_font_prop, load_glyph_flags)
+                               if font_cls else None)
+
+        super().__init__(default_font_prop, load_glyph_flags)
         for texfont in "cal rm tt it bf sf bfit".split():
             prop = mpl.rcParams['mathtext.' + texfont]
             font = findfont(prop)
@@ -580,10 +594,12 @@ def __init__(self, *args, **kwargs):
 
     _slanted_symbols = set(r"\int \oint".split())
 
-    def _map_virtual_font(self, fontname, font_class, uniindex):
+    def _map_virtual_font(self, fontname: str, font_class: str,
+                          uniindex: int) -> tuple[str, int]:
         return fontname, uniindex
 
-    def _get_glyph(self, fontname, font_class, sym):
+    def _get_glyph(self, fontname: str, font_class: str,
+                   sym: str) -> tuple[FT2Font, int, bool]:
         try:
             uniindex = get_unicode_index(sym)
             found_symbol = True
@@ -645,7 +661,8 @@ def _get_glyph(self, fontname, font_class, sym):
 
         return font, uniindex, slanted
 
-    def get_sized_alternatives_for_symbol(self, fontname, sym):
+    def get_sized_alternatives_for_symbol(self, fontname: str,
+                                          sym: str) -> list[tuple[str, str]]:
         if self._fallback_font:
             return self._fallback_font.get_sized_alternatives_for_symbol(
                 fontname, sym)
@@ -655,14 +672,14 @@ def get_sized_alternatives_for_symbol(self, fontname, sym):
 class DejaVuFonts(UnicodeFonts, metaclass=abc.ABCMeta):
     _fontmap: dict[str | int, str] = {}
 
-    def __init__(self, *args, **kwargs):
+    def __init__(self, default_font_prop: FontProperties, load_glyph_flags: int):
         # This must come first so the backend's owner is set correctly
         if isinstance(self, DejaVuSerifFonts):
-            self._fallback_font = StixFonts(*args, **kwargs)
+            self._fallback_font = StixFonts(default_font_prop, load_glyph_flags)
         else:
-            self._fallback_font = StixSansFonts(*args, **kwargs)
-        self.bakoma = BakomaFonts(*args, **kwargs)
-        TruetypeFonts.__init__(self, *args, **kwargs)
+            self._fallback_font = StixSansFonts(default_font_prop, load_glyph_flags)
+        self.bakoma = BakomaFonts(default_font_prop, load_glyph_flags)
+        TruetypeFonts.__init__(self, default_font_prop, load_glyph_flags)
         # Include Stix sized alternatives for glyphs
         self._fontmap.update({
             1: 'STIXSizeOneSym',
@@ -676,7 +693,8 @@ def __init__(self, *args, **kwargs):
             self.fontmap[key] = fullpath
             self.fontmap[name] = fullpath
 
-    def _get_glyph(self, fontname, font_class, sym):
+    def _get_glyph(self, fontname: str, font_class: str,
+                   sym: str) -> tuple[FT2Font, int, bool]:
         # Override prime symbol to use Bakoma.
         if sym == r'\prime':
             return self.bakoma._get_glyph(fontname, font_class, sym)
@@ -740,7 +758,7 @@ class StixFonts(UnicodeFonts):
 
     - handles sized alternative characters for the STIXSizeX fonts.
     """
-    _fontmap = {
+    _fontmap: dict[str | int, str] = {
         'rm': 'STIXGeneral',
         'it': 'STIXGeneral:italic',
         'bf': 'STIXGeneral:weight=bold',
@@ -755,17 +773,18 @@ class StixFonts(UnicodeFonts):
         4: 'STIXSizeFourSym',
         5: 'STIXSizeFiveSym',
     }
-    _fallback_font = False
+    _fallback_font = None
     _sans = False
 
-    def __init__(self, *args, **kwargs):
-        TruetypeFonts.__init__(self, *args, **kwargs)
+    def __init__(self, default_font_prop: FontProperties, load_glyph_flags: int):
+        TruetypeFonts.__init__(self, default_font_prop, load_glyph_flags)
         for key, name in self._fontmap.items():
             fullpath = findfont(name)
             self.fontmap[key] = fullpath
             self.fontmap[name] = fullpath
 
-    def _map_virtual_font(self, fontname, font_class, uniindex):
+    def _map_virtual_font(self, fontname: str, font_class: str,
+                          uniindex: int) -> tuple[str, int]:
         # Handle these "fonts" that are actually embedded in
         # other fonts.
         font_mapping = stix_virtual_fonts.get(fontname)
@@ -819,7 +838,10 @@ def _map_virtual_font(self, fontname, font_class, uniindex):
         return fontname, uniindex
 
     @functools.cache
-    def get_sized_alternatives_for_symbol(self, fontname, sym):
+    def get_sized_alternatives_for_symbol(  # type: ignore[override]
+            self,
+            fontname: str,
+            sym: str) -> list[tuple[str, str]] | list[tuple[int, str]]:
         fixes = {
             '\\{': '{', '\\}': '}', '\\[': '[', '\\]': ']',
             '<': '\N{MATHEMATICAL LEFT ANGLE BRACKET}',
@@ -974,7 +996,7 @@ class DejaVuSansFontConstants(FontConstantsBase):
     }
 
 
-def _get_font_constant_set(state):
+def _get_font_constant_set(state: ParserState) -> type[FontConstantsBase]:
     constants = _font_constant_mapping.get(
         state.fontset._get_font(state.font).family_name, FontConstantsBase)
     # STIX sans isn't really its own fonts, just different code points
@@ -988,57 +1010,58 @@ def _get_font_constant_set(state):
 class Node:
     """A node in the TeX box model."""
 
-    def __init__(self):
+    def __init__(self) -> None:
         self.size = 0
 
-    def __repr__(self):
+    def __repr__(self) -> str:
         return type(self).__name__
 
-    def get_kerning(self, next):
+    def get_kerning(self, next: Node | None) -> float:
         return 0.0
 
-    def shrink(self):
+    def shrink(self) -> None:
         """
         Shrinks one level smaller.  There are only three levels of
         sizes, after which things will no longer get smaller.
         """
         self.size += 1
 
-    def render(self, output, x, y):
+    def render(self, output: Output, x: float, y: float) -> None:
         """Render this node."""
 
 
 class Box(Node):
     """A node with a physical location."""
 
-    def __init__(self, width, height, depth):
+    def __init__(self, width: float, height: float, depth: float) -> None:
         super().__init__()
         self.width  = width
         self.height = height
         self.depth  = depth
 
-    def shrink(self):
+    def shrink(self) -> None:
         super().shrink()
         if self.size < NUM_SIZE_LEVELS:
             self.width  *= SHRINK_FACTOR
             self.height *= SHRINK_FACTOR
             self.depth  *= SHRINK_FACTOR
 
-    def render(self, output, x1, y1, x2, y2):
+    def render(self, output: Output,  # type: ignore[override]
+               x1: float, y1: float, x2: float, y2: float) -> None:
         pass
 
 
 class Vbox(Box):
     """A box with only height (zero width)."""
 
-    def __init__(self, height, depth):
+    def __init__(self, height: float, depth: float):
         super().__init__(0., height, depth)
 
 
 class Hbox(Box):
     """A box with only width (zero height and depth)."""
 
-    def __init__(self, width):
+    def __init__(self, width: float):
         super().__init__(width, 0., 0.)
 
 
@@ -1055,7 +1078,7 @@ class Char(Node):
     `Hlist`.
     """
 
-    def __init__(self, c, state):
+    def __init__(self, c: str, state: ParserState):
         super().__init__()
         self.c = c
         self.fontset = state.fontset
@@ -1067,10 +1090,10 @@ def __init__(self, c, state):
         # pack phase, after we know the real fontsize
         self._update_metrics()
 
-    def __repr__(self):
+    def __repr__(self) -> str:
         return '`%s`' % self.c
 
-    def _update_metrics(self):
+    def _update_metrics(self) -> None:
         metrics = self._metrics = self.fontset.get_metrics(
             self.font, self.font_class, self.c, self.fontsize, self.dpi)
         if self.c == ' ':
@@ -1080,10 +1103,10 @@ def _update_metrics(self):
         self.height = metrics.iceberg
         self.depth = -(metrics.iceberg - metrics.height)
 
-    def is_slanted(self):
+    def is_slanted(self) -> bool:
         return self._metrics.slanted
 
-    def get_kerning(self, next):
+    def get_kerning(self, next: Node | None) -> float:
         """
         Return the amount of kerning between this and the given character.
 
@@ -1099,12 +1122,12 @@ def get_kerning(self, next):
                 self.dpi)
         return advance + kern
 
-    def render(self, output, x, y):
+    def render(self, output: Output, x: float, y: float) -> None:
         self.fontset.render_glyph(
             output, x, y,
             self.font, self.font_class, self.c, self.fontsize, self.dpi)
 
-    def shrink(self):
+    def shrink(self) -> None:
         super().shrink()
         if self.size < NUM_SIZE_LEVELS:
             self.fontsize *= SHRINK_FACTOR
@@ -1119,18 +1142,18 @@ class Accent(Char):
     since they are already offset correctly from the baseline in
     TrueType fonts.
     """
-    def _update_metrics(self):
+    def _update_metrics(self) -> None:
         metrics = self._metrics = self.fontset.get_metrics(
             self.font, self.font_class, self.c, self.fontsize, self.dpi)
         self.width = metrics.xmax - metrics.xmin
         self.height = metrics.ymax - metrics.ymin
         self.depth = 0
 
-    def shrink(self):
+    def shrink(self) -> None:
         super().shrink()
         self._update_metrics()
 
-    def render(self, output, x, y):
+    def render(self, output: Output, x: float, y: float) -> None:
         self.fontset.render_glyph(
             output, x - self._metrics.xmin, y + self._metrics.ymin,
             self.font, self.font_class, self.c, self.fontsize, self.dpi)
@@ -1139,23 +1162,24 @@ def render(self, output, x, y):
 class List(Box):
     """A list of nodes (either horizontal or vertical)."""
 
-    def __init__(self, elements):
+    def __init__(self, elements: T.Sequence[Node]):
         super().__init__(0., 0., 0.)
         self.shift_amount = 0.   # An arbitrary offset
-        self.children     = elements  # The child nodes of this list
+        self.children = [*elements]  # The child nodes of this list
         # The following parameters are set in the vpack and hpack functions
         self.glue_set     = 0.   # The glue setting of this list
         self.glue_sign    = 0    # 0: normal, -1: shrinking, 1: stretching
         self.glue_order   = 0    # The order of infinity (0 - 3) for the glue
 
-    def __repr__(self):
+    def __repr__(self) -> str:
         return '{}<w={:.02f} h={:.02f} d={:.02f} s={:.02f}>[{}]'.format(
             super().__repr__(),
             self.width, self.height,
             self.depth, self.shift_amount,
             ', '.join([repr(x) for x in self.children]))
 
-    def _set_glue(self, x, sign, totals, error_type):
+    def _set_glue(self, x: float, sign: int, totals: list[float],
+                  error_type: str) -> None:
         self.glue_order = o = next(
             # Highest order of glue used by the members of this list.
             (i for i in range(len(totals))[::-1] if totals[i] != 0), 0)
@@ -1170,7 +1194,7 @@ def _set_glue(self, x, sign, totals, error_type):
                 _log.warning("%s %s: %r",
                              error_type, type(self).__name__, self)
 
-    def shrink(self):
+    def shrink(self) -> None:
         for child in self.children:
             child.shrink()
         super().shrink()
@@ -1182,13 +1206,15 @@ def shrink(self):
 class Hlist(List):
     """A horizontal list of boxes."""
 
-    def __init__(self, elements, w=0., m='additional', do_kern=True):
+    def __init__(self, elements: T.Sequence[Node], w: float = 0.0,
+                 m: T.Literal['additional', 'exactly'] = 'additional',
+                 do_kern: bool = True):
         super().__init__(elements)
         if do_kern:
             self.kern()
         self.hpack(w=w, m=m)
 
-    def kern(self):
+    def kern(self) -> None:
         """
         Insert `Kern` nodes between `Char` nodes to set kerning.
 
@@ -1213,21 +1239,8 @@ def kern(self):
                     new_children.append(kern)
             self.children = new_children
 
-    # This is a failed experiment to fake cross-font kerning.
-#     def get_kerning(self, next):
-#         if len(self.children) >= 2 and isinstance(self.children[-2], Char):
-#             if isinstance(next, Char):
-#                 print "CASE A"
-#                 return self.children[-2].get_kerning(next)
-#             elif (isinstance(next, Hlist) and len(next.children)
-#                   and isinstance(next.children[0], Char)):
-#                 print "CASE B"
-#                 result = self.children[-2].get_kerning(next.children[0])
-#                 print result
-#                 return result
-#         return 0.0
-
-    def hpack(self, w=0., m='additional'):
+    def hpack(self, w: float = 0.0,
+              m: T.Literal['additional', 'exactly'] = 'additional') -> None:
         r"""
         Compute the dimensions of the resulting boxes, and adjust the glue if
         one of those dimensions is pre-specified.  The computed sizes normally
@@ -1295,11 +1308,14 @@ def hpack(self, w=0., m='additional'):
 class Vlist(List):
     """A vertical list of boxes."""
 
-    def __init__(self, elements, h=0., m='additional'):
+    def __init__(self, elements: T.Sequence[Node], h: float = 0.0,
+                 m: T.Literal['additional', 'exactly'] = 'additional'):
         super().__init__(elements)
         self.vpack(h=h, m=m)
 
-    def vpack(self, h=0., m='additional', l=np.inf):
+    def vpack(self, h: float = 0.0,
+              m: T.Literal['additional', 'exactly'] = 'additional',
+              l: float = np.inf) -> None:
         """
         Compute the dimensions of the resulting boxes, and to adjust the glue
         if one of those dimensions is pre-specified.
@@ -1382,18 +1398,19 @@ class Rule(Box):
     running in an `Hlist`; the height and depth are never running in a `Vlist`.
     """
 
-    def __init__(self, width, height, depth, state):
+    def __init__(self, width: float, height: float, depth: float, state: ParserState):
         super().__init__(width, height, depth)
         self.fontset = state.fontset
 
-    def render(self, output, x, y, w, h):
+    def render(self, output: Output,  # type: ignore[override]
+               x: float, y: float, w: float, h: float) -> None:
         self.fontset.render_rect_filled(output, x, y, x + w, y + h)
 
 
 class Hrule(Rule):
     """Convenience class to create a horizontal rule."""
 
-    def __init__(self, state, thickness=None):
+    def __init__(self, state: ParserState, thickness: float | None = None):
         if thickness is None:
             thickness = state.get_current_underline_thickness()
         height = depth = thickness * 0.5
@@ -1403,7 +1420,7 @@ def __init__(self, state, thickness=None):
 class Vrule(Rule):
     """Convenience class to create a vertical rule."""
 
-    def __init__(self, state):
+    def __init__(self, state: ParserState):
         thickness = state.get_current_underline_thickness()
         super().__init__(thickness, np.inf, np.inf, state)
 
@@ -1436,7 +1453,10 @@ class Glue(Node):
     it's easier to stick to what TeX does.)
     """
 
-    def __init__(self, glue_type):
+    def __init__(self,
+                 glue_type: _GlueSpec | T.Literal["fil", "fill", "filll",
+                                                  "neg_fil", "neg_fill", "neg_filll",
+                                                  "empty", "ss"]):
         super().__init__()
         if isinstance(glue_type, str):
             glue_spec = _GlueSpec._named[glue_type]  # type: ignore[attr-defined]
@@ -1446,7 +1466,7 @@ def __init__(self, glue_type):
             raise ValueError("glue_type must be a glue spec name or instance")
         self.glue_spec = glue_spec
 
-    def shrink(self):
+    def shrink(self) -> None:
         super().shrink()
         if self.size < NUM_SIZE_LEVELS:
             g = self.glue_spec
@@ -1459,7 +1479,7 @@ class HCentered(Hlist):
     centered within its enclosing box.
     """
 
-    def __init__(self, elements):
+    def __init__(self, elements: list[Node]):
         super().__init__([Glue('ss'), *elements, Glue('ss')], do_kern=False)
 
 
@@ -1469,7 +1489,7 @@ class VCentered(Vlist):
     centered within its enclosing box.
     """
 
-    def __init__(self, elements):
+    def __init__(self, elements: list[Node]):
         super().__init__([Glue('ss'), *elements, Glue('ss')])
 
 
@@ -1487,14 +1507,14 @@ class Kern(Node):
     height = 0
     depth = 0
 
-    def __init__(self, width):
+    def __init__(self, width: float):
         super().__init__()
         self.width = width
 
-    def __repr__(self):
+    def __repr__(self) -> str:
         return "k%.02f" % self.width
 
-    def shrink(self):
+    def shrink(self) -> None:
         super().shrink()
         if self.size < NUM_SIZE_LEVELS:
             self.width *= SHRINK_FACTOR
@@ -1509,7 +1529,8 @@ class AutoHeightChar(Hlist):
     always just return a scaled version of the glyph.
     """
 
-    def __init__(self, c, height, depth, state, always=False, factor=None):
+    def __init__(self, c: str, height: float, depth: float, state: ParserState,
+                 always: bool = False, factor: float | None = None):
         alternatives = state.fontset.get_sized_alternatives_for_symbol(
             state.font, c)
 
@@ -1526,7 +1547,7 @@ def __init__(self, c, height, depth, state, always=False, factor=None):
             if char.height + char.depth >= target_total - 0.2 * xHeight:
                 break
 
-        shift = 0
+        shift = 0.0
         if state.font != 0 or len(alternatives) == 1:
             if factor is None:
                 factor = target_total / (char.height + char.depth)
@@ -1548,7 +1569,8 @@ class AutoWidthChar(Hlist):
     always just return a scaled version of the glyph.
     """
 
-    def __init__(self, c, width, state, always=False, char_class=Char):
+    def __init__(self, c: str, width: float, state: ParserState, always: bool = False,
+                 char_class: type[Char] = Char):
         alternatives = state.fontset.get_sized_alternatives_for_symbol(
             state.font, c)
 
@@ -1567,7 +1589,7 @@ def __init__(self, c, width, state, always=False, char_class=Char):
         self.width = char.width
 
 
-def ship(box, xy=(0, 0)):
+def ship(box: Box, xy: tuple[float, float] = (0, 0)) -> Output:
     """
     Ship out *box* at offset *xy*, converting it to an `Output`.
 
@@ -1584,10 +1606,10 @@ def ship(box, xy=(0, 0)):
     off_v = oy + box.height
     output = Output(box)
 
-    def clamp(value):
+    def clamp(value: float) -> float:
         return -1e9 if value < -1e9 else +1e9 if value > +1e9 else value
 
-    def hlist_out(box):
+    def hlist_out(box: Hlist) -> None:
         nonlocal cur_v, cur_h, off_h, off_v
 
         cur_g = 0
@@ -1612,9 +1634,11 @@ def hlist_out(box):
                     cur_v = base_line + p.shift_amount
                     if isinstance(p, Hlist):
                         hlist_out(p)
-                    else:
+                    elif isinstance(p, Vlist):
                         # p.vpack(box.height + box.depth, 'exactly')
                         vlist_out(p)
+                    else:
+                        assert False, "unreachable code"
                     cur_h = edge + p.width
                     cur_v = base_line
             elif isinstance(p, Box):
@@ -1648,7 +1672,7 @@ def hlist_out(box):
                 rule_width += cur_g
                 cur_h += rule_width
 
-    def vlist_out(box):
+    def vlist_out(box: Vlist) -> None:
         nonlocal cur_v, cur_h, off_h, off_v
 
         cur_g = 0
@@ -1672,8 +1696,10 @@ def vlist_out(box):
                     p.width = box.width
                     if isinstance(p, Hlist):
                         hlist_out(p)
-                    else:
+                    elif isinstance(p, Vlist):
                         vlist_out(p)
+                    else:
+                        assert False, "unreachable code"
                     cur_v = save_v + p.depth
                     cur_h = left_edge
             elif isinstance(p, Box):
@@ -1705,6 +1731,7 @@ def vlist_out(box):
                 raise RuntimeError(
                     "Internal mathtext error: Char node found in vlist")
 
+    assert isinstance(box, Hlist)
     hlist_out(box)
     return output
 
@@ -1713,9 +1740,9 @@ def vlist_out(box):
 # PARSER
 
 
-def Error(msg):
+def Error(msg: str) -> ParserElement:
     """Helper class to raise parser errors."""
-    def raise_error(s, loc, toks):
+    def raise_error(s: str, loc: int, toks: ParseResults) -> T.Any:
         raise ParseFatalException(s, loc, msg)
 
     return Empty().setParseAction(raise_error)
@@ -1732,33 +1759,34 @@ class ParserState:
     and popped accordingly.
     """
 
-    def __init__(self, fontset, font, font_class, fontsize, dpi):
+    def __init__(self, fontset: Fonts, font: str, font_class: str, fontsize: float,
+                 dpi: float):
         self.fontset = fontset
         self._font = font
         self.font_class = font_class
         self.fontsize = fontsize
         self.dpi = dpi
 
-    def copy(self):
+    def copy(self) -> ParserState:
         return copy.copy(self)
 
     @property
-    def font(self):
+    def font(self) -> str:
         return self._font
 
     @font.setter
-    def font(self, name):
+    def font(self, name: str) -> None:
         if name in ('rm', 'it', 'bf', 'bfit'):
             self.font_class = name
         self._font = name
 
-    def get_current_underline_thickness(self):
+    def get_current_underline_thickness(self) -> float:
         """Return the underline thickness for this state."""
         return self.fontset.get_underline_thickness(
             self.font, self.fontsize, self.dpi)
 
 
-def cmd(expr, args):
+def cmd(expr: str, args: ParserElement) -> ParserElement:
     r"""
     Helper to define TeX commands.
 
@@ -1770,7 +1798,7 @@ def cmd(expr, args):
     the error message.
     """
 
-    def names(elt):
+    def names(elt: ParserElement) -> T.Generator[str, None, None]:
         if isinstance(elt, ParseExpression):
             for expr in elt.exprs:
                 yield from names(expr)
@@ -1943,10 +1971,10 @@ class _MathStyle(enum.Enum):
                              ord('\N{GREEK SMALL LETTER OMEGA}') + 1)])
     _latin_alphabets = set(string.ascii_letters)
 
-    def __init__(self):
+    def __init__(self) -> None:
         p = types.SimpleNamespace()
 
-        def set_names_and_parse_actions():
+        def set_names_and_parse_actions() -> None:
             for key, val in vars(p).items():
                 if not key.startswith('_'):
                     # Set names on (almost) everything -- very useful for debugging
@@ -1961,7 +1989,7 @@ def set_names_and_parse_actions():
         # Root definitions.
 
         # In TeX parlance, a csname is a control sequence name (a "\foo").
-        def csnames(group, names):
+        def csnames(group: str, names: Iterable[str]) -> Regex:
             ends_with_alpha = []
             ends_with_nonalpha = []
             for name in names:
@@ -2120,7 +2148,7 @@ def csnames(group, names):
         # To add space to nucleus operators after sub/superscripts
         self._in_subscript_or_superscript = False
 
-    def parse(self, s, fonts_object, fontsize, dpi):
+    def parse(self, s: str, fonts_object: Fonts, fontsize: float, dpi: float) -> Hlist:
         """
         Parse expression *s* using the given *fonts_object* for
         output, at the given *fontsize* and *dpi*.
@@ -2129,43 +2157,43 @@ def parse(self, s, fonts_object, fontsize, dpi):
         """
         self._state_stack = [
             ParserState(fonts_object, 'default', 'rm', fontsize, dpi)]
-        self._em_width_cache = {}
+        self._em_width_cache: dict[tuple[str, float, float], float] = {}
         try:
             result = self._expression.parseString(s)
         except ParseBaseException as err:
             # explain becomes a plain method on pyparsing 3 (err.explain(0)).
             raise ValueError("\n" + ParseException.explain(err, 0)) from None
-        self._state_stack = None
+        self._state_stack = []
         self._in_subscript_or_superscript = False
         # prevent operator spacing from leaking into a new expression
         self._em_width_cache = {}
         ParserElement.resetCache()
-        return result[0]
+        return T.cast(Hlist, result[0])  # Known return type from main.
 
-    def get_state(self):
+    def get_state(self) -> ParserState:
         """Get the current `State` of the parser."""
         return self._state_stack[-1]
 
-    def pop_state(self):
+    def pop_state(self) -> None:
         """Pop a `State` off of the stack."""
         self._state_stack.pop()
 
-    def push_state(self):
+    def push_state(self) -> None:
         """Push a new `State` onto the stack, copying the current state."""
         self._state_stack.append(self.get_state().copy())
 
-    def main(self, toks):
-        return [Hlist(toks)]
+    def main(self, toks: ParseResults) -> list[Hlist]:
+        return [Hlist(toks.asList())]
 
-    def math_string(self, toks):
+    def math_string(self, toks: ParseResults) -> ParseResults:
         return self._math_expression.parseString(toks[0][1:-1], parseAll=True)
 
-    def math(self, toks):
-        hlist = Hlist(toks)
+    def math(self, toks: ParseResults) -> T.Any:
+        hlist = Hlist(toks.asList())
         self.pop_state()
         return [hlist]
 
-    def non_math(self, toks):
+    def non_math(self, toks: ParseResults) -> T.Any:
         s = toks[0].replace(r'\$', '$')
         symbols = [Char(c, self.get_state()) for c in s]
         hlist = Hlist(symbols)
@@ -2176,7 +2204,7 @@ def non_math(self, toks):
 
     float_literal = staticmethod(pyparsing_common.convertToFloat)
 
-    def text(self, toks):
+    def text(self, toks: ParseResults) -> T.Any:
         self.push_state()
         state = self.get_state()
         state.font = 'rm'
@@ -2184,7 +2212,7 @@ def text(self, toks):
         self.pop_state()
         return [hlist]
 
-    def _make_space(self, percentage):
+    def _make_space(self, percentage: float) -> Kern:
         # In TeX, an em (the unit usually used to measure horizontal lengths)
         # is not the width of the character 'm'; it is the same in different
         # font styles (e.g. roman or italic). Mathtext, however, uses 'm' in
@@ -2216,15 +2244,16 @@ def _make_space(self, percentage):
         r'\!':         -0.16667,  # -3/18 em = -3 mu
     }
 
-    def space(self, toks):
+    def space(self, toks: ParseResults) -> T.Any:
         num = self._space_widths[toks["space"]]
         box = self._make_space(num)
         return [box]
 
-    def customspace(self, toks):
+    def customspace(self, toks: ParseResults) -> T.Any:
         return [self._make_space(toks["space"])]
 
-    def symbol(self, s, loc, toks):
+    def symbol(self, s: str, loc: int,
+               toks: ParseResults | dict[str, str]) -> T.Any:
         c = toks["sym"]
         if c == "-":
             # "U+2212 minus sign is the preferred representation of the unary
@@ -2271,7 +2300,7 @@ def symbol(self, s, loc, toks):
                 return [Hlist([char, self._make_space(0.2)], do_kern=True)]
         return [char]
 
-    def unknown_symbol(self, s, loc, toks):
+    def unknown_symbol(self, s: str, loc: int, toks: ParseResults) -> T.Any:
         raise ParseFatalException(s, loc, f"Unknown symbol: {toks['name']}")
 
     _accent_map = {
@@ -2299,11 +2328,12 @@ def unknown_symbol(self, s, loc, toks):
 
     _wide_accents = set(r"widehat widetilde widebar".split())
 
-    def accent(self, toks):
+    def accent(self, toks: ParseResults) -> T.Any:
         state = self.get_state()
         thickness = state.get_current_underline_thickness()
         accent = toks["accent"]
         sym = toks["sym"]
+        accent_box: Node
         if accent in self._wide_accents:
             accent_box = AutoWidthChar(
                 '\\' + accent, sym.width, state, char_class=Accent)
@@ -2320,16 +2350,16 @@ def accent(self, toks):
                 Hlist([sym])
                 ])
 
-    def function(self, s, loc, toks):
+    def function(self, s: str, loc: int, toks: ParseResults) -> T.Any:
         hlist = self.operatorname(s, loc, toks)
         hlist.function_name = toks["name"]
         return hlist
 
-    def operatorname(self, s, loc, toks):
+    def operatorname(self, s: str, loc: int, toks: ParseResults) -> T.Any:
         self.push_state()
         state = self.get_state()
         state.font = 'rm'
-        hlist_list = []
+        hlist_list: list[Node] = []
         # Change the font of Chars, but leave Kerns alone
         name = toks["name"]
         for c in name:
@@ -2360,51 +2390,51 @@ def operatorname(self, s, loc, toks):
 
         return Hlist(hlist_list)
 
-    def start_group(self, toks):
+    def start_group(self, toks: ParseResults) -> T.Any:
         self.push_state()
         # Deal with LaTeX-style font tokens
         if toks.get("font"):
             self.get_state().font = toks.get("font")
         return []
 
-    def group(self, toks):
+    def group(self, toks: ParseResults) -> T.Any:
         grp = Hlist(toks.get("group", []))
         return [grp]
 
-    def required_group(self, toks):
+    def required_group(self, toks: ParseResults) -> T.Any:
         return Hlist(toks.get("group", []))
 
     optional_group = required_group
 
-    def end_group(self):
+    def end_group(self) -> T.Any:
         self.pop_state()
         return []
 
-    def unclosed_group(self, s, loc, toks):
+    def unclosed_group(self, s: str, loc: int, toks: ParseResults) -> T.Any:
         raise ParseFatalException(s, len(s), "Expected '}'")
 
-    def font(self, toks):
+    def font(self, toks: ParseResults) -> T.Any:
         self.get_state().font = toks["font"]
         return []
 
-    def is_overunder(self, nucleus):
+    def is_overunder(self, nucleus: Node) -> bool:
         if isinstance(nucleus, Char):
             return nucleus.c in self._overunder_symbols
         elif isinstance(nucleus, Hlist) and hasattr(nucleus, 'function_name'):
             return nucleus.function_name in self._overunder_functions
         return False
 
-    def is_dropsub(self, nucleus):
+    def is_dropsub(self, nucleus: Node) -> bool:
         if isinstance(nucleus, Char):
             return nucleus.c in self._dropsub_symbols
         return False
 
-    def is_slanted(self, nucleus):
+    def is_slanted(self, nucleus: Node) -> bool:
         if isinstance(nucleus, Char):
             return nucleus.is_slanted()
         return False
 
-    def subsuper(self, s, loc, toks):
+    def subsuper(self, s: str, loc: int, toks: ParseResults) -> T.Any:
         nucleus = toks.get("nucleus", Hbox(0))
         subsuper = toks.get("subsuper", [])
         napostrophes = len(toks.get("apostrophes", []))
@@ -2517,9 +2547,13 @@ def subsuper(self, s, loc, toks):
             else:
                 subkern = 0
 
+        x: List
         if super is None:
             # node757
-            x = Hlist([Kern(subkern), sub])
+            # Note: One of super or sub must be a Node if we're in this function, but
+            # mypy can't know this, since it can't interpret pyparsing expressions,
+            # hence the cast.
+            x = Hlist([Kern(subkern), T.cast(Node, sub)])
             x.shrink()
             if self.is_dropsub(last_char):
                 shift_down = lc_baseline + constants.subdrop * xHeight
@@ -2566,7 +2600,8 @@ def subsuper(self, s, loc, toks):
         result = Hlist(spaced_nucleus)
         return [result]
 
-    def _genfrac(self, ldelim, rdelim, rule, style, num, den):
+    def _genfrac(self, ldelim: str, rdelim: str, rule: float | None, style: _MathStyle,
+                 num: Hlist, den: Hlist) -> T.Any:
         state = self.get_state()
         thickness = state.get_current_underline_thickness()
 
@@ -2601,34 +2636,37 @@ def _genfrac(self, ldelim, rdelim, rule, style, num, den):
                 ldelim = '.'
             if rdelim == '':
                 rdelim = '.'
-            return self._auto_sized_delimiter(ldelim, result, rdelim)
+            return self._auto_sized_delimiter(ldelim,
+                                              T.cast(list[T.Union[Box, Char, str]],
+                                                     result),
+                                              rdelim)
         return result
 
-    def style_literal(self, toks):
+    def style_literal(self, toks: ParseResults) -> T.Any:
         return self._MathStyle(int(toks["style_literal"]))
 
-    def genfrac(self, toks):
+    def genfrac(self, toks: ParseResults) -> T.Any:
         return self._genfrac(
             toks.get("ldelim", ""), toks.get("rdelim", ""),
             toks["rulesize"], toks.get("style", self._MathStyle.TEXTSTYLE),
             toks["num"], toks["den"])
 
-    def frac(self, toks):
+    def frac(self, toks: ParseResults) -> T.Any:
         return self._genfrac(
             "", "", self.get_state().get_current_underline_thickness(),
             self._MathStyle.TEXTSTYLE, toks["num"], toks["den"])
 
-    def dfrac(self, toks):
+    def dfrac(self, toks: ParseResults) -> T.Any:
         return self._genfrac(
             "", "", self.get_state().get_current_underline_thickness(),
             self._MathStyle.DISPLAYSTYLE, toks["num"], toks["den"])
 
-    def binom(self, toks):
+    def binom(self, toks: ParseResults) -> T.Any:
         return self._genfrac(
             "(", ")", 0,
             self._MathStyle.TEXTSTYLE, toks["num"], toks["den"])
 
-    def _genset(self, s, loc, toks):
+    def _genset(self, s: str, loc: int, toks: ParseResults) -> T.Any:
         annotation = toks["annotation"]
         body = toks["body"]
         thickness = self.get_state().get_current_underline_thickness()
@@ -2660,7 +2698,7 @@ def _genset(self, s, loc, toks):
 
     overset = underset = _genset
 
-    def sqrt(self, toks):
+    def sqrt(self, toks: ParseResults) -> T.Any:
         root = toks.get("root")
         body = toks["value"]
         state = self.get_state()
@@ -2700,7 +2738,7 @@ def sqrt(self, toks):
                        rightside])               # Body
         return [hlist]
 
-    def overline(self, toks):
+    def overline(self, toks: ParseResults) -> T.Any:
         body = toks["body"]
 
         state = self.get_state()
@@ -2719,7 +2757,9 @@ def overline(self, toks):
         hlist = Hlist([rightside])
         return [hlist]
 
-    def _auto_sized_delimiter(self, front, middle, back):
+    def _auto_sized_delimiter(self, front: str,
+                              middle: list[Box | Char | str],
+                              back: str) -> T.Any:
         state = self.get_state()
         if len(middle):
             height = max([x.height for x in middle if not isinstance(x, str)])
@@ -2727,41 +2767,45 @@ def _auto_sized_delimiter(self, front, middle, back):
             factor = None
             for idx, el in enumerate(middle):
                 if isinstance(el, str) and el == '\\middle':
-                    c = middle[idx + 1]
+                    c = T.cast(str, middle[idx + 1])  # Should be one of p.delims.
                     if c != '.':
                         middle[idx + 1] = AutoHeightChar(
                                 c, height, depth, state, factor=factor)
                     else:
                         middle.remove(c)
                     del middle[idx]
+            # There should only be \middle and its delimiter as str, which have
+            # just been removed.
+            middle_part = T.cast(list[T.Union[Box, Char]], middle)
         else:
             height = 0
             depth = 0
             factor = 1.0
+            middle_part = []
 
-        parts = []
+        parts: list[Node] = []
         # \left. and \right. aren't supposed to produce any symbols
         if front != '.':
             parts.append(
                 AutoHeightChar(front, height, depth, state, factor=factor))
-        parts.extend(middle)
+        parts.extend(middle_part)
         if back != '.':
             parts.append(
                 AutoHeightChar(back, height, depth, state, factor=factor))
         hlist = Hlist(parts)
         return hlist
 
-    def auto_delim(self, toks):
+    def auto_delim(self, toks: ParseResults) -> T.Any:
         return self._auto_sized_delimiter(
             toks["left"],
             # if "mid" in toks ... can be removed when requiring pyparsing 3.
             toks["mid"].asList() if "mid" in toks else [],
             toks["right"])
 
-    def boldsymbol(self, toks):
+    def boldsymbol(self, toks: ParseResults) -> T.Any:
         self.push_state()
         state = self.get_state()
-        hlist = []
+        hlist: list[Node] = []
         name = toks["value"]
         for c in name:
             if isinstance(c, Hlist):
@@ -2784,7 +2828,7 @@ def boldsymbol(self, toks):
 
         return Hlist(hlist)
 
-    def substack(self, toks):
+    def substack(self, toks: ParseResults) -> T.Any:
         parts = toks["parts"]
         state = self.get_state()
         thickness = state.get_current_underline_thickness()
diff --git a/lib/matplotlib/_mathtext_data.py b/lib/matplotlib/_mathtext_data.py
index d37cdff22e57..8f413b2a1673 100644
--- a/lib/matplotlib/_mathtext_data.py
+++ b/lib/matplotlib/_mathtext_data.py
@@ -2,6 +2,9 @@
 font data tables for truetype and afm computer modern fonts
 """
 
+from __future__ import annotations
+
+
 latex_to_bakoma = {
     '\\__sqrt__'                 : ('cmex10', 0x70),
     '\\bigcap'                   : ('cmex10', 0x5c),
@@ -1099,7 +1102,8 @@
 # Each element is a 4-tuple of the form:
 #   src_start, src_end, dst_font, dst_start
 #
-stix_virtual_fonts = {
+stix_virtual_fonts: dict[str, dict[str, list[tuple[int, int, str, int]]] |
+                              list[tuple[int, int, str, int]]] = {
     'bb':
         {
         'rm':

From 2293d6595798ee6448790d70b02a93abdc4bed99 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 16 Aug 2023 07:08:04 -0400
Subject: [PATCH 0090/1120] TYP: Add overloads for MathTextParser return types

---
 lib/matplotlib/backends/backend_agg.py |  2 +-
 lib/matplotlib/mathtext.pyi            | 15 ++++++++++-----
 lib/matplotlib/textpath.pyi            |  4 ++--
 3 files changed, 13 insertions(+), 8 deletions(-)

diff --git a/lib/matplotlib/backends/backend_agg.py b/lib/matplotlib/backends/backend_agg.py
index 9008096253c6..470ce9d925ad 100644
--- a/lib/matplotlib/backends/backend_agg.py
+++ b/lib/matplotlib/backends/backend_agg.py
@@ -71,7 +71,7 @@ def __init__(self, width, height, dpi):
         self._filter_renderers = []
 
         self._update_methods()
-        self.mathtext_parser = MathTextParser('Agg')
+        self.mathtext_parser = MathTextParser('agg')
 
         self.bbox = Bbox.from_bounds(0, 0, self.width, self.height)
 
diff --git a/lib/matplotlib/mathtext.pyi b/lib/matplotlib/mathtext.pyi
index 706f83a6b168..607501a275c6 100644
--- a/lib/matplotlib/mathtext.pyi
+++ b/lib/matplotlib/mathtext.pyi
@@ -1,5 +1,8 @@
 import os
+from typing import Generic, IO, Literal, TypeVar, overload
+
 from matplotlib.font_manager import FontProperties
+from matplotlib.typing import ColorType
 
 # Re-exported API from _mathtext.
 from ._mathtext import (
@@ -8,14 +11,16 @@ from ._mathtext import (
     get_unicode_index as get_unicode_index,
 )
 
-from typing import IO, Literal
-from matplotlib.typing import ColorType
+_ParseType = TypeVar("_ParseType", RasterParse, VectorParse)
 
-class MathTextParser:
-    def __init__(self, output: Literal["path", "agg", "raster", "macosx"]) -> None: ...
+class MathTextParser(Generic[_ParseType]):
+    @overload
+    def __init__(self: MathTextParser[VectorParse], output: Literal["path"]) -> None: ...
+    @overload
+    def __init__(self: MathTextParser[RasterParse], output: Literal["agg", "raster", "macosx"]) -> None: ...
     def parse(
         self, s: str, dpi: float = ..., prop: FontProperties | None = ..., *, antialiased: bool | None = ...
-    ) -> RasterParse | VectorParse: ...
+    ) -> _ParseType: ...
 
 def math_to_image(
     s: str,
diff --git a/lib/matplotlib/textpath.pyi b/lib/matplotlib/textpath.pyi
index 6e49a3e8092d..34d4e92ac47e 100644
--- a/lib/matplotlib/textpath.pyi
+++ b/lib/matplotlib/textpath.pyi
@@ -1,6 +1,6 @@
 from matplotlib.font_manager import FontProperties
 from matplotlib.ft2font import FT2Font
-from matplotlib.mathtext import MathTextParser
+from matplotlib.mathtext import MathTextParser, VectorParse
 from matplotlib.path import Path
 
 import numpy as np
@@ -10,7 +10,7 @@ from typing import Literal
 class TextToPath:
     FONT_SCALE: float
     DPI: float
-    mathtext_parser: MathTextParser
+    mathtext_parser: MathTextParser[VectorParse]
     def __init__(self) -> None: ...
     def get_text_width_height_descent(
         self, s: str, prop: FontProperties, ismath: bool | Literal["TeX"]

From 7e5cc665d9d8e67732fbd41cc654a614f2fb45bd Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 30 Aug 2023 16:51:01 -0400
Subject: [PATCH 0091/1120] TYP: Fix types of errorbar *lims arguments

---
 lib/matplotlib/axes/_axes.py  | 2 +-
 lib/matplotlib/axes/_axes.pyi | 8 ++++----
 lib/matplotlib/pyplot.py      | 8 ++++----
 3 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 4d5907503f09..db0ffe0aaabd 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -3436,7 +3436,7 @@ def errorbar(self, x, y, yerr=None, xerr=None,
             If True, will plot the errorbars above the plot
             symbols. Default is below.
 
-        lolims, uplims, xlolims, xuplims : bool, default: False
+        lolims, uplims, xlolims, xuplims : bool or array-like, default: False
             These arguments can be used to indicate that a value gives only
             upper/lower limits.  In that case a caret symbol is used to
             indicate this. *lims*-arguments may be scalars, or array-likes of
diff --git a/lib/matplotlib/axes/_axes.pyi b/lib/matplotlib/axes/_axes.pyi
index 30c0622b89f5..6eeec5cae7fc 100644
--- a/lib/matplotlib/axes/_axes.pyi
+++ b/lib/matplotlib/axes/_axes.pyi
@@ -332,10 +332,10 @@ class Axes(_AxesBase):
         elinewidth: float | None = ...,
         capsize: float | None = ...,
         barsabove: bool = ...,
-        lolims: bool = ...,
-        uplims: bool = ...,
-        xlolims: bool = ...,
-        xuplims: bool = ...,
+        lolims: bool | ArrayLike = ...,
+        uplims: bool | ArrayLike = ...,
+        xlolims: bool | ArrayLike = ...,
+        xuplims: bool | ArrayLike = ...,
         errorevery: int | tuple[int, int] = ...,
         capthick: float | None = ...,
         *,
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 04fdcbc744c9..95ddd9bd7045 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -2961,10 +2961,10 @@ def errorbar(
     elinewidth: float | None = None,
     capsize: float | None = None,
     barsabove: bool = False,
-    lolims: bool = False,
-    uplims: bool = False,
-    xlolims: bool = False,
-    xuplims: bool = False,
+    lolims: bool | ArrayLike = False,
+    uplims: bool | ArrayLike = False,
+    xlolims: bool | ArrayLike = False,
+    xuplims: bool | ArrayLike = False,
     errorevery: int | tuple[int, int] = 1,
     capthick: float | None = None,
     *,

From fa2304c681bc3e595f6040e9b66a0238c520908c Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 30 Aug 2023 20:00:53 -0400
Subject: [PATCH 0092/1120] TYP: Fix return types of Gcf getters

Some return None when there is no figure available.
---
 lib/matplotlib/_pylab_helpers.pyi | 6 ++++--
 lib/matplotlib/pyplot.py          | 2 +-
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/_pylab_helpers.pyi b/lib/matplotlib/_pylab_helpers.pyi
index 6e1c8889833f..bdd8cfba3173 100644
--- a/lib/matplotlib/_pylab_helpers.pyi
+++ b/lib/matplotlib/_pylab_helpers.pyi
@@ -6,7 +6,7 @@ from matplotlib.figure import Figure
 class Gcf:
     figs: OrderedDict[int, FigureManagerBase]
     @classmethod
-    def get_fig_manager(cls, num: int) -> FigureManagerBase: ...
+    def get_fig_manager(cls, num: int) -> FigureManagerBase | None: ...
     @classmethod
     def destroy(cls, num: int | FigureManagerBase) -> None: ...
     @classmethod
@@ -20,7 +20,9 @@ class Gcf:
     @classmethod
     def get_num_fig_managers(cls) -> int: ...
     @classmethod
-    def get_active(cls) -> FigureManagerBase: ...
+    def get_active(cls) -> FigureManagerBase | None: ...
+    @classmethod
+    def _set_new_active_manager(cls, manager: FigureManagerBase) -> None: ...
     @classmethod
     def set_active(cls, manager: FigureManagerBase) -> None: ...
     @classmethod
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 95ddd9bd7045..976e997a472b 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -938,7 +938,7 @@ def figure(
 
         for hookspecs in rcParams["figure.hooks"]:
             module_name, dotted_name = hookspecs.split(":")
-            obj = importlib.import_module(module_name)
+            obj: Any = importlib.import_module(module_name)
             for part in dotted_name.split("."):
                 obj = getattr(obj, part)
             obj(fig)

From 6e86bdfa2d3b787c5436db312ac23c67bbeceb69 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 30 Aug 2023 20:58:18 -0400
Subject: [PATCH 0093/1120] TYP: Accept tuples in Legend handles list

Fixes #26639
---
 lib/matplotlib/axes/_axes.py  | 5 ++++-
 lib/matplotlib/axes/_axes.pyi | 4 ++--
 lib/matplotlib/legend.py      | 4 ++--
 lib/matplotlib/legend.pyi     | 2 +-
 4 files changed, 9 insertions(+), 6 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index db0ffe0aaabd..c1ad5956e2cb 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -280,7 +280,7 @@ def legend(self, *args, **kwargs):
 
         Parameters
         ----------
-        handles : sequence of `.Artist`, optional
+        handles : sequence of (`.Artist` or tuple of `.Artist`), optional
             A list of Artists (lines, patches) to be added to the legend.
             Use this together with *labels*, if you need full control on what
             is shown in the legend and the automatic mechanism described above
@@ -289,6 +289,9 @@ def legend(self, *args, **kwargs):
             The length of handles and labels should be the same in this
             case. If they are not, they are truncated to the smaller length.
 
+            If an entry contains a tuple, then the legend handler for all Artists in the
+            tuple will be placed alongside a single label.
+
         labels : list of str, optional
             A list of labels to show next to the artists.
             Use this together with *handles*, if you need full control on what
diff --git a/lib/matplotlib/axes/_axes.pyi b/lib/matplotlib/axes/_axes.pyi
index 6eeec5cae7fc..96ea087f7eb9 100644
--- a/lib/matplotlib/axes/_axes.pyi
+++ b/lib/matplotlib/axes/_axes.pyi
@@ -57,9 +57,9 @@ class Axes(_AxesBase):
     @overload
     def legend(self) -> Legend: ...
     @overload
-    def legend(self, handles: Sequence[Artist], labels: Sequence[str], **kwargs) -> Legend: ...
+    def legend(self, handles: Sequence[Artist | tuple[Artist, ...]], labels: Sequence[str], **kwargs) -> Legend: ...
     @overload
-    def legend(self, *, handles: Sequence[Artist], **kwargs) -> Legend: ...
+    def legend(self, *, handles: Sequence[Artist | tuple[Artist, ...]], **kwargs) -> Legend: ...
     @overload
     def legend(self, labels: Sequence[str], **kwargs) -> Legend: ...
     @overload
diff --git a/lib/matplotlib/legend.py b/lib/matplotlib/legend.py
index 18d0ee913237..bdabacdfedbf 100644
--- a/lib/matplotlib/legend.py
+++ b/lib/matplotlib/legend.py
@@ -401,7 +401,7 @@ def __init__(
         parent : `~matplotlib.axes.Axes` or `.Figure`
             The artist that contains the legend.
 
-        handles : list of `.Artist`
+        handles : list of (`.Artist` or tuple of `.Artist`)
             A list of Artists (lines, patches) to be added to the legend.
 
         labels : list of str
@@ -1322,7 +1322,7 @@ def _parse_legend_args(axs, *args, handles=None, labels=None, **kwargs):
 
     Returns
     -------
-    handles : list of `.Artist`
+    handles : list of (`.Artist` or tuple of `.Artist`)
         The legend handles.
     labels : list of str
         The legend labels.
diff --git a/lib/matplotlib/legend.pyi b/lib/matplotlib/legend.pyi
index 077aaf672d39..d559b06c5d5d 100644
--- a/lib/matplotlib/legend.pyi
+++ b/lib/matplotlib/legend.pyi
@@ -52,7 +52,7 @@ class Legend(Artist):
     def __init__(
         self,
         parent: Axes | Figure,
-        handles: Iterable[Artist],
+        handles: Iterable[Artist | tuple[Artist, ...]],
         labels: Iterable[str],
         *,
         loc: str | tuple[float, float] | int | None = ...,

From af6fbefcfdaf04cb28c0626b4a3e620f50c7216f Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Tue, 8 Aug 2023 05:42:50 -0400
Subject: [PATCH 0094/1120] restructured explanation and turned notes in
 special characters section

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Co-authored-by: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
---
 galleries/users_explain/text/mathtext.py | 719 +++++++++++------------
 1 file changed, 358 insertions(+), 361 deletions(-)

diff --git a/galleries/users_explain/text/mathtext.py b/galleries/users_explain/text/mathtext.py
index 0b786e3e7ed0..09c049d4a833 100644
--- a/galleries/users_explain/text/mathtext.py
+++ b/galleries/users_explain/text/mathtext.py
@@ -7,365 +7,362 @@
 Writing mathematical expressions
 ================================
 
-You can use a subset of TeX markup in any Matplotlib text string by placing it
-inside a pair of dollar signs ($).
-
-Note that you do not need to have TeX installed, since Matplotlib ships
-its own TeX expression parser, layout engine, and fonts.  The layout engine
-is a fairly direct adaptation of the layout algorithms in Donald Knuth's
-TeX, so the quality is quite good (Matplotlib also provides a ``usetex``
-option for those who do want to call out to TeX to generate their text; see
-:ref:`usetex`).
-
-Any text element can use math text.  You should use raw strings (precede the
-quotes with an ``'r'``), and surround the math text with dollar signs ($), as
-in TeX. Regular text and mathtext can be interleaved within the same string.
-Mathtext can use DejaVu Sans (default), DejaVu Serif, the Computer Modern fonts
-(from (La)TeX), `STIX <http://www.stixfonts.org/>`_ fonts (which are designed
-to blend well with Times), or a Unicode font that you provide.  The mathtext
-font can be selected via :rc:`mathtext.fontset` (see
-:ref:`customizing`)
-
-Here is a simple example::
-
-    # plain text
-    plt.title('alpha > beta')
-
-produces "alpha > beta".
-
-Whereas this::
-
-    # math text
-    plt.title(r'$\alpha > \beta$')
-
-produces ":mathmpl:`\alpha > \beta`".
-
-.. note::
-   Mathtext should be placed between a pair of dollar signs ($). To make it
-   easy to display monetary values, e.g., "$100.00", if a single dollar sign
-   is present in the entire string, it will be displayed verbatim as a dollar
-   sign.  This is a small change from regular TeX, where the dollar sign in
-   non-math text would have to be escaped ('\\\$').
-
-.. note::
-   While the syntax inside the pair of dollar signs ($) aims to be TeX-like,
-   the text outside does not.  In particular, characters such as::
-
-     # $ % & ~ _ ^ \ { } \( \) \[ \]
-
-   have special meaning outside of math mode in TeX.  Therefore, these
-   characters will behave differently depending on :rc:`text.usetex`.  See the
-   :ref:`usetex tutorial <usetex>` for more information.
-
-.. note::
-   To generate html output in documentation that will exactly match the output
-   generated by ``mathtext``, use the `matplotlib.sphinxext.mathmpl` Sphinx
-   extension.
-
-Subscripts and superscripts
----------------------------
-To make subscripts and superscripts, use the ``'_'`` and ``'^'`` symbols::
-
-    r'$\alpha_i > \beta_i$'
-
-.. math::
-
-    \alpha_i > \beta_i
-
-To display multi-letter subscripts or superscripts correctly,
-you should put them in curly braces ``{...}``::
-
-    r'$\alpha^{ic} > \beta_{ic}$'
-
-.. math::
-
-    \alpha^{ic} > \beta_{ic}
-
-Some symbols automatically put their sub/superscripts under and over the
-operator.  For example, to write the sum of :mathmpl:`x_i` from :mathmpl:`0` to
-:mathmpl:`\infty`, you could do::
-
-    r'$\sum_{i=0}^\infty x_i$'
-
-.. math::
-
-    \sum_{i=0}^\infty x_i
-
-Fractions, binomials, and stacked numbers
------------------------------------------
-Fractions, binomials, and stacked numbers can be created with the
-``\frac{}{}``, ``\binom{}{}`` and ``\genfrac{}{}{}{}{}{}`` commands,
-respectively::
-
-    r'$\frac{3}{4} \binom{3}{4} \genfrac{}{}{0}{}{3}{4}$'
-
-produces
-
-.. math::
-
-    \frac{3}{4} \binom{3}{4} \genfrac{}{}{0pt}{}{3}{4}
-
-Fractions can be arbitrarily nested::
-
-    r'$\frac{5 - \frac{1}{x}}{4}$'
-
-produces
-
-.. math::
-
-    \frac{5 - \frac{1}{x}}{4}
-
-Note that special care needs to be taken to place parentheses and brackets
-around fractions.  Doing things the obvious way produces brackets that are too
-small::
-
-    r'$(\frac{5 - \frac{1}{x}}{4})$'
-
-.. math::
-
-    (\frac{5 - \frac{1}{x}}{4})
-
-The solution is to precede the bracket with ``\left`` and ``\right`` to inform
-the parser that those brackets encompass the entire object.::
-
-    r'$\left(\frac{5 - \frac{1}{x}}{4}\right)$'
-
-.. math::
-
-    \left(\frac{5 - \frac{1}{x}}{4}\right)
-
-Radicals
---------
-Radicals can be produced with the ``\sqrt[]{}`` command.  For example::
-
-    r'$\sqrt{2}$'
-
-.. math::
-
-    \sqrt{2}
-
-Any base can (optionally) be provided inside square brackets.  Note that the
-base must be a simple expression, and cannot contain layout commands such as
-fractions or sub/superscripts::
-
-    r'$\sqrt[3]{x}$'
-
-.. math::
-
-    \sqrt[3]{x}
-
-.. _mathtext-fonts:
-
-Fonts
------
-The default font is *italics* for mathematical symbols.
-
-.. note::
-
-   This default can be changed using :rc:`mathtext.default`.  This is
-   useful, for example, to use the same font as regular non-math text for math
-   text, by setting it to ``regular``.
-
-To change fonts, e.g., to write "sin" in a Roman font, enclose the text in a
-font command::
-
-    r'$s(t) = \mathcal{A}\mathrm{sin}(2 \omega t)$'
-
-.. math::
-
-    s(t) = \mathcal{A}\mathrm{sin}(2 \omega t)
-
-More conveniently, many commonly used function names that are typeset in
-a Roman font have shortcuts.  So the expression above could be written as
-follows::
-
-    r'$s(t) = \mathcal{A}\sin(2 \omega t)$'
-
-.. math::
-
-    s(t) = \mathcal{A}\sin(2 \omega t)
-
-Here "s" and "t" are variable in italics font (default), "sin" is in Roman
-font, and the amplitude "A" is in calligraphy font.  Note in the example above
-the calligraphy ``A`` is squished into the ``sin``.  You can use a spacing
-command to add a little whitespace between them::
-
-    r's(t) = \mathcal{A}\/\sin(2 \omega t)'
-
-.. Here we cheat a bit: for HTML math rendering, Sphinx relies on MathJax which
-   doesn't actually support the italic correction (\/); instead, use a thin
-   space (\,) which is supported.
-
-.. math::
-
-    s(t) = \mathcal{A}\,\sin(2 \omega t)
-
-The choices available with all fonts are:
-
-========================= ================================
-Command                   Result
-========================= ================================
-``\mathrm{Roman}``        :mathmpl:`\mathrm{Roman}`
-``\mathit{Italic}``       :mathmpl:`\mathit{Italic}`
-``\mathtt{Typewriter}``   :mathmpl:`\mathtt{Typewriter}`
-``\mathcal{CALLIGRAPHY}`` :mathmpl:`\mathcal{CALLIGRAPHY}`
-========================= ================================
-
-.. role:: math-stix(mathmpl)
-   :fontset: stix
-
-When using the `STIX <http://www.stixfonts.org/>`_ fonts, you also have the
-choice of:
-
-================================ =========================================
-Command                          Result
-================================ =========================================
-``\mathbb{blackboard}``          :math-stix:`\mathbb{blackboard}`
-``\mathrm{\mathbb{blackboard}}`` :math-stix:`\mathrm{\mathbb{blackboard}}`
-``\mathfrak{Fraktur}``           :math-stix:`\mathfrak{Fraktur}`
-``\mathsf{sansserif}``           :math-stix:`\mathsf{sansserif}`
-``\mathrm{\mathsf{sansserif}}``  :math-stix:`\mathrm{\mathsf{sansserif}}`
-``\mathbfit{bolditalic}``        :math-stix:`\mathbfit{bolditalic}`
-================================ =========================================
-
-There are also five global "font sets" to choose from, which are
-selected using the ``mathtext.fontset`` parameter in :ref:`matplotlibrc
-<matplotlibrc-sample>`.
-
-``dejavusans``: DejaVu Sans
-    .. mathmpl::
-       :fontset: dejavusans
-
-       \mathcal{R} \prod_{i=\alpha}^{\infty} a_i \sin\left(2\pi fx_i\right)
-
-``dejavuserif``: DejaVu Serif
-    .. mathmpl::
-       :fontset: dejavuserif
-
-       \mathcal{R} \prod_{i=\alpha}^{\infty} a_i \sin\left(2\pi fx_i\right)
-
-``cm``: Computer Modern (TeX)
-    .. mathmpl::
-       :fontset: cm
-
-       \mathcal{R} \prod_{i=\alpha}^{\infty} a_i \sin\left(2\pi fx_i\right)
-
-``stix``: STIX (designed to blend well with Times)
-    .. mathmpl::
-       :fontset: stix
-
-       \mathcal{R} \prod_{i=\alpha}^{\infty} a_i \sin\left(2\pi fx_i\right)
-
-``stixsans``: STIX sans-serif
-    .. mathmpl::
-       :fontset: stixsans
-
-       \mathcal{R} \prod_{i=\alpha}^{\infty} a_i \sin\left(2\pi fx_i\right)
-
-Additionally, you can use ``\mathdefault{...}`` or its alias
-``\mathregular{...}`` to use the font used for regular text outside of
-mathtext.  There are a number of limitations to this approach, most notably
-that far fewer symbols will be available, but it can be useful to make math
-expressions blend well with other text in the plot.
-
-For compatibility with popular packages, ``\text{...}`` is available and uses the
-``\mathrm{...}`` font, but otherwise retains spaces and renders - as a dash
-(not minus).
-
-Custom fonts
-~~~~~~~~~~~~
-mathtext also provides a way to use custom fonts for math.  This method is
-fairly tricky to use, and should be considered an experimental feature for
-patient users only.  By setting :rc:`mathtext.fontset` to ``custom``,
-you can then set the following parameters, which control which font file to use
-for a particular set of math characters.
-
-============================== =================================
-Parameter                      Corresponds to
-============================== =================================
-``mathtext.it``                ``\mathit{}`` or default italic
-``mathtext.rm``                ``\mathrm{}`` Roman (upright)
-``mathtext.tt``                ``\mathtt{}`` Typewriter (monospace)
-``mathtext.bf``                ``\mathbf{}`` bold
-``mathtext.bfit``              ``\mathbfit{}`` bold italic
-``mathtext.cal``               ``\mathcal{}`` calligraphic
-``mathtext.sf``                ``\mathsf{}`` sans-serif
-============================== =================================
-
-Each parameter should be set to a fontconfig font descriptor (as defined in the
-yet-to-be-written font chapter).
-
-.. TODO: Link to font chapter
-
-The fonts used should have a Unicode mapping in order to find any
-non-Latin characters, such as Greek.  If you want to use a math symbol
-that is not contained in your custom fonts, you can set
-:rc:`mathtext.fallback` to either ``'cm'``, ``'stix'`` or ``'stixsans'``
-which will cause the mathtext system to use
-characters from an alternative font whenever a particular
-character cannot be found in the custom font.
-
-Note that the math glyphs specified in Unicode have evolved over time, and many
-fonts may not have glyphs in the correct place for mathtext.
-
-Accents
--------
-An accent command may precede any symbol to add an accent above it.  There are
-long and short forms for some of them.
-
-============================== =================================
-Command                        Result
-============================== =================================
-``\acute a`` or ``\'a``        :mathmpl:`\acute a`
-``\bar a``                     :mathmpl:`\bar a`
-``\breve a``                   :mathmpl:`\breve a`
-``\dot a`` or ``\.a``          :mathmpl:`\dot a`
-``\ddot a`` or ``\''a``        :mathmpl:`\ddot a`
-``\dddot a``                   :mathmpl:`\dddot a`
-``\ddddot a``                  :mathmpl:`\ddddot a`
-``\grave a`` or ``\`a``        :mathmpl:`\grave a`
-``\hat a`` or ``\^a``          :mathmpl:`\hat a`
-``\tilde a`` or ``\~a``        :mathmpl:`\tilde a`
-``\vec a``                     :mathmpl:`\vec a`
-``\overline{abc}``             :mathmpl:`\overline{abc}`
-============================== =================================
-
-In addition, there are two special accents that automatically adjust to the
-width of the symbols below:
-
-============================== =================================
-Command                        Result
-============================== =================================
-``\widehat{xyz}``              :mathmpl:`\widehat{xyz}`
-``\widetilde{xyz}``            :mathmpl:`\widetilde{xyz}`
-============================== =================================
-
-Care should be taken when putting accents on lower-case i's and j's.  Note that
-in the following ``\imath`` is used to avoid the extra dot over the i::
-
-    r"$\hat i\ \ \hat \imath$"
-
-.. math::
-
-    \hat i\ \ \hat \imath
-
-Symbols
--------
-You can also use a large number of the TeX symbols, as in ``\infty``,
-``\leftarrow``, ``\sum``, ``\int``.
-
-.. math_symbol_table::
-
-If a particular symbol does not have a name (as is true of many of the more
-obscure symbols in the STIX fonts), Unicode characters can also be used::
-
-   r'$\u23ce$'
-
-Example
--------
-Here is an example illustrating many of these features in context.
-
-.. figure:: /gallery/text_labels_and_annotations/images/sphx_glr_mathtext_demo_001.png
-   :target: /gallery/text_labels_and_annotations/mathtext_demo.html
-   :align: center
+Matplotlib implements a lightweight TeX expression parser and layout engine and
+*Mathtext* is the subset of Tex markup that this engine supports. Any string can
+be processed as Mathtext by placing the string inside a pair of dollar signs
+``'$'``. Mathtext often contains many backslashes ``'\'``; so that the backslashes
+do not need to be escaped, Mathtext is often written using raw strings. For
+example:
 """
+
+import matplotlib.pyplot as plt
+
+fig = plt.figure(figsize=(3, 3), linewidth=1, edgecolor='black')
+fig.text(.2, .7, "plain text: alpha > beta")
+fig.text(.2, .5, "Mathtext: $\\alpha > \\beta$")
+fig.text(.2, .3, r"raw string Mathtext: $\alpha > \beta$")
+
+# %%
+# .. seealso::
+#
+#   :doc:`Mathtext example </gallery/text_labels_and_annotations/mathtext_demo>`
+#
+# TeX does *not* need to be installed to use Mathtext because Matplotlib ships
+# with the Mathtext parser and engine. The Mathtext layout engine is a fairly
+# direct adaptation of the layout algorithms in Donald Knuth's TeX. To render
+# mathematical text using a different TeX engine, see :ref:`usetex`.
+#
+# .. note::
+#   To generate html output in documentation that will exactly match the output
+#   generated by ``mathtext``, use the `matplotlib.sphinxext.mathmpl` Sphinx
+#   extension.
+#
+#
+# Special characters
+# ------------------
+#
+# Mathtext must be placed between a pair of (US) dollar signs ``'$'``. A literal
+# dollar symbol ``'$'`` in a string containing Mathtext must be escaped using a
+# backslash: ``'\$'``. A string may contain multiple pairs of dollar signs,
+# resulting in multiple Mathtext expressions. Strings with an odd number of
+# dollar signs are rendered solely as plain text.
+
+fig = plt.figure(figsize=(3, 3), linewidth=1, edgecolor='black')
+fig.suptitle("Number of unescaped $")
+fig.text(.1, .7, r"odd: $ \alpha $ = $1")
+fig.text(.1, .5, r"even: $ \beta $= $ 2 $")
+fig.text(.1, .3, r'odd: $ \gamma $= \$3 $')
+fig.text(.1, .1, r'even: $ \delta $ = $ \$4 $')
+
+# %%
+# While Mathtext aims for compatibility with regular TeX, it diverges on when
+# special characters need to be escaped. In TeX the dollar sign must be escaped
+# ``'\$'`` in non-math text, while in Matplotlib the dollar sign must be
+# escaped when writing Mathtext.
+#
+# These other special characters are also escaped in non-math TeX, while in
+# Matplotlib their behavior is dependent on how :rc:`text.usetex` is set::
+#
+#    # $ % & ~ _ ^ \ { } \( \) \[ \]
+#
+# See the :ref:`usetex tutorial <usetex>` for more information.
+#
+#
+# Subscripts and superscripts
+# ---------------------------
+# To make subscripts and superscripts, use the ``'_'`` and ``'^'`` symbols::
+#
+#     r'$\alpha_i > \beta_i$'
+#
+# .. math::
+#
+#     \alpha_i > \beta_i
+#
+# To display multi-letter subscripts or superscripts correctly,
+# you should put them in curly braces ``{...}``::
+#
+#     r'$\alpha^{ic} > \beta_{ic}$'
+#
+# .. math::
+#
+#     \alpha^{ic} > \beta_{ic}
+#
+# Some symbols automatically put their sub/superscripts under and over the
+# operator.  For example, to write the sum of :mathmpl:`x_i` from :mathmpl:`0` to
+# :mathmpl:`\infty`, you could do::
+#
+#     r'$\sum_{i=0}^\infty x_i$'
+#
+# .. math::
+#
+#     \sum_{i=0}^\infty x_i
+#
+# Fractions, binomials, and stacked numbers
+# -----------------------------------------
+# Fractions, binomials, and stacked numbers can be created with the
+# ``\frac{}{}``, ``\binom{}{}`` and ``\genfrac{}{}{}{}{}{}`` commands,
+# respectively::
+#
+#     r'$\frac{3}{4} \binom{3}{4} \genfrac{}{}{0}{}{3}{4}$'
+#
+# produces
+#
+# .. math::
+#
+#     \frac{3}{4} \binom{3}{4} \genfrac{}{}{0pt}{}{3}{4}
+#
+# Fractions can be arbitrarily nested::
+#
+#     r'$\frac{5 - \frac{1}{x}}{4}$'
+#
+# produces
+#
+# .. math::
+#
+#     \frac{5 - \frac{1}{x}}{4}
+#
+# Note that special care needs to be taken to place parentheses and brackets
+# around fractions.  Doing things the obvious way produces brackets that are too
+# small::
+#
+#     r'$(\frac{5 - \frac{1}{x}}{4})$'
+#
+# .. math::
+#
+#     (\frac{5 - \frac{1}{x}}{4})
+#
+# The solution is to precede the bracket with ``\left`` and ``\right`` to inform
+# the parser that those brackets encompass the entire object.::
+#
+#     r'$\left(\frac{5 - \frac{1}{x}}{4}\right)$'
+#
+# .. math::
+#
+#     \left(\frac{5 - \frac{1}{x}}{4}\right)
+#
+# Radicals
+# --------
+# Radicals can be produced with the ``\sqrt[]{}`` command.  For example::
+#
+#     r'$\sqrt{2}$'
+#
+# .. math::
+#
+#     \sqrt{2}
+#
+# Any base can (optionally) be provided inside square brackets.  Note that the
+# base must be a simple expression, and cannot contain layout commands such as
+# fractions or sub/superscripts::
+#
+#     r'$\sqrt[3]{x}$'
+#
+# .. math::
+#
+#     \sqrt[3]{x}
+#
+# .. _mathtext-fonts:
+#
+# Fonts
+# -----
+#
+# The default font is *italics* for mathematical symbols.
+#
+# This default can be changed using :rc:`mathtext.default`. For setting rcParams,
+# see :ref:`customizing`. For example, setting the default to ``regular`` allows
+# you to use the same font for math text and regular non-math text.
+#
+# To change fonts, e.g., to write "sin" in a Roman font, enclose the text in a
+# font command::
+#
+#     r'$s(t) = \mathcal{A}\mathrm{sin}(2 \omega t)$'
+#
+# .. math::
+#
+#     s(t) = \mathcal{A}\mathrm{sin}(2 \omega t)
+#
+# More conveniently, many commonly used function names that are typeset in
+# a Roman font have shortcuts.  So the expression above could be written as
+# follows::
+#
+#     r'$s(t) = \mathcal{A}\sin(2 \omega t)$'
+#
+# .. math::
+#
+#     s(t) = \mathcal{A}\sin(2 \omega t)
+#
+# Here "s" and "t" are variable in italics font (default), "sin" is in Roman
+# font, and the amplitude "A" is in calligraphy font.  Note in the example above
+# the calligraphy ``A`` is squished into the ``sin``.  You can use a spacing
+# command to add a little whitespace between them::
+#
+#     r's(t) = \mathcal{A}\/\sin(2 \omega t)'
+#
+# .. Here we cheat a bit: for HTML math rendering, Sphinx relies on MathJax which
+#    doesn't actually support the italic correction (\/); instead, use a thin
+#    space (\,) which is supported.
+#
+# .. math::
+#
+#     s(t) = \mathcal{A}\,\sin(2 \omega t)
+#
+# Mathtext can use DejaVu Sans (default), DejaVu Serif, Computer Modern fonts
+# from (La)TeX, `STIX <http://www.stixfonts.org/>`_ fonts which are designed
+# to blend well with Times, or a Unicode font that you provide. The Mathtext
+# font can be selected via :rc:`mathtext.fontset`.
+#
+# The choices available with all fonts are:
+#
+# ========================= ================================
+# Command                   Result
+# ========================= ================================
+# ``\mathrm{Roman}``        :mathmpl:`\mathrm{Roman}`
+# ``\mathit{Italic}``       :mathmpl:`\mathit{Italic}`
+# ``\mathtt{Typewriter}``   :mathmpl:`\mathtt{Typewriter}`
+# ``\mathcal{CALLIGRAPHY}`` :mathmpl:`\mathcal{CALLIGRAPHY}`
+# ========================= ================================
+#
+# .. role:: math-stix(mathmpl)
+#    :fontset: stix
+#
+# When using the `STIX <http://www.stixfonts.org/>`_ fonts, you also have the
+# choice of:
+#
+# ================================ =========================================
+# Command                          Result
+# ================================ =========================================
+# ``\mathbb{blackboard}``          :math-stix:`\mathbb{blackboard}`
+# ``\mathrm{\mathbb{blackboard}}`` :math-stix:`\mathrm{\mathbb{blackboard}}`
+# ``\mathfrak{Fraktur}``           :math-stix:`\mathfrak{Fraktur}`
+# ``\mathsf{sansserif}``           :math-stix:`\mathsf{sansserif}`
+# ``\mathrm{\mathsf{sansserif}}``  :math-stix:`\mathrm{\mathsf{sansserif}}`
+# ``\mathbfit{bolditalic}``        :math-stix:`\mathbfit{bolditalic}`
+# ================================ =========================================
+#
+# There are also five global "font sets" to choose from, which are
+# selected using the ``mathtext.fontset`` parameter in :ref:`matplotlibrc
+# <matplotlibrc-sample>`.
+#
+# ``dejavusans``: DejaVu Sans
+#     .. mathmpl::
+#        :fontset: dejavusans
+#
+#        \mathcal{R} \prod_{i=\alpha}^{\infty} a_i \sin\left(2\pi fx_i\right)
+#
+# ``dejavuserif``: DejaVu Serif
+#     .. mathmpl::
+#        :fontset: dejavuserif
+#
+#        \mathcal{R} \prod_{i=\alpha}^{\infty} a_i \sin\left(2\pi fx_i\right)
+#
+# ``cm``: Computer Modern (TeX)
+#     .. mathmpl::
+#        :fontset: cm
+#
+#        \mathcal{R} \prod_{i=\alpha}^{\infty} a_i \sin\left(2\pi fx_i\right)
+#
+# ``stix``: STIX (designed to blend well with Times)
+#     .. mathmpl::
+#        :fontset: stix
+#
+#        \mathcal{R} \prod_{i=\alpha}^{\infty} a_i \sin\left(2\pi fx_i\right)
+#
+# ``stixsans``: STIX sans-serif
+#     .. mathmpl::
+#        :fontset: stixsans
+#
+#        \mathcal{R} \prod_{i=\alpha}^{\infty} a_i \sin\left(2\pi fx_i\right)
+#
+# Additionally, you can use ``\mathdefault{...}`` or its alias
+# ``\mathregular{...}`` to use the font used for regular text outside of
+# Mathtext.  There are a number of limitations to this approach, most notably
+# that far fewer symbols will be available, but it can be useful to make math
+# expressions blend well with other text in the plot.
+#
+# For compatibility with popular packages, ``\text{...}`` is available and uses the
+# ``\mathrm{...}`` font, but otherwise retains spaces and renders - as a dash
+# (not minus).
+#
+# Custom fonts
+# ~~~~~~~~~~~~
+# Mathtext also provides a way to use custom fonts for math.  This method is
+# fairly tricky to use, and should be considered an experimental feature for
+# patient users only.  By setting :rc:`mathtext.fontset` to ``custom``,
+# you can then set the following parameters, which control which font file to use
+# for a particular set of math characters.
+#
+# ============================== =================================
+# Parameter                      Corresponds to
+# ============================== =================================
+# ``mathtext.it``                ``\mathit{}`` or default italic
+# ``mathtext.rm``                ``\mathrm{}`` Roman (upright)
+# ``mathtext.tt``                ``\mathtt{}`` Typewriter (monospace)
+# ``mathtext.bf``                ``\mathbf{}`` bold
+# ``mathtext.bfit``              ``\mathbfit{}`` bold italic
+# ``mathtext.cal``               ``\mathcal{}`` calligraphic
+# ``mathtext.sf``                ``\mathsf{}`` sans-serif
+# ============================== =================================
+#
+# Each parameter should be set to a fontconfig font descriptor, as defined in
+# :ref:`fonts`. The fonts used should have a Unicode mapping in order to find
+# any non-Latin characters, such as Greek.  If you want to use a math symbol
+# that is not contained in your custom fonts, you can set
+# :rc:`mathtext.fallback` to either ``'cm'``, ``'stix'`` or ``'stixsans'``
+# which will cause the Mathtext system to use
+# characters from an alternative font whenever a particular
+# character cannot be found in the custom font.
+#
+# Note that the math glyphs specified in Unicode have evolved over time, and
+# many fonts may not have glyphs in the correct place for Mathtext.
+#
+# Accents
+# -------
+# An accent command may precede any symbol to add an accent above it.  There are
+# long and short forms for some of them.
+#
+# ============================== =================================
+# Command                        Result
+# ============================== =================================
+# ``\acute a`` or ``\'a``        :mathmpl:`\acute a`
+# ``\bar a``                     :mathmpl:`\bar a`
+# ``\breve a``                   :mathmpl:`\breve a`
+# ``\dot a`` or ``\.a``          :mathmpl:`\dot a`
+# ``\ddot a`` or ``\''a``        :mathmpl:`\ddot a`
+# ``\dddot a``                   :mathmpl:`\dddot a`
+# ``\ddddot a``                  :mathmpl:`\ddddot a`
+# ``\grave a`` or ``\`a``        :mathmpl:`\grave a`
+# ``\hat a`` or ``\^a``          :mathmpl:`\hat a`
+# ``\tilde a`` or ``\~a``        :mathmpl:`\tilde a`
+# ``\vec a``                     :mathmpl:`\vec a`
+# ``\overline{abc}``             :mathmpl:`\overline{abc}`
+# ============================== =================================
+#
+# In addition, there are two special accents that automatically adjust to the
+# width of the symbols below:
+#
+# ============================== =================================
+# Command                        Result
+# ============================== =================================
+# ``\widehat{xyz}``              :mathmpl:`\widehat{xyz}`
+# ``\widetilde{xyz}``            :mathmpl:`\widetilde{xyz}`
+# ============================== =================================
+#
+# Care should be taken when putting accents on lower-case i's and j's.  Note
+# that in the following ``\imath`` is used to avoid the extra dot over the i::
+#
+#     r"$\hat i\ \ \hat \imath$"
+#
+# .. math::
+#
+#     \hat i\ \ \hat \imath
+#
+# Symbols
+# -------
+# You can also use a large number of the TeX symbols, as in ``\infty``,
+# ``\leftarrow``, ``\sum``, ``\int``.
+#
+# .. math_symbol_table::
+#
+# If a particular symbol does not have a name (as is true of many of the more
+# obscure symbols in the STIX fonts), Unicode characters can also be used::
+#
+#    r'$\u23ce$'

From d3afa558a02b972d7e6bd863482053bb9d64e6d6 Mon Sep 17 00:00:00 2001
From: Gautam Sagar <47146980+gautamsagar99@users.noreply.github.com>
Date: Thu, 31 Aug 2023 02:16:38 -0500
Subject: [PATCH 0095/1120] Removed unnecessary origin keywords

---
 .../contourf_demo.py                          | 36 ++++++++++++-------
 1 file changed, 23 insertions(+), 13 deletions(-)

diff --git a/galleries/examples/images_contours_and_fields/contourf_demo.py b/galleries/examples/images_contours_and_fields/contourf_demo.py
index edf72d928270..776d2535a872 100644
--- a/galleries/examples/images_contours_and_fields/contourf_demo.py
+++ b/galleries/examples/images_contours_and_fields/contourf_demo.py
@@ -8,8 +8,6 @@
 import matplotlib.pyplot as plt
 import numpy as np
 
-origin = 'lower'
-
 delta = 0.025
 
 x = y = np.arange(-3.0, 3.01, delta)
@@ -41,14 +39,14 @@
 # for purposes of illustration.
 
 fig1, ax2 = plt.subplots(layout='constrained')
-CS = ax2.contourf(X, Y, Z, 10, cmap=plt.cm.bone, origin=origin)
+CS = ax2.contourf(X, Y, Z, 10, cmap=plt.cm.bone)
 
 # Note that in the following, we explicitly pass in a subset of the contour
 # levels used for the filled contours.  Alternatively, we could pass in
 # additional levels to provide extra resolution, or leave out the *levels*
 # keyword argument to use all of the original levels.
 
-CS2 = ax2.contour(CS, levels=CS.levels[::2], colors='r', origin=origin)
+CS2 = ax2.contour(CS, levels=CS.levels[::2], colors='r')
 
 ax2.set_title('Nonsense (3 masked regions)')
 ax2.set_xlabel('word length anomaly')
@@ -68,20 +66,14 @@
 
 fig2, ax2 = plt.subplots(layout='constrained')
 levels = [-1.5, -1, -0.5, 0, 0.5, 1]
-CS3 = ax2.contourf(X, Y, Z, levels,
-                   colors=('r', 'g', 'b'),
-                   origin=origin,
-                   extend='both')
+CS3 = ax2.contourf(X, Y, Z, levels, colors=('r', 'g', 'b'), extend='both')
 # Our data range extends outside the range of levels; make
 # data below the lowest contour level yellow, and above the
 # highest level cyan:
 CS3.cmap.set_under('yellow')
 CS3.cmap.set_over('cyan')
 
-CS4 = ax2.contour(X, Y, Z, levels,
-                  colors=('k',),
-                  linewidths=(3,),
-                  origin=origin)
+CS4 = ax2.contour(X, Y, Z, levels, colors=('k',), linewidths=(3,))
 ax2.set_title('Listed colors (3 masked regions)')
 ax2.clabel(CS4, fmt='%2.1f', colors='w', fontsize=14)
 
@@ -104,13 +96,31 @@
 fig, axs = plt.subplots(2, 2, layout="constrained")
 
 for ax, extend in zip(axs.flat, extends):
-    cs = ax.contourf(X, Y, Z, levels, cmap=cmap, extend=extend, origin=origin)
+    cs = ax.contourf(X, Y, Z, levels, cmap=cmap, extend=extend)
     fig.colorbar(cs, ax=ax, shrink=0.9)
     ax.set_title("extend = %s" % extend)
     ax.locator_params(nbins=4)
 
 plt.show()
 
+# %%
+# Orient contour plots using the origin keyword
+# ---------------------------------------------
+# This code demonstrates orienting contour plot data using the "origin" keyword
+
+x = np.arange(1, 10)
+y = x.reshape(-1, 1)
+h = x * y
+
+fig, (ax1, ax2) = plt.subplots(ncols=2)
+
+ax1.set_title("origin='upper'")
+ax2.set_title("origin='lower'")
+ax1.contourf(h, levels=np.arange(5, 70, 5), extend='both', origin="upper")
+ax2.contourf(h, levels=np.arange(5, 70, 5), extend='both', origin="lower")
+
+plt.show()
+
 # %%
 #
 # .. admonition:: References

From babd065c2e7b11c29d8e9e2e21a9336f2f3d2a2f Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 30 Aug 2023 17:09:39 -0400
Subject: [PATCH 0096/1120] DOC: Fix override of Axes setter in example

`set_axes` was dropped from `Artist` a long time ago, so the version in
the subclass did nothing.
---
 .../text_labels_and_annotations/line_with_text.py         | 8 +++++---
 lib/matplotlib/legend.py                                  | 1 -
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/galleries/examples/text_labels_and_annotations/line_with_text.py b/galleries/examples/text_labels_and_annotations/line_with_text.py
index 8a62733b13ce..389554bd5ae1 100644
--- a/galleries/examples/text_labels_and_annotations/line_with_text.py
+++ b/galleries/examples/text_labels_and_annotations/line_with_text.py
@@ -28,9 +28,11 @@ def set_figure(self, figure):
         self.text.set_figure(figure)
         super().set_figure(figure)
 
-    def set_axes(self, axes):
-        self.text.set_axes(axes)
-        super().set_axes(axes)
+    # Override the axes property setter to set Axes on our children as well.
+    @lines.Line2D.axes.setter
+    def axes(self, new_axes):
+        self.text.axes = new_axes
+        lines.Line2D.axes.fset(self, new_axes)  # Call the superclass property setter.
 
     def set_transform(self, transform):
         # 2 pixel offset
diff --git a/lib/matplotlib/legend.py b/lib/matplotlib/legend.py
index bdabacdfedbf..fcd7850bb473 100644
--- a/lib/matplotlib/legend.py
+++ b/lib/matplotlib/legend.py
@@ -642,7 +642,6 @@ def _set_artist_props(self, a):
         """
         a.set_figure(self.figure)
         if self.isaxes:
-            # a.set_axes(self.axes)
             a.axes = self.axes
 
         a.set_transform(self.get_transform())

From 75441cee35c51f27f07952c1af3775ce160be71d Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 30 Aug 2023 19:29:07 -0400
Subject: [PATCH 0097/1120] DOC: Remove extra imports from paths tutorial

---
 galleries/users_explain/artists/paths.py | 15 ++++++---------
 1 file changed, 6 insertions(+), 9 deletions(-)

diff --git a/galleries/users_explain/artists/paths.py b/galleries/users_explain/artists/paths.py
index d505711fd1c0..b096d05d0751 100644
--- a/galleries/users_explain/artists/paths.py
+++ b/galleries/users_explain/artists/paths.py
@@ -18,6 +18,8 @@
 could use this code:
 """
 
+import numpy as np
+
 import matplotlib.pyplot as plt
 
 import matplotlib.patches as patches
@@ -191,11 +193,6 @@
 #       edgecolor='yellow', alpha=0.5)
 #     ax.add_patch(patch)
 
-import numpy as np
-
-import matplotlib.patches as patches
-import matplotlib.path as path
-
 fig, ax = plt.subplots()
 # Fixing random state for reproducibility
 np.random.seed(19680801)
@@ -213,9 +210,9 @@
 
 nverts = nrects*(1+3+1)
 verts = np.zeros((nverts, 2))
-codes = np.ones(nverts, int) * path.Path.LINETO
-codes[0::5] = path.Path.MOVETO
-codes[4::5] = path.Path.CLOSEPOLY
+codes = np.full(nverts, Path.LINETO, dtype=int)
+codes[0::5] = Path.MOVETO
+codes[4::5] = Path.CLOSEPOLY
 verts[0::5, 0] = left
 verts[0::5, 1] = bottom
 verts[1::5, 0] = left
@@ -225,7 +222,7 @@
 verts[3::5, 0] = right
 verts[3::5, 1] = bottom
 
-barpath = path.Path(verts, codes)
+barpath = Path(verts, codes)
 patch = patches.PathPatch(barpath, facecolor='green',
                           edgecolor='yellow', alpha=0.5)
 ax.add_patch(patch)

From 4b0084abda9abc0a4b1486fad2174fee4306c0c6 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 30 Aug 2023 19:51:02 -0400
Subject: [PATCH 0098/1120] DOC: Use dict.items to iterate subplot_mosaic
 result

---
 galleries/users_explain/axes/arranging_axes.py  | 16 ++++++++--------
 galleries/users_explain/axes/axes_scales.py     | 17 +++++++----------
 galleries/users_explain/figure/figure_intro.rst |  4 ++--
 3 files changed, 17 insertions(+), 20 deletions(-)

diff --git a/galleries/users_explain/axes/arranging_axes.py b/galleries/users_explain/axes/arranging_axes.py
index 9288eede9fd5..79b69f4bf3dd 100644
--- a/galleries/users_explain/axes/arranging_axes.py
+++ b/galleries/users_explain/axes/arranging_axes.py
@@ -152,8 +152,8 @@ def annotate_axes(ax, text, fontsize=18):
 fig, axd = plt.subplot_mosaic([['upper left', 'upper right'],
                                ['lower left', 'lower right']],
                               figsize=(5.5, 3.5), layout="constrained")
-for k in axd:
-    annotate_axes(axd[k], f'axd["{k}"]', fontsize=14)
+for k, ax in axd.items():
+    annotate_axes(ax, f'axd[{k!r}]', fontsize=14)
 fig.suptitle('plt.subplot_mosaic()')
 
 # %%
@@ -200,8 +200,8 @@ def annotate_axes(ax, text, fontsize=18):
 fig, axd = plt.subplot_mosaic([['upper left', 'right'],
                                ['lower left', 'right']],
                               figsize=(5.5, 3.5), layout="constrained")
-for k in axd:
-    annotate_axes(axd[k], f'axd["{k}"]', fontsize=14)
+for k, ax in axd.items():
+    annotate_axes(ax, f'axd[{k!r}]', fontsize=14)
 fig.suptitle('plt.subplot_mosaic()')
 
 # %%
@@ -223,8 +223,8 @@ def annotate_axes(ax, text, fontsize=18):
                                ['lower left', 'right']],
                               gridspec_kw=gs_kw, figsize=(5.5, 3.5),
                               layout="constrained")
-for k in axd:
-    annotate_axes(axd[k], f'axd["{k}"]', fontsize=14)
+for k, ax in axd.items():
+    annotate_axes(ax, f'axd[{k!r}]', fontsize=14)
 fig.suptitle('plt.subplot_mosaic()')
 
 # %%
@@ -262,8 +262,8 @@ def annotate_axes(ax, text, fontsize=18):
           ['lower left', 'lower right']]
 
 fig, axd = plt.subplot_mosaic(outer, layout="constrained")
-for k in axd:
-    annotate_axes(axd[k], f'axd["{k}"]')
+for k, ax in axd.items():
+    annotate_axes(ax, f'axd[{k!r}]')
 
 # %%
 # Low-level and advanced grid methods
diff --git a/galleries/users_explain/axes/axes_scales.py b/galleries/users_explain/axes/axes_scales.py
index 567f3c5762ed..6b163835070c 100644
--- a/galleries/users_explain/axes/axes_scales.py
+++ b/galleries/users_explain/axes/axes_scales.py
@@ -98,25 +98,23 @@
 # %%
 #
 
-todo = ['asinh', 'symlog', 'log', 'logit', ]
 fig, axs = plt.subplot_mosaic([['asinh', 'symlog'],
                                ['log', 'logit']], layout='constrained')
 
 x = np.arange(0, 1000)
 
-for td in todo:
-    ax = axs[td]
-    if td in ['asinh', 'symlog']:
+for name, ax in axs.items():
+    if name in ['asinh', 'symlog']:
         yy = x - np.mean(x)
-    elif td in ['logit']:
+    elif name in ['logit']:
         yy = (x-np.min(x))
         yy = yy / np.max(np.abs(yy))
     else:
         yy = x
 
     ax.plot(yy, yy)
-    ax.set_yscale(td)
-    ax.set_title(td)
+    ax.set_yscale(name)
+    ax.set_title(name)
 
 # %%
 # Optional arguments for scales
@@ -131,9 +129,8 @@
 fig, axs = plt.subplot_mosaic([['log', 'symlog']], layout='constrained',
                               figsize=(6.4, 3))
 
-for td in axs:
-    ax = axs[td]
-    if td in ['log']:
+for name, ax in axs.items():
+    if name in ['log']:
         ax.plot(x, x)
         ax.set_yscale('log', base=2)
         ax.set_title('log base=2')
diff --git a/galleries/users_explain/figure/figure_intro.rst b/galleries/users_explain/figure/figure_intro.rst
index 87bec6236d2a..745b01566427 100644
--- a/galleries/users_explain/figure/figure_intro.rst
+++ b/galleries/users_explain/figure/figure_intro.rst
@@ -139,8 +139,8 @@ More complex grids can be achieved with `.pyplot.subplot_mosaic` (which wraps
 
     fig, axs = plt.subplot_mosaic([['A', 'right'], ['B', 'right']],
                                   figsize=(4, 3), layout='constrained')
-    for ax_name in axs:
-        axs[ax_name].text(0.5, 0.5, ax_name, ha='center', va='center')
+    for ax_name, ax in axs.items():
+        ax.text(0.5, 0.5, ax_name, ha='center', va='center')
 
 Sometimes we want to have a nested layout in a Figure, with two or more sets of
 Axes that do not share the same subplot grid.

From f403f2e306109ca962146684ebea61f1d6521519 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 30 Aug 2023 20:21:23 -0400
Subject: [PATCH 0099/1120] DOC: Remove usage of discouraged layout engine API

Fixes #26637
---
 galleries/examples/userdemo/connectionstyle_demo.py | 2 +-
 lib/matplotlib/figure.py                            | 8 ++++----
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/galleries/examples/userdemo/connectionstyle_demo.py b/galleries/examples/userdemo/connectionstyle_demo.py
index 50ca108fc92b..e34c63a5708b 100644
--- a/galleries/examples/userdemo/connectionstyle_demo.py
+++ b/galleries/examples/userdemo/connectionstyle_demo.py
@@ -48,7 +48,7 @@ def demo_con_style(ax, connectionstyle):
 
 for ax in axs.flat:
     ax.set(xlim=(0, 1), ylim=(0, 1.25), xticks=[], yticks=[], aspect=1.25)
-fig.set_constrained_layout_pads(wspace=0, hspace=0, w_pad=0, h_pad=0)
+fig.get_layout_engine().set(wspace=0, hspace=0, w_pad=0, h_pad=0)
 
 plt.show()
 
diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
index da03778b92ea..fe997d35372c 100644
--- a/lib/matplotlib/figure.py
+++ b/lib/matplotlib/figure.py
@@ -2466,8 +2466,7 @@ def __init__(self,
               to avoid overlapping axes decorations.  Can handle complex plot
               layouts and colorbars, and is thus recommended.
 
-              See :ref:`constrainedlayout_guide`
-              for examples.
+              See :ref:`constrainedlayout_guide` for examples.
 
             - 'compressed': uses the same algorithm as 'constrained', but
               removes extra space between fixed-aspect-ratio Axes.  Best for
@@ -2475,8 +2474,9 @@ def __init__(self,
 
             - 'tight': Use the tight layout mechanism. This is a relatively
               simple algorithm that adjusts the subplot parameters so that
-              decorations do not overlap. See `.set_tight_layout` for
-              further details.
+              decorations do not overlap.
+
+              See :ref:`tight_layout_guide` for examples.
 
             - 'none': Do not use a layout engine.
 

From 1d8659586031ec98a733bde94b42e1ca87ddaf0d Mon Sep 17 00:00:00 2001
From: Ratnabali Dutta <ratnabalidutta26@gmail.com>
Date: Mon, 26 Jun 2023 20:24:00 +0530
Subject: [PATCH 0100/1120] Add sorted tex2uni data table

---
 lib/matplotlib/_mathtext_data.py | 1277 +++++++++++++++---------------
 1 file changed, 644 insertions(+), 633 deletions(-)

diff --git a/lib/matplotlib/_mathtext_data.py b/lib/matplotlib/_mathtext_data.py
index d37cdff22e57..1a12d1ec08ce 100644
--- a/lib/matplotlib/_mathtext_data.py
+++ b/lib/matplotlib/_mathtext_data.py
@@ -460,640 +460,651 @@
 
 uni2type1 = {v: k for k, v in type12uni.items()}
 
+#  The script below is to sort and format the tex2uni dict
+
+## For decimal values: int(hex(v), 16)
+#  newtex = {k: hex(v) for k, v in tex2uni.items()}
+#  sd = dict(sorted(newtex.items(), key=lambda item: item[0]))
+#
+## For formatting the sorted dictionary with proper spacing
+## the value '24' comes from finding the longest string in
+## the newtex keys with len(max(newtex, key=len))
+#  for key in sd:
+#      print("{0:24} : {1: <s},".format("'" + key + "'", sd[key]))
+
 tex2uni = {
-    'widehat'                  : 0x0302,
-    'widetilde'                : 0x0303,
-    'widebar'                  : 0x0305,
-    'langle'                   : 0x27e8,
-    'rangle'                   : 0x27e9,
-    'perp'                     : 0x27c2,
-    'neq'                      : 0x2260,
-    'Join'                     : 0x2a1d,
-    'leqslant'                 : 0x2a7d,
-    'geqslant'                 : 0x2a7e,
-    'lessapprox'               : 0x2a85,
-    'gtrapprox'                : 0x2a86,
-    'lesseqqgtr'               : 0x2a8b,
-    'gtreqqless'               : 0x2a8c,
-    'triangleeq'               : 0x225c,
-    'eqslantless'              : 0x2a95,
-    'eqslantgtr'               : 0x2a96,
-    'backepsilon'              : 0x03f6,
-    'precapprox'               : 0x2ab7,
-    'succapprox'               : 0x2ab8,
-    'fallingdotseq'            : 0x2252,
-    'subseteqq'                : 0x2ac5,
-    'supseteqq'                : 0x2ac6,
-    'varpropto'                : 0x221d,
-    'precnapprox'              : 0x2ab9,
-    'succnapprox'              : 0x2aba,
-    'subsetneqq'               : 0x2acb,
-    'supsetneqq'               : 0x2acc,
-    'lnapprox'                 : 0x2a89,
-    'gnapprox'                 : 0x2a8a,
-    'longleftarrow'            : 0x27f5,
-    'longrightarrow'           : 0x27f6,
-    'longleftrightarrow'       : 0x27f7,
-    'Longleftarrow'            : 0x27f8,
-    'Longrightarrow'           : 0x27f9,
-    'Longleftrightarrow'       : 0x27fa,
-    'longmapsto'               : 0x27fc,
-    'leadsto'                  : 0x21dd,
-    'dashleftarrow'            : 0x290e,
-    'dashrightarrow'           : 0x290f,
-    'circlearrowleft'          : 0x21ba,
-    'circlearrowright'         : 0x21bb,
-    'leftrightsquigarrow'      : 0x21ad,
-    'leftsquigarrow'           : 0x219c,
-    'rightsquigarrow'          : 0x219d,
-    'Game'                     : 0x2141,
-    'hbar'                     : 0x0127,
-    'hslash'                   : 0x210f,
-    'ldots'                    : 0x2026,
-    'vdots'                    : 0x22ee,
-    'doteqdot'                 : 0x2251,
-    'doteq'                    : 8784,
-    'partial'                  : 8706,
-    'gg'                       : 8811,
-    'asymp'                    : 8781,
-    'blacktriangledown'        : 9662,
-    'otimes'                   : 8855,
-    'nearrow'                  : 8599,
-    'varpi'                    : 982,
-    'vee'                      : 8744,
-    'vec'                      : 8407,
-    'smile'                    : 8995,
-    'succnsim'                 : 8937,
-    'gimel'                    : 8503,
-    'vert'                     : 124,
-    '|'                        : 8214,
-    'varrho'                   : 1009,
-    'P'                        : 182,
-    'approxident'              : 8779,
-    'Swarrow'                  : 8665,
-    'textasciicircum'          : 94,
-    'imageof'                  : 8887,
-    'ntriangleleft'            : 8938,
-    'nleq'                     : 8816,
-    'div'                      : 247,
-    'nparallel'                : 8742,
-    'Leftarrow'                : 8656,
-    'lll'                      : 8920,
-    'oiint'                    : 8751,
-    'ngeq'                     : 8817,
-    'Theta'                    : 920,
-    'origof'                   : 8886,
-    'blacksquare'              : 9632,
-    'solbar'                   : 9023,
-    'neg'                      : 172,
-    'sum'                      : 8721,
-    'Vdash'                    : 8873,
-    'coloneq'                  : 8788,
-    'degree'                   : 176,
-    'bowtie'                   : 8904,
-    'blacktriangleright'       : 9654,
-    'varsigma'                 : 962,
-    'leq'                      : 8804,
-    'ggg'                      : 8921,
-    'lneqq'                    : 8808,
-    'scurel'                   : 8881,
-    'stareq'                   : 8795,
-    'BbbN'                     : 8469,
-    'nLeftarrow'               : 8653,
-    'nLeftrightarrow'          : 8654,
-    'k'                        : 808,
-    'bot'                      : 8869,
-    'BbbC'                     : 8450,
-    'Lsh'                      : 8624,
-    'leftleftarrows'           : 8647,
-    'BbbZ'                     : 8484,
-    'digamma'                  : 989,
-    'BbbR'                     : 8477,
-    'BbbP'                     : 8473,
-    'BbbQ'                     : 8474,
-    'vartriangleright'         : 8883,
-    'succsim'                  : 8831,
-    'wedge'                    : 8743,
-    'lessgtr'                  : 8822,
-    'veebar'                   : 8891,
-    'mapsdown'                 : 8615,
-    'Rsh'                      : 8625,
-    'chi'                      : 967,
-    'prec'                     : 8826,
-    'nsubseteq'                : 8840,
-    'therefore'                : 8756,
-    'eqcirc'                   : 8790,
-    'textexclamdown'           : 161,
-    'nRightarrow'              : 8655,
-    'flat'                     : 9837,
-    'notin'                    : 8713,
-    'llcorner'                 : 8990,
-    'varepsilon'               : 949,
-    'bigtriangleup'            : 9651,
-    'aleph'                    : 8501,
-    'dotminus'                 : 8760,
-    'upsilon'                  : 965,
-    'Lambda'                   : 923,
-    'cap'                      : 8745,
-    'barleftarrow'             : 8676,
-    'mu'                       : 956,
-    'boxplus'                  : 8862,
-    'mp'                       : 8723,
-    'circledast'               : 8859,
-    'tau'                      : 964,
-    'in'                       : 8712,
-    'backslash'                : 92,
-    'varnothing'               : 8709,
-    'sharp'                    : 9839,
-    'eqsim'                    : 8770,
-    'gnsim'                    : 8935,
-    'Searrow'                  : 8664,
-    'updownarrows'             : 8645,
-    'heartsuit'                : 9825,
-    'trianglelefteq'           : 8884,
-    'ddag'                     : 8225,
-    'sqsubseteq'               : 8849,
-    'mapsfrom'                 : 8612,
-    'boxbar'                   : 9707,
-    'sim'                      : 8764,
-    'Nwarrow'                  : 8662,
-    'nequiv'                   : 8802,
-    'succ'                     : 8827,
-    'vdash'                    : 8866,
-    'Leftrightarrow'           : 8660,
-    'parallel'                 : 8741,
-    'invnot'                   : 8976,
-    'natural'                  : 9838,
-    'ss'                       : 223,
-    'uparrow'                  : 8593,
-    'nsim'                     : 8769,
-    'hookrightarrow'           : 8618,
-    'Equiv'                    : 8803,
-    'approx'                   : 8776,
-    'Vvdash'                   : 8874,
-    'nsucc'                    : 8833,
-    'leftrightharpoons'        : 8651,
-    'Re'                       : 8476,
-    'boxminus'                 : 8863,
-    'equiv'                    : 8801,
-    'Lleftarrow'               : 8666,
-    'll'                       : 8810,
-    'Cup'                      : 8915,
-    'measeq'                   : 8798,
-    'upharpoonleft'            : 8639,
-    'lq'                       : 8216,
-    'Upsilon'                  : 933,
-    'subsetneq'                : 8842,
-    'greater'                  : 62,
-    'supsetneq'                : 8843,
-    'Cap'                      : 8914,
-    'L'                        : 321,
-    'spadesuit'                : 9824,
-    'lrcorner'                 : 8991,
-    'not'                      : 824,
-    'bar'                      : 772,
-    'rightharpoonaccent'       : 8401,
-    'boxdot'                   : 8865,
-    'l'                        : 322,
-    'leftharpoondown'          : 8637,
-    'bigcup'                   : 8899,
-    'iint'                     : 8748,
-    'bigwedge'                 : 8896,
-    'downharpoonleft'          : 8643,
-    'textasciitilde'           : 126,
-    'subset'                   : 8834,
-    'leqq'                     : 8806,
-    'mapsup'                   : 8613,
-    'nvDash'                   : 8877,
-    'looparrowleft'            : 8619,
-    'nless'                    : 8814,
-    'rightarrowbar'            : 8677,
-    'Vert'                     : 8214,
-    'downdownarrows'           : 8650,
-    'uplus'                    : 8846,
-    'simeq'                    : 8771,
-    'napprox'                  : 8777,
-    'ast'                      : 8727,
-    'amalg'                    : 10815,
-    'lhd'                      : 9665,
-    'rhd'                      : 9655,
-    'ddagger'                  : 8225,
-    'unlhd'                    : 8884,
-    'unrhd'                    : 8885,
-    'setminus'                 : 8726,
-    'twoheaduparrow'           : 8607,
-    'doublebarwedge'           : 8966,
-    'Sigma'                    : 931,
-    'leftharpoonaccent'        : 8400,
-    'ntrianglelefteq'          : 8940,
-    'nexists'                  : 8708,
-    'times'                    : 215,
-    'measuredangle'            : 8737,
-    'bumpeq'                   : 8783,
-    'carriagereturn'           : 8629,
-    'adots'                    : 8944,
-    'checkmark'                : 10003,
-    'lambda'                   : 955,
-    'xi'                       : 958,
-    'rbrace'                   : 125,
-    'rbrack'                   : 93,
-    'Nearrow'                  : 8663,
-    'maltese'                  : 10016,
-    'clubsuit'                 : 9827,
-    'top'                      : 8868,
-    'overarc'                  : 785,
-    'varphi'                   : 966,
-    'Delta'                    : 916,
-    'iota'                     : 953,
-    'nleftarrow'               : 8602,
-    'candra'                   : 784,
-    'supset'                   : 8835,
-    'triangleleft'             : 9665,
-    'gtreqless'                : 8923,
-    'ntrianglerighteq'         : 8941,
-    'quad'                     : 8195,
-    'Xi'                       : 926,
-    'gtrdot'                   : 8919,
-    'leftthreetimes'           : 8907,
-    'minus'                    : 8722,
-    'preccurlyeq'              : 8828,
-    'nleftrightarrow'          : 8622,
-    'lambdabar'                : 411,
-    'blacktriangle'            : 9652,
-    'kernelcontraction'        : 8763,
-    'Phi'                      : 934,
-    'angle'                    : 8736,
-    'spadesuitopen'            : 9828,
-    'eqless'                   : 8924,
-    'mid'                      : 8739,
-    'varkappa'                 : 1008,
-    'Ldsh'                     : 8626,
-    'updownarrow'              : 8597,
-    'beta'                     : 946,
-    'textquotedblleft'         : 8220,
-    'rho'                      : 961,
-    'alpha'                    : 945,
-    'intercal'                 : 8890,
-    'beth'                     : 8502,
-    'grave'                    : 768,
-    'acwopencirclearrow'       : 8634,
-    'nmid'                     : 8740,
-    'nsupset'                  : 8837,
-    'sigma'                    : 963,
-    'dot'                      : 775,
-    'Rightarrow'               : 8658,
-    'turnednot'                : 8985,
-    'backsimeq'                : 8909,
-    'leftarrowtail'            : 8610,
-    'approxeq'                 : 8778,
-    'curlyeqsucc'              : 8927,
-    'rightarrowtail'           : 8611,
-    'Psi'                      : 936,
-    'copyright'                : 169,
-    'yen'                      : 165,
-    'vartriangleleft'          : 8882,
-    'rasp'                     : 700,
-    'triangleright'            : 9655,
-    'precsim'                  : 8830,
-    'infty'                    : 8734,
-    'geq'                      : 8805,
-    'updownarrowbar'           : 8616,
-    'precnsim'                 : 8936,
-    'H'                        : 779,
-    'ulcorner'                 : 8988,
-    'looparrowright'           : 8620,
-    'ncong'                    : 8775,
-    'downarrow'                : 8595,
-    'circeq'                   : 8791,
-    'subseteq'                 : 8838,
-    'bigstar'                  : 9733,
-    'prime'                    : 8242,
-    'lceil'                    : 8968,
-    'Rrightarrow'              : 8667,
-    'oiiint'                   : 8752,
-    'curlywedge'               : 8911,
-    'vDash'                    : 8872,
-    'lfloor'                   : 8970,
-    'ddots'                    : 8945,
-    'exists'                   : 8707,
-    'underbar'                 : 817,
-    'Pi'                       : 928,
-    'leftrightarrows'          : 8646,
-    'sphericalangle'           : 8738,
-    'coprod'                   : 8720,
-    'circledcirc'              : 8858,
-    'gtrsim'                   : 8819,
-    'gneqq'                    : 8809,
-    'between'                  : 8812,
-    'theta'                    : 952,
-    'complement'               : 8705,
-    'arceq'                    : 8792,
-    'nVdash'                   : 8878,
-    'S'                        : 167,
-    'wr'                       : 8768,
-    'wp'                       : 8472,
-    'backcong'                 : 8780,
-    'lasp'                     : 701,
-    'c'                        : 807,
-    'nabla'                    : 8711,
-    'dotplus'                  : 8724,
-    'eta'                      : 951,
-    'forall'                   : 8704,
-    'eth'                      : 240,
-    'dh'                       : 240,
-    'DH'                       : 208,
-    'colon'                    : 58,
-    'sqcup'                    : 8852,
-    'bigsqcup'                 : 10758,
-    'rightrightarrows'         : 8649,
-    'sqsupset'                 : 8848,
-    'mapsto'                   : 8614,
-    'bigtriangledown'          : 9661,
-    'sqsupseteq'               : 8850,
-    'propto'                   : 8733,
-    'pi'                       : 960,
-    'pm'                       : 177,
-    'dots'                     : 0x2026,
-    'nrightarrow'              : 8603,
-    'textasciiacute'           : 180,
-    'Doteq'                    : 8785,
-    'breve'                    : 774,
-    'sqcap'                    : 8851,
-    'twoheadrightarrow'        : 8608,
-    'kappa'                    : 954,
-    'vartriangle'              : 9653,
-    'diamondsuit'              : 9826,
-    'pitchfork'                : 8916,
-    'blacktriangleleft'        : 9664,
-    'nprec'                    : 8832,
-    'curvearrowright'          : 8631,
-    'barwedge'                 : 8892,
-    'multimap'                 : 8888,
-    'textquestiondown'         : 191,
-    'cong'                     : 8773,
-    'rtimes'                   : 8906,
-    'rightzigzagarrow'         : 8669,
-    'rightarrow'               : 8594,
-    'leftarrow'                : 8592,
-    '__sqrt__'                 : 8730,
-    'twoheaddownarrow'         : 8609,
-    'oint'                     : 8750,
-    'bigvee'                   : 8897,
-    'eqdef'                    : 8797,
-    'sterling'                 : 163,
-    'phi'                      : 981,
-    'Updownarrow'              : 8661,
-    'backprime'                : 8245,
-    'emdash'                   : 8212,
-    'Gamma'                    : 915,
-    'i'                        : 305,
-    'rceil'                    : 8969,
-    'leftharpoonup'            : 8636,
-    'Im'                       : 8465,
-    'curvearrowleft'           : 8630,
-    'wedgeq'                   : 8793,
-    'curlyeqprec'              : 8926,
-    'questeq'                  : 8799,
-    'less'                     : 60,
-    'upuparrows'               : 8648,
-    'tilde'                    : 771,
-    'textasciigrave'           : 96,
-    'smallsetminus'            : 8726,
-    'ell'                      : 8467,
-    'cup'                      : 8746,
-    'danger'                   : 9761,
-    'nVDash'                   : 8879,
-    'cdotp'                    : 183,
-    'cdots'                    : 8943,
-    'hat'                      : 770,
-    'eqgtr'                    : 8925,
-    'psi'                      : 968,
-    'frown'                    : 8994,
-    'acute'                    : 769,
-    'downzigzagarrow'          : 8623,
-    'ntriangleright'           : 8939,
-    'cupdot'                   : 8845,
-    'circleddash'              : 8861,
-    'oslash'                   : 8856,
-    'mho'                      : 8487,
-    'd'                        : 803,
-    'sqsubset'                 : 8847,
-    'cdot'                     : 8901,
-    'Omega'                    : 937,
-    'OE'                       : 338,
-    'veeeq'                    : 8794,
-    'Finv'                     : 8498,
-    't'                        : 865,
-    'leftrightarrow'           : 8596,
-    'swarrow'                  : 8601,
-    'rightthreetimes'          : 8908,
-    'rightleftharpoons'        : 8652,
-    'lesssim'                  : 8818,
-    'searrow'                  : 8600,
-    'because'                  : 8757,
-    'gtrless'                  : 8823,
-    'star'                     : 8902,
-    'nsubset'                  : 8836,
-    'zeta'                     : 950,
-    'dddot'                    : 8411,
-    'bigcirc'                  : 9675,
-    'Supset'                   : 8913,
-    'circ'                     : 8728,
-    'slash'                    : 8725,
-    'ocirc'                    : 778,
-    'prod'                     : 8719,
-    'twoheadleftarrow'         : 8606,
-    'daleth'                   : 8504,
-    'upharpoonright'           : 8638,
-    'odot'                     : 8857,
-    'Uparrow'                  : 8657,
-    'O'                        : 216,
-    'hookleftarrow'            : 8617,
-    'trianglerighteq'          : 8885,
-    'nsimeq'                   : 8772,
-    'oe'                       : 339,
-    'nwarrow'                  : 8598,
-    'o'                        : 248,
-    'ddddot'                   : 8412,
-    'downharpoonright'         : 8642,
-    'succcurlyeq'              : 8829,
-    'gamma'                    : 947,
-    'scrR'                     : 8475,
-    'dag'                      : 8224,
-    'thickspace'               : 8197,
-    'frakZ'                    : 8488,
-    'lessdot'                  : 8918,
-    'triangledown'             : 9663,
-    'ltimes'                   : 8905,
-    'scrB'                     : 8492,
-    'endash'                   : 8211,
-    'scrE'                     : 8496,
-    'scrF'                     : 8497,
-    'scrH'                     : 8459,
-    'scrI'                     : 8464,
-    'rightharpoondown'         : 8641,
-    'scrL'                     : 8466,
-    'scrM'                     : 8499,
-    'frakC'                    : 8493,
-    'nsupseteq'                : 8841,
-    'circledR'                 : 174,
-    'circledS'                 : 9416,
-    'ngtr'                     : 8815,
-    'bigcap'                   : 8898,
-    'scre'                     : 8495,
-    'Downarrow'                : 8659,
-    'scrg'                     : 8458,
-    'overleftrightarrow'       : 8417,
-    'scro'                     : 8500,
-    'lnsim'                    : 8934,
-    'eqcolon'                  : 8789,
-    'curlyvee'                 : 8910,
-    'urcorner'                 : 8989,
-    'lbrace'                   : 123,
-    'Bumpeq'                   : 8782,
-    'delta'                    : 948,
-    'boxtimes'                 : 8864,
-    'overleftarrow'            : 8406,
-    'prurel'                   : 8880,
-    'clubsuitopen'             : 9831,
-    'cwopencirclearrow'        : 8635,
-    'geqq'                     : 8807,
-    'rightleftarrows'          : 8644,
-    'lgroup'                   : 0x27EE,
-    'rgroup'                   : 0x27EF,
-    'aa'                       : 229,
-    'ac'                       : 8766,
-    'ae'                       : 230,
-    'int'                      : 8747,
-    'rfloor'                   : 8971,
-    'risingdotseq'             : 8787,
-    'nvdash'                   : 8876,
-    'diamond'                  : 8900,
-    'ddot'                     : 776,
-    'backsim'                  : 8765,
-    'oplus'                    : 8853,
-    'triangleq'                : 8796,
-    'check'                    : 780,
-    'ni'                       : 8715,
-    'iiint'                    : 8749,
-    'ne'                       : 8800,
-    'lesseqgtr'                : 8922,
-    'obar'                     : 9021,
-    'supseteq'                 : 8839,
-    'nu'                       : 957,
-    'AA'                       : 197,
-    'AE'                       : 198,
-    'models'                   : 8871,
-    'ominus'                   : 8854,
-    'dashv'                    : 8867,
-    'omega'                    : 969,
-    'rq'                       : 8217,
-    'Subset'                   : 8912,
-    'rightharpoonup'           : 8640,
-    'Rdsh'                     : 8627,
-    'bullet'                   : 8729,
-    'divideontimes'            : 8903,
-    'lbrack'                   : 91,
-    'textquotedblright'        : 8221,
-    'Colon'                    : 8759,
-    '%'                        : 37,
-    '$'                        : 36,
-    '{'                        : 123,
-    '}'                        : 125,
-    '_'                        : 95,
-    '#'                        : 35,
-    'imath'                    : 0x131,
-    'circumflexaccent'         : 770,
-    'combiningbreve'           : 774,
-    'combiningoverline'        : 772,
-    'combininggraveaccent'     : 768,
-    'combiningacuteaccent'     : 769,
-    'combiningdiaeresis'       : 776,
-    'combiningtilde'           : 771,
-    'combiningrightarrowabove' : 8407,
-    'combiningdotabove'        : 775,
-    'combiningthreedotsabove'  : 8411,
-    'combiningfourdotsabove'   : 8412,
-    'to'                       : 8594,
-    'succeq'                   : 8829,
-    'emptyset'                 : 8709,
-    'leftparen'                : 40,
-    'rightparen'               : 41,
-    'bigoplus'                 : 10753,
-    'leftbrace'                : 123,
-    'rightbrace'               : 125,
-    'jmath'                    : 567,
-    'bigodot'                  : 10752,
-    'preceq'                   : 8828,
-    'biguplus'                 : 10756,
-    'epsilon'                  : 949,
-    'vartheta'                 : 977,
-    'bigotimes'                : 10754,
-    'guillemotleft'            : 171,
-    'ring'                     : 730,
-    'Thorn'                    : 222,
-    'guilsinglright'           : 8250,
-    'perthousand'              : 8240,
-    'macron'                   : 175,
-    'cent'                     : 162,
-    'guillemotright'           : 187,
-    'equal'                    : 61,
-    'asterisk'                 : 42,
-    'guilsinglleft'            : 8249,
-    'plus'                     : 43,
-    'thorn'                    : 254,
-    'dagger'                   : 8224,
-    'increment'                : 8710,
-    'smallin'                  : 8714,
-    'notsmallowns'             : 8716,
-    'smallowns'                : 8717,
-    'QED'                      : 8718,
-    'rightangle'               : 8735,
-    'smallintclockwise'        : 8753,
-    'smallvarointclockwise'    : 8754,
-    'smallointctrcclockwise'   : 8755,
-    'ratio'                    : 8758,
-    'minuscolon'               : 8761,
-    'dotsminusdots'            : 8762,
-    'sinewave'                 : 8767,
-    'simneqq'                  : 8774,
-    'nlesssim'                 : 8820,
-    'ngtrsim'                  : 8821,
-    'nlessgtr'                 : 8824,
-    'ngtrless'                 : 8825,
-    'cupleftarrow'             : 8844,
-    'oequal'                   : 8860,
-    'rightassert'              : 8870,
-    'rightModels'              : 8875,
-    'hermitmatrix'             : 8889,
-    'barvee'                   : 8893,
-    'measuredrightangle'       : 8894,
-    'varlrtriangle'            : 8895,
-    'equalparallel'            : 8917,
-    'npreccurlyeq'             : 8928,
-    'nsucccurlyeq'             : 8929,
-    'nsqsubseteq'              : 8930,
-    'nsqsupseteq'              : 8931,
-    'sqsubsetneq'              : 8932,
-    'sqsupsetneq'              : 8933,
-    'disin'                    : 8946,
-    'varisins'                 : 8947,
-    'isins'                    : 8948,
-    'isindot'                  : 8949,
-    'varisinobar'              : 8950,
-    'isinobar'                 : 8951,
-    'isinvb'                   : 8952,
-    'isinE'                    : 8953,
-    'nisd'                     : 8954,
-    'varnis'                   : 8955,
-    'nis'                      : 8956,
-    'varniobar'                : 8957,
-    'niobar'                   : 8958,
-    'bagmember'                : 8959,
-    'triangle'                 : 9651,
-    'iiiint'                   : 10764,
-    'amalg'                    : 10815,
-    'merge'                    : 10837,
+    '#'                      : 0x23,
+    '$'                      : 0x24,
+    '%'                      : 0x25,
+    'AA'                     : 0xc5,
+    'AE'                     : 0xc6,
+    'BbbC'                   : 0x2102,
+    'BbbN'                   : 0x2115,
+    'BbbP'                   : 0x2119,
+    'BbbQ'                   : 0x211a,
+    'BbbR'                   : 0x211d,
+    'BbbZ'                   : 0x2124,
+    'Bumpeq'                 : 0x224e,
+    'Cap'                    : 0x22d2,
+    'Colon'                  : 0x2237,
+    'Cup'                    : 0x22d3,
+    'DH'                     : 0xd0,
+    'Delta'                  : 0x394,
+    'Doteq'                  : 0x2251,
+    'Downarrow'              : 0x21d3,
+    'Equiv'                  : 0x2263,
+    'Finv'                   : 0x2132,
+    'Game'                   : 0x2141,
+    'Gamma'                  : 0x393,
+    'H'                      : 0x30b,
+    'Im'                     : 0x2111,
+    'Join'                   : 0x2a1d,
+    'L'                      : 0x141,
+    'Lambda'                 : 0x39b,
+    'Ldsh'                   : 0x21b2,
+    'Leftarrow'              : 0x21d0,
+    'Leftrightarrow'         : 0x21d4,
+    'Lleftarrow'             : 0x21da,
+    'Longleftarrow'          : 0x27f8,
+    'Longleftrightarrow'     : 0x27fa,
+    'Longrightarrow'         : 0x27f9,
+    'Lsh'                    : 0x21b0,
+    'Nearrow'                : 0x21d7,
+    'Nwarrow'                : 0x21d6,
+    'O'                      : 0xd8,
+    'OE'                     : 0x152,
+    'Omega'                  : 0x3a9,
+    'P'                      : 0xb6,
+    'Phi'                    : 0x3a6,
+    'Pi'                     : 0x3a0,
+    'Psi'                    : 0x3a8,
+    'QED'                    : 0x220e,
+    'Rdsh'                   : 0x21b3,
+    'Re'                     : 0x211c,
+    'Rightarrow'             : 0x21d2,
+    'Rrightarrow'            : 0x21db,
+    'Rsh'                    : 0x21b1,
+    'S'                      : 0xa7,
+    'Searrow'                : 0x21d8,
+    'Sigma'                  : 0x3a3,
+    'Subset'                 : 0x22d0,
+    'Supset'                 : 0x22d1,
+    'Swarrow'                : 0x21d9,
+    'Theta'                  : 0x398,
+    'Thorn'                  : 0xde,
+    'Uparrow'                : 0x21d1,
+    'Updownarrow'            : 0x21d5,
+    'Upsilon'                : 0x3a5,
+    'Vdash'                  : 0x22a9,
+    'Vert'                   : 0x2016,
+    'Vvdash'                 : 0x22aa,
+    'Xi'                     : 0x39e,
+    '_'                      : 0x5f,
+    '__sqrt__'               : 0x221a,
+    'aa'                     : 0xe5,
+    'ac'                     : 0x223e,
+    'acute'                  : 0x301,
+    'acwopencirclearrow'     : 0x21ba,
+    'adots'                  : 0x22f0,
+    'ae'                     : 0xe6,
+    'aleph'                  : 0x2135,
+    'alpha'                  : 0x3b1,
+    'amalg'                  : 0x2a3f,
+    'angle'                  : 0x2220,
+    'approx'                 : 0x2248,
+    'approxeq'               : 0x224a,
+    'approxident'            : 0x224b,
+    'arceq'                  : 0x2258,
+    'ast'                    : 0x2217,
+    'asterisk'               : 0x2a,
+    'asymp'                  : 0x224d,
+    'backcong'               : 0x224c,
+    'backepsilon'            : 0x3f6,
+    'backprime'              : 0x2035,
+    'backsim'                : 0x223d,
+    'backsimeq'              : 0x22cd,
+    'backslash'              : 0x5c,
+    'bagmember'              : 0x22ff,
+    'bar'                    : 0x304,
+    'barleftarrow'           : 0x21e4,
+    'barvee'                 : 0x22bd,
+    'barwedge'               : 0x22bc,
+    'because'                : 0x2235,
+    'beta'                   : 0x3b2,
+    'beth'                   : 0x2136,
+    'between'                : 0x226c,
+    'bigcap'                 : 0x22c2,
+    'bigcirc'                : 0x25cb,
+    'bigcup'                 : 0x22c3,
+    'bigodot'                : 0x2a00,
+    'bigoplus'               : 0x2a01,
+    'bigotimes'              : 0x2a02,
+    'bigsqcup'               : 0x2a06,
+    'bigstar'                : 0x2605,
+    'bigtriangledown'        : 0x25bd,
+    'bigtriangleup'          : 0x25b3,
+    'biguplus'               : 0x2a04,
+    'bigvee'                 : 0x22c1,
+    'bigwedge'               : 0x22c0,
+    'blacksquare'            : 0x25a0,
+    'blacktriangle'          : 0x25b4,
+    'blacktriangledown'      : 0x25be,
+    'blacktriangleleft'      : 0x25c0,
+    'blacktriangleright'     : 0x25b6,
+    'bot'                    : 0x22a5,
+    'bowtie'                 : 0x22c8,
+    'boxbar'                 : 0x25eb,
+    'boxdot'                 : 0x22a1,
+    'boxminus'               : 0x229f,
+    'boxplus'                : 0x229e,
+    'boxtimes'               : 0x22a0,
+    'breve'                  : 0x306,
+    'bullet'                 : 0x2219,
+    'bumpeq'                 : 0x224f,
+    'c'                      : 0x327,
+    'candra'                 : 0x310,
+    'cap'                    : 0x2229,
+    'carriagereturn'         : 0x21b5,
+    'cdot'                   : 0x22c5,
+    'cdotp'                  : 0xb7,
+    'cdots'                  : 0x22ef,
+    'cent'                   : 0xa2,
+    'check'                  : 0x30c,
+    'checkmark'              : 0x2713,
+    'chi'                    : 0x3c7,
+    'circ'                   : 0x2218,
+    'circeq'                 : 0x2257,
+    'circlearrowleft'        : 0x21ba,
+    'circlearrowright'       : 0x21bb,
+    'circledR'               : 0xae,
+    'circledS'               : 0x24c8,
+    'circledast'             : 0x229b,
+    'circledcirc'            : 0x229a,
+    'circleddash'            : 0x229d,
+    'circumflexaccent'       : 0x302,
+    'clubsuit'               : 0x2663,
+    'clubsuitopen'           : 0x2667,
+    'colon'                  : 0x3a,
+    'coloneq'                : 0x2254,
+    'combiningacuteaccent'   : 0x301,
+    'combiningbreve'         : 0x306,
+    'combiningdiaeresis'     : 0x308,
+    'combiningdotabove'      : 0x307,
+    'combiningfourdotsabove' : 0x20dc,
+    'combininggraveaccent'   : 0x300,
+    'combiningoverline'      : 0x304,
+    'combiningrightarrowabove' : 0x20d7,
+    'combiningthreedotsabove' : 0x20db,
+    'combiningtilde'         : 0x303,
+    'complement'             : 0x2201,
+    'cong'                   : 0x2245,
+    'coprod'                 : 0x2210,
+    'copyright'              : 0xa9,
+    'cup'                    : 0x222a,
+    'cupdot'                 : 0x228d,
+    'cupleftarrow'           : 0x228c,
+    'curlyeqprec'            : 0x22de,
+    'curlyeqsucc'            : 0x22df,
+    'curlyvee'               : 0x22ce,
+    'curlywedge'             : 0x22cf,
+    'curvearrowleft'         : 0x21b6,
+    'curvearrowright'        : 0x21b7,
+    'cwopencirclearrow'      : 0x21bb,
+    'd'                      : 0x323,
+    'dag'                    : 0x2020,
+    'dagger'                 : 0x2020,
+    'daleth'                 : 0x2138,
+    'danger'                 : 0x2621,
+    'dashleftarrow'          : 0x290e,
+    'dashrightarrow'         : 0x290f,
+    'dashv'                  : 0x22a3,
+    'ddag'                   : 0x2021,
+    'ddagger'                : 0x2021,
+    'ddddot'                 : 0x20dc,
+    'dddot'                  : 0x20db,
+    'ddot'                   : 0x308,
+    'ddots'                  : 0x22f1,
+    'degree'                 : 0xb0,
+    'delta'                  : 0x3b4,
+    'dh'                     : 0xf0,
+    'diamond'                : 0x22c4,
+    'diamondsuit'            : 0x2662,
+    'digamma'                : 0x3dd,
+    'disin'                  : 0x22f2,
+    'div'                    : 0xf7,
+    'divideontimes'          : 0x22c7,
+    'dot'                    : 0x307,
+    'doteq'                  : 0x2250,
+    'doteqdot'               : 0x2251,
+    'dotminus'               : 0x2238,
+    'dotplus'                : 0x2214,
+    'dots'                   : 0x2026,
+    'dotsminusdots'          : 0x223a,
+    'doublebarwedge'         : 0x2306,
+    'downarrow'              : 0x2193,
+    'downdownarrows'         : 0x21ca,
+    'downharpoonleft'        : 0x21c3,
+    'downharpoonright'       : 0x21c2,
+    'downzigzagarrow'        : 0x21af,
+    'ell'                    : 0x2113,
+    'emdash'                 : 0x2014,
+    'emptyset'               : 0x2205,
+    'endash'                 : 0x2013,
+    'epsilon'                : 0x3b5,
+    'eqcirc'                 : 0x2256,
+    'eqcolon'                : 0x2255,
+    'eqdef'                  : 0x225d,
+    'eqgtr'                  : 0x22dd,
+    'eqless'                 : 0x22dc,
+    'eqsim'                  : 0x2242,
+    'eqslantgtr'             : 0x2a96,
+    'eqslantless'            : 0x2a95,
+    'equal'                  : 0x3d,
+    'equalparallel'          : 0x22d5,
+    'equiv'                  : 0x2261,
+    'eta'                    : 0x3b7,
+    'eth'                    : 0xf0,
+    'exists'                 : 0x2203,
+    'fallingdotseq'          : 0x2252,
+    'flat'                   : 0x266d,
+    'forall'                 : 0x2200,
+    'frakC'                  : 0x212d,
+    'frakZ'                  : 0x2128,
+    'frown'                  : 0x2322,
+    'gamma'                  : 0x3b3,
+    'geq'                    : 0x2265,
+    'geqq'                   : 0x2267,
+    'geqslant'               : 0x2a7e,
+    'gg'                     : 0x226b,
+    'ggg'                    : 0x22d9,
+    'gimel'                  : 0x2137,
+    'gnapprox'               : 0x2a8a,
+    'gneqq'                  : 0x2269,
+    'gnsim'                  : 0x22e7,
+    'grave'                  : 0x300,
+    'greater'                : 0x3e,
+    'gtrapprox'              : 0x2a86,
+    'gtrdot'                 : 0x22d7,
+    'gtreqless'              : 0x22db,
+    'gtreqqless'             : 0x2a8c,
+    'gtrless'                : 0x2277,
+    'gtrsim'                 : 0x2273,
+    'guillemotleft'          : 0xab,
+    'guillemotright'         : 0xbb,
+    'guilsinglleft'          : 0x2039,
+    'guilsinglright'         : 0x203a,
+    'hat'                    : 0x302,
+    'hbar'                   : 0x127,
+    'heartsuit'              : 0x2661,
+    'hermitmatrix'           : 0x22b9,
+    'hookleftarrow'          : 0x21a9,
+    'hookrightarrow'         : 0x21aa,
+    'hslash'                 : 0x210f,
+    'i'                      : 0x131,
+    'iiiint'                 : 0x2a0c,
+    'iiint'                  : 0x222d,
+    'iint'                   : 0x222c,
+    'imageof'                : 0x22b7,
+    'imath'                  : 0x131,
+    'in'                     : 0x2208,
+    'increment'              : 0x2206,
+    'infty'                  : 0x221e,
+    'int'                    : 0x222b,
+    'intercal'               : 0x22ba,
+    'invnot'                 : 0x2310,
+    'iota'                   : 0x3b9,
+    'isinE'                  : 0x22f9,
+    'isindot'                : 0x22f5,
+    'isinobar'               : 0x22f7,
+    'isins'                  : 0x22f4,
+    'isinvb'                 : 0x22f8,
+    'jmath'                  : 0x237,
+    'k'                      : 0x328,
+    'kappa'                  : 0x3ba,
+    'kernelcontraction'      : 0x223b,
+    'l'                      : 0x142,
+    'lambda'                 : 0x3bb,
+    'lambdabar'              : 0x19b,
+    'langle'                 : 0x27e8,
+    'lasp'                   : 0x2bd,
+    'lbrace'                 : 0x7b,
+    'lbrack'                 : 0x5b,
+    'lceil'                  : 0x2308,
+    'ldots'                  : 0x2026,
+    'leadsto'                : 0x21dd,
+    'leftarrow'              : 0x2190,
+    'leftarrowtail'          : 0x21a2,
+    'leftbrace'              : 0x7b,
+    'leftharpoonaccent'      : 0x20d0,
+    'leftharpoondown'        : 0x21bd,
+    'leftharpoonup'          : 0x21bc,
+    'leftleftarrows'         : 0x21c7,
+    'leftparen'              : 0x28,
+    'leftrightarrow'         : 0x2194,
+    'leftrightarrows'        : 0x21c6,
+    'leftrightharpoons'      : 0x21cb,
+    'leftrightsquigarrow'    : 0x21ad,
+    'leftsquigarrow'         : 0x219c,
+    'leftthreetimes'         : 0x22cb,
+    'leq'                    : 0x2264,
+    'leqq'                   : 0x2266,
+    'leqslant'               : 0x2a7d,
+    'less'                   : 0x3c,
+    'lessapprox'             : 0x2a85,
+    'lessdot'                : 0x22d6,
+    'lesseqgtr'              : 0x22da,
+    'lesseqqgtr'             : 0x2a8b,
+    'lessgtr'                : 0x2276,
+    'lesssim'                : 0x2272,
+    'lfloor'                 : 0x230a,
+    'lgroup'                 : 0x27ee,
+    'lhd'                    : 0x25c1,
+    'll'                     : 0x226a,
+    'llcorner'               : 0x231e,
+    'lll'                    : 0x22d8,
+    'lnapprox'               : 0x2a89,
+    'lneqq'                  : 0x2268,
+    'lnsim'                  : 0x22e6,
+    'longleftarrow'          : 0x27f5,
+    'longleftrightarrow'     : 0x27f7,
+    'longmapsto'             : 0x27fc,
+    'longrightarrow'         : 0x27f6,
+    'looparrowleft'          : 0x21ab,
+    'looparrowright'         : 0x21ac,
+    'lq'                     : 0x2018,
+    'lrcorner'               : 0x231f,
+    'ltimes'                 : 0x22c9,
+    'macron'                 : 0xaf,
+    'maltese'                : 0x2720,
+    'mapsdown'               : 0x21a7,
+    'mapsfrom'               : 0x21a4,
+    'mapsto'                 : 0x21a6,
+    'mapsup'                 : 0x21a5,
+    'measeq'                 : 0x225e,
+    'measuredangle'          : 0x2221,
+    'measuredrightangle'     : 0x22be,
+    'merge'                  : 0x2a55,
+    'mho'                    : 0x2127,
+    'mid'                    : 0x2223,
+    'minus'                  : 0x2212,
+    'minuscolon'             : 0x2239,
+    'models'                 : 0x22a7,
+    'mp'                     : 0x2213,
+    'mu'                     : 0x3bc,
+    'multimap'               : 0x22b8,
+    'nLeftarrow'             : 0x21cd,
+    'nLeftrightarrow'        : 0x21ce,
+    'nRightarrow'            : 0x21cf,
+    'nVDash'                 : 0x22af,
+    'nVdash'                 : 0x22ae,
+    'nabla'                  : 0x2207,
+    'napprox'                : 0x2249,
+    'natural'                : 0x266e,
+    'ncong'                  : 0x2247,
+    'ne'                     : 0x2260,
+    'nearrow'                : 0x2197,
+    'neg'                    : 0xac,
+    'neq'                    : 0x2260,
+    'nequiv'                 : 0x2262,
+    'nexists'                : 0x2204,
+    'ngeq'                   : 0x2271,
+    'ngtr'                   : 0x226f,
+    'ngtrless'               : 0x2279,
+    'ngtrsim'                : 0x2275,
+    'ni'                     : 0x220b,
+    'niobar'                 : 0x22fe,
+    'nis'                    : 0x22fc,
+    'nisd'                   : 0x22fa,
+    'nleftarrow'             : 0x219a,
+    'nleftrightarrow'        : 0x21ae,
+    'nleq'                   : 0x2270,
+    'nless'                  : 0x226e,
+    'nlessgtr'               : 0x2278,
+    'nlesssim'               : 0x2274,
+    'nmid'                   : 0x2224,
+    'not'                    : 0x338,
+    'notin'                  : 0x2209,
+    'notsmallowns'           : 0x220c,
+    'nparallel'              : 0x2226,
+    'nprec'                  : 0x2280,
+    'npreccurlyeq'           : 0x22e0,
+    'nrightarrow'            : 0x219b,
+    'nsim'                   : 0x2241,
+    'nsimeq'                 : 0x2244,
+    'nsqsubseteq'            : 0x22e2,
+    'nsqsupseteq'            : 0x22e3,
+    'nsubset'                : 0x2284,
+    'nsubseteq'              : 0x2288,
+    'nsucc'                  : 0x2281,
+    'nsucccurlyeq'           : 0x22e1,
+    'nsupset'                : 0x2285,
+    'nsupseteq'              : 0x2289,
+    'ntriangleleft'          : 0x22ea,
+    'ntrianglelefteq'        : 0x22ec,
+    'ntriangleright'         : 0x22eb,
+    'ntrianglerighteq'       : 0x22ed,
+    'nu'                     : 0x3bd,
+    'nvDash'                 : 0x22ad,
+    'nvdash'                 : 0x22ac,
+    'nwarrow'                : 0x2196,
+    'o'                      : 0xf8,
+    'obar'                   : 0x233d,
+    'ocirc'                  : 0x30a,
+    'odot'                   : 0x2299,
+    'oe'                     : 0x153,
+    'oequal'                 : 0x229c,
+    'oiiint'                 : 0x2230,
+    'oiint'                  : 0x222f,
+    'oint'                   : 0x222e,
+    'omega'                  : 0x3c9,
+    'ominus'                 : 0x2296,
+    'oplus'                  : 0x2295,
+    'origof'                 : 0x22b6,
+    'oslash'                 : 0x2298,
+    'otimes'                 : 0x2297,
+    'overarc'                : 0x311,
+    'overleftarrow'          : 0x20d6,
+    'overleftrightarrow'     : 0x20e1,
+    'parallel'               : 0x2225,
+    'partial'                : 0x2202,
+    'perp'                   : 0x27c2,
+    'perthousand'            : 0x2030,
+    'phi'                    : 0x3d5,
+    'pi'                     : 0x3c0,
+    'pitchfork'              : 0x22d4,
+    'plus'                   : 0x2b,
+    'pm'                     : 0xb1,
+    'prec'                   : 0x227a,
+    'precapprox'             : 0x2ab7,
+    'preccurlyeq'            : 0x227c,
+    'preceq'                 : 0x227c,
+    'precnapprox'            : 0x2ab9,
+    'precnsim'               : 0x22e8,
+    'precsim'                : 0x227e,
+    'prime'                  : 0x2032,
+    'prod'                   : 0x220f,
+    'propto'                 : 0x221d,
+    'prurel'                 : 0x22b0,
+    'psi'                    : 0x3c8,
+    'quad'                   : 0x2003,
+    'questeq'                : 0x225f,
+    'rangle'                 : 0x27e9,
+    'rasp'                   : 0x2bc,
+    'ratio'                  : 0x2236,
+    'rbrace'                 : 0x7d,
+    'rbrack'                 : 0x5d,
+    'rceil'                  : 0x2309,
+    'rfloor'                 : 0x230b,
+    'rgroup'                 : 0x27ef,
+    'rhd'                    : 0x25b7,
+    'rho'                    : 0x3c1,
+    'rightModels'            : 0x22ab,
+    'rightangle'             : 0x221f,
+    'rightarrow'             : 0x2192,
+    'rightarrowbar'          : 0x21e5,
+    'rightarrowtail'         : 0x21a3,
+    'rightassert'            : 0x22a6,
+    'rightbrace'             : 0x7d,
+    'rightharpoonaccent'     : 0x20d1,
+    'rightharpoondown'       : 0x21c1,
+    'rightharpoonup'         : 0x21c0,
+    'rightleftarrows'        : 0x21c4,
+    'rightleftharpoons'      : 0x21cc,
+    'rightparen'             : 0x29,
+    'rightrightarrows'       : 0x21c9,
+    'rightsquigarrow'        : 0x219d,
+    'rightthreetimes'        : 0x22cc,
+    'rightzigzagarrow'       : 0x21dd,
+    'ring'                   : 0x2da,
+    'risingdotseq'           : 0x2253,
+    'rq'                     : 0x2019,
+    'rtimes'                 : 0x22ca,
+    'scrB'                   : 0x212c,
+    'scrE'                   : 0x2130,
+    'scrF'                   : 0x2131,
+    'scrH'                   : 0x210b,
+    'scrI'                   : 0x2110,
+    'scrL'                   : 0x2112,
+    'scrM'                   : 0x2133,
+    'scrR'                   : 0x211b,
+    'scre'                   : 0x212f,
+    'scrg'                   : 0x210a,
+    'scro'                   : 0x2134,
+    'scurel'                 : 0x22b1,
+    'searrow'                : 0x2198,
+    'setminus'               : 0x2216,
+    'sharp'                  : 0x266f,
+    'sigma'                  : 0x3c3,
+    'sim'                    : 0x223c,
+    'simeq'                  : 0x2243,
+    'simneqq'                : 0x2246,
+    'sinewave'               : 0x223f,
+    'slash'                  : 0x2215,
+    'smallin'                : 0x220a,
+    'smallintclockwise'      : 0x2231,
+    'smallointctrcclockwise' : 0x2233,
+    'smallowns'              : 0x220d,
+    'smallsetminus'          : 0x2216,
+    'smallvarointclockwise'  : 0x2232,
+    'smile'                  : 0x2323,
+    'solbar'                 : 0x233f,
+    'spadesuit'              : 0x2660,
+    'spadesuitopen'          : 0x2664,
+    'sphericalangle'         : 0x2222,
+    'sqcap'                  : 0x2293,
+    'sqcup'                  : 0x2294,
+    'sqsubset'               : 0x228f,
+    'sqsubseteq'             : 0x2291,
+    'sqsubsetneq'            : 0x22e4,
+    'sqsupset'               : 0x2290,
+    'sqsupseteq'             : 0x2292,
+    'sqsupsetneq'            : 0x22e5,
+    'ss'                     : 0xdf,
+    'star'                   : 0x22c6,
+    'stareq'                 : 0x225b,
+    'sterling'               : 0xa3,
+    'subset'                 : 0x2282,
+    'subseteq'               : 0x2286,
+    'subseteqq'              : 0x2ac5,
+    'subsetneq'              : 0x228a,
+    'subsetneqq'             : 0x2acb,
+    'succ'                   : 0x227b,
+    'succapprox'             : 0x2ab8,
+    'succcurlyeq'            : 0x227d,
+    'succeq'                 : 0x227d,
+    'succnapprox'            : 0x2aba,
+    'succnsim'               : 0x22e9,
+    'succsim'                : 0x227f,
+    'sum'                    : 0x2211,
+    'supset'                 : 0x2283,
+    'supseteq'               : 0x2287,
+    'supseteqq'              : 0x2ac6,
+    'supsetneq'              : 0x228b,
+    'supsetneqq'             : 0x2acc,
+    'swarrow'                : 0x2199,
+    't'                      : 0x361,
+    'tau'                    : 0x3c4,
+    'textasciiacute'         : 0xb4,
+    'textasciicircum'        : 0x5e,
+    'textasciigrave'         : 0x60,
+    'textasciitilde'         : 0x7e,
+    'textexclamdown'         : 0xa1,
+    'textquestiondown'       : 0xbf,
+    'textquotedblleft'       : 0x201c,
+    'textquotedblright'      : 0x201d,
+    'therefore'              : 0x2234,
+    'theta'                  : 0x3b8,
+    'thickspace'             : 0x2005,
+    'thorn'                  : 0xfe,
+    'tilde'                  : 0x303,
+    'times'                  : 0xd7,
+    'to'                     : 0x2192,
+    'top'                    : 0x22a4,
+    'triangle'               : 0x25b3,
+    'triangledown'           : 0x25bf,
+    'triangleeq'             : 0x225c,
+    'triangleleft'           : 0x25c1,
+    'trianglelefteq'         : 0x22b4,
+    'triangleq'              : 0x225c,
+    'triangleright'          : 0x25b7,
+    'trianglerighteq'        : 0x22b5,
+    'turnednot'              : 0x2319,
+    'twoheaddownarrow'       : 0x21a1,
+    'twoheadleftarrow'       : 0x219e,
+    'twoheadrightarrow'      : 0x21a0,
+    'twoheaduparrow'         : 0x219f,
+    'ulcorner'               : 0x231c,
+    'underbar'               : 0x331,
+    'unlhd'                  : 0x22b4,
+    'unrhd'                  : 0x22b5,
+    'uparrow'                : 0x2191,
+    'updownarrow'            : 0x2195,
+    'updownarrowbar'         : 0x21a8,
+    'updownarrows'           : 0x21c5,
+    'upharpoonleft'          : 0x21bf,
+    'upharpoonright'         : 0x21be,
+    'uplus'                  : 0x228e,
+    'upsilon'                : 0x3c5,
+    'upuparrows'             : 0x21c8,
+    'urcorner'               : 0x231d,
+    'vDash'                  : 0x22a8,
+    'varepsilon'             : 0x3b5,
+    'varisinobar'            : 0x22f6,
+    'varisins'               : 0x22f3,
+    'varkappa'               : 0x3f0,
+    'varlrtriangle'          : 0x22bf,
+    'varniobar'              : 0x22fd,
+    'varnis'                 : 0x22fb,
+    'varnothing'             : 0x2205,
+    'varphi'                 : 0x3c6,
+    'varpi'                  : 0x3d6,
+    'varpropto'              : 0x221d,
+    'varrho'                 : 0x3f1,
+    'varsigma'               : 0x3c2,
+    'vartheta'               : 0x3d1,
+    'vartriangle'            : 0x25b5,
+    'vartriangleleft'        : 0x22b2,
+    'vartriangleright'       : 0x22b3,
+    'vdash'                  : 0x22a2,
+    'vdots'                  : 0x22ee,
+    'vec'                    : 0x20d7,
+    'vee'                    : 0x2228,
+    'veebar'                 : 0x22bb,
+    'veeeq'                  : 0x225a,
+    'vert'                   : 0x7c,
+    'wedge'                  : 0x2227,
+    'wedgeq'                 : 0x2259,
+    'widebar'                : 0x305,
+    'widehat'                : 0x302,
+    'widetilde'              : 0x303,
+    'wp'                     : 0x2118,
+    'wr'                     : 0x2240,
+    'xi'                     : 0x3be,
+    'yen'                    : 0xa5,
+    'zeta'                   : 0x3b6,
+    '{'                      : 0x7b,
+    '|'                      : 0x2016,
+    '}'                      : 0x7d,
 }
 
 # Each element is a 4-tuple of the form:

From db6198d45fe48263d5047d50c5a0a5ed6baf351c Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Thu, 31 Aug 2023 12:17:38 +0200
Subject: [PATCH 0101/1120] Clarify loading of backend FigureCanvas and show().

- FigureCanvas is now required to exist on backend modules (since the
  deprecation elapsed in 3.8) and we indeed already access that
  attribute directly when checking required_interactive_framework, so
  remove redundant getattrs.
- Clarify the error message when manager_class is None *and* there's no
  global show().  (Previously an AttributeError would be raised.)
---
 lib/matplotlib/pyplot.py | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 415d5c042241..6c8294d31a3f 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -339,8 +339,9 @@ def switch_backend(newbackend: str) -> None:
     old_backend = dict.__getitem__(rcParams, 'backend')
 
     module = importlib.import_module(cbook._backend_module_name(newbackend))
+    canvas_class = module.FigureCanvas
 
-    required_framework = module.FigureCanvas.required_interactive_framework
+    required_framework = canvas_class.required_interactive_framework
     if required_framework is not None:
         current_framework = cbook._get_running_interactive_framework()
         if (current_framework and required_framework
@@ -369,8 +370,6 @@ class backend_mod(matplotlib.backend_bases._Backend):
     # update backend_mod accordingly; also, per-backend customization of
     # draw_if_interactive is disabled.
     if new_figure_manager is None:
-        # Only try to get the canvas class if have opted into the new scheme.
-        canvas_class = backend_mod.FigureCanvas
 
         def new_figure_manager_given_figure(num, figure):
             return canvas_class.new_manager(figure, num)
@@ -394,8 +393,7 @@ def draw_if_interactive() -> None:
 
     # If the manager explicitly overrides pyplot_show, use it even if a global
     # show is already present, as the latter may be here for backcompat.
-    manager_class = getattr(getattr(backend_mod, "FigureCanvas", None),
-                            "manager_class", None)
+    manager_class = getattr(canvas_class, "manager_class", None)
     # We can't compare directly manager_class.pyplot_show and FMB.pyplot_show because
     # pyplot_show is a classmethod so the above constructs are bound classmethods, and
     # thus always different (being bound to different classes).  We also have to use
@@ -405,6 +403,10 @@ def draw_if_interactive() -> None:
     if (show is None
             or (manager_pyplot_show is not None
                 and manager_pyplot_show != base_pyplot_show)):
+        if not manager_pyplot_show:
+            raise ValueError(
+                f"Backend {newbackend} defines neither FigureCanvas.manager_class nor "
+                f"a toplevel show function")
         _pyplot_show = cast('Any', manager_class).pyplot_show
         backend_mod.show = _pyplot_show  # type: ignore[method-assign]
 

From 219323a1cb6fe5840b4a503d7dc8962a236d7664 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Wed, 30 Aug 2023 10:47:20 +0200
Subject: [PATCH 0102/1120] [MNT] Move SubplotParams from figure to gridspec

Logically, this belongs more to the gridspec layout than
to the figure.

There is no API breakage involved, because
`matplotlib.figure` reimports `SubplotParams`. Do we
nevertheless want an API change note?
---
 doc/api/gridspec_api.rst                      |  1 +
 .../next_api_changes/behavior/26634-TH.rst    |  5 ++
 .../auto_subplots_adjust.py                   |  2 +-
 lib/matplotlib/figure.py                      | 67 +-----------------
 lib/matplotlib/figure.pyi                     | 28 +-------
 lib/matplotlib/gridspec.py                    | 70 +++++++++++++++++--
 lib/matplotlib/gridspec.pyi                   | 28 +++++++-
 7 files changed, 102 insertions(+), 99 deletions(-)
 create mode 100644 doc/api/next_api_changes/behavior/26634-TH.rst

diff --git a/doc/api/gridspec_api.rst b/doc/api/gridspec_api.rst
index 2b9f5a67784c..fe1137d94113 100644
--- a/doc/api/gridspec_api.rst
+++ b/doc/api/gridspec_api.rst
@@ -19,3 +19,4 @@ Classes
    SubplotSpec
    GridSpecBase
    GridSpecFromSubplotSpec
+   SubplotParams
diff --git a/doc/api/next_api_changes/behavior/26634-TH.rst b/doc/api/next_api_changes/behavior/26634-TH.rst
new file mode 100644
index 000000000000..4961722078d6
--- /dev/null
+++ b/doc/api/next_api_changes/behavior/26634-TH.rst
@@ -0,0 +1,5 @@
+``SubplotParams`` has been moved from ``matplotlib.figure`` to ``matplotlib.gridspec``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+It is still importable from ``matplotlib.figure``, so does not require any changes to
+existing code.
diff --git a/galleries/examples/subplots_axes_and_figures/auto_subplots_adjust.py b/galleries/examples/subplots_axes_and_figures/auto_subplots_adjust.py
index 3bd0d3f2bec1..e0a8c76a0e61 100644
--- a/galleries/examples/subplots_axes_and_figures/auto_subplots_adjust.py
+++ b/galleries/examples/subplots_axes_and_figures/auto_subplots_adjust.py
@@ -83,5 +83,5 @@ def on_draw(event):
 #    - `matplotlib.transforms.BboxBase.union`
 #    - `matplotlib.transforms.Transform.inverted`
 #    - `matplotlib.figure.Figure.subplots_adjust`
-#    - `matplotlib.figure.SubplotParams`
+#    - `matplotlib.gridspec.SubplotParams`
 #    - `matplotlib.backend_bases.FigureCanvasBase.mpl_connect`
diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
index 4361ef655c81..c28ba98edec8 100644
--- a/lib/matplotlib/figure.py
+++ b/lib/matplotlib/figure.py
@@ -10,9 +10,6 @@
     `SubFigure`) with `Figure.add_subfigure` or `Figure.subfigures` methods
     (provisional API v3.4).
 
-`SubplotParams`
-    Control the default spacing between subplots.
-
 Figures are typically created using pyplot methods `~.pyplot.figure`,
 `~.pyplot.subplots`, and `~.pyplot.subplot_mosaic`.
 
@@ -51,7 +48,7 @@
 import matplotlib.image as mimage
 
 from matplotlib.axes import Axes
-from matplotlib.gridspec import GridSpec
+from matplotlib.gridspec import GridSpec, SubplotParams
 from matplotlib.layout_engine import (
     ConstrainedLayoutEngine, TightLayoutEngine, LayoutEngine,
     PlaceHolderLayoutEngine
@@ -118,66 +115,6 @@ def __setstate__(self, state):
         self._counter = itertools.count(next_counter)
 
 
-class SubplotParams:
-    """
-    A class to hold the parameters for a subplot.
-    """
-
-    def __init__(self, left=None, bottom=None, right=None, top=None,
-                 wspace=None, hspace=None):
-        """
-        Defaults are given by :rc:`figure.subplot.[name]`.
-
-        Parameters
-        ----------
-        left : float
-            The position of the left edge of the subplots,
-            as a fraction of the figure width.
-        right : float
-            The position of the right edge of the subplots,
-            as a fraction of the figure width.
-        bottom : float
-            The position of the bottom edge of the subplots,
-            as a fraction of the figure height.
-        top : float
-            The position of the top edge of the subplots,
-            as a fraction of the figure height.
-        wspace : float
-            The width of the padding between subplots,
-            as a fraction of the average Axes width.
-        hspace : float
-            The height of the padding between subplots,
-            as a fraction of the average Axes height.
-        """
-        for key in ["left", "bottom", "right", "top", "wspace", "hspace"]:
-            setattr(self, key, mpl.rcParams[f"figure.subplot.{key}"])
-        self.update(left, bottom, right, top, wspace, hspace)
-
-    def update(self, left=None, bottom=None, right=None, top=None,
-               wspace=None, hspace=None):
-        """
-        Update the dimensions of the passed parameters. *None* means unchanged.
-        """
-        if ((left if left is not None else self.left)
-                >= (right if right is not None else self.right)):
-            raise ValueError('left cannot be >= right')
-        if ((bottom if bottom is not None else self.bottom)
-                >= (top if top is not None else self.top)):
-            raise ValueError('bottom cannot be >= top')
-        if left is not None:
-            self.left = left
-        if right is not None:
-            self.right = right
-        if bottom is not None:
-            self.bottom = bottom
-        if top is not None:
-            self.top = top
-        if wspace is not None:
-            self.wspace = wspace
-        if hspace is not None:
-            self.hspace = hspace
-
-
 class FigureBase(Artist):
     """
     Base class for `.Figure` and `.SubFigure` containing the methods that add
@@ -2435,7 +2372,7 @@ def __init__(self,
         frameon : bool, default: :rc:`figure.frameon`
             If ``False``, suppress drawing the figure background patch.
 
-        subplotpars : `SubplotParams`
+        subplotpars : `~matplotlib.gridspec.SubplotParams`
             Subplot parameters. If not given, the default subplot
             parameters :rc:`figure.subplot.*` are used.
 
diff --git a/lib/matplotlib/figure.pyi b/lib/matplotlib/figure.pyi
index 40e8fce0321f..f53feb78014d 100644
--- a/lib/matplotlib/figure.pyi
+++ b/lib/matplotlib/figure.pyi
@@ -11,7 +11,7 @@ from matplotlib.backend_bases import (
 from matplotlib.colors import Colormap, Normalize
 from matplotlib.colorbar import Colorbar
 from matplotlib.cm import ScalarMappable
-from matplotlib.gridspec import GridSpec, SubplotSpec
+from matplotlib.gridspec import GridSpec, SubplotSpec, SubplotParams as SubplotParams
 from matplotlib.image import _ImageBase, FigureImage
 from matplotlib.layout_engine import LayoutEngine
 from matplotlib.legend import Legend
@@ -27,32 +27,6 @@ from collections.abc import Callable, Iterable
 from typing import Any, IO, Literal, overload
 from .typing import ColorType, HashableList
 
-class SubplotParams:
-    def __init__(
-        self,
-        left: float | None = ...,
-        bottom: float | None = ...,
-        right: float | None = ...,
-        top: float | None = ...,
-        wspace: float | None = ...,
-        hspace: float | None = ...,
-    ) -> None: ...
-    left: float
-    right: float
-    bottom: float
-    top: float
-    wspace: float
-    hspace: float
-    def update(
-        self,
-        left: float | None = ...,
-        bottom: float | None = ...,
-        right: float | None = ...,
-        top: float | None = ...,
-        wspace: float | None = ...,
-        hspace: float | None = ...,
-    ) -> None: ...
-
 class FigureBase(Artist):
     artists: list[Artist]
     lines: list[Line2D]
diff --git a/lib/matplotlib/gridspec.py b/lib/matplotlib/gridspec.py
index b2f1b5d8ff2e..13a7d29ca563 100644
--- a/lib/matplotlib/gridspec.py
+++ b/lib/matplotlib/gridspec.py
@@ -320,7 +320,7 @@ class GridSpec(GridSpecBase):
     A grid layout to place subplots within a figure.
 
     The location of the grid cells is determined in a similar way to
-    `~.figure.SubplotParams` using *left*, *right*, *top*, *bottom*, *wspace*
+    `.SubplotParams` using *left*, *right*, *top*, *bottom*, *wspace*
     and *hspace*.
 
     Indexing a GridSpec instance returns a `.SubplotSpec`.
@@ -424,7 +424,7 @@ def get_subplot_params(self, figure=None):
         if figure is None:
             kw = {k: mpl.rcParams["figure.subplot."+k]
                   for k in self._AllowedKeys}
-            subplotpars = mpl.figure.SubplotParams(**kw)
+            subplotpars = SubplotParams(**kw)
         else:
             subplotpars = copy.copy(figure.subplotpars)
 
@@ -517,9 +517,9 @@ def get_subplot_params(self, figure=None):
         figbox = self._subplot_spec.get_position(figure)
         left, bottom, right, top = figbox.extents
 
-        return mpl.figure.SubplotParams(left=left, right=right,
-                                        bottom=bottom, top=top,
-                                        wspace=wspace, hspace=hspace)
+        return SubplotParams(left=left, right=right,
+                             bottom=bottom, top=top,
+                             wspace=wspace, hspace=hspace)
 
     def get_topmost_subplotspec(self):
         """
@@ -736,3 +736,63 @@ def subgridspec(self, nrows, ncols, **kwargs):
                 fig.add_subplot(gssub[0, i])
         """
         return GridSpecFromSubplotSpec(nrows, ncols, self, **kwargs)
+
+
+class SubplotParams:
+    """
+    Parameters defining the positioning of a subplots grid in a figure.
+    """
+
+    def __init__(self, left=None, bottom=None, right=None, top=None,
+                 wspace=None, hspace=None):
+        """
+        Defaults are given by :rc:`figure.subplot.[name]`.
+
+        Parameters
+        ----------
+        left : float
+            The position of the left edge of the subplots,
+            as a fraction of the figure width.
+        right : float
+            The position of the right edge of the subplots,
+            as a fraction of the figure width.
+        bottom : float
+            The position of the bottom edge of the subplots,
+            as a fraction of the figure height.
+        top : float
+            The position of the top edge of the subplots,
+            as a fraction of the figure height.
+        wspace : float
+            The width of the padding between subplots,
+            as a fraction of the average Axes width.
+        hspace : float
+            The height of the padding between subplots,
+            as a fraction of the average Axes height.
+        """
+        for key in ["left", "bottom", "right", "top", "wspace", "hspace"]:
+            setattr(self, key, mpl.rcParams[f"figure.subplot.{key}"])
+        self.update(left, bottom, right, top, wspace, hspace)
+
+    def update(self, left=None, bottom=None, right=None, top=None,
+               wspace=None, hspace=None):
+        """
+        Update the dimensions of the passed parameters. *None* means unchanged.
+        """
+        if ((left if left is not None else self.left)
+                >= (right if right is not None else self.right)):
+            raise ValueError('left cannot be >= right')
+        if ((bottom if bottom is not None else self.bottom)
+                >= (top if top is not None else self.top)):
+            raise ValueError('bottom cannot be >= top')
+        if left is not None:
+            self.left = left
+        if right is not None:
+            self.right = right
+        if bottom is not None:
+            self.bottom = bottom
+        if top is not None:
+            self.top = top
+        if wspace is not None:
+            self.wspace = wspace
+        if hspace is not None:
+            self.hspace = hspace
diff --git a/lib/matplotlib/gridspec.pyi b/lib/matplotlib/gridspec.pyi
index 6e2273080b3b..6f314054a9ee 100644
--- a/lib/matplotlib/gridspec.pyi
+++ b/lib/matplotlib/gridspec.pyi
@@ -5,7 +5,7 @@ import numpy as np
 
 from matplotlib.axes import Axes, SubplotBase
 from matplotlib.backend_bases import RendererBase
-from matplotlib.figure import Figure, SubplotParams
+from matplotlib.figure import Figure
 from matplotlib.transforms import Bbox
 
 class GridSpecBase:
@@ -132,3 +132,29 @@ class SubplotSpec:
     def subgridspec(
         self, nrows: int, ncols: int, **kwargs
     ) -> GridSpecFromSubplotSpec: ...
+
+class SubplotParams:
+    def __init__(
+        self,
+        left: float | None = ...,
+        bottom: float | None = ...,
+        right: float | None = ...,
+        top: float | None = ...,
+        wspace: float | None = ...,
+        hspace: float | None = ...,
+    ) -> None: ...
+    left: float
+    right: float
+    bottom: float
+    top: float
+    wspace: float
+    hspace: float
+    def update(
+        self,
+        left: float | None = ...,
+        bottom: float | None = ...,
+        right: float | None = ...,
+        top: float | None = ...,
+        wspace: float | None = ...,
+        hspace: float | None = ...,
+    ) -> None: ...

From 88863e1bc62a203d606d19d0aa3e14de12ceeeb6 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Thu, 31 Aug 2023 00:42:29 +0200
Subject: [PATCH 0103/1120] [DOC] Enhance API reference index

Co-authored-by: Jody Klymak <jklymak@gmail.com>
---
 doc/_static/mpl.css |  5 ++++
 doc/api/index.rst   | 56 +++++++++++++++++++++++++++++++++------------
 2 files changed, 47 insertions(+), 14 deletions(-)

diff --git a/doc/_static/mpl.css b/doc/_static/mpl.css
index e9d7d65f3e01..45ecb21d5511 100644
--- a/doc/_static/mpl.css
+++ b/doc/_static/mpl.css
@@ -122,6 +122,11 @@ table.property-table td {
     margin: 0 0.5em;
 }
 
+/* Make the code examples in the API reference index the same height. */
+.api-interface-example pre {
+    min-height: 6.5rem;
+}
+
 /* Make inheritance images have a scroll bar if necessary. */
 div.graphviz {
     border: 1px solid lightgrey;
diff --git a/doc/api/index.rst b/doc/api/index.rst
index 1b098009faed..e55a0ed3c5b2 100644
--- a/doc/api/index.rst
+++ b/doc/api/index.rst
@@ -4,25 +4,23 @@ API Reference
 Matplotlib interfaces
 ---------------------
 
-Matplotlib provides two different interfaces:
-
-- **Axes interface**: create a `.Figure` and one or more `~.axes.Axes` objects
-  (typically using `.pyplot.subplots`), then *explicitly* use methods on these objects
-  to add data, configure limits, set labels etc.
-- **pyplot interface**: consists of functions in the `.pyplot` module. Figure and Axes
-  are manipulated through these functions and are only *implicitly* present in the
-  background.
-
-See :ref:`api_interfaces` for a more detailed description of both and their recommended
-use cases.
+Matplotlib has two interfaces. See :ref:`api_interfaces` for a more detailed
+description of both and their recommended use cases.
 
 .. grid:: 1 1 2 2
-    :padding: 0 0 1 1
+    :padding: 0
+    :gutter: 2
 
     .. grid-item-card::
+        :shadow: none
+        :class-footer: api-interface-footer
 
         **Axes interface** (object-based, explicit)
-        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+        create a `.Figure` and one or more `~.axes.Axes` objects, then *explicitly* use
+        methods on these objects to add data, configure limits, set labels etc.
+
+        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
         API:
 
@@ -30,15 +28,45 @@ use cases.
         - :mod:`~matplotlib.axes`: add data, limits, labels etc.
         - `.Figure`: for figure-level methods
 
+        +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+        Example:
+
+        .. code-block:: python
+           :class: api-interface-example
+
+           fig, ax = plt.subplots()
+           ax.plot(x, y)
+           ax.set_title("Sample plot")
+           plt.show()
+
+
     .. grid-item-card::
+        :shadow: none
+        :class-footer: api-interface-footer
 
         **pyplot interface** (function-based, implicit)
-        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+        consists of functions in the `.pyplot` module. Figure and Axes are manipulated
+        through these functions and are only *implicitly* present in the background.
+
+        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
         API:
 
         - `matplotlib.pyplot`
 
+        +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+        Example:
+
+        .. code-block:: python
+           :class: api-interface-example
+
+           plt.plot(x, y)
+           plt.title("Sample plot")
+           plt.show()
+
 
 .. _api-index:
 

From 2bf23975ba0c8287ca3ea507f3b2aa618c4b997e Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Fri, 1 Sep 2023 14:55:34 +0200
Subject: [PATCH 0104/1120] [DOC] Slightly improve the LineCollection docstring

---
 lib/matplotlib/collections.py | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/collections.py b/lib/matplotlib/collections.py
index 9db9a066fb65..81db24d0c026 100644
--- a/lib/matplotlib/collections.py
+++ b/lib/matplotlib/collections.py
@@ -1404,11 +1404,12 @@ def __init__(self, segments,  # Can be None.
         Parameters
         ----------
         segments : list of array-like
-            A sequence of (*line0*, *line1*, *line2*), where::
+            A sequence (*line0*, *line1*, *line2*) of lines, where each line is a list
+            of points::
 
-                linen = (x0, y0), (x1, y1), ... (xm, ym)
+                lineN = [(x0, y0), (x1, y1), ... (xm, ym)]
 
-            or the equivalent numpy array with two columns. Each line
+            or the equivalent Mx2 numpy array with two columns. Each line
             can have a different number of segments.
         linewidths : float or list of float, default: :rc:`lines.linewidth`
             The width of each line in points.

From 5fb45b8f3f3edf6dff9105c784022dc56b4dbab2 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Tue, 6 Jun 2023 22:39:43 -0400
Subject: [PATCH 0105/1120] TST: Move locale comma test to a subprocess

On some systems/pytest versions, the skip in an exception handler does
not skip, but is treated as an exception. Namely, the ARM test machine
in Cirrus and on my WSL Ubuntu.
---
 lib/matplotlib/tests/test_ticker.py | 40 +++++++++++++++++++----------
 1 file changed, 27 insertions(+), 13 deletions(-)

diff --git a/lib/matplotlib/tests/test_ticker.py b/lib/matplotlib/tests/test_ticker.py
index c95526ecf987..9d08e335dbdd 100644
--- a/lib/matplotlib/tests/test_ticker.py
+++ b/lib/matplotlib/tests/test_ticker.py
@@ -1640,22 +1640,36 @@ def test_latex(self, is_latex, usetex, expected):
             assert fmt.format_pct(50, 100) == expected
 
 
-def test_locale_comma():
-    currentLocale = locale.getlocale()
+def _impl_locale_comma():
     try:
         locale.setlocale(locale.LC_ALL, 'de_DE.UTF-8')
-        ticks = mticker.ScalarFormatter(useMathText=True, useLocale=True)
-        fmt = '$\\mathdefault{%1.1f}$'
-        x = ticks._format_maybe_minus_and_locale(fmt, 0.5)
-        assert x == '$\\mathdefault{0{,}5}$'
-        # Do not change , in the format string
-        fmt = ',$\\mathdefault{,%1.1f},$'
-        x = ticks._format_maybe_minus_and_locale(fmt, 0.5)
-        assert x == ',$\\mathdefault{,0{,}5},$'
     except locale.Error:
-        pytest.skip("Locale de_DE.UTF-8 is not supported on this machine")
-    finally:
-        locale.setlocale(locale.LC_ALL, currentLocale)
+        print('SKIP: Locale de_DE.UTF-8 is not supported on this machine')
+        return
+    ticks = mticker.ScalarFormatter(useMathText=True, useLocale=True)
+    fmt = '$\\mathdefault{%1.1f}$'
+    x = ticks._format_maybe_minus_and_locale(fmt, 0.5)
+    assert x == '$\\mathdefault{0{,}5}$'
+    # Do not change , in the format string
+    fmt = ',$\\mathdefault{,%1.1f},$'
+    x = ticks._format_maybe_minus_and_locale(fmt, 0.5)
+    assert x == ',$\\mathdefault{,0{,}5},$'
+
+
+def test_locale_comma():
+    # On some systems/pytest versions, `pytest.skip` in an exception handler
+    # does not skip, but is treated as an exception, so directly running this
+    # test can incorrectly fail instead of skip.
+    # Instead, run this test in a subprocess, which avoids the problem, and the
+    # need to fix the locale after.
+    proc = mpl.testing.subprocess_run_helper(_impl_locale_comma, timeout=60,
+                                             extra_env={'MPLBACKEND': 'Agg'})
+    skip_msg = next((line[len('SKIP:'):].strip()
+                     for line in proc.stdout.splitlines()
+                     if line.startswith('SKIP:')),
+                    '')
+    if skip_msg:
+        pytest.skip(skip_msg)
 
 
 def test_majformatter_type():

From 4bb4dc7d9d47fb483fcbc5a7e5ba7271153bdc36 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Mon, 31 Jul 2023 23:49:42 -0400
Subject: [PATCH 0106/1120] Use Agg backend in pickle test subprocess

The main parent process is using Agg, so the subprocess should as well,
to be able to unpickle correctly.
---
 lib/matplotlib/tests/test_pickle.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/tests/test_pickle.py b/lib/matplotlib/tests/test_pickle.py
index 8d1e20b4cb93..e222a495e437 100644
--- a/lib/matplotlib/tests/test_pickle.py
+++ b/lib/matplotlib/tests/test_pickle.py
@@ -143,7 +143,7 @@ def test_pickle_load_from_subprocess(fig_test, fig_ref, tmp_path):
     proc = subprocess_run_helper(
         _pickle_load_subprocess,
         timeout=60,
-        extra_env={'PICKLE_FILE_PATH': str(fp)}
+        extra_env={'PICKLE_FILE_PATH': str(fp), 'MPLBACKEND': 'Agg'}
     )
 
     loaded_fig = pickle.loads(ast.literal_eval(proc.stdout))

From 8530b1f2d6fd9fae1baf25b2c9d79471dd91f690 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 11 Aug 2023 19:12:09 -0400
Subject: [PATCH 0107/1120] TST: Mark macosx backend in leak test as xfail

---
 lib/matplotlib/tests/test_backends_interactive.py | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/lib/matplotlib/tests/test_backends_interactive.py b/lib/matplotlib/tests/test_backends_interactive.py
index dbc0f0928b74..e15e591b1b10 100644
--- a/lib/matplotlib/tests/test_backends_interactive.py
+++ b/lib/matplotlib/tests/test_backends_interactive.py
@@ -660,7 +660,7 @@ def _test_figure_leak():
                     reason="appveyor tests fail; gh-22988 suggests reworking")
 @pytest.mark.parametrize("env", _get_testable_interactive_backends())
 @pytest.mark.parametrize("time_mem", [(0.0, 2_000_000), (0.1, 30_000_000)])
-def test_figure_leak_20490(env, time_mem):
+def test_figure_leak_20490(env, time_mem, request):
     pytest.importorskip("psutil", reason="psutil needed to run this test")
 
     # We haven't yet directly identified the leaks so test with a memory growth
@@ -669,9 +669,10 @@ def test_figure_leak_20490(env, time_mem):
     if env["MPLBACKEND"] == "wx":
         pytest.skip("wx backend is deprecated; tests failed on appveyor")
 
-    if env["MPLBACKEND"] == "macosx" or (
-            env["MPLBACKEND"] == "tkagg" and sys.platform == 'darwin'
-    ):
+    if env["MPLBACKEND"] == "macosx":
+        request.node.add_marker(pytest.mark.xfail(reason="macosx backend is leaky"))
+
+    if env["MPLBACKEND"] == "tkagg" and sys.platform == "darwin":
         acceptable_memory_leakage += 11_000_000
 
     result = _run_helper(

From 02263d2654183df374e467eaad6066e66daf6873 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 11 Aug 2023 21:00:57 -0400
Subject: [PATCH 0108/1120] TST: Mark test_other_signal_before_sigint mac as
 xfail

---
 lib/matplotlib/tests/test_backends_interactive.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_backends_interactive.py b/lib/matplotlib/tests/test_backends_interactive.py
index e15e591b1b10..6048b2647b17 100644
--- a/lib/matplotlib/tests/test_backends_interactive.py
+++ b/lib/matplotlib/tests/test_backends_interactive.py
@@ -816,12 +816,12 @@ def custom_signal_handler(signum, frame):
     ('show', {'block': True}),
     ('pause', {'interval': 10})
 ])
-def test_other_signal_before_sigint(env, target, kwargs):
+def test_other_signal_before_sigint(env, target, kwargs, request):
     backend = env.get("MPLBACKEND")
     if not backend.startswith(("qt", "macosx")):
         pytest.skip("SIGINT currently only tested on qt and macosx")
-    if backend == "macosx" and target == "show":
-        pytest.xfail("test currently failing for macosx + show()")
+    if backend == "macosx":
+        request.node.add_marker(pytest.mark.xfail(reason="macosx backend is buggy"))
     proc = _WaitForStringPopen(
         [sys.executable, "-c",
          inspect.getsource(_test_other_signal_before_sigint_impl) +

From 3d116a7d58b8ba3cc1d8baf95198b07ff37fcd10 Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Sun, 3 Sep 2023 15:58:51 +0100
Subject: [PATCH 0109/1120] Update PR template doc links [skip ci]

---
 .github/PULL_REQUEST_TEMPLATE.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index fa84d5cac9f5..c91ba742fee3 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -5,9 +5,9 @@
 
 - [ ] "closes #0000" is in the body of the PR description to [link the related issue](https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue)
 - [ ] new and changed code is [tested](https://matplotlib.org/devdocs/devel/testing.html)
-- [ ] *Plotting related* features are demonstrated in an [example](https://matplotlib.org/devdocs/devel/documenting_mpl.html#writing-examples-and-tutorials)
+- [ ] *Plotting related* features are demonstrated in an [example](https://matplotlib.org/devdocs/devel/document.html#write-examples-and-tutorials)
 - [ ] *New Features* and *API Changes* are noted with a [directive and release note](https://matplotlib.org/devdocs/devel/coding_guide.html#new-features-and-api-changes)
-- [ ] Documentation complies with [general](https://matplotlib.org/devdocs/devel/documenting_mpl.html#writing-rest-pages) and [docstring](https://matplotlib.org/devdocs/devel/documenting_mpl.html#writing-docstrings) guidelines
+- [ ] Documentation complies with [general](https://matplotlib.org/devdocs/devel/document.html#write-rest-pages) and [docstring](https://matplotlib.org/devdocs/devel/document.html#write-docstrings) guidelines
 
 <!--
 Thank you so much for your PR!  To help us review your contribution, please

From b1e9eb72574547c3ad627285c095c186155f255d Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Sun, 3 Sep 2023 12:12:08 -0400
Subject: [PATCH 0110/1120] Condense long PR comment, break up and put into
 related sections.

---
 .github/PULL_REQUEST_TEMPLATE.md | 41 +++++++++++---------------------
 1 file changed, 14 insertions(+), 27 deletions(-)

diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index fa84d5cac9f5..487ca7482767 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -1,5 +1,16 @@
-## PR summary
+<!--
+Thank you so much for your PR!  To help us review your contribution, please check
+out the development guide https://matplotlib.org/devdocs/devel/index.html
+-->
 
+## PR summary
+<!-- Please provide at least 1-2 sentences describing the pull request in detail
+(Why is this change required?  What problem does it solve?) and link to relevant
+issues and PRs.
+Also please summarize the changes in the title, for example "Raise ValueError on
+non-numeric input to set_xlim" and avoid non-descriptive titles such as "Addresses
+issue #8576".
+-->
 ## PR checklist
 <!-- Please mark any checkboxes that do not apply to this PR as [N/A].-->
 
@@ -9,32 +20,8 @@
 - [ ] *New Features* and *API Changes* are noted with a [directive and release note](https://matplotlib.org/devdocs/devel/coding_guide.html#new-features-and-api-changes)
 - [ ] Documentation complies with [general](https://matplotlib.org/devdocs/devel/documenting_mpl.html#writing-rest-pages) and [docstring](https://matplotlib.org/devdocs/devel/documenting_mpl.html#writing-docstrings) guidelines
 
-<!--
-Thank you so much for your PR!  To help us review your contribution, please
-consider the following points:
-
-- A development guide is available at https://matplotlib.org/devdocs/devel/index.html.
-
-- Help with git and github is available at https://matplotlib.org/devdocs/devel/development_workflow.html
-
-- Create a separate branch for your changes and open the PR from this branch. Please avoid working on `main`.
-
-- The PR title should summarize the changes, for example "Raise ValueError on
-  non-numeric input to set_xlim".  Avoid non-descriptive titles such as
-  "Addresses issue #8576".
-
-- The summary should provide at least 1-2 sentences describing the pull request
-  in detail (Why is this change required?  What problem does it solve?) and
-  link to any relevant issues.
-
-- If you are contributing fixes to docstrings, please pay attention to
-  https://matplotlib.org/stable/devel/documenting_mpl.html#formatting-conventions.  In particular,
-  note the difference between using single backquotes, double backquotes, and
-  asterisks in the markup.
-
-We understand that PRs can sometimes be overwhelming, especially as the
+<!--We understand that PRs can sometimes be overwhelming, especially as the
 reviews start coming in.  Please let us know if the reviews are unclear or
 the recommended next step seems overly demanding, if you would like help in
 addressing a reviewer's comments, or if you have been waiting too long to hear
-back on your PR.
--->
+back on your PR.-->

From 9398d8a6b2470455a5c623699f05d8766b9f5802 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Sun, 3 Sep 2023 15:00:34 -0400
Subject: [PATCH 0111/1120] Added sanitize_sequence to kwargs in
 _preprocess_data (#26670)

Added a simple test for using errorbar with mapview kwarg
Changed errorbar kwarg test to be more explicit

Co-authored-by: jovianw <kvothejohn@gmail.com>
---
 lib/matplotlib/__init__.py        | 5 ++++-
 lib/matplotlib/tests/test_axes.py | 6 ++++++
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/__init__.py b/lib/matplotlib/__init__.py
index 1e3dab1b336b..d0212cfe0276 100644
--- a/lib/matplotlib/__init__.py
+++ b/lib/matplotlib/__init__.py
@@ -1462,7 +1462,10 @@ def func(foo, label=None): ...
     @functools.wraps(func)
     def inner(ax, *args, data=None, **kwargs):
         if data is None:
-            return func(ax, *map(sanitize_sequence, args), **kwargs)
+            return func(
+                ax,
+                *map(sanitize_sequence, args),
+                **{k: sanitize_sequence(v) for k, v in kwargs.items()})
 
         bound = new_sig.bind(ax, *args, **kwargs)
         auto_label = (bound.arguments.get(label_namer)
diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index e6251948ebee..3b5f9019ead2 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -835,6 +835,12 @@ def test_errorbar_dashes(fig_test, fig_ref):
     ax_test.errorbar(x, y, xerr=np.abs(y), yerr=np.abs(y), dashes=[2, 2])
 
 
+def test_errorbar_mapview_kwarg():
+    D = {ii: ii for ii in range(10)}
+    fig, ax = plt.subplots()
+    ax.errorbar(x=D.keys(), y=D.values(), xerr=D.values())
+
+
 @image_comparison(['single_point', 'single_point'])
 def test_single_point():
     # Issue #1796: don't let lines.marker affect the grid

From 7ebce14d93327dc8d10879c7bbdf091267cf60b5 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Mon, 4 Sep 2023 09:23:11 +0200
Subject: [PATCH 0112/1120] Make generated pgf code more robust against later
 changes of tex engine.

By moving the conditionals to tex itself, the generated tex code becomes
compilable with engines different from the one originally configured;
this is similar to the `\ifdefined\pdfpagewidth` test in
PdfPages.savefig.
---
 lib/matplotlib/backends/backend_pgf.py | 38 +++++++++++++-------------
 1 file changed, 19 insertions(+), 19 deletions(-)

diff --git a/lib/matplotlib/backends/backend_pgf.py b/lib/matplotlib/backends/backend_pgf.py
index 734c188b0048..7d60249d2477 100644
--- a/lib/matplotlib/backends/backend_pgf.py
+++ b/lib/matplotlib/backends/backend_pgf.py
@@ -34,7 +34,7 @@
 
 def _get_preamble():
     """Prepare a LaTeX preamble based on the rcParams configuration."""
-    preamble = [
+    return "\n".join([
         # Remove Matplotlib's custom command \mathdefault.  (Not using
         # \mathnormal instead since this looks odd with Computer Modern.)
         r"\def\mathdefault#1{#1}",
@@ -42,21 +42,21 @@ def _get_preamble():
         r"\everymath=\expandafter{\the\everymath\displaystyle}",
         # Allow pgf.preamble to override the above definitions.
         mpl.rcParams["pgf.preamble"],
-    ]
-    if mpl.rcParams["pgf.texsystem"] != "pdflatex":
-        preamble.append("\\usepackage{fontspec}")
-        if mpl.rcParams["pgf.rcfonts"]:
-            families = ["serif", "sans\\-serif", "monospace"]
-            commands = ["setmainfont", "setsansfont", "setmonofont"]
-            for family, command in zip(families, commands):
-                # 1) Forward slashes also work on Windows, so don't mess with
-                # backslashes.  2) The dirname needs to include a separator.
-                path = pathlib.Path(fm.findfont(family))
-                preamble.append(r"\%s{%s}[Path=\detokenize{%s/}]" % (
-                    command, path.name, path.parent.as_posix()))
-    preamble.append(mpl.texmanager._usepackage_if_not_loaded(
-        "underscore", option="strings"))  # Documented as "must come last".
-    return "\n".join(preamble)
+        r"\ifdefined\pdftexversion\else  % non-pdftex case.",
+        r"  \usepackage{fontspec}",
+        *([
+            r"  \%s{%s}[Path=\detokenize{%s/}]"
+            % (command, path.name, path.parent.as_posix())
+            for command, path in zip(
+                ["setmainfont", "setsansfont", "setmonofont"],
+                [pathlib.Path(fm.findfont(family))
+                 for family in ["serif", "sans\\-serif", "monospace"]]
+            )
+        ] if mpl.rcParams["pgf.rcfonts"] else []),
+        r"\fi",
+        # Documented as "must come last".
+        mpl.texmanager._usepackage_if_not_loaded("underscore", option="strings"),
+    ])
 
 
 # It's better to use only one unit for all coordinates, since the
@@ -94,9 +94,9 @@ def _escape_and_apply_props(s, prop):
     family = prop.get_family()[0]
     if family in families:
         commands.append(families[family])
-    elif (any(font.name == family for font in fm.fontManager.ttflist)
-          and mpl.rcParams["pgf.texsystem"] != "pdflatex"):
-        commands.append(r"\setmainfont{%s}\rmfamily" % family)
+    elif any(font.name == family for font in fm.fontManager.ttflist):
+        commands.append(
+            r"\ifdefined\pdftexversion\else\setmainfont{%s}\rmfamily\fi" % family)
     else:
         _log.warning("Ignoring unknown font: %s", family)
 

From 4ceb02f6fcab7c0ad4f366333eca634aa6c49bce Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Mon, 4 Sep 2023 07:57:44 +0200
Subject: [PATCH 0113/1120] Fix error generation for missing pgf.texsystem.

If pgf.texsystem isn't installed, then self.latex will not be created
*at all* by _setup_latex_process, and we thus cannot access
self.latex.args[0], but must instead read the rc value again.  To make
this clearer, move the error handling into _setup_latex_process, instead
of having it outside.

No test because that'd require setting up a test env where pgf.texsystem
is explicitly *missing* (or go through lots of mocks), which seems not
worth it.
---
 lib/matplotlib/backends/backend_pgf.py | 29 +++++++++++++-------------
 1 file changed, 14 insertions(+), 15 deletions(-)

diff --git a/lib/matplotlib/backends/backend_pgf.py b/lib/matplotlib/backends/backend_pgf.py
index 734c188b0048..ccf4b800a614 100644
--- a/lib/matplotlib/backends/backend_pgf.py
+++ b/lib/matplotlib/backends/backend_pgf.py
@@ -241,16 +241,7 @@ def __init__(self):
         self._finalize_tmpdir = weakref.finalize(self, self._tmpdir.cleanup)
 
         # test the LaTeX setup to ensure a clean startup of the subprocess
-        try:
-            self._setup_latex_process(expect_reply=False)
-        except FileNotFoundError as err:
-            raise RuntimeError(
-                f"{self.latex.args[0]!r} not found.  Install it or change "
-                f"rcParams['pgf.texsystem'] to an available TeX "
-                f"implementation.") from err
-        except OSError as err:
-            raise RuntimeError(
-                f"Error starting process {self.latex.args[0]!r}") from err
+        self._setup_latex_process(expect_reply=False)
         stdout, stderr = self.latex.communicate("\n\\makeatletter\\@@end\n")
         if self.latex.returncode != 0:
             raise LatexError(
@@ -258,7 +249,6 @@ def __init__(self):
                 f"while processing the following input:\n"
                 f"{self._build_latex_header()}",
                 stdout)
-
         self.latex = None  # Will be set up on first use.
         # Per-instance cache.
         self._get_box_metrics = functools.lru_cache(self._get_box_metrics)
@@ -268,10 +258,19 @@ def _setup_latex_process(self, *, expect_reply=True):
         # Windows, we must ensure that the subprocess has quit before being
         # able to delete the tmpdir in which it runs; in order to do so, we
         # must first `kill()` it, and then `communicate()` with it.
-        self.latex = subprocess.Popen(
-            [mpl.rcParams["pgf.texsystem"], "-halt-on-error"],
-            stdin=subprocess.PIPE, stdout=subprocess.PIPE,
-            encoding="utf-8", cwd=self.tmpdir)
+        try:
+            self.latex = subprocess.Popen(
+                [mpl.rcParams["pgf.texsystem"], "-halt-on-error"],
+                stdin=subprocess.PIPE, stdout=subprocess.PIPE,
+                encoding="utf-8", cwd=self.tmpdir)
+        except FileNotFoundError as err:
+            raise RuntimeError(
+                f"{mpl.rcParams['pgf.texsystem']!r} not found; install it or change "
+                f"rcParams['pgf.texsystem'] to an available TeX implementation"
+            ) from err
+        except OSError as err:
+            raise RuntimeError(
+                f"Error starting {mpl.rcParams['pgf.texsystem']!r}") from err
 
         def finalize_latex(latex):
             latex.kill()

From c20554d1cb96ac254560e8db1e1df5b19de799a0 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 4 Sep 2023 19:33:56 +0000
Subject: [PATCH 0114/1120] Bump actions/checkout from 3 to 4

Bumps [actions/checkout](https://github.com/actions/checkout) from 3 to 4.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v3...v4)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 .github/workflows/cibuildwheel.yml    | 2 +-
 .github/workflows/circleci.yml        | 2 +-
 .github/workflows/clean_pr.yml        | 2 +-
 .github/workflows/codeql-analysis.yml | 2 +-
 .github/workflows/cygwin.yml          | 2 +-
 .github/workflows/mypy-stubtest.yml   | 2 +-
 .github/workflows/reviewdog.yml       | 6 +++---
 .github/workflows/tests.yml           | 2 +-
 8 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 8c45ef95990b..54b68c6bc56b 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -39,7 +39,7 @@ jobs:
       SDIST_NAME: ${{ steps.sdist.outputs.SDIST_NAME }}
 
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           fetch-depth: 0
 
diff --git a/.github/workflows/circleci.yml b/.github/workflows/circleci.yml
index ab8362bed0da..8f9e3190c5e2 100644
--- a/.github/workflows/circleci.yml
+++ b/.github/workflows/circleci.yml
@@ -27,7 +27,7 @@ jobs:
     runs-on: ubuntu-latest
     name: Post warnings/errors as review
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
 
       - name: Fetch result artifacts
         id: fetch-artifacts
diff --git a/.github/workflows/clean_pr.yml b/.github/workflows/clean_pr.yml
index e1fc4c1530ff..f3ccb3195d77 100644
--- a/.github/workflows/clean_pr.yml
+++ b/.github/workflows/clean_pr.yml
@@ -10,7 +10,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           fetch-depth: '0'
       - name: Check for added-and-deleted files
diff --git a/.github/workflows/codeql-analysis.yml b/.github/workflows/codeql-analysis.yml
index c10336410178..d31973e954d5 100644
--- a/.github/workflows/codeql-analysis.yml
+++ b/.github/workflows/codeql-analysis.yml
@@ -26,7 +26,7 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Set up Python
         uses: actions/setup-python@v4
diff --git a/.github/workflows/cygwin.yml b/.github/workflows/cygwin.yml
index b4b30b57dab1..11ea1377b36d 100644
--- a/.github/workflows/cygwin.yml
+++ b/.github/workflows/cygwin.yml
@@ -78,7 +78,7 @@ jobs:
       - name: Fix line endings
         run: git config --global core.autocrlf input
 
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           fetch-depth: 0
 
diff --git a/.github/workflows/mypy-stubtest.yml b/.github/workflows/mypy-stubtest.yml
index f8897d0697fe..6da6f607642c 100644
--- a/.github/workflows/mypy-stubtest.yml
+++ b/.github/workflows/mypy-stubtest.yml
@@ -11,7 +11,7 @@ jobs:
     name: mypy-stubtest
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
 
       - name: Set up Python 3
         uses: actions/setup-python@v4
diff --git a/.github/workflows/reviewdog.yml b/.github/workflows/reviewdog.yml
index f1d57141602d..dafc331a11eb 100644
--- a/.github/workflows/reviewdog.yml
+++ b/.github/workflows/reviewdog.yml
@@ -12,7 +12,7 @@ jobs:
     name: flake8
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
 
       - name: Set up Python 3
         uses: actions/setup-python@v4
@@ -42,7 +42,7 @@ jobs:
     name: mypy
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
 
       - name: Set up Python 3
         uses: actions/setup-python@v4
@@ -77,7 +77,7 @@ jobs:
     name: eslint
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
 
       - name: eslint
         uses: reviewdog/action-eslint@v1
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index b48c47907d09..adff7f1ce292 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -88,7 +88,7 @@ jobs:
             pyside6-ver: '!=6.5.1'
 
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           fetch-depth: 0
 

From e908ac1344fd90f72fe7a43962db61bec170abfc Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Tue, 5 Sep 2023 12:11:20 -0500
Subject: [PATCH 0115/1120] Add changed callback after setting norm values

---
 lib/matplotlib/contour.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/contour.py b/lib/matplotlib/contour.py
index aa3041ddce9b..7de45b54de38 100644
--- a/lib/matplotlib/contour.py
+++ b/lib/matplotlib/contour.py
@@ -892,7 +892,8 @@ def __init__(self, ax, *args,
                 self.norm.vmin = vmin
             if vmax is not None:
                 self.norm.vmax = vmax
-            self._process_colors()
+        self.norm._changed()
+        self._process_colors()
 
         if self._paths is None:
             self._paths = self._make_paths_from_contour_generator()

From e5a554aecbb1d5b5690f5376fda6c260e84e8f77 Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Tue, 5 Sep 2023 19:53:54 +0200
Subject: [PATCH 0116/1120] Improve naming of cibuildwheel jobs

---
 .github/workflows/cibuildwheel.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 8c45ef95990b..366dece1a23e 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -87,7 +87,7 @@ jobs:
                  'CI: Run cibuildwheel')
       )
     needs: build_sdist
-    name: Build wheels on ${{ matrix.os }}
+    name: Build wheels on ${{ matrix.os }} for ${{ matrix.cibw_archs }}
     runs-on: ${{ matrix.os }}
     env:
       CIBW_BEFORE_BUILD: >-

From 414d3825dac72bb5e870d592d75eed1edd44866a Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Tue, 5 Sep 2023 20:38:35 +0200
Subject: [PATCH 0117/1120] Check type for set_clip_box

---
 lib/matplotlib/artist.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/artist.py b/lib/matplotlib/artist.py
index 5c3f6dc5952f..04eaa6cf75df 100644
--- a/lib/matplotlib/artist.py
+++ b/lib/matplotlib/artist.py
@@ -15,7 +15,7 @@
 from .colors import BoundaryNorm
 from .cm import ScalarMappable
 from .path import Path
-from .transforms import (Bbox, IdentityTransform, Transform, TransformedBbox,
+from .transforms import (BboxBase, Bbox, IdentityTransform, Transform, TransformedBbox,
                          TransformedPatchPath, TransformedPath)
 
 _log = logging.getLogger(__name__)
@@ -763,6 +763,7 @@ def set_clip_box(self, clipbox):
             clipping for an artist added to an Axes.
 
         """
+        _api.check_isinstance((BboxBase, None), clipbox=clipbox)
         if clipbox != self.clipbox:
             self.clipbox = clipbox
             self.pchanged()

From 58d5aad7ba8bec31cf1ff5dc4a758fabc9b7fe16 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 10 Aug 2023 03:52:43 -0400
Subject: [PATCH 0118/1120] TYP: Add common type overloads of subplot_mosaic

I'll assert, without proof, that passing a single string, a mosaic list
of strings, or a mosaic list all of the same type is more common than
passing arbitrary unrelated hashables. Thus it is somewhat convenient if
the return type stipulates that the resulting dictionary is also keyed
with strings or the common type.

This also fixes the type of the `per_subplot_kw` argument, which also
allows dictionary keys of tuples of the entries.
---
 doc/missing-references.json |  6 ++++
 lib/matplotlib/figure.py    |  8 ++---
 lib/matplotlib/figure.pyi   | 52 +++++++++++++++++++++-------
 lib/matplotlib/pyplot.py    | 68 +++++++++++++++++++++++++++++++++----
 lib/matplotlib/typing.py    |  5 +--
 5 files changed, 112 insertions(+), 27 deletions(-)

diff --git a/doc/missing-references.json b/doc/missing-references.json
index 1061b08b7fe6..364885ab3a74 100644
--- a/doc/missing-references.json
+++ b/doc/missing-references.json
@@ -152,6 +152,9 @@
     "HashableList": [
       "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.subplot_mosaic:1"
     ],
+    "HashableList[_HT]": [
+      "doc/docstring of builtins.list:17"
+    ],
     "LineStyleType": [
       "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.eventplot:1",
       "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.hlines:1",
@@ -701,6 +704,9 @@
     "matplotlib.animation.TimedAnimation.to_jshtml": [
       "doc/api/_as_gen/matplotlib.animation.TimedAnimation.rst:28:<autosummary>:1"
     ],
+    "matplotlib.typing._HT": [
+      "doc/docstring of builtins.list:17"
+    ],
     "mpl_toolkits.axislines.Axes": [
       "lib/mpl_toolkits/axisartist/axis_artist.py:docstring of mpl_toolkits.axisartist.axis_artist:7"
     ],
diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
index 9d929acf688c..d37dda204278 100644
--- a/lib/matplotlib/figure.py
+++ b/lib/matplotlib/figure.py
@@ -1749,15 +1749,11 @@ def _norm_per_subplot_kw(per_subplot_kw):
             if isinstance(k, tuple):
                 for sub_key in k:
                     if sub_key in expanded:
-                        raise ValueError(
-                            f'The key {sub_key!r} appears multiple times.'
-                            )
+                        raise ValueError(f'The key {sub_key!r} appears multiple times.')
                     expanded[sub_key] = v
             else:
                 if k in expanded:
-                    raise ValueError(
-                        f'The key {k!r} appears multiple times.'
-                    )
+                    raise ValueError(f'The key {k!r} appears multiple times.')
                 expanded[k] = v
         return expanded
 
diff --git a/lib/matplotlib/figure.pyi b/lib/matplotlib/figure.pyi
index f53feb78014d..687ae9e500d0 100644
--- a/lib/matplotlib/figure.pyi
+++ b/lib/matplotlib/figure.pyi
@@ -1,4 +1,9 @@
+from collections.abc import Callable, Hashable, Iterable
 import os
+from typing import Any, IO, Literal, TypeVar, overload
+
+import numpy as np
+from numpy.typing import ArrayLike
 
 from matplotlib.artist import Artist
 from matplotlib.axes import Axes, SubplotBase
@@ -19,14 +24,10 @@ from matplotlib.lines import Line2D
 from matplotlib.patches import Rectangle, Patch
 from matplotlib.text import Text
 from matplotlib.transforms import Affine2D, Bbox, BboxBase, Transform
-
-import numpy as np
-from numpy.typing import ArrayLike
-
-from collections.abc import Callable, Iterable
-from typing import Any, IO, Literal, overload
 from .typing import ColorType, HashableList
 
+_T = TypeVar("_T")
+
 class FigureBase(Artist):
     artists: list[Artist]
     lines: list[Line2D]
@@ -200,11 +201,38 @@ class FigureBase(Artist):
         *,
         bbox_extra_artists: Iterable[Artist] | None = ...,
     ) -> Bbox: ...
-
-    # Any in list of list is recursive list[list[Hashable | list[Hashable | ...]]] but that can't really be type checked
+    @overload
     def subplot_mosaic(
         self,
-        mosaic: str | HashableList,
+        mosaic: str,
+        *,
+        sharex: bool = ...,
+        sharey: bool = ...,
+        width_ratios: ArrayLike | None = ...,
+        height_ratios: ArrayLike | None = ...,
+        empty_sentinel: str = ...,
+        subplot_kw: dict[str, Any] | None = ...,
+        per_subplot_kw: dict[str | tuple[str, ...], dict[str, Any]] | None = ...,
+        gridspec_kw: dict[str, Any] | None = ...,
+    ) -> dict[str, Axes]: ...
+    @overload
+    def subplot_mosaic(
+        self,
+        mosaic: list[HashableList[_T]],
+        *,
+        sharex: bool = ...,
+        sharey: bool = ...,
+        width_ratios: ArrayLike | None = ...,
+        height_ratios: ArrayLike | None = ...,
+        empty_sentinel: _T = ...,
+        subplot_kw: dict[str, Any] | None = ...,
+        per_subplot_kw: dict[_T | tuple[_T, ...], dict[str, Any]] | None = ...,
+        gridspec_kw: dict[str, Any] | None = ...,
+    ) -> dict[_T, Axes]: ...
+    @overload
+    def subplot_mosaic(
+        self,
+        mosaic: list[HashableList[Hashable]],
         *,
         sharex: bool = ...,
         sharey: bool = ...,
@@ -212,9 +240,9 @@ class FigureBase(Artist):
         height_ratios: ArrayLike | None = ...,
         empty_sentinel: Any = ...,
         subplot_kw: dict[str, Any] | None = ...,
-        per_subplot_kw: dict[Any, dict[str, Any]] | None = ...,
-        gridspec_kw: dict[str, Any] | None = ...
-    ) -> dict[Any, Axes]: ...
+        per_subplot_kw: dict[Hashable | tuple[Hashable, ...], dict[str, Any]] | None = ...,
+        gridspec_kw: dict[str, Any] | None = ...,
+    ) -> dict[Hashable, Axes]: ...
 
 class SubFigure(FigureBase):
     figure: Figure
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index cc18b6b21bf0..00e5dea071a4 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -125,6 +125,7 @@
 
     _P = ParamSpec('_P')
     _R = TypeVar('_R')
+    _T = TypeVar('_T')
 
 
 # We may not need the following imports here:
@@ -1602,8 +1603,56 @@ def subplots(
     return fig, axs
 
 
+@overload
+def subplot_mosaic(
+    mosaic: str,
+    *,
+    sharex: bool = ...,
+    sharey: bool = ...,
+    width_ratios: ArrayLike | None = ...,
+    height_ratios: ArrayLike | None = ...,
+    empty_sentinel: str = ...,
+    subplot_kw: dict[str, Any] | None = ...,
+    gridspec_kw: dict[str, Any] | None = ...,
+    per_subplot_kw: dict[str | tuple[str, ...], dict[str, Any]] | None = ...,
+    **fig_kw: Any
+) -> tuple[Figure, dict[str, matplotlib.axes.Axes]]: ...
+
+
+@overload
+def subplot_mosaic(
+    mosaic: list[HashableList[_T]],
+    *,
+    sharex: bool = ...,
+    sharey: bool = ...,
+    width_ratios: ArrayLike | None = ...,
+    height_ratios: ArrayLike | None = ...,
+    empty_sentinel: _T = ...,
+    subplot_kw: dict[str, Any] | None = ...,
+    gridspec_kw: dict[str, Any] | None = ...,
+    per_subplot_kw: dict[_T | tuple[_T, ...], dict[str, Any]] | None = ...,
+    **fig_kw: Any
+) -> tuple[Figure, dict[_T, matplotlib.axes.Axes]]: ...
+
+
+@overload
+def subplot_mosaic(
+    mosaic: list[HashableList[Hashable]],
+    *,
+    sharex: bool = ...,
+    sharey: bool = ...,
+    width_ratios: ArrayLike | None = ...,
+    height_ratios: ArrayLike | None = ...,
+    empty_sentinel: Any = ...,
+    subplot_kw: dict[str, Any] | None = ...,
+    gridspec_kw: dict[str, Any] | None = ...,
+    per_subplot_kw: dict[Hashable | tuple[Hashable, ...], dict[str, Any]] | None = ...,
+    **fig_kw: Any
+) -> tuple[Figure, dict[Hashable, matplotlib.axes.Axes]]: ...
+
+
 def subplot_mosaic(
-    mosaic: str | HashableList,
+    mosaic: str | list[HashableList[_T]] | list[HashableList[Hashable]],
     *,
     sharex: bool = False,
     sharey: bool = False,
@@ -1612,9 +1661,13 @@ def subplot_mosaic(
     empty_sentinel: Any = '.',
     subplot_kw: dict[str, Any] | None = None,
     gridspec_kw: dict[str, Any] | None = None,
-    per_subplot_kw: dict[Hashable, dict[str, Any]] | None = None,
-    **fig_kw
-) -> tuple[Figure, dict[Hashable, matplotlib.axes.Axes]]:
+    per_subplot_kw: dict[str | tuple[str, ...], dict[str, Any]] |
+                    dict[_T | tuple[_T, ...], dict[str, Any]] |
+                    dict[Hashable | tuple[Hashable, ...], dict[str, Any]] | None = None,
+    **fig_kw: Any
+) -> tuple[Figure, dict[str, matplotlib.axes.Axes]] | \
+     tuple[Figure, dict[_T, matplotlib.axes.Axes]] | \
+     tuple[Figure, dict[Hashable, matplotlib.axes.Axes]]:
     """
     Build a layout of Axes based on ASCII art or nested lists.
 
@@ -1716,12 +1769,13 @@ def subplot_mosaic(
 
     """
     fig = figure(**fig_kw)
-    ax_dict = fig.subplot_mosaic(
-        mosaic, sharex=sharex, sharey=sharey,
+    ax_dict = fig.subplot_mosaic(  # type: ignore[misc]
+        mosaic,  # type: ignore[arg-type]
+        sharex=sharex, sharey=sharey,
         height_ratios=height_ratios, width_ratios=width_ratios,
         subplot_kw=subplot_kw, gridspec_kw=gridspec_kw,
         empty_sentinel=empty_sentinel,
-        per_subplot_kw=per_subplot_kw,
+        per_subplot_kw=per_subplot_kw,  # type: ignore[arg-type]
     )
     return fig, ax_dict
 
diff --git a/lib/matplotlib/typing.py b/lib/matplotlib/typing.py
index e6b9ada7d8a2..02059be94ba2 100644
--- a/lib/matplotlib/typing.py
+++ b/lib/matplotlib/typing.py
@@ -11,7 +11,7 @@
 """
 from collections.abc import Hashable, Sequence
 import pathlib
-from typing import Any, Literal, Union
+from typing import Any, Literal, TypeVar, Union
 
 from . import path
 from ._enums import JoinStyle, CapStyle
@@ -55,5 +55,6 @@
     Sequence[Union[str, pathlib.Path, dict[str, Any]]],
 ]
 
-HashableList = list[Union[Hashable, "HashableList"]]
+_HT = TypeVar("_HT", bound=Hashable)
+HashableList = list[Union[_HT, "HashableList[_HT]"]]
 """A nested list of Hashable values."""

From dc3c81a92b7a7744e2a022e8e6d5a28aa0de854d Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Wed, 6 Sep 2023 15:55:55 -0500
Subject: [PATCH 0119/1120] DOC: consistency in docstrings of formatting of
 array-like

---
 lib/matplotlib/axis.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/axis.py b/lib/matplotlib/axis.py
index 56d4e6b77dc6..9adfb2cde7d3 100644
--- a/lib/matplotlib/axis.py
+++ b/lib/matplotlib/axis.py
@@ -2097,7 +2097,7 @@ def set_ticks(self, ticks, labels=None, *, minor=False, **kwargs):
 
         Parameters
         ----------
-        ticks : 1D ArrayLike
+        ticks : 1D array-like
             Array of tick locations.  The axis `.Locator` is replaced by a
             `~.ticker.FixedLocator`.
 

From b62bfb0e27d2bf586cf0adb4958a3307a8330cee Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Wed, 6 Sep 2023 02:54:47 -0400
Subject: [PATCH 0120/1120] converted coc to rst and added md forward rule

---
 CODE_OF_CONDUCT.md                    | 139 +-----------------------
 doc/users/project/code_of_conduct.rst | 147 ++++++++++++++++++++++++++
 doc/users/project/index.rst           |   1 +
 3 files changed, 152 insertions(+), 135 deletions(-)
 create mode 100644 doc/users/project/code_of_conduct.rst

diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
index 1e35beeaf357..d43f37214254 100644
--- a/CODE_OF_CONDUCT.md
+++ b/CODE_OF_CONDUCT.md
@@ -1,136 +1,5 @@
 
-# Contributor Covenant Code of Conduct
-
-## Our Pledge
-
-We as members, contributors, and leaders pledge to make participation in our
-community a harassment-free experience for everyone, regardless of age, body
-size, visible or invisible disability, ethnicity, sex characteristics, gender
-identity and expression, level of experience, education, socio-economic status,
-nationality, personal appearance, race, religion, or sexual identity
-and orientation.
-
-We pledge to act and interact in ways that contribute to an open, welcoming,
-diverse, inclusive, and healthy community.
-
-## Our Standards
-
-Examples of behavior that contributes to a positive environment for our
-community include:
-
-* Demonstrating empathy and kindness toward other people
-* Being respectful of differing opinions, viewpoints, and experiences
-* Giving and gracefully accepting constructive feedback
-* Accepting responsibility and apologizing to those affected by our mistakes,
-  and learning from the experience
-* Focusing on what is best not just for us as individuals, but for the
-  overall community
-
-Examples of unacceptable behavior include:
-
-* The use of sexualized language or imagery, and sexual attention or
-  advances of any kind
-* Trolling, insulting or derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or email
-  address, without their explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
-  professional setting
-
-## Enforcement Responsibilities
-
-Community leaders are responsible for clarifying and enforcing our standards of
-acceptable behavior and will take appropriate and fair corrective action in
-response to any behavior that they deem inappropriate, threatening, offensive,
-or harmful.
-
-Community leaders have the right and responsibility to remove, edit, or reject
-comments, commits, code, wiki edits, issues, and other contributions that are
-not aligned to this Code of Conduct, and will communicate reasons for moderation
-decisions when appropriate.
-
-## Scope
-
-This Code of Conduct applies within all community spaces, and also applies when
-an individual is officially representing the community in public spaces.
-Examples of representing our community include using an official e-mail address,
-posting via an official social media account, or acting as an appointed
-representative at an online or offline event.
-
-## Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported to the community leaders responsible for enforcement at
-[matplotlib-coc@numfocus.org](mailto:matplotlib-coc@numfocus.org)
-(monitored by the [CoC subcommittee](https://matplotlib.org/governance/people.html#coc-subcommittee)) or a
-report can be made using the [NumFOCUS Code of Conduct report form][numfocus
-form].  If community leaders cannot come to a resolution about enforcement,
-reports will be escalated to the NumFocus Code of Conduct committee
-(conduct@numfocus.org).  All complaints will be reviewed and investigated
-promptly and fairly.
-
-All community leaders are obligated to respect the privacy and security of the
-reporter of any incident.
-
-[numfocus form]: https://numfocus.typeform.com/to/ynjGdT
-
-## Enforcement Guidelines
-
-Community leaders will follow these Community Impact Guidelines in determining
-the consequences for any action they deem in violation of this Code of Conduct:
-
-### 1. Correction
-
-**Community Impact**: Use of inappropriate language or other behavior deemed
-unprofessional or unwelcome in the community.
-
-**Consequence**: A private, written warning from community leaders, providing
-clarity around the nature of the violation and an explanation of why the
-behavior was inappropriate. A public apology may be requested.
-
-### 2. Warning
-
-**Community Impact**: A violation through a single incident or series
-of actions.
-
-**Consequence**: A warning with consequences for continued behavior. No
-interaction with the people involved, including unsolicited interaction with
-those enforcing the Code of Conduct, for a specified period of time. This
-includes avoiding interactions in community spaces as well as external channels
-like social media. Violating these terms may lead to a temporary or
-permanent ban.
-
-### 3. Temporary Ban
-
-**Community Impact**: A serious violation of community standards, including
-sustained inappropriate behavior.
-
-**Consequence**: A temporary ban from any sort of interaction or public
-communication with the community for a specified period of time. No public or
-private interaction with the people involved, including unsolicited interaction
-with those enforcing the Code of Conduct, is allowed during this period.
-Violating these terms may lead to a permanent ban.
-
-### 4. Permanent Ban
-
-**Community Impact**: Demonstrating a pattern of violation of community
-standards, including sustained inappropriate behavior,  harassment of an
-individual, or aggression toward or disparagement of classes of individuals.
-
-**Consequence**: A permanent ban from any sort of public interaction within
-the community.
-
-## Attribution
-
-This Code of Conduct is adapted from the [Contributor Covenant][homepage],
-version 2.0, available at
-https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
-
-Community Impact Guidelines were inspired by [Mozilla's code of conduct
-enforcement ladder](https://github.com/mozilla/diversity).
-
-[homepage]: https://www.contributor-covenant.org
-
-For answers to common questions about this code of conduct, see the FAQ at
-https://www.contributor-covenant.org/faq. Translations are available at
-https://www.contributor-covenant.org/translations.
+---
+layout: forward
+target: https://matplotlib.org/stable/users/project/code_of_conduct.html
+---
diff --git a/doc/users/project/code_of_conduct.rst b/doc/users/project/code_of_conduct.rst
new file mode 100644
index 000000000000..8deda909bd4c
--- /dev/null
+++ b/doc/users/project/code_of_conduct.rst
@@ -0,0 +1,147 @@
+.. code_of_conduct
+
+====================================
+Contributor Covenant Code of Conduct
+====================================
+
+Our Pledge
+==========
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+Our Standards
+=============
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the
+  overall community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or
+  advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email
+  address, without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+Enforcement Responsibilities
+============================
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+Scope
+=====
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+Enforcement
+===========
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+`matplotlib-coc@numfocus.org <mailto:matplotlib-coc@numfocus.org>`_ which is
+monitored by the `CoC subcommittee <https://matplotlib.org/governance/people.html#coc-subcommittee>`_ or a
+report can be made using the `NumFOCUS Code of Conduct report form <https://numfocus.typeform.com/to/ynjGdT>`_.
+If community leaders cannot come to a resolution about enforcement,
+reports will be escalated to the NumFocus Code of Conduct committee
+(conduct@numfocus.org).  All complaints will be reviewed and investigated
+promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+Enforcement Guidelines
+======================
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+1. Correction
+-------------
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+2. Warning
+----------
+
+**Community Impact**: A violation through a single incident or series
+of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or
+permanent ban.
+
+3. Temporary Ban
+----------------
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+4. Permanent Ban
+----------------
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior,  harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within
+the community.
+
+Attribution
+===========
+
+This Code of Conduct is adapted from the `Contributor Covenant <https://www.contributor-covenant.org>`_,
+version 2.0, available at
+https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
+
+Community Impact Guidelines were inspired by `Mozilla's code of conduct
+enforcement ladder <https://github.com/mozilla/diversity>`_.
+
+
+For answers to common questions about this code of conduct, see the FAQ at
+https://www.contributor-covenant.org/faq. Translations are available at
+https://www.contributor-covenant.org/translations.
diff --git a/doc/users/project/index.rst b/doc/users/project/index.rst
index 27f60d166abb..80dd6e27bc3d 100644
--- a/doc/users/project/index.rst
+++ b/doc/users/project/index.rst
@@ -8,6 +8,7 @@ Project information
 
     mission.rst
     history.rst
+    Code of Conduct <code_of_conduct.rst>
     citing.rst
     license.rst
     credits.rst

From cb84a6b50f4440d9f27b8a7b4d234b83a29f037b Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Wed, 6 Sep 2023 10:03:58 -0400
Subject: [PATCH 0121/1120] put placeholder text with links out in
 code_of_conduct.md

---
 CODE_OF_CONDUCT.md | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
index d43f37214254..657eb14336b9 100644
--- a/CODE_OF_CONDUCT.md
+++ b/CODE_OF_CONDUCT.md
@@ -1,5 +1,6 @@
+<!--placeholder page so Github knows we have a CoC-->
 
----
-layout: forward
-target: https://matplotlib.org/stable/users/project/code_of_conduct.html
----
+Our Code of Conduct is at
+https://matplotlib.org/stable/users/project/code_of_conduct.html
+
+It is rendered from `doc/users/project/code_of_conduct.rst`

From 41e38c5b1584632d2dac27bdb620b076b6947084 Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Fri, 8 Sep 2023 09:18:31 +0200
Subject: [PATCH 0122/1120] Fix issue with missing attribute in
 Path3DCollection

---
 lib/mpl_toolkits/mplot3d/art3d.py            |  1 +
 lib/mpl_toolkits/mplot3d/tests/test_art3d.py | 18 ++++++++++++++++++
 2 files changed, 19 insertions(+)

diff --git a/lib/mpl_toolkits/mplot3d/art3d.py b/lib/mpl_toolkits/mplot3d/art3d.py
index ac6e841f5019..d2d782123f6e 100644
--- a/lib/mpl_toolkits/mplot3d/art3d.py
+++ b/lib/mpl_toolkits/mplot3d/art3d.py
@@ -833,6 +833,7 @@ def patch_collection_2d_to_3d(col, zs=0, zdir='z', depthshade=True):
     """
     if isinstance(col, PathCollection):
         col.__class__ = Path3DCollection
+        col._offset_zordered = None
     elif isinstance(col, PatchCollection):
         col.__class__ = Patch3DCollection
     col._depthshade = depthshade
diff --git a/lib/mpl_toolkits/mplot3d/tests/test_art3d.py b/lib/mpl_toolkits/mplot3d/tests/test_art3d.py
index 02d35aad0e4b..4ed48aae4685 100644
--- a/lib/mpl_toolkits/mplot3d/tests/test_art3d.py
+++ b/lib/mpl_toolkits/mplot3d/tests/test_art3d.py
@@ -1,6 +1,9 @@
+import numpy as np
+
 import matplotlib.pyplot as plt
 
 from matplotlib.backend_bases import MouseEvent
+from mpl_toolkits.mplot3d.art3d import Line3DCollection
 
 
 def test_scatter_3d_projection_conservation():
@@ -36,3 +39,18 @@ def test_scatter_3d_projection_conservation():
             assert contains is True
             assert len(ind["ind"]) == 1
             assert ind["ind"][0] == i
+
+
+def test_zordered_error():
+    # Smoke test for https://github.com/matplotlib/matplotlib/issues/26497
+    lc = [(np.fromiter([0.0, 0.0, 0.0], dtype="float"),
+           np.fromiter([1.0, 1.0, 1.0], dtype="float"))]
+    pc = [np.fromiter([0.0, 0.0], dtype="float"),
+          np.fromiter([0.0, 1.0], dtype="float"),
+          np.fromiter([1.0, 1.0], dtype="float")]
+
+    fig = plt.figure()
+    ax = fig.add_subplot(projection="3d")
+    ax.add_collection(Line3DCollection(lc))
+    ax.scatter(*pc, visible=False)
+    plt.draw()

From fa80f34333df2033ac219beb11486bdbac1dff22 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 8 Sep 2023 05:30:32 -0400
Subject: [PATCH 0123/1120] Add a Python 3.12 classifier

---
 setup.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/setup.py b/setup.py
index de8976cb70d2..e9c5df01eb68 100644
--- a/setup.py
+++ b/setup.py
@@ -305,6 +305,7 @@ def make_release_tree(self, base_dir, files):
         'Programming Language :: Python :: 3.9',
         'Programming Language :: Python :: 3.10',
         'Programming Language :: Python :: 3.11',
+        'Programming Language :: Python :: 3.12',
         'Topic :: Scientific/Engineering :: Visualization',
     ],
 

From 3fd6eecfe978a7b818964c365eb6ca45f106f9a0 Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Wed, 6 Sep 2023 10:09:05 +0200
Subject: [PATCH 0124/1120] [Doc] Small fixes found by velin

---
 lib/matplotlib/_constrained_layout.py        | 61 ++++++++++++--------
 lib/matplotlib/backend_bases.py              |  5 ++
 lib/matplotlib/backends/_backend_pdf_ps.py   |  2 +-
 lib/matplotlib/backends/backend_svg.py       |  1 +
 lib/matplotlib/colors.py                     | 32 +++++++---
 lib/matplotlib/legend_handler.py             |  2 +-
 lib/matplotlib/patches.py                    |  7 ++-
 lib/mpl_toolkits/axes_grid1/axes_divider.py  | 16 ++++-
 lib/mpl_toolkits/axes_grid1/axes_rgb.py      |  4 +-
 lib/mpl_toolkits/axes_grid1/parasite_axes.py |  2 +-
 lib/mpl_toolkits/axisartist/axis_artist.py   |  8 +--
 lib/mpl_toolkits/mplot3d/art3d.py            |  2 +-
 lib/mpl_toolkits/mplot3d/axis3d.py           |  4 +-
 13 files changed, 94 insertions(+), 52 deletions(-)

diff --git a/lib/matplotlib/_constrained_layout.py b/lib/matplotlib/_constrained_layout.py
index a562e44a44af..907e7a24976e 100644
--- a/lib/matplotlib/_constrained_layout.py
+++ b/lib/matplotlib/_constrained_layout.py
@@ -69,11 +69,8 @@ def do_constrained_layout(fig, h_pad, w_pad,
 
     Parameters
     ----------
-    fig : Figure
-        ``Figure`` instance to do the layout in.
-
-    renderer : Renderer
-        Renderer to use.
+    fig : `~matplotlib.figure.Figure`
+        `.Figure` instance to do the layout in.
 
     h_pad, w_pad : float
       Padding around the axes elements in figure-normalized units.
@@ -274,7 +271,7 @@ def compress_fixed_aspect(layoutgrids, fig):
             extrah = np.zeros(gs.nrows)
         elif _gs != gs:
             raise ValueError('Cannot do compressed layout if axes are not'
-                                'all from the same gridspec')
+                             'all from the same gridspec')
         orig = ax.get_position(original=True)
         actual = ax.get_position(original=False)
         dw = orig.width - actual.width
@@ -343,6 +340,19 @@ def make_layout_margins(layoutgrids, fig, renderer, *, w_pad=0, h_pad=0,
     decorations on the axis.
 
     Then make room for colorbars.
+
+    Parameters
+    ----------
+    layoutgrids : dict
+    fig : `~matplotlib.figure.Figure`
+        `.Figure` instance to do the layout in.
+    renderer : `~matplotlib.backend_bases.RendererBase` subclass.
+        The renderer to use.
+    w_pad, h_pad : float, default: 0
+        Width and height padding (in fraction of figure).
+    hspace, wspace : float, default: 0
+        Width and height padding as fraction of figure size divided by
+        number of columns or rows.
     """
     for sfig in fig.subfigs:  # recursively make child panel margins
         ss = sfig._subplotspec
@@ -448,7 +458,7 @@ def make_margin_suptitles(layoutgrids, fig, renderer, *, w_pad=0, h_pad=0):
     # get the h_pad and w_pad as distances in the local subfigure coordinates:
     padbox = mtransforms.Bbox([[0, 0], [w_pad, h_pad]])
     padbox = (fig.transFigure -
-                   fig.transSubfigure).transform_bbox(padbox)
+              fig.transSubfigure).transform_bbox(padbox)
     h_pad_local = padbox.height
     w_pad_local = padbox.width
 
@@ -578,7 +588,12 @@ def match_submerged_margins(layoutgrids, fig):
 
 def get_cb_parent_spans(cbax):
     """
-    Figure out which subplotspecs this colorbar belongs to:
+    Figure out which subplotspecs this colorbar belongs to.
+
+    Parameters
+    ----------
+    cbax : `~matplotlib.axes.Axes`
+        Axes for the colorbar.
     """
     rowstart = np.inf
     rowstop = -np.inf
@@ -602,14 +617,14 @@ def get_pos_and_bbox(ax, renderer):
 
     Parameters
     ----------
-    ax
-    renderer
+    ax : `~matplotlib.axes.Axes`
+    renderer : `~matplotlib.backend_bases.RendererBase` subclass.
 
     Returns
     -------
-    pos : Bbox
+    pos : `~matplotlib.transforms.Bbox`
         Position in figure coordinates.
-    bbox : Bbox
+    bbox : `~matplotlib.transforms.Bbox`
         Tight bounding box in figure coordinates.
     """
     fig = ax.figure
@@ -672,18 +687,14 @@ def reposition_colorbar(layoutgrids, cbax, renderer, *, offset=None):
 
     Parameters
     ----------
-    cbax : Axes
-        Axes for the colorbar
-
-    renderer :
-    w_pad, h_pad : float
-        width and height padding (in fraction of figure)
-    hspace, wspace : float
-        width and height padding as fraction of figure size divided by
-        number of columns or rows
-    margin : array-like
-        offset the colorbar needs to be pushed to in order to
-        account for multiple colorbars
+    layoutgrids : dict
+    cbax : `~matplotlib.axes.Axes`
+        Axes for the colorbar.
+    renderer : `~matplotlib.backend_bases.RendererBase` subclass.
+        The renderer to use.
+    offset : array-like
+        Offset the colorbar needs to be pushed to in order to
+        account for multiple colorbars.
     """
 
     parents = cbax._colorbar_info['parents']
@@ -753,7 +764,7 @@ def reposition_colorbar(layoutgrids, cbax, renderer, *, offset=None):
 
 def reset_margins(layoutgrids, fig):
     """
-    Reset the margins in the layoutboxes of fig.
+    Reset the margins in the layoutboxes of *fig*.
 
     Margins are usually set as a minimum, so if the figure gets smaller
     the minimum needs to be zero in order for it to grow again.
diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
index b960ca72bae6..49e067b02bfb 100644
--- a/lib/matplotlib/backend_bases.py
+++ b/lib/matplotlib/backend_bases.py
@@ -208,10 +208,15 @@ def draw_markers(self, gc, marker_path, marker_trans, path,
         ----------
         gc : `.GraphicsContextBase`
             The graphics context.
+        marker_path : `~matplotlib.path.Path`
+            The path for the marker.
         marker_trans : `~matplotlib.transforms.Transform`
             An affine transform applied to the marker.
+        path : `~matplotlib.path.Path`
+            The locations to draw the markers.
         trans : `~matplotlib.transforms.Transform`
             An affine transform applied to the path.
+        rgbFace : color, optional
         """
         for vertices, codes in path.iter_segments(trans, simplify=False):
             if len(vertices):
diff --git a/lib/matplotlib/backends/_backend_pdf_ps.py b/lib/matplotlib/backends/_backend_pdf_ps.py
index 7a4c2e6a3966..ce55df523d9d 100644
--- a/lib/matplotlib/backends/_backend_pdf_ps.py
+++ b/lib/matplotlib/backends/_backend_pdf_ps.py
@@ -28,7 +28,7 @@ def get_glyphs_subset(fontfile, characters):
 
     Parameters
     ----------
-    symbol : str
+    fontfile : str
         Path to the font file
     characters : str
         Continuous set of characters to include in subset
diff --git a/lib/matplotlib/backends/backend_svg.py b/lib/matplotlib/backends/backend_svg.py
index 4bac6bcb4427..f62152ed1f0a 100644
--- a/lib/matplotlib/backends/backend_svg.py
+++ b/lib/matplotlib/backends/backend_svg.py
@@ -200,6 +200,7 @@ def end(self, tag=None, indent=True):
         tag
             Element tag.  If given, the tag must match the start tag.  If
             omitted, the current element is closed.
+        indent : bool, default: True
         """
         if tag:
             assert self.__tags, f"unbalanced end({tag})"
diff --git a/lib/matplotlib/colors.py b/lib/matplotlib/colors.py
index 43eab9583e90..d0d20806666a 100644
--- a/lib/matplotlib/colors.py
+++ b/lib/matplotlib/colors.py
@@ -2300,6 +2300,18 @@ def __init__(self, azdeg=315, altdeg=45, hsv_min_val=0, hsv_max_val=1,
         altdeg : float, default: 45 degrees
             The altitude (0-90, degrees up from horizontal) of the light
             source.
+        hsv_min_val : number, default: 0
+            The minimum value ("v" in "hsv") that the *intensity* map can shift the
+            output image to.
+        hsv_max_val : number, default: 1
+            The maximum value ("v" in "hsv") that the *intensity* map can shift the
+            output image to.
+        hsv_min_sat : number, default: 1
+            The minimum saturation value that the *intensity* map can shift the output
+            image to.
+        hsv_max_sat : number, default: 0
+            The maximum saturation value that the *intensity* map can shift the output
+            image to.
 
         Notes
         -----
@@ -2599,18 +2611,20 @@ def blend_hsv(self, rgb, intensity, hsv_max_sat=None, hsv_max_val=None,
             An (M, N, 3) RGB array of floats ranging from 0 to 1 (color image).
         intensity : `~numpy.ndarray`
             An (M, N, 1) array of floats ranging from 0 to 1 (grayscale image).
-        hsv_max_sat : number, default: 1
-            The maximum saturation value that the *intensity* map can shift the
-            output image to.
+        hsv_max_sat : number, optional
+            The maximum saturation value that the *intensity* map can shift the output
+            image to. If not provided, use the value provided upon initialization.
         hsv_min_sat : number, optional
-            The minimum saturation value that the *intensity* map can shift the
-            output image to. Defaults to 0.
+            The minimum saturation value that the *intensity* map can shift the output
+            image to. If not provided, use the value provided upon initialization.
         hsv_max_val : number, optional
-            The maximum value ("v" in "hsv") that the *intensity* map can shift
-            the output image to. Defaults to 1.
+            The maximum value ("v" in "hsv") that the *intensity* map can shift the
+            output image to. If not provided, use the value provided upon
+            initialization.
         hsv_min_val : number, optional
-            The minimum value ("v" in "hsv") that the *intensity* map can shift
-            the output image to. Defaults to 0.
+            The minimum value ("v" in "hsv") that the *intensity* map can shift the
+            output image to. If not provided, use the value provided upon
+            initialization.
 
         Returns
         -------
diff --git a/lib/matplotlib/legend_handler.py b/lib/matplotlib/legend_handler.py
index c72edf86a484..5a929070e32d 100644
--- a/lib/matplotlib/legend_handler.py
+++ b/lib/matplotlib/legend_handler.py
@@ -155,7 +155,7 @@ def create_artists(self, legend, orig_handle,
         fontsize : int
             The fontsize in pixels. The legend artists being created should
             be scaled according to the given fontsize.
-        trans :  `~matplotlib.transforms.Transform`
+        trans : `~matplotlib.transforms.Transform`
             The transform that is applied to the legend artists being created.
             Typically from unit coordinates in the handler box to screen
             coordinates.
diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
index 92dc55940b8a..f80df92c62fc 100644
--- a/lib/matplotlib/patches.py
+++ b/lib/matplotlib/patches.py
@@ -994,9 +994,10 @@ def __init__(self, values, edges, *,
             True or an array is passed to *baseline*, a closed
             path is drawn.
 
-        Other valid keyword arguments are:
+        **kwargs
+            `Patch` properties:
 
-        %(Patch:kwdoc)s
+            %(Patch:kwdoc)s
         """
         self.orientation = orientation
         self._edges = np.asarray(edges)
@@ -1112,7 +1113,7 @@ def set_closed(self, closed):
         Parameters
         ----------
         closed : bool
-           True if the polygon is closed
+            True if the polygon is closed
         """
         if self._closed == bool(closed):
             return
diff --git a/lib/mpl_toolkits/axes_grid1/axes_divider.py b/lib/mpl_toolkits/axes_grid1/axes_divider.py
index 097bf712d121..f6c38f35dbc4 100644
--- a/lib/mpl_toolkits/axes_grid1/axes_divider.py
+++ b/lib/mpl_toolkits/axes_grid1/axes_divider.py
@@ -37,11 +37,11 @@ def __init__(self, fig, pos, horizontal, vertical,
             Sizes for horizontal division.
         vertical : list of :mod:`~mpl_toolkits.axes_grid1.axes_size`
             Sizes for vertical division.
-        aspect : bool
+        aspect : bool, optional
             Whether overall rectangular area is reduced so that the relative
             part of the horizontal and vertical scales have the same scale.
         anchor : (float, float) or {'C', 'SW', 'S', 'SE', 'E', 'NE', 'N', \
-'NW', 'W'}
+'NW', 'W'}, default: 'C'
             Placement of the reduced rectangle, when *aspect* is True.
         """
 
@@ -294,7 +294,7 @@ def add_auto_adjustable_area(self, use_axes, pad=0.1, adjust_dirs=None):
         ----------
         use_axes : `~matplotlib.axes.Axes` or list of `~matplotlib.axes.Axes`
             The Axes whose decorations are taken into account.
-        pad : float, optional
+        pad : float, default: 0.1
             Additional padding in inches.
         adjust_dirs : list of {"left", "right", "bottom", "top"}, optional
             The sides where padding is added; defaults to all four sides.
@@ -377,6 +377,16 @@ def __init__(self, fig, *args, horizontal=None, vertical=None,
             If *nrows*, *ncols*, and *index* are all single digit numbers, then
             *args* can be passed as a single 3-digit number (e.g. 234 for
             (2, 3, 4)).
+        horizontal : list of :mod:`~mpl_toolkits.axes_grid1.axes_size`, optional
+            Sizes for horizontal division.
+        vertical : list of :mod:`~mpl_toolkits.axes_grid1.axes_size`, optional
+            Sizes for vertical division.
+        aspect : bool, optional
+            Whether overall rectangular area is reduced so that the relative
+            part of the horizontal and vertical scales have the same scale.
+        anchor : (float, float) or {'C', 'SW', 'S', 'SE', 'E', 'NE', 'N', \
+'NW', 'W'}, default: 'C'
+            Placement of the reduced rectangle, when *aspect* is True.
         """
         self.figure = fig
         super().__init__(fig, [0, 0, 1, 1],
diff --git a/lib/mpl_toolkits/axes_grid1/axes_rgb.py b/lib/mpl_toolkits/axes_grid1/axes_rgb.py
index 499684a22d5e..52fd707e8704 100644
--- a/lib/mpl_toolkits/axes_grid1/axes_rgb.py
+++ b/lib/mpl_toolkits/axes_grid1/axes_rgb.py
@@ -17,7 +17,7 @@ def make_rgb_axes(ax, pad=0.01, axes_class=None, **kwargs):
     axes_class : `matplotlib.axes.Axes` or None, optional
         Axes class to use for the R, G, and B Axes. If None, use
         the same class as *ax*.
-    **kwargs :
+    **kwargs
         Forwarded to *axes_class* init for the R, G, and B Axes.
     """
 
@@ -130,7 +130,7 @@ def imshow_rgb(self, r, g, b, **kwargs):
         ----------
         r, g, b : array-like
             The red, green, and blue arrays.
-        **kwargs :
+        **kwargs
             Forwarded to `~.Axes.imshow` calls for the four images.
 
         Returns
diff --git a/lib/mpl_toolkits/axes_grid1/parasite_axes.py b/lib/mpl_toolkits/axes_grid1/parasite_axes.py
index cafd06adba2e..2a2b5957e844 100644
--- a/lib/mpl_toolkits/axes_grid1/parasite_axes.py
+++ b/lib/mpl_toolkits/axes_grid1/parasite_axes.py
@@ -105,7 +105,7 @@ def get_aux_axes(
         axes_class : subclass type of `~matplotlib.axes.Axes`, optional
             The `~.axes.Axes` subclass that is instantiated.  If None, the base
             class of the host axes is used.
-        kwargs
+        **kwargs
             Other parameters are forwarded to the parasite axes constructor.
         """
         if axes_class is None:
diff --git a/lib/mpl_toolkits/axisartist/axis_artist.py b/lib/mpl_toolkits/axisartist/axis_artist.py
index 74df999ef24e..407ad07a3dc2 100644
--- a/lib/mpl_toolkits/axisartist/axis_artist.py
+++ b/lib/mpl_toolkits/axisartist/axis_artist.py
@@ -602,11 +602,11 @@ def __init__(self, *args, which="major", axis="both", **kwargs):
         Parameters
         ----------
         which : {"major", "minor"}
-           Which grid to consider.
+            Which grid to consider.
         axis : {"both", "x", "y"}
-           Which axis to consider.
-        *args, **kwargs :
-           Passed to `.LineCollection`.
+            Which axis to consider.
+        *args, **kwargs
+            Passed to `.LineCollection`.
         """
         self._which = which
         self._axis = axis
diff --git a/lib/mpl_toolkits/mplot3d/art3d.py b/lib/mpl_toolkits/mplot3d/art3d.py
index ac6e841f5019..d60219b74fb9 100644
--- a/lib/mpl_toolkits/mplot3d/art3d.py
+++ b/lib/mpl_toolkits/mplot3d/art3d.py
@@ -202,7 +202,7 @@ def __init__(self, xs, ys, zs, *args, **kwargs):
             The y-data to be plotted.
         zs : array-like
             The z-data to be plotted.
-        *args, **kwargs :
+        *args, **kwargs
             Additional arguments are passed to `~matplotlib.lines.Line2D`.
         """
         super().__init__([], [], *args, **kwargs)
diff --git a/lib/mpl_toolkits/mplot3d/axis3d.py b/lib/mpl_toolkits/mplot3d/axis3d.py
index 58792deae963..4c5fa8a9c901 100644
--- a/lib/mpl_toolkits/mplot3d/axis3d.py
+++ b/lib/mpl_toolkits/mplot3d/axis3d.py
@@ -192,7 +192,7 @@ def set_ticks_position(self, position):
 
         Parameters
         ----------
-        str : {'lower', 'upper', 'both', 'default', 'none'}
+        position : {'lower', 'upper', 'both', 'default', 'none'}
             The position of the bolded axis lines, ticks, and tick labels.
         """
         if position in ['top', 'bottom']:
@@ -221,7 +221,7 @@ def set_label_position(self, position):
 
         Parameters
         ----------
-        str : {'lower', 'upper', 'both', 'default', 'none'}
+        position : {'lower', 'upper', 'both', 'default', 'none'}
             The position of the axis label.
         """
         if position in ['top', 'bottom']:

From d5a54d1eb10dc5cee3702f9f338add8276c5cd3b Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Tue, 29 Aug 2023 20:29:50 -0400
Subject: [PATCH 0125/1120] removed faq folder and added general faq link to
 user guide index, moved install related troubleshooting/faq to install docs
 new troubleshooting page specific to development consolidated information
 across install, install for dev, and dependencies

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>
---
 doc/conf.py                                   |   3 +-
 doc/devel/dependencies.rst                    |  82 ++-
 doc/devel/development_setup.rst               |   6 +
 doc/devel/index.rst                           |  11 +
 doc/devel/troubleshooting.rst                 |  45 ++
 doc/index.rst                                 |   2 +-
 doc/missing-references.json                   | 667 +++++++++---------
 doc/users/{faq/howto_faq.rst => faq.rst}      |  98 ++-
 doc/users/faq/index.rst                       |  21 -
 doc/users/faq/troubleshooting_faq.rst         | 177 -----
 doc/users/index.rst                           |   6 +
 .../environment_variables_faq.rst             |  11 +-
 doc/users/installing/index.rst                | 126 +---
 .../installing/troubleshooting_faq.inc.rst    |  72 ++
 14 files changed, 675 insertions(+), 652 deletions(-)
 create mode 100644 doc/devel/troubleshooting.rst
 rename doc/users/{faq/howto_faq.rst => faq.rst} (75%)
 delete mode 100644 doc/users/faq/index.rst
 delete mode 100644 doc/users/faq/troubleshooting_faq.rst
 rename doc/users/{faq => installing}/environment_variables_faq.rst (95%)
 create mode 100644 doc/users/installing/troubleshooting_faq.inc.rst

diff --git a/doc/conf.py b/doc/conf.py
index 21da93ee6f58..95f7ea065f96 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -121,8 +121,7 @@ def _parse_skip_subdirs_file():
 ]
 
 exclude_patterns = [
-    'api/prev_api_changes/api_changes_*/*'
-]
+    'api/prev_api_changes/api_changes_*/*', '**/*inc.rst']
 
 exclude_patterns += skip_subdirs
 
diff --git a/doc/devel/dependencies.rst b/doc/devel/dependencies.rst
index 3ad6ecc8dcb2..c840436397cc 100644
--- a/doc/devel/dependencies.rst
+++ b/doc/devel/dependencies.rst
@@ -38,7 +38,7 @@ The following packages and tools are not required but extend the capabilities
 of Matplotlib.
 
 Backends
-~~~~~~~~
+^^^^^^^^
 
 Matplotlib figures can be rendered to various user interfaces. See
 :ref:`what-is-a-backend` for more details on the optional Matplotlib backends
@@ -73,14 +73,14 @@ and the capabilities they provide.
 .. _ipykernel: https://pypi.org/project/ipykernel/
 
 Animations
-~~~~~~~~~~
+^^^^^^^^^^
 
 * `ffmpeg <https://www.ffmpeg.org/>`_: for saving movies.
 * `ImageMagick <https://www.imagemagick.org/script/index.php>`_: for saving
   animated gifs.
 
 Font handling and rendering
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 * `LaTeX <https://www.latex-project.org/>`_ (with `cm-super
   <https://ctan.org/pkg/cm-super>`__ and `underscore
@@ -111,7 +111,7 @@ rasterize characters differently) and of Qhull.  As an exception, Matplotlib
 defaults to the system version of FreeType on AIX.
 
 Use system libraries
-~~~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^^
 
 To force Matplotlib to use a copy of FreeType or Qhull already installed in
 your system, create a :file:`mplsetup.cfg` file with the following contents:
@@ -185,7 +185,7 @@ remember to clear your artifacts before re-building::
 
 
 Manual Download
-~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^
 
 
 If the automatic download does not work (for example on air-gapped systems) it
@@ -240,17 +240,65 @@ Setup dependencies
 C++ compiler
 ------------
 
-Matplotlib requires a C++ compiler that supports C++11.
+Matplotlib requires a C++ compiler that supports C++11, and each platform has a
+development environment that must be installed before a compiler can be installed.
+
+.. tab-set::
+
+    .. tab-item:: Linux
+
+        On some Linux systems, you can install a meta-build package. For example,
+        on  Ubuntu ``apt install build-essential``
+
+        Otherwise, use the system distribution's package manager to install
+        :ref:`gcc <compiler-table>`.
+
+    .. tab-item:: macOS
+
+        Install `Xcode <https://developer.apple.com/xcode/>`_ for Apple platform development.
+
+    .. tab-item:: Windows
+
+        Install `Visual Studio Build Tools <https://visualstudio.microsoft.com/downloads/?q=build+tools>`_
+
+        Make sure "Desktop development with C++" is selected, and that the latest MSVC,
+        "C++ CMake tools for Windows," and a Windows SDK compatible with your version
+        of Windows are selected and installed. They should be selected by default under
+        the "Optional" subheading, but are required to build Matplotlib from source.
+
+        Alternatively, you can install a Linux-like environment such as `CygWin <https://www.cygwin.com/>`_
+        or `Windows Subsystem for Linux <https://learn.microsoft.com/en-us/windows/wsl/install>`_.
+
+
+We highly recommend that you install a compiler using your platform tool, i.e.,
+Xcode, VS Code or Linux package manager. Choose **one** compiler from this list:
+
+.. _compiler-table:
+
+.. list-table::
+   :widths: 20 20 20 40
+   :header-rows: 1
+
+   * - compiler
+     - minimum version
+     - platforms
+     - notes
+   * - GCC
+     - **4.8.1**
+     - Linux, macOS, Windows
+     - `gcc 4.8.1 <https://gcc.gnu.org/projects/cxx-status.html#cxx11>`_,
+       `GCC: Binaries <https://gcc.gnu.org/install/binaries.html>`_,
+
+       For gcc <6.5 you will need to set ``$CFLAGS=-std=c++11`` to enable C++11 support.
+   * - Clang (LLVM)
+     - **3.3**
+     - Linux, macOS
+     - `clang 3.3 <https://clang.llvm.org/cxx_status.html>`_, `LLVM <https://releases.llvm.org/download.html>`_
+   * - MSVC++
+     - **14.0**
+     - Windows
+     - `Visual Studio 2015 C++ <https://docs.microsoft.com/en-us/cpp/overview/visual-cpp-language-conformance?view=msvc-140>`_
 
-- `gcc 4.8.1 <https://gcc.gnu.org/projects/cxx-status.html#cxx11>`_ or higher.  For gcc <6.5 you will
-  need to set ``$CFLAGS=-std=c++11`` to enable C++11 support.
-  `Installing GCC: Binaries <https://gcc.gnu.org/install/binaries.html>`_.
-- `clang 3.3 <https://clang.llvm.org/cxx_status.html>`_ or higher.
-  `LLVM Download Page <https://releases.llvm.org/download.html>`_.
-- `Visual Studio 2015
-  <https://docs.microsoft.com/en-us/cpp/overview/visual-cpp-language-conformance?view=msvc-140>`_
-  (aka VS 14.0) or higher. A free version of Build Tools for Visual Studio is available for
-  `download <https://visualstudio.microsoft.com/downloads/?q=build+tools>`_.
 
 
 .. _test-dependencies:
@@ -286,8 +334,8 @@ testing the following will be used if they are installed.
   fonts for testing font fallback and non-western fonts
 - xarray_ used to test compatibility with xarray
 
-If any of these dependencies are not discovered the tests that rely on them
-will be skipped by pytest.
+If any of these dependencies are not discovered, then the tests that rely on
+them will be skipped by pytest.
 
 .. note::
 
diff --git a/doc/devel/development_setup.rst b/doc/devel/development_setup.rst
index 4d277fca2ab4..8537e1229df4 100644
--- a/doc/devel/development_setup.rst
+++ b/doc/devel/development_setup.rst
@@ -148,6 +148,12 @@ The simplest way to do this is to use either Python's virtual environment
 
 Remember to activate the environment whenever you start working on Matplotlib.
 
+Install Dependencies
+====================
+Most Python dependencies will be installed when :ref:`setting up the environment <dev-environment>`
+but non-Python dependencies like C++ compilers, LaTeX, and other system applications
+must be installed separately. For a full list, see :ref:`dependencies`.
+
 Install Matplotlib in editable mode
 ===================================
 
diff --git a/doc/devel/index.rst b/doc/devel/index.rst
index a49290dd8994..2b358595255b 100644
--- a/doc/devel/index.rst
+++ b/doc/devel/index.rst
@@ -78,6 +78,7 @@ Development environment
 .. grid:: 1 1 2 2
 
    .. grid-item-card::
+      :shadow: none
 
       **Install**
       ^^^
@@ -91,9 +92,11 @@ Development environment
          :maxdepth: 1
 
          dependencies
+         ../users/installing/environment_variables_faq.rst
 
 
    .. grid-item-card::
+      :shadow: none
 
       **Workflow**
       ^^^^
@@ -103,6 +106,10 @@ Development environment
 
          development_workflow
 
+      .. toctree::
+         :maxdepth: 1
+
+         troubleshooting.rst
 
 
 .. _contribution_guideline:
@@ -115,6 +122,7 @@ Policies and guidelines
    :gutter: 2
 
    .. grid-item-card::
+      :shadow: none
 
       **Code**
       ^^^
@@ -128,6 +136,7 @@ Policies and guidelines
          testing
 
    .. grid-item-card::
+      :shadow: none
 
       **Documentation**
       ^^^
@@ -139,6 +148,7 @@ Policies and guidelines
          style_guide
 
    .. grid-item-card::
+      :shadow: none
 
       **Triage**
       ^^^
@@ -148,6 +158,7 @@ Policies and guidelines
       | :ref:`triage_workflow`
 
    .. grid-item-card::
+      :shadow: none
 
       **Maintenance**
       ^^^
diff --git a/doc/devel/troubleshooting.rst b/doc/devel/troubleshooting.rst
new file mode 100644
index 000000000000..77c1b242399b
--- /dev/null
+++ b/doc/devel/troubleshooting.rst
@@ -0,0 +1,45 @@
+.. _troubleshooting-faq:
+
+.. redirect-from:: /faq/troubleshooting_faq
+.. redirect-from:: /users/faq/troubleshooting_faq
+
+===============
+Troubleshooting
+===============
+
+For guidance on debugging an installation, see :ref:`installing-faq`.
+
+
+.. _git-trouble:
+
+Problems with git
+=================
+
+First, make sure you have a clean build and install (see :ref:`clean-install`),
+get the latest git update, install it and run a simple test script in debug
+mode::
+
+    rm -rf /path/to/site-packages/matplotlib*
+    git clean -xfd
+    git pull
+    python -m pip install -v . > build.out
+    python -c "from pylab import *; set_loglevel('debug'); plot(); show()" > run.out
+
+and post :file:`build.out` and :file:`run.out` to the `matplotlib-devel
+<https://mail.python.org/mailman/listinfo/matplotlib-devel>`_
+mailing list (please do not post git problems to the `users list
+<https://mail.python.org/mailman/listinfo/matplotlib-users>`_).
+
+Of course, you will want to clearly describe your problem, what you
+are expecting and what you are getting, but often a clean build and
+install will help.  See also :ref:`reporting-problems`.
+
+Unlink of file ``*/_c_internal_utils.cp311-win_amd64.pyd`` failed
+============================================================================
+
+The DLL files may be loaded by multiple running instances of Matplotlib; therefore
+check that Matplotlib is not running in any other application before trying to
+unlink this file. Multiple versions of Matplotlib can be linked to the same DLL,
+for example a development version installed in a development conda environment
+and a stable version running in a Jupyter notebook. To resolve this error, fully
+close all running instances of Matplotlib.
diff --git a/doc/index.rst b/doc/index.rst
index 8193c94aede9..4f42273d3dcc 100644
--- a/doc/index.rst
+++ b/doc/index.rst
@@ -56,7 +56,7 @@ Learn
             users/explain/quick_start
             User guide <users/index.rst>
             tutorials/index.rst
-            users/faq/index.rst
+            users/faq.rst
 
     .. grid-item-card::
         :padding: 2
diff --git a/doc/missing-references.json b/doc/missing-references.json
index 364885ab3a74..72de214df985 100644
--- a/doc/missing-references.json
+++ b/doc/missing-references.json
@@ -1,101 +1,126 @@
 {
   "py:attr": {
     "cbar_axes": [
-      "lib/mpl_toolkits/axes_grid1/axes_grid.py:docstring of mpl_toolkits.axes_grid1.axes_grid.ImageGrid:41",
-      "lib/mpl_toolkits/axisartist/axes_grid.py:docstring of mpl_toolkits.axisartist.axes_grid.ImageGrid:41"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axes_grid1\\axes_grid.py:docstring of mpl_toolkits.axes_grid1.axes_grid.ImageGrid:72",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axisartist\\axes_grid.py:docstring of mpl_toolkits.axisartist.axes_grid.ImageGrid:72"
     ],
     "eventson": [
-      "lib/matplotlib/widgets.py:docstring of matplotlib.widgets:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\widgets.py:docstring of matplotlib.widgets.CheckButtons.set_active:4",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\widgets.py:docstring of matplotlib.widgets.RadioButtons.set_active:4"
     ],
     "fmt_zdata": [
-      "lib/mpl_toolkits/mplot3d/axes3d.py:docstring of mpl_toolkits.mplot3d.axes3d.Axes3D.format_zdata:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\mplot3d\\axes3d.py:docstring of mpl_toolkits.mplot3d.axes3d.Axes3D.format_zdata:2"
     ],
     "height": [
-      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.Bbox.bounds:2"
     ],
     "input_dims": [
-      "lib/matplotlib/projections/geo.py:docstring of matplotlib.projections.geo.AitoffAxes:1",
-      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms:10",
-      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms:11",
-      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms:4"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.AitoffAxes.AitoffTransform.transform_non_affine:14",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.AitoffAxes.InvertedAitoffTransform.transform_non_affine:14",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.HammerAxes.HammerTransform.transform_non_affine:14",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.HammerAxes.InvertedHammerTransform.transform_non_affine:14",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.LambertAxes.InvertedLambertTransform.transform_non_affine:14",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.LambertAxes.LambertTransform.transform_non_affine:14",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.MollweideAxes.InvertedMollweideTransform.transform_non_affine:14",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.MollweideAxes.MollweideTransform.transform_non_affine:14",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.AffineBase.transform:8",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.AffineBase.transform_affine:15",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.AffineBase.transform_non_affine:14",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.CompositeGenericTransform.transform_affine:15",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.CompositeGenericTransform.transform_non_affine:14",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.IdentityTransform.transform:8",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.IdentityTransform.transform_affine:15",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.IdentityTransform.transform_non_affine:14"
     ],
     "lines": [
-      "lib/matplotlib/colorbar.py:docstring of matplotlib.colorbar:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\colorbar.py:docstring of matplotlib.colorbar.Colorbar.add_lines:4"
     ],
     "matplotlib.axes.Axes.patch": [
-      "doc/tutorials/artists.rst:177",
-      "doc/tutorials/artists.rst:405"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\tutorials/artists.rst:188",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\tutorials/artists.rst:427"
     ],
     "matplotlib.axes.Axes.patches": [
-      "doc/tutorials/artists.rst:443"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\tutorials/artists.rst:465"
     ],
     "matplotlib.axes.Axes.transAxes": [
-      "lib/mpl_toolkits/axes_grid1/anchored_artists.py:docstring of mpl_toolkits.axes_grid1.anchored_artists.AnchoredDirectionArrows:4"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axes_grid1\\anchored_artists.py:docstring of mpl_toolkits.axes_grid1.anchored_artists.AnchoredDirectionArrows:8"
     ],
     "matplotlib.axes.Axes.transData": [
-      "lib/mpl_toolkits/axes_grid1/anchored_artists.py:docstring of mpl_toolkits.axes_grid1.anchored_artists.AnchoredAuxTransformBox:7",
-      "lib/mpl_toolkits/axes_grid1/anchored_artists.py:docstring of mpl_toolkits.axes_grid1.anchored_artists.AnchoredEllipse:4",
-      "lib/mpl_toolkits/axes_grid1/anchored_artists.py:docstring of mpl_toolkits.axes_grid1.anchored_artists.AnchoredSizeBar:4"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axes_grid1\\anchored_artists.py:docstring of mpl_toolkits.axes_grid1.anchored_artists.AnchoredAuxTransformBox:11",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axes_grid1\\anchored_artists.py:docstring of mpl_toolkits.axes_grid1.anchored_artists.AnchoredEllipse:33",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axes_grid1\\anchored_artists.py:docstring of mpl_toolkits.axes_grid1.anchored_artists.AnchoredSizeBar:8"
     ],
     "matplotlib.axes.Axes.xaxis": [
-      "doc/tutorials/artists.rst:589",
-      "doc/users/explain/axes/index.rst:133"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\tutorials/artists.rst:611",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\users/explain/axes/axes_intro.rst:133"
     ],
     "matplotlib.axes.Axes.yaxis": [
-      "doc/tutorials/artists.rst:589",
-      "doc/users/explain/axes/index.rst:133"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\tutorials/artists.rst:611",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\users/explain/axes/axes_intro.rst:133"
     ],
     "matplotlib.axis.Axis.label": [
-      "doc/tutorials/artists.rst:636"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\tutorials/artists.rst:658"
     ],
     "matplotlib.colors.Colormap.name": [
-      "lib/matplotlib/cm.py:docstring of matplotlib.cm:10"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\cm.py:docstring of matplotlib.cm.register_cmap:14"
     ],
     "matplotlib.figure.Figure.patch": [
-      "doc/tutorials/artists.rst:177",
-      "doc/tutorials/artists.rst:310"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\tutorials/artists.rst:188",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\tutorials/artists.rst:321"
     ],
     "matplotlib.figure.Figure.transFigure": [
-      "doc/tutorials/artists.rst:359"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\tutorials/artists.rst:370"
     ],
     "max": [
-      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.Bbox.p1:4"
     ],
     "min": [
-      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.Bbox.p0:4"
     ],
     "mpl_toolkits.mplot3d.axis3d._axinfo": [
-      "doc/api/toolkits/mplot3d.rst:66"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/toolkits/mplot3d.rst:66"
     ],
     "name": [
-      "lib/matplotlib/scale.py:docstring of matplotlib.scale:7"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\scale.py:docstring of matplotlib.scale.ScaleBase:8"
     ],
     "output_dims": [
-      "lib/matplotlib/projections/geo.py:docstring of matplotlib.projections.geo.AitoffAxes:6",
-      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms:10",
-      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms:16",
-      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms:17"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.AitoffAxes.AitoffTransform.transform_non_affine:20",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.AitoffAxes.InvertedAitoffTransform.transform_non_affine:20",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.HammerAxes.HammerTransform.transform_non_affine:20",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.HammerAxes.InvertedHammerTransform.transform_non_affine:20",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.LambertAxes.InvertedLambertTransform.transform_non_affine:20",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.LambertAxes.LambertTransform.transform_non_affine:20",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.MollweideAxes.InvertedMollweideTransform.transform_non_affine:20",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.MollweideAxes.MollweideTransform.transform_non_affine:20",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.AffineBase.transform:14",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.AffineBase.transform_affine:21",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.AffineBase.transform_non_affine:20",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.CompositeGenericTransform.transform_affine:21",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.CompositeGenericTransform.transform_non_affine:20",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.IdentityTransform.transform:14",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.IdentityTransform.transform_affine:21",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.IdentityTransform.transform_non_affine:20"
     ],
     "triangulation": [
-      "lib/matplotlib/tri/_trirefine.py:docstring of matplotlib.tri._trirefine.UniformTriRefiner:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\tri\\_trirefine.py:docstring of matplotlib.tri._trirefine.UniformTriRefiner.refine_triangulation:2"
     ],
     "use_sticky_edges": [
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.margins:48"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.margins:53"
     ],
     "width": [
-      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.Bbox.bounds:2"
     ],
     "xmax": [
-      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.Bbox.x1:4"
     ],
     "xmin": [
-      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.Bbox.x0:4"
     ],
     "ymax": [
-      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.Bbox.y1:4"
     ],
     "ymin": [
-      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.Bbox.y0:4"
     ]
   },
   "py:class": {
@@ -168,538 +193,539 @@
       "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.twiny:1"
     ],
     "matplotlib.axes._base._AxesBase": [
-      "doc/api/artist_api.rst:202"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/artist_api.rst:202"
     ],
     "matplotlib.backend_bases.FigureCanvas": [
-      "doc/tutorials/artists.rst:36",
-      "doc/tutorials/artists.rst:38",
-      "doc/tutorials/artists.rst:43"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\tutorials/artists.rst:36",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\tutorials/artists.rst:38",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\tutorials/artists.rst:43"
     ],
     "matplotlib.backend_bases.Renderer": [
-      "doc/tutorials/artists.rst:38",
-      "doc/tutorials/artists.rst:43"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\tutorials/artists.rst:38",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\tutorials/artists.rst:43"
     ],
     "matplotlib.backend_bases._Backend": [
-      "lib/matplotlib/backend_bases.py:docstring of matplotlib.backend_bases:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backend_bases.py:docstring of matplotlib.backend_bases.ShowBase:1"
     ],
     "matplotlib.backends._backend_pdf_ps.RendererPDFPSBase": [
-      "lib/matplotlib/backends/backend_pdf.py:docstring of matplotlib.backends.backend_pdf:1",
-      "lib/matplotlib/backends/backend_ps.py:docstring of matplotlib.backends.backend_ps:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backends\\backend_pdf.py:docstring of matplotlib.backends.backend_pdf.RendererPdf:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backends\\backend_ps.py:docstring of matplotlib.backends.backend_ps.RendererPS:1"
     ],
     "matplotlib.backends._backend_tk.FigureCanvasTk": [
-      "lib/matplotlib/backends/backend_tkagg.py:docstring of matplotlib.backends.backend_tkagg:1",
-      "lib/matplotlib/backends/backend_tkcairo.py:docstring of matplotlib.backends.backend_tkcairo:1"
-    ],
-    "matplotlib.backends.backend_webagg_core.FigureCanvasWebAggCore": [
-      "lib/matplotlib/backends/backend_nbagg.py:docstring of matplotlib.backends.backend_nbagg:1",
-      "lib/matplotlib/backends/backend_webagg.py:docstring of matplotlib.backends.backend_webagg:1"
-    ],
-    "matplotlib.backends.backend_webagg_core.FigureManagerWebAgg": [
-      "lib/matplotlib/backends/backend_nbagg.py:docstring of matplotlib.backends.backend_nbagg:1",
-      "lib/matplotlib/backends/backend_webagg.py:docstring of matplotlib.backends.backend_webagg:1"
-    ],
-    "matplotlib.backends.backend_webagg_core.NavigationToolbar2WebAgg": [
-      "lib/matplotlib/backends/backend_nbagg.py:docstring of matplotlib.backends.backend_nbagg:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backends\\backend_tkagg.py:docstring of matplotlib.backends.backend_tkagg.FigureCanvasTkAgg:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backends\\backend_tkcairo.py:docstring of matplotlib.backends.backend_tkcairo.FigureCanvasTkCairo:1"
     ],
     "matplotlib.collections._CollectionWithSizes": [
-      "doc/api/artist_api.rst:202",
-      "doc/api/collections_api.rst:13",
-      "lib/matplotlib/collections.py:docstring of matplotlib.collections:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/artist_api.rst:202",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/collections_api.rst:13",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\collections.py:docstring of matplotlib.collections.CircleCollection:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\collections.py:docstring of matplotlib.collections.PathCollection:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\collections.py:docstring of matplotlib.collections.PolyCollection:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\collections.py:docstring of matplotlib.collections.RegularPolyCollection:1"
     ],
     "matplotlib.collections._MeshData": [
-      "doc/api/artist_api.rst:202",
-      "doc/api/collections_api.rst:13",
-      "lib/matplotlib/collections.py:docstring of matplotlib.collections:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/artist_api.rst:202",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/collections_api.rst:13",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\collections.py:docstring of matplotlib.collections.PolyQuadMesh:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\collections.py:docstring of matplotlib.collections.QuadMesh:1"
     ],
     "matplotlib.image._ImageBase": [
-      "doc/api/artist_api.rst:202",
-      "lib/matplotlib/image.py:docstring of matplotlib.image:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/artist_api.rst:202",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\image.py:docstring of matplotlib.image.AxesImage:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\image.py:docstring of matplotlib.image.BboxImage:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\image.py:docstring of matplotlib.image.FigureImage:1"
     ],
     "matplotlib.patches.ArrowStyle._Base": [
-      "lib/matplotlib/patches.py:docstring of matplotlib.patches.ArrowStyle:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle.Fancy:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle.Simple:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle.Wedge:1"
     ],
     "matplotlib.patches.ArrowStyle._Curve": [
-      "lib/matplotlib/patches.py:docstring of matplotlib.patches.ArrowStyle:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle.BarAB:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle.BracketA:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle.BracketAB:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle.BracketB:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle.BracketCurve:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle.Curve:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle.CurveA:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle.CurveAB:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle.CurveB:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle.CurveBracket:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle.CurveFilledA:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle.CurveFilledAB:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle.CurveFilledB:1"
     ],
     "matplotlib.patches.ConnectionStyle._Base": [
-      "lib/matplotlib/patches.py:docstring of matplotlib.patches.ConnectionStyle:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ConnectionStyle.Angle3:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ConnectionStyle.Angle:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ConnectionStyle.Arc3:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ConnectionStyle.Arc:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ConnectionStyle.Bar:1"
     ],
     "matplotlib.patches._Style": [
-      "lib/matplotlib/patches.py:docstring of matplotlib.patches.ArrowStyle:1",
-      "lib/matplotlib/patches.py:docstring of matplotlib.patches.BoxStyle:1",
-      "lib/matplotlib/patches.py:docstring of matplotlib.patches.ConnectionStyle:1",
-      "lib/mpl_toolkits/axisartist/axisline_style.py:docstring of mpl_toolkits.axisartist.axisline_style.AxislineStyle:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.BoxStyle:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ConnectionStyle:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axisartist\\axisline_style.py:docstring of mpl_toolkits.axisartist.axisline_style.AxislineStyle:1"
     ],
     "matplotlib.projections.geo._GeoTransform": [
-      "lib/matplotlib/projections/geo.py:docstring of matplotlib.projections.geo:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.AitoffAxes.AitoffTransform:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.AitoffAxes.InvertedAitoffTransform:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.HammerAxes.HammerTransform:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.HammerAxes.InvertedHammerTransform:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.LambertAxes.InvertedLambertTransform:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.LambertAxes.LambertTransform:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.MollweideAxes.InvertedMollweideTransform:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.MollweideAxes.MollweideTransform:1"
     ],
     "matplotlib.text._AnnotationBase": [
-      "doc/api/artist_api.rst:202",
-      "lib/matplotlib/offsetbox.py:docstring of matplotlib.offsetbox:1",
-      "lib/matplotlib/text.py:docstring of matplotlib.text.Annotation:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/artist_api.rst:202",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\offsetbox.py:docstring of matplotlib.offsetbox.AnnotationBbox:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\text.py:docstring of matplotlib.text.Annotation:1"
     ],
     "matplotlib.transforms._BlendedMixin": [
-      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.BlendedAffine2D:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.BlendedGenericTransform:1"
     ],
     "matplotlib.widgets._SelectorWidget": [
-      "lib/matplotlib/widgets.py:docstring of matplotlib.widgets:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\widgets.py:docstring of matplotlib.widgets.LassoSelector:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\widgets.py:docstring of matplotlib.widgets.PolygonSelector:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\widgets.py:docstring of matplotlib.widgets.RectangleSelector:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\widgets.py:docstring of matplotlib.widgets.SpanSelector:1"
     ],
     "mpl_toolkits.axes_grid1.axes_size._Base": [
-      "lib/mpl_toolkits/axes_grid1/axes_size.py:docstring of mpl_toolkits.axes_grid1.axes_size.Add:1",
-      "lib/mpl_toolkits/axes_grid1/axes_size.py:docstring of mpl_toolkits.axes_grid1.axes_size.AxesX:1",
-      "lib/mpl_toolkits/axes_grid1/axes_size.py:docstring of mpl_toolkits.axes_grid1.axes_size.AxesY:1",
-      "lib/mpl_toolkits/axes_grid1/axes_size.py:docstring of mpl_toolkits.axes_grid1.axes_size.Fixed:1",
-      "lib/mpl_toolkits/axes_grid1/axes_size.py:docstring of mpl_toolkits.axes_grid1.axes_size.Fraction:1",
-      "lib/mpl_toolkits/axes_grid1/axes_size.py:docstring of mpl_toolkits.axes_grid1.axes_size.MaxExtent:1",
-      "lib/mpl_toolkits/axes_grid1/axes_size.py:docstring of mpl_toolkits.axes_grid1.axes_size.Scaled:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axes_grid1\\axes_size.py:docstring of mpl_toolkits.axes_grid1.axes_size.Add:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axes_grid1\\axes_size.py:docstring of mpl_toolkits.axes_grid1.axes_size.AxesX:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axes_grid1\\axes_size.py:docstring of mpl_toolkits.axes_grid1.axes_size.AxesY:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axes_grid1\\axes_size.py:docstring of mpl_toolkits.axes_grid1.axes_size.Fixed:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axes_grid1\\axes_size.py:docstring of mpl_toolkits.axes_grid1.axes_size.Fraction:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axes_grid1\\axes_size.py:docstring of mpl_toolkits.axes_grid1.axes_size.MaxExtent:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axes_grid1\\axes_size.py:docstring of mpl_toolkits.axes_grid1.axes_size.Scaled:1"
     ],
     "mpl_toolkits.axes_grid1.parasite_axes.AxesHostAxes": [
-      "doc/api/_as_gen/mpl_toolkits.axes_grid1.parasite_axes.rst:30:<autosummary>:1",
-      "lib/mpl_toolkits/axes_grid1/parasite_axes.py:docstring of mpl_toolkits.axes_grid1.parasite_axes.AxesHostAxes:1"
+      "<unknown>:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/mpl_toolkits.axes_grid1.parasite_axes.rst:30:<autosummary>:1"
     ],
     "mpl_toolkits.axes_grid1.parasite_axes.AxesParasite": [
-      "doc/api/_as_gen/mpl_toolkits.axes_grid1.parasite_axes.rst:30:<autosummary>:1",
-      "lib/mpl_toolkits/axes_grid1/parasite_axes.py:docstring of mpl_toolkits.axes_grid1.parasite_axes.AxesParasite:1"
+      "<unknown>:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/mpl_toolkits.axes_grid1.parasite_axes.rst:30:<autosummary>:1"
     ],
     "mpl_toolkits.axisartist.Axes": [
-      "doc/api/toolkits/axisartist.rst:6"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/toolkits/axisartist.rst:6"
     ],
     "mpl_toolkits.axisartist.axisline_style.AxislineStyle._Base": [
-      "lib/mpl_toolkits/axisartist/axisline_style.py:docstring of mpl_toolkits.axisartist.axisline_style.AxislineStyle:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axisartist\\axisline_style.py:docstring of mpl_toolkits.axisartist.axisline_style.AxislineStyle.SimpleArrow:1"
     ],
     "mpl_toolkits.axisartist.axisline_style._FancyAxislineStyle.FilledArrow": [
-      "lib/mpl_toolkits/axisartist/axisline_style.py:docstring of mpl_toolkits.axisartist.axisline_style.AxislineStyle:1"
+      "<unknown>:1"
     ],
     "mpl_toolkits.axisartist.axisline_style._FancyAxislineStyle.SimpleArrow": [
-      "lib/mpl_toolkits/axisartist/axisline_style.py:docstring of mpl_toolkits.axisartist.axisline_style.AxislineStyle:1"
+      "<unknown>:1"
     ],
     "mpl_toolkits.axisartist.axislines._FixedAxisArtistHelperBase": [
-      "lib/mpl_toolkits/axisartist/axislines.py:docstring of mpl_toolkits.axisartist.axislines.AxisArtistHelper:1",
-      "lib/mpl_toolkits/axisartist/axislines.py:docstring of mpl_toolkits.axisartist.axislines.FixedAxisArtistHelperRectilinear:1",
-      "lib/mpl_toolkits/axisartist/grid_helper_curvelinear.py:docstring of mpl_toolkits.axisartist.grid_helper_curvelinear.FixedAxisArtistHelper:1"
+      "<unknown>:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axisartist\\axislines.py:docstring of mpl_toolkits.axisartist.axislines.FixedAxisArtistHelperRectilinear:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axisartist\\grid_helper_curvelinear.py:docstring of mpl_toolkits.axisartist.grid_helper_curvelinear.FixedAxisArtistHelper:1"
     ],
     "mpl_toolkits.axisartist.axislines._FloatingAxisArtistHelperBase": [
-      "lib/mpl_toolkits/axisartist/axislines.py:docstring of mpl_toolkits.axisartist.axislines.AxisArtistHelper:1",
-      "lib/mpl_toolkits/axisartist/axislines.py:docstring of mpl_toolkits.axisartist.axislines.FloatingAxisArtistHelperRectilinear:1",
-      "lib/mpl_toolkits/axisartist/grid_helper_curvelinear.py:docstring of mpl_toolkits.axisartist.grid_helper_curvelinear.FloatingAxisArtistHelper:1"
+      "<unknown>:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axisartist\\axislines.py:docstring of mpl_toolkits.axisartist.axislines.FloatingAxisArtistHelperRectilinear:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axisartist\\grid_helper_curvelinear.py:docstring of mpl_toolkits.axisartist.grid_helper_curvelinear.FloatingAxisArtistHelper:1"
     ],
     "mpl_toolkits.axisartist.floating_axes.FloatingAxesHostAxes": [
-      "doc/api/_as_gen/mpl_toolkits.axisartist.floating_axes.rst:32:<autosummary>:1",
-      "lib/mpl_toolkits/axisartist/floating_axes.py:docstring of mpl_toolkits.axisartist.floating_axes.FloatingAxesHostAxes:1"
-    ],
-    "np.ndarray": [
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.acorr:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.angle_spectrum:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.cohere:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.csd:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.hist2d:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.hist:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.imread:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.magnitude_spectrum:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.phase_spectrum:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.psd:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.specgram:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.xcorr:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.xticks:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.yticks:1"
+      "<unknown>:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/mpl_toolkits.axisartist.floating_axes.rst:32:<autosummary>:1"
     ],
     "numpy.uint8": [
-      "lib/matplotlib/path.py:docstring of matplotlib.path:1"
+      "<unknown>:1"
     ]
   },
   "py:data": {
     "matplotlib.axes.Axes.transAxes": [
-      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.legend:238",
-      "lib/matplotlib/figure.py:docstring of matplotlib.figure.FigureBase.add_artist:1",
-      "lib/matplotlib/legend.py:docstring of matplotlib.legend.Legend:105",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.figlegend:242",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.legend:238"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes._axes.Axes.legend:248",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\figure.py:docstring of matplotlib.figure.FigureBase.legend:249",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\legend.py:docstring of matplotlib.legend.Legend:201",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.figlegend:249",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.legend:248"
     ]
   },
   "py:meth": {
     "AbstractPathEffect._update_gc": [
-      "lib/matplotlib/patheffects.py:docstring of matplotlib.patheffects.AbstractPathEffect:26",
-      "lib/matplotlib/patheffects.py:docstring of matplotlib.patheffects.AbstractPathEffect:28",
-      "lib/matplotlib/patheffects.py:docstring of matplotlib.patheffects.AbstractPathEffect:35",
-      "lib/matplotlib/patheffects.py:docstring of matplotlib.patheffects.AbstractPathEffect:40",
-      "lib/matplotlib/patheffects.py:docstring of matplotlib.patheffects.AbstractPathEffect:41"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patheffects.py:docstring of matplotlib.patheffects.SimpleLineShadow:44",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patheffects.py:docstring of matplotlib.patheffects.SimplePatchShadow:42",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patheffects.py:docstring of matplotlib.patheffects.TickedStroke:57",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patheffects.py:docstring of matplotlib.patheffects.withSimplePatchShadow:51",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patheffects.py:docstring of matplotlib.patheffects.withTickedStroke:56"
     ],
     "IPython.terminal.interactiveshell.TerminalInteractiveShell.inputhook": [
-      "doc/users/explain/figure/interactive_guide.rst:420"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\users/explain/figure/interactive_guide.rst:420"
     ],
     "_find_tails": [
-      "lib/matplotlib/quiver.py:docstring of matplotlib.quiver.Barbs:5"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\quiver.py:docstring of matplotlib.quiver.Barbs:9"
     ],
     "_make_barbs": [
-      "lib/matplotlib/quiver.py:docstring of matplotlib.quiver.Barbs:5"
-    ],
-    "get_matrix": [
-      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms:12"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\quiver.py:docstring of matplotlib.quiver.Barbs:9"
     ],
     "matplotlib.collections._CollectionWithSizes.set_sizes": [
-      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.barbs:171",
-      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.broken_barh:77",
-      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.fill_between:113",
-      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.fill_betweenx:113",
-      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.hexbin:201",
-      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.pcolor:173",
-      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.quiver:207",
-      "lib/matplotlib/collections.py:docstring of matplotlib.collections.AsteriskPolygonCollection:22",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.barbs:171",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.broken_barh:77",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.fill_between:113",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.fill_betweenx:113",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.hexbin:201",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.pcolor:173",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.quiver:207",
-      "lib/matplotlib/quiver.py:docstring of matplotlib.quiver.Barbs:205",
-      "lib/matplotlib/quiver.py:docstring of matplotlib.quiver.Barbs:38",
-      "lib/matplotlib/quiver.py:docstring of matplotlib.quiver.Quiver:244",
-      "lib/matplotlib/quiver.py:docstring of matplotlib.quiver.Quiver:38",
-      "lib/mpl_toolkits/mplot3d/art3d.py:docstring of mpl_toolkits.mplot3d.art3d.Path3DCollection:39",
-      "lib/mpl_toolkits/mplot3d/art3d.py:docstring of mpl_toolkits.mplot3d.art3d.Poly3DCollection:37"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes._axes.Axes.barbs:176",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes._axes.Axes.broken_barh:82",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes._axes.Axes.fill_between:118",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes._axes.Axes.fill_betweenx:118",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes._axes.Axes.hexbin:206",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes._axes.Axes.pcolor:178",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes._axes.Axes.quiver:212",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\collections.py:docstring of matplotlib.artist.AsteriskPolygonCollection.set:44",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\collections.py:docstring of matplotlib.artist.BrokenBarHCollection.set:44",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\collections.py:docstring of matplotlib.artist.CircleCollection.set:44",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\collections.py:docstring of matplotlib.artist.PathCollection.set:44",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\collections.py:docstring of matplotlib.artist.PolyCollection.set:44",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\collections.py:docstring of matplotlib.artist.PolyQuadMesh.set:44",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\collections.py:docstring of matplotlib.artist.RegularPolyCollection.set:44",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\collections.py:docstring of matplotlib.artist.StarPolygonCollection.set:44",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.barbs:176",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.broken_barh:82",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.fill_between:118",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.fill_betweenx:118",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.hexbin:206",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.pcolor:178",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.quiver:212",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\quiver.py:docstring of matplotlib.artist.Barbs.set:45",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\quiver.py:docstring of matplotlib.artist.Quiver.set:45",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\quiver.py:docstring of matplotlib.quiver.Barbs:209",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\quiver.py:docstring of matplotlib.quiver.Quiver:248",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\mplot3d\\art3d.py:docstring of matplotlib.artist.Path3DCollection.set:46",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\mplot3d\\art3d.py:docstring of matplotlib.artist.Poly3DCollection.set:44"
     ],
     "matplotlib.collections._MeshData.set_array": [
-      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.pcolormesh:155",
-      "lib/matplotlib/collections.py:docstring of matplotlib.collections.AsteriskPolygonCollection:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.pcolormesh:155"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes._axes.Axes.pcolormesh:160",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\collections.py:docstring of matplotlib.artist.PolyQuadMesh.set:17",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\collections.py:docstring of matplotlib.artist.QuadMesh.set:17",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.pcolormesh:160"
     ]
   },
   "py:obj": {
     "Artist.stale_callback": [
-      "doc/users/explain/figure/interactive_guide.rst:323"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\users/explain/figure/interactive_guide.rst:323"
     ],
     "Artist.sticky_edges": [
-      "doc/api/axes_api.rst:354:<autosummary>:1",
-      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes.Axes.use_sticky_edges:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/axes_api.rst:356:<autosummary>:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes.Axes.use_sticky_edges:2"
     ],
     "Axes.dataLim": [
-      "doc/api/axes_api.rst:293:<autosummary>:1",
-      "lib/matplotlib/axes/_base.py:docstring of matplotlib.axes._base._AxesBase.update_datalim:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/axes_api.rst:293:<autosummary>:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_base.py:docstring of matplotlib.axes._base._AxesBase.update_datalim:2"
     ],
     "AxesBase": [
-      "doc/api/axes_api.rst:446:<autosummary>:1",
-      "lib/matplotlib/axes/_base.py:docstring of matplotlib.axes._base._AxesBase.add_child_axes:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/axes_api.rst:448:<autosummary>:1",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_base.py:docstring of matplotlib.axes._base._AxesBase.add_child_axes:2"
     ],
     "Figure.stale_callback": [
-      "doc/users/explain/figure/interactive_guide.rst:333"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\users/explain/figure/interactive_guide.rst:333"
     ],
     "Glyph": [
-      "doc/gallery/misc/ftface_props.rst:28"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\gallery/misc/ftface_props.rst:28"
     ],
     "Image": [
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.gci:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.gci:4"
     ],
     "ImageComparisonFailure": [
-      "lib/matplotlib/testing/decorators.py:docstring of matplotlib.testing.decorators:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\testing\\decorators.py:docstring of matplotlib.testing.decorators.image_comparison:2"
     ],
     "Line2D.pick": [
-      "doc/users/explain/figure/event_handling.rst:568"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\users/explain/figure/event_handling.rst:568"
     ],
     "QuadContourSet.changed()": [
-      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.contour:147",
-      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.contourf:147",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.contour:147",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.contourf:147"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes._axes.Axes.contour:152",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes._axes.Axes.contourf:152",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.contour:152",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.contourf:152"
     ],
     "Rectangle.contains": [
-      "doc/users/explain/figure/event_handling.rst:280"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\users/explain/figure/event_handling.rst:280"
     ],
     "Size.from_any": [
-      "lib/mpl_toolkits/axes_grid1/axes_grid.py:docstring of mpl_toolkits.axes_grid1.axes_grid.ImageGrid:53",
-      "lib/mpl_toolkits/axisartist/axes_grid.py:docstring of mpl_toolkits.axisartist.axes_grid.ImageGrid:53"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axes_grid1\\axes_grid.py:docstring of mpl_toolkits.axes_grid1.axes_grid.ImageGrid:84",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axisartist\\axes_grid.py:docstring of mpl_toolkits.axisartist.axes_grid.ImageGrid:84"
     ],
     "Timer": [
-      "lib/matplotlib/backend_bases.py:docstring of matplotlib.backend_bases:1",
-      "lib/matplotlib/backend_bases.py:docstring of matplotlib.backend_bases:13"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backend_bases.py:docstring of matplotlib.backend_bases.FigureCanvasBase.new_timer:2",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backend_bases.py:docstring of matplotlib.backend_bases.TimerBase:14"
     ],
     "ToolContainer": [
-      "lib/matplotlib/backend_bases.py:docstring of matplotlib.backend_bases:1",
-      "lib/matplotlib/backend_bases.py:docstring of matplotlib.backend_bases:19"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backend_bases.py:docstring of matplotlib.backend_bases.ToolContainerBase.remove_toolitem:2",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backend_bases.py:docstring of matplotlib.backend_bases.ToolContainerBase:20"
     ],
     "_iter_collection": [
-      "lib/matplotlib/backend_bases.py:docstring of matplotlib.backend_bases:11",
-      "lib/matplotlib/backends/backend_pdf.py:docstring of matplotlib.backends.backend_pdf.FigureCanvasPdf:1",
-      "lib/matplotlib/backends/backend_ps.py:docstring of matplotlib.backends.backend_ps.FigureCanvasPS:1",
-      "lib/matplotlib/backends/backend_svg.py:docstring of matplotlib.backends.backend_svg.FigureCanvasSVG:1",
-      "lib/matplotlib/patheffects.py:docstring of matplotlib.patheffects.AbstractPathEffect:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backend_bases.py:docstring of matplotlib.backend_bases.RendererBase.draw_path_collection:15",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backends\\backend_pdf.py:docstring of matplotlib.backends.backend_pdf.RendererPdf.draw_path_collection:15",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backends\\backend_ps.py:docstring of matplotlib.backends.backend_ps.RendererPS.draw_path_collection:15",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backends\\backend_svg.py:docstring of matplotlib.backends.backend_svg.RendererSVG.draw_path_collection:15",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patheffects.py:docstring of matplotlib.patheffects.PathEffectRenderer.draw_path_collection:15"
     ],
     "_iter_collection_raw_paths": [
-      "lib/matplotlib/backend_bases.py:docstring of matplotlib.backend_bases:11",
-      "lib/matplotlib/backends/backend_pdf.py:docstring of matplotlib.backends.backend_pdf.FigureCanvasPdf:1",
-      "lib/matplotlib/backends/backend_ps.py:docstring of matplotlib.backends.backend_ps.FigureCanvasPS:1",
-      "lib/matplotlib/backends/backend_svg.py:docstring of matplotlib.backends.backend_svg.FigureCanvasSVG:1",
-      "lib/matplotlib/patheffects.py:docstring of matplotlib.patheffects.AbstractPathEffect:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backend_bases.py:docstring of matplotlib.backend_bases.RendererBase.draw_path_collection:15",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backends\\backend_pdf.py:docstring of matplotlib.backends.backend_pdf.RendererPdf.draw_path_collection:15",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backends\\backend_ps.py:docstring of matplotlib.backends.backend_ps.RendererPS.draw_path_collection:15",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backends\\backend_svg.py:docstring of matplotlib.backends.backend_svg.RendererSVG.draw_path_collection:15",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patheffects.py:docstring of matplotlib.patheffects.PathEffectRenderer.draw_path_collection:15"
     ],
     "_read": [
-      "lib/matplotlib/dviread.py:docstring of matplotlib.dviread:19"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\dviread.py:docstring of matplotlib.dviread.Vf:20"
     ],
     "active": [
-      "lib/matplotlib/widgets.py:docstring of matplotlib.widgets.AxesWidget:15"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\widgets.py:docstring of matplotlib.widgets.AxesWidget:34"
     ],
     "ax.transAxes": [
-      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.indicate_inset:14",
-      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.inset_axes:6"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes._axes.Axes.indicate_inset:19",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes._axes.Axes.inset_axes:11"
     ],
     "axes.bbox": [
-      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.legend:136",
-      "lib/matplotlib/figure.py:docstring of matplotlib.figure.Figure:69",
-      "lib/matplotlib/legend.py:docstring of matplotlib.legend.Legend:3",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.figlegend:140",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.legend:136"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes._axes.Axes.legend:144",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\figure.py:docstring of matplotlib.figure.FigureBase.legend:145",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\legend.py:docstring of matplotlib.legend.Legend:97",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.figlegend:145",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.legend:144"
     ],
     "can_composite": [
-      "lib/matplotlib/image.py:docstring of matplotlib.image:5"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\image.py:docstring of matplotlib.image.composite_images:9"
     ],
     "converter": [
-      "lib/matplotlib/testing/compare.py:docstring of matplotlib.testing.compare:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\testing\\compare.py:docstring of matplotlib.testing.compare.compare_images:4"
     ],
     "draw_image": [
-      "lib/matplotlib/backends/backend_agg.py:docstring of matplotlib.backends.backend_agg:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backends\\backend_agg.py:docstring of matplotlib.backends.backend_agg.RendererAgg.option_scale_image:2"
     ],
     "figure.bbox": [
-      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.legend:136",
-      "lib/matplotlib/figure.py:docstring of matplotlib.figure.Figure:69",
-      "lib/matplotlib/legend.py:docstring of matplotlib.legend.Legend:3",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.figlegend:140",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.legend:136"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes._axes.Axes.legend:144",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\figure.py:docstring of matplotlib.figure.FigureBase.legend:145",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\legend.py:docstring of matplotlib.legend.Legend:97",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.figlegend:145",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.legend:144"
     ],
     "fmt_xdata": [
-      "lib/matplotlib/axes/_base.py:docstring of matplotlib.axes._base._AxesBase.format_xdata:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_base.py:docstring of matplotlib.axes._base._AxesBase.format_xdata:4"
     ],
     "fmt_ydata": [
-      "lib/matplotlib/axes/_base.py:docstring of matplotlib.axes._base._AxesBase.format_ydata:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_base.py:docstring of matplotlib.axes._base._AxesBase.format_ydata:4"
     ],
     "get_size": [
-      "lib/mpl_toolkits/axes_grid1/axes_size.py:docstring of mpl_toolkits.axes_grid1.axes_size:1"
-    ],
-    "get_xbound": [
-      "lib/mpl_toolkits/mplot3d/axes3d.py:docstring of mpl_toolkits.mplot3d.axes3d.Axes3D.get_xlim:17"
-    ],
-    "get_ybound": [
-      "lib/mpl_toolkits/mplot3d/axes3d.py:docstring of mpl_toolkits.mplot3d.axes3d.Axes3D.get_ylim:17"
-    ],
-    "invert_xaxis": [
-      "lib/mpl_toolkits/mplot3d/axes3d.py:docstring of mpl_toolkits.mplot3d.axes3d.Axes3D.get_xlim:19"
-    ],
-    "invert_yaxis": [
-      "lib/mpl_toolkits/mplot3d/axes3d.py:docstring of mpl_toolkits.mplot3d.axes3d.Axes3D.get_ylim:19"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axes_grid1\\axes_size.py:docstring of mpl_toolkits.axes_grid1.axes_size:1"
     ],
     "ipykernel.pylab.backend_inline": [
-      "doc/users/explain/figure/interactive.rst:264"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\users/explain/figure/interactive.rst:340"
     ],
     "kde.covariance_factor": [
-      "lib/matplotlib/mlab.py:docstring of matplotlib.mlab:40"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\mlab.py:docstring of matplotlib.mlab.GaussianKDE:41"
     ],
     "kde.factor": [
-      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.violinplot:41",
-      "lib/matplotlib/mlab.py:docstring of matplotlib.mlab:11",
-      "lib/matplotlib/mlab.py:docstring of matplotlib.mlab:44",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.violinplot:41"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes._axes.Axes.violinplot:46",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\mlab.py:docstring of matplotlib.mlab.GaussianKDE:12",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\mlab.py:docstring of matplotlib.mlab.GaussianKDE:45",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.violinplot:46"
     ],
     "make_image": [
-      "lib/matplotlib/image.py:docstring of matplotlib.image:5"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\image.py:docstring of matplotlib.image.composite_images:9"
     ],
     "matplotlib.animation.ArtistAnimation.new_frame_seq": [
-      "doc/api/_as_gen/matplotlib.animation.ArtistAnimation.rst:28:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ArtistAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.ArtistAnimation.new_saved_frame_seq": [
-      "doc/api/_as_gen/matplotlib.animation.ArtistAnimation.rst:28:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ArtistAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.ArtistAnimation.pause": [
-      "doc/api/_as_gen/matplotlib.animation.ArtistAnimation.rst:28:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ArtistAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.ArtistAnimation.repeat": [
-      "doc/api/_as_gen/matplotlib.animation.ArtistAnimation.rst:33:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ArtistAnimation.rst:33:<autosummary>:1"
     ],
     "matplotlib.animation.ArtistAnimation.resume": [
-      "doc/api/_as_gen/matplotlib.animation.ArtistAnimation.rst:28:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ArtistAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.ArtistAnimation.save": [
-      "doc/api/_as_gen/matplotlib.animation.ArtistAnimation.rst:28:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ArtistAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.ArtistAnimation.to_html5_video": [
-      "doc/api/_as_gen/matplotlib.animation.ArtistAnimation.rst:28:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ArtistAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.ArtistAnimation.to_jshtml": [
-      "doc/api/_as_gen/matplotlib.animation.ArtistAnimation.rst:28:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ArtistAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegFileWriter.bin_path": [
-      "doc/api/_as_gen/matplotlib.animation.FFMpegFileWriter.rst:27:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FFMpegFileWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegFileWriter.finish": [
-      "doc/api/_as_gen/matplotlib.animation.FFMpegFileWriter.rst:27:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FFMpegFileWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegFileWriter.frame_format": [
-      "lib/matplotlib/animation.py:docstring of matplotlib.animation.FFMpegFileWriter.supported_formats:1:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\animation.py:docstring of matplotlib.animation.FFMpegFileWriter.supported_formats:1:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegFileWriter.frame_size": [
-      "lib/matplotlib/animation.py:docstring of matplotlib.animation.FFMpegFileWriter.supported_formats:1:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\animation.py:docstring of matplotlib.animation.FFMpegFileWriter.supported_formats:1:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegFileWriter.grab_frame": [
-      "doc/api/_as_gen/matplotlib.animation.FFMpegFileWriter.rst:27:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FFMpegFileWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegFileWriter.isAvailable": [
-      "doc/api/_as_gen/matplotlib.animation.FFMpegFileWriter.rst:27:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FFMpegFileWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegFileWriter.output_args": [
-      "lib/matplotlib/animation.py:docstring of matplotlib.animation.FFMpegFileWriter.supported_formats:1:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\animation.py:docstring of matplotlib.animation.FFMpegFileWriter.supported_formats:1:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegFileWriter.saving": [
-      "doc/api/_as_gen/matplotlib.animation.FFMpegFileWriter.rst:27:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FFMpegFileWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegFileWriter.setup": [
-      "doc/api/_as_gen/matplotlib.animation.FFMpegFileWriter.rst:27:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FFMpegFileWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegWriter.bin_path": [
-      "doc/api/_as_gen/matplotlib.animation.FFMpegWriter.rst:27:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FFMpegWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegWriter.finish": [
-      "doc/api/_as_gen/matplotlib.animation.FFMpegWriter.rst:27:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FFMpegWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegWriter.frame_size": [
-      "doc/api/_as_gen/matplotlib.animation.FFMpegWriter.rst:34:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FFMpegWriter.rst:34:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegWriter.grab_frame": [
-      "doc/api/_as_gen/matplotlib.animation.FFMpegWriter.rst:27:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FFMpegWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegWriter.isAvailable": [
-      "doc/api/_as_gen/matplotlib.animation.FFMpegWriter.rst:27:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FFMpegWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegWriter.output_args": [
-      "doc/api/_as_gen/matplotlib.animation.FFMpegWriter.rst:34:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FFMpegWriter.rst:34:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegWriter.saving": [
-      "doc/api/_as_gen/matplotlib.animation.FFMpegWriter.rst:27:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FFMpegWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegWriter.setup": [
-      "doc/api/_as_gen/matplotlib.animation.FFMpegWriter.rst:27:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FFMpegWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegWriter.supported_formats": [
-      "doc/api/_as_gen/matplotlib.animation.FFMpegWriter.rst:34:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FFMpegWriter.rst:34:<autosummary>:1"
     ],
     "matplotlib.animation.FileMovieWriter.bin_path": [
-      "doc/api/_as_gen/matplotlib.animation.FileMovieWriter.rst:27:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FileMovieWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.FileMovieWriter.frame_size": [
-      "lib/matplotlib/animation.py:docstring of matplotlib.animation.FileMovieWriter.finish:1:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\animation.py:docstring of matplotlib.animation.FileMovieWriter.finish:1:<autosummary>:1"
     ],
     "matplotlib.animation.FileMovieWriter.isAvailable": [
-      "doc/api/_as_gen/matplotlib.animation.FileMovieWriter.rst:27:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FileMovieWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.FileMovieWriter.saving": [
-      "doc/api/_as_gen/matplotlib.animation.FileMovieWriter.rst:27:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FileMovieWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.FileMovieWriter.supported_formats": [
-      "lib/matplotlib/animation.py:docstring of matplotlib.animation.FileMovieWriter.finish:1:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\animation.py:docstring of matplotlib.animation.FileMovieWriter.finish:1:<autosummary>:1"
     ],
     "matplotlib.animation.FuncAnimation.pause": [
-      "doc/api/_as_gen/matplotlib.animation.FuncAnimation.rst:28:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FuncAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.FuncAnimation.repeat": [
-      "lib/matplotlib/animation.py:docstring of matplotlib.animation.FuncAnimation.new_frame_seq:1:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\animation.py:docstring of matplotlib.animation.FuncAnimation.new_frame_seq:1:<autosummary>:1"
     ],
     "matplotlib.animation.FuncAnimation.resume": [
-      "doc/api/_as_gen/matplotlib.animation.FuncAnimation.rst:28:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FuncAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.FuncAnimation.save": [
-      "doc/api/_as_gen/matplotlib.animation.FuncAnimation.rst:28:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FuncAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.FuncAnimation.to_html5_video": [
-      "doc/api/_as_gen/matplotlib.animation.FuncAnimation.rst:28:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FuncAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.FuncAnimation.to_jshtml": [
-      "doc/api/_as_gen/matplotlib.animation.FuncAnimation.rst:28:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FuncAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.HTMLWriter.bin_path": [
-      "doc/api/_as_gen/matplotlib.animation.HTMLWriter.rst:27:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.HTMLWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.HTMLWriter.frame_format": [
-      "lib/matplotlib/animation.py:docstring of matplotlib.animation.HTMLWriter.finish:1:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\animation.py:docstring of matplotlib.animation.HTMLWriter.finish:1:<autosummary>:1"
     ],
     "matplotlib.animation.HTMLWriter.frame_size": [
-      "lib/matplotlib/animation.py:docstring of matplotlib.animation.HTMLWriter.finish:1:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\animation.py:docstring of matplotlib.animation.HTMLWriter.finish:1:<autosummary>:1"
     ],
     "matplotlib.animation.HTMLWriter.saving": [
-      "doc/api/_as_gen/matplotlib.animation.HTMLWriter.rst:27:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.HTMLWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.ImageMagickFileWriter.bin_path": [
-      "doc/api/_as_gen/matplotlib.animation.ImageMagickFileWriter.rst:27:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ImageMagickFileWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.ImageMagickFileWriter.finish": [
-      "doc/api/_as_gen/matplotlib.animation.ImageMagickFileWriter.rst:27:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ImageMagickFileWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.ImageMagickFileWriter.frame_format": [
-      "lib/matplotlib/animation.py:docstring of matplotlib.animation.ImageMagickFileWriter.input_names:1:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\animation.py:docstring of matplotlib.animation.ImageMagickFileWriter.input_names:1:<autosummary>:1"
     ],
     "matplotlib.animation.ImageMagickFileWriter.frame_size": [
-      "lib/matplotlib/animation.py:docstring of matplotlib.animation.ImageMagickFileWriter.input_names:1:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\animation.py:docstring of matplotlib.animation.ImageMagickFileWriter.input_names:1:<autosummary>:1"
     ],
     "matplotlib.animation.ImageMagickFileWriter.grab_frame": [
-      "doc/api/_as_gen/matplotlib.animation.ImageMagickFileWriter.rst:27:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ImageMagickFileWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.ImageMagickFileWriter.isAvailable": [
-      "doc/api/_as_gen/matplotlib.animation.ImageMagickFileWriter.rst:27:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ImageMagickFileWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.ImageMagickFileWriter.saving": [
-      "doc/api/_as_gen/matplotlib.animation.ImageMagickFileWriter.rst:27:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ImageMagickFileWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.ImageMagickFileWriter.setup": [
-      "doc/api/_as_gen/matplotlib.animation.ImageMagickFileWriter.rst:27:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ImageMagickFileWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.ImageMagickWriter.bin_path": [
-      "doc/api/_as_gen/matplotlib.animation.ImageMagickWriter.rst:27:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ImageMagickWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.ImageMagickWriter.finish": [
-      "doc/api/_as_gen/matplotlib.animation.ImageMagickWriter.rst:27:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ImageMagickWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.ImageMagickWriter.frame_size": [
-      "lib/matplotlib/animation.py:docstring of matplotlib.animation.ImageMagickWriter.input_names:1:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\animation.py:docstring of matplotlib.animation.ImageMagickWriter.input_names:1:<autosummary>:1"
     ],
     "matplotlib.animation.ImageMagickWriter.grab_frame": [
-      "doc/api/_as_gen/matplotlib.animation.ImageMagickWriter.rst:27:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ImageMagickWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.ImageMagickWriter.isAvailable": [
-      "doc/api/_as_gen/matplotlib.animation.ImageMagickWriter.rst:27:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ImageMagickWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.ImageMagickWriter.saving": [
-      "doc/api/_as_gen/matplotlib.animation.ImageMagickWriter.rst:27:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ImageMagickWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.ImageMagickWriter.setup": [
-      "doc/api/_as_gen/matplotlib.animation.ImageMagickWriter.rst:27:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ImageMagickWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.ImageMagickWriter.supported_formats": [
-      "lib/matplotlib/animation.py:docstring of matplotlib.animation.ImageMagickWriter.input_names:1:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\animation.py:docstring of matplotlib.animation.ImageMagickWriter.input_names:1:<autosummary>:1"
     ],
     "matplotlib.animation.MovieWriter.frame_size": [
-      "lib/matplotlib/animation.py:docstring of matplotlib.animation.MovieWriter.bin_path:1:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\animation.py:docstring of matplotlib.animation.MovieWriter.bin_path:1:<autosummary>:1"
     ],
     "matplotlib.animation.MovieWriter.saving": [
-      "doc/api/_as_gen/matplotlib.animation.MovieWriter.rst:27:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.MovieWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.PillowWriter.frame_size": [
-      "lib/matplotlib/animation.py:docstring of matplotlib.animation.PillowWriter.finish:1:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\animation.py:docstring of matplotlib.animation.PillowWriter.finish:1:<autosummary>:1"
     ],
     "matplotlib.animation.PillowWriter.saving": [
-      "doc/api/_as_gen/matplotlib.animation.PillowWriter.rst:26:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.PillowWriter.rst:26:<autosummary>:1"
     ],
     "matplotlib.animation.TimedAnimation.new_frame_seq": [
-      "doc/api/_as_gen/matplotlib.animation.TimedAnimation.rst:28:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.TimedAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.TimedAnimation.new_saved_frame_seq": [
-      "doc/api/_as_gen/matplotlib.animation.TimedAnimation.rst:28:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.TimedAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.TimedAnimation.pause": [
-      "doc/api/_as_gen/matplotlib.animation.TimedAnimation.rst:28:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.TimedAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.TimedAnimation.resume": [
-      "doc/api/_as_gen/matplotlib.animation.TimedAnimation.rst:28:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.TimedAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.TimedAnimation.save": [
-      "doc/api/_as_gen/matplotlib.animation.TimedAnimation.rst:28:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.TimedAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.TimedAnimation.to_html5_video": [
-      "doc/api/_as_gen/matplotlib.animation.TimedAnimation.rst:28:<autosummary>:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.TimedAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.TimedAnimation.to_jshtml": [
       "doc/api/_as_gen/matplotlib.animation.TimedAnimation.rst:28:<autosummary>:1"
@@ -708,40 +734,31 @@
       "doc/docstring of builtins.list:17"
     ],
     "mpl_toolkits.axislines.Axes": [
-      "lib/mpl_toolkits/axisartist/axis_artist.py:docstring of mpl_toolkits.axisartist.axis_artist:7"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axisartist\\axis_artist.py:docstring of mpl_toolkits.axisartist.axis_artist:7"
     ],
     "next_whats_new": [
-      "doc/users/next_whats_new/README.rst:6"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\users/next_whats_new/README.rst:6"
     ],
     "option_scale_image": [
-      "lib/matplotlib/backends/backend_cairo.py:docstring of matplotlib.backends.backend_cairo.FigureCanvasCairo:1",
-      "lib/matplotlib/backends/backend_pdf.py:docstring of matplotlib.backends.backend_pdf.FigureCanvasPdf:1",
-      "lib/matplotlib/backends/backend_ps.py:docstring of matplotlib.backends.backend_ps.FigureCanvasPS:2",
-      "lib/matplotlib/backends/backend_template.py:docstring of matplotlib.backends.backend_template:18"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backends\\backend_cairo.py:docstring of matplotlib.backends.backend_cairo.RendererCairo.draw_image:22",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backends\\backend_pdf.py:docstring of matplotlib.backends.backend_pdf.RendererPdf.draw_image:22",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backends\\backend_ps.py:docstring of matplotlib.backends.backend_ps.RendererPS.draw_image:22",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backends\\backend_template.py:docstring of matplotlib.backends.backend_template.RendererTemplate.draw_image:22"
     ],
     "print_xyz": [
-      "lib/matplotlib/backends/backend_template.py:docstring of matplotlib.backends.backend_template:22"
-    ],
-    "set_xbound": [
-      "lib/mpl_toolkits/mplot3d/axes3d.py:docstring of mpl_toolkits.mplot3d.axes3d.Axes3D.get_xlim:17"
-    ],
-    "set_ybound": [
-      "lib/mpl_toolkits/mplot3d/axes3d.py:docstring of mpl_toolkits.mplot3d.axes3d.Axes3D.get_ylim:17"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backends\\backend_template.py:docstring of matplotlib.backends.backend_template:22"
     ],
     "toggled": [
-      "lib/matplotlib/backend_tools.py:docstring of matplotlib.backend_tools:1"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backend_tools.py:docstring of matplotlib.backend_tools.AxisScaleBase.disable:4",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backend_tools.py:docstring of matplotlib.backend_tools.AxisScaleBase.enable:4",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backend_tools.py:docstring of matplotlib.backend_tools.AxisScaleBase.trigger:2",
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backend_tools.py:docstring of matplotlib.backend_tools.ZoomPanBase.trigger:2"
     ],
     "tool_removed_event": [
-      "lib/matplotlib/backend_bases.py:docstring of matplotlib.backend_bases:2"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backend_bases.py:docstring of matplotlib.backend_bases.ToolContainerBase.remove_toolitem:6"
     ],
     "whats_new.rst": [
-      "doc/users/next_whats_new/README.rst:6"
-    ],
-    "xaxis_inverted": [
-      "lib/mpl_toolkits/mplot3d/axes3d.py:docstring of mpl_toolkits.mplot3d.axes3d.Axes3D.get_xlim:19"
-    ],
-    "yaxis_inverted": [
-      "lib/mpl_toolkits/mplot3d/axes3d.py:docstring of mpl_toolkits.mplot3d.axes3d.Axes3D.get_ylim:19"
+      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\users/next_whats_new/README.rst:6"
     ]
   }
 }
diff --git a/doc/users/faq/howto_faq.rst b/doc/users/faq.rst
similarity index 75%
rename from doc/users/faq/howto_faq.rst
rename to doc/users/faq.rst
index f43494ff4f12..46084ec4c6c6 100644
--- a/doc/users/faq/howto_faq.rst
+++ b/doc/users/faq.rst
@@ -1,14 +1,12 @@
 .. _howto-faq:
 
 .. redirect-from:: /faq/howto_faq
+.. redirect-from:: /users/faq/howto_faq
+.. redirect-from:: /faq/index
 
-******
-How-to
-******
-
-.. contents::
-   :backlinks: none
-
+==========================
+Frequently Asked Questions
+==========================
 
 .. _how-to-too-many-ticks:
 
@@ -199,14 +197,8 @@ different scales, you can often get ylabels that do not align
 vertically across the multiple subplots, which can be unattractive.
 By default, Matplotlib positions the x location of the ylabel so that
 it does not overlap any of the y ticks.  You can override this default
-behavior by specifying the coordinates of the label.  The example
-below shows the default behavior in the left subplots, and the manual
-setting in the right subplots.
-
-.. figure:: ../../gallery/text_labels_and_annotations/images/sphx_glr_align_ylabels_001.png
-   :target: ../../gallery/text_labels_and_annotations/align_ylabels.html
-   :align: center
-   :scale: 50
+behavior by specifying the coordinates of the label. To learn how, see
+:doc:`/gallery/text_labels_and_annotations/align_ylabels`
 
 .. _howto-set-zorder:
 
@@ -307,3 +299,79 @@ artists.
 You may be able to work on separate figures from separate threads.  However,
 you must in that case use a *non-interactive backend* (typically Agg), because
 most GUI backends *require* being run from the main thread as well.
+
+.. _reporting-problems:
+
+Get help
+--------
+
+There are a number of good resources for getting help with Matplotlib.
+There is a good chance your question has already been asked:
+
+- The `mailing list archive
+  <https://discourse.matplotlib.org/c/community/matplotlib-users/6>`_.
+
+- `GitHub issues <https://github.com/matplotlib/matplotlib/issues>`_.
+
+- Stackoverflow questions tagged `matplotlib
+  <https://stackoverflow.com/questions/tagged/matplotlib>`_.
+
+If you are unable to find an answer to your question through search, please
+provide the following information in your e-mail to the `mailing list
+<https://mail.python.org/mailman/listinfo/matplotlib-users>`_:
+
+* Your operating system (Linux/Unix users: post the output of ``uname -a``).
+
+* Matplotlib version::
+
+     python -c "import matplotlib; print(matplotlib.__version__)"
+
+* Where you obtained Matplotlib (e.g., your Linux distribution's packages,
+  GitHub, PyPI, or `Anaconda <https://www.anaconda.com/>`_).
+
+* Any customizations to your ``matplotlibrc`` file (see
+  :ref:`customizing`).
+
+* If the problem is reproducible, please try to provide a *minimal*, standalone
+  Python script that demonstrates the problem.  This is *the* critical step.
+  If you can't post a piece of code that we can run and reproduce your error,
+  the chances of getting help are significantly diminished.  Very often, the
+  mere act of trying to minimize your code to the smallest bit that produces
+  the error will help you find a bug in *your* code that is causing the
+  problem.
+
+* Matplotlib provides debugging information through the `logging` library, and
+  a helper function to set the logging level: one can call ::
+
+    plt.set_loglevel("info")  # or "debug" for more info
+
+  to obtain this debugging information.
+
+  Standard functions from the `logging` module are also applicable; e.g. one
+  could call ``logging.basicConfig(level="DEBUG")`` even before importing
+  Matplotlib (this is in particular necessary to get the logging info emitted
+  during Matplotlib's import), or attach a custom handler to the "matplotlib"
+  logger.  This may be useful if you use a custom logging configuration.
+
+If you compiled Matplotlib yourself, please also provide:
+
+* any changes you have made to ``setup.py`` or ``setupext.py``.
+* the output of::
+
+     rm -rf build
+     python setup.py build
+
+  The beginning of the build output contains lots of details about your
+  platform that are useful for the Matplotlib developers to diagnose your
+  problem.
+
+* your compiler version -- e.g., ``gcc --version``.
+
+Including this information in your first e-mail to the mailing list
+will save a lot of time.
+
+You will likely get a faster response writing to the mailing list than
+filing a bug in the bug tracker.  Most developers check the bug
+tracker only periodically.  If your problem has been determined to be
+a bug and cannot be quickly solved, you may be asked to file a bug in
+the tracker so the issue doesn't get lost.
diff --git a/doc/users/faq/index.rst b/doc/users/faq/index.rst
deleted file mode 100644
index 636c90904aba..000000000000
--- a/doc/users/faq/index.rst
+++ /dev/null
@@ -1,21 +0,0 @@
-.. _faq-index:
-
-.. redirect-from:: /faq/index
-
-##########################
-How-to and troubleshooting
-##########################
-
-.. only:: html
-
-   :Release: |version|
-   :Date: |today|
-
-   Frequently asked questions about Matplotlib:
-
-.. toctree::
-   :maxdepth: 2
-
-   howto_faq.rst
-   troubleshooting_faq.rst
-   environment_variables_faq.rst
diff --git a/doc/users/faq/troubleshooting_faq.rst b/doc/users/faq/troubleshooting_faq.rst
deleted file mode 100644
index 851e18d1664d..000000000000
--- a/doc/users/faq/troubleshooting_faq.rst
+++ /dev/null
@@ -1,177 +0,0 @@
-.. _troubleshooting-faq:
-
-.. redirect-from:: /faq/troubleshooting_faq
-
-***************
-Troubleshooting
-***************
-
-.. contents::
-   :backlinks: none
-
-.. _matplotlib-version:
-
-Obtaining Matplotlib version
-============================
-
-To find out your Matplotlib version number, import it and print the
-``__version__`` attribute::
-
-    >>> import matplotlib
-    >>> matplotlib.__version__
-    '0.98.0'
-
-
-.. _locating-matplotlib-install:
-
-:file:`matplotlib` install location
-===================================
-
-You can find what directory Matplotlib is installed in by importing it
-and printing the ``__file__`` attribute::
-
-    >>> import matplotlib
-    >>> matplotlib.__file__
-    '/home/jdhunter/dev/lib64/python2.5/site-packages/matplotlib/__init__.pyc'
-
-.. _locating-matplotlib-config-dir:
-
-:file:`matplotlib` configuration and cache directory locations
-==============================================================
-
-Each user has a Matplotlib configuration directory which may contain a
-:ref:`matplotlibrc <customizing-with-matplotlibrc-files>` file. To
-locate your :file:`matplotlib/` configuration directory, use
-:func:`matplotlib.get_configdir`::
-
-    >>> import matplotlib as mpl
-    >>> mpl.get_configdir()
-    '/home/darren/.config/matplotlib'
-
-On Unix-like systems, this directory is generally located in your
-:envvar:`HOME` directory under the :file:`.config/` directory.
-
-In addition, users have a cache directory. On Unix-like systems, this is
-separate from the configuration directory by default. To locate your
-:file:`.cache/` directory, use :func:`matplotlib.get_cachedir`::
-
-    >>> import matplotlib as mpl
-    >>> mpl.get_cachedir()
-    '/home/darren/.cache/matplotlib'
-
-On Windows, both the config directory and the cache directory are
-the same and are in your :file:`Documents and Settings` or :file:`Users`
-directory by default::
-
-    >>> import matplotlib as mpl
-    >>> mpl.get_configdir()
-    'C:\\Documents and Settings\\jdhunter\\.matplotlib'
-    >>> mpl.get_cachedir()
-    'C:\\Documents and Settings\\jdhunter\\.matplotlib'
-
-If you would like to use a different configuration directory, you can
-do so by specifying the location in your :envvar:`MPLCONFIGDIR`
-environment variable -- see
-:ref:`setting-linux-osx-environment-variables`.  Note that
-:envvar:`MPLCONFIGDIR` sets the location of both the configuration
-directory and the cache directory.
-
-.. _reporting-problems:
-
-Getting help
-============
-
-There are a number of good resources for getting help with Matplotlib.
-There is a good chance your question has already been asked:
-
-- The `mailing list archive
-  <https://discourse.matplotlib.org/c/community/matplotlib-users/6>`_.
-
-- `GitHub issues <https://github.com/matplotlib/matplotlib/issues>`_.
-
-- Stackoverflow questions tagged `matplotlib
-  <https://stackoverflow.com/questions/tagged/matplotlib>`_.
-
-If you are unable to find an answer to your question through search, please
-provide the following information in your e-mail to the `mailing list
-<https://mail.python.org/mailman/listinfo/matplotlib-users>`_:
-
-* Your operating system (Linux/Unix users: post the output of ``uname -a``).
-
-* Matplotlib version::
-
-     python -c "import matplotlib; print(matplotlib.__version__)"
-
-* Where you obtained Matplotlib (e.g., your Linux distribution's packages,
-  GitHub, PyPI, or `Anaconda <https://www.anaconda.com/>`_).
-
-* Any customizations to your ``matplotlibrc`` file (see
-  :ref:`customizing`).
-
-* If the problem is reproducible, please try to provide a *minimal*, standalone
-  Python script that demonstrates the problem.  This is *the* critical step.
-  If you can't post a piece of code that we can run and reproduce your error,
-  the chances of getting help are significantly diminished.  Very often, the
-  mere act of trying to minimize your code to the smallest bit that produces
-  the error will help you find a bug in *your* code that is causing the
-  problem.
-
-* Matplotlib provides debugging information through the `logging` library, and
-  a helper function to set the logging level: one can call ::
-
-    plt.set_loglevel("info")  # or "debug" for more info
-
-  to obtain this debugging information.
-
-  Standard functions from the `logging` module are also applicable; e.g. one
-  could call ``logging.basicConfig(level="DEBUG")`` even before importing
-  Matplotlib (this is in particular necessary to get the logging info emitted
-  during Matplotlib's import), or attach a custom handler to the "matplotlib"
-  logger.  This may be useful if you use a custom logging configuration.
-
-If you compiled Matplotlib yourself, please also provide:
-
-* any changes you have made to ``setup.py`` or ``setupext.py``.
-* the output of::
-
-     rm -rf build
-     python setup.py build
-
-  The beginning of the build output contains lots of details about your
-  platform that are useful for the Matplotlib developers to diagnose your
-  problem.
-
-* your compiler version -- e.g., ``gcc --version``.
-
-Including this information in your first e-mail to the mailing list
-will save a lot of time.
-
-You will likely get a faster response writing to the mailing list than
-filing a bug in the bug tracker.  Most developers check the bug
-tracker only periodically.  If your problem has been determined to be
-a bug and cannot be quickly solved, you may be asked to file a bug in
-the tracker so the issue doesn't get lost.
-
-.. _git-trouble:
-
-Problems with recent git versions
-=================================
-
-First, make sure you have a clean build and install (see :ref:`clean-install`),
-get the latest git update, install it and run a simple test script in debug
-mode::
-
-    rm -rf /path/to/site-packages/matplotlib*
-    git clean -xdf
-    git pull
-    python -m pip install -v . > build.out
-    python -c "from pylab import *; set_loglevel('debug'); plot(); show()" > run.out
-
-and post :file:`build.out` and :file:`run.out` to the `matplotlib-devel
-<https://mail.python.org/mailman/listinfo/matplotlib-devel>`_
-mailing list (please do not post git problems to the `users list
-<https://mail.python.org/mailman/listinfo/matplotlib-users>`_).
-
-Of course, you will want to clearly describe your problem, what you
-are expecting and what you are getting, but often a clean build and
-install will help.  See also :ref:`reporting-problems`.
diff --git a/doc/users/index.rst b/doc/users/index.rst
index 8081b353aeb5..64317fd61607 100644
--- a/doc/users/index.rst
+++ b/doc/users/index.rst
@@ -19,6 +19,11 @@ Using Matplotlib
 
             explain/quick_start
 
+        .. toctree::
+            :maxdepth: 1
+
+            faq.rst
+
     .. grid-item-card::
         :padding: 2
 
@@ -92,6 +97,7 @@ Using Matplotlib
 
             explain/toolkits/index
 
+
 .. toctree::
     :hidden:
 
diff --git a/doc/users/faq/environment_variables_faq.rst b/doc/users/installing/environment_variables_faq.rst
similarity index 95%
rename from doc/users/faq/environment_variables_faq.rst
rename to doc/users/installing/environment_variables_faq.rst
index fb9341db1147..e7a721026743 100644
--- a/doc/users/faq/environment_variables_faq.rst
+++ b/doc/users/installing/environment_variables_faq.rst
@@ -1,13 +1,12 @@
 .. _environment-variables:
 
-.. redirect-from:: /faq/environment_variables_faq
 
-*********************
-Environment variables
-*********************
+.. redirect-from:: /faq/installing_faq
+.. redirect-from:: /users/faq/installing_faq
 
-.. contents::
-   :backlinks: none
+=====================
+Environment variables
+=====================
 
 .. envvar:: HOME
 
diff --git a/doc/users/installing/index.rst b/doc/users/installing/index.rst
index 0a95d2088ce4..c8c9ba549775 100644
--- a/doc/users/installing/index.rst
+++ b/doc/users/installing/index.rst
@@ -1,12 +1,12 @@
 .. redirect-from:: /users/installing
 
-############
+============
 Installation
-############
+============
 
-==============================
-Installing an official release
-==============================
+
+Install an official release
+===========================
 
 Matplotlib releases are available as wheel packages for macOS, Windows and
 Linux on `PyPI <https://pypi.org/project/matplotlib/>`_. Install it using
@@ -33,14 +33,15 @@ precompiled wheel for your OS and Python.
    animations and a larger selection of file formats, you can
    install :ref:`optional_dependencies`.
 
-=========================
+
 Third-party distributions
 =========================
 
 Various third-parties provide Matplotlib for their environments.
 
 Conda packages
-==============
+--------------
+
 Matplotlib is available both via the *anaconda main channel*
 
 .. code-block:: sh
@@ -54,7 +55,7 @@ as well as via the *conda-forge community channel*
    conda install -c conda-forge matplotlib
 
 Python distributions
-====================
+--------------------
 
 Matplotlib is part of major Python distributions:
 
@@ -66,7 +67,7 @@ Matplotlib is part of major Python distributions:
 - `WinPython <https://winpython.github.io/>`_
 
 Linux package manager
-=====================
+---------------------
 
 If you are using the Python version that comes with your Linux distribution,
 you can install Matplotlib via your package manager, e.g.:
@@ -80,9 +81,8 @@ you can install Matplotlib via your package manager, e.g.:
 
 .. _install_from_source:
 
-==========================
-Installing a nightly build
-==========================
+Install a nightly build
+=======================
 
 Matplotlib makes nightly development build wheels available on the
 `scientific-python-nightly-wheels Anaconda Cloud organization
@@ -99,82 +99,30 @@ scientific-python-nightly-wheels as the package index to query:
     --extra-index-url https://pypi.org/simple \
     matplotlib
 
-======================
-Installing from source
-======================
-
-If you are interested in contributing to Matplotlib development,
-running the latest source code, or just like to build everything
-yourself, it is not difficult to build Matplotlib from source.
-
-First you need to install the :ref:`dependencies`.
-
-A C compiler is required.  Typically, on Linux, you will need ``gcc``, which
-should be installed using your distribution's package manager; on macOS, you
-will need xcode_; on Windows, you will need `Visual Studio`_ 2015 or later.
-
-For those using Visual Studio, make sure "Desktop development with C++" is
-selected, and that the latest MSVC, "C++ CMake tools for Windows," and a
-Windows SDK compatible with your version of Windows are selected and installed.
-They should be selected by default under the "Optional" subheading, but are
-required to build matplotlib from source.
-
-.. _xcode: https://guide.macports.org/chunked/installing.html#installing.xcode
-
-.. _Visual Studio: https://visualstudio.microsoft.com/downloads/
-
-The easiest way to get the latest development version to start contributing
-is to go to the git `repository <https://github.com/matplotlib/matplotlib>`_
-and run::
-
-  git clone https://github.com/matplotlib/matplotlib.git
-
-or::
 
-  git clone git@github.com:matplotlib/matplotlib.git
+Install from source
+===================
 
-If you're developing, it's better to do it in editable mode. The reason why
-is that pytest's test discovery only works for Matplotlib
-if installation is done this way. Also, editable mode allows your code changes
-to be instantly propagated to your library code without reinstalling (though
-you will have to restart your python process / kernel)::
+.. admonition:: Installing for Development
+  :class: important
 
-  cd matplotlib
-  python -m pip install -e .
+  If you would like to contribute to Matplotlib or otherwise need to
+  install the latest development code, please follow the instructions in
+  :ref:`installing_for_devs`.
 
-If you're not developing, it can be installed from the source directory with
-a simple (just replace the last step)::
+The following instructions are for installing from source for production use.
+This is generally *not* recommended; please use prebuilt packages when possible.
+Proceed with caution because these instructions may result in your
+build producing unexpected behavior and/or causing local testing to fail.
 
-  python -m pip install .
+Before trying to install Matplotlib, please install the :ref:`dependencies`.
 
-To run the tests you will need to install some additional dependencies::
-
-  python -m pip install -r requirements/dev/dev-requirements.txt
-
-Then, if you want to update your Matplotlib at any time, just do::
-
-  git pull
-
-When you run ``git pull``, if the output shows that only Python files have
-been updated, you are all set. If C files have changed, you need to run ``pip
-install -e .`` again to compile them.
-
-There is more information on :ref:`using git <using-git>` in the developer
-docs.
-
-.. warning::
-
-  The following instructions in this section are for very custom
-  installations of Matplotlib. Proceed with caution because these instructions
-  may result in your build producing unexpected behavior and/or causing
-  local testing to fail.
-
-If you would like to build from a tarball, grab the latest *tar.gz* release
+To build from a tarball, download the latest *tar.gz* release
 file from `the PyPI files page <https://pypi.org/project/matplotlib/>`_.
 
 We provide a `mplsetup.cfg`_ file which you can use to customize the build
 process. For example, which default backend to use, whether some of the
-optional libraries that Matplotlib ships with are installed, and so on.  This
+optional libraries that Matplotlib ships with are installed, and so on. This
 file will be particularly useful to those packaging Matplotlib.
 
 .. _mplsetup.cfg: https://raw.githubusercontent.com/matplotlib/matplotlib/main/mplsetup.cfg.template
@@ -182,13 +130,16 @@ file will be particularly useful to those packaging Matplotlib.
 If you are building your own Matplotlib wheels (or sdists) on Windows, note
 that any DLLs that you copy into the source tree will be packaged too.
 
-==========================
-Installing for development
-==========================
-See :ref:`installing_for_devs`.
 
-.. redirect-from:: /faq/installing_faq
-.. redirect-from:: /users/faq/installing_faq
+Configure build and behavior defaults
+=====================================
+
+Aspects of the build and install process and some behaviorial defaults of the
+library can be configured via :ref:`environment-variables`. Default plotting
+appearance and behavior can be configured via the
+:ref:`rcParams file <customizing-with-matplotlibrc-files>`
+
+
 
 .. _installing-faq:
 
@@ -196,10 +147,6 @@ See :ref:`installing_for_devs`.
 Frequently asked questions
 ==========================
 
-.. contents::
-   :backlinks: none
-   :local:
-
 Report a compilation problem
 ============================
 
@@ -326,3 +273,6 @@ Python.org Python, or check your homebrew or macports setup.  Remember that
 the disk image installer only works for Python.org Python, and will not get
 picked up by other Pythons.  If all these fail, please :ref:`let us know
 <reporting-problems>`.
+
+
+.. include:: troubleshooting_faq.inc.rst
diff --git a/doc/users/installing/troubleshooting_faq.inc.rst b/doc/users/installing/troubleshooting_faq.inc.rst
new file mode 100644
index 000000000000..60bad7ccffc9
--- /dev/null
+++ b/doc/users/installing/troubleshooting_faq.inc.rst
@@ -0,0 +1,72 @@
+.. _troubleshooting-install:
+
+Troubleshooting
+===============
+
+.. _matplotlib-version:
+
+Obtaining Matplotlib version
+----------------------------
+
+To find out your Matplotlib version number, import it and print the
+``__version__`` attribute::
+
+    >>> import matplotlib
+    >>> matplotlib.__version__
+    '0.98.0'
+
+
+.. _locating-matplotlib-install:
+
+:file:`matplotlib` install location
+-----------------------------------
+
+You can find what directory Matplotlib is installed in by importing it
+and printing the ``__file__`` attribute::
+
+    >>> import matplotlib
+    >>> matplotlib.__file__
+    '/home/jdhunter/dev/lib64/python2.5/site-packages/matplotlib/__init__.pyc'
+
+
+.. _locating-matplotlib-config-dir:
+
+:file:`matplotlib` configuration and cache directory locations
+--------------------------------------------------------------
+
+Each user has a Matplotlib configuration directory which may contain a
+:ref:`matplotlibrc <customizing-with-matplotlibrc-files>` file. To
+locate your :file:`matplotlib/` configuration directory, use
+:func:`matplotlib.get_configdir`::
+
+    >>> import matplotlib as mpl
+    >>> mpl.get_configdir()
+    '/home/darren/.config/matplotlib'
+
+On Unix-like systems, this directory is generally located in your
+:envvar:`HOME` directory under the :file:`.config/` directory.
+
+In addition, users have a cache directory. On Unix-like systems, this is
+separate from the configuration directory by default. To locate your
+:file:`.cache/` directory, use :func:`matplotlib.get_cachedir`::
+
+    >>> import matplotlib as mpl
+    >>> mpl.get_cachedir()
+    '/home/darren/.cache/matplotlib'
+
+On Windows, both the config directory and the cache directory are
+the same and are in your :file:`Documents and Settings` or :file:`Users`
+directory by default::
+
+    >>> import matplotlib as mpl
+    >>> mpl.get_configdir()
+    'C:\\Documents and Settings\\jdhunter\\.matplotlib'
+    >>> mpl.get_cachedir()
+    'C:\\Documents and Settings\\jdhunter\\.matplotlib'
+
+If you would like to use a different configuration directory, you can
+do so by specifying the location in your :envvar:`MPLCONFIGDIR`
+environment variable -- see
+:ref:`setting-linux-osx-environment-variables`.  Note that
+:envvar:`MPLCONFIGDIR` sets the location of both the configuration
+directory and the cache directory.

From 41d196378101d120d001952795fd27f3f777e5c6 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Mon, 11 Sep 2023 16:03:53 -0400
Subject: [PATCH 0126/1120] rstcheck config and precommit & fixed rst linting
 errors

---
 .pre-commit-config.yaml                       |  8 ++-
 doc/_templates/autofunctions.rst              |  2 +
 doc/_templates/automodule.rst                 |  9 ++-
 doc/_templates/autosummary.rst                |  5 +-
 doc/_templates/autosummary_class_only.rst     |  1 +
 .../next_api_changes/behavior/25775-HZ.rst    |  2 +-
 .../prev_api_changes/api_changes_2.1.2.rst    |  2 +-
 .../api_changes_3.5.0/behaviour.rst           |  4 +-
 .../api_changes_3.7.0/behaviour.rst           |  4 +-
 doc/devel/MEP/MEP23.rst                       |  4 +-
 doc/devel/MEP/MEP28.rst                       |  1 +
 doc/devel/contribute.rst                      | 69 ++++++++++---------
 doc/devel/document.rst                        |  2 +-
 .../antialiasing_text_annotation.rst          |  4 +-
 doc/users/next_whats_new/boldsym_mathtext.rst |  2 +-
 .../next_whats_new/mathtext_features.rst      |  4 +-
 doc/users/next_whats_new/updated_mathtext.rst |  4 +-
 .../prev_whats_new/dflt_style_changes.rst     | 10 +--
 .../prev_whats_new/github_stats_3.0.0.rst     |  6 +-
 .../prev_whats_new/github_stats_3.2.0.rst     |  6 +-
 .../prev_whats_new/github_stats_3.4.0.rst     |  2 +-
 doc/users/prev_whats_new/whats_new_1.5.rst    |  3 +-
 doc/users/prev_whats_new/whats_new_3.0.rst    |  2 +-
 doc/users/prev_whats_new/whats_new_3.4.0.rst  |  2 +-
 doc/users/prev_whats_new/whats_new_3.5.0.rst  |  4 +-
 .../users_explain/toolkits/axisartist.rst     | 69 +++++++++++++++----
 pyproject.toml                                | 63 +++++++++++++++++
 27 files changed, 212 insertions(+), 82 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index e213bf188f4c..18707e44e5d0 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -26,7 +26,6 @@ repos:
       - id: no-commit-to-branch #default is master and main
       - id: trailing-whitespace
         exclude_types: [svg]
-
   - repo: https://github.com/pycqa/flake8
     rev: 6.0.0
     hooks:
@@ -44,10 +43,15 @@ repos:
           "--skip",
           "doc/users/project/credits.rst"
           ]
-
   - repo: https://github.com/pycqa/isort
     rev: 5.12.0
     hooks:
       - id: isort
         name: isort (python)
         files: ^galleries/tutorials/|^galleries/examples/|^galleries/plot_types/
+  - repo: https://github.com/rstcheck/rstcheck
+    rev: v6.2.0
+    hooks:
+      - id: rstcheck
+        additional_dependencies:
+          - sphinx>=1.8.1
diff --git a/doc/_templates/autofunctions.rst b/doc/_templates/autofunctions.rst
index 942731b46587..291b8eee2ede 100644
--- a/doc/_templates/autofunctions.rst
+++ b/doc/_templates/autofunctions.rst
@@ -14,7 +14,9 @@ Functions
 .. autosummary::
    :template: autosummary.rst
    :toctree:
+
 {% for item in functions %}{% if item not in ['plotting', 'colormaps'] %}
    {{ item }}{% endif %}{% endfor %}
+
 {% endif %}
 {% endblock %}
diff --git a/doc/_templates/automodule.rst b/doc/_templates/automodule.rst
index 984c12e00d03..fef899a38a5e 100644
--- a/doc/_templates/automodule.rst
+++ b/doc/_templates/automodule.rst
@@ -1,8 +1,10 @@
 {{ fullname | escape | underline}}
 
 {% if fullname in ['mpl_toolkits.axes_grid1.colorbar'] %}
-.. To prevent problems with the autosummary for the colorbar doc
-   treat this separately (sphinx-doc/sphinx/issues/4874)
+
+.. To prevent problems with the autosummary for the colorbar doc treat this
+   separately (sphinx-doc/sphinx/issues/4874)
+
 .. automodule:: {{ fullname }}
    :members:
 
@@ -21,8 +23,10 @@ Classes
 .. autosummary::
    :template: autosummary.rst
    :toctree:
+
 {% for item in classes %}{% if item not in ['zip', 'map', 'reduce'] %}
    {{ item }}{% endif %}{% endfor %}
+
 {% endif %}
 {% endblock %}
 
@@ -38,6 +42,7 @@ Functions
 
 {% for item in functions %}{% if item not in ['zip', 'map', 'reduce'] %}
    {{ item }}{% endif %}{% endfor %}
+
 {% endif %}
 {% endblock %}
 {% endif %}
diff --git a/doc/_templates/autosummary.rst b/doc/_templates/autosummary.rst
index c5f90e87f016..824dbe5b9a4b 100644
--- a/doc/_templates/autosummary.rst
+++ b/doc/_templates/autosummary.rst
@@ -5,6 +5,7 @@
 
 
 {% if objtype in ['class'] %}
+
 .. auto{{ objtype }}:: {{ objname }}
     :show-inheritance:
     :special-members: __call__
@@ -16,11 +17,13 @@
 
 {% if objtype in ['class', 'method', 'function'] %}
 {% if objname in ['AxesGrid', 'Scalable', 'HostAxes', 'FloatingAxes',
-                      'ParasiteAxesAuxTrans', 'ParasiteAxes'] %}
+'ParasiteAxesAuxTrans', 'ParasiteAxes'] %}
+
 .. Filter out the above aliases to other classes, as sphinx gallery
    creates no example file for those (sphinx-gallery/sphinx-gallery#365)
 
 {% else %}
+
 .. minigallery:: {{module}}.{{objname}}
    :add-heading:
 
diff --git a/doc/_templates/autosummary_class_only.rst b/doc/_templates/autosummary_class_only.rst
index 6611f04f5c0d..d10f1b375fd3 100644
--- a/doc/_templates/autosummary_class_only.rst
+++ b/doc/_templates/autosummary_class_only.rst
@@ -5,6 +5,7 @@
 
 
 {% if objtype in ['class'] %}
+
 .. auto{{ objtype }}:: {{ objname }}
     :no-members:
 
diff --git a/doc/api/next_api_changes/behavior/25775-HZ.rst b/doc/api/next_api_changes/behavior/25775-HZ.rst
index 118195811b98..badd2951e515 100644
--- a/doc/api/next_api_changes/behavior/25775-HZ.rst
+++ b/doc/api/next_api_changes/behavior/25775-HZ.rst
@@ -4,7 +4,7 @@ Default antialiasing behavior changes for ``Text`` and ``Annotation``
 ``matplotlib.pyplot.annotate()`` and ``matplotlib.pyplot.text()`` now support parameter *antialiased* when initializing.
 Examples:
 
-.. code-block::
+.. code-block:: python
 
     mpl.text.Text(.5, .5, "foo\nbar", antialiased=True)
     plt.text(0.5, 0.5, '6 inches x 2 inches', antialiased=True)
diff --git a/doc/api/prev_api_changes/api_changes_2.1.2.rst b/doc/api/prev_api_changes/api_changes_2.1.2.rst
index 5eb6658e263e..a043a99942bd 100644
--- a/doc/api/prev_api_changes/api_changes_2.1.2.rst
+++ b/doc/api/prev_api_changes/api_changes_2.1.2.rst
@@ -13,7 +13,7 @@ didn't handle linewidths or linestyles etc.
 
 This logic did not exist in `.axes.Axes.legend`.  It was included (erroneously)
 in Matplotlib 2.1.1 when the legend argument parsing was unified
-[#9324](https://github.com/matplotlib/matplotlib/pull/9324).  This change
+`#9324 <https://github.com/matplotlib/matplotlib/pull/9324>`_.  This change
 removes that check in `.axes.Axes.legend` again to restore the old behavior.
 
 This logic has also been dropped from `.Figure.legend`, where it
diff --git a/doc/api/prev_api_changes/api_changes_3.5.0/behaviour.rst b/doc/api/prev_api_changes/api_changes_3.5.0/behaviour.rst
index 69e38270ca76..9045fbb62764 100644
--- a/doc/api/prev_api_changes/api_changes_3.5.0/behaviour.rst
+++ b/doc/api/prev_api_changes/api_changes_3.5.0/behaviour.rst
@@ -132,7 +132,7 @@ consistently exposes all the attributes and methods related to the line marker
 (:ghissue:`11358`). This makes it easy to change the marker features after
 instantiating a legend.
 
-.. code::
+.. code-block:: python
 
     import matplotlib.pyplot as plt
 
@@ -147,7 +147,7 @@ instantiating a legend.
 The former legend handler for Line2D objects has been renamed
 `.HandlerLine2DCompound`. To revert to the previous behaviour, one can use
 
-.. code::
+.. code-block:: python
 
     import matplotlib.legend as mlegend
     from matplotlib.legend_handler import HandlerLine2DCompound
diff --git a/doc/api/prev_api_changes/api_changes_3.7.0/behaviour.rst b/doc/api/prev_api_changes/api_changes_3.7.0/behaviour.rst
index 6057bfa9af4c..a4fd8b57e419 100644
--- a/doc/api/prev_api_changes/api_changes_3.7.0/behaviour.rst
+++ b/doc/api/prev_api_changes/api_changes_3.7.0/behaviour.rst
@@ -51,7 +51,7 @@ Now, the halfrange remains fixed when vcenter is changed, and **vmin** and
 
 For example, this is what the values were when changing vcenter previously.
 
-.. code-block::
+.. code-block:: python
 
     norm = CenteredNorm(vcenter=0, halfrange=1)
     # Move vcenter up by one
@@ -61,7 +61,7 @@ For example, this is what the values were when changing vcenter previously.
 
 and now, with that same example
 
-.. code-block::
+.. code-block:: python
 
     norm = CenteredNorm(vcenter=0, halfrange=1)
     norm.vcenter = 1
diff --git a/doc/devel/MEP/MEP23.rst b/doc/devel/MEP/MEP23.rst
index 11fd965c4816..1c06978eb8bc 100644
--- a/doc/devel/MEP/MEP23.rst
+++ b/doc/devel/MEP/MEP23.rst
@@ -35,7 +35,7 @@ most use cases.
 
 Sometimes when there are too many figures open at the same time, it is
 desirable to be able to group these under the same window
-[see](https://github.com/matplotlib/matplotlib/issues/2194).
+`see <https://github.com/matplotlib/matplotlib/issues/2194>`_.
 
 The proposed solution modifies `.FigureManagerBase` to contain and manage more
 than one ``Canvas``. The settings parameter :rc:`backend.multifigure` control
@@ -44,7 +44,7 @@ when the **MultiFigure** behaviour is desired.
 **Note**
 
 It is important to note, that the proposed solution, assumes that the
-[MEP22](https://github.com/matplotlib/matplotlib/wiki/Mep22) is
+`MEP22 <https://github.com/matplotlib/matplotlib/wiki/Mep22>`_. is
 already in place. This is simply because the actual implementation of
 the ``Toolbar`` makes it pretty hard to switch between canvases.
 
diff --git a/doc/devel/MEP/MEP28.rst b/doc/devel/MEP/MEP28.rst
index 0a215a9f19d0..7ae9f8e610d4 100644
--- a/doc/devel/MEP/MEP28.rst
+++ b/doc/devel/MEP/MEP28.rst
@@ -264,6 +264,7 @@ value of ``statfxn`` would be ``cbook.boxplot_stats``, but users could
 pass their own function. Then ``transform_in`` and ``transform_out`` would
 then be passed as elements of the ``statfxn_args`` parameter.
 
+.. rstcheck: ignore-next-code-block
 .. code:: python
 
    def boxplot_stats(data, ..., transform_in=None, transform_out=None):
diff --git a/doc/devel/contribute.rst b/doc/devel/contribute.rst
index 9ed1fe500fa5..9b53a80ab374 100644
--- a/doc/devel/contribute.rst
+++ b/doc/devel/contribute.rst
@@ -170,18 +170,18 @@ also welcome to post feature requests or pull requests.
 
 If you are reporting a bug, please do your best to include the following:
 
-1. A short, top-level summary of the bug. In most cases, this should be 1-2
+#. A short, top-level summary of the bug. In most cases, this should be 1-2
    sentences.
 
-2. A short, self-contained code snippet to reproduce the bug, ideally allowing
+#. A short, self-contained code snippet to reproduce the bug, ideally allowing
    a simple copy and paste to reproduce. Please do your best to reduce the code
    snippet to the minimum required.
 
-3. The actual outcome of the code snippet.
+#. The actual outcome of the code snippet.
 
-4. The expected outcome of the code snippet.
+#. The expected outcome of the code snippet.
 
-5. The Matplotlib version, Python version and platform that you are using. You
+#. The Matplotlib version, Python version and platform that you are using. You
    can grab the version with the following commands::
 
       >>> import matplotlib
@@ -229,52 +229,54 @@ contribute to Matplotlib.
 
 A brief overview of the workflow is as follows.
 
-1. `Create an account <https://github.com/join>`_ on GitHub if you do not
+#. `Create an account <https://github.com/join>`_ on GitHub if you do not
    already have one.
 
-2. Fork the `project repository <https://github.com/matplotlib/matplotlib>`_:
-   click on the 'Fork' button near the top of the page. This creates a copy of
-   the code under your account on the GitHub server.
+#. Fork the `project repository <https://github.com/matplotlib/matplotlib>`_ by
+   clicking on the :octicon:`repo-forked` **Fork** button near the top of the page.
+   This creates a copy of the code under your account on the GitHub server.
 
-.. tab-set::
+#. Set up a development environment:
 
-    .. tab-item:: Local development
+   .. tab-set::
 
-        3. Clone this copy to your local disk::
+      .. tab-item:: Local development
 
-             git clone https://github.com/<YOUR GITHUB USERNAME>/matplotlib.git
+          Clone this copy to your local disk::
 
-    .. tab-item:: Using GitHub Codespaces
+            git clone https://github.com/<YOUR GITHUB USERNAME>/matplotlib.git
 
-        3. Check out the Matplotlib repository and activate your development
-           environment:
+      .. tab-item:: Using GitHub Codespaces
 
-           * Open codespaces on your fork by clicking on the green "Code" button
+          Check out the Matplotlib repository and activate your development environment:
+
+          #. Open codespaces on your fork by clicking on the green "Code" button
              on the GitHub web interface and selecting the "Codespaces" tab.
-           * Next, click on "Open codespaces on <your branch name>". You will be
+
+          #. Next, click on "Open codespaces on <your branch name>". You will be
              able to change branches later, so you can select the default
              ``main`` branch.
-           * After the codespace is created, you will be taken to a new browser
+
+          #. After the codespace is created, you will be taken to a new browser
              tab where you can use the terminal to activate a pre-defined conda
              environment called ``mpl-dev``::
 
-               conda activate mpl-dev
-
+              conda activate mpl-dev
 
 
-4. Install the local version of Matplotlib with::
+#. Install the local version of Matplotlib with::
 
      python -m pip install -e .
 
    See :ref:`installing_for_devs` for detailed instructions.
 
-5. Create a branch to hold your changes::
+#. Create a branch to hold your changes::
 
      git checkout -b my-feature origin/main
 
    and start making changes. Never work in the ``main`` branch!
 
-6. Work on this task using Git to do the version control. Codespaces persist for
+#. Work on this task using Git to do the version control. Codespaces persist for
    some time (check the `documentation for details
    <https://docs.github.com/codespaces/getting-started/the-codespace-lifecycle>`_)
    and can be managed on https://github.com/codespaces. When you're done editing
@@ -301,11 +303,11 @@ GitHub Codespaces workflows
   <https://github.com/devcontainers/features/tree/main/src/desktop-lite>`_.
   You can use it by connecting to this desktop via your web browser. To do this:
 
-  1. Press ``F1`` or ``Ctrl/Cmd+Shift+P`` and select
+  #. Press ``F1`` or ``Ctrl/Cmd+Shift+P`` and select
      ``Ports: Focus on Ports View`` in the VSCode session to bring it into
      focus. Open the ports view in your tool, select the ``noVNC`` port, and
      click the Globe icon.
-  2. In the browser that appears, click the Connect button and enter the desktop
+  #. In the browser that appears, click the Connect button and enter the desktop
      password (``vscode`` by default).
 
   Check the `GitHub instructions
@@ -391,10 +393,11 @@ Rules
 Introducing
 ~~~~~~~~~~~
 
-1. Announce the deprecation in a new file
+#. Announce the deprecation in a new file
    :file:`doc/api/next_api_changes/deprecations/99999-ABC.rst` where ``99999``
    is the pull request number and ``ABC`` are the contributor's initials.
-2. If possible, issue a `~matplotlib.MatplotlibDeprecationWarning` when the
+
+#. If possible, issue a `~matplotlib.MatplotlibDeprecationWarning` when the
    deprecated API is used. There are a number of helper tools for this:
 
    - Use ``_api.warn_deprecated()`` for general deprecation warnings
@@ -411,7 +414,7 @@ Introducing
 
    You can use standard rst cross references in *alternative*.
 
-3. Make appropriate changes to the type hints in the associated ``.pyi`` file.
+#. Make appropriate changes to the type hints in the associated ``.pyi`` file.
    The general guideline is to match runtime reported behavior.
 
    - Items marked with ``@_api.deprecated`` or ``@_api.deprecate_privatize_attribute``
@@ -431,15 +434,17 @@ Introducing
 Expiring
 ~~~~~~~~
 
-1. Announce the API changes in a new file
+#. Announce the API changes in a new file
    :file:`doc/api/next_api_changes/[kind]/99999-ABC.rst` where ``99999``
    is the pull request number and ``ABC`` are the contributor's initials, and
    ``[kind]`` is one of the folders :file:`behavior`, :file:`development`,
    :file:`removals`. See :file:`doc/api/next_api_changes/README.rst` for more
    information. For the content, you can usually copy the deprecation notice
    and adapt it slightly.
-2. Change the code functionality and remove any related deprecation warnings.
-3. Make appropriate changes to the type hints in the associated ``.pyi`` file.
+
+#. Change the code functionality and remove any related deprecation warnings.
+
+#. Make appropriate changes to the type hints in the associated ``.pyi`` file.
 
    - Items marked with ``@_api.deprecated`` or ``@_api.deprecate_privatize_attribute``
      are to be removed on expiry.
diff --git a/doc/devel/document.rst b/doc/devel/document.rst
index 68f2d3a674c9..ac92888b4052 100644
--- a/doc/devel/document.rst
+++ b/doc/devel/document.rst
@@ -668,7 +668,7 @@ in that case, they can be documented as an ``.. ACCEPTS:`` block, e.g. for
 
 .. code-block:: python
 
-   def set_xlim(self, ...):
+   def set_xlim(self, left=None, right=None):
        """
        Set the x-axis view limits.
 
diff --git a/doc/users/next_whats_new/antialiasing_text_annotation.rst b/doc/users/next_whats_new/antialiasing_text_annotation.rst
index c771f6a1e19f..277b9ab05c92 100644
--- a/doc/users/next_whats_new/antialiasing_text_annotation.rst
+++ b/doc/users/next_whats_new/antialiasing_text_annotation.rst
@@ -6,7 +6,7 @@ When *antialiased* is set to ``False``, antialiasing will not be applied to the
 When *antialiased* is not specified, antialiasing will be set by :rc:`text.antialiased` at the creation time of ``Text`` and ``Annotation`` object.
 Examples:
 
-.. code-block::
+.. code-block:: python
 
     mpl.text.Text(.5, .5, "foo\nbar", antialiased=True)
     plt.text(0.5, 0.5, '6 inches x 2 inches', antialiased=True)
@@ -15,7 +15,7 @@ Examples:
 If the text contains math expression, *antialiased* applies to the whole text.
 Examples:
 
-.. code-block::
+.. code-block:: python
 
     # no part will be antialiased for the text below
     plt.text(0.5, 0.25, r"$I'm \sqrt{x}$", antialiased=False)
diff --git a/doc/users/next_whats_new/boldsym_mathtext.rst b/doc/users/next_whats_new/boldsym_mathtext.rst
index d58532d5661e..80c8415b60cb 100644
--- a/doc/users/next_whats_new/boldsym_mathtext.rst
+++ b/doc/users/next_whats_new/boldsym_mathtext.rst
@@ -6,7 +6,7 @@ Supports using the ``\boldsymbol{}`` command in mathtext:
 To change symbols to bold enclose the text in a font command as
 shown:
 
-.. code-block::
+.. code-block:: none
 
     r'$\boldsymbol{a+2+\alpha}$'
 
diff --git a/doc/users/next_whats_new/mathtext_features.rst b/doc/users/next_whats_new/mathtext_features.rst
index f62a8d453fee..57c4ec214aee 100644
--- a/doc/users/next_whats_new/mathtext_features.rst
+++ b/doc/users/next_whats_new/mathtext_features.rst
@@ -5,7 +5,7 @@
 
 To use it to enclose the math in a substack command as shown:
 
-.. code-block::
+.. code-block:: none
 
     r'$\sum_{\substack{1\leq i\leq 3\\ 1\leq j\leq 5}}$'
 
@@ -23,7 +23,7 @@ The ``\middle`` delimiter has been added, and can now be used with the
 To use the middle command enclose it in between the ``\left`` and
 ``\right`` delimiter command as shown:
 
-.. code-block::
+.. code-block:: none
 
     r'$\left( \frac{a}{b} \middle| q \right)$'
 
diff --git a/doc/users/next_whats_new/updated_mathtext.rst b/doc/users/next_whats_new/updated_mathtext.rst
index 3658b8db6be1..fb19bf0325b5 100644
--- a/doc/users/next_whats_new/updated_mathtext.rst
+++ b/doc/users/next_whats_new/updated_mathtext.rst
@@ -6,9 +6,9 @@ Supports use of bold-italic font style in mathtext using the ``\mathbfit{}`` com
 To change font to bold and italic enclose the text in a font command as
 shown:
 
-.. code-block::
+.. code-block:: none
 
-    r'$\mathbfit{\eta \leq C(\delta(\eta))}$
+    r'$\mathbfit{\eta \leq C(\delta(\eta))}$'
 
 .. math::
    \mathbfit{\eta \leq C(\delta(\eta))}
diff --git a/doc/users/prev_whats_new/dflt_style_changes.rst b/doc/users/prev_whats_new/dflt_style_changes.rst
index e86e34c50e46..a833064b573b 100644
--- a/doc/users/prev_whats_new/dflt_style_changes.rst
+++ b/doc/users/prev_whats_new/dflt_style_changes.rst
@@ -13,7 +13,7 @@ are designed to work well in the most common cases.
 A 'classic' style sheet is provided so reverting to the 1.x default
 values is a single line of python
 
-.. code::
+.. code-block:: python
 
   import matplotlib.style
   import matplotlib as mpl
@@ -102,14 +102,14 @@ denote the first 10 colors in :rc:`axes.prop_cycle`. See
 
 To restore the old color cycle use
 
-.. code::
+.. code-block:: python
 
    from cycler import cycler
    mpl.rcParams['axes.prop_cycle'] = cycler(color='bgrcmyk')
 
 or set
 
-.. code::
+.. code-block:: cfg
 
    axes.prop_cycle    : cycler('color', 'bgrcmyk')
 
@@ -156,13 +156,13 @@ map.  For details on all of the colormaps available in matplotlib see
 
 The previous default can be restored using
 
-.. code::
+.. code-block:: python
 
    mpl.rcParams['image.cmap'] = 'jet'
 
 or setting
 
-.. code::
+.. code-block:: cfg
 
    image.cmap    : 'jet'
 
diff --git a/doc/users/prev_whats_new/github_stats_3.0.0.rst b/doc/users/prev_whats_new/github_stats_3.0.0.rst
index ab90e5e79e4e..0e9c4b3b588d 100644
--- a/doc/users/prev_whats_new/github_stats_3.0.0.rst
+++ b/doc/users/prev_whats_new/github_stats_3.0.0.rst
@@ -128,7 +128,7 @@ The following 478 authors contributed 9809 commits.
 * Drew J. Sonne
 * Duncan Macleod
 * Dylan Evans
-* E. G. Patrick Bos
+* E\. G\. Patrick Bos
 * Egor Panfilov
 * Elijah Schutz
 * Elizabeth Seiver
@@ -205,7 +205,7 @@ The following 478 authors contributed 9809 commits.
 * Isaac Slavitt
 * Ismo Toijala
 * J Alammar
-* J. Goutin
+* J\. Goutin
 * Jaap Versteegh
 * Jacob McDonald
 * jacob-on-github
@@ -464,7 +464,7 @@ The following 478 authors contributed 9809 commits.
 * Tuan Dung Tran
 * u55
 * ultra-andy
-* V. R
+* V\. R
 * vab9
 * Valentin Schmidt
 * Vedant Nanda
diff --git a/doc/users/prev_whats_new/github_stats_3.2.0.rst b/doc/users/prev_whats_new/github_stats_3.2.0.rst
index 5fd75f7c57d0..3cb3fce5de52 100644
--- a/doc/users/prev_whats_new/github_stats_3.2.0.rst
+++ b/doc/users/prev_whats_new/github_stats_3.2.0.rst
@@ -119,7 +119,7 @@ The following 164 authors contributed 3455 commits.
 * Nicolas Courtemanche
 * Nikita Kniazev
 * njwhite
-* O. Castany
+* O\. Castany
 * Oliver Natt
 * Olivier
 * Om Sitapara
@@ -142,7 +142,7 @@ The following 164 authors contributed 3455 commits.
 * Richard Ji-Cathriner
 * RoryIAngus
 * Ryan May
-* S. Fukuda
+* S\. Fukuda
 * Samesh
 * Samesh Lakhotia
 * sasoripathos
@@ -164,7 +164,7 @@ The following 164 authors contributed 3455 commits.
 * Tim Hoffmann
 * Tom Flannaghan
 * Travis CI
-* V. Armando Solé
+* V\. Armando Solé
 * Vincent L.M. Mazoyer
 * Viraj Mohile
 * Wafa Soofi
diff --git a/doc/users/prev_whats_new/github_stats_3.4.0.rst b/doc/users/prev_whats_new/github_stats_3.4.0.rst
index fe49e673a660..b2568058b455 100644
--- a/doc/users/prev_whats_new/github_stats_3.4.0.rst
+++ b/doc/users/prev_whats_new/github_stats_3.4.0.rst
@@ -82,7 +82,7 @@ The following 177 authors contributed 3852 commits.
 * ImportanceOfBeingErnest
 * Isuru Fernando
 * ItsRLuo
-* J. Scott Berg
+* J\. Scott Berg
 * Jae-Joon Lee
 * Jakub Klus
 * Janakarajan Natarajan
diff --git a/doc/users/prev_whats_new/whats_new_1.5.rst b/doc/users/prev_whats_new/whats_new_1.5.rst
index 5ff5b0a97bbd..dd8e204aa957 100644
--- a/doc/users/prev_whats_new/whats_new_1.5.rst
+++ b/doc/users/prev_whats_new/whats_new_1.5.rst
@@ -517,7 +517,8 @@ also prevents unsafe usage by strictly defining the parameters that a
 user can set.
 
 To use, call ``set_params()`` on a `.Locator` instance with desired arguments:
-::
+
+.. code-block:: python
 
     loc = matplotlib.ticker.LogLocator()
     # Set given attributes for loc.
diff --git a/doc/users/prev_whats_new/whats_new_3.0.rst b/doc/users/prev_whats_new/whats_new_3.0.rst
index 2f268eaf0058..e3dd12c71a8e 100644
--- a/doc/users/prev_whats_new/whats_new_3.0.rst
+++ b/doc/users/prev_whats_new/whats_new_3.0.rst
@@ -147,7 +147,7 @@ Add ``ax.get_gridspec`` to ``SubplotBase``
 New method ``SubplotBase.get_gridspec`` is added so that users can
 easily get the gridspec that went into making an axes:
 
-.. code::
+.. code-block:: python
 
     import matplotlib.pyplot as plt
 
diff --git a/doc/users/prev_whats_new/whats_new_3.4.0.rst b/doc/users/prev_whats_new/whats_new_3.4.0.rst
index f90a95c7f126..0cd57b4b8d45 100644
--- a/doc/users/prev_whats_new/whats_new_3.4.0.rst
+++ b/doc/users/prev_whats_new/whats_new_3.4.0.rst
@@ -494,7 +494,7 @@ display an image of the colormap.
 
 .. only:: html
 
-    .. code-block::
+    .. code-block:: ipython
 
         In[1]: cmap = plt.get_cmap('viridis').with_extremes(bad='r', under='g', over='b')
 
diff --git a/doc/users/prev_whats_new/whats_new_3.5.0.rst b/doc/users/prev_whats_new/whats_new_3.5.0.rst
index 5e69ab6be926..5a55cff17d02 100644
--- a/doc/users/prev_whats_new/whats_new_3.5.0.rst
+++ b/doc/users/prev_whats_new/whats_new_3.5.0.rst
@@ -284,7 +284,7 @@ Simplifying the font setting for usetex mode
 Now the :rc:`font.family` accepts some font names as value for a more
 user-friendly setup.
 
-.. code-block::
+.. code-block:: python
 
     plt.rcParams.update({
         "text.usetex": True,
@@ -561,7 +561,7 @@ to block callback signals from being processed by the ``CallbackRegistry``.
 The optional keyword, *signal*, can be used to block a specific signal
 from being processed and let all other signals pass.
 
-.. code-block::
+.. code-block:: python
 
     import matplotlib.pyplot as plt
 
diff --git a/galleries/users_explain/toolkits/axisartist.rst b/galleries/users_explain/toolkits/axisartist.rst
index 9246fb27271b..f27839956282 100644
--- a/galleries/users_explain/toolkits/axisartist.rst
+++ b/galleries/users_explain/toolkits/axisartist.rst
@@ -341,18 +341,63 @@ On the other hand, there is a concept of "axis_direction". This is a
 default setting of above properties for each, "bottom", "left", "top",
 and "right" axis.
 
-========== =========== ========= ========== ========= ==========
-   ?           ?        left      bottom      right      top
----------- ----------- --------- ---------- --------- ----------
-axislabel   direction      '-'       '+'        '+'      '-'
-axislabel   rotation      180         0          0       180
-axislabel   va           center    top       center     bottom
-axislabel   ha           right    center      right     center
-ticklabel   direction      '-'       '+'        '+'      '-'
-ticklabels  rotation       90         0        -90       180
-ticklabel   ha           right    center      right     center
-ticklabel   va           center   baseline    center   baseline
-========== =========== ========= ========== ========= ==========
+.. list-table::
+
+  * -
+    -
+    - left
+    - bottom
+    - right
+    - top
+  * - axislabel
+    - direction
+    - '-'
+    - '+'
+    - '+'
+    - '-'
+  * - axislabel
+    - rotation
+    - 180
+    - 0
+    - 0
+    - 180
+  * - axislabel
+    - va
+    - center
+    - top
+    - center
+    - bottom
+  * - axislabel
+    - ha
+    - right
+    - center
+    - right
+    - center
+  * - ticklabel
+    - direction
+    - '-'
+    - '+'
+    - '+'
+    - '-'
+  * - ticklabels
+    - rotation
+    - 90
+    - 0
+    - -90
+    - 180
+  * - ticklabel
+    - ha
+    - right
+    - center
+    - right
+    - center
+  * - ticklabel
+    - va
+    - center
+    - baseline
+    - center
+    - baseline
+
 
 And, 'set_axis_direction("top")' means to adjust the text rotation
 etc, for settings suitable for "top" axis. The concept of axis
diff --git a/pyproject.toml b/pyproject.toml
index d2e2f769b7ef..f52b96e1cd67 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -140,3 +140,66 @@ ignore_missing_imports = true
 enable_incomplete_feature = [
   "Unpack",
 ]
+
+[tool.rstcheck]
+ignore_directives = [
+    # matplotlib.sphinxext.mathmpl
+    "mathmpl",
+    # matplotlib.sphinxext.plot_directive
+    "plot",
+    # sphinxext.math_symbol_table
+    "math_symbol_table",
+    # sphinxext.redirect_from
+    "redirect-from",
+    # sphinx-design
+    "dropdown",
+    "grid",
+    "tab-set",
+    # sphinx-gallery
+    "minigallery",
+    "image-sg",
+    # sphinx.ext.autodoc
+    "automodule",
+    "autoclass",
+    "autofunction",
+    "autodata",
+    "automethod",
+    "autoattribute",
+    "autoproperty",
+    # sphinx.ext.autosummary
+    "autosummary",
+    # sphinx.ext.ifconfig
+    "ifconfig",
+    # sphinx.ext.inheritance_diagram
+    "inheritance-diagram",
+    # include directive is causing attribute errors
+    "include"
+]
+ignore_roles = [
+    # sphinxext.custom_roles
+    "rc",
+    # matplotlib.sphinxext.mathmpl
+    "mathmpl",
+    "math-stix",
+    # sphinxext.github
+    "ghissue",
+    "ghpull",
+    "ghuser",
+    # sphinx-design
+    "octicon",
+]
+ignore_substitutions = [
+    "Artist",
+    "Axes",
+    "Axis",
+    "Figure",
+    "release"
+]
+
+ignore_messages = [
+    "Hyperlink target \".*\" is not referenced.",
+    "Duplicate implicit target name: \".*\".",
+    "Duplicate explicit target name: \".*\".",
+    # error in role directive is `.. role:: math-stix(mathmpl)
+    "Error in \"role\" directive:",
+]

From eff63fb81311ac1a3e9297710718d648e473f016 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Wed, 13 Sep 2023 12:07:43 -0500
Subject: [PATCH 0127/1120] MNT: Numpy 2.0 removals from ndarray class

xref numpy/numpy#24682

Only a handful of lines, and _mostly_ in tests/relatively unused utility functions like rgb_to_hsv, but still something that should be addressed.
---
 lib/matplotlib/cbook.py             | 3 ++-
 lib/matplotlib/colors.py            | 5 +++--
 lib/matplotlib/tests/test_axes.py   | 6 +++---
 lib/matplotlib/tests/test_colors.py | 4 ++--
 4 files changed, 10 insertions(+), 8 deletions(-)

diff --git a/lib/matplotlib/cbook.py b/lib/matplotlib/cbook.py
index bea97102006b..80ec1612688b 100644
--- a/lib/matplotlib/cbook.py
+++ b/lib/matplotlib/cbook.py
@@ -734,7 +734,8 @@ def safe_masked_invalid(x, copy=False):
     if not x.dtype.isnative:
         # If we have already made a copy, do the byteswap in place, else make a
         # copy with the byte order swapped.
-        x = x.byteswap(inplace=copy).newbyteorder('N')  # Swap to native order.
+        # Swap to native order.
+        x = x.byteswap(inplace=copy).view(x.dtype.newbyteorder('N'))
     try:
         xm = np.ma.masked_where(~(np.isfinite(x)), x, copy=False)
     except TypeError:
diff --git a/lib/matplotlib/colors.py b/lib/matplotlib/colors.py
index d0d20806666a..904b6ecfa04b 100644
--- a/lib/matplotlib/colors.py
+++ b/lib/matplotlib/colors.py
@@ -726,7 +726,8 @@ def __call__(self, X, alpha=None, bytes=False):
 
         xa = np.array(X, copy=True)
         if not xa.dtype.isnative:
-            xa = xa.byteswap().newbyteorder()  # Native byteorder is faster.
+            # Native byteorder is faster.
+            xa = xa.byteswap().view(xa.dtype.newbyteorder())
         if xa.dtype.kind == "f":
             xa *= self.N
             # xa == 1 (== N after multiplication) is not out of range.
@@ -2161,7 +2162,7 @@ def rgb_to_hsv(arr):
     out = np.zeros_like(arr)
     arr_max = arr.max(-1)
     ipos = arr_max > 0
-    delta = arr.ptp(-1)
+    delta = np.ptp(arr, -1)
     s = np.zeros_like(delta)
     s[ipos] = delta[ipos] / arr_max[ipos]
     ipos = delta > 0
diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index 3b5f9019ead2..ab9dab03e543 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -1333,7 +1333,7 @@ def test_pcolormesh():
     Qz = np.sin(Y) + np.sin(X)
     Qx = (Qx + 1.1)
     Z = np.hypot(X, Y) / 5
-    Z = (Z - Z.min()) / Z.ptp()
+    Z = (Z - Z.min()) / np.ptp(Z)
 
     # The color array can include masked values:
     Zm = ma.masked_where(np.abs(Qz) < 0.5 * np.max(Qz), Z)
@@ -1354,7 +1354,7 @@ def test_pcolormesh_small():
     Qz = np.sin(Y) + np.sin(X)
     Qx = (Qx + 1.1)
     Z = np.hypot(X, Y) / 5
-    Z = (Z - Z.min()) / Z.ptp()
+    Z = (Z - Z.min()) / np.ptp(Z)
     Zm = ma.masked_where(np.abs(Qz) < 0.5 * np.max(Qz), Z)
     Zm2 = ma.masked_where(Qz < -0.5 * np.max(Qz), Z)
 
@@ -1384,7 +1384,7 @@ def test_pcolormesh_alpha():
     Qx = X
     Qy = Y + np.sin(X)
     Z = np.hypot(X, Y) / 5
-    Z = (Z - Z.min()) / Z.ptp()
+    Z = (Z - Z.min()) / np.ptp(Z)
     vir = mpl.colormaps["viridis"].resampled(16)
     # make another colormap with varying alpha
     colors = vir(np.arange(16))
diff --git a/lib/matplotlib/tests/test_colors.py b/lib/matplotlib/tests/test_colors.py
index e8fc9baa1479..1c77f995fb53 100644
--- a/lib/matplotlib/tests/test_colors.py
+++ b/lib/matplotlib/tests/test_colors.py
@@ -216,7 +216,7 @@ def test_colormap_endian():
     a = [-0.5, 0, 0.5, 1, 1.5, np.nan]
     for dt in ["f2", "f4", "f8"]:
         anative = np.ma.masked_invalid(np.array(a, dtype=dt))
-        aforeign = anative.byteswap().newbyteorder()
+        aforeign = anative.byteswap().view(anative.dtype.newbyteorder())
         assert_array_equal(cmap(anative), cmap(aforeign))
 
 
@@ -1126,7 +1126,7 @@ def alternative_hillshade(azimuth, elev, z):
 
         intensity = np.tensordot(normals, illum, axes=(2, 0))
         intensity -= intensity.min()
-        intensity /= intensity.ptp()
+        intensity /= np.ptp(intensity)
         return intensity
 
     y, x = np.mgrid[5:0:-1, :5]

From 43d4bd65d0a6c7a575e435cdaf6e132c59d7c03b Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 13 Sep 2023 15:40:42 -0400
Subject: [PATCH 0128/1120] DOC: Add redirects for old gitwash files

These were deleted in 3.7.0, and a bunch of redirects were added
in #24629, but these two were missed.
---
 doc/devel/development_workflow.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/doc/devel/development_workflow.rst b/doc/devel/development_workflow.rst
index 0d3a4c590de2..c03dab47c759 100644
--- a/doc/devel/development_workflow.rst
+++ b/doc/devel/development_workflow.rst
@@ -1,5 +1,8 @@
 .. highlight:: bash
 
+.. redirect-from:: /devel/gitwash/development_workflow
+.. redirect-from:: /devel/gitwash/maintainer_workflow
+
 .. _development-workflow:
 
 ####################

From 1d7f0945689342d16c4a370b3e355a46090fd6b7 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 13 Sep 2023 18:17:44 -0400
Subject: [PATCH 0129/1120] Trim Gouraud triangles that contain NaN

Agg enters an infinite loop if you give it points that are NaN, due to
converting the values to fixed-point integers, and then oscillating
between the large values that result from that conversion.

NaN values may be introduced after transforming the input, so we need to
trim those after transformation. This matches what is done in normal
paths.
---
 lib/matplotlib/tests/test_transforms.py | 19 +++++++++++++++++++
 src/_backend_agg.h                      |  3 +++
 2 files changed, 22 insertions(+)

diff --git a/lib/matplotlib/tests/test_transforms.py b/lib/matplotlib/tests/test_transforms.py
index ee6754cb8da8..a9a92d33cff3 100644
--- a/lib/matplotlib/tests/test_transforms.py
+++ b/lib/matplotlib/tests/test_transforms.py
@@ -142,6 +142,25 @@ def test_pcolormesh_pre_transform_limits():
     assert_almost_equal(expected, ax.dataLim.get_points())
 
 
+def test_pcolormesh_gouraud_nans():
+    np.random.seed(19680801)
+
+    values = np.linspace(0, 180, 3)
+    radii = np.linspace(100, 1000, 10)
+    z, y = np.meshgrid(values, radii)
+    x = np.radians(np.random.rand(*z.shape) * 100)
+
+    fig = plt.figure()
+    ax = fig.add_subplot(111, projection="polar")
+    # Setting the limit to cause clipping of the r values causes NaN to be
+    # introduced; these should not crash but be ignored as in other path
+    # operations.
+    ax.set_rlim(101, 1000)
+    ax.pcolormesh(x, y, z, shading="gouraud")
+
+    fig.canvas.draw()
+
+
 def test_Affine2D_from_values():
     points = np.array([[0, 0],
                        [10, 20],
diff --git a/src/_backend_agg.h b/src/_backend_agg.h
index f15fa05dd5fd..61c24232a866 100644
--- a/src/_backend_agg.h
+++ b/src/_backend_agg.h
@@ -1193,6 +1193,9 @@ inline void RendererAgg::_draw_gouraud_triangle(PointArray &points,
             tpoints[i][j] = points(i, j);
         }
         trans.transform(&tpoints[i][0], &tpoints[i][1]);
+        if(std::isnan(tpoints[i][0]) || std::isnan(tpoints[i][1])) {
+            return;
+        }
     }
 
     span_alloc_t span_alloc;

From 4c14bd0f25735174b16ccc78146276664a1ddad1 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Mon, 4 Sep 2023 02:50:12 +0200
Subject: [PATCH 0130/1120] Remove usage of numpy recarray

Structured numpy arrays are more fundamental than recarrays
and sufficient in all cases.

Supersedes #26664.
---
 .../fill_between_alpha.py                      |  8 ++++----
 .../lines_bars_and_markers/scatter_demo2.py    |  8 ++++----
 galleries/examples/misc/keyword_plotting.py    | 13 +++++++------
 .../examples/ticks/centered_ticklabels.py      |  7 +++----
 .../examples/ticks/date_index_formatter.py     | 18 +++++++++---------
 galleries/tutorials/pyplot.py                  |  6 ++++--
 galleries/users_explain/quick_start.py         |  9 ++++++---
 7 files changed, 37 insertions(+), 32 deletions(-)

diff --git a/galleries/examples/lines_bars_and_markers/fill_between_alpha.py b/galleries/examples/lines_bars_and_markers/fill_between_alpha.py
index 66822aaff0c5..3894d9d1d45c 100644
--- a/galleries/examples/lines_bars_and_markers/fill_between_alpha.py
+++ b/galleries/examples/lines_bars_and_markers/fill_between_alpha.py
@@ -18,14 +18,14 @@
 import matplotlib.cbook as cbook
 
 # load up some sample financial data
-r = cbook.get_sample_data('goog.npz')['price_data'].view(np.recarray)
+r = cbook.get_sample_data('goog.npz')['price_data']
 # create two subplots with the shared x and y axes
 fig, (ax1, ax2) = plt.subplots(1, 2, sharex=True, sharey=True)
 
-pricemin = r.close.min()
+pricemin = r["close"].min()
 
-ax1.plot(r.date, r.close, lw=2)
-ax2.fill_between(r.date, pricemin, r.close, alpha=0.7)
+ax1.plot(r["date"], r["close"], lw=2)
+ax2.fill_between(r["date"], pricemin, r["close"], alpha=0.7)
 
 for ax in ax1, ax2:
     ax.grid(True)
diff --git a/galleries/examples/lines_bars_and_markers/scatter_demo2.py b/galleries/examples/lines_bars_and_markers/scatter_demo2.py
index 0a9eee4f2b53..c3d57c423d69 100644
--- a/galleries/examples/lines_bars_and_markers/scatter_demo2.py
+++ b/galleries/examples/lines_bars_and_markers/scatter_demo2.py
@@ -14,14 +14,14 @@
 # low, close, volume, adj_close from the mpl-data/sample_data directory. The
 # record array stores the date as an np.datetime64 with a day unit ('D') in
 # the date column.
-price_data = cbook.get_sample_data('goog.npz')['price_data'].view(np.recarray)
+price_data = cbook.get_sample_data('goog.npz')['price_data']
 price_data = price_data[-250:]  # get the most recent 250 trading days
 
-delta1 = np.diff(price_data.adj_close) / price_data.adj_close[:-1]
+delta1 = np.diff(price_data["adj_close"]) / price_data["adj_close"][:-1]
 
 # Marker size in units of points^2
-volume = (15 * price_data.volume[:-2] / price_data.volume[0])**2
-close = 0.003 * price_data.close[:-2] / 0.003 * price_data.open[:-2]
+volume = (15 * price_data["volume"][:-2] / price_data["volume"][0])**2
+close = 0.003 * price_data["close"][:-2] / 0.003 * price_data["open"][:-2]
 
 fig, ax = plt.subplots()
 ax.scatter(delta1[:-1], delta1[1:], c=close, s=volume, alpha=0.5)
diff --git a/galleries/examples/misc/keyword_plotting.py b/galleries/examples/misc/keyword_plotting.py
index 4e0f3e61037d..e8a2d944fe0d 100644
--- a/galleries/examples/misc/keyword_plotting.py
+++ b/galleries/examples/misc/keyword_plotting.py
@@ -3,13 +3,14 @@
 Plotting with keywords
 ======================
 
-There are some instances where you have data in a format that lets you
-access particular variables with strings: for example, with
-`numpy.recarray` or `pandas.DataFrame`.
+Some data structures, like dict, `structured numpy array
+<https://numpy.org/doc/stable/user/basics.rec.html#structured-arrays>`_
+or `pandas.DataFrame` provide access to labelled data via string index access
+``data[key]``.
 
-Matplotlib allows you to provide such an object with the ``data`` keyword
-argument. If provided, you may generate plots with the strings
-corresponding to these variables.
+For these data types, Matplotlib supports passing the whole datastructure via the
+``data`` keyword argument, and using the string names as plot function parameters,
+where you'd normally pass in your data.
 """
 
 import matplotlib.pyplot as plt
diff --git a/galleries/examples/ticks/centered_ticklabels.py b/galleries/examples/ticks/centered_ticklabels.py
index 21c81e43d1f2..ab9e1b56c4e6 100644
--- a/galleries/examples/ticks/centered_ticklabels.py
+++ b/galleries/examples/ticks/centered_ticklabels.py
@@ -18,18 +18,17 @@
 """
 
 import matplotlib.pyplot as plt
-import numpy as np
 
 import matplotlib.cbook as cbook
 import matplotlib.dates as dates
 import matplotlib.ticker as ticker
 
 # Load some financial data; Google's stock price
-r = cbook.get_sample_data('goog.npz')['price_data'].view(np.recarray)
+r = cbook.get_sample_data('goog.npz')['price_data']
 r = r[-250:]  # get the last 250 days
 
 fig, ax = plt.subplots()
-ax.plot(r.date, r.adj_close)
+ax.plot(r["date"], r["adj_close"])
 
 ax.xaxis.set_major_locator(dates.MonthLocator())
 # 16 is a slight approximation since months differ in number of days.
@@ -45,5 +44,5 @@
 for label in ax.get_xticklabels(minor=True):
     label.set_horizontalalignment('center')
 imid = len(r) // 2
-ax.set_xlabel(str(r.date[imid].item().year))
+ax.set_xlabel(str(r["date"][imid].item().year))
 plt.show()
diff --git a/galleries/examples/ticks/date_index_formatter.py b/galleries/examples/ticks/date_index_formatter.py
index 4c48ac5ace7a..c5bc6abaf17f 100644
--- a/galleries/examples/ticks/date_index_formatter.py
+++ b/galleries/examples/ticks/date_index_formatter.py
@@ -21,23 +21,23 @@
 import matplotlib.lines as ml
 from matplotlib.ticker import Formatter
 
-# Load a numpy record array from yahoo csv data with fields date, open, high,
+# Load a structured numpy array from yahoo csv data with fields date, open, high,
 # low, close, volume, adj_close from the mpl-data/sample_data directory. The
 # record array stores the date as an np.datetime64 with a day unit ('D') in
-# the date column (``r.date``).
-r = cbook.get_sample_data('goog.npz')['price_data'].view(np.recarray)
+# the date column (``r['date']``).
+r = cbook.get_sample_data('goog.npz')['price_data']
 r = r[:9]  # get the first 9 days
 
 fig, (ax1, ax2) = plt.subplots(nrows=2, figsize=(6, 6), layout='constrained')
 fig.get_layout_engine().set(hspace=0.15)
 
 # First we'll do it the default way, with gaps on weekends
-ax1.plot(r.date, r.adj_close, 'o-')
+ax1.plot(r["date"], r["adj_close"], 'o-')
 
 # Highlight gaps in daily data
-gaps = np.flatnonzero(np.diff(r.date) > np.timedelta64(1, 'D'))
+gaps = np.flatnonzero(np.diff(r["date"]) > np.timedelta64(1, 'D'))
 for gap in r[['date', 'adj_close']][np.stack((gaps, gaps + 1)).T]:
-    ax1.plot(gap.date, gap.adj_close, 'w--', lw=2)
+    ax1.plot(gap['date'], gap['adj_close'], 'w--', lw=2)
 ax1.legend(handles=[ml.Line2D([], [], ls='--', label='Gaps in daily data')])
 
 ax1.set_title("Plot y at x Coordinates")
@@ -51,12 +51,12 @@
 def format_date(x, _):
     try:
         # convert datetime64 to datetime, and use datetime's strftime:
-        return r.date[round(x)].item().strftime('%a')
+        return r["date"][round(x)].item().strftime('%a')
     except IndexError:
         pass
 
 # Create an index plot (x defaults to range(len(y)) if omitted)
-ax2.plot(r.adj_close, 'o-')
+ax2.plot(r["adj_close"], 'o-')
 
 ax2.set_title("Plot y at Index Coordinates Using Custom Formatter")
 ax2.xaxis.set_major_formatter(format_date)  # internally creates FuncFormatter
@@ -79,6 +79,6 @@ def __call__(self, x, pos=0):
             pass
 
 
-ax2.xaxis.set_major_formatter(MyFormatter(r.date, '%a'))
+ax2.xaxis.set_major_formatter(MyFormatter(r["date"], '%a'))
 
 plt.show()
diff --git a/galleries/tutorials/pyplot.py b/galleries/tutorials/pyplot.py
index b6e02041afa0..3c9f65a68c57 100644
--- a/galleries/tutorials/pyplot.py
+++ b/galleries/tutorials/pyplot.py
@@ -106,8 +106,10 @@
 # =============================
 #
 # There are some instances where you have data in a format that lets you
-# access particular variables with strings. For example, with
-# `numpy.recarray` or `pandas.DataFrame`.
+# access particular variables with strings. For example, with `structured arrays`_
+# or `pandas.DataFrame`.
+#
+# .. _structured arrays: https://numpy.org/doc/stable/user/basics.rec.html#structured-arrays
 #
 # Matplotlib allows you to provide such an object with
 # the ``data`` keyword argument. If provided, then you may generate plots with
diff --git a/galleries/users_explain/quick_start.py b/galleries/users_explain/quick_start.py
index cf2d5850e6e5..16d0165ec7a6 100644
--- a/galleries/users_explain/quick_start.py
+++ b/galleries/users_explain/quick_start.py
@@ -126,10 +126,13 @@
 #   b = np.matrix([[1, 2], [3, 4]])
 #   b_asarray = np.asarray(b)
 #
-# Most methods will also parse an addressable object like a *dict*, a
-# `numpy.recarray`, or a `pandas.DataFrame`.  Matplotlib allows you to
-# provide the ``data`` keyword argument and generate plots passing the
+# Most methods will also parse a string-indexable object like a *dict*, a
+# `structured numpy array`_, or a `pandas.DataFrame`.  Matplotlib allows you
+# to provide the ``data`` keyword argument and generate plots passing the
 # strings corresponding to the *x* and *y* variables.
+#
+# .. _structured numpy array: <https://numpy.org/doc/stable/user/basics.rec.html#structured-arrays>`_  # noqa: E501
+
 np.random.seed(19680801)  # seed the random number generator.
 data = {'a': np.arange(50),
         'c': np.random.randint(0, 50, 50),

From 448e9f6ffabdb44d3a1d0ddfa6d39908d550a2ca Mon Sep 17 00:00:00 2001
From: Jody Klymak <jklymak@gmail.com>
Date: Thu, 31 Aug 2023 11:10:15 -0700
Subject: [PATCH 0131/1120] DOC: organize figure API [ci doc]

---
 doc/api/figure_api.rst                        | 303 +++++++++++++++++-
 .../prev_api_changes/api_changes_3.4.2.rst    |   2 +-
 .../api_changes_3.5.0/behaviour.rst           |   2 +-
 doc/users/prev_whats_new/whats_new_3.4.0.rst  |   4 +-
 .../subplots_axes_and_figures/figure_title.py |  10 +-
 .../gridspec_nested.py                        |   2 +-
 .../users_explain/axes/arranging_axes.py      |   2 +
 .../users_explain/figure/figure_intro.rst     |  16 +-
 galleries/users_explain/figure/index.rst      |   2 +
 lib/matplotlib/artist.py                      |   8 +-
 lib/matplotlib/figure.py                      |  24 +-
 11 files changed, 344 insertions(+), 31 deletions(-)

diff --git a/doc/api/figure_api.rst b/doc/api/figure_api.rst
index 1beb0a701b26..84d068f5c3af 100644
--- a/doc/api/figure_api.rst
+++ b/doc/api/figure_api.rst
@@ -5,5 +5,304 @@
 .. currentmodule:: matplotlib.figure
 
 .. automodule:: matplotlib.figure
-   :members:
-   :inherited-members:
+   :no-members:
+   :no-undoc-members:
+
+The Figure class
+================
+.. autosummary::
+   :toctree: _as_gen
+   :template: autosummary_class_only.rst
+   :nosignatures:
+
+   Figure
+
+
+Adding Axes and SubFigures
+==========================
+
+.. autosummary::
+   :toctree: _as_gen
+   :template: autosummary.rst
+   :nosignatures:
+
+   Figure.add_axes
+   Figure.add_subplot
+   Figure.subplots
+   Figure.subplot_mosaic
+   Figure.add_gridspec
+   Figure.get_axes
+   Figure.axes
+   Figure.delaxes
+   Figure.subfigures
+   Figure.add_subfigure
+
+Saving
+======
+
+.. autosummary::
+   :toctree: _as_gen
+   :template: autosummary.rst
+   :nosignatures:
+
+   Figure.savefig
+
+
+Annotating
+==========
+
+.. autosummary::
+   :toctree: _as_gen
+   :template: autosummary.rst
+   :nosignatures:
+
+   Figure.colorbar
+   Figure.legend
+   Figure.text
+   Figure.suptitle
+   Figure.get_suptitle
+   Figure.supxlabel
+   Figure.get_supxlabel
+   Figure.supylabel
+   Figure.get_supylabel
+   Figure.align_labels
+   Figure.align_xlabels
+   Figure.align_ylabels
+   Figure.autofmt_xdate
+
+
+Figure geometry
+===============
+
+.. autosummary::
+   :toctree: _as_gen
+   :template: autosummary.rst
+   :nosignatures:
+
+   Figure.set_size_inches
+   Figure.get_size_inches
+   Figure.set_figheight
+   Figure.get_figheight
+   Figure.set_figwidth
+   Figure.get_figwidth
+   Figure.dpi
+   Figure.set_dpi
+   Figure.set_dpi
+
+Subplot layout
+==============
+
+.. autosummary::
+   :toctree: _as_gen
+   :template: autosummary.rst
+   :nosignatures:
+
+   Figure.subplots_adjust
+   Figure.set_layout_engine
+   Figure.get_layout_engine
+
+Discouraged or deprecated
+-------------------------
+
+.. autosummary::
+   :toctree: _as_gen
+   :template: autosummary.rst
+   :nosignatures:
+
+   Figure.tight_layout
+   Figure.set_tight_layout
+   Figure.get_tight_layout
+   Figure.set_constrained_layout
+   Figure.get_constrained_layout
+   Figure.set_constrained_layout_pads
+   Figure.get_constrained_layout_pads
+
+Interactive
+===========
+
+.. seealso::
+
+   - :ref:`event-handling`
+
+.. autosummary::
+   :toctree: _as_gen
+   :template: autosummary.rst
+   :nosignatures:
+
+   Figure.ginput
+   Figure.add_axobserver
+   Figure.waitforbuttonpress
+   Figure.pick
+
+Modifying appearance
+====================
+
+.. autosummary::
+   :toctree: _as_gen
+   :template: autosummary.rst
+   :nosignatures:
+
+   Figure.set_frameon
+   Figure.get_frameon
+   Figure.set_linewidth
+   Figure.get_linewidth
+   Figure.set_facecolor
+   Figure.get_facecolor
+   Figure.set_edgecolor
+   Figure.get_edgecolor
+
+Adding and getting Artists
+==========================
+
+.. autosummary::
+   :toctree: _as_gen
+   :template: autosummary.rst
+   :nosignatures:
+
+   Figure.add_artist
+   Figure.get_children
+   Figure.figimage
+
+Getting and modifying state
+===========================
+
+.. seealso::
+
+   - :ref:`interactive_figures`
+
+.. autosummary::
+   :toctree: _as_gen
+   :template: autosummary.rst
+   :nosignatures:
+
+   Figure.clear
+   Figure.gca
+   Figure.sca
+   Figure.get_tightbbox
+   Figure.get_window_extent
+   Figure.show
+   Figure.set_canvas
+   Figure.draw
+   Figure.draw_without_rendering
+   Figure.draw_artist
+
+.. _figure-api-subfigure:
+
+SubFigure
+=========
+
+Matplotlib has the concept of a `~.SubFigure`, which is a logical figure inside
+a parent `~.Figure`.  It has many of the same methods as the parent.  See
+:ref:`nested_axes_layouts`.
+
+.. plot::
+
+   fig = plt.figure(layout='constrained', figsize=(4, 2.5), facecolor='lightgoldenrodyellow')
+
+   # Make two subfigures, left ones more narrow than right ones:
+   sfigs = fig.subfigures(1, 2, width_ratios=[0.8, 1])
+   sfigs[0].set_facecolor('khaki')
+   sfigs[1].set_facecolor('lightsalmon')
+
+   # Add subplots to left subfigure:
+   lax = sfigs[0].subplots(2, 1)
+   sfigs[0].suptitle('Left subfigure')
+
+   # Add subplots to right subfigure:
+   rax = sfigs[1].subplots(1, 2)
+   sfigs[1].suptitle('Right subfigure')
+
+   # suptitle for the main figure:
+   fig.suptitle('Figure')
+
+SubFigure class
+---------------
+
+.. autosummary::
+   :toctree: _as_gen
+   :template: autosummary_class_only.rst
+   :nosignatures:
+
+   SubFigure
+
+Adding Axes and SubFigures
+--------------------------
+.. autosummary::
+   :toctree: _as_gen
+   :template: autosummary.rst
+   :nosignatures:
+
+   SubFigure.add_axes
+   SubFigure.add_subplot
+   SubFigure.subplots
+   SubFigure.subplot_mosaic
+   SubFigure.add_gridspec
+   SubFigure.delaxes
+   SubFigure.add_subfigure
+   SubFigure.subfigures
+
+Annotating
+----------
+
+.. autosummary::
+   :toctree: _as_gen
+   :template: autosummary.rst
+   :nosignatures:
+
+   SubFigure.colorbar
+   SubFigure.legend
+   SubFigure.text
+   SubFigure.suptitle
+   SubFigure.get_suptitle
+   SubFigure.supxlabel
+   SubFigure.get_supxlabel
+   SubFigure.supylabel
+   SubFigure.get_supylabel
+   SubFigure.align_labels
+   SubFigure.align_xlabels
+   SubFigure.align_ylabels
+
+Adding and getting Artists
+--------------------------
+
+.. autosummary::
+   :toctree: _as_gen
+   :template: autosummary.rst
+   :nosignatures:
+
+   SubFigure.add_artist
+   SubFigure.get_children
+
+Modifying appearance
+--------------------
+
+.. autosummary::
+   :toctree: _as_gen
+   :template: autosummary.rst
+   :nosignatures:
+
+   SubFigure.set_frameon
+   SubFigure.get_frameon
+   SubFigure.set_linewidth
+   SubFigure.get_linewidth
+   SubFigure.set_facecolor
+   SubFigure.get_facecolor
+   SubFigure.set_edgecolor
+   SubFigure.get_edgecolor
+
+Passthroughs
+------------
+
+.. autosummary::
+   :toctree: _as_gen
+   :template: autosummary.rst
+   :nosignatures:
+
+   SubFigure.set_dpi
+   SubFigure.get_dpi
+
+
+FigureBase parent class
+=======================
+
+.. autoclass:: FigureBase
diff --git a/doc/api/prev_api_changes/api_changes_3.4.2.rst b/doc/api/prev_api_changes/api_changes_3.4.2.rst
index 2de543be37d6..34d760bf0941 100644
--- a/doc/api/prev_api_changes/api_changes_3.4.2.rst
+++ b/doc/api/prev_api_changes/api_changes_3.4.2.rst
@@ -7,7 +7,7 @@ Behaviour changes
 Rename first argument to ``subplot_mosaic``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Both `.FigureBase.subplot_mosaic`, and `.pyplot.subplot_mosaic` have had the
+Both `.Figure.subplot_mosaic`, and `.pyplot.subplot_mosaic` have had the
 first position argument renamed from *layout* to *mosaic*.  This is because we
 are considering to consolidate *constrained_layout* and *tight_layout* keyword
 arguments in the Figure creation functions of `.pyplot` into a single *layout*
diff --git a/doc/api/prev_api_changes/api_changes_3.5.0/behaviour.rst b/doc/api/prev_api_changes/api_changes_3.5.0/behaviour.rst
index 69e38270ca76..278cad0a29c1 100644
--- a/doc/api/prev_api_changes/api_changes_3.5.0/behaviour.rst
+++ b/doc/api/prev_api_changes/api_changes_3.5.0/behaviour.rst
@@ -4,7 +4,7 @@ Behaviour changes
 First argument to ``subplot_mosaic`` renamed
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Both `.FigureBase.subplot_mosaic`, and `.pyplot.subplot_mosaic` have had the
+Both `.Figure.subplot_mosaic`, and `.pyplot.subplot_mosaic` have had the
 first positional argument renamed from *layout* to *mosaic*. As we have
 consolidated the *constrained_layout* and *tight_layout* keyword arguments in
 the Figure creation functions of `.pyplot` into a single *layout* keyword
diff --git a/doc/users/prev_whats_new/whats_new_3.4.0.rst b/doc/users/prev_whats_new/whats_new_3.4.0.rst
index f90a95c7f126..707b43ab73b9 100644
--- a/doc/users/prev_whats_new/whats_new_3.4.0.rst
+++ b/doc/users/prev_whats_new/whats_new_3.4.0.rst
@@ -634,8 +634,8 @@ supxlabel and supylabel
 -----------------------
 
 It is possible to add x- and y-labels to a whole figure, analogous to
-`.FigureBase.suptitle` using the new `.FigureBase.supxlabel` and
-`.FigureBase.supylabel` methods.
+`.Figure.suptitle` using the new `.Figure.supxlabel` and
+`.Figure.supylabel` methods.
 
 .. plot::
 
diff --git a/galleries/examples/subplots_axes_and_figures/figure_title.py b/galleries/examples/subplots_axes_and_figures/figure_title.py
index bc8a90366d8e..118157f0579c 100644
--- a/galleries/examples/subplots_axes_and_figures/figure_title.py
+++ b/galleries/examples/subplots_axes_and_figures/figure_title.py
@@ -5,10 +5,10 @@
 
 Each axes can have a title (or actually three - one each with *loc* "left",
 "center", and "right"), but is sometimes desirable to give a whole figure
-(or `.SubFigure`) an overall title, using `.FigureBase.suptitle`.
+(or `.SubFigure`) an overall title, using `.Figure.suptitle`.
 
-We can also add figure-level x- and y-labels using `.FigureBase.supxlabel` and
-`.FigureBase.supylabel`.
+We can also add figure-level x- and y-labels using `.Figure.supxlabel` and
+`.Figure.supylabel`.
 """
 
 import matplotlib.pyplot as plt
@@ -31,8 +31,8 @@
 fig.suptitle('Different types of oscillations', fontsize=16)
 
 # %%
-# A global x- or y-label can be set using the `.FigureBase.supxlabel` and
-# `.FigureBase.supylabel` methods.
+# A global x- or y-label can be set using the `.Figure.supxlabel` and
+# `.Figure.supylabel` methods.
 
 
 with get_sample_data('Stocks.csv') as file:
diff --git a/galleries/examples/subplots_axes_and_figures/gridspec_nested.py b/galleries/examples/subplots_axes_and_figures/gridspec_nested.py
index a2750a0ecb49..bfcb90cdfc4a 100644
--- a/galleries/examples/subplots_axes_and_figures/gridspec_nested.py
+++ b/galleries/examples/subplots_axes_and_figures/gridspec_nested.py
@@ -7,7 +7,7 @@
 set the position for a nested grid of subplots.
 
 Note that the same functionality can be achieved more directly with
-`~.FigureBase.subfigures`; see
+`~.Figure.subfigures`; see
 :doc:`/gallery/subplots_axes_and_figures/subfigures`.
 
 """
diff --git a/galleries/users_explain/axes/arranging_axes.py b/galleries/users_explain/axes/arranging_axes.py
index 79b69f4bf3dd..8068d3b92ad3 100644
--- a/galleries/users_explain/axes/arranging_axes.py
+++ b/galleries/users_explain/axes/arranging_axes.py
@@ -228,6 +228,8 @@ def annotate_axes(ax, text, fontsize=18):
 fig.suptitle('plt.subplot_mosaic()')
 
 # %%
+# .. _nested_axes_layouts:
+#
 # Nested Axes layouts
 # -------------------
 #
diff --git a/galleries/users_explain/figure/figure_intro.rst b/galleries/users_explain/figure/figure_intro.rst
index 745b01566427..5f7db3d0202c 100644
--- a/galleries/users_explain/figure/figure_intro.rst
+++ b/galleries/users_explain/figure/figure_intro.rst
@@ -197,15 +197,15 @@ common cases.
 Adding Artists
 --------------
 
-The `~.FigureBase` class has a number of methods to add artists to a `~.Figure` or
+The `~.Figure` class has a number of methods for adding artists to a `~.Figure` or
 a `~.SubFigure`.  By far the most common are to add Axes of various configurations
-(`~.FigureBase.add_axes`, `~.FigureBase.add_subplot`, `~.FigureBase.subplots`,
-`~.FigureBase.subplot_mosaic`) and subfigures (`~.FigureBase.subfigures`).  Colorbars
-are added to Axes or group of Axes at the Figure level (`~.FigureBase.colorbar`).
-It is also possible to have a Figure-level legend (`~.FigureBase.legend`).
-Other Artists include figure-wide labels (`~.FigureBase.suptitle`,
-`~.FigureBase.supxlabel`, `~.FigureBase.supylabel`) and text (`~.FigureBase.text`).
-Finally, low-level Artists can be added directly using `~.FigureBase.add_artist`
+(`~.Figure.add_axes`, `~.Figure.add_subplot`, `~.Figure.subplots`,
+`~.Figure.subplot_mosaic`) and subfigures (`~.Figure.subfigures`).  Colorbars
+are added to Axes or group of Axes at the Figure level (`~.Figure.colorbar`).
+It is also possible to have a Figure-level legend (`~.Figure.legend`).
+Other Artists include figure-wide labels (`~.Figure.suptitle`,
+`~.Figure.supxlabel`, `~.Figure.supylabel`) and text (`~.Figure.text`).
+Finally, low-level Artists can be added directly using `~.Figure.add_artist`
 usually with care being taken to use the appropriate transform.  Usually these
 include ``Figure.transFigure`` which ranges from 0 to 1 in each direction, and
 represents the fraction of the current Figure size, or ``Figure.dpi_scale_trans``
diff --git a/galleries/users_explain/figure/index.rst b/galleries/users_explain/figure/index.rst
index 4433246e4074..753c24b62a5c 100644
--- a/galleries/users_explain/figure/index.rst
+++ b/galleries/users_explain/figure/index.rst
@@ -1,3 +1,5 @@
+.. _figures_and_backends:
+
 ++++++++++++++++++++
 Figures and backends
 ++++++++++++++++++++
diff --git a/lib/matplotlib/artist.py b/lib/matplotlib/artist.py
index 04eaa6cf75df..4a495531d900 100644
--- a/lib/matplotlib/artist.py
+++ b/lib/matplotlib/artist.py
@@ -506,7 +506,7 @@ def pickable(self):
 
         See Also
         --------
-        set_picker, get_picker, pick
+        .Artist.set_picker, .Artist.get_picker, .Artist.pick
         """
         return self.figure is not None and self._picker is not None
 
@@ -519,7 +519,7 @@ def pick(self, mouseevent):
 
         See Also
         --------
-        set_picker, get_picker, pickable
+        .Artist.set_picker, .Artist.get_picker, .Artist.pickable
         """
         from .backend_bases import PickEvent  # Circular import.
         # Pick self
@@ -586,11 +586,11 @@ def get_picker(self):
         """
         Return the picking behavior of the artist.
 
-        The possible values are described in `.set_picker`.
+        The possible values are described in `.Artist.set_picker`.
 
         See Also
         --------
-        set_picker, pickable, pick
+        .Artist.set_picker, .Artist.pickable, .Artist.pick
         """
         return self._picker
 
diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
index d37dda204278..c750095aee18 100644
--- a/lib/matplotlib/figure.py
+++ b/lib/matplotlib/figure.py
@@ -1438,8 +1438,12 @@ def align_labels(self, axs=None):
 
     def add_gridspec(self, nrows=1, ncols=1, **kwargs):
         """
-        Return a `.GridSpec` that has this figure as a parent.  This allows
-        complex layout of Axes in the figure.
+        Low-level API for creating a `.GridSpec` that has this figure as a parent.
+
+        This is a low-level API, allowing you to create a gridspec and
+        subsequently add subplots based on the gridspec. Most users do
+        not need that freedom and should use the higher-level methods
+        `~.Figure.subplots` or `~.Figure.subplot_mosaic`.
 
         Parameters
         ----------
@@ -1663,6 +1667,9 @@ def _process_projection_requirements(self, *, axes_class=None, polar=False,
         return projection_class, kwargs
 
     def get_default_bbox_extra_artists(self):
+        """
+        Return a list of Artists typically used in `.Figure.get_tightbbox`.
+        """
         bbox_artists = [artist for artist in self.get_children()
                         if (artist.get_visible() and artist.get_in_layout())]
         for ax in self.axes:
@@ -2088,6 +2095,7 @@ class SubFigure(FigureBase):
     """
     Logical figure that can be placed inside a figure.
 
+    See :ref:`figure-api-subfigure` for an index of methods on this class.
     Typically instantiated using `.Figure.add_subfigure` or
     `.SubFigure.add_subfigure`, or `.SubFigure.subfigures`.  A subfigure has
     the same methods as a figure except for those particularly tied to the size
@@ -2299,6 +2307,8 @@ class Figure(FigureBase):
     """
     The top level container for all the plot elements.
 
+    See `matplotlib.figure` for an index of class methods.
+
     Attributes
     ----------
     patch
@@ -2715,21 +2725,21 @@ def _set_dpi(self, dpi, forward=True):
     dpi = property(_get_dpi, _set_dpi, doc="The resolution in dots per inch.")
 
     def get_tight_layout(self):
-        """Return whether `.tight_layout` is called when drawing."""
+        """Return whether `.Figure.tight_layout` is called when drawing."""
         return isinstance(self.get_layout_engine(), TightLayoutEngine)
 
     @_api.deprecated("3.6", alternative="set_layout_engine",
                      pending=True)
     def set_tight_layout(self, tight):
         """
-        Set whether and how `.tight_layout` is called when drawing.
+        Set whether and how `.Figure.tight_layout` is called when drawing.
 
         Parameters
         ----------
         tight : bool or dict with keys "pad", "w_pad", "h_pad", "rect" or None
-            If a bool, sets whether to call `.tight_layout` upon drawing.
+            If a bool, sets whether to call `.Figure.tight_layout` upon drawing.
             If ``None``, use :rc:`figure.autolayout` instead.
-            If a dict, pass it as kwargs to `.tight_layout`, overriding the
+            If a dict, pass it as kwargs to `.Figure.tight_layout`, overriding the
             default paddings.
         """
         if tight is None:
@@ -3170,7 +3180,7 @@ def add_axobserver(self, func):
 
     def savefig(self, fname, *, transparent=None, **kwargs):
         """
-        Save the current figure.
+        Save the current figure as an image or vector graphic to a file.
 
         Call signature::
 

From 55dee1230ce38e31f3db74f491241357f59f4566 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Thu, 14 Sep 2023 22:27:40 -0400
Subject: [PATCH 0132/1120] use inline to ignore role in file instead of
 ignoring error

---
 galleries/users_explain/text/mathtext.py | 1 +
 pyproject.toml                           | 2 --
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/galleries/users_explain/text/mathtext.py b/galleries/users_explain/text/mathtext.py
index 09c049d4a833..067a332aa54a 100644
--- a/galleries/users_explain/text/mathtext.py
+++ b/galleries/users_explain/text/mathtext.py
@@ -221,6 +221,7 @@
 # ``\mathcal{CALLIGRAPHY}`` :mathmpl:`\mathcal{CALLIGRAPHY}`
 # ========================= ================================
 #
+# .. rstcheck: ignore-directives=role
 # .. role:: math-stix(mathmpl)
 #    :fontset: stix
 #
diff --git a/pyproject.toml b/pyproject.toml
index f52b96e1cd67..5c61dd9ff055 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -200,6 +200,4 @@ ignore_messages = [
     "Hyperlink target \".*\" is not referenced.",
     "Duplicate implicit target name: \".*\".",
     "Duplicate explicit target name: \".*\".",
-    # error in role directive is `.. role:: math-stix(mathmpl)
-    "Error in \"role\" directive:",
 ]

From e6805e67d60dbf79b016519d07cf0d5accb6e75e Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Thu, 14 Sep 2023 22:38:08 -0400
Subject: [PATCH 0133/1120] axis artist param table in simple table format

---
 .../users_explain/toolkits/axisartist.rst     | 69 ++++---------------
 1 file changed, 12 insertions(+), 57 deletions(-)

diff --git a/galleries/users_explain/toolkits/axisartist.rst b/galleries/users_explain/toolkits/axisartist.rst
index f27839956282..313a0fb5a9e9 100644
--- a/galleries/users_explain/toolkits/axisartist.rst
+++ b/galleries/users_explain/toolkits/axisartist.rst
@@ -341,63 +341,18 @@ On the other hand, there is a concept of "axis_direction". This is a
 default setting of above properties for each, "bottom", "left", "top",
 and "right" axis.
 
-.. list-table::
-
-  * -
-    -
-    - left
-    - bottom
-    - right
-    - top
-  * - axislabel
-    - direction
-    - '-'
-    - '+'
-    - '+'
-    - '-'
-  * - axislabel
-    - rotation
-    - 180
-    - 0
-    - 0
-    - 180
-  * - axislabel
-    - va
-    - center
-    - top
-    - center
-    - bottom
-  * - axislabel
-    - ha
-    - right
-    - center
-    - right
-    - center
-  * - ticklabel
-    - direction
-    - '-'
-    - '+'
-    - '+'
-    - '-'
-  * - ticklabels
-    - rotation
-    - 90
-    - 0
-    - -90
-    - 180
-  * - ticklabel
-    - ha
-    - right
-    - center
-    - right
-    - center
-  * - ticklabel
-    - va
-    - center
-    - baseline
-    - center
-    - baseline
-
+========== ========== ========= ========== ========= ==========
+label type  parameter    left      bottom      right      top
+========== ========== ========= ========== ========= ==========
+axislabel   direction      '-'       '+'        '+'      '-'
+axislabel   rotation      180         0          0       180
+axislabel   va           center    top       center     bottom
+axislabel   ha           right    center      right     center
+ticklabel   direction      '-'       '+'        '+'      '-'
+ticklabel   rotation       90         0        -90       180
+ticklabel   ha           right    center      right     center
+ticklabel   va           center   baseline    center   baseline
+========== ========== ========= ========== ========= ==========
 
 And, 'set_axis_direction("top")' means to adjust the text rotation
 etc, for settings suitable for "top" axis. The concept of axis

From 4f7d68f7aaadb65f8880d3c18de81f311e628235 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Thu, 14 Sep 2023 22:45:52 -0400
Subject: [PATCH 0134/1120] ghpull directive

---
 doc/api/prev_api_changes/api_changes_2.1.2.rst | 6 +++---
 doc/devel/MEP/MEP23.rst                        | 4 ++--
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/doc/api/prev_api_changes/api_changes_2.1.2.rst b/doc/api/prev_api_changes/api_changes_2.1.2.rst
index a043a99942bd..92a72523443d 100644
--- a/doc/api/prev_api_changes/api_changes_2.1.2.rst
+++ b/doc/api/prev_api_changes/api_changes_2.1.2.rst
@@ -12,9 +12,9 @@ list of conditions was incomplete, didn't handle RGB tuples,
 didn't handle linewidths or linestyles etc.
 
 This logic did not exist in `.axes.Axes.legend`.  It was included (erroneously)
-in Matplotlib 2.1.1 when the legend argument parsing was unified
-`#9324 <https://github.com/matplotlib/matplotlib/pull/9324>`_.  This change
-removes that check in `.axes.Axes.legend` again to restore the old behavior.
+in Matplotlib 2.1.1 when the legend argument parsing was unified :ghpull:`9324`.  
+This change removes that check in `.axes.Axes.legend` again to restore the old 
+behavior.
 
 This logic has also been dropped from `.Figure.legend`, where it
 was previously undocumented. Repeated
diff --git a/doc/devel/MEP/MEP23.rst b/doc/devel/MEP/MEP23.rst
index 1c06978eb8bc..d6b342877959 100644
--- a/doc/devel/MEP/MEP23.rst
+++ b/doc/devel/MEP/MEP23.rst
@@ -34,8 +34,8 @@ This is and may continue to be the desired method of operation for
 most use cases.
 
 Sometimes when there are too many figures open at the same time, it is
-desirable to be able to group these under the same window
-`see <https://github.com/matplotlib/matplotlib/issues/2194>`_.
+desirable to be able to group these under the same window. See :ghpull:`2194`.
+
 
 The proposed solution modifies `.FigureManagerBase` to contain and manage more
 than one ``Canvas``. The settings parameter :rc:`backend.multifigure` control

From e245ad90074cb1d890b0621496446bccf55fdccf Mon Sep 17 00:00:00 2001
From: katotaisei <katotaisei064@gmail.com>
Date: Fri, 15 Sep 2023 14:23:54 +0900
Subject: [PATCH 0135/1120] fix Axes.errorbar docstring

---
 lib/matplotlib/axes/_axes.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 2b1f1bddfc6f..9997e660f40c 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -3382,7 +3382,7 @@ def errorbar(self, x, y, yerr=None, xerr=None,
         Plot y versus x as lines and/or markers with attached errorbars.
 
         *x*, *y* define the data locations, *xerr*, *yerr* define the errorbar
-        sizes. By default, this draws the data markers/lines as well the
+        sizes. By default, this draws the data markers/lines as well as the
         errorbars. Use fmt='none' to draw errorbars without any data markers.
 
         .. versionadded:: 3.7

From 6811d37fab1b839c654189687fc9aeac7eeba85b Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Fri, 15 Sep 2023 19:01:19 +0200
Subject: [PATCH 0136/1120] Remove unused Axis private init helpers.

These were deprecated in c3f87d4 and later made unused, but not removed.
---
 lib/matplotlib/axis.py | 15 ---------------
 1 file changed, 15 deletions(-)

diff --git a/lib/matplotlib/axis.py b/lib/matplotlib/axis.py
index 56d4e6b77dc6..4c9bc8f064fe 100644
--- a/lib/matplotlib/axis.py
+++ b/lib/matplotlib/axis.py
@@ -265,21 +265,6 @@ def get_pad(self):
         """Get the value of the tick label pad in points."""
         return self._base_pad
 
-    def _get_text1(self):
-        """Get the default Text 1 instance."""
-
-    def _get_text2(self):
-        """Get the default Text 2 instance."""
-
-    def _get_tick1line(self):
-        """Get the default `.Line2D` instance for tick1."""
-
-    def _get_tick2line(self):
-        """Get the default `.Line2D` instance for tick2."""
-
-    def _get_gridline(self):
-        """Get the default grid `.Line2D` instance for this tick."""
-
     def get_loc(self):
         """Return the tick location (data coords) as a scalar."""
         return self._loc

From c36c5a9a520ea3210b66c28f3c893b0a9fad076f Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Sun, 17 Sep 2023 12:05:10 +0200
Subject: [PATCH 0137/1120] Remove deprecated draw_gouraud_triangle

---
 .../next_api_changes/removals/26797-OG.rst    | 17 +++++++
 lib/matplotlib/backend_bases.py               | 18 --------
 lib/matplotlib/backend_bases.pyi              |  7 ---
 lib/matplotlib/backends/backend_agg.py        |  1 -
 lib/matplotlib/backends/backend_pdf.py        |  4 --
 lib/matplotlib/backends/backend_ps.py         |  5 ---
 lib/matplotlib/backends/backend_svg.py        |  4 --
 src/_backend_agg.h                            | 20 ---------
 src/_backend_agg_wrapper.cpp                  | 44 -------------------
 9 files changed, 17 insertions(+), 103 deletions(-)
 create mode 100644 doc/api/next_api_changes/removals/26797-OG.rst

diff --git a/doc/api/next_api_changes/removals/26797-OG.rst b/doc/api/next_api_changes/removals/26797-OG.rst
new file mode 100644
index 000000000000..680f69e01a96
--- /dev/null
+++ b/doc/api/next_api_changes/removals/26797-OG.rst
@@ -0,0 +1,17 @@
+``draw_gouraud_triangle``
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+... is removed. Use `~.RendererBase.draw_gouraud_triangles` instead.
+
+A ``draw_gouraud_triangle`` call in a custom `~matplotlib.artist.Artist` can readily be
+replaced as::
+
+    self.draw_gouraud_triangles(gc, points.reshape((1, 3, 2)),
+                                colors.reshape((1, 3, 4)), trans)
+
+A `~.RendererBase.draw_gouraud_triangles` method can be implemented from an
+existing ``draw_gouraud_triangle`` method as::
+
+    transform = transform.frozen()
+    for tri, col in zip(triangles_array, colors_array):
+        self.draw_gouraud_triangle(gc, tri, col, transform)
diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
index 49e067b02bfb..c07ad692451e 100644
--- a/lib/matplotlib/backend_bases.py
+++ b/lib/matplotlib/backend_bases.py
@@ -292,24 +292,6 @@ def draw_quad_mesh(self, gc, master_transform, meshWidth, meshHeight,
             gc, master_transform, paths, [], offsets, offsetTrans, facecolors,
             edgecolors, linewidths, [], [antialiased], [None], 'screen')
 
-    @_api.deprecated("3.7", alternative="draw_gouraud_triangles")
-    def draw_gouraud_triangle(self, gc, points, colors, transform):
-        """
-        Draw a Gouraud-shaded triangle.
-
-        Parameters
-        ----------
-        gc : `.GraphicsContextBase`
-            The graphics context.
-        points : (3, 2) array-like
-            Array of (x, y) points for the triangle.
-        colors : (3, 4) array-like
-            RGBA colors for each point of the triangle.
-        transform : `~matplotlib.transforms.Transform`
-            An affine transform to apply to the points.
-        """
-        raise NotImplementedError
-
     def draw_gouraud_triangles(self, gc, triangles_array, colors_array,
                                transform):
         """
diff --git a/lib/matplotlib/backend_bases.pyi b/lib/matplotlib/backend_bases.pyi
index 0ae88cf18a42..075d87a6edd8 100644
--- a/lib/matplotlib/backend_bases.pyi
+++ b/lib/matplotlib/backend_bases.pyi
@@ -77,13 +77,6 @@ class RendererBase:
         antialiased: bool,
         edgecolors: Sequence[ColorType] | ColorType | None,
     ) -> None: ...
-    def draw_gouraud_triangle(
-        self,
-        gc: GraphicsContextBase,
-        points: ArrayLike,
-        colors: ArrayLike,
-        transform: Transform,
-    ) -> None: ...
     def draw_gouraud_triangles(
         self,
         gc: GraphicsContextBase,
diff --git a/lib/matplotlib/backends/backend_agg.py b/lib/matplotlib/backends/backend_agg.py
index 470ce9d925ad..92253c02c1b5 100644
--- a/lib/matplotlib/backends/backend_agg.py
+++ b/lib/matplotlib/backends/backend_agg.py
@@ -84,7 +84,6 @@ def __setstate__(self, state):
         self.__init__(state['width'], state['height'], state['dpi'])
 
     def _update_methods(self):
-        self.draw_gouraud_triangle = self._renderer.draw_gouraud_triangle
         self.draw_gouraud_triangles = self._renderer.draw_gouraud_triangles
         self.draw_image = self._renderer.draw_image
         self.draw_markers = self._renderer.draw_markers
diff --git a/lib/matplotlib/backends/backend_pdf.py b/lib/matplotlib/backends/backend_pdf.py
index aa4883135d92..d66e199b25b2 100644
--- a/lib/matplotlib/backends/backend_pdf.py
+++ b/lib/matplotlib/backends/backend_pdf.py
@@ -2132,10 +2132,6 @@ def draw_markers(self, gc, marker_path, marker_trans, path, trans,
                 lastx, lasty = x, y
         output(Op.grestore)
 
-    def draw_gouraud_triangle(self, gc, points, colors, trans):
-        self.draw_gouraud_triangles(gc, points.reshape((1, 3, 2)),
-                                    colors.reshape((1, 3, 4)), trans)
-
     def draw_gouraud_triangles(self, gc, points, colors, trans):
         assert len(points) == len(colors)
         if len(points) == 0:
diff --git a/lib/matplotlib/backends/backend_ps.py b/lib/matplotlib/backends/backend_ps.py
index a757bcf8d3be..b59c571809d1 100644
--- a/lib/matplotlib/backends/backend_ps.py
+++ b/lib/matplotlib/backends/backend_ps.py
@@ -691,11 +691,6 @@ def draw_mathtext(self, gc, x, y, s, prop, angle):
             self._pswriter.write(f"{ox} {oy} {w} {h} rectfill\n")
         self._pswriter.write("grestore\n")
 
-    @_log_if_debug_on
-    def draw_gouraud_triangle(self, gc, points, colors, trans):
-        self.draw_gouraud_triangles(gc, points.reshape((1, 3, 2)),
-                                    colors.reshape((1, 3, 4)), trans)
-
     @_log_if_debug_on
     def draw_gouraud_triangles(self, gc, points, colors, trans):
         assert len(points) == len(colors)
diff --git a/lib/matplotlib/backends/backend_svg.py b/lib/matplotlib/backends/backend_svg.py
index f62152ed1f0a..f95d5dbf6d9e 100644
--- a/lib/matplotlib/backends/backend_svg.py
+++ b/lib/matplotlib/backends/backend_svg.py
@@ -770,10 +770,6 @@ def draw_path_collection(self, gc, master_transform, paths, all_transforms,
 
         self._path_collection_id += 1
 
-    def draw_gouraud_triangle(self, gc, points, colors, trans):
-        # docstring inherited
-        self._draw_gouraud_triangle(gc, points, colors, trans)
-
     def _draw_gouraud_triangle(self, gc, points, colors, trans):
         # This uses a method described here:
         #
diff --git a/src/_backend_agg.h b/src/_backend_agg.h
index 61c24232a866..dd73aecde0f2 100644
--- a/src/_backend_agg.h
+++ b/src/_backend_agg.h
@@ -190,12 +190,6 @@ class RendererAgg
                         bool antialiased,
                         ColorArray &edgecolors);
 
-    template <class PointArray, class ColorArray>
-    void draw_gouraud_triangle(GCAgg &gc,
-                               PointArray &points,
-                               ColorArray &colors,
-                               agg::trans_affine &trans);
-
     template <class PointArray, class ColorArray>
     void draw_gouraud_triangles(GCAgg &gc,
                                 PointArray &points,
@@ -1229,20 +1223,6 @@ inline void RendererAgg::_draw_gouraud_triangle(PointArray &points,
     }
 }
 
-template <class PointArray, class ColorArray>
-inline void RendererAgg::draw_gouraud_triangle(GCAgg &gc,
-                                               PointArray &points,
-                                               ColorArray &colors,
-                                               agg::trans_affine &trans)
-{
-    theRasterizer.reset_clipping();
-    rendererBase.reset_clipping(true);
-    set_clipbox(gc.cliprect, theRasterizer);
-    bool has_clippath = render_clippath(gc.clippath.path, gc.clippath.trans, gc.snap_mode);
-
-    _draw_gouraud_triangle(points, colors, trans, has_clippath);
-}
-
 template <class PointArray, class ColorArray>
 inline void RendererAgg::draw_gouraud_triangles(GCAgg &gc,
                                                 PointArray &points,
diff --git a/src/_backend_agg_wrapper.cpp b/src/_backend_agg_wrapper.cpp
index ee69729be7e5..02832f1c3e69 100644
--- a/src/_backend_agg_wrapper.cpp
+++ b/src/_backend_agg_wrapper.cpp
@@ -436,49 +436,6 @@ static PyObject *PyRendererAgg_draw_quad_mesh(PyRendererAgg *self, PyObject *arg
     Py_RETURN_NONE;
 }
 
-static PyObject *
-PyRendererAgg_draw_gouraud_triangle(PyRendererAgg *self, PyObject *args)
-{
-    GCAgg gc;
-    numpy::array_view<const double, 2> points;
-    numpy::array_view<const double, 2> colors;
-    agg::trans_affine trans;
-
-    if (!PyArg_ParseTuple(args,
-                          "O&O&O&O&|O:draw_gouraud_triangle",
-                          &convert_gcagg,
-                          &gc,
-                          &points.converter,
-                          &points,
-                          &colors.converter,
-                          &colors,
-                          &convert_trans_affine,
-                          &trans)) {
-        return NULL;
-    }
-
-    if (points.dim(0) != 3 || points.dim(1) != 2) {
-        PyErr_Format(PyExc_ValueError,
-                     "points must have shape (3, 2), "
-                     "got (%" NPY_INTP_FMT ", %" NPY_INTP_FMT ")",
-                     points.dim(0), points.dim(1));
-        return NULL;
-    }
-
-    if (colors.dim(0) != 3 || colors.dim(1) != 4) {
-        PyErr_Format(PyExc_ValueError,
-                     "colors must have shape (3, 4), "
-                     "got (%" NPY_INTP_FMT ", %" NPY_INTP_FMT ")",
-                     colors.dim(0), colors.dim(1));
-        return NULL;
-    }
-
-
-    CALL_CPP("draw_gouraud_triangle", (self->x->draw_gouraud_triangle(gc, points, colors, trans)));
-
-    Py_RETURN_NONE;
-}
-
 static PyObject *
 PyRendererAgg_draw_gouraud_triangles(PyRendererAgg *self, PyObject *args)
 {
@@ -603,7 +560,6 @@ static PyTypeObject *PyRendererAgg_init_type()
         {"draw_image", (PyCFunction)PyRendererAgg_draw_image, METH_VARARGS, NULL},
         {"draw_path_collection", (PyCFunction)PyRendererAgg_draw_path_collection, METH_VARARGS, NULL},
         {"draw_quad_mesh", (PyCFunction)PyRendererAgg_draw_quad_mesh, METH_VARARGS, NULL},
-        {"draw_gouraud_triangle", (PyCFunction)PyRendererAgg_draw_gouraud_triangle, METH_VARARGS, NULL},
         {"draw_gouraud_triangles", (PyCFunction)PyRendererAgg_draw_gouraud_triangles, METH_VARARGS, NULL},
 
         {"clear", (PyCFunction)PyRendererAgg_clear, METH_NOARGS, NULL},

From 819e1734c41ba4e476899601acc67c42fa254aab Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Sun, 17 Sep 2023 12:43:21 +0200
Subject: [PATCH 0138/1120] Minor refactoring for performance

---
 lib/matplotlib/backends/backend_svg.py | 75 +++++++++++++-------------
 1 file changed, 37 insertions(+), 38 deletions(-)

diff --git a/lib/matplotlib/backends/backend_svg.py b/lib/matplotlib/backends/backend_svg.py
index f95d5dbf6d9e..d454a5b2fdb9 100644
--- a/lib/matplotlib/backends/backend_svg.py
+++ b/lib/matplotlib/backends/backend_svg.py
@@ -770,7 +770,7 @@ def draw_path_collection(self, gc, master_transform, paths, all_transforms,
 
         self._path_collection_id += 1
 
-    def _draw_gouraud_triangle(self, gc, points, colors, trans):
+    def _draw_gouraud_triangle(self, transformed_points, colors):
         # This uses a method described here:
         #
         #   http://www.svgopen.org/2005/papers/Converting3DFaceToSVG/index.html
@@ -782,43 +782,17 @@ def _draw_gouraud_triangle(self, gc, points, colors, trans):
         # opposite edge.  Underlying these three gradients is a solid
         # triangle whose color is the average of all three points.
 
-        writer = self.writer
-        if not self._has_gouraud:
-            self._has_gouraud = True
-            writer.start(
-                'filter',
-                id='colorAdd')
-            writer.element(
-                'feComposite',
-                attrib={'in': 'SourceGraphic'},
-                in2='BackgroundImage',
-                operator='arithmetic',
-                k2="1", k3="1")
-            writer.end('filter')
-            # feColorMatrix filter to correct opacity
-            writer.start(
-                'filter',
-                id='colorMat')
-            writer.element(
-                'feColorMatrix',
-                attrib={'type': 'matrix'},
-                values='1 0 0 0 0 \n0 1 0 0 0 \n0 0 1 0 0' +
-                       ' \n1 1 1 1 0 \n0 0 0 0 1 ')
-            writer.end('filter')
-
         avg_color = np.average(colors, axis=0)
         if avg_color[-1] == 0:
             # Skip fully-transparent triangles
             return
 
-        trans_and_flip = self._make_flip_transform(trans)
-        tpoints = trans_and_flip.transform(points)
-
+        writer = self.writer
         writer.start('defs')
         for i in range(3):
-            x1, y1 = tpoints[i]
-            x2, y2 = tpoints[(i + 1) % 3]
-            x3, y3 = tpoints[(i + 2) % 3]
+            x1, y1 = transformed_points[i]
+            x2, y2 = transformed_points[(i + 1) % 3]
+            x3, y3 = transformed_points[(i + 2) % 3]
             rgba_color = colors[i]
 
             if x2 == x3:
@@ -858,9 +832,9 @@ def _draw_gouraud_triangle(self, gc, points, colors, trans):
         writer.end('defs')
 
         # triangle formation using "path"
-        dpath = "M " + _short_float_fmt(x1)+',' + _short_float_fmt(y1)
-        dpath += " L " + _short_float_fmt(x2) + ',' + _short_float_fmt(y2)
-        dpath += " " + _short_float_fmt(x3) + ',' + _short_float_fmt(y3) + " Z"
+        dpath = (f"M {_short_float_fmt(x1)},{_short_float_fmt(y1)}"
+                 f" L {_short_float_fmt(x2)},{_short_float_fmt(y2)}"
+                 f" {_short_float_fmt(x3)},{_short_float_fmt(y3)} Z")
 
         writer.element(
             'path',
@@ -902,11 +876,36 @@ def _draw_gouraud_triangle(self, gc, points, colors, trans):
 
     def draw_gouraud_triangles(self, gc, triangles_array, colors_array,
                                transform):
-        self.writer.start('g', **self._get_clip_attrs(gc))
+        writer = self.writer
+        writer.start('g', **self._get_clip_attrs(gc))
         transform = transform.frozen()
-        for tri, col in zip(triangles_array, colors_array):
-            self._draw_gouraud_triangle(gc, tri, col, transform)
-        self.writer.end('g')
+        trans_and_flip = self._make_flip_transform(transform)
+
+        if not self._has_gouraud:
+            self._has_gouraud = True
+            writer.start(
+                'filter',
+                id='colorAdd')
+            writer.element(
+                'feComposite',
+                attrib={'in': 'SourceGraphic'},
+                in2='BackgroundImage',
+                operator='arithmetic',
+                k2="1", k3="1")
+            writer.end('filter')
+            # feColorMatrix filter to correct opacity
+            writer.start(
+                'filter',
+                id='colorMat')
+            writer.element(
+                'feColorMatrix',
+                attrib={'type': 'matrix'},
+                values='1 0 0 0 0 \n0 1 0 0 0 \n0 0 1 0 0 \n1 1 1 1 0 \n0 0 0 0 1 ')
+            writer.end('filter')
+
+        for points, colors in zip(triangles_array, colors_array):
+            self._draw_gouraud_triangle(trans_and_flip.transform(points), colors)
+        writer.end('g')
 
     def option_scale_image(self):
         # docstring inherited

From 5be91befb451a655214e65c69d4aa0cfb652772f Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Sun, 17 Sep 2023 13:38:10 +0200
Subject: [PATCH 0139/1120] Update kiwisolver and pillow versions to be
 consistent with requirements

---
 environment.yml               | 4 ++--
 lib/matplotlib/__init__.py    | 2 +-
 requirements/testing/mypy.txt | 4 ++--
 setup.py                      | 4 ++--
 4 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/environment.yml b/environment.yml
index c35b90e9acba..7b13735bb172 100644
--- a/environment.yml
+++ b/environment.yml
@@ -14,9 +14,9 @@ dependencies:
   - cycler>=0.10.0
   - fonttools>=4.22.0
   - importlib-resources>=3.2.0
-  - kiwisolver>=1.0.1
+  - kiwisolver>=1.3.1
   - numpy>=1.21
-  - pillow>=6.2
+  - pillow>=8
   - pybind11>=2.6.0
   - pygobject
   - pyparsing>=2.3.1
diff --git a/lib/matplotlib/__init__.py b/lib/matplotlib/__init__.py
index d0212cfe0276..3ffe046e6ba9 100644
--- a/lib/matplotlib/__init__.py
+++ b/lib/matplotlib/__init__.py
@@ -246,7 +246,7 @@ def _check_versions():
     for modname, minver in [
             ("cycler", "0.10"),
             ("dateutil", "2.7"),
-            ("kiwisolver", "1.0.1"),
+            ("kiwisolver", "1.3.1"),
             ("numpy", "1.21"),
             ("pyparsing", "2.3.1"),
     ]:
diff --git a/requirements/testing/mypy.txt b/requirements/testing/mypy.txt
index 801601bcd6eb..f697772da5ea 100644
--- a/requirements/testing/mypy.txt
+++ b/requirements/testing/mypy.txt
@@ -17,10 +17,10 @@ sphinx
 contourpy>=1.0.1
 cycler>=0.10
 fonttools>=4.22.0
-kiwisolver>=1.0.1
+kiwisolver>=1.3.1
 numpy>=1.19
 packaging>=20.0
-pillow>=6.2.0
+pillow>=8
 pyparsing>=2.3.1
 python-dateutil>=2.7
 setuptools_scm>=7
diff --git a/setup.py b/setup.py
index e9c5df01eb68..98aed8ccc912 100644
--- a/setup.py
+++ b/setup.py
@@ -332,10 +332,10 @@ def make_release_tree(self, base_dir, files):
         "contourpy>=1.0.1",
         "cycler>=0.10",
         "fonttools>=4.22.0",
-        "kiwisolver>=1.0.1",
+        "kiwisolver>=1.3.1",
         "numpy>=1.21",
         "packaging>=20.0",
-        "pillow>=6.2.0",
+        "pillow>=8",
         "pyparsing>=2.3.1",
         "python-dateutil>=2.7",
     ] + (

From a4d1f4e99587deaeeae82db2715beda38a33fda7 Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Tue, 12 Sep 2023 11:06:47 +0200
Subject: [PATCH 0140/1120] Use cbook methods for string checking

---
 lib/matplotlib/_mathtext.py | 2 +-
 lib/matplotlib/legend.py    | 4 ++--
 lib/matplotlib/rcsetup.py   | 4 ++--
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/lib/matplotlib/_mathtext.py b/lib/matplotlib/_mathtext.py
index b23cb67116ed..0d8842772a5b 100644
--- a/lib/matplotlib/_mathtext.py
+++ b/lib/matplotlib/_mathtext.py
@@ -2766,7 +2766,7 @@ def _auto_sized_delimiter(self, front: str,
             depth = max([x.depth for x in middle if not isinstance(x, str)])
             factor = None
             for idx, el in enumerate(middle):
-                if isinstance(el, str) and el == '\\middle':
+                if el == r'\middle':
                     c = T.cast(str, middle[idx + 1])  # Should be one of p.delims.
                     if c != '.':
                         middle[idx + 1] = AutoHeightChar(
diff --git a/lib/matplotlib/legend.py b/lib/matplotlib/legend.py
index fcd7850bb473..14249cb73442 100644
--- a/lib/matplotlib/legend.py
+++ b/lib/matplotlib/legend.py
@@ -29,7 +29,7 @@
 import numpy as np
 
 import matplotlib as mpl
-from matplotlib import _api, _docstring, colors, offsetbox
+from matplotlib import _api, _docstring, cbook, colors, offsetbox
 from matplotlib.artist import Artist, allow_rasterization
 from matplotlib.cbook import silent_list
 from matplotlib.font_manager import FontProperties
@@ -622,7 +622,7 @@ def __init__(
                         break
                     except AttributeError:
                         pass
-        elif isinstance(labelcolor, str) and labelcolor == 'none':
+        elif cbook._str_equal(labelcolor, 'none'):
             for text in self.texts:
                 text.set_color(labelcolor)
         elif np.iterable(labelcolor):
diff --git a/lib/matplotlib/rcsetup.py b/lib/matplotlib/rcsetup.py
index 276bb9f812a9..c289459b1874 100644
--- a/lib/matplotlib/rcsetup.py
+++ b/lib/matplotlib/rcsetup.py
@@ -179,7 +179,7 @@ def _make_type_validator(cls, *, allow_none=False):
 
     def validator(s):
         if (allow_none and
-                (s is None or isinstance(s, str) and s.lower() == "none")):
+                (s is None or cbook._str_lower_equal(s, "none"))):
             return None
         if cls is str and not isinstance(s, str):
             raise ValueError(f'Could not convert {s!r} to str')
@@ -615,7 +615,7 @@ def _validate_minor_tick_ndivs(n):
     two major ticks.
     """
 
-    if isinstance(n, str) and n.lower() == 'auto':
+    if cbook._str_lower_equal(n, 'auto'):
         return n
     try:
         n = _validate_int_greaterequal0(n)

From 587a8e50c6407b9713b6b3d34edac873b1e22842 Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Tue, 12 Sep 2023 11:04:57 +0200
Subject: [PATCH 0141/1120] Add typing for some private methods and modules

---
 lib/matplotlib/_c_internal_utils.pyi | 6 ++++++
 lib/matplotlib/cbook.pyi             | 8 ++++++++
 2 files changed, 14 insertions(+)

diff --git a/lib/matplotlib/_c_internal_utils.pyi b/lib/matplotlib/_c_internal_utils.pyi
index 3a211223be80..3efc81bc8332 100644
--- a/lib/matplotlib/_c_internal_utils.pyi
+++ b/lib/matplotlib/_c_internal_utils.pyi
@@ -1 +1,7 @@
 def display_is_valid() -> bool: ...
+
+def Win32_GetForegroundWindow() -> int | None: ...
+def Win32_SetForegroundWindow(hwnd: int) -> None: ...
+def Win32_SetProcessDpiAwareness_max() -> None: ...
+def Win32_SetCurrentProcessExplicitAppUserModelID(appid: str) -> None: ...
+def Win32_GetCurrentProcessExplicitAppUserModelID() -> str | None: ...
diff --git a/lib/matplotlib/cbook.pyi b/lib/matplotlib/cbook.pyi
index 227a23df4168..a6ad1e54a51c 100644
--- a/lib/matplotlib/cbook.pyi
+++ b/lib/matplotlib/cbook.pyi
@@ -161,6 +161,10 @@ def normalize_kwargs(
 ) -> dict[str, Any]: ...
 def _lock_path(path: str | os.PathLike) -> contextlib.AbstractContextManager[None]: ...
 def _str_equal(obj: Any, s: str) -> bool: ...
+def _str_lower_equal(obj: Any, s: str) -> bool: ...
+def _array_perimeter(arr: np.ndarray) -> np.ndarray: ...
+def _unfold(arr: np.ndarray, axis: int, size: int, step: int) -> np.ndarray: ...
+def _array_patch_perimeters(x: np.ndarray, rstride: int, cstride: int) -> np.ndarray: ...
 def _setattr_cm(obj: Any, **kwargs) -> contextlib.AbstractContextManager[None]: ...
 
 class _OrderedSet(collections.abc.MutableSet):
@@ -172,4 +176,8 @@ class _OrderedSet(collections.abc.MutableSet):
     def discard(self, key) -> None: ...
 
 def _backend_module_name(name: str) -> str: ...
+def _setup_new_guiapp() -> None: ...
 def _format_approx(number: float, precision: int) -> str: ...
+def _g_sig_digits(value: float, delta: float) -> int: ...
+def _unikey_or_keysym_to_mplkey(unikey: str, keysym: str) -> str: ...
+def _auto_format_str(fmt: str, value: Any) -> str: ...

From c67d1c3a604686ae7ac826db609228005df9827a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pedro=20Pe=C3=A7anha?= <pedrompecanha27@gmail.com>
Date: Sun, 17 Sep 2023 13:28:00 -0300
Subject: [PATCH 0142/1120] Changing the default value to None, adding
 docstring documenting and fixing extra logic.

---
 lib/matplotlib/axes/_base.py | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index f9c3c25bbff5..a8130e1910e3 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -3229,7 +3229,7 @@ def grid(self, visible=None, which='major', axis='both', **kwargs):
         if axis in ['y', 'both']:
             self.yaxis.grid(visible, which=which, **kwargs)
 
-    def ticklabel_format(self, *, axis='both', style='', scilimits=None,
+    def ticklabel_format(self, *, axis='both', style=None, scilimits=None,
                          useOffset=None, useLocale=None, useMathText=None):
         r"""
         Configure the `.ScalarFormatter` used by default for linear Axes.
@@ -3245,6 +3245,7 @@ def ticklabel_format(self, *, axis='both', style='', scilimits=None,
         style : {'sci', 'scientific', 'plain'}
             Whether to use scientific notation.
             The formatter default is to use scientific notation.
+            Sci is equivalent to scientific.
 
         scilimits : pair of ints (m, n)
             Scientific notation is used only for numbers outside the range
@@ -3283,8 +3284,11 @@ def ticklabel_format(self, *, axis='both', style='', scilimits=None,
             except (ValueError, TypeError) as err:
                 raise ValueError("scilimits must be a sequence of 2 integers"
                                  ) from err
-        STYLES = {'sci': True, 'scientific': True, 'plain': False, '': None}
-        is_sci_style = _api.check_getitem(STYLES, style=style)
+        STYLES = {'sci': True, 'scientific': True, 'plain': False}
+        if style == None:
+            is_sci_style = False
+        else:
+            is_sci_style = _api.check_getitem(STYLES, style=style)
         axis_map = {**{k: [v] for k, v in self._axis_map.items()},
                     'both': list(self._axis_map.values())}
         axises = _api.check_getitem(axis_map, axis=axis)

From b6607993610991f6b9dec153a42a2fd678df7bf6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pedro=20Pe=C3=A7anha?= <pedrompecanha27@gmail.com>
Date: Sun, 17 Sep 2023 13:44:48 -0300
Subject: [PATCH 0143/1120] Update _base.py

Fixing if condition.
---
 lib/matplotlib/axes/_base.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index a8130e1910e3..8449ec066d52 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -3285,7 +3285,7 @@ def ticklabel_format(self, *, axis='both', style=None, scilimits=None,
                 raise ValueError("scilimits must be a sequence of 2 integers"
                                  ) from err
         STYLES = {'sci': True, 'scientific': True, 'plain': False}
-        if style == None:
+        if style is None:
             is_sci_style = False
         else:
             is_sci_style = _api.check_getitem(STYLES, style=style)

From b31b17dcb7e0b116c93ee81347bbf06b6b09e5f5 Mon Sep 17 00:00:00 2001
From: Marc Bresson <marco.bresson@gmail.com>
Date: Mon, 18 Sep 2023 07:53:47 +0200
Subject: [PATCH 0144/1120] feat: specify input range when image data must be
 clipped

---
 lib/matplotlib/image.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/image.py b/lib/matplotlib/image.py
index 757f0ba3476e..3579bf57176f 100644
--- a/lib/matplotlib/image.py
+++ b/lib/matplotlib/image.py
@@ -700,7 +700,9 @@ def _normalize_image_array(A):
             if A.min() < 0 or high < A.max():
                 _log.warning(
                     'Clipping input data to the valid range for imshow with '
-                    'RGB data ([0..1] for floats or [0..255] for integers).'
+                    'RGB data ([0..1] for floats or [0..255] for integers). '
+                    'Got range [%s..%s].',
+                    A.min(), A.max()
                 )
                 A = np.clip(A, 0, high)
             # Cast unsupported integer types to uint8

From f923a8a91ec33313f2cc17e33d0f3f09e1460dd9 Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Mon, 18 Sep 2023 09:31:12 +0200
Subject: [PATCH 0145/1120] Fix issue with locale comma when not using math
 text

---
 lib/matplotlib/tests/test_ticker.py |  5 +++++
 lib/matplotlib/ticker.py            | 10 +++++-----
 2 files changed, 10 insertions(+), 5 deletions(-)

diff --git a/lib/matplotlib/tests/test_ticker.py b/lib/matplotlib/tests/test_ticker.py
index 9d08e335dbdd..961daaa1d167 100644
--- a/lib/matplotlib/tests/test_ticker.py
+++ b/lib/matplotlib/tests/test_ticker.py
@@ -1654,6 +1654,11 @@ def _impl_locale_comma():
     fmt = ',$\\mathdefault{,%1.1f},$'
     x = ticks._format_maybe_minus_and_locale(fmt, 0.5)
     assert x == ',$\\mathdefault{,0{,}5},$'
+    # Make sure no brackets are added if not using math text
+    ticks = mticker.ScalarFormatter(useMathText=False, useLocale=True)
+    fmt = '%1.1f'
+    x = ticks._format_maybe_minus_and_locale(fmt, 0.5)
+    assert x == '0,5'
 
 
 def test_locale_comma():
diff --git a/lib/matplotlib/ticker.py b/lib/matplotlib/ticker.py
index 767e6200cd2f..22cc5193504b 100644
--- a/lib/matplotlib/ticker.py
+++ b/lib/matplotlib/ticker.py
@@ -516,11 +516,11 @@ def _format_maybe_minus_and_locale(self, fmt, arg):
         Format *arg* with *fmt*, applying Unicode minus and locale if desired.
         """
         return self.fix_minus(
-                # Escape commas introduced by format_string but not those present
-                # from the beginning in fmt.
-                ",".join(locale.format_string(part, (arg,), True)
-                         .replace(",", "{,}")
-                         for part in fmt.split(","))
+                # Escape commas introduced by locale.format_string if using math text,
+                # but not those present from the beginning in fmt.
+                (",".join(locale.format_string(part, (arg,), True).replace(",", "{,}")
+                          for part in fmt.split(",")) if self._useMathText
+                 else locale.format_string(fmt, (arg,), True))
                 if self._useLocale
                 else fmt % arg)
 

From a75771b933b6c1a366e50871238e311ae4c40091 Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Mon, 18 Sep 2023 13:37:10 +0200
Subject: [PATCH 0146/1120] Catch ValueError to support pytorch (and others)
 plotting

---
 lib/matplotlib/cbook.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/cbook.py b/lib/matplotlib/cbook.py
index 80ec1612688b..f02486a0e280 100644
--- a/lib/matplotlib/cbook.py
+++ b/lib/matplotlib/cbook.py
@@ -1685,7 +1685,7 @@ def safe_first_element(obj):
 def _safe_first_finite(obj, *, skip_nonfinite=True):
     """
     Return the first finite element in *obj* if one is available and skip_nonfinite is
-    True. Otherwise return the first element.
+    True. Otherwise, return the first element.
 
     This is a method for internal use.
 
@@ -1697,7 +1697,7 @@ def safe_isfinite(val):
             return False
         try:
             return math.isfinite(val)
-        except TypeError:
+        except (TypeError, ValueError):
             pass
         try:
             return np.isfinite(val) if np.isscalar(val) else True

From 10d9f7bbc5b7d214064fd2efe68e85d3ac6ce0f7 Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Sun, 17 Sep 2023 13:14:41 +0200
Subject: [PATCH 0147/1120] Remove deprecated methods and attributed in Axes3D

---
 .../next_api_changes/removals/26798-OG.rst    |  9 ++++++++
 doc/api/toolkits/mplot3d/axes3d.rst           |  3 ---
 lib/mpl_toolkits/mplot3d/axes3d.py            | 22 -------------------
 3 files changed, 9 insertions(+), 25 deletions(-)
 create mode 100644 doc/api/next_api_changes/removals/26798-OG.rst

diff --git a/doc/api/next_api_changes/removals/26798-OG.rst b/doc/api/next_api_changes/removals/26798-OG.rst
new file mode 100644
index 000000000000..0d7d0a11faf2
--- /dev/null
+++ b/doc/api/next_api_changes/removals/26798-OG.rst
@@ -0,0 +1,9 @@
+``unit_cube``, ``tunit_cube``, and ``tunit_edges``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+... of `.Axes3D` are removed without replacements.
+
+``axes3d.vvec``, ``axes3d.eye``, ``axes3d.sx``, and ``axes3d.sy``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+... are removed without replacement.
diff --git a/doc/api/toolkits/mplot3d/axes3d.rst b/doc/api/toolkits/mplot3d/axes3d.rst
index b581494e4883..a1051992f9a7 100644
--- a/doc/api/toolkits/mplot3d/axes3d.rst
+++ b/doc/api/toolkits/mplot3d/axes3d.rst
@@ -267,9 +267,6 @@ Aliases and deprecated methods
     set_zlim3d
     stem3D
     text3D
-    tunit_cube
-    tunit_edges
-    unit_cube
 
 
 Other
diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index e7abdc0767b5..ac218cb9c952 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -58,11 +58,6 @@ class Axes3D(Axes):
     Axes._shared_axes["z"] = cbook.Grouper()
     Axes._shared_axes["view"] = cbook.Grouper()
 
-    vvec = _api.deprecate_privatize_attribute("3.7")
-    eye = _api.deprecate_privatize_attribute("3.7")
-    sx = _api.deprecate_privatize_attribute("3.7")
-    sy = _api.deprecate_privatize_attribute("3.7")
-
     def __init__(
             self, fig, rect=None, *args,
             elev=30, azim=-60, roll=0, sharez=None, proj_type='persp',
@@ -227,10 +222,6 @@ def get_zaxis(self):
     get_zgridlines = _axis_method_wrapper("zaxis", "get_gridlines")
     get_zticklines = _axis_method_wrapper("zaxis", "get_ticklines")
 
-    @_api.deprecated("3.7")
-    def unit_cube(self, vals=None):
-        return self._unit_cube(vals)
-
     def _unit_cube(self, vals=None):
         minx, maxx, miny, maxy, minz, maxz = vals or self.get_w_lims()
         return [(minx, miny, minz),
@@ -242,10 +233,6 @@ def _unit_cube(self, vals=None):
                 (maxx, maxy, maxz),
                 (minx, maxy, maxz)]
 
-    @_api.deprecated("3.7")
-    def tunit_cube(self, vals=None, M=None):
-        return self._tunit_cube(vals, M)
-
     def _tunit_cube(self, vals=None, M=None):
         if M is None:
             M = self.M
@@ -253,10 +240,6 @@ def _tunit_cube(self, vals=None, M=None):
         tcube = proj3d._proj_points(xyzs, M)
         return tcube
 
-    @_api.deprecated("3.7")
-    def tunit_edges(self, vals=None, M=None):
-        return self._tunit_edges(vals, M)
-
     def _tunit_edges(self, vals=None, M=None):
         tc = self._tunit_cube(vals, M)
         edges = [(tc[0], tc[1]),
@@ -943,11 +926,6 @@ def get_proj(self):
         # towards the middle of the box of data from a distance:
         eye = R + self._dist * ps
 
-        # vvec, self._vvec and self._eye are unused, remove when deprecated
-        vvec = R - eye
-        self._eye = eye
-        self._vvec = vvec / np.linalg.norm(vvec)
-
         # Calculate the viewing axes for the eye position
         u, v, w = self._calc_view_axes(eye)
         self._view_u = u  # _view_u is towards the right of the screen

From 2096ae720c80fdcb72d45b69a0bee20dd4ef4602 Mon Sep 17 00:00:00 2001
From: Pedro <pedrompecanha27@gmail.com>
Date: Mon, 18 Sep 2023 12:12:23 -0300
Subject: [PATCH 0148/1120] Added backwards-compatibility comment, changing to
 a solo STYLES dictionary and added stub parameter alternative.

---
 lib/matplotlib/axes/_base.py  | 13 ++++++-------
 lib/matplotlib/axes/_base.pyi |  2 +-
 2 files changed, 7 insertions(+), 8 deletions(-)

diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index 8449ec066d52..32a8747a50a8 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -3242,10 +3242,11 @@ def ticklabel_format(self, *, axis='both', style=None, scilimits=None,
         axis : {'x', 'y', 'both'}, default: 'both'
             The axis to configure.  Only major ticks are affected.
 
-        style : {'sci', 'scientific', 'plain'}
+        style : {'sci', 'scientific', 'plain', '', None}, default: None
             Whether to use scientific notation.
             The formatter default is to use scientific notation.
             Sci is equivalent to scientific.
+            The '' option is included solely for backwards-compatibility.
 
         scilimits : pair of ints (m, n)
             Scientific notation is used only for numbers outside the range
@@ -3275,7 +3276,8 @@ def ticklabel_format(self, *, axis='both', style=None, scilimits=None,
         AttributeError
             If the current formatter is not a `.ScalarFormatter`.
         """
-        style = style.lower()
+        if isinstance(style, str):
+            style = style.lower()
         axis = axis.lower()
         if scilimits is not None:
             try:
@@ -3284,11 +3286,8 @@ def ticklabel_format(self, *, axis='both', style=None, scilimits=None,
             except (ValueError, TypeError) as err:
                 raise ValueError("scilimits must be a sequence of 2 integers"
                                  ) from err
-        STYLES = {'sci': True, 'scientific': True, 'plain': False}
-        if style is None:
-            is_sci_style = False
-        else:
-            is_sci_style = _api.check_getitem(STYLES, style=style)
+        STYLES = {'sci': True, 'scientific': True, 'plain': False, '': None, None: None}
+        is_sci_style = _api.check_getitem(STYLES, style=style)
         axis_map = {**{k: [v] for k, v in self._axis_map.items()},
                     'both': list(self._axis_map.values())}
         axises = _api.check_getitem(axis_map, axis=axis)
diff --git a/lib/matplotlib/axes/_base.pyi b/lib/matplotlib/axes/_base.pyi
index e3644585296d..1f929b6c90c5 100644
--- a/lib/matplotlib/axes/_base.pyi
+++ b/lib/matplotlib/axes/_base.pyi
@@ -283,7 +283,7 @@ class _AxesBase(martist.Artist):
         self,
         *,
         axis: Literal["both", "x", "y"] = ...,
-        style: Literal["", "sci", "scientific", "plain"] = ...,
+        style: Literal["", "sci", "scientific", "plain"] | None = ...,
         scilimits: tuple[int, int] | None = ...,
         useOffset: bool | float | None = ...,
         useLocale: bool | None = ...,

From c6fdf59dfa41755c16a4ba859dfab52bad1ddbb7 Mon Sep 17 00:00:00 2001
From: Pedro <pedrompecanha27@gmail.com>
Date: Mon, 18 Sep 2023 13:04:32 -0300
Subject: [PATCH 0149/1120] Changing comments from the docstring area to inline
 comments.

---
 lib/matplotlib/axes/_base.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index 32a8747a50a8..cb6d5ba7cb41 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -3242,11 +3242,9 @@ def ticklabel_format(self, *, axis='both', style=None, scilimits=None,
         axis : {'x', 'y', 'both'}, default: 'both'
             The axis to configure.  Only major ticks are affected.
 
-        style : {'sci', 'scientific', 'plain', '', None}, default: None
+        style : {'sci', 'scientific', 'plain'} or None, default: None
             Whether to use scientific notation.
             The formatter default is to use scientific notation.
-            Sci is equivalent to scientific.
-            The '' option is included solely for backwards-compatibility.
 
         scilimits : pair of ints (m, n)
             Scientific notation is used only for numbers outside the range
@@ -3287,6 +3285,8 @@ def ticklabel_format(self, *, axis='both', style=None, scilimits=None,
                 raise ValueError("scilimits must be a sequence of 2 integers"
                                  ) from err
         STYLES = {'sci': True, 'scientific': True, 'plain': False, '': None, None: None}
+        # 'sci' is equivalent to 'scientific'.
+        # The '' option is included for backwards-compatibility.
         is_sci_style = _api.check_getitem(STYLES, style=style)
         axis_map = {**{k: [v] for k, v in self._axis_map.items()},
                     'both': list(self._axis_map.values())}

From 606925ab3644d9e08a54b8430bac01fc258c6e68 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Mon, 18 Sep 2023 12:42:24 -0500
Subject: [PATCH 0150/1120] Add overload for slice to Spines.__getitem__

Closes #26808
---
 lib/matplotlib/spines.pyi | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/lib/matplotlib/spines.pyi b/lib/matplotlib/spines.pyi
index 0a5243776730..0f06a6d1ce2b 100644
--- a/lib/matplotlib/spines.pyi
+++ b/lib/matplotlib/spines.pyi
@@ -75,6 +75,8 @@ class Spines(MutableMapping[str, Spine]):
     def __getitem__(self, key: str) -> Spine: ...
     @overload
     def __getitem__(self, key: list[str]) -> SpinesProxy: ...
+    @overload
+    def __getitem__(self, key: slice) -> SpinesProxy: ...
     def __setitem__(self, key: str, value: Spine) -> None: ...
     def __delitem__(self, key: str) -> None: ...
     def __iter__(self) -> Iterator[str]: ...

From 3b58aa7d1fff65e269f5d7c5af30336a2544920d Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 18 Sep 2023 19:33:25 +0000
Subject: [PATCH 0151/1120] Bump docker/setup-qemu-action from 2 to 3

Bumps [docker/setup-qemu-action](https://github.com/docker/setup-qemu-action) from 2 to 3.
- [Release notes](https://github.com/docker/setup-qemu-action/releases)
- [Commits](https://github.com/docker/setup-qemu-action/compare/v2...v3)

---
updated-dependencies:
- dependency-name: docker/setup-qemu-action
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 .github/workflows/cibuildwheel.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 3369b67122c9..63fd8e7d504d 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -125,7 +125,7 @@ jobs:
     steps:
       - name: Set up QEMU
         if: matrix.cibw_archs == 'aarch64'
-        uses: docker/setup-qemu-action@v2
+        uses: docker/setup-qemu-action@v3
         with:
           platforms: arm64
 

From 18dd02a66457f45efccddcf832c77da1a65e5288 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 18 Sep 2023 19:33:35 +0000
Subject: [PATCH 0152/1120] Bump pypa/cibuildwheel from 2.15.0 to 2.16.0

Bumps [pypa/cibuildwheel](https://github.com/pypa/cibuildwheel) from 2.15.0 to 2.16.0.
- [Release notes](https://github.com/pypa/cibuildwheel/releases)
- [Changelog](https://github.com/pypa/cibuildwheel/blob/main/docs/changelog.md)
- [Commits](https://github.com/pypa/cibuildwheel/compare/39a63b5912f086dd459cf6fcb13dcdd3fe3bc24d...a873dd9cbf9e3c4c73a1fd11ac31cf835f6eb502)

---
updated-dependencies:
- dependency-name: pypa/cibuildwheel
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 .github/workflows/cibuildwheel.yml | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 3369b67122c9..f4825081bf5b 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -136,7 +136,7 @@ jobs:
           path: dist/
 
       - name: Build wheels for CPython 3.12
-        uses: pypa/cibuildwheel@39a63b5912f086dd459cf6fcb13dcdd3fe3bc24d # v2.15.0
+        uses: pypa/cibuildwheel@a873dd9cbf9e3c4c73a1fd11ac31cf835f6eb502 # v2.16.0
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -158,7 +158,7 @@ jobs:
             pip install --pre "numpy>=1.25"
 
       - name: Build wheels for CPython 3.11
-        uses: pypa/cibuildwheel@39a63b5912f086dd459cf6fcb13dcdd3fe3bc24d # v2.15.0
+        uses: pypa/cibuildwheel@a873dd9cbf9e3c4c73a1fd11ac31cf835f6eb502 # v2.16.0
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -166,7 +166,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.10
-        uses: pypa/cibuildwheel@39a63b5912f086dd459cf6fcb13dcdd3fe3bc24d # v2.15.0
+        uses: pypa/cibuildwheel@a873dd9cbf9e3c4c73a1fd11ac31cf835f6eb502 # v2.16.0
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -174,7 +174,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.9
-        uses: pypa/cibuildwheel@39a63b5912f086dd459cf6fcb13dcdd3fe3bc24d # v2.15.0
+        uses: pypa/cibuildwheel@a873dd9cbf9e3c4c73a1fd11ac31cf835f6eb502 # v2.16.0
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -182,7 +182,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for PyPy
-        uses: pypa/cibuildwheel@39a63b5912f086dd459cf6fcb13dcdd3fe3bc24d # v2.15.0
+        uses: pypa/cibuildwheel@a873dd9cbf9e3c4c73a1fd11ac31cf835f6eb502 # v2.16.0
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:

From 6c3ca1c1e7282655b6e6d48ed090e4740faef8a2 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Mon, 18 Sep 2023 23:21:33 +0200
Subject: [PATCH 0153/1120] Remove usage of plt.Axes from tests

Axes is considered private in pyplot. See also #26812.
---
 lib/matplotlib/tests/test_bbox_tight.py | 3 +--
 lib/matplotlib/tests/test_image.py      | 4 +---
 2 files changed, 2 insertions(+), 5 deletions(-)

diff --git a/lib/matplotlib/tests/test_bbox_tight.py b/lib/matplotlib/tests/test_bbox_tight.py
index 4d4624e13f1d..b191ee90a4f8 100644
--- a/lib/matplotlib/tests/test_bbox_tight.py
+++ b/lib/matplotlib/tests/test_bbox_tight.py
@@ -141,8 +141,7 @@ def test_noop_tight_bbox():
     dpi = 100
     # make the figure just the right size up front
     fig = plt.figure(frameon=False, dpi=dpi, figsize=(x_size/dpi, y_size/dpi))
-    ax = plt.Axes(fig, [0., 0., 1., 1.])
-    fig.add_axes(ax)
+    ax = fig.add_axes((0, 0, 1, 1))
     ax.set_axis_off()
     ax.xaxis.set_visible(False)
     ax.yaxis.set_visible(False)
diff --git a/lib/matplotlib/tests/test_image.py b/lib/matplotlib/tests/test_image.py
index aeeebd136b65..c9c959e96115 100644
--- a/lib/matplotlib/tests/test_image.py
+++ b/lib/matplotlib/tests/test_image.py
@@ -800,10 +800,8 @@ def test_image_preserve_size2():
     data = np.identity(n, float)
 
     fig = plt.figure(figsize=(n, n), frameon=False)
-
-    ax = plt.Axes(fig, [0.0, 0.0, 1.0, 1.0])
+    ax = fig.add_axes((0.0, 0.0, 1.0, 1.0))
     ax.set_axis_off()
-    fig.add_axes(ax)
     ax.imshow(data, interpolation='nearest', origin='lower', aspect='auto')
     buff = io.BytesIO()
     fig.savefig(buff, dpi=1)

From 3766913d0d537a50f08c9a00b2f1c8f2b8b8faae Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Mon, 18 Sep 2023 23:51:44 +0200
Subject: [PATCH 0154/1120] Fix doc build (alternative)

Attempt to fix doc build failure introduced with #25272.

I suspect this is sphinx scoping: #25272 reused methods
like `Axes.set_xbounds` to generate documentation for Axes3D. However,
a see also of invert_xaxis only searches within the same module (or
class), and invert_xaxis is not documented for Axes3D. This PR
attempt to explicitly document the missing methods for Axes3D.
---
 doc/api/toolkits/mplot3d/axes3d.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/doc/api/toolkits/mplot3d/axes3d.rst b/doc/api/toolkits/mplot3d/axes3d.rst
index ca9d98cb0c88..877e47b7e93a 100644
--- a/doc/api/toolkits/mplot3d/axes3d.rst
+++ b/doc/api/toolkits/mplot3d/axes3d.rst
@@ -98,6 +98,10 @@ Axis limits and direction
    get_zlim
    set_zlim
    get_w_lims
+   invert_xaxis
+   xaxis_inverted
+   invert_yaxis
+   yaxis_inverted
    invert_zaxis
    zaxis_inverted
    get_xbound

From 604704c65775426d14798c12e5971093162f5a18 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Tue, 19 Sep 2023 00:13:59 +0200
Subject: [PATCH 0155/1120] Reoder safe_first_element() and
 _safe_first_finite() code

This does not change functionality. The code path for
`safe_first_element` is `_safe_first_finite(skip_nonfinite=False)` which
 is separate code block and does not interact with the
 skip_nonfinite=True case. IMHO this is more readable.

 Also add a comment on the exception handling recently modified in #26806.
---
 lib/matplotlib/cbook.py | 37 ++++++++++++++++++-------------------
 1 file changed, 18 insertions(+), 19 deletions(-)

diff --git a/lib/matplotlib/cbook.py b/lib/matplotlib/cbook.py
index f02486a0e280..b56de559532d 100644
--- a/lib/matplotlib/cbook.py
+++ b/lib/matplotlib/cbook.py
@@ -1679,10 +1679,20 @@ def safe_first_element(obj):
     This is a type-independent way of obtaining the first element,
     supporting both index access and the iterator protocol.
     """
-    return _safe_first_finite(obj, skip_nonfinite=False)
+    if isinstance(obj, collections.abc.Iterator):
+        # needed to accept `array.flat` as input.
+        # np.flatiter reports as an instance of collections.Iterator but can still be
+        # indexed via []. This has the side effect of re-setting the iterator, but
+        # that is acceptable.
+        try:
+            return obj[0]
+        except TypeError:
+            pass
+        raise RuntimeError("matplotlib does not support generators as input")
+    return next(iter(obj))
 
 
-def _safe_first_finite(obj, *, skip_nonfinite=True):
+def _safe_first_finite(obj):
     """
     Return the first finite element in *obj* if one is available and skip_nonfinite is
     True. Otherwise, return the first element.
@@ -1698,6 +1708,9 @@ def safe_isfinite(val):
         try:
             return math.isfinite(val)
         except (TypeError, ValueError):
+            # if the outer object is 2d, then val is a 1d array, and
+            # - math.isfinite(numpy.zeros(3)) raises TypeError
+            # - math.isfinite(torch.zeros(3)) raises ValueError
             pass
         try:
             return np.isfinite(val) if np.isscalar(val) else True
@@ -1705,26 +1718,12 @@ def safe_isfinite(val):
             # This is something that NumPy cannot make heads or tails of,
             # assume "finite"
             return True
-    if skip_nonfinite is False:
-        if isinstance(obj, collections.abc.Iterator):
-            # needed to accept `array.flat` as input.
-            # np.flatiter reports as an instance of collections.Iterator
-            # but can still be indexed via [].
-            # This has the side effect of re-setting the iterator, but
-            # that is acceptable.
-            try:
-                return obj[0]
-            except TypeError:
-                pass
-            raise RuntimeError("matplotlib does not support generators "
-                               "as input")
-        return next(iter(obj))
-    elif isinstance(obj, np.flatiter):
+
+    if isinstance(obj, np.flatiter):
         # TODO do the finite filtering on this
         return obj[0]
     elif isinstance(obj, collections.abc.Iterator):
-        raise RuntimeError("matplotlib does not "
-                           "support generators as input")
+        raise RuntimeError("matplotlib does not support generators as input")
     else:
         for val in obj:
             if safe_isfinite(val):

From 15218fa3572e506c4e3f04eb6de0907cf7b7dddd Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Tue, 19 Sep 2023 14:28:50 +0200
Subject: [PATCH 0156/1120] Fix issue with non-string labels and legend

---
 lib/matplotlib/container.py            | 2 +-
 lib/matplotlib/tests/test_container.py | 7 +++++++
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/container.py b/lib/matplotlib/container.py
index e11fea391871..0f082e298afc 100644
--- a/lib/matplotlib/container.py
+++ b/lib/matplotlib/container.py
@@ -19,7 +19,7 @@ def __new__(cls, *args, **kwargs):
     def __init__(self, kl, label=None):
         self._callbacks = cbook.CallbackRegistry(signals=["pchanged"])
         self._remove_method = None
-        self._label = label
+        self._label = str(label) if label is not None else None
 
     def remove(self):
         for c in cbook.flatten(
diff --git a/lib/matplotlib/tests/test_container.py b/lib/matplotlib/tests/test_container.py
index 8e894d9e9084..1e4577c518ae 100644
--- a/lib/matplotlib/tests/test_container.py
+++ b/lib/matplotlib/tests/test_container.py
@@ -1,3 +1,4 @@
+import numpy as np
 import matplotlib.pyplot as plt
 
 
@@ -28,3 +29,9 @@ def test_errorbar_remove():
 
     eb = ax.errorbar([1], [1], fmt='none')
     eb.remove()
+
+
+def test_nonstring_label():
+    # Test for #26824
+    plt.bar(np.arange(10), np.random.rand(10), label=1)
+    plt.legend()

From 4c3355d7d20ce4831b43224a8aebe2c178880bcb Mon Sep 17 00:00:00 2001
From: Pedro <pedrompecanha27@gmail.com>
Date: Tue, 19 Sep 2023 09:30:55 -0300
Subject: [PATCH 0157/1120] Reformatting pyplot.py and putting the sci
 equivalency in the docstring area.

---
 lib/matplotlib/axes/_base.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index cb6d5ba7cb41..23b50971b732 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -3245,6 +3245,7 @@ def ticklabel_format(self, *, axis='both', style=None, scilimits=None,
         style : {'sci', 'scientific', 'plain'} or None, default: None
             Whether to use scientific notation.
             The formatter default is to use scientific notation.
+            'sci' is equivalent to 'scientific'.
 
         scilimits : pair of ints (m, n)
             Scientific notation is used only for numbers outside the range
@@ -3285,7 +3286,6 @@ def ticklabel_format(self, *, axis='both', style=None, scilimits=None,
                 raise ValueError("scilimits must be a sequence of 2 integers"
                                  ) from err
         STYLES = {'sci': True, 'scientific': True, 'plain': False, '': None, None: None}
-        # 'sci' is equivalent to 'scientific'.
         # The '' option is included for backwards-compatibility.
         is_sci_style = _api.check_getitem(STYLES, style=style)
         axis_map = {**{k: [v] for k, v in self._axis_map.items()},

From 730a0bfb29742b0583230646ced4da39ce9986df Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Tue, 19 Sep 2023 14:39:32 +0200
Subject: [PATCH 0158/1120] [MNT] Move NUM_VERTICES from mplutils.h to the only
 file it is used in

---
 src/_path.h    | 2 ++
 src/mplutils.h | 2 --
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/_path.h b/src/_path.h
index 61c4ed07d0d2..387a0a6737f4 100644
--- a/src/_path.h
+++ b/src/_path.h
@@ -21,6 +21,8 @@
 #include "_backend_agg_basic_types.h"
 #include "numpy_cpp.h"
 
+const size_t NUM_VERTICES[] = { 1, 1, 1, 2, 3 };
+
 struct XY
 {
     double x;
diff --git a/src/mplutils.h b/src/mplutils.h
index 6eb89899ca4a..186449e8f63c 100644
--- a/src/mplutils.h
+++ b/src/mplutils.h
@@ -49,8 +49,6 @@ enum {
     CLOSEPOLY = 0x4f
 };
 
-const size_t NUM_VERTICES[] = { 1, 1, 1, 2, 3, 1 };
-
 inline int prepare_and_add_type(PyTypeObject *type, PyObject *module)
 {
     if (PyType_Ready(type)) {

From 558b2d843dcc27d5fb4718f4cfec28a93d431382 Mon Sep 17 00:00:00 2001
From: Pedro <pedrompecanha27@gmail.com>
Date: Tue, 19 Sep 2023 10:05:45 -0300
Subject: [PATCH 0159/1120] Attempting to fix pyplot.py by hand, although this
 is not encouraged.

---
 lib/matplotlib/pyplot.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 00e5dea071a4..06aef7ed686f 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -3953,7 +3953,7 @@ def tick_params(axis: Literal["both", "x", "y"] = "both", **kwargs) -> None:
 def ticklabel_format(
     *,
     axis: Literal["both", "x", "y"] = "both",
-    style: Literal["", "sci", "scientific", "plain"] = "",
+    style: Literal["", "sci", "scientific", "plain"] | None = None
     scilimits: tuple[int, int] | None = None,
     useOffset: bool | float | None = None,
     useLocale: bool | None = None,

From 3cf0234d3646ef57264b8e19ddbaa6cd7d301bf7 Mon Sep 17 00:00:00 2001
From: Pedro <pedrompecanha27@gmail.com>
Date: Tue, 19 Sep 2023 10:08:44 -0300
Subject: [PATCH 0160/1120] Adding a comma to pyplot.py.

---
 lib/matplotlib/pyplot.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 06aef7ed686f..74a73725d5d9 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -3953,7 +3953,7 @@ def tick_params(axis: Literal["both", "x", "y"] = "both", **kwargs) -> None:
 def ticklabel_format(
     *,
     axis: Literal["both", "x", "y"] = "both",
-    style: Literal["", "sci", "scientific", "plain"] | None = None
+    style: Literal["", "sci", "scientific", "plain"] | None = None,
     scilimits: tuple[int, int] | None = None,
     useOffset: bool | float | None = None,
     useLocale: bool | None = None,

From 6bdc99f92ad27ba4705b0c3a4d7ee1adb74d6230 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pedro=20Pe=C3=A7anha?=
 <60028123+pedrompecanha@users.noreply.github.com>
Date: Tue, 19 Sep 2023 11:22:21 -0300
Subject: [PATCH 0161/1120] Editing the docstring, making it more consistent to
 the other parameters that default to None.

Co-authored-by: Ruth Comer <10599679+rcomer@users.noreply.github.com>
---
 lib/matplotlib/axes/_base.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index 23b50971b732..394dfc2ccafd 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -3242,7 +3242,7 @@ def ticklabel_format(self, *, axis='both', style=None, scilimits=None,
         axis : {'x', 'y', 'both'}, default: 'both'
             The axis to configure.  Only major ticks are affected.
 
-        style : {'sci', 'scientific', 'plain'} or None, default: None
+        style : {'sci', 'scientific', 'plain'}
             Whether to use scientific notation.
             The formatter default is to use scientific notation.
             'sci' is equivalent to 'scientific'.

From b6694f43e5be64b923a4ecb1eb060856af861bf4 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Fri, 15 Sep 2023 19:09:23 +0200
Subject: [PATCH 0162/1120] Fix axh{line,span} on polar axes.

For axhline, set the underlying path's _interpolation_steps to
GRIDLINE_INTERPOLATION_STEPS (180), which amounts to using the same
logic to draw it as for drawing gridlines.  This ensures that a polar
axhline goes (due to interpolation) around the whole circle, rather than
being a trivial line connecting a point to itself.  Also update axvline
for consistency.  (Note that _interpolation_steps has is ignored for
rectilinear transforms and thus the change doesn't slow down the common,
rectilinear case.)

Increase the number of interpolation steps of ax{v,h}span likewise to
GRIDLINE_INTERPOLATION_STEPS (again for consistency), and more
importantly switch them to using Rectangle rather than Polygon, so that
a polar axhspan is drawn as an annulus.  This is necessary due to a
separate "bug", whereby the CLOSEPOLY step on a Polygon would generate
(effectively) a segment that's unfortunately ignored by
_interpolation_steps (as it doesn't appear explicitly), whereas
Rectangle explicitly includes the closing (4th) segment before emitting
a CLOSEPOLY.
---
 .../next_api_changes/behavior/26788-AL.rst    |   6 +++++
 doc/users/next_whats_new/polar-line-spans.rst |   5 ++++
 lib/matplotlib/axes/_axes.py                  |  25 ++++++++++++++----
 .../test_axes/axhvlinespan_interpolation.png  | Bin 0 -> 28240 bytes
 lib/matplotlib/tests/test_axes.py             |  12 +++++++++
 lib/matplotlib/tests/test_path.py             |   6 ++---
 lib/matplotlib/transforms.py                  |  13 +++++++++
 lib/matplotlib/widgets.py                     |  12 +++------
 8 files changed, 63 insertions(+), 16 deletions(-)
 create mode 100644 doc/api/next_api_changes/behavior/26788-AL.rst
 create mode 100644 doc/users/next_whats_new/polar-line-spans.rst
 create mode 100644 lib/matplotlib/tests/baseline_images/test_axes/axhvlinespan_interpolation.png

diff --git a/doc/api/next_api_changes/behavior/26788-AL.rst b/doc/api/next_api_changes/behavior/26788-AL.rst
new file mode 100644
index 000000000000..14573e870843
--- /dev/null
+++ b/doc/api/next_api_changes/behavior/26788-AL.rst
@@ -0,0 +1,6 @@
+``axvspan`` and ``axhspan`` now return ``Rectangle``\s, not ``Polygons``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+This change allows using `~.Axes.axhspan` to draw an annulus on polar axes.
+
+This change also affects other elements built via `~.Axes.axvspan` and
+`~.Axes.axhspan`, such as ``Slider.poly``.
diff --git a/doc/users/next_whats_new/polar-line-spans.rst b/doc/users/next_whats_new/polar-line-spans.rst
new file mode 100644
index 000000000000..47bb382dbdbf
--- /dev/null
+++ b/doc/users/next_whats_new/polar-line-spans.rst
@@ -0,0 +1,5 @@
+``axhline`` and ``axhspan`` on polar axes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+... now draw circles and circular arcs (`~.Axes.axhline`) or annuli and wedges
+(`~.Axes.axhspan`).
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 9997e660f40c..0fcabac8c7c0 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -783,6 +783,7 @@ def axhline(self, y=0, xmin=0, xmax=1, **kwargs):
         trans = self.get_yaxis_transform(which='grid')
         l = mlines.Line2D([xmin, xmax], [y, y], transform=trans, **kwargs)
         self.add_line(l)
+        l.get_path()._interpolation_steps = mpl.axis.GRIDLINE_INTERPOLATION_STEPS
         if scaley:
             self._request_autoscale_view("y")
         return l
@@ -851,6 +852,7 @@ def axvline(self, x=0, ymin=0, ymax=1, **kwargs):
         trans = self.get_xaxis_transform(which='grid')
         l = mlines.Line2D([x, x], [ymin, ymax], transform=trans, **kwargs)
         self.add_line(l)
+        l.get_path()._interpolation_steps = mpl.axis.GRIDLINE_INTERPOLATION_STEPS
         if scalex:
             self._request_autoscale_view("x")
         return l
@@ -978,10 +980,17 @@ def axhspan(self, ymin, ymax, xmin=0, xmax=1, **kwargs):
         self._check_no_units([xmin, xmax], ['xmin', 'xmax'])
         (ymin, ymax), = self._process_unit_info([("y", [ymin, ymax])], kwargs)
 
-        verts = (xmin, ymin), (xmin, ymax), (xmax, ymax), (xmax, ymin)
-        p = mpatches.Polygon(verts, **kwargs)
+        p = mpatches.Rectangle((xmin, ymin), xmax - xmin, ymax - ymin, **kwargs)
         p.set_transform(self.get_yaxis_transform(which="grid"))
+        # For Rectangles and non-separable transforms, add_patch can be buggy
+        # and update the x limits even though it shouldn't do so for an
+        # yaxis_transformed patch, so undo that update.
+        ix = self.dataLim.intervalx
+        mx = self.dataLim.minposx
         self.add_patch(p)
+        self.dataLim.intervalx = ix
+        self.dataLim.minposx = mx
+        p.get_path()._interpolation_steps = mpl.axis.GRIDLINE_INTERPOLATION_STEPS
         self._request_autoscale_view("y")
         return p
 
@@ -1034,11 +1043,17 @@ def axvspan(self, xmin, xmax, ymin=0, ymax=1, **kwargs):
         self._check_no_units([ymin, ymax], ['ymin', 'ymax'])
         (xmin, xmax), = self._process_unit_info([("x", [xmin, xmax])], kwargs)
 
-        verts = [(xmin, ymin), (xmin, ymax), (xmax, ymax), (xmax, ymin)]
-        p = mpatches.Polygon(verts, **kwargs)
+        p = mpatches.Rectangle((xmin, ymin), xmax - xmin, ymax - ymin, **kwargs)
         p.set_transform(self.get_xaxis_transform(which="grid"))
-        p.get_path()._interpolation_steps = 100
+        # For Rectangles and non-separable transforms, add_patch can be buggy
+        # and update the y limits even though it shouldn't do so for an
+        # xaxis_transformed patch, so undo that update.
+        iy = self.dataLim.intervaly.copy()
+        my = self.dataLim.minposy
         self.add_patch(p)
+        self.dataLim.intervaly = iy
+        self.dataLim.minposy = my
+        p.get_path()._interpolation_steps = mpl.axis.GRIDLINE_INTERPOLATION_STEPS
         self._request_autoscale_view("x")
         return p
 
diff --git a/lib/matplotlib/tests/baseline_images/test_axes/axhvlinespan_interpolation.png b/lib/matplotlib/tests/baseline_images/test_axes/axhvlinespan_interpolation.png
new file mode 100644
index 0000000000000000000000000000000000000000..3937cdf5b34c9a77d8003dd04967ee70ef4ab130
GIT binary patch
literal 28240
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

literal 0
HcmV?d00001

diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index ab9dab03e543..564bf6a86b52 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -8849,3 +8849,15 @@ def test_xylim_changed_shared():
     axs[1].callbacks.connect("ylim_changed", events.append)
     axs[0].set(xlim=[1, 3], ylim=[2, 4])
     assert events == [axs[1], axs[1]]
+
+
+@image_comparison(["axhvlinespan_interpolation.png"], style="default")
+def test_axhvlinespan_interpolation():
+    ax = plt.figure().add_subplot(projection="polar")
+    ax.set_axis_off()
+    ax.axvline(.1, c="C0")
+    ax.axvspan(.2, .3, fc="C1")
+    ax.axvspan(.4, .5, .1, .2, fc="C2")
+    ax.axhline(1, c="C0", alpha=.5)
+    ax.axhspan(.8, .9, fc="C1", alpha=.5)
+    ax.axhspan(.6, .7, .8, .9, fc="C2", alpha=.5)
diff --git a/lib/matplotlib/tests/test_path.py b/lib/matplotlib/tests/test_path.py
index 0a1d6c6b5e52..8c0c32dc133b 100644
--- a/lib/matplotlib/tests/test_path.py
+++ b/lib/matplotlib/tests/test_path.py
@@ -142,11 +142,11 @@ def test_nonlinear_containment():
     ax.set(xscale="log", ylim=(0, 1))
     polygon = ax.axvspan(1, 10)
     assert polygon.get_path().contains_point(
-        ax.transData.transform((5, .5)), ax.transData)
+        ax.transData.transform((5, .5)), polygon.get_transform())
     assert not polygon.get_path().contains_point(
-        ax.transData.transform((.5, .5)), ax.transData)
+        ax.transData.transform((.5, .5)), polygon.get_transform())
     assert not polygon.get_path().contains_point(
-        ax.transData.transform((50, .5)), ax.transData)
+        ax.transData.transform((50, .5)), polygon.get_transform())
 
 
 @image_comparison(['arrow_contains_point.png'],
diff --git a/lib/matplotlib/transforms.py b/lib/matplotlib/transforms.py
index d04b59afa9d7..5a7fd125a29b 100644
--- a/lib/matplotlib/transforms.py
+++ b/lib/matplotlib/transforms.py
@@ -671,6 +671,7 @@ def intersection(bbox1, bbox2):
         y1 = np.minimum(bbox1.ymax, bbox2.ymax)
         return Bbox([[x0, y0], [x1, y1]]) if x0 <= x1 and y0 <= y1 else None
 
+
 _default_minpos = np.array([np.inf, np.inf])
 
 
@@ -1011,6 +1012,10 @@ def minpos(self):
         """
         return self._minpos
 
+    @minpos.setter
+    def minpos(self, val):
+        self._minpos[:] = val
+
     @property
     def minposx(self):
         """
@@ -1022,6 +1027,10 @@ def minposx(self):
         """
         return self._minpos[0]
 
+    @minposx.setter
+    def minposx(self, val):
+        self._minpos[0] = val
+
     @property
     def minposy(self):
         """
@@ -1033,6 +1042,10 @@ def minposy(self):
         """
         return self._minpos[1]
 
+    @minposy.setter
+    def minposy(self, val):
+        self._minpos[1] = val
+
     def get_points(self):
         """
         Get the points of the bounding box as an array of the form
diff --git a/lib/matplotlib/widgets.py b/lib/matplotlib/widgets.py
index 0a31a9dd2529..771cfd714b91 100644
--- a/lib/matplotlib/widgets.py
+++ b/lib/matplotlib/widgets.py
@@ -433,8 +433,8 @@ def __init__(self, ax, label, valmin, valmax, valinit=0.5, valfmt=None,
         Notes
         -----
         Additional kwargs are passed on to ``self.poly`` which is the
-        `~matplotlib.patches.Polygon` that draws the slider knob.  See the
-        `.Polygon` documentation for valid property names (``facecolor``,
+        `~matplotlib.patches.Rectangle` that draws the slider knob.  See the
+        `.Rectangle` documentation for valid property names (``facecolor``,
         ``edgecolor``, ``alpha``, etc.).
         """
         super().__init__(ax, orientation, closedmin, closedmax,
@@ -577,16 +577,12 @@ def set_val(self, val):
         ----------
         val : float
         """
-        xy = self.poly.xy
         if self.orientation == 'vertical':
-            xy[1] = .25, val
-            xy[2] = .75, val
+            self.poly.set_height(val - self.poly.get_y())
             self._handle.set_ydata([val])
         else:
-            xy[2] = val, .75
-            xy[3] = val, .25
+            self.poly.set_width(val - self.poly.get_x())
             self._handle.set_xdata([val])
-        self.poly.xy = xy
         self.valtext.set_text(self._format(val))
         if self.drawon:
             self.ax.figure.canvas.draw_idle()

From e6af5a339c7cea73fa0aaa587e258ecb742d4bef Mon Sep 17 00:00:00 2001
From: Chiraag Balu <86278218+chiraagbalu@users.noreply.github.com>
Date: Tue, 19 Sep 2023 23:06:04 -0700
Subject: [PATCH 0163/1120] Fix Issue 26821: [Bug]: ValueError: The truth
 value... when an ndarray is passed to the color kwarg of axes3d.scatter
 (#26834)

* FIX: [Bug]: ValueError: The truth value... when an ndarray is passed to the color kwarg of axes3d.scatter

* added smoke test to ensure no value error is thrown

* fixed smoke test to use fig canvas draw rather than plt show

* added an extra line and reduced line length to comply with flake8

* removed trailing whitespace

* Update lib/mpl_toolkits/mplot3d/tests/test_axes3d.py

Co-authored-by: Kyle Sunden <git@ksunden.space>

---------

Co-authored-by: Kyle Sunden <git@ksunden.space>
---
 lib/mpl_toolkits/mplot3d/axes3d.py            | 2 +-
 lib/mpl_toolkits/mplot3d/tests/test_axes3d.py | 9 +++++++++
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index c519bc656533..0c18bce8ebd3 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -2672,7 +2672,7 @@ def scatter(self, xs, ys, zs=0, zdir='z', s=20, c=None, depthshade=True,
         xs, ys, zs, s, c, color = cbook.delete_masked_points(
             xs, ys, zs, s, c, kwargs.get('color', None)
             )
-        if kwargs.get('color', None):
+        if kwargs.get("color") is not None:
             kwargs['color'] = color
 
         # For xs and ys, 2D scatter() will do the copying.
diff --git a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
index 75f0e2261907..f3666fffc418 100644
--- a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
@@ -2302,3 +2302,12 @@ def test_Poly3DCollection_init_value_error():
                         'or both for shade to work.'):
         poly = np.array([[0, 0, 1], [0, 1, 1], [0, 0, 0]], float)
         c = art3d.Poly3DCollection([poly], shade=True)
+
+
+def test_ndarray_color_kwargs_value_error():
+    # smoke test
+    # ensures ndarray can be passed to color in kwargs for 3d projection plot
+    fig = plt.figure()
+    ax = fig.add_subplot(111, projection='3d')
+    ax.scatter(1, 0, 0, color=np.array([0, 0, 0, 1]))
+    fig.canvas.draw()

From 5e8f2b8a54479755de7c8dace03974fcd6d83206 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Wed, 20 Sep 2023 13:25:00 +0200
Subject: [PATCH 0164/1120] Reduce redundant information in
 _process_plot_var_args.

_prop_keys is redundant with _cycler_items and not really needed
anywhere.  Removing it makes it less likely that a
_process_plot_var_args gets in an invalid state if _cycler_items is
updated while _prop_keys is not touched.
---
 lib/matplotlib/axes/_base.py | 28 ++++++++++++----------------
 1 file changed, 12 insertions(+), 16 deletions(-)

diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index f9c3c25bbff5..7093271f2872 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -228,7 +228,6 @@ def set_prop_cycle(self, cycler):
             cycler = mpl.rcParams['axes.prop_cycle']
         self._idx = 0
         self._cycler_items = [*cycler]
-        self._prop_keys = cycler.keys  # This should make a copy
 
     def __call__(self, axes, *args, data=None, **kwargs):
         axes._process_unit_info(kwargs=kwargs)
@@ -305,11 +304,12 @@ def __call__(self, axes, *args, data=None, **kwargs):
 
     def get_next_color(self):
         """Return the next color in the cycle."""
-        if 'color' not in self._prop_keys:
-            return 'k'
-        c = self._cycler_items[self._idx]['color']
-        self._idx = (self._idx + 1) % len(self._cycler_items)
-        return c
+        entry = self._cycler_items[self._idx]
+        if "color" in entry:
+            self._idx = (self._idx + 1) % len(self._cycler_items)  # Advance cycler.
+            return entry["color"]
+        else:
+            return "k"
 
     def _getdefaults(self, ignore, kw):
         """
@@ -318,17 +318,13 @@ def _getdefaults(self, ignore, kw):
         of the next entry in the property cycle, excluding keys in *ignore*.
         Otherwise, don't advance the property cycle, and return an empty dict.
         """
-        prop_keys = self._prop_keys - ignore
-        if any(kw.get(k, None) is None for k in prop_keys):
-            # Need to copy this dictionary or else the next time around
-            # in the cycle, the dictionary could be missing entries.
-            default_dict = self._cycler_items[self._idx].copy()
-            self._idx = (self._idx + 1) % len(self._cycler_items)
-            for p in ignore:
-                default_dict.pop(p, None)
+        defaults = self._cycler_items[self._idx]
+        if any(kw.get(k, None) is None for k in {*defaults} - ignore):
+            self._idx = (self._idx + 1) % len(self._cycler_items)  # Advance cycler.
+            # Return a new dict to avoid exposing _cycler_items entries to mutation.
+            return {k: v for k, v in defaults.items() if k not in ignore}
         else:
-            default_dict = {}
-        return default_dict
+            return {}
 
     def _setdefaults(self, defaults, kw):
         """

From ddad97332fa3f76b7cd0225b1d430e3e54e12e49 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Wed, 20 Sep 2023 13:36:40 +0200
Subject: [PATCH 0165/1120] Minor style-ish changes in _process_plot_var_args.

- Swap arguments on _getdefaults so that ignores can be made optional.
- Inline some temporaries, and use more comprehensions.
---
 lib/matplotlib/axes/_base.py | 17 +++++++----------
 1 file changed, 7 insertions(+), 10 deletions(-)

diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index 7093271f2872..1d9a91d78991 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -311,7 +311,7 @@ def get_next_color(self):
         else:
             return "k"
 
-    def _getdefaults(self, ignore, kw):
+    def _getdefaults(self, kw, ignore=frozenset()):
         """
         If some keys in the property cycle (excluding those in the set
         *ignore*) are absent or set to None in the dict *kw*, return a copy
@@ -337,8 +337,7 @@ def _setdefaults(self, defaults, kw):
 
     def _makeline(self, axes, x, y, kw, kwargs):
         kw = {**kw, **kwargs}  # Don't modify the original kw.
-        default_dict = self._getdefaults(set(), kw)
-        self._setdefaults(default_dict, kw)
+        self._setdefaults(self._getdefaults(kw), kw)
         seg = mlines.Line2D(x, y, **kw)
         return seg, kw
 
@@ -358,18 +357,16 @@ def _makefill(self, axes, x, y, kw, kwargs):
         # *user* explicitly specifies a marker which should be an error.
         # We also want to prevent advancing the cycler if there are no
         # defaults needed after ignoring the given properties.
-        ignores = {'marker', 'markersize', 'markeredgecolor',
-                   'markerfacecolor', 'markeredgewidth'}
-        # Also ignore anything provided by *kwargs*.
-        for k, v in kwargs.items():
-            if v is not None:
-                ignores.add(k)
+        ignores = ({'marker', 'markersize', 'markeredgecolor',
+                    'markerfacecolor', 'markeredgewidth'}
+                   # Also ignore anything provided by *kwargs*.
+                   | {k for k, v in kwargs.items() if v is not None})
 
         # Only using the first dictionary to use as basis
         # for getting defaults for back-compat reasons.
         # Doing it with both seems to mess things up in
         # various places (probably due to logic bugs elsewhere).
-        default_dict = self._getdefaults(ignores, kw)
+        default_dict = self._getdefaults(kw, ignores)
         self._setdefaults(default_dict, kw)
 
         # Looks like we don't want "color" to be interpreted to

From 89314c0289a74d55d8cfa70ab02d467b7cf34414 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Wed, 20 Sep 2023 17:17:45 +0200
Subject: [PATCH 0166/1120] DOC: Use ax.xaxis rather ax.get_xaxis()

get_xaxis() is discouraged.
---
 doc/users/faq.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/users/faq.rst b/doc/users/faq.rst
index 46084ec4c6c6..c4e133d56d73 100644
--- a/doc/users/faq.rst
+++ b/doc/users/faq.rst
@@ -123,7 +123,7 @@ The default formatter will use an offset to reduce
 the length of the ticklabels.  To turn this feature
 off on a per-axis basis::
 
-   ax.get_xaxis().get_major_formatter().set_useOffset(False)
+   ax.xaxis.get_major_formatter().set_useOffset(False)
 
 set :rc:`axes.formatter.useoffset`, or use a different
 formatter.  See :mod:`~matplotlib.ticker` for details.

From 3b643d4455947a0b71ce30761a738905efbf6351 Mon Sep 17 00:00:00 2001
From: Jorge Moraleda <jorge.moraleda@gmail.com>
Date: Mon, 11 Sep 2023 20:33:29 -0400
Subject: [PATCH 0167/1120] Explicitly set foreground color to black in svg
 icons. make_icons script adds style="fill:black;" to monochromatic icons

---
 lib/matplotlib/mpl-data/images/back.svg        |  2 +-
 lib/matplotlib/mpl-data/images/filesave.svg    |  2 +-
 lib/matplotlib/mpl-data/images/forward.svg     |  2 +-
 lib/matplotlib/mpl-data/images/help.svg        |  2 +-
 lib/matplotlib/mpl-data/images/home.svg        |  2 +-
 lib/matplotlib/mpl-data/images/move.svg        |  2 +-
 .../mpl-data/images/qt4_editor_options.svg     |  2 +-
 lib/matplotlib/mpl-data/images/subplots.svg    |  2 +-
 .../mpl-data/images/zoom_to_rect.svg           |  2 +-
 tools/make_icons.py                            | 18 ++++++++++++++----
 10 files changed, 23 insertions(+), 13 deletions(-)

diff --git a/lib/matplotlib/mpl-data/images/back.svg b/lib/matplotlib/mpl-data/images/back.svg
index a933ef8cdf50..0c2d653cbe8f 100644
--- a/lib/matplotlib/mpl-data/images/back.svg
+++ b/lib/matplotlib/mpl-data/images/back.svg
@@ -40,7 +40,7 @@ L 33.991875 44.72875
 L 60.703125 44.72875 
 C 63.43375 44.72875 65.144375 42.444375 65.144375 39.8625 
 z
-"/>
+" style="fill:black;"/>
   </g>
  </g>
 </svg>
diff --git a/lib/matplotlib/mpl-data/images/filesave.svg b/lib/matplotlib/mpl-data/images/filesave.svg
index ad8372d295de..856721b6b5e2 100644
--- a/lib/matplotlib/mpl-data/images/filesave.svg
+++ b/lib/matplotlib/mpl-data/images/filesave.svg
@@ -62,7 +62,7 @@ C 6.855625 64.95875 8.491875 66.584375 10.5 66.584375
 L 61.5 66.584375 
 C 63.508125 66.584375 65.144375 64.95875 65.144375 62.94 
 z
-"/>
+" style="fill:black;"/>
   </g>
  </g>
 </svg>
diff --git a/lib/matplotlib/mpl-data/images/forward.svg b/lib/matplotlib/mpl-data/images/forward.svg
index 1f4071360680..08b6fe174602 100644
--- a/lib/matplotlib/mpl-data/images/forward.svg
+++ b/lib/matplotlib/mpl-data/images/forward.svg
@@ -40,7 +40,7 @@ C 30.645 66.4675 31.866875 66.99875 33.1525 66.99875
 C 34.438125 66.99875 35.691875 66.4675 36.605625 65.59625 
 L 61.30875 40.893125 
 C 62.2225 39.979375 62.71125 38.725625 62.71125 37.44 
-"/>
+" style="fill:black;"/>
   </g>
  </g>
 </svg>
diff --git a/lib/matplotlib/mpl-data/images/help.svg b/lib/matplotlib/mpl-data/images/help.svg
index 484bdbcbf659..260528d607aa 100644
--- a/lib/matplotlib/mpl-data/images/help.svg
+++ b/lib/matplotlib/mpl-data/images/help.svg
@@ -46,7 +46,7 @@ C 42.486563 52.0175 43.134687 51.029375 43.134687 50.19
 C 43.134687 49.095625 44.537188 46.47125 46.779063 45.185625 
 C 50.380938 43.166875 55.279063 40.404375 55.279063 33.19 
 z
-"/>
+" style="fill:black;"/>
   </g>
  </g>
 </svg>
diff --git a/lib/matplotlib/mpl-data/images/home.svg b/lib/matplotlib/mpl-data/images/home.svg
index 3c4ccce3ed1f..db140d43d156 100644
--- a/lib/matplotlib/mpl-data/images/home.svg
+++ b/lib/matplotlib/mpl-data/images/home.svg
@@ -53,7 +53,7 @@ C 62.482813 46.47125 62.748438 46.545625 63.056562 46.545625
 C 63.088437 46.545625 63.130938 46.545625 63.173438 46.545625 
 C 63.470938 46.51375 63.779063 46.354375 63.970313 46.13125 
 z
-"/>
+" style="fill:black;"/>
   </g>
  </g>
 </svg>
diff --git a/lib/matplotlib/mpl-data/images/move.svg b/lib/matplotlib/mpl-data/images/move.svg
index aa7198cf72df..f7e23ab0451c 100644
--- a/lib/matplotlib/mpl-data/images/move.svg
+++ b/lib/matplotlib/mpl-data/images/move.svg
@@ -67,7 +67,7 @@ C 55.433125 48.49 56.5275 49.584375 57.855625 49.584375
 C 58.50375 49.584375 59.109375 49.31875 59.56625 48.861875 
 L 69.2775 39.150625 
 C 69.734375 38.69375 70 38.088125 70 37.44 
-"/>
+" style="fill:black;"/>
   </g>
  </g>
 </svg>
diff --git a/lib/matplotlib/mpl-data/images/qt4_editor_options.svg b/lib/matplotlib/mpl-data/images/qt4_editor_options.svg
index 0b46bf80923e..02adfbc4ae11 100644
--- a/lib/matplotlib/mpl-data/images/qt4_editor_options.svg
+++ b/lib/matplotlib/mpl-data/images/qt4_editor_options.svg
@@ -42,7 +42,7 @@ L 63.3275 27.123125
 L 67.9175 31.713125 
 C 68.714375 32.51 70 31.93625 70 30.87375 
 z
-"/>
+" style="fill:black;"/>
   </g>
  </g>
 </svg>
diff --git a/lib/matplotlib/mpl-data/images/subplots.svg b/lib/matplotlib/mpl-data/images/subplots.svg
index e87d2c9b1b19..9a0fa90972ff 100644
--- a/lib/matplotlib/mpl-data/images/subplots.svg
+++ b/lib/matplotlib/mpl-data/images/subplots.svg
@@ -75,7 +75,7 @@ L 32.355625 18.0175
 L 32.355625 22.873125 
 L 65.144375 22.873125 
 z
-"/>
+" style="fill:black;"/>
   </g>
  </g>
 </svg>
diff --git a/lib/matplotlib/mpl-data/images/zoom_to_rect.svg b/lib/matplotlib/mpl-data/images/zoom_to_rect.svg
index f4b69b23c5eb..44e59a8a4fdc 100644
--- a/lib/matplotlib/mpl-data/images/zoom_to_rect.svg
+++ b/lib/matplotlib/mpl-data/images/zoom_to_rect.svg
@@ -34,7 +34,7 @@ C 36.525937 59.300937 41.838437 57.664687 46.279687 54.594062
 L 59.295313 67.577812 
 C 60.166562 68.480937 61.420313 69.012187 62.716563 69.012187 
 C 65.372813 69.012187 67.572187 66.812812 67.572187 64.156562 
-"/>
+" style="fill:black;"/>
   </g>
  </g>
 </svg>
diff --git a/tools/make_icons.py b/tools/make_icons.py
index 0424c0d03dad..f09d40e92256 100755
--- a/tools/make_icons.py
+++ b/tools/make_icons.py
@@ -36,8 +36,18 @@ def get_fontawesome():
     return cached_path
 
 
-def save_icon(fig, dest_dir, name):
-    fig.savefig(dest_dir / (name + '.svg'))
+def save_icon(fig, dest_dir, name, add_black_fg_color):
+    if add_black_fg_color:
+        # Add explicit black foreground color to monochromatic svg icons
+        # so it can be replaced by backends to add dark theme support
+        svg_bytes_io = BytesIO()
+        fig.savefig(svg_bytes_io, format='svg')
+        svg = svg_bytes_io.getvalue()
+        before, sep, after = svg.rpartition(b'\nz\n"')
+        svg = before + sep + b' style="fill:black;"' + after
+        (dest_dir / (name + '.svg')).write_bytes(svg)
+    else:
+        fig.savefig(dest_dir / (name + '.svg'))
     fig.savefig(dest_dir / (name + '.pdf'))
     for dpi, suffix in [(24, ''), (48, '_large')]:
         fig.savefig(dest_dir / (name + suffix + '.png'), dpi=dpi)
@@ -102,9 +112,9 @@ def make_icons():
     font_path = get_fontawesome()
     for name, ccode in icon_defs:
         fig = make_icon(font_path, ccode)
-        save_icon(fig, args.dest_dir, name)
+        save_icon(fig, args.dest_dir, name, True)
     fig = make_matplotlib_icon()
-    save_icon(fig, args.dest_dir, 'matplotlib')
+    save_icon(fig, args.dest_dir, 'matplotlib', False)
 
 
 if __name__ == "__main__":

From 25308bb2b8702c3fa6dc61869156c8b4a84e1371 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 20 Sep 2023 18:22:03 -0400
Subject: [PATCH 0168/1120] ci: Use new name for WQY-ZenHei package on Circle

---
 .circleci/config.yml | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/.circleci/config.yml b/.circleci/config.yml
index 5fc186a4143a..c914581f5211 100644
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -44,24 +44,24 @@ commands:
           command: |
             sudo apt -qq update
             sudo apt install -y \
-              inkscape \
-              ffmpeg \
+              cm-super \
               dvipng \
+              ffmpeg \
+              fonts-crosextra-carlito \
+              fonts-freefont-otf \
+              fonts-humor-sans \
+              fonts-noto-cjk \
+              fonts-wqy-zenhei \
+              graphviz \
+              inkscape \
               lmodern \
-              cm-super \
+              optipng \
+              texlive-fonts-recommended \
               texlive-latex-base \
               texlive-latex-extra \
-              texlive-fonts-recommended \
               texlive-latex-recommended \
               texlive-pictures \
-              texlive-xetex \
-              ttf-wqy-zenhei \
-              graphviz \
-              fonts-crosextra-carlito \
-              fonts-freefont-otf \
-              fonts-humor-sans \
-              fonts-noto-cjk \
-              optipng
+              texlive-xetex
 
   fonts-install:
     steps:

From ac8ac991da1bcc28ae7d98e6be6d12629466ddd2 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 20 Sep 2023 18:23:16 -0400
Subject: [PATCH 0169/1120] ci: Don't install recommended packages on Circle

We don't need the optional packages and save a little download/install
time.
---
 .circleci/config.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.circleci/config.yml b/.circleci/config.yml
index c914581f5211..60a1e8211e60 100644
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -42,8 +42,8 @@ commands:
       - run:
           name: Install apt packages
           command: |
-            sudo apt -qq update
-            sudo apt install -y \
+            sudo apt-get -qq update
+            sudo apt-get install -yy --no-install-recommends \
               cm-super \
               dvipng \
               ffmpeg \

From c70a52edf48a133ff9b7ea022d8a43c8efc58109 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Wed, 20 Sep 2023 17:48:00 -0500
Subject: [PATCH 0170/1120] Bump setuptools required version because of
 setuptools_scm v8

Technically could work with older setuptools and setuptools_scm==7, but encoding that matrix of dependencies is not something I think is worth worrying about, and setuptools 64 is over a year old (though not by a _whole_ lot).
---
 doc/api/next_api_changes/development/26849-KS.rst | 5 +++++
 doc/devel/dependencies.rst                        | 2 +-
 pyproject.toml                                    | 9 ++++++++-
 requirements/testing/mypy.txt                     | 1 +
 setup.py                                          | 5 ++++-
 5 files changed, 19 insertions(+), 3 deletions(-)
 create mode 100644 doc/api/next_api_changes/development/26849-KS.rst

diff --git a/doc/api/next_api_changes/development/26849-KS.rst b/doc/api/next_api_changes/development/26849-KS.rst
new file mode 100644
index 000000000000..1a1deda40fca
--- /dev/null
+++ b/doc/api/next_api_changes/development/26849-KS.rst
@@ -0,0 +1,5 @@
+Minimum version of setuptools bumped to 64
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To comply with requirements of ``setuptools_scm``, the minimum version of ``setuptools``
+has been increased from 42 to 64.
diff --git a/doc/devel/dependencies.rst b/doc/devel/dependencies.rst
index a865b80cab84..400bc63d42ac 100644
--- a/doc/devel/dependencies.rst
+++ b/doc/devel/dependencies.rst
@@ -228,7 +228,7 @@ Setup dependencies
   runtime dependency.
 - `PyBind11 <https://pypi.org/project/pybind11/>`_ (>= 2.6). Used to connect C/C++ code
   with Python.
-- `setuptools <https://pypi.org/project/setuptools/>`_ (>= 42).
+- `setuptools <https://pypi.org/project/setuptools/>`_ (>= 64).
 - `setuptools_scm <https://pypi.org/project/setuptools-scm/>`_ (>= 7).  Used to
   update the reported ``mpl.__version__`` based on the current git commit.
   Also a runtime dependency for editable installs.
diff --git a/pyproject.toml b/pyproject.toml
index 5c61dd9ff055..4d9ccce2b290 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,10 +4,17 @@ requires = [
     "certifi>=2020.06.20",
     "numpy>=1.25",
     "pybind11>=2.6",
-    "setuptools>=42",
+    "setuptools>=64",
     "setuptools_scm>=7",
 ]
 
+[tool.setuptools_scm]
+version_scheme = "release-branch-semver"
+local_scheme = "node-and-date"
+write_to = "lib/matplotlib/_version.py"
+parentdir_prefix_version = "matplotlib-"
+fallback_version = "0.0+UNKNOWN"
+
 [tool.isort]
 known_pydata = "numpy, matplotlib.pyplot"
 known_firstparty = "matplotlib,mpl_toolkits"
diff --git a/requirements/testing/mypy.txt b/requirements/testing/mypy.txt
index f697772da5ea..a5ca15cfbdad 100644
--- a/requirements/testing/mypy.txt
+++ b/requirements/testing/mypy.txt
@@ -24,5 +24,6 @@ pillow>=8
 pyparsing>=2.3.1
 python-dateutil>=2.7
 setuptools_scm>=7
+setuptools>=64
 
 importlib-resources>=3.2.0 ; python_version < "3.10"
diff --git a/setup.py b/setup.py
index 98aed8ccc912..899021a83254 100644
--- a/setup.py
+++ b/setup.py
@@ -340,7 +340,10 @@ def make_release_tree(self, base_dir, files):
         "python-dateutil>=2.7",
     ] + (
         # Installing from a git checkout that is not producing a wheel.
-        ["setuptools_scm>=7"] if (
+        # setuptools_scm warns with older setuptools, which turns into errors for our
+        # test suite. However setuptools_scm does not themselves pin the version of
+        # setuptools.
+        ["setuptools_scm>=7", "setuptools>=64"] if (
             Path(__file__).with_name(".git").exists() and
             os.environ.get("CIBUILDWHEEL", "0") != "1"
         ) else []

From a9d4f4c692233c4c65e8b86e642ac74053cb16c3 Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Thu, 21 Sep 2023 09:41:23 +0200
Subject: [PATCH 0171/1120] Remove Julian date support

---
 .../next_api_changes/removals/26852-OG.rst    |  5 ++
 lib/matplotlib/dates.py                       | 59 -------------------
 lib/matplotlib/tests/test_dates.py            | 17 ------
 3 files changed, 5 insertions(+), 76 deletions(-)
 create mode 100644 doc/api/next_api_changes/removals/26852-OG.rst

diff --git a/doc/api/next_api_changes/removals/26852-OG.rst b/doc/api/next_api_changes/removals/26852-OG.rst
new file mode 100644
index 000000000000..dc7d595f575f
--- /dev/null
+++ b/doc/api/next_api_changes/removals/26852-OG.rst
@@ -0,0 +1,5 @@
+``num2julian``, ``julian2num`` and ``JULIAN_OFFSET``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+... of the `.dates` module are removed without replacements. These were
+undocumented and not exported.
diff --git a/lib/matplotlib/dates.py b/lib/matplotlib/dates.py
index a11e0d4f1ef6..c12d9f31ba4b 100644
--- a/lib/matplotlib/dates.py
+++ b/lib/matplotlib/dates.py
@@ -205,18 +205,6 @@
 UTC = datetime.timezone.utc
 
 
-@_api.caching_module_getattr
-class __getattr__:
-    JULIAN_OFFSET = _api.deprecated("3.7")(property(lambda self: 1721424.5))
-    # Julian date at 0000-12-31
-    # note that the Julian day epoch is achievable w/
-    # np.datetime64('-4713-11-24T12:00:00'); datetime64 is proleptic
-    # Gregorian and BC has a one-year offset.  So
-    # np.datetime64('0000-12-31') - np.datetime64('-4713-11-24T12:00') =
-    # 1721424.5
-    # Ref: https://en.wikipedia.org/wiki/Julian_day
-
-
 def _get_tzinfo(tz=None):
     """
     Generate `~datetime.tzinfo` from a string or return `~datetime.tzinfo`.
@@ -466,53 +454,6 @@ def date2num(d):
     return d if iterable else d[0]
 
 
-@_api.deprecated("3.7")
-def julian2num(j):
-    """
-    Convert a Julian date (or sequence) to a Matplotlib date (or sequence).
-
-    Parameters
-    ----------
-    j : float or sequence of floats
-        Julian dates (days relative to 4713 BC Jan 1, 12:00:00 Julian
-        calendar or 4714 BC Nov 24, 12:00:00, proleptic Gregorian calendar).
-
-    Returns
-    -------
-    float or sequence of floats
-        Matplotlib dates (days relative to `.get_epoch`).
-    """
-    ep = np.datetime64(get_epoch(), 'h').astype(float) / 24.
-    ep0 = np.datetime64('0000-12-31T00:00:00', 'h').astype(float) / 24.
-    # Julian offset defined above is relative to 0000-12-31, but we need
-    # relative to our current epoch:
-    dt = __getattr__("JULIAN_OFFSET") - ep0 + ep
-    return np.subtract(j, dt)  # Handles both scalar & nonscalar j.
-
-
-@_api.deprecated("3.7")
-def num2julian(n):
-    """
-    Convert a Matplotlib date (or sequence) to a Julian date (or sequence).
-
-    Parameters
-    ----------
-    n : float or sequence of floats
-        Matplotlib dates (days relative to `.get_epoch`).
-
-    Returns
-    -------
-    float or sequence of floats
-        Julian dates (days relative to 4713 BC Jan 1, 12:00:00).
-    """
-    ep = np.datetime64(get_epoch(), 'h').astype(float) / 24.
-    ep0 = np.datetime64('0000-12-31T00:00:00', 'h').astype(float) / 24.
-    # Julian offset defined above is relative to 0000-12-31, but we need
-    # relative to our current epoch:
-    dt = __getattr__("JULIAN_OFFSET") - ep0 + ep
-    return np.add(n, dt)  # Handles both scalar & nonscalar j.
-
-
 def num2date(x, tz=None):
     """
     Convert Matplotlib dates to `~datetime.datetime` objects.
diff --git a/lib/matplotlib/tests/test_dates.py b/lib/matplotlib/tests/test_dates.py
index 8995b9b35f09..4133524e0e1a 100644
--- a/lib/matplotlib/tests/test_dates.py
+++ b/lib/matplotlib/tests/test_dates.py
@@ -6,7 +6,6 @@
 import numpy as np
 import pytest
 
-import matplotlib as mpl
 from matplotlib import rc_context, style
 import matplotlib.dates as mdates
 import matplotlib.pyplot as plt
@@ -1282,22 +1281,6 @@ def test_change_interval_multiples():
     assert ax.get_xticklabels()[1].get_text() == 'Feb 01 2020'
 
 
-def test_julian2num():
-    mdates._reset_epoch_test_example()
-    mdates.set_epoch('0000-12-31')
-    with pytest.warns(mpl.MatplotlibDeprecationWarning):
-        # 2440587.5 is julian date for 1970-01-01T00:00:00
-        # https://en.wikipedia.org/wiki/Julian_day
-        assert mdates.julian2num(2440588.5) == 719164.0
-        assert mdates.num2julian(719165.0) == 2440589.5
-    # set back to the default
-    mdates._reset_epoch_test_example()
-    mdates.set_epoch('1970-01-01T00:00:00')
-    with pytest.warns(mpl.MatplotlibDeprecationWarning):
-        assert mdates.julian2num(2440588.5) == 1.0
-        assert mdates.num2julian(2.0) == 2440589.5
-
-
 def test_DateLocator():
     locator = mdates.DateLocator()
     # Test nonsingular

From 6da5edcaff5a54be75ea05188221aca208980005 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Thu, 21 Sep 2023 13:01:29 -0400
Subject: [PATCH 0172/1120] TST: skeleton of tests passing datetime into every
 method

---
 lib/matplotlib/tests/test_datetime.py | 384 ++++++++++++++++++++++++++
 1 file changed, 384 insertions(+)
 create mode 100644 lib/matplotlib/tests/test_datetime.py

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
new file mode 100644
index 000000000000..fa6cee3916ff
--- /dev/null
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -0,0 +1,384 @@
+import pytest
+
+import matplotlib.pyplot as plt
+import matplotlib as mpl
+
+
+class TestDatetimePlotting:
+    @pytest.mark.xfail(reason="Test for acorr not written yet")
+    @mpl.style.context("default")
+    def test_acorr(self):
+        fig, ax = plt.subplots()
+        ax.acorr(...)
+
+    @pytest.mark.xfail(reason="Test for angle_spectrum not written yet")
+    @mpl.style.context("default")
+    def test_angle_spectrum(self):
+        fig, ax = plt.subplots()
+        ax.angle_spectrum(...)
+
+    @pytest.mark.xfail(reason="Test for annotate not written yet")
+    @mpl.style.context("default")
+    def test_annotate(self):
+        fig, ax = plt.subplots()
+        ax.annotate(...)
+
+    @pytest.mark.xfail(reason="Test for arrow not written yet")
+    @mpl.style.context("default")
+    def test_arrow(self):
+        fig, ax = plt.subplots()
+        ax.arrow(...)
+
+    @pytest.mark.xfail(reason="Test for axhline not written yet")
+    @mpl.style.context("default")
+    def test_axhline(self):
+        fig, ax = plt.subplots()
+        ax.axhline(...)
+
+    @pytest.mark.xfail(reason="Test for axhspan not written yet")
+    @mpl.style.context("default")
+    def test_axhspan(self):
+        fig, ax = plt.subplots()
+        ax.axhspan(...)
+
+    @pytest.mark.xfail(reason="Test for axline not written yet")
+    @mpl.style.context("default")
+    def test_axline(self):
+        fig, ax = plt.subplots()
+        ax.axline(...)
+
+    @pytest.mark.xfail(reason="Test for axvline not written yet")
+    @mpl.style.context("default")
+    def test_axvline(self):
+        fig, ax = plt.subplots()
+        ax.axvline(...)
+
+    @pytest.mark.xfail(reason="Test for axvspan not written yet")
+    @mpl.style.context("default")
+    def test_axvspan(self):
+        fig, ax = plt.subplots()
+        ax.axvspan(...)
+
+    @pytest.mark.xfail(reason="Test for bar not written yet")
+    @mpl.style.context("default")
+    def test_bar(self):
+        fig, ax = plt.subplots()
+        ax.bar(...)
+
+    @pytest.mark.xfail(reason="Test for bar_label not written yet")
+    @mpl.style.context("default")
+    def test_bar_label(self):
+        fig, ax = plt.subplots()
+        ax.bar_label(...)
+
+    @pytest.mark.xfail(reason="Test for barbs not written yet")
+    @mpl.style.context("default")
+    def test_barbs(self):
+        fig, ax = plt.subplots()
+        ax.barbs(...)
+
+    @pytest.mark.xfail(reason="Test for barh not written yet")
+    @mpl.style.context("default")
+    def test_barh(self):
+        fig, ax = plt.subplots()
+        ax.barh(...)
+
+    @pytest.mark.xfail(reason="Test for boxplot not written yet")
+    @mpl.style.context("default")
+    def test_boxplot(self):
+        fig, ax = plt.subplots()
+        ax.boxplot(...)
+
+    @pytest.mark.xfail(reason="Test for broken_barh not written yet")
+    @mpl.style.context("default")
+    def test_broken_barh(self):
+        fig, ax = plt.subplots()
+        ax.broken_barh(...)
+
+    @pytest.mark.xfail(reason="Test for bxp not written yet")
+    @mpl.style.context("default")
+    def test_bxp(self):
+        fig, ax = plt.subplots()
+        ax.bxp(...)
+
+    @pytest.mark.xfail(reason="Test for clabel not written yet")
+    @mpl.style.context("default")
+    def test_clabel(self):
+        fig, ax = plt.subplots()
+        ax.clabel(...)
+
+    @pytest.mark.xfail(reason="Test for cohere not written yet")
+    @mpl.style.context("default")
+    def test_cohere(self):
+        fig, ax = plt.subplots()
+        ax.cohere(...)
+
+    @pytest.mark.xfail(reason="Test for contour not written yet")
+    @mpl.style.context("default")
+    def test_contour(self):
+        fig, ax = plt.subplots()
+        ax.contour(...)
+
+    @pytest.mark.xfail(reason="Test for contourf not written yet")
+    @mpl.style.context("default")
+    def test_contourf(self):
+        fig, ax = plt.subplots()
+        ax.contourf(...)
+
+    @pytest.mark.xfail(reason="Test for csd not written yet")
+    @mpl.style.context("default")
+    def test_csd(self):
+        fig, ax = plt.subplots()
+        ax.csd(...)
+
+    @pytest.mark.xfail(reason="Test for errorbar not written yet")
+    @mpl.style.context("default")
+    def test_errorbar(self):
+        fig, ax = plt.subplots()
+        ax.errorbar(...)
+
+    @pytest.mark.xfail(reason="Test for eventplot not written yet")
+    @mpl.style.context("default")
+    def test_eventplot(self):
+        fig, ax = plt.subplots()
+        ax.eventplot(...)
+
+    @pytest.mark.xfail(reason="Test for fill not written yet")
+    @mpl.style.context("default")
+    def test_fill(self):
+        fig, ax = plt.subplots()
+        ax.fill(...)
+
+    @pytest.mark.xfail(reason="Test for fill_between not written yet")
+    @mpl.style.context("default")
+    def test_fill_between(self):
+        fig, ax = plt.subplots()
+        ax.fill_between(...)
+
+    @pytest.mark.xfail(reason="Test for fill_betweenx not written yet")
+    @mpl.style.context("default")
+    def test_fill_betweenx(self):
+        fig, ax = plt.subplots()
+        ax.fill_betweenx(...)
+
+    @pytest.mark.xfail(reason="Test for hexbin not written yet")
+    @mpl.style.context("default")
+    def test_hexbin(self):
+        fig, ax = plt.subplots()
+        ax.hexbin(...)
+
+    @pytest.mark.xfail(reason="Test for hist not written yet")
+    @mpl.style.context("default")
+    def test_hist(self):
+        fig, ax = plt.subplots()
+        ax.hist(...)
+
+    @pytest.mark.xfail(reason="Test for hist2d not written yet")
+    @mpl.style.context("default")
+    def test_hist2d(self):
+        fig, ax = plt.subplots()
+        ax.hist2d(...)
+
+    @pytest.mark.xfail(reason="Test for hlines not written yet")
+    @mpl.style.context("default")
+    def test_hlines(self):
+        fig, ax = plt.subplots()
+        ax.hlines(...)
+
+    @pytest.mark.xfail(reason="Test for imshow not written yet")
+    @mpl.style.context("default")
+    def test_imshow(self):
+        fig, ax = plt.subplots()
+        ax.imshow(...)
+
+    @pytest.mark.xfail(reason="Test for loglog not written yet")
+    @mpl.style.context("default")
+    def test_loglog(self):
+        fig, ax = plt.subplots()
+        ax.loglog(...)
+
+    @pytest.mark.xfail(reason="Test for magnitude_spectrum not written yet")
+    @mpl.style.context("default")
+    def test_magnitude_spectrum(self):
+        fig, ax = plt.subplots()
+        ax.magnitude_spectrum(...)
+
+    @pytest.mark.xfail(reason="Test for matshow not written yet")
+    @mpl.style.context("default")
+    def test_matshow(self):
+        fig, ax = plt.subplots()
+        ax.matshow(...)
+
+    @pytest.mark.xfail(reason="Test for pcolor not written yet")
+    @mpl.style.context("default")
+    def test_pcolor(self):
+        fig, ax = plt.subplots()
+        ax.pcolor(...)
+
+    @pytest.mark.xfail(reason="Test for pcolorfast not written yet")
+    @mpl.style.context("default")
+    def test_pcolorfast(self):
+        fig, ax = plt.subplots()
+        ax.pcolorfast(...)
+
+    @pytest.mark.xfail(reason="Test for pcolormesh not written yet")
+    @mpl.style.context("default")
+    def test_pcolormesh(self):
+        fig, ax = plt.subplots()
+        ax.pcolormesh(...)
+
+    @pytest.mark.xfail(reason="Test for phase_spectrum not written yet")
+    @mpl.style.context("default")
+    def test_phase_spectrum(self):
+        fig, ax = plt.subplots()
+        ax.phase_spectrum(...)
+
+    @pytest.mark.xfail(reason="Test for plot not written yet")
+    @mpl.style.context("default")
+    def test_plot(self):
+        fig, ax = plt.subplots()
+        ax.plot(...)
+
+    @pytest.mark.xfail(reason="Test for plot_date not written yet")
+    @mpl.style.context("default")
+    def test_plot_date(self):
+        fig, ax = plt.subplots()
+        ax.plot_date(...)
+
+    @pytest.mark.xfail(reason="Test for psd not written yet")
+    @mpl.style.context("default")
+    def test_psd(self):
+        fig, ax = plt.subplots()
+        ax.psd(...)
+
+    @pytest.mark.xfail(reason="Test for quiver not written yet")
+    @mpl.style.context("default")
+    def test_quiver(self):
+        fig, ax = plt.subplots()
+        ax.quiver(...)
+
+    @pytest.mark.xfail(reason="Test for quiverkey not written yet")
+    @mpl.style.context("default")
+    def test_quiverkey(self):
+        fig, ax = plt.subplots()
+        ax.quiverkey(...)
+
+    @pytest.mark.xfail(reason="Test for scatter not written yet")
+    @mpl.style.context("default")
+    def test_scatter(self):
+        fig, ax = plt.subplots()
+        ax.scatter(...)
+
+    @pytest.mark.xfail(reason="Test for semilogx not written yet")
+    @mpl.style.context("default")
+    def test_semilogx(self):
+        fig, ax = plt.subplots()
+        ax.semilogx(...)
+
+    @pytest.mark.xfail(reason="Test for semilogy not written yet")
+    @mpl.style.context("default")
+    def test_semilogy(self):
+        fig, ax = plt.subplots()
+        ax.semilogy(...)
+
+    @pytest.mark.xfail(reason="Test for specgram not written yet")
+    @mpl.style.context("default")
+    def test_specgram(self):
+        fig, ax = plt.subplots()
+        ax.specgram(...)
+
+    @pytest.mark.xfail(reason="Test for spy not written yet")
+    @mpl.style.context("default")
+    def test_spy(self):
+        fig, ax = plt.subplots()
+        ax.spy(...)
+
+    @pytest.mark.xfail(reason="Test for stackplot not written yet")
+    @mpl.style.context("default")
+    def test_stackplot(self):
+        fig, ax = plt.subplots()
+        ax.stackplot(...)
+
+    @pytest.mark.xfail(reason="Test for stairs not written yet")
+    @mpl.style.context("default")
+    def test_stairs(self):
+        fig, ax = plt.subplots()
+        ax.stairs(...)
+
+    @pytest.mark.xfail(reason="Test for stem not written yet")
+    @mpl.style.context("default")
+    def test_stem(self):
+        fig, ax = plt.subplots()
+        ax.stem(...)
+
+    @pytest.mark.xfail(reason="Test for step not written yet")
+    @mpl.style.context("default")
+    def test_step(self):
+        fig, ax = plt.subplots()
+        ax.step(...)
+
+    @pytest.mark.xfail(reason="Test for streamplot not written yet")
+    @mpl.style.context("default")
+    def test_streamplot(self):
+        fig, ax = plt.subplots()
+        ax.streamplot(...)
+
+    @pytest.mark.xfail(reason="Test for table not written yet")
+    @mpl.style.context("default")
+    def test_table(self):
+        fig, ax = plt.subplots()
+        ax.table(...)
+
+    @pytest.mark.xfail(reason="Test for text not written yet")
+    @mpl.style.context("default")
+    def test_text(self):
+        fig, ax = plt.subplots()
+        ax.text(...)
+
+    @pytest.mark.xfail(reason="Test for tricontour not written yet")
+    @mpl.style.context("default")
+    def test_tricontour(self):
+        fig, ax = plt.subplots()
+        ax.tricontour(...)
+
+    @pytest.mark.xfail(reason="Test for tricontourf not written yet")
+    @mpl.style.context("default")
+    def test_tricontourf(self):
+        fig, ax = plt.subplots()
+        ax.tricontourf(...)
+
+    @pytest.mark.xfail(reason="Test for tripcolor not written yet")
+    @mpl.style.context("default")
+    def test_tripcolor(self):
+        fig, ax = plt.subplots()
+        ax.tripcolor(...)
+
+    @pytest.mark.xfail(reason="Test for triplot not written yet")
+    @mpl.style.context("default")
+    def test_triplot(self):
+        fig, ax = plt.subplots()
+        ax.triplot(...)
+
+    @pytest.mark.xfail(reason="Test for violin not written yet")
+    @mpl.style.context("default")
+    def test_violin(self):
+        fig, ax = plt.subplots()
+        ax.violin(...)
+
+    @pytest.mark.xfail(reason="Test for violinplot not written yet")
+    @mpl.style.context("default")
+    def test_violinplot(self):
+        fig, ax = plt.subplots()
+        ax.violinplot(...)
+
+    @pytest.mark.xfail(reason="Test for vlines not written yet")
+    @mpl.style.context("default")
+    def test_vlines(self):
+        fig, ax = plt.subplots()
+        ax.vlines(...)
+
+    @pytest.mark.xfail(reason="Test for xcorr not written yet")
+    @mpl.style.context("default")
+    def test_xcorr(self):
+        fig, ax = plt.subplots()
+        ax.xcorr(...)

From 6b870e72eee153f856eced32435ad1c789e7e44b Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Thu, 21 Sep 2023 13:58:44 -0400
Subject: [PATCH 0173/1120] TST: put pie back

timedeltas make sense
---
 lib/matplotlib/tests/test_datetime.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index fa6cee3916ff..e313c3bf9523 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -209,6 +209,12 @@ def test_matshow(self):
         fig, ax = plt.subplots()
         ax.matshow(...)
 
+    @pytest.mark.xfail(reason="Test for pie not written yet")
+    @mpl.style.context("default")
+    def test_pie(self):
+        fig, ax = plt.subplots()
+        ax.pcolor(...)
+
     @pytest.mark.xfail(reason="Test for pcolor not written yet")
     @mpl.style.context("default")
     def test_pcolor(self):

From de6919ca5f620e458416d857014f17125a8ef2b2 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Thu, 21 Sep 2023 13:06:40 -0400
Subject: [PATCH 0174/1120] TST: implement plot smoke test

---
 lib/matplotlib/tests/test_datetime.py | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index e313c3bf9523..53958229f174 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -1,3 +1,6 @@
+import datetime
+import numpy as np
+
 import pytest
 
 import matplotlib.pyplot as plt
@@ -239,11 +242,15 @@ def test_phase_spectrum(self):
         fig, ax = plt.subplots()
         ax.phase_spectrum(...)
 
-    @pytest.mark.xfail(reason="Test for plot not written yet")
     @mpl.style.context("default")
     def test_plot(self):
-        fig, ax = plt.subplots()
-        ax.plot(...)
+        mpl.rcParams["date.converter"] = 'concise'
+        N = 6
+        fig, (ax1, ax2, ax3) = plt.subplots(3, 1, layout='constrained')
+        x = np.array([datetime.datetime(2023, 9, n) for n in range(1, N)])
+        ax1.plot(x, range(1, N))
+        ax2.plot(range(1, N), x)
+        ax3.plot(x, x)
 
     @pytest.mark.xfail(reason="Test for plot_date not written yet")
     @mpl.style.context("default")

From 5b0feba7be1af643510a6fe61deb427343aa61da Mon Sep 17 00:00:00 2001
From: Pavel Liavonau <liavonlida@gmail.com>
Date: Thu, 21 Sep 2023 20:09:47 +0200
Subject: [PATCH 0175/1120] QT/NavidationToolbar2: configure subplots dialog
 should be modal.

Fix for a case when parent windows is modal. Configure subplots hides behind parent modal windows in case of non-modal usage.
Other dialogs of NavigationToolbarQT are modal, so it looks like a bug.

tested on pyQT6
---
 lib/matplotlib/backends/backend_qt.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/lib/matplotlib/backends/backend_qt.py b/lib/matplotlib/backends/backend_qt.py
index 4b3783bc87ca..2aa7874fbdb7 100644
--- a/lib/matplotlib/backends/backend_qt.py
+++ b/lib/matplotlib/backends/backend_qt.py
@@ -759,6 +759,7 @@ def configure_subplots(self):
             self.canvas.mpl_connect(
                 "close_event", lambda e: self._subplot_dialog.reject())
         self._subplot_dialog.update_from_current_subplotpars()
+        self._subplot_dialog.setModal(True)
         self._subplot_dialog.show()
         return self._subplot_dialog
 

From 5e5378ec107674fcd4d8f48f24487964675f00f5 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 20 Sep 2023 23:47:00 -0400
Subject: [PATCH 0176/1120] DOC: Fix missing-reference generation on Windows

On Windows, the path is absolute and contains a colon after the drive
letter, so splitting on colon results in trying to relativize 'c' (or
whatever the drive is) to the base directory, which just makes the final
path into base directory + file path.
---
 doc/missing-references.json         | 743 +++++++++++++---------------
 doc/sphinxext/missing_references.py |  14 +-
 2 files changed, 344 insertions(+), 413 deletions(-)

diff --git a/doc/missing-references.json b/doc/missing-references.json
index 72de214df985..1b0a6f9ef226 100644
--- a/doc/missing-references.json
+++ b/doc/missing-references.json
@@ -1,731 +1,660 @@
 {
   "py:attr": {
     "cbar_axes": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axes_grid1\\axes_grid.py:docstring of mpl_toolkits.axes_grid1.axes_grid.ImageGrid:72",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axisartist\\axes_grid.py:docstring of mpl_toolkits.axisartist.axes_grid.ImageGrid:72"
+      "lib/mpl_toolkits/axes_grid1/axes_grid.py:docstring of mpl_toolkits.axes_grid1.axes_grid.ImageGrid:72",
+      "lib/mpl_toolkits/axisartist/axes_grid.py:docstring of mpl_toolkits.axisartist.axes_grid.ImageGrid:72"
     ],
     "eventson": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\widgets.py:docstring of matplotlib.widgets.CheckButtons.set_active:4",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\widgets.py:docstring of matplotlib.widgets.RadioButtons.set_active:4"
+      "lib/matplotlib/widgets.py:docstring of matplotlib.widgets.CheckButtons.set_active:4",
+      "lib/matplotlib/widgets.py:docstring of matplotlib.widgets.RadioButtons.set_active:4"
     ],
     "fmt_zdata": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\mplot3d\\axes3d.py:docstring of mpl_toolkits.mplot3d.axes3d.Axes3D.format_zdata:2"
+      "lib/mpl_toolkits/mplot3d/axes3d.py:docstring of mpl_toolkits.mplot3d.axes3d.Axes3D.format_zdata:2"
     ],
     "height": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.Bbox.bounds:2"
+      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms.Bbox.bounds:2"
     ],
     "input_dims": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.AitoffAxes.AitoffTransform.transform_non_affine:14",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.AitoffAxes.InvertedAitoffTransform.transform_non_affine:14",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.HammerAxes.HammerTransform.transform_non_affine:14",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.HammerAxes.InvertedHammerTransform.transform_non_affine:14",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.LambertAxes.InvertedLambertTransform.transform_non_affine:14",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.LambertAxes.LambertTransform.transform_non_affine:14",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.MollweideAxes.InvertedMollweideTransform.transform_non_affine:14",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.MollweideAxes.MollweideTransform.transform_non_affine:14",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.AffineBase.transform:8",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.AffineBase.transform_affine:15",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.AffineBase.transform_non_affine:14",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.CompositeGenericTransform.transform_affine:15",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.CompositeGenericTransform.transform_non_affine:14",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.IdentityTransform.transform:8",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.IdentityTransform.transform_affine:15",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.IdentityTransform.transform_non_affine:14"
+      "lib/matplotlib/projections/geo.py:docstring of matplotlib.projections.geo.AitoffAxes.AitoffTransform.transform_non_affine:14",
+      "lib/matplotlib/projections/geo.py:docstring of matplotlib.projections.geo.AitoffAxes.InvertedAitoffTransform.transform_non_affine:14",
+      "lib/matplotlib/projections/geo.py:docstring of matplotlib.projections.geo.HammerAxes.HammerTransform.transform_non_affine:14",
+      "lib/matplotlib/projections/geo.py:docstring of matplotlib.projections.geo.HammerAxes.InvertedHammerTransform.transform_non_affine:14",
+      "lib/matplotlib/projections/geo.py:docstring of matplotlib.projections.geo.LambertAxes.InvertedLambertTransform.transform_non_affine:14",
+      "lib/matplotlib/projections/geo.py:docstring of matplotlib.projections.geo.LambertAxes.LambertTransform.transform_non_affine:14",
+      "lib/matplotlib/projections/geo.py:docstring of matplotlib.projections.geo.MollweideAxes.InvertedMollweideTransform.transform_non_affine:14",
+      "lib/matplotlib/projections/geo.py:docstring of matplotlib.projections.geo.MollweideAxes.MollweideTransform.transform_non_affine:14",
+      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms.AffineBase.transform:8",
+      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms.AffineBase.transform_affine:15",
+      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms.AffineBase.transform_non_affine:14",
+      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms.CompositeGenericTransform.transform_affine:15",
+      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms.CompositeGenericTransform.transform_non_affine:14",
+      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms.IdentityTransform.transform:8",
+      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms.IdentityTransform.transform_affine:15",
+      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms.IdentityTransform.transform_non_affine:14"
     ],
     "lines": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\colorbar.py:docstring of matplotlib.colorbar.Colorbar.add_lines:4"
+      "lib/matplotlib/colorbar.py:docstring of matplotlib.colorbar.Colorbar.add_lines:4"
     ],
     "matplotlib.axes.Axes.patch": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\tutorials/artists.rst:188",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\tutorials/artists.rst:427"
+      "doc/tutorials/artists.rst:188",
+      "doc/tutorials/artists.rst:427"
     ],
     "matplotlib.axes.Axes.patches": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\tutorials/artists.rst:465"
+      "doc/tutorials/artists.rst:465"
     ],
     "matplotlib.axes.Axes.transAxes": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axes_grid1\\anchored_artists.py:docstring of mpl_toolkits.axes_grid1.anchored_artists.AnchoredDirectionArrows:8"
+      "lib/mpl_toolkits/axes_grid1/anchored_artists.py:docstring of mpl_toolkits.axes_grid1.anchored_artists.AnchoredDirectionArrows:8"
     ],
     "matplotlib.axes.Axes.transData": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axes_grid1\\anchored_artists.py:docstring of mpl_toolkits.axes_grid1.anchored_artists.AnchoredAuxTransformBox:11",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axes_grid1\\anchored_artists.py:docstring of mpl_toolkits.axes_grid1.anchored_artists.AnchoredEllipse:33",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axes_grid1\\anchored_artists.py:docstring of mpl_toolkits.axes_grid1.anchored_artists.AnchoredSizeBar:8"
+      "lib/mpl_toolkits/axes_grid1/anchored_artists.py:docstring of mpl_toolkits.axes_grid1.anchored_artists.AnchoredAuxTransformBox:11",
+      "lib/mpl_toolkits/axes_grid1/anchored_artists.py:docstring of mpl_toolkits.axes_grid1.anchored_artists.AnchoredEllipse:33",
+      "lib/mpl_toolkits/axes_grid1/anchored_artists.py:docstring of mpl_toolkits.axes_grid1.anchored_artists.AnchoredSizeBar:8"
     ],
     "matplotlib.axes.Axes.xaxis": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\tutorials/artists.rst:611",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\users/explain/axes/axes_intro.rst:133"
+      "doc/tutorials/artists.rst:611",
+      "doc/users/explain/axes/axes_intro.rst:133"
     ],
     "matplotlib.axes.Axes.yaxis": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\tutorials/artists.rst:611",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\users/explain/axes/axes_intro.rst:133"
+      "doc/tutorials/artists.rst:611",
+      "doc/users/explain/axes/axes_intro.rst:133"
     ],
     "matplotlib.axis.Axis.label": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\tutorials/artists.rst:658"
+      "doc/tutorials/artists.rst:658"
     ],
     "matplotlib.colors.Colormap.name": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\cm.py:docstring of matplotlib.cm.register_cmap:14"
+      "lib/matplotlib/cm.py:docstring of matplotlib.cm.register_cmap:14"
     ],
     "matplotlib.figure.Figure.patch": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\tutorials/artists.rst:188",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\tutorials/artists.rst:321"
+      "doc/tutorials/artists.rst:188",
+      "doc/tutorials/artists.rst:321"
     ],
     "matplotlib.figure.Figure.transFigure": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\tutorials/artists.rst:370"
+      "doc/tutorials/artists.rst:370"
     ],
     "max": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.Bbox.p1:4"
+      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms.Bbox.p1:4"
     ],
     "min": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.Bbox.p0:4"
+      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms.Bbox.p0:4"
     ],
     "mpl_toolkits.mplot3d.axis3d._axinfo": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/toolkits/mplot3d.rst:66"
+      "doc/api/toolkits/mplot3d.rst:66"
     ],
     "name": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\scale.py:docstring of matplotlib.scale.ScaleBase:8"
+      "lib/matplotlib/scale.py:docstring of matplotlib.scale.ScaleBase:8"
     ],
     "output_dims": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.AitoffAxes.AitoffTransform.transform_non_affine:20",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.AitoffAxes.InvertedAitoffTransform.transform_non_affine:20",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.HammerAxes.HammerTransform.transform_non_affine:20",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.HammerAxes.InvertedHammerTransform.transform_non_affine:20",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.LambertAxes.InvertedLambertTransform.transform_non_affine:20",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.LambertAxes.LambertTransform.transform_non_affine:20",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.MollweideAxes.InvertedMollweideTransform.transform_non_affine:20",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.MollweideAxes.MollweideTransform.transform_non_affine:20",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.AffineBase.transform:14",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.AffineBase.transform_affine:21",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.AffineBase.transform_non_affine:20",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.CompositeGenericTransform.transform_affine:21",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.CompositeGenericTransform.transform_non_affine:20",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.IdentityTransform.transform:14",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.IdentityTransform.transform_affine:21",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.IdentityTransform.transform_non_affine:20"
+      "lib/matplotlib/projections/geo.py:docstring of matplotlib.projections.geo.AitoffAxes.AitoffTransform.transform_non_affine:20",
+      "lib/matplotlib/projections/geo.py:docstring of matplotlib.projections.geo.AitoffAxes.InvertedAitoffTransform.transform_non_affine:20",
+      "lib/matplotlib/projections/geo.py:docstring of matplotlib.projections.geo.HammerAxes.HammerTransform.transform_non_affine:20",
+      "lib/matplotlib/projections/geo.py:docstring of matplotlib.projections.geo.HammerAxes.InvertedHammerTransform.transform_non_affine:20",
+      "lib/matplotlib/projections/geo.py:docstring of matplotlib.projections.geo.LambertAxes.InvertedLambertTransform.transform_non_affine:20",
+      "lib/matplotlib/projections/geo.py:docstring of matplotlib.projections.geo.LambertAxes.LambertTransform.transform_non_affine:20",
+      "lib/matplotlib/projections/geo.py:docstring of matplotlib.projections.geo.MollweideAxes.InvertedMollweideTransform.transform_non_affine:20",
+      "lib/matplotlib/projections/geo.py:docstring of matplotlib.projections.geo.MollweideAxes.MollweideTransform.transform_non_affine:20",
+      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms.AffineBase.transform:14",
+      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms.AffineBase.transform_affine:21",
+      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms.AffineBase.transform_non_affine:20",
+      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms.CompositeGenericTransform.transform_affine:21",
+      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms.CompositeGenericTransform.transform_non_affine:20",
+      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms.IdentityTransform.transform:14",
+      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms.IdentityTransform.transform_affine:21",
+      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms.IdentityTransform.transform_non_affine:20"
     ],
     "triangulation": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\tri\\_trirefine.py:docstring of matplotlib.tri._trirefine.UniformTriRefiner.refine_triangulation:2"
+      "lib/matplotlib/tri/_trirefine.py:docstring of matplotlib.tri._trirefine.UniformTriRefiner.refine_triangulation:2"
     ],
     "use_sticky_edges": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.margins:53"
+      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.margins:53"
     ],
     "width": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.Bbox.bounds:2"
+      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms.Bbox.bounds:2"
     ],
     "xmax": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.Bbox.x1:4"
+      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms.Bbox.x1:4"
     ],
     "xmin": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.Bbox.x0:4"
+      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms.Bbox.x0:4"
     ],
     "ymax": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.Bbox.y1:4"
+      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms.Bbox.y1:4"
     ],
     "ymin": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.Bbox.y0:4"
+      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms.Bbox.y0:4"
     ]
   },
   "py:class": {
-    "ArrayLike": [
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.acorr:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.angle_spectrum:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.bar:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.bar_label:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.barh:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.boxplot:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.clabel:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.csd:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.ecdf:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.errorbar:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.eventplot:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.figimage:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.fill_between:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.fill_betweenx:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.hist2d:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.hist:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.hlines:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.imsave:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.imshow:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.magnitude_spectrum:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.matshow:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.pcolor:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.pcolormesh:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.phase_spectrum:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.pie:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.plot:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.plot_date:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.psd:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.rgrids:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.scatter:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.specgram:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.spy:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.stairs:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.stem:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.step:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.subplot_mosaic:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.thetagrids:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.violinplot:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.vlines:1"
-    ],
-    "ColorType": [
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.errorbar:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.eventplot:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.hist:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.hlines:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.pie:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.scatter:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.vlines:1"
-    ],
-    "HashableList": [
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.subplot_mosaic:1"
-    ],
     "HashableList[_HT]": [
       "doc/docstring of builtins.list:17"
     ],
-    "LineStyleType": [
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.eventplot:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.hlines:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.vlines:1"
-    ],
-    "MarkerType": [
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.scatter:1"
-    ],
-    "_AxesBase": [
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.twinx:1",
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.twiny:1"
-    ],
     "matplotlib.axes._base._AxesBase": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/artist_api.rst:202"
+      "doc/api/artist_api.rst:202"
     ],
     "matplotlib.backend_bases.FigureCanvas": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\tutorials/artists.rst:36",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\tutorials/artists.rst:38",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\tutorials/artists.rst:43"
+      "doc/tutorials/artists.rst:36",
+      "doc/tutorials/artists.rst:38",
+      "doc/tutorials/artists.rst:43"
     ],
     "matplotlib.backend_bases.Renderer": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\tutorials/artists.rst:38",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\tutorials/artists.rst:43"
+      "doc/tutorials/artists.rst:38",
+      "doc/tutorials/artists.rst:43"
     ],
     "matplotlib.backend_bases._Backend": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backend_bases.py:docstring of matplotlib.backend_bases.ShowBase:1"
+      "lib/matplotlib/backend_bases.py:docstring of matplotlib.backend_bases.ShowBase:1"
     ],
     "matplotlib.backends._backend_pdf_ps.RendererPDFPSBase": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backends\\backend_pdf.py:docstring of matplotlib.backends.backend_pdf.RendererPdf:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backends\\backend_ps.py:docstring of matplotlib.backends.backend_ps.RendererPS:1"
+      "lib/matplotlib/backends/backend_pdf.py:docstring of matplotlib.backends.backend_pdf.RendererPdf:1",
+      "lib/matplotlib/backends/backend_ps.py:docstring of matplotlib.backends.backend_ps.RendererPS:1"
     ],
     "matplotlib.backends._backend_tk.FigureCanvasTk": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backends\\backend_tkagg.py:docstring of matplotlib.backends.backend_tkagg.FigureCanvasTkAgg:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backends\\backend_tkcairo.py:docstring of matplotlib.backends.backend_tkcairo.FigureCanvasTkCairo:1"
+      "lib/matplotlib/backends/backend_tkagg.py:docstring of matplotlib.backends.backend_tkagg.FigureCanvasTkAgg:1",
+      "lib/matplotlib/backends/backend_tkcairo.py:docstring of matplotlib.backends.backend_tkcairo.FigureCanvasTkCairo:1"
     ],
     "matplotlib.collections._CollectionWithSizes": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/artist_api.rst:202",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/collections_api.rst:13",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\collections.py:docstring of matplotlib.collections.CircleCollection:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\collections.py:docstring of matplotlib.collections.PathCollection:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\collections.py:docstring of matplotlib.collections.PolyCollection:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\collections.py:docstring of matplotlib.collections.RegularPolyCollection:1"
+      "doc/api/artist_api.rst:202",
+      "doc/api/collections_api.rst:13",
+      "lib/matplotlib/collections.py:docstring of matplotlib.collections.CircleCollection:1",
+      "lib/matplotlib/collections.py:docstring of matplotlib.collections.PathCollection:1",
+      "lib/matplotlib/collections.py:docstring of matplotlib.collections.PolyCollection:1",
+      "lib/matplotlib/collections.py:docstring of matplotlib.collections.RegularPolyCollection:1"
     ],
     "matplotlib.collections._MeshData": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/artist_api.rst:202",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/collections_api.rst:13",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\collections.py:docstring of matplotlib.collections.PolyQuadMesh:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\collections.py:docstring of matplotlib.collections.QuadMesh:1"
+      "doc/api/artist_api.rst:202",
+      "doc/api/collections_api.rst:13",
+      "lib/matplotlib/collections.py:docstring of matplotlib.collections.PolyQuadMesh:1",
+      "lib/matplotlib/collections.py:docstring of matplotlib.collections.QuadMesh:1"
     ],
     "matplotlib.image._ImageBase": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/artist_api.rst:202",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\image.py:docstring of matplotlib.image.AxesImage:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\image.py:docstring of matplotlib.image.BboxImage:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\image.py:docstring of matplotlib.image.FigureImage:1"
+      "doc/api/artist_api.rst:202",
+      "lib/matplotlib/image.py:docstring of matplotlib.image.AxesImage:1",
+      "lib/matplotlib/image.py:docstring of matplotlib.image.BboxImage:1",
+      "lib/matplotlib/image.py:docstring of matplotlib.image.FigureImage:1"
     ],
     "matplotlib.patches.ArrowStyle._Base": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle.Fancy:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle.Simple:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle.Wedge:1"
+      "lib/matplotlib/patches.py:docstring of matplotlib.patches.ArrowStyle.Fancy:1",
+      "lib/matplotlib/patches.py:docstring of matplotlib.patches.ArrowStyle.Simple:1",
+      "lib/matplotlib/patches.py:docstring of matplotlib.patches.ArrowStyle.Wedge:1"
     ],
     "matplotlib.patches.ArrowStyle._Curve": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle.BarAB:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle.BracketA:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle.BracketAB:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle.BracketB:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle.BracketCurve:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle.Curve:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle.CurveA:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle.CurveAB:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle.CurveB:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle.CurveBracket:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle.CurveFilledA:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle.CurveFilledAB:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle.CurveFilledB:1"
+      "lib/matplotlib/patches.py:docstring of matplotlib.patches.ArrowStyle.BarAB:1",
+      "lib/matplotlib/patches.py:docstring of matplotlib.patches.ArrowStyle.BracketA:1",
+      "lib/matplotlib/patches.py:docstring of matplotlib.patches.ArrowStyle.BracketAB:1",
+      "lib/matplotlib/patches.py:docstring of matplotlib.patches.ArrowStyle.BracketB:1",
+      "lib/matplotlib/patches.py:docstring of matplotlib.patches.ArrowStyle.BracketCurve:1",
+      "lib/matplotlib/patches.py:docstring of matplotlib.patches.ArrowStyle.Curve:1",
+      "lib/matplotlib/patches.py:docstring of matplotlib.patches.ArrowStyle.CurveA:1",
+      "lib/matplotlib/patches.py:docstring of matplotlib.patches.ArrowStyle.CurveAB:1",
+      "lib/matplotlib/patches.py:docstring of matplotlib.patches.ArrowStyle.CurveB:1",
+      "lib/matplotlib/patches.py:docstring of matplotlib.patches.ArrowStyle.CurveBracket:1",
+      "lib/matplotlib/patches.py:docstring of matplotlib.patches.ArrowStyle.CurveFilledA:1",
+      "lib/matplotlib/patches.py:docstring of matplotlib.patches.ArrowStyle.CurveFilledAB:1",
+      "lib/matplotlib/patches.py:docstring of matplotlib.patches.ArrowStyle.CurveFilledB:1"
     ],
     "matplotlib.patches.ConnectionStyle._Base": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ConnectionStyle.Angle3:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ConnectionStyle.Angle:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ConnectionStyle.Arc3:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ConnectionStyle.Arc:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ConnectionStyle.Bar:1"
+      "lib/matplotlib/patches.py:docstring of matplotlib.patches.ConnectionStyle.Angle3:1",
+      "lib/matplotlib/patches.py:docstring of matplotlib.patches.ConnectionStyle.Angle:1",
+      "lib/matplotlib/patches.py:docstring of matplotlib.patches.ConnectionStyle.Arc3:1",
+      "lib/matplotlib/patches.py:docstring of matplotlib.patches.ConnectionStyle.Arc:1",
+      "lib/matplotlib/patches.py:docstring of matplotlib.patches.ConnectionStyle.Bar:1"
     ],
     "matplotlib.patches._Style": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ArrowStyle:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.BoxStyle:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patches.py:docstring of matplotlib.patches.ConnectionStyle:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axisartist\\axisline_style.py:docstring of mpl_toolkits.axisartist.axisline_style.AxislineStyle:1"
+      "lib/matplotlib/patches.py:docstring of matplotlib.patches.ArrowStyle:1",
+      "lib/matplotlib/patches.py:docstring of matplotlib.patches.BoxStyle:1",
+      "lib/matplotlib/patches.py:docstring of matplotlib.patches.ConnectionStyle:1",
+      "lib/mpl_toolkits/axisartist/axisline_style.py:docstring of mpl_toolkits.axisartist.axisline_style.AxislineStyle:1"
     ],
     "matplotlib.projections.geo._GeoTransform": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.AitoffAxes.AitoffTransform:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.AitoffAxes.InvertedAitoffTransform:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.HammerAxes.HammerTransform:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.HammerAxes.InvertedHammerTransform:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.LambertAxes.InvertedLambertTransform:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.LambertAxes.LambertTransform:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.MollweideAxes.InvertedMollweideTransform:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\projections\\geo.py:docstring of matplotlib.projections.geo.MollweideAxes.MollweideTransform:1"
+      "lib/matplotlib/projections/geo.py:docstring of matplotlib.projections.geo.AitoffAxes.AitoffTransform:1",
+      "lib/matplotlib/projections/geo.py:docstring of matplotlib.projections.geo.AitoffAxes.InvertedAitoffTransform:1",
+      "lib/matplotlib/projections/geo.py:docstring of matplotlib.projections.geo.HammerAxes.HammerTransform:1",
+      "lib/matplotlib/projections/geo.py:docstring of matplotlib.projections.geo.HammerAxes.InvertedHammerTransform:1",
+      "lib/matplotlib/projections/geo.py:docstring of matplotlib.projections.geo.LambertAxes.InvertedLambertTransform:1",
+      "lib/matplotlib/projections/geo.py:docstring of matplotlib.projections.geo.LambertAxes.LambertTransform:1",
+      "lib/matplotlib/projections/geo.py:docstring of matplotlib.projections.geo.MollweideAxes.InvertedMollweideTransform:1",
+      "lib/matplotlib/projections/geo.py:docstring of matplotlib.projections.geo.MollweideAxes.MollweideTransform:1"
     ],
     "matplotlib.text._AnnotationBase": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/artist_api.rst:202",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\offsetbox.py:docstring of matplotlib.offsetbox.AnnotationBbox:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\text.py:docstring of matplotlib.text.Annotation:1"
+      "doc/api/artist_api.rst:202",
+      "lib/matplotlib/offsetbox.py:docstring of matplotlib.offsetbox.AnnotationBbox:1",
+      "lib/matplotlib/text.py:docstring of matplotlib.text.Annotation:1"
     ],
     "matplotlib.transforms._BlendedMixin": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.BlendedAffine2D:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\transforms.py:docstring of matplotlib.transforms.BlendedGenericTransform:1"
+      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms.BlendedAffine2D:1",
+      "lib/matplotlib/transforms.py:docstring of matplotlib.transforms.BlendedGenericTransform:1"
     ],
     "matplotlib.widgets._SelectorWidget": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\widgets.py:docstring of matplotlib.widgets.LassoSelector:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\widgets.py:docstring of matplotlib.widgets.PolygonSelector:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\widgets.py:docstring of matplotlib.widgets.RectangleSelector:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\widgets.py:docstring of matplotlib.widgets.SpanSelector:1"
+      "lib/matplotlib/widgets.py:docstring of matplotlib.widgets.LassoSelector:1",
+      "lib/matplotlib/widgets.py:docstring of matplotlib.widgets.PolygonSelector:1",
+      "lib/matplotlib/widgets.py:docstring of matplotlib.widgets.RectangleSelector:1",
+      "lib/matplotlib/widgets.py:docstring of matplotlib.widgets.SpanSelector:1"
     ],
     "mpl_toolkits.axes_grid1.axes_size._Base": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axes_grid1\\axes_size.py:docstring of mpl_toolkits.axes_grid1.axes_size.Add:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axes_grid1\\axes_size.py:docstring of mpl_toolkits.axes_grid1.axes_size.AxesX:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axes_grid1\\axes_size.py:docstring of mpl_toolkits.axes_grid1.axes_size.AxesY:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axes_grid1\\axes_size.py:docstring of mpl_toolkits.axes_grid1.axes_size.Fixed:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axes_grid1\\axes_size.py:docstring of mpl_toolkits.axes_grid1.axes_size.Fraction:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axes_grid1\\axes_size.py:docstring of mpl_toolkits.axes_grid1.axes_size.MaxExtent:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axes_grid1\\axes_size.py:docstring of mpl_toolkits.axes_grid1.axes_size.Scaled:1"
+      "lib/mpl_toolkits/axes_grid1/axes_size.py:docstring of mpl_toolkits.axes_grid1.axes_size.Add:1",
+      "lib/mpl_toolkits/axes_grid1/axes_size.py:docstring of mpl_toolkits.axes_grid1.axes_size.AxesX:1",
+      "lib/mpl_toolkits/axes_grid1/axes_size.py:docstring of mpl_toolkits.axes_grid1.axes_size.AxesY:1",
+      "lib/mpl_toolkits/axes_grid1/axes_size.py:docstring of mpl_toolkits.axes_grid1.axes_size.Fixed:1",
+      "lib/mpl_toolkits/axes_grid1/axes_size.py:docstring of mpl_toolkits.axes_grid1.axes_size.Fraction:1",
+      "lib/mpl_toolkits/axes_grid1/axes_size.py:docstring of mpl_toolkits.axes_grid1.axes_size.MaxExtent:1",
+      "lib/mpl_toolkits/axes_grid1/axes_size.py:docstring of mpl_toolkits.axes_grid1.axes_size.Scaled:1"
     ],
     "mpl_toolkits.axes_grid1.parasite_axes.AxesHostAxes": [
-      "<unknown>:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/mpl_toolkits.axes_grid1.parasite_axes.rst:30:<autosummary>:1"
+      "doc/api/_as_gen/mpl_toolkits.axes_grid1.parasite_axes.rst:32:<autosummary>:1"
     ],
     "mpl_toolkits.axes_grid1.parasite_axes.AxesParasite": [
-      "<unknown>:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/mpl_toolkits.axes_grid1.parasite_axes.rst:30:<autosummary>:1"
+      "doc/api/_as_gen/mpl_toolkits.axes_grid1.parasite_axes.rst:32:<autosummary>:1"
     ],
     "mpl_toolkits.axisartist.Axes": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/toolkits/axisartist.rst:6"
+      "doc/api/toolkits/axisartist.rst:6"
     ],
     "mpl_toolkits.axisartist.axisline_style.AxislineStyle._Base": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axisartist\\axisline_style.py:docstring of mpl_toolkits.axisartist.axisline_style.AxislineStyle.SimpleArrow:1"
+      "lib/mpl_toolkits/axisartist/axisline_style.py:docstring of mpl_toolkits.axisartist.axisline_style.AxislineStyle:1"
     ],
     "mpl_toolkits.axisartist.axisline_style._FancyAxislineStyle.FilledArrow": [
-      "<unknown>:1"
+      "lib/mpl_toolkits/axisartist/axisline_style.py:docstring of mpl_toolkits.axisartist.axisline_style.AxislineStyle:1"
     ],
     "mpl_toolkits.axisartist.axisline_style._FancyAxislineStyle.SimpleArrow": [
-      "<unknown>:1"
+      "lib/mpl_toolkits/axisartist/axisline_style.py:docstring of mpl_toolkits.axisartist.axisline_style.AxislineStyle:1"
     ],
     "mpl_toolkits.axisartist.axislines._FixedAxisArtistHelperBase": [
-      "<unknown>:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axisartist\\axislines.py:docstring of mpl_toolkits.axisartist.axislines.FixedAxisArtistHelperRectilinear:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axisartist\\grid_helper_curvelinear.py:docstring of mpl_toolkits.axisartist.grid_helper_curvelinear.FixedAxisArtistHelper:1"
+      "lib/mpl_toolkits/axisartist/axislines.py:docstring of mpl_toolkits.axisartist.axislines.FixedAxisArtistHelperRectilinear:1",
+      "lib/mpl_toolkits/axisartist/grid_helper_curvelinear.py:docstring of mpl_toolkits.axisartist.grid_helper_curvelinear.FixedAxisArtistHelper:1"
     ],
     "mpl_toolkits.axisartist.axislines._FloatingAxisArtistHelperBase": [
-      "<unknown>:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axisartist\\axislines.py:docstring of mpl_toolkits.axisartist.axislines.FloatingAxisArtistHelperRectilinear:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axisartist\\grid_helper_curvelinear.py:docstring of mpl_toolkits.axisartist.grid_helper_curvelinear.FloatingAxisArtistHelper:1"
+      "lib/mpl_toolkits/axisartist/axislines.py:docstring of mpl_toolkits.axisartist.axislines.FloatingAxisArtistHelperRectilinear:1",
+      "lib/mpl_toolkits/axisartist/grid_helper_curvelinear.py:docstring of mpl_toolkits.axisartist.grid_helper_curvelinear.FloatingAxisArtistHelper:1"
     ],
     "mpl_toolkits.axisartist.floating_axes.FloatingAxesHostAxes": [
-      "<unknown>:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/mpl_toolkits.axisartist.floating_axes.rst:32:<autosummary>:1"
+      "doc/api/_as_gen/mpl_toolkits.axisartist.floating_axes.rst:34:<autosummary>:1"
     ],
     "numpy.uint8": [
-      "<unknown>:1"
+      "lib/matplotlib/path.py:docstring of matplotlib.path:1"
     ]
   },
   "py:data": {
     "matplotlib.axes.Axes.transAxes": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes._axes.Axes.legend:248",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\figure.py:docstring of matplotlib.figure.FigureBase.legend:249",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\legend.py:docstring of matplotlib.legend.Legend:201",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.figlegend:249",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.legend:248"
+      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.legend:248",
+      "lib/matplotlib/figure.py:docstring of matplotlib.figure.FigureBase.legend:249",
+      "lib/matplotlib/legend.py:docstring of matplotlib.legend.Legend:201",
+      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.figlegend:249",
+      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.legend:248"
     ]
   },
   "py:meth": {
     "AbstractPathEffect._update_gc": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patheffects.py:docstring of matplotlib.patheffects.SimpleLineShadow:44",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patheffects.py:docstring of matplotlib.patheffects.SimplePatchShadow:42",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patheffects.py:docstring of matplotlib.patheffects.TickedStroke:57",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patheffects.py:docstring of matplotlib.patheffects.withSimplePatchShadow:51",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patheffects.py:docstring of matplotlib.patheffects.withTickedStroke:56"
+      "lib/matplotlib/patheffects.py:docstring of matplotlib.patheffects.SimpleLineShadow:44",
+      "lib/matplotlib/patheffects.py:docstring of matplotlib.patheffects.SimplePatchShadow:42",
+      "lib/matplotlib/patheffects.py:docstring of matplotlib.patheffects.TickedStroke:57",
+      "lib/matplotlib/patheffects.py:docstring of matplotlib.patheffects.withSimplePatchShadow:51",
+      "lib/matplotlib/patheffects.py:docstring of matplotlib.patheffects.withTickedStroke:56"
     ],
     "IPython.terminal.interactiveshell.TerminalInteractiveShell.inputhook": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\users/explain/figure/interactive_guide.rst:420"
+      "doc/users/explain/figure/interactive_guide.rst:420"
     ],
     "_find_tails": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\quiver.py:docstring of matplotlib.quiver.Barbs:9"
+      "lib/matplotlib/quiver.py:docstring of matplotlib.quiver.Barbs:9"
     ],
     "_make_barbs": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\quiver.py:docstring of matplotlib.quiver.Barbs:9"
+      "lib/matplotlib/quiver.py:docstring of matplotlib.quiver.Barbs:9"
     ],
     "matplotlib.collections._CollectionWithSizes.set_sizes": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes._axes.Axes.barbs:176",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes._axes.Axes.broken_barh:82",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes._axes.Axes.fill_between:118",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes._axes.Axes.fill_betweenx:118",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes._axes.Axes.hexbin:206",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes._axes.Axes.pcolor:178",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes._axes.Axes.quiver:212",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\collections.py:docstring of matplotlib.artist.AsteriskPolygonCollection.set:44",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\collections.py:docstring of matplotlib.artist.BrokenBarHCollection.set:44",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\collections.py:docstring of matplotlib.artist.CircleCollection.set:44",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\collections.py:docstring of matplotlib.artist.PathCollection.set:44",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\collections.py:docstring of matplotlib.artist.PolyCollection.set:44",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\collections.py:docstring of matplotlib.artist.PolyQuadMesh.set:44",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\collections.py:docstring of matplotlib.artist.RegularPolyCollection.set:44",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\collections.py:docstring of matplotlib.artist.StarPolygonCollection.set:44",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.barbs:176",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.broken_barh:82",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.fill_between:118",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.fill_betweenx:118",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.hexbin:206",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.pcolor:178",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.quiver:212",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\quiver.py:docstring of matplotlib.artist.Barbs.set:45",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\quiver.py:docstring of matplotlib.artist.Quiver.set:45",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\quiver.py:docstring of matplotlib.quiver.Barbs:209",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\quiver.py:docstring of matplotlib.quiver.Quiver:248",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\mplot3d\\art3d.py:docstring of matplotlib.artist.Path3DCollection.set:46",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\mplot3d\\art3d.py:docstring of matplotlib.artist.Poly3DCollection.set:44"
+      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.barbs:176",
+      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.broken_barh:82",
+      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.fill_between:118",
+      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.fill_betweenx:118",
+      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.hexbin:206",
+      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.pcolor:178",
+      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.quiver:212",
+      "lib/matplotlib/collections.py:docstring of matplotlib.artist.AsteriskPolygonCollection.set:44",
+      "lib/matplotlib/collections.py:docstring of matplotlib.artist.BrokenBarHCollection.set:44",
+      "lib/matplotlib/collections.py:docstring of matplotlib.artist.CircleCollection.set:44",
+      "lib/matplotlib/collections.py:docstring of matplotlib.artist.PathCollection.set:44",
+      "lib/matplotlib/collections.py:docstring of matplotlib.artist.PolyCollection.set:44",
+      "lib/matplotlib/collections.py:docstring of matplotlib.artist.PolyQuadMesh.set:44",
+      "lib/matplotlib/collections.py:docstring of matplotlib.artist.RegularPolyCollection.set:44",
+      "lib/matplotlib/collections.py:docstring of matplotlib.artist.StarPolygonCollection.set:44",
+      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.barbs:176",
+      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.broken_barh:82",
+      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.fill_between:118",
+      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.fill_betweenx:118",
+      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.hexbin:206",
+      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.pcolor:178",
+      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.quiver:212",
+      "lib/matplotlib/quiver.py:docstring of matplotlib.artist.Barbs.set:45",
+      "lib/matplotlib/quiver.py:docstring of matplotlib.artist.Quiver.set:45",
+      "lib/matplotlib/quiver.py:docstring of matplotlib.quiver.Barbs:209",
+      "lib/matplotlib/quiver.py:docstring of matplotlib.quiver.Quiver:248",
+      "lib/mpl_toolkits/mplot3d/art3d.py:docstring of matplotlib.artist.Path3DCollection.set:46",
+      "lib/mpl_toolkits/mplot3d/art3d.py:docstring of matplotlib.artist.Poly3DCollection.set:44"
     ],
     "matplotlib.collections._MeshData.set_array": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes._axes.Axes.pcolormesh:160",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\collections.py:docstring of matplotlib.artist.PolyQuadMesh.set:17",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\collections.py:docstring of matplotlib.artist.QuadMesh.set:17",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.pcolormesh:160"
+      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.pcolormesh:160",
+      "lib/matplotlib/collections.py:docstring of matplotlib.artist.PolyQuadMesh.set:17",
+      "lib/matplotlib/collections.py:docstring of matplotlib.artist.QuadMesh.set:17",
+      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.pcolormesh:160"
     ]
   },
   "py:obj": {
     "Artist.stale_callback": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\users/explain/figure/interactive_guide.rst:323"
+      "doc/users/explain/figure/interactive_guide.rst:323"
     ],
     "Artist.sticky_edges": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/axes_api.rst:356:<autosummary>:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes.Axes.use_sticky_edges:2"
+      "doc/api/axes_api.rst:356:<autosummary>:1"
     ],
     "Axes.dataLim": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/axes_api.rst:293:<autosummary>:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_base.py:docstring of matplotlib.axes._base._AxesBase.update_datalim:2"
+      "doc/api/axes_api.rst:293:<autosummary>:1",
+      "lib/matplotlib/axes/_base.py:docstring of matplotlib.axes._base._AxesBase.update_datalim:2"
     ],
     "AxesBase": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/axes_api.rst:448:<autosummary>:1",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_base.py:docstring of matplotlib.axes._base._AxesBase.add_child_axes:2"
+      "doc/api/axes_api.rst:448:<autosummary>:1",
+      "lib/matplotlib/axes/_base.py:docstring of matplotlib.axes._base._AxesBase.add_child_axes:2"
     ],
     "Figure.stale_callback": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\users/explain/figure/interactive_guide.rst:333"
+      "doc/users/explain/figure/interactive_guide.rst:333"
     ],
     "Glyph": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\gallery/misc/ftface_props.rst:28"
+      "doc/gallery/misc/ftface_props.rst:28"
     ],
     "Image": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.gci:4"
+      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.gci:4"
     ],
     "ImageComparisonFailure": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\testing\\decorators.py:docstring of matplotlib.testing.decorators.image_comparison:2"
+      "lib/matplotlib/testing/decorators.py:docstring of matplotlib.testing.decorators.image_comparison:2"
     ],
     "Line2D.pick": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\users/explain/figure/event_handling.rst:568"
+      "doc/users/explain/figure/event_handling.rst:568"
     ],
     "QuadContourSet.changed()": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes._axes.Axes.contour:152",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes._axes.Axes.contourf:152",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.contour:152",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.contourf:152"
+      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.contour:152",
+      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.contourf:152",
+      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.contour:152",
+      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.contourf:152"
     ],
     "Rectangle.contains": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\users/explain/figure/event_handling.rst:280"
+      "doc/users/explain/figure/event_handling.rst:280"
     ],
     "Size.from_any": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axes_grid1\\axes_grid.py:docstring of mpl_toolkits.axes_grid1.axes_grid.ImageGrid:84",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axisartist\\axes_grid.py:docstring of mpl_toolkits.axisartist.axes_grid.ImageGrid:84"
+      "lib/mpl_toolkits/axes_grid1/axes_grid.py:docstring of mpl_toolkits.axes_grid1.axes_grid.ImageGrid:84",
+      "lib/mpl_toolkits/axisartist/axes_grid.py:docstring of mpl_toolkits.axisartist.axes_grid.ImageGrid:84"
     ],
     "Timer": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backend_bases.py:docstring of matplotlib.backend_bases.FigureCanvasBase.new_timer:2",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backend_bases.py:docstring of matplotlib.backend_bases.TimerBase:14"
+      "lib/matplotlib/backend_bases.py:docstring of matplotlib.backend_bases.FigureCanvasBase.new_timer:2",
+      "lib/matplotlib/backend_bases.py:docstring of matplotlib.backend_bases.TimerBase:14"
     ],
     "ToolContainer": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backend_bases.py:docstring of matplotlib.backend_bases.ToolContainerBase.remove_toolitem:2",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backend_bases.py:docstring of matplotlib.backend_bases.ToolContainerBase:20"
+      "lib/matplotlib/backend_bases.py:docstring of matplotlib.backend_bases.ToolContainerBase.remove_toolitem:2",
+      "lib/matplotlib/backend_bases.py:docstring of matplotlib.backend_bases.ToolContainerBase:20"
     ],
     "_iter_collection": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backend_bases.py:docstring of matplotlib.backend_bases.RendererBase.draw_path_collection:15",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backends\\backend_pdf.py:docstring of matplotlib.backends.backend_pdf.RendererPdf.draw_path_collection:15",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backends\\backend_ps.py:docstring of matplotlib.backends.backend_ps.RendererPS.draw_path_collection:15",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backends\\backend_svg.py:docstring of matplotlib.backends.backend_svg.RendererSVG.draw_path_collection:15",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patheffects.py:docstring of matplotlib.patheffects.PathEffectRenderer.draw_path_collection:15"
+      "lib/matplotlib/backend_bases.py:docstring of matplotlib.backend_bases.RendererBase.draw_path_collection:15",
+      "lib/matplotlib/backends/backend_pdf.py:docstring of matplotlib.backends.backend_pdf.RendererPdf.draw_path_collection:15",
+      "lib/matplotlib/backends/backend_ps.py:docstring of matplotlib.backends.backend_ps.RendererPS.draw_path_collection:15",
+      "lib/matplotlib/backends/backend_svg.py:docstring of matplotlib.backends.backend_svg.RendererSVG.draw_path_collection:15",
+      "lib/matplotlib/patheffects.py:docstring of matplotlib.patheffects.PathEffectRenderer.draw_path_collection:15"
     ],
     "_iter_collection_raw_paths": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backend_bases.py:docstring of matplotlib.backend_bases.RendererBase.draw_path_collection:15",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backends\\backend_pdf.py:docstring of matplotlib.backends.backend_pdf.RendererPdf.draw_path_collection:15",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backends\\backend_ps.py:docstring of matplotlib.backends.backend_ps.RendererPS.draw_path_collection:15",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backends\\backend_svg.py:docstring of matplotlib.backends.backend_svg.RendererSVG.draw_path_collection:15",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\patheffects.py:docstring of matplotlib.patheffects.PathEffectRenderer.draw_path_collection:15"
+      "lib/matplotlib/backend_bases.py:docstring of matplotlib.backend_bases.RendererBase.draw_path_collection:15",
+      "lib/matplotlib/backends/backend_pdf.py:docstring of matplotlib.backends.backend_pdf.RendererPdf.draw_path_collection:15",
+      "lib/matplotlib/backends/backend_ps.py:docstring of matplotlib.backends.backend_ps.RendererPS.draw_path_collection:15",
+      "lib/matplotlib/backends/backend_svg.py:docstring of matplotlib.backends.backend_svg.RendererSVG.draw_path_collection:15",
+      "lib/matplotlib/patheffects.py:docstring of matplotlib.patheffects.PathEffectRenderer.draw_path_collection:15"
     ],
     "_read": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\dviread.py:docstring of matplotlib.dviread.Vf:20"
+      "lib/matplotlib/dviread.py:docstring of matplotlib.dviread.Vf:20"
     ],
     "active": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\widgets.py:docstring of matplotlib.widgets.AxesWidget:34"
+      "lib/matplotlib/widgets.py:docstring of matplotlib.widgets.AxesWidget:34"
     ],
     "ax.transAxes": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes._axes.Axes.indicate_inset:19",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes._axes.Axes.inset_axes:11"
+      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.indicate_inset:19",
+      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.inset_axes:11"
     ],
     "axes.bbox": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes._axes.Axes.legend:144",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\figure.py:docstring of matplotlib.figure.FigureBase.legend:145",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\legend.py:docstring of matplotlib.legend.Legend:97",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.figlegend:145",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.legend:144"
+      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.legend:144",
+      "lib/matplotlib/figure.py:docstring of matplotlib.figure.FigureBase.legend:145",
+      "lib/matplotlib/legend.py:docstring of matplotlib.legend.Legend:97",
+      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.figlegend:145",
+      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.legend:144"
     ],
     "can_composite": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\image.py:docstring of matplotlib.image.composite_images:9"
+      "lib/matplotlib/image.py:docstring of matplotlib.image.composite_images:9"
     ],
     "converter": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\testing\\compare.py:docstring of matplotlib.testing.compare.compare_images:4"
+      "lib/matplotlib/testing/compare.py:docstring of matplotlib.testing.compare.compare_images:4"
     ],
     "draw_image": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backends\\backend_agg.py:docstring of matplotlib.backends.backend_agg.RendererAgg.option_scale_image:2"
+      "lib/matplotlib/backends/backend_agg.py:docstring of matplotlib.backends.backend_agg.RendererAgg.option_scale_image:2"
     ],
     "figure.bbox": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes._axes.Axes.legend:144",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\figure.py:docstring of matplotlib.figure.FigureBase.legend:145",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\legend.py:docstring of matplotlib.legend.Legend:97",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.figlegend:145",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.legend:144"
+      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.legend:144",
+      "lib/matplotlib/figure.py:docstring of matplotlib.figure.FigureBase.legend:145",
+      "lib/matplotlib/legend.py:docstring of matplotlib.legend.Legend:97",
+      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.figlegend:145",
+      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.legend:144"
     ],
     "fmt_xdata": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_base.py:docstring of matplotlib.axes._base._AxesBase.format_xdata:4"
+      "lib/matplotlib/axes/_base.py:docstring of matplotlib.axes._base._AxesBase.format_xdata:4"
     ],
     "fmt_ydata": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_base.py:docstring of matplotlib.axes._base._AxesBase.format_ydata:4"
+      "lib/matplotlib/axes/_base.py:docstring of matplotlib.axes._base._AxesBase.format_ydata:4"
     ],
     "get_size": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axes_grid1\\axes_size.py:docstring of mpl_toolkits.axes_grid1.axes_size:1"
+      "lib/mpl_toolkits/axes_grid1/axes_size.py:docstring of mpl_toolkits.axes_grid1.axes_size:1"
     ],
     "ipykernel.pylab.backend_inline": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\users/explain/figure/interactive.rst:340"
+      "doc/users/explain/figure/interactive.rst:340"
     ],
     "kde.covariance_factor": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\mlab.py:docstring of matplotlib.mlab.GaussianKDE:41"
+      "lib/matplotlib/mlab.py:docstring of matplotlib.mlab.GaussianKDE:41"
     ],
     "kde.factor": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\axes\\_axes.py:docstring of matplotlib.axes._axes.Axes.violinplot:46",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\mlab.py:docstring of matplotlib.mlab.GaussianKDE:12",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\mlab.py:docstring of matplotlib.mlab.GaussianKDE:45",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\pyplot.py:docstring of matplotlib.pyplot.violinplot:46"
+      "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.violinplot:46",
+      "lib/matplotlib/mlab.py:docstring of matplotlib.mlab.GaussianKDE:12",
+      "lib/matplotlib/mlab.py:docstring of matplotlib.mlab.GaussianKDE:45",
+      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.violinplot:46"
     ],
     "make_image": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\image.py:docstring of matplotlib.image.composite_images:9"
+      "lib/matplotlib/image.py:docstring of matplotlib.image.composite_images:9"
     ],
     "matplotlib.animation.ArtistAnimation.new_frame_seq": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ArtistAnimation.rst:28:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.ArtistAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.ArtistAnimation.new_saved_frame_seq": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ArtistAnimation.rst:28:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.ArtistAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.ArtistAnimation.pause": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ArtistAnimation.rst:28:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.ArtistAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.ArtistAnimation.repeat": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ArtistAnimation.rst:33:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.ArtistAnimation.rst:33:<autosummary>:1"
     ],
     "matplotlib.animation.ArtistAnimation.resume": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ArtistAnimation.rst:28:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.ArtistAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.ArtistAnimation.save": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ArtistAnimation.rst:28:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.ArtistAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.ArtistAnimation.to_html5_video": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ArtistAnimation.rst:28:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.ArtistAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.ArtistAnimation.to_jshtml": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ArtistAnimation.rst:28:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.ArtistAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegFileWriter.bin_path": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FFMpegFileWriter.rst:27:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.FFMpegFileWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegFileWriter.finish": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FFMpegFileWriter.rst:27:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.FFMpegFileWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegFileWriter.frame_format": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\animation.py:docstring of matplotlib.animation.FFMpegFileWriter.supported_formats:1:<autosummary>:1"
+      "lib/matplotlib/animation.py:docstring of matplotlib.animation.FFMpegFileWriter.supported_formats:1:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegFileWriter.frame_size": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\animation.py:docstring of matplotlib.animation.FFMpegFileWriter.supported_formats:1:<autosummary>:1"
+      "lib/matplotlib/animation.py:docstring of matplotlib.animation.FFMpegFileWriter.supported_formats:1:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegFileWriter.grab_frame": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FFMpegFileWriter.rst:27:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.FFMpegFileWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegFileWriter.isAvailable": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FFMpegFileWriter.rst:27:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.FFMpegFileWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegFileWriter.output_args": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\animation.py:docstring of matplotlib.animation.FFMpegFileWriter.supported_formats:1:<autosummary>:1"
+      "lib/matplotlib/animation.py:docstring of matplotlib.animation.FFMpegFileWriter.supported_formats:1:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegFileWriter.saving": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FFMpegFileWriter.rst:27:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.FFMpegFileWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegFileWriter.setup": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FFMpegFileWriter.rst:27:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.FFMpegFileWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegWriter.bin_path": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FFMpegWriter.rst:27:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.FFMpegWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegWriter.finish": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FFMpegWriter.rst:27:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.FFMpegWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegWriter.frame_size": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FFMpegWriter.rst:34:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.FFMpegWriter.rst:34:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegWriter.grab_frame": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FFMpegWriter.rst:27:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.FFMpegWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegWriter.isAvailable": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FFMpegWriter.rst:27:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.FFMpegWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegWriter.output_args": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FFMpegWriter.rst:34:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.FFMpegWriter.rst:34:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegWriter.saving": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FFMpegWriter.rst:27:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.FFMpegWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegWriter.setup": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FFMpegWriter.rst:27:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.FFMpegWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.FFMpegWriter.supported_formats": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FFMpegWriter.rst:34:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.FFMpegWriter.rst:34:<autosummary>:1"
     ],
     "matplotlib.animation.FileMovieWriter.bin_path": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FileMovieWriter.rst:27:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.FileMovieWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.FileMovieWriter.frame_size": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\animation.py:docstring of matplotlib.animation.FileMovieWriter.finish:1:<autosummary>:1"
+      "lib/matplotlib/animation.py:docstring of matplotlib.animation.FileMovieWriter.finish:1:<autosummary>:1"
     ],
     "matplotlib.animation.FileMovieWriter.isAvailable": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FileMovieWriter.rst:27:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.FileMovieWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.FileMovieWriter.saving": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FileMovieWriter.rst:27:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.FileMovieWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.FileMovieWriter.supported_formats": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\animation.py:docstring of matplotlib.animation.FileMovieWriter.finish:1:<autosummary>:1"
+      "lib/matplotlib/animation.py:docstring of matplotlib.animation.FileMovieWriter.finish:1:<autosummary>:1"
     ],
     "matplotlib.animation.FuncAnimation.pause": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FuncAnimation.rst:28:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.FuncAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.FuncAnimation.repeat": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\animation.py:docstring of matplotlib.animation.FuncAnimation.new_frame_seq:1:<autosummary>:1"
+      "lib/matplotlib/animation.py:docstring of matplotlib.animation.FuncAnimation.new_frame_seq:1:<autosummary>:1"
     ],
     "matplotlib.animation.FuncAnimation.resume": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FuncAnimation.rst:28:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.FuncAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.FuncAnimation.save": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FuncAnimation.rst:28:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.FuncAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.FuncAnimation.to_html5_video": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FuncAnimation.rst:28:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.FuncAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.FuncAnimation.to_jshtml": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.FuncAnimation.rst:28:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.FuncAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.HTMLWriter.bin_path": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.HTMLWriter.rst:27:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.HTMLWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.HTMLWriter.frame_format": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\animation.py:docstring of matplotlib.animation.HTMLWriter.finish:1:<autosummary>:1"
+      "lib/matplotlib/animation.py:docstring of matplotlib.animation.HTMLWriter.finish:1:<autosummary>:1"
     ],
     "matplotlib.animation.HTMLWriter.frame_size": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\animation.py:docstring of matplotlib.animation.HTMLWriter.finish:1:<autosummary>:1"
+      "lib/matplotlib/animation.py:docstring of matplotlib.animation.HTMLWriter.finish:1:<autosummary>:1"
     ],
     "matplotlib.animation.HTMLWriter.saving": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.HTMLWriter.rst:27:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.HTMLWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.ImageMagickFileWriter.bin_path": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ImageMagickFileWriter.rst:27:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.ImageMagickFileWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.ImageMagickFileWriter.finish": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ImageMagickFileWriter.rst:27:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.ImageMagickFileWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.ImageMagickFileWriter.frame_format": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\animation.py:docstring of matplotlib.animation.ImageMagickFileWriter.input_names:1:<autosummary>:1"
+      "lib/matplotlib/animation.py:docstring of matplotlib.animation.ImageMagickFileWriter.input_names:1:<autosummary>:1"
     ],
     "matplotlib.animation.ImageMagickFileWriter.frame_size": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\animation.py:docstring of matplotlib.animation.ImageMagickFileWriter.input_names:1:<autosummary>:1"
+      "lib/matplotlib/animation.py:docstring of matplotlib.animation.ImageMagickFileWriter.input_names:1:<autosummary>:1"
     ],
     "matplotlib.animation.ImageMagickFileWriter.grab_frame": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ImageMagickFileWriter.rst:27:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.ImageMagickFileWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.ImageMagickFileWriter.isAvailable": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ImageMagickFileWriter.rst:27:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.ImageMagickFileWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.ImageMagickFileWriter.saving": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ImageMagickFileWriter.rst:27:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.ImageMagickFileWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.ImageMagickFileWriter.setup": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ImageMagickFileWriter.rst:27:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.ImageMagickFileWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.ImageMagickWriter.bin_path": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ImageMagickWriter.rst:27:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.ImageMagickWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.ImageMagickWriter.finish": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ImageMagickWriter.rst:27:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.ImageMagickWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.ImageMagickWriter.frame_size": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\animation.py:docstring of matplotlib.animation.ImageMagickWriter.input_names:1:<autosummary>:1"
+      "lib/matplotlib/animation.py:docstring of matplotlib.animation.ImageMagickWriter.input_names:1:<autosummary>:1"
     ],
     "matplotlib.animation.ImageMagickWriter.grab_frame": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ImageMagickWriter.rst:27:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.ImageMagickWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.ImageMagickWriter.isAvailable": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ImageMagickWriter.rst:27:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.ImageMagickWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.ImageMagickWriter.saving": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ImageMagickWriter.rst:27:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.ImageMagickWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.ImageMagickWriter.setup": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.ImageMagickWriter.rst:27:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.ImageMagickWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.ImageMagickWriter.supported_formats": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\animation.py:docstring of matplotlib.animation.ImageMagickWriter.input_names:1:<autosummary>:1"
+      "lib/matplotlib/animation.py:docstring of matplotlib.animation.ImageMagickWriter.input_names:1:<autosummary>:1"
     ],
     "matplotlib.animation.MovieWriter.frame_size": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\animation.py:docstring of matplotlib.animation.MovieWriter.bin_path:1:<autosummary>:1"
+      "lib/matplotlib/animation.py:docstring of matplotlib.animation.MovieWriter.bin_path:1:<autosummary>:1"
     ],
     "matplotlib.animation.MovieWriter.saving": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.MovieWriter.rst:27:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.MovieWriter.rst:27:<autosummary>:1"
     ],
     "matplotlib.animation.PillowWriter.frame_size": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\animation.py:docstring of matplotlib.animation.PillowWriter.finish:1:<autosummary>:1"
+      "lib/matplotlib/animation.py:docstring of matplotlib.animation.PillowWriter.finish:1:<autosummary>:1"
     ],
     "matplotlib.animation.PillowWriter.saving": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.PillowWriter.rst:26:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.PillowWriter.rst:26:<autosummary>:1"
     ],
     "matplotlib.animation.TimedAnimation.new_frame_seq": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.TimedAnimation.rst:28:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.TimedAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.TimedAnimation.new_saved_frame_seq": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.TimedAnimation.rst:28:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.TimedAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.TimedAnimation.pause": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.TimedAnimation.rst:28:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.TimedAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.TimedAnimation.resume": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.TimedAnimation.rst:28:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.TimedAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.TimedAnimation.save": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.TimedAnimation.rst:28:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.TimedAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.TimedAnimation.to_html5_video": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\api/_as_gen/matplotlib.animation.TimedAnimation.rst:28:<autosummary>:1"
+      "doc/api/_as_gen/matplotlib.animation.TimedAnimation.rst:28:<autosummary>:1"
     ],
     "matplotlib.animation.TimedAnimation.to_jshtml": [
       "doc/api/_as_gen/matplotlib.animation.TimedAnimation.rst:28:<autosummary>:1"
@@ -734,31 +663,31 @@
       "doc/docstring of builtins.list:17"
     ],
     "mpl_toolkits.axislines.Axes": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\mpl_toolkits\\axisartist\\axis_artist.py:docstring of mpl_toolkits.axisartist.axis_artist:7"
+      "lib/mpl_toolkits/axisartist/axis_artist.py:docstring of mpl_toolkits.axisartist.axis_artist:7"
     ],
     "next_whats_new": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\users/next_whats_new/README.rst:6"
+      "doc/users/next_whats_new/README.rst:6"
     ],
     "option_scale_image": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backends\\backend_cairo.py:docstring of matplotlib.backends.backend_cairo.RendererCairo.draw_image:22",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backends\\backend_pdf.py:docstring of matplotlib.backends.backend_pdf.RendererPdf.draw_image:22",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backends\\backend_ps.py:docstring of matplotlib.backends.backend_ps.RendererPS.draw_image:22",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backends\\backend_template.py:docstring of matplotlib.backends.backend_template.RendererTemplate.draw_image:22"
+      "lib/matplotlib/backends/backend_cairo.py:docstring of matplotlib.backends.backend_cairo.RendererCairo.draw_image:22",
+      "lib/matplotlib/backends/backend_pdf.py:docstring of matplotlib.backends.backend_pdf.RendererPdf.draw_image:22",
+      "lib/matplotlib/backends/backend_ps.py:docstring of matplotlib.backends.backend_ps.RendererPS.draw_image:22",
+      "lib/matplotlib/backends/backend_template.py:docstring of matplotlib.backends.backend_template.RendererTemplate.draw_image:22"
     ],
     "print_xyz": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backends\\backend_template.py:docstring of matplotlib.backends.backend_template:22"
+      "lib/matplotlib/backends/backend_template.py:docstring of matplotlib.backends.backend_template:22"
     ],
     "toggled": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backend_tools.py:docstring of matplotlib.backend_tools.AxisScaleBase.disable:4",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backend_tools.py:docstring of matplotlib.backend_tools.AxisScaleBase.enable:4",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backend_tools.py:docstring of matplotlib.backend_tools.AxisScaleBase.trigger:2",
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backend_tools.py:docstring of matplotlib.backend_tools.ZoomPanBase.trigger:2"
+      "lib/matplotlib/backend_tools.py:docstring of matplotlib.backend_tools.AxisScaleBase.disable:4",
+      "lib/matplotlib/backend_tools.py:docstring of matplotlib.backend_tools.AxisScaleBase.enable:4",
+      "lib/matplotlib/backend_tools.py:docstring of matplotlib.backend_tools.AxisScaleBase.trigger:2",
+      "lib/matplotlib/backend_tools.py:docstring of matplotlib.backend_tools.ZoomPanBase.trigger:2"
     ],
     "tool_removed_event": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\lib\\matplotlib\\backend_bases.py:docstring of matplotlib.backend_bases.ToolContainerBase.remove_toolitem:6"
+      "lib/matplotlib/backend_bases.py:docstring of matplotlib.backend_bases.ToolContainerBase.remove_toolitem:6"
     ],
     "whats_new.rst": [
-      "doc/C:\\Users\\story\\Projects\\matplotlib\\doc\\users/next_whats_new/README.rst:6"
+      "doc/users/next_whats_new/README.rst:6"
     ]
   }
 }
diff --git a/doc/sphinxext/missing_references.py b/doc/sphinxext/missing_references.py
index cc0a3a8ea268..c621adb2c945 100644
--- a/doc/sphinxext/missing_references.py
+++ b/doc/sphinxext/missing_references.py
@@ -99,8 +99,12 @@ def get_location(node, app):
     if source:
         # 'source' can have the form '/some/path:docstring of some.api' but the
         # colons are forbidden on windows, but on posix just passes through.
-        path, *post = source.partition(':')
-        post = ''.join(post)
+        if ':docstring of' in source:
+            path, *post = source.rpartition(':docstring of')
+            post = ''.join(post)
+        else:
+            path = source
+            post = ''
         # We locate references relative to the parent of the doc
         # directory, which for matplotlib, will be the root of the
         # matplotlib repo. When matplotlib is not an editable install
@@ -194,8 +198,7 @@ def save_missing_references_handler(app, exc):
 
     _warn_unused_missing_references(app)
 
-    json_path = (Path(app.confdir) /
-                 app.config.missing_references_filename)
+    json_path = Path(app.confdir) / app.config.missing_references_filename
 
     references_warnings = getattr(app.env, 'missing_references_warnings', {})
 
@@ -264,8 +267,7 @@ def prepare_missing_references_handler(app):
 
     app.env.missing_references_ignored_references = {}
 
-    json_path = (Path(app.confdir) /
-                    app.config.missing_references_filename)
+    json_path = Path(app.confdir) / app.config.missing_references_filename
     if not json_path.exists():
         return
 

From 705568a578d7275b32c6f9878924a8539f99978d Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Thu, 21 Sep 2023 10:04:23 +0200
Subject: [PATCH 0177/1120] Remove deprecations and make arguments keyword only

---
 ci/mypy-stubtest-allowlist.txt                |   1 -
 .../next_api_changes/removals/26853-OG.rst    |  26 +++
 .../test_widgets/check_radio_buttons.png      | Bin 24315 -> 23386 bytes
 lib/matplotlib/tests/test_widgets.py          |  59 ------
 lib/matplotlib/widgets.py                     | 174 +++---------------
 lib/matplotlib/widgets.pyi                    |   9 +-
 6 files changed, 54 insertions(+), 215 deletions(-)
 create mode 100644 doc/api/next_api_changes/removals/26853-OG.rst

diff --git a/ci/mypy-stubtest-allowlist.txt b/ci/mypy-stubtest-allowlist.txt
index 99216f5f75eb..64fae8d44562 100644
--- a/ci/mypy-stubtest-allowlist.txt
+++ b/ci/mypy-stubtest-allowlist.txt
@@ -54,7 +54,6 @@ matplotlib.cm.register_cmap
 matplotlib.cm.unregister_cmap
 matplotlib.collections.PolyCollection.span_where
 matplotlib.gridspec.GridSpecBase.get_grid_positions
-matplotlib.widgets.MultiCursor.needclear
 
 # 3.8 deprecations
 matplotlib.cbook.get_sample_data
diff --git a/doc/api/next_api_changes/removals/26853-OG.rst b/doc/api/next_api_changes/removals/26853-OG.rst
new file mode 100644
index 000000000000..dc5c37e38db5
--- /dev/null
+++ b/doc/api/next_api_changes/removals/26853-OG.rst
@@ -0,0 +1,26 @@
+Most arguments to widgets have been made keyword-only
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Passing all but the very few first arguments positionally in the constructors
+of Widgets is now keyword-only. In general, all optional arguments are keyword-only.
+
+``RadioButtons.circles``
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+... is removed.  (``RadioButtons`` now draws itself using `~.Axes.scatter`.)
+
+``CheckButtons.rectangles`` and ``CheckButtons.lines``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``CheckButtons.rectangles`` and ``CheckButtons.lines`` are removed.
+(``CheckButtons`` now draws itself using `~.Axes.scatter`.)
+
+Remove unused parameter *x* to ``TextBox.begin_typing``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+This parameter was unused in the method, but was a required argument.
+
+``MultiCursor.needclear``
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+... is removed.
diff --git a/lib/matplotlib/tests/baseline_images/test_widgets/check_radio_buttons.png b/lib/matplotlib/tests/baseline_images/test_widgets/check_radio_buttons.png
index d6e6004a1732e7f6c449ce3ce7cc87b70743acc7..f0d5023008cabd1296c3cbd30447476c7608cb0d 100644
GIT binary patch
literal 23386
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%0ADJ)ar9_c
z<khR&rc<;3cb}>q2h5k=ltt2E!Y{{9Dh0xuKn^L&oS>)m<Dm%h7`?MKoL>KM?Wa$l
zj!03<5G3tR!h`8N9y^Cr9BW|mDY}asL1?AmE)nSSo4}N&=p!n@jmJ>4u{+(sgqWiX
zIRkv;))`n^Gswr#L5PqfouDBi&;)fE38R6lwC*5bX{`@AuH9>H<}?%;ELX@-q8nWv
z;r{yVJU-Xo|920$j{?|?9Sd}gW*g{b>uFhbNM&m&WA_$Q!Ub#-N*ps*51PXvT%N7<
z-&+dJ)(G9-PfJTn=^^{q2L+XesVcrOv&gkXUNow9jkKxGTQSWw;w`l_Eg2YgiR~`V
z=&q@>zs{{F>Y<r!XppVWG3~6Q(-kcs^QLCR=#X=`qS4y3=In)MVr%>^x!o0oXBiE*
z37{0f+A6LRY)OX76tj(tuv2ui;T$q=JeEY7%(!&jA3c)k@beQ$DA2xAYRemN;Yz6$
zhhjW-aR~2`u4faR;Hf&-Jv$&6vVl8f!xIu#@%>g|e0E9QWqBJ5#qNCt3bY(IOP)DX
zi~-mq`r#fF_5LSjd2zupLc!icEDR#die4I6f`P?wRYQ2Gv9EpG_NvUS`HoL+cr9Lw
zQHj|W-t=p-X{Ie{MmWJh@x9!em<Wh?ouuw7kC#l9qb@rya(WTs?SCjs$|ZVf{wY6M
zzloj<KjD;5wd=*<f-~O~1T8O2OeJ9NT6Spz)1=hu?K4tH#PM+JTvbfCPEK*LAmf8P
zFCH4NtX@`pxzE8WQ-#$KwUe6bYrj=srkG{iIMgyyYe0YV`}Rn?GX0JEXO%}(c+i_v
zt??cG$Xv7buG4FOzCd-pS4L|gubh6kiCg!<MWF}hxajZP;BIRQCm+j(#ScCAC`U%z
zGt@HzZ?4;RRXVC-t2V}Ey9%Ef*BCtNF5o?Rkrlt2y}JM9c<Swnr_!_A_NhIO_!G*l
zIP!Fi#Ux#SJezG%Yz*w8HM%gGk#TW?^0qUl?tu#DzbhdqWFkuqcs<0+D;;;BfE^>5
z4crQ;t8<!s$M+=FbvY&Swo5Kw<-{+(*{`(evW$EUBa<yMn8#)0RB4h2P1`XsmT{r6
zbOLD<OkrhK!KY9AYkrYD;2=2Oc8y3$4OqS?7(y?UR$XzT6<Bovek-OpheQ|+Y)Um&
zWhqLL+!B6YQ$WW94T$TON2|djW)`|UOIqIZUUX4l%nxXJE?|y~uyeIU9q45Q{+S5H
ziL9=wO8J~Ut6sF}sK&Cj&PxI^D0FKOhyK+g&oXzkPj;J3KZxt#;>5e5YVsR;lg(Xc
zl*0^nSVLF82b8-meYznG`iOqKN(un%<nr?Jf@S?l^mMKf7(p-l$D8xP!Bvi+yMxx2
zP}O&A2^~5HLz8!QqK>FOEPPwIyVYI3HC;PWn@yvA&sBOT{r$TuEZBnWZZ|=%@~n~C
zX>0M3IY8zT+l*N}etEVvQ-H-K(aW4L8yh-0^XF@5_GuOA#rcvxuSbM%?HwOB5T@99
zLF%dv+A~xx@X{SI99avAEV9xmYWjfGA#L-5%J*!Ube|HMi%dCI<x}!a^b6}EViK}n
zwj5`13G$7U%vGkwWy7V?uVv<}nspTSY+|aqms13(3m&PEM<kO_LIEd9ESYLs^dg0=
z`Zq4RBBipqJ+@k{fO>lDRExRO+V3V+{Ib7|K$s|B>6d0dO24k=J6z#6CFFcxGj&z+
zP2a4XFtOfo_A|4Jee{$-B1R4|()}LQW1fA_eJ8Ci1~J|CAql#BVYMPV0SPC(y1e&2
z=iI%#eq-Y0C0OJv4RT7c_qX0hM)oP1O0(UcZ;9fCmsOnFxe1vvDgm)S-pcuRHu<sj
zaAj)+_Hk?aY04J#7Rc3QTS{qc+WgXUzBhMX`>?ONCSjs7s65DUd97+>a4$h9acH5#
z9H~cxGh?L}ax)`pb0mRK!fF<fpJvo)Eol35rR;N0rT6sHNCsUF^^mZHa2wp>_NxiY
zTLsB4IFDo*J`iWo3w0LVDIsbv2MyeEOWpS>;AY)lB?fJF4`iI3q0Ky+eDbDg%h>=t
zW<imlQ-dp<T8K%_2`v~f8pMp`>=B(4PxG>IX3K{uvBY;NTr}$PAk>*N-PXPU70@-p
zrWSc3<*VBBE9$5Xg@aJW^kYBCum#H@&SgLrb3#S?>kVtM+D8TwODTM~3#q~$HPM)y
zxNC6wyM%EZBriQS<~Z@Rr*DMBitY?ws~&7IWWeiEdlQqU785c$T>~PR<CP@x%=^T1
zmV$>%e=BpTHx-0DJ#E}QIl)6da$8)$0KJ%VM^kmfv9n5WLDN9KI;}QwtLG;sQL|cf
zvAe=@;x0Zhpw6nBu7ytAwbAia)v13yZuDRvNll!$j+ew@Dr-;7O!s%S-HOr1-90?6
zFZl3wN*!Up+H5f{9js3`liz$fE-#~3EL~PhBHL^|*5Yg7xfnOX{b9p-mpu^;vh3_e
zZjow_J)xzX{F7CdpI1+A^+hn~vtnLrED!Aka_(q^Fbn2(sZ8AV=l#fd(YrrMttn$e
zce>9B^D8eTEs64u?k|sIe(Px665B_~BYpj0#n`89XDszg3lnS!p2_*-XhlrQeY%X>
z=TKt9HeOl0z(9FPRXhF0-aMQIeZO~FZ)1L69Mjay_<8Ev`etz~O6PN=IV?Ed$@xEO
zq37PbTTN>tx{P`$>bEmHsa0Vva=_G%N1o}vT=M)N?qGT=2m9DrTH|fAy>(+1166J#
zag?ACBHA+_HnEw>`6$~uJ1^1uuxXqS<|HVGkJwZ-)BMo8?;b$9PkITg0P5^WLcKNF
zm}^GePlnRv?=)5U!kPV-#Y?w14B9HP-_@RD;9Or8Kg@^2WTCr~+tO&TF*Z$YIoM$>
zQsuFS>oo!!z-Y%l$v&^5C@~@tQ;bmxOxIWask&%<tRQj_BU}Xs7UFPZ(CSHeLs-nx
zFaL1`i^y(_4limZdH2dj&dQMdK|>qIP#IN4NojV!{LiX~KMD4u^Xu0V2aRxqM%SJ+
z-80q~YVNcT@5CJyWJ-IkNYOmVH7%>d{W0dphd6wezT>;fdJnCWnVfRF+>_<8fd>(5
zvDxJ6Tp#^gW+Qv{jPTC4h#zaQf4E9>JB#Wuh%y@g<%Wb1m+V0~N#a(jlD=5*{Azok
z=ZD*v(OJ8BBbx+^b^og`u5IkP7I3vhurz7Mq-(0=U3$Lkv}UnLv~~@|EC*KTHT9ZU
zi&U~S&bI{d@UGM{%+n2jITYDVyi|a5T)W7kuT+tR*_P=&k+bVHpp4$A)^l5-H0LMJ
z=sJlqV8oaOJcPv1?<X2mxgStdrPAX0WmFFDCKY1>h2npu1ux2+pJzPh$@$FFcU2Ti
z%oO)8%^6nG!wqMfQbf)+gi{UBl;86r4mV14UK>n|J=B5dH1}3e`PqDdp7T<d2)>Ts
z#Vt~iR=+o*v!~=7w2&V?Xl~hAE6oq#X>{VSXCjADD=$eGySBx)jweR*CU$-}6YFHu
z?Ijvv_mGNky+ktN68kpM2YN9`R_@!}K6;~`R|-R{kwNWgxUR3~Z$&0`G;Z9gz0-NT
zlYZToZ`W~Ml6Fr*xy)M?H@u~#cxY3_Xu13TgG)j-+4QMrE6txm{NLZ2qBeHo+zH!?
zBK#_#%Ka;omx-u~1_!U%$bk<7yJOF(yAO+r<Rb(>-`bA%8uvCf1~N=T6+=3?@g;{{
zq>VI;ZzZqF>3UmLMliMX|JJ_t@ik-hB448<l5`0Yq!o2T$Q-9~W1+VK5+HatKnF;*
zH0K0B626=uo=0>q%{SB609RA6x-zpLCoh@~5QfI2SL!F4)@!coMFf6f3RV;n%<EOJ
z9eLF<G|dzLGwY99wrbWpo8#5#6+JE-EUW9h+)$PagJe~ucGW`+2mOWPwfZ~L%gxUB
zR?&<PeS^Sp5R`SOu~lIOr>_b8bl>d9>s1j9XM409YrTKJT-|*`W2zO&r3H#znqq94
zASTVA+P@ER1<yc)8OgM}mTG<;6A`978LnF%0rVC7YgI7ak6XfUpyJUQew@vu@It|;
zi{5PC6`@|Yc8XIE=;%a($d5cw7Q50GbtU>?x)E&>GjQg5DWv93s*Gw|%r`<Lk6hjU
zRqGKev09?8u6l*RFM0jPN!|JJ&<8#{%Ek9+pt`T3Z?RmV6r%u~yfak>Ggjl?RqNGN
zK00zqokR;VI3LWm`QFhptPk$J*7xw<%)V**4!AC;eO+UpR3mwmauQNf{CR#Ab)>yL
zOUu@i<+xtBTpJ2v*+AjF-F-*k)Eu#*B+_?arnn1a+CJ~jr3;US+3buS8QPp*mmq9d
zSnRo2Eb3mnAR?-?)MpgnP;Mhw<+g5IOqYC<n|s-jUmzf&x)hUcTg#`r_U<Y(GXY)`
ziWh~ZM95@@^-9*B7Xcpo#D@DJQ8Anc+o>A|1es%87KVm0m?#tfw(8Cj3ssXe^@4=%
z!qo1Jpzh?q)l0KC)>?#v5?dmo*f$rs1fN~rT(T~?-kZyTCsxsHI5>{^fY8oo#wYA|
zp3b1udXRo|rdKiBaQH$?<oow~g3=nvFIELh#ufueG9aasT0%P#yE#%ZTN6R)VPTj8
z*F{eJMu^kl0gG$F!sBRhi4`oD=7lHA$~b;qN&$X<dj~&S=>CWe3uETie!m{G;bbhd
zoFFb!zEs>!f5&=S>6*%jv)1_h_Ec=w_Ubpcnv6uDZ<OB}6_~u)y>_#lR+2V8Q>&_|
zjJMQ2+RA-wWHkGU!q13Nr3(oCd*SkvK6_ho;vV#Qj=VLOH<xWo{1*q!U*=IT-uSkJ
zCt_EZOHJO=Brs1%2<uj=W*Z$&^~nZB43q?q;Ed>nQ9i%5R4ucO`PK0Z-)fk`?%_Xv
zkNRAGU}KO%D62tE`{uaomt(WkxEpt8F$HqaN>@?DV%*S}uJG-e=z#XAZ=*)KRU5kV
z>}bsic`sRh!sqSVE-wPz^SPXYG)|3t2F!pu_75}%`ZL)&wHZogrCvVVjV!^{tsbN+
zbd7(O$%!^OlDoBNTgzI$5_zzDE$G4Fwr{8IR;xf?plLg6!mU-^?G_=sq|UF^9_168
zhBd#Qxi550PDQkjJ-)ULlAHag@W}fbs{S2GuPUddq0(uf<+VpoUDp?pvVh1T^=XJ7
z@!kk_T20ybsVwr@2wDMBzgiP)jN_{s86Cw|tOiWPY_8jOUbUF%s3}lTiV(88L29fT
z()pFk03#yiJU39u!O=xyTy40y80+DFuzQXNSsJqNY|DGazvpaZG~wtMDD=YN$#p}k
zhZ2=;k3?Nsx5Zwc;H!#=<Q48EKN1(PLV*O@w;<ai9$iUyRP%Iq5(&TkzFGCy);W95
zMl^*69H$F$BG!~(OKEP&`rpt!bGY3YTd*@N8Q@_WbZ=uz$c);<-GJ%^G{4_I91<}O
z@oi$($dB_7pX+tbt?l<d6hEBz^z?7KlA#3cDCZ@R5f9rR(`Q&O<b_=nx?oJ5p~S84
zE+q$>;WII0bKXujhHoSf)Aynszh~3b-hN?kDpSvfugZO}T=*M}_jdA4#}9>REuX1J
zYaX`b8+_xrGCM1CBfw9f>ZzJq0MDNVzBfMx?JJ#LzM>O|V=-oss*i@VSGi?Fi^M-!
z&^DegEjAC(!T0G^bsux(t+Vo9%~5N7w$tMB`%BwoPv(=j(2%E2w9`|&JjSvn?Mgo|
zbaAZ@XUj+Zm#Hj8oYl7m-k3Qyg;Bs8Vblm^`y%P%SCld<;2kg8hiiwQMRQrXP6yQB
z1JZSvXX9P{^T)0F$JxsB`n$Sp7?s)S4C>lqFOC)%#_x%1<#FmW6h{W=6ka7vaB0zV
zhbAYhPJDaCb(>f6z{Il+Q}`^Y1oE_`XG1)QeAmY(UFL~&+zva@xBHHnRR#=l<$@QT
z*HTgxH0w0WF&NygvY%+{YmK@RFBa|Lt}Nlc7<aKc{BWJg*dnUo0{@q&KZVXY8<UYD
zK|0sFataKq3sTQK1#4n0|1(v+>>vFpq>y+;r5D{SCmT8>(X;DW)7+pi!TN`l(6uyf
zBO9l-^Da&Bj`vo~s`IB87=@G*bWb0C)UNrZeR}eMkp7A)z|_(ZXD~M+PADQSANott
zow-(O<7Itk-aJw88@<btenpkEj6CijXZ65`MCO5E$@dF&ZhMR0ZhdD}%qPDi+Zt<r
zU1>PokMFoy!;#syY-zWbZrt5`MfGj>g>mEg{Cp{UbUWOJ9M0QmM-{r-v?s`9y6?_n
zsO}tYgwk}lEZjK%f~S?<hrDuG!q_!{$@|7PQsTk#x4Z2Mk@O@MI}Q_9=#1AS4!UQq
z!W%iUEo<uny1x>z%`;1FryhlK$`#aHMb)CIbKffLzXdXfveMmw5FXIy<(XEu|8=I8
zr<Lb2VaWJlMSs=iR8@E8lb5Z>&-jaynZ5!a`Z{e|EMn`O4X=TNM2l*Zo)ebePu+5s
z$L?9DPA=@)blVK41z%He;i`C{kLO$*#yCay=2|?YUtP6d82FhHP`b&f!LK|2@WbyO
z7Ooa;+{%KEu~%&bw_mxDt!K@n#%(v_6J~g9S6=y4+=A-auLnDktXlc8Y~VR|Xa7-;
zNp9#_W_Ny#hHp){f7bh?_$^<q!%3&fDtAth^BTqoZp5J?s%@F)&%agNOv(gV1pXaV
zPJW9Pv4bm+u<PY<M@Yj;ptFh-+FOZl-dxtNphW*5_TRtx0bQpEJNIM?)dhAQ=-U0K
zage^^6nKR^HMb9<|Ih!?lKl0LIwv&?&9-)Q=tnMsaL5A+G-B$D9IKy2%?<sshB%N;
z5!3dpmU@%ryN&r&2^@RVOJ9bMjia)o-KmVD^&l?GJ?$f>j)WJWK|=va*c7x<<i|ue
zasgT&p;Gfd>KeUW&B<<zPQe4Mp|-ZRXt!vzhEHhc+O#{|d(0D>Z&l3D|3h1f;T>FR
zL?7Oim&!up5eBqPb`A8?;_%ezAmt+YAgU*+qx8lZRL-zluscvIz3g*Z8t7A>EOJBz
zI*^euMwm<<oooo5tPt$B9uL)Ecwr2Ns9`7=9TJBr&K^gHV56jx|G5esqC|(7VDCPo
z+am!VyahE`WD=e0IXYAeLw`WpKqi9<KpYJZXDRN#4vnwSM`o@`uJpLLA6|n`ftN1a
zJ=SqFT0rf5)=)JV{SJl~xQAi}|M3M3V@J_LsRJ2Vku{Y08ghh!;x^iL3qln%qU|M;
zRh&W%!1g~&#dR29=u$h4^<0PxeEy#zLI}EUw1|NIgd&2EFS>=(_H)dC)oW<~w_k}6
z#sE{gvFaiua{u1_Gk$zt?KJF&BP?Hzw{E`(9B45J&eU8hOC8;p;!g4t51`FB653jd
za~`q6O%RxX8oF?h2S@7TR8`Y{Y0s`rVhUK8A6yiU7!v2ve_y+sZP#aF5;k-&UI-uX
zu>x_qNE@748pLJn0^jV`U^-~Yr_ZDtc?TPMmHt_B{{8Z%sr;wu^b7@Y>;sML2j1Q<
zrT#fJJ8=RN*@cUklA+=6CeW~TiEAQQHcdV}?Po^14>D1DNYs*7Y;!l%j{{O?zqHBE
zpXNB7wqiH?&C43zgLP?b=Oyf!n>?r$-e>ppOnZAKy~;UV&(?Xt3#kO=hS>ZWA-N%>
zY5D8M@&q3rxo`c<vug{{ZG8=i%)^dBt36giFCH(C$n>prrgpI<>fe?y4=j27{45>E
z!ER28$y=vJ235_7jRq<ig1vf}(^^^yM(c+Myx>T7^a8gRZ(ZDaRC#%Kx?d;x$+Msq
zAnz}N0Nl@wTW$?b$;Ytx9Y|xJm@IMsEiCHRF|(Ve%ChYE)HpqyD<GmmBPWecz#pk_
z%s|QZb28Ph@4A+Ty9C-FNFFeA>oPM)TxSrus*!ow)NIO%VSiIA3x~59x-~oQOLaK%
z9Gblm#NB=wiQ=Bq%#!x&;;OUwi5dRLtw(S0DWuauJNX5CmqMvy(52v9O^bE2R7~Yv
z@(E|AM9g$lTNl$IJGTL+^MW>Z^K~Q0g~*zk1nFb@5-SU*c2?G@Vah0m-^{5PA%UOU
z5?n1aBa3~@1FPN#HjM4AsUL4-8H!tcr6j#94{y35Du0=gKtr<A^eLtU$DK&U*!<Fs
z$#f6b*+!;xv$nMAWg$kzSo%D#;p&UV<i&)@w$_`ZsU}Xe1-dNpBF0X1=5?pgZhB<w
z%^D42j0--+P_^~uAl<HySI?|ut*3w&Ix3)w315An`uH)i&v}6zEe2S!Y%Xw=S{NS@
zmBao%e(i#g#nVfe&a2Z=_a!A~e<}w|8ZvrZCzu*8ReWZ@7c$o!yo4{eTc%<}A;m5%
z5^6gl^Hcw+!*ZO8{jE+tyq^>Pdm=qX(AIE{MKU^C24nc(je4cS4`Z$T3#L=$C;WXm
zx7zE@RyqtjpvhC*&?3Q2$8nj@2MQM7xt2tI`bo(G=svxgoG|tW**sm|orz2yTJ)i?
zyu^T{H~5MrT>>XZ-lcf@lN=HI3;m1w5vhNqW8^E;#D-3wL;6dSM?bz?6kP6kZ6q|~
zKk4s@_d-RKP1_-((ubuB(<R;orK0zpIwY6&WTSiYek_R6_nJk0*teHYF2LJOzUcj$
z`!jf5)`{idT}t--+3_jr9C;}Ty|GVd-34KJj%-VURuz=z`7j4(m?u>yg-T`7We@Rn
z%U<}3ap|@NAvNPA`fE+c)Hp0oEePm0oaSL;7Zfk;=(Co@8=&%{f9?sv%poZdu44!j
zVv7Cz(h7UL8q2To3dv>c77)MCYMgv?YjZc*p|{j%BGJ&+1*gVa;&F#qOAJXni+Oi`
zK_`jHd+$?I>2*<FcZ=V{XEvQ;Gc?#L0-0w!D(}q^<y^(f=J*bT=7cpi@@D?%UX}c3
z+N+5C?w>KX-KB2VT})q{rIl}?NMQ87B7NVJI3B}Fx1Y|l(X+bi>+}b4+r>7=@zMwM
zgkp-u`FKT<9A4wv?tTSxjX`xi7;Pz?7Zl{ym^bd@V&#(w-{;IS4TzXit@HD&@mkCE
zcqb@5ny{<cLz<ms5bsi%@H5$l!Z~yBN+X8bvZRB`wKl0qk99tySaOz{2KRlP(T)c~
za8g>OHPQ;pHYz{R5Vu|AkX(*+{q@TQ8yll(oy}Oj!TvG#>mDr^h%mfm9(?VNce!3o
zxg~)9F3Ceo4UCga`6&NHG~7wPysye&RC3iTu(t%R$81-PudQ#X;hQ&|e*ZomFnm)J
z!)TaVJwIYCX=^^DbaLC%=ZAr4hF*hBFm%j;%7M*W$He@yf12+s>N*>T<(^MB!4wId
z8qprxt9j%i&b6)1zER2!UA*vBFm{7Tg($YvaCjH8;9bkw>91n6shONRyyp*6cVtWR
zdvu?lqx`i;5Cxg6uf?@4cTw3YvOKa};`V+tv1Y%0cUt+dd*$})i<2OcCFrh)y)L0o
z!ENmNf)3mDm5a7#`lkf_M&cdO)rR9cd%J^1IUvE5iPcI6<OoGDA9&BY##cM>^z9uw
zjMHxF52#%sUKv>Za;oQ8_PE_J3&%CCdw$f{HRH!bEj5ZYlJlke(cmucH^@V#CRtL;
z+%(vt7cei}yM1LsaP{q5`d`*bHF&&+<j^g{4wC?o5S>L1iY$+u=aCwwcggwS9M5XY
zJ8|t&x959M2p#;-#jSt7q;WhmWd}c<6Ove1Zucx*1@F~9_-_(hxQWvpHhraz{gL&>
zape%pqdnbF45*$R@o4pM>PxBaPI4ggy8UPHuCJsV{oZJy=p~#sh|o&42Ca4|&?nuj
zw5EDoMq)tmY%(HzVB<4usr7&+S9z{_j!a&6ssS~=a65pspnZw>uw9<F+e@#<$`oFF
zoIBFj3AVb}?i$~p{`l~5+lYuB$j2cjp^92v1rJbFo|%sOJ!p%Wjt4(LXWOe--dqY=
z&URI|<({oedoWy%8{Khj+j$abxV&GrD?Dp7GykXx#q6%BEs~E<@UOAh`k%VniLVA+
ztrB$wEz{ZdB(g?-;~ZzOMz%(;VjDJFUKvq3k0NzGv4-ngYnmWGL#M7~aAJ948L?{f
zgQLetm)iITJGrj(5(Ub<3s|+J*0xH8X(x`wkhxdgT&ml9kC!RvH%A}Q_js!Z_nx^w
zi{ef5i$RL|kdC}N!rbB&>QDqD52U^BZ%NW~R+aDm#iO?02{rW31<xkZ7v#`sQRxSo
zN`;bSUsTm<&%-I{lwHR=x9gqin+_#QoauLNpNsBopIJ<>z3s`+d=!nInnNxp9+yR_
z@$EkTN?|#iR+`|xLdWn<JWV=>cJkR<uJ7Nsu1zjZ=8ez4=HeDu{4f!%6Rk^IoZsPG
zJssgu(pRG;`#b25hautn5|qqXC?amDFC7lA;&eMao{x;|l*w3Mn(PoXy0mlmo)&e_
z=QgI^7kjj~oK7~Q>|7;csFvLBYs9%N8zUwrCU@$UUJ5RWj!CXa2A)*syk2bT-bMOi
z3xDFr8EV**Fx}o~SrAGOo)I6dyR@qfzpr{V!e^}SYror<jGHCmMhkSr&CvMrUhs3a
z@$trzKlP^%^7cm6>m0mLIB@N)RZA5LRF%<ujg_S%^t+p7?0Z22a)xm3;*A}*y_x9J
zc6I?SHAj!OwqnL=++d!prdUdce6poc27Y98&pU8J{Hn)H#78~K%@Gv`)HsT!%1BnA
zToIC1B{-igTg|w|hkNqr$=qmqou+4Tippd_Ev5wYQ|SU5FO9#oPL<Uy%`fJRJi-g+
zwUpfL;~P4gZ+)-a;#cJ7n=5|LMVc4X3ql{Bdl<sZWXqIy*n&N|=Ma@}IOiUqEqOP@
zB>Qn!!yfIF4pA*HF{GfpAVGgU4azdRvIV&BEiLmO*1^o7(3TI<E|!=xZ7WJ#rZ`kY
zoX|Fjdb%2`{-0{`^-#Bk7pbAC9=_>_r@ORsI<?2dJCwBD(S)J?;y>Y~FfJG-r`NQI
zntvJ8@J>0PFDp%r5>)G|E6(TCudw&6L)~re%hxmL*!Pa_4tQxjdv9WT-t{@CHTZN*
zG#`GeAT75hvC_{ge460b<QgxjMy?jj>fC)IJ1gdnpr0B(R-HOGf9`n?l~{qiRJeZm
z+j~1GlfD%?cvMP`Mbwxe^N$SM)nDAzlcQQ{2`?0@O7R3dZ;4c3@&q9dYVn$u8k|KS
zhq{i2V+j!nb(Itq-&NJpqb|(uyEj>eTlU_RxONy@e(#$zoD^d2IFD%4dmkFa@ZHlb
zdst<6Wtz{(C`*>wqMJR-gMcYW6yvZSVi&Zz9_cg}_NZ=mQ{h9+!Crduz4Uv&X{{Go
z^<p1(6}QV5;8~&Di=V)yjLxbB8uO2>MHw!`yDw-AcQ=A#goSkv;4TA2(z|n96NNVM
zPNQBw@(UgJiPbcuv4R4+`<8tXU0wcC6{ddh8hO{JzrRiYU+rA^R})zpEu;m6qc(!F
zM!GvJA`ljVAR>Y^K?R+$g@6(W8dlk47m!6n86Z*CpoTWsECNa*5_Uqm5dt(wG@v0u
z*c26lL=0h(CG*0ZnVxgzUznfj)OqJs)q8d7tM9wty|<vRSow~meruB7HX-ipRK1SS
z>00?VnE}u+BpI-#*$T!dieOm3iqU4_nbP1kf5dZb4i%XuWD-!&;!w^txa18Neh-NQ
zR<6L;K_UpyvR6D3>CCS{NkxbVkFVvHC9P@Kod?8|%Y(Xtuh0Da)QkcnBABWzM5A(b
z3wg?Np#drwb3Dzp`I)j>5Upn~%D<vulTnjnU~MvEWoRhCE%Ws1gY`ZS|M;2b3>8S0
z&w1A%Wdi6J(Nz<|5KDb4kE}lf+I#-E!A6d&j*B-0+cWAxfzlEab*v$&)!g?VK*d|n
znSE0TEPbjRGDfNKf}=sRuBE{iq@tpsMry>91Vny@(Y_#nzL3S{x>XozsAtghsj4%-
zu8(JE!wz3cr-5q69cwXr7PEJ=(J>-0aG@_U4*Zu>4I=v>tC(uj-Vzfa#@lsW1F4SH
zFgIyIX3zdEg|qy^i*pt)r!f16joWjQzx96FN65^r9(~%;_vsaTj*IFWImA*mO6l!o
z#ym!!?7j^;Wq~e~9%6AwdN14wkM2<M&QZ54*rP<a*N06GqRH)3h8U|TKsNa_09c0!
z>kFVK8#0~}PTO>=_WjO7(shHH4g$cJ%Rh{&cNxsj&zsKgYqe@?O(V9$p7d1AWF7Ue
z*N-<=sg#z*Q$yb>Q@uSK$40X(6KIMDcWdSV8K?T;uWxI`n;f|mw`x`1pB&ktS{&iZ
z(sU8K{~ojdeMl)vZBnvBgSw^s<%A+*4I}dE>I!aV<`H2B0-K~0!$;GWZGwpfxff|C
z{4@TR-+Ps+7*-%rif#cfU6=IH@mrfG1h$n~zeNSS<7bv8U)W&%@H+JF!ybRm{vC|9
zK<=CmkGoO*ptu0z6Q7yM<W#$5yHgWHK=v2ej((V?NYe%?g~<J+L)|OZIOdC*{N!Zz
zs5n&68a-3bF~*p5fUH0~rn;#OAKEVS!HZROju19`--3YP|90!x$@@0v6IT7;WfX6t
zo9QPMRMdlawdDT?0y^NIz>Bj!=^P7+aEQ`tB<<7iN2$@bh$zPwYM$rS#H7xriFJ&z
z{c6=mTD)HOH0DKy!VHb##)7_U)Nn+pW0m$$=)`;aNozF=8?ZRl?g27#|H1+jZt_yj
zH6j9tH<-;wVpWwa@0*(vEA{b<(WRv2dQRC$cv0-<gV)rM-=-9BZIc;VfPmynlL2Z1
zw!>~OlE>68@8nfKiLOoy&<nc`Qcu(WPB$&l0l&40JOFZ8c?ypVnkNi6(vO<CMlsRo
z3~zUf02jZ+72yjV{IqT&W=teibD-mSRLapr`}ch5vzMmo%Y832BAVvPv~j<5g)`Jx
zbq;<PudUZA+5~efJ3flu$!E`AmyNX5I`Zbzeed?s;iUK95aI401Oj96p0SSf2~e@Q
z0b4blnSn4g;X%~daJ<~$z|O)UiqoW|ijO7L3cJVX<?bvE@bzQqZDov&(_axKMh)8j
zL$Q3_jrF?PLp^s**=gIik2gNO{Mw9p;I<k(X|s6^pihuZ=2j+B_sBe~xVC&`p4Ua%
zF;`jbMi6a2LC<Wil~<gGwIUJ;3?)7J6qd|RJmu{?uY7qNx%Abmt!ct9T%J$##8Ux!
zO;i9v@>`yFqzWj6)wSnzcXR)F$IrZ3GR~z0exaeDCDx*ywZEH4HgLzIX;WWBh1Rj=
z?cyngZYm(2-Svo^yBoc7Wm2G__+#jZf7?euJ_GEiVP=i?#$x`$>)aSQDaeis0{+#j
zaW^%UY&TyDt5Gaa?R0+cWQYmGXO7f9_h8J=aYtEeOP;t#*;*-v$s65x)AoVlAVcYV
z(qnf*uR8a*1GR>OjIK1b{DRWgM*%8BwL6md1cYGRHYc(zsxoG%2>XF9w|r|SlWm!&
zh>(I(`4N1?M0vP|GaYm6gK?sZ&r)Yjy8~<(@iWuRkk4`6Sku75;RFi%!wbSmO@=ru
zol)vU5Z*}3!ipapr5ZhCSLH8G++hC1wzp@d7m$<9X4y5QMY0&v8urEzt~}4h^~)r$
zF96J0%i1@+C3K_=UGud)F0gV@#9?aRCTK{!E*oxP?KhW@@X?r0KUiG$?MK_j4GiZY
z5>I!{^9Y|skmNc0pr)9|3-w&s8;ssHjMlbu`E*Uh@_Z`+5;Zc^c%>l9**tTr^r7v#
z4I?c#gx$2j-FgLEdmAii1KbI*wPlWV-jJDY)3qA*U>GMFG$F^DV*C60nt+vInjq9n
zE!*zc%0zuv2{NQ7g^KO<cqbS=47W?(h#A1e%$|UwRF&)_J@?20Pf&8v3-rqeisjvZ
z<t77TW6z~PkLKaWW`>t5y|PVq4mRdxPZBGY9O~Yn#Zhs6HNJIRd_-&jOC9&V+U?K<
zX#;e08@|Ijo_%*TH}_(HMGaQ`mZBHm9N85Z-+J|xTv%>yvjBzxNdRxyVP!qOw2<aa
z4_30%JUc{AIe!J{Zy<Rl(3Lj(L3n~ii;V)DK~J63q^uVW7V>4F1F8~?o9OjB05D4W
z!c)fi_gp~m1gIY9R_JVlL6F_qW|0{%Hi8ZSyc!Jr+a0zMCM{P`G1t4WFT1PPLJCrL
zToQ!qA!4W4a;bKRUpA3lHo$InYsBf)sVrb^Q0%p{2rz*o75@uZKHN^~7Xjx3K;TwZ
zQR!B9)k$U5`7Xp04Q*L@ZhOd&fOG-OmYDZ7#ZCiHiJqJPGJ81plizk(S>f*EJEnw&
z=dV4`$p-WGE(^=1jl(6@56~BrGoezxCG-GXDguHACWoLNyTlXIaj6slc6uj?+_u2=
zgVWo{0lj}+VlkduJiMN_h5cflTwl6^<?MbbTJkpsey@IARe+2uF$VNk0f*gSEt1<v
h!pQ$m{$~$_;_i~}<Vfe?Sug~hbUgDj<+xAUKLHFodpQ6A

literal 24315
zcmeEubyQdD_vWFy47vnF1!*Ld5|I)EM7lc#0qGX$5D)}GKoBKFN~A+c0ST3o?(Pm@
z_Tm1%znC>^=AW5a^T)96UH7hY-gC}--goc)?C070d_o@FlOrLdB}5Q}L_uCg1wk-<
z5d>ol9~X{X>mHhd|EN3N)^K`gXXfN$=wOQ6HFUDKv2(JqG-7r(b#Sz_dn~{$%+1Sf
zV(QE%$S2BaZen68EFvmoB+Sok!q3Yuz{|(aca_<~$;saFIuDQSzhBO6=U~pGiltKm
zk07v@*K|Y>GDGxVj4a6ymI$J!s33Dw)irr}*iGkU&jjw8d7u}KEV=SIa#f|F+jrY^
z?76r~1vjnA-|zn#+C5*w`Sjs09ZoK;>b#XZuj9=)-uqjG;%DO%a;LR3&lR*E9!~1u
zM%xD3nkCF0?ziL3yxA3>ZGZ6V*MMFko5Go3_-iq0i5Ny$;4epm*jEPrC<8HGpeMfZ
zB4;QlC^V^YrO?wv^@u#2H8G?{Lg4gOVk~Aj8~xl6VS}?py#N2={~HTdDCCS4tQ4)5
zds|u>^Bf_L34dZ?(k&So+!!{3?Ck6;&0_W`haDI3D2x|b2mt}X+Rl!Uvp{fg*2{^>
z$?@rF(<QS6dR(b=%**Epk%_SS#>U2$ybCNWx3YVzTs=G%YdWv+pr@yZ4=c*bPzy-p
zyEl1-8n5wx-=^~|<c)pS;yQEYOxlCXuDO&%V2UaaA1W7{-EEmZ@}Xd1Ne?ypjU>Ey
zf!NvE84LL-NqKsTRaI4m4->Pn@KeOFVT^fsw#6!ArAfa<m@$3B!ov8Hq-E38a>tjK
z^A2b05(H^U1Zg8y%C+)@jI6;}U$H6Rk9go9<U^Gdw+ux2tdREojMEp?;(fUH>INGd
zb{G}U=}KMIy0<q->rTW^(^cul_4(tn)sopG#bnpp*ajWRq7SlFE95*qs|u6A6_iuR
ze3*9aTG!Mg!~bB(n{X^GEg6`bn=hG>Q)s^P|2C?fS1y|-R)~lCQ+VKbr^u=Av|Oe>
z4i7qYG7kFs)F*tXpD8~#+7pmCb+sH`VxRYZ|D4CJPn|bFu<bWz?j}q6FwS<SHaCV*
zt*?#O^K*KPRJn<G?iH-;7Z}#tPq)UYygHovepaW-m7?#HF6UECaM$UG@y^e@2&P7X
z0fwIUzG>CLLhfAGTdW+lywHv}Hzr4_Ju<lu>-@0F+_!U9_EW??*2ca*JM-#8k5%_)
z%ZFekf_5YH8L|-^PwBt{TF=6K_zsb*9xDnOnh;jG$gx-Y-e2c`eTa^aH?tRIxb7sS
zqH;!+<NPO`a{rbV`SxVd;`YI$m>B<iZ?4DXgj2A}j_s{ay6z6Uw7pkGCm1l^DVS)B
zh&^36cd)Y@#qnsUJ4>0>X?27_++#<k(s_AoB3&koGOy5m+e*yq;P+S&osdnigxA5?
z(m-*A@%QiF6NK#;ue+>-*VRc8(+c7n8XCHNYHMk!JKEo*pr#I98Lpfx9rbQg-+6K2
zmi_*Q>F{Pi0CqUT4N5Mp&r*jw%Z1L%TJkZf7K2j`qVJUw{nho{a7al>achN9OZ>KG
zUeV5tD8>X3oRz5K%&+qQdw6owYJm-r!x+LQCu7FcTD~qLvuD`)($eC07LAdyG0CUd
zrU<$$t&*G-H*iz1Z9c<q*q$5TFRg8CNW&{_ycBoaF!B7m-IpL_OABLzvLAk!sr;}+
zCVAvr>9UGR?pOHm!@V-+W!iXd-B6biH@wZ+&gLK{Zwq@5*ajtn`czASN)HU5^+qa<
z(#KrBJuMw6zDG2@L{b8X@dbtG;IPH#r6aWAaF@EKruSVAlM@pKp8F0arl#ZVi2@>S
z8*Do(!?_;S3bE{aOU0c|os~}W{@?>fgI{bDBz+`SMr)()CJ7mi)_BczXW$`e-hU4)
ze!f$9`_y~$hj5wCi9|=LBpDSI72;b`a!q1y3`;3RjE3;}x4Qd503LhP$4aRKICUpS
zvkwt045i<bOMxw|e*zq5D_8^t&w-s>-fDmO@?5f*+nM_*Vqd?<Ug9&TL!9P+UhEWw
zDbz<v9tYoWS&_=<X1;I%qr|!o7tyKlq!}0(m>ViDUOAGDp#A#mS8>;MRu-17FSgpc
zdsx1Yhbu0Ki!*e0cUue;WiqZt!$h2Tj}q~UiF~IsEq}f5ul5i|nAzEJ^R!C7wZ?Js
zc^x<*bqCvvg(lz6T-C3k$H2g_cX0UjQL{L$+X6x6=jRK)d<iUhIuiB!`}gdw>%V^f
z9Gjcd7~8+7*&+=QK#ACArhaJ#fyjVUcOQ|!O5>VYlGo6Vl3nbzUH^H9XI?j`wpMcH
zM^X@ME%}uzR}kN7k6ojwmS}2N0<AALA-E*8V>`=(71j&Cv!8{B6YJD^>$)iAsj+f%
zf9i5y=*>$qzlo0={oNg{=z}oQj#HoN##f1mn6*=fGf869v1w>t!y_jy#Al<dvqdNn
zAxvug#E)03`o6##daF+z)%wFYMj;^~jcWI6NZs%-!`ruSD;_mk_kFr8BNMQ46i7ms
z4qKfd>c|dp6C$%&XG%nSd%N@^I!9R4=W(3s(lKme?pyedvmLiPQ^b{X)$*kCE8RBP
z)6>&mfOlWIpTf++L8z>(j9V=UZc_wq;|*@pYQq0fw-OglH!SA&Jqv52MTU_*j5XXY
zOox5!&lXRJ;7$$GZ4_(U+t<n%FI~E%l*o^htDYaImDl8tLqtwTM?^+OR#s6l0YQpd
z(BeUgwUFINcyKU29Q)SOb3QRK@isT+`u29Cy1v)*%sa2r72`P8*4CuV%-Dq<4{4YT
zj<`;eU}IyCf%{0gx{6?8Vv>`S8?1Ri-on8ZD7ncN8~VrTQ!*gn<v7JG)f_RR3&d}G
zte!0Yxi(bphzAdNz!7KB`%yF6aaECnlar_~Uq2`#gSD!f=s4)cjT?0E*7lB$oDLW*
z#jt=zMn+>xOFHQVR-alYR`vCi%57z2-hX>p&s5tSX0{V1HRa&;eA`!3TYK_3mEPqI
zdQMJGL95>_X%5RvOI>A8CVvV>0ANceI_zakBo34FLYhTGRiC<Ve41%h^Bp}RJx#XW
zQ3ckvK0C#U(8e|O^3!}xIhy*Ig9%qEI3lhyRWb^~#^gj}nCsq}VPc%P-G~^ygr~-?
zXMcfVnZvYVcB^V`kBGw*{_)}H$;8(DFW!lJ5;8KX-{Beeh<y>ts~Wx#-)Zt|4mhqm
z&H3g$%1s9gD05lW%WjjfA45LrRp)rrn0GRYxvr%(Oxq4uobSnbR1XkR2*Ji_v6loq
zjpI=w1bQ69z1*sH3B;;IOGZ|9q9vMjZ~B$K{lS*yyUa`)oqIu~3@={3#Ew&Z&Z+*1
znV<iRfO*H&&7Jq}-lahhyI51BmZ!Bh86^pW0@l{-W#r^0zdplD5chB%xE2Et&seWN
zZT1CY?RWOWxzSq5q2b~G4oA{dIl3#JT7T55)`I!p613?j_d3}6I#6u>v^gd=mJb%k
zX=RAU&(9CcjQrcTZyP$VqNDxxH)mOSdC7+>U7GD`|HkJpUAPrEwlUpSF$?Jx^$q8%
zTAwZaz=4gI|CHP&op)aTbKZ9FOOJT|qg+b&-Ia(tuefQBBp_%Lep^%DPt-+TvJo(O
zu3_l8O`kv7?37Fpv^*2ZC?1+5Y{w!Y!3diT0iEIK=!n<$kD#D+FL7aEA#R`JWD|*M
zp4OvXF^Gnc=q2zPVoK~!opp6{d#hXN?ADqh=Eh%hd|<7VBt$aV6j2Y$K*7Y6`eBI4
zdk@29bp(eQ)A+-^H}+uES9L4StyXQ4&UB_mK~(BW`ywkNlXmkNE^e(Hxb7_9ktS|&
z<@q5heNR6Kyhhs#J?P`6HmYcP+uDeJyuMc7UucZtzh1SwA><1pPbRQ!Y-|X*gt@s%
z+g|a=si{#yM0^%|>AunGNOeVDlAxu3r^KPsZWXLXnd>^s7u&%=SlG$qzlZ&wEziR8
z1u=@dBgjHueiZxN*XOimg-1P~9qz790*F@}p3?$nc}6BtH}yUC?Sspqf5pJFg9{3H
zZHCGU`yF9%QJ5Bmc;kIA|AAV>o|*k#vc^(537t^G`@2b9CD!Tzfr06_f=HjIpt%T4
zYyuDmML}F*YF}>MiYZZZK%KqyW~L{z9SjzNv}|l_X|R`wFT4*c`1qR}F1>F?Av1Ax
zcc;`cmyyB#^Tjr4mc3`V;^{4S_v`5y8Qn#uZ7idskVEmJ=zh3dTJ;K?H;%AA)f6JO
zhTdx-+fcA0ECfPCSI#5Ok2>XNeto!)hkVqpWxNxA^(&Ya1vxnaQLz2>H6q#wT;xSc
z3aPcVwTAZWU->u5$%J_VTwElPk&!ql`a{z3@IvFurK3%dLGam+Nj)3kq@d_7rarzJ
zHShx?nctKUmgAD=&VYHBRmtrXI@q!947m(2PuKa(S6iRzM@N}9XMWT}U<?K<M(Q9N
z<a3ykCuX>Qj!XNC%rjgP`@<dE;cHJ9e&3Xp#r>pT`{~AewOk4+Ds>C-r;EKmikY#I
z<KsiSVe9AnFp;iWA0PCk>VwGo4!yvX#iPbM`N8Jt1<Z)ql@fd*+j#4?IfGA1+5|J9
zprZ>LEVTm!m+s^2g><ujU|_s*wT9E-SpQ~I6cZU89UZtUEi$&U64}-DU^r(2>=D?e
zw2OCrAW8T8yL6CWo`rSN%A+hc@02w&Gkg0Koqg%!VHDplD4YSa3MhA+O*ijM$$FHl
z=GT`j;YAA&+ypr@`MGleSy`85Zr`3JNP!S_V6a!LV@8FT^3y=HN6j}KEL@}5jHKe}
zBCe#QBrv3m+hLU84gTC30G@SyeSKr@$;rvQrmg4DnOc?55>Z~2vaz`;CMGtvun>xc
zM{3ZOcGK<CK$V*S%p8sps;jG;n3++Q<2Us6QR#bapGR{%jz>9l_4Qb%Xg1eh>B95#
z*RR4Sld=F@bBqi(oCWv9&rn298|@X_@P7~9rFfXz1E>Ua#Env#S~|C9;!lZnnd2-e
zzktA72y~Fau*{Ccse&iMu93>g$+>z^9q}kQI|~6~kIl@eO<}$;w-lspXlSS#7$}!9
z?9qv99IdTNa2N~@R%|=-?LW|}{1es3s{b)um4&_v4(15B7$C`!GC+cH7I@5e-Xmqw
z;#CYb4lrQZ(o8buKvEcUHc--?(gO)W0s;c0vQ-xtpZ{2AW8s%0_Sq5x)`K|CwEHP$
z{uEEC4HBS;E;riC@VCcLz&E-O`R2`=!laurs_&_fvp{7)9*<OoOih^}z7Y{5Rn^tw
z@Gk78ok_xEDEWwD6h{!Sje1CON%XE9eS{p6nS}+Dj7cKk!-q?-NO*X7LHw3H6cm7>
zKC0(%r4ZP$I!HJ1A(@4Jk%rXk@@4!{uU&>5^?bdYA~JdrU#p&+dCW1?vyB>p&%APh
zG!+fa-rnAj<#V7b40*uPU@6%t+-ZjdXE_)EdM9`xzpYAwLqoqo_;?W)_h=#_?FQgz
zhFlaT`7Zg&P`Q9vM{-D>c4@q&hvN#Djtc5&Mn)`Fzq2q9*MqGq?mJ5%;56e9&P}_d
zf&H2j`@AD7*2Q*M_<dz-b(CpkWd&FVMTN_1Bup<IumDX~hAXbA<?H2Dy5wJ={Xf8#
z&OLRc1fB~yH{#*pfx`TgCr@x|?}Lb>Lwzi-4?c8J;Ts;4r!UH-PL4LoAgBkxTTehH
z92^xT2jR0fPa6+h3dJixlv_47AHQx7l|8`%C+!ixFE1};WyOJpjQbM%*m`<;7C>oJ
ziXe{+&#yhE{q_ECJ!DF}uw0(G3O;+|cth15RKED(Z>~T61~H<*X<nsjv*QNJWF(H(
z>Wv10(7x@qAZKKZgvd7b#$|*LbtvWOuWNF+(c$u$Dhdc&oMPtgH9FzPFA;gjK;w&w
zi^IfrA&kW2=jZ<hj&X&RHKS`YkeG&L|M2ims^><?xie>2w&#Dz6_u90@&-D`(zg0D
zGwd@wT_J{T9>Qr%L_~zsT-Sx+#aBG~@u1dh&3{N;h}6{7RFI3Lk7iSdsX5xXqmZpS
z<8}fWKs-GI!^ILUU7KNq4fzQfZ|293A6YtuZ(rO$R6qCdF&#zs=4Y+E&-S~cD$AOO
z7e@yUGnqP?Xet$Cn^)J<6LrbPKBRhw`eET2O*DkOXbXFc2FgOqU+l@Ej<}Hb-~M;}
z0|-YmzyE@NbHkOwC?^3tVHFdj7q%P0{-3h0K{4U%mEJr$h*cB}47w&BwI|0O=q3V(
zmDSMD$fk@Zr-<H<>ED#QXaJdSt0HV%p~voHL`q4CSgXVeWfn#UTl0wT_F|v$_n3<s
zHJ+l7ppQ*W1!xwV%|B*}|4#rIrWGC&ACD_1*NoYD|IQuGqH3^ydl#3W)Kn%Dej2#X
zv+1^1_3)RrdsjwgCTu)Pv31EE`2eIo)%$=T)oX|5vzBf2tgNi8(binI#o!k%J@@&G
z)r)JpyUkT@n``4iObcqupcqhrw9(M@_7-6J9YKpOq||P-R~Pb71``vLF(8Z;##SX2
zEsZq)6$B58N=k4LF}DqwRZyK;s`!qSEffCN=!Xe5*8rQ1DlY#9fzQBhZf^f);?_M$
zNlTlf{iq7m3c#wl4!iz>3x7UaK1&oZm(J*x%Iz`QSsG|*Z@>CE^6jml3GgqCa)*m-
z3g5u*cwJU>ww4CYmRR+0ti2xfJ|yuuTE}CQ^bY^{@oGR&kTF~e42Q<5?~`p8N{lue
z*5ooxoiQG;#~OlrqM6b{Pj1jP>)tf&(#LC?o6ky1h0)BH;4J%`|0D2cPcJW$PtD)I
z6Fhvc^cBXwRm&|j_=?%k)btH-?bD}EBET1b?7p0R{Ub>jFdq|+**|@H8+h7lK}!`2
zhMJn1y@lL-)OS_0Rd5&?8R2ajz!r(B*&*u%&<>P->-**n1DGfQ6BE<$+BJyck0FXv
zn#8C!ymy=i+I%ZpRXS5;S`*(8KTj<TIPN&eT<EH-%XS^Kw6=Z&LmQu)!?#=YKQV3V
z=#W)aJvTHo6sm)4T#b-@mXJU#a^uG0d9~uABKyT&F31G;_VxfF2VRsK^8Y)ZGbyJ&
z-a7R-FNAH=wAIH4^-WFoK*{<wk17i@VQeK(2P^@xKAx(3iM)Z59Au}gjXiWcs+9;8
z&!Y(d<u)2nS>414hF1MElsr%}2mha;{^L;`g#Qc$I0^k{s0qAq_o<K=9y}fuekv5U
z$WtG;Xnc&&bnCDU?y)N2OS&l=v*{u{v78lxDvwd&-?K1yuU$Kjj4l808ROD~;QCTA
z^AuMN;nMzaTEx2dW60i~D@cAVCj7=i&%>o+*xtQ=pKkW!b<<-)5GW1zSRWevMlQc<
zLxtpa_7~BGvr)lU3F?^=3Ar&rM9x8oeM}Tjr`AdXM`=+xGu;79>3uLtQ?rtJkD{}U
zP#VjD2SZ!`8A=U9ub&R(hoLjRr$fVGXt}}ZP%IdF?{uhQ$aqwHgt8ruoC(K&m3Ujw
zTZ<ZzF;n=yctH+4ez<-xNq<B}RV+}FU!5PKv9Yj!OF!WP#@5bGpkk&!XvP%UvNG>O
zK_C5x`FlrE`QNIOLH<L;jZQS!V|8r4U;v357Nj+%b?9Eby966_^>jX4b!&2Q1n34S
z^T7rdoz_A)FzcBf$)0ZDbJ(@k)~vxgixMp$6jE;=NU_J#6kjpHj$yk1y8-SLpwn?e
zb%EvAH@H)xGL`}8g{x&!fRRD3UcEy1=UqLVdGjx=8*!QcA|~oG*s?$C8{BdZUiu<0
zh}kqdPoF$7L_QnPA75g52$&Y{e>NY~BA8$Nb96m{9y4j4?njXYEN2Kh{T3s>qv*`j
z?FfT~j}Jc`ND2c_ccbVsv5yS;8YVZXkAtys>&(F!=q0`BA$)K-uMCAiCMT9p0@*g;
z#MRP+M;zw^Nf|;L8f2d3-&InQ(a@ldiHT`_YYLG#YCP&P71r3v(w`C{aPzsrQl8#?
z{ix?eRNtDL@oohYV<3=v8G#rpfA1c5sSt!vY+wdKkP#lfh8#K#$Uj=!Kp_Jd)GO^n
zP{PjFGb!uIR-e~Vo|u?W>`9tlSs{h6P~9Q!yhM%S8bn5;^@+v;G$=zHVi6H3Yp~72
zPf1DHo6Csm0x<x@?V<i37g+d3;a&F=O_1=guv=162msn0oj}ldP=P}oKUv&ENY8Wq
zHoWna=*r?^7~~LBqVH9*dA*NZfmwcoM7}Ma>lP3ur~FG7FB%RMnWCgvM@MJvU@_l#
zW9s{hHpd&<WQ=0Lz)6{bCPQ?i7IWp5jilE!7<69h_xpReYYdmIZEdyhx*HfUV`5>2
zc}2;{#DkM(8L-nJu`w~g1|xyJU0`Oe8(YlRs}6-g&vNBTc0ZDkoE#1e$Ox#vdz?7T
zikL})KEHa07A49+V#Xo!MWsyHjGM5?<CBxm#>Na_Kil8jpn~mdczw+pK_CHXLbEEz
z86~CHf&{y(qjIXMs(w!)sU-v%;ezw(h%R^pOZqpyBZ~7KY*+@7zP`Q=tHYsDQFsWX
zsB-z6a^ci|fZP}e(Bm*jo5z9ET8vbQqG=914|3%D!r@D>ghIA|m_<aWALXci1tA|*
zUqDI8>beeq_1W@QfpIhG(f(}eMZ&MJ1mUm*7VHcNr*ub`jjU{--fXFL-@V<+%E}v1
z13Po}Y<HELBbwpdyLV6HiwzB%f<K!AaNd@VjwZ+kQ6l#49oyDoUw+GV*(k<{<|rms
zLBW^eK2SI_+GFKNY0Ss`^zZ{IBwOSR40(O~J3BjWDQ(jZCg$c?2#8w<5UBpa!TPUX
zF@SvAJ3GtD%j1iQivz(#_#_K26F$cT<{_=6rA06TfgNZX>(8jhUF7<W8-Tuy8nxcy
zs6>8B<5MKOUh{07Zvyh|^LLvH#8%z0Mc}Y%YHIjoWOCK++k{-^prV0BhlPr6;BFBR
zmt@>w>3^oeO)=|2&vV+Zj))V}i;(m2@gWU0K6s?`QnMXzwz<uh`U}gP=Fgy<vb|ji
zshez$Dtx-AhM>UN6i)LD$S?~(zlwS%6m2%+N}#HOCdzZav(JJIqH6KxeyYT6z(in)
z%nD~#MykWIva-(Dvfq_4`2=BrxE{err6Lh1*QltdtbHTmse?s<^`aJjOb`B_<05+Z
zwcyuJx|Icxbpn=VxNk3HsbmtO;?%Gxlg|+!Sax^W6Jym}HIj~wj*9c&IuAkETR%Qr
zMTyt=_&83ABa~@?`7$#zBQ!KLXz>b?LSFL@`g#d$78ZfVH8~TJ#FqkmKk$EBU3;l`
z5eiP=YfjCO`k^X}iXGNjN=maej)@>LrU_7&V8;Salf=ZY+jn9Dzz|qjS+Pb&Mjl)~
zx8I?ls3;9_7bRVwH9uR-A|^aMOu|GV9d<I~8w%;{qIg{(ox|?qZr6x+c6U=i?un~E
zJ2QhTEL?h~j|kyU{MaJu?duwK(UOURf&c=_Me`VpE{JbHBl8Nhzk*@70furg#1i}Z
z;`<TX%gAg2Jf;7fWFZG;M+aA!p31rHfFQ~Pr(hD>ye6mmg&Ii(@?w9q_XJgy`pX?J
zLGg5>O2}#M!BCZ3@z8>Lwkl}#SznVxPC!yb2S9+<{Itx<!jB72C^9d?c#x@b0r-nd
zp9IMGz&~(xi>>>(_YMxy?M7=*1Eu8F!H4ikOv8`uTV~u0s}`M{tdlM@KM7J<e~s4-
zRgSokKD2=7I{uuB*SLwe9Z2`_@o~Zpm&fHL(ZN|P5EkOdVs&wjU@s>j9wdl7Ve$9(
z-}>`HR6yXY<ln8cXcz!${-MibLt+&u2sN((f>K~8YS#DmQX-)DhmDPm{j7>`*quqT
zGg|D;%hId9j*Jc3)i#1O6xOHbL9#qpD(tY>9weLLC!5hNuAbW?YePbT0qZyYooyA{
z0rIxrx$2!`dR68FfBvwrv&-h^nLw(HRjvavQkQh6+tD5$1P)Yo1!9gCqyUuAz(Ff$
zk#>XU$`t~L=Jg?GFO5x1`1k4iFn|;ksFN}{;J!9?)26=w1L!W480tXhM)fk3djhDS
zCDc#tpw$?h9REe{1_5H*eHCH@lh+mn=vn!F`%OlQm7hU^Fa})Ok4%yt48BTH&lDGb
z<*#tlxx^`Qs6O!*6&0bSI&2)A`N-Xc9wIz4MgY@<l|rvW=g&3+XAlEZ)90Xl8w0g#
zX=&-QW}OE;1Tcyc)!lM!!Q+D<JCDDr=@0d!t%aUDRI1l#N&b}DMWNC<1YH=>Je%qh
z3ChC!r%_O*pz<09d7fco=y_^BBW$Q)5`DCW7=-HEP-)9_*$WE^xe4Jd<$+>jl7KlW
z*uo0v%XUlb6q;AT!U&mZq7^e^5P6O`j?Q&ZW(j=HQBtx)-o+s4twTsm44fKjsz1Ly
zC(4|gv#{J-8;?<9k45A`f{%t^p*FUCyWD=<A6x2RyH7t%jOW_5N0`iBTitRM#(<hH
z5P2$YofkltL6~FR-``gNZONqrB;<=wJ%O^CLThVl3~2tDU_6+M@=8kZyy)oYpJ0TU
z0DX7h{~K$9=pmS>0RClyao^F(Q(IjO&n&2|y}~>Fh2oJJ9MCE|w9DT4_%~*C>F-Z6
z^U3gGHvWf4j6AQucVKv`HAgZ$Ss4<w8LeR`Hv91{=HeZctH{R$fU02(^>;USLXv0!
z!Q55<SdfnAy<LEsO23r?J?FKsT_n^q>VO`BWj$k4c)>;hnkCQ*w8pEWs~Zhf4XCi5
z*KCGr>-yfhF=Q1B!<(R5tglqAP5>j_1IONeEubJ{qR6&$MDd6^mL8KkoK0ch|L(mm
zj_m7C7wTGD38D7s{sy`xQfJF`xaC0YL%>Gy?46tfs;kB6>FJ?*i4V#RBr<isem(5F
z2V9zE5rUxW)*QvppFg*(V%Zd^uUVbDmnsnf$hANjKu(cJ1RES`N{O)sm3vfLf`VZn
zpqgQK`t9Jz$fjTlR(lY{pmvLc7E}OmiMa;{257|Hx6s-uk&e^G*8IcjwvFB0Ahp~^
zK>JN`sBb(deXOgYsd+(6tg6KU^1J8o{*cd*f*V;y&qBR@chrZe_V|F)`{b|7h-6}L
zJEW${jRNxsH5FA548HIWT2KqwP=laOPEQ{WP&1yJUn32vCxo2>DDwzD9-@wAzbmb%
z7<zO2qeda-?#ggIP;H8{XR)Mgt~id>VL;JGbJd|Kk|7L=6Nd9YGl4B)Gpmu=K`{$~
zc8(xE<0b=;>Vm_=fA=_o$lz(32U0IuL4idNfQ!y+&Az<ya18`-Bd7+z<ud;O=$008
zOUA?o;*zY<%fz6QhyB<;pdfb#VFRNj@cmtAEH@AJjpy+hJyw~}?H~`q^bDf#_Q6~=
zK3g-CGT%YdgaUt}5-KlEIh0Q=FLQxbcrWJN&~0Ww`!>fnD%mf=mOprS!;5@xZk7W9
zA`YZy^a0t%&5;#-Kn4Y&G@!s9s{nu%lb4sbwKHgUC+1}({uHqEicRpV%jM<e=MVHi
z?&QX3*@bqBl#$h84J9}KPghDKvWmw1$vEz#PN1-YMGXR4JePJltaJjOF)l2?yIt8X
z$&(`iA)9{R&z}VYo<G09%iEPEB<{IK4ys9Daj^hww&Ldms31dan*m%9nv#IYx47Jc
zRuTAnkReOr>gr0ZBWG&R>LHj23N!~+h`5hx$DX*JV5|<#5+wEzGlwc&$e>)pqf7&l
z1Y{rKz3all!e!;<aakSo{E5U+r{dh8cX8Q0QxX;2G6Y~mld6C#1ywMWPGd(Gmsx*&
z7M8O>r%Y&-_z_GNZ2mgX4;W#4-q*iV2k}~Y8u*fl7RrsXbl~ztMwFFu2%{rHFxF@w
zNrTL>8JbDLP}sO|;X<c17;Gcx8EtvqP`O0YaXvofRcnwAq59#M>T^sp>T@Cv{INC9
zOGYLTQaFBHb~*&O5<fq`qSG??7-3bOwlc&E9DRNLt>r-~NKTp|OrkkDlo}Co58}rV
zaG=lSqE)N}l==Jt{%&Qe%zOO^rx94&XyZY#1fPK5CREZ<w()AOn3aWt2%Yo~6Lk!b
z<POnn4Ju;6X=%*W!v4n~L9RjV)d*^IP(S^m_Y^RT7z>xU4v@Lfb=|1{&mT+#Fo1%d
zUgveG@(S7%1FRaPDGUUX!~iG^Qh*B7=&@RDKGjPReG$@KelK>nOE2K)TVNZwyA$GV
z0OydLy4zj^&5y2S+5sXOrF#cJ4^;5%x8{_WhRV-^A_;~6Mo8J9NP;!&rl6pJ0_VMC
z5e!h{tBwyA6QHg+wK3Gu`wWlF2mmiQEbLiO5FRcWV|X;H92yvbF*Wq$sy{Vd=`X~B
zl3_F4ZESu%yU)W1@|3k+Z9CMdAu3*dUv;MvEV|_-@ZRjPUDs|U2YeAxQ5wjGP~8zi
zhEuc0_QG>`6wB4CO1o&%gKAAkK~d2+w5DxXj|=+WTuHPOz;s87c-VM-&|=S*^~vV?
z!9hBx;GtDAaE(l&9IzGGr)JPM(ZB>FCLw+|zf*{H>a!cEqVYQ1xeXXnVAMz$PR)l2
zHC~)vRGdTGlF)7|p(9gM)0>$phOl^OS!cv^^KSJB8HKVYWRU!<=e>8w&CfY!%>2KK
zv>+rA_+m?;fvW}#&?uh|=e=jfV@Ro^ul%$s`T1?w=T3?F@+(jC)mPpkbmmL!(a$H*
z9dRZdE57c$6bx+!hJe%w*Q_bgL<WK(#1FI=4N{o)Uk@#UlizB3QQiIgzkvs;<{RqY
zzkk1>x%pO}nlS(b+MTAHsdyeF;#>K<&<{a-#^X4+JyH|9jy{HMTAMiL>}SOsh|ORZ
z(oRl-u;Y)G{zsg#*>m<Eq&*8gP8f*D_3M<HXhs0-j40T;lL6<0mM}~NZAL(Q`^;0l
znm}WkjvS9_5lft+ubYMRi5_A;TCQB1>t+Rxj1L%(CTXZA!oO)i*dU2`{nZpoQ2$0Y
zz5K%N0nN;D(F8;R9t>XYT!X6Q&`v}I&;W`rm1YNYb9CkFOG0@90~pG+J#jQy78f5L
zTMP~+1`WxiM(H}z)Y$k|zt$U{kWd<WXHet^i4+?TF9X~hRcpy9DFY#_EP-SmK_}b<
z1`h2&Mi0a})jrmNV#^EI10_a;T)UNC#2!Jb=#|NZ#?2EyGw*0rI9-8qB}Q;hJ;V(h
z1mcTfdjcQO32qiv)~DN0slBeR36+?p8>>~%V7bTPqUXK)ja2$$5Ls_RZ4*_nL5nc}
zFofDg>BurW3;(%#rszb0-l<y(9G?C&Xo`r$#Kpy7OD*&lW;h)m?Mt_Hg9SphjLpZ#
zhrsvUgUefb*fEoEa~0^2U`teD9~d0G<4~@%v9l8oGWsP2l@*p3V35=0_p((L!76`=
zOWKe5PEAg-!jdV1l!HD1h4bM>Xm6nvu}@=*{musI-}l~LHFuzF7ZqBeWCvz4yiY{M
z{SpLcLN6Xzo_IiYwpVR1LjZD09=)rk=H`okM<N<uUYdIiI2ay5B+){D%0J7=3}6G$
z>I}fPF)(?c?6D(sH=(-LiAn`vQ0QJj6Xdf$TWjODhHAX%fL?=C|0{Q7R^fk1dR^lc
zGrvK|8lRfNh6EBav$&k9P@{hX<ZuO}PNqZx&`5u<QTdfsR-#e}noB{`&>hvlXV0)8
z`6j99`0<0}@#DuAa|D8v*l&T95h~U^JX|fa%o(hb9iWnZHMR&EVE}?v-4aZYt@ZVr
zs;V#b=tQZShKF_YD}Bi+l-EIJ;Gp^sirj=U;QfRx4p3qFxgis64MBBELQpJK-B86`
zSpuLgjt*5}(Q2ORK6)@3a>Z!VQ~el3X_@!{^cuMHY1?}AbK^bMA~96kqy%ZHg`Z~o
z9y4?mlMCChx5aL{bfV%a2PNELn%@dhx_cJ~arM|FYL3Z#|6V#<m9~;bhVnUFS449S
z0X}keeSIBL=ojBjnrsMZ{MZ!a@7}!)MU#l(bD(&^Kf{hYiVsbj*5qVlNqim3>7kt2
zWP?eQn7wuMJRraT;JfKDu5vj{iUoP0knDR~)qpGw7~DUqMtDDedJ!yHyv%8JW5c70
zTy`0QjsLu}vvUDtSJ2+wN>a~6As#kZM^5p`0bcjCq@Jz_?*?5*5KmMUAe&J>?cC?M
z5GcuVT2xTJ2sf2!L}i8?8CV*5CUimKu;EtoVX$0TXHc#0)@cv8C|tyU4wg8Y24<Na
zgDx!pLwJ&^3VM+lXq3T<sCLoP&I?bnM7JQ30(}zE>3Jw*1h=A<jA$CTX?hV_$uOCK
zhyGI^LCYg79Av#sA9ZqjAg{sz&di_Ko^ba9D-flB?`uD<#qZukFRG%xhOo1-)q%us
z7S9b`Q|O95#*J10a7^DY`Hf^fxQqlNz}}78-@l-MZe_H${aBQl#SfiG66ow51^HoN
zL|AD!lWUU7U{)+S_|W4mW5R;oKmGKj5%j1$I)7Po@6Jb{?}r*u3pJV|h6ljC!cld-
z1s^?_fF9(4Vg>~bYK+P_kQK2!L`w#$sDR$03T@a@&O$HZa4bqPIcKL7#(KHd4+n~&
z6#BibwUt9xJGkW?tX}jLLj>Dbs{~<Us_P`n(xuZVOgEYSs7n+O7&_{*jCp*}w#M(i
zgPrpT%f`m{<;$3oXTeH@@YqD!j1i);_IK})8_vP0x|NteUeo9`eSIdiIg{S^NmC$A
zjx6no@w%2Q?u!I`S676T)Ghy)mEU0L?O@N|+7l8npQypZU5rbY)-Sh*(?~tTmHP2I
zuomwhaoi-dy%uk+QxZd8-=Lk^U>uWTf?Ww=%Ql(bKMYHwV&X|z9U}N_OBBvTCTL5D
zjW?S@M~VA8k0_iL$7$|`2MKaCdV-Pa!|i=vp4^m}8u@I6Q+47!zDz`jsiS+R*O`U?
z3Ye2gPWuhS%oO9~fU1iZ5plsS+YlzN!q+Gz6|t`?D7u$Q+1LL1;y2Ao=ZQV*e2nq&
zy5qlfah!EK%ThKUU6=pv`c1d_vC7GiO=aG}c?GI{SGj=wM1aWbHymjHR6P0;(y|4v
z5Pd~p6>;79NbUVboG43Aw>^nY{0zPYa&%N|Xv!c?c(lj5_CpvN$l=ohk(78`r9@1p
z1vY6N2Yzw}5-~4AohtmTWzLRVWh{%)nz5q$DcHCqXKDxgk-vvwDR)?MUZVT``%$E*
zuc_g<G@mCu9T7He=-Ynx?FM^?SoXTNw|uLs@%?FNWFKFpNaO%J<HwsB#@d?*^L<4{
zzCmHX%J?FYz~+FkjP~NpU|c{x53lpp0*h!@@5w-F(l4cWpY*A!BYj;*K3^$t$#?Z$
zO_`hLlt0|5yDu3sDj?8U^^KH4u~&kF3bIhElIxw%S{|T_%iUgy*Y$^XZ`H?7cm&ZZ
z#aUYNy>!39KSHlsQEw%j#^_0NPj1~ig}N6PSe7zBgpJhE(+MGV)fc_rXNEWu7TM6O
z%_P+o8cV6f%-!}}%=7PD{!I`ZdZxB^4f8>*L{J!~6v*NLV>U}>FVH~2;>Z&FE{6LR
zmw1U5Nu~-xoFdMvWKoxk(J?IUJ&fWU`$D|874G6NN}Th+mbjmLKG&zZ3gOI6Z!7m<
zvUkExe$)2F%Pgn;_}CQsz~P^{l-yHSPLdfs-N!`6hX;1ySNK;M>*yclAgprn`ul{>
zUC+sI^N3JWHq>V<{gE+k?dTwdPzmuN5siKPax>!aLB>Chtb+!sI0SVb0hH@up~g{;
zHrn!|2Or_a8B@q#X=H02i_-R)OVMu2Qy$K~uD9b&qv&Cp*!xs+S%UVHb@2INbpwq}
zL&P`J=W64uVd~`0??F?w`>sYJ-nIKT9!pe&<U~H|?#<<LKiIumyb*$GeiV-=p_%Dk
zW9m1L!;xn?>_No*78kkL<n2E{Y53FEYa|m!VXF2@?I+8=0)L8$csIkHHl<rC?kb5r
ze6Gy~o<92?B7a2EBdr<O-m@Fchh*Y!kbE2Y>M?H9W@`~l3<|kS96^w8>J!&FLldrc
zf3q6g53(uJPd_YB7yA&ylr%qWb1xPVTRQ$~{V3)m?6XAsndnNf%Gz#O?Gw8L@pd~&
zre>ok!-3Sc){l%VcK}&s;z&FYA_HU7XRoUDo2qs;dEG}Xj=VQr!W|egJ^tSOgGFEc
z<Xow0DT4T=_|2((pflmutSL&5NiUFemt<3r-mMr`9xivUaZHcRc(U1jw`%4@D`nCu
zg4QE_hgs+%<x1qr+@o45&zBO7Uwjn0V#GT0rqndfe8x@<@`@aNeEh!8TuKJCaf(N>
zW=zOgm9uO6`<;ct?mQ_b5;u!!fAD_l5pmjBR$VC4WzfMu68|U-7cP?JXB_`Iu>bN@
z*4ETEOOT@>d!nn*S&p93o!Ys#Jc+<AqCd3zP`3Vi6M^?9Zw-4J46`aRR()}8mM;c9
ziH}^bpJcCSXh>7LAD3Q=`4u~^-@{a@^4PF-{L0?ZcIQ(^Jdz8s-wn)d@w7R$pXFaH
zQbkcwGw~^Mw78@1YI|ti^4l!kN6M#cpmKa|yB_}!ZNNOw-DaPPzaQ%KM7?0oYbuWz
zkhHsbLKTyW9v4YTL<2rOtypLsIa`8fcf7~mo1z<L$#WkIftjxz`|Wm@+*4ojw7x`d
zLr?yOJ|ZpeW@GQ0#5W<rKAvYudr5;|lRtNVyuBte$#>v6inqG#L1tU^C(X|T>)A->
zxDV;%mjfa8&nX67Pi5kv6(N{Ip!f||LP}!f$mp)DR0%Tl+LK88@NwgZeD6@s6BnG+
zoxO8yw_Z&iwvE!M&a`&LQCGVNjtp#*(&pI(yis>CTH$o;{#N{ah2BNZ#VI$*rL6S+
zGl{vSKANCUOg|Y0y)ADDYSMb{ESTFDJVB7(`C3fHe|~U$VF)@F4baZf))=znTPW|r
zLPQ3y8yn|Gw8R$`ih35`T;=4uM!~upDTB3(yO;I@4_EgNl&t}riv$K4>sF7CNy&aP
zj<shA*gM+)VtDo4Bw@&zpR|d-A*WW&&_4F7`zxCK$RMo@Su0r%u($5d?hlo01o%eX
zYDbS4P=jj0i*`+3r-n-W6>)UyD;!x?Zr9a+$2xxWcT;C@<bzk?a&Q?P1~T`c@>a?u
z996!fOhmP!*L5hKDR%d(^`QQ(FG6%4qa#FebaK_O^)hIXC1@8yQi5;z^_FPO66ki)
z{<a{OU8Rfopn2cW&Ng2?5nWH+MJF6)X^pO4=BoY4q&>%mRJTBn!@pf*aH6q4-dOoZ
zA?-&n{ikM+Qu1_u^8a*l#7}+HRXCez{vJyz#UQEv$5#@|#DhF)Z+L@zTOX1qIU@8-
z-eUUH7t^ay@KH%vCbxI9*2@r$$K`6w-g~&W-WpXgx!93+3-*|v)*b(>Ub64a2s}fn
zdW;us8{RK_l5;NbUE|X)C&(sf>|I`&BSp$$-7k$=yQr+Dy*4f}YLo9&lFL8Y`8Iv{
zYQ61+e%ELBUq<;Cil84w#zX<$+Iel>*U_b8yeWeYr{=gmj%m#(k7|46FK0_ayz$ub
zM8w5Q@lu?Y7{Pg(VsFGZv1>#g(RYl9Ce8j)uhREZ%=lKA)Vx7IN>QHC?>^W^S>GTj
zcbq)Cw<_!-2XU|F?f9%^k>K2+mws}kBk3XDsvKRu(Cw7_CiCbE|4gt&=!Z;rb3`B2
z->4k<T7QY`X)`n-<_P54Pc=~}Jr*ceecG=zV5C;58SF`(O=N6qRq}Pcf3hD8lu^Ph
z_}BV}?!(HFisy`?Bae@SAP7;HyRbzzGd5Q@@2=hMr`ntODcsn52=9b?U_dhQ*O|2+
z^741<^80)m3x?~*=9fa0xn$3~{Z065j6QQ~Yc(WSLA`MONOpKKDXg*YzKH@l)ia69
z^ip6lOI{v4dV|Nbo)X(%lSoDblB(%QbtMC`-d$GmvAhnGaL!(&IWIzZa=baZx7H9u
z-EYtAe*<T7qB@Ma!um2oapps<AOpl(dx`O?mFt(ZFD)@uF+s?9|9J70R;bqAMg&jy
zYLGWf`d3{lujj6PRq3j@{0k)5aNhRsm-9EG)>{8^BEAgjE(Xm#RpOC7Z*nGw%~lsq
zFvuSnp}U%G62qp@l%w;nwyLj<jhQm005}ty1)YVne;CDnxQD*)Ns1qk?Ydna=Rl+|
zuaGsXMh4*ccGmJD*QcRcOoB7CYS#GH<%WreBa<FwnHA4-NFOQp<vq4cvQ_z4LzSu!
zEDVP*N-vkNm=k#(9v>z-3}$ViM<vmtHnT{4NjUM?{I9C0C7a2T*(J@f9(BLlVH=FK
zPj1mON!CpK*_a}*UuUtO!Y^>)v7ZSSku`~g>x0`}NewhT)^Afdq|7c5V&h_F$YMO(
z9(`Exdu0@llnM7^>LF2f&xC8S+4N{&0`+<dj~;eW(MHY89DX=G!BuVC%jc#?DbtHU
z8<t_?MI>gQQ~A<fYgmn9!a6y^I@(Ecr57i(5nAH5G41$HVDSq#OTYGLQSlz`w{J4K
zTv|wp6^0fUIn5P!tiDe;-|GD&k6V~jLzGa;rp$e8ekfXOj#VEtE8%l+PNM+PsG;9m
z;53+fz<jyI;>WYvT5A71d<+aJPqDG-xRa8zmwZ=-{eFG$WAed1-p&uTJgck#oPlDx
zQPj7wpcL<TlPPWGgmR2gOk=P7$&<S8v2`_GEY$Ni?sE&Nz4SOLqn_XjWea)mI$C*8
zbYLKT_VK91*zV}<`+5qO<8Xo`5fFpse%?M}q*N=~2tiw!D3rb9SdjOb7_%K1AMS;a
ztM!`jchlhpm%DXpSDedwhzAVCVw7=in9iaPRC&Ca_V1ED+;R^5T_4ECX7RQbF1k}%
z|3>1kQrygErsBaQB{k|Wx+!Ewd8;H(E5zAp9@Et|xZG1g0Z0F#%9k$_AFS6)h1vND
zAyrHFPuwP7%hNWpa9&hnzIJWbb+)7K<&`?nxOH_!zw(=Vj}<$woHJa_E0wu#s1~1a
zsnnEcty@k?k+8t<)`&H~K%>>j=4@lZ%He8Q8YL|U=5!km-AL2P5njTzJMGOLtKxj>
zYsX#&zu3nPSN-n1@~u6_OnyVcbLb|T>z|kBCp>!9%T2~K0$?)B-i!{ZulHjVmsuTZ
z2$8DwPB*_QrW24SJVNfc8-MkRm+q)1>$kJa3vMHybba&fjwgS;$KcY&)c3?_Prl-Q
z;P6rV(l`CT2kE=~=3(i{qJda=w7pG>eSU764uhLEdkm6{uJacu6sdS{CH5N%iZBYt
zCfAMEA-x{_+CP9X_+@%0@=W6CvZN=PB1-pg-FMFUExgi)ud*EVt^3KT`DFr<HH#a%
zmWso!hi;CZU{X*_>^4XFwY|EXPs5C<Huz;f|H|c~X?iApY>i^st@sF<*h8%jtBG<)
z$9nxp46Fw7)q&!JQja!DpxNhM*3SNFyp3J!hjqJ}$%nXwg#PGc?bg^x_0TNj*!ozw
z)M}*4ZfKUzk)nxPmtTX)D2~ak(?WOb&|;F_yu74Ycz?KZb%Dt>lAa=Jwr#MAhMF&Z
zZBdnDtm^^=^+S~ga-J81j;@PpE9KeQb?2W{>Oq;%-p%WfmJ+#jtFhDH{jy`Ewsu%2
z7l$IY=`EW97RppHcWj+%4vDDo`o^w}NCqQ)DHdaN3O}P@3Z0U8xFncj;$aeYKiLYk
zwxcAsMk`E@Jqwx9CLUyGiNeqE$hA8O`VNk*YmT*k#|e-rb5rF8nHCK(C#0l!99Mf7
zMF&Y^K>Mlv4NuQ4YrDuwm#~_SR>iBN<xh#^l?26*nggqm*<$lBz1CYn4MX)~2KBA1
z9M%vmWex-?AJx&&7}aRcb~L6QwsOK33JHhr^DCY<^4bl4F=8Ble^*LAxc{f=+St+H
z=VVdVl`}DkSNttKtEfZo-Z^`#Mbwcz!lik7V|<2PO$5t`30@8r5%|LgaHNbA_-+lk
zbMYyET=44sV#_l0BawAx&&@3)rIud!@f1(K`_m`)ta7Nixm${FH665QzR~Fy5*Zk%
zdvjxAcf$SNc3iQrk+k%{OF7ju=xhT8DiI57PXFfBS}LEF@3HCT9bMxcv)`wUtSOPb
zB>_IcWY$YZ=bWs+goht(5@7Ic4VD$|d3C1vFAh}?76{GQ&=otHf6ZV0bJ3k$SJw}h
zgqX9Emx?<$^|>wOUDXjZ^eQ$jVKO7(3`9q3&*q{zTNip*63z?Sbw04Gx*()}@6Op=
z3&-C%7rhxJl22Znw)rLr6LH)9&Khz|VNyHZH!r*vej$*IDoiYr32$e$^YFD6$yKeF
z+W9p^Mx+d9!n6q;CIU2Qh=c!<g>cZKk?K1*2K_a~EtBo}hikSSYzhIN8E!OmeSE8(
za?WhsXx*_saEMD8Zb@|Yiw%W#y5~Ah!IO;s_h#SEq*?d*w;j};ob}_sPK!_6KHPQi
zcehce{@xp6Ywb7J>uOK9yjMr{1Ezi?H6Armay5vx`1%epXGN7*H_rUNdDDoZeQBVs
zC0c5+mqk_5^YRW=GGBecmosr7BT^{OCron~2n#=19fJ6g<+fTq6p_ZGLyob$Wm!n^
z`GN;R`N91D6PJkE<1>yJl7CfgwyJEC@Z~|r!DF78@;a%eW|43g^wAU&N)NK#vfvv^
zI-5>U@B5s{Z|28syOaxN9p_xw5{2($ck|ScH|Kry_4#{;Sf9>;>cz@%qkqz5^JZzL
z`%?;j^G-@z_8hdaQzr9LEZbz>{YU@$j>z84Ti8T=r~>Ds#s&9|6b9MlpEwC(<u-OW
z>d7DO`xWr=nP_DMY6u#cW{#FTd17QIj)&K+{o%pOPh47g{XV>W%1fPnpDpKC`aDi*
zEGGXR8j+eU|B<S8ccZF&DPwtZJpKLUpxJjY3weFCn5>CcM{j9q6fD4swYDSVNhZ!u
z`tbPGFBp>zV_L{h$B<%3c79iAzr)ILB|;V}LN>$Wlef1iDGjuKQYa7bx7}uzG3A0E
zZ&1us*<IT)E8{(nzM3ig`UQR+^aG};WIIJcDau$l1VwLEJ&s0lUS&&YyZ8#yc>j+y
za}+z{n0Ame(ceKkWZ}>Uxz9uewcS=G5b+X;Q5XvS3L+jmDjjA`fHD}}4JrY}qpKho
z@T1yIdZ_ttTLXs`>E=pqjrYm5l@zP8@~4ua2|WnDAYUSNaHj0{Z&heaHWq$%DiTJo
zgNXS*SC4ZH(6?za{qK6NJ2%i-(=bu_k)JkYv+$F^tW__dvsS``S;yUgSwTxN%z7H7
zcr9BnYvpqE1^MryL%C0fQlUdpWtZg_T68k~XDBEl%892#(SCJRc64a_>0MD5gAO)?
zEnVgGyd-)a%@bv2P)S}9)k9l6;ri&Wrx&3rD9!1?BlO^DMBu=KRr^VVZr?Pzs*PxT
zgO7%gkSuxhPH|Bse4Kq&CGzs}zR>Ki#4cd=umvBq187*c>itMio_xY%6pG%S<5C80
z9sH03DD#r+|49TE4?_281B83k%jXao#Qw<>KJ*^YC<tGRJw2g+F^}rnIYZF$?ilE$
zs{;?`q7FK_`_H7BL)1@Ou4PPUU{d&~3KV@2)yUCxLVp9tWE_3^)hK0H{zSrmS*2QT
zME~nhR8Tib?8lPFX8t#$EC~2}g$5muF1D|z<BSwk?irzA(DYaZK5}DaDYBu*WXFUy
z6Fey284G7fqkBsMAIe?DhetzGo3C5udrUq)DR=jk!gp+AYvV<^ljFDGXE%r|**SBU
z7A}RMT91q<HG(0PhkLxu1ER6(u5Q|GqBQgS%%U`VvrGov=|#DVO(X_i{U<ux+OaF1
z!ta0J*w|2GLfarrZccMX5|5W%c56ud{#*E|fo)FX7V^5U7{Os!^bC!K`aU>6e{Q5u
zF_D#3hB>Cj#o-K9;{E<eAm*b#_~E{zesSTIvg40e>ki5#pU0i&b>SYH#QL54Vf2uh
z16@7}@y;qN10~`Iwcg|Ta&lBmm>KCZ{deSBNPLj4>dL*u7tH<!`FchcBK&9eb_R#~
z)blWfY><WD7)Hi^b~PAUrMRE93?^jwJeO9<hN=jXMPo}>UY<+y@#+30Y<_Q~Z_0uB
zvOMw4vvK6;)6O@*)9!VSn&%=X=I-B(jxpHpahI8|xxL~Jc{`f(h)D7hJ8pl;ovnuD
z5t6Igu=W<0*Lu|J8pC|6#qD>l@|qFbk7E|N3E1!R+fNf3SQD9;&n`2BN8lW6W0`ee
z<B|y-Ri8co46H1e(0BxcH^@gkO(AxJv(~VF$guzY-NpyJ%<iPNw(#Y+V`sGkPL~C=
z@SeTZ2Dxon+@lpy0s^V#$ht4K@Y5sHeUFPYP_tKk*-C-j$*_FLCzh0~<H}=jFBq$#
z%f|W3o^I~>`bw|EnVOMOyW@S&PDe*9t3F)k6%*tgKUBtKWE#gg#&Ag*>{rU3xRv^d
zI<S>~$ma#|AJX**T8#WE7Df`f(2<%?x{W$tlMma>%){#NgU2U^D?#{geDS2?NxBMZ
zhb&&IkqGrB+1l=Cc~pWAai#a6b9dY9B2m>5KXm!lnWtjhyLVf^uST5LTdb=}v?~Lz
zt0)uS3E_2khaZT6F;T*PccVk$b0J2}iJr~w#!4lQ-R94VlFL{~Rh6&0{<S5q=-X)6
zVDb76ZG7R6;J0}Kp(gmxrx@cnFB>_=%ri4Fc2}{kSxt>DWL^e#B78p^J4f~V;h)$`
z>Fw!X{0bjr9v{A9efU@#t*8WV@RzQxhnkHzB7gthZsA;(@D)u?ZU{BFrKuSr>V@;f
z{_@eabbd7Q%LMYTBKXvd8^IiCRf>fpq?HfvMGGbx$dwf!I-N?xEF2^dodi%XmdP|d
zc0}4x;g9sMBYtU5sUcS>DvxbhcafzK-X9kAOT|ln<8tHUeEECn!I_euM8?{YjsB5D
z#5FtPu|Xo_UWhuQ&ez!XOKbTHQC}nQGIES5O6yo-Pw#H(hq31KoA%ns@HY33&LGw$
zx=W}qHlQL@gMWe<OL|vY{uQ~BkK1*G;=PK%R#~S#%^k)2(pqM(zxKTezYzkWU&~Lk
zulb=&AE$dYJRWmV(rfzyr+=&dS8uvY>z{m7RSjZ-iFNUMlZ)M$>d=*=4~ss$g+FBa
zH3u;em227k_TE^>6`QZ3wKX01TX=Wl%3brPJ=Pr7F_9y$RXeA@UpPmG|8lP=RbzQr
zd$5+qz(@A5GNvII<aN;2(HNqAX>GORq$%84V591N!9xSH%0$<#Ddn0){$hc`-9LId
zcWMGFK0WO&y{WHj@2O^F#j+!}DmO7H^IPS&^eC<u5xx7}Hu?Im3D1J>MFu{Lz<RA_
z7s@=!tnodM(AFb|{k+f60ag!v?%N3UB+O3B*<Yl~o`0rAd*8XARq}koGQ*S<MHE7{
z7PAXo0XLgY!=UL88!Q7*<xtIJPB|aXW@>-6VBLHu)naahe0af`^UFsr3hgnA$zTOr
z_VezMxzDUqW-Svf=gKl!KZ%uL3gZb6DV9H{OyRP(n#vZdwnSy%A-^XD(SvEuaevCz
z=WxyF6aA{6?M|FeRd<?w-V~I667~1V>bm&vr@2H5G4^+!5{2F1Y8u*cB(nL1N=JWo
z`qF-8*}Kk-8;#CxI{dM;Hnm<WQH2kN;EO0RkgbM5=naeH`IbHz7AnT$E-iSJOIfYC
zRUY7ozeOAnYs<HL?9~+6!jQ1pN}o*ccE%x*UQ*{6!*11;PG5hIc2X<q?DU9eP`8Ji
zvFqlz#^xVdk$#b}?pV3Gzg~942X5q#m8vjqSl<{f1m)$4O+TNYy&Zy-9qw_jh}Wna
z{5=sn!V~|p?fdgy$S>CW85NFCs|QID%|BOd%FA%{xb-abGRklEsWhUnnZ9B4Ww36q
z;s6tw;uode6RP_-Ud-z<r9(W&k3ea==33)oBUdjf6}p>U&$&TEnFiu+{m+g&7hZ)#
z**}=Px#qmyA)s#Gqo4brr;wv}SBngf?unhDI-dH+xf)CmANRHo@{tB|Cl&WIa5kUF
z2YFCmj{CaDB0hg*lVEmzW9HSkdLx++@k#yI8Xh9x{l>3tmuIqAU6RuwI5GS*Ft^4I
z>>x99qvev$41>>EeHd=$2Idtk_HzsRycMk|nGcLA_0(C~7OhW(BEho-TX;k6qiHaG
zX|T@WO@Y$Ry2cJ1&Rgiu-XOl%1o!z<5d>6Zj9^B2(D~6KgH82^iTj4b<xl6PM~Oza
z4&Tevm!<}Khd%Pj`xbNWP8UyF>es%9`)F)U-!R+3DDYlBaLqsQ=-=Cv4bUf%+oXDJ
zteUD^=6DjR*M}CC9x9)OooG&TXRxK;WQc8>YUwpwOv$}w)!$-kFSg@a<LL2w+3$7e
zYs9yiCTiSj^)=4}$|=y)P!+o*uH??S;~L__GY@^<gl5}*h_{fu3E3=)EfnypEAh{{
zy>$zge+o6QHJ`ho-$f2?b<;Ax;qBX?P_g`qhfjy@S4M$G9X1@93B`)N%U-<W|E-<#
z{Awy&!+7Ws=`|=_0THgD2_q$-fQl%HARui3L6j!FPXHUeSZIzCnlvc_V(7t0009X_
z1f@qHfb>v80^#m3_s*I>;C{THlC{n{XYI4sd)~eG^FHryiWw9q5DT=piRImG0y^ZN
zl?vnkja4D6tdFW$3OjtZSx*p`WAeOhKiQ9%0p)<UWomRxt!84XLh*CjI=;9pAj*S4
zX%~aVBrYXJRJwW8_)1cuK6?FfKx<+7us*Z2G->=Vn<9mim&tPkjj%LoWcdO2@i4E}
z_&&kRu#i%R;k|%axx^7w#)rqb+n)?;%m;Gb6s0He(#v-ynd(R*Cgbla)6xWI_GjsX
zxE%ScB3J|zpvZN<Ix>+inhrnq_zFL~rt6f_#(zHcKSF%By<`L4kfY^xdry$+`XuHc
zVHguG*4_B84&w><`R8vw4i&tmkA__Q>(W{|Apyxrna0_`ofoG|K-$gCz!b}E2Ax_e
zTVj7zr14?M8YC>GJCiVwYpW==LytfFTzXvttM-T5iP_Psel1Wcc*pU@0DXIO18cL!
zX|2P#>j#?oMMNw!g#2~wJX(D`z@Ii|H`WI)mI$J?4CZVUHfwVRjxRd*uNwlrw|J$l
zcI;U5Ubxe}z8eomtwFd%CX@MZ@1)?OP^>fZHTuh3*GEo6AeMd#qI<*V6UTLhB=$BK
z+9gD}A>hKh^{u4G>AIReYGBEL)dmYxzws;!_2Q)0=tv;6pO$<v0G}L!Jo_-BGID1w
zm?P@qVZLvdeD0TCbS(Ox>-G8Ji#o9vS}9S^_(3;`R^s>{5yJmjBlk<Uj@qp`6;to+
z_$tf_z4ClLmA@HXQ|=#4lqr(?35o+g)qxkphBebDLSAonsTt__yT`%C&1_eB_MknJ
zv1XaU^LjZ$o}7VjJsyR%G|Mv-JNwEb=ZSyPfErwaTaG*Aw@`s_hnpRxEEBTHr-kXE
zpdwqt83pMIz^#Dxcu5t$%U7AR5iGzV@lu^d^yoatSQQg_!#L-6UB{&nKaU%6%cE>%
zwm_R?iAarPu4@|@h?>7U^^r+0pTYer59+BsZB%Mdm7btGM|w0N=`oGL(LkP99*vIS
zCbiu0;tcr3di6DX!1BxRy}4^sYfiwtnpt3rHlRlQ(OuXS3w3ORPOW01mxw~P3IeUv
zRi*@CCN3^l^WR+$r?fB%xQXRV;~km`PVzd0?XVux5NbvO?psGP17=TJoQ(^j6Mn1_
z*Y3Mh0gX;N7AKCesf|kH;Dx4$F##SzU4T)92}_w#)#2vR<unX(Ag5`=-0;<6-G5NF
zbx`#nRL%s#FUPn*SyeG#Xd>sqj#Zkqs(pUQX6OR|P|SM9oS*S@-AvjX3nA<NY>!*p
z+30S~)^V;wONwbia&w(0Y@JRXfpW9)@j<w`b6mTz-QBrE@#62vA<8io_sny`wg{v9
zGja1t##b0iEf^NR^6L0K>Fi}yIS5v83D*%4YpfTf+2FJF{#0*W7}T?dF-aco#0opW
z3LT)fM)qAN8u3jL7|Fs_4l@HXK!wJwqL4Nb*8V<_hzNG%@{Exq*#|V+kKINfS|bmR
zzW1<NJBy0sVrEOo9TEk6#-fyvFZofpPwr=x!qwNdhMk{w)!5WB1}!r-HN_((AU?D4
z(0f1x&oj&ud*e#Q*a|c@q_-&gAMTqAI~AE6ecoBSIL6M;WA&$|KM{&hDA<HzNrEuW
zeagy#fwp?k)-{4c0#TFaQ(k|+-ViY;Bukysy8gyyQ<BJuFq*|_-|?04R$!W__jmR+
z<Vw5p=(B>A0el(=#QPLIziR9Hrbx^@ui_a%$<gWqVt(&LH499=Y-Uxbqr^OK2mkRr
zv$ZkZU1U($1;*2hOr~8^RdUZ}w`6Hb=yvm}@_Kx9QLV?IN5-~5sKs9LjDvu#?FU8s
z#$*ZnB<P`h2~7i<`Xut`)$CW)AC;K+HLKcEm?cs@r#Djy`<=EA1V`(vSGN}}cxhm2
zfD)^Z!Cx^I)<GG5Zx9Sw)v0O)PH;d#y0V>}0cWeOHb`+XAzPek3*S=DFU#-03pjWI
z_#yYelCHnPMOGt-=}Mlt+&bxE0q1taG6#xst9bC#&eMQl_ED>bDO`oAvU_&v$i}nh
zIMd*rf!eo0UXBw@O&y+IhJB1cVDF;-D7{G_R=e(o%XxW54IMN#uYT~V?~p(UOtbTR
z!r)_c^&V-;6=6q3L=~Tuczos2|0V;Dib|0PCAVZ~N%%J8iVR(~^Y42F%(aIsnTa=7
zE2n+s$#Wd^6JVBX4M)_uCnn}U$L?=ipUr2lrlDh}m+l8yD}NU(Z`8)knBHJt5>tf3
zTTVR~C4tD*eg4cZ#np`|a!(3*f83^Ndn!6)3<DQ8F_FHG>tIR|kMlQ02_02uWNZ^U
z`=ql+;8PR$ph0cNtrzCdPC`<QdNjt~AIVfP++=OpS6A|JT*31B)B6>REl!W0Kp<Ky
zW^2oq<5Q>_uJn)Yxl6i!>$zi?%;<Y>#hq|2R%I{ESe6~a<8KbWoyVdA8Jx-_&yhB=
zIq%8<D(c4$e{}<-I**JT(OZTeW*zZeUf$UZ2Xx&~lVY{DZ{^Y<-%4e$#2OO2@nVw3
z1_Gt5&v9*aL}~@Gv6PCIuc@hdXfHB}ee@9=S+AzuV$*|!R3)$uTIygsevb2mbuxH0
zhzQXjIk!}Oi7D^iZFmqt7F{=&WkOJ(sltQ8wn7T-jR6c5_WZ%DSqQO_ce&&+&e;X|
zxl<-6u03-8E;F#sNE<tYO^)K`JiXlEy%4nRxnRlot9#sjX{V?kQi<VG^DLeWJQuz<
zUgs3@8i{l+{@`IXl>l#RjzD|LBS(+x50xt*Wlz5Fst0%r3-z8bF3D6a;_4eKlp|&F
z5>(4O!_6cI0TQ}qun>mWb6cScoC<}@)ym2Nehs&(yI*h+xcnpTv5ZwEV+Q=VLnT^c
zjff)X+@IuX+DflWvc1*dbAIouo5Te$*wT<YVh}j0_Djvw&o|<x%3eeH5l8hmt9<h_
z`GYC%M=)oUtENaavi{ftVXS@t9Z3mTS3POq$z+~dWQuc660NAHr*0*|q~=%=@Uu5J
zR|MNX>3iNH5fYpkF0D>Te_ixApkXzp5doJyy_jNsjKDh;c9g|Lq04z}o3*uwa5odj
zUTiAj#Acm6v`t-+jhk_w5{C+0jLjWrPr^xq!h<0>AyI&+rIpdLuM;-oojZ`r1pHUd
z{P*14sw8KzEd8LzHwqQm+w8sT$IFgK3BQew;p`rVQdTjB#Z;1MPACccD<}}OISMBH
z1`3@Hf1C~G#t<SlpF)F|e=xwCBrO#t8|A!>GHQyPhbsu%VPKFhVLd7kaosaWb@y_4
zpN}0iQcBlk1{=q$9C#TP^HbW^=4tzcr=PxAZgTZznvuQ6Ichz#V9EAPFaY6M?{spN
zS-GZt_xgl~on0I4k8|h;ptpBy*hR(nTCF>7xcqwTwVcTa)nL_m{h0WcVYuWrxiQ$3
zxikL~sby}KB~bz{^g!Uf3>VPAL{L|s#W%Vc?3(>8QGc#)juF3u7s_?RUP`$>idj1n
zo`L^CK%>NbsSTW1?B=MqOw7r+(4e?D=VZHD_dJch35Np}jzChO_1M!i8OuQmWo}}t
zK*=;aHXD5@#lYvSdC^ojTLxI*aXODAw0W8fYCVW&ApMt&4rqcOUyK4W9**9Z04Alq
zEmq1@Umy_f_+O>^?~8uWk;&hg8}e3Gsfv&3Uf0;zQ!%$#^`fGa!QbM7p0MLE5OmTi
zqCf=%ZNQHYdwT&i`;Hb{YO(gLVlusl)%yt0q78a?(7YO2%J+b{%5r&slFuKQu}`2M
zfnv%DK#TxDgpn^w=ja#dJOluB2HiB0&le&!vfTbcID>4H9ezEH0h#TZfO7jzAl~}W
zMIZs_;9oY{J0j=`KVaWI9c6b0ASSG`Ud$2**aOKIQvbN&3N^HvSm|TO3>c??_zmF3
zopIagN&EqTw3qm)m?4#a`ABgSe*gehzPsBm4UGFDjq+)Xy7+1wzQ%K%q-eXR-Hp1c
z;=Ge^NUFY2BKza{ZdlNR3cKF#Q1DDa9C!$rn%L9gjrR24|Kr5}#|ZU3U85d+Cv*D!
RQh=I=7#W%vR9tX;@NW~Cpx*!h

diff --git a/lib/matplotlib/tests/test_widgets.py b/lib/matplotlib/tests/test_widgets.py
index 1ecb4b9a1df7..3e41712ba530 100644
--- a/lib/matplotlib/tests/test_widgets.py
+++ b/lib/matplotlib/tests/test_widgets.py
@@ -7,8 +7,6 @@
 import matplotlib.colors as mcolors
 import matplotlib.widgets as widgets
 import matplotlib.pyplot as plt
-from matplotlib.patches import Rectangle
-from matplotlib.lines import Line2D
 from matplotlib.testing.decorators import check_figures_equal, image_comparison
 from matplotlib.testing.widgets import (click_and_drag, do_event, get_ax,
                                         mock_event, noop)
@@ -1055,16 +1053,10 @@ def test_check_radio_buttons_image():
 
     rax1 = fig.add_axes((0.05, 0.7, 0.2, 0.15))
     rb1 = widgets.RadioButtons(rax1, ('Radio 1', 'Radio 2', 'Radio 3'))
-    with pytest.warns(DeprecationWarning,
-                      match='The circles attribute was deprecated'):
-        rb1.circles  # Trigger the old-style elliptic radiobuttons.
 
     rax2 = fig.add_axes((0.05, 0.5, 0.2, 0.15))
     cb1 = widgets.CheckButtons(rax2, ('Check 1', 'Check 2', 'Check 3'),
                                (False, True, True))
-    with pytest.warns(DeprecationWarning,
-                      match='The rectangles attribute was deprecated'):
-        cb1.rectangles  # Trigger old-style Rectangle check boxes
 
     rax3 = fig.add_axes((0.05, 0.3, 0.2, 0.15))
     rb3 = widgets.RadioButtons(
@@ -1164,57 +1156,6 @@ def test_check_button_props(fig_test, fig_ref):
     cb.set_check_props({**check_props, 's': (24 / 2)**2})
 
 
-@check_figures_equal(extensions=["png"])
-def test_check_buttons_rectangles(fig_test, fig_ref):
-    # Test should be removed once .rectangles is removed
-    cb = widgets.CheckButtons(fig_test.subplots(), ["", ""],
-                              [False, False])
-    with pytest.warns(DeprecationWarning,
-                      match='The rectangles attribute was deprecated'):
-        cb.rectangles
-    ax = fig_ref.add_subplot(xticks=[], yticks=[])
-    ys = [2/3, 1/3]
-    dy = 1/3
-    w, h = dy / 2, dy / 2
-    rectangles = [
-        Rectangle(xy=(0.05, ys[i] - h / 2), width=w, height=h,
-                  edgecolor="black",
-                  facecolor="none",
-                  transform=ax.transAxes
-                  )
-        for i, y in enumerate(ys)
-    ]
-    for rectangle in rectangles:
-        ax.add_patch(rectangle)
-
-
-@check_figures_equal(extensions=["png"])
-def test_check_buttons_lines(fig_test, fig_ref):
-    # Test should be removed once .lines is removed
-    cb = widgets.CheckButtons(fig_test.subplots(), ["", ""], [True, True])
-    with pytest.warns(DeprecationWarning,
-                      match='The lines attribute was deprecated'):
-        cb.lines
-    for rectangle in cb._rectangles:
-        rectangle.set_visible(False)
-    ax = fig_ref.add_subplot(xticks=[], yticks=[])
-    ys = [2/3, 1/3]
-    dy = 1/3
-    w, h = dy / 2, dy / 2
-    lineparams = {'color': 'k', 'linewidth': 1.25,
-                    'transform': ax.transAxes,
-                    'solid_capstyle': 'butt'}
-    for i, y in enumerate(ys):
-        x, y = 0.05, y - h / 2
-        l1 = Line2D([x, x + w], [y + h, y], **lineparams)
-        l2 = Line2D([x, x + w], [y, y + h], **lineparams)
-
-        l1.set_visible(True)
-        l2.set_visible(True)
-        ax.add_line(l1)
-        ax.add_line(l2)
-
-
 def test_slider_slidermin_slidermax_invalid():
     fig, ax = plt.subplots()
     # test min/max with floats
diff --git a/lib/matplotlib/widgets.py b/lib/matplotlib/widgets.py
index 0a31a9dd2529..f24be7904690 100644
--- a/lib/matplotlib/widgets.py
+++ b/lib/matplotlib/widgets.py
@@ -21,7 +21,7 @@
 from . import (_api, _docstring, backend_tools, cbook, collections, colors,
                text as mtext, ticker, transforms)
 from .lines import Line2D
-from .patches import Circle, Rectangle, Ellipse, Polygon
+from .patches import Rectangle, Ellipse, Polygon
 from .transforms import TransformedPatchPath, Affine2D
 
 
@@ -355,11 +355,10 @@ class Slider(SliderBase):
         Slider value.
     """
 
-    @_api.make_keyword_only("3.7", name="valinit")
-    def __init__(self, ax, label, valmin, valmax, valinit=0.5, valfmt=None,
+    def __init__(self, ax, label, valmin, valmax, *, valinit=0.5, valfmt=None,
                  closedmin=True, closedmax=True, slidermin=None,
                  slidermax=None, dragging=True, valstep=None,
-                 orientation='horizontal', *, initcolor='r',
+                 orientation='horizontal', initcolor='r',
                  track_color='lightgrey', handle_style=None, **kwargs):
         """
         Parameters
@@ -627,13 +626,13 @@ class RangeSlider(SliderBase):
         Slider value.
     """
 
-    @_api.make_keyword_only("3.7", name="valinit")
     def __init__(
         self,
         ax,
         label,
         valmin,
         valmax,
+        *,
         valinit=None,
         valfmt=None,
         closedmin=True,
@@ -1115,32 +1114,20 @@ def _clear(self, event):
             return
         self._background = self.canvas.copy_from_bbox(self.ax.bbox)
         self.ax.draw_artist(self._checks)
-        if hasattr(self, '_lines'):
-            for l1, l2 in self._lines:
-                self.ax.draw_artist(l1)
-                self.ax.draw_artist(l2)
 
     def _clicked(self, event):
         if self.ignore(event) or event.button != 1 or not self.ax.contains(event)[0]:
             return
         pclicked = self.ax.transAxes.inverted().transform((event.x, event.y))
         distances = {}
-        if hasattr(self, "_rectangles"):
-            for i, (p, t) in enumerate(zip(self._rectangles, self.labels)):
-                x0, y0 = p.get_xy()
-                if (t.get_window_extent().contains(event.x, event.y)
-                        or (x0 <= pclicked[0] <= x0 + p.get_width()
-                            and y0 <= pclicked[1] <= y0 + p.get_height())):
-                    distances[i] = np.linalg.norm(pclicked - p.get_center())
-        else:
-            _, frame_inds = self._frames.contains(event)
-            coords = self._frames.get_offset_transform().transform(
-                self._frames.get_offsets()
-            )
-            for i, t in enumerate(self.labels):
-                if (i in frame_inds["ind"]
-                        or t.get_window_extent().contains(event.x, event.y)):
-                    distances[i] = np.linalg.norm(pclicked - coords[i])
+        _, frame_inds = self._frames.contains(event)
+        coords = self._frames.get_offset_transform().transform(
+            self._frames.get_offsets()
+        )
+        for i, t in enumerate(self.labels):
+            if (i in frame_inds["ind"]
+                    or t.get_window_extent().contains(event.x, event.y)):
+                distances[i] = np.linalg.norm(pclicked - coords[i])
         if len(distances) > 0:
             closest = min(distances, key=distances.get)
             self.set_active(closest)
@@ -1227,20 +1214,11 @@ def set_active(self, index):
         )
         self._checks.set_facecolor(facecolors)
 
-        if hasattr(self, "_lines"):
-            l1, l2 = self._lines[index]
-            l1.set_visible(not l1.get_visible())
-            l2.set_visible(not l2.get_visible())
-
         if self.drawon:
             if self._useblit:
                 if self._background is not None:
                     self.canvas.restore_region(self._background)
                 self.ax.draw_artist(self._checks)
-                if hasattr(self, "_lines"):
-                    for l1, l2 in self._lines:
-                        self.ax.draw_artist(l1)
-                        self.ax.draw_artist(l2)
                 self.canvas.blit(self.ax.bbox)
             else:
                 self.canvas.draw()
@@ -1283,60 +1261,6 @@ def disconnect(self, cid):
         """Remove the observer with connection id *cid*."""
         self._observers.disconnect(cid)
 
-    @_api.deprecated("3.7",
-                     addendum="Any custom property styling may be lost.")
-    @property
-    def rectangles(self):
-        if not hasattr(self, "_rectangles"):
-            ys = np.linspace(1, 0, len(self.labels)+2)[1:-1]
-            dy = 1. / (len(self.labels) + 1)
-            w, h = dy / 2, dy / 2
-            rectangles = self._rectangles = [
-                Rectangle(xy=(0.05, ys[i] - h / 2), width=w, height=h,
-                          edgecolor="black",
-                          facecolor="none",
-                          transform=self.ax.transAxes
-                          )
-                for i, y in enumerate(ys)
-            ]
-            self._frames.set_visible(False)
-            for rectangle in rectangles:
-                self.ax.add_patch(rectangle)
-        if not hasattr(self, "_lines"):
-            with _api.suppress_matplotlib_deprecation_warning():
-                _ = self.lines
-        return self._rectangles
-
-    @_api.deprecated("3.7",
-                     addendum="Any custom property styling may be lost.")
-    @property
-    def lines(self):
-        if not hasattr(self, "_lines"):
-            ys = np.linspace(1, 0, len(self.labels)+2)[1:-1]
-            self._checks.set_visible(False)
-            dy = 1. / (len(self.labels) + 1)
-            w, h = dy / 2, dy / 2
-            self._lines = []
-            current_status = self.get_status()
-            lineparams = {'color': 'k', 'linewidth': 1.25,
-                          'transform': self.ax.transAxes,
-                          'solid_capstyle': 'butt',
-                          'animated': self._useblit}
-            for i, y in enumerate(ys):
-                x, y = 0.05, y - h / 2
-                l1 = Line2D([x, x + w], [y + h, y], **lineparams)
-                l2 = Line2D([x, x + w], [y, y + h], **lineparams)
-
-                l1.set_visible(current_status[i])
-                l2.set_visible(current_status[i])
-                self._lines.append((l1, l2))
-                self.ax.add_line(l1)
-                self.ax.add_line(l2)
-        if not hasattr(self, "_rectangles"):
-            with _api.suppress_matplotlib_deprecation_warning():
-                _ = self.rectangles
-        return self._lines
-
 
 class TextBox(AxesWidget):
     """
@@ -1361,8 +1285,7 @@ class TextBox(AxesWidget):
         The color of the text box when hovering.
     """
 
-    @_api.make_keyword_only("3.7", name="color")
-    def __init__(self, ax, label, initial='',
+    def __init__(self, ax, label, initial='', *,
                  color='.95', hovercolor='1', label_pad=.01,
                  textalignment="left"):
         """
@@ -1513,8 +1436,7 @@ def set_val(self, val):
             self._observers.process('change', self.text)
             self._observers.process('submit', self.text)
 
-    @_api.delete_parameter("3.7", "x")
-    def begin_typing(self, x=None):
+    def begin_typing(self):
         self.capturekeystrokes = True
         # Disable keypress shortcuts, which may otherwise cause the figure to
         # be saved, closed, etc., until the user stops typing.  The way to
@@ -1730,9 +1652,6 @@ def _clear(self, event):
             return
         self._background = self.canvas.copy_from_bbox(self.ax.bbox)
         self.ax.draw_artist(self._buttons)
-        if hasattr(self, "_circles"):
-            for circle in self._circles:
-                self.ax.draw_artist(circle)
 
     def _clicked(self, event):
         if self.ignore(event) or event.button != 1 or not self.ax.contains(event)[0]:
@@ -1742,16 +1661,10 @@ def _clicked(self, event):
         coords = self._buttons.get_offset_transform().transform(
             self._buttons.get_offsets())
         distances = {}
-        if hasattr(self, "_circles"):  # Remove once circles is removed.
-            for i, (p, t) in enumerate(zip(self._circles, self.labels)):
-                if (t.get_window_extent().contains(event.x, event.y)
-                        or np.linalg.norm(pclicked - p.center) < p.radius):
-                    distances[i] = np.linalg.norm(pclicked - p.center)
-        else:
-            for i, t in enumerate(self.labels):
-                if (i in inds["ind"]
-                        or t.get_window_extent().contains(event.x, event.y)):
-                    distances[i] = np.linalg.norm(pclicked - coords[i])
+        for i, t in enumerate(self.labels):
+            if (i in inds["ind"]
+                    or t.get_window_extent().contains(event.x, event.y)):
+                distances[i] = np.linalg.norm(pclicked - coords[i])
         if len(distances) > 0:
             closest = min(distances, key=distances.get)
             self.set_active(closest)
@@ -1824,19 +1737,12 @@ def set_active(self, index):
         button_facecolors[:] = colors.to_rgba("none")
         button_facecolors[index] = colors.to_rgba(self._active_colors[index])
         self._buttons.set_facecolor(button_facecolors)
-        if hasattr(self, "_circles"):  # Remove once circles is removed.
-            for i, p in enumerate(self._circles):
-                p.set_facecolor(self.activecolor if i == index else "none")
-                if self.drawon and self._useblit:
-                    self.ax.draw_artist(p)
+
         if self.drawon:
             if self._useblit:
                 if self._background is not None:
                     self.canvas.restore_region(self._background)
                 self.ax.draw_artist(self._buttons)
-                if hasattr(self, "_circles"):
-                    for p in self._circles:
-                        self.ax.draw_artist(p)
                 self.canvas.blit(self.ax.bbox)
             else:
                 self.canvas.draw()
@@ -1856,23 +1762,6 @@ def disconnect(self, cid):
         """Remove the observer with connection id *cid*."""
         self._observers.disconnect(cid)
 
-    @_api.deprecated("3.7",
-                     addendum="Any custom property styling may be lost.")
-    @property
-    def circles(self):
-        if not hasattr(self, "_circles"):
-            radius = min(.5 / (len(self.labels) + 1) - .01, .05)
-            circles = self._circles = [
-                Circle(xy=self._buttons.get_offsets()[i], edgecolor="black",
-                       facecolor=self._buttons.get_facecolor()[i],
-                       radius=radius, transform=self.ax.transAxes,
-                       animated=self._useblit)
-                for i in range(len(self.labels))]
-            self._buttons.set_visible(False)
-            for circle in circles:
-                self.ax.add_patch(circle)
-        return self._circles
-
 
 class SubplotTool(Widget):
     """
@@ -1974,8 +1863,7 @@ class Cursor(AxesWidget):
     --------
     See :doc:`/gallery/widgets/cursor`.
     """
-    @_api.make_keyword_only("3.7", "horizOn")
-    def __init__(self, ax, horizOn=True, vertOn=True, useblit=False,
+    def __init__(self, ax, *, horizOn=True, vertOn=True, useblit=False,
                  **lineprops):
         super().__init__(ax)
 
@@ -2109,8 +1997,6 @@ def __init__(self, canvas, axes, *, useblit=True, horizOn=False, vertOn=True,
 
         self.connect()
 
-    needclear = _api.deprecated("3.7")(lambda self: False)
-
     def connect(self):
         """Connect events."""
         for canvas, info in self._canvas_infos.items():
@@ -2613,8 +2499,7 @@ class SpanSelector(_SelectorWidget):
     See also: :doc:`/gallery/widgets/span_selector`
     """
 
-    @_api.make_keyword_only("3.7", name="minspan")
-    def __init__(self, ax, onselect, direction, minspan=0, useblit=False,
+    def __init__(self, ax, onselect, direction, *, minspan=0, useblit=False,
                  props=None, onmove_callback=None, interactive=False,
                  button=None, handle_props=None, grab_range=10,
                  state_modifier_keys=None, drag_from_anywhere=False,
@@ -2957,8 +2842,7 @@ class ToolLineHandles:
         for details.
     """
 
-    @_api.make_keyword_only("3.7", "line_props")
-    def __init__(self, ax, positions, direction, line_props=None,
+    def __init__(self, ax, positions, direction, *, line_props=None,
                  useblit=True):
         self.ax = ax
 
@@ -3068,8 +2952,7 @@ class ToolHandles:
         for details.
     """
 
-    @_api.make_keyword_only("3.7", "marker")
-    def __init__(self, ax, x, y, marker='o', marker_props=None, useblit=True):
+    def __init__(self, ax, x, y, *, marker='o', marker_props=None, useblit=True):
         self.ax = ax
         props = {'marker': marker, 'markersize': 7, 'markerfacecolor': 'w',
                  'linestyle': 'none', 'alpha': 0.5, 'visible': False,
@@ -3771,8 +3654,7 @@ def onselect(verts):
         which corresponds to all buttons.
     """
 
-    @_api.make_keyword_only("3.7", name="useblit")
-    def __init__(self, ax, onselect, useblit=True, props=None, button=None):
+    def __init__(self, ax, onselect, *, useblit=True, props=None, button=None):
         super().__init__(ax, onselect, useblit=useblit, button=button)
         self.verts = None
         props = {
@@ -3882,9 +3764,8 @@ class PolygonSelector(_SelectorWidget):
     point.
     """
 
-    @_api.make_keyword_only("3.7", name="useblit")
-    def __init__(self, ax, onselect, useblit=False,
-                 props=None, handle_props=None, grab_range=10, *,
+    def __init__(self, ax, onselect, *, useblit=False,
+                 props=None, handle_props=None, grab_range=10,
                  draw_bounding_box=False, box_handle_props=None,
                  box_props=None):
         # The state modifiers 'move', 'square', and 'center' are expected by
@@ -4199,8 +4080,7 @@ class Lasso(AxesWidget):
         for details.
     """
 
-    @_api.make_keyword_only("3.7", name="useblit")
-    def __init__(self, ax, xy, callback, useblit=True):
+    def __init__(self, ax, xy, callback, *, useblit=True):
         super().__init__(ax)
 
         self.useblit = useblit and self.canvas.supports_blit
diff --git a/lib/matplotlib/widgets.pyi b/lib/matplotlib/widgets.pyi
index 00c2d0da8a7e..ca1e5a71a288 100644
--- a/lib/matplotlib/widgets.pyi
+++ b/lib/matplotlib/widgets.pyi
@@ -164,10 +164,6 @@ class CheckButtons(AxesWidget):
     def get_status(self) -> list[bool]: ...
     def on_clicked(self, func: Callable[[str], Any]) -> int: ...
     def disconnect(self, cid: int) -> None: ...
-    @property
-    def lines(self) -> list[tuple[Line2D, Line2D]]: ...
-    @property
-    def rectangles(self) -> list[Rectangle]: ...
 
 class TextBox(AxesWidget):
     label: Text
@@ -191,7 +187,7 @@ class TextBox(AxesWidget):
     @property
     def text(self) -> str: ...
     def set_val(self, val: str) -> None: ...
-    def begin_typing(self, x = ...) -> None: ...
+    def begin_typing(self) -> None: ...
     def stop_typing(self) -> None: ...
     def on_text_change(self, func: Callable[[str], Any]) -> int: ...
     def on_submit(self, func: Callable[[str], Any]) -> int: ...
@@ -217,8 +213,6 @@ class RadioButtons(AxesWidget):
     def set_active(self, index: int) -> None: ...
     def on_clicked(self, func: Callable[[str], Any]) -> int: ...
     def disconnect(self, cid: int) -> None: ...
-    @property
-    def circles(self) -> list[Circle]: ...
 
 class SubplotTool(Widget):
     figure: Figure
@@ -253,7 +247,6 @@ class MultiCursor(Widget):
     vertOn: bool
     visible: bool
     useblit: bool
-    needclear: bool
     vlines: list[Line2D]
     hlines: list[Line2D]
     def __init__(

From f49cf289ef8c90c47b2264b3731a9cd9739772b9 Mon Sep 17 00:00:00 2001
From: ananya314 <ananya.devarakonda1@gmail.com>
Date: Fri, 22 Sep 2023 14:15:23 -0400
Subject: [PATCH 0178/1120] Removed deprecated code from animation.py

---
 doc/api/next_api_changes/removals/26872-AD.rst | 6 ++++++
 lib/matplotlib/animation.py                    | 4 ----
 lib/matplotlib/animation.pyi                   | 2 --
 3 files changed, 6 insertions(+), 6 deletions(-)
 create mode 100644 doc/api/next_api_changes/removals/26872-AD.rst

diff --git a/doc/api/next_api_changes/removals/26872-AD.rst b/doc/api/next_api_changes/removals/26872-AD.rst
new file mode 100644
index 000000000000..2f678ffc3cfd
--- /dev/null
+++ b/doc/api/next_api_changes/removals/26872-AD.rst
@@ -0,0 +1,6 @@
+``repeat``
+~~~~~~~~~~
+... of `.TimedAnimation` is removed without replacements.
+``save_count``
+~~~~~~~~~~~~~~
+... of `.FuncAnimation` is removed without replacements.
diff --git a/lib/matplotlib/animation.py b/lib/matplotlib/animation.py
index e9b1c23658cd..e7d09e7d7847 100644
--- a/lib/matplotlib/animation.py
+++ b/lib/matplotlib/animation.py
@@ -1446,8 +1446,6 @@ def _step(self, *args):
         self.event_source.interval = self._interval
         return True
 
-    repeat = _api.deprecate_privatize_attribute("3.7")
-
 
 class ArtistAnimation(TimedAnimation):
     """
@@ -1788,8 +1786,6 @@ def _draw_frame(self, framedata):
             for a in self._drawn_artists:
                 a.set_animated(self._blit)
 
-    save_count = _api.deprecate_privatize_attribute("3.7")
-
 
 def _validate_grabframe_kwargs(savefig_kwargs):
     if mpl.rcParams['savefig.bbox'] == 'tight':
diff --git a/lib/matplotlib/animation.pyi b/lib/matplotlib/animation.pyi
index de1b9926afd6..56c27a465b7f 100644
--- a/lib/matplotlib/animation.pyi
+++ b/lib/matplotlib/animation.pyi
@@ -188,7 +188,6 @@ class Animation:
     def resume(self) -> None: ...
 
 class TimedAnimation(Animation):
-    repeat: bool
     def __init__(
         self,
         fig: Figure,
@@ -204,7 +203,6 @@ class ArtistAnimation(TimedAnimation):
     def __init__(self, fig: Figure, artists: Sequence[Collection[Artist]], *args, **kwargs) -> None: ...
 
 class FuncAnimation(TimedAnimation):
-    save_count: int
     def __init__(
         self,
         fig: Figure,

From 27a0884db74972ad8efb13b130875afebfc92d74 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Fri, 22 Sep 2023 16:36:48 -0500
Subject: [PATCH 0179/1120] [TYP] Type changes from running against Pandas

---
 lib/matplotlib/axes/__init__.pyi |  6 ++++++
 lib/matplotlib/axes/_base.pyi    | 34 +++++++++++++++++++-------------
 lib/matplotlib/ticker.pyi        |  2 +-
 3 files changed, 27 insertions(+), 15 deletions(-)

diff --git a/lib/matplotlib/axes/__init__.pyi b/lib/matplotlib/axes/__init__.pyi
index 0c27be62e370..d885677b63de 100644
--- a/lib/matplotlib/axes/__init__.pyi
+++ b/lib/matplotlib/axes/__init__.pyi
@@ -1,3 +1,9 @@
+__all__ = [
+    'Axes',
+    'Subplot',
+    'SubplotBase',
+]
+
 from typing import TypeVar
 
 from ._axes import *
diff --git a/lib/matplotlib/axes/_base.pyi b/lib/matplotlib/axes/_base.pyi
index 1f929b6c90c5..a8a47f819446 100644
--- a/lib/matplotlib/axes/_base.pyi
+++ b/lib/matplotlib/axes/_base.pyi
@@ -6,6 +6,7 @@ from matplotlib import cbook
 from matplotlib.artist import Artist
 from matplotlib.axis import XAxis, YAxis, Tick
 from matplotlib.backend_bases import RendererBase, MouseButton, MouseEvent
+from matplotlib.cbook import CallbackRegistry
 from matplotlib.container import Container
 from matplotlib.collections import Collection
 from matplotlib.cm import ScalarMappable
@@ -25,9 +26,11 @@ from cycler import Cycler
 
 import numpy as np
 from numpy.typing import ArrayLike
-from typing import Any, Literal, overload
+from typing import Any, Literal, TypeVar, overload
 from matplotlib.typing import ColorType
 
+_T = TypeVar("_T", bound=Artist)
+
 class _axis_method_wrapper:
     attr_name: str
     method_name: str
@@ -53,6 +56,9 @@ class _AxesBase(martist.Artist):
     transData: Transform
     ignore_existing_data_limits: bool
     axison: bool
+    containers: list[Container]
+    callbacks: CallbackRegistry
+    child_axes: list[_AxesBase]
     _projection_init: Any
 
     def __init__(
@@ -126,7 +132,7 @@ class _AxesBase(martist.Artist):
     def cla(self) -> None: ...
 
     # Could be made generic, but comments indicate it may be temporary anyway
-    class ArtistList(Sequence[Artist]):
+    class ArtistList(Sequence[_T]):
         def __init__(
             self,
             axes: _AxesBase,
@@ -135,40 +141,40 @@ class _AxesBase(martist.Artist):
             invalid_types: type | Iterable[type] | None = ...,
         ) -> None: ...
         def __len__(self) -> int: ...
-        def __iter__(self) -> Iterator[Artist]: ...
+        def __iter__(self) -> Iterator[_T]: ...
         @overload
-        def __getitem__(self, key: int) -> Artist: ...
+        def __getitem__(self, key: int) -> _T: ...
         @overload
-        def __getitem__(self, key: slice) -> list[Artist]: ...
+        def __getitem__(self, key: slice) -> list[_T]: ...
 
         @overload
-        def __add__(self, other: _AxesBase.ArtistList) -> list[Artist]: ...
+        def __add__(self, other: _AxesBase.ArtistList[_T]) -> list[_T]: ...
         @overload
         def __add__(self, other: list[Any]) -> list[Any]: ...
         @overload
         def __add__(self, other: tuple[Any]) -> tuple[Any]: ...
 
         @overload
-        def __radd__(self, other: _AxesBase.ArtistList) -> list[Artist]: ...
+        def __radd__(self, other: _AxesBase.ArtistList[_T]) -> list[_T]: ...
         @overload
         def __radd__(self, other: list[Any]) -> list[Any]: ...
         @overload
         def __radd__(self, other: tuple[Any]) -> tuple[Any]: ...
 
     @property
-    def artists(self) -> _AxesBase.ArtistList: ...
+    def artists(self) -> _AxesBase.ArtistList[Artist]: ...
     @property
-    def collections(self) -> _AxesBase.ArtistList: ...
+    def collections(self) -> _AxesBase.ArtistList[Collection]: ...
     @property
-    def images(self) -> _AxesBase.ArtistList: ...
+    def images(self) -> _AxesBase.ArtistList[AxesImage]: ...
     @property
-    def lines(self) -> _AxesBase.ArtistList: ...
+    def lines(self) -> _AxesBase.ArtistList[Line2D]: ...
     @property
-    def patches(self) -> _AxesBase.ArtistList: ...
+    def patches(self) -> _AxesBase.ArtistList[Patch]: ...
     @property
-    def tables(self) -> _AxesBase.ArtistList: ...
+    def tables(self) -> _AxesBase.ArtistList[Table]: ...
     @property
-    def texts(self) -> _AxesBase.ArtistList: ...
+    def texts(self) -> _AxesBase.ArtistList[Text]: ...
     def get_facecolor(self) -> ColorType: ...
     def set_facecolor(self, color: ColorType | None) -> None: ...
     @overload
diff --git a/lib/matplotlib/ticker.pyi b/lib/matplotlib/ticker.pyi
index 2ef1c9f53f1d..f026b4943c94 100644
--- a/lib/matplotlib/ticker.pyi
+++ b/lib/matplotlib/ticker.pyi
@@ -19,7 +19,7 @@ class _DummyAxis:
 
 class TickHelper:
     axis: None | Axis | _DummyAxis | _AxisWrapper
-    def set_axis(self, axis: Axis | _DummyAxis | None) -> None: ...
+    def set_axis(self, axis: Axis | _DummyAxis | _AxisWrapper | None) -> None: ...
     def create_dummy_axis(self, **kwargs) -> None: ...
 
 class Formatter(TickHelper):

From 19f775e0d590b94af60fa19a4de2790ff05ca310 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Fri, 15 Sep 2023 20:05:10 +0200
Subject: [PATCH 0180/1120] Simplify Tk toolktip setup.

... switching everything to use closures.
---
 lib/matplotlib/backends/_backend_tk.py | 72 ++++++++++----------------
 1 file changed, 27 insertions(+), 45 deletions(-)

diff --git a/lib/matplotlib/backends/_backend_tk.py b/lib/matplotlib/backends/_backend_tk.py
index 89c380f8c96b..698e84247d53 100644
--- a/lib/matplotlib/backends/_backend_tk.py
+++ b/lib/matplotlib/backends/_backend_tk.py
@@ -631,7 +631,7 @@ def __init__(self, canvas, window=None, *, pack_toolbar=True):
                     command=getattr(self, callback),
                 )
                 if tooltip_text is not None:
-                    ToolTip.createToolTip(button, tooltip_text)
+                    add_tooltip(button, tooltip_text)
 
         self._label_font = tkinter.font.Font(root=window, size=10)
 
@@ -892,62 +892,44 @@ def set_history_buttons(self):
         state_map = {True: tk.NORMAL, False: tk.DISABLED}
         can_back = self._nav_stack._pos > 0
         can_forward = self._nav_stack._pos < len(self._nav_stack) - 1
-
         if "Back" in self._buttons:
             self._buttons['Back']['state'] = state_map[can_back]
-
         if "Forward" in self._buttons:
             self._buttons['Forward']['state'] = state_map[can_forward]
 
 
-class ToolTip:
-    """
-    Tooltip recipe from
-    http://www.voidspace.org.uk/python/weblog/arch_d7_2006_07_01.shtml#e387
-    """
-    @staticmethod
-    def createToolTip(widget, text):
-        toolTip = ToolTip(widget)
-        def enter(event):
-            toolTip.showtip(text)
-        def leave(event):
-            toolTip.hidetip()
-        widget.bind('<Enter>', enter)
-        widget.bind('<Leave>', leave)
-
-    def __init__(self, widget):
-        self.widget = widget
-        self.tipwindow = None
-        self.id = None
-        self.x = self.y = 0
-
-    def showtip(self, text):
+def add_tooltip(widget, text):
+    tipwindow = None
+
+    def showtip(event):
         """Display text in tooltip window."""
-        self.text = text
-        if self.tipwindow or not self.text:
+        nonlocal tipwindow
+        if tipwindow or not text:
             return
-        x, y, _, _ = self.widget.bbox("insert")
-        x = x + self.widget.winfo_rootx() + self.widget.winfo_width()
-        y = y + self.widget.winfo_rooty()
-        self.tipwindow = tw = tk.Toplevel(self.widget)
-        tw.wm_overrideredirect(1)
-        tw.wm_geometry("+%d+%d" % (x, y))
-        try:
-            # For Mac OS
-            tw.tk.call("::tk::unsupported::MacWindowStyle",
-                       "style", tw._w,
-                       "help", "noActivates")
+        x, y, _, _ = widget.bbox("insert")
+        x = x + widget.winfo_rootx() + widget.winfo_width()
+        y = y + widget.winfo_rooty()
+        tipwindow = tk.Toplevel(widget)
+        tipwindow.overrideredirect(1)
+        tipwindow.geometry(f"+{x}+{y}")
+        try:  # For Mac OS
+            tipwindow.tk.call("::tk::unsupported::MacWindowStyle",
+                              "style", tipwindow._w,
+                              "help", "noActivates")
         except tk.TclError:
             pass
-        label = tk.Label(tw, text=self.text, justify=tk.LEFT,
+        label = tk.Label(tipwindow, text=text, justify=tk.LEFT,
                          relief=tk.SOLID, borderwidth=1)
         label.pack(ipadx=1)
 
-    def hidetip(self):
-        tw = self.tipwindow
-        self.tipwindow = None
-        if tw:
-            tw.destroy()
+    def hidetip(event):
+        nonlocal tipwindow
+        if tipwindow:
+            tipwindow.destroy()
+        tipwindow = None
+
+    widget.bind("<Enter>", showtip)
+    widget.bind("<Leave>", hidetip)
 
 
 @backend_tools._register_tool_class(FigureCanvasTk)
@@ -1002,7 +984,7 @@ def add_toolitem(
                                               lambda: self._button_click(name))
         button.pack_configure(before=before)
         if description is not None:
-            ToolTip.createToolTip(button, description)
+            add_tooltip(button, description)
         self._toolitems.setdefault(name, [])
         self._toolitems[name].append(button)
 

From ff552f45f2d30c76120fe0355306afac9a9dd2da Mon Sep 17 00:00:00 2001
From: agautam478 <72432016+agautam478@users.noreply.github.com>
Date: Fri, 22 Sep 2023 19:37:29 -0700
Subject: [PATCH 0181/1120] Remove the 3.7 deprecated code from axis.py
 (#26871)

---
 doc/api/next_api_changes/removals/26871-AG.rst | 3 +++
 lib/matplotlib/axis.py                         | 1 -
 2 files changed, 3 insertions(+), 1 deletion(-)
 create mode 100644 doc/api/next_api_changes/removals/26871-AG.rst

diff --git a/doc/api/next_api_changes/removals/26871-AG.rst b/doc/api/next_api_changes/removals/26871-AG.rst
new file mode 100644
index 000000000000..9c24ac3215a1
--- /dev/null
+++ b/doc/api/next_api_changes/removals/26871-AG.rst
@@ -0,0 +1,3 @@
+``matplotlib.axis.Axis.set_ticklabels``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+... a param was renamed to labels from ticklabels.
diff --git a/lib/matplotlib/axis.py b/lib/matplotlib/axis.py
index 33d029028012..64aeac81c140 100644
--- a/lib/matplotlib/axis.py
+++ b/lib/matplotlib/axis.py
@@ -1941,7 +1941,6 @@ def set_pickradius(self, pickradius):
     def _format_with_dict(tickd, x, pos):
         return tickd.get(x, "")
 
-    @_api.rename_parameter("3.7", "ticklabels", "labels")
     def set_ticklabels(self, labels, *, minor=False, fontdict=None, **kwargs):
         r"""
         [*Discouraged*] Set this Axis' tick labels with list of string labels.

From 82ff2732958c5825e421ae2e28098f8fe014aa20 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Sat, 23 Sep 2023 14:31:44 +0200
Subject: [PATCH 0182/1120] Simplify CheckButtons and RadioButtons click
 handler.

Shorten the code that determines which button has been clicked.

Use Text.contains directly (it calls text.get_window_extent itself)
rather than manually going through text.get_window_extent.

The previous code for finding the closest click was actually wrong
(transAxes.inverted().transform((event.x, event.y)) is in axes space,
but get_offset_transform().transform(get_offsets()) is in screen space,
so they cannot be subtracted from one another) but it didn't really
matter because a click is, in practice, always contained by a single
button anyways (idxs has length at most 1).  Still, fix that.
---
 lib/matplotlib/widgets.py | 41 +++++++++++++++------------------------
 1 file changed, 16 insertions(+), 25 deletions(-)

diff --git a/lib/matplotlib/widgets.py b/lib/matplotlib/widgets.py
index f24be7904690..45aa58d6fc19 100644
--- a/lib/matplotlib/widgets.py
+++ b/lib/matplotlib/widgets.py
@@ -1118,19 +1118,14 @@ def _clear(self, event):
     def _clicked(self, event):
         if self.ignore(event) or event.button != 1 or not self.ax.contains(event)[0]:
             return
-        pclicked = self.ax.transAxes.inverted().transform((event.x, event.y))
-        distances = {}
-        _, frame_inds = self._frames.contains(event)
-        coords = self._frames.get_offset_transform().transform(
-            self._frames.get_offsets()
-        )
-        for i, t in enumerate(self.labels):
-            if (i in frame_inds["ind"]
-                    or t.get_window_extent().contains(event.x, event.y)):
-                distances[i] = np.linalg.norm(pclicked - coords[i])
-        if len(distances) > 0:
-            closest = min(distances, key=distances.get)
-            self.set_active(closest)
+        idxs = [  # Indices of frames and of texts that contain the event.
+            *self._frames.contains(event)[1]["ind"],
+            *[i for i, text in enumerate(self.labels) if text.contains(event)[0]]]
+        if idxs:
+            coords = self._frames.get_offset_transform().transform(
+                self._frames.get_offsets())
+            self.set_active(  # Closest index, only looking in idxs.
+                idxs[(((event.x, event.y) - coords[idxs]) ** 2).sum(-1).argmin()])
 
     def set_label_props(self, props):
         """
@@ -1656,18 +1651,14 @@ def _clear(self, event):
     def _clicked(self, event):
         if self.ignore(event) or event.button != 1 or not self.ax.contains(event)[0]:
             return
-        pclicked = self.ax.transAxes.inverted().transform((event.x, event.y))
-        _, inds = self._buttons.contains(event)
-        coords = self._buttons.get_offset_transform().transform(
-            self._buttons.get_offsets())
-        distances = {}
-        for i, t in enumerate(self.labels):
-            if (i in inds["ind"]
-                    or t.get_window_extent().contains(event.x, event.y)):
-                distances[i] = np.linalg.norm(pclicked - coords[i])
-        if len(distances) > 0:
-            closest = min(distances, key=distances.get)
-            self.set_active(closest)
+        idxs = [  # Indices of buttons and of texts that contain the event.
+            *self._buttons.contains(event)[1]["ind"],
+            *[i for i, text in enumerate(self.labels) if text.contains(event)[0]]]
+        if idxs:
+            coords = self._buttons.get_offset_transform().transform(
+                self._buttons.get_offsets())
+            self.set_active(  # Closest index, only looking in idxs.
+                idxs[(((event.x, event.y) - coords[idxs]) ** 2).sum(-1).argmin()])
 
     def set_label_props(self, props):
         """

From 96392c3a5ae485ddc605cd0e3b6025a5f3dac51d Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Sun, 24 Sep 2023 12:01:04 +0100
Subject: [PATCH 0183/1120] add users/explain to default skip subdir

---
 doc/conf.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/doc/conf.py b/doc/conf.py
index f369c7c4b89c..c2cdadf0ec24 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -47,8 +47,9 @@ def _parse_skip_subdirs_file():
     but you can skip subdirectories of 'users'.  Doing this
     can make partial builds very fast.
     """
-    default_skip_subdirs = ['users/prev_whats_new/*', 'api/*', 'gallery/*',
-                            'tutorials/*', 'plot_types/*', 'devel/*']
+    default_skip_subdirs = [
+        'users/prev_whats_new/*', 'users/explain/*', 'api/*', 'gallery/*',
+        'tutorials/*', 'plot_types/*', 'devel/*']
     try:
         with open(".mpl_skip_subdirs.yaml", 'r') as fin:
             print('Reading subdirectories to skip from',

From a3bebed46725dc7203f459c62bc9eeb60a2a7338 Mon Sep 17 00:00:00 2001
From: Ian Thomas <ianthomas23@gmail.com>
Date: Fri, 7 Jul 2023 08:54:11 +0100
Subject: [PATCH 0184/1120] Use pybind11 in image module

---
 lib/matplotlib/tests/test_image.py |  15 +-
 setupext.py                        |   9 +-
 src/_image_wrapper.cpp             | 329 +++++++++++------------------
 src/py_converters_11.cpp           |  20 ++
 src/py_converters_11.h             |  13 ++
 5 files changed, 179 insertions(+), 207 deletions(-)
 create mode 100644 src/py_converters_11.cpp
 create mode 100644 src/py_converters_11.h

diff --git a/lib/matplotlib/tests/test_image.py b/lib/matplotlib/tests/test_image.py
index c9c959e96115..4fb4e65137d4 100644
--- a/lib/matplotlib/tests/test_image.py
+++ b/lib/matplotlib/tests/test_image.py
@@ -1468,17 +1468,26 @@ def test_str_norms(fig_test, fig_ref):
 
 def test__resample_valid_output():
     resample = functools.partial(mpl._image.resample, transform=Affine2D())
-    with pytest.raises(ValueError, match="must be a NumPy array"):
+    with pytest.raises(TypeError, match="incompatible function arguments"):
         resample(np.zeros((9, 9)), None)
     with pytest.raises(ValueError, match="different dimensionalities"):
         resample(np.zeros((9, 9)), np.zeros((9, 9, 4)))
-    with pytest.raises(ValueError, match="must be RGBA"):
+    with pytest.raises(ValueError, match="different dimensionalities"):
+        resample(np.zeros((9, 9, 4)), np.zeros((9, 9)))
+    with pytest.raises(ValueError, match="3D input array must be RGBA"):
+        resample(np.zeros((9, 9, 3)), np.zeros((9, 9, 4)))
+    with pytest.raises(ValueError, match="3D output array must be RGBA"):
         resample(np.zeros((9, 9, 4)), np.zeros((9, 9, 3)))
-    with pytest.raises(ValueError, match="Mismatched types"):
+    with pytest.raises(ValueError, match="mismatched types"):
         resample(np.zeros((9, 9), np.uint8), np.zeros((9, 9)))
     with pytest.raises(ValueError, match="must be C-contiguous"):
         resample(np.zeros((9, 9)), np.zeros((9, 9)).T)
 
+    out = np.zeros((9, 9))
+    out.flags.writeable = False
+    with pytest.raises(ValueError, match="Output array must be writeable"):
+        resample(np.zeros((9, 9)), out)
+
 
 def test_axesimage_get_shape():
     # generate dummy image to test get_shape method
diff --git a/setupext.py b/setupext.py
index 9f78d88c87e8..049f46c65c7d 100644
--- a/setupext.py
+++ b/setupext.py
@@ -424,12 +424,13 @@ def get_extensions(self):
         add_libagg_flags(ext)
         yield ext
         # image
-        ext = Extension(
+        ext = Pybind11Extension(
             "matplotlib._image", [
                 "src/_image_wrapper.cpp",
-                "src/py_converters.cpp",
-            ])
-        add_numpy_flags(ext)
+                "src/py_converters_11.cpp",
+            ],
+            cxx_std=11)
+        # Only need source code files agg_image_filters.cpp and agg_trans_affine.cpp
         add_libagg_flags_and_sources(ext)
         yield ext
         # path
diff --git a/src/_image_wrapper.cpp b/src/_image_wrapper.cpp
index ca6ae8b2226f..a63004ebb624 100644
--- a/src/_image_wrapper.cpp
+++ b/src/_image_wrapper.cpp
@@ -1,7 +1,8 @@
-#include "mplutils.h"
+#include <pybind11/pybind11.h>
+#include <pybind11/numpy.h>
+
 #include "_image_resample.h"
-#include "numpy_cpp.h"
-#include "py_converters.h"
+#include "py_converters_11.h"
 
 
 /**********************************************************************
@@ -49,8 +50,8 @@ const char* image_resample__doc__ =
 "    The radius of the kernel, if method is SINC, LANCZOS or BLACKMAN.\n";
 
 
-static PyArrayObject *
-_get_transform_mesh(PyObject *py_affine, npy_intp *dims)
+static pybind11::array_t<double> _get_transform_mesh(const pybind11::object& transform,
+                                                     const ssize_t *dims)
 {
     /* TODO: Could we get away with float, rather than double, arrays here? */
 
@@ -58,240 +59,168 @@ _get_transform_mesh(PyObject *py_affine, npy_intp *dims)
     every pixel in the output image to the input image.  This is used
     as a lookup table during the actual resampling. */
 
-    PyObject *py_inverse = NULL;
-    npy_intp out_dims[3];
-
-    out_dims[0] = dims[0] * dims[1];
-    out_dims[1] = 2;
+    // If attribute doesn't exist, raises Python AttributeError
+    auto inverse = transform.attr("inverted")();
 
-    py_inverse = PyObject_CallMethod(py_affine, "inverted", NULL);
-    if (py_inverse == NULL) {
-        return NULL;
-    }
+    pybind11::array_t<double> input_mesh({dims[0]*dims[1], 2L});
+    auto p = input_mesh.mutable_data();
 
-    numpy::array_view<double, 2> input_mesh(out_dims);
-    double *p = (double *)input_mesh.data();
-
-    for (npy_intp y = 0; y < dims[0]; ++y) {
-        for (npy_intp x = 0; x < dims[1]; ++x) {
+    for (auto y = 0; y < dims[0]; ++y) {
+        for (auto x = 0; x < dims[1]; ++x) {
             *p++ = (double)x;
             *p++ = (double)y;
         }
     }
 
-    PyObject *output_mesh = PyObject_CallMethod(
-        py_inverse, "transform", "O", input_mesh.pyobj_steal());
-
-    Py_DECREF(py_inverse);
-
-    if (output_mesh == NULL) {
-        return NULL;
-    }
-
-    PyArrayObject *output_mesh_array =
-        (PyArrayObject *)PyArray_ContiguousFromAny(
-            output_mesh, NPY_DOUBLE, 2, 2);
+    auto output_mesh = inverse.attr("transform")(input_mesh);
 
-    Py_DECREF(output_mesh);
+    auto output_mesh_array =
+        pybind11::array_t<double, pybind11::array::c_style | pybind11::array::forcecast>(output_mesh);
 
-    if (output_mesh_array == NULL) {
-        return NULL;
-    }
+    if (output_mesh_array.ndim() != 2)
+        throw std::runtime_error(
+            "Inverse transformed mesh array should be 2D not " +
+            std::to_string(output_mesh_array.ndim()) + "D");
 
     return output_mesh_array;
 }
 
 
-static PyObject *
-image_resample(PyObject *self, PyObject* args, PyObject *kwargs)
+// Using generic pybind::array for input and output arrays rather than the more usual
+// pybind::array_t<type> as function supports multiple array dtypes.
+static void image_resample(pybind11::array input_array,
+                           pybind11::array& output_array,
+                           const pybind11::object& transform,
+                           interpolation_e interpolation,
+                           bool resample_,  // Avoid name clash with resample() function
+                           float alpha,
+                           bool norm,
+                           float radius)
 {
-    PyObject *py_input = NULL;
-    PyObject *py_output = NULL;
-    PyObject *py_transform = NULL;
-    resample_params_t params;
+    // Validate input_array
+    auto dtype = input_array.dtype();  // Validated when determine resampler below
+    auto ndim = input_array.ndim();
 
-    PyArrayObject *input = NULL;
-    PyArrayObject *output = NULL;
-    PyArrayObject *transform_mesh = NULL;
-    int ndim;
-    int type;
-
-    params.interpolation = NEAREST;
-    params.transform_mesh = NULL;
-    params.resample = false;
-    params.norm = false;
-    params.radius = 1.0;
-    params.alpha = 1.0;
-
-    const char *kwlist[] = {
-        "input_array", "output_array", "transform", "interpolation",
-        "resample", "alpha", "norm", "radius", NULL };
-
-    if (!PyArg_ParseTupleAndKeywords(
-            args, kwargs, "OOO|iO&dO&d:resample", (char **)kwlist,
-            &py_input, &py_output, &py_transform,
-            &params.interpolation, &convert_bool, &params.resample,
-            &params.alpha, &convert_bool, &params.norm, &params.radius)) {
-        return NULL;
-    }
+    if (ndim < 2 || ndim > 3)
+        throw std::invalid_argument("Input array must be a 2D or 3D array");
 
-    if (params.interpolation < 0 || params.interpolation >= _n_interpolation) {
-        PyErr_Format(PyExc_ValueError, "Invalid interpolation value %d",
-                     params.interpolation);
-        goto error;
-    }
+    if (ndim == 3 && input_array.shape(2) != 4)
+        throw std::invalid_argument(
+            "3D input array must be RGBA with shape (M, N, 4), has trailing dimension of " +
+            std::to_string(ndim));
 
-    input = (PyArrayObject *)PyArray_FromAny(
-        py_input, NULL, 2, 3, NPY_ARRAY_C_CONTIGUOUS, NULL);
-    if (!input) {
-        goto error;
-    }
-    ndim = PyArray_NDIM(input);
-    type = PyArray_TYPE(input);
+    // Ensure input array is contiguous, regardless of dtype
+    input_array = pybind11::array::ensure(input_array, pybind11::array::c_style);
 
-    if (!PyArray_Check(py_output)) {
-        PyErr_SetString(PyExc_ValueError, "Output array must be a NumPy array");
-        goto error;
-    }
-    output = (PyArrayObject *)py_output;
-    if (PyArray_NDIM(output) != ndim) {
-        PyErr_Format(
-            PyExc_ValueError,
-            "Input (%dD) and output (%dD) have different dimensionalities.",
-            ndim, PyArray_NDIM(output));
-        goto error;
-    }
-    // PyArray_FromAny above checks that input is 2D or 3D.
-    if (ndim == 3 && (PyArray_DIM(input, 2) != 4 || PyArray_DIM(output, 2) != 4)) {
-        PyErr_Format(
-            PyExc_ValueError,
-            "If 3D, input and output arrays must be RGBA with shape (M, N, 4); "
-            "got trailing dimensions of %" NPY_INTP_FMT " and %" NPY_INTP_FMT
-            " respectively", PyArray_DIM(input, 2), PyArray_DIM(output, 2));
-        goto error;
-    }
-    if (PyArray_TYPE(output) != type) {
-        PyErr_SetString(PyExc_ValueError, "Mismatched types");
-        goto error;
-    }
-    if (!PyArray_IS_C_CONTIGUOUS(output)) {
-        PyErr_SetString(PyExc_ValueError, "Output array must be C-contiguous");
-        goto error;
-    }
+    // Validate output array
+    auto out_ndim = output_array.ndim();
+
+    if (out_ndim != ndim)
+        throw std::invalid_argument(
+            "Input (" + std::to_string(ndim) + "D) and output (" + std::to_string(out_ndim) +
+            "D) arrays have different dimensionalities");
+
+    if (out_ndim == 3 && output_array.shape(2) != 4)
+        throw std::invalid_argument(
+            "3D output array must be RGBA with shape (M, N, 4), has trailing dimension of " +
+            std::to_string(out_ndim));
 
-    if (py_transform == NULL || py_transform == Py_None) {
+    if (!output_array.dtype().is(dtype))
+        throw std::invalid_argument("Input and output arrays have mismatched types");
+
+    if ((output_array.flags() & pybind11::array::c_style) == 0)
+        throw std::invalid_argument("Output array must be C-contiguous");
+
+    if (!output_array.writeable())
+        throw std::invalid_argument("Output array must be writeable");
+
+    resample_params_t params;
+    params.interpolation = interpolation;
+    params.transform_mesh = nullptr;
+    params.resample = resample_;
+    params.norm = norm;
+    params.radius = radius;
+    params.alpha = alpha;
+
+    // Only used if transform is not affine.
+    // Need to keep it in scope for the duration of this function.
+    pybind11::array_t<double> transform_mesh;
+
+    // Validate transform
+    if (transform.is_none()) {
         params.is_affine = true;
     } else {
-        PyObject *py_is_affine;
-        int py_is_affine2;
-        py_is_affine = PyObject_GetAttrString(py_transform, "is_affine");
-        if (!py_is_affine) {
-            goto error;
-        }
+        // Raises Python AttributeError if no such attribute or TypeError if cast fails
+        bool is_affine = pybind11::cast<bool>(transform.attr("is_affine"));
 
-        py_is_affine2 = PyObject_IsTrue(py_is_affine);
-        Py_DECREF(py_is_affine);
-
-        if (py_is_affine2 == -1) {
-            goto error;
-        } else if (py_is_affine2) {
-            if (!convert_trans_affine(py_transform, &params.affine)) {
-                goto error;
-            }
+        if (is_affine) {
+            convert_trans_affine(transform, params.affine);
             params.is_affine = true;
         } else {
-            transform_mesh = _get_transform_mesh(
-                py_transform, PyArray_DIMS(output));
-            if (!transform_mesh) {
-                goto error;
-            }
-            params.transform_mesh = (double *)PyArray_DATA(transform_mesh);
+            transform_mesh = _get_transform_mesh(transform, output_array.shape());
+            params.transform_mesh = transform_mesh.data();
             params.is_affine = false;
         }
     }
 
     if (auto resampler =
             (ndim == 2) ? (
-                (type == NPY_UINT8) ? resample<agg::gray8> :
-                (type == NPY_INT8) ? resample<agg::gray8> :
-                (type == NPY_UINT16) ? resample<agg::gray16> :
-                (type == NPY_INT16) ? resample<agg::gray16> :
-                (type == NPY_FLOAT32) ? resample<agg::gray32> :
-                (type == NPY_FLOAT64) ? resample<agg::gray64> :
+                (dtype.is(pybind11::dtype::of<std::uint8_t>())) ? resample<agg::gray8> :
+                (dtype.is(pybind11::dtype::of<std::int8_t>())) ? resample<agg::gray8> :
+                (dtype.is(pybind11::dtype::of<std::uint16_t>())) ? resample<agg::gray16> :
+                (dtype.is(pybind11::dtype::of<std::int16_t>())) ? resample<agg::gray16> :
+                (dtype.is(pybind11::dtype::of<float>())) ? resample<agg::gray32> :
+                (dtype.is(pybind11::dtype::of<double>())) ? resample<agg::gray64> :
                 nullptr) : (
             // ndim == 3
-                (type == NPY_UINT8) ? resample<agg::rgba8> :
-                (type == NPY_INT8) ? resample<agg::rgba8> :
-                (type == NPY_UINT16) ? resample<agg::rgba16> :
-                (type == NPY_INT16) ? resample<agg::rgba16> :
-                (type == NPY_FLOAT32) ? resample<agg::rgba32> :
-                (type == NPY_FLOAT64) ? resample<agg::rgba64> :
+                (dtype.is(pybind11::dtype::of<std::uint8_t>())) ? resample<agg::rgba8> :
+                (dtype.is(pybind11::dtype::of<std::int8_t>())) ? resample<agg::rgba8> :
+                (dtype.is(pybind11::dtype::of<std::uint16_t>())) ? resample<agg::rgba16> :
+                (dtype.is(pybind11::dtype::of<std::int16_t>())) ? resample<agg::rgba16> :
+                (dtype.is(pybind11::dtype::of<float>())) ? resample<agg::rgba32> :
+                (dtype.is(pybind11::dtype::of<double>())) ? resample<agg::rgba64> :
                 nullptr)) {
         Py_BEGIN_ALLOW_THREADS
         resampler(
-            PyArray_DATA(input), PyArray_DIM(input, 1), PyArray_DIM(input, 0),
-            PyArray_DATA(output), PyArray_DIM(output, 1), PyArray_DIM(output, 0),
+            input_array.data(), input_array.shape(1), input_array.shape(0),
+            output_array.mutable_data(), output_array.shape(1), output_array.shape(0),
             params);
         Py_END_ALLOW_THREADS
-    } else {
-        PyErr_SetString(
-            PyExc_ValueError,
-            "arrays must be of dtype byte, short, float32 or float64");
-        goto error;
-    }
-
-    Py_DECREF(input);
-    Py_XDECREF(transform_mesh);
-    Py_RETURN_NONE;
-
- error:
-    Py_XDECREF(input);
-    Py_XDECREF(transform_mesh);
-    return NULL;
+    } else
+        throw std::invalid_argument("arrays must be of dtype byte, short, float32 or float64");
 }
 
-static PyMethodDef module_functions[] = {
-    {"resample", (PyCFunction)image_resample, METH_VARARGS|METH_KEYWORDS, image_resample__doc__},
-    {NULL}
-};
-
-static struct PyModuleDef moduledef = {
-    PyModuleDef_HEAD_INIT, "_image", NULL, 0, module_functions,
-};
-
-PyMODINIT_FUNC PyInit__image(void)
-{
-    PyObject *m;
-
-    import_array();
-
-    m = PyModule_Create(&moduledef);
-
-    if (m == NULL) {
-        return NULL;
-    }
-
-    if (PyModule_AddIntConstant(m, "NEAREST", NEAREST) ||
-        PyModule_AddIntConstant(m, "BILINEAR", BILINEAR) ||
-        PyModule_AddIntConstant(m, "BICUBIC", BICUBIC) ||
-        PyModule_AddIntConstant(m, "SPLINE16", SPLINE16) ||
-        PyModule_AddIntConstant(m, "SPLINE36", SPLINE36) ||
-        PyModule_AddIntConstant(m, "HANNING", HANNING) ||
-        PyModule_AddIntConstant(m, "HAMMING", HAMMING) ||
-        PyModule_AddIntConstant(m, "HERMITE", HERMITE) ||
-        PyModule_AddIntConstant(m, "KAISER", KAISER) ||
-        PyModule_AddIntConstant(m, "QUADRIC", QUADRIC) ||
-        PyModule_AddIntConstant(m, "CATROM", CATROM) ||
-        PyModule_AddIntConstant(m, "GAUSSIAN", GAUSSIAN) ||
-        PyModule_AddIntConstant(m, "BESSEL", BESSEL) ||
-        PyModule_AddIntConstant(m, "MITCHELL", MITCHELL) ||
-        PyModule_AddIntConstant(m, "SINC", SINC) ||
-        PyModule_AddIntConstant(m, "LANCZOS", LANCZOS) ||
-        PyModule_AddIntConstant(m, "BLACKMAN", BLACKMAN) ||
-        PyModule_AddIntConstant(m, "_n_interpolation", _n_interpolation)) {
-        Py_DECREF(m);
-        return NULL;
-    }
 
-    return m;
+PYBIND11_MODULE(_image, m) {
+    pybind11::enum_<interpolation_e>(m, "interpolation_e")
+        .value("NEAREST", NEAREST)
+        .value("BILINEAR", BILINEAR)
+        .value("BICUBIC", BICUBIC)
+        .value("SPLINE16", SPLINE16)
+        .value("SPLINE36", SPLINE36)
+        .value("HANNING", HANNING)
+        .value("HAMMING", HAMMING)
+        .value("HERMITE", HERMITE)
+        .value("KAISER", KAISER)
+        .value("QUADRIC", QUADRIC)
+        .value("CATROM", CATROM)
+        .value("GAUSSIAN", GAUSSIAN)
+        .value("BESSEL", BESSEL)
+        .value("MITCHELL", MITCHELL)
+        .value("SINC", SINC)
+        .value("LANCZOS", LANCZOS)
+        .value("BLACKMAN", BLACKMAN)
+        .value("_n_interpolation", _n_interpolation)
+        .export_values();
+
+    m.def("resample", &image_resample,
+        pybind11::arg("input_array"),
+        pybind11::arg("output_array"),
+        pybind11::arg("transform"),
+        pybind11::arg("interpolation") = interpolation_e::NEAREST,
+        pybind11::arg("resample") = false,
+        pybind11::arg("alpha") = 1,
+        pybind11::arg("norm") = false,
+        pybind11::arg("radius") = 1,
+        image_resample__doc__);
 }
diff --git a/src/py_converters_11.cpp b/src/py_converters_11.cpp
new file mode 100644
index 000000000000..fbcc8f809f44
--- /dev/null
+++ b/src/py_converters_11.cpp
@@ -0,0 +1,20 @@
+#include "py_converters_11.h"
+
+void convert_trans_affine(const pybind11::object& transform, agg::trans_affine& affine)
+{
+    // If None assume identity transform so leave affine unchanged
+    if (transform.is(pybind11::none()))
+        return;
+
+    auto array = pybind11::array_t<double, pybind11::array::c_style>::ensure(transform);
+    if (!array || array.ndim() != 2 || array.shape(0) != 3 || array.shape(1) != 3)
+        throw std::invalid_argument("Invalid affine transformation matrix");
+
+    auto buffer = array.data();
+    affine.sx = buffer[0];
+    affine.shx = buffer[1];
+    affine.tx = buffer[2];
+    affine.shy = buffer[3];
+    affine.sy = buffer[4];
+    affine.ty = buffer[5];
+}
diff --git a/src/py_converters_11.h b/src/py_converters_11.h
new file mode 100644
index 000000000000..1017b2a3e5c1
--- /dev/null
+++ b/src/py_converters_11.h
@@ -0,0 +1,13 @@
+#ifndef MPL_PY_CONVERTERS_11_H
+#define MPL_PY_CONVERTERS_11_H
+
+// pybind11 equivalent of py_converters.h
+
+#include <pybind11/pybind11.h>
+#include <pybind11/numpy.h>
+
+#include "agg_trans_affine.h"
+
+void convert_trans_affine(const pybind11::object& transform, agg::trans_affine& affine);
+
+#endif

From c14ad96e31898726f5841d9804363d9d4d4ba409 Mon Sep 17 00:00:00 2001
From: Ian Thomas <ianthomas23@gmail.com>
Date: Fri, 7 Jul 2023 11:32:18 +0100
Subject: [PATCH 0185/1120] Be explicit with array dimension types

---
 src/_image_wrapper.cpp | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/_image_wrapper.cpp b/src/_image_wrapper.cpp
index a63004ebb624..5167e196c9e5 100644
--- a/src/_image_wrapper.cpp
+++ b/src/_image_wrapper.cpp
@@ -51,7 +51,7 @@ const char* image_resample__doc__ =
 
 
 static pybind11::array_t<double> _get_transform_mesh(const pybind11::object& transform,
-                                                     const ssize_t *dims)
+                                                     const pybind11::ssize_t *dims)
 {
     /* TODO: Could we get away with float, rather than double, arrays here? */
 
@@ -62,7 +62,8 @@ static pybind11::array_t<double> _get_transform_mesh(const pybind11::object& tra
     // If attribute doesn't exist, raises Python AttributeError
     auto inverse = transform.attr("inverted")();
 
-    pybind11::array_t<double> input_mesh({dims[0]*dims[1], 2L});
+    pybind11::ssize_t mesh_dims[2] = {dims[0]*dims[2], 2};
+    pybind11::array_t<double> input_mesh(mesh_dims);
     auto p = input_mesh.mutable_data();
 
     for (auto y = 0; y < dims[0]; ++y) {

From 1a3c723dd8685cf6e8bd3f9f8bd9b15a77b94dd8 Mon Sep 17 00:00:00 2001
From: Ian Thomas <ianthomas23@gmail.com>
Date: Mon, 17 Jul 2023 09:48:19 +0100
Subject: [PATCH 0186/1120] Review comments

---
 src/_image_resample.h  | 2 --
 src/_image_wrapper.cpp | 5 ++---
 2 files changed, 2 insertions(+), 5 deletions(-)

diff --git a/src/_image_resample.h b/src/_image_resample.h
index 10763fb01d37..60f5e66d4539 100644
--- a/src/_image_resample.h
+++ b/src/_image_resample.h
@@ -496,7 +496,6 @@ typedef enum {
     SINC,
     LANCZOS,
     BLACKMAN,
-    _n_interpolation
 } interpolation_e;
 
 
@@ -629,7 +628,6 @@ static void get_filter(const resample_params_t &params,
 {
     switch (params.interpolation) {
     case NEAREST:
-    case _n_interpolation:
         // Never should get here.  Here to silence compiler warnings.
         break;
 
diff --git a/src/_image_wrapper.cpp b/src/_image_wrapper.cpp
index 5167e196c9e5..13178e734d36 100644
--- a/src/_image_wrapper.cpp
+++ b/src/_image_wrapper.cpp
@@ -62,7 +62,7 @@ static pybind11::array_t<double> _get_transform_mesh(const pybind11::object& tra
     // If attribute doesn't exist, raises Python AttributeError
     auto inverse = transform.attr("inverted")();
 
-    pybind11::ssize_t mesh_dims[2] = {dims[0]*dims[2], 2};
+    pybind11::ssize_t mesh_dims[2] = {dims[0]*dims[1], 2};
     pybind11::array_t<double> input_mesh(mesh_dims);
     auto p = input_mesh.mutable_data();
 
@@ -102,7 +102,7 @@ static void image_resample(pybind11::array input_array,
     auto dtype = input_array.dtype();  // Validated when determine resampler below
     auto ndim = input_array.ndim();
 
-    if (ndim < 2 || ndim > 3)
+    if (ndim != 2 && ndim != 3)
         throw std::invalid_argument("Input array must be a 2D or 3D array");
 
     if (ndim == 3 && input_array.shape(2) != 4)
@@ -211,7 +211,6 @@ PYBIND11_MODULE(_image, m) {
         .value("SINC", SINC)
         .value("LANCZOS", LANCZOS)
         .value("BLACKMAN", BLACKMAN)
-        .value("_n_interpolation", _n_interpolation)
         .export_values();
 
     m.def("resample", &image_resample,

From bfaf1a7d406f115b71ed25676825cbc4d1eb9c22 Mon Sep 17 00:00:00 2001
From: Ian Thomas <ianthomas23@gmail.com>
Date: Sun, 24 Sep 2023 14:08:37 +0100
Subject: [PATCH 0187/1120] Added curly braces around one-liners

---
 src/_image_wrapper.cpp   | 27 ++++++++++++++++++---------
 src/py_converters_11.cpp |  6 ++++--
 2 files changed, 22 insertions(+), 11 deletions(-)

diff --git a/src/_image_wrapper.cpp b/src/_image_wrapper.cpp
index 13178e734d36..93904d52bcc6 100644
--- a/src/_image_wrapper.cpp
+++ b/src/_image_wrapper.cpp
@@ -78,10 +78,11 @@ static pybind11::array_t<double> _get_transform_mesh(const pybind11::object& tra
     auto output_mesh_array =
         pybind11::array_t<double, pybind11::array::c_style | pybind11::array::forcecast>(output_mesh);
 
-    if (output_mesh_array.ndim() != 2)
+    if (output_mesh_array.ndim() != 2) {
         throw std::runtime_error(
             "Inverse transformed mesh array should be 2D not " +
             std::to_string(output_mesh_array.ndim()) + "D");
+    }
 
     return output_mesh_array;
 }
@@ -102,13 +103,15 @@ static void image_resample(pybind11::array input_array,
     auto dtype = input_array.dtype();  // Validated when determine resampler below
     auto ndim = input_array.ndim();
 
-    if (ndim != 2 && ndim != 3)
+    if (ndim != 2 && ndim != 3) {
         throw std::invalid_argument("Input array must be a 2D or 3D array");
+    }
 
-    if (ndim == 3 && input_array.shape(2) != 4)
+    if (ndim == 3 && input_array.shape(2) != 4) {
         throw std::invalid_argument(
             "3D input array must be RGBA with shape (M, N, 4), has trailing dimension of " +
             std::to_string(ndim));
+    }
 
     // Ensure input array is contiguous, regardless of dtype
     input_array = pybind11::array::ensure(input_array, pybind11::array::c_style);
@@ -116,24 +119,29 @@ static void image_resample(pybind11::array input_array,
     // Validate output array
     auto out_ndim = output_array.ndim();
 
-    if (out_ndim != ndim)
+    if (out_ndim != ndim) {
         throw std::invalid_argument(
             "Input (" + std::to_string(ndim) + "D) and output (" + std::to_string(out_ndim) +
             "D) arrays have different dimensionalities");
+    }
 
-    if (out_ndim == 3 && output_array.shape(2) != 4)
+    if (out_ndim == 3 && output_array.shape(2) != 4) {
         throw std::invalid_argument(
             "3D output array must be RGBA with shape (M, N, 4), has trailing dimension of " +
             std::to_string(out_ndim));
+    }
 
-    if (!output_array.dtype().is(dtype))
+    if (!output_array.dtype().is(dtype)) {
         throw std::invalid_argument("Input and output arrays have mismatched types");
+    }
 
-    if ((output_array.flags() & pybind11::array::c_style) == 0)
+    if ((output_array.flags() & pybind11::array::c_style) == 0) {
         throw std::invalid_argument("Output array must be C-contiguous");
+    }
 
-    if (!output_array.writeable())
+    if (!output_array.writeable()) {
         throw std::invalid_argument("Output array must be writeable");
+    }
 
     resample_params_t params;
     params.interpolation = interpolation;
@@ -187,8 +195,9 @@ static void image_resample(pybind11::array input_array,
             output_array.mutable_data(), output_array.shape(1), output_array.shape(0),
             params);
         Py_END_ALLOW_THREADS
-    } else
+    } else {
         throw std::invalid_argument("arrays must be of dtype byte, short, float32 or float64");
+    }
 }
 
 
diff --git a/src/py_converters_11.cpp b/src/py_converters_11.cpp
index fbcc8f809f44..47a5ec5b5a2c 100644
--- a/src/py_converters_11.cpp
+++ b/src/py_converters_11.cpp
@@ -3,12 +3,14 @@
 void convert_trans_affine(const pybind11::object& transform, agg::trans_affine& affine)
 {
     // If None assume identity transform so leave affine unchanged
-    if (transform.is(pybind11::none()))
+    if (transform.is(pybind11::none())) {
         return;
+    }
 
     auto array = pybind11::array_t<double, pybind11::array::c_style>::ensure(transform);
-    if (!array || array.ndim() != 2 || array.shape(0) != 3 || array.shape(1) != 3)
+    if (!array || array.ndim() != 2 || array.shape(0) != 3 || array.shape(1) != 3) {
         throw std::invalid_argument("Invalid affine transformation matrix");
+    }
 
     auto buffer = array.data();
     affine.sx = buffer[0];

From c417369d21d2d5c671abb420513401492b2e20a2 Mon Sep 17 00:00:00 2001
From: Ian Thomas <ianthomas23@gmail.com>
Date: Sun, 24 Sep 2023 14:20:18 +0100
Subject: [PATCH 0188/1120] Export _InterpolationType rather than
 interpolation_e

---
 src/_image_wrapper.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/_image_wrapper.cpp b/src/_image_wrapper.cpp
index 93904d52bcc6..a41b803f7146 100644
--- a/src/_image_wrapper.cpp
+++ b/src/_image_wrapper.cpp
@@ -202,7 +202,7 @@ static void image_resample(pybind11::array input_array,
 
 
 PYBIND11_MODULE(_image, m) {
-    pybind11::enum_<interpolation_e>(m, "interpolation_e")
+    pybind11::enum_<interpolation_e>(m, "_InterpolationType")
         .value("NEAREST", NEAREST)
         .value("BILINEAR", BILINEAR)
         .value("BICUBIC", BICUBIC)

From 5d90e482eace4312ad696a9cdf3aa85d3cba4fc8 Mon Sep 17 00:00:00 2001
From: Ian Thomas <ianthomas23@gmail.com>
Date: Sun, 24 Sep 2023 14:28:57 +0100
Subject: [PATCH 0189/1120] Miscellaneous review comments

---
 src/_image_wrapper.cpp   | 28 +++++++++++++---------------
 src/py_converters_11.cpp |  2 +-
 2 files changed, 14 insertions(+), 16 deletions(-)

diff --git a/src/_image_wrapper.cpp b/src/_image_wrapper.cpp
index a41b803f7146..179f8d1301f7 100644
--- a/src/_image_wrapper.cpp
+++ b/src/_image_wrapper.cpp
@@ -10,9 +10,6 @@
  * */
 
 const char* image_resample__doc__ =
-"resample(input_array, output_array, transform, interpolation=NEAREST, resample=False, alpha=1.0, norm=False, radius=1.0)\n"
-"--\n\n"
-
 "Resample input_array, blending it in-place into output_array, using an\n"
 "affine transformation.\n\n"
 
@@ -50,8 +47,8 @@ const char* image_resample__doc__ =
 "    The radius of the kernel, if method is SINC, LANCZOS or BLACKMAN.\n";
 
 
-static pybind11::array_t<double> _get_transform_mesh(const pybind11::object& transform,
-                                                     const pybind11::ssize_t *dims)
+static pybind11::array_t<double>
+_get_transform_mesh(const pybind11::object& transform, const pybind11::ssize_t *dims)
 {
     /* TODO: Could we get away with float, rather than double, arrays here? */
 
@@ -90,14 +87,15 @@ static pybind11::array_t<double> _get_transform_mesh(const pybind11::object& tra
 
 // Using generic pybind::array for input and output arrays rather than the more usual
 // pybind::array_t<type> as function supports multiple array dtypes.
-static void image_resample(pybind11::array input_array,
-                           pybind11::array& output_array,
-                           const pybind11::object& transform,
-                           interpolation_e interpolation,
-                           bool resample_,  // Avoid name clash with resample() function
-                           float alpha,
-                           bool norm,
-                           float radius)
+static void
+image_resample(pybind11::array input_array,
+               pybind11::array& output_array,
+               const pybind11::object& transform,
+               interpolation_e interpolation,
+               bool resample_,  // Avoid name clash with resample() function
+               float alpha,
+               bool norm,
+               float radius)
 {
     // Validate input_array
     auto dtype = input_array.dtype();  // Validated when determine resampler below
@@ -110,7 +108,7 @@ static void image_resample(pybind11::array input_array,
     if (ndim == 3 && input_array.shape(2) != 4) {
         throw std::invalid_argument(
             "3D input array must be RGBA with shape (M, N, 4), has trailing dimension of " +
-            std::to_string(ndim));
+            std::to_string(input_array.shape(2)));
     }
 
     // Ensure input array is contiguous, regardless of dtype
@@ -128,7 +126,7 @@ static void image_resample(pybind11::array input_array,
     if (out_ndim == 3 && output_array.shape(2) != 4) {
         throw std::invalid_argument(
             "3D output array must be RGBA with shape (M, N, 4), has trailing dimension of " +
-            std::to_string(out_ndim));
+            std::to_string(output_array.shape(2)));
     }
 
     if (!output_array.dtype().is(dtype)) {
diff --git a/src/py_converters_11.cpp b/src/py_converters_11.cpp
index 47a5ec5b5a2c..982cc9ac6c46 100644
--- a/src/py_converters_11.cpp
+++ b/src/py_converters_11.cpp
@@ -3,7 +3,7 @@
 void convert_trans_affine(const pybind11::object& transform, agg::trans_affine& affine)
 {
     // If None assume identity transform so leave affine unchanged
-    if (transform.is(pybind11::none())) {
+    if (transform.is_none()) {
         return;
     }
 

From 1c054c482388607586cad067af70bf891053ee6e Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Sun, 24 Sep 2023 09:32:36 +0100
Subject: [PATCH 0190/1120] MNT: only account for Artists once in
 fig.get_tightbbox

---
 lib/matplotlib/figure.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
index c750095aee18..2b83a7ae4a73 100644
--- a/lib/matplotlib/figure.py
+++ b/lib/matplotlib/figure.py
@@ -1710,7 +1710,9 @@ def get_tightbbox(self, renderer=None, bbox_extra_artists=None):
 
         bb = []
         if bbox_extra_artists is None:
-            artists = self.get_default_bbox_extra_artists()
+            artists = [artist for artist in self.get_children()
+                       if (artist not in self.axes and artist.get_visible()
+                           and artist.get_in_layout())]
         else:
             artists = bbox_extra_artists
 

From 96b094484b7b21c31bd64076220ad3eaa0583839 Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Mon, 25 Sep 2023 11:32:20 +0100
Subject: [PATCH 0191/1120] allsegs and allkinds return individual segments

---
 lib/matplotlib/contour.py            |  6 ++++--
 lib/matplotlib/tests/test_contour.py | 18 ++++++++++++++----
 2 files changed, 18 insertions(+), 6 deletions(-)

diff --git a/lib/matplotlib/contour.py b/lib/matplotlib/contour.py
index efea024dc102..2725dd6340a4 100644
--- a/lib/matplotlib/contour.py
+++ b/lib/matplotlib/contour.py
@@ -935,9 +935,11 @@ def __init__(self, ax, *args,
             )
 
     allsegs = _api.deprecated("3.8", pending=True)(property(lambda self: [
-        p.vertices for c in self.collections for p in c.get_paths()]))
+        [subp.vertices for subp in p._iter_connected_components()]
+        for p in self.get_paths()]))
     allkinds = _api.deprecated("3.8", pending=True)(property(lambda self: [
-        p.codes for c in self.collections for p in c.get_paths()]))
+        [subp.codes for subp in p._iter_connected_components()]
+        for p in self.get_paths()]))
     tcolors = _api.deprecated("3.8")(property(lambda self: [
         (tuple(rgba),) for rgba in self.to_rgba(self.cvalues, self.alpha)]))
     tlinewidths = _api.deprecated("3.8")(property(lambda self: [
diff --git a/lib/matplotlib/tests/test_contour.py b/lib/matplotlib/tests/test_contour.py
index 4a32fdc6ce32..c911d499ea96 100644
--- a/lib/matplotlib/tests/test_contour.py
+++ b/lib/matplotlib/tests/test_contour.py
@@ -819,14 +819,24 @@ def test_all_nan():
                                 2.4e-14, 5e-14, 7.5e-14, 1e-13])
 
 
+def test_allsegs_allkinds():
+    x, y = np.meshgrid(np.arange(0, 10, 2), np.arange(0, 10, 2))
+    z = np.sin(x) * np.cos(y)
+
+    cs = plt.contour(x, y, z, levels=[0, 0.5])
+
+    # Expect two levels, first with 5 segments and the second with 4.
+    with pytest.warns(PendingDeprecationWarning, match="all"):
+        for result in [cs.allsegs, cs.allkinds]:
+            assert len(result) == 2
+            assert len(result[0]) == 5
+            assert len(result[1]) == 4
+
+
 def test_deprecated_apis():
     cs = plt.contour(np.arange(16).reshape((4, 4)))
     with pytest.warns(mpl.MatplotlibDeprecationWarning, match="collections"):
         colls = cs.collections
-    with pytest.warns(PendingDeprecationWarning, match="allsegs"):
-        assert cs.allsegs == [p.vertices for c in colls for p in c.get_paths()]
-    with pytest.warns(PendingDeprecationWarning, match="allkinds"):
-        assert cs.allkinds == [p.codes for c in colls for p in c.get_paths()]
     with pytest.warns(mpl.MatplotlibDeprecationWarning, match="tcolors"):
         assert_array_equal(cs.tcolors, [c.get_edgecolor() for c in colls])
     with pytest.warns(mpl.MatplotlibDeprecationWarning, match="tlinewidths"):

From 0c6a3b0d2cb5de809a928dc6e3b0fb4f713e8fb0 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Fri, 22 Sep 2023 17:23:02 -0500
Subject: [PATCH 0192/1120] Rework axes/__init__.pyi to not use __all__

---
 lib/matplotlib/axes/__init__.pyi | 13 +++++--------
 lib/matplotlib/axes/_base.pyi    |  1 -
 2 files changed, 5 insertions(+), 9 deletions(-)

diff --git a/lib/matplotlib/axes/__init__.pyi b/lib/matplotlib/axes/__init__.pyi
index d885677b63de..7df38b8bde9e 100644
--- a/lib/matplotlib/axes/__init__.pyi
+++ b/lib/matplotlib/axes/__init__.pyi
@@ -1,16 +1,13 @@
-__all__ = [
-    'Axes',
-    'Subplot',
-    'SubplotBase',
-]
-
 from typing import TypeVar
 
-from ._axes import *
-from ._axes import Axes as Subplot
+from ._axes import Axes as Axes
+
 
 _T = TypeVar("_T")
 
+# Backcompat.
+Subplot = Axes
+
 class _SubplotBaseMeta(type):
     def __instancecheck__(self, obj) -> bool: ...
 
diff --git a/lib/matplotlib/axes/_base.pyi b/lib/matplotlib/axes/_base.pyi
index a8a47f819446..cac66d354245 100644
--- a/lib/matplotlib/axes/_base.pyi
+++ b/lib/matplotlib/axes/_base.pyi
@@ -131,7 +131,6 @@ class _AxesBase(martist.Artist):
     def clear(self) -> None: ...
     def cla(self) -> None: ...
 
-    # Could be made generic, but comments indicate it may be temporary anyway
     class ArtistList(Sequence[_T]):
         def __init__(
             self,

From 84915614d61840af07d286ebcf930f940030bf96 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jo=C3=A3o=20Andrade?=
 <49215007+jpgianfaldoni@users.noreply.github.com>
Date: Mon, 25 Sep 2023 20:15:10 -0300
Subject: [PATCH 0193/1120] Removed the deprecated code from offsetbox.py
 (#26910)

* Removed the deprecated code from offsetbox.py

* fix spacing

* add rst file

* fix title underline

* fix rst file

* make lowercase

* Update doc/api/next_api_changes/removals/26910-JP.rst

Co-authored-by: Kyle Sunden <git@ksunden.space>

* Update doc/api/next_api_changes/removals/26910-JP.rst

Co-authored-by: Ruth Comer <10599679+rcomer@users.noreply.github.com>

---------

Co-authored-by: Kyle Sunden <git@ksunden.space>
Co-authored-by: Ruth Comer <10599679+rcomer@users.noreply.github.com>
---
 .../next_api_changes/removals/26910-JP.rst    | 13 ++++++++
 lib/matplotlib/offsetbox.py                   | 32 -------------------
 lib/matplotlib/offsetbox.pyi                  |  7 ----
 3 files changed, 13 insertions(+), 39 deletions(-)
 create mode 100644 doc/api/next_api_changes/removals/26910-JP.rst

diff --git a/doc/api/next_api_changes/removals/26910-JP.rst b/doc/api/next_api_changes/removals/26910-JP.rst
new file mode 100644
index 000000000000..0de12cd89ad5
--- /dev/null
+++ b/doc/api/next_api_changes/removals/26910-JP.rst
@@ -0,0 +1,13 @@
+``offsetbox.bbox_artist``
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+... is removed. This was just a wrapper to call `.patches.bbox_artist` if a flag is set in the file, so use that directly if you need the behavior.
+
+``offsetBox.get_extent_offsets`` and ``offsetBox.get_extent``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+... are removed; these methods are also removed on all subclasses of `.OffsetBox`.
+
+... To get the offsetbox extents, instead of ``get_extent``, use `.OffsetBox.get_bbox`, which directly returns a `.Bbox` instance.
+
+... To also get the child offsets, instead of ``get_extent_offsets``, separately call `~.OffsetBox.get_offset` on each children after triggering a draw.
diff --git a/lib/matplotlib/offsetbox.py b/lib/matplotlib/offsetbox.py
index bb117c38cece..acf93f5a34d9 100644
--- a/lib/matplotlib/offsetbox.py
+++ b/lib/matplotlib/offsetbox.py
@@ -61,12 +61,6 @@ def get_offset(self, *args, **kwargs):
     return get_offset
 
 
-@_api.deprecated("3.7", alternative='patches.bbox_artist')
-def bbox_artist(*args, **kwargs):
-    if DEBUG:
-        mbbox_artist(*args, **kwargs)
-
-
 # for debugging use
 def _bbox_artist(*args, **kwargs):
     if DEBUG:
@@ -366,32 +360,6 @@ def get_bbox(self, renderer):
         bbox, offsets = self._get_bbox_and_child_offsets(renderer)
         return bbox
 
-    @_api.deprecated("3.7", alternative="get_bbox and child.get_offset")
-    def get_extent_offsets(self, renderer):
-        """
-        Update offset of the children and return the extent of the box.
-
-        Parameters
-        ----------
-        renderer : `.RendererBase` subclass
-
-        Returns
-        -------
-        width
-        height
-        xdescent
-        ydescent
-        list of (xoffset, yoffset) pairs
-        """
-        bbox, offsets = self._get_bbox_and_child_offsets(renderer)
-        return bbox.width, bbox.height, -bbox.x0, -bbox.y0, offsets
-
-    @_api.deprecated("3.7", alternative="get_bbox")
-    def get_extent(self, renderer):
-        """Return a tuple ``width, height, xdescent, ydescent`` of the box."""
-        bbox = self.get_bbox(renderer)
-        return bbox.width, bbox.height, -bbox.x0, -bbox.y0
-
     def get_window_extent(self, renderer=None):
         # docstring inherited
         if renderer is None:
diff --git a/lib/matplotlib/offsetbox.pyi b/lib/matplotlib/offsetbox.pyi
index 7d7f4d8f67ec..09f89aed2bc8 100644
--- a/lib/matplotlib/offsetbox.pyi
+++ b/lib/matplotlib/offsetbox.pyi
@@ -15,7 +15,6 @@ from typing import Any, Literal, overload
 
 DEBUG: bool
 
-def bbox_artist(*args, **kwargs) -> None: ...
 def _get_packed_offsets(
     widths: Sequence[float],
     total: float | None,
@@ -51,12 +50,6 @@ class OffsetBox(martist.Artist):
     def get_visible_children(self) -> list[martist.Artist]: ...
     def get_children(self) -> list[martist.Artist]: ...
     def get_bbox(self, renderer: RendererBase) -> Bbox: ...
-    def get_extent_offsets(
-        self, renderer: RendererBase
-    ) -> tuple[float, float, float, float, list[tuple[float, float]]]: ...
-    def get_extent(
-        self, renderer: RendererBase
-    ) -> tuple[float, float, float, float]: ...
     def get_window_extent(self, renderer: RendererBase | None = ...) -> Bbox: ...
 
 class PackerBase(OffsetBox):

From a6d0029803dcbd74ad46f38f8520bc08db5d05d4 Mon Sep 17 00:00:00 2001
From: Ananya Devarakonda <57040724+ananya314@users.noreply.github.com>
Date: Fri, 22 Sep 2023 18:36:11 -0400
Subject: [PATCH 0194/1120] removed deprecated code from gridspec.py

Co-Authored-By: Elliott Sales de Andrade <quantum.analyst@gmail.com>
---
 ci/mypy-stubtest-allowlist.txt                |  1 -
 .../next_api_changes/removals/26885-AD.rst    |  4 +++
 lib/matplotlib/gridspec.py                    | 31 +++++--------------
 lib/matplotlib/gridspec.pyi                   |  2 +-
 4 files changed, 13 insertions(+), 25 deletions(-)
 create mode 100644 doc/api/next_api_changes/removals/26885-AD.rst

diff --git a/ci/mypy-stubtest-allowlist.txt b/ci/mypy-stubtest-allowlist.txt
index 64fae8d44562..e0890b3f7117 100644
--- a/ci/mypy-stubtest-allowlist.txt
+++ b/ci/mypy-stubtest-allowlist.txt
@@ -53,7 +53,6 @@ matplotlib.figure.Figure.set_tight_layout
 matplotlib.cm.register_cmap
 matplotlib.cm.unregister_cmap
 matplotlib.collections.PolyCollection.span_where
-matplotlib.gridspec.GridSpecBase.get_grid_positions
 
 # 3.8 deprecations
 matplotlib.cbook.get_sample_data
diff --git a/doc/api/next_api_changes/removals/26885-AD.rst b/doc/api/next_api_changes/removals/26885-AD.rst
new file mode 100644
index 000000000000..c617f10d07ed
--- /dev/null
+++ b/doc/api/next_api_changes/removals/26885-AD.rst
@@ -0,0 +1,4 @@
+``raw`` parameter
+~~~~~~~~~~~~~~~~~
+
+... of `.GridSpecBase.get_grid_positions` is removed without replacements.
diff --git a/lib/matplotlib/gridspec.py b/lib/matplotlib/gridspec.py
index 13a7d29ca563..0b93ea93dd3d 100644
--- a/lib/matplotlib/gridspec.py
+++ b/lib/matplotlib/gridspec.py
@@ -141,8 +141,7 @@ def get_height_ratios(self):
         """
         return self._row_height_ratios
 
-    @_api.delete_parameter("3.7", "raw")
-    def get_grid_positions(self, fig, raw=False):
+    def get_grid_positions(self, fig):
         """
         Return the positions of the grid cells in figure coordinates.
 
@@ -151,11 +150,6 @@ def get_grid_positions(self, fig, raw=False):
         fig : `~matplotlib.figure.Figure`
             The figure the grid should be applied to. The subplot parameters
             (margins and spacing between subplots) are taken from *fig*.
-        raw : bool, default: False
-            If *True*, the subplot parameters of the figure are not taken
-            into account. The grid spans the range [0, 1] in both directions
-            without margins and there is no space between grid cells. This is
-            used for constrained_layout.
 
         Returns
         -------
@@ -164,22 +158,13 @@ def get_grid_positions(self, fig, raw=False):
             figure coordinates.
         """
         nrows, ncols = self.get_geometry()
-
-        if raw:
-            left = 0.
-            right = 1.
-            bottom = 0.
-            top = 1.
-            wspace = 0.
-            hspace = 0.
-        else:
-            subplot_params = self.get_subplot_params(fig)
-            left = subplot_params.left
-            right = subplot_params.right
-            bottom = subplot_params.bottom
-            top = subplot_params.top
-            wspace = subplot_params.wspace
-            hspace = subplot_params.hspace
+        subplot_params = self.get_subplot_params(fig)
+        left = subplot_params.left
+        right = subplot_params.right
+        bottom = subplot_params.bottom
+        top = subplot_params.top
+        wspace = subplot_params.wspace
+        hspace = subplot_params.hspace
         tot_width = right - left
         tot_height = top - bottom
 
diff --git a/lib/matplotlib/gridspec.pyi b/lib/matplotlib/gridspec.pyi
index 6f314054a9ee..1ac1bb0b40e7 100644
--- a/lib/matplotlib/gridspec.pyi
+++ b/lib/matplotlib/gridspec.pyi
@@ -30,7 +30,7 @@ class GridSpecBase:
     def set_height_ratios(self, height_ratios: ArrayLike | None) -> None: ...
     def get_height_ratios(self) -> ArrayLike: ...
     def get_grid_positions(
-        self, fig: Figure, raw: bool = ...
+        self, fig: Figure
     ) -> tuple[np.ndarray, np.ndarray, np.ndarray, np.ndarray]: ...
     @staticmethod
     def _check_gridspec_exists(figure: Figure, nrows: int, ncols: int) -> GridSpec: ...

From e64af30e42dd1f2af7584021ee1f6bdd595cce59 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Mon, 25 Sep 2023 23:02:03 -0500
Subject: [PATCH 0195/1120] Add additional public attrs

---
 lib/matplotlib/axes/_base.pyi | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/lib/matplotlib/axes/_base.pyi b/lib/matplotlib/axes/_base.pyi
index cac66d354245..c63d81992389 100644
--- a/lib/matplotlib/axes/_base.pyi
+++ b/lib/matplotlib/axes/_base.pyi
@@ -59,6 +59,8 @@ class _AxesBase(martist.Artist):
     containers: list[Container]
     callbacks: CallbackRegistry
     child_axes: list[_AxesBase]
+    legend_: Legend | None
+    title: Text
     _projection_init: Any
 
     def __init__(

From a9523f5fbc9552d088f7759f918d0c1ab766d236 Mon Sep 17 00:00:00 2001
From: rsp2210 <rushikeshp2210@gmail.com>
Date: Mon, 25 Sep 2023 22:46:28 -0700
Subject: [PATCH 0196/1120] Resolved squash conflict and applied changes

---
 doc/api/next_api_changes/behavior/26902-RP.rst |  5 +++++
 lib/matplotlib/lines.py                        | 18 ++----------------
 lib/matplotlib/tests/test_lines.py             |  7 ++-----
 3 files changed, 9 insertions(+), 21 deletions(-)
 create mode 100644 doc/api/next_api_changes/behavior/26902-RP.rst

diff --git a/doc/api/next_api_changes/behavior/26902-RP.rst b/doc/api/next_api_changes/behavior/26902-RP.rst
new file mode 100644
index 000000000000..3106de94fbd5
--- /dev/null
+++ b/doc/api/next_api_changes/behavior/26902-RP.rst
@@ -0,0 +1,5 @@
+``Line2D``
+~~~~~~~~~~
+
+When creating a Line2D or using `.Line2D.set_xdata` and `.Line2D.set_ydata`,
+passing x/y data as non sequence is now an error.
diff --git a/lib/matplotlib/lines.py b/lib/matplotlib/lines.py
index 92d55a3fe6ae..31b931a52c82 100644
--- a/lib/matplotlib/lines.py
+++ b/lib/matplotlib/lines.py
@@ -1276,14 +1276,7 @@ def set_xdata(self, x):
         x : 1D array
         """
         if not np.iterable(x):
-            # When deprecation cycle is completed
-            # raise RuntimeError('x must be a sequence')
-            _api.warn_deprecated(
-                since="3.7",
-                message="Setting data with a non sequence type "
-                "is deprecated since %(since)s and will be "
-                "remove %(removal)s")
-            x = [x, ]
+            raise RuntimeError('x must be a sequence')
         self._xorig = copy.copy(x)
         self._invalidx = True
         self.stale = True
@@ -1297,14 +1290,7 @@ def set_ydata(self, y):
         y : 1D array
         """
         if not np.iterable(y):
-            # When deprecation cycle is completed
-            # raise RuntimeError('y must be a sequence')
-            _api.warn_deprecated(
-                since="3.7",
-                message="Setting data with a non sequence type "
-                "is deprecated since %(since)s and will be "
-                "remove %(removal)s")
-            y = [y, ]
+            raise RuntimeError('y must be a sequence')
         self._yorig = copy.copy(y)
         self._invalidy = True
         self.stale = True
diff --git a/lib/matplotlib/tests/test_lines.py b/lib/matplotlib/tests/test_lines.py
index 4f23e6969b0b..68e378a20f88 100644
--- a/lib/matplotlib/tests/test_lines.py
+++ b/lib/matplotlib/tests/test_lines.py
@@ -92,12 +92,9 @@ def test_invalid_line_data():
         mlines.Line2D([], 1)
 
     line = mlines.Line2D([], [])
-    # when deprecation cycle is completed
-    # with pytest.raises(RuntimeError, match='x must be'):
-    with pytest.warns(mpl.MatplotlibDeprecationWarning):
+    with pytest.raises(RuntimeError, match='x must be'):
         line.set_xdata(0)
-    # with pytest.raises(RuntimeError, match='y must be'):
-    with pytest.warns(mpl.MatplotlibDeprecationWarning):
+    with pytest.raises(RuntimeError, match='y must be'):
         line.set_ydata(0)
 
 

From a711b12b0866a721686be49b7a694bae3abd29cc Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Tue, 26 Sep 2023 15:26:11 -0500
Subject: [PATCH 0197/1120] Add tool for running stubtest

Walks the ast to find delete_parameter calls and automatically ignores them as their signature is modified at runtime

Could potentially be further modified to respect the alias behavior, which is the majority of the current allowlist

Makes running stubtest easier as now it is just 'python tools/stubtest.py', rather than a long incantation with multiple arguments
---
 .github/workflows/mypy-stubtest.yml |  5 +--
 ci/mypy-stubtest-allowlist.txt      |  3 --
 doc/devel/contribute.rst            | 16 ++++-----
 tools/stubtest.py                   | 53 +++++++++++++++++++++++++++++
 4 files changed, 60 insertions(+), 17 deletions(-)
 create mode 100644 tools/stubtest.py

diff --git a/.github/workflows/mypy-stubtest.yml b/.github/workflows/mypy-stubtest.yml
index 6da6f607642c..4cb225258f4f 100644
--- a/.github/workflows/mypy-stubtest.yml
+++ b/.github/workflows/mypy-stubtest.yml
@@ -37,10 +37,7 @@ jobs:
           REVIEWDOG_GITHUB_API_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
           set -o pipefail
-          MPLBACKEND=agg python -m mypy.stubtest \
-            --mypy-config-file pyproject.toml \
-            --allowlist ci/mypy-stubtest-allowlist.txt \
-            matplotlib | \
+          MPLBACKEND=agg python tools/stubtest.py | \
               reviewdog \
                 -efm '%Eerror: %m' \
                 -efm '%CStub: in file %f:%l' \
diff --git a/ci/mypy-stubtest-allowlist.txt b/ci/mypy-stubtest-allowlist.txt
index e0890b3f7117..5474d6fc5087 100644
--- a/ci/mypy-stubtest-allowlist.txt
+++ b/ci/mypy-stubtest-allowlist.txt
@@ -55,13 +55,10 @@ matplotlib.cm.unregister_cmap
 matplotlib.collections.PolyCollection.span_where
 
 # 3.8 deprecations
-matplotlib.cbook.get_sample_data
 matplotlib.contour.ContourSet.allkinds
 matplotlib.contour.ContourSet.allsegs
 matplotlib.contour.ContourSet.tcolors
 matplotlib.contour.ContourSet.tlinewidths
-matplotlib.ticker.LogLocator.__init__
-matplotlib.ticker.LogLocator.set_params
 
 # positional-only argument name lacking leading underscores
 matplotlib.axes._base._AxesBase.axis
diff --git a/doc/devel/contribute.rst b/doc/devel/contribute.rst
index 9b53a80ab374..85c061b7ce8f 100644
--- a/doc/devel/contribute.rst
+++ b/doc/devel/contribute.rst
@@ -425,11 +425,7 @@ Introducing
      updated on introduction.
    - Items decorated with ``@_api.delete_parameter`` should include a default value hint
      for the deleted parameter, even if it did not previously have one (e.g.
-     ``param: <type> = ...``). Even so, the decorator changes the default value to a
-     sentinel value which should not be included in the type stub. Thus, Mypy Stubtest
-     needs to be informed of the inconsistency by placing the method into
-     :file:`ci/mypy-stubtest-allowlist.txt` under a heading indicating the deprecation
-     version number.
+     ``param: <type> = ...``).
 
 Expiring
 ~~~~~~~~
@@ -452,11 +448,11 @@ Expiring
      will have been updated at introduction, and require no change now.
    - Items decorated with ``@_api.delete_parameter`` will need to be updated to the
      final signature, in the same way as the ``.py`` file signature is updated.
-     The entry in :file:`ci/mypy-stubtest-allowlist.txt` should be removed.
-   - Any other entries in :file:`ci/mypy-stubtest-allowlist.txt` under a version's
-     deprecations should be double checked, as only ``delete_parameter`` should normally
-     require that mechanism for deprecation. For removed items that were not in the stub
-     file, only deleting from the allowlist is required.
+   - Any entries in :file:`ci/mypy-stubtest-allowlist.txt` which indicate a deprecation
+     version should be double checked. In most cases this is not needed, though some
+     items were never type hinted in the first place and were added to this file
+     instead. For removed items that were not in the stub file, only deleting from the
+     allowlist is required.
 
 Adding new API
 --------------
diff --git a/tools/stubtest.py b/tools/stubtest.py
new file mode 100644
index 000000000000..a68f3ab5c3b3
--- /dev/null
+++ b/tools/stubtest.py
@@ -0,0 +1,53 @@
+import ast
+import pathlib
+import subprocess
+import sys
+import tempfile
+
+root = pathlib.Path(__file__).parent.parent
+
+lib = root / "lib"
+mpl = lib / "matplotlib"
+
+
+class Visitor(ast.NodeVisitor):
+    def __init__(self, filepath, output):
+        self.filepath = filepath
+        self.context = list(filepath.with_suffix("").relative_to(lib).parts)
+        self.output = output
+
+    def visit_FunctionDef(self, node):
+        if any("delete_parameter" in ast.unparse(line) for line in node.decorator_list):
+            parents = []
+            if hasattr(node, "parent"):
+                parent = node.parent
+                while hasattr(parent, "parent") and not isinstance(parent, ast.Module):
+                    parents.append(parent.name)
+                    parent = parent.parent
+            self.output.write(f"{'.'.join(self.context + parents)}.{node.name}\n")
+
+
+with tempfile.NamedTemporaryFile("wt") as f:
+    for path in mpl.glob("**/*.py"):
+        v = Visitor(path, f)
+        tree = ast.parse(path.read_text())
+
+        # Assign parents to tree so they can be backtraced
+        for node in ast.walk(tree):
+            for child in ast.iter_child_nodes(node):
+                child.parent = node
+
+        v.visit(tree)
+    f.flush()
+    proc = subprocess.run(
+        [
+            "stubtest",
+            "--mypy-config-file=pyproject.toml",
+            "--allowlist=ci/mypy-stubtest-allowlist.txt",
+            f"--allowlist={f.name}",
+            "matplotlib",
+        ],
+        cwd=root,
+    )
+
+sys.exit(proc.returncode)

From a59c2680dc176744282be1173f6a90cfb475d909 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Tue, 26 Sep 2023 17:47:27 -0500
Subject: [PATCH 0198/1120] Add alias decorator handling to the generated
 allowlist

---
 ci/mypy-stubtest-allowlist.txt | 82 ----------------------------------
 tools/stubtest.py              | 28 +++++++++++-
 2 files changed, 27 insertions(+), 83 deletions(-)

diff --git a/ci/mypy-stubtest-allowlist.txt b/ci/mypy-stubtest-allowlist.txt
index 5474d6fc5087..4cbbcac94dcf 100644
--- a/ci/mypy-stubtest-allowlist.txt
+++ b/ci/mypy-stubtest-allowlist.txt
@@ -63,88 +63,6 @@ matplotlib.contour.ContourSet.tlinewidths
 # positional-only argument name lacking leading underscores
 matplotlib.axes._base._AxesBase.axis
 
-# Aliases (dynamically generated, not type hinted)
-matplotlib.collections.Collection.get_aa
-matplotlib.collections.Collection.get_antialiaseds
-matplotlib.collections.Collection.get_dashes
-matplotlib.collections.Collection.get_ec
-matplotlib.collections.Collection.get_edgecolors
-matplotlib.collections.Collection.get_facecolors
-matplotlib.collections.Collection.get_fc
-matplotlib.collections.Collection.get_linestyles
-matplotlib.collections.Collection.get_linewidths
-matplotlib.collections.Collection.get_ls
-matplotlib.collections.Collection.get_lw
-matplotlib.collections.Collection.get_transOffset
-matplotlib.collections.Collection.set_aa
-matplotlib.collections.Collection.set_antialiaseds
-matplotlib.collections.Collection.set_dashes
-matplotlib.collections.Collection.set_ec
-matplotlib.collections.Collection.set_edgecolors
-matplotlib.collections.Collection.set_facecolors
-matplotlib.collections.Collection.set_fc
-matplotlib.collections.Collection.set_linestyles
-matplotlib.collections.Collection.set_linewidths
-matplotlib.collections.Collection.set_ls
-matplotlib.collections.Collection.set_lw
-matplotlib.collections.Collection.set_transOffset
-matplotlib.lines.Line2D.get_aa
-matplotlib.lines.Line2D.get_c
-matplotlib.lines.Line2D.get_ds
-matplotlib.lines.Line2D.get_ls
-matplotlib.lines.Line2D.get_lw
-matplotlib.lines.Line2D.get_mec
-matplotlib.lines.Line2D.get_mew
-matplotlib.lines.Line2D.get_mfc
-matplotlib.lines.Line2D.get_mfcalt
-matplotlib.lines.Line2D.get_ms
-matplotlib.lines.Line2D.set_aa
-matplotlib.lines.Line2D.set_c
-matplotlib.lines.Line2D.set_ds
-matplotlib.lines.Line2D.set_ls
-matplotlib.lines.Line2D.set_lw
-matplotlib.lines.Line2D.set_mec
-matplotlib.lines.Line2D.set_mew
-matplotlib.lines.Line2D.set_mfc
-matplotlib.lines.Line2D.set_mfcalt
-matplotlib.lines.Line2D.set_ms
-matplotlib.patches.Patch.get_aa
-matplotlib.patches.Patch.get_ec
-matplotlib.patches.Patch.get_fc
-matplotlib.patches.Patch.get_ls
-matplotlib.patches.Patch.get_lw
-matplotlib.patches.Patch.set_aa
-matplotlib.patches.Patch.set_ec
-matplotlib.patches.Patch.set_fc
-matplotlib.patches.Patch.set_ls
-matplotlib.patches.Patch.set_lw
-matplotlib.text.Text.get_c
-matplotlib.text.Text.get_family
-matplotlib.text.Text.get_font
-matplotlib.text.Text.get_font_properties
-matplotlib.text.Text.get_ha
-matplotlib.text.Text.get_name
-matplotlib.text.Text.get_size
-matplotlib.text.Text.get_style
-matplotlib.text.Text.get_va
-matplotlib.text.Text.get_variant
-matplotlib.text.Text.get_weight
-matplotlib.text.Text.set_c
-matplotlib.text.Text.set_family
-matplotlib.text.Text.set_font
-matplotlib.text.Text.set_font_properties
-matplotlib.text.Text.set_ha
-matplotlib.text.Text.set_ma
-matplotlib.text.Text.set_name
-matplotlib.text.Text.set_size
-matplotlib.text.Text.set_stretch
-matplotlib.text.Text.set_style
-matplotlib.text.Text.set_va
-matplotlib.text.Text.set_variant
-matplotlib.text.Text.set_weight
-matplotlib.axes._base._AxesBase.get_fc
-matplotlib.axes._base._AxesBase.set_fc
-
 # Other dynamic python behaviors not type hinted
 matplotlib.rcsetup.defaultParams
 
diff --git a/tools/stubtest.py b/tools/stubtest.py
index a68f3ab5c3b3..3f3c6931255f 100644
--- a/tools/stubtest.py
+++ b/tools/stubtest.py
@@ -1,4 +1,5 @@
 import ast
+import os
 import pathlib
 import subprocess
 import sys
@@ -22,10 +23,34 @@ def visit_FunctionDef(self, node):
             if hasattr(node, "parent"):
                 parent = node.parent
                 while hasattr(parent, "parent") and not isinstance(parent, ast.Module):
-                    parents.append(parent.name)
+                    parents.insert(0, parent.name)
                     parent = parent.parent
             self.output.write(f"{'.'.join(self.context + parents)}.{node.name}\n")
 
+    def visit_ClassDef(self, node):
+        for dec in node.decorator_list:
+            if "define_aliases" in ast.unparse(dec):
+                parents = []
+                if hasattr(node, "parent"):
+                    parent = node.parent
+                    while hasattr(parent, "parent") and not isinstance(
+                        parent, ast.Module
+                    ):
+                        parents.insert(0, parent.name)
+                        parent = parent.parent
+                aliases = ast.literal_eval(dec.args[0])
+                # Written as a regex rather than two lines to avoid unused entries
+                # for setters on items with only a getter
+                for substitutions in aliases.values():
+                    parts = self.context + parents + [node.name]
+                    self.output.write(
+                        "\n".join(
+                            f"{'.'.join(parts)}.[gs]et_{a}\n" for a in substitutions
+                        )
+                    )
+        for child in ast.iter_child_nodes(node):
+            self.visit(child)
+
 
 with tempfile.NamedTemporaryFile("wt") as f:
     for path in mpl.glob("**/*.py"):
@@ -48,6 +73,7 @@ def visit_FunctionDef(self, node):
             "matplotlib",
         ],
         cwd=root,
+        env=os.environ | {"MPLBACKEND": "agg"},
     )
 
 sys.exit(proc.returncode)

From a16721f0771be2816114172574af2c2a36b8fbe2 Mon Sep 17 00:00:00 2001
From: ananya314 <57040724+ananya314@users.noreply.github.com>
Date: Wed, 27 Sep 2023 00:36:02 -0400
Subject: [PATCH 0199/1120] Fix 26872-AD.rst

---
 doc/api/next_api_changes/removals/26872-AD.rst | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/doc/api/next_api_changes/removals/26872-AD.rst b/doc/api/next_api_changes/removals/26872-AD.rst
index 2f678ffc3cfd..411359813e51 100644
--- a/doc/api/next_api_changes/removals/26872-AD.rst
+++ b/doc/api/next_api_changes/removals/26872-AD.rst
@@ -1,6 +1,5 @@
-``repeat``
-~~~~~~~~~~
-... of `.TimedAnimation` is removed without replacements.
-``save_count``
-~~~~~~~~~~~~~~
-... of `.FuncAnimation` is removed without replacements.
+``Animation`` attributes
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+The attributes ``repeat`` of `.TimedAnimation` and subclasses and
+``save_count`` of `.FuncAnimation` are considered private and removed.

From 4d02b5f1f13b75e4f51f858ac0f51a8ac3921a9e Mon Sep 17 00:00:00 2001
From: Hugues Hoppe <hhoppe@users.noreply.github.com>
Date: Tue, 26 Sep 2023 23:50:28 -0700
Subject: [PATCH 0200/1120] Update pyplot.py

Added type signature for `show`.
---
 lib/matplotlib/pyplot.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 74a73725d5d9..ce7d302ae9e7 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -479,7 +479,7 @@ def draw_if_interactive(*args, **kwargs):
 
 
 # This function's signature is rewritten upon backend-load by switch_backend.
-def show(*args, **kwargs):
+def show(*args, **kwargs) -> None:
     """
     Display all open figures.
 

From c60622a3fd8bb010d6fe6f1e71651e78e3775e4c Mon Sep 17 00:00:00 2001
From: wemi3 <62965919+wemi3@users.noreply.github.com>
Date: Wed, 27 Sep 2023 00:36:47 -0700
Subject: [PATCH 0201/1120] 26865 Removed deprecations from quiver.py (#26918)

* 26865 Removed deprecations from quiver.py

* Added rst file

* updated quiver.pyi

* removed extra lines

* removed code stubs, edited rst file

* Update lib/matplotlib/quiver.py

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>

* Update doc/api/next_api_changes/removals/26918-EW.rst

Co-authored-by: Oscar Gustafsson <oscar.gustafsson@gmail.com>

---------

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Co-authored-by: Oscar Gustafsson <oscar.gustafsson@gmail.com>
---
 doc/api/next_api_changes/removals/26918-EW.rst | 3 +++
 lib/matplotlib/quiver.py                       | 4 ----
 lib/matplotlib/quiver.pyi                      | 4 ----
 3 files changed, 3 insertions(+), 8 deletions(-)
 create mode 100644 doc/api/next_api_changes/removals/26918-EW.rst

diff --git a/doc/api/next_api_changes/removals/26918-EW.rst b/doc/api/next_api_changes/removals/26918-EW.rst
new file mode 100644
index 000000000000..454f35d5e200
--- /dev/null
+++ b/doc/api/next_api_changes/removals/26918-EW.rst
@@ -0,0 +1,3 @@
+``Quiver.quiver_doc`` and ``Barbs.barbs_doc``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+... are removed. These are the doc-string and should not be accessible as a named class member.
diff --git a/lib/matplotlib/quiver.py b/lib/matplotlib/quiver.py
index c8f8ba566106..52f56deb40c0 100644
--- a/lib/matplotlib/quiver.py
+++ b/lib/matplotlib/quiver.py
@@ -721,8 +721,6 @@ def _h_arrows(self, length):
         # Mask handling is deferred to the caller, _make_verts.
         return X, Y
 
-    quiver_doc = _api.deprecated("3.7")(property(lambda self: _quiver_doc))
-
 
 _barbs_doc = r"""
 Plot a 2D field of barbs.
@@ -1177,5 +1175,3 @@ def set_offsets(self, xy):
         xy = np.column_stack((x, y))
         super().set_offsets(xy)
         self.stale = True
-
-    barbs_doc = _api.deprecated("3.7")(property(lambda self: _barbs_doc))
diff --git a/lib/matplotlib/quiver.pyi b/lib/matplotlib/quiver.pyi
index c673c5dd3aff..2a043a92b4b5 100644
--- a/lib/matplotlib/quiver.pyi
+++ b/lib/matplotlib/quiver.pyi
@@ -125,8 +125,6 @@ class Quiver(mcollections.PolyCollection):
     def set_UVC(
         self, U: ArrayLike, V: ArrayLike, C: ArrayLike | None = ...
     ) -> None: ...
-    @property
-    def quiver_doc(self) -> str: ...
 
 class Barbs(mcollections.PolyCollection):
     sizes: dict[str, float]
@@ -183,5 +181,3 @@ class Barbs(mcollections.PolyCollection):
         self, U: ArrayLike, V: ArrayLike, C: ArrayLike | None = ...
     ) -> None: ...
     def set_offsets(self, xy: ArrayLike) -> None: ...
-    @property
-    def barbs_doc(self) -> str: ...

From d69ace945fd80ae8356227b055a4b94142f32f62 Mon Sep 17 00:00:00 2001
From: Jody Klymak <jklymak@gmail.com>
Date: Fri, 22 Sep 2023 18:12:51 -0700
Subject: [PATCH 0202/1120] DOC: improve removal for julian dates [ci doc]

---
 doc/api/next_api_changes/removals/26852-OG.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/doc/api/next_api_changes/removals/26852-OG.rst b/doc/api/next_api_changes/removals/26852-OG.rst
index dc7d595f575f..08ad0105b70a 100644
--- a/doc/api/next_api_changes/removals/26852-OG.rst
+++ b/doc/api/next_api_changes/removals/26852-OG.rst
@@ -3,3 +3,10 @@
 
 ... of the `.dates` module are removed without replacements. These were
 undocumented and not exported.
+
+Julian dates in Matplotlib were calculated from a Julian date epoch: ``jdate =
+(date - np.datetime64(EPOCH)) / np.timedelta64(1, 'D')``.  Conversely, a Julian
+date was converted to datetime as ``date = np.timedelta64(int(jdate * 24 *
+3600), 's') + np.datetime64(EPOCH)``. Matplotlib was using
+``EPOCH='-4713-11-24T12:00'`` so that 2000-01-01 at 12:00 is 2_451_545.0 (see
+<https://en.wikipedia.org/wiki/Julian_day>`).

From ab94dd766af49d996f8c48ee88e75944277ef574 Mon Sep 17 00:00:00 2001
From: Jody Klymak <jklymak@gmail.com>
Date: Mon, 25 Sep 2023 11:57:32 -0700
Subject: [PATCH 0203/1120] DOC: add a couple more placement examples,
 crosslink axes_grid [ci doc]

Co-authored-by: Ruth Comer <10599679+rcomer@users.noreply.github.com>
---
 .../demo_colorbar_with_axes_divider.py        |   6 +
 .../demo_colorbar_with_inset_locator.py       |  10 +-
 .../users_explain/axes/colorbar_placement.py  | 113 ++++++++++++++++--
 .../axes/constrainedlayout_guide.py           |   4 +-
 4 files changed, 118 insertions(+), 15 deletions(-)

diff --git a/galleries/examples/axes_grid1/demo_colorbar_with_axes_divider.py b/galleries/examples/axes_grid1/demo_colorbar_with_axes_divider.py
index e314c2dcea21..9e4611c65bb7 100644
--- a/galleries/examples/axes_grid1/demo_colorbar_with_axes_divider.py
+++ b/galleries/examples/axes_grid1/demo_colorbar_with_axes_divider.py
@@ -1,4 +1,6 @@
 """
+.. _demo-colorbar-with-axes-divider:
+
 =========================
 Colorbar with AxesDivider
 =========================
@@ -8,6 +10,10 @@
 method of the `.AxesDivider` can then be used to create a new axes on a given
 side ("top", "right", "bottom", or "left") of the original axes. This example
 uses `.append_axes` to add colorbars next to axes.
+
+Users should consider simply passing the main axes to the *ax* keyword argument of
+`~.Figure.colorbar` instead of creating a locatable axes manually like this.
+See :ref:`colorbar_placement`.
 """
 
 import matplotlib.pyplot as plt
diff --git a/galleries/examples/axes_grid1/demo_colorbar_with_inset_locator.py b/galleries/examples/axes_grid1/demo_colorbar_with_inset_locator.py
index 0c8d48e23101..8ec7d0e7271b 100644
--- a/galleries/examples/axes_grid1/demo_colorbar_with_inset_locator.py
+++ b/galleries/examples/axes_grid1/demo_colorbar_with_inset_locator.py
@@ -1,15 +1,21 @@
 """
+.. _demo-colorbar-with-inset-locator:
+
 ==============================================================
 Controlling the position and size of colorbars with Inset Axes
 ==============================================================
 
-This example shows how to control the position, height, and width of
-colorbars using `~mpl_toolkits.axes_grid1.inset_locator.inset_axes`.
+This example shows how to control the position, height, and width of colorbars
+using `~mpl_toolkits.axes_grid1.inset_locator.inset_axes`.
 
 Inset axes placement is controlled as for legends: either by providing a *loc*
 option ("upper right", "best", ...), or by providing a locator with respect to
 the parent bbox.  Parameters such as *bbox_to_anchor* and *borderpad* likewise
 work in the same way, and are also demonstrated here.
+
+Users should consider using `.Axes.inset_axes` instead (see
+:ref:`colorbar_placement`).
+
 """
 
 import matplotlib.pyplot as plt
diff --git a/galleries/users_explain/axes/colorbar_placement.py b/galleries/users_explain/axes/colorbar_placement.py
index de767a4fa130..1e43d4940a98 100644
--- a/galleries/users_explain/axes/colorbar_placement.py
+++ b/galleries/users_explain/axes/colorbar_placement.py
@@ -10,7 +10,11 @@
 Colorbars indicate the quantitative extent of image data.  Placing in
 a figure is non-trivial because room needs to be made for them.
 
-The simplest case is just attaching a colorbar to each axes:
+Automatic placement of colorbars
+================================
+
+The simplest case is just attaching a colorbar to each axes.  Note in this
+example that the colorbars steal some space from the parent axes.
 """
 import matplotlib.pyplot as plt
 import numpy as np
@@ -28,9 +32,9 @@
         fig.colorbar(pcm, ax=ax)
 
 # %%
-# The first column has the same type of data in both rows, so it may
-# be desirable to combine the colorbar which we do by calling
-# `.Figure.colorbar` with a list of axes instead of a single axes.
+# The first column has the same type of data in both rows, so it may be
+# desirable to have just one colorbar. We do this by passing `.Figure.colorbar`
+# a list of axes with the *ax* kwarg.
 
 fig, axs = plt.subplots(2, 2)
 cmaps = ['RdBu_r', 'viridis']
@@ -41,6 +45,27 @@
                             cmap=cmaps[col])
     fig.colorbar(pcm, ax=axs[:, col], shrink=0.6)
 
+# %%
+# The stolen space can lead to axes in the same subplot layout
+# being different sizes, which is often undesired if the the
+# x-axis on each plot is meant to be comparable as in the following:
+
+fig, axs = plt.subplots(2, 1, figsize=(4, 5), sharex=True)
+X = np.random.randn(20, 20)
+axs[0].plot(np.sum(X, axis=0))
+axs[1].pcolormesh(X)
+fig.colorbar(pcm, ax=axs[1], shrink=0.6)
+
+# %%
+# This is usually undesired, and can be worked around in various ways, e.g.
+# adding a colorbar to the other axes and then removing it.  However, the most
+# straightforward is to use :ref:`constrained layout <constrainedlayout_guide>`:
+
+fig, axs = plt.subplots(2, 1, figsize=(4, 5), sharex=True, layout='constrained')
+axs[0].plot(np.sum(X, axis=0))
+axs[1].pcolormesh(X)
+fig.colorbar(pcm, ax=axs[1], shrink=0.6)
+
 # %%
 # Relatively complicated colorbar layouts are possible using this
 # paradigm.  Note that this example works far better with
@@ -56,8 +81,67 @@
 fig.colorbar(pcm, ax=[axs[2, 1]], location='left')
 
 # %%
-# Colorbars with fixed-aspect-ratio axes
-# ======================================
+# Adjusting the spacing between colorbars and parent axes
+# =======================================================
+#
+# The distance a colorbar is from the parent axes can be adjusted with the
+# *pad* keyword argument.  This is in units of fraction of the parent axes
+# width, and the default for a vertical axes is 0.05 (or 0.15 for a horizontal
+# axes).
+
+fig, axs = plt.subplots(3, 1, layout='constrained', figsize=(5, 5))
+for ax, pad in zip(axs, [0.025, 0.05, 0.1]):
+    pcm = ax.pcolormesh(np.random.randn(20, 20), cmap='viridis')
+    fig.colorbar(pcm, ax=ax, pad=pad, label=f'pad: {pad}')
+fig.suptitle("layout='constrained'")
+
+# %%
+# Note that if you do not use constrained layout, the pad command makes the
+# parent axes shrink:
+
+fig, axs = plt.subplots(3, 1, figsize=(5, 5))
+for ax, pad in zip(axs, [0.025, 0.05, 0.1]):
+    pcm = ax.pcolormesh(np.random.randn(20, 20), cmap='viridis')
+    fig.colorbar(pcm, ax=ax, pad=pad, label=f'pad: {pad}')
+fig.suptitle("No layout manager")
+
+# %%
+# Manual placement of colorbars
+# =============================
+#
+# Sometimes the automatic placement provided by ``colorbar`` does not
+# give the desired effect.  We can manually create an axes and tell
+# ``colorbar`` to use that axes by passing the axes to the *cax* keyword
+# argument.
+#
+# Using ``inset_axes``
+# --------------------
+#
+# We can manually create any type of axes for the colorbar to use, but an
+# `.Axes.inset_axes` is useful because it is a child of the parent axes and can
+# be positioned relative to the parent.  Here we add a colorbar centered near
+# the bottom of the parent axes.
+
+fig, ax = plt.subplots(layout='constrained', figsize=(4, 4))
+pcm = ax.pcolormesh(np.random.randn(20, 20), cmap='viridis')
+ax.set_ylim([-4, 20])
+cax = ax.inset_axes([0.3, 0.07, 0.4, 0.04])
+fig.colorbar(pcm, cax=cax, orientation='horizontal')
+
+# %%
+# `.Axes.inset_axes` can also specify its position in data coordinates
+# using the *transform* keyword argument if you want your axes at a
+# certain data position on the graph:
+
+fig, ax = plt.subplots(layout='constrained', figsize=(4, 4))
+pcm = ax.pcolormesh(np.random.randn(20, 20), cmap='viridis')
+ax.set_ylim([-4, 20])
+cax = ax.inset_axes([7.5, -1.7, 5, 1.2], transform=ax.transData)
+fig.colorbar(pcm, cax=cax, orientation='horizontal')
+
+# %%
+# Colorbars attached to fixed-aspect-ratio axes
+# ---------------------------------------------
 #
 # Placing colorbars for axes with a fixed aspect ratio pose a particular
 # challenge as the parent axes changes size depending on the data view.
@@ -77,9 +161,10 @@
             fig.colorbar(pcm, ax=ax, shrink=0.6)
 
 # %%
-# One way around this issue is to use an `.Axes.inset_axes` to locate the
-# axes in axes coordinates.  Note that if you zoom in on the axes, and
-# change the shape of the axes, the colorbar will also change position.
+# We solve this problem using `.Axes.inset_axes` to locate the axes in "axes
+# coordinates" (see :ref:`transforms_tutorial`).  Note that if you zoom in on
+# the parent axes, and thus change the shape of it, the colorbar will also
+# change position.
 
 fig, axs = plt.subplots(2, 2, layout='constrained')
 cmaps = ['RdBu_r', 'viridis']
@@ -94,6 +179,12 @@
             ax.set_aspect(1/2)
         if row == 1:
             cax = ax.inset_axes([1.04, 0.2, 0.05, 0.6])
-            fig.colorbar(pcm, ax=ax, cax=cax)
+            fig.colorbar(pcm, cax=cax)
 
-plt.show()
+# %%
+# .. seealso::
+#
+#  :ref:`axes_grid` has methods for manually creating colorbar axes as well:
+#
+#  - :ref:`demo-colorbar-with-inset-locator`
+#  - :ref:`demo-colorbar-with-axes-divider`
diff --git a/galleries/users_explain/axes/constrainedlayout_guide.py b/galleries/users_explain/axes/constrainedlayout_guide.py
index 0a2752674c6a..260a4f76bf71 100644
--- a/galleries/users_explain/axes/constrainedlayout_guide.py
+++ b/galleries/users_explain/axes/constrainedlayout_guide.py
@@ -4,9 +4,9 @@
 
 .. _constrainedlayout_guide:
 
-================================
+========================
 Constrained Layout Guide
-================================
+========================
 
 Use *constrained layout* to fit plots within your figure cleanly.
 

From afcc560f3ea70dc9f3964dabf2b7632118f6085d Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Tue, 26 Sep 2023 15:05:25 -0500
Subject: [PATCH 0204/1120] [TYP] Remove some stubtest allowlist entries

Mark the expected interface for some things such as Transform.input_dims as read-only via a property and remove redundant versions in subclasses

Same for some offsetbox code

Fix rcsetup ignores
---
 ci/mypy-stubtest-allowlist.txt | 18 ------------------
 lib/matplotlib/offsetbox.pyi   |  8 ++++++--
 lib/matplotlib/rcsetup.pyi     |  9 ++++++---
 lib/matplotlib/transforms.pyi  | 20 +++++++++-----------
 4 files changed, 21 insertions(+), 34 deletions(-)

diff --git a/ci/mypy-stubtest-allowlist.txt b/ci/mypy-stubtest-allowlist.txt
index e0890b3f7117..b92ef9c67688 100644
--- a/ci/mypy-stubtest-allowlist.txt
+++ b/ci/mypy-stubtest-allowlist.txt
@@ -32,18 +32,6 @@ matplotlib.ticker.LogitLocator.nonsingular
 matplotlib.backend_bases._Mode.__new__
 matplotlib.units.Number.__hash__
 
-# Property read-write vs read-only weirdness, fix if possible
-matplotlib.offsetbox.DraggableBase.canvas
-matplotlib.offsetbox.DraggableBase.cids
-matplotlib.transforms.BboxTransform.is_separable
-matplotlib.transforms.BboxTransformFrom.is_separable
-matplotlib.transforms.BboxTransformTo.is_separable
-matplotlib.transforms.BlendedAffine2D.is_separable
-matplotlib.transforms.CompositeGenericTransform.is_separable
-matplotlib.transforms.TransformWrapper.input_dims
-matplotlib.transforms.TransformWrapper.is_separable
-matplotlib.transforms.TransformWrapper.output_dims
-
 # 3.6 Pending deprecations
 matplotlib.figure.Figure.set_constrained_layout
 matplotlib.figure.Figure.set_constrained_layout_pads
@@ -148,16 +136,10 @@ matplotlib.text.Text.set_weight
 matplotlib.axes._base._AxesBase.get_fc
 matplotlib.axes._base._AxesBase.set_fc
 
-# Other dynamic python behaviors not type hinted
-matplotlib.rcsetup.defaultParams
-
 # Maybe should be abstractmethods, required for subclasses, stubs define once
 matplotlib.tri.*TriInterpolator.__call__
 matplotlib.tri.*TriInterpolator.gradient
 
-# Functionally a method call, but actually a class instance, type hinted as former
-matplotlib.rcsetup.validate_fillstyle
-
 # TypeVar used only in type hints
 matplotlib.backend_bases.FigureCanvasBase._T
 matplotlib.backend_managers.ToolManager._T
diff --git a/lib/matplotlib/offsetbox.pyi b/lib/matplotlib/offsetbox.pyi
index 09f89aed2bc8..c222a9b2973e 100644
--- a/lib/matplotlib/offsetbox.pyi
+++ b/lib/matplotlib/offsetbox.pyi
@@ -280,11 +280,15 @@ class AnnotationBbox(martist.Artist, mtext._AnnotationBase):
 class DraggableBase:
     ref_artist: martist.Artist
     got_artist: bool
-    canvas: FigureCanvasBase
-    cids: list[int]
     mouse_x: int
     mouse_y: int
     background: Any
+
+    @property
+    def canvas(self) -> FigureCanvasBase: ...
+    @property
+    def cids(self) -> list[int]: ...
+
     def __init__(self, ref_artist: martist.Artist, use_blit: bool = ...) -> None: ...
     def on_motion(self, evt: Event) -> None: ...
     def on_pick(self, evt: Event) -> None: ...
diff --git a/lib/matplotlib/rcsetup.pyi b/lib/matplotlib/rcsetup.pyi
index 8a8a9e71d666..70e94a7694a9 100644
--- a/lib/matplotlib/rcsetup.pyi
+++ b/lib/matplotlib/rcsetup.pyi
@@ -129,9 +129,9 @@ def validate_fontstretch(
 def validate_font_properties(s: Any) -> dict[str, Any]: ...
 def validate_whiskers(s: Any) -> list[float] | float: ...
 def validate_ps_distiller(s: Any) -> None | Literal["ghostscript", "xpdf"]: ...
-def validate_fillstyle(
-    s: Any,
-) -> Literal["full", "left", "right", "bottom", "top", "none"]: ...
+
+validate_fillstyle: ValidateInStrings
+
 def validate_fillstylelist(
     s: Any,
 ) -> list[Literal["full", "left", "right", "bottom", "top", "none"]]: ...
@@ -152,3 +152,6 @@ def validate_hist_bins(
 ) -> Literal["auto", "sturges", "fd", "doane", "scott", "rice", "sqrt"] | int | list[
     float
 ]: ...
+
+# At runtime is added in __init__.py
+defaultParams: dict[str, Any]
diff --git a/lib/matplotlib/transforms.pyi b/lib/matplotlib/transforms.pyi
index 68e55612b7f1..90a527e5bfc5 100644
--- a/lib/matplotlib/transforms.pyi
+++ b/lib/matplotlib/transforms.pyi
@@ -175,12 +175,17 @@ class LockableBbox(BboxBase):
     def locked_y1(self, y1: float | None) -> None: ...
 
 class Transform(TransformNode):
-    input_dims: int | None
-    output_dims: int | None
-    is_separable: bool
-    # Implemented as a standard attr in base class, but functionally readonly and some subclasses implement as such
+
+    # Implemented as a standard attrs in base class, but functionally readonly and some subclasses implement as such
+    @property
+    def input_dims(self) -> int | None: ...
+    @property
+    def output_dims(self) -> int | None: ...
+    @property
+    def is_separable(self) -> bool: ...
     @property
     def has_inverse(self) -> bool: ...
+
     def __add__(self, other: Transform) -> Transform: ...
     @property
     def depth(self) -> int: ...
@@ -225,8 +230,6 @@ class Affine2DBase(AffineBase):
     input_dims: Literal[2]
     output_dims: Literal[2]
     def frozen(self) -> Affine2D: ...
-    @property
-    def is_separable(self): ...
     def to_values(self) -> tuple[float, float, float, float, float, float]: ...
 
 class Affine2D(Affine2DBase):
@@ -255,7 +258,6 @@ class _BlendedMixin:
 class BlendedGenericTransform(_BlendedMixin, Transform):
     input_dims: Literal[2]
     output_dims: Literal[2]
-    is_separable: bool
     pass_through: bool
     def __init__(
         self, x_transform: Transform, y_transform: Transform, **kwargs
@@ -265,8 +267,6 @@ class BlendedGenericTransform(_BlendedMixin, Transform):
     def contains_branch(self, other: Transform) -> Literal[False]: ...
     @property
     def is_affine(self) -> bool: ...
-    @property
-    def has_inverse(self) -> bool: ...
 
 class BlendedAffine2D(_BlendedMixin, Affine2DBase):
     def __init__(
@@ -279,8 +279,6 @@ def blended_transform_factory(
 
 class CompositeGenericTransform(Transform):
     pass_through: bool
-    input_dims: int | None
-    output_dims: int | None
     def __init__(self, a: Transform, b: Transform, **kwargs) -> None: ...
 
 class CompositeAffine2D(Affine2DBase):

From e8f21d271a498fb6bcee936eae239ce7298e8a9e Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Wed, 27 Sep 2023 11:53:16 -0500
Subject: [PATCH 0205/1120] add tomli to rstcheck extras

required for reading config from pyproject.toml on py<3.11
---
 .pre-commit-config.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 18707e44e5d0..05a14a1a08cc 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -55,3 +55,4 @@ repos:
       - id: rstcheck
         additional_dependencies:
           - sphinx>=1.8.1
+          - tomli

From 6dadeca73c5d5a60999e68351018fa3928db55a1 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Wed, 27 Sep 2023 13:07:30 -0500
Subject: [PATCH 0206/1120] Add ArrayLike to scatter c arg type hint

Closes #26936
---
 lib/matplotlib/axes/_axes.pyi | 2 +-
 lib/matplotlib/pyplot.py      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.pyi b/lib/matplotlib/axes/_axes.pyi
index 96ea087f7eb9..9602db3b950c 100644
--- a/lib/matplotlib/axes/_axes.pyi
+++ b/lib/matplotlib/axes/_axes.pyi
@@ -402,7 +402,7 @@ class Axes(_AxesBase):
         x: float | ArrayLike,
         y: float | ArrayLike,
         s: float | ArrayLike | None = ...,
-        c: Sequence[ColorType] | ColorType | None = ...,
+        c: ArrayLike | Sequence[ColorType] | ColorType | None = ...,
         marker: MarkerType | None = ...,
         cmap: str | Colormap | None = ...,
         norm: str | Normalize | None = ...,
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 74a73725d5d9..f48ca312e58e 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -3670,7 +3670,7 @@ def scatter(
     x: float | ArrayLike,
     y: float | ArrayLike,
     s: float | ArrayLike | None = None,
-    c: Sequence[ColorType] | ColorType | None = None,
+    c: ArrayLike | Sequence[ColorType] | ColorType | None = None,
     marker: MarkerType | None = None,
     cmap: str | Colormap | None = None,
     norm: str | Normalize | None = None,

From 3f72eca907dbe6ebedd4e4437139ee6393b12947 Mon Sep 17 00:00:00 2001
From: Aditi Gautam <agautam@uber.com>
Date: Fri, 22 Sep 2023 11:34:20 -0700
Subject: [PATCH 0207/1120] Cleaned up the span_where class method from
 Polycollections.

---
 ci/mypy-stubtest-allowlist.txt                |  1 -
 doc/api/artist_api.rst                        |  2 +-
 .../next_api_changes/removals/26874-AG.rst    |  4 ++
 doc/users/prev_whats_new/whats_new_1.4.rst    |  2 +-
 lib/matplotlib/axes/_axes.pyi                 |  3 +-
 lib/matplotlib/collections.py                 | 45 -------------------
 lib/matplotlib/collections.pyi                | 12 -----
 lib/matplotlib/pyplot.py                      |  3 +-
 8 files changed, 8 insertions(+), 64 deletions(-)
 create mode 100644 doc/api/next_api_changes/removals/26874-AG.rst

diff --git a/ci/mypy-stubtest-allowlist.txt b/ci/mypy-stubtest-allowlist.txt
index e0890b3f7117..78f269a5f5bf 100644
--- a/ci/mypy-stubtest-allowlist.txt
+++ b/ci/mypy-stubtest-allowlist.txt
@@ -52,7 +52,6 @@ matplotlib.figure.Figure.set_tight_layout
 # 3.7 deprecations
 matplotlib.cm.register_cmap
 matplotlib.cm.unregister_cmap
-matplotlib.collections.PolyCollection.span_where
 
 # 3.8 deprecations
 matplotlib.cbook.get_sample_data
diff --git a/doc/api/artist_api.rst b/doc/api/artist_api.rst
index 3903bbd5924d..df7a6e8b1c04 100644
--- a/doc/api/artist_api.rst
+++ b/doc/api/artist_api.rst
@@ -11,7 +11,7 @@
 Inheritance Diagrams
 ====================
 
-.. inheritance-diagram:: matplotlib.axes._axes.Axes matplotlib.axes._base._AxesBase matplotlib.axis.Axis matplotlib.axis.Tick matplotlib.axis.XAxis matplotlib.axis.XTick matplotlib.axis.YAxis matplotlib.axis.YTick matplotlib.collections.AsteriskPolygonCollection matplotlib.collections.BrokenBarHCollection matplotlib.collections.CircleCollection matplotlib.collections.Collection matplotlib.collections.EllipseCollection matplotlib.collections.EventCollection matplotlib.collections.LineCollection matplotlib.collections.PatchCollection matplotlib.collections.PathCollection matplotlib.collections.PolyCollection matplotlib.collections.QuadMesh matplotlib.collections.RegularPolyCollection matplotlib.collections.StarPolygonCollection matplotlib.collections.TriMesh matplotlib.collections._CollectionWithSizes matplotlib.contour.ClabelText matplotlib.contour.ContourSet matplotlib.contour.QuadContourSet matplotlib.figure.FigureBase matplotlib.figure.Figure matplotlib.figure.SubFigure matplotlib.image.AxesImage matplotlib.image.BboxImage matplotlib.image.FigureImage matplotlib.image.NonUniformImage matplotlib.image.PcolorImage matplotlib.image._ImageBase matplotlib.legend.Legend matplotlib.lines.Line2D matplotlib.offsetbox.AnchoredOffsetbox matplotlib.offsetbox.AnchoredText matplotlib.offsetbox.AnnotationBbox matplotlib.offsetbox.AuxTransformBox matplotlib.offsetbox.DrawingArea matplotlib.offsetbox.HPacker matplotlib.offsetbox.OffsetBox matplotlib.offsetbox.OffsetImage matplotlib.offsetbox.PackerBase matplotlib.offsetbox.PaddedBox matplotlib.offsetbox.TextArea matplotlib.offsetbox.VPacker matplotlib.patches.Annulus matplotlib.patches.Arc matplotlib.patches.Arrow matplotlib.patches.Circle matplotlib.patches.CirclePolygon matplotlib.patches.ConnectionPatch matplotlib.patches.Ellipse matplotlib.patches.FancyArrow matplotlib.patches.FancyArrowPatch matplotlib.patches.FancyBboxPatch matplotlib.patches.Patch matplotlib.patches.PathPatch matplotlib.patches.Polygon matplotlib.patches.Rectangle matplotlib.patches.RegularPolygon matplotlib.patches.Shadow matplotlib.patches.StepPatch matplotlib.patches.Wedge matplotlib.projections.geo.AitoffAxes matplotlib.projections.geo.GeoAxes matplotlib.projections.geo.HammerAxes matplotlib.projections.geo.LambertAxes matplotlib.projections.geo.MollweideAxes matplotlib.projections.polar.PolarAxes matplotlib.projections.polar.RadialAxis matplotlib.projections.polar.RadialTick matplotlib.projections.polar.ThetaAxis matplotlib.projections.polar.ThetaTick matplotlib.quiver.Barbs matplotlib.quiver.Quiver matplotlib.quiver.QuiverKey matplotlib.spines.Spine matplotlib.table.Cell matplotlib.table.Table matplotlib.text.Annotation matplotlib.text.Text matplotlib.tri.TriContourSet
+.. inheritance-diagram:: matplotlib.axes._axes.Axes matplotlib.axes._base._AxesBase matplotlib.axis.Axis matplotlib.axis.Tick matplotlib.axis.XAxis matplotlib.axis.XTick matplotlib.axis.YAxis matplotlib.axis.YTick matplotlib.collections.AsteriskPolygonCollection matplotlib.collections.CircleCollection matplotlib.collections.Collection matplotlib.collections.EllipseCollection matplotlib.collections.EventCollection matplotlib.collections.LineCollection matplotlib.collections.PatchCollection matplotlib.collections.PathCollection matplotlib.collections.PolyCollection matplotlib.collections.QuadMesh matplotlib.collections.RegularPolyCollection matplotlib.collections.StarPolygonCollection matplotlib.collections.TriMesh matplotlib.collections._CollectionWithSizes matplotlib.contour.ClabelText matplotlib.contour.ContourSet matplotlib.contour.QuadContourSet matplotlib.figure.FigureBase matplotlib.figure.Figure matplotlib.figure.SubFigure matplotlib.image.AxesImage matplotlib.image.BboxImage matplotlib.image.FigureImage matplotlib.image.NonUniformImage matplotlib.image.PcolorImage matplotlib.image._ImageBase matplotlib.legend.Legend matplotlib.lines.Line2D matplotlib.offsetbox.AnchoredOffsetbox matplotlib.offsetbox.AnchoredText matplotlib.offsetbox.AnnotationBbox matplotlib.offsetbox.AuxTransformBox matplotlib.offsetbox.DrawingArea matplotlib.offsetbox.HPacker matplotlib.offsetbox.OffsetBox matplotlib.offsetbox.OffsetImage matplotlib.offsetbox.PackerBase matplotlib.offsetbox.PaddedBox matplotlib.offsetbox.TextArea matplotlib.offsetbox.VPacker matplotlib.patches.Annulus matplotlib.patches.Arc matplotlib.patches.Arrow matplotlib.patches.Circle matplotlib.patches.CirclePolygon matplotlib.patches.ConnectionPatch matplotlib.patches.Ellipse matplotlib.patches.FancyArrow matplotlib.patches.FancyArrowPatch matplotlib.patches.FancyBboxPatch matplotlib.patches.Patch matplotlib.patches.PathPatch matplotlib.patches.Polygon matplotlib.patches.Rectangle matplotlib.patches.RegularPolygon matplotlib.patches.Shadow matplotlib.patches.StepPatch matplotlib.patches.Wedge matplotlib.projections.geo.AitoffAxes matplotlib.projections.geo.GeoAxes matplotlib.projections.geo.HammerAxes matplotlib.projections.geo.LambertAxes matplotlib.projections.geo.MollweideAxes matplotlib.projections.polar.PolarAxes matplotlib.projections.polar.RadialAxis matplotlib.projections.polar.RadialTick matplotlib.projections.polar.ThetaAxis matplotlib.projections.polar.ThetaTick matplotlib.quiver.Barbs matplotlib.quiver.Quiver matplotlib.quiver.QuiverKey matplotlib.spines.Spine matplotlib.table.Cell matplotlib.table.Table matplotlib.text.Annotation matplotlib.text.Text matplotlib.tri.TriContourSet
    :parts: 1
    :private-bases:
 
diff --git a/doc/api/next_api_changes/removals/26874-AG.rst b/doc/api/next_api_changes/removals/26874-AG.rst
new file mode 100644
index 000000000000..ad305cf9d96c
--- /dev/null
+++ b/doc/api/next_api_changes/removals/26874-AG.rst
@@ -0,0 +1,4 @@
+``collections.PolyCollection.span_where`` and ``collections.BrokenBarHCollection``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+... removed as it was deprecated during 3.7. Use ``fill_between`` instead
diff --git a/doc/users/prev_whats_new/whats_new_1.4.rst b/doc/users/prev_whats_new/whats_new_1.4.rst
index 39eefa81b168..eb0e93fd8883 100644
--- a/doc/users/prev_whats_new/whats_new_1.4.rst
+++ b/doc/users/prev_whats_new/whats_new_1.4.rst
@@ -221,7 +221,7 @@ Added size related functions to specialized `.Collection`\s
 Added the ``get_size`` and ``set_size`` functions to control the size of
 elements of specialized collections (
 :class:`~matplotlib.collections.AsteriskPolygonCollection`
-:class:`~matplotlib.collections.BrokenBarHCollection`
+``matplotlib.collections.BrokenBarHCollection``
 :class:`~matplotlib.collections.CircleCollection`
 :class:`~matplotlib.collections.PathCollection`
 :class:`~matplotlib.collections.PolyCollection`
diff --git a/lib/matplotlib/axes/_axes.pyi b/lib/matplotlib/axes/_axes.pyi
index 96ea087f7eb9..5dff356be4a9 100644
--- a/lib/matplotlib/axes/_axes.pyi
+++ b/lib/matplotlib/axes/_axes.pyi
@@ -6,7 +6,6 @@ from matplotlib.backend_bases import RendererBase
 from matplotlib.collections import (
     Collection,
     LineCollection,
-    BrokenBarHCollection,
     PathCollection,
     PolyCollection,
     EventCollection,
@@ -282,7 +281,7 @@ class Axes(_AxesBase):
         *,
         data=...,
         **kwargs
-    ) -> BrokenBarHCollection: ...
+    ) -> PolyCollection: ...
     def stem(
         self,
         *args: ArrayLike | str,
diff --git a/lib/matplotlib/collections.py b/lib/matplotlib/collections.py
index 81db24d0c026..cc20e5cebc1b 100644
--- a/lib/matplotlib/collections.py
+++ b/lib/matplotlib/collections.py
@@ -1253,51 +1253,6 @@ def set_verts_and_codes(self, verts, codes):
                        for xy, cds in zip(verts, codes)]
         self.stale = True
 
-    @classmethod
-    @_api.deprecated("3.7", alternative="fill_between")
-    def span_where(cls, x, ymin, ymax, where, **kwargs):
-        """
-        Return a `.BrokenBarHCollection` that plots horizontal bars from
-        over the regions in *x* where *where* is True.  The bars range
-        on the y-axis from *ymin* to *ymax*
-
-        *kwargs* are passed on to the collection.
-        """
-        xranges = []
-        for ind0, ind1 in cbook.contiguous_regions(where):
-            xslice = x[ind0:ind1]
-            if not len(xslice):
-                continue
-            xranges.append((xslice[0], xslice[-1] - xslice[0]))
-        return BrokenBarHCollection(xranges, [ymin, ymax - ymin], **kwargs)
-
-
-@_api.deprecated("3.7")
-class BrokenBarHCollection(PolyCollection):
-    """
-    A collection of horizontal bars spanning *yrange* with a sequence of
-    *xranges*.
-    """
-    def __init__(self, xranges, yrange, **kwargs):
-        """
-        Parameters
-        ----------
-        xranges : list of (float, float)
-            The sequence of (left-edge-position, width) pairs for each bar.
-        yrange : (float, float)
-            The (lower-edge, height) common to all bars.
-        **kwargs
-            Forwarded to `.Collection`.
-        """
-        ymin, ywidth = yrange
-        ymax = ymin + ywidth
-        verts = [[(xmin, ymin),
-                  (xmin, ymax),
-                  (xmin + xwidth, ymax),
-                  (xmin + xwidth, ymin),
-                  (xmin, ymin)] for xmin, xwidth in xranges]
-        super().__init__(verts, **kwargs)
-
 
 class RegularPolyCollection(_CollectionWithSizes):
     """A collection of n-sided regular polygons."""
diff --git a/lib/matplotlib/collections.pyi b/lib/matplotlib/collections.pyi
index 01682a55b374..7162c4687dfa 100644
--- a/lib/matplotlib/collections.pyi
+++ b/lib/matplotlib/collections.pyi
@@ -106,18 +106,6 @@ class PolyCollection(_CollectionWithSizes):
         self, verts: Sequence[ArrayLike | Path], codes: Sequence[int]
     ) -> None: ...
 
-class BrokenBarHCollection(PolyCollection):
-    def __init__(
-        self,
-        xranges: Iterable[tuple[float, float]],
-        yrange: tuple[float, float],
-        **kwargs
-    ) -> None: ...
-    @classmethod
-    def span_where(
-        cls, x: ArrayLike, ymin: float, ymax: float, where: ArrayLike, **kwargs
-    ) -> BrokenBarHCollection: ...
-
 class RegularPolyCollection(_CollectionWithSizes):
     def __init__(
         self, numsides: int, *, rotation: float = ..., sizes: ArrayLike = ..., **kwargs
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 74a73725d5d9..d5c100089993 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -99,7 +99,6 @@
     from matplotlib.collections import (
         Collection,
         LineCollection,
-        BrokenBarHCollection,
         PolyCollection,
         PathCollection,
         EventCollection,
@@ -2873,7 +2872,7 @@ def broken_barh(
     *,
     data=None,
     **kwargs,
-) -> BrokenBarHCollection:
+) -> PolyCollection:
     return gca().broken_barh(
         xranges, yrange, **({"data": data} if data is not None else {}), **kwargs
     )

From 61661f1c40fcaafe19b1f230da83d569a05f4ff9 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Wed, 27 Sep 2023 17:18:49 -0500
Subject: [PATCH 0208/1120] Close file so it hopefully works on windows (but
 not tested)

---
 tools/stubtest.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/tools/stubtest.py b/tools/stubtest.py
index 3f3c6931255f..71de6bda20c8 100644
--- a/tools/stubtest.py
+++ b/tools/stubtest.py
@@ -52,7 +52,7 @@ def visit_ClassDef(self, node):
             self.visit(child)
 
 
-with tempfile.NamedTemporaryFile("wt") as f:
+with tempfile.NamedTemporaryFile("wt", delete=False) as f:
     for path in mpl.glob("**/*.py"):
         v = Visitor(path, f)
         tree = ast.parse(path.read_text())
@@ -64,6 +64,7 @@ def visit_ClassDef(self, node):
 
         v.visit(tree)
     f.flush()
+    f.close()
     proc = subprocess.run(
         [
             "stubtest",
@@ -75,5 +76,9 @@ def visit_ClassDef(self, node):
         cwd=root,
         env=os.environ | {"MPLBACKEND": "agg"},
     )
+    try:
+        os.unlink(f.name)
+    except OSError:
+        pass
 
 sys.exit(proc.returncode)

From 93cab2e642521f86f10b6d65824776a1f623ec72 Mon Sep 17 00:00:00 2001
From: Haoying Zhang <38875181+stevezhang1999@users.noreply.github.com>
Date: Wed, 27 Sep 2023 20:43:26 -0400
Subject: [PATCH 0209/1120] DOC: Clarify description and add examples in
 colors.Normalize (#26915)

Co-authored-by: Zihao Yang zihaoyng@gmail.com
---
 lib/matplotlib/colors.py | 64 ++++++++++++++++++++++++++++++----------
 1 file changed, 48 insertions(+), 16 deletions(-)

diff --git a/lib/matplotlib/colors.py b/lib/matplotlib/colors.py
index 904b6ecfa04b..584adba8eace 100644
--- a/lib/matplotlib/colors.py
+++ b/lib/matplotlib/colors.py
@@ -1215,8 +1215,24 @@ def reversed(self, name=None):
 
 class Normalize:
     """
-    A class which, when called, linearly normalizes data into the
-    ``[0.0, 1.0]`` interval.
+    A class which, when called, maps values within the interval
+    ``[vmin, vmax]`` linearly to the interval ``[0.0, 1.0]``. The mapping of
+    values outside ``[vmin, vmax]`` depends on *clip*.
+
+    Examples
+    --------
+    ::
+
+        x = [-2, -1, 0, 1, 2]
+
+        norm = mpl.colors.Normalize(vmin=-1, vmax=1, clip=False)
+        norm(x)  # [-0.5, 0., 0.5, 1., 1.5]
+        norm = mpl.colors.Normalize(vmin=-1, vmax=1, clip=True)
+        norm(x)  # [0., 0., 0.5, 1., 1.]
+
+    See Also
+    --------
+    :ref:`colormapnorms`
     """
 
     def __init__(self, vmin=None, vmax=None, clip=False):
@@ -1224,27 +1240,30 @@ def __init__(self, vmin=None, vmax=None, clip=False):
         Parameters
         ----------
         vmin, vmax : float or None
-            If *vmin* and/or *vmax* is not given, they are initialized from the
-            minimum and maximum value, respectively, of the first input
-            processed; i.e., ``__call__(A)`` calls ``autoscale_None(A)``.
+            Values within the range ``[vmin, vmax]`` from the input data will be
+            linearly mapped to ``[0, 1]``. If either *vmin* or *vmax* is not
+            provided, they default to the minimum and maximum values of the input,
+            respectively.
+
 
         clip : bool, default: False
             Determines the behavior for mapping values outside the range
             ``[vmin, vmax]``.
 
-            If clipping is off, values outside the range ``[vmin, vmax]`` are also
-            transformed linearly, resulting in values outside ``[0, 1]``. For a
-            standard use with colormaps, this behavior is desired because colormaps
-            mark these outside values with specific colors for *over* or *under*.
+            If *clip* is ``False``, values outside ``[vmin, vmax]`` are also transformed
+            linearly, leading to results outside ``[0, 1]``. For a standard use with
+            colormaps, this behavior is desired because colormaps mark these outside
+            values with specific colors for over or under.
 
-            If ``True`` values falling outside the range ``[vmin, vmax]``,
-            are mapped to 0 or 1, whichever is closer. This makes these values
+            If *clip* is ``True``, values outside ``[vmin, vmax]`` are set to 0 or 1,
+            depending on which boundary they're closer to. This makes these values
             indistinguishable from regular boundary values and can lead to
             misinterpretation of the data.
 
+
         Notes
         -----
-        Returns 0 if ``vmin == vmax``.
+        If ``vmin == vmax``, input data will be mapped to 0.
         """
         self._vmin = _sanitize_extrema(vmin)
         self._vmax = _sanitize_extrema(vmax)
@@ -1298,6 +1317,11 @@ def process_value(value):
 
         *value* can be a scalar or sequence.
 
+        Parameters
+        ----------
+        value
+            Data to normalize.
+
         Returns
         -------
         result : masked array
@@ -1328,8 +1352,7 @@ def process_value(value):
 
     def __call__(self, value, clip=None):
         """
-        Normalize *value* data in the ``[vmin, vmax]`` interval into the
-        ``[0.0, 1.0]`` interval and return it.
+        Normalize the data and return the normalized data.
 
         Parameters
         ----------
@@ -1375,6 +1398,15 @@ def __call__(self, value, clip=None):
         return result
 
     def inverse(self, value):
+        """
+        Maps the normalized value (i.e., index in the colormap) back to image
+        data value.
+
+        Parameters
+        ----------
+        value
+            Normalized value.
+        """
         if not self.scaled():
             raise ValueError("Not invertible until both vmin and vmax are set")
         (vmin,), _ = self.process_value(self.vmin)
@@ -1396,7 +1428,7 @@ def autoscale(self, A):
         self._changed()
 
     def autoscale_None(self, A):
-        """If vmin or vmax are not set, use the min/max of *A* to set them."""
+        """If *vmin* or *vmax* are not set, use the min/max of *A* to set them."""
         A = np.asanyarray(A)
 
         if isinstance(A, np.ma.MaskedArray):
@@ -1410,7 +1442,7 @@ def autoscale_None(self, A):
             self.vmax = A.max()
 
     def scaled(self):
-        """Return whether vmin and vmax are set."""
+        """Return whether *vmin* and *vmax* are both set."""
         return self.vmin is not None and self.vmax is not None
 
 

From 890d4b38a3387a3616069ed4f5f159d7f6b70e15 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Thu, 28 Sep 2023 10:17:35 +0200
Subject: [PATCH 0210/1120] Inline Cursor._update into its sole caller.

... to make the Cursor redraw logic easier to follow.
Also remove the unused return value from _update.
---
 lib/matplotlib/widgets.py | 18 ++++++------------
 1 file changed, 6 insertions(+), 12 deletions(-)

diff --git a/lib/matplotlib/widgets.py b/lib/matplotlib/widgets.py
index 9fde066afb5c..a1974a43fe12 100644
--- a/lib/matplotlib/widgets.py
+++ b/lib/matplotlib/widgets.py
@@ -1886,23 +1886,19 @@ def onmove(self, event):
         if not self.ax.contains(event)[0]:
             self.linev.set_visible(False)
             self.lineh.set_visible(False)
-
             if self.needclear:
                 self.canvas.draw()
                 self.needclear = False
             return
         self.needclear = True
-
         xdata, ydata = self._get_data_coords(event)
         self.linev.set_xdata((xdata, xdata))
         self.linev.set_visible(self.visible and self.vertOn)
         self.lineh.set_ydata((ydata, ydata))
         self.lineh.set_visible(self.visible and self.horizOn)
-
-        if self.visible and (self.vertOn or self.horizOn):
-            self._update()
-
-    def _update(self):
+        if not (self.visible and (self.vertOn or self.horizOn)):
+            return
+        # Redraw.
         if self.useblit:
             if self.background is not None:
                 self.canvas.restore_region(self.background)
@@ -1911,7 +1907,6 @@ def _update(self):
             self.canvas.blit(self.ax.bbox)
         else:
             self.canvas.draw_idle()
-        return False
 
 
 class MultiCursor(Widget):
@@ -2026,10 +2021,9 @@ def onmove(self, event):
         for line in self.hlines:
             line.set_ydata((ydata, ydata))
             line.set_visible(self.visible and self.horizOn)
-        if self.visible and (self.vertOn or self.horizOn):
-            self._update()
-
-    def _update(self):
+        if not (self.visible and (self.vertOn or self.horizOn)):
+            return
+        # Redraw.
         if self.useblit:
             for canvas, info in self._canvas_infos.items():
                 if info["background"]:

From 1e6993831473efc56bf6a0fce6eeb17769eb9d13 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Thu, 28 Sep 2023 23:35:23 +0200
Subject: [PATCH 0211/1120] Fix incorrect skip check in test_backend_ps.

There was a typo in `elif rcParams.get("ps.userdistiller") == "xpdf"`
which effectively always returned False (the correct spelling is
"ps.usedistiller", so the get() call always returned None), which
made the skip check for xpdf never run.  Thus, running the test on
a machine without pdftops installed would eventually result in an
ExecutableNotFoundError when matplotlib actually tries to call the
distiller.

To avoid this kind of problems (dict.get hiding typos), directly update
the test-specific settings into the main rcParams, and use normal
brackets to access rcParams entries, as rcParams keys are a fixed set
anyways.
---
 lib/matplotlib/backends/backend_macosx.py |  2 +-
 lib/matplotlib/tests/test_backend_ps.py   | 15 +++++++--------
 2 files changed, 8 insertions(+), 9 deletions(-)

diff --git a/lib/matplotlib/backends/backend_macosx.py b/lib/matplotlib/backends/backend_macosx.py
index 1d92ec602d3b..ecf21b07aef4 100644
--- a/lib/matplotlib/backends/backend_macosx.py
+++ b/lib/matplotlib/backends/backend_macosx.py
@@ -147,7 +147,7 @@ def __init__(self, canvas, num):
         icon_path = str(cbook._get_data_path('images/matplotlib.pdf'))
         _macosx.FigureManager.set_icon(icon_path)
         FigureManagerBase.__init__(self, canvas, num)
-        self._set_window_mode(mpl.rcParams.get("macosx.window_mode", "system"))
+        self._set_window_mode(mpl.rcParams["macosx.window_mode"])
         if self.toolbar is not None:
             self.toolbar.update()
         if mpl.is_interactive():
diff --git a/lib/matplotlib/tests/test_backend_ps.py b/lib/matplotlib/tests/test_backend_ps.py
index 954d0955a760..cbf33ccc5a1b 100644
--- a/lib/matplotlib/tests/test_backend_ps.py
+++ b/lib/matplotlib/tests/test_backend_ps.py
@@ -40,20 +40,19 @@
     'eps with usetex'
 ])
 def test_savefig_to_stringio(format, use_log, rcParams, orientation, papersize):
-    if rcParams.get("ps.usedistiller") == "ghostscript":
+    mpl.rcParams.update(rcParams)
+    if mpl.rcParams["ps.usedistiller"] == "ghostscript":
         try:
             mpl._get_executable_info("gs")
         except mpl.ExecutableNotFoundError as exc:
             pytest.skip(str(exc))
-    elif rcParams.get("ps.userdistiller") == "xpdf":
+    elif mpl.rcParams["ps.usedistiller"] == "xpdf":
         try:
             mpl._get_executable_info("gs")  # Effectively checks for ps2pdf.
             mpl._get_executable_info("pdftops")
         except mpl.ExecutableNotFoundError as exc:
             pytest.skip(str(exc))
 
-    mpl.rcParams.update(rcParams)
-
     fig, ax = plt.subplots()
 
     with io.StringIO() as s_buf, io.BytesIO() as b_buf:
@@ -67,9 +66,9 @@ def test_savefig_to_stringio(format, use_log, rcParams, orientation, papersize):
             title += " \N{MINUS SIGN}\N{EURO SIGN}"
         ax.set_title(title)
         allowable_exceptions = []
-        if rcParams.get("text.usetex"):
+        if mpl.rcParams["text.usetex"]:
             allowable_exceptions.append(RuntimeError)
-        if rcParams.get("ps.useafm"):
+        if mpl.rcParams["ps.useafm"]:
             allowable_exceptions.append(mpl.MatplotlibDeprecationWarning)
         try:
             fig.savefig(s_buf, format=format, orientation=orientation,
@@ -87,14 +86,14 @@ def test_savefig_to_stringio(format, use_log, rcParams, orientation, papersize):
         if format == 'ps':
             # Default figsize = (8, 6) inches = (576, 432) points = (203.2, 152.4) mm.
             # Landscape orientation will swap dimensions.
-            if rcParams.get("ps.usedistiller") == "xpdf":
+            if mpl.rcParams["ps.usedistiller"] == "xpdf":
                 # Some versions specifically show letter/203x152, but not all,
                 # so we can only use this simpler test.
                 if papersize == 'figure':
                     assert b'letter' not in s_val.lower()
                 else:
                     assert b'letter' in s_val.lower()
-            elif rcParams.get("ps.usedistiller") or rcParams.get("text.usetex"):
+            elif mpl.rcParams["ps.usedistiller"] or mpl.rcParams["text.usetex"]:
                 width = b'432.0' if orientation == 'landscape' else b'576.0'
                 wanted = (b'-dDEVICEWIDTHPOINTS=' + width if papersize == 'figure'
                           else b'-sPAPERSIZE')

From 72bf994e82553bae4c2075c57db74f44c158c872 Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Thu, 28 Sep 2023 19:33:48 +0100
Subject: [PATCH 0212/1120] FIX 2-tuple of colors in to_rgba_array

---
 lib/matplotlib/colors.py            | 2 +-
 lib/matplotlib/tests/test_colors.py | 5 +++++
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/colors.py b/lib/matplotlib/colors.py
index 584adba8eace..b9866974d8a3 100644
--- a/lib/matplotlib/colors.py
+++ b/lib/matplotlib/colors.py
@@ -435,7 +435,7 @@ def to_rgba_array(c, alpha=None):
         (n, 4) array of RGBA colors,  where each channel (red, green, blue,
         alpha) can assume values between 0 and 1.
     """
-    if isinstance(c, tuple) and len(c) == 2:
+    if isinstance(c, tuple) and len(c) == 2 and isinstance(c[1], Real):
         if alpha is None:
             c, alpha = c
         else:
diff --git a/lib/matplotlib/tests/test_colors.py b/lib/matplotlib/tests/test_colors.py
index 1c77f995fb53..139efbe17407 100644
--- a/lib/matplotlib/tests/test_colors.py
+++ b/lib/matplotlib/tests/test_colors.py
@@ -1298,6 +1298,11 @@ def test_to_rgba_array_single_str():
         array = mcolors.to_rgba_array("rgb")
 
 
+def test_to_rgba_array_2tuple_str():
+    expected = np.array([[0, 0, 0, 1], [1, 1, 1, 1]])
+    assert_array_equal(mcolors.to_rgba_array(("k", "w")), expected)
+
+
 def test_to_rgba_array_alpha_array():
     with pytest.raises(ValueError, match="The number of colors must match"):
         mcolors.to_rgba_array(np.ones((5, 3), float), alpha=np.ones((2,)))

From 6245534a75f3469f2e421510299610ff0b06eb46 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Fri, 29 Sep 2023 14:16:44 +0200
Subject: [PATCH 0213/1120] Deprecate backend_ps.get_bbox_header, and split it
 for internal use.

It's clearly an internal helper, and the two parts (the actual bbox
header and the rotation command) don't really benefit from being smushed
together, so make the function private and split the two parts.
---
 .../deprecations/26960-AL.rst                 |  3 ++
 lib/matplotlib/backends/backend_ps.py         | 36 +++++++++----------
 2 files changed, 21 insertions(+), 18 deletions(-)
 create mode 100644 doc/api/next_api_changes/deprecations/26960-AL.rst

diff --git a/doc/api/next_api_changes/deprecations/26960-AL.rst b/doc/api/next_api_changes/deprecations/26960-AL.rst
new file mode 100644
index 000000000000..cbde4cbba424
--- /dev/null
+++ b/doc/api/next_api_changes/deprecations/26960-AL.rst
@@ -0,0 +1,3 @@
+``backend_ps.get_bbox_header``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+... is deprecated, as it is considered an internal helper.
diff --git a/lib/matplotlib/backends/backend_ps.py b/lib/matplotlib/backends/backend_ps.py
index b59c571809d1..e1e5bd9c091b 100644
--- a/lib/matplotlib/backends/backend_ps.py
+++ b/lib/matplotlib/backends/backend_ps.py
@@ -9,6 +9,7 @@
 from io import StringIO
 import itertools
 import logging
+import math
 import os
 import pathlib
 import shutil
@@ -915,7 +916,7 @@ def print_figure_impl(fh):
             print(f"%%LanguageLevel: 3\n"
                   f"{dsc_comments}\n"
                   f"%%Orientation: {orientation.name}\n"
-                  f"{get_bbox_header(bbox)[0]}\n"
+                  f"{_get_bbox_header(bbox)}\n"
                   f"%%EndComments\n",
                   end="", file=fh)
 
@@ -1024,7 +1025,7 @@ def _print_figure_tex(
 %!PS-Adobe-3.0 EPSF-3.0
 %%LanguageLevel: 3
 {dsc_comments}
-{get_bbox_header(bbox)[0]}
+{_get_bbox_header(bbox)}
 %%EndComments
 %%BeginProlog
 /mpldict {len(_psDefs)} dict def
@@ -1219,21 +1220,26 @@ def xpdf_distill(tmpfile, eps=False, ptype='letter', bbox=None, rotated=False):
         pstoeps(tmpfile)
 
 
+@_api.deprecated("3.9")
 def get_bbox_header(lbrt, rotated=False):
     """
     Return a postscript header string for the given bbox lbrt=(l, b, r, t).
     Optionally, return rotate command.
     """
+    return _get_bbox_header(lbrt), (_get_rotate_command(lbrt) if rotated else "")
 
+
+def _get_bbox_header(lbrt):
+    """Return a PostScript header string for bounding box *lbrt*=(l, b, r, t)."""
     l, b, r, t = lbrt
-    if rotated:
-        rotate = f"{l+r:.2f} {0:.2f} translate\n90 rotate"
-    else:
-        rotate = ""
-    bbox_info = '%%%%BoundingBox: %d %d %d %d' % (l, b, np.ceil(r), np.ceil(t))
-    hires_bbox_info = f'%%HiResBoundingBox: {l:.6f} {b:.6f} {r:.6f} {t:.6f}'
+    return (f"%%BoundingBox: {int(l)} {int(b)} {math.ceil(r)} {math.ceil(t)}\n"
+            f"%%HiResBoundingBox: {l:.6f} {b:.6f} {r:.6f} {t:.6f}")
+
 
-    return '\n'.join([bbox_info, hires_bbox_info]), rotate
+def _get_rotate_command(lbrt):
+    """Return a PostScript 90° rotation command for bounding box *lbrt*=(l, b, r, t)."""
+    l, b, r, t = lbrt
+    return f"{l+r:.2f} {0:.2f} translate\n90 rotate"
 
 
 def pstoeps(tmpfile, bbox=None, rotated=False):
@@ -1243,12 +1249,6 @@ def pstoeps(tmpfile, bbox=None, rotated=False):
     None, original bbox will be used.
     """
 
-    # if rotated==True, the output eps file need to be rotated
-    if bbox:
-        bbox_info, rotate = get_bbox_header(bbox, rotated=rotated)
-    else:
-        bbox_info, rotate = None, None
-
     epsfile = tmpfile + '.eps'
     with open(epsfile, 'wb') as epsh, open(tmpfile, 'rb') as tmph:
         write = epsh.write
@@ -1257,7 +1257,7 @@ def pstoeps(tmpfile, bbox=None, rotated=False):
             if line.startswith(b'%!PS'):
                 write(b"%!PS-Adobe-3.0 EPSF-3.0\n")
                 if bbox:
-                    write(bbox_info.encode('ascii') + b'\n')
+                    write(_get_bbox_header(bbox).encode('ascii') + b'\n')
             elif line.startswith(b'%%EndComments'):
                 write(line)
                 write(b'%%BeginProlog\n'
@@ -1269,8 +1269,8 @@ def pstoeps(tmpfile, bbox=None, rotated=False):
                       b'/setpagedevice {pop} def\n'
                       b'%%EndProlog\n'
                       b'%%Page 1 1\n')
-                if rotate:
-                    write(rotate.encode('ascii') + b'\n')
+                if rotated:  # The output eps file need to be rotated.
+                    write(_get_rotate_command(bbox).encode('ascii') + b'\n')
                 break
             elif bbox and line.startswith((b'%%Bound', b'%%HiResBound',
                                            b'%%DocumentMedia', b'%%Pages')):

From 0334c9489a5cc38f83e279ccc2bfcffb587bd02b Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Fri, 29 Sep 2023 12:03:35 +0200
Subject: [PATCH 0214/1120] Move papersize="auto" deprecation to backend_bases.

This makes it easier for mplcairo (which also outputs PostScript
natively) to inherit the deprecation and be able to run the matplotlib
test suite both with matplotlib 3.7 (where there should be no warning)
and with matplotlib 3.8 (where there should be a warning).
---
 lib/matplotlib/backend_bases.py       | 6 ++++++
 lib/matplotlib/backends/backend_ps.py | 6 ------
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
index c07ad692451e..54e974991854 100644
--- a/lib/matplotlib/backend_bases.py
+++ b/lib/matplotlib/backend_bases.py
@@ -2105,6 +2105,12 @@ def print_figure(
         if dpi == 'figure':
             dpi = getattr(self.figure, '_original_dpi', self.figure.dpi)
 
+        if kwargs.get("papertype") == 'auto':
+            # When deprecation elapses, remove backend_ps._get_papertype & its callers.
+            _api.warn_deprecated(
+                "3.8", name="papertype='auto'", addendum="Pass an explicit paper type, "
+                "'figure', or omit the *papertype* argument entirely.")
+
         # Remove the figure manager, if any, to avoid resizing the GUI widget.
         with cbook._setattr_cm(self, manager=None), \
              self._switch_canvas_and_return_print_method(format, backend) \
diff --git a/lib/matplotlib/backends/backend_ps.py b/lib/matplotlib/backends/backend_ps.py
index b59c571809d1..8d09fc1fe733 100644
--- a/lib/matplotlib/backends/backend_ps.py
+++ b/lib/matplotlib/backends/backend_ps.py
@@ -867,9 +867,6 @@ def _print_figure(
         # find the appropriate papertype
         width, height = self.figure.get_size_inches()
         if papertype == 'auto':
-            _api.warn_deprecated("3.8", name="papertype='auto'",
-                                 addendum="Pass an explicit paper type, 'figure', or "
-                                 "omit the *papertype* argument entirely.")
             papertype = _get_papertype(*orientation.swap_if_landscape((width, height)))
 
         if is_eps or papertype == 'figure':
@@ -1053,9 +1050,6 @@ def _print_figure_tex(
                     self.figure.get_size_inches())
             else:
                 if papertype == 'auto':
-                    _api.warn_deprecated("3.8", name="papertype='auto'",
-                                         addendum="Pass an explicit paper type, or "
-                                         "omit the *papertype* argument entirely.")
                     papertype = _get_papertype(width, height)
                 paper_width, paper_height = papersize[papertype]
 

From 17f4a9aabc14b20e3f76aed7bab2bdbd90429b2a Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Mon, 25 Sep 2023 23:34:35 +0200
Subject: [PATCH 0215/1120] Deprecate ContourLabeler.add_label_clabeltext.

We can just dispatch add_label based on the value of the internal
_use_clabeltext flag.  This change is also preparing for a possible
future change where we always have use_clabeltext=True (which is needed
for contour labels to be properly rotated after changes of axes aspect
ratio, and should have no drawback except for a tiny(?) performance
cost).
---
 .../next_api_changes/behavior/26917-AL.rst    |  3 +++
 .../deprecations/26917-AL.rst                 |  3 +++
 lib/matplotlib/contour.py                     | 23 ++++++++-----------
 3 files changed, 15 insertions(+), 14 deletions(-)
 create mode 100644 doc/api/next_api_changes/behavior/26917-AL.rst
 create mode 100644 doc/api/next_api_changes/deprecations/26917-AL.rst

diff --git a/doc/api/next_api_changes/behavior/26917-AL.rst b/doc/api/next_api_changes/behavior/26917-AL.rst
new file mode 100644
index 000000000000..7872caf3204d
--- /dev/null
+++ b/doc/api/next_api_changes/behavior/26917-AL.rst
@@ -0,0 +1,3 @@
+``ContourLabeler.add_label`` now respects *use_clabeltext*
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+... and sets `.Text.set_transform_rotates_text` accordingly.
diff --git a/doc/api/next_api_changes/deprecations/26917-AL.rst b/doc/api/next_api_changes/deprecations/26917-AL.rst
new file mode 100644
index 000000000000..d3cf16f5c511
--- /dev/null
+++ b/doc/api/next_api_changes/deprecations/26917-AL.rst
@@ -0,0 +1,3 @@
+``ContourLabeler.add_label_clabeltext``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+... is deprecated.
diff --git a/lib/matplotlib/contour.py b/lib/matplotlib/contour.py
index efea024dc102..941ebf7aed39 100644
--- a/lib/matplotlib/contour.py
+++ b/lib/matplotlib/contour.py
@@ -527,7 +527,7 @@ def calc_label_rot_and_inline(self, slc, ind, lw, lc=None, spacing=5):
         return rotation, nlc
 
     def add_label(self, x, y, rotation, lev, cvalue):
-        """Add contour label without `.Text.set_transform_rotates_text`."""
+        """Add a contour label, respecting whether *use_clabeltext* was set."""
         data_x, data_y = self.axes.transData.inverted().transform((x, y))
         t = Text(
             data_x, data_y,
@@ -538,20 +538,21 @@ def add_label(self, x, y, rotation, lev, cvalue):
             color=self.labelMappable.to_rgba(cvalue, alpha=self.get_alpha()),
             fontproperties=self._label_font_props,
             clip_box=self.axes.bbox)
+        if self._use_clabeltext:
+            data_rotation, = self.axes.transData.inverted().transform_angles(
+                [rotation], [[x, y]])
+            t.set(rotation=data_rotation, transform_rotates_text=True)
         self.labelTexts.append(t)
         self.labelCValues.append(cvalue)
         self.labelXYs.append((x, y))
         # Add label to plot here - useful for manual mode label selection
         self.axes.add_artist(t)
 
+    @_api.deprecated("3.8", alternative="add_label")
     def add_label_clabeltext(self, x, y, rotation, lev, cvalue):
         """Add contour label with `.Text.set_transform_rotates_text`."""
-        self.add_label(x, y, rotation, lev, cvalue)
-        # Grab the last added text, and reconfigure its rotation.
-        t = self.labelTexts[-1]
-        data_rotation, = self.axes.transData.inverted().transform_angles(
-            [rotation], [[x, y]])
-        t.set(rotation=data_rotation, transform_rotates_text=True)
+        with cbook._setattr_cm(self, _use_clabeltext=True):
+            self.add_label(x, y, rotation, lev, cvalue)
 
     def add_label_near(self, x, y, inline=True, inline_spacing=5,
                        transform=None):
@@ -600,12 +601,6 @@ def pop_label(self, index=-1):
         t.remove()
 
     def labels(self, inline, inline_spacing):
-
-        if self._use_clabeltext:
-            add_label = self.add_label_clabeltext
-        else:
-            add_label = self.add_label
-
         for idx, (icon, lev, cvalue) in enumerate(zip(
                 self.labelIndiceList,
                 self.labelLevelList,
@@ -622,7 +617,7 @@ def labels(self, inline, inline_spacing):
                     rotation, path = self._split_path_and_get_label_rotation(
                         subpath, idx, (x, y),
                         label_width, inline_spacing)
-                    add_label(x, y, rotation, lev, cvalue)  # Really add label.
+                    self.add_label(x, y, rotation, lev, cvalue)  # Really add label.
                     if inline:  # If inline, add new contours
                         additions.append(path)
                 else:  # If not adding label, keep old path

From 8f52c28bcca3b5fd90c1c531929d9557304839e8 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Fri, 29 Sep 2023 10:46:29 -0400
Subject: [PATCH 0216/1120] turned send to matplotlib into a section and added
 some more info so it would stand out

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>
---
 doc/devel/contribute.rst | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/doc/devel/contribute.rst b/doc/devel/contribute.rst
index 9b53a80ab374..aab1e73f955c 100644
--- a/doc/devel/contribute.rst
+++ b/doc/devel/contribute.rst
@@ -227,6 +227,9 @@ Maplotlib repository to your own computer, or alternatively using
 in-browser development environment that comes with the appropriated setup to
 contribute to Matplotlib.
 
+Workflow overview
+^^^^^^^^^^^^^^^^^
+
 A brief overview of the workflow is as follows.
 
 #. `Create an account <https://github.com/join>`_ on GitHub if you do not
@@ -289,8 +292,13 @@ A brief overview of the workflow is as follows.
 
      git push -u origin my-feature
 
-Finally, go to the web page of your fork of the Matplotlib repo, and click
-'Pull request' to send your changes to the maintainers for review.
+Open a pull request on Matplotlib
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Finally, go to the web page of *your fork* of the Matplotlib repo, and click
+**Compare & pull request** to send your changes to the maintainers for review.
+The base repository is ``matplotlib/matplotlib`` and the base branch is
+generally ``main``. For more guidance, see GitHub's `pull request tutorial
+<https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork>`_.
 
 For more detailed instructions on how to set up Matplotlib for development and
 best practices for contribution, see :ref:`installing_for_devs`.

From 754ec4518eef8e81ebc131c81a2da475b03b7be1 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Fri, 29 Sep 2023 10:48:21 -0400
Subject: [PATCH 0217/1120] changed title level to documented leveling format

---
 doc/devel/contribute.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/doc/devel/contribute.rst b/doc/devel/contribute.rst
index aab1e73f955c..a9bfb0f816dd 100644
--- a/doc/devel/contribute.rst
+++ b/doc/devel/contribute.rst
@@ -304,7 +304,7 @@ For more detailed instructions on how to set up Matplotlib for development and
 best practices for contribution, see :ref:`installing_for_devs`.
 
 GitHub Codespaces workflows
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 * If you need to open a GUI window with Matplotlib output on Codespaces, our
   configuration includes a `light-weight Fluxbox-based desktop
@@ -386,7 +386,7 @@ This ensures that users are notified before the change will take effect and thus
 prevents unexpected breaking of code.
 
 Rules
-~~~~~
+^^^^^
 
 - Deprecations are targeted at the next point.release (e.g. 3.x)
 - Deprecated API is generally removed two point-releases after introduction
@@ -399,7 +399,7 @@ Rules
   API consistency lead developer
 
 Introducing
-~~~~~~~~~~~
+^^^^^^^^^^^
 
 #. Announce the deprecation in a new file
    :file:`doc/api/next_api_changes/deprecations/99999-ABC.rst` where ``99999``
@@ -440,7 +440,7 @@ Introducing
      version number.
 
 Expiring
-~~~~~~~~
+^^^^^^^^
 
 #. Announce the API changes in a new file
    :file:`doc/api/next_api_changes/[kind]/99999-ABC.rst` where ``99999``
@@ -621,7 +621,7 @@ example, use ``_log.error('hello %s', 'world')``  rather than ``_log.error('hell
 {}'.format('world'))`` or ``_log.error(f'hello {s}')``.
 
 Which logging level to use?
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 There are five levels at which you can emit messages.
 

From c486c95f3bb8eb0852fd7202345e635ae127c439 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Tue, 26 Sep 2023 03:18:05 -0400
Subject: [PATCH 0218/1120] clarify that path.sketch/validate_sketch is looking
 for string list of three elements

---
 lib/matplotlib/mpl-data/matplotlibrc | 16 ++++++++--------
 lib/matplotlib/rcsetup.py            |  2 +-
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/lib/matplotlib/mpl-data/matplotlibrc b/lib/matplotlib/mpl-data/matplotlibrc
index a097c98429d1..f606bab8c304 100644
--- a/lib/matplotlib/mpl-data/matplotlibrc
+++ b/lib/matplotlib/mpl-data/matplotlibrc
@@ -669,14 +669,14 @@
 #path.snap: True  # When True, rectilinear axis-aligned paths will be snapped
                   # to the nearest pixel when certain criteria are met.
                   # When False, paths will never be snapped.
-#path.sketch: None  # May be None, or a 3-tuple of the form:
-                    # (scale, length, randomness).
-                    #     - *scale* is the amplitude of the wiggle
-                    #         perpendicular to the line (in pixels).
-                    #     - *length* is the length of the wiggle along the
-                    #         line (in pixels).
-                    #     - *randomness* is the factor by which the length is
-                    #         randomly scaled.
+#path.sketch: None  # May be None, or a triplet of the form:
+                    #  path.sketch: scale, length, randomness 
+                    # - *scale* is the amplitude of the wiggle
+                    #    perpendicular to the line (in pixels).
+                    # - *length* is the length of the wiggle along the
+                    #    line (in pixels).
+                    # - *randomness* is the factor by which the length is
+                    #    randomly scaled.
 #path.effects:
 
 
diff --git a/lib/matplotlib/rcsetup.py b/lib/matplotlib/rcsetup.py
index fa18677f5895..57a3859a90e7 100644
--- a/lib/matplotlib/rcsetup.py
+++ b/lib/matplotlib/rcsetup.py
@@ -562,7 +562,7 @@ def validate_sketch(s):
     try:
         return tuple(_listify_validator(validate_float, n=3)(s))
     except ValueError:
-        raise ValueError("Expected a (scale, length, randomness) triplet")
+        raise ValueError("Expected a 'scale, length, randomness' triplet")
 
 
 def _validate_greaterthan_minushalf(s):

From 36a3f7f63253a54786374f39f7e2955e8c8ee793 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Tue, 26 Sep 2023 15:54:34 -0400
Subject: [PATCH 0219/1120] added tests for the sketch param validator

---
 lib/matplotlib/tests/test_rcparams.py | 36 +++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/lib/matplotlib/tests/test_rcparams.py b/lib/matplotlib/tests/test_rcparams.py
index 515068c462d4..37dd107382e0 100644
--- a/lib/matplotlib/tests/test_rcparams.py
+++ b/lib/matplotlib/tests/test_rcparams.py
@@ -27,6 +27,7 @@
     validate_int,
     validate_markevery,
     validate_stringlist,
+    validate_sketch,
     _validate_linestyle,
     _listify_validator)
 
@@ -628,3 +629,38 @@ def test_rcparams_legend_loc_from_file(tmpdir, value):
 
     with mpl.rc_context(fname=rc_path):
         assert mpl.rcParams["legend.loc"] == value
+
+
+@pytest.mark.parametrize("value", [(1, 2, 3), '1, 2, 3'])
+def test_validate_sketch(value):
+    mpl.rcParams["path.sketch"] = value
+    assert mpl.rcParams["path.sketch"] == (1, 2, 3)
+    assert validate_sketch(value) == (1, 2, 3)
+
+
+@pytest.mark.parametrize("value", [1, '1', '(1, 2, 3)'])
+def test_validate_sketch_error(value):
+    with pytest.raises(ValueError, match="'scale, length, randomness'"):
+        validate_sketch(value)
+    with pytest.raises(ValueError, match="'scale, length, randomness'"):
+        mpl.rcParams["path.sketch"] = value
+
+
+def test_rcparams_path_sketch_from_file(tmpdir):
+    rc_path = tmpdir.join("matplotlibrc")
+    rc_path.write("path.sketch: 1, 2, 3")
+
+    with mpl.rc_context(fname=rc_path):
+        assert mpl.rcParams["path.sketch"] == (1, 2, 3)
+
+
+def test_rcparams_path_sketch_from_file_error(tmpdir, caplog):
+    # rcParams parser doesn't read a tuple rcfile entry
+    rc_path = tmpdir.join("matplotlibrc")
+    rc_path.write("path.sketch: (1, 2, 3)")
+
+    with mpl.rc_context(fname=rc_path):
+        with caplog.at_level("WARNING"):
+            assert mpl.rcParams['path.sketch'] is None
+            assert ("Expected a 'scale, length, randomness' triplet"
+                     in caplog.text)

From 3a86726bd44395c07442b17cd02231e90c75ba7d Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Tue, 8 Aug 2023 14:56:37 +0200
Subject: [PATCH 0220/1120] Minor cleanups.

Re: the rewriting of AsinhLocator formulas: The previous implementation
added 1e-6 to the logs in the case where xs=0 in order to avoid a
warning with log(0), but the result of the log was then zeroed out by
multiplication by xs anyways.  Instead, here we just rely on
`10**log(0) = 10**-inf = 0`.
---
 lib/matplotlib/axis.py                     |  2 +-
 lib/matplotlib/backend_bases.py            | 54 +++++++---------------
 lib/matplotlib/font_manager.py             |  3 +-
 lib/matplotlib/projections/polar.py        | 26 ++++-------
 lib/matplotlib/quiver.py                   |  4 +-
 lib/matplotlib/ticker.py                   | 51 +++++++-------------
 lib/mpl_toolkits/axisartist/grid_finder.py |  4 +-
 7 files changed, 48 insertions(+), 96 deletions(-)

diff --git a/lib/matplotlib/axis.py b/lib/matplotlib/axis.py
index 64aeac81c140..fa28597a9d08 100644
--- a/lib/matplotlib/axis.py
+++ b/lib/matplotlib/axis.py
@@ -208,7 +208,7 @@ def _apply_tickdir(self, tickdir):
         """Set tick direction.  Valid values are 'out', 'in', 'inout'."""
         # This method is responsible for updating `_pad`, and, in subclasses,
         # for setting the tick{1,2}line markers as well.  From the user
-        # perspective this should always be called though _apply_params, which
+        # perspective this should always be called through _apply_params, which
         # further updates ticklabel positions using the new pads.
         if tickdir is None:
             tickdir = mpl.rcParams[f'{self.__name__}.direction']
diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
index c07ad692451e..484a1be4ec90 100644
--- a/lib/matplotlib/backend_bases.py
+++ b/lib/matplotlib/backend_bases.py
@@ -2385,8 +2385,6 @@ def key_press_handler(event, canvas=None, toolbar=None):
         back-compatibility, but, if set, should always be equal to
         ``event.canvas.toolbar``.
     """
-    # these bindings happen whether you are over an Axes or not
-
     if event.key is None:
         return
     if canvas is None:
@@ -2394,55 +2392,40 @@ def key_press_handler(event, canvas=None, toolbar=None):
     if toolbar is None:
         toolbar = canvas.toolbar
 
-    # Load key-mappings from rcParams.
-    fullscreen_keys = rcParams['keymap.fullscreen']
-    home_keys = rcParams['keymap.home']
-    back_keys = rcParams['keymap.back']
-    forward_keys = rcParams['keymap.forward']
-    pan_keys = rcParams['keymap.pan']
-    zoom_keys = rcParams['keymap.zoom']
-    save_keys = rcParams['keymap.save']
-    quit_keys = rcParams['keymap.quit']
-    quit_all_keys = rcParams['keymap.quit_all']
-    grid_keys = rcParams['keymap.grid']
-    grid_minor_keys = rcParams['keymap.grid_minor']
-    toggle_yscale_keys = rcParams['keymap.yscale']
-    toggle_xscale_keys = rcParams['keymap.xscale']
-
-    # toggle fullscreen mode ('f', 'ctrl + f')
-    if event.key in fullscreen_keys:
+    # toggle fullscreen mode (default key 'f', 'ctrl + f')
+    if event.key in rcParams['keymap.fullscreen']:
         try:
             canvas.manager.full_screen_toggle()
         except AttributeError:
             pass
 
     # quit the figure (default key 'ctrl+w')
-    if event.key in quit_keys:
+    if event.key in rcParams['keymap.quit']:
         Gcf.destroy_fig(canvas.figure)
-    if event.key in quit_all_keys:
+    if event.key in rcParams['keymap.quit_all']:
         Gcf.destroy_all()
 
     if toolbar is not None:
         # home or reset mnemonic  (default key 'h', 'home' and 'r')
-        if event.key in home_keys:
+        if event.key in rcParams['keymap.home']:
             toolbar.home()
         # forward / backward keys to enable left handed quick navigation
         # (default key for backward: 'left', 'backspace' and 'c')
-        elif event.key in back_keys:
+        elif event.key in rcParams['keymap.back']:
             toolbar.back()
         # (default key for forward: 'right' and 'v')
-        elif event.key in forward_keys:
+        elif event.key in rcParams['keymap.forward']:
             toolbar.forward()
         # pan mnemonic (default key 'p')
-        elif event.key in pan_keys:
+        elif event.key in rcParams['keymap.pan']:
             toolbar.pan()
             toolbar._update_cursor(event)
         # zoom mnemonic (default key 'o')
-        elif event.key in zoom_keys:
+        elif event.key in rcParams['keymap.zoom']:
             toolbar.zoom()
             toolbar._update_cursor(event)
         # saving current figure (default key 's')
-        elif event.key in save_keys:
+        elif event.key in rcParams['keymap.save']:
             toolbar.save_figure()
 
     if event.inaxes is None:
@@ -2452,19 +2435,16 @@ def key_press_handler(event, canvas=None, toolbar=None):
     def _get_uniform_gridstate(ticks):
         # Return True/False if all grid lines are on or off, None if they are
         # not all in the same state.
-        if all(tick.gridline.get_visible() for tick in ticks):
-            return True
-        elif not any(tick.gridline.get_visible() for tick in ticks):
-            return False
-        else:
-            return None
+        return (True if all(tick.gridline.get_visible() for tick in ticks) else
+                False if not any(tick.gridline.get_visible() for tick in ticks) else
+                None)
 
     ax = event.inaxes
     # toggle major grids in current Axes (default key 'g')
     # Both here and below (for 'G'), we do nothing if *any* grid (major or
     # minor, x or y) is not in a uniform state, to avoid messing up user
     # customization.
-    if (event.key in grid_keys
+    if (event.key in rcParams['keymap.grid']
             # Exclude minor grids not in a uniform state.
             and None not in [_get_uniform_gridstate(ax.xaxis.minorTicks),
                              _get_uniform_gridstate(ax.yaxis.minorTicks)]):
@@ -2483,7 +2463,7 @@ def _get_uniform_gridstate(ticks):
             ax.grid(y_state, which="major" if y_state else "both", axis="y")
             canvas.draw_idle()
     # toggle major and minor grids in current Axes (default key 'G')
-    if (event.key in grid_minor_keys
+    if (event.key in rcParams['keymap.grid_minor']
             # Exclude major grids not in a uniform state.
             and None not in [_get_uniform_gridstate(ax.xaxis.majorTicks),
                              _get_uniform_gridstate(ax.yaxis.majorTicks)]):
@@ -2501,7 +2481,7 @@ def _get_uniform_gridstate(ticks):
             ax.grid(y_state, which="both", axis="y")
             canvas.draw_idle()
     # toggle scaling of y-axes between 'log and 'linear' (default key 'l')
-    elif event.key in toggle_yscale_keys:
+    elif event.key in rcParams['keymap.yscale']:
         scale = ax.get_yscale()
         if scale == 'log':
             ax.set_yscale('linear')
@@ -2514,7 +2494,7 @@ def _get_uniform_gridstate(ticks):
                 ax.set_yscale('linear')
             ax.figure.canvas.draw_idle()
     # toggle scaling of x-axes between 'log and 'linear' (default key 'k')
-    elif event.key in toggle_xscale_keys:
+    elif event.key in rcParams['keymap.xscale']:
         scalex = ax.get_xscale()
         if scalex == 'log':
             ax.set_xscale('linear')
diff --git a/lib/matplotlib/font_manager.py b/lib/matplotlib/font_manager.py
index a91ca4ba45df..68b22ccf7df1 100644
--- a/lib/matplotlib/font_manager.py
+++ b/lib/matplotlib/font_manager.py
@@ -1448,7 +1448,8 @@ def _findfont_cached(self, prop, fontext, directory, fallback_to_default,
                 # actually raised.
                 return _ExceptionProxy(
                     ValueError,
-                    f"Failed to find font {prop}, and fallback to the default font was disabled"
+                    f"Failed to find font {prop}, and fallback to the default font was "
+                    f"disabled"
                 )
         else:
             _log.debug('findfont: Matching %s to %s (%r) with score of %f.',
diff --git a/lib/matplotlib/projections/polar.py b/lib/matplotlib/projections/polar.py
index 0bff320e5728..f6fa0ea7b982 100644
--- a/lib/matplotlib/projections/polar.py
+++ b/lib/matplotlib/projections/polar.py
@@ -524,24 +524,16 @@ def get_matrix(self):
         if self._invalid:
             if self.mode == 'rlabel':
                 angle = (
-                    np.deg2rad(self.axes.get_rlabel_position()) *
-                    self.axes.get_theta_direction() +
-                    self.axes.get_theta_offset()
+                    np.deg2rad(self.axes.get_rlabel_position()
+                               * self.axes.get_theta_direction())
+                    + self.axes.get_theta_offset()
+                    - np.pi / 2
                 )
-            else:
-                if self.mode == 'min':
-                    angle = self.axes._realViewLim.xmin
-                elif self.mode == 'max':
-                    angle = self.axes._realViewLim.xmax
-
-            if self.mode in ('rlabel', 'min'):
-                padx = np.cos(angle - np.pi / 2)
-                pady = np.sin(angle - np.pi / 2)
-            else:
-                padx = np.cos(angle + np.pi / 2)
-                pady = np.sin(angle + np.pi / 2)
-
-            self._t = (self.pad * padx / 72, self.pad * pady / 72)
+            elif self.mode == 'min':
+                angle = self.axes._realViewLim.xmin - np.pi / 2
+            elif self.mode == 'max':
+                angle = self.axes._realViewLim.xmax + np.pi / 2
+            self._t = (self.pad * np.cos(angle) / 72, self.pad * np.sin(angle) / 72)
         return super().get_matrix()
 
 
diff --git a/lib/matplotlib/quiver.py b/lib/matplotlib/quiver.py
index 52f56deb40c0..3089af5757dd 100644
--- a/lib/matplotlib/quiver.py
+++ b/lib/matplotlib/quiver.py
@@ -72,7 +72,7 @@
     of these components (in data or in screen space) depends on *angles*.
 
     *U* and *V* must have the same number of elements, matching the number of
-    arrow locations in  *X*, *Y*. *U* and *V* may be masked. Locations masked
+    arrow locations in *X*, *Y*. *U* and *V* may be masked. Locations masked
     in any of *U*, *V*, and *C* will not be drawn.
 
 C : 1D or 2D array-like, optional
@@ -90,7 +90,7 @@
       symbolize a quantity that is not based on *X*, *Y* data coordinates.
 
       If *U* == *V* the orientation of the arrow on the plot is 45 degrees
-      counter-clockwise from the  horizontal axis (positive to the right).
+      counter-clockwise from the horizontal axis (positive to the right).
 
     - 'xy': Arrow direction in data coordinates, i.e. the arrows point from
       (x, y) to (x+u, y+v). Use this e.g. for plotting a gradient field.
diff --git a/lib/matplotlib/ticker.py b/lib/matplotlib/ticker.py
index 43a6126f6fcf..41114aafbf3e 100644
--- a/lib/matplotlib/ticker.py
+++ b/lib/matplotlib/ticker.py
@@ -2661,51 +2661,32 @@ def __call__(self):
             return self.tick_values(vmin, vmax)
 
     def tick_values(self, vmin, vmax):
-        # Construct a set of "on-screen" locations
-        # that are uniformly spaced:
+        # Construct a set of uniformly-spaced "on-screen" locations.
         ymin, ymax = self.linear_width * np.arcsinh(np.array([vmin, vmax])
-                                                        / self.linear_width)
+                                                    / self.linear_width)
         ys = np.linspace(ymin, ymax, self.numticks)
-        zero_dev = np.abs(ys / (ymax - ymin))
-        if (ymin * ymax) < 0:
-            # Ensure that the zero tick-mark is included,
-            # if the axis straddles zero
+        zero_dev = abs(ys / (ymax - ymin))
+        if ymin * ymax < 0:
+            # Ensure that the zero tick-mark is included, if the axis straddles zero.
             ys = np.hstack([ys[(zero_dev > 0.5 / self.numticks)], 0.0])
 
         # Transform the "on-screen" grid to the data space:
         xs = self.linear_width * np.sinh(ys / self.linear_width)
         zero_xs = (ys == 0)
 
-        # Round the data-space values to be intuitive base-n numbers,
-        # keeping track of positive and negative values separately,
-        # but giving careful treatment to the zero value:
-        if self.base > 1:
-            log_base = math.log(self.base)
-            powers = (
-                np.where(zero_xs, 0, np.sign(xs)) *
-                np.power(self.base,
-                         np.where(zero_xs, 0.0,
-                                  np.floor(np.log(np.abs(xs) + zero_xs*1e-6)
-                                                / log_base)))
-            )
-            if self.subs:
-                qs = np.outer(powers, self.subs).flatten()
-            else:
-                qs = powers
-        else:
-            powers = (
-                np.where(xs >= 0, 1, -1) *
-                np.power(10, np.where(zero_xs, 0.0,
-                                      np.floor(np.log10(np.abs(xs)
-                                                        + zero_xs*1e-6))))
-            )
-            qs = powers * np.round(xs / powers)
+        # Round the data-space values to be intuitive base-n numbers, keeping track of
+        # positive and negative values separately and carefully treating the zero value.
+        with np.errstate(divide="ignore"):  # base ** log(0) = base ** -inf = 0.
+            if self.base > 1:
+                pows = (np.sign(xs)
+                        * self.base ** np.floor(np.log(abs(xs)) / math.log(self.base)))
+                qs = np.outer(pows, self.subs).flatten() if self.subs else pows
+            else:  # No need to adjust sign(pows), as it cancels out when computing qs.
+                pows = np.where(zero_xs, 1, 10**np.floor(np.log10(abs(xs))))
+                qs = pows * np.round(xs / pows)
         ticks = np.array(sorted(set(qs)))
 
-        if len(ticks) >= 2:
-            return ticks
-        else:
-            return np.linspace(vmin, vmax, self.numticks)
+        return ticks if len(ticks) >= 2 else np.linspace(vmin, vmax, self.numticks)
 
 
 class LogitLocator(MaxNLocator):
diff --git a/lib/mpl_toolkits/axisartist/grid_finder.py b/lib/mpl_toolkits/axisartist/grid_finder.py
index 18a48b8e8ccf..ff61887f9ef2 100644
--- a/lib/mpl_toolkits/axisartist/grid_finder.py
+++ b/lib/mpl_toolkits/axisartist/grid_finder.py
@@ -188,9 +188,7 @@ def get_grid_info(self, x1, y1, x2, y2):
                                                         lon_min, lon_max,
                                                         lat_min, lat_max)
 
-        ddx = (x2-x1)*1.e-10
-        ddy = (y2-y1)*1.e-10
-        bb = Bbox.from_extents(x1-ddx, y1-ddy, x2+ddx, y2+ddy)
+        bb = Bbox.from_extents(x1, y1, x2, y2).expanded(1 + 2e-10, 1 + 2e-10)
 
         grid_info = {
             "extremes": extremes,

From df8eb6bbe4adad645a2d88c17bc02dfef530c9c5 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 2 Oct 2023 19:34:57 +0000
Subject: [PATCH 0221/1120] Bump pypa/cibuildwheel from 2.16.0 to 2.16.1

Bumps [pypa/cibuildwheel](https://github.com/pypa/cibuildwheel) from 2.16.0 to 2.16.1.
- [Release notes](https://github.com/pypa/cibuildwheel/releases)
- [Changelog](https://github.com/pypa/cibuildwheel/blob/main/docs/changelog.md)
- [Commits](https://github.com/pypa/cibuildwheel/compare/a873dd9cbf9e3c4c73a1fd11ac31cf835f6eb502...7da7df1efc530f07d1945c00934b8cfd34be0d50)

---
updated-dependencies:
- dependency-name: pypa/cibuildwheel
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 .github/workflows/cibuildwheel.yml | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 5788c3e0bc0a..8c76303cbb85 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -136,7 +136,7 @@ jobs:
           path: dist/
 
       - name: Build wheels for CPython 3.12
-        uses: pypa/cibuildwheel@a873dd9cbf9e3c4c73a1fd11ac31cf835f6eb502 # v2.16.0
+        uses: pypa/cibuildwheel@7da7df1efc530f07d1945c00934b8cfd34be0d50 # v2.16.1
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -158,7 +158,7 @@ jobs:
             pip install --pre "numpy>=1.25"
 
       - name: Build wheels for CPython 3.11
-        uses: pypa/cibuildwheel@a873dd9cbf9e3c4c73a1fd11ac31cf835f6eb502 # v2.16.0
+        uses: pypa/cibuildwheel@7da7df1efc530f07d1945c00934b8cfd34be0d50 # v2.16.1
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -166,7 +166,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.10
-        uses: pypa/cibuildwheel@a873dd9cbf9e3c4c73a1fd11ac31cf835f6eb502 # v2.16.0
+        uses: pypa/cibuildwheel@7da7df1efc530f07d1945c00934b8cfd34be0d50 # v2.16.1
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -174,7 +174,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.9
-        uses: pypa/cibuildwheel@a873dd9cbf9e3c4c73a1fd11ac31cf835f6eb502 # v2.16.0
+        uses: pypa/cibuildwheel@7da7df1efc530f07d1945c00934b8cfd34be0d50 # v2.16.1
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -182,7 +182,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for PyPy
-        uses: pypa/cibuildwheel@a873dd9cbf9e3c4c73a1fd11ac31cf835f6eb502 # v2.16.0
+        uses: pypa/cibuildwheel@7da7df1efc530f07d1945c00934b8cfd34be0d50 # v2.16.1
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:

From 5bf7e33ea01e320497cd54becdcf4ceb800dea55 Mon Sep 17 00:00:00 2001
From: vicky6 <vigneshvetrivel88@gmail.com>
Date: Tue, 3 Oct 2023 02:38:37 +0530
Subject: [PATCH 0222/1120] deprecated api tri (#26909)

* deprecated api tri

* updated deprecated api tri

* updated deprecated api tri

* updated deprecated api tri

* updated deprecated api tri

* pre-commit.ci autofix

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
---
 doc/api/next_api_changes/removals/26909-VV.rst | 4 ++++
 lib/matplotlib/tri/triangulation.py            | 9 ---------
 lib/matplotlib/tri/tricontour.py               | 9 ---------
 lib/matplotlib/tri/trifinder.py                | 9 ---------
 lib/matplotlib/tri/triinterpolate.py           | 9 ---------
 lib/matplotlib/tri/tripcolor.py                | 9 ---------
 lib/matplotlib/tri/triplot.py                  | 9 ---------
 lib/matplotlib/tri/trirefine.py                | 9 ---------
 lib/matplotlib/tri/tritools.py                 | 9 ---------
 9 files changed, 4 insertions(+), 72 deletions(-)
 create mode 100644 doc/api/next_api_changes/removals/26909-VV.rst
 delete mode 100644 lib/matplotlib/tri/triangulation.py
 delete mode 100644 lib/matplotlib/tri/tricontour.py
 delete mode 100644 lib/matplotlib/tri/trifinder.py
 delete mode 100644 lib/matplotlib/tri/triinterpolate.py
 delete mode 100644 lib/matplotlib/tri/tripcolor.py
 delete mode 100644 lib/matplotlib/tri/triplot.py
 delete mode 100644 lib/matplotlib/tri/trirefine.py
 delete mode 100644 lib/matplotlib/tri/tritools.py

diff --git a/doc/api/next_api_changes/removals/26909-VV.rst b/doc/api/next_api_changes/removals/26909-VV.rst
new file mode 100644
index 000000000000..bdb815eed322
--- /dev/null
+++ b/doc/api/next_api_changes/removals/26909-VV.rst
@@ -0,0 +1,4 @@
+``matplotlib.tri`` submodules are removed
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+The ``matplotlib.tri.*`` submodules are removed.  All functionality is
+available in ``matplotlib.tri`` directly and should be imported from there.
diff --git a/lib/matplotlib/tri/triangulation.py b/lib/matplotlib/tri/triangulation.py
deleted file mode 100644
index c48b09b280ff..000000000000
--- a/lib/matplotlib/tri/triangulation.py
+++ /dev/null
@@ -1,9 +0,0 @@
-from ._triangulation import *  # noqa: F401, F403
-from matplotlib import _api
-
-
-_api.warn_deprecated(
-    "3.7",
-    message=f"Importing {__name__} was deprecated in Matplotlib 3.7 and will "
-            f"be removed two minor releases later. All functionality is "
-            f"available via the top-level module matplotlib.tri")
diff --git a/lib/matplotlib/tri/tricontour.py b/lib/matplotlib/tri/tricontour.py
deleted file mode 100644
index 37406451d376..000000000000
--- a/lib/matplotlib/tri/tricontour.py
+++ /dev/null
@@ -1,9 +0,0 @@
-from ._tricontour import *  # noqa: F401, F403
-from matplotlib import _api
-
-
-_api.warn_deprecated(
-    "3.7",
-    message=f"Importing {__name__} was deprecated in Matplotlib 3.7 and will "
-            f"be removed two minor releases later. All functionality is "
-            f"available via the top-level module matplotlib.tri")
diff --git a/lib/matplotlib/tri/trifinder.py b/lib/matplotlib/tri/trifinder.py
deleted file mode 100644
index 1aff5c9d3280..000000000000
--- a/lib/matplotlib/tri/trifinder.py
+++ /dev/null
@@ -1,9 +0,0 @@
-from ._trifinder import *  # noqa: F401, F403
-from matplotlib import _api
-
-
-_api.warn_deprecated(
-    "3.7",
-    message=f"Importing {__name__} was deprecated in Matplotlib 3.7 and will "
-            f"be removed two minor releases later. All functionality is "
-            f"available via the top-level module matplotlib.tri")
diff --git a/lib/matplotlib/tri/triinterpolate.py b/lib/matplotlib/tri/triinterpolate.py
deleted file mode 100644
index 3112bd38e6c6..000000000000
--- a/lib/matplotlib/tri/triinterpolate.py
+++ /dev/null
@@ -1,9 +0,0 @@
-from ._triinterpolate import *  # noqa: F401, F403
-from matplotlib import _api
-
-
-_api.warn_deprecated(
-    "3.7",
-    message=f"Importing {__name__} was deprecated in Matplotlib 3.7 and will "
-            f"be removed two minor releases later. All functionality is "
-            f"available via the top-level module matplotlib.tri")
diff --git a/lib/matplotlib/tri/tripcolor.py b/lib/matplotlib/tri/tripcolor.py
deleted file mode 100644
index 0da87891810d..000000000000
--- a/lib/matplotlib/tri/tripcolor.py
+++ /dev/null
@@ -1,9 +0,0 @@
-from ._tripcolor import *  # noqa: F401, F403
-from matplotlib import _api
-
-
-_api.warn_deprecated(
-    "3.7",
-    message=f"Importing {__name__} was deprecated in Matplotlib 3.7 and will "
-            f"be removed two minor releases later. All functionality is "
-            f"available via the top-level module matplotlib.tri")
diff --git a/lib/matplotlib/tri/triplot.py b/lib/matplotlib/tri/triplot.py
deleted file mode 100644
index 7c012b1a59e7..000000000000
--- a/lib/matplotlib/tri/triplot.py
+++ /dev/null
@@ -1,9 +0,0 @@
-from ._triplot import *  # noqa: F401, F403
-from matplotlib import _api
-
-
-_api.warn_deprecated(
-    "3.7",
-    message=f"Importing {__name__} was deprecated in Matplotlib 3.7 and will "
-            f"be removed two minor releases later. All functionality is "
-            f"available via the top-level module matplotlib.tri")
diff --git a/lib/matplotlib/tri/trirefine.py b/lib/matplotlib/tri/trirefine.py
deleted file mode 100644
index 6f22f9e8d203..000000000000
--- a/lib/matplotlib/tri/trirefine.py
+++ /dev/null
@@ -1,9 +0,0 @@
-from ._trirefine import *  # noqa: F401, F403
-from matplotlib import _api
-
-
-_api.warn_deprecated(
-    "3.7",
-    message=f"Importing {__name__} was deprecated in Matplotlib 3.7 and will "
-            f"be removed two minor releases later. All functionality is "
-            f"available via the top-level module matplotlib.tri")
diff --git a/lib/matplotlib/tri/tritools.py b/lib/matplotlib/tri/tritools.py
deleted file mode 100644
index 9c6839ca2049..000000000000
--- a/lib/matplotlib/tri/tritools.py
+++ /dev/null
@@ -1,9 +0,0 @@
-from ._tritools import *  # noqa: F401, F403
-from matplotlib import _api
-
-
-_api.warn_deprecated(
-    "3.7",
-    message=f"Importing {__name__} was deprecated in Matplotlib 3.7 and will "
-            f"be removed two minor releases later. All functionality is "
-            f"available via the top-level module matplotlib.tri")

From eeda7055df59d07a5b10c491d1c93009a10e7bcb Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Thu, 28 Sep 2023 01:31:24 -0400
Subject: [PATCH 0223/1120] support tuple input for sketch

Co-authored-by: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
---
 lib/matplotlib/mpl-data/matplotlibrc  |  4 ++--
 lib/matplotlib/rcsetup.py             |  9 ++++++---
 lib/matplotlib/tests/test_rcparams.py | 26 +++++++-------------------
 3 files changed, 15 insertions(+), 24 deletions(-)

diff --git a/lib/matplotlib/mpl-data/matplotlibrc b/lib/matplotlib/mpl-data/matplotlibrc
index f606bab8c304..9bd8a622092e 100644
--- a/lib/matplotlib/mpl-data/matplotlibrc
+++ b/lib/matplotlib/mpl-data/matplotlibrc
@@ -669,8 +669,8 @@
 #path.snap: True  # When True, rectilinear axis-aligned paths will be snapped
                   # to the nearest pixel when certain criteria are met.
                   # When False, paths will never be snapped.
-#path.sketch: None  # May be None, or a triplet of the form:
-                    #  path.sketch: scale, length, randomness 
+#path.sketch: None  # May be None, or a tuple of the form:
+                    #  path.sketch: (scale, length, randomness) 
                     # - *scale* is the amplitude of the wiggle
                     #    perpendicular to the line (in pixels).
                     # - *length* is the length of the wiggle along the
diff --git a/lib/matplotlib/rcsetup.py b/lib/matplotlib/rcsetup.py
index 57a3859a90e7..38d4606024d3 100644
--- a/lib/matplotlib/rcsetup.py
+++ b/lib/matplotlib/rcsetup.py
@@ -555,14 +555,17 @@ def validate_bbox(s):
 
 
 def validate_sketch(s):
+
     if isinstance(s, str):
-        s = s.lower()
+        s = s.lower().strip()
+        if s.startswith("(") and s.endswith(")"):
+            s = s[1:-1]
     if s == 'none' or s is None:
         return None
     try:
         return tuple(_listify_validator(validate_float, n=3)(s))
-    except ValueError:
-        raise ValueError("Expected a 'scale, length, randomness' triplet")
+    except ValueError as exc:
+        raise ValueError("Expected a (scale, length, randomness) tuple") from exc
 
 
 def _validate_greaterthan_minushalf(s):
diff --git a/lib/matplotlib/tests/test_rcparams.py b/lib/matplotlib/tests/test_rcparams.py
index 37dd107382e0..65cd823f13a9 100644
--- a/lib/matplotlib/tests/test_rcparams.py
+++ b/lib/matplotlib/tests/test_rcparams.py
@@ -631,36 +631,24 @@ def test_rcparams_legend_loc_from_file(tmpdir, value):
         assert mpl.rcParams["legend.loc"] == value
 
 
-@pytest.mark.parametrize("value", [(1, 2, 3), '1, 2, 3'])
+@pytest.mark.parametrize("value", [(1, 2, 3), '1, 2, 3', '(1, 2, 3)'])
 def test_validate_sketch(value):
     mpl.rcParams["path.sketch"] = value
     assert mpl.rcParams["path.sketch"] == (1, 2, 3)
     assert validate_sketch(value) == (1, 2, 3)
 
 
-@pytest.mark.parametrize("value", [1, '1', '(1, 2, 3)'])
+@pytest.mark.parametrize("value", [1, '1', '1 2 3'])
 def test_validate_sketch_error(value):
-    with pytest.raises(ValueError, match="'scale, length, randomness'"):
+    with pytest.raises(ValueError, match="scale, length, randomness"):
         validate_sketch(value)
-    with pytest.raises(ValueError, match="'scale, length, randomness'"):
+    with pytest.raises(ValueError, match="scale, length, randomness"):
         mpl.rcParams["path.sketch"] = value
 
 
-def test_rcparams_path_sketch_from_file(tmpdir):
+@pytest.mark.parametrize("value", ['1, 2, 3', '(1,2,3)'])
+def test_rcparams_path_sketch_from_file(tmpdir, value):
     rc_path = tmpdir.join("matplotlibrc")
-    rc_path.write("path.sketch: 1, 2, 3")
-
+    rc_path.write(f"path.sketch: {value}")
     with mpl.rc_context(fname=rc_path):
         assert mpl.rcParams["path.sketch"] == (1, 2, 3)
-
-
-def test_rcparams_path_sketch_from_file_error(tmpdir, caplog):
-    # rcParams parser doesn't read a tuple rcfile entry
-    rc_path = tmpdir.join("matplotlibrc")
-    rc_path.write("path.sketch: (1, 2, 3)")
-
-    with mpl.rc_context(fname=rc_path):
-        with caplog.at_level("WARNING"):
-            assert mpl.rcParams['path.sketch'] is None
-            assert ("Expected a 'scale, length, randomness' triplet"
-                     in caplog.text)

From 06e47316ed527d10be9199774e43d55bcedc527d Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Mon, 2 Oct 2023 11:37:19 -0500
Subject: [PATCH 0224/1120] Switch to tempdirectory for windows support and
 autocleanup

---
 tools/stubtest.py | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/tools/stubtest.py b/tools/stubtest.py
index 71de6bda20c8..7c93d2dae157 100644
--- a/tools/stubtest.py
+++ b/tools/stubtest.py
@@ -52,25 +52,25 @@ def visit_ClassDef(self, node):
             self.visit(child)
 
 
-with tempfile.NamedTemporaryFile("wt", delete=False) as f:
-    for path in mpl.glob("**/*.py"):
-        v = Visitor(path, f)
-        tree = ast.parse(path.read_text())
+with tempfile.TemporaryDirectory() as d:
+    p = pathlib.Path(d) / "allowlist.txt"
+    with p.open("wt") as f:
+        for path in mpl.glob("**/*.py"):
+            v = Visitor(path, f)
+            tree = ast.parse(path.read_text())
 
-        # Assign parents to tree so they can be backtraced
-        for node in ast.walk(tree):
-            for child in ast.iter_child_nodes(node):
-                child.parent = node
+            # Assign parents to tree so they can be backtraced
+            for node in ast.walk(tree):
+                for child in ast.iter_child_nodes(node):
+                    child.parent = node
 
-        v.visit(tree)
-    f.flush()
-    f.close()
+            v.visit(tree)
     proc = subprocess.run(
         [
             "stubtest",
             "--mypy-config-file=pyproject.toml",
             "--allowlist=ci/mypy-stubtest-allowlist.txt",
-            f"--allowlist={f.name}",
+            f"--allowlist={p}",
             "matplotlib",
         ],
         cwd=root,

From de10600d7b8893d09264a2899a9a435a4f3af3b8 Mon Sep 17 00:00:00 2001
From: iamfaham <iamfaham5@gmail.com>
Date: Wed, 4 Oct 2023 01:01:22 +0530
Subject: [PATCH 0225/1120] Reformatted docs under galleries/tutorials and
 galleries/users_explain/toolkits

---
 galleries/tutorials/index.rst                  | 12 ++++++------
 galleries/users_explain/toolkits/axes_grid.rst |  6 +++---
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/galleries/tutorials/index.rst b/galleries/tutorials/index.rst
index e51c35a214cd..ace37dcb6f57 100644
--- a/galleries/tutorials/index.rst
+++ b/galleries/tutorials/index.rst
@@ -118,14 +118,14 @@ User guide tutorials
 Many of our tutorials were moved from this section to :ref:`users-guide-index`:
 
 Introductory
-~~~~~~~~~~~~
+^^^^^^^^^^^^
 
 - :ref:`quick_start`
 - :ref:`customizing`
 - :ref:`animations`
 
 Intermediate
-~~~~~~~~~~~~
+^^^^^^^^^^^^
 
 - :ref:`legend_guide`
 - :ref:`color_cycle`
@@ -136,7 +136,7 @@ Intermediate
 - :ref:`imshow_extent`
 
 Advanced
-~~~~~~~~
+^^^^^^^^
 
 - :ref:`blitting`
 - :ref:`paths`
@@ -144,16 +144,16 @@ Advanced
 - :ref:`transforms_tutorial`
 
 Colors
-~~~~~~
+^^^^^^
 
 See :ref:`tutorials-colors`.
 
 Text
-~~~~
+^^^^
 
 See :ref:`tutorials-text`.
 
 Toolkits
-~~~~~~~~
+^^^^^^^^
 
 See :ref:`tutorials-toolkits`.
diff --git a/galleries/users_explain/toolkits/axes_grid.rst b/galleries/users_explain/toolkits/axes_grid.rst
index a9c39bd55b10..ba37c4cf7d78 100644
--- a/galleries/users_explain/toolkits/axes_grid.rst
+++ b/galleries/users_explain/toolkits/axes_grid.rst
@@ -86,7 +86,7 @@ colorbar whose height (or width) is in sync with the main axes
    :align: center
 
 scatter_hist.py with AxesDivider
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The :doc:`/gallery/lines_bars_and_markers/scatter_hist` example can be
 rewritten using `~.axes_grid1.axes_divider.make_axes_locatable`::
@@ -141,14 +141,14 @@ parasite axes.  To create a host axes, you may use ``host_subplot`` or
 ``host_axes`` command.
 
 Example 1: twinx
-~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^
 
 .. figure:: /gallery/axes_grid1/images/sphx_glr_parasite_simple_001.png
    :target: /gallery/axes_grid1/parasite_simple.html
    :align: center
 
 Example 2: twin
-~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^
 
 ``twin`` without a transform argument assumes that the parasite axes has the
 same data transform as the host. This can be useful when you want the

From 6665b26c72e2b1ab8d4a3844dc15751b74af5462 Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Wed, 7 Sep 2022 18:36:07 +0200
Subject: [PATCH 0226/1120] Start transitioning to pyproject.toml

---
 pyproject.toml | 88 ++++++++++++++++++++++++++++++++++++++++++++++++++
 setup.py       | 80 +--------------------------------------------
 2 files changed, 89 insertions(+), 79 deletions(-)

diff --git a/pyproject.toml b/pyproject.toml
index 4d9ccce2b290..423d6352ae8f 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,5 +1,73 @@
+[project]
+name = "matplotlib"
+authors = [
+  {email = "matplotlib-users@python.org"},
+  {name = "John D. Hunter, Michael Droettboom"}
+]
+description = "Python plotting package"
+readme = "README.md"
+license = { file = "LICENSE/LICENSE" }
+dynamic = ["version"]
+classifiers=[
+    "Development Status :: 5 - Production/Stable",
+    "Framework :: Matplotlib",
+    "Intended Audience :: Science/Research",
+    "Intended Audience :: Education",
+    "License :: OSI Approved :: Python Software Foundation License",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Visualization",
+]
+
+# When updating the list of dependencies, add an api_changes/development
+# entry and also update the following places:
+# - lib/matplotlib/__init__.py (matplotlib._check_versions())
+# - requirements/testing/minver.txt
+# - doc/devel/dependencies.rst
+# - .github/workflows/tests.yml
+# - environment.yml
+dependencies = [
+    "contourpy >= 1.0.1",
+    "cycler >= 0.10",
+    "fonttools >= 4.22.0",
+    "kiwisolver >= 1.3.1",
+    "numpy >= 1.21",
+    "packaging >= 20.0",
+    "pillow >= 8",
+    "pyparsing >= 2.3.1",
+    "python-dateutil >= 2.7",
+    "setuptools >= 64",
+    "setuptools_scm >= 7",
+    "importlib-resources >= 3.2.0; python_version < '3.10'",
+]
+requires-python = ">=3.9"
+
+[project.optional-dependencies]
+# Should be a copy of the build dependencies below.
+dev = [
+    "certifi>=2020.06.20",
+    "numpy>=1.25",
+    "pybind11>=2.6",
+    "setuptools>=64",
+    "setuptools_scm>=7",
+]
+
+[project.urls]
+"Homepage" = "https://matplotlib.org"
+"Download" = "https://matplotlib.org/stable/users/installing/index.html"
+"Documentation" = "https://matplotlib.org"
+"Source Code" = "https://github.com/matplotlib/matplotlib"
+"Bug Tracker" = "https://github.com/matplotlib/matplotlib/issues"
+"Forum" = "https://discourse.matplotlib.org/"
+"Donate" = "https://numfocus.org/donate-to-matplotlib"
+
 [build-system]
 build-backend = "setuptools.build_meta"
+# Also keep in sync with optional dependencies above.
 requires = [
     "certifi>=2020.06.20",
     "numpy>=1.25",
@@ -8,6 +76,26 @@ requires = [
     "setuptools_scm>=7",
 ]
 
+[tool.setuptools]
+platforms = ["any"]
+py-modules = ["pylab"]
+license-files = ["LICENSE/*"]
+namespace-packages = ["mpl_toolkits"]
+
+[tool.setuptools.packages.find]
+where = ["lib"]
+include = ["matplotlib*", "mpl_toolkits*"]
+exclude = [
+    "matplotlib.tests*",
+    "mpl_toolkits.axes_grid1.tests*",
+    "mpl_toolkits.axisartist.tests*",
+    "mpl_toolkits.mplot3d.tests*",
+]
+namespaces = true
+
+[tool.setuptools.exclude-package-data]
+"*" = ["*.png", "*.svg"]
+
 [tool.setuptools_scm]
 version_scheme = "release-branch-semver"
 local_scheme = "node-and-date"
diff --git a/setup.py b/setup.py
index 899021a83254..66698a3aed6c 100644
--- a/setup.py
+++ b/setup.py
@@ -29,7 +29,7 @@
 import shutil
 import subprocess
 
-from setuptools import setup, find_namespace_packages, Distribution, Extension
+from setuptools import setup, Distribution, Extension
 import setuptools.command.build_ext
 import setuptools.command.build_py
 import setuptools.command.sdist
@@ -277,89 +277,11 @@ def make_release_tree(self, base_dir, files):
             package_data[key] = list(set(val + package_data[key]))
 
 setup(  # Finally, pass this all along to setuptools to do the heavy lifting.
-    name="matplotlib",
-    description="Python plotting package",
-    author="John D. Hunter, Michael Droettboom",
-    author_email="matplotlib-users@python.org",
-    url="https://matplotlib.org",
-    download_url="https://matplotlib.org/stable/users/installing/index.html",
-    project_urls={
-        'Documentation': 'https://matplotlib.org',
-        'Source Code': 'https://github.com/matplotlib/matplotlib',
-        'Bug Tracker': 'https://github.com/matplotlib/matplotlib/issues',
-        'Forum': 'https://discourse.matplotlib.org/',
-        'Donate': 'https://numfocus.org/donate-to-matplotlib'
-    },
-    long_description=Path("README.md").read_text(encoding="utf-8"),
-    long_description_content_type="text/markdown",
-    license="PSF",
-    platforms="any",
-    classifiers=[
-        'Development Status :: 5 - Production/Stable',
-        'Framework :: Matplotlib',
-        'Intended Audience :: Science/Research',
-        'Intended Audience :: Education',
-        'License :: OSI Approved :: Python Software Foundation License',
-        'Programming Language :: Python',
-        'Programming Language :: Python :: 3',
-        'Programming Language :: Python :: 3.9',
-        'Programming Language :: Python :: 3.10',
-        'Programming Language :: Python :: 3.11',
-        'Programming Language :: Python :: 3.12',
-        'Topic :: Scientific/Engineering :: Visualization',
-    ],
-
-    package_dir={"": "lib"},
-    packages=find_namespace_packages(
-        where="lib",
-        exclude=["*baseline_images*", "*tinypages*", "*mpl-data*", "*web_backend*"],
-    ),
-    py_modules=["pylab"],
     # Dummy extension to trigger build_ext, which will swap it out with
     # real extensions that can depend on numpy for the build.
     ext_modules=[Extension("", [])],
     package_data=package_data,
 
-    python_requires='>={}'.format('.'.join(str(n) for n in py_min_version)),
-    # When updating the list of dependencies, add an api_changes/development
-    # entry and also update the following places:
-    # - lib/matplotlib/__init__.py (matplotlib._check_versions())
-    # - requirements/testing/minver.txt
-    # - doc/devel/dependencies.rst
-    # - .github/workflows/tests.yml
-    # - environment.yml
-    install_requires=[
-        "contourpy>=1.0.1",
-        "cycler>=0.10",
-        "fonttools>=4.22.0",
-        "kiwisolver>=1.3.1",
-        "numpy>=1.21",
-        "packaging>=20.0",
-        "pillow>=8",
-        "pyparsing>=2.3.1",
-        "python-dateutil>=2.7",
-    ] + (
-        # Installing from a git checkout that is not producing a wheel.
-        # setuptools_scm warns with older setuptools, which turns into errors for our
-        # test suite. However setuptools_scm does not themselves pin the version of
-        # setuptools.
-        ["setuptools_scm>=7", "setuptools>=64"] if (
-            Path(__file__).with_name(".git").exists() and
-            os.environ.get("CIBUILDWHEEL", "0") != "1"
-        ) else []
-    ),
-    extras_require={
-        ':python_version<"3.10"': [
-            "importlib-resources>=3.2.0",
-        ],
-    },
-    use_scm_version={
-        "version_scheme": "release-branch-semver",
-        "local_scheme": "node-and-date",
-        "write_to": "lib/matplotlib/_version.py",
-        "parentdir_prefix_version": "matplotlib-",
-        "fallback_version": "0.0+UNKNOWN",
-    },
     cmdclass={
         "build_ext": BuildExtraLibraries,
         "build_py": BuildPy,

From 044a5e50093a9572e72ca0a5aa2424f55d902aed Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 24 Aug 2023 03:28:10 -0400
Subject: [PATCH 0227/1120] BLD: Use Meson to build extensions

---
 .circleci/config.yml                          |   7 +-
 .gitignore                                    |   3 +
 extern/agg24-svn/meson.build                  |  22 +
 extern/meson.build                            |  41 +
 extern/ttconv/meson.build                     |  14 +
 meson.build                                   |  28 +
 meson_options.txt                             |  17 +
 src/_c_internal_utils.c                       |   6 +
 src/_tkagg.cpp                                |   7 +
 src/_ttconv.cpp                               |   2 +-
 src/meson.build                               | 191 ++++
 src/tri/_tri.cpp                              |  10 +-
 subprojects/freetype-2.11.1.wrap              |   7 +
 subprojects/freetype-2.6.1.wrap               |   9 +
 .../freetype-2.6.1-meson/LICENSE.build        |  19 +
 .../builds/unix/ftconfig.h.in                 | 498 ++++++++++
 .../include/freetype/config/ftoption.h.in     | 886 ++++++++++++++++++
 .../freetype-2.6.1-meson/meson.build          | 187 ++++
 .../packagefiles/qhull-2020.2/meson.build     |  31 +
 subprojects/qhull.wrap                        |   9 +
 20 files changed, 1982 insertions(+), 12 deletions(-)
 create mode 100644 extern/agg24-svn/meson.build
 create mode 100644 extern/meson.build
 create mode 100644 extern/ttconv/meson.build
 create mode 100644 meson.build
 create mode 100644 meson_options.txt
 create mode 100644 src/meson.build
 create mode 100644 subprojects/freetype-2.11.1.wrap
 create mode 100644 subprojects/freetype-2.6.1.wrap
 create mode 100644 subprojects/packagefiles/freetype-2.6.1-meson/LICENSE.build
 create mode 100644 subprojects/packagefiles/freetype-2.6.1-meson/builds/unix/ftconfig.h.in
 create mode 100644 subprojects/packagefiles/freetype-2.6.1-meson/include/freetype/config/ftoption.h.in
 create mode 100644 subprojects/packagefiles/freetype-2.6.1-meson/meson.build
 create mode 100644 subprojects/packagefiles/qhull-2020.2/meson.build
 create mode 100644 subprojects/qhull.wrap

diff --git a/.circleci/config.yml b/.circleci/config.yml
index 60a1e8211e60..680798abe5fb 100644
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -117,12 +117,9 @@ commands:
               python -m pip install --user -ve .
             fi
       - save_cache:
-          key: build-deps-1
+          key: build-deps-2
           paths:
-            # FreeType 2.6.1 tarball.
-            - ~/.cache/matplotlib/0a3c7dfbda6da1e8fce29232e8e96d987ababbbf71ebc8c75659e4132c367014
-            # Qhull 2020.2 tarball.
-            - ~/.cache/matplotlib/b5c2d7eb833278881b952c8a52d20179eab87766b00b865000469a45c1838b7e
+            - subprojects/packagecache
 
   doc-build:
     steps:
diff --git a/.gitignore b/.gitignore
index 9c6bb2263c99..a76efc1cd47a 100644
--- a/.gitignore
+++ b/.gitignore
@@ -44,6 +44,9 @@ pip-wheel-metadata/*
 mplsetup.cfg
 # generated by setuptools_scm
 lib/matplotlib/_version.py
+# build subproject files
+subprojects/*/
+!subprojects/packagefiles/
 
 # OS generated files #
 ######################
diff --git a/extern/agg24-svn/meson.build b/extern/agg24-svn/meson.build
new file mode 100644
index 000000000000..a1c088423cb8
--- /dev/null
+++ b/extern/agg24-svn/meson.build
@@ -0,0 +1,22 @@
+# We need a patched Agg not available elsewhere, so always use the vendored
+# version.
+
+agg_incdir = include_directories('include')
+
+agg_lib = static_library('agg',
+  'src/agg_bezier_arc.cpp',
+  'src/agg_curves.cpp',
+  'src/agg_image_filters.cpp',
+  'src/agg_trans_affine.cpp',
+  'src/agg_vcgen_contour.cpp',
+  'src/agg_vcgen_dash.cpp',
+  'src/agg_vcgen_stroke.cpp',
+  'src/agg_vpgen_segmentator.cpp',
+  include_directories : agg_incdir,
+  gnu_symbol_visibility: 'inlineshidden',
+)
+
+agg_dep = declare_dependency(
+  include_directories: agg_incdir,
+  link_with: agg_lib,
+)
diff --git a/extern/meson.build b/extern/meson.build
new file mode 100644
index 000000000000..af809ce2531d
--- /dev/null
+++ b/extern/meson.build
@@ -0,0 +1,41 @@
+# Bundled code.
+subdir('agg24-svn')
+subdir('ttconv')
+
+# External code.
+
+# FreeType 2.3 has libtool version 9.11.3 as can be checked from the tarball.
+# For FreeType>=2.4, there is a conversion table in docs/VERSIONS.txt in the
+# FreeType source tree.
+if get_option('system-freetype')
+  freetype_dep = dependency('freetype2', version: '>=9.11.3')
+else
+  # This is the version of FreeType to use when building a local version. It
+  # must match the value in `lib/matplotlib.__init__.py`. Also update the docs
+  # in `docs/devel/dependencies.rst`. Bump the cache key in
+  # `.circleci/config.yml` when changing requirements.
+  TESTING_VERSION_OF_FREETYPE = '2.6.1'
+  if host_machine.system() == 'windows' and host_machine.cpu_family() == 'aarch64'
+    # Older versions of freetype are not supported for win/arm64
+    # Matplotlib tests will not pass
+    LOCAL_FREETYPE_VERSION = '2.11.1'
+  else
+    LOCAL_FREETYPE_VERSION = TESTING_VERSION_OF_FREETYPE
+  endif
+
+  freetype_proj = subproject(
+    f'freetype-@LOCAL_FREETYPE_VERSION@',
+    default_options: ['default_library=static'])
+  freetype_dep = freetype_proj.get_variable('freetype_dep')
+endif
+
+if get_option('system-qhull')
+  qhull_dep = dependency('qhull_r', version: '>=8.0.2', required: false)
+  if not qhull_dep.found()
+    cc.check_header('libqhull_r/qhull_ra.h', required: true)
+    qhull_dep = cc.find_library('qhull_r')
+  endif
+else
+  qhull_proj = subproject('qhull')
+  qhull_dep = qhull_proj.get_variable('qhull_dep')
+endif
diff --git a/extern/ttconv/meson.build b/extern/ttconv/meson.build
new file mode 100644
index 000000000000..939eb3069c43
--- /dev/null
+++ b/extern/ttconv/meson.build
@@ -0,0 +1,14 @@
+ttconv_lib = static_library('ttconv',
+  'pprdrv_tt2.cpp',
+  'pprdrv_tt.cpp',
+  'ttutil.cpp',
+  'pprdrv.h',
+  'truetype.h',
+  dependencies: [py3_dep],
+  gnu_symbol_visibility: 'inlineshidden',
+)
+
+ttconv_dep = declare_dependency(
+  include_directories: include_directories('.'),
+  link_with: ttconv_lib,
+)
diff --git a/meson.build b/meson.build
new file mode 100644
index 000000000000..c294eea2a678
--- /dev/null
+++ b/meson.build
@@ -0,0 +1,28 @@
+project(
+  'matplotlib',
+  'c', 'cpp',
+  version: '3.9.0.dev0',
+  # qt_editor backend is MIT
+  # ResizeObserver at end of lib/matplotlib/backends/web_backend/js/mpl.js is CC0
+  # Carlogo, STIX and Computer Modern is OFL
+  # DejaVu is Bitstream Vera and Public Domain
+  license: 'PSF-2.0 AND MIT AND CC0-1.0 AND OFL-1.1 AND Bitstream-Vera AND Public-Domain',
+  default_options: [
+    'b_lto=true',
+    'cpp_std=c++11',
+    'auto_features=disabled',  # Force FreeType to avoid extra dependencies.
+  ],
+)
+
+cc = meson.get_compiler('c')
+cpp = meson.get_compiler('cpp')
+
+# https://mesonbuild.com/Python-module.html
+py_mod = import('python')
+py3 = py_mod.find_installation()
+py3_dep = py3.dependency()
+
+pybind11_dep = dependency('pybind11', version: '>=2.6')
+
+subdir('extern')
+subdir('src')
diff --git a/meson_options.txt b/meson_options.txt
new file mode 100644
index 000000000000..0b10c331ae48
--- /dev/null
+++ b/meson_options.txt
@@ -0,0 +1,17 @@
+# By default, Matplotlib downloads and builds its own copies of FreeType and of
+# Qhull.  You may set the following to True to instead link against a system
+# FreeType/Qhull.  As an exception, Matplotlib defaults to the system version
+# of FreeType on AIX.
+option('system-freetype', type: 'boolean', value: false,
+       description: 'Build against system version of FreeType')
+option('system-qhull', type: 'boolean', value: false,
+       description: 'Build against system version of Qhull')
+
+# Some of Matplotlib's components are optional: the MacOSX backend (installed
+# by default on MacOSX; requires the Cocoa headers included with XCode), and
+# the test data (i.e., the baseline image files; not installed by default). You
+# can control whether they are installed by uncommenting the following lines.
+# Note that the MacOSX backend is never built on Linux or Windows, regardless
+# of the config value.
+option('macosx', type: 'boolean', value: true,
+       description: 'Enable MacOSX backend (requires Cocoa)')
diff --git a/src/_c_internal_utils.c b/src/_c_internal_utils.c
index f1bd22a42c54..49e5057f1349 100644
--- a/src/_c_internal_utils.c
+++ b/src/_c_internal_utils.c
@@ -1,3 +1,9 @@
+#ifdef _WIN32
+#define WIN32_LEAN_AND_MEAN
+// Windows 10, for latest HiDPI API support.
+#define WINVER 0x0A00
+#define _WIN32_WINNT 0x0A00
+#endif
 #define PY_SSIZE_T_CLEAN
 #include <Python.h>
 #ifdef __linux__
diff --git a/src/_tkagg.cpp b/src/_tkagg.cpp
index 5c36b3f07f50..a967845707d4 100644
--- a/src/_tkagg.cpp
+++ b/src/_tkagg.cpp
@@ -9,6 +9,13 @@
 // rewritten, we have removed the PIL licensing information.  If you want PIL,
 // you can get it at https://python-pillow.org/
 
+#ifdef _WIN32
+#define WIN32_LEAN_AND_MEAN
+// Windows 8.1
+#define WINVER 0x0603
+#define _WIN32_WINNT 0x0603
+#endif
+
 #define PY_SSIZE_T_CLEAN
 #include <Python.h>
 
diff --git a/src/_ttconv.cpp b/src/_ttconv.cpp
index 72fdfba6961d..51c2531bed99 100644
--- a/src/_ttconv.cpp
+++ b/src/_ttconv.cpp
@@ -8,7 +8,7 @@
 #include "mplutils.h"
 
 #include <pybind11/pybind11.h>
-#include "ttconv/pprdrv.h"
+#include "pprdrv.h"
 #include <vector>
 
 namespace py = pybind11;
diff --git a/src/meson.build b/src/meson.build
new file mode 100644
index 000000000000..6a33d2dfb12a
--- /dev/null
+++ b/src/meson.build
@@ -0,0 +1,191 @@
+# NumPy include directory - needed in all submodules
+# The try-except is needed because when things are split across drives on Windows, there
+# is no relative path and an exception gets raised. There may be other such cases, so add
+# a catch-all and switch to an absolute path. Relative paths are needed when for example
+# a virtualenv is placed inside the source tree; Meson rejects absolute paths to places
+# inside the source tree.
+# For cross-compilation it is often not possible to run the Python interpreter in order
+# to retrieve numpy's include directory. It can be specified in the cross file instead:
+#
+#   [properties]
+#   numpy-include-dir = /abspath/to/host-pythons/site-packages/numpy/core/include
+#
+# This uses the path as is, and avoids running the interpreter.
+incdir_numpy = meson.get_external_property('numpy-include-dir', 'not-given')
+if incdir_numpy == 'not-given'
+  incdir_numpy = run_command(py3,
+    [
+      '-c',
+      '''import os
+import numpy as np
+try:
+    incdir = os.path.relpath(np.get_include())
+except Exception:
+    incdir = np.get_include()
+print(incdir)'''
+    ],
+    check: true
+  ).stdout().strip()
+endif
+numpy_dep = declare_dependency(
+  compile_args: [
+    '-DNPY_NO_DEPRECATED_API=NPY_1_7_API_VERSION',
+    # Allow NumPy's printf format specifiers in C++.
+    '-D__STDC_FORMAT_MACROS=1',
+  ],
+  include_directories: include_directories(incdir_numpy),
+  dependencies: py3_dep,
+)
+
+# For cross-compilation it is often not possible to run the Python interpreter in order
+# to retrieve the platform-specific /dev/null. It can be specified in the cross file
+# instead:
+#
+#   [properties]
+#   devnull = /dev/null
+#
+# This uses the value as is, and avoids running the interpreter.
+devnull = meson.get_external_property('devnull', 'not-given')
+if devnull == 'not-given'
+  devnull = run_command(py3, '-c', 'import os; print(os.devnull)',
+                        capture: true, check: true).stdout().strip()
+endif
+
+# Will only exist on Linux with older glibc.
+dl = cc.find_library('dl', required: false)
+
+# With Meson >= 1.2.0, use cpp_winlibs instead of manually searching.
+if ['cygwin', 'windows'].contains(host_machine.system())
+  comctl32 = cc.find_library('comctl32')
+  ole32 = cc.find_library('ole32')
+  psapi = cc.find_library('psapi')
+  shell32 = cc.find_library('shell32')
+  user32 = cc.find_library('user32')
+else
+  comctl32 = []
+  ole32 = []
+  psapi = []
+  shell32 = []
+  user32 = []
+endif
+
+extension_data = {
+  '_backend_agg': {
+    'subdir': 'matplotlib/backends',
+    'sources': files(
+      'py_converters.cpp',
+      '_backend_agg.cpp',
+      '_backend_agg_wrapper.cpp',
+    ),
+    'dependencies': [agg_dep, numpy_dep, freetype_dep],
+  },
+  '_c_internal_utils': {
+    'subdir': 'matplotlib',
+    'sources': files(
+      '_c_internal_utils.c',
+    ),
+    'dependencies': [py3_dep, dl, ole32, shell32, user32],
+  },
+  'ft2font': {
+    'subdir': 'matplotlib',
+    'sources': files(
+      'ft2font.cpp',
+      'ft2font_wrapper.cpp',
+      'py_converters.cpp',
+    ),
+    'dependencies': [
+      freetype_dep, numpy_dep, agg_dep.partial_dependency(includes: true),
+    ],
+  },
+  '_image': {
+    'subdir': 'matplotlib',
+    'sources': files(
+      '_image_wrapper.cpp',
+      'py_converters_11.cpp',
+    ),
+    'dependencies': [
+      pybind11_dep,
+      # Only need source code files agg_image_filters.cpp and agg_trans_affine.cpp
+      agg_dep,
+    ],
+  },
+  '_path': {
+    'subdir': 'matplotlib',
+    'sources': files(
+      'py_converters.cpp',
+      '_path_wrapper.cpp',
+    ),
+    'dependencies': [numpy_dep, agg_dep],
+  },
+  '_qhull': {
+    'subdir': 'matplotlib',
+    'sources': files(
+      '_qhull_wrapper.cpp',
+    ),
+    'dependencies': [numpy_dep, qhull_dep],
+    'c_args': [f'-DMPL_DEVNULL=@devnull@'],
+    'cpp_args': [f'-DMPL_DEVNULL=@devnull@'],
+  },
+  '_tkagg': {
+    'subdir': 'matplotlib/backends',
+    'sources': files(
+      '_tkagg.cpp',
+    ),
+    'include_directories': include_directories('.'),
+    # The dl/psapi libraries are needed for finding Tcl/Tk at run time.
+    'dependencies': [
+      numpy_dep, agg_dep.partial_dependency(includes: true), dl, comctl32, psapi,
+    ],
+  },
+  '_tri': {
+    'subdir': 'matplotlib',
+    'sources': files(
+      'tri/_tri.cpp',
+      'tri/_tri_wrapper.cpp',
+    ),
+    'dependencies': [pybind11_dep],
+  },
+  '_ttconv': {
+    'subdir': 'matplotlib',
+    'sources': files(
+      '_ttconv.cpp',
+    ),
+    'dependencies': [ttconv_dep, pybind11_dep],
+  },
+}
+
+cpp_special_arguments = []
+if cpp.get_id() == 'msvc' and get_option('buildtype') != 'plain'
+  # Disable FH4 Exception Handling implementation so that we don't require
+  # VCRUNTIME140_1.dll. For more details, see:
+  # https://devblogs.microsoft.com/cppblog/making-cpp-exception-handling-smaller-x64/
+  # https://github.com/joerick/cibuildwheel/issues/423#issuecomment-677763904
+  cpp_special_arguments += ['/d2FH4-']
+endif
+
+foreach ext, kwargs : extension_data
+  # Ensure that PY_ARRAY_UNIQUE_SYMBOL is uniquely defined for each extension.
+  unique_array_api = '-DPY_ARRAY_UNIQUE_SYMBOL=MPL_@0@_ARRAY_API'.format(ext.replace('.', '_'))
+  additions = {
+    'c_args': [unique_array_api] + kwargs.get('c_args', []),
+    'cpp_args': cpp_special_arguments + [unique_array_api] + kwargs.get('cpp_args', []),
+  }
+  py3.extension_module(
+    ext,
+    install: true,
+    kwargs: kwargs + additions)
+endforeach
+
+if get_option('macosx') and host_machine.system() == 'darwin'
+  add_languages('objc', native: false)
+  py3.extension_module(
+    '_macosx',
+    subdir: 'matplotlib/backends',
+    sources: files(
+      '_macosx.m',
+    ),
+    dependencies: dependency('appleframeworks', modules: 'Cocoa'),
+    override_options: ['werror=true'],
+    install: true,
+  )
+endif
diff --git a/src/tri/_tri.cpp b/src/tri/_tri.cpp
index 2674a3140b35..5c01dbfa681c 100644
--- a/src/tri/_tri.cpp
+++ b/src/tri/_tri.cpp
@@ -1,9 +1,7 @@
-/* This file contains liberal use of asserts to assist code development and
- * debugging.  Standard matplotlib builds disable asserts so they cause no
- * performance reduction.  To enable the asserts, you need to undefine the
- * NDEBUG macro, which is achieved by adding the following
- *     undef_macros=['NDEBUG']
- * to the appropriate make_extension call in setupext.py, and then rebuilding.
+/* This file contains liberal use of asserts to assist code development and debugging.
+ * Standard Matplotlib builds disable asserts so they cause no performance reduction. To
+ * enable the asserts, you need to undefine the NDEBUG macro, which is achieved by
+ * passing ``b_ndebug=false`` to the Meson configuration.
  */
 #include "../mplutils.h"
 #include "_tri.h"
diff --git a/subprojects/freetype-2.11.1.wrap b/subprojects/freetype-2.11.1.wrap
new file mode 100644
index 000000000000..af4e91e2d0a5
--- /dev/null
+++ b/subprojects/freetype-2.11.1.wrap
@@ -0,0 +1,7 @@
+[wrap-file]
+source_url = https://download.savannah.gnu.org/releases/freetype/freetype-2.11.1.tar.xz
+source_filename = freetype-2.11.1.tar.xz
+source_hash = 3333ae7cfda88429c97a7ae63b7d01ab398076c3b67182e960e5684050f2c5c8
+
+[provide]
+freetype-2.11.1 = freetype_dep
diff --git a/subprojects/freetype-2.6.1.wrap b/subprojects/freetype-2.6.1.wrap
new file mode 100644
index 000000000000..9da2890cdac8
--- /dev/null
+++ b/subprojects/freetype-2.6.1.wrap
@@ -0,0 +1,9 @@
+[wrap-file]
+source_url = https://download.savannah.gnu.org/releases/freetype/freetype-old/freetype-2.6.1.tar.gz
+source_filename = freetype-2.6.1.tar.gz
+source_hash = 0a3c7dfbda6da1e8fce29232e8e96d987ababbbf71ebc8c75659e4132c367014
+
+patch_directory = freetype-2.6.1-meson
+
+[provide]
+freetype-2.6.1 = freetype_dep
diff --git a/subprojects/packagefiles/freetype-2.6.1-meson/LICENSE.build b/subprojects/packagefiles/freetype-2.6.1-meson/LICENSE.build
new file mode 100644
index 000000000000..ec288041f388
--- /dev/null
+++ b/subprojects/packagefiles/freetype-2.6.1-meson/LICENSE.build
@@ -0,0 +1,19 @@
+Copyright (c) 2018 The Meson development team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/subprojects/packagefiles/freetype-2.6.1-meson/builds/unix/ftconfig.h.in b/subprojects/packagefiles/freetype-2.6.1-meson/builds/unix/ftconfig.h.in
new file mode 100644
index 000000000000..400f3a2a5bf2
--- /dev/null
+++ b/subprojects/packagefiles/freetype-2.6.1-meson/builds/unix/ftconfig.h.in
@@ -0,0 +1,498 @@
+/***************************************************************************/
+/*                                                                         */
+/*  ftconfig.in                                                            */
+/*                                                                         */
+/*    UNIX-specific configuration file (specification only).               */
+/*                                                                         */
+/*  Copyright 1996-2015 by                                                 */
+/*  David Turner, Robert Wilhelm, and Werner Lemberg.                      */
+/*                                                                         */
+/*  This file is part of the FreeType project, and may only be used,       */
+/*  modified, and distributed under the terms of the FreeType project      */
+/*  license, LICENSE.TXT.  By continuing to use, modify, or distribute     */
+/*  this file you indicate that you have read the license and              */
+/*  understand and accept it fully.                                        */
+/*                                                                         */
+/***************************************************************************/
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* This header file contains a number of macro definitions that are used */
+  /* by the rest of the engine.  Most of the macros here are automatically */
+  /* determined at compile time, and you should not need to change it to   */
+  /* port FreeType, except to compile the library with a non-ANSI          */
+  /* compiler.                                                             */
+  /*                                                                       */
+  /* Note however that if some specific modifications are needed, we       */
+  /* advise you to place a modified copy in your build directory.          */
+  /*                                                                       */
+  /* The build directory is usually `builds/<system>', and contains        */
+  /* system-specific files that are always included first when building    */
+  /* the library.                                                          */
+  /*                                                                       */
+  /*************************************************************************/
+
+/* MESON: based on unix/ftconfig.in with but meson-friendly configuration defines */
+
+#ifndef FTCONFIG_H_
+#define FTCONFIG_H_
+
+#include <ft2build.h>
+#include FT_CONFIG_OPTIONS_H
+#include FT_CONFIG_STANDARD_LIBRARY_H
+
+
+FT_BEGIN_HEADER
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /*               PLATFORM-SPECIFIC CONFIGURATION MACROS                  */
+  /*                                                                       */
+  /* These macros can be toggled to suit a specific system.  The current   */
+  /* ones are defaults used to compile FreeType in an ANSI C environment   */
+  /* (16bit compilers are also supported).  Copy this file to your own     */
+  /* `builds/<system>' directory, and edit it to port the engine.          */
+  /*                                                                       */
+  /*************************************************************************/
+
+
+#define HAVE_UNISTD_H @HAVE_UNISTD_H@
+#define HAVE_FCNTL_H @HAVE_FCNTL_H@
+#define HAVE_STDINT_H @HAVE_STDINT_H@
+
+
+  /* There are systems (like the Texas Instruments 'C54x) where a `char' */
+  /* has 16 bits.  ANSI C says that sizeof(char) is always 1.  Since an  */
+  /* `int' has 16 bits also for this system, sizeof(int) gives 1 which   */
+  /* is probably unexpected.                                             */
+  /*                                                                     */
+  /* `CHAR_BIT' (defined in limits.h) gives the number of bits in a      */
+  /* `char' type.                                                        */
+
+#ifndef FT_CHAR_BIT
+#define FT_CHAR_BIT  CHAR_BIT
+#endif
+
+
+#undef FT_USE_AUTOCONF_SIZEOF_TYPES
+#ifdef FT_USE_AUTOCONF_SIZEOF_TYPES
+
+#undef SIZEOF_INT
+#undef SIZEOF_LONG
+#define FT_SIZEOF_INT  SIZEOF_INT
+#define FT_SIZEOF_LONG SIZEOF_LONG
+
+#else /* !FT_USE_AUTOCONF_SIZEOF_TYPES */
+
+  /* Following cpp computation of the bit length of int and long */
+  /* is copied from default include/freetype/config/ftconfig.h.  */
+  /* If any improvement is required for this file, it should be  */
+  /* applied to the original header file for the builders that   */
+  /* do not use configure script.                                */
+
+  /* The size of an `int' type.  */
+#if                                 FT_UINT_MAX == 0xFFFFUL
+#define FT_SIZEOF_INT  (16 / FT_CHAR_BIT)
+#elif                               FT_UINT_MAX == 0xFFFFFFFFUL
+#define FT_SIZEOF_INT  (32 / FT_CHAR_BIT)
+#elif FT_UINT_MAX > 0xFFFFFFFFUL && FT_UINT_MAX == 0xFFFFFFFFFFFFFFFFUL
+#define FT_SIZEOF_INT  (64 / FT_CHAR_BIT)
+#else
+#error "Unsupported size of `int' type!"
+#endif
+
+  /* The size of a `long' type.  A five-byte `long' (as used e.g. on the */
+  /* DM642) is recognized but avoided.                                   */
+#if                                  FT_ULONG_MAX == 0xFFFFFFFFUL
+#define FT_SIZEOF_LONG  (32 / FT_CHAR_BIT)
+#elif FT_ULONG_MAX > 0xFFFFFFFFUL && FT_ULONG_MAX == 0xFFFFFFFFFFUL
+#define FT_SIZEOF_LONG  (32 / FT_CHAR_BIT)
+#elif FT_ULONG_MAX > 0xFFFFFFFFUL && FT_ULONG_MAX == 0xFFFFFFFFFFFFFFFFUL
+#define FT_SIZEOF_LONG  (64 / FT_CHAR_BIT)
+#else
+#error "Unsupported size of `long' type!"
+#endif
+
+#endif /* !FT_USE_AUTOCONF_SIZEOF_TYPES */
+
+
+  /* FT_UNUSED is a macro used to indicate that a given parameter is not  */
+  /* used -- this is only used to get rid of unpleasant compiler warnings */
+#ifndef FT_UNUSED
+#define FT_UNUSED( arg )  ( (arg) = (arg) )
+#endif
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /*                     AUTOMATIC CONFIGURATION MACROS                    */
+  /*                                                                       */
+  /* These macros are computed from the ones defined above.  Don't touch   */
+  /* their definition, unless you know precisely what you are doing.  No   */
+  /* porter should need to mess with them.                                 */
+  /*                                                                       */
+  /*************************************************************************/
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* Mac support                                                           */
+  /*                                                                       */
+  /*   This is the only necessary change, so it is defined here instead    */
+  /*   providing a new configuration file.                                 */
+  /*                                                                       */
+#if defined( __APPLE__ ) || ( defined( __MWERKS__ ) && defined( macintosh ) )
+  /* no Carbon frameworks for 64bit 10.4.x */
+  /* AvailabilityMacros.h is available since Mac OS X 10.2,        */
+  /* so guess the system version by maximum errno before inclusion */
+#include <errno.h>
+#ifdef ECANCELED /* defined since 10.2 */
+#include "AvailabilityMacros.h"
+#endif
+#if defined( __LP64__ ) && \
+    ( MAC_OS_X_VERSION_MIN_REQUIRED <= MAC_OS_X_VERSION_10_4 )
+/undef FT_MACINTOSH
+#endif
+
+#elif defined( __SC__ ) || defined( __MRC__ )
+  /* Classic MacOS compilers */
+#include "ConditionalMacros.h"
+#if TARGET_OS_MAC
+#define FT_MACINTOSH 1
+#endif
+
+#endif
+
+
+  /* Fix compiler warning with sgi compiler */
+#if defined( __sgi ) && !defined( __GNUC__ )
+#if defined( _COMPILER_VERSION ) && ( _COMPILER_VERSION >= 730 )
+#pragma set woff 3505
+#endif
+#endif
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* <Section>                                                             */
+  /*    basic_types                                                        */
+  /*                                                                       */
+  /*************************************************************************/
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* <Type>                                                                */
+  /*    FT_Int16                                                           */
+  /*                                                                       */
+  /* <Description>                                                         */
+  /*    A typedef for a 16bit signed integer type.                         */
+  /*                                                                       */
+  typedef signed short  FT_Int16;
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* <Type>                                                                */
+  /*    FT_UInt16                                                          */
+  /*                                                                       */
+  /* <Description>                                                         */
+  /*    A typedef for a 16bit unsigned integer type.                       */
+  /*                                                                       */
+  typedef unsigned short  FT_UInt16;
+
+  /* */
+
+
+  /* this #if 0 ... #endif clause is for documentation purposes */
+#if 0
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* <Type>                                                                */
+  /*    FT_Int32                                                           */
+  /*                                                                       */
+  /* <Description>                                                         */
+  /*    A typedef for a 32bit signed integer type.  The size depends on    */
+  /*    the configuration.                                                 */
+  /*                                                                       */
+  typedef signed XXX  FT_Int32;
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* <Type>                                                                */
+  /*    FT_UInt32                                                          */
+  /*                                                                       */
+  /*    A typedef for a 32bit unsigned integer type.  The size depends on  */
+  /*    the configuration.                                                 */
+  /*                                                                       */
+  typedef unsigned XXX  FT_UInt32;
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* <Type>                                                                */
+  /*    FT_Int64                                                           */
+  /*                                                                       */
+  /*    A typedef for a 64bit signed integer type.  The size depends on    */
+  /*    the configuration.  Only defined if there is real 64bit support;   */
+  /*    otherwise, it gets emulated with a structure (if necessary).       */
+  /*                                                                       */
+  typedef signed XXX  FT_Int64;
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* <Type>                                                                */
+  /*    FT_UInt64                                                          */
+  /*                                                                       */
+  /*    A typedef for a 64bit unsigned integer type.  The size depends on  */
+  /*    the configuration.  Only defined if there is real 64bit support;   */
+  /*    otherwise, it gets emulated with a structure (if necessary).       */
+  /*                                                                       */
+  typedef unsigned XXX  FT_UInt64;
+
+  /* */
+
+#endif
+
+#if FT_SIZEOF_INT == 4
+
+  typedef signed int      FT_Int32;
+  typedef unsigned int    FT_UInt32;
+
+#elif FT_SIZEOF_LONG == 4
+
+  typedef signed long     FT_Int32;
+  typedef unsigned long   FT_UInt32;
+
+#else
+#error "no 32bit type found -- please check your configuration files"
+#endif
+
+
+  /* look up an integer type that is at least 32 bits */
+#if FT_SIZEOF_INT >= 4
+
+  typedef int            FT_Fast;
+  typedef unsigned int   FT_UFast;
+
+#elif FT_SIZEOF_LONG >= 4
+
+  typedef long           FT_Fast;
+  typedef unsigned long  FT_UFast;
+
+#endif
+
+
+  /* determine whether we have a 64-bit int type for platforms without */
+  /* Autoconf                                                          */
+#if FT_SIZEOF_LONG == 8
+
+  /* FT_LONG64 must be defined if a 64-bit type is available */
+#define FT_LONG64
+#define FT_INT64   long
+#define FT_UINT64  unsigned long
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* A 64-bit data type may create compilation problems if you compile     */
+  /* in strict ANSI mode.  To avoid them, we disable other 64-bit data     */
+  /* types if __STDC__ is defined.  You can however ignore this rule       */
+  /* by defining the FT_CONFIG_OPTION_FORCE_INT64 configuration macro.     */
+  /*                                                                       */
+#elif !defined( __STDC__ ) || defined( FT_CONFIG_OPTION_FORCE_INT64 )
+
+#if defined( _MSC_VER ) && _MSC_VER >= 900  /* Visual C++ (and Intel C++) */
+
+  /* this compiler provides the __int64 type */
+#define FT_LONG64
+#define FT_INT64   __int64
+#define FT_UINT64  unsigned __int64
+
+#elif defined( __BORLANDC__ )  /* Borland C++ */
+
+  /* XXXX: We should probably check the value of __BORLANDC__ in order */
+  /*       to test the compiler version.                               */
+
+  /* this compiler provides the __int64 type */
+#define FT_LONG64
+#define FT_INT64   __int64
+#define FT_UINT64  unsigned __int64
+
+#elif defined( __WATCOMC__ )   /* Watcom C++ */
+
+  /* Watcom doesn't provide 64-bit data types */
+
+#elif defined( __MWERKS__ )    /* Metrowerks CodeWarrior */
+
+#define FT_LONG64
+#define FT_INT64   long long int
+#define FT_UINT64  unsigned long long int
+
+#elif defined( __GNUC__ )
+
+  /* GCC provides the `long long' type */
+#define FT_LONG64
+#define FT_INT64   long long int
+#define FT_UINT64  unsigned long long int
+
+#endif /* _MSC_VER */
+
+#endif /* FT_SIZEOF_LONG == 8 */
+
+#ifdef FT_LONG64
+  typedef FT_INT64   FT_Int64;
+  typedef FT_UINT64  FT_UInt64;
+#endif
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* miscellaneous                                                         */
+  /*                                                                       */
+  /*************************************************************************/
+
+
+#define FT_BEGIN_STMNT  do {
+#define FT_END_STMNT    } while ( 0 )
+#define FT_DUMMY_STMNT  FT_BEGIN_STMNT FT_END_STMNT
+
+
+  /* typeof condition taken from gnulib's `intprops.h' header file */
+#if ( __GNUC__ >= 2                         || \
+      defined( __IBM__TYPEOF__ )            || \
+      ( __SUNPRO_C >= 0x5110 && !__STDC__ ) )
+#define FT_TYPEOF( type )  (__typeof__ (type))
+#else
+#define FT_TYPEOF( type )  /* empty */
+#endif
+
+
+#ifdef FT_MAKE_OPTION_SINGLE_OBJECT
+
+#define FT_LOCAL( x )      static  x
+#define FT_LOCAL_DEF( x )  static  x
+
+#else
+
+#ifdef __cplusplus
+#define FT_LOCAL( x )      extern "C"  x
+#define FT_LOCAL_DEF( x )  extern "C"  x
+#else
+#define FT_LOCAL( x )      extern  x
+#define FT_LOCAL_DEF( x )  x
+#endif
+
+#endif /* FT_MAKE_OPTION_SINGLE_OBJECT */
+
+#define FT_LOCAL_ARRAY( x )      extern const  x
+#define FT_LOCAL_ARRAY_DEF( x )  const  x
+
+
+#ifndef FT_BASE
+
+#ifdef __cplusplus
+#define FT_BASE( x )  extern "C"  x
+#else
+#define FT_BASE( x )  extern  x
+#endif
+
+#endif /* !FT_BASE */
+
+
+#ifndef FT_BASE_DEF
+
+#ifdef __cplusplus
+#define FT_BASE_DEF( x )  x
+#else
+#define FT_BASE_DEF( x )  x
+#endif
+
+#endif /* !FT_BASE_DEF */
+
+
+#ifndef FT_EXPORT
+
+#ifdef __cplusplus
+#define FT_EXPORT( x )  extern "C"  x
+#else
+#define FT_EXPORT( x )  extern  x
+#endif
+
+#endif /* !FT_EXPORT */
+
+
+#ifndef FT_EXPORT_DEF
+
+#ifdef __cplusplus
+#define FT_EXPORT_DEF( x )  extern "C"  x
+#else
+#define FT_EXPORT_DEF( x )  extern  x
+#endif
+
+#endif /* !FT_EXPORT_DEF */
+
+
+#ifndef FT_EXPORT_VAR
+
+#ifdef __cplusplus
+#define FT_EXPORT_VAR( x )  extern "C"  x
+#else
+#define FT_EXPORT_VAR( x )  extern  x
+#endif
+
+#endif /* !FT_EXPORT_VAR */
+
+  /* The following macros are needed to compile the library with a   */
+  /* C++ compiler and with 16bit compilers.                          */
+  /*                                                                 */
+
+  /* This is special.  Within C++, you must specify `extern "C"' for */
+  /* functions which are used via function pointers, and you also    */
+  /* must do that for structures which contain function pointers to  */
+  /* assure C linkage -- it's not possible to have (local) anonymous */
+  /* functions which are accessed by (global) function pointers.     */
+  /*                                                                 */
+  /*                                                                 */
+  /* FT_CALLBACK_DEF is used to _define_ a callback function.        */
+  /*                                                                 */
+  /* FT_CALLBACK_TABLE is used to _declare_ a constant variable that */
+  /* contains pointers to callback functions.                        */
+  /*                                                                 */
+  /* FT_CALLBACK_TABLE_DEF is used to _define_ a constant variable   */
+  /* that contains pointers to callback functions.                   */
+  /*                                                                 */
+  /*                                                                 */
+  /* Some 16bit compilers have to redefine these macros to insert    */
+  /* the infamous `_cdecl' or `__fastcall' declarations.             */
+  /*                                                                 */
+#ifndef FT_CALLBACK_DEF
+#ifdef __cplusplus
+#define FT_CALLBACK_DEF( x )  extern "C"  x
+#else
+#define FT_CALLBACK_DEF( x )  static  x
+#endif
+#endif /* FT_CALLBACK_DEF */
+
+#ifndef FT_CALLBACK_TABLE
+#ifdef __cplusplus
+#define FT_CALLBACK_TABLE      extern "C"
+#define FT_CALLBACK_TABLE_DEF  extern "C"
+#else
+#define FT_CALLBACK_TABLE      extern
+#define FT_CALLBACK_TABLE_DEF  /* nothing */
+#endif
+#endif /* FT_CALLBACK_TABLE */
+
+
+FT_END_HEADER
+
+
+#endif /* FTCONFIG_H_ */
+
+
+/* END */
diff --git a/subprojects/packagefiles/freetype-2.6.1-meson/include/freetype/config/ftoption.h.in b/subprojects/packagefiles/freetype-2.6.1-meson/include/freetype/config/ftoption.h.in
new file mode 100644
index 000000000000..5df84c706800
--- /dev/null
+++ b/subprojects/packagefiles/freetype-2.6.1-meson/include/freetype/config/ftoption.h.in
@@ -0,0 +1,886 @@
+/***************************************************************************/
+/*                                                                         */
+/*  ftoption.h                                                             */
+/*                                                                         */
+/*    User-selectable configuration macros (specification only).           */
+/*                                                                         */
+/*  Copyright 1996-2015 by                                                 */
+/*  David Turner, Robert Wilhelm, and Werner Lemberg.                      */
+/*                                                                         */
+/*  This file is part of the FreeType project, and may only be used,       */
+/*  modified, and distributed under the terms of the FreeType project      */
+/*  license, LICENSE.TXT.  By continuing to use, modify, or distribute     */
+/*  this file you indicate that you have read the license and              */
+/*  understand and accept it fully.                                        */
+/*                                                                         */
+/***************************************************************************/
+
+
+#ifndef FTOPTION_H_
+#define FTOPTION_H_
+
+
+#include <ft2build.h>
+
+
+FT_BEGIN_HEADER
+
+  /*************************************************************************/
+  /*                                                                       */
+  /*                 USER-SELECTABLE CONFIGURATION MACROS                  */
+  /*                                                                       */
+  /* This file contains the default configuration macro definitions for    */
+  /* a standard build of the FreeType library.  There are three ways to    */
+  /* use this file to build project-specific versions of the library:      */
+  /*                                                                       */
+  /*  - You can modify this file by hand, but this is not recommended in   */
+  /*    cases where you would like to build several versions of the        */
+  /*    library from a single source directory.                            */
+  /*                                                                       */
+  /*  - You can put a copy of this file in your build directory, more      */
+  /*    precisely in `$BUILD/freetype/config/ftoption.h', where `$BUILD'   */
+  /*    is the name of a directory that is included _before_ the FreeType  */
+  /*    include path during compilation.                                   */
+  /*                                                                       */
+  /*    The default FreeType Makefiles and Jamfiles use the build          */
+  /*    directory `builds/<system>' by default, but you can easily change  */
+  /*    that for your own projects.                                        */
+  /*                                                                       */
+  /*  - Copy the file <ft2build.h> to `$BUILD/ft2build.h' and modify it    */
+  /*    slightly to pre-define the macro FT_CONFIG_OPTIONS_H used to       */
+  /*    locate this file during the build.  For example,                   */
+  /*                                                                       */
+  /*      #define FT_CONFIG_OPTIONS_H  <myftoptions.h>                     */
+  /*      #include <freetype/config/ftheader.h>                            */
+  /*                                                                       */
+  /*    will use `$BUILD/myftoptions.h' instead of this file for macro     */
+  /*    definitions.                                                       */
+  /*                                                                       */
+  /*    Note also that you can similarly pre-define the macro              */
+  /*    FT_CONFIG_MODULES_H used to locate the file listing of the modules */
+  /*    that are statically linked to the library at compile time.  By     */
+  /*    default, this file is <freetype/config/ftmodule.h>.                */
+  /*                                                                       */
+  /* We highly recommend using the third method whenever possible.         */
+  /*                                                                       */
+  /*************************************************************************/
+
+
+  /*************************************************************************/
+  /*************************************************************************/
+  /****                                                                 ****/
+  /**** G E N E R A L   F R E E T Y P E   2   C O N F I G U R A T I O N ****/
+  /****                                                                 ****/
+  /*************************************************************************/
+  /*************************************************************************/
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* Uncomment the line below if you want to activate sub-pixel rendering  */
+  /* (a.k.a. LCD rendering, or ClearType) in this build of the library.    */
+  /*                                                                       */
+  /* Note that this feature is covered by several Microsoft patents        */
+  /* and should not be activated in any default build of the library.      */
+  /*                                                                       */
+  /* This macro has no impact on the FreeType API, only on its             */
+  /* _implementation_.  For example, using FT_RENDER_MODE_LCD when calling */
+  /* FT_Render_Glyph still generates a bitmap that is 3 times wider than   */
+  /* the original size in case this macro isn't defined; however, each     */
+  /* triplet of subpixels has R=G=B.                                       */
+  /*                                                                       */
+  /* This is done to allow FreeType clients to run unmodified, forcing     */
+  /* them to display normal gray-level anti-aliased glyphs.                */
+  /*                                                                       */
+/* #define FT_CONFIG_OPTION_SUBPIXEL_RENDERING */
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* Many compilers provide a non-ANSI 64-bit data type that can be used   */
+  /* by FreeType to speed up some computations.  However, this will create */
+  /* some problems when compiling the library in strict ANSI mode.         */
+  /*                                                                       */
+  /* For this reason, the use of 64-bit integers is normally disabled when */
+  /* the __STDC__ macro is defined.  You can however disable this by       */
+  /* defining the macro FT_CONFIG_OPTION_FORCE_INT64 here.                 */
+  /*                                                                       */
+  /* For most compilers, this will only create compilation warnings when   */
+  /* building the library.                                                 */
+  /*                                                                       */
+  /* ObNote: The compiler-specific 64-bit integers are detected in the     */
+  /*         file `ftconfig.h' either statically or through the            */
+  /*         `configure' script on supported platforms.                    */
+  /*                                                                       */
+#undef FT_CONFIG_OPTION_FORCE_INT64
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* If this macro is defined, do not try to use an assembler version of   */
+  /* performance-critical functions (e.g. FT_MulFix).  You should only do  */
+  /* that to verify that the assembler function works properly, or to      */
+  /* execute benchmark tests of the various implementations.               */
+/* #define FT_CONFIG_OPTION_NO_ASSEMBLER */
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* If this macro is defined, try to use an inlined assembler version of  */
+  /* the `FT_MulFix' function, which is a `hotspot' when loading and       */
+  /* hinting glyphs, and which should be executed as fast as possible.     */
+  /*                                                                       */
+  /* Note that if your compiler or CPU is not supported, this will default */
+  /* to the standard and portable implementation found in `ftcalc.c'.      */
+  /*                                                                       */
+#define FT_CONFIG_OPTION_INLINE_MULFIX
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* LZW-compressed file support.                                          */
+  /*                                                                       */
+  /*   FreeType now handles font files that have been compressed with the  */
+  /*   `compress' program.  This is mostly used to parse many of the PCF   */
+  /*   files that come with various X11 distributions.  The implementation */
+  /*   uses NetBSD's `zopen' to partially uncompress the file on the fly   */
+  /*   (see src/lzw/ftgzip.c).                                             */
+  /*                                                                       */
+  /*   Define this macro if you want to enable this `feature'.             */
+  /*                                                                       */
+#define FT_CONFIG_OPTION_USE_LZW
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* Gzip-compressed file support.                                         */
+  /*                                                                       */
+  /*   FreeType now handles font files that have been compressed with the  */
+  /*   `gzip' program.  This is mostly used to parse many of the PCF files */
+  /*   that come with XFree86.  The implementation uses `zlib' to          */
+  /*   partially uncompress the file on the fly (see src/gzip/ftgzip.c).   */
+  /*                                                                       */
+  /*   Define this macro if you want to enable this `feature'.  See also   */
+  /*   the macro FT_CONFIG_OPTION_SYSTEM_ZLIB below.                       */
+  /*                                                                       */
+#define FT_CONFIG_OPTION_USE_ZLIB
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* ZLib library selection                                                */
+  /*                                                                       */
+  /*   This macro is only used when FT_CONFIG_OPTION_USE_ZLIB is defined.  */
+  /*   It allows FreeType's `ftgzip' component to link to the system's     */
+  /*   installation of the ZLib library.  This is useful on systems like   */
+  /*   Unix or VMS where it generally is already available.                */
+  /*                                                                       */
+  /*   If you let it undefined, the component will use its own copy        */
+  /*   of the zlib sources instead.  These have been modified to be        */
+  /*   included directly within the component and *not* export external    */
+  /*   function names.  This allows you to link any program with FreeType  */
+  /*   _and_ ZLib without linking conflicts.                               */
+  /*                                                                       */
+  /*   Do not #undef this macro here since the build system might define   */
+  /*   it for certain configurations only.                                 */
+  /*                                                                       */
+#mesondefine FT_CONFIG_OPTION_SYSTEM_ZLIB
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* Bzip2-compressed file support.                                        */
+  /*                                                                       */
+  /*   FreeType now handles font files that have been compressed with the  */
+  /*   `bzip2' program.  This is mostly used to parse many of the PCF      */
+  /*   files that come with XFree86.  The implementation uses `libbz2' to  */
+  /*   partially uncompress the file on the fly (see src/bzip2/ftbzip2.c). */
+  /*   Contrary to gzip, bzip2 currently is not included and need to use   */
+  /*   the system available bzip2 implementation.                          */
+  /*                                                                       */
+  /*   Define this macro if you want to enable this `feature'.             */
+  /*                                                                       */
+#mesondefine FT_CONFIG_OPTION_USE_BZIP2
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* Define to disable the use of file stream functions and types, FILE,   */
+  /* fopen() etc.  Enables the use of smaller system libraries on embedded */
+  /* systems that have multiple system libraries, some with or without     */
+  /* file stream support, in the cases where file stream support is not    */
+  /* necessary such as memory loading of font files.                       */
+  /*                                                                       */
+/* #define FT_CONFIG_OPTION_DISABLE_STREAM_SUPPORT */
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* PNG bitmap support.                                                   */
+  /*                                                                       */
+  /*   FreeType now handles loading color bitmap glyphs in the PNG format. */
+  /*   This requires help from the external libpng library.  Uncompressed  */
+  /*   color bitmaps do not need any external libraries and will be        */
+  /*   supported regardless of this configuration.                         */
+  /*                                                                       */
+  /*   Define this macro if you want to enable this `feature'.             */
+  /*                                                                       */
+#mesondefine FT_CONFIG_OPTION_USE_PNG
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* HarfBuzz support.                                                     */
+  /*                                                                       */
+  /*   FreeType uses the HarfBuzz library to improve auto-hinting of       */
+  /*   OpenType fonts.  If available, many glyphs not directly addressable */
+  /*   by a font's character map will be hinted also.                      */
+  /*                                                                       */
+  /*   Define this macro if you want to enable this `feature'.             */
+  /*                                                                       */
+#mesondefine FT_CONFIG_OPTION_USE_HARFBUZZ
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* DLL export compilation                                                */
+  /*                                                                       */
+  /*   When compiling FreeType as a DLL, some systems/compilers need a     */
+  /*   special keyword in front OR after the return type of function       */
+  /*   declarations.                                                       */
+  /*                                                                       */
+  /*   Two macros are used within the FreeType source code to define       */
+  /*   exported library functions: FT_EXPORT and FT_EXPORT_DEF.            */
+  /*                                                                       */
+  /*     FT_EXPORT( return_type )                                          */
+  /*                                                                       */
+  /*       is used in a function declaration, as in                        */
+  /*                                                                       */
+  /*         FT_EXPORT( FT_Error )                                         */
+  /*         FT_Init_FreeType( FT_Library*  alibrary );                    */
+  /*                                                                       */
+  /*                                                                       */
+  /*     FT_EXPORT_DEF( return_type )                                      */
+  /*                                                                       */
+  /*       is used in a function definition, as in                         */
+  /*                                                                       */
+  /*         FT_EXPORT_DEF( FT_Error )                                     */
+  /*         FT_Init_FreeType( FT_Library*  alibrary )                     */
+  /*         {                                                             */
+  /*           ... some code ...                                           */
+  /*           return FT_Err_Ok;                                           */
+  /*         }                                                             */
+  /*                                                                       */
+  /*   You can provide your own implementation of FT_EXPORT and            */
+  /*   FT_EXPORT_DEF here if you want.  If you leave them undefined, they  */
+  /*   will be later automatically defined as `extern return_type' to      */
+  /*   allow normal compilation.                                           */
+  /*                                                                       */
+  /*   Do not #undef these macros here since the build system might define */
+  /*   them for certain configurations only.                               */
+  /*                                                                       */
+/* #define FT_EXPORT(x)      extern x */
+/* #define FT_EXPORT_DEF(x)  x */
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* Glyph Postscript Names handling                                       */
+  /*                                                                       */
+  /*   By default, FreeType 2 is compiled with the `psnames' module.  This */
+  /*   module is in charge of converting a glyph name string into a        */
+  /*   Unicode value, or return a Macintosh standard glyph name for the    */
+  /*   use with the TrueType `post' table.                                 */
+  /*                                                                       */
+  /*   Undefine this macro if you do not want `psnames' compiled in your   */
+  /*   build of FreeType.  This has the following effects:                 */
+  /*                                                                       */
+  /*   - The TrueType driver will provide its own set of glyph names,      */
+  /*     if you build it to support postscript names in the TrueType       */
+  /*     `post' table.                                                     */
+  /*                                                                       */
+  /*   - The Type 1 driver will not be able to synthesize a Unicode        */
+  /*     charmap out of the glyphs found in the fonts.                     */
+  /*                                                                       */
+  /*   You would normally undefine this configuration macro when building  */
+  /*   a version of FreeType that doesn't contain a Type 1 or CFF driver.  */
+  /*                                                                       */
+#define FT_CONFIG_OPTION_POSTSCRIPT_NAMES
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* Postscript Names to Unicode Values support                            */
+  /*                                                                       */
+  /*   By default, FreeType 2 is built with the `PSNames' module compiled  */
+  /*   in.  Among other things, the module is used to convert a glyph name */
+  /*   into a Unicode value.  This is especially useful in order to        */
+  /*   synthesize on the fly a Unicode charmap from the CFF/Type 1 driver  */
+  /*   through a big table named the `Adobe Glyph List' (AGL).             */
+  /*                                                                       */
+  /*   Undefine this macro if you do not want the Adobe Glyph List         */
+  /*   compiled in your `PSNames' module.  The Type 1 driver will not be   */
+  /*   able to synthesize a Unicode charmap out of the glyphs found in the */
+  /*   fonts.                                                              */
+  /*                                                                       */
+#define FT_CONFIG_OPTION_ADOBE_GLYPH_LIST
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* Support for Mac fonts                                                 */
+  /*                                                                       */
+  /*   Define this macro if you want support for outline fonts in Mac      */
+  /*   format (mac dfont, mac resource, macbinary containing a mac         */
+  /*   resource) on non-Mac platforms.                                     */
+  /*                                                                       */
+  /*   Note that the `FOND' resource isn't checked.                        */
+  /*                                                                       */
+#define FT_CONFIG_OPTION_MAC_FONTS
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* Guessing methods to access embedded resource forks                    */
+  /*                                                                       */
+  /*   Enable extra Mac fonts support on non-Mac platforms (e.g.           */
+  /*   GNU/Linux).                                                         */
+  /*                                                                       */
+  /*   Resource forks which include fonts data are stored sometimes in     */
+  /*   locations which users or developers don't expected.  In some cases, */
+  /*   resource forks start with some offset from the head of a file.  In  */
+  /*   other cases, the actual resource fork is stored in file different   */
+  /*   from what the user specifies.  If this option is activated,         */
+  /*   FreeType tries to guess whether such offsets or different file      */
+  /*   names must be used.                                                 */
+  /*                                                                       */
+  /*   Note that normal, direct access of resource forks is controlled via */
+  /*   the FT_CONFIG_OPTION_MAC_FONTS option.                              */
+  /*                                                                       */
+#ifdef FT_CONFIG_OPTION_MAC_FONTS
+#define FT_CONFIG_OPTION_GUESSING_EMBEDDED_RFORK
+#endif
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* Allow the use of FT_Incremental_Interface to load typefaces that      */
+  /* contain no glyph data, but supply it via a callback function.         */
+  /* This is required by clients supporting document formats which         */
+  /* supply font data incrementally as the document is parsed, such        */
+  /* as the Ghostscript interpreter for the PostScript language.           */
+  /*                                                                       */
+#define FT_CONFIG_OPTION_INCREMENTAL
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* The size in bytes of the render pool used by the scan-line converter  */
+  /* to do all of its work.                                                */
+  /*                                                                       */
+#define FT_RENDER_POOL_SIZE  16384L
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* FT_MAX_MODULES                                                        */
+  /*                                                                       */
+  /*   The maximum number of modules that can be registered in a single    */
+  /*   FreeType library object.  32 is the default.                        */
+  /*                                                                       */
+#define FT_MAX_MODULES  32
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* Debug level                                                           */
+  /*                                                                       */
+  /*   FreeType can be compiled in debug or trace mode.  In debug mode,    */
+  /*   errors are reported through the `ftdebug' component.  In trace      */
+  /*   mode, additional messages are sent to the standard output during    */
+  /*   execution.                                                          */
+  /*                                                                       */
+  /*   Define FT_DEBUG_LEVEL_ERROR to build the library in debug mode.     */
+  /*   Define FT_DEBUG_LEVEL_TRACE to build it in trace mode.              */
+  /*                                                                       */
+  /*   Don't define any of these macros to compile in `release' mode!      */
+  /*                                                                       */
+  /*   Do not #undef these macros here since the build system might define */
+  /*   them for certain configurations only.                               */
+  /*                                                                       */
+/* #define FT_DEBUG_LEVEL_ERROR */
+/* #define FT_DEBUG_LEVEL_TRACE */
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* Autofitter debugging                                                  */
+  /*                                                                       */
+  /*   If FT_DEBUG_AUTOFIT is defined, FreeType provides some means to     */
+  /*   control the autofitter behaviour for debugging purposes with global */
+  /*   boolean variables (consequently, you should *never* enable this     */
+  /*   while compiling in `release' mode):                                 */
+  /*                                                                       */
+  /*     _af_debug_disable_horz_hints                                      */
+  /*     _af_debug_disable_vert_hints                                      */
+  /*     _af_debug_disable_blue_hints                                      */
+  /*                                                                       */
+  /*   Additionally, the following functions provide dumps of various      */
+  /*   internal autofit structures to stdout (using `printf'):             */
+  /*                                                                       */
+  /*     af_glyph_hints_dump_points                                        */
+  /*     af_glyph_hints_dump_segments                                      */
+  /*     af_glyph_hints_dump_edges                                         */
+  /*     af_glyph_hints_get_num_segments                                   */
+  /*     af_glyph_hints_get_segment_offset                                 */
+  /*                                                                       */
+  /*   As an argument, they use another global variable:                   */
+  /*                                                                       */
+  /*     _af_debug_hints                                                   */
+  /*                                                                       */
+  /*   Please have a look at the `ftgrid' demo program to see how those    */
+  /*   variables and macros should be used.                                */
+  /*                                                                       */
+  /*   Do not #undef these macros here since the build system might define */
+  /*   them for certain configurations only.                               */
+  /*                                                                       */
+/* #define FT_DEBUG_AUTOFIT */
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* Memory Debugging                                                      */
+  /*                                                                       */
+  /*   FreeType now comes with an integrated memory debugger that is       */
+  /*   capable of detecting simple errors like memory leaks or double      */
+  /*   deletes.  To compile it within your build of the library, you       */
+  /*   should define FT_DEBUG_MEMORY here.                                 */
+  /*                                                                       */
+  /*   Note that the memory debugger is only activated at runtime when     */
+  /*   when the _environment_ variable `FT2_DEBUG_MEMORY' is defined also! */
+  /*                                                                       */
+  /*   Do not #undef this macro here since the build system might define   */
+  /*   it for certain configurations only.                                 */
+  /*                                                                       */
+/* #define FT_DEBUG_MEMORY */
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* Module errors                                                         */
+  /*                                                                       */
+  /*   If this macro is set (which is _not_ the default), the higher byte  */
+  /*   of an error code gives the module in which the error has occurred,  */
+  /*   while the lower byte is the real error code.                        */
+  /*                                                                       */
+  /*   Setting this macro makes sense for debugging purposes only, since   */
+  /*   it would break source compatibility of certain programs that use    */
+  /*   FreeType 2.                                                         */
+  /*                                                                       */
+  /*   More details can be found in the files ftmoderr.h and fterrors.h.   */
+  /*                                                                       */
+#undef FT_CONFIG_OPTION_USE_MODULE_ERRORS
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* Position Independent Code                                             */
+  /*                                                                       */
+  /*   If this macro is set (which is _not_ the default), FreeType2 will   */
+  /*   avoid creating constants that require address fixups.  Instead the  */
+  /*   constants will be moved into a struct and additional intialization  */
+  /*   code will be used.                                                  */
+  /*                                                                       */
+  /*   Setting this macro is needed for systems that prohibit address      */
+  /*   fixups, such as BREW.                                               */
+  /*                                                                       */
+#mesondefine FT_CONFIG_OPTION_PIC
+
+
+  /*************************************************************************/
+  /*************************************************************************/
+  /****                                                                 ****/
+  /****        S F N T   D R I V E R    C O N F I G U R A T I O N       ****/
+  /****                                                                 ****/
+  /*************************************************************************/
+  /*************************************************************************/
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* Define TT_CONFIG_OPTION_EMBEDDED_BITMAPS if you want to support       */
+  /* embedded bitmaps in all formats using the SFNT module (namely         */
+  /* TrueType & OpenType).                                                 */
+  /*                                                                       */
+#define TT_CONFIG_OPTION_EMBEDDED_BITMAPS
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* Define TT_CONFIG_OPTION_POSTSCRIPT_NAMES if you want to be able to    */
+  /* load and enumerate the glyph Postscript names in a TrueType or        */
+  /* OpenType file.                                                        */
+  /*                                                                       */
+  /* Note that when you do not compile the `PSNames' module by undefining  */
+  /* the above FT_CONFIG_OPTION_POSTSCRIPT_NAMES, the `sfnt' module will   */
+  /* contain additional code used to read the PS Names table from a font.  */
+  /*                                                                       */
+  /* (By default, the module uses `PSNames' to extract glyph names.)       */
+  /*                                                                       */
+#define TT_CONFIG_OPTION_POSTSCRIPT_NAMES
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* Define TT_CONFIG_OPTION_SFNT_NAMES if your applications need to       */
+  /* access the internal name table in a SFNT-based format like TrueType   */
+  /* or OpenType.  The name table contains various strings used to         */
+  /* describe the font, like family name, copyright, version, etc.  It     */
+  /* does not contain any glyph name though.                               */
+  /*                                                                       */
+  /* Accessing SFNT names is done through the functions declared in        */
+  /* `ftsnames.h'.                                                         */
+  /*                                                                       */
+#define TT_CONFIG_OPTION_SFNT_NAMES
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* TrueType CMap support                                                 */
+  /*                                                                       */
+  /*   Here you can fine-tune which TrueType CMap table format shall be    */
+  /*   supported.                                                          */
+#define TT_CONFIG_CMAP_FORMAT_0
+#define TT_CONFIG_CMAP_FORMAT_2
+#define TT_CONFIG_CMAP_FORMAT_4
+#define TT_CONFIG_CMAP_FORMAT_6
+#define TT_CONFIG_CMAP_FORMAT_8
+#define TT_CONFIG_CMAP_FORMAT_10
+#define TT_CONFIG_CMAP_FORMAT_12
+#define TT_CONFIG_CMAP_FORMAT_13
+#define TT_CONFIG_CMAP_FORMAT_14
+
+
+  /*************************************************************************/
+  /*************************************************************************/
+  /****                                                                 ****/
+  /****    T R U E T Y P E   D R I V E R    C O N F I G U R A T I O N   ****/
+  /****                                                                 ****/
+  /*************************************************************************/
+  /*************************************************************************/
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* Define TT_CONFIG_OPTION_BYTECODE_INTERPRETER if you want to compile   */
+  /* a bytecode interpreter in the TrueType driver.                        */
+  /*                                                                       */
+  /* By undefining this, you will only compile the code necessary to load  */
+  /* TrueType glyphs without hinting.                                      */
+  /*                                                                       */
+  /*   Do not #undef this macro here, since the build system might         */
+  /*   define it for certain configurations only.                          */
+  /*                                                                       */
+#define TT_CONFIG_OPTION_BYTECODE_INTERPRETER
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* Define TT_CONFIG_OPTION_SUBPIXEL_HINTING if you want to compile       */
+  /* EXPERIMENTAL subpixel hinting support into the TrueType driver.  This */
+  /* replaces the native TrueType hinting mechanism when anything but      */
+  /* FT_RENDER_MODE_MONO is requested.                                     */
+  /*                                                                       */
+  /* Enabling this causes the TrueType driver to ignore instructions under */
+  /* certain conditions.  This is done in accordance with the guide here,  */
+  /* with some minor differences:                                          */
+  /*                                                                       */
+  /*  http://www.microsoft.com/typography/cleartype/truetypecleartype.aspx */
+  /*                                                                       */
+  /* By undefining this, you only compile the code necessary to hint       */
+  /* TrueType glyphs with native TT hinting.                               */
+  /*                                                                       */
+  /*   This option requires TT_CONFIG_OPTION_BYTECODE_INTERPRETER to be    */
+  /*   defined.                                                            */
+  /*                                                                       */
+/* #define TT_CONFIG_OPTION_SUBPIXEL_HINTING */
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* If you define TT_CONFIG_OPTION_UNPATENTED_HINTING, a special version  */
+  /* of the TrueType bytecode interpreter is used that doesn't implement   */
+  /* any of the patented opcodes and algorithms.  The patents related to   */
+  /* TrueType hinting have expired worldwide since May 2010; this option   */
+  /* is now deprecated.                                                    */
+  /*                                                                       */
+  /* Note that the TT_CONFIG_OPTION_UNPATENTED_HINTING macro is *ignored*  */
+  /* if you define TT_CONFIG_OPTION_BYTECODE_INTERPRETER; in other words,  */
+  /* either define TT_CONFIG_OPTION_BYTECODE_INTERPRETER or                */
+  /* TT_CONFIG_OPTION_UNPATENTED_HINTING but not both at the same time.    */
+  /*                                                                       */
+  /* This macro is only useful for a small number of font files (mostly    */
+  /* for Asian scripts) that require bytecode interpretation to properly   */
+  /* load glyphs.  For all other fonts, this produces unpleasant results,  */
+  /* thus the unpatented interpreter is never used to load glyphs from     */
+  /* TrueType fonts unless one of the following two options is used.       */
+  /*                                                                       */
+  /*   - The unpatented interpreter is explicitly activated by the user    */
+  /*     through the FT_PARAM_TAG_UNPATENTED_HINTING parameter tag         */
+  /*     when opening the FT_Face.                                         */
+  /*                                                                       */
+  /*   - FreeType detects that the FT_Face corresponds to one of the       */
+  /*     `trick' fonts (e.g., `Mingliu') it knows about.  The font engine  */
+  /*     contains a hard-coded list of font names and other matching       */
+  /*     parameters (see function `tt_face_init' in file                   */
+  /*     `src/truetype/ttobjs.c').                                         */
+  /*                                                                       */
+  /* Here a sample code snippet for using FT_PARAM_TAG_UNPATENTED_HINTING. */
+  /*                                                                       */
+  /*   {                                                                   */
+  /*     FT_Parameter  parameter;                                          */
+  /*     FT_Open_Args  open_args;                                          */
+  /*                                                                       */
+  /*                                                                       */
+  /*     parameter.tag = FT_PARAM_TAG_UNPATENTED_HINTING;                  */
+  /*                                                                       */
+  /*     open_args.flags      = FT_OPEN_PATHNAME | FT_OPEN_PARAMS;         */
+  /*     open_args.pathname   = my_font_pathname;                          */
+  /*     open_args.num_params = 1;                                         */
+  /*     open_args.params     = &parameter;                                */
+  /*                                                                       */
+  /*     error = FT_Open_Face( library, &open_args, index, &face );        */
+  /*     ...                                                               */
+  /*   }                                                                   */
+  /*                                                                       */
+/* #define TT_CONFIG_OPTION_UNPATENTED_HINTING */
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* Define TT_CONFIG_OPTION_COMPONENT_OFFSET_SCALED to compile the        */
+  /* TrueType glyph loader to use Apple's definition of how to handle      */
+  /* component offsets in composite glyphs.                                */
+  /*                                                                       */
+  /* Apple and MS disagree on the default behavior of component offsets    */
+  /* in composites.  Apple says that they should be scaled by the scaling  */
+  /* factors in the transformation matrix (roughly, it's more complex)     */
+  /* while MS says they should not.  OpenType defines two bits in the      */
+  /* composite flags array which can be used to disambiguate, but old      */
+  /* fonts will not have them.                                             */
+  /*                                                                       */
+  /*   http://www.microsoft.com/typography/otspec/glyf.htm                 */
+  /*   https://developer.apple.com/fonts/TrueType-Reference-Manual/RM06/Chap6glyf.html */
+  /*                                                                       */
+#undef TT_CONFIG_OPTION_COMPONENT_OFFSET_SCALED
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* Define TT_CONFIG_OPTION_GX_VAR_SUPPORT if you want to include         */
+  /* support for Apple's distortable font technology (fvar, gvar, cvar,    */
+  /* and avar tables).  This has many similarities to Type 1 Multiple      */
+  /* Masters support.                                                      */
+  /*                                                                       */
+#define TT_CONFIG_OPTION_GX_VAR_SUPPORT
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* Define TT_CONFIG_OPTION_BDF if you want to include support for        */
+  /* an embedded `BDF ' table within SFNT-based bitmap formats.            */
+  /*                                                                       */
+#define TT_CONFIG_OPTION_BDF
+
+
+  /*************************************************************************/
+  /*************************************************************************/
+  /****                                                                 ****/
+  /****      T Y P E 1   D R I V E R    C O N F I G U R A T I O N       ****/
+  /****                                                                 ****/
+  /*************************************************************************/
+  /*************************************************************************/
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* T1_MAX_DICT_DEPTH is the maximum depth of nest dictionaries and       */
+  /* arrays in the Type 1 stream (see t1load.c).  A minimum of 4 is        */
+  /* required.                                                             */
+  /*                                                                       */
+#define T1_MAX_DICT_DEPTH  5
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* T1_MAX_SUBRS_CALLS details the maximum number of nested sub-routine   */
+  /* calls during glyph loading.                                           */
+  /*                                                                       */
+#define T1_MAX_SUBRS_CALLS  16
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* T1_MAX_CHARSTRING_OPERANDS is the charstring stack's capacity.  A     */
+  /* minimum of 16 is required.                                            */
+  /*                                                                       */
+  /* The Chinese font MingTiEG-Medium (CNS 11643 character set) needs 256. */
+  /*                                                                       */
+#define T1_MAX_CHARSTRINGS_OPERANDS  256
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* Define this configuration macro if you want to prevent the            */
+  /* compilation of `t1afm', which is in charge of reading Type 1 AFM      */
+  /* files into an existing face.  Note that if set, the T1 driver will be */
+  /* unable to produce kerning distances.                                  */
+  /*                                                                       */
+#undef T1_CONFIG_OPTION_NO_AFM
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* Define this configuration macro if you want to prevent the            */
+  /* compilation of the Multiple Masters font support in the Type 1        */
+  /* driver.                                                               */
+  /*                                                                       */
+#undef T1_CONFIG_OPTION_NO_MM_SUPPORT
+
+
+  /*************************************************************************/
+  /*************************************************************************/
+  /****                                                                 ****/
+  /****         C F F   D R I V E R    C O N F I G U R A T I O N        ****/
+  /****                                                                 ****/
+  /*************************************************************************/
+  /*************************************************************************/
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* Using CFF_CONFIG_OPTION_DARKENING_PARAMETER_{X,Y}{1,2,3,4} it is      */
+  /* possible to set up the default values of the four control points that */
+  /* define the stem darkening behaviour of the (new) CFF engine.  For     */
+  /* more details please read the documentation of the                     */
+  /* `darkening-parameters' property of the cff driver module (file        */
+  /* `ftcffdrv.h'), which allows the control at run-time.                  */
+  /*                                                                       */
+  /* Do *not* undefine these macros!                                       */
+  /*                                                                       */
+#define CFF_CONFIG_OPTION_DARKENING_PARAMETER_X1   500
+#define CFF_CONFIG_OPTION_DARKENING_PARAMETER_Y1   400
+
+#define CFF_CONFIG_OPTION_DARKENING_PARAMETER_X2  1000
+#define CFF_CONFIG_OPTION_DARKENING_PARAMETER_Y2   275
+
+#define CFF_CONFIG_OPTION_DARKENING_PARAMETER_X3  1667
+#define CFF_CONFIG_OPTION_DARKENING_PARAMETER_Y3   275
+
+#define CFF_CONFIG_OPTION_DARKENING_PARAMETER_X4  2333
+#define CFF_CONFIG_OPTION_DARKENING_PARAMETER_Y4     0
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* CFF_CONFIG_OPTION_OLD_ENGINE controls whether the pre-Adobe CFF       */
+  /* engine gets compiled into FreeType.  If defined, it is possible to    */
+  /* switch between the two engines using the `hinting-engine' property of */
+  /* the cff driver module.                                                */
+  /*                                                                       */
+/* #define CFF_CONFIG_OPTION_OLD_ENGINE */
+
+
+  /*************************************************************************/
+  /*************************************************************************/
+  /****                                                                 ****/
+  /****    A U T O F I T   M O D U L E    C O N F I G U R A T I O N     ****/
+  /****                                                                 ****/
+  /*************************************************************************/
+  /*************************************************************************/
+
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* Compile autofit module with CJK (Chinese, Japanese, Korean) script    */
+  /* support.                                                              */
+  /*                                                                       */
+#define AF_CONFIG_OPTION_CJK
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* Compile autofit module with Indic script support.                     */
+  /*                                                                       */
+#define AF_CONFIG_OPTION_INDIC
+
+  /*************************************************************************/
+  /*                                                                       */
+  /* Compile autofit module with warp hinting.  The idea of the warping    */
+  /* code is to slightly scale and shift a glyph within a single dimension */
+  /* so that as much of its segments are aligned (more or less) on the     */
+  /* grid.  To find out the optimal scaling and shifting value, various    */
+  /* parameter combinations are tried and scored.                          */
+  /*                                                                       */
+  /* This experimental option is active only if the rendering mode is      */
+  /* FT_RENDER_MODE_LIGHT; you can switch warping on and off with the      */
+  /* `warping' property of the auto-hinter (see file `ftautoh.h' for more  */
+  /* information; by default it is switched off).                          */
+  /*                                                                       */
+#define AF_CONFIG_OPTION_USE_WARPER
+
+  /* */
+
+
+  /*
+   * This macro is obsolete.  Support has been removed in FreeType
+   * version 2.5.
+   */
+/* #define FT_CONFIG_OPTION_OLD_INTERNALS */
+
+
+  /*
+   * This macro is defined if either unpatented or native TrueType
+   * hinting is requested by the definitions above.
+   */
+#ifdef TT_CONFIG_OPTION_BYTECODE_INTERPRETER
+#define  TT_USE_BYTECODE_INTERPRETER
+#undef   TT_CONFIG_OPTION_UNPATENTED_HINTING
+#elif defined TT_CONFIG_OPTION_UNPATENTED_HINTING
+#define  TT_USE_BYTECODE_INTERPRETER
+#endif
+
+
+  /*
+   * Check CFF darkening parameters.  The checks are the same as in function
+   * `cff_property_set' in file `cffdrivr.c'.
+   */
+#if CFF_CONFIG_OPTION_DARKENING_PARAMETER_X1 < 0   || \
+    CFF_CONFIG_OPTION_DARKENING_PARAMETER_X2 < 0   || \
+    CFF_CONFIG_OPTION_DARKENING_PARAMETER_X3 < 0   || \
+    CFF_CONFIG_OPTION_DARKENING_PARAMETER_X4 < 0   || \
+                                                      \
+    CFF_CONFIG_OPTION_DARKENING_PARAMETER_Y1 < 0   || \
+    CFF_CONFIG_OPTION_DARKENING_PARAMETER_Y2 < 0   || \
+    CFF_CONFIG_OPTION_DARKENING_PARAMETER_Y3 < 0   || \
+    CFF_CONFIG_OPTION_DARKENING_PARAMETER_Y4 < 0   || \
+                                                      \
+    CFF_CONFIG_OPTION_DARKENING_PARAMETER_X1 >        \
+      CFF_CONFIG_OPTION_DARKENING_PARAMETER_X2     || \
+    CFF_CONFIG_OPTION_DARKENING_PARAMETER_X2 >        \
+      CFF_CONFIG_OPTION_DARKENING_PARAMETER_X3     || \
+    CFF_CONFIG_OPTION_DARKENING_PARAMETER_X3 >        \
+      CFF_CONFIG_OPTION_DARKENING_PARAMETER_X4     || \
+                                                      \
+    CFF_CONFIG_OPTION_DARKENING_PARAMETER_Y1 > 500 || \
+    CFF_CONFIG_OPTION_DARKENING_PARAMETER_Y2 > 500 || \
+    CFF_CONFIG_OPTION_DARKENING_PARAMETER_Y3 > 500 || \
+    CFF_CONFIG_OPTION_DARKENING_PARAMETER_Y4 > 500
+#error "Invalid CFF darkening parameters!"
+#endif
+
+FT_END_HEADER
+
+
+#endif /* FTOPTION_H_ */
+
+
+/* END */
diff --git a/subprojects/packagefiles/freetype-2.6.1-meson/meson.build b/subprojects/packagefiles/freetype-2.6.1-meson/meson.build
new file mode 100644
index 000000000000..dddfd67f6d09
--- /dev/null
+++ b/subprojects/packagefiles/freetype-2.6.1-meson/meson.build
@@ -0,0 +1,187 @@
+project('freetype2', 'c',
+  license : ['FTL', 'GPL2'],
+  version: '2.6.1')
+
+# NOTE about FreeType versions
+# There are 3 versions numbers associated with each releases:
+# - official release number (eg. 2.6.1) - accessible via
+#   FREETYPE_{MAJOR,MINOR,PATCH} macros from FT_FREETYPE_H
+# - libtool-specific version number, this is what is returned by
+#   freetype-config --version / pkg-config --modversion (eg. 22.1.16)
+# - the platform-specific shared object version number (eg. 6.16.1)
+# See https://git.savannah.gnu.org/cgit/freetype/freetype2.git/tree/docs/VERSIONS.TXT
+# for more information
+release_version = meson.project_version()
+libtool_version = '18.1.12'
+so_version = '6.12.1'
+so_soversion = '6'
+
+pkgmod = import('pkgconfig')
+
+cc = meson.get_compiler('c')
+
+base_sources = [
+  'src/autofit/autofit.c',
+  'src/base/ftbase.c',
+  'src/base/ftbbox.c',
+  'src/base/ftbdf.c',
+  'src/base/ftbitmap.c',
+  'src/base/ftcid.c',
+  'src/base/ftfntfmt.c',
+  'src/base/ftfstype.c',
+  'src/base/ftgasp.c',
+  'src/base/ftglyph.c',
+  'src/base/ftgxval.c',
+  'src/base/ftinit.c',
+  'src/base/ftlcdfil.c',
+  'src/base/ftmm.c',
+  'src/base/ftotval.c',
+  'src/base/ftpatent.c',
+  'src/base/ftpfr.c',
+  'src/base/ftstroke.c',
+  'src/base/ftsynth.c',
+  'src/base/ftsystem.c',
+  'src/base/fttype1.c',
+  'src/base/ftwinfnt.c',
+  'src/bdf/bdf.c',
+  'src/bzip2/ftbzip2.c',
+  'src/cache/ftcache.c',
+  'src/cff/cff.c',
+  'src/cid/type1cid.c',
+  'src/gzip/ftgzip.c',
+  'src/lzw/ftlzw.c',
+  'src/pcf/pcf.c',
+  'src/pfr/pfr.c',
+  'src/psaux/psaux.c',
+  'src/pshinter/pshinter.c',
+  'src/psnames/psnames.c',
+  'src/raster/raster.c',
+  'src/sfnt/sfnt.c',
+  'src/smooth/smooth.c',
+  'src/truetype/truetype.c',
+  'src/type1/type1.c',
+  'src/type42/type42.c',
+  'src/winfonts/winfnt.c',
+]
+
+ft2build_h = [
+  'include/ft2build.h',
+]
+
+ft_headers = [
+  'include/freetype/freetype.h',
+  'include/freetype/ftadvanc.h',
+  'include/freetype/ftautoh.h',
+  'include/freetype/ftbbox.h',
+  'include/freetype/ftbdf.h',
+  'include/freetype/ftbitmap.h',
+  'include/freetype/ftbzip2.h',
+  'include/freetype/ftcache.h',
+  'include/freetype/ftcffdrv.h',
+  'include/freetype/ftchapters.h',
+  'include/freetype/ftcid.h',
+  'include/freetype/fterrdef.h',
+  'include/freetype/fterrors.h',
+  'include/freetype/ftfntfmt.h',
+  'include/freetype/ftgasp.h',
+  'include/freetype/ftglyph.h',
+  'include/freetype/ftgxval.h',
+  'include/freetype/ftgzip.h',
+  'include/freetype/ftimage.h',
+  'include/freetype/ftincrem.h',
+  'include/freetype/ftlcdfil.h',
+  'include/freetype/ftlist.h',
+  'include/freetype/ftlzw.h',
+  'include/freetype/ftmac.h',
+  'include/freetype/ftmm.h',
+  'include/freetype/ftmodapi.h',
+  'include/freetype/ftmoderr.h',
+  'include/freetype/ftotval.h',
+  'include/freetype/ftoutln.h',
+  'include/freetype/ftpfr.h',
+  'include/freetype/ftrender.h',
+  'include/freetype/ftsizes.h',
+  'include/freetype/ftsnames.h',
+  'include/freetype/ftstroke.h',
+  'include/freetype/ftsynth.h',
+  'include/freetype/ftsystem.h',
+  'include/freetype/fttrigon.h',
+  'include/freetype/ftttdrv.h',
+  'include/freetype/fttypes.h',
+  'include/freetype/ftwinfnt.h',
+  'include/freetype/t1tables.h',
+  'include/freetype/ttnameid.h',
+  'include/freetype/tttables.h',
+  'include/freetype/tttags.h',
+  'include/freetype/ttunpat.h',
+]
+
+ft_config_headers = [
+  'include/freetype/config/ftconfig.h',
+  'include/freetype/config/ftheader.h',
+  'include/freetype/config/ftmodule.h',
+  'include/freetype/config/ftoption.h',
+  'include/freetype/config/ftstdlib.h',
+]
+
+if host_machine.system() == 'windows'
+  base_sources += [
+    'builds/windows/ftdebug.c',
+  ]
+else
+  base_sources += [
+    'src/base/ftdebug.c',
+  ]
+endif
+
+c_args = [
+  '-DFT2_BUILD_LIBRARY',
+  '-DFT_CONFIG_CONFIG_H=<ftconfig.h>',
+  '-DFT_CONFIG_OPTIONS_H=<ftoption.h>'
+]
+
+check_headers = []
+
+if ['linux', 'darwin', 'cygwin'].contains(host_machine.system())
+  check_headers += [
+    ['unistd.h'],
+    ['fcntl.h'],
+    ['stdint.h'],
+  ]
+  ftconfig_h_in = files('builds/unix/ftconfig.h.in')
+else
+  ftconfig_h_in = files('include/freetype/config/ftconfig.h')
+endif
+
+conf = configuration_data()
+deps = []
+incbase = include_directories(['include'])
+
+foreach check : check_headers
+  name = check[0]
+
+  if cc.has_header(name)
+    conf.set('HAVE_@0@'.format(name.to_upper().underscorify()), 1)
+  endif
+endforeach
+
+configure_file(input: ftconfig_h_in,
+  output: 'ftconfig.h',
+  configuration: conf)
+
+ft_config_headers += [configure_file(input: 'include/freetype/config/ftoption.h.in',
+  output: 'ftoption.h',
+  configuration: conf)]
+
+libfreetype = static_library('freetype', base_sources,
+  include_directories: incbase,
+  dependencies: deps,
+  c_args: c_args,
+  gnu_symbol_visibility: 'inlineshidden',
+)
+
+freetype_dep = declare_dependency(
+  link_with: libfreetype,
+  include_directories : incbase,
+  dependencies: deps,
+)
diff --git a/subprojects/packagefiles/qhull-2020.2/meson.build b/subprojects/packagefiles/qhull-2020.2/meson.build
new file mode 100644
index 000000000000..3d20c5d2ae55
--- /dev/null
+++ b/subprojects/packagefiles/qhull-2020.2/meson.build
@@ -0,0 +1,31 @@
+project('qhull', 'c',
+  version: '8.0.2',
+  license: 'Qhull')
+
+qhull_inc = include_directories('src')
+qhull_lib = static_library('qhull_r',
+  'src/libqhull_r/geom2_r.c',
+  'src/libqhull_r/geom_r.c',
+  'src/libqhull_r/global_r.c',
+  'src/libqhull_r/io_r.c',
+  'src/libqhull_r/libqhull_r.c',
+  'src/libqhull_r/mem_r.c',
+  'src/libqhull_r/merge_r.c',
+  'src/libqhull_r/poly2_r.c',
+  'src/libqhull_r/poly_r.c',
+  'src/libqhull_r/qset_r.c',
+  'src/libqhull_r/random_r.c',
+  'src/libqhull_r/rboxlib_r.c',
+  'src/libqhull_r/stat_r.c',
+  'src/libqhull_r/usermem_r.c',
+  'src/libqhull_r/userprintf_rbox_r.c',
+  'src/libqhull_r/userprintf_r.c',
+  'src/libqhull_r/user_r.c',
+  gnu_symbol_visibility: 'inlineshidden',
+)
+
+qhull_dep = declare_dependency(
+  include_directories: qhull_inc,
+  link_with: qhull_lib)
+
+meson.override_dependency('qhull_r', qhull_dep)
diff --git a/subprojects/qhull.wrap b/subprojects/qhull.wrap
new file mode 100644
index 000000000000..f43ead300834
--- /dev/null
+++ b/subprojects/qhull.wrap
@@ -0,0 +1,9 @@
+[wrap-file]
+# Also bump the cache key in `.circleci/config.yml`.
+# Also update the docs in `docs/devel/dependencies.rst`.
+directory = qhull-2020.2
+source_url = http://www.qhull.org/download/qhull-2020-src-8.0.2.tgz
+source_filename = qhull-2020-src-8.0.2.tgz
+source_hash = b5c2d7eb833278881b952c8a52d20179eab87766b00b865000469a45c1838b7e
+
+patch_directory = qhull-2020.2

From 7d85c0e1e942be5c65118a678c78605ef9533089 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 24 Aug 2023 03:28:22 -0400
Subject: [PATCH 0228/1120] BLD: Install Python files via Meson

---
 .flake8                                       |   2 -
 lib/matplotlib/_api/meson.build               |  12 +
 lib/matplotlib/axes/meson.build               |  16 +
 lib/matplotlib/backends/meson.build           |  49 ++
 lib/matplotlib/backends/qt_editor/meson.build |  11 +
 .../backends/web_backend/meson.build          |  14 +
 lib/matplotlib/meson.build                    | 154 ++++
 lib/matplotlib/projections/meson.build        |  14 +
 lib/matplotlib/sphinxext/meson.build          |  12 +
 lib/matplotlib/style/meson.build              |  11 +
 lib/matplotlib/testing/jpl_units/meson.build  |  16 +
 lib/matplotlib/testing/meson.build            |  22 +
 lib/matplotlib/tests/meson.build              | 113 +++
 lib/matplotlib/tri/meson.build                |  25 +
 lib/meson.build                               |   8 +
 lib/mpl_toolkits/axes_grid1/meson.build       |  15 +
 lib/mpl_toolkits/axes_grid1/tests/meson.build |  12 +
 lib/mpl_toolkits/axisartist/meson.build       |  18 +
 lib/mpl_toolkits/axisartist/tests/meson.build |  17 +
 lib/mpl_toolkits/meson.build                  |   3 +
 lib/mpl_toolkits/mplot3d/meson.build          |  11 +
 lib/mpl_toolkits/mplot3d/tests/meson.build    |  14 +
 meson.build                                   |   4 +-
 meson_options.txt                             |  11 +
 mplsetup.cfg.template                         |  38 -
 pyproject.toml                                |  39 +-
 setup.cfg                                     |   5 -
 setup.py                                      | 290 -------
 setupext.py                                   | 799 ------------------
 29 files changed, 592 insertions(+), 1163 deletions(-)
 create mode 100644 lib/matplotlib/_api/meson.build
 create mode 100644 lib/matplotlib/axes/meson.build
 create mode 100644 lib/matplotlib/backends/meson.build
 create mode 100644 lib/matplotlib/backends/qt_editor/meson.build
 create mode 100644 lib/matplotlib/backends/web_backend/meson.build
 create mode 100644 lib/matplotlib/meson.build
 create mode 100644 lib/matplotlib/projections/meson.build
 create mode 100644 lib/matplotlib/sphinxext/meson.build
 create mode 100644 lib/matplotlib/style/meson.build
 create mode 100644 lib/matplotlib/testing/jpl_units/meson.build
 create mode 100644 lib/matplotlib/testing/meson.build
 create mode 100644 lib/matplotlib/tests/meson.build
 create mode 100644 lib/matplotlib/tri/meson.build
 create mode 100644 lib/meson.build
 create mode 100644 lib/mpl_toolkits/axes_grid1/meson.build
 create mode 100644 lib/mpl_toolkits/axes_grid1/tests/meson.build
 create mode 100644 lib/mpl_toolkits/axisartist/meson.build
 create mode 100644 lib/mpl_toolkits/axisartist/tests/meson.build
 create mode 100644 lib/mpl_toolkits/meson.build
 create mode 100644 lib/mpl_toolkits/mplot3d/meson.build
 create mode 100644 lib/mpl_toolkits/mplot3d/tests/meson.build
 delete mode 100644 mplsetup.cfg.template
 delete mode 100644 setup.cfg
 delete mode 100644 setup.py
 delete mode 100644 setupext.py

diff --git a/.flake8 b/.flake8
index ee739cdf4231..00cd213e0f79 100644
--- a/.flake8
+++ b/.flake8
@@ -31,8 +31,6 @@ exclude =
     .eggs
 
 per-file-ignores =
-    setup.py: E402
-
     lib/matplotlib/__init__.py: E402, F401
     lib/matplotlib/_animation_data.py: E501
     lib/matplotlib/_api/__init__.py: F401
diff --git a/lib/matplotlib/_api/meson.build b/lib/matplotlib/_api/meson.build
new file mode 100644
index 000000000000..57aa234ab878
--- /dev/null
+++ b/lib/matplotlib/_api/meson.build
@@ -0,0 +1,12 @@
+python_sources = [
+  '__init__.py',
+  'deprecation.py',
+]
+
+typing_sources = [
+  '__init__.pyi',
+  'deprecation.pyi',
+]
+
+py3.install_sources(python_sources, typing_sources,
+                    subdir: 'matplotlib/_api')
diff --git a/lib/matplotlib/axes/meson.build b/lib/matplotlib/axes/meson.build
new file mode 100644
index 000000000000..8de3c9c382d7
--- /dev/null
+++ b/lib/matplotlib/axes/meson.build
@@ -0,0 +1,16 @@
+python_sources = [
+  '__init__.py',
+  '_axes.py',
+  '_base.py',
+  '_secondary_axes.py',
+]
+
+typing_sources = [
+  '__init__.pyi',
+  '_axes.pyi',
+  '_base.pyi',
+  '_secondary_axes.pyi',
+]
+
+py3.install_sources(python_sources, typing_sources,
+                    subdir: 'matplotlib/axes')
diff --git a/lib/matplotlib/backends/meson.build b/lib/matplotlib/backends/meson.build
new file mode 100644
index 000000000000..050cc616b42c
--- /dev/null
+++ b/lib/matplotlib/backends/meson.build
@@ -0,0 +1,49 @@
+python_sources = [
+  '__init__.py',
+  'backend_agg.py',
+  'backend_cairo.py',
+  '_backend_gtk.py',
+  'backend_gtk3.py',
+  'backend_gtk3agg.py',
+  'backend_gtk3cairo.py',
+  'backend_gtk4.py',
+  'backend_gtk4agg.py',
+  'backend_gtk4cairo.py',
+  'backend_macosx.py',
+  'backend_mixed.py',
+  'backend_nbagg.py',
+  '_backend_pdf_ps.py',
+  'backend_pdf.py',
+  'backend_pgf.py',
+  'backend_ps.py',
+  'backend_qt.py',
+  'backend_qtagg.py',
+  'backend_qtcairo.py',
+  'backend_qt5.py',
+  'backend_qt5agg.py',
+  'backend_qt5cairo.py',
+  'backend_svg.py',
+  'backend_template.py',
+  '_backend_tk.py',
+  'backend_tkagg.py',
+  'backend_tkcairo.py',
+  'backend_webagg.py',
+  'backend_webagg_core.py',
+  'backend_wx.py',
+  'backend_wxagg.py',
+  'backend_wxcairo.py',
+  'qt_compat.py',
+]
+
+typing_sources = [
+  # Compiled extension types.
+  '_backend_agg.pyi',
+  '_macosx.pyi',
+  '_tkagg.pyi',
+]
+
+py3.install_sources(python_sources, typing_sources,
+                    subdir: 'matplotlib/backends')
+
+subdir('qt_editor')
+subdir('web_backend')
diff --git a/lib/matplotlib/backends/qt_editor/meson.build b/lib/matplotlib/backends/qt_editor/meson.build
new file mode 100644
index 000000000000..1f4ea9cd4691
--- /dev/null
+++ b/lib/matplotlib/backends/qt_editor/meson.build
@@ -0,0 +1,11 @@
+python_sources = [
+  '__init__.py',
+  '_formlayout.py',
+  'figureoptions.py',
+]
+
+typing_sources = [
+]
+
+py3.install_sources(python_sources, typing_sources,
+                    subdir: 'matplotlib/backends/qt_editor')
diff --git a/lib/matplotlib/backends/web_backend/meson.build b/lib/matplotlib/backends/web_backend/meson.build
new file mode 100644
index 000000000000..f8025d1742d3
--- /dev/null
+++ b/lib/matplotlib/backends/web_backend/meson.build
@@ -0,0 +1,14 @@
+install_dir = py3.get_install_dir(subdir: 'matplotlib/backends/web_backend')
+
+install_data(
+  'all_figures.html',
+  'ipython_inline_figure.html',
+  'single_figure.html',
+  install_tag: 'data',
+  install_dir: install_dir)
+install_subdir('css', install_tag: 'data', install_dir: install_dir)
+install_subdir('js', install_tag: 'data', install_dir: install_dir)
+install_data(
+  'nbagg_uat.ipynb',
+  install_tag: 'tests',
+  install_dir: install_dir)
diff --git a/lib/matplotlib/meson.build b/lib/matplotlib/meson.build
new file mode 100644
index 000000000000..4f8d93d1f01d
--- /dev/null
+++ b/lib/matplotlib/meson.build
@@ -0,0 +1,154 @@
+python_sources = [
+  '__init__.py',
+  '_afm.py',
+  '_animation_data.py',
+  '_blocking_input.py',
+  '_cm.py',
+  '_cm_listed.py',
+  '_color_data.py',
+  '_constrained_layout.py',
+  '_docstring.py',
+  '_enums.py',
+  '_fontconfig_pattern.py',
+  '_internal_utils.py',
+  '_layoutgrid.py',
+  '_mathtext.py',
+  '_mathtext_data.py',
+  '_pylab_helpers.py',
+  '_text_helpers.py',
+  '_tight_bbox.py',
+  '_tight_layout.py',
+  '_type1font.py',
+  'animation.py',
+  'artist.py',
+  'axis.py',
+  'backend_bases.py',
+  'backend_managers.py',
+  'backend_tools.py',
+  'bezier.py',
+  'category.py',
+  'cbook.py',
+  'cm.py',
+  'collections.py',
+  'colorbar.py',
+  'colors.py',
+  'container.py',
+  'contour.py',
+  'dates.py',
+  'dviread.py',
+  'figure.py',
+  'font_manager.py',
+  'gridspec.py',
+  'hatch.py',
+  'image.py',
+  'layout_engine.py',
+  'legend_handler.py',
+  'legend.py',
+  'lines.py',
+  'markers.py',
+  'mathtext.py',
+  'mlab.py',
+  'offsetbox.py',
+  'patches.py',
+  'patheffects.py',
+  'path.py',
+  'pylab.py',
+  'pyplot.py',
+  'quiver.py',
+  'rcsetup.py',
+  'sankey.py',
+  'scale.py',
+  'spines.py',
+  'stackplot.py',
+  'streamplot.py',
+  'table.py',
+  'texmanager.py',
+  'textpath.py',
+  'text.py',
+  'ticker.py',
+  'transforms.py',
+  'typing.py',
+  'units.py',
+  'widgets.py',
+]
+
+typing_sources = [
+  'py.typed',
+  # Compiled extension types.
+  '_c_internal_utils.pyi',
+  'ft2font.pyi',
+  '_image.pyi',
+  '_qhull.pyi',
+  '_tri.pyi',
+  # Pure Python types.
+  '__init__.pyi',
+  '_color_data.pyi',
+  '_docstring.pyi',
+  '_enums.pyi',
+  '_path.pyi',
+  '_pylab_helpers.pyi',
+  '_ttconv.pyi',
+  'animation.pyi',
+  'artist.pyi',
+  'axis.pyi',
+  'backend_bases.pyi',
+  'backend_managers.pyi',
+  'backend_tools.pyi',
+  'bezier.pyi',
+  'cbook.pyi',
+  'cm.pyi',
+  'collections.pyi',
+  'colorbar.pyi',
+  'colors.pyi',
+  'container.pyi',
+  'contour.pyi',
+  'dviread.pyi',
+  'figure.pyi',
+  'font_manager.pyi',
+  'gridspec.pyi',
+  'hatch.pyi',
+  'image.pyi',
+  'layout_engine.pyi',
+  'legend_handler.pyi',
+  'legend.pyi',
+  'lines.pyi',
+  'markers.pyi',
+  'mathtext.pyi',
+  'mlab.pyi',
+  'offsetbox.pyi',
+  'patches.pyi',
+  'patheffects.pyi',
+  'path.pyi',
+  'quiver.pyi',
+  'rcsetup.pyi',
+  'sankey.pyi',
+  'scale.pyi',
+  'spines.pyi',
+  'stackplot.pyi',
+  'streamplot.pyi',
+  'table.pyi',
+  'texmanager.pyi',
+  'textpath.pyi',
+  'text.pyi',
+  'ticker.pyi',
+  'transforms.pyi',
+  'widgets.pyi',
+]
+
+py3.install_sources(python_sources, typing_sources,
+                    subdir: 'matplotlib')
+
+subdir('_api')
+subdir('axes')
+subdir('backends')
+subdir('projections')
+subdir('sphinxext')
+subdir('style')
+subdir('testing')
+subdir('tests')
+subdir('tri')
+
+install_subdir(
+  'mpl-data',
+  install_tag: 'data',
+  install_dir: py3.get_install_dir(subdir: 'matplotlib'))
diff --git a/lib/matplotlib/projections/meson.build b/lib/matplotlib/projections/meson.build
new file mode 100644
index 000000000000..221b93efadee
--- /dev/null
+++ b/lib/matplotlib/projections/meson.build
@@ -0,0 +1,14 @@
+python_sources = [
+  '__init__.py',
+  'geo.py',
+  'polar.py',
+]
+
+typing_sources = [
+  '__init__.pyi',
+  'geo.pyi',
+  'polar.pyi',
+]
+
+py3.install_sources(python_sources, typing_sources,
+                    subdir: 'matplotlib/projections')
diff --git a/lib/matplotlib/sphinxext/meson.build b/lib/matplotlib/sphinxext/meson.build
new file mode 100644
index 000000000000..5dc7388384eb
--- /dev/null
+++ b/lib/matplotlib/sphinxext/meson.build
@@ -0,0 +1,12 @@
+python_sources = [
+  '__init__.py',
+  'figmpl_directive.py',
+  'mathmpl.py',
+  'plot_directive.py',
+]
+
+typing_sources = [
+]
+
+py3.install_sources(python_sources, typing_sources,
+                    subdir: 'matplotlib/sphinxext')
diff --git a/lib/matplotlib/style/meson.build b/lib/matplotlib/style/meson.build
new file mode 100644
index 000000000000..03e7972132bb
--- /dev/null
+++ b/lib/matplotlib/style/meson.build
@@ -0,0 +1,11 @@
+python_sources = [
+  '__init__.py',
+  'core.py',
+]
+
+typing_sources = [
+  'core.pyi',
+]
+
+py3.install_sources(python_sources, typing_sources,
+                    subdir: 'matplotlib/style')
diff --git a/lib/matplotlib/testing/jpl_units/meson.build b/lib/matplotlib/testing/jpl_units/meson.build
new file mode 100644
index 000000000000..c950f0bfa4dd
--- /dev/null
+++ b/lib/matplotlib/testing/jpl_units/meson.build
@@ -0,0 +1,16 @@
+python_sources = [
+  '__init__.py',
+  'Duration.py',
+  'EpochConverter.py',
+  'Epoch.py',
+  'StrConverter.py',
+  'UnitDblConverter.py',
+  'UnitDblFormatter.py',
+  'UnitDbl.py',
+]
+
+typing_sources = [
+]
+
+py3.install_sources(python_sources, typing_sources,
+                    subdir: 'matplotlib/testing/jpl_units')
diff --git a/lib/matplotlib/testing/meson.build b/lib/matplotlib/testing/meson.build
new file mode 100644
index 000000000000..1016f81941ca
--- /dev/null
+++ b/lib/matplotlib/testing/meson.build
@@ -0,0 +1,22 @@
+python_sources = [
+  '__init__.py',
+  '_markers.py',
+  'compare.py',
+  'conftest.py',
+  'decorators.py',
+  'exceptions.py',
+  'widgets.py',
+]
+
+typing_sources = [
+  '__init__.pyi',
+  'compare.pyi',
+  'conftest.pyi',
+  'decorators.pyi',
+  'widgets.pyi',
+]
+
+py3.install_sources(python_sources, typing_sources,
+                    subdir: 'matplotlib/testing')
+
+subdir('jpl_units')
diff --git a/lib/matplotlib/tests/meson.build b/lib/matplotlib/tests/meson.build
new file mode 100644
index 000000000000..148a40f11a2f
--- /dev/null
+++ b/lib/matplotlib/tests/meson.build
@@ -0,0 +1,113 @@
+python_sources = [
+  '__init__.py',
+  'conftest.py',
+  'test_afm.py',
+  'test_agg_filter.py',
+  'test_agg.py',
+  'test_animation.py',
+  'test_api.py',
+  'test_arrow_patches.py',
+  'test_artist.py',
+  'test_axes.py',
+  'test_axis.py',
+  'test_backend_bases.py',
+  'test_backend_cairo.py',
+  'test_backend_gtk3.py',
+  'test_backend_macosx.py',
+  'test_backend_nbagg.py',
+  'test_backend_pdf.py',
+  'test_backend_pgf.py',
+  'test_backend_ps.py',
+  'test_backend_qt.py',
+  'test_backends_interactive.py',
+  'test_backend_svg.py',
+  'test_backend_template.py',
+  'test_backend_tk.py',
+  'test_backend_tools.py',
+  'test_backend_webagg.py',
+  'test_basic.py',
+  'test_bbox_tight.py',
+  'test_category.py',
+  'test_cbook.py',
+  'test_collections.py',
+  'test_colorbar.py',
+  'test_colors.py',
+  'test_compare_images.py',
+  'test_constrainedlayout.py',
+  'test_container.py',
+  'test_contour.py',
+  'test_cycles.py',
+  'test_dates.py',
+  'test_datetime.py',
+  'test_determinism.py',
+  'test_doc.py',
+  'test_dviread.py',
+  'test_figure.py',
+  'test_fontconfig_pattern.py',
+  'test_font_manager.py',
+  'test_ft2font.py',
+  'test_getattr.py',
+  'test_gridspec.py',
+  'test_image.py',
+  'test_legend.py',
+  'test_lines.py',
+  'test_marker.py',
+  'test_mathtext.py',
+  'test_matplotlib.py',
+  'test_mlab.py',
+  'test_offsetbox.py',
+  'test_patches.py',
+  'test_patheffects.py',
+  'test_path.py',
+  'test_pickle.py',
+  'test_png.py',
+  'test_polar.py',
+  'test_preprocess_data.py',
+  'test_pyplot.py',
+  'test_quiver.py',
+  'test_rcparams.py',
+  'test_sankey.py',
+  'test_scale.py',
+  'test_simplification.py',
+  'test_skew.py',
+  'test_sphinxext.py',
+  'test_spines.py',
+  'test_streamplot.py',
+  'test_style.py',
+  'test_subplots.py',
+  'test_table.py',
+  'test_testing.py',
+  'test_texmanager.py',
+  'test_textpath.py',
+  'test_text.py',
+  'test_ticker.py',
+  'test_tightlayout.py',
+  'test_transforms.py',
+  'test_triangulation.py',
+  'test_ttconv.py',
+  'test_type1font.py',
+  'test_units.py',
+  'test_usetex.py',
+  'test_widgets.py',
+]
+
+py3.install_sources(python_sources,
+                    subdir: 'matplotlib/tests')
+
+install_data(
+  'README',
+  'Courier10PitchBT-Bold.pfb',
+  'cmr10.pfb',
+  'mpltest.ttf',
+  'test_nbagg_01.ipynb',
+  install_tag: 'tests',
+  install_dir: py3.get_install_dir(subdir: 'matplotlib/tests/'))
+
+install_subdir(
+  'baseline_images',
+  install_tag: 'tests',
+  install_dir: py3.get_install_dir(subdir: 'matplotlib/tests'))
+install_subdir(
+  'tinypages',
+  install_tag: 'tests',
+  install_dir: py3.get_install_dir(subdir: 'matplotlib/tests'))
diff --git a/lib/matplotlib/tri/meson.build b/lib/matplotlib/tri/meson.build
new file mode 100644
index 000000000000..9e71f3348c69
--- /dev/null
+++ b/lib/matplotlib/tri/meson.build
@@ -0,0 +1,25 @@
+python_sources = [
+  '__init__.py',
+  '_triangulation.py',
+  '_tricontour.py',
+  '_trifinder.py',
+  '_triinterpolate.py',
+  '_tripcolor.py',
+  '_triplot.py',
+  '_trirefine.py',
+  '_tritools.py',
+]
+
+typing_sources = [
+  '_triangulation.pyi',
+  '_tricontour.pyi',
+  '_trifinder.pyi',
+  '_triinterpolate.pyi',
+  '_tripcolor.pyi',
+  '_triplot.pyi',
+  '_trirefine.pyi',
+  '_tritools.pyi',
+]
+
+py3.install_sources(python_sources, typing_sources,
+                    subdir: 'matplotlib/tri')
diff --git a/lib/meson.build b/lib/meson.build
new file mode 100644
index 000000000000..9701a7da98dd
--- /dev/null
+++ b/lib/meson.build
@@ -0,0 +1,8 @@
+python_sources = [
+  'pylab.py',
+]
+
+py3.install_sources(python_sources)
+
+subdir('matplotlib')
+subdir('mpl_toolkits')
diff --git a/lib/mpl_toolkits/axes_grid1/meson.build b/lib/mpl_toolkits/axes_grid1/meson.build
new file mode 100644
index 000000000000..7dd5c3861163
--- /dev/null
+++ b/lib/mpl_toolkits/axes_grid1/meson.build
@@ -0,0 +1,15 @@
+python_sources = [
+  '__init__.py',
+  'anchored_artists.py',
+  'axes_divider.py',
+  'axes_grid.py',
+  'axes_rgb.py',
+  'axes_size.py',
+  'inset_locator.py',
+  'mpl_axes.py',
+  'parasite_axes.py',
+]
+
+py3.install_sources(python_sources, subdir: 'mpl_toolkits/axes_grid1')
+
+subdir('tests')
diff --git a/lib/mpl_toolkits/axes_grid1/tests/meson.build b/lib/mpl_toolkits/axes_grid1/tests/meson.build
new file mode 100644
index 000000000000..980bf173cc10
--- /dev/null
+++ b/lib/mpl_toolkits/axes_grid1/tests/meson.build
@@ -0,0 +1,12 @@
+python_sources = [
+  '__init__.py',
+  'conftest.py',
+  'test_axes_grid1.py',
+]
+
+py3.install_sources(python_sources, subdir: 'mpl_toolkits/axes_grid1/tests')
+
+install_subdir(
+  'baseline_images',
+  install_tag: 'tests',
+  install_dir: py3.get_install_dir(subdir: 'mpl_toolkits/axes_grid1/tests'))
diff --git a/lib/mpl_toolkits/axisartist/meson.build b/lib/mpl_toolkits/axisartist/meson.build
new file mode 100644
index 000000000000..8d9314e42576
--- /dev/null
+++ b/lib/mpl_toolkits/axisartist/meson.build
@@ -0,0 +1,18 @@
+python_sources = [
+  '__init__.py',
+  'angle_helper.py',
+  'axes_divider.py',
+  'axes_grid.py',
+  'axes_rgb.py',
+  'axis_artist.py',
+  'axislines.py',
+  'axisline_style.py',
+  'floating_axes.py',
+  'grid_finder.py',
+  'grid_helper_curvelinear.py',
+  'parasite_axes.py',
+]
+
+py3.install_sources(python_sources, subdir: 'mpl_toolkits/axisartist')
+
+subdir('tests')
diff --git a/lib/mpl_toolkits/axisartist/tests/meson.build b/lib/mpl_toolkits/axisartist/tests/meson.build
new file mode 100644
index 000000000000..634c8190a037
--- /dev/null
+++ b/lib/mpl_toolkits/axisartist/tests/meson.build
@@ -0,0 +1,17 @@
+python_sources = [
+  '__init__.py',
+  'conftest.py',
+  'test_angle_helper.py',
+  'test_axis_artist.py',
+  'test_axislines.py',
+  'test_floating_axes.py',
+  'test_grid_finder.py',
+  'test_grid_helper_curvelinear.py',
+]
+
+py3.install_sources(python_sources, subdir: 'mpl_toolkits/axisartist/tests')
+
+install_subdir(
+  'baseline_images',
+  install_tag: 'tests',
+  install_dir: py3.get_install_dir(subdir: 'mpl_toolkits/axisartist/tests'))
diff --git a/lib/mpl_toolkits/meson.build b/lib/mpl_toolkits/meson.build
new file mode 100644
index 000000000000..290cd6139f94
--- /dev/null
+++ b/lib/mpl_toolkits/meson.build
@@ -0,0 +1,3 @@
+subdir('axes_grid1')
+subdir('axisartist')
+subdir('mplot3d')
diff --git a/lib/mpl_toolkits/mplot3d/meson.build b/lib/mpl_toolkits/mplot3d/meson.build
new file mode 100644
index 000000000000..2d9cade6c93c
--- /dev/null
+++ b/lib/mpl_toolkits/mplot3d/meson.build
@@ -0,0 +1,11 @@
+python_sources = [
+  '__init__.py',
+  'art3d.py',
+  'axes3d.py',
+  'axis3d.py',
+  'proj3d.py',
+]
+
+py3.install_sources(python_sources, subdir: 'mpl_toolkits/mplot3d')
+
+subdir('tests')
diff --git a/lib/mpl_toolkits/mplot3d/tests/meson.build b/lib/mpl_toolkits/mplot3d/tests/meson.build
new file mode 100644
index 000000000000..7a638aedf72b
--- /dev/null
+++ b/lib/mpl_toolkits/mplot3d/tests/meson.build
@@ -0,0 +1,14 @@
+python_sources = [
+  '__init__.py',
+  'conftest.py',
+  'test_art3d.py',
+  'test_axes3d.py',
+  'test_legend3d.py',
+]
+
+py3.install_sources(python_sources, subdir: 'mpl_toolkits/mplot3d/tests')
+
+install_subdir(
+  'baseline_images',
+  install_tag: 'tests',
+  install_dir: py3.get_install_dir(subdir: 'mpl_toolkits/mplot3d/tests'))
diff --git a/meson.build b/meson.build
index c294eea2a678..1ba673948a1e 100644
--- a/meson.build
+++ b/meson.build
@@ -7,6 +7,7 @@ project(
   # Carlogo, STIX and Computer Modern is OFL
   # DejaVu is Bitstream Vera and Public Domain
   license: 'PSF-2.0 AND MIT AND CC0-1.0 AND OFL-1.1 AND Bitstream-Vera AND Public-Domain',
+  meson_version: '>=1.1.0',
   default_options: [
     'b_lto=true',
     'cpp_std=c++11',
@@ -19,10 +20,11 @@ cpp = meson.get_compiler('cpp')
 
 # https://mesonbuild.com/Python-module.html
 py_mod = import('python')
-py3 = py_mod.find_installation()
+py3 = py_mod.find_installation(pure: false)
 py3_dep = py3.dependency()
 
 pybind11_dep = dependency('pybind11', version: '>=2.6')
 
 subdir('extern')
 subdir('src')
+subdir('lib')
diff --git a/meson_options.txt b/meson_options.txt
index 0b10c331ae48..ed753bb26854 100644
--- a/meson_options.txt
+++ b/meson_options.txt
@@ -15,3 +15,14 @@ option('system-qhull', type: 'boolean', value: false,
 # of the config value.
 option('macosx', type: 'boolean', value: true,
        description: 'Enable MacOSX backend (requires Cocoa)')
+
+# User-configurable options
+#
+# Default backend, one of: Agg, Cairo, GTK3Agg, GTK3Cairo, GTK4Agg, GTK4Cairo,
+# MacOSX, Pdf, Ps, QtAgg, QtCairo, SVG, TkAgg, WX, WXAgg.
+#
+# The Agg, Ps, Pdf and SVG backends do not require external dependencies.  Do
+# not choose MacOSX if you have disabled the relevant extension modules.  The
+# default is determined by fallback.
+option('rcParams-backend', type: 'string', value: 'auto',
+       description: 'Set default backend at runtime')
diff --git a/mplsetup.cfg.template b/mplsetup.cfg.template
deleted file mode 100644
index 30985b2e313d..000000000000
--- a/mplsetup.cfg.template
+++ /dev/null
@@ -1,38 +0,0 @@
-# Rename this file to mplsetup.cfg to modify Matplotlib's build options.
-
-[libs]
-# By default, Matplotlib builds with LTO, which may be slow if you re-compile
-# often, and don't need the space saving/speedup.
-#
-#enable_lto = True
-#
-# By default, Matplotlib downloads and builds its own copies of FreeType and of
-# Qhull.  You may set the following to True to instead link against a system
-# FreeType/Qhull.  As an exception, Matplotlib defaults to the system version
-# of FreeType on AIX.
-#
-#system_freetype = False
-#system_qhull = False
-
-[packages]
-# Some of Matplotlib's components are optional: the MacOSX backend (installed
-# by default on MacOSX; requires the Cocoa headers included with XCode), and
-# the test data (i.e., the baseline image files; not installed by default).
-# You can control whether they are installed by uncommenting the following
-# lines.  Note that the MacOSX backend is never built on Linux or Windows,
-# regardless of the config value.
-#
-#tests = False
-#macosx = True
-
-[rc_options]
-# User-configurable options
-#
-# Default backend, one of: Agg, Cairo, GTK3Agg, GTK3Cairo, GTK4Agg, GTK4Cairo,
-# MacOSX, Pdf, Ps, QtAgg, QtCairo, SVG, TkAgg, WX, WXAgg.
-#
-# The Agg, Ps, Pdf and SVG backends do not require external dependencies.  Do
-# not choose MacOSX if you have disabled the relevant extension modules.  The
-# default is determined by fallback.
-#
-#backend = Agg
diff --git a/pyproject.toml b/pyproject.toml
index 423d6352ae8f..37d97e02b956 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -40,8 +40,6 @@ dependencies = [
     "pillow >= 8",
     "pyparsing >= 2.3.1",
     "python-dateutil >= 2.7",
-    "setuptools >= 64",
-    "setuptools_scm >= 7",
     "importlib-resources >= 3.2.0; python_version < '3.10'",
 ]
 requires-python = ">=3.9"
@@ -49,11 +47,16 @@ requires-python = ">=3.9"
 [project.optional-dependencies]
 # Should be a copy of the build dependencies below.
 dev = [
-    "certifi>=2020.06.20",
+    "meson-python>=0.13.1",
     "numpy>=1.25",
     "pybind11>=2.6",
-    "setuptools>=64",
     "setuptools_scm>=7",
+    # Not required by us but setuptools_scm without a version, cso _if_
+    # installed, then setuptools_scm 8 requires at least this version.
+    # Unfortunately, we can't do a sort of minimum-if-instaled dependency, so
+    # we need to keep this for now until setuptools_scm _fully_ drops
+    # setuptools.
+    "setuptools>=64",
 ]
 
 [project.urls]
@@ -66,35 +69,17 @@ dev = [
 "Donate" = "https://numfocus.org/donate-to-matplotlib"
 
 [build-system]
-build-backend = "setuptools.build_meta"
+build-backend = "mesonpy"
 # Also keep in sync with optional dependencies above.
 requires = [
-    "certifi>=2020.06.20",
+    "meson-python>=0.13.1",
     "numpy>=1.25",
     "pybind11>=2.6",
-    "setuptools>=64",
     "setuptools_scm>=7",
 ]
 
-[tool.setuptools]
-platforms = ["any"]
-py-modules = ["pylab"]
-license-files = ["LICENSE/*"]
-namespace-packages = ["mpl_toolkits"]
-
-[tool.setuptools.packages.find]
-where = ["lib"]
-include = ["matplotlib*", "mpl_toolkits*"]
-exclude = [
-    "matplotlib.tests*",
-    "mpl_toolkits.axes_grid1.tests*",
-    "mpl_toolkits.axisartist.tests*",
-    "mpl_toolkits.mplot3d.tests*",
-]
-namespaces = true
-
-[tool.setuptools.exclude-package-data]
-"*" = ["*.png", "*.svg"]
+[tool.meson-python.args]
+install = ['--tags=data,python-runtime,runtime']
 
 [tool.setuptools_scm]
 version_scheme = "release-branch-semver"
@@ -171,8 +156,6 @@ target-version = "py39"
 convention = "numpy"
 
 [tool.ruff.per-file-ignores]
-"setup.py" = ["E402"]
-
 "doc/conf.py" = ["E402"]
 "galleries/examples/animation/frame_grabbing_sgskip.py" = ["E402"]
 "galleries/examples/lines_bars_and_markers/marker_reference.py" = ["E402"]
diff --git a/setup.cfg b/setup.cfg
deleted file mode 100644
index 9d4cf0e7b72c..000000000000
--- a/setup.cfg
+++ /dev/null
@@ -1,5 +0,0 @@
-# NOTE: Matplotlib-specific configuration options have been moved to
-# mplsetup.cfg.template.
-
-[metadata]
-license_files = LICENSE/*
diff --git a/setup.py b/setup.py
deleted file mode 100644
index 66698a3aed6c..000000000000
--- a/setup.py
+++ /dev/null
@@ -1,290 +0,0 @@
-"""
-The Matplotlib build options can be modified with a mplsetup.cfg file. See
-mplsetup.cfg.template for more information.
-"""
-
-# NOTE: This file must remain Python 2 compatible for the foreseeable future,
-# to ensure that we error out properly for people with outdated setuptools
-# and/or pip.
-import sys
-
-py_min_version = (3, 9)  # minimal supported python version
-since_mpl_version = (3, 8)  # py_min_version is required since this mpl version
-
-if sys.version_info < py_min_version:
-    error = """
-Beginning with Matplotlib {0}, Python {1} or above is required.
-You are using Python {2}.
-
-This may be due to an out of date pip.
-
-Make sure you have pip >= 9.0.1.
-""".format('.'.join(str(n) for n in since_mpl_version),
-           '.'.join(str(n) for n in py_min_version),
-           '.'.join(str(n) for n in sys.version_info[:3]))
-    sys.exit(error)
-
-import os
-from pathlib import Path
-import shutil
-import subprocess
-
-from setuptools import setup, Distribution, Extension
-import setuptools.command.build_ext
-import setuptools.command.build_py
-import setuptools.command.sdist
-
-# sys.path modified to find setupext.py during pyproject.toml builds.
-sys.path.append(str(Path(__file__).resolve().parent))
-
-import setupext
-from setupext import print_raw, print_status
-
-
-# These are the packages in the order we want to display them.
-mpl_packages = [
-    setupext.Matplotlib(),
-    setupext.Python(),
-    setupext.Platform(),
-    setupext.FreeType(),
-    setupext.Qhull(),
-    setupext.Tests(),
-    setupext.BackendMacOSX(),
-    ]
-
-
-# From https://bugs.python.org/issue26689
-def has_flag(self, flagname):
-    """Return whether a flag name is supported on the specified compiler."""
-    import tempfile
-    with tempfile.NamedTemporaryFile('w', suffix='.cpp') as f:
-        f.write('int main (int argc, char **argv) { return 0; }')
-        try:
-            self.compile([f.name], extra_postargs=[flagname])
-        except Exception as exc:
-            # https://github.com/pypa/setuptools/issues/2698
-            if type(exc).__name__ != "CompileError":
-                raise
-            return False
-    return True
-
-
-class BuildExtraLibraries(setuptools.command.build_ext.build_ext):
-    def finalize_options(self):
-        # If coverage is enabled then need to keep the .o and .gcno files in a
-        # non-temporary directory otherwise coverage info not collected.
-        cppflags = os.getenv('CPPFLAGS')
-        if cppflags and '--coverage' in cppflags:
-            self.build_temp = 'build'
-
-        self.distribution.ext_modules[:] = [
-            ext
-            for package in good_packages
-            for ext in package.get_extensions()
-        ]
-        super().finalize_options()
-
-    def add_optimization_flags(self):
-        """
-        Add optional optimization flags to extension.
-
-        This adds flags for LTO and hidden visibility to both compiled
-        extensions, and to the environment variables so that vendored libraries
-        will also use them. If the compiler does not support these flags, then
-        none are added.
-        """
-
-        env = os.environ.copy()
-        if sys.platform == 'win32':
-            return env
-        enable_lto = setupext.config.getboolean('libs', 'enable_lto',
-                                                fallback=None)
-
-        def prepare_flags(name, enable_lto):
-            """
-            Prepare *FLAGS from the environment.
-
-            If set, return them, and also check whether LTO is disabled in each
-            one, raising an error if Matplotlib config explicitly enabled LTO.
-            """
-            if name in os.environ:
-                if '-fno-lto' in os.environ[name]:
-                    if enable_lto is True:
-                        raise ValueError('Configuration enable_lto=True, but '
-                                         '{0} contains -fno-lto'.format(name))
-                    enable_lto = False
-                return [os.environ[name]], enable_lto
-            return [], enable_lto
-
-        _, enable_lto = prepare_flags('CFLAGS', enable_lto)  # Only check lto.
-        cppflags, enable_lto = prepare_flags('CPPFLAGS', enable_lto)
-        cxxflags, enable_lto = prepare_flags('CXXFLAGS', enable_lto)
-        ldflags, enable_lto = prepare_flags('LDFLAGS', enable_lto)
-
-        if enable_lto is False:
-            return env
-
-        if has_flag(self.compiler, '-fvisibility=hidden'):
-            for ext in self.extensions:
-                ext.extra_compile_args.append('-fvisibility=hidden')
-            cppflags.append('-fvisibility=hidden')
-        if has_flag(self.compiler, '-fvisibility-inlines-hidden'):
-            for ext in self.extensions:
-                if self.compiler.detect_language(ext.sources) != 'cpp':
-                    continue
-                ext.extra_compile_args.append('-fvisibility-inlines-hidden')
-            cxxflags.append('-fvisibility-inlines-hidden')
-        ranlib = 'RANLIB' in env
-        if not ranlib and self.compiler.compiler_type == 'unix':
-            try:
-                result = subprocess.run(self.compiler.compiler +
-                                        ['--version'],
-                                        stdout=subprocess.PIPE,
-                                        stderr=subprocess.STDOUT,
-                                        universal_newlines=True)
-            except Exception:
-                pass
-            else:
-                version = result.stdout.lower()
-                if 'gcc' in version:
-                    ranlib = shutil.which('gcc-ranlib')
-                elif 'clang' in version:
-                    if sys.platform == 'darwin':
-                        ranlib = True
-                    else:
-                        ranlib = shutil.which('llvm-ranlib')
-        if ranlib and has_flag(self.compiler, '-flto'):
-            for ext in self.extensions:
-                ext.extra_compile_args.append('-flto')
-            cppflags.append('-flto')
-            ldflags.append('-flto')
-            # Needed so FreeType static library doesn't lose its LTO objects.
-            if isinstance(ranlib, str):
-                env['RANLIB'] = ranlib
-
-        env['CPPFLAGS'] = ' '.join(cppflags)
-        env['CXXFLAGS'] = ' '.join(cxxflags)
-        env['LDFLAGS'] = ' '.join(ldflags)
-
-        return env
-
-    def build_extensions(self):
-        if (self.compiler.compiler_type == 'msvc' and
-                os.environ.get('MPL_DISABLE_FH4')):
-            # Disable FH4 Exception Handling implementation so that we don't
-            # require VCRUNTIME140_1.dll. For more details, see:
-            # https://devblogs.microsoft.com/cppblog/making-cpp-exception-handling-smaller-x64/
-            # https://github.com/joerick/cibuildwheel/issues/423#issuecomment-677763904
-            for ext in self.extensions:
-                ext.extra_compile_args.append('/d2FH4-')
-
-        env = self.add_optimization_flags()
-        for package in good_packages:
-            package.do_custom_build(env)
-        # Make sure we don't accidentally use too modern C++ constructs, even
-        # though modern compilers default to enabling them.  Enabling this for
-        # a single platform is enough; also only do this for C++-only
-        # extensions as clang refuses to compile C/ObjC with -std=c++11.
-        if sys.platform != "win32":
-            for ext in self.distribution.ext_modules[:]:
-                if not any(src.endswith((".c", ".m")) for src in ext.sources):
-                    ext.extra_compile_args.append("-std=c++11")
-        return super().build_extensions()
-
-    def build_extension(self, ext):
-        # When C coverage is enabled, the path to the object file is saved.
-        # Since we re-use source files in multiple extensions, libgcov will
-        # complain at runtime that it is trying to save coverage for the same
-        # object file at different timestamps (since each source is compiled
-        # again for each extension). Thus, we need to use unique temporary
-        # build directories to store object files for each extension.
-        orig_build_temp = self.build_temp
-        self.build_temp = os.path.join(self.build_temp, ext.name)
-        try:
-            super().build_extension(ext)
-        finally:
-            self.build_temp = orig_build_temp
-
-
-def update_matplotlibrc(path):
-    # If packagers want to change the default backend, insert a `#backend: ...`
-    # line.  Otherwise, use the default `##backend: Agg` which has no effect
-    # even after decommenting, which allows _auto_backend_sentinel to be filled
-    # in at import time.
-    template_lines = path.read_text(encoding="utf-8").splitlines(True)
-    backend_line_idx, = [  # Also asserts that there is a single such line.
-        idx for idx, line in enumerate(template_lines)
-        if "#backend:" in line]
-    template_lines[backend_line_idx] = (
-        "#backend: {}\n".format(setupext.options["backend"])
-        if setupext.options["backend"]
-        else "##backend: Agg\n")
-    path.write_text("".join(template_lines), encoding="utf-8")
-
-
-class BuildPy(setuptools.command.build_py.build_py):
-    def run(self):
-        super().run()
-        if not getattr(self, 'editable_mode', False):
-            update_matplotlibrc(
-                Path(self.build_lib, "matplotlib/mpl-data/matplotlibrc"))
-
-
-class Sdist(setuptools.command.sdist.sdist):
-    def make_release_tree(self, base_dir, files):
-        super().make_release_tree(base_dir, files)
-        update_matplotlibrc(
-            Path(base_dir, "lib/matplotlib/mpl-data/matplotlibrc"))
-
-# Start with type hint data
-# Will be further filled below by the various components.
-package_data = {"matplotlib": ["py.typed", "**/*.pyi"]}
-
-# If the user just queries for information, don't bother figuring out which
-# packages to build or install.
-if not (any('--' + opt in sys.argv
-            for opt in Distribution.display_option_names + ['help'])
-        or 'clean' in sys.argv):
-    # Go through all of the packages and figure out which ones we are
-    # going to build/install.
-    print_raw()
-    print_raw("Edit mplsetup.cfg to change the build options; "
-              "suppress output with --quiet.")
-    print_raw()
-    print_raw("BUILDING MATPLOTLIB")
-
-    good_packages = []
-    for package in mpl_packages:
-        try:
-            message = package.check()
-        except setupext.Skipped as e:
-            print_status(package.name, "no  [{e}]".format(e=e))
-            continue
-        if message is not None:
-            print_status(package.name,
-                         "yes [{message}]".format(message=message))
-        good_packages.append(package)
-
-    print_raw()
-
-    # Now collect all of the information we need to build all of the packages.
-    for package in good_packages:
-        # Extension modules only get added in build_ext, as numpy will have
-        # been installed (as setup_requires) at that point.
-        data = package.get_package_data()
-        for key, val in data.items():
-            package_data.setdefault(key, [])
-            package_data[key] = list(set(val + package_data[key]))
-
-setup(  # Finally, pass this all along to setuptools to do the heavy lifting.
-    # Dummy extension to trigger build_ext, which will swap it out with
-    # real extensions that can depend on numpy for the build.
-    ext_modules=[Extension("", [])],
-    package_data=package_data,
-
-    cmdclass={
-        "build_ext": BuildExtraLibraries,
-        "build_py": BuildPy,
-        "sdist": Sdist,
-    },
-)
diff --git a/setupext.py b/setupext.py
deleted file mode 100644
index 049f46c65c7d..000000000000
--- a/setupext.py
+++ /dev/null
@@ -1,799 +0,0 @@
-import configparser
-import functools
-import hashlib
-from io import BytesIO
-import logging
-import os
-from pathlib import Path
-import platform
-import shlex
-import shutil
-import subprocess
-import sys
-import sysconfig
-import tarfile
-from tempfile import TemporaryDirectory
-import textwrap
-import urllib.request
-
-from pybind11.setup_helpers import Pybind11Extension
-from setuptools import Distribution, Extension
-
-_log = logging.getLogger(__name__)
-
-
-def _get_xdg_cache_dir():
-    """
-    Return the `XDG cache directory`__.
-
-    __ https://specifications.freedesktop.org/basedir-spec/latest/
-    """
-    cache_dir = os.environ.get('XDG_CACHE_HOME')
-    if not cache_dir:
-        cache_dir = os.path.expanduser('~/.cache')
-        if cache_dir.startswith('~/'):  # Expansion failed.
-            return None
-    return Path(cache_dir, 'matplotlib')
-
-
-def _get_hash(data):
-    """Compute the sha256 hash of *data*."""
-    hasher = hashlib.sha256()
-    hasher.update(data)
-    return hasher.hexdigest()
-
-
-@functools.cache
-def _get_ssl_context():
-    import certifi
-    import ssl
-    return ssl.create_default_context(cafile=certifi.where())
-
-
-def get_from_cache_or_download(url, sha):
-    """
-    Get bytes from the given url or local cache.
-
-    Parameters
-    ----------
-    url : str
-        The url to download.
-    sha : str
-        The sha256 of the file.
-
-    Returns
-    -------
-    BytesIO
-        The file loaded into memory.
-    """
-    cache_dir = _get_xdg_cache_dir()
-
-    if cache_dir is not None:  # Try to read from cache.
-        try:
-            data = (cache_dir / sha).read_bytes()
-        except OSError:
-            pass
-        else:
-            if _get_hash(data) == sha:
-                return BytesIO(data)
-
-    # jQueryUI's website blocks direct downloads from urllib.request's
-    # default User-Agent, but not (for example) wget; so I don't feel too
-    # bad passing in an empty User-Agent.
-    with urllib.request.urlopen(
-            urllib.request.Request(url, headers={"User-Agent": ""}),
-            context=_get_ssl_context()) as req:
-        data = req.read()
-
-    file_sha = _get_hash(data)
-    if file_sha != sha:
-        raise Exception(
-            f"The downloaded file does not match the expected sha.  {url} was "
-            f"expected to have {sha} but it had {file_sha}")
-
-    if cache_dir is not None:  # Try to cache the downloaded file.
-        try:
-            cache_dir.mkdir(parents=True, exist_ok=True)
-            with open(cache_dir / sha, "xb") as fout:
-                fout.write(data)
-        except OSError:
-            pass
-
-    return BytesIO(data)
-
-
-def get_and_extract_tarball(urls, sha, dirname):
-    """
-    Obtain a tarball (from cache or download) and extract it.
-
-    Parameters
-    ----------
-    urls : list[str]
-        URLs from which download is attempted (in order of attempt), if the
-        tarball is not in the cache yet.
-    sha : str
-        SHA256 hash of the tarball; used both as a cache key (by
-        `get_from_cache_or_download`) and to validate a downloaded tarball.
-    dirname : path-like
-        Directory where the tarball is extracted.
-    """
-    toplevel = Path("build", dirname)
-    if not toplevel.exists():  # Download it or load it from cache.
-        try:
-            import certifi  # noqa
-        except ImportError as e:
-            raise ImportError(
-                f"`certifi` is unavailable ({e}) so unable to download any of "
-                f"the following: {urls}.") from None
-
-        Path("build").mkdir(exist_ok=True)
-        for url in urls:
-            try:
-                tar_contents = get_from_cache_or_download(url, sha)
-                break
-            except Exception:
-                pass
-        else:
-            raise OSError(
-                f"Failed to download any of the following: {urls}.  "
-                f"Please download one of these urls and extract it into "
-                f"'build/' at the top-level of the source repository.")
-        print(f"Extracting {urllib.parse.urlparse(url).path}")
-        with tarfile.open(fileobj=tar_contents, mode="r:gz") as tgz:
-            if os.path.commonpath(tgz.getnames()) != dirname:
-                raise OSError(
-                    f"The downloaded tgz file was expected to have {dirname} "
-                    f"as sole top-level directory, but that is not the case")
-            tgz.extractall("build")
-    return toplevel
-
-
-# SHA256 hashes of the FreeType tarballs
-_freetype_hashes = {
-    '2.6.1':
-        '0a3c7dfbda6da1e8fce29232e8e96d987ababbbf71ebc8c75659e4132c367014',
-    '2.6.2':
-        '8da42fc4904e600be4b692555ae1dcbf532897da9c5b9fb5ebd3758c77e5c2d4',
-    '2.6.3':
-        '7942096c40ee6fea882bd4207667ad3f24bff568b96b10fd3885e11a7baad9a3',
-    '2.6.4':
-        '27f0e38347a1850ad57f84fc4dfed68ba0bc30c96a6fa6138ef84d485dd9a8d7',
-    '2.6.5':
-        '3bb24add9b9ec53636a63ea8e867ed978c4f8fdd8f1fa5ccfd41171163d4249a',
-    '2.7':
-        '7b657d5f872b0ab56461f3bd310bd1c5ec64619bd15f0d8e08282d494d9cfea4',
-    '2.7.1':
-        '162ef25aa64480b1189cdb261228e6c5c44f212aac4b4621e28cf2157efb59f5',
-    '2.8':
-        '33a28fabac471891d0523033e99c0005b95e5618dc8ffa7fa47f9dadcacb1c9b',
-    '2.8.1':
-        '876711d064a6a1bd74beb18dd37f219af26100f72daaebd2d86cb493d7cd7ec6',
-    '2.9':
-        'bf380e4d7c4f3b5b1c1a7b2bf3abb967bda5e9ab480d0df656e0e08c5019c5e6',
-    '2.9.1':
-        'ec391504e55498adceb30baceebd147a6e963f636eb617424bcfc47a169898ce',
-    '2.10.0':
-        '955e17244e9b38adb0c98df66abb50467312e6bb70eac07e49ce6bd1a20e809a',
-    '2.10.1':
-        '3a60d391fd579440561bf0e7f31af2222bc610ad6ce4d9d7bd2165bca8669110',
-    '2.11.1':
-        'f8db94d307e9c54961b39a1cc799a67d46681480696ed72ecf78d4473770f09b'
-}
-# This is the version of FreeType to use when building a local version.  It
-# must match the value in lib/matplotlib.__init__.py, and the cache path in
-# `.circleci/config.yml`. Also update the docs in
-# `docs/devel/dependencies.rst`.
-TESTING_VERSION_OF_FREETYPE = '2.6.1'
-if sys.platform.startswith('win') and platform.machine() == 'ARM64':
-    # older versions of freetype are not supported for win/arm64
-    # Matplotlib tests will not pass
-    LOCAL_FREETYPE_VERSION = '2.11.1'
-else:
-    LOCAL_FREETYPE_VERSION = TESTING_VERSION_OF_FREETYPE
-
-LOCAL_FREETYPE_HASH = _freetype_hashes.get(LOCAL_FREETYPE_VERSION, 'unknown')
-
-# Also update the cache path in `.circleci/config.yml`.
-# Also update the docs in `docs/devel/dependencies.rst`.
-LOCAL_QHULL_VERSION = '2020.2'
-LOCAL_QHULL_HASH = (
-    'b5c2d7eb833278881b952c8a52d20179eab87766b00b865000469a45c1838b7e')
-
-
-# Matplotlib build options, which can be altered using mplsetup.cfg
-mplsetup_cfg = os.environ.get('MPLSETUPCFG') or 'mplsetup.cfg'
-config = configparser.ConfigParser()
-if os.path.exists(mplsetup_cfg):
-    config.read(mplsetup_cfg)
-options = {
-    'backend': config.get('rc_options', 'backend', fallback=None),
-    'system_freetype': config.getboolean(
-        'libs', 'system_freetype',
-        fallback=sys.platform.startswith(('aix', 'os400'))
-    ),
-    'system_qhull': config.getboolean(
-        'libs', 'system_qhull', fallback=sys.platform.startswith('os400')
-    ),
-}
-
-
-if '-q' in sys.argv or '--quiet' in sys.argv:
-    def print_raw(*args, **kwargs): pass  # Suppress our own output.
-else:
-    print_raw = print
-
-
-def print_status(package, status):
-    initial_indent = "%12s: " % package
-    indent = ' ' * 18
-    print_raw(textwrap.fill(status, width=80,
-                            initial_indent=initial_indent,
-                            subsequent_indent=indent))
-
-
-@functools.cache  # We only need to compute this once.
-def get_pkg_config():
-    """
-    Get path to pkg-config and set up the PKG_CONFIG environment variable.
-    """
-    if sys.platform == 'win32':
-        return None
-    pkg_config = os.environ.get('PKG_CONFIG') or 'pkg-config'
-    if shutil.which(pkg_config) is None:
-        print(
-            "IMPORTANT WARNING:\n"
-            "    pkg-config is not installed.\n"
-            "    Matplotlib may not be able to find some of its dependencies.")
-        return None
-    pkg_config_path = sysconfig.get_config_var('LIBDIR')
-    if pkg_config_path is not None:
-        pkg_config_path = os.path.join(pkg_config_path, 'pkgconfig')
-        try:
-            os.environ['PKG_CONFIG_PATH'] += ':' + pkg_config_path
-        except KeyError:
-            os.environ['PKG_CONFIG_PATH'] = pkg_config_path
-    return pkg_config
-
-
-def pkg_config_setup_extension(
-        ext, package,
-        atleast_version=None, alt_exec=None, default_libraries=()):
-    """Add parameters to the given *ext* for the given *package*."""
-
-    # First, try to get the flags from pkg-config.
-
-    pkg_config = get_pkg_config()
-    cmd = [pkg_config, package] if pkg_config else alt_exec
-    if cmd is not None:
-        try:
-            if pkg_config and atleast_version:
-                subprocess.check_call(
-                    [*cmd, f"--atleast-version={atleast_version}"])
-            # Use sys.getfilesystemencoding() to allow round-tripping
-            # when passed back to later subprocess calls; do not use
-            # locale.getpreferredencoding() which universal_newlines=True
-            # would do.
-            cflags = shlex.split(
-                os.fsdecode(subprocess.check_output([*cmd, "--cflags"])))
-            libs = shlex.split(
-                os.fsdecode(subprocess.check_output([*cmd, "--libs"])))
-        except (OSError, subprocess.CalledProcessError):
-            pass
-        else:
-            ext.extra_compile_args.extend(cflags)
-            ext.extra_link_args.extend(libs)
-            return
-
-    # If that fails, fall back on the defaults.
-
-    # conda Windows header and library paths.
-    # https://github.com/conda/conda/issues/2312 re: getting the env dir.
-    if sys.platform == 'win32':
-        conda_env_path = (os.getenv('CONDA_PREFIX')  # conda >= 4.1
-                          or os.getenv('CONDA_DEFAULT_ENV'))  # conda < 4.1
-        if conda_env_path and os.path.isdir(conda_env_path):
-            conda_env_path = Path(conda_env_path)
-            ext.include_dirs.append(str(conda_env_path / "Library/include"))
-            ext.library_dirs.append(str(conda_env_path / "Library/lib"))
-
-    # Default linked libs.
-    ext.libraries.extend(default_libraries)
-
-
-class Skipped(Exception):
-    """
-    Exception thrown by `SetupPackage.check` to indicate that a package should
-    be skipped.
-    """
-
-
-class SetupPackage:
-
-    def check(self):
-        """
-        If the package should be installed, return an informative string, or
-        None if no information should be displayed at all.
-
-        If the package should be skipped, raise a `Skipped` exception.
-
-        If a missing build dependency is fatal, call `sys.exit`.
-        """
-
-    def get_package_data(self):
-        """
-        Get a package data dictionary to add to the configuration.
-        These are merged into to the *package_data* list passed to
-        `setuptools.setup`.
-        """
-        return {}
-
-    def get_extensions(self):
-        """
-        Return or yield a list of C extensions (`distutils.core.Extension`
-        objects) to add to the configuration.  These are added to the
-        *extensions* list passed to `setuptools.setup`.
-        """
-        return []
-
-    def do_custom_build(self, env):
-        """
-        If a package needs to do extra custom things, such as building a
-        third-party library, before building an extension, it should
-        override this method.
-        """
-
-
-class OptionalPackage(SetupPackage):
-    default_config = True
-
-    def check(self):
-        """
-        Check whether ``mplsetup.cfg`` requests this package to be installed.
-
-        May be overridden by subclasses for additional checks.
-        """
-        if config.getboolean("packages", self.name,
-                             fallback=self.default_config):
-            return "installing"
-        else:  # Configuration opt-out by user
-            raise Skipped("skipping due to configuration")
-
-
-class Platform(SetupPackage):
-    name = "platform"
-
-    def check(self):
-        return sys.platform
-
-
-class Python(SetupPackage):
-    name = "python"
-
-    def check(self):
-        return sys.version
-
-
-def _pkg_data_helper(pkg, subdir):
-    """Glob "lib/$pkg/$subdir/**/*", returning paths relative to "lib/$pkg"."""
-    base = Path("lib", pkg)
-    return [str(path.relative_to(base)) for path in (base / subdir).rglob("*")]
-
-
-class Matplotlib(SetupPackage):
-    name = "matplotlib"
-
-    def get_package_data(self):
-        return {
-            'matplotlib': [
-                'mpl-data/matplotlibrc',
-                *_pkg_data_helper('matplotlib', 'mpl-data'),
-                *_pkg_data_helper('matplotlib', 'backends/web_backend'),
-                '*.dll',  # Only actually matters on Windows.
-            ],
-        }
-
-    def get_extensions(self):
-        # agg
-        ext = Extension(
-            "matplotlib.backends._backend_agg", [
-                "src/py_converters.cpp",
-                "src/_backend_agg.cpp",
-                "src/_backend_agg_wrapper.cpp",
-            ])
-        add_numpy_flags(ext)
-        add_libagg_flags_and_sources(ext)
-        FreeType.add_flags(ext)
-        yield ext
-        # c_internal_utils
-        ext = Extension(
-            "matplotlib._c_internal_utils", ["src/_c_internal_utils.c"],
-            libraries=({
-                "linux": ["dl"],
-                "win32": ["ole32", "shell32", "user32"],
-            }.get(sys.platform, [])))
-        yield ext
-        # ft2font
-        ext = Extension(
-            "matplotlib.ft2font", [
-                "src/ft2font.cpp",
-                "src/ft2font_wrapper.cpp",
-                "src/py_converters.cpp",
-            ])
-        FreeType.add_flags(ext)
-        add_numpy_flags(ext)
-        add_libagg_flags(ext)
-        yield ext
-        # image
-        ext = Pybind11Extension(
-            "matplotlib._image", [
-                "src/_image_wrapper.cpp",
-                "src/py_converters_11.cpp",
-            ],
-            cxx_std=11)
-        # Only need source code files agg_image_filters.cpp and agg_trans_affine.cpp
-        add_libagg_flags_and_sources(ext)
-        yield ext
-        # path
-        ext = Extension(
-            "matplotlib._path", [
-                "src/py_converters.cpp",
-                "src/_path_wrapper.cpp",
-            ])
-        add_numpy_flags(ext)
-        add_libagg_flags_and_sources(ext)
-        yield ext
-        # qhull
-        ext = Extension(
-            "matplotlib._qhull", ["src/_qhull_wrapper.cpp"],
-            define_macros=[("MPL_DEVNULL", os.devnull)])
-        add_numpy_flags(ext)
-        Qhull.add_flags(ext)
-        yield ext
-        # tkagg
-        ext = Extension(
-            "matplotlib.backends._tkagg", [
-                "src/_tkagg.cpp",
-            ],
-            include_dirs=["src"],
-            # psapi library needed for finding Tcl/Tk at run time.
-            libraries={"linux": ["dl"], "win32": ["comctl32", "psapi"],
-                       "cygwin": ["comctl32", "psapi"]}.get(sys.platform, []),
-            extra_link_args={"win32": ["-mwindows"]}.get(sys.platform, []))
-        add_numpy_flags(ext)
-        add_libagg_flags(ext)
-        yield ext
-        # tri
-        ext = Pybind11Extension(
-            "matplotlib._tri", [
-                "src/tri/_tri.cpp",
-                "src/tri/_tri_wrapper.cpp",
-            ],
-            cxx_std=11)
-        yield ext
-        # ttconv
-        ext = Pybind11Extension(
-            "matplotlib._ttconv", [
-                "src/_ttconv.cpp",
-                "extern/ttconv/pprdrv_tt.cpp",
-                "extern/ttconv/pprdrv_tt2.cpp",
-                "extern/ttconv/ttutil.cpp",
-            ],
-            include_dirs=["extern"],
-            cxx_std=11)
-        yield ext
-
-
-class Tests(OptionalPackage):
-    name = "tests"
-    default_config = False
-
-    def get_package_data(self):
-        return {
-            'matplotlib': [
-                *_pkg_data_helper('matplotlib', 'tests/baseline_images'),
-                *_pkg_data_helper('matplotlib', 'tests/tinypages'),
-                'tests/cmr10.pfb',
-                'tests/Courier10PitchBT-Bold.pfb',
-                'tests/mpltest.ttf',
-                'tests/test_*.ipynb',
-            ],
-            'mpl_toolkits': [
-                *_pkg_data_helper('mpl_toolkits',
-                                  'axes_grid1/tests/baseline_images'),
-                *_pkg_data_helper('mpl_toolkits',
-                                  'axisartist/tests/baseline_images'),
-                *_pkg_data_helper('mpl_toolkits',
-                                  'mplot3d/tests/baseline_images'),
-            ]
-        }
-
-
-def add_numpy_flags(ext):
-    import numpy as np
-    ext.include_dirs.append(np.get_include())
-    ext.define_macros.extend([
-        # Ensure that PY_ARRAY_UNIQUE_SYMBOL is uniquely defined for each
-        # extension.
-        ('PY_ARRAY_UNIQUE_SYMBOL',
-         'MPL_' + ext.name.replace('.', '_') + '_ARRAY_API'),
-        ('NPY_NO_DEPRECATED_API', 'NPY_1_7_API_VERSION'),
-        # Allow NumPy's printf format specifiers in C++.
-        ('__STDC_FORMAT_MACROS', 1),
-    ])
-
-
-def add_libagg_flags(ext):
-    # We need a patched Agg not available elsewhere, so always use the vendored
-    # version.
-    ext.include_dirs.insert(0, "extern/agg24-svn/include")
-
-
-def add_libagg_flags_and_sources(ext):
-    # We need a patched Agg not available elsewhere, so always use the vendored
-    # version.
-    ext.include_dirs.insert(0, "extern/agg24-svn/include")
-    agg_sources = [
-        "agg_bezier_arc.cpp",
-        "agg_curves.cpp",
-        "agg_image_filters.cpp",
-        "agg_trans_affine.cpp",
-        "agg_vcgen_contour.cpp",
-        "agg_vcgen_dash.cpp",
-        "agg_vcgen_stroke.cpp",
-        "agg_vpgen_segmentator.cpp",
-    ]
-    ext.sources.extend(
-        os.path.join("extern", "agg24-svn", "src", x) for x in agg_sources)
-
-
-def get_ccompiler():
-    """
-    Return a new CCompiler instance.
-
-    CCompiler used to be constructible via `distutils.ccompiler.new_compiler`,
-    but this API was removed as part of the distutils deprecation.  Instead,
-    we trick setuptools into instantiating it by creating a dummy Distribution
-    with a list of extension modules that claims to be truthy, but is actually
-    empty, and then running the Distribution's build_ext command.  (If using
-    a plain empty ext_modules, build_ext would early-return without doing
-    anything.)
-    """
-
-    class L(list):
-        def __bool__(self):
-            return True
-
-    build_ext = Distribution({"ext_modules": L()}).get_command_obj("build_ext")
-    build_ext.finalize_options()
-    build_ext.run()
-    return build_ext.compiler
-
-
-class FreeType(SetupPackage):
-    name = "freetype"
-
-    @classmethod
-    def add_flags(cls, ext):
-        # checkdep_freetype2.c immediately aborts the compilation either with
-        # "foo.h: No such file or directory" if the header is not found, or an
-        # appropriate error message if the header indicates a too-old version.
-        ext.sources.insert(0, 'src/checkdep_freetype2.c')
-        if options.get('system_freetype'):
-            pkg_config_setup_extension(
-                # FreeType 2.3 has libtool version 9.11.3 as can be checked
-                # from the tarball.  For FreeType>=2.4, there is a conversion
-                # table in docs/VERSIONS.txt in the FreeType source tree.
-                ext, 'freetype2',
-                atleast_version='9.11.3',
-                alt_exec=['freetype-config'],
-                default_libraries=['freetype'])
-            ext.define_macros.append(('FREETYPE_BUILD_TYPE', 'system'))
-        else:
-            src_path = Path('build', f'freetype-{LOCAL_FREETYPE_VERSION}')
-            # Statically link to the locally-built freetype.
-            ext.include_dirs.insert(0, str(src_path / 'include'))
-            ext.extra_objects.insert(
-                0, str((src_path / 'objs/.libs/libfreetype').with_suffix(
-                    '.lib' if sys.platform == 'win32' else '.a')))
-            ext.define_macros.append(('FREETYPE_BUILD_TYPE', 'local'))
-            if sys.platform == 'darwin':
-                name = ext.name.split('.')[-1]
-                ext.extra_link_args.append(
-                    f'-Wl,-exported_symbol,_PyInit_{name}')
-
-    def do_custom_build(self, env):
-        # We're using a system freetype
-        if options.get('system_freetype'):
-            return
-
-        tarball = f'freetype-{LOCAL_FREETYPE_VERSION}.tar.gz'
-        src_path = get_and_extract_tarball(
-            urls=[
-                (f'https://downloads.sourceforge.net/project/freetype'
-                 f'/freetype2/{LOCAL_FREETYPE_VERSION}/{tarball}'),
-                (f'https://download.savannah.gnu.org/releases/freetype'
-                 f'/{tarball}'),
-                (f'https://download.savannah.gnu.org/releases/freetype'
-                 f'/freetype-old/{tarball}')
-            ],
-            sha=LOCAL_FREETYPE_HASH,
-            dirname=f'freetype-{LOCAL_FREETYPE_VERSION}',
-        )
-
-        libfreetype = (src_path / "objs/.libs/libfreetype").with_suffix(
-            ".lib" if sys.platform == "win32" else ".a")
-        if libfreetype.is_file():
-            return  # Bail out because we have already built FreeType.
-
-        print(f"Building freetype in {src_path}")
-        if sys.platform != 'win32':  # compilation on non-windows
-            env = {
-                **{
-                    var: value
-                    for var, value in sysconfig.get_config_vars().items()
-                    if var in {"CC", "CFLAGS", "CXX", "CXXFLAGS", "LD",
-                               "LDFLAGS"}
-                },
-                **env,
-            }
-            configure_ac = Path(src_path, "builds/unix/configure.ac")
-            if ((src_path / "autogen.sh").exists()
-                    and not configure_ac.exists()):
-                print(f"{configure_ac} does not exist. "
-                      f"Using sh autogen.sh to generate.")
-                subprocess.check_call(
-                    ["sh", "./autogen.sh"], env=env, cwd=src_path)
-            env["CFLAGS"] = env.get("CFLAGS", "") + " -fPIC"
-            configure = [
-                "./configure", "--with-zlib=no", "--with-bzip2=no",
-                "--with-png=no", "--with-harfbuzz=no", "--enable-static",
-                "--disable-shared"
-            ]
-            host = sysconfig.get_config_var('HOST_GNU_TYPE')
-            if host is not None:  # May be unset on PyPy.
-                configure.append(f"--host={host}")
-            subprocess.check_call(configure, env=env, cwd=src_path)
-            if 'GNUMAKE' in env:
-                make = env['GNUMAKE']
-            elif 'MAKE' in env:
-                make = env['MAKE']
-            else:
-                try:
-                    output = subprocess.check_output(['make', '-v'],
-                                                     stderr=subprocess.DEVNULL)
-                except subprocess.CalledProcessError:
-                    output = b''
-                if b'GNU' not in output and b'makepp' not in output:
-                    make = 'gmake'
-                else:
-                    make = 'make'
-            subprocess.check_call([make], env=env, cwd=src_path)
-        else:  # compilation on windows
-            shutil.rmtree(src_path / "objs", ignore_errors=True)
-            base_path = Path(
-                f"build/freetype-{LOCAL_FREETYPE_VERSION}/builds/windows"
-            )
-            vc = 'vc2010'
-            sln_path = base_path / vc / "freetype.sln"
-            # https://developercommunity.visualstudio.com/comments/190992/view.html
-            (sln_path.parent / "Directory.Build.props").write_text(
-                "<?xml version='1.0' encoding='utf-8'?>"
-                "<Project>"
-                "<PropertyGroup>"
-                # WindowsTargetPlatformVersion must be given on a single line.
-                "<WindowsTargetPlatformVersion>$("
-                "[Microsoft.Build.Utilities.ToolLocationHelper]"
-                "::GetLatestSDKTargetPlatformVersion('Windows', '10.0')"
-                ")</WindowsTargetPlatformVersion>"
-                "</PropertyGroup>"
-                "</Project>",
-                encoding="utf-8")
-            # It is not a trivial task to determine PlatformToolset to plug it
-            # into msbuild command, and Directory.Build.props will not override
-            # the value in the project file.
-            # The DefaultPlatformToolset is from Microsoft.Cpp.Default.props
-            with open(base_path / vc / "freetype.vcxproj", 'r+b') as f:
-                toolset_repl = b'PlatformToolset>$(DefaultPlatformToolset)<'
-                vcxproj = f.read().replace(b'PlatformToolset>v100<',
-                                           toolset_repl)
-                assert toolset_repl in vcxproj, (
-                   'Upgrading Freetype might break this')
-                f.seek(0)
-                f.truncate()
-                f.write(vcxproj)
-
-            cc = get_ccompiler()
-            cc.initialize()
-            # On setuptools versions that use "local" distutils,
-            # ``cc.spawn(["msbuild", ...])`` no longer manages to locate the
-            # right executable, even though they are correctly on the PATH,
-            # because only the env kwarg to Popen() is updated, and not
-            # os.environ["PATH"]. Instead, use shutil.which to walk the PATH
-            # and get absolute executable paths.
-            with TemporaryDirectory() as tmpdir:
-                dest = Path(tmpdir, "path")
-                cc.spawn([
-                    sys.executable, "-c",
-                    "import pathlib, shutil, sys\n"
-                    "dest = pathlib.Path(sys.argv[1])\n"
-                    "dest.write_text(shutil.which('msbuild'))\n",
-                    str(dest),
-                ])
-                msbuild_path = dest.read_text()
-            msbuild_platform = (
-                "ARM64" if platform.machine() == "ARM64" else
-                "x64" if platform.architecture()[0] == "64bit" else
-                "Win32")
-            # Freetype 2.10.0+ support static builds.
-            msbuild_config = (
-                "Release Static"
-                if [*map(int, LOCAL_FREETYPE_VERSION.split("."))] >= [2, 10]
-                else "Release"
-            )
-
-            cc.spawn([msbuild_path, str(sln_path),
-                      "/t:Clean;Build",
-                      f"/p:Configuration={msbuild_config};"
-                      f"Platform={msbuild_platform}"])
-            # Move to the corresponding Unix build path.
-            libfreetype.parent.mkdir()
-            # Be robust against change of FreeType version.
-            lib_paths = Path(src_path / "objs").rglob('freetype*.lib')
-            # Select FreeType library for required platform
-            lib_path, = [
-                p for p in lib_paths
-                if msbuild_platform in p.resolve().as_uri()
-            ]
-            print(f"Copying {lib_path} to {libfreetype}")
-            shutil.copy2(lib_path, libfreetype)
-
-
-class Qhull(SetupPackage):
-    name = "qhull"
-    _extensions_to_update = []
-
-    @classmethod
-    def add_flags(cls, ext):
-        if options.get("system_qhull"):
-            ext.libraries.append("qhull_r")
-        else:
-            cls._extensions_to_update.append(ext)
-
-    def do_custom_build(self, env):
-        if options.get('system_qhull'):
-            return
-
-        toplevel = get_and_extract_tarball(
-            urls=["http://www.qhull.org/download/qhull-2020-src-8.0.2.tgz"],
-            sha=LOCAL_QHULL_HASH,
-            dirname=f"qhull-{LOCAL_QHULL_VERSION}",
-        )
-        shutil.copyfile(toplevel / "COPYING.txt", "LICENSE/LICENSE_QHULL")
-
-        for ext in self._extensions_to_update:
-            qhull_path = Path(f'build/qhull-{LOCAL_QHULL_VERSION}/src')
-            ext.include_dirs.insert(0, str(qhull_path))
-            ext.sources.extend(
-                map(str, sorted(qhull_path.glob('libqhull_r/*.c'))))
-            if sysconfig.get_config_var("LIBM") == "-lm":
-                ext.libraries.extend("m")
-
-
-class BackendMacOSX(OptionalPackage):
-    name = 'macosx'
-
-    def check(self):
-        if sys.platform != 'darwin':
-            raise Skipped("Mac OS-X only")
-        return super().check()
-
-    def get_extensions(self):
-        ext = Extension(
-            'matplotlib.backends._macosx', [
-                'src/_macosx.m'
-            ])
-        ext.extra_compile_args.extend(['-Werror'])
-        ext.extra_link_args.extend(['-framework', 'Cocoa'])
-        if platform.python_implementation().lower() == 'pypy':
-            ext.extra_compile_args.append('-DPYPY=1')
-        yield ext

From 05b664f09fed1fea8e13985f3e075e85f431990a Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 25 Aug 2023 23:30:16 -0400
Subject: [PATCH 0229/1120] Try to generate a version from Meson

---
 lib/matplotlib/__init__.py    | 23 ++++++++++++++---------
 lib/matplotlib/_version.py.in |  1 +
 lib/matplotlib/meson.build    | 14 ++++++++++++++
 3 files changed, 29 insertions(+), 9 deletions(-)
 create mode 100644 lib/matplotlib/_version.py.in

diff --git a/lib/matplotlib/__init__.py b/lib/matplotlib/__init__.py
index 3ffe046e6ba9..821d1bdeb5ea 100644
--- a/lib/matplotlib/__init__.py
+++ b/lib/matplotlib/__init__.py
@@ -219,15 +219,20 @@ def _get_version():
     if ((root / ".matplotlib-repo").exists()
             and (root / ".git").exists()
             and not (root / ".git/shallow").exists()):
-        import setuptools_scm
-        return setuptools_scm.get_version(
-            root=root,
-            version_scheme="release-branch-semver",
-            local_scheme="node-and-date",
-            fallback_version=_version.version,
-        )
-    else:  # Get the version from the _version.py setuptools_scm file.
-        return _version.version
+        try:
+            import setuptools_scm
+        except ImportError:
+            pass
+        else:
+            return setuptools_scm.get_version(
+                root=root,
+                version_scheme="release-branch-semver",
+                local_scheme="node-and-date",
+                fallback_version=_version.version,
+            )
+    # Get the version from the _version.py file if not in repo or setuptools_scm is
+    # unavailable.
+    return _version.version
 
 
 @_api.caching_module_getattr
diff --git a/lib/matplotlib/_version.py.in b/lib/matplotlib/_version.py.in
new file mode 100644
index 000000000000..a809c61c2099
--- /dev/null
+++ b/lib/matplotlib/_version.py.in
@@ -0,0 +1 @@
+version = @VCS_TAG@
diff --git a/lib/matplotlib/meson.build b/lib/matplotlib/meson.build
index 4f8d93d1f01d..7847e7c8b438 100644
--- a/lib/matplotlib/meson.build
+++ b/lib/matplotlib/meson.build
@@ -138,6 +138,20 @@ typing_sources = [
 py3.install_sources(python_sources, typing_sources,
                     subdir: 'matplotlib')
 
+fs = import('fs')
+if fs.exists('_version.py')
+    py3.install_sources('_version.py', subdir: 'matplotlib')
+else
+  cfg = configuration_data()
+  cfg.set_quoted('VCS_TAG', meson.project_version())
+  configure_file(
+    input: '_version.py.in', output: '_version.py',
+    configuration: cfg,
+    install: true,
+    install_tag: 'python-runtime',
+    install_dir: py3.get_install_dir() / 'matplotlib')
+endif
+
 subdir('_api')
 subdir('axes')
 subdir('backends')

From 0c0a9d3d15e7969663c99440e1dfcf33e1b5cff6 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 30 Aug 2023 00:46:59 -0400
Subject: [PATCH 0230/1120] Implement backend setup in matplotlibrc

---
 lib/matplotlib/meson.build          |  6 +-----
 lib/matplotlib/mpl-data/meson.build | 24 ++++++++++++++++++++++++
 tools/generate_matplotlibrc.py      | 28 ++++++++++++++++++++++++++++
 3 files changed, 53 insertions(+), 5 deletions(-)
 create mode 100644 lib/matplotlib/mpl-data/meson.build
 create mode 100755 tools/generate_matplotlibrc.py

diff --git a/lib/matplotlib/meson.build b/lib/matplotlib/meson.build
index 7847e7c8b438..c4b66fc1b336 100644
--- a/lib/matplotlib/meson.build
+++ b/lib/matplotlib/meson.build
@@ -155,14 +155,10 @@ endif
 subdir('_api')
 subdir('axes')
 subdir('backends')
+subdir('mpl-data')
 subdir('projections')
 subdir('sphinxext')
 subdir('style')
 subdir('testing')
 subdir('tests')
 subdir('tri')
-
-install_subdir(
-  'mpl-data',
-  install_tag: 'data',
-  install_dir: py3.get_install_dir(subdir: 'matplotlib'))
diff --git a/lib/matplotlib/mpl-data/meson.build b/lib/matplotlib/mpl-data/meson.build
new file mode 100644
index 000000000000..00a825fbbbea
--- /dev/null
+++ b/lib/matplotlib/mpl-data/meson.build
@@ -0,0 +1,24 @@
+custom_target('matplotlibrc',
+  command: [
+    find_program(meson.project_source_root() / 'tools/generate_matplotlibrc.py'),
+    '@INPUT@',
+    '@OUTPUT@',
+    get_option('rcParams-backend')
+  ],
+  input: 'matplotlibrc',
+  output: 'matplotlibrc',
+  install: true,
+  install_tag: 'data',
+  install_dir: py3.get_install_dir(subdir: 'matplotlib/mpl-data'))
+
+install_data(
+  'kpsewhich.lua',
+  install_tag: 'data',
+  install_dir: py3.get_install_dir(subdir: 'matplotlib/mpl-data'))
+
+foreach dir : ['fonts', 'images', 'plot_directive', 'sample_data', 'stylelib']
+  install_subdir(
+    dir,
+    install_tag: 'data',
+    install_dir: py3.get_install_dir(subdir: 'matplotlib/mpl-data'))
+endforeach
diff --git a/tools/generate_matplotlibrc.py b/tools/generate_matplotlibrc.py
new file mode 100755
index 000000000000..33d6277870da
--- /dev/null
+++ b/tools/generate_matplotlibrc.py
@@ -0,0 +1,28 @@
+#!/usr/bin/env python
+"""
+Generate matplotlirc for installs.
+
+If packagers want to change the default backend, insert a `#backend: ...` line.
+Otherwise, use the default `##backend: Agg` which has no effect even after
+decommenting, which allows _auto_backend_sentinel to be filled in at import
+time.
+"""
+
+import sys
+from pathlib import Path
+
+
+if len(sys.argv) != 4:
+    raise SystemExit('usage: {sys.argv[0]} <input> <output> <backend>')
+
+input = Path(sys.argv[1])
+output = Path(sys.argv[2])
+backend = sys.argv[3]
+
+template_lines = input.read_text(encoding="utf-8").splitlines(True)
+backend_line_idx, = [  # Also asserts that there is a single such line.
+    idx for idx, line in enumerate(template_lines)
+    if "#backend:" in line]
+template_lines[backend_line_idx] = (
+    f"#backend: {backend}\n" if backend not in ['', 'auto'] else "##backend: Agg\n")
+output.write_text("".join(template_lines), encoding="utf-8")

From 8830387a497b3809ff522e0d7eb30f04d91cd266 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Sat, 2 Sep 2023 02:47:17 -0400
Subject: [PATCH 0231/1120] Update CI for Meson build

---
 .appveyor.yml                         |  2 +-
 .circleci/config.yml                  |  7 +++++--
 .github/workflows/cibuildwheel.yml    |  9 +++++----
 .github/workflows/codeql-analysis.yml |  8 ++++----
 .github/workflows/cygwin.yml          | 14 ++++---------
 .github/workflows/mypy-stubtest.yml   |  3 ++-
 .github/workflows/tests.yml           | 29 +++++++--------------------
 azure-pipelines.yml                   | 13 ++++++++----
 environment.yml                       |  5 +++--
 requirements/testing/minver.txt       |  8 +++++---
 10 files changed, 45 insertions(+), 53 deletions(-)

diff --git a/.appveyor.yml b/.appveyor.yml
index b48726bb3e51..6e71e94e58f5 100644
--- a/.appveyor.yml
+++ b/.appveyor.yml
@@ -70,7 +70,7 @@ install:
 test_script:
   # Now build the thing..
   - set LINK=/LIBPATH:%cd%\lib
-  - pip install -ve .
+  - pip install -v --no-build-isolation --config-settings=setup-args="--vsenv" --editable .[dev]
   # this should show no freetype dll...
   - set "DUMPBIN=%VS140COMNTOOLS%\..\..\VC\bin\dumpbin.exe"
   - '"%DUMPBIN%" /DEPENDENTS lib\matplotlib\ft2font*.pyd | findstr freetype.*.dll && exit /b 1 || exit /b 0'
diff --git a/.circleci/config.yml b/.circleci/config.yml
index 680798abe5fb..e8c8c2fca394 100644
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -55,6 +55,7 @@ commands:
               graphviz \
               inkscape \
               lmodern \
+              ninja-build \
               optipng \
               texlive-fonts-recommended \
               texlive-latex-base \
@@ -97,6 +98,7 @@ commands:
       - run:
           name: Install Python dependencies
           command: |
+            python -m pip install --user meson-python pybind11
             python -m pip install --user \
                 numpy<< parameters.numpy_version >> \
                 -r requirements/doc/doc-requirements.txt
@@ -114,7 +116,8 @@ commands:
               version=${version#v}
               python -m pip install matplotlib==${version}
             else
-              python -m pip install --user -ve .
+              python -m pip install --user --verbose \
+                --no-build-isolation --editable .[dev]
             fi
       - save_cache:
           key: build-deps-2
@@ -215,8 +218,8 @@ jobs:
       - fonts-install
       - pip-install
 
-      - mpl-install
       - doc-deps-install
+      - mpl-install
 
       - doc-build
       - doc-show-errors-warnings
diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 8c76303cbb85..d4230e8f17ab 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -91,16 +91,17 @@ jobs:
     runs-on: ${{ matrix.os }}
     env:
       CIBW_BEFORE_BUILD: >-
-        pip install certifi numpy>=1.25 &&
+        pip install numpy>=1.25 &&
         rm -rf {package}/build
       CIBW_BEFORE_BUILD_WINDOWS: >-
-        pip install certifi delvewheel numpy>=1.25 &&
+        pip install delvewheel numpy>=1.25 &&
         rm -rf {package}/build
       CIBW_REPAIR_WHEEL_COMMAND_WINDOWS: >-
         delvewheel repair -w {dest_dir} {wheel}
       CIBW_AFTER_BUILD: >-
         twine check {wheel} &&
         python {package}/ci/check_wheel_licenses.py {wheel}
+      CIBW_CONFIG_SETTINGS: setup-args="--vsenv"
       CIBW_MANYLINUX_X86_64_IMAGE: manylinux2014
       CIBW_SKIP: "*-musllinux_aarch64"
       CIBW_TEST_COMMAND: >-
@@ -144,11 +145,11 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
           # Remove this once NumPy with Python 3.12 wheels is not pre-release.
           CIBW_BEFORE_BUILD: >-
-            pip install certifi "pybind11>=2.6" "setuptools>=42" "setuptools_scm>=7" &&
+            pip install "meson-python>=0.13.1" ninja "pybind11>=2.6" "setuptools>=42" "setuptools_scm>=7" &&
             pip install --pre "numpy>=1.25" &&
             rm -rf {package}/build
           CIBW_BEFORE_BUILD_WINDOWS: >-
-            pip install certifi delvewheel "pybind11>=2.6" "setuptools>=42" "setuptools_scm>=7" &&
+            pip install delvewheel "meson-python>=0.13.1" ninja "pybind11>=2.6" "setuptools>=42" "setuptools_scm>=7" &&
             pip install --pre "numpy>=1.25" &&
             rm -rf {package}/build
           CIBW_ENVIRONMENT: PIP_NO_BUILD_ISOLATION=0
diff --git a/.github/workflows/codeql-analysis.yml b/.github/workflows/codeql-analysis.yml
index d31973e954d5..5753b17922d6 100644
--- a/.github/workflows/codeql-analysis.yml
+++ b/.github/workflows/codeql-analysis.yml
@@ -41,9 +41,9 @@ jobs:
           # dependencies so we don't need another copy here.
           # https://github.com/jazzband/pip-tools/pull/1681
           python -m pip install --upgrade \
-            certifi contourpy cycler fonttools kiwisolver importlib_resources \
-            numpy packaging pillow pyparsing python-dateutil setuptools-scm \
-            pybind11
+            build contourpy cycler fonttools kiwisolver \
+            importlib_resources meson-python numpy packaging pillow pybind11 \
+            pyparsing python-dateutil setuptools-scm
           echo "CODEQL_PYTHON=$(which python)" >> $GITHUB_ENV
 
       - name: Initialize CodeQL
@@ -56,7 +56,7 @@ jobs:
         if: matrix.language == 'cpp'
         run: |
           mkdir ~/.cache/matplotlib
-          $CODEQL_PYTHON setup.py build
+          $CODEQL_PYTHON -m build
 
       - name: Perform CodeQL Analysis
         uses: github/codeql-action/analyze@v2
diff --git a/.github/workflows/cygwin.yml b/.github/workflows/cygwin.yml
index 11ea1377b36d..feded9f0c1ad 100644
--- a/.github/workflows/cygwin.yml
+++ b/.github/workflows/cygwin.yml
@@ -203,20 +203,14 @@ jobs:
           AUTOCONF: /usr/bin/autoconf-2.69
           MAKEFLAGS: dw
         run: |
+          export PATH="/usr/local/bin:$PATH"
           ccache -s
           git describe
-          cat <<EOT >> mplsetup.cfg
-          [rc_options]
-          backend=Agg
-
-          [libs]
-          system_freetype = False
-          system_qhull = True
-          EOT
-          cat mplsetup.cfg
           # All dependencies must have been pre-installed, so that the minver
           # constraints are held.
-          python -m pip install --no-deps -ve .
+          python -m pip install --no-deps --no-build-isolation --verbose \
+            --config-settings=setup-args="-DrcParams-backend=Agg" \
+            --editable .[dev]
 
       - name: Find DLLs to rebase
         shell: bash.exe -eo pipefail -o igncr "{0}"
diff --git a/.github/workflows/mypy-stubtest.yml b/.github/workflows/mypy-stubtest.yml
index 4cb225258f4f..8d2943e38ecf 100644
--- a/.github/workflows/mypy-stubtest.yml
+++ b/.github/workflows/mypy-stubtest.yml
@@ -22,7 +22,7 @@ jobs:
         run: |
           pip3 install -r requirements/testing/mypy.txt \
             -r requirements/testing/all.txt
-          pip3 install -e .
+          pip3 install .
 
       - name: Set up reviewdog
         run: |
@@ -38,6 +38,7 @@ jobs:
         run: |
           set -o pipefail
           MPLBACKEND=agg python tools/stubtest.py | \
+              sed -e "s!$pythonLocation/lib/python3.9/site-packages!lib!g" | \
               reviewdog \
                 -efm '%Eerror: %m' \
                 -efm '%CStub: in file %f:%l' \
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index adff7f1ce292..a3d3d63c64fa 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -56,7 +56,6 @@ jobs:
             pyside2-ver: '==5.15.1'  # oldest version with working Py3.9 wheel.
             pyside6-ver: '==6.0.0'
             delete-font-cache: true
-            no-build-isolation: true
           - os: ubuntu-20.04
             python-version: 3.9
             extra-requirements: '-r requirements/testing/extra.txt'
@@ -81,7 +80,6 @@ jobs:
             python-version: '3.12-dev'
             pyside6-ver: '!=6.5.1'
             pre: true
-            no-build-isolation: true
           - os: macos-latest
             python-version: 3.9
             # https://bugreports.qt.io/projects/PYSIDE/issues/PYSIDE-2346
@@ -131,6 +129,7 @@ jobs:
               libxcb-render-util0 \
               libxcb-xinerama0 \
               lmodern \
+              ninja-build \
               pkg-config \
               qtbase5-dev \
               texlive-fonts-recommended \
@@ -150,7 +149,7 @@ jobs:
           macOS)
             brew install ccache
             brew tap homebrew/cask-fonts
-            brew install font-noto-sans-cjk gobject-introspection gtk4
+            brew install font-noto-sans-cjk gobject-introspection gtk4 ninja
             ;;
           esac
 
@@ -205,17 +204,14 @@ jobs:
           fi
 
           # Install dependencies from PyPI.
+          # Preinstall build requirements to enable no-build-isolation builds.
           python -m pip install --upgrade $PRE \
             'contourpy>=1.0.1' cycler fonttools kiwisolver importlib_resources \
             numpy packaging pillow 'pyparsing!=3.1.0' python-dateutil setuptools-scm \
+            'meson-python>=0.13.1' 'pybind11>=2.6' \
             -r requirements/testing/all.txt \
             ${{ matrix.extra-requirements }}
 
-          # Preinstall pybind11 on no-build-isolation builds.
-          if [[ "${{ matrix.no-build-isolation }}" == 'true' ]]; then
-            python -m pip install 'pybind11>=2.6'
-          fi
-
           # Install optional dependencies from PyPI.
           # Sphinx is needed to run sphinxext tests
           python -m pip install --upgrade sphinx!=6.1.2
@@ -300,20 +296,9 @@ jobs:
             fi
           fi
 
-          cat <<EOT >> mplsetup.cfg
-          [rc_options]
-          backend=Agg
-          EOT
-
-          cat mplsetup.cfg
-
-          if [[ "${{ matrix.no-build-isolation }}" == 'true' ]]; then
-            # Minimum versions run does not use build isolation so that it
-            # builds against the pre-installed minver dependencies.
-            python -m pip install --no-deps --no-build-isolation -ve .
-          else
-            python -m pip install --no-deps -ve .
-          fi
+          python -m pip install --no-deps --no-build-isolation --verbose \
+            --config-settings=setup-args="-DrcParams-backend=Agg" \
+            --editable .[dev]
 
           if [[ "${{ runner.os }}" != 'macOS' ]]; then
             unset CPPFLAGS
diff --git a/azure-pipelines.yml b/azure-pipelines.yml
index 7d00e499fd18..8eb5cacfb55a 100644
--- a/azure-pipelines.yml
+++ b/azure-pipelines.yml
@@ -96,6 +96,7 @@ stages:
               cm-super \
               dvipng \
               ffmpeg \
+              fonts-freefont-otf \
               fonts-noto-cjk \
               fonts-wqy-zenhei \
               gdb \
@@ -105,23 +106,24 @@ stages:
               libcairo2 \
               libgirepository-1.0-1 \
               lmodern \
-              fonts-freefont-otf \
+              ninja-build \
               poppler-utils \
-              texlive-pictures \
               texlive-fonts-recommended \
               texlive-latex-base \
               texlive-latex-extra \
               texlive-latex-recommended \
               texlive-luatex \
+              texlive-pictures \
               texlive-xetex
             ;;
           darwin)
             brew install --cask xquartz
-            brew install pkg-config ffmpeg imagemagick mplayer ccache
+            brew install ccache ffmpeg imagemagick mplayer ninja pkg-config
             brew tap homebrew/cask-fonts
             brew install font-noto-sans-cjk-sc
             ;;
           win32)
+            choco install ninja
             ;;
           *)
             exit 1
@@ -131,12 +133,15 @@ stages:
 
       - bash: |
           python -m pip install --upgrade pip
+          python -m pip install --upgrade meson-python pybind11
           python -m pip install -r requirements/testing/all.txt -r requirements/testing/extra.txt ||
             [[ "$PYTHON_VERSION" = 'Pre' ]]
         displayName: 'Install dependencies with pip'
 
       - bash: |
-          python -m pip install -ve . ||
+          python -m pip install \
+            --no-build-isolation --config-settings=setup-args="--vsenv" \
+            --verbose --editable .[dev] ||
             [[ "$PYTHON_VERSION" = 'Pre' ]]
         displayName: "Install self"
 
diff --git a/environment.yml b/environment.yml
index 7b13735bb172..095e3d240bd2 100644
--- a/environment.yml
+++ b/environment.yml
@@ -2,7 +2,7 @@
 #
 #   conda env create -f environment.yml
 #   conda activate mpl-dev
-#   pip install -e .
+#   pip install -e .[dev]
 #
 name: mpl-dev
 channels:
@@ -15,14 +15,15 @@ dependencies:
   - fonttools>=4.22.0
   - importlib-resources>=3.2.0
   - kiwisolver>=1.3.1
+  - meson-python>=0.13.1
   - numpy>=1.21
   - pillow>=8
+  - pkg-config
   - pybind11>=2.6.0
   - pygobject
   - pyparsing>=2.3.1
   - pyqt
   - python-dateutil>=2.1
-  - setuptools
   - setuptools_scm
   - wxpython
   # building documentation
diff --git a/requirements/testing/minver.txt b/requirements/testing/minver.txt
index b989922c5527..b399bd996e08 100644
--- a/requirements/testing/minver.txt
+++ b/requirements/testing/minver.txt
@@ -2,12 +2,14 @@
 
 contourpy==1.0.1
 cycler==0.10
-kiwisolver==1.3.1
+fonttools==4.22.0
 importlib-resources==3.2.0
+kiwisolver==1.3.1
+meson-python==0.13.1
+meson==1.1.0
 numpy==1.21.0
 packaging==20.0
 pillow==8.0.0
 pyparsing==2.3.1
-python-dateutil==2.7
-fonttools==4.22.0
 pytest==7.0.0
+python-dateutil==2.7

From 65545ddd98ab0964f3b96f8aecf0514e6d31a118 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 7 Sep 2023 00:42:34 -0400
Subject: [PATCH 0232/1120] DOC: Update documentation for Meson change

---
 .gitignore                                    |  7 +-
 .../next_api_changes/development/26621-ES.rst | 46 +++++++++++++
 doc/devel/contribute.rst                      |  7 +-
 doc/devel/dependencies.rst                    | 67 +++++++++----------
 doc/devel/development_setup.rst               | 34 +++++-----
 doc/devel/min_dep_policy.rst                  |  2 +-
 doc/users/faq.rst                             | 14 ++--
 lib/matplotlib/__init__.py                    |  8 +--
 meson_options.txt                             | 18 ++---
 requirements/doc/doc-requirements.txt         |  2 +-
 src/_qhull_wrapper.cpp                        |  2 +-
 11 files changed, 126 insertions(+), 81 deletions(-)
 create mode 100644 doc/api/next_api_changes/development/26621-ES.rst

diff --git a/.gitignore b/.gitignore
index a76efc1cd47a..1514710bd9be 100644
--- a/.gitignore
+++ b/.gitignore
@@ -29,10 +29,10 @@
 
 # Python files #
 ################
-# setup.py working directory
+# meson-python working directory
 build
 
-# setup.py dist directory
+# meson-python/build frontend dist directory
 dist
 # Egg metadata
 *.egg-info
@@ -41,9 +41,6 @@ dist
 pip-wheel-metadata/*
 # tox testing tool
 .tox
-mplsetup.cfg
-# generated by setuptools_scm
-lib/matplotlib/_version.py
 # build subproject files
 subprojects/*/
 !subprojects/packagefiles/
diff --git a/doc/api/next_api_changes/development/26621-ES.rst b/doc/api/next_api_changes/development/26621-ES.rst
new file mode 100644
index 000000000000..ff87f53b3573
--- /dev/null
+++ b/doc/api/next_api_changes/development/26621-ES.rst
@@ -0,0 +1,46 @@
+Build system ported to Meson
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The build system of Matplotlib has been ported from setuptools to `meson-python
+<https://meson-python.readthedocs.io>`_ and `Meson <https://mesonbuild.com>`_.
+Consequently, there have been a few changes for development and packaging purposes.
+
+1. Installation by ``pip`` of packages with ``pyproject.toml`` use `build isolation
+   <https://pip.pypa.io/en/stable/reference/build-system/pyproject-toml/#build-isolation>`_
+   by default, which interferes with editable installation. Thus for developers using
+   editable installs, it is now necessary to pass the ``--no-build-isolation`` flag to
+   ``pip install``. This means that all build-time requirements must be available in the
+   environment for an editable install.
+2. Build configuration has moved from a custom :file:`mplsetup.cfg` (also configurable
+   via ``MPLSETUP`` environment variable) to Meson options. These may be specified using
+   `meson-python's build config settings
+   <https://meson-python.readthedocs.io/en/stable/how-to-guides/config-settings.html>`_
+   for ``setup-args``. See :file:`meson_options.txt` for all options. For example, a
+   :file:`mplsetup.cfg` containing the following::
+
+      [rc_options]
+      backend=Agg
+
+      [libs]
+      system_qhull = True
+
+   may be replaced by passing the following arguments to ``pip``::
+
+      --config-settings=setup-args="-DrcParams-backend=Agg" \
+      --config-settings=setup-args="-Dsystem-qhull=true"
+
+   Note that you must use ``pip`` >= 23.1 in order to pass more than one setting.
+3. Relatedly, Meson's `builtin options <https://mesonbuild.com/Builtin-options.html>`_
+   are now used instead of custom options, e.g., the LTO option is now ``b_lto``.
+4. On Windows, Meson activates a Visual Studio environment automatically. However, it
+   will not do so if another compiler is available. See `Meson's documentation
+   <https://mesonbuild.com/Builtin-options.html#details-for-vsenv>`_ if you wish to
+   change the priority of chosen compilers.
+5. Installation of test data was previously controlled by :file:`mplsetup.cfg`, but has
+   now been moved to Meson's install tags. To install test data, add the ``tests``
+   tag to the requested install (be sure to include the existing tags as below)::
+
+      --config-settings=install-args="--tags=data,python-runtime,runtime,tests"
+6. Checking typing stubs with ``stubtest`` does not work easily with editable install.
+   For the time being, we suggest using a normal (non-editable) install if you wish to
+   run ``stubtest``.
diff --git a/doc/devel/contribute.rst b/doc/devel/contribute.rst
index 85c061b7ce8f..976e03c97776 100644
--- a/doc/devel/contribute.rst
+++ b/doc/devel/contribute.rst
@@ -266,7 +266,7 @@ A brief overview of the workflow is as follows.
 
 #. Install the local version of Matplotlib with::
 
-     python -m pip install -e .
+     python -m pip install --no-build-isolation --editable .[dev]
 
    See :ref:`installing_for_devs` for detailed instructions.
 
@@ -476,9 +476,8 @@ take particular care when adding new API:
 New modules and files: installation
 -----------------------------------
 
-* If you have added new files or directories, or reorganized existing
-  ones, make sure the new files are included in the match patterns in
-  in *package_data* in :file:`setupext.py`.
+* If you have added new files or directories, or reorganized existing ones, make sure the
+  new files are included in the :file:`meson.build` in the corresponding directories.
 * New modules *may* be typed inline or using parallel stub file like existing modules.
 
 C/C++ extensions
diff --git a/doc/devel/dependencies.rst b/doc/devel/dependencies.rst
index 400bc63d42ac..77df6e494d50 100644
--- a/doc/devel/dependencies.rst
+++ b/doc/devel/dependencies.rst
@@ -100,7 +100,8 @@ Matplotlib brings its own copies of the following libraries:
 Additionally, Matplotlib depends on:
 
 - FreeType_ (>= 2.3): a font rendering library
-- QHull_ (>= 2020.2): a library for computing triangulations
+- QHull_ (>= 8.0.2): a library for computing triangulations (note that this version is
+  also known as 2020.2)
 
 .. _FreeType: https://www.freetype.org/
 .. _Qhull: http://www.qhull.org/
@@ -113,24 +114,16 @@ defaults to the system version of FreeType on AIX.
 Use system libraries
 ^^^^^^^^^^^^^^^^^^^^
 
-To force Matplotlib to use a copy of FreeType or Qhull already installed in
-your system, create a :file:`mplsetup.cfg` file with the following contents:
-
-.. code-block:: cfg
-
-   [libs]
-   system_freetype = true
-   system_qhull = true
-
-before running
+To force Matplotlib to use a copy of FreeType or Qhull already installed in your system,
+you must `pass configuration settings to Meson via meson-python
+<https://meson-python.readthedocs.io/en/stable/how-to-guides/config-settings.html>`_:
 
 .. code-block:: sh
 
-   python -m pip install .
-
-
-You can also use the :envvar:`MPLSETUPCFG` to specify the path to a cfg file when
-installing from pypi.
+   python -m pip install \
+     --config-settings=setup-args="-Dsystem-freetype=true" \
+     --config-settings=setup-args="-Dsystem-qhull=true" \
+     .
 
 
 In this case, you need to install the FreeType and Qhull library and headers.
@@ -187,18 +180,12 @@ remember to clear your artifacts before re-building::
 Manual Download
 ^^^^^^^^^^^^^^^
 
-
-If the automatic download does not work (for example on air-gapped systems) it
-is preferable to instead use system libraries.  However you can manually
-download and unpack the tarballs into::
-
-  build/freetype-2.6.1  # on all platforms but windows ARM64
-  build/freetype-2.11.1 # on windows ARM64
-  build/qhull-2020.2
-
-at the top level of the checkout repository.  The expected sha256 hashes of
-the downloaded tarballs is in :file:`setupext.py` if you wish to verify
-before unpacking.
+If the automatic download does not work (for example, on air-gapped systems) it is
+preferable to instead use system libraries. However you can manually download the
+tarballs into :file:`subprojects/packagecache` at the top level of the checkout
+repository. The expected SHA256 hashes of the downloaded tarballs are in
+:file:`subprojects/*.wrap` if you wish to verify them, but they will also be checked by
+the build system before unpacking.
 
 
 Minimum pip / manylinux support (linux)
@@ -207,7 +194,7 @@ Minimum pip / manylinux support (linux)
 Matplotlib publishes `manylinux wheels <https://github.com/pypa/manylinux>`_
 which have a minimum version of pip which will recognize the wheels
 
-- Python 3.9+: ``manylinx2014`` / pip >= 19.3
+- Python 3.9+: ``manylinux2014`` / pip >= 19.3
 
 In all cases the required version of pip is embedded in the CPython source.
 
@@ -223,12 +210,18 @@ Dependencies for building Matplotlib
 Setup dependencies
 ------------------
 
-- `certifi <https://pypi.org/project/certifi/>`_ (>= 2020.06.20).  Used while
-  downloading the freetype and QHull source during build.  This is not a
-  runtime dependency.
+By default, ``pip`` will build packages using build isolation, and the following
+dependencies will be automatically installed in the isolated environment to build
+Matplotlib. However, for development, you may wish to make an editable install, which
+will require disabling build isolation, so these build dependencies should be installed
+in your target environment manually:
+
+- `meson-python <https://meson-python.readthedocs.io/>`_ (>= 0.13.1).
+- `ninja <https://ninja-build.org/>`_ (>= 1.8.2). This may be available in your package
+  manager or bundled with Meson, but may be installed via ``pip`` if otherwise not
+  available.
 - `PyBind11 <https://pypi.org/project/pybind11/>`_ (>= 2.6). Used to connect C/C++ code
   with Python.
-- `setuptools <https://pypi.org/project/setuptools/>`_ (>= 64).
 - `setuptools_scm <https://pypi.org/project/setuptools-scm/>`_ (>= 7).  Used to
   update the reported ``mpl.__version__`` based on the current git commit.
   Also a runtime dependency for editable installs.
@@ -288,8 +281,6 @@ Xcode, VS Code or Linux package manager. Choose **one** compiler from this list:
      - Linux, macOS, Windows
      - `gcc 4.8.1 <https://gcc.gnu.org/projects/cxx-status.html#cxx11>`_,
        `GCC: Binaries <https://gcc.gnu.org/install/binaries.html>`_,
-
-       For gcc <6.5 you will need to set ``$CFLAGS=-std=c++11`` to enable C++11 support.
    * - Clang (LLVM)
      - **3.3**
      - Linux, macOS
@@ -330,8 +321,8 @@ testing the following will be used if they are installed.
 - pytest-xvfb_ to run tests without windows popping up (Linux)
 - pytz_ used to test pytz int
 - sphinx_ used to test our sphinx extensions
-- WenQuanYi Zen Hei and `Noto Sans CJK <https://fonts.google.com/noto/use>`_
-  fonts for testing font fallback and non-western fonts
+- `WenQuanYi Zen Hei`_ and `Noto Sans CJK`_ fonts for testing font fallback and
+  non-Western fonts
 - xarray_ used to test compatibility with xarray
 
 If any of these dependencies are not discovered, then the tests that rely on
@@ -359,6 +350,8 @@ them will be skipped by pytest.
 .. _pytest-xvfb: https://pypi.org/project/pytest-xvfb/
 .. _pytest: http://doc.pytest.org/en/latest/
 .. _sphinx: https://pypi.org/project/Sphinx/
+.. _WenQuanYi Zen Hei: http://wenq.org/en/
+.. _Noto Sans CJK: https://fonts.google.com/noto/use
 .. _xarray: https://pypi.org/project/xarray/
 
 
diff --git a/doc/devel/development_setup.rst b/doc/devel/development_setup.rst
index 8537e1229df4..0e7db431163f 100644
--- a/doc/devel/development_setup.rst
+++ b/doc/devel/development_setup.rst
@@ -157,34 +157,36 @@ must be installed separately. For a full list, see :ref:`dependencies`.
 Install Matplotlib in editable mode
 ===================================
 
-Install Matplotlib in editable mode from the :file:`matplotlib` directory
-using the command ::
+Install Matplotlib in editable mode from the :file:`matplotlib` directory using the
+command ::
 
-    python -m pip install -ve .
+    python -m pip install --verbose --no-build-isolation --editable .[dev]
 
-The 'editable/develop mode', builds everything and places links in your Python
-environment so that Python will be able to import Matplotlib from your
-development source directory.  This allows you to import your modified version
-of Matplotlib without re-installing after every change. Note that this is only
-true for ``*.py`` files.  If you change the C-extension source (which might
-also happen if you change branches) you will have to re-run
-``python -m pip install -ve .``
+The 'editable/develop mode' builds everything and places links in your Python environment
+so that Python will be able to import Matplotlib from your development source directory.
+This allows you to import your modified version of Matplotlib without re-installing after
+every change. Note that before the merging of the `Meson port
+<https://github.com/matplotlib/matplotlib/pull/26621>`_, this is only true for ``*.py``
+files. If you change the C-extension source based on a commit before the change to the
+Meson build system (which might also happen if you change branches), you will have to
+re-run the above command.
 
 Verify the Installation
 =======================
 
-Run the following command to make sure you have correctly installed Matplotlib in editable mode.
-The command should be run when the virtual environment is activated ::
+Run the following command to make sure you have correctly installed Matplotlib in
+editable mode. The command should be run when the virtual environment is activated::
 
     python -c "import matplotlib; print(matplotlib.__file__)"
 
 This command should return : ``<matplotlib_local_repo>\lib\matplotlib\__init__.py``
 
-We encourage you to run tests and build docs to verify that the code installed correctly and that the docs build cleanly,
-so that when you make code or document related changes you are aware of the existing issues beforehand.
+We encourage you to run tests and build docs to verify that the code installed correctly
+and that the docs build cleanly, so that when you make code or document related changes
+you are aware of the existing issues beforehand.
 
-   * Run test cases to verify installation :ref:`testing`
-   * Verify documentation build :ref:`documenting-matplotlib`
+* Run test cases to verify installation :ref:`testing`
+* Verify documentation build :ref:`documenting-matplotlib`
 
 Install pre-commit hooks
 ========================
diff --git a/doc/devel/min_dep_policy.rst b/doc/devel/min_dep_policy.rst
index 475985992bbc..dd8e069f0b94 100644
--- a/doc/devel/min_dep_policy.rst
+++ b/doc/devel/min_dep_policy.rst
@@ -22,7 +22,7 @@ Matplotlib supports:
 - All minor versions of ``numpy`` released in the 24 months prior
   to the project, and at minimum the last three minor versions.
 
-In ``setup.py``, the ``python_requires`` variable should be set to
+In :file:`pyproject.toml`, the ``requires-python`` variable should be set to
 the minimum supported version of Python.  All supported minor
 versions of Python should be in the test matrix and have binary
 artifacts built for the release.
diff --git a/doc/users/faq.rst b/doc/users/faq.rst
index c4e133d56d73..42747c814f94 100644
--- a/doc/users/faq.rst
+++ b/doc/users/faq.rst
@@ -355,17 +355,23 @@ provide the following information in your e-mail to the `mailing list
 
 If you compiled Matplotlib yourself, please also provide:
 
-* any changes you have made to ``setup.py`` or ``setupext.py``.
+* your compiler version -- e.g., ``gcc --version``.
 * the output of::
 
-     rm -rf build
-     python setup.py build
+     pip install --verbose
 
   The beginning of the build output contains lots of details about your
   platform that are useful for the Matplotlib developers to diagnose your
   problem.
 
-* your compiler version -- e.g., ``gcc --version``.
+If you compiled an older version of Matplotlib using the pre-Meson build system, instead
+provide:
+
+* any changes you have made to ``setup.py``/``setupext.py``,
+* the output of::
+
+     rm -rf build
+     python setup.py build
 
 Including this information in your first e-mail to the mailing list
 will save a lot of time.
diff --git a/lib/matplotlib/__init__.py b/lib/matplotlib/__init__.py
index 821d1bdeb5ea..0cdfa43b40d1 100644
--- a/lib/matplotlib/__init__.py
+++ b/lib/matplotlib/__init__.py
@@ -1307,8 +1307,8 @@ def _val_or_rc(val, rc_name):
 
 
 def _init_tests():
-    # The version of FreeType to install locally for running the
-    # tests.  This must match the value in `setupext.py`
+    # The version of FreeType to install locally for running the tests. This must match
+    # the value in `meson.build`.
     LOCAL_FREETYPE_VERSION = '2.6.1'
 
     from matplotlib import ft2font
@@ -1316,8 +1316,8 @@ def _init_tests():
             ft2font.__freetype_build_type__ != 'local'):
         _log.warning(
             f"Matplotlib is not built with the correct FreeType version to "
-            f"run tests.  Rebuild without setting system_freetype=1 in "
-            f"mplsetup.cfg.  Expect many image comparison failures below.  "
+            f"run tests.  Rebuild without setting system-freetype=true in "
+            f"Meson setup options.  Expect many image comparison failures below.  "
             f"Expected freetype version {LOCAL_FREETYPE_VERSION}.  "
             f"Found freetype version {ft2font.__freetype_version__}.  "
             "Freetype build type is {}local".format(
diff --git a/meson_options.txt b/meson_options.txt
index ed753bb26854..77f2b5ec22de 100644
--- a/meson_options.txt
+++ b/meson_options.txt
@@ -1,18 +1,20 @@
+# Options may be set by passing through `pip` or `build` via meson-python:
+# https://meson-python.readthedocs.io/en/stable/how-to-guides/config-settings.html
+
 # By default, Matplotlib downloads and builds its own copies of FreeType and of
-# Qhull.  You may set the following to True to instead link against a system
-# FreeType/Qhull.  As an exception, Matplotlib defaults to the system version
-# of FreeType on AIX.
+# Qhull. You may use the following options to instead link against a system
+# FreeType/Qhull. As an exception, Matplotlib defaults to the system version of
+# FreeType on AIX.
 option('system-freetype', type: 'boolean', value: false,
        description: 'Build against system version of FreeType')
 option('system-qhull', type: 'boolean', value: false,
        description: 'Build against system version of Qhull')
 
 # Some of Matplotlib's components are optional: the MacOSX backend (installed
-# by default on MacOSX; requires the Cocoa headers included with XCode), and
-# the test data (i.e., the baseline image files; not installed by default). You
-# can control whether they are installed by uncommenting the following lines.
-# Note that the MacOSX backend is never built on Linux or Windows, regardless
-# of the config value.
+# by default on MacOSX; requires the Cocoa headers included with XCode). You
+# can control whether they are installed using the following options. Note that
+# the MacOSX backend is never built on Linux or Windows, regardless of the
+# config value.
 option('macosx', type: 'boolean', value: true,
        description: 'Enable MacOSX backend (requires Cocoa)')
 
diff --git a/requirements/doc/doc-requirements.txt b/requirements/doc/doc-requirements.txt
index c0b4a19e3dd3..f60e9addf47b 100644
--- a/requirements/doc/doc-requirements.txt
+++ b/requirements/doc/doc-requirements.txt
@@ -2,7 +2,7 @@
 #
 # You will first need a matching Matplotlib installation
 # e.g (from the Matplotlib root directory)
-#     pip install -e .
+#     pip install --no-build-isolation --editable .[dev]
 #
 # Install the documentation requirements with:
 #     pip install -r requirements/doc/doc-requirements.txt
diff --git a/src/_qhull_wrapper.cpp b/src/_qhull_wrapper.cpp
index 7e4f306305b8..ef374d8e42c0 100644
--- a/src/_qhull_wrapper.cpp
+++ b/src/_qhull_wrapper.cpp
@@ -162,7 +162,7 @@ delaunay_impl(npy_intp npoints, const double* x, const double* y,
     if (hide_qhull_errors) {
         /* qhull errors are ignored by writing to OS-equivalent of /dev/null.
          * Rather than have OS-specific code here, instead it is determined by
-         * setupext.py and passed in via the macro MPL_DEVNULL. */
+         * meson.build and passed in via the macro MPL_DEVNULL. */
         error_file = fopen(STRINGIFY(MPL_DEVNULL), "w");
         if (error_file == NULL) {
             throw std::runtime_error("Could not open devnull");

From 01c1ff610fe89c1425666465b9dc044ffb9dd563 Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Wed, 27 Sep 2023 15:59:16 -0400
Subject: [PATCH 0233/1120] ci: Pin NumPy on Cygwin build

Cherry-picked out of #26800; also unpin setuptools.
---
 .github/workflows/cygwin.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/cygwin.yml b/.github/workflows/cygwin.yml
index feded9f0c1ad..6968d7afb4f5 100644
--- a/.github/workflows/cygwin.yml
+++ b/.github/workflows/cygwin.yml
@@ -174,8 +174,8 @@ jobs:
       - name: Install Python dependencies
         shell: bash.exe -eo pipefail -o igncr "{0}"
         run: |
-          python -m pip install --upgrade pip 'setuptools<60' wheel
-          python -m pip install kiwisolver 'numpy!=1.21.*' pillow importlib_resources
+          python -m pip install --upgrade pip setuptools wheel
+          python -m pip install kiwisolver 'numpy>=1.22,<1.26' pillow importlib_resources
           grep -v -F -e psutil requirements/testing/all.txt >requirements_test.txt
           python -m pip install meson-python pybind11
           export PATH="/usr/local/bin:$PATH"

From 15362458ce3a1a7a7106fdbbde140e037e67ac0d Mon Sep 17 00:00:00 2001
From: Anvi Verma <114463178+AnviVerma27@users.noreply.github.com>
Date: Wed, 4 Oct 2023 22:01:04 +0530
Subject: [PATCH 0234/1120] user/project/citing updated (#26995)

update citing.rst formatting
---
 doc/users/project/citing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/users/project/citing.rst b/doc/users/project/citing.rst
index 2230ecf1463c..77a7449b356e 100644
--- a/doc/users/project/citing.rst
+++ b/doc/users/project/citing.rst
@@ -25,7 +25,7 @@ specific DOI from the list below, referring to the version used for your publica
    :target: https://doi.org/10.5281/zenodo.592536
 
 By version
-~~~~~~~~~~
+^^^^^^^^^^
 .. START OF AUTOGENERATED
 
 

From 500c5f28798c9dcd6cc9a23d53a4f435d870c736 Mon Sep 17 00:00:00 2001
From: Jody Klymak <jklymak@gmail.com>
Date: Mon, 2 Oct 2023 08:36:50 -0700
Subject: [PATCH 0235/1120] DOC: add units to user/explain [ci doc]

---
 .../examples/ticks/date_concise_formatter.py  |   2 +
 .../ticks/date_formatters_locators.py         |   2 +
 galleries/examples/units/basic_units.py       |   2 +
 galleries/users_explain/axes/axes_units.py    | 278 ++++++++++++++++++
 galleries/users_explain/axes/index.rst        |   1 +
 5 files changed, 285 insertions(+)
 create mode 100644 galleries/users_explain/axes/axes_units.py

diff --git a/galleries/examples/ticks/date_concise_formatter.py b/galleries/examples/ticks/date_concise_formatter.py
index f757fc4fbe09..540ebf0e56c1 100644
--- a/galleries/examples/ticks/date_concise_formatter.py
+++ b/galleries/examples/ticks/date_concise_formatter.py
@@ -1,4 +1,6 @@
 """
+.. _date_concise_formatter:
+
 ================================================
 Formatting date ticks using ConciseDateFormatter
 ================================================
diff --git a/galleries/examples/ticks/date_formatters_locators.py b/galleries/examples/ticks/date_formatters_locators.py
index e500f2e90abc..39492168242f 100644
--- a/galleries/examples/ticks/date_formatters_locators.py
+++ b/galleries/examples/ticks/date_formatters_locators.py
@@ -1,4 +1,6 @@
 """
+.. _date_formatters_locators:
+
 =================================
 Date tick locators and formatters
 =================================
diff --git a/galleries/examples/units/basic_units.py b/galleries/examples/units/basic_units.py
index e9b5d18ef340..0b493ab7216c 100644
--- a/galleries/examples/units/basic_units.py
+++ b/galleries/examples/units/basic_units.py
@@ -1,4 +1,6 @@
 """
+.. _basic_units:
+
 ===========
 Basic Units
 ===========
diff --git a/galleries/users_explain/axes/axes_units.py b/galleries/users_explain/axes/axes_units.py
new file mode 100644
index 000000000000..cfc6d787ca74
--- /dev/null
+++ b/galleries/users_explain/axes/axes_units.py
@@ -0,0 +1,278 @@
+"""
+.. _user_axes_units:
+
+=========================================
+Plotting beyond floats: dates and strings
+=========================================
+
+The most basic way to use Matplotlib plotting methods is to pass coordinates in
+as numerical numpy arrays.  For example, ``plot(x, y)`` will work if ``x`` and
+``y`` are numpy arrays of floats (or integers).  Plotting methods will also
+work if `numpy.asarray` will convert ``x`` and ``y`` to an array of floating
+point numbers; e.g. ``x`` could be a python list.
+
+Matplotlib also has the ability to convert other data types if a "unit
+converter" exists for the data type.  Matplotlib has two built-in converters,
+one for dates and the other for lists of strings.  Other downstream libraries
+have their own converters to handle their data types.
+
+The method to add converters to Matplotlib is described in `matplotlib.units`.
+Here we briefly overview the built-in date and string converters.
+
+Date conversion
+===============
+
+If ``x`` and/or ``y`` are a list of `datetime` or an array of
+`numpy.datetime64`, Matplotlib has a built in converter that will convert the
+datetime to a float, and add locators and formatters to the axis that are
+appropriate for dates.
+
+In the following example, the x-axis gains a converter that converts from
+`numpy.datetime64` to float, and a locator that put ticks at the beginning of
+the month, and a formatter that label the ticks appropriately:
+"""
+
+import numpy as np
+
+import matplotlib.dates as mdates
+import matplotlib.units as munits
+
+import matplotlib.pyplot as plt
+
+fig, ax = plt.subplots(figsize=(5.4, 2), layout='constrained')
+time = np.arange('1980-01-01', '1980-06-25', dtype='datetime64[D]')
+x = np.arange(len(time))
+ax.plot(time, x)
+
+# %%
+#
+# Note that if we try to plot a float on the x-axis, it will be plotted in
+# units of days since the "epoch" for the converter, in this case 1970-01-01
+# (see :ref:`date-format`).  So when we plot the value 0, the ticks start at
+# 1970-01-01, and note that the locator now chooses every two years for a tick
+# instead of every month:
+
+fig, ax = plt.subplots(figsize=(5.4, 2), layout='constrained')
+time = np.arange('1980-01-01', '1980-06-25', dtype='datetime64[D]')
+x = np.arange(len(time))
+ax.plot(time, x)
+# 0 gets labeled as 1970-01-01
+ax.plot(0, 0, 'd')
+ax.text(0, 0, ' Float x=0', rotation=45)
+
+
+# %%
+#
+# We can customize the locator and the formatter; see :ref:`date-locators` and
+# :ref:`date-formatters` for a complete list, and
+# :ref:`date_formatters_locators` for examples of them in use.  Here we locate
+# by every second month, and format just with the month's 3-letter name using
+# ``"%b"`` (see `~datetime.datetime.strftime` for format codes):
+
+fig, ax = plt.subplots(figsize=(5.4, 2), layout='constrained')
+time = np.arange('1980-01-01', '1980-06-25', dtype='datetime64[D]')
+x = np.arange(len(time))
+ax.plot(time, x)
+ax.xaxis.set_major_locator(mdates.MonthLocator(bymonth=np.arange(1, 13, 2)))
+ax.xaxis.set_major_formatter(mdates.DateFormatter('%b'))
+ax.set_xlabel('1980')
+
+# %%
+#
+# The default locator is the `~.dates.AutoDateLocator`, and the default
+# Formatter `~.dates.AutoDateFormatter`.  There is also a "concise"
+# formatter/locator that gives a more compact labelling, and can be set via
+# rcParams.  Note how instead of the redundant "Jan" label at the start of the
+# year, "1980" is used instead.  See :ref:`date_concise_formatter` for more
+# examples.
+
+plt.rcParams['date.converter'] = 'concise'
+
+fig, ax = plt.subplots(figsize=(5.4, 2), layout='constrained')
+time = np.arange('1980-01-01', '1980-06-25', dtype='datetime64[D]')
+x = np.arange(len(time))
+ax.plot(time, x)
+
+# %%
+#
+# We can set the limits on the axis either by passing the appropriate dates in
+# or by passing a floating point value in the proper units of floating days
+# since the epoch.  We can get this value from `~.dates.date2num`.
+
+fig, axs = plt.subplots(2, 1, figsize=(5.4, 3), layout='constrained')
+for ax in axs.flat:
+    time = np.arange('1980-01-01', '1980-06-25', dtype='datetime64[D]')
+    x = np.arange(len(time))
+    ax.plot(time, x)
+
+# set xlim using datetime64:
+axs[0].set_xlim(np.datetime64('1980-02-01'), np.datetime64('1980-04-01'))
+
+# set xlim using floats:
+# Note can get from mdates.date2num(np.datetime64('1980-02-01'))
+axs[1].set_xlim(3683, 3683+60)
+
+# %%
+#
+# String conversion: categorical plots
+# ====================================
+#
+# Sometimes we want to label categories on an axis rather than numbers.
+# Matplotlib allows this using a "categorical" converter (see
+# `~.matplotlib.category`).
+
+data = {'apple': 10, 'orange': 15, 'lemon': 5, 'lime': 20}
+names = list(data.keys())
+values = list(data.values())
+
+fig, axs = plt.subplots(1, 3, figsize=(7, 3), sharey=True, layout='constrained')
+axs[0].bar(names, values)
+axs[1].scatter(names, values)
+axs[2].plot(names, values)
+fig.suptitle('Categorical Plotting')
+
+# %%
+#
+# Note that the "categories" are plotted in the order that they are first
+# specified and that subsequent plotting in a different order will not affect
+# the original order.  Further, new additions will be added on the end:
+
+fig, ax = plt.subplots(figsize=(5, 3), layout='constrained')
+ax.bar(names, values)
+
+# plot in a different order:
+ax.scatter(['lemon', 'apple'], [7, 12])
+
+# add a new category, and out of order:
+ax.plot(['pear', 'orange', 'apple', 'lemon'], [13, 10, 7, 12], color='C1')
+
+
+# %%
+#
+# Note that when using ``plot`` like in the above, the order of the plotting is
+# mapped onto the original order of the data, so the new line goes in the order
+# specified.
+#
+# The category converter maps from categories to integers, starting at zero. So
+# data can also be manually added to the axis using a float.  However, note
+# that a float that is not a category will not get a label.
+
+fig, ax = plt.subplots(figsize=(5, 3), layout='constrained')
+ax.bar(names, values)
+
+# 0 gets labeled as "apple"
+ax.plot(0, 0, 'd', color='C1')
+ax.text(0, 0, '  Float x=0', rotation=45, color='C1')
+
+# 2 gets labeled as "lemon"
+ax.plot(2, 0, 'd', color='C1')
+ax.text(2, 0, '  Float x=2', rotation=45, color='C1')
+
+# 4 doesn't get a label
+ax.plot(4, 0, 'd', color='C1')
+ax.text(4, 0, '  Float x=4', rotation=45, color='C1')
+
+# 2.5 doesn't get a label
+ax.plot(2.5, 0, 'd', color='C1')
+ax.text(2.5, 0, '  Float x=2.5', rotation=45, color='C1')
+
+
+# %%
+#
+# Setting the limits for a category axis can be done by specifying the
+# categories, or by specifying floating point numbers:
+
+fig, axs = plt.subplots(2, 1, figsize=(5, 5), layout='constrained')
+ax = axs[0]
+ax.bar(names, values)
+ax.set_xlim('orange', 'lemon')
+ax.set_xlabel('limits set with categories')
+ax = axs[1]
+ax.bar(names, values)
+ax.set_xlim(0.5, 2.5)
+ax.set_xlabel('limits set with floats')
+
+# %%
+#
+# The category axes are helpful for some plot types, but can lead to confusion
+# if data is read in as a list of strings, even if it is meant to be a list of
+# floats or dates.  This sometimes happens when reading comma-separated value
+# (CSV) files. The categorical locator and formatter will put a tick at every
+# string value and label each one as well:
+
+fig, ax = plt.subplots(figsize=(5.4, 2.5), layout='constrained')
+x = [str(xx) for xx in np.arange(100)]  # list of strings
+ax.plot(x, np.arange(100))
+ax.set_xlabel('x is list of strings')
+
+# %%
+#
+# If this is not desired, then simply convert the data to floats before plotting:
+
+fig, ax = plt.subplots(figsize=(5.4, 2.5), layout='constrained')
+x = np.asarray(x, dtype='float')  # array of float.
+ax.plot(x, np.arange(100))
+ax.set_xlabel('x is array of floats')
+
+# %%
+#
+# Determine converter, formatter, and locator on an axis
+# ======================================================
+#
+# Sometimes it is helpful to be able to debug what Matplotlib is using to
+# convert the incoming data: we can do that by querying the ``converter``
+# property on the axis.  We can also query the formatters and locators using
+# `~.axis.Axis.get_major_locator` and `~.axis.Axis.get_major_formatter`.
+#
+# Note that by default the converter is *None*.
+
+fig, axs = plt.subplots(3, 1, figsize=(6.4, 7), layout='constrained')
+x = np.arange(100)
+ax = axs[0]
+ax.plot(x, x)
+label = f'Converter: {ax.xaxis.converter}\n '
+label += f'Locator: {ax.xaxis.get_major_locator()}\n'
+label += f'Formatter: {ax.xaxis.get_major_formatter()}\n'
+ax.set_xlabel(label)
+
+ax = axs[1]
+time = np.arange('1980-01-01', '1980-06-25', dtype='datetime64[D]')
+x = np.arange(len(time))
+ax.plot(time, x)
+label = f'Converter: {ax.xaxis.converter}\n '
+label += f'Locator: {ax.xaxis.get_major_locator()}\n'
+label += f'Formatter: {ax.xaxis.get_major_formatter()}\n'
+ax.set_xlabel(label)
+
+ax = axs[2]
+data = {'apple': 10, 'orange': 15, 'lemon': 5, 'lime': 20}
+names = list(data.keys())
+values = list(data.values())
+ax.plot(names, values)
+label = f'Converter: {ax.xaxis.converter}\n '
+label += f'Locator: {ax.xaxis.get_major_locator()}\n'
+label += f'Formatter: {ax.xaxis.get_major_formatter()}\n'
+ax.set_xlabel(label)
+
+# %%
+#
+# General unit support
+# ====================
+#
+# The support for dates and categories is part of "units" support that is
+# built into Matplotlib.  This is described at `.matplotlib.units` and in the #
+# :ref:`basic_units` example.
+#
+# Unit support works by querying the type of data passed to the plotting
+# function and dispatching to the first converter in a list that accepts that
+# type of data.  So below, if ``x`` has ``datetime`` objects in it, the
+# converter will be ``_SwitchableDateConverter``; if it has has strings in it,
+# it will be sent to the ``StrCategoryConverter``.
+
+for k in munits.registry:
+    print(f"type: {k};\n    converter: {munits.registry[k]}")
+
+# %%
+#
+# Downstream libraries like pandas, astropy, and pint all can add their own
+# converters to Matplotlib.
diff --git a/galleries/users_explain/axes/index.rst b/galleries/users_explain/axes/index.rst
index 3d0a67ca14e7..f0e14f8e3923 100644
--- a/galleries/users_explain/axes/index.rst
+++ b/galleries/users_explain/axes/index.rst
@@ -43,6 +43,7 @@ annotations like x- and y-labels, titles, and legends.
 
     axes_scales
     axes_ticks
+    axes_units
     Legends <legend_guide>
     Subplot mosaic <mosaic>
 

From feb602a4edd7bc83cfee073426dfc485207d1c35 Mon Sep 17 00:00:00 2001
From: Jody Klymak <jklymak@gmail.com>
Date: Tue, 3 Oct 2023 19:20:48 -0700
Subject: [PATCH 0236/1120] DOC: add units to user/explain [ci doc]

---
 galleries/users_explain/axes/axes_units.py | 75 ++++++++++++----------
 1 file changed, 41 insertions(+), 34 deletions(-)

diff --git a/galleries/users_explain/axes/axes_units.py b/galleries/users_explain/axes/axes_units.py
index cfc6d787ca74..37b3b5a09ef6 100644
--- a/galleries/users_explain/axes/axes_units.py
+++ b/galleries/users_explain/axes/axes_units.py
@@ -23,9 +23,9 @@
 ===============
 
 If ``x`` and/or ``y`` are a list of `datetime` or an array of
-`numpy.datetime64`, Matplotlib has a built in converter that will convert the
-datetime to a float, and add locators and formatters to the axis that are
-appropriate for dates.
+`numpy.datetime64`, Matplotlib has a built-in converter that will convert the
+datetime to a float, and add tick locators and formatters to the axis that are
+appropriate for dates.  See `matplotlib.dates`.
 
 In the following example, the x-axis gains a converter that converts from
 `numpy.datetime64` to float, and a locator that put ticks at the beginning of
@@ -49,8 +49,8 @@
 # Note that if we try to plot a float on the x-axis, it will be plotted in
 # units of days since the "epoch" for the converter, in this case 1970-01-01
 # (see :ref:`date-format`).  So when we plot the value 0, the ticks start at
-# 1970-01-01, and note that the locator now chooses every two years for a tick
-# instead of every month:
+# 1970-01-01.  (The locator also now chooses every two years for a tick instead
+# of every month):
 
 fig, ax = plt.subplots(figsize=(5.4, 2), layout='constrained')
 time = np.arange('1980-01-01', '1980-06-25', dtype='datetime64[D]')
@@ -60,7 +60,6 @@
 ax.plot(0, 0, 'd')
 ax.text(0, 0, ' Float x=0', rotation=45)
 
-
 # %%
 #
 # We can customize the locator and the formatter; see :ref:`date-locators` and
@@ -80,11 +79,10 @@
 # %%
 #
 # The default locator is the `~.dates.AutoDateLocator`, and the default
-# Formatter `~.dates.AutoDateFormatter`.  There is also a "concise"
-# formatter/locator that gives a more compact labelling, and can be set via
-# rcParams.  Note how instead of the redundant "Jan" label at the start of the
-# year, "1980" is used instead.  See :ref:`date_concise_formatter` for more
-# examples.
+# Formatter `~.dates.AutoDateFormatter`.  There are also  "concise" formatter
+# and locators that give a more compact labelling, and can be set via rcParams.
+# Note how instead of the redundant "Jan" label at the start of the year,
+# "1980" is used instead.  See :ref:`date_concise_formatter` for more examples.
 
 plt.rcParams['date.converter'] = 'concise'
 
@@ -95,9 +93,10 @@
 
 # %%
 #
-# We can set the limits on the axis either by passing the appropriate dates in
-# or by passing a floating point value in the proper units of floating days
-# since the epoch.  We can get this value from `~.dates.date2num`.
+# We can set the limits on the axis either by passing the appropriate dates as
+# limits, or by passing a floating-point value in the proper units of days
+# since the epoch.  If we need it, we can get this value from
+# `~.dates.date2num`.
 
 fig, axs = plt.subplots(2, 1, figsize=(5.4, 3), layout='constrained')
 for ax in axs.flat:
@@ -135,7 +134,8 @@
 #
 # Note that the "categories" are plotted in the order that they are first
 # specified and that subsequent plotting in a different order will not affect
-# the original order.  Further, new additions will be added on the end:
+# the original order.  Further, new additions will be added on the end (see
+# "pear" below):
 
 fig, ax = plt.subplots(figsize=(5, 3), layout='constrained')
 ax.bar(names, values)
@@ -143,7 +143,7 @@
 # plot in a different order:
 ax.scatter(['lemon', 'apple'], [7, 12])
 
-# add a new category, and out of order:
+# add a new category, "pear", and put the other categories in a different order:
 ax.plot(['pear', 'orange', 'apple', 'lemon'], [13, 10, 7, 12], color='C1')
 
 
@@ -154,28 +154,34 @@
 # specified.
 #
 # The category converter maps from categories to integers, starting at zero. So
-# data can also be manually added to the axis using a float.  However, note
-# that a float that is not a category will not get a label.
+# data can also be manually added to the axis using a float.  Note that if a
+# float is passed in that does not have a "category" associated with it, the
+# data point can still be plotted, but a tick will not be created.  In the
+# following, we plot data at 4.0 and 2.5, but no tick is added there because
+# those are not categories.
 
 fig, ax = plt.subplots(figsize=(5, 3), layout='constrained')
 ax.bar(names, values)
+# arguments for styling the labels below:
+args = {'rotation': 70, 'color': 'C1',
+        'bbox': {'color': 'white', 'alpha': .7, 'boxstyle': 'round'}}
+
 
 # 0 gets labeled as "apple"
-ax.plot(0, 0, 'd', color='C1')
-ax.text(0, 0, '  Float x=0', rotation=45, color='C1')
+ax.plot(0, 2, 'd', color='C1')
+ax.text(0, 3, 'Float x=0', **args)
 
 # 2 gets labeled as "lemon"
-ax.plot(2, 0, 'd', color='C1')
-ax.text(2, 0, '  Float x=2', rotation=45, color='C1')
+ax.plot(2, 2, 'd', color='C1')
+ax.text(2, 3, 'Float x=2', **args)
 
 # 4 doesn't get a label
-ax.plot(4, 0, 'd', color='C1')
-ax.text(4, 0, '  Float x=4', rotation=45, color='C1')
+ax.plot(4, 2, 'd', color='C1')
+ax.text(4, 3, 'Float x=4', **args)
 
 # 2.5 doesn't get a label
-ax.plot(2.5, 0, 'd', color='C1')
-ax.text(2.5, 0, '  Float x=2.5', rotation=45, color='C1')
-
+ax.plot(2.5, 2, 'd', color='C1')
+ax.text(2.5, 3, 'Float x=2.5', **args)
 
 # %%
 #
@@ -220,7 +226,7 @@
 # ======================================================
 #
 # Sometimes it is helpful to be able to debug what Matplotlib is using to
-# convert the incoming data: we can do that by querying the ``converter``
+# convert the incoming data.  We can do that by querying the ``converter``
 # property on the axis.  We can also query the formatters and locators using
 # `~.axis.Axis.get_major_locator` and `~.axis.Axis.get_major_formatter`.
 #
@@ -256,11 +262,11 @@
 
 # %%
 #
-# General unit support
-# ====================
+# More about "unit" support
+# =========================
 #
-# The support for dates and categories is part of "units" support that is
-# built into Matplotlib.  This is described at `.matplotlib.units` and in the #
+# The support for dates and categories is part of "units" support that is built
+# into Matplotlib.  This is described at `.matplotlib.units` and in the
 # :ref:`basic_units` example.
 #
 # Unit support works by querying the type of data passed to the plotting
@@ -274,5 +280,6 @@
 
 # %%
 #
-# Downstream libraries like pandas, astropy, and pint all can add their own
-# converters to Matplotlib.
+# Downstream libraries like `pandas <https://pandas.pydata.org>`_,
+# `astropy <https://www.astropy.org>`_, `pint <https://pint.readthedocs.io>`_
+# and others supply their own converters that can be used with Matplotlib.

From b420c9d2fc087c59bd83c0be8c9036d52878c7c9 Mon Sep 17 00:00:00 2001
From: Jody Klymak <jklymak@gmail.com>
Date: Wed, 4 Oct 2023 15:38:19 -0700
Subject: [PATCH 0237/1120] DOC: add units to user/explain [ci doc]

---
 galleries/users_explain/axes/axes_units.py | 24 ++++++++++++++--------
 galleries/users_explain/axes/index.rst     |  1 -
 2 files changed, 16 insertions(+), 9 deletions(-)

diff --git a/galleries/users_explain/axes/axes_units.py b/galleries/users_explain/axes/axes_units.py
index 37b3b5a09ef6..6b486f007a12 100644
--- a/galleries/users_explain/axes/axes_units.py
+++ b/galleries/users_explain/axes/axes_units.py
@@ -1,9 +1,9 @@
 """
 .. _user_axes_units:
 
-=========================================
-Plotting beyond floats: dates and strings
-=========================================
+==========================
+Plotting dates and strings
+==========================
 
 The most basic way to use Matplotlib plotting methods is to pass coordinates in
 as numerical numpy arrays.  For example, ``plot(x, y)`` will work if ``x`` and
@@ -275,11 +275,19 @@
 # converter will be ``_SwitchableDateConverter``; if it has has strings in it,
 # it will be sent to the ``StrCategoryConverter``.
 
-for k in munits.registry:
-    print(f"type: {k};\n    converter: {munits.registry[k]}")
+for k, v in munits.registry.items():
+    print(f"type: {k};\n    converter: {type(v)}")
 
 # %%
 #
-# Downstream libraries like `pandas <https://pandas.pydata.org>`_,
-# `astropy <https://www.astropy.org>`_, `pint <https://pint.readthedocs.io>`_
-# and others supply their own converters that can be used with Matplotlib.
+# There are a number of downstream libraries that provide their own converters
+# with locators and formatters.  Physical unit support is provided by
+# `astropy <https://www.astropy.org>`_, `pint <https://pint.readthedocs.io>`_, and
+# `unyt <https://unyt.readthedocs.io>`_, among others.
+#
+# High level libraries like `pandas <https://pandas.pydata.org>`_ and
+# `nc-time-axis <https://nc-time-axis.readthedocs.io>`_ (and thus
+# `xarray <https://docs.xarray.dev>`_) provide their own datetime support.
+# This support can sometimes be incompatible with Matplotlib native datetime
+# support, so care should be taken when using Matplotlib locators and
+# formatters if these libraries are being used.
diff --git a/galleries/users_explain/axes/index.rst b/galleries/users_explain/axes/index.rst
index f0e14f8e3923..308a4d4ea208 100644
--- a/galleries/users_explain/axes/index.rst
+++ b/galleries/users_explain/axes/index.rst
@@ -24,7 +24,6 @@ annotations like x- and y-labels, titles, and legends.
                                 color='darkgrey')
     fig.suptitle('plt.subplots()')
 
-
 .. toctree::
     :maxdepth: 2
 

From 67878c2039512695073581b0156009f48b2c7afd Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Thu, 28 Sep 2023 20:06:40 +0200
Subject: [PATCH 0238/1120] Clarify that explicit ticklabels are used without
 further formatting.

This was not made explicit in the docs (it is in essence due to the use
of FixedFormatter, but that's a rather involved detail for end users).
Also minor rewordings.
---
 lib/matplotlib/axis.py | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/lib/matplotlib/axis.py b/lib/matplotlib/axis.py
index fa28597a9d08..e7f6724c4372 100644
--- a/lib/matplotlib/axis.py
+++ b/lib/matplotlib/axis.py
@@ -1961,8 +1961,9 @@ def set_ticklabels(self, labels, *, minor=False, fontdict=None, **kwargs):
         ----------
         labels : sequence of str or of `.Text`\s
             Texts for labeling each tick location in the sequence set by
-            `.Axis.set_ticks`; the number of labels must match the number of
-            locations.
+            `.Axis.set_ticks`; the number of labels must match the number of locations.
+            The labels are used as is, via a `.FixedFormatter` (without further
+            formatting).
 
         minor : bool
             If True, set minor ticks instead of major ticks.
@@ -2093,26 +2094,25 @@ def set_ticks(self, ticks, labels=None, *, minor=False, **kwargs):
         Parameters
         ----------
         ticks : 1D array-like
-            Array of tick locations.  The axis `.Locator` is replaced by a
-            `~.ticker.FixedLocator`.
+            Array of tick locations (either floats or in axis units). The axis
+            `.Locator` is replaced by a `~.ticker.FixedLocator`.
 
-            The values may be either floats or in axis units.
-
-            Pass an empty list to remove all ticks::
-
-                set_ticks([])
+            Pass an empty list (``set_ticks([])``) to remove all ticks.
 
             Some tick formatters will not label arbitrary tick positions;
             e.g. log formatters only label decade ticks by default. In
             such a case you can set a formatter explicitly on the axis
             using `.Axis.set_major_formatter` or provide formatted
             *labels* yourself.
+
         labels : list of str, optional
-            Tick labels for each location in *ticks*. *labels* must be of the same
-            length as *ticks*. If not set, the labels are generate using the axis
-            tick `.Formatter`.
+            Tick labels for each location in *ticks*; must have the same length as
+            *ticks*. If set, the labels are used as is, via a `.FixedFormatter`.
+            If not set, the labels are generated using the axis tick `.Formatter`.
+
         minor : bool, default: False
             If ``False``, set the major ticks; if ``True``, the minor ticks.
+
         **kwargs
             `.Text` properties for the labels. Using these is only allowed if
             you pass *labels*. In other cases, please use `~.Axes.tick_params`.

From 78904b65db2ac5baee6c891872447f0505ee912c Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Sat, 23 Sep 2023 11:28:51 +0200
Subject: [PATCH 0239/1120] Deprecate setting the timer interval while starting
 it.

This feature is unused internally and has simple replacements; removing
it will make it easier for subclasses to directly override Timer.start
rather than having Timer.start handle the interval and then deferring to
a private _timer_start.
---
 doc/api/next_api_changes/deprecations/26894-AL.rst | 6 ++++++
 lib/matplotlib/backend_bases.py                    | 1 +
 2 files changed, 7 insertions(+)
 create mode 100644 doc/api/next_api_changes/deprecations/26894-AL.rst

diff --git a/doc/api/next_api_changes/deprecations/26894-AL.rst b/doc/api/next_api_changes/deprecations/26894-AL.rst
new file mode 100644
index 000000000000..b156fa843917
--- /dev/null
+++ b/doc/api/next_api_changes/deprecations/26894-AL.rst
@@ -0,0 +1,6 @@
+*interval* parameter of ``TimerBase.start``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Setting the timer *interval* while starting it is deprecated.  The interval can
+be specified instead in the timer constructor, or by setting the
+``timer.interval`` attribute.
diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
index cdca80df0c82..a411cfbe3a4a 100644
--- a/lib/matplotlib/backend_bases.py
+++ b/lib/matplotlib/backend_bases.py
@@ -1117,6 +1117,7 @@ def __del__(self):
         """Need to stop timer and possibly disconnect timer."""
         self._timer_stop()
 
+    @_api.delete_parameter("3.9", "interval", alternative="timer.interval")
     def start(self, interval=None):
         """
         Start the timer object.

From eb6e233a85dc2227efef354a04b687ee87199673 Mon Sep 17 00:00:00 2001
From: Pradeep Reddy Raamana <raamana@gmail.com>
Date: Fri, 30 Mar 2018 14:37:00 -0400
Subject: [PATCH 0240/1120] Add clear methods for check and radio buttons

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Co-authored-by: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
---
 .../next_whats_new/widget_button_clear.rst    |  6 ++
 lib/matplotlib/tests/test_widgets.py          | 25 ++++-
 lib/matplotlib/widgets.py                     | 92 +++++++++++++++++--
 lib/matplotlib/widgets.pyi                    |  9 +-
 4 files changed, 119 insertions(+), 13 deletions(-)
 create mode 100644 doc/users/next_whats_new/widget_button_clear.rst

diff --git a/doc/users/next_whats_new/widget_button_clear.rst b/doc/users/next_whats_new/widget_button_clear.rst
new file mode 100644
index 000000000000..2d16cf281e7c
--- /dev/null
+++ b/doc/users/next_whats_new/widget_button_clear.rst
@@ -0,0 +1,6 @@
+Check and Radio Button widgets support clearing
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The `.CheckButtons` and `.RadioButtons` widgets now support clearing their
+state by calling their ``.clear`` method. Note that it is not possible to have
+no selected radio buttons, so the selected option at construction time is selected.
diff --git a/lib/matplotlib/tests/test_widgets.py b/lib/matplotlib/tests/test_widgets.py
index 3e41712ba530..de17bb79bd4b 100644
--- a/lib/matplotlib/tests/test_widgets.py
+++ b/lib/matplotlib/tests/test_widgets.py
@@ -1004,10 +1004,23 @@ def test_lasso_selector_set_props(ax):
 
 
 def test_CheckButtons(ax):
-    check = widgets.CheckButtons(ax, ('a', 'b', 'c'), (True, False, True))
+    labels = ('a', 'b', 'c')
+    check = widgets.CheckButtons(ax, labels, (True, False, True))
     assert check.get_status() == [True, False, True]
     check.set_active(0)
     assert check.get_status() == [False, False, True]
+    assert check.get_checked_labels() == ['c']
+    check.clear()
+    assert check.get_status() == [False, False, False]
+    assert check.get_checked_labels() == []
+
+    for invalid_index in [-1, len(labels), len(labels)+5]:
+        with pytest.raises(ValueError):
+            check.set_active(index=invalid_index)
+
+    for invalid_value in ['invalid', -1]:
+        with pytest.raises(TypeError):
+            check.set_active(1, state=invalid_value)
 
     cid = check.on_clicked(lambda: None)
     check.disconnect(cid)
@@ -1045,6 +1058,16 @@ def test_TextBox(ax, toolbar):
     assert text_change_event.call_count == 3
 
 
+def test_RadioButtons(ax):
+    radio = widgets.RadioButtons(ax, ('Radio 1', 'Radio 2', 'Radio 3'))
+    radio.set_active(1)
+    assert radio.value_selected == 'Radio 2'
+    assert radio.index_selected == 1
+    radio.clear()
+    assert radio.value_selected == 'Radio 1'
+    assert radio.index_selected == 0
+
+
 @image_comparison(['check_radio_buttons.png'], style='mpl20', remove_text=True)
 def test_check_radio_buttons_image():
     ax = get_ax()
diff --git a/lib/matplotlib/widgets.py b/lib/matplotlib/widgets.py
index a1974a43fe12..cd9716408303 100644
--- a/lib/matplotlib/widgets.py
+++ b/lib/matplotlib/widgets.py
@@ -1176,9 +1176,9 @@ def set_check_props(self, props):
         # If new colours are supplied, then we must re-apply the status.
         self._init_status(actives)
 
-    def set_active(self, index):
+    def set_active(self, index, state=None):
         """
-        Toggle (activate or deactivate) a check button by index.
+        Modify the state of a check button by index.
 
         Callbacks will be triggered if :attr:`eventson` is True.
 
@@ -1187,22 +1187,27 @@ def set_active(self, index):
         index : int
             Index of the check button to toggle.
 
+        state : bool, optional
+            If a boolean value, set the state explicitly. If no value is
+            provided, the state is toggled.
+
         Raises
         ------
         ValueError
             If *index* is invalid.
+        TypeError
+            If *state* is not boolean.
         """
         if index not in range(len(self.labels)):
             raise ValueError(f'Invalid CheckButton index: {index}')
+        _api.check_isinstance((bool, None), state=state)
 
         invisible = colors.to_rgba('none')
 
         facecolors = self._checks.get_facecolor()
-        facecolors[index] = (
-            self._active_check_colors[index]
-            if colors.same_color(facecolors[index], invisible)
-            else invisible
-        )
+        if state is None:
+            state = colors.same_color(facecolors[index], invisible)
+        facecolors[index] = self._active_check_colors[index] if state else invisible
         self._checks.set_facecolor(facecolors)
 
         if self.drawon:
@@ -1233,6 +1238,23 @@ def _init_status(self, actives):
             [ec if active else "none"
              for ec, active in zip(self._active_check_colors, actives)])
 
+    def clear(self):
+        """Uncheck all checkboxes."""
+
+        self._checks.set_facecolor(['none'] * len(self._active_check_colors))
+
+        if hasattr(self, '_lines'):
+            for l1, l2 in self._lines:
+                l1.set_visible(False)
+                l2.set_visible(False)
+
+        if self.drawon:
+            self.canvas.draw()
+
+        if self.eventson:
+            # Call with no label, as all checkboxes are being cleared.
+            self._observers.process('clicked', None)
+
     def get_status(self):
         """
         Return a list of the status (True/False) of all of the check buttons.
@@ -1240,11 +1262,31 @@ def get_status(self):
         return [not colors.same_color(color, colors.to_rgba("none"))
                 for color in self._checks.get_facecolors()]
 
+    def get_checked_labels(self):
+        """Return a list of labels currently checked by user."""
+
+        return [l.get_text() for l, box_checked in
+                zip(self.labels, self.get_status())
+                if box_checked]
+
     def on_clicked(self, func):
         """
         Connect the callback function *func* to button click events.
 
-        Returns a connection id, which can be used to disconnect the callback.
+        Parameters
+        ----------
+        func : callable
+            When the button is clicked, call *func* with button label.
+            When all buttons are cleared, call *func* with None.
+            The callback func must have the signature::
+
+                def func(label: str | None) -> Any
+
+            Return values may exist, but are ignored.
+
+        Returns
+        -------
+        A connection id, which can be used to disconnect the callback.
         """
         return self._observers.connect('clicked', lambda text: func(text))
 
@@ -1533,6 +1575,8 @@ class RadioButtons(AxesWidget):
         The buttons.
     value_selected : str
         The label text of the currently selected button.
+    index_selected : int
+        The index of the selected button.
     """
 
     def __init__(self, ax, labels, active=0, activecolor=None, *,
@@ -1590,7 +1634,9 @@ def __init__(self, ax, labels, active=0, activecolor=None, *,
             activecolor = 'blue'  # Default.
 
         self._activecolor = activecolor
+        self._initial_active = active
         self.value_selected = labels[active]
+        self.index_selected = active
 
         ax.set_xticks([])
         ax.set_yticks([])
@@ -1716,10 +1762,21 @@ def set_active(self, index):
         Select button with number *index*.
 
         Callbacks will be triggered if :attr:`eventson` is True.
+
+        Parameters
+        ----------
+        index : int
+            The index of the button to activate.
+
+        Raises
+        ------
+        ValueError
+            If the index is invalid.
         """
         if index not in range(len(self.labels)):
             raise ValueError(f'Invalid RadioButton index: {index}')
         self.value_selected = self.labels[index].get_text()
+        self.index_selected = index
         button_facecolors = self._buttons.get_facecolor()
         button_facecolors[:] = colors.to_rgba("none")
         button_facecolors[index] = colors.to_rgba(self._active_colors[index])
@@ -1737,11 +1794,28 @@ def set_active(self, index):
         if self.eventson:
             self._observers.process('clicked', self.labels[index].get_text())
 
+    def clear(self):
+        """Reset the active button to the initially active one."""
+        self.set_active(self._initial_active)
+
     def on_clicked(self, func):
         """
         Connect the callback function *func* to button click events.
 
-        Returns a connection id, which can be used to disconnect the callback.
+        Parameters
+        ----------
+        func : callable
+            When the button is clicked, call *func* with button label.
+            When all buttons are cleared, call *func* with None.
+            The callback func must have the signature::
+
+                def func(label: str | None) -> Any
+
+            Return values may exist, but are ignored.
+
+        Returns
+        -------
+        A connection id, which can be used to disconnect the callback.
         """
         return self._observers.connect('clicked', func)
 
diff --git a/lib/matplotlib/widgets.pyi b/lib/matplotlib/widgets.pyi
index ca1e5a71a288..e27da7575b74 100644
--- a/lib/matplotlib/widgets.pyi
+++ b/lib/matplotlib/widgets.pyi
@@ -160,9 +160,11 @@ class CheckButtons(AxesWidget):
     def set_label_props(self, props: dict[str, Any]) -> None: ...
     def set_frame_props(self, props: dict[str, Any]) -> None: ...
     def set_check_props(self, props: dict[str, Any]) -> None: ...
-    def set_active(self, index: int) -> None: ...
+    def set_active(self, index: int, state: bool | None = ...) -> None: ...  # type: ignore[override]
+    def clear(self) -> None: ...
     def get_status(self) -> list[bool]: ...
-    def on_clicked(self, func: Callable[[str], Any]) -> int: ...
+    def get_checked_labels(self) -> list[str]: ...
+    def on_clicked(self, func: Callable[[str | None], Any]) -> int: ...
     def disconnect(self, cid: int) -> None: ...
 
 class TextBox(AxesWidget):
@@ -211,7 +213,8 @@ class RadioButtons(AxesWidget):
     def set_label_props(self, props: dict[str, Any]) -> None: ...
     def set_radio_props(self, props: dict[str, Any]) -> None: ...
     def set_active(self, index: int) -> None: ...
-    def on_clicked(self, func: Callable[[str], Any]) -> int: ...
+    def clear(self) -> None: ...
+    def on_clicked(self, func: Callable[[str | None], Any]) -> int: ...
     def disconnect(self, cid: int) -> None: ...
 
 class SubplotTool(Widget):

From cd7ba8268b4f2006c4c3777f079163ed706d0e5c Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 5 Oct 2023 17:23:04 -0400
Subject: [PATCH 0241/1120] DOC: Fix resizing of animation examples

On resize, either `init_func` will be called, or if not defined, the
main `func` with `i=0` is called. On animations that save a state, the
latter can cause weird glitching as the history will skip around.

* For `bayes_update`, I fixed it by providing an `init_func`.
* For `double_pendulum`, I fixed it by simplifying the trace line (since
  we have the entire history pre-computed.)
---
 galleries/examples/animation/bayes_update.py    |  7 ++++++-
 galleries/examples/animation/double_pendulum.py | 11 ++---------
 2 files changed, 8 insertions(+), 10 deletions(-)

diff --git a/galleries/examples/animation/bayes_update.py b/galleries/examples/animation/bayes_update.py
index 86b6e5c342d1..1081b4704623 100644
--- a/galleries/examples/animation/bayes_update.py
+++ b/galleries/examples/animation/bayes_update.py
@@ -41,6 +41,11 @@ def __init__(self, ax, prob=0.5):
         # which the plotted distribution should converge.
         self.ax.axvline(prob, linestyle='--', color='black')
 
+    def start(self):
+        # Used for the *init_func* parameter of FuncAnimation; this is called when
+        # initializing the animation, and also after resizing the figure.
+        return self.line,
+
     def __call__(self, i):
         # This way the plot can continuously run and we just keep
         # watching new realizations of the process
@@ -62,5 +67,5 @@ def __call__(self, i):
 
 fig, ax = plt.subplots()
 ud = UpdateDist(ax, prob=0.7)
-anim = FuncAnimation(fig, ud, frames=100, interval=100, blit=True)
+anim = FuncAnimation(fig, ud, init_func=ud.start, frames=100, interval=100, blit=True)
 plt.show()
diff --git a/galleries/examples/animation/double_pendulum.py b/galleries/examples/animation/double_pendulum.py
index 5f8282daea0f..7a42a6d989ba 100644
--- a/galleries/examples/animation/double_pendulum.py
+++ b/galleries/examples/animation/double_pendulum.py
@@ -11,8 +11,6 @@
 Output generated via `matplotlib.animation.Animation.to_jshtml`.
 """
 
-from collections import deque
-
 import matplotlib.pyplot as plt
 import numpy as np
 from numpy import cos, sin
@@ -92,19 +90,14 @@ def derivs(t, state):
 trace, = ax.plot([], [], '.-', lw=1, ms=2)
 time_template = 'time = %.1fs'
 time_text = ax.text(0.05, 0.9, '', transform=ax.transAxes)
-history_x, history_y = deque(maxlen=history_len), deque(maxlen=history_len)
 
 
 def animate(i):
     thisx = [0, x1[i], x2[i]]
     thisy = [0, y1[i], y2[i]]
 
-    if i == 0:
-        history_x.clear()
-        history_y.clear()
-
-    history_x.appendleft(thisx[2])
-    history_y.appendleft(thisy[2])
+    history_x = x2[:i]
+    history_y = y2[:i]
 
     line.set_data(thisx, thisy)
     trace.set_data(history_x, history_y)

From 4a8397433a7b6383e2341a87901b4c64b4f54f0a Mon Sep 17 00:00:00 2001
From: Greg Lucas <greg.m.lucas@gmail.com>
Date: Sun, 1 Oct 2023 17:27:43 -0600
Subject: [PATCH 0242/1120] FIX: Add PyOS_InputHook back to macos backend

The PyOS_InputHook is used to run our event loop while waiting
on standard input from the user. This means we should flush our
events while waiting for any input from the user so the figures
are responsive.
---
 src/_macosx.m | 63 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 63 insertions(+)

diff --git a/src/_macosx.m b/src/_macosx.m
index 8d92b75f6bfe..e9677a40e6b5 100755
--- a/src/_macosx.m
+++ b/src/_macosx.m
@@ -41,6 +41,66 @@
 static bool keyChangeCapsLock = false;
 /* Keep track of the current mouse up/down state for open/closed cursor hand */
 static bool leftMouseGrabbing = false;
+/* Keep track of whether stdin has been received */
+static bool stdin_received = false;
+static bool stdin_sigint = false;
+// Global variable to store the original SIGINT handler
+static struct sigaction originalSigintAction = {0};
+
+// Signal handler for SIGINT, only sets a flag to exit the run loop
+static void handleSigint(int signal) {
+    stdin_sigint = true;
+}
+
+static int wait_for_stdin() {
+    @autoreleasepool {
+        stdin_received = false;
+        stdin_sigint = false;
+
+        // Set up a SIGINT handler to interrupt the event loop if ctrl+c comes in too
+        struct sigaction customAction = {0};
+        customAction.sa_handler = handleSigint;
+        // Set the new handler and store the old one
+        sigaction(SIGINT, &customAction, &originalSigintAction);
+
+        // Create an NSFileHandle for standard input
+        NSFileHandle *stdinHandle = [NSFileHandle fileHandleWithStandardInput];
+
+        // Register for data available notifications on standard input
+        [[NSNotificationCenter defaultCenter] addObserverForName: NSFileHandleDataAvailableNotification
+                                                          object: stdinHandle
+                                                           queue: [NSOperationQueue mainQueue] // Use the main queue
+                                                      usingBlock: ^(NSNotification *notification) {
+                                                                    // Mark that input has been received
+                                                                    stdin_received = true;
+                                                                    }
+        ];
+
+        // Wait in the background for anything that happens to stdin
+        [stdinHandle waitForDataInBackgroundAndNotify];
+
+        // continuously run an event loop until the stdin_received flag is set to exit
+        while (!stdin_received && !stdin_sigint) {
+            while (true) {
+                NSEvent *event = [NSApp nextEventMatchingMask: NSEventMaskAny
+                                                    untilDate: [NSDate distantPast]
+                                                       inMode: NSDefaultRunLoopMode
+                                                      dequeue: YES];
+                if (!event) { break; }
+                [NSApp sendEvent: event];
+            }
+            // We need to run the run loop for a short time to allow the
+            // events to be processed and keep flushing them while we wait for stdin
+            [[NSRunLoop currentRunLoop] runUntilDate: [NSDate dateWithTimeIntervalSinceNow: 0.01]];
+        }
+        // Remove the input handler as an observer
+        [[NSNotificationCenter defaultCenter] removeObserver: stdinHandle];
+
+        // Restore the original SIGINT handler upon exiting the function
+        sigaction(SIGINT, &originalSigintAction, NULL);
+        return 1;
+    }
+}
 
 /* ---------------------------- Cocoa classes ---------------------------- */
 
@@ -139,6 +199,9 @@ static void lazy_init(void) {
     NSApp = [NSApplication sharedApplication];
     [NSApp setActivationPolicy:NSApplicationActivationPolicyRegular];
 
+    // Run our own event loop while waiting for stdin on the Python side
+    // this is needed to keep the application responsive while waiting for input
+    PyOS_InputHook = wait_for_stdin;
 }
 
 static PyObject*

From 1a3b32fa96806692404788df6baf914426ee1409 Mon Sep 17 00:00:00 2001
From: esibinga <vegheadeva@gmail.com>
Date: Fri, 4 Aug 2023 09:45:15 -0400
Subject: [PATCH 0243/1120] tag guideline draft

---
 doc/devel/index.rst                   |   1 +
 galleries/examples/tag_glossary.rst   | 155 ++++++++++++++++++++++++++
 galleries/examples/tag_guidelines.rst |  70 ++++++++++++
 3 files changed, 226 insertions(+)
 create mode 100644 galleries/examples/tag_glossary.rst
 create mode 100644 galleries/examples/tag_guidelines.rst

diff --git a/doc/devel/index.rst b/doc/devel/index.rst
index 2b358595255b..75088bce774a 100644
--- a/doc/devel/index.rst
+++ b/doc/devel/index.rst
@@ -146,6 +146,7 @@ Policies and guidelines
 
          document
          style_guide
+         ../gallery/tag_guidelines
 
    .. grid-item-card::
       :shadow: none
diff --git a/galleries/examples/tag_glossary.rst b/galleries/examples/tag_glossary.rst
new file mode 100644
index 000000000000..439524f0b99c
--- /dev/null
+++ b/galleries/examples/tag_glossary.rst
@@ -0,0 +1,155 @@
+:orphan:
+
+Tag Glossary
+============
+
+    I. API tags: what content from the API reference is in the example?
+    II. Structural tags: what format is the example? What context can we provide?
+    III. Domain tags: what discipline(s) might seek this example consistently?
+    IV. Internal tags: what information is helpful for maintainers or contributors?
+
+
+*1. API tags: what content from the API reference is in the example?*
+
++-----------------------------------+---------------------------------------------+
+|``tag``                            | use case - if not obvious                   |
++===================================+=============================================+
+|**Styling**                                                                      |
++-----------------------------------+---------------------------------------------+
+|``styling: color``                 |                                             |
++-----------------------------------+---------------------------------------------+
+|``styling: shape``                 |                                             |
++-----------------------------------+---------------------------------------------+
+|``styling: size``                  |                                             |
++-----------------------------------+---------------------------------------------+
+|``styling: position``              |                                             |
++-----------------------------------+---------------------------------------------+
+|``styling: texture``               |                                             |
++-----------------------------------+---------------------------------------------+
+|``styling: colormap``              |                                             |
++-----------------------------------+---------------------------------------------+
+|``styling: colorbar``              |                                             |
++-----------------------------------+---------------------------------------------+
+|``styling: linestyle``             |                                             |
++-----------------------------------+---------------------------------------------+
+|``styling: small-multiples``       |                                             |
++-----------------------------------+---------------------------------------------+
+|                                   |                                             |
++-----------------------------------+---------------------------------------------+
+|**Primary or relevant plot component**                                           |
++-----------------------------------+---------------------------------------------+
+|Use these tags when plot contains a teachable example                            |
++-----------------------------------+---------------------------------------------+
+|``component: axes``                |                                             |
++-----------------------------------+---------------------------------------------+
+|``component: axis``                |                                             |
++-----------------------------------+---------------------------------------------+
+|``component: marker``              |                                             |
++-----------------------------------+---------------------------------------------+
+|``component: label``               |                                             |
++-----------------------------------+---------------------------------------------+
+|``component: title``               |                                             |
++-----------------------------------+---------------------------------------------+
+|``component: legend``              |                                             |
++-----------------------------------+---------------------------------------------+
+|``component: subplot``             |                                             |
++-----------------------------------+---------------------------------------------+
+|``component: figure``              |                                             |
++-----------------------------------+---------------------------------------------+
+|``component: annotation``          |                                             |
++-----------------------------------+---------------------------------------------+
+|``component: label``               |                                             |
++-----------------------------------+---------------------------------------------+
+|``component: ticks``               |                                             |
++-----------------------------------+---------------------------------------------+
+|``component: spines``              |frequently paired with ``component: axis``   |
++-----------------------------------+---------------------------------------------+
+|``component: error``               |                                             |
++-----------------------------------+---------------------------------------------+
+|                                   |                                             |
++-----------------------------------+---------------------------------------------+
+|**Interactivity**                                                                |
++-----------------------------------+---------------------------------------------+
+|``interactivity: event handling``  |                                             |
++-----------------------------------+---------------------------------------------+
+|``interactivity: zoom``            |                                             |
++-----------------------------------+---------------------------------------------+
+|``interactivity: pan``             |                                             |
++-----------------------------------+---------------------------------------------+
+|``interactivity: brush``           |                                             |
++-----------------------------------+---------------------------------------------+
+|                                   |                                             |
++-----------------------------------+---------------------------------------------+
+|**Plot Type**                                                                    |
++-----------------------------------+---------------------------------------------+
+|``plot type: bar``                 |example contains a bar plot                  |
++-----------------------------------+---------------------------------------------+
+|``plot type: line``                |example contains a line plot                 |
++-----------------------------------+---------------------------------------------+
+|``plot type: pie``                 |example contains a pie plot                  |
++-----------------------------------+---------------------------------------------+
+|``plot type: polar``               |example contains a polar plot                |
++-----------------------------------+---------------------------------------------+
+|``plot type: 3D``                  |example contains a 3D plot                   |
++-----------------------------------+---------------------------------------------+
+|``plot type: histogram``           |example contains a histogram                 |
++-----------------------------------+---------------------------------------------+
+|``plot type: specialty``           |                                             |
++-----------------------------------+---------------------------------------------+
+|``plot type:          ``           |                                             |
++-----------------------------------+---------------------------------------------+
+
+
+*2. Structural tags: what format is the example? What context can we provide?*
+
++-----------------------+-------------------------------------------------------------------+
+|``tag``                | use case                                                          |
++=======================+===================================================================+
+|``level: reference``   |reference docs like "marker reference" or "list of named colors"   |
+|                       | - dense collection of short-format information                    |
+|                       | - well-defined scope, accessible information                      |
++-----------------------+-------------------------------------------------------------------+
+|``level``              |level refers to how much context/background the user will need     |
++-----------------------+-------------------------------------------------------------------+
+|``level: beginner``    |concepts are standalone, self-contained, require only one module   |
++-----------------------+-------------------------------------------------------------------+
+|``level: intermediate``|concepts may require knowledge of other modules, have dependencies |
++-----------------------+-------------------------------------------------------------------+
+|``level: advanced``    |concepts require multiple modules and have dependencies            |
++-----------------------+-------------------------------------------------------------------+
+
+*3. Domain tags: what discipline(s) might seek this example consistently?*
+
+Note: it's futile to draw fences around "who owns what", and that's not the point of domain tags. Domain tags help groups of people to privately organize relevant information, and so are not displayed publicly. See below for a list of existing domain tags. If you don't see the one you're looking for and you think it should exist, consider proposing it.
+
++-------------------------------+----------------------------------------+
+|``tag``                        | use case                               |
++=======================+================================================+
+|``domain``                     |for whom is the example relevant?       |
++-------------------------------+----------------------------------------+
+|``domain: cartography``        |                                        |
++-------------------------------+----------------------------------------+
+|``domain: geometry``           |                                        |
++-------------------------------+----------------------------------------+
+|``domain: statistics``         |                                        |
++-------------------------------+----------------------------------------+
+|``domain: oceanography``       |                                        |
++-------------------------------+----------------------------------------+
+|``domain: signal-processing``  |                                        |
++-------------------------------+----------------------------------------+
+|                               |                                        |
++-------------------------------+----------------------------------------+
+
+*4. Internal tags: what information is helpful for maintainers or contributors?*
+
++---------------------------+-----------------------------------------------------------------------+
+|``tag``                    | use case                                                              |
++===========================+=======================================================================+
+|``internal: low bandwidth``|allows users to filter out bandwidth-intensive examples like animations|
++---------------------------+-----------------------------------------------------------------------+
+|``internal: untagged``     |allows docs contributors to easily find untagged examples              |
++---------------------------+-----------------------------------------------------------------------+
+|``internal: deprecated``   |examples containing deprecated functionality or concepts               |
++---------------------------+-----------------------------------------------------------------------+
+|``internal: needs-review`` |example needs to be reviewed for accuracy or pedagogical value         |
++---------------------------+-----------------------------------------------------------------------+
diff --git a/galleries/examples/tag_guidelines.rst b/galleries/examples/tag_guidelines.rst
new file mode 100644
index 000000000000..2fac2f8712c9
--- /dev/null
+++ b/galleries/examples/tag_guidelines.rst
@@ -0,0 +1,70 @@
+Guidelines for assigning tags to gallery examples
+=================================================
+
+*Why do we need tags?*
+
+    Tags serve multiple purposes.
+
+    Tags have a one-to-many organization (i.e. one example can have several tags), while the gallery structure requires that examples are placed in only one location. This means tags provide a secondary layer of organization and make the gallery of examples more flexible and more user-friendly.
+
+    They allow for better discoverability, search, and browse functions. They are helpful for users struggling to write a search query for what they're looking for.
+
+    Hidden tags provide additional functionality for maintainers and contributors.
+
+*What gets a tag?*
+
+Every gallery example should be tagged with:
+
+* 1+ content tags
+* structural, domain, or internal tag(s) if helpful
+
+Examples with many tags may indicate that the entry is a showcase example.
+
+Tags can repeat existing forms of organization (e.g. an example is in the Animation folder and also gets an ``animation`` tag).
+
+Tags are helpful to denote particularly good "byproduct" examples. E.g. the explicit purpose of a gallery example might be to demonstrate a colormap, but it's also a good demonstration of a legend. Tag ``legend`` to indicate that, rather than changing the title or the scope of the example.
+
+*Tag Categories* - See :doc:`Tag Glossary <tag_glossary>` for a complete list of tags.
+
+I. API tags: what content from the API reference is in the example?
+II. Structural tags: what format is the example? What context can we provide?
+III. Domain tags: what discipline(s) might seek this example consistently?
+IV. Internal tags: what information is helpful for maintainers or contributors?
+
+*Proposing new tags*
+
+    1. Review existing tag list, looking out for similar entries (i.e. ``axes`` and ``axis``).
+    2. If a relevant tag or subcategory does not yet exist, propose it. Each tag is two parts: ``subcategory: tag``. Tags should be one or two words.
+    3. New tags should be be added when they are relevant to existing gallery entries too. Avoid tags that will link to only a single gallery entry.
+    4. Tags can recreate other forms of organization.
+
+Note: Tagging organization aims to work for 80-90% of cases. Some examples fall outside of the tagging structure. Niche or specific examples shouldn't be given standalone tags that won't apply to other examples.
+
+*How to tag?*
+ where you put the directive is where the tag will show
+
+**Related content**
+
+*What is a gallery example?*
+
+The gallery of examples contains visual demonstrations of matplolib features. Gallery examples exist so that users can scan through visual examples.
+
+Unlike tutorials or user guides, gallery examples teach by demonstration, rather than by explanation or instruction.
+
+Gallery examples should avoid instruction or excessive explanation except for brief clarifying code comments. Instead, they can tag related concepts and/or link to relevant tutorials or user guides.
+
+Format:
+
+All gallery examples should aim to follow the following format:
+
+* Title: 1-6 words, descriptive of content
+* Subtitle: 10-50 words, action-oriented description of the example subject
+* Image: a clear demonstration of the subject, showing edge cases and different applications if possible
+* Code + Text (optional): code, commented as appropriate + written text to add context if necessary
+
+Example:
+
+``bbox_intersect`` gallery example showcases the point of visual examples
+
+* messy example/ hard to categorize, but the gallery is definitely the right spot for it because it's the kind of thing you'd find by visual search
+* https://matplotlib.org/devdocs/gallery/misc/bbox_intersect.html#sphx-glr-gallery-misc-bbox-intersect-py

From efe71e4d9a92aed867f3301e7c2226880112a261 Mon Sep 17 00:00:00 2001
From: Matthew Feickert <matthew.feickert@cern.ch>
Date: Fri, 6 Oct 2023 15:20:00 -0500
Subject: [PATCH 0244/1120] CI: Update scientific-python/upload-nightly-action
 to 0.2.0

* The scientific-python/upload-nightly-action action has received
  stability updates in 0.2.0 that provides a reproducible runtime
  environment for the action, which should mitigate issues with
  stability.
   - c.f. https://github.com/scientific-python/upload-nightly-action/releases/tag/0.2.0
---
 .github/workflows/nightlies.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/nightlies.yml b/.github/workflows/nightlies.yml
index 31d043f55819..76e7fee0b205 100644
--- a/.github/workflows/nightlies.yml
+++ b/.github/workflows/nightlies.yml
@@ -59,7 +59,7 @@ jobs:
           ls -l dist/
 
       - name: Upload wheels to Anaconda Cloud as nightlies
-        uses: scientific-python/upload-nightly-action@8f0394fd2aa0c85d7364a9958652e8994e06b23c # 0.1.0
+        uses: scientific-python/upload-nightly-action@5fb764c5bce1ac2297084c0f7161b1919f17c74f # 0.2.0
         with:
           artifacts_path: dist
           anaconda_nightly_upload_token: ${{ secrets.ANACONDA_ORG_UPLOAD_TOKEN }}

From 52d87ca317a2f6ed7a272422ace8a2e5d3f2138a Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Tue, 12 Sep 2023 13:50:42 -0400
Subject: [PATCH 0245/1120] separate and clarify axisartist default tables

---
 .../users_explain/toolkits/axisartist.rst     | 43 +++++++++++++------
 1 file changed, 31 insertions(+), 12 deletions(-)

diff --git a/galleries/users_explain/toolkits/axisartist.rst b/galleries/users_explain/toolkits/axisartist.rst
index 313a0fb5a9e9..4927f9a3c940 100644
--- a/galleries/users_explain/toolkits/axisartist.rst
+++ b/galleries/users_explain/toolkits/axisartist.rst
@@ -341,18 +341,37 @@ On the other hand, there is a concept of "axis_direction". This is a
 default setting of above properties for each, "bottom", "left", "top",
 and "right" axis.
 
-========== ========== ========= ========== ========= ==========
-label type  parameter    left      bottom      right      top
-========== ========== ========= ========== ========= ==========
-axislabel   direction      '-'       '+'        '+'      '-'
-axislabel   rotation      180         0          0       180
-axislabel   va           center    top       center     bottom
-axislabel   ha           right    center      right     center
-ticklabel   direction      '-'       '+'        '+'      '-'
-ticklabel   rotation       90         0        -90       180
-ticklabel   ha           right    center      right     center
-ticklabel   va           center   baseline    center   baseline
-========== ========== ========= ========== ========= ==========
+.. table:: ``axislabel`` property defaults
+
+   +---------------------+-----------------+----------------+----------------------+--------------------+
+   | reference direction | label direction | label rotation | horizontal alignment | vertical alignment |
+   +=====================+=================+================+======================+====================+
+   | left                | '-'             | 180            | right                | center             |
+   +---------------------+-----------------+----------------+----------------------+--------------------+
+   | bottom              | '+'             | 0              | center               | top                |
+   +---------------------+-----------------+----------------+----------------------+--------------------+
+   | right               | '+'             | 0              | right                | center             |
+   +---------------------+-----------------+----------------+----------------------+--------------------+
+   | top                 | '-'             | 180            | center               | bottom             |
+   +---------------------+-----------------+----------------+----------------------+--------------------+
+
+
+
+.. table:: ``ticklabel`` property defaults
+
+   +---------------------+-----------------+----------------+----------------------+--------------------+
+   | reference direction | label direction | label rotation | horizontal alignment | vertical alignment |
+   +=====================+=================+================+======================+====================+
+   | left                | '-'             | 90             | right                | center             |
+   +---------------------+-----------------+----------------+----------------------+--------------------+
+   | bottom              | '+'             | 0              | center               | baseline           |
+   +---------------------+-----------------+----------------+----------------------+--------------------+
+   | right               | '+'             | -90            | right                | center             |
+   +---------------------+-----------------+----------------+----------------------+--------------------+
+   | top                 | '-'             | 180            | center               | baseline           |
+   +---------------------+-----------------+----------------+----------------------+--------------------+
+
+
 
 And, 'set_axis_direction("top")' means to adjust the text rotation
 etc, for settings suitable for "top" axis. The concept of axis

From be1c941a72592326a7775c7fe93ca8ea9c7f6297 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Fri, 6 Oct 2023 01:28:26 -0400
Subject: [PATCH 0246/1120] document table usage and clean up headings

---
 doc/devel/document.rst | 48 ++++++++++++++++++++++++++++++++----------
 1 file changed, 37 insertions(+), 11 deletions(-)

diff --git a/doc/devel/document.rst b/doc/devel/document.rst
index ac92888b4052..095b42d689ce 100644
--- a/doc/devel/document.rst
+++ b/doc/devel/document.rst
@@ -142,7 +142,7 @@ It is useful to strive for consistency in the Matplotlib documentation.  Here
 are some formatting and style conventions that are used.
 
 Section formatting
-~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^
 
 Use `sentence case <https://apastyle.apa.org/style-grammar-guidelines/capitalization/sentence-case>`__
 ``Upper lower`` for section titles, e.g., ``Possible hangups`` rather than
@@ -163,8 +163,25 @@ for section markup characters, i.e.:
 
 This may not yet be applied consistently in existing docs.
 
+Table formatting
+^^^^^^^^^^^^^^^^
+Given the size of the table and length of each entry, use:
+
++-------------+-------------------------------+--------------------+
+|             | small table                   | large table        |
++-------------+-------------------------------+--------------------+
+| short entry | `simple or grid table <sg>`_  | `grid table <sg>`_ |
++-------------+-------------------------------+--------------------+
+| long entry  | `list table <lt>`_            | `csv table <csv>`_ |
++-------------+-------------------------------+--------------------+
+
+For more information, see `rst tables <https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#tables>`_.
+.. _sg: https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#tables
+.. _lt: https://docutils.sourceforge.io/docs/ref/rst/directives.html#list-table
+.. _csv: https://docutils.sourceforge.io/docs/ref/rst/directives.html#toc-entry-22
+
 Function arguments
-~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^
 
 Function arguments and keywords within docstrings should be referred to using
 the ``*emphasis*`` role. This will keep Matplotlib's documentation consistent
@@ -445,7 +462,8 @@ and the Sphinx_ documentation.  Some Matplotlib-specific formatting conventions
 to keep in mind:
 
 Quote positions
-~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^
+
 The quotes for single line docstrings are on the same line (pydocstyle D200)::
 
     def get_linewidth(self):
@@ -461,7 +479,8 @@ The quotes for multi-line docstrings are on separate lines (pydocstyle D213)::
         """
 
 Function arguments
-~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^
+
 Function arguments and keywords within docstrings should be referred to
 using the ``*emphasis*`` role. This will keep Matplotlib's documentation
 consistent with Python's documentation:
@@ -478,7 +497,8 @@ Do not use the ```default role``` or the ````literal```` role:
 
 
 Quotes for strings
-~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^
+
 Matplotlib does not have a convention whether to use single-quotes or
 double-quotes.  There is a mixture of both in the current code.
 
@@ -495,7 +515,8 @@ slightly improve the rendered docs, they are cumbersome to type and difficult
 to read in plain-text docs.
 
 Parameter type descriptions
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
 The main goal for parameter type descriptions is to be readable and
 understandable by humans. If the possible types are too complex use a
 simplification for the type description and explain the type more
@@ -534,7 +555,8 @@ Non-numeric homogeneous sequences are described as lists, e.g.::
   list of `.Artist`
 
 Reference types
-~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^
+
 Generally, the rules from referring-to-other-code_ apply. More specifically:
 
 Use full references ```~matplotlib.colors.Normalize``` with an
@@ -550,7 +572,8 @@ Use abbreviated links ```.Normalize``` in the text.
         A `.Normalize` instance is used to scale luminance data to 0, 1.
 
 Default values
-~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^
+
 As opposed to the numpydoc guide, parameters need not be marked as
 *optional* if they have a simple default:
 
@@ -592,7 +615,8 @@ effect.
 
 
 ``See also`` sections
-~~~~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^^^
+
 Sphinx automatically links code elements in the definition blocks of ``See
 also`` sections. No need to use backticks there::
 
@@ -602,7 +626,8 @@ also`` sections. No need to use backticks there::
    axhline : horizontal line across the Axes
 
 Wrap parameter lists
-~~~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^^
+
 Long parameter lists should be wrapped using a ``\`` for continuation and
 starting on the new line without any indent (no indent because pydoc will
 parse the docstring and strip the line continuation so that indent would
@@ -627,7 +652,8 @@ Alternatively, you can describe the valid parameter values in a dedicated
 section of the docstring.
 
 rcParams
-~~~~~~~~
+^^^^^^^^
+
 rcParams can be referenced with the custom ``:rc:`` role:
 :literal:`:rc:\`foo\`` yields ``rcParams["foo"] = 'default'``, which is a link
 to the :file:`matplotlibrc` file description.

From 6e46393b6103af3eb41acb201bf68625a1757251 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 6 Oct 2023 04:14:18 -0400
Subject: [PATCH 0247/1120] Bump required C++ standard to c++17

According to SciPy's Toolchain Roadmap [1], C++17 core features became
available in 2022. This was concluded based on minimum compiler versions
in `manylinux2014` images, AIX systems, FreeBSD systems, and Windows.
Note, some standard library features are not universally supported.

This commit does not move much code to C++17, just a couple of minor
improvements that I could easily change.

[1] https://docs.scipy.org/doc/scipy/dev/toolchain.html#c-language-standards
---
 .../next_api_changes/development/27012-ES.rst |  7 +++
 doc/devel/dependencies.rst                    | 14 ++---
 meson.build                                   |  2 +-
 src/_image_wrapper.cpp                        | 51 +++++++++----------
 4 files changed, 40 insertions(+), 34 deletions(-)
 create mode 100644 doc/api/next_api_changes/development/27012-ES.rst

diff --git a/doc/api/next_api_changes/development/27012-ES.rst b/doc/api/next_api_changes/development/27012-ES.rst
new file mode 100644
index 000000000000..1bec3e7d91df
--- /dev/null
+++ b/doc/api/next_api_changes/development/27012-ES.rst
@@ -0,0 +1,7 @@
+Extensions require C++17
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+Matplotlib now requires a compiler that supports C++17 in order to build its extensions.
+According to `SciPy's analysis
+<https://docs.scipy.org/doc/scipy/dev/toolchain.html#c-language-standards>`_, this
+should be available on all supported platforms.
diff --git a/doc/devel/dependencies.rst b/doc/devel/dependencies.rst
index 77df6e494d50..0ffdaf65696a 100644
--- a/doc/devel/dependencies.rst
+++ b/doc/devel/dependencies.rst
@@ -233,7 +233,7 @@ in your target environment manually:
 C++ compiler
 ------------
 
-Matplotlib requires a C++ compiler that supports C++11, and each platform has a
+Matplotlib requires a C++ compiler that supports C++17, and each platform has a
 development environment that must be installed before a compiler can be installed.
 
 .. tab-set::
@@ -277,18 +277,18 @@ Xcode, VS Code or Linux package manager. Choose **one** compiler from this list:
      - platforms
      - notes
    * - GCC
-     - **4.8.1**
+     - **7.2**
      - Linux, macOS, Windows
-     - `gcc 4.8.1 <https://gcc.gnu.org/projects/cxx-status.html#cxx11>`_,
+     - `gcc 7.2 <https://gcc.gnu.org/projects/cxx-status.html#cxx17>`_,
        `GCC: Binaries <https://gcc.gnu.org/install/binaries.html>`_,
    * - Clang (LLVM)
-     - **3.3**
+     - **5**
      - Linux, macOS
-     - `clang 3.3 <https://clang.llvm.org/cxx_status.html>`_, `LLVM <https://releases.llvm.org/download.html>`_
+     - `clang 5 <https://clang.llvm.org/cxx_status.html>`_, `LLVM <https://releases.llvm.org/download.html>`_
    * - MSVC++
-     - **14.0**
+     - **16.0**
      - Windows
-     - `Visual Studio 2015 C++ <https://docs.microsoft.com/en-us/cpp/overview/visual-cpp-language-conformance?view=msvc-140>`_
+     - `Visual Studio 2019 C++ <https://docs.microsoft.com/en-us/cpp/overview/visual-cpp-language-conformance?view=msvc-160>`_
 
 
 
diff --git a/meson.build b/meson.build
index 1ba673948a1e..41f080b3700e 100644
--- a/meson.build
+++ b/meson.build
@@ -10,7 +10,7 @@ project(
   meson_version: '>=1.1.0',
   default_options: [
     'b_lto=true',
-    'cpp_std=c++11',
+    'cpp_std=c++17',
     'auto_features=disabled',  # Force FreeType to avoid extra dependencies.
   ],
 )
diff --git a/src/_image_wrapper.cpp b/src/_image_wrapper.cpp
index 179f8d1301f7..b18e93a50fb3 100644
--- a/src/_image_wrapper.cpp
+++ b/src/_image_wrapper.cpp
@@ -10,41 +10,40 @@
  * */
 
 const char* image_resample__doc__ =
-"Resample input_array, blending it in-place into output_array, using an\n"
-"affine transformation.\n\n"
+R"""(Resample input_array, blending it in-place into output_array, using an affine transform.
 
-"Parameters\n"
-"----------\n"
-"input_array : 2-d or 3-d NumPy array of float, double or `numpy.uint8`\n"
-"    If 2-d, the image is grayscale.  If 3-d, the image must be of size\n"
-"    4 in the last dimension and represents RGBA data.\n\n"
+Parameters
+----------
+input_array : 2-d or 3-d NumPy array of float, double or `numpy.uint8`
+    If 2-d, the image is grayscale.  If 3-d, the image must be of size 4 in the last
+    dimension and represents RGBA data.
 
-"output_array : 2-d or 3-d NumPy array of float, double or `numpy.uint8`\n"
-"    The dtype and number of dimensions must match `input_array`.\n\n"
+output_array : 2-d or 3-d NumPy array of float, double or `numpy.uint8`
+    The dtype and number of dimensions must match `input_array`.
 
-"transform : matplotlib.transforms.Transform instance\n"
-"    The transformation from the input array to the output array.\n\n"
+transform : matplotlib.transforms.Transform instance
+    The transformation from the input array to the output array.
 
-"interpolation : int, default: NEAREST\n"
-"    The interpolation method.  Must be one of the following constants\n"
-"    defined in this module:\n\n"
+interpolation : int, default: NEAREST
+    The interpolation method.  Must be one of the following constants defined in this
+    module:
 
-"      NEAREST, BILINEAR, BICUBIC, SPLINE16, SPLINE36,\n"
-"      HANNING, HAMMING, HERMITE, KAISER, QUADRIC, CATROM, GAUSSIAN,\n"
-"      BESSEL, MITCHELL, SINC, LANCZOS, BLACKMAN\n\n"
+      NEAREST, BILINEAR, BICUBIC, SPLINE16, SPLINE36, HANNING, HAMMING, HERMITE, KAISER,
+      QUADRIC, CATROM, GAUSSIAN, BESSEL, MITCHELL, SINC, LANCZOS, BLACKMAN
 
-"resample : bool, optional\n"
-"    When `True`, use a full resampling method.  When `False`, only\n"
-"    resample when the output image is larger than the input image.\n\n"
+resample : bool, optional
+    When `True`, use a full resampling method.  When `False`, only resample when the
+    output image is larger than the input image.
 
-"alpha : float, default: 1\n"
-"    The transparency level, from 0 (transparent) to 1 (opaque).\n\n"
+alpha : float, default: 1
+    The transparency level, from 0 (transparent) to 1 (opaque).
 
-"norm : bool, default: False\n"
-"    Whether to norm the interpolation function.\n\n"
+norm : bool, default: False
+    Whether to norm the interpolation function.
 
-"radius: float, default: 1\n"
-"    The radius of the kernel, if method is SINC, LANCZOS or BLACKMAN.\n";
+radius: float, default: 1
+    The radius of the kernel, if method is SINC, LANCZOS or BLACKMAN.
+)""";
 
 
 static pybind11::array_t<double>

From 1a53e5ba11089c747c9ffbd38dcd03372b1f98ef Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 28 Sep 2023 03:27:21 -0400
Subject: [PATCH 0248/1120] ci: Run mypy against typed cycler

---
 .github/workflows/reviewdog.yml | 2 --
 pyproject.toml                  | 1 -
 2 files changed, 3 deletions(-)

diff --git a/.github/workflows/reviewdog.yml b/.github/workflows/reviewdog.yml
index dafc331a11eb..f9c1121581c0 100644
--- a/.github/workflows/reviewdog.yml
+++ b/.github/workflows/reviewdog.yml
@@ -65,9 +65,7 @@ jobs:
           REVIEWDOG_GITHUB_API_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
           set -o pipefail
-          # The --ignore-missing-imports can be removed when typed cycler is released and used
           mypy --config pyproject.toml lib/matplotlib \
-             --ignore-missing-imports \
              --follow-imports silent | \
             reviewdog -f=mypy -name=mypy \
               -tee -reporter=github-check -filter-mode nofilter
diff --git a/pyproject.toml b/pyproject.toml
index 37d97e02b956..e0c7e4e9dfee 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -214,7 +214,6 @@ exclude = [
   # stubtest will import and run, opening a figure if not excluded
   ".*/tinypages",
 ]
-ignore_missing_imports = true
 enable_incomplete_feature = [
   "Unpack",
 ]

From 677a4064f87edef0ef27c68b520df5094eb4ee87 Mon Sep 17 00:00:00 2001
From: Koustav Ghosh <ghosh.hardkots.koustav1@gmail.com>
Date: Sat, 7 Oct 2023 11:23:19 +0530
Subject: [PATCH 0249/1120] Add test_contourf #26864

---
 lib/matplotlib/tests/test_datetime.py | 24 +++++++++++++++++++++---
 1 file changed, 21 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 53958229f174..39bf6f6356e8 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -122,11 +122,29 @@ def test_contour(self):
         fig, ax = plt.subplots()
         ax.contour(...)
 
-    @pytest.mark.xfail(reason="Test for contourf not written yet")
     @mpl.style.context("default")
     def test_contourf(self):
-        fig, ax = plt.subplots()
-        ax.contourf(...)
+        mpl.rcParams["date.converter"] = "concise"
+        range_threshold = 10
+        fig, (ax1, ax2, ax3) = plt.subplots(3, 1, layout="constrained")
+
+        x_dates = np.array(
+            [datetime.datetime(2023, 10, delta) for delta in range(1, range_threshold)]
+        )
+        y_dates = np.array(
+            [datetime.datetime(2023, 10, delta) for delta in range(1, range_threshold)]
+        )
+        x_ranges = np.array(range(1, range_threshold))
+        y_ranges = np.array(range(1, range_threshold))
+
+        X_dates, Y_dates = np.meshgrid(x_dates, y_dates)
+        X_ranges, Y_ranges = np.meshgrid(x_ranges, y_ranges)
+
+        Z_ranges = np.cos(X_ranges / 4) + np.sin(Y_ranges / 4)
+
+        ax1.contourf(X_dates, Y_dates, Z_ranges)
+        ax2.contourf(X_dates, Y_ranges, Z_ranges)
+        ax3.contourf(X_ranges, Y_dates, Z_ranges)
 
     @pytest.mark.xfail(reason="Test for csd not written yet")
     @mpl.style.context("default")

From 10b4157c1d99e46a88428ab893400cd6e3be8309 Mon Sep 17 00:00:00 2001
From: Augusto Borges <borges.augustoar@gmail.com>
Date: Fri, 6 Oct 2023 12:00:23 +0200
Subject: [PATCH 0250/1120] ValueError exception added to handle mix of {} and
 % string

---
 lib/matplotlib/colorbar.py            | 2 +-
 lib/matplotlib/tests/test_colorbar.py | 8 +++++++-
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/colorbar.py b/lib/matplotlib/colorbar.py
index 5c37eef5190b..6c92f3795384 100644
--- a/lib/matplotlib/colorbar.py
+++ b/lib/matplotlib/colorbar.py
@@ -404,7 +404,7 @@ def __init__(self, ax, mappable=None, *, cmap=None,
             try:
                 self._formatter = ticker.FormatStrFormatter(format)
                 _ = self._formatter(0)
-            except TypeError:
+            except (TypeError, ValueError):
                 self._formatter = ticker.StrMethodFormatter(format)
         else:
             self._formatter = format  # Assume it is a Formatter or None
diff --git a/lib/matplotlib/tests/test_colorbar.py b/lib/matplotlib/tests/test_colorbar.py
index 73c4dab9a87f..0cf098e787ee 100644
--- a/lib/matplotlib/tests/test_colorbar.py
+++ b/lib/matplotlib/tests/test_colorbar.py
@@ -15,7 +15,7 @@
     BoundaryNorm, LogNorm, PowerNorm, Normalize, NoNorm
 )
 from matplotlib.colorbar import Colorbar
-from matplotlib.ticker import FixedLocator, LogFormatter
+from matplotlib.ticker import FixedLocator, LogFormatter, StrMethodFormatter
 from matplotlib.testing.decorators import check_figures_equal
 
 
@@ -1230,3 +1230,9 @@ def test_colorbar_wrong_figure():
     fig_tl.colorbar(im)
     fig_tl.draw_without_rendering()
     fig_cl.draw_without_rendering()
+
+
+def test_colorbar_format_string_and_old():
+    plt.imshow([[0, 1]])
+    cb = plt.colorbar(format="{x}%")
+    assert isinstance(cb._formatter, StrMethodFormatter)

From 38a17d681a16a8499694a26854971ca24df13f49 Mon Sep 17 00:00:00 2001
From: Augusto Borges <borges.augustoar@gmail.com>
Date: Thu, 5 Oct 2023 20:34:31 +0200
Subject: [PATCH 0251/1120] Warning issued if handles and labels have a len
 mismatch when __len__ exists for both

New check for the no len case. Now artists are stored
---
 lib/matplotlib/legend.py            |  6 ++++++
 lib/matplotlib/tests/test_legend.py | 18 ++++++++++++++++++
 2 files changed, 24 insertions(+)

diff --git a/lib/matplotlib/legend.py b/lib/matplotlib/legend.py
index 14249cb73442..58e5dfcfe3b8 100644
--- a/lib/matplotlib/legend.py
+++ b/lib/matplotlib/legend.py
@@ -1337,6 +1337,12 @@ def _parse_legend_args(axs, *args, handles=None, labels=None, **kwargs):
         _api.warn_external("You have mixed positional and keyword arguments, "
                            "some input may be discarded.")
 
+    if (hasattr(handles, "__len__") and
+            hasattr(labels, "__len__") and
+            len(handles) != len(labels)):
+        _api.warn_external(f"Mismatched number of handles and labels: "
+                           f"len(handles) = {len(handles)} "
+                           f"len(labels) = {len(labels)}")
     # if got both handles and labels as kwargs, make same length
     if handles and labels:
         handles, labels = zip(*zip(handles, labels))
diff --git a/lib/matplotlib/tests/test_legend.py b/lib/matplotlib/tests/test_legend.py
index 1549354ba56b..3a35b4051c71 100644
--- a/lib/matplotlib/tests/test_legend.py
+++ b/lib/matplotlib/tests/test_legend.py
@@ -1357,3 +1357,21 @@ def test_loc_validation_string_value():
     ax.legend(loc='upper center')
     with pytest.raises(ValueError, match="'wrong' is not a valid value for"):
         ax.legend(loc='wrong')
+
+
+def test_legend_handle_label_mismatch():
+    pl1, = plt.plot(range(10))
+    pl2, = plt.plot(range(10))
+    with pytest.warns(UserWarning, match="number of handles and labels"):
+        legend = plt.legend(handles=[pl1, pl2], labels=["pl1", "pl2", "pl3"])
+        assert len(legend.legend_handles) == 2
+        assert len(legend.get_texts()) == 2
+
+
+def test_legend_handle_label_mismatch_no_len():
+    pl1, = plt.plot(range(10))
+    pl2, = plt.plot(range(10))
+    legend = plt.legend(handles=iter([pl1, pl2]),
+                        labels=iter(["pl1", "pl2", "pl3"]))
+    assert len(legend.legend_handles) == 2
+    assert len(legend.get_texts()) == 2

From 04347743c7a2850ca85da0259ec92e78fa3bb9e4 Mon Sep 17 00:00:00 2001
From: Koustav Ghosh <ghosh.hardkots.koustav1@gmail.com>
Date: Sun, 8 Oct 2023 19:29:54 +0530
Subject: [PATCH 0252/1120] Add test_bar in test_datetime

---
 lib/matplotlib/tests/test_datetime.py | 19 ++++++++++++++++---
 1 file changed, 16 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 53958229f174..2566baad27d1 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -62,11 +62,24 @@ def test_axvspan(self):
         fig, ax = plt.subplots()
         ax.axvspan(...)
 
-    @pytest.mark.xfail(reason="Test for bar not written yet")
     @mpl.style.context("default")
     def test_bar(self):
-        fig, ax = plt.subplots()
-        ax.bar(...)
+        mpl.rcParams["date.converter"] = "concise"
+        range_threshold = 10
+        fig, (ax1, ax2, ax3) = plt.subplots(3, 1, layout="constrained")
+
+        x_dates = np.array(
+            [datetime.datetime(2023, 10, delta) for delta in range(1, range_threshold)]
+        )
+        y_dates = np.array(
+            [datetime.datetime(2023, 10, delta) for delta in range(1, range_threshold)]
+        )
+        x_ranges = np.array(range(1, range_threshold))
+        y_ranges = np.array(range(1, range_threshold))
+
+        ax1.bar(x_dates, y_ranges)
+        ax2.bar(x_dates, y_dates)
+        ax3.bar(x_ranges, y_dates)
 
     @pytest.mark.xfail(reason="Test for bar_label not written yet")
     @mpl.style.context("default")

From 7d89a388a188a6181d2df498ff8c2fb001f3389d Mon Sep 17 00:00:00 2001
From: Jody Klymak <jklymak@gmail.com>
Date: Fri, 6 Oct 2023 08:03:55 -0700
Subject: [PATCH 0253/1120] DOC: clarify usetex versus mathtext [ci doc]

---
 doc/users/prev_whats_new/whats_new_3.8.0.rst |  4 ++++
 galleries/users_explain/text/mathtext.py     | 14 +++++++++-----
 2 files changed, 13 insertions(+), 5 deletions(-)

diff --git a/doc/users/prev_whats_new/whats_new_3.8.0.rst b/doc/users/prev_whats_new/whats_new_3.8.0.rst
index ab5a0dce85da..8c34252098db 100644
--- a/doc/users/prev_whats_new/whats_new_3.8.0.rst
+++ b/doc/users/prev_whats_new/whats_new_3.8.0.rst
@@ -327,6 +327,10 @@ This allows users to set the location of the legend in a more flexible and consi
 Mathtext improvements
 =====================
 
+Improvements are to Mathtext, Matplotlib's native TeX-like mathematics parser
+(see :ref:`mathtext`, not to be confused with Matplotlib using LaTeX directly:
+:ref:`usetex`).
+
 Boldsymbol mathtext command ``\boldsymbol``
 -------------------------------------------
 
diff --git a/galleries/users_explain/text/mathtext.py b/galleries/users_explain/text/mathtext.py
index 067a332aa54a..27aad440dcb5 100644
--- a/galleries/users_explain/text/mathtext.py
+++ b/galleries/users_explain/text/mathtext.py
@@ -8,11 +8,15 @@
 ================================
 
 Matplotlib implements a lightweight TeX expression parser and layout engine and
-*Mathtext* is the subset of Tex markup that this engine supports. Any string can
-be processed as Mathtext by placing the string inside a pair of dollar signs
-``'$'``. Mathtext often contains many backslashes ``'\'``; so that the backslashes
-do not need to be escaped, Mathtext is often written using raw strings. For
-example:
+*Mathtext* is the subset of Tex markup that this engine supports. Note that
+Matplotlib can also render all text directly using TeX if :rc:`text.usetex` is
+*True*; see :ref:`usetex` for more details.   Mathtext support is available
+if :rc:`text.usetex` is *False*.
+
+Any string can be processed as Mathtext by placing the string inside a pair of
+dollar signs ``'$'``. Mathtext often contains many backslashes ``'\'``; so that
+the backslashes do not need to be escaped, Mathtext is often written using raw
+strings. For example:
 """
 
 import matplotlib.pyplot as plt

From 0d17fb025b1d653e45b894bad3fbb7a165fdccb6 Mon Sep 17 00:00:00 2001
From: Abdul Razak Taha <rhaxaqi@gmail.com>
Date: Sun, 8 Oct 2023 23:43:23 +0000
Subject: [PATCH 0254/1120] Add a section to Highlight past winners for JDH
 plotting contest in docs (#27021)

* Update index.rst

Added a link to past winners for the JDH plotting contest in fixing issue #11129

* Update index.rst

changed formatting on JDH plotting link to RST syntax.

* changed description of PR and alignment contest items

realigned contest link, and author items under galleries section to render on same line
---
 doc/users/resources/index.rst | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/doc/users/resources/index.rst b/doc/users/resources/index.rst
index a2c4ccd4a7fc..77010f176048 100644
--- a/doc/users/resources/index.rst
+++ b/doc/users/resources/index.rst
@@ -71,10 +71,6 @@ Videos
 Tutorials
 =========
 
-
-* `The Python Graph Gallery <https://www.python-graph-gallery.com>`_
-  by Yan Holtz
-
 * `Matplotlib tutorial <https://www.labri.fr/perso/nrougier/teaching/matplotlib/>`_
   by Nicolas P. Rougier
 
@@ -85,3 +81,13 @@ Tutorials
 * `Beyond the Basics: Data Visualization in Python
   <https://github.com/stefmolin/python-data-viz-workshop>`_
   by Stefanie Molin
+
+=========
+Galleries
+=========
+
+* `Past winners for JDH plotting contest <https://jhepc.github.io/gallery.html>`_
+  by Nelle Varoquaux
+
+* `The Python Graph Gallery <https://www.python-graph-gallery.com>`_
+  by Yan Holtz

From 05035bae9f9513ec49c330bba72872f5627beed7 Mon Sep 17 00:00:00 2001
From: Ratnabali Dutta <ratnabalidutta26@gmail.com>
Date: Thu, 14 Sep 2023 22:39:23 +0530
Subject: [PATCH 0255/1120] Add mypy overloading to stix table

Co-authored-by: Kyle Sunden <git@ksunden.space>
---
 lib/matplotlib/_mathtext_data.py | 749 ++++++++++++++++++++++++-------
 1 file changed, 598 insertions(+), 151 deletions(-)

diff --git a/lib/matplotlib/_mathtext_data.py b/lib/matplotlib/_mathtext_data.py
index baaee1b876da..764555def495 100644
--- a/lib/matplotlib/_mathtext_data.py
+++ b/lib/matplotlib/_mathtext_data.py
@@ -3,7 +3,7 @@
 """
 
 from __future__ import annotations
-
+from typing import overload
 
 latex_to_bakoma = {
     '\\__sqrt__'                 : ('cmex10', 0x70),
@@ -1112,197 +1112,644 @@
 
 # Each element is a 4-tuple of the form:
 #   src_start, src_end, dst_font, dst_start
-#
-stix_virtual_fonts: dict[str, dict[str, list[tuple[int, int, str, int]]] |
-                              list[tuple[int, int, str, int]]] = {
+
+_EntryTypeIn = tuple[str, str, str, str | int]
+_EntryTypeOut = tuple[int, int, str, int]
+
+_stix_virtual_fonts: dict[str, dict[str, list[_EntryTypeIn]] |
+                               list[_EntryTypeIn]] = {
     'bb':
         {
-        'rm':
+        "rm":
             [
-            (0x0030, 0x0039, 'rm', 0x1d7d8), # 0-9
-            (0x0041, 0x0042, 'rm', 0x1d538), # A-B
-            (0x0043, 0x0043, 'rm', 0x2102),  # C
-            (0x0044, 0x0047, 'rm', 0x1d53b), # D-G
-            (0x0048, 0x0048, 'rm', 0x210d),  # H
-            (0x0049, 0x004d, 'rm', 0x1d540), # I-M
-            (0x004e, 0x004e, 'rm', 0x2115),  # N
-            (0x004f, 0x004f, 'rm', 0x1d546), # O
-            (0x0050, 0x0051, 'rm', 0x2119),  # P-Q
-            (0x0052, 0x0052, 'rm', 0x211d),  # R
-            (0x0053, 0x0059, 'rm', 0x1d54a), # S-Y
-            (0x005a, 0x005a, 'rm', 0x2124),  # Z
-            (0x0061, 0x007a, 'rm', 0x1d552), # a-z
-            (0x0393, 0x0393, 'rm', 0x213e),  # \Gamma
-            (0x03a0, 0x03a0, 'rm', 0x213f),  # \Pi
-            (0x03a3, 0x03a3, 'rm', 0x2140),  # \Sigma
-            (0x03b3, 0x03b3, 'rm', 0x213d),  # \gamma
-            (0x03c0, 0x03c0, 'rm', 0x213c),  # \pi
+            ("\N{DIGIT ZERO}",
+             "\N{DIGIT NINE}",
+             "rm",
+             "\N{MATHEMATICAL DOUBLE-STRUCK DIGIT ZERO}"),
+            ("\N{LATIN CAPITAL LETTER A}",
+             "\N{LATIN CAPITAL LETTER B}",
+             "rm",
+             "\N{MATHEMATICAL DOUBLE-STRUCK CAPITAL A}"),
+            ("\N{LATIN CAPITAL LETTER C}",
+             "\N{LATIN CAPITAL LETTER C}",
+             "rm",
+             "\N{DOUBLE-STRUCK CAPITAL C}"),
+            ("\N{LATIN CAPITAL LETTER D}",
+             "\N{LATIN CAPITAL LETTER G}",
+             "rm",
+             "\N{MATHEMATICAL DOUBLE-STRUCK CAPITAL D}"),
+            ("\N{LATIN CAPITAL LETTER H}",
+             "\N{LATIN CAPITAL LETTER H}",
+             "rm",
+             "\N{DOUBLE-STRUCK CAPITAL H}"),
+            ("\N{LATIN CAPITAL LETTER I}",
+             "\N{LATIN CAPITAL LETTER M}",
+             "rm",
+             "\N{MATHEMATICAL DOUBLE-STRUCK CAPITAL I}"),
+            ("\N{LATIN CAPITAL LETTER N}",
+             "\N{LATIN CAPITAL LETTER N}",
+             "rm",
+             "\N{DOUBLE-STRUCK CAPITAL N}"),
+            ("\N{LATIN CAPITAL LETTER O}",
+             "\N{LATIN CAPITAL LETTER O}",
+             "rm",
+             "\N{MATHEMATICAL DOUBLE-STRUCK CAPITAL O}"),
+            ("\N{LATIN CAPITAL LETTER P}",
+             "\N{LATIN CAPITAL LETTER Q}",
+             "rm",
+             "\N{DOUBLE-STRUCK CAPITAL P}"),
+            ("\N{LATIN CAPITAL LETTER R}",
+             "\N{LATIN CAPITAL LETTER R}",
+             "rm",
+             "\N{DOUBLE-STRUCK CAPITAL R}"),
+            ("\N{LATIN CAPITAL LETTER S}",
+             "\N{LATIN CAPITAL LETTER Y}",
+             "rm",
+             "\N{MATHEMATICAL DOUBLE-STRUCK CAPITAL S}"),
+            ("\N{LATIN CAPITAL LETTER Z}",
+             "\N{LATIN CAPITAL LETTER Z}",
+             "rm",
+             "\N{DOUBLE-STRUCK CAPITAL Z}"),
+            ("\N{LATIN SMALL LETTER A}",
+             "\N{LATIN SMALL LETTER Z}",
+             "rm",
+             "\N{MATHEMATICAL DOUBLE-STRUCK SMALL A}"),
+            ("\N{GREEK CAPITAL LETTER GAMMA}",
+             "\N{GREEK CAPITAL LETTER GAMMA}",
+             "rm",
+             "\N{DOUBLE-STRUCK CAPITAL GAMMA}"),
+            ("\N{GREEK CAPITAL LETTER PI}",
+             "\N{GREEK CAPITAL LETTER PI}",
+             "rm",
+             "\N{DOUBLE-STRUCK CAPITAL PI}"),
+            ("\N{GREEK CAPITAL LETTER SIGMA}",
+             "\N{GREEK CAPITAL LETTER SIGMA}",
+             "rm",
+             "\N{DOUBLE-STRUCK N-ARY SUMMATION}"),
+            ("\N{GREEK SMALL LETTER GAMMA}",
+             "\N{GREEK SMALL LETTER GAMMA}",
+             "rm",
+             "\N{DOUBLE-STRUCK SMALL GAMMA}"),
+            ("\N{GREEK SMALL LETTER PI}",
+             "\N{GREEK SMALL LETTER PI}",
+             "rm",
+             "\N{DOUBLE-STRUCK SMALL PI}"),
             ],
-        'it':
+        "it":
             [
-            (0x0030, 0x0039, 'rm', 0x1d7d8), # 0-9
-            (0x0041, 0x0042, 'it', 0xe154),  # A-B
-            (0x0043, 0x0043, 'it', 0x2102),  # C
-            (0x0044, 0x0044, 'it', 0x2145),  # D
-            (0x0045, 0x0047, 'it', 0xe156),  # E-G
-            (0x0048, 0x0048, 'it', 0x210d),  # H
-            (0x0049, 0x004d, 'it', 0xe159),  # I-M
-            (0x004e, 0x004e, 'it', 0x2115),  # N
-            (0x004f, 0x004f, 'it', 0xe15e),  # O
-            (0x0050, 0x0051, 'it', 0x2119),  # P-Q
-            (0x0052, 0x0052, 'it', 0x211d),  # R
-            (0x0053, 0x0059, 'it', 0xe15f),  # S-Y
-            (0x005a, 0x005a, 'it', 0x2124),  # Z
-            (0x0061, 0x0063, 'it', 0xe166),  # a-c
-            (0x0064, 0x0065, 'it', 0x2146),  # d-e
-            (0x0066, 0x0068, 'it', 0xe169),  # f-h
-            (0x0069, 0x006a, 'it', 0x2148),  # i-j
-            (0x006b, 0x007a, 'it', 0xe16c),  # k-z
-            (0x0393, 0x0393, 'it', 0x213e),  # \Gamma (not in beta STIX fonts)
-            (0x03a0, 0x03a0, 'it', 0x213f),  # \Pi
-            (0x03a3, 0x03a3, 'it', 0x2140),  # \Sigma (not in beta STIX fonts)
-            (0x03b3, 0x03b3, 'it', 0x213d),  # \gamma (not in beta STIX fonts)
-            (0x03c0, 0x03c0, 'it', 0x213c),  # \pi
+            ("\N{DIGIT ZERO}",
+             "\N{DIGIT NINE}",
+             "rm",
+             "\N{MATHEMATICAL DOUBLE-STRUCK DIGIT ZERO}"),
+            ("\N{LATIN CAPITAL LETTER A}",
+             "\N{LATIN CAPITAL LETTER B}",
+             "it",
+             0xe154),
+            ("\N{LATIN CAPITAL LETTER C}",
+             "\N{LATIN CAPITAL LETTER C}",
+             "it",
+             "\N{DOUBLE-STRUCK CAPITAL C}"),
+            ("\N{LATIN CAPITAL LETTER D}",
+             "\N{LATIN CAPITAL LETTER D}",
+             "it",
+             "\N{DOUBLE-STRUCK ITALIC CAPITAL D}"),
+            ("\N{LATIN CAPITAL LETTER E}",
+             "\N{LATIN CAPITAL LETTER G}",
+             "it",
+             0xe156),
+            ("\N{LATIN CAPITAL LETTER H}",
+             "\N{LATIN CAPITAL LETTER H}",
+             "it",
+             "\N{DOUBLE-STRUCK CAPITAL H}"),
+            ("\N{LATIN CAPITAL LETTER I}",
+             "\N{LATIN CAPITAL LETTER M}",
+             "it",
+             0xe159),
+            ("\N{LATIN CAPITAL LETTER N}",
+             "\N{LATIN CAPITAL LETTER N}",
+             "it",
+             "\N{DOUBLE-STRUCK CAPITAL N}"),
+            ("\N{LATIN CAPITAL LETTER O}",
+             "\N{LATIN CAPITAL LETTER O}",
+             "it",
+             0xe15e),
+            ("\N{LATIN CAPITAL LETTER P}",
+             "\N{LATIN CAPITAL LETTER Q}",
+             "it",
+             "\N{DOUBLE-STRUCK CAPITAL P}"),
+            ("\N{LATIN CAPITAL LETTER R}",
+             "\N{LATIN CAPITAL LETTER R}",
+             "it",
+             "\N{DOUBLE-STRUCK CAPITAL R}"),
+            ("\N{LATIN CAPITAL LETTER S}",
+             "\N{LATIN CAPITAL LETTER Y}",
+             "it",
+             0xe15f),
+            ("\N{LATIN CAPITAL LETTER Z}",
+             "\N{LATIN CAPITAL LETTER Z}",
+             "it",
+             "\N{DOUBLE-STRUCK CAPITAL Z}"),
+            ("\N{LATIN SMALL LETTER A}",
+             "\N{LATIN SMALL LETTER C}",
+             "it",
+             0xe166),
+            ("\N{LATIN SMALL LETTER D}",
+             "\N{LATIN SMALL LETTER E}",
+             "it",
+             "\N{DOUBLE-STRUCK ITALIC SMALL D}"),
+            ("\N{LATIN SMALL LETTER F}",
+             "\N{LATIN SMALL LETTER H}",
+             "it",
+             0xe169),
+            ("\N{LATIN SMALL LETTER I}",
+             "\N{LATIN SMALL LETTER J}",
+             "it",
+             "\N{DOUBLE-STRUCK ITALIC SMALL I}"),
+            ("\N{LATIN SMALL LETTER K}",
+             "\N{LATIN SMALL LETTER Z}",
+             "it",
+             0xe16c),
+            ("\N{GREEK CAPITAL LETTER GAMMA}",
+             "\N{GREEK CAPITAL LETTER GAMMA}",
+             "it",
+             "\N{DOUBLE-STRUCK CAPITAL GAMMA}"),  # \Gamma (not in beta STIX fonts)
+            ("\N{GREEK CAPITAL LETTER PI}",
+             "\N{GREEK CAPITAL LETTER PI}",
+             "it",
+             "\N{DOUBLE-STRUCK CAPITAL PI}"),
+            ("\N{GREEK CAPITAL LETTER SIGMA}",
+             "\N{GREEK CAPITAL LETTER SIGMA}",
+             "it",
+             "\N{DOUBLE-STRUCK N-ARY SUMMATION}"),  # \Sigma (not in beta STIX fonts)
+            ("\N{GREEK SMALL LETTER GAMMA}",
+             "\N{GREEK SMALL LETTER GAMMA}",
+             "it",
+             "\N{DOUBLE-STRUCK SMALL GAMMA}"),  # \gamma (not in beta STIX fonts)
+            ("\N{GREEK SMALL LETTER PI}",
+             "\N{GREEK SMALL LETTER PI}",
+             "it",
+             "\N{DOUBLE-STRUCK SMALL PI}"),
             ],
-        'bf':
+        "bf":
             [
-            (0x0030, 0x0039, 'rm', 0x1d7d8), # 0-9
-            (0x0041, 0x0042, 'bf', 0xe38a),  # A-B
-            (0x0043, 0x0043, 'bf', 0x2102),  # C
-            (0x0044, 0x0044, 'bf', 0x2145),  # D
-            (0x0045, 0x0047, 'bf', 0xe38d),  # E-G
-            (0x0048, 0x0048, 'bf', 0x210d),  # H
-            (0x0049, 0x004d, 'bf', 0xe390),  # I-M
-            (0x004e, 0x004e, 'bf', 0x2115),  # N
-            (0x004f, 0x004f, 'bf', 0xe395),  # O
-            (0x0050, 0x0051, 'bf', 0x2119),  # P-Q
-            (0x0052, 0x0052, 'bf', 0x211d),  # R
-            (0x0053, 0x0059, 'bf', 0xe396),  # S-Y
-            (0x005a, 0x005a, 'bf', 0x2124),  # Z
-            (0x0061, 0x0063, 'bf', 0xe39d),  # a-c
-            (0x0064, 0x0065, 'bf', 0x2146),  # d-e
-            (0x0066, 0x0068, 'bf', 0xe3a2),  # f-h
-            (0x0069, 0x006a, 'bf', 0x2148),  # i-j
-            (0x006b, 0x007a, 'bf', 0xe3a7),  # k-z
-            (0x0393, 0x0393, 'bf', 0x213e),  # \Gamma
-            (0x03a0, 0x03a0, 'bf', 0x213f),  # \Pi
-            (0x03a3, 0x03a3, 'bf', 0x2140),  # \Sigma
-            (0x03b3, 0x03b3, 'bf', 0x213d),  # \gamma
-            (0x03c0, 0x03c0, 'bf', 0x213c),  # \pi
+            ("\N{DIGIT ZERO}",
+             "\N{DIGIT NINE}",
+             "rm",
+             "\N{MATHEMATICAL DOUBLE-STRUCK DIGIT ZERO}"),
+            ("\N{LATIN CAPITAL LETTER A}",
+             "\N{LATIN CAPITAL LETTER B}",
+             "bf",
+             0xe38a),
+            ("\N{LATIN CAPITAL LETTER C}",
+             "\N{LATIN CAPITAL LETTER C}",
+             "bf",
+             "\N{DOUBLE-STRUCK CAPITAL C}"),
+            ("\N{LATIN CAPITAL LETTER D}",
+             "\N{LATIN CAPITAL LETTER D}",
+             "bf",
+             "\N{DOUBLE-STRUCK ITALIC CAPITAL D}"),
+            ("\N{LATIN CAPITAL LETTER E}",
+             "\N{LATIN CAPITAL LETTER G}",
+             "bf",
+             0xe38d),
+            ("\N{LATIN CAPITAL LETTER H}",
+             "\N{LATIN CAPITAL LETTER H}",
+             "bf",
+             "\N{DOUBLE-STRUCK CAPITAL H}"),
+            ("\N{LATIN CAPITAL LETTER I}",
+             "\N{LATIN CAPITAL LETTER M}",
+             "bf",
+             0xe390),
+            ("\N{LATIN CAPITAL LETTER N}",
+             "\N{LATIN CAPITAL LETTER N}",
+             "bf",
+             "\N{DOUBLE-STRUCK CAPITAL N}"),
+            ("\N{LATIN CAPITAL LETTER O}",
+             "\N{LATIN CAPITAL LETTER O}",
+             "bf",
+             0xe395),
+            ("\N{LATIN CAPITAL LETTER P}",
+             "\N{LATIN CAPITAL LETTER Q}",
+             "bf",
+             "\N{DOUBLE-STRUCK CAPITAL P}"),
+            ("\N{LATIN CAPITAL LETTER R}",
+             "\N{LATIN CAPITAL LETTER R}",
+             "bf",
+             "\N{DOUBLE-STRUCK CAPITAL R}"),
+            ("\N{LATIN CAPITAL LETTER S}",
+             "\N{LATIN CAPITAL LETTER Y}",
+             "bf",
+             0xe396),
+            ("\N{LATIN CAPITAL LETTER Z}",
+             "\N{LATIN CAPITAL LETTER Z}",
+             "bf",
+             "\N{DOUBLE-STRUCK CAPITAL Z}"),
+            ("\N{LATIN SMALL LETTER A}",
+             "\N{LATIN SMALL LETTER C}",
+             "bf",
+             0xe39d),
+            ("\N{LATIN SMALL LETTER D}",
+             "\N{LATIN SMALL LETTER E}",
+             "bf",
+             "\N{DOUBLE-STRUCK ITALIC SMALL D}"),
+            ("\N{LATIN SMALL LETTER F}",
+             "\N{LATIN SMALL LETTER H}",
+             "bf",
+             0xe3a2),
+            ("\N{LATIN SMALL LETTER I}",
+             "\N{LATIN SMALL LETTER J}",
+             "bf",
+             "\N{DOUBLE-STRUCK ITALIC SMALL I}"),
+            ("\N{LATIN SMALL LETTER K}",
+             "\N{LATIN SMALL LETTER Z}",
+             "bf",
+             0xe3a7),
+            ("\N{GREEK CAPITAL LETTER GAMMA}",
+             "\N{GREEK CAPITAL LETTER GAMMA}",
+             "bf",
+             "\N{DOUBLE-STRUCK CAPITAL GAMMA}"),
+            ("\N{GREEK CAPITAL LETTER PI}",
+             "\N{GREEK CAPITAL LETTER PI}",
+             "bf",
+             "\N{DOUBLE-STRUCK CAPITAL PI}"),
+            ("\N{GREEK CAPITAL LETTER SIGMA}",
+             "\N{GREEK CAPITAL LETTER SIGMA}",
+             "bf",
+             "\N{DOUBLE-STRUCK N-ARY SUMMATION}"),
+            ("\N{GREEK SMALL LETTER GAMMA}",
+             "\N{GREEK SMALL LETTER GAMMA}",
+             "bf",
+             "\N{DOUBLE-STRUCK SMALL GAMMA}"),
+            ("\N{GREEK SMALL LETTER PI}",
+             "\N{GREEK SMALL LETTER PI}",
+             "bf",
+             "\N{DOUBLE-STRUCK SMALL PI}"),
             ],
         },
     'cal':
         [
-        (0x0041, 0x005a, 'it', 0xe22d), # A-Z
+        ("\N{LATIN CAPITAL LETTER A}",
+         "\N{LATIN CAPITAL LETTER Z}",
+         "it",
+         0xe22d),
         ],
     'frak':
         {
-        'rm':
+        "rm":
             [
-            (0x0041, 0x0042, 'rm', 0x1d504), # A-B
-            (0x0043, 0x0043, 'rm', 0x212d),  # C
-            (0x0044, 0x0047, 'rm', 0x1d507), # D-G
-            (0x0048, 0x0048, 'rm', 0x210c),  # H
-            (0x0049, 0x0049, 'rm', 0x2111),  # I
-            (0x004a, 0x0051, 'rm', 0x1d50d), # J-Q
-            (0x0052, 0x0052, 'rm', 0x211c),  # R
-            (0x0053, 0x0059, 'rm', 0x1d516), # S-Y
-            (0x005a, 0x005a, 'rm', 0x2128),  # Z
-            (0x0061, 0x007a, 'rm', 0x1d51e), # a-z
+            ("\N{LATIN CAPITAL LETTER A}",
+             "\N{LATIN CAPITAL LETTER B}",
+             "rm",
+             "\N{MATHEMATICAL FRAKTUR CAPITAL A}"),
+            ("\N{LATIN CAPITAL LETTER C}",
+             "\N{LATIN CAPITAL LETTER C}",
+             "rm",
+             "\N{BLACK-LETTER CAPITAL C}"),
+            ("\N{LATIN CAPITAL LETTER D}",
+             "\N{LATIN CAPITAL LETTER G}",
+             "rm",
+             "\N{MATHEMATICAL FRAKTUR CAPITAL D}"),
+            ("\N{LATIN CAPITAL LETTER H}",
+             "\N{LATIN CAPITAL LETTER H}",
+             "rm",
+             "\N{BLACK-LETTER CAPITAL H}"),
+            ("\N{LATIN CAPITAL LETTER I}",
+             "\N{LATIN CAPITAL LETTER I}",
+             "rm",
+             "\N{BLACK-LETTER CAPITAL I}"),
+            ("\N{LATIN CAPITAL LETTER J}",
+             "\N{LATIN CAPITAL LETTER Q}",
+             "rm",
+             "\N{MATHEMATICAL FRAKTUR CAPITAL J}"),
+            ("\N{LATIN CAPITAL LETTER R}",
+             "\N{LATIN CAPITAL LETTER R}",
+             "rm",
+             "\N{BLACK-LETTER CAPITAL R}"),
+            ("\N{LATIN CAPITAL LETTER S}",
+             "\N{LATIN CAPITAL LETTER Y}",
+             "rm",
+             "\N{MATHEMATICAL FRAKTUR CAPITAL S}"),
+            ("\N{LATIN CAPITAL LETTER Z}",
+             "\N{LATIN CAPITAL LETTER Z}",
+             "rm",
+             "\N{BLACK-LETTER CAPITAL Z}"),
+            ("\N{LATIN SMALL LETTER A}",
+             "\N{LATIN SMALL LETTER Z}",
+             "rm",
+             "\N{MATHEMATICAL FRAKTUR SMALL A}"),
             ],
-        'bf':
+        "bf":
             [
-            (0x0041, 0x005a, 'bf', 0x1d56c), # A-Z
-            (0x0061, 0x007a, 'bf', 0x1d586), # a-z
+            ("\N{LATIN CAPITAL LETTER A}",
+             "\N{LATIN CAPITAL LETTER Z}",
+             "bf",
+             "\N{MATHEMATICAL BOLD FRAKTUR CAPITAL A}"),
+            ("\N{LATIN SMALL LETTER A}",
+             "\N{LATIN SMALL LETTER Z}",
+             "bf",
+             "\N{MATHEMATICAL BOLD FRAKTUR SMALL A}"),
             ],
         },
     'scr':
         [
-        (0x0041, 0x0041, 'it', 0x1d49c), # A
-        (0x0042, 0x0042, 'it', 0x212c),  # B
-        (0x0043, 0x0044, 'it', 0x1d49e), # C-D
-        (0x0045, 0x0046, 'it', 0x2130),  # E-F
-        (0x0047, 0x0047, 'it', 0x1d4a2), # G
-        (0x0048, 0x0048, 'it', 0x210b),  # H
-        (0x0049, 0x0049, 'it', 0x2110),  # I
-        (0x004a, 0x004b, 'it', 0x1d4a5), # J-K
-        (0x004c, 0x004c, 'it', 0x2112),  # L
-        (0x004d, 0x004d, 'it', 0x2133),  # M
-        (0x004e, 0x0051, 'it', 0x1d4a9), # N-Q
-        (0x0052, 0x0052, 'it', 0x211b),  # R
-        (0x0053, 0x005a, 'it', 0x1d4ae), # S-Z
-        (0x0061, 0x0064, 'it', 0x1d4b6), # a-d
-        (0x0065, 0x0065, 'it', 0x212f),  # e
-        (0x0066, 0x0066, 'it', 0x1d4bb), # f
-        (0x0067, 0x0067, 'it', 0x210a),  # g
-        (0x0068, 0x006e, 'it', 0x1d4bd), # h-n
-        (0x006f, 0x006f, 'it', 0x2134),  # o
-        (0x0070, 0x007a, 'it', 0x1d4c5), # p-z
+        ("\N{LATIN CAPITAL LETTER A}",
+         "\N{LATIN CAPITAL LETTER A}",
+         "it",
+         "\N{MATHEMATICAL SCRIPT CAPITAL A}"),
+        ("\N{LATIN CAPITAL LETTER B}",
+         "\N{LATIN CAPITAL LETTER B}",
+         "it",
+         "\N{SCRIPT CAPITAL B}"),
+        ("\N{LATIN CAPITAL LETTER C}",
+         "\N{LATIN CAPITAL LETTER D}",
+         "it",
+         "\N{MATHEMATICAL SCRIPT CAPITAL C}"),
+        ("\N{LATIN CAPITAL LETTER E}",
+         "\N{LATIN CAPITAL LETTER F}",
+         "it",
+         "\N{SCRIPT CAPITAL E}"),
+        ("\N{LATIN CAPITAL LETTER G}",
+         "\N{LATIN CAPITAL LETTER G}",
+         "it",
+         "\N{MATHEMATICAL SCRIPT CAPITAL G}"),
+        ("\N{LATIN CAPITAL LETTER H}",
+         "\N{LATIN CAPITAL LETTER H}",
+         "it",
+         "\N{SCRIPT CAPITAL H}"),
+        ("\N{LATIN CAPITAL LETTER I}",
+         "\N{LATIN CAPITAL LETTER I}",
+         "it",
+         "\N{SCRIPT CAPITAL I}"),
+        ("\N{LATIN CAPITAL LETTER J}",
+         "\N{LATIN CAPITAL LETTER K}",
+         "it",
+         "\N{MATHEMATICAL SCRIPT CAPITAL J}"),
+        ("\N{LATIN CAPITAL LETTER L}",
+         "\N{LATIN CAPITAL LETTER L}",
+         "it",
+         "\N{SCRIPT CAPITAL L}"),
+        ("\N{LATIN CAPITAL LETTER M}",
+         "\N{LATIN CAPITAL LETTER M}",
+         "it",
+         "\N{SCRIPT CAPITAL M}"),
+        ("\N{LATIN CAPITAL LETTER N}",
+         "\N{LATIN CAPITAL LETTER Q}",
+         "it",
+         "\N{MATHEMATICAL SCRIPT CAPITAL N}"),
+        ("\N{LATIN CAPITAL LETTER R}",
+         "\N{LATIN CAPITAL LETTER R}",
+         "it",
+         "\N{SCRIPT CAPITAL R}"),
+        ("\N{LATIN CAPITAL LETTER S}",
+         "\N{LATIN CAPITAL LETTER Z}",
+         "it",
+         "\N{MATHEMATICAL SCRIPT CAPITAL S}"),
+        ("\N{LATIN SMALL LETTER A}",
+         "\N{LATIN SMALL LETTER D}",
+         "it",
+         "\N{MATHEMATICAL SCRIPT SMALL A}"),
+        ("\N{LATIN SMALL LETTER E}",
+         "\N{LATIN SMALL LETTER E}",
+         "it",
+         "\N{SCRIPT SMALL E}"),
+        ("\N{LATIN SMALL LETTER F}",
+         "\N{LATIN SMALL LETTER F}",
+         "it",
+         "\N{MATHEMATICAL SCRIPT SMALL F}"),
+        ("\N{LATIN SMALL LETTER G}",
+         "\N{LATIN SMALL LETTER G}",
+         "it",
+         "\N{SCRIPT SMALL G}"),
+        ("\N{LATIN SMALL LETTER H}",
+         "\N{LATIN SMALL LETTER N}",
+         "it",
+         "\N{MATHEMATICAL SCRIPT SMALL H}"),
+        ("\N{LATIN SMALL LETTER O}",
+         "\N{LATIN SMALL LETTER O}",
+         "it",
+         "\N{SCRIPT SMALL O}"),
+        ("\N{LATIN SMALL LETTER P}",
+         "\N{LATIN SMALL LETTER Z}",
+         "it",
+         "\N{MATHEMATICAL SCRIPT SMALL P}"),
         ],
     'sf':
         {
-        'rm':
+        "rm":
             [
-            (0x0030, 0x0039, 'rm', 0x1d7e2), # 0-9
-            (0x0041, 0x005a, 'rm', 0x1d5a0), # A-Z
-            (0x0061, 0x007a, 'rm', 0x1d5ba), # a-z
-            (0x0391, 0x03a9, 'rm', 0xe17d),  # \Alpha-\Omega
-            (0x03b1, 0x03c9, 'rm', 0xe196),  # \alpha-\omega
-            (0x03d1, 0x03d1, 'rm', 0xe1b0),  # theta variant
-            (0x03d5, 0x03d5, 'rm', 0xe1b1),  # phi variant
-            (0x03d6, 0x03d6, 'rm', 0xe1b3),  # pi variant
-            (0x03f1, 0x03f1, 'rm', 0xe1b2),  # rho variant
-            (0x03f5, 0x03f5, 'rm', 0xe1af),  # lunate epsilon
-            (0x2202, 0x2202, 'rm', 0xe17c),  # partial differential
+            ("\N{DIGIT ZERO}",
+             "\N{DIGIT NINE}",
+             "rm",
+             "\N{MATHEMATICAL SANS-SERIF DIGIT ZERO}"),
+            ("\N{LATIN CAPITAL LETTER A}",
+             "\N{LATIN CAPITAL LETTER Z}",
+             "rm",
+             "\N{MATHEMATICAL SANS-SERIF CAPITAL A}"),
+            ("\N{LATIN SMALL LETTER A}",
+             "\N{LATIN SMALL LETTER Z}",
+             "rm",
+             "\N{MATHEMATICAL SANS-SERIF SMALL A}"),
+            ("\N{GREEK CAPITAL LETTER ALPHA}",
+             "\N{GREEK CAPITAL LETTER OMEGA}",
+             "rm",
+             0xe17d),
+            ("\N{GREEK SMALL LETTER ALPHA}",
+             "\N{GREEK SMALL LETTER OMEGA}",
+             "rm",
+             0xe196),
+            ("\N{GREEK THETA SYMBOL}",
+             "\N{GREEK THETA SYMBOL}",
+             "rm",
+             0xe1b0),
+            ("\N{GREEK PHI SYMBOL}",
+             "\N{GREEK PHI SYMBOL}",
+             "rm",
+             0xe1b1),
+            ("\N{GREEK PI SYMBOL}",
+             "\N{GREEK PI SYMBOL}",
+             "rm",
+             0xe1b3),
+            ("\N{GREEK RHO SYMBOL}",
+             "\N{GREEK RHO SYMBOL}",
+             "rm",
+             0xe1b2),
+            ("\N{GREEK LUNATE EPSILON SYMBOL}",
+             "\N{GREEK LUNATE EPSILON SYMBOL}",
+             "rm",
+             0xe1af),
+            ("\N{PARTIAL DIFFERENTIAL}",
+             "\N{PARTIAL DIFFERENTIAL}",
+             "rm",
+             0xe17c),
             ],
-        'it':
+        "it":
             [
             # These numerals are actually upright.  We don't actually
             # want italic numerals ever.
-            (0x0030, 0x0039, 'rm', 0x1d7e2), # 0-9
-            (0x0041, 0x005a, 'it', 0x1d608), # A-Z
-            (0x0061, 0x007a, 'it', 0x1d622), # a-z
-            (0x0391, 0x03a9, 'rm', 0xe17d),  # \Alpha-\Omega
-            (0x03b1, 0x03c9, 'it', 0xe1d8),  # \alpha-\omega
-            (0x03d1, 0x03d1, 'it', 0xe1f2),  # theta variant
-            (0x03d5, 0x03d5, 'it', 0xe1f3),  # phi variant
-            (0x03d6, 0x03d6, 'it', 0xe1f5),  # pi variant
-            (0x03f1, 0x03f1, 'it', 0xe1f4),  # rho variant
-            (0x03f5, 0x03f5, 'it', 0xe1f1),  # lunate epsilon
+            ("\N{DIGIT ZERO}",
+             "\N{DIGIT NINE}",
+             "rm",
+             "\N{MATHEMATICAL SANS-SERIF DIGIT ZERO}"),
+            ("\N{LATIN CAPITAL LETTER A}",
+             "\N{LATIN CAPITAL LETTER Z}",
+             "it",
+             "\N{MATHEMATICAL SANS-SERIF ITALIC CAPITAL A}"),
+            ("\N{LATIN SMALL LETTER A}",
+             "\N{LATIN SMALL LETTER Z}",
+             "it",
+             "\N{MATHEMATICAL SANS-SERIF ITALIC SMALL A}"),
+            ("\N{GREEK CAPITAL LETTER ALPHA}",
+             "\N{GREEK CAPITAL LETTER OMEGA}",
+             "rm",
+             0xe17d),
+            ("\N{GREEK SMALL LETTER ALPHA}",
+             "\N{GREEK SMALL LETTER OMEGA}",
+             "it",
+             0xe1d8),
+            ("\N{GREEK THETA SYMBOL}",
+             "\N{GREEK THETA SYMBOL}",
+             "it",
+             0xe1f2),
+            ("\N{GREEK PHI SYMBOL}",
+             "\N{GREEK PHI SYMBOL}",
+             "it",
+             0xe1f3),
+            ("\N{GREEK PI SYMBOL}",
+             "\N{GREEK PI SYMBOL}",
+             "it",
+             0xe1f5),
+            ("\N{GREEK RHO SYMBOL}",
+             "\N{GREEK RHO SYMBOL}",
+             "it",
+             0xe1f4),
+            ("\N{GREEK LUNATE EPSILON SYMBOL}",
+             "\N{GREEK LUNATE EPSILON SYMBOL}",
+             "it",
+             0xe1f1),
             ],
-        'bf':
+        "bf":
             [
-            (0x0030, 0x0039, 'bf', 0x1d7ec), # 0-9
-            (0x0041, 0x005a, 'bf', 0x1d5d4), # A-Z
-            (0x0061, 0x007a, 'bf', 0x1d5ee), # a-z
-            (0x0391, 0x03a9, 'bf', 0x1d756), # \Alpha-\Omega
-            (0x03b1, 0x03c9, 'bf', 0x1d770), # \alpha-\omega
-            (0x03d1, 0x03d1, 'bf', 0x1d78b), # theta variant
-            (0x03d5, 0x03d5, 'bf', 0x1d78d), # phi variant
-            (0x03d6, 0x03d6, 'bf', 0x1d78f), # pi variant
-            (0x03f0, 0x03f0, 'bf', 0x1d78c), # kappa variant
-            (0x03f1, 0x03f1, 'bf', 0x1d78e), # rho variant
-            (0x03f5, 0x03f5, 'bf', 0x1d78a), # lunate epsilon
-            (0x2202, 0x2202, 'bf', 0x1d789), # partial differential
-            (0x2207, 0x2207, 'bf', 0x1d76f), # \Nabla
+            ("\N{DIGIT ZERO}",
+             "\N{DIGIT NINE}",
+             "bf",
+             "\N{MATHEMATICAL SANS-SERIF BOLD DIGIT ZERO}"),
+            ("\N{LATIN CAPITAL LETTER A}",
+             "\N{LATIN CAPITAL LETTER Z}",
+             "bf",
+             "\N{MATHEMATICAL SANS-SERIF BOLD CAPITAL A}"),
+            ("\N{LATIN SMALL LETTER A}",
+             "\N{LATIN SMALL LETTER Z}",
+             "bf",
+             "\N{MATHEMATICAL SANS-SERIF BOLD SMALL A}"),
+            ("\N{GREEK CAPITAL LETTER ALPHA}",
+             "\N{GREEK CAPITAL LETTER OMEGA}",
+             "bf",
+             "\N{MATHEMATICAL SANS-SERIF BOLD CAPITAL ALPHA}"),
+            ("\N{GREEK SMALL LETTER ALPHA}",
+             "\N{GREEK SMALL LETTER OMEGA}",
+             "bf",
+             "\N{MATHEMATICAL SANS-SERIF BOLD SMALL ALPHA}"),
+            ("\N{GREEK THETA SYMBOL}",
+             "\N{GREEK THETA SYMBOL}",
+             "bf",
+             "\N{MATHEMATICAL SANS-SERIF BOLD THETA SYMBOL}"),
+            ("\N{GREEK PHI SYMBOL}",
+             "\N{GREEK PHI SYMBOL}",
+             "bf",
+             "\N{MATHEMATICAL SANS-SERIF BOLD PHI SYMBOL}"),
+            ("\N{GREEK PI SYMBOL}",
+             "\N{GREEK PI SYMBOL}",
+             "bf",
+             "\N{MATHEMATICAL SANS-SERIF BOLD PI SYMBOL}"),
+            ("\N{GREEK KAPPA SYMBOL}",
+             "\N{GREEK KAPPA SYMBOL}",
+             "bf",
+             "\N{MATHEMATICAL SANS-SERIF BOLD KAPPA SYMBOL}"),
+            ("\N{GREEK RHO SYMBOL}",
+             "\N{GREEK RHO SYMBOL}",
+             "bf",
+             "\N{MATHEMATICAL SANS-SERIF BOLD RHO SYMBOL}"),
+            ("\N{GREEK LUNATE EPSILON SYMBOL}",
+             "\N{GREEK LUNATE EPSILON SYMBOL}",
+             "bf",
+             "\N{MATHEMATICAL SANS-SERIF BOLD EPSILON SYMBOL}"),
+            ("\N{PARTIAL DIFFERENTIAL}",
+             "\N{PARTIAL DIFFERENTIAL}",
+             "bf",
+             "\N{MATHEMATICAL SANS-SERIF BOLD PARTIAL DIFFERENTIAL}"),
+            ("\N{NABLA}",
+             "\N{NABLA}",
+             "bf",
+             "\N{MATHEMATICAL SANS-SERIF BOLD NABLA}"),
             ],
-        'bfit':
+        "bfit":
             [
-            (0x0041, 0x005a, 'bfit', 0x1d468), # A-Z
-            (0x0061, 0x007a, 'bfit', 0x1d482), # a-z
-            (0x0393, 0x03a9, 'bfit', 0x1d71e), # \Gamma-\Omega
-            (0x03b1, 0x03c9, 'bfit', 0x1d736), # \alpha-\omega
+            ("\N{LATIN CAPITAL LETTER A}",
+             "\N{LATIN CAPITAL LETTER Z}",
+             "bfit",
+             "\N{MATHEMATICAL BOLD ITALIC CAPITAL A}"),
+            ("\N{LATIN SMALL LETTER A}",
+             "\N{LATIN SMALL LETTER Z}",
+             "bfit",
+             "\N{MATHEMATICAL BOLD ITALIC SMALL A}"),
+            ("\N{GREEK CAPITAL LETTER GAMMA}",
+             "\N{GREEK CAPITAL LETTER OMEGA}",
+             "bfit",
+             "\N{MATHEMATICAL BOLD ITALIC CAPITAL GAMMA}"),
+            ("\N{GREEK SMALL LETTER ALPHA}",
+             "\N{GREEK SMALL LETTER OMEGA}",
+             "bfit",
+             "\N{MATHEMATICAL BOLD ITALIC SMALL ALPHA}"),
             ],
         },
     'tt':
         [
-        (0x0030, 0x0039, 'rm', 0x1d7f6), # 0-9
-        (0x0041, 0x005a, 'rm', 0x1d670), # A-Z
-        (0x0061, 0x007a, 'rm', 0x1d68a)  # a-z
+        ("\N{DIGIT ZERO}",
+         "\N{DIGIT NINE}",
+         "rm",
+         "\N{MATHEMATICAL MONOSPACE DIGIT ZERO}"),
+        ("\N{LATIN CAPITAL LETTER A}",
+         "\N{LATIN CAPITAL LETTER Z}",
+         "rm",
+         "\N{MATHEMATICAL MONOSPACE CAPITAL A}"),
+        ("\N{LATIN SMALL LETTER A}",
+         "\N{LATIN SMALL LETTER Z}",
+         "rm",
+         "\N{MATHEMATICAL MONOSPACE SMALL A}")
         ],
     }
 
 
+@overload
+def _normalize_stix_fontcodes(d: _EntryTypeIn) -> _EntryTypeOut: ...
+
+
+@overload
+def _normalize_stix_fontcodes(d: list[_EntryTypeIn]) -> list[_EntryTypeOut]: ...
+
+
+@overload
+def _normalize_stix_fontcodes(d: dict[str, list[_EntryTypeIn] |
+                                      dict[str, list[_EntryTypeIn]]]
+                              ) -> dict[str, list[_EntryTypeOut] |
+                                        dict[str, list[_EntryTypeOut]]]: ...
+
+
+def _normalize_stix_fontcodes(d):
+    if isinstance(d, tuple):
+        return tuple(ord(x) if isinstance(x, str) and len(x) == 1 else x for x in d)
+    elif isinstance(d, list):
+        return [_normalize_stix_fontcodes(x) for x in d]
+    elif isinstance(d, dict):
+        return {k: _normalize_stix_fontcodes(v) for k, v in d.items()}
+
+
+stix_virtual_fonts: dict[str, dict[str, list[_EntryTypeOut]] | list[_EntryTypeOut]]
+stix_virtual_fonts = _normalize_stix_fontcodes(_stix_virtual_fonts)
+
+# Free redundant list now that it has been normalized
+del _stix_virtual_fonts
+
 # Fix some incorrect glyphs.
 stix_glyph_fixes = {
     # Cap and Cup glyphs are swapped.

From a7f5df32f2445378fbc48e61a77292d183a98d1d Mon Sep 17 00:00:00 2001
From: Binaya Sharma <binaya.sharma@stackguardian.io>
Date: Mon, 9 Oct 2023 13:27:14 +0545
Subject: [PATCH 0256/1120] updated artist_intro.rst

---
 galleries/users_explain/artists/artist_intro.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/galleries/users_explain/artists/artist_intro.rst b/galleries/users_explain/artists/artist_intro.rst
index 213a945f44b8..d23c59da631d 100644
--- a/galleries/users_explain/artists/artist_intro.rst
+++ b/galleries/users_explain/artists/artist_intro.rst
@@ -10,7 +10,7 @@ and :doc:`Axes <../axes/index>` are Artists, and generally contain
 
 
 Creating Artists
-~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^
 
 Usually we do not instantiate Artists directly, but rather use a plotting
 method on `~.axes.Axes`.  Some examples of plotting methods and the Artist
@@ -58,7 +58,7 @@ Artist via `~.Axes.get_lines()`:
     Line2D(example)
 
 Changing Artist properties
-~~~~~~~~~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Getting the ``lines`` object gives us access to all the properties of the
 Line2D object.  So if we want to change the *linewidth* after the fact, we can do so using `.Artist.set`.
@@ -132,7 +132,7 @@ Note most Artists also have a distinct list of setters; e.g.
 `.Line2D.set_color` or `.Line2D.set_linewidth`.
 
 Changing Artist data
-~~~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^^
 
 In addition to styling properties like *color* and *linewidth*, the Line2D
 object has a *data* property.  You can set the data after the line has been
@@ -149,7 +149,7 @@ same line is shown evolving over time (see :doc:`../animations/index`)
     lines[0].set_data([x, np.cos(x)])
 
 Manually adding Artists
-~~~~~~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^^^^^
 
 Not all Artists have helper methods, or you may want to use a low-level method
 for some reason.  For example the `.patches.Circle` Artist does not have a
@@ -178,7 +178,7 @@ be clipped, as is the case above for the ``clipped_circle`` patch.
 See :ref:`artist_reference` for other patches.
 
 Removing Artists
-~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^
 
 Sometimes we want to remove an Artist from a figure without re-specifying the
 whole figure from scratch.  Most Artists have a usable *remove* method that

From 128541a973d10d43a3380141a9785296fb5ebbd4 Mon Sep 17 00:00:00 2001
From: Koustav Ghosh <ghosh.hardkots.koustav1@gmail.com>
Date: Mon, 9 Oct 2023 16:38:09 +0530
Subject: [PATCH 0257/1120] add test_plot_date in test_datetime.py

---
 lib/matplotlib/tests/test_datetime.py | 19 ++++++++++++++++---
 1 file changed, 16 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 53958229f174..9c2be8ba541d 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -252,11 +252,24 @@ def test_plot(self):
         ax2.plot(range(1, N), x)
         ax3.plot(x, x)
 
-    @pytest.mark.xfail(reason="Test for plot_date not written yet")
     @mpl.style.context("default")
     def test_plot_date(self):
-        fig, ax = plt.subplots()
-        ax.plot_date(...)
+        mpl.rcParams["date.converter"] = "concise"
+        range_threshold = 10
+        fig, (ax1, ax2, ax3) = plt.subplots(3, 1, layout="constrained")
+
+        x_dates = np.array(
+            [datetime.datetime(2023, 10, delta) for delta in range(1, range_threshold)]
+        )
+        y_dates = np.array(
+            [datetime.datetime(2023, 10, delta) for delta in range(1, range_threshold)]
+        )
+        x_ranges = np.array(range(1, range_threshold))
+        y_ranges = np.array(range(1, range_threshold))
+
+        ax1.plot_date(x_dates, y_dates)
+        ax2.plot_date(x_dates, y_ranges)
+        ax3.plot_date(x_ranges, y_dates)
 
     @pytest.mark.xfail(reason="Test for psd not written yet")
     @mpl.style.context("default")

From e0acb05992bfd445ba534473129ae446b54bb2db Mon Sep 17 00:00:00 2001
From: Gaurav-Kumar-Soni <sonigaurav950@gmail.com>
Date: Mon, 9 Oct 2023 18:19:16 +0530
Subject: [PATCH 0258/1120] Formatted docs

---
 doc/users/project/index.rst |  2 +-
 doc/users/release_notes.rst | 39 +++++++++++++++++++------------------
 2 files changed, 21 insertions(+), 20 deletions(-)

diff --git a/doc/users/project/index.rst b/doc/users/project/index.rst
index 80dd6e27bc3d..ad55576190ab 100644
--- a/doc/users/project/index.rst
+++ b/doc/users/project/index.rst
@@ -1,7 +1,7 @@
 .. redirect-from:: /users/backmatter
 
 Project information
--------------------
+===================
 
 .. toctree::
     :maxdepth: 2
diff --git a/doc/users/release_notes.rst b/doc/users/release_notes.rst
index 1d281543b76c..7862305af65e 100644
--- a/doc/users/release_notes.rst
+++ b/doc/users/release_notes.rst
@@ -13,7 +13,7 @@ Release notes
 
 
 Version 3.8
-===========
+^^^^^^^^^^^
 .. toctree::
     :maxdepth: 1
 
@@ -22,7 +22,7 @@ Version 3.8
     github_stats.rst
 
 Version 3.7
-===========
+^^^^^^^^^^^
 .. toctree::
     :maxdepth: 1
 
@@ -34,7 +34,7 @@ Version 3.7
     prev_whats_new/github_stats_3.7.0.rst
 
 Version 3.6
-===========
+^^^^^^^^^^^
 .. toctree::
     :maxdepth: 1
 
@@ -47,7 +47,7 @@ Version 3.6
     prev_whats_new/github_stats_3.6.0.rst
 
 Version 3.5
-===========
+^^^^^^^^^^^
 .. toctree::
     :maxdepth: 1
 
@@ -62,7 +62,7 @@ Version 3.5
     prev_whats_new/github_stats_3.5.0.rst
 
 Version 3.4
-===========
+^^^^^^^^^^^
 .. toctree::
     :maxdepth: 1
 
@@ -72,11 +72,12 @@ Version 3.4
     prev_whats_new/github_stats_3.4.1.rst
     prev_whats_new/github_stats_3.4.0.rst
 
+=============
 Past versions
 =============
 
 Version 3.3
-~~~~~~~~~~~
+^^^^^^^^^^^
 .. toctree::
     :maxdepth: 1
 
@@ -90,7 +91,7 @@ Version 3.3
     prev_whats_new/github_stats_3.3.0.rst
 
 Version 3.2
-~~~~~~~~~~~
+^^^^^^^^^^^
 .. toctree::
     :maxdepth: 1
 
@@ -101,7 +102,7 @@ Version 3.2
     prev_whats_new/github_stats_3.2.0.rst
 
 Version 3.1
-~~~~~~~~~~~
+^^^^^^^^^^^
 .. toctree::
     :maxdepth: 1
 
@@ -114,7 +115,7 @@ Version 3.1
     prev_whats_new/github_stats_3.1.0.rst
 
 Version 3.0
-~~~~~~~~~~~
+^^^^^^^^^^^
 .. toctree::
     :maxdepth: 1
 
@@ -127,7 +128,7 @@ Version 3.0
     prev_whats_new/github_stats_3.0.0.rst
 
 Version 2.2
-~~~~~~~~~~~
+^^^^^^^^^^^
 .. toctree::
     :maxdepth: 1
 
@@ -135,7 +136,7 @@ Version 2.2
     ../api/prev_api_changes/api_changes_2.2.0.rst
 
 Version 2.1
-~~~~~~~~~~~
+^^^^^^^^^^^
 .. toctree::
     :maxdepth: 1
 
@@ -145,7 +146,7 @@ Version 2.1
     ../api/prev_api_changes/api_changes_2.1.0.rst
 
 Version 2.0
-~~~~~~~~~~~
+^^^^^^^^^^^
 .. toctree::
     :maxdepth: 1
 
@@ -154,7 +155,7 @@ Version 2.0
     ../api/prev_api_changes/api_changes_2.0.0.rst
 
 Version 1.5
-~~~~~~~~~~~
+^^^^^^^^^^^
 .. toctree::
     :maxdepth: 1
 
@@ -164,7 +165,7 @@ Version 1.5
     ../api/prev_api_changes/api_changes_1.5.0.rst
 
 Version 1.4
-~~~~~~~~~~~
+^^^^^^^^^^^
 .. toctree::
     :maxdepth: 1
 
@@ -172,7 +173,7 @@ Version 1.4
     ../api/prev_api_changes/api_changes_1.4.x.rst
 
 Version 1.3
-~~~~~~~~~~~
+^^^^^^^^^^^
 .. toctree::
     :maxdepth: 1
 
@@ -180,7 +181,7 @@ Version 1.3
     ../api/prev_api_changes/api_changes_1.3.x.rst
 
 Version 1.2
-~~~~~~~~~~~
+^^^^^^^^^^^
 .. toctree::
     :maxdepth: 1
 
@@ -189,7 +190,7 @@ Version 1.2
     ../api/prev_api_changes/api_changes_1.2.x.rst
 
 Version 1.1
-~~~~~~~~~~~
+^^^^^^^^^^^
 .. toctree::
     :maxdepth: 1
 
@@ -197,14 +198,14 @@ Version 1.1
     ../api/prev_api_changes/api_changes_1.1.x.rst
 
 Version 1.0
-~~~~~~~~~~~
+^^^^^^^^^^^
 .. toctree::
     :maxdepth: 1
 
     prev_whats_new/whats_new_1.0.rst
 
 Version 0.x
-~~~~~~~~~~~
+^^^^^^^^^^^
 .. toctree::
     :maxdepth: 1
 

From 4f32e81f3a52dda57ee41024d7f841d70664a951 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 9 Oct 2023 19:12:20 +0000
Subject: [PATCH 0259/1120] Bump pypa/cibuildwheel from 2.16.1 to 2.16.2

Bumps [pypa/cibuildwheel](https://github.com/pypa/cibuildwheel) from 2.16.1 to 2.16.2.
- [Release notes](https://github.com/pypa/cibuildwheel/releases)
- [Changelog](https://github.com/pypa/cibuildwheel/blob/main/docs/changelog.md)
- [Commits](https://github.com/pypa/cibuildwheel/compare/7da7df1efc530f07d1945c00934b8cfd34be0d50...fff9ec32ed25a9c576750c91e06b410ed0c15db7)

---
updated-dependencies:
- dependency-name: pypa/cibuildwheel
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 .github/workflows/cibuildwheel.yml | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index d4230e8f17ab..3b141f934e29 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -137,7 +137,7 @@ jobs:
           path: dist/
 
       - name: Build wheels for CPython 3.12
-        uses: pypa/cibuildwheel@7da7df1efc530f07d1945c00934b8cfd34be0d50 # v2.16.1
+        uses: pypa/cibuildwheel@fff9ec32ed25a9c576750c91e06b410ed0c15db7 # v2.16.2
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -159,7 +159,7 @@ jobs:
             pip install --pre "numpy>=1.25"
 
       - name: Build wheels for CPython 3.11
-        uses: pypa/cibuildwheel@7da7df1efc530f07d1945c00934b8cfd34be0d50 # v2.16.1
+        uses: pypa/cibuildwheel@fff9ec32ed25a9c576750c91e06b410ed0c15db7 # v2.16.2
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -167,7 +167,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.10
-        uses: pypa/cibuildwheel@7da7df1efc530f07d1945c00934b8cfd34be0d50 # v2.16.1
+        uses: pypa/cibuildwheel@fff9ec32ed25a9c576750c91e06b410ed0c15db7 # v2.16.2
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -175,7 +175,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.9
-        uses: pypa/cibuildwheel@7da7df1efc530f07d1945c00934b8cfd34be0d50 # v2.16.1
+        uses: pypa/cibuildwheel@fff9ec32ed25a9c576750c91e06b410ed0c15db7 # v2.16.2
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -183,7 +183,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for PyPy
-        uses: pypa/cibuildwheel@7da7df1efc530f07d1945c00934b8cfd34be0d50 # v2.16.1
+        uses: pypa/cibuildwheel@fff9ec32ed25a9c576750c91e06b410ed0c15db7 # v2.16.2
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:

From f4abe20b6b06c9b24e7e6fb71d1be7707d3af27c Mon Sep 17 00:00:00 2001
From: Ratnabali Dutta <ratnabalidutta26@gmail.com>
Date: Tue, 10 Oct 2023 02:05:21 +0530
Subject: [PATCH 0260/1120] Add Union for multiple type info

Co-authored-by: Kyle Sunden <git@ksunden.space>
---
 lib/matplotlib/_mathtext_data.py | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/lib/matplotlib/_mathtext_data.py b/lib/matplotlib/_mathtext_data.py
index 764555def495..8f0aece5de92 100644
--- a/lib/matplotlib/_mathtext_data.py
+++ b/lib/matplotlib/_mathtext_data.py
@@ -3,7 +3,7 @@
 """
 
 from __future__ import annotations
-from typing import overload
+from typing import overload, Union
 
 latex_to_bakoma = {
     '\\__sqrt__'                 : ('cmex10', 0x70),
@@ -1113,11 +1113,11 @@
 # Each element is a 4-tuple of the form:
 #   src_start, src_end, dst_font, dst_start
 
-_EntryTypeIn = tuple[str, str, str, str | int]
+_EntryTypeIn = tuple[str, str, str, Union[str, int]]
 _EntryTypeOut = tuple[int, int, str, int]
 
-_stix_virtual_fonts: dict[str, dict[str, list[_EntryTypeIn]] |
-                               list[_EntryTypeIn]] = {
+_stix_virtual_fonts: dict[str, Union[dict[
+    str, list[_EntryTypeIn]], list[_EntryTypeIn]]] = {
     'bb':
         {
         "rm":
@@ -1744,7 +1744,8 @@ def _normalize_stix_fontcodes(d):
         return {k: _normalize_stix_fontcodes(v) for k, v in d.items()}
 
 
-stix_virtual_fonts: dict[str, dict[str, list[_EntryTypeOut]] | list[_EntryTypeOut]]
+stix_virtual_fonts: dict[str, Union[dict[str, list[_EntryTypeOut]],
+                                    list[_EntryTypeOut]]]
 stix_virtual_fonts = _normalize_stix_fontcodes(_stix_virtual_fonts)
 
 # Free redundant list now that it has been normalized

From 4976bc98d5021d4dc561ed8eaebd816a6bf549db Mon Sep 17 00:00:00 2001
From: Binaya Sharma <binaya.sharma@stackguardian.io>
Date: Tue, 10 Oct 2023 10:54:00 +0545
Subject: [PATCH 0261/1120] updated api_interfaces.rst

---
 galleries/users_explain/figure/api_interfaces.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/galleries/users_explain/figure/api_interfaces.rst b/galleries/users_explain/figure/api_interfaces.rst
index 473c808794ca..6947817e6781 100644
--- a/galleries/users_explain/figure/api_interfaces.rst
+++ b/galleries/users_explain/figure/api_interfaces.rst
@@ -31,7 +31,7 @@ Native Matplotlib interfaces
 ----------------------------
 
 The explicit "Axes" interface
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The "Axes" interface is how Matplotlib is implemented, and many customizations
 and fine-tuning end up being done at this level.
@@ -59,7 +59,7 @@ but before they are displayed.
 
 
 The implicit "pyplot" interface
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The `~.matplotlib.pyplot` module shadows most of the
 `~.matplotlib.axes.Axes` plotting methods to give the equivalent of

From bfde4897d9110d429b24479489ba112408d3dfc0 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Tue, 10 Oct 2023 00:30:28 -0500
Subject: [PATCH 0262/1120] Ensure valid path mangling for ContourLabeler

---
 lib/matplotlib/contour.py | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/contour.py b/lib/matplotlib/contour.py
index dc5ed5d626bc..6a4b27035dc1 100644
--- a/lib/matplotlib/contour.py
+++ b/lib/matplotlib/contour.py
@@ -418,8 +418,13 @@ def interp_vec(x, xp, fp): return [np.interp(x, xp, col) for col in fp.T]
         new_code_blocks = []
         if is_closed_path:
             if i0 != -1 and i1 != -1:
-                new_xy_blocks.extend([[(x1, y1)], cc_xys[i1:i0+1], [(x0, y0)]])
-                new_code_blocks.extend([[Path.MOVETO], [Path.LINETO] * (i0 + 2 - i1)])
+                # This is probably wrong in the case that the entire contour would
+                # be discarded, but ensures that a valid path is returned and is
+                # consistent with behavior of mpl <3.8
+                points = cc_xys[i1:i0+1]
+                new_xy_blocks.extend([[(x1, y1)], points, [(x0, y0)]])
+                nlines = len(points) + 1
+                new_code_blocks.extend([[Path.MOVETO], [Path.LINETO] * nlines])
         else:
             if i0 != -1:
                 new_xy_blocks.extend([cc_xys[:i0 + 1], [(x0, y0)]])

From 5874f3256ebf38da425379341a5b78c9ebc9cf72 Mon Sep 17 00:00:00 2001
From: Binaya Sharma <binaya.sharma@stackguardian.io>
Date: Tue, 10 Oct 2023 21:30:18 +0545
Subject: [PATCH 0263/1120] updated interactive.rst

---
 galleries/users_explain/figure/interactive.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/galleries/users_explain/figure/interactive.rst b/galleries/users_explain/figure/interactive.rst
index 0d94a1cf8493..a32d1a1eb847 100644
--- a/galleries/users_explain/figure/interactive.rst
+++ b/galleries/users_explain/figure/interactive.rst
@@ -366,7 +366,7 @@ which uses the `.backend_nbagg` backend provided by Matplotlib;
 however, nbagg does not work in Jupyter Lab.
 
 GUIs + Jupyter
-~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^
 
 You can also use one of the non-``ipympl`` GUI backends in a Jupyter Notebook.
 If you are running your Jupyter kernel locally, the GUI window will spawn on

From b2027c3fcab34933b40bd2f9227ddd1f2b50fd20 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Tue, 10 Oct 2023 13:52:29 -0500
Subject: [PATCH 0264/1120] Add test of clabel with large padding

---
 lib/matplotlib/tests/test_contour.py | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/lib/matplotlib/tests/test_contour.py b/lib/matplotlib/tests/test_contour.py
index c911d499ea96..b3b7f575b07a 100644
--- a/lib/matplotlib/tests/test_contour.py
+++ b/lib/matplotlib/tests/test_contour.py
@@ -338,6 +338,22 @@ def test_clabel_zorder(use_clabeltext, contour_zorder, clabel_zorder):
         assert clabel.get_zorder() == expected_clabel_zorder
 
 
+def test_clabel_with_large_spacing():
+    # When the inline spacing is large relative to the contour, it may cause the
+    # entire contour to be removed. In current implementation, one line segment is
+    # retained between the identified points.
+    # This behavior may be worth reconsidering, but check to be sure we do not produce
+    # an invalid path, which results in an error at clabel call time.
+    # see gh-27045 for more information
+    x = y = np.arange(-3.0, 3.01, 0.05)
+    X, Y = np.meshgrid(x, y)
+    Z = np.exp(-X**2 - Y**2)
+
+    fig, ax = plt.subplots()
+    contourset = ax.contour(X, Y, Z, levels=[0.01, 0.2, .5, .8])
+    ax.clabel(contourset, inline_spacing=100)
+
+
 # tol because ticks happen to fall on pixel boundaries so small
 # floating point changes in tick location flip which pixel gets
 # the tick.

From 24518d61d1cb5f539a459bda7c640c4ed4c1214b Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Sat, 16 Sep 2023 00:14:03 -0400
Subject: [PATCH 0265/1120] Change internal utility extension to C++

This requires a minor bit of typecasting as in the `_tkagg.cpp` file.

This is a separate commit from the pybind11 change to improve rename
detection.
---
 ..._internal_utils.c => _c_internal_utils.cpp} | 18 ++++++++++--------
 src/meson.build                                |  2 +-
 2 files changed, 11 insertions(+), 9 deletions(-)
 rename src/{_c_internal_utils.c => _c_internal_utils.cpp} (90%)

diff --git a/src/_c_internal_utils.c b/src/_c_internal_utils.cpp
similarity index 90%
rename from src/_c_internal_utils.c
rename to src/_c_internal_utils.cpp
index 49e5057f1349..a8fc31fa8a7b 100644
--- a/src/_c_internal_utils.c
+++ b/src/_c_internal_utils.cpp
@@ -24,11 +24,11 @@ mpl_display_is_valid(PyObject* module)
     // than dlopen().
     if (getenv("DISPLAY")
         && (libX11 = dlopen("libX11.so.6", RTLD_LAZY))) {
+        typedef struct Display* (*XOpenDisplay_t)(char const*);
+        typedef int (*XCloseDisplay_t)(struct Display*);
         struct Display* display = NULL;
-        struct Display* (* XOpenDisplay)(char const*) =
-            dlsym(libX11, "XOpenDisplay");
-        int (* XCloseDisplay)(struct Display*) =
-            dlsym(libX11, "XCloseDisplay");
+        XOpenDisplay_t XOpenDisplay = (XOpenDisplay_t)dlsym(libX11, "XOpenDisplay");
+        XCloseDisplay_t XCloseDisplay = (XCloseDisplay_t)dlsym(libX11, "XCloseDisplay");
         if (XOpenDisplay && XCloseDisplay
                 && (display = XOpenDisplay(NULL))) {
             XCloseDisplay(display);
@@ -44,11 +44,13 @@ mpl_display_is_valid(PyObject* module)
     void* libwayland_client;
     if (getenv("WAYLAND_DISPLAY")
         && (libwayland_client = dlopen("libwayland-client.so.0", RTLD_LAZY))) {
+        typedef struct wl_display* (*wl_display_connect_t)(char const*);
+        typedef void (*wl_display_disconnect_t)(struct wl_display*);
         struct wl_display* display = NULL;
-        struct wl_display* (* wl_display_connect)(char const*) =
-            dlsym(libwayland_client, "wl_display_connect");
-        void (* wl_display_disconnect)(struct wl_display*) =
-            dlsym(libwayland_client, "wl_display_disconnect");
+        wl_display_connect_t wl_display_connect =
+            (wl_display_connect_t)dlsym(libwayland_client, "wl_display_connect");
+        wl_display_disconnect_t wl_display_disconnect =
+            (wl_display_disconnect_t)dlsym(libwayland_client, "wl_display_disconnect");
         if (wl_display_connect && wl_display_disconnect
                 && (display = wl_display_connect(NULL))) {
             wl_display_disconnect(display);
diff --git a/src/meson.build b/src/meson.build
index 6a33d2dfb12a..ce7a8cb034aa 100644
--- a/src/meson.build
+++ b/src/meson.build
@@ -82,7 +82,7 @@ extension_data = {
   '_c_internal_utils': {
     'subdir': 'matplotlib',
     'sources': files(
-      '_c_internal_utils.c',
+      '_c_internal_utils.cpp',
     ),
     'dependencies': [py3_dep, dl, ole32, shell32, user32],
   },

From 6355271f37423de1062ec99bf0886036b6cc62d9 Mon Sep 17 00:00:00 2001
From: Daniel Hitchcock <daniel.c.hitchcock@gmail.com>
Date: Sun, 24 Sep 2023 19:21:37 -0400
Subject: [PATCH 0266/1120] Removal of deprecations for Contour

fix pyi

fix pyi
---
 doc/api/artist_api.rst                        |  2 +-
 .../next_api_changes/removals/26907-DCH.rst   | 14 +++++++
 lib/matplotlib/contour.py                     | 38 -------------------
 lib/matplotlib/contour.pyi                    |  9 +----
 4 files changed, 16 insertions(+), 47 deletions(-)
 create mode 100644 doc/api/next_api_changes/removals/26907-DCH.rst

diff --git a/doc/api/artist_api.rst b/doc/api/artist_api.rst
index df7a6e8b1c04..0ca3fb364c41 100644
--- a/doc/api/artist_api.rst
+++ b/doc/api/artist_api.rst
@@ -11,7 +11,7 @@
 Inheritance Diagrams
 ====================
 
-.. inheritance-diagram:: matplotlib.axes._axes.Axes matplotlib.axes._base._AxesBase matplotlib.axis.Axis matplotlib.axis.Tick matplotlib.axis.XAxis matplotlib.axis.XTick matplotlib.axis.YAxis matplotlib.axis.YTick matplotlib.collections.AsteriskPolygonCollection matplotlib.collections.CircleCollection matplotlib.collections.Collection matplotlib.collections.EllipseCollection matplotlib.collections.EventCollection matplotlib.collections.LineCollection matplotlib.collections.PatchCollection matplotlib.collections.PathCollection matplotlib.collections.PolyCollection matplotlib.collections.QuadMesh matplotlib.collections.RegularPolyCollection matplotlib.collections.StarPolygonCollection matplotlib.collections.TriMesh matplotlib.collections._CollectionWithSizes matplotlib.contour.ClabelText matplotlib.contour.ContourSet matplotlib.contour.QuadContourSet matplotlib.figure.FigureBase matplotlib.figure.Figure matplotlib.figure.SubFigure matplotlib.image.AxesImage matplotlib.image.BboxImage matplotlib.image.FigureImage matplotlib.image.NonUniformImage matplotlib.image.PcolorImage matplotlib.image._ImageBase matplotlib.legend.Legend matplotlib.lines.Line2D matplotlib.offsetbox.AnchoredOffsetbox matplotlib.offsetbox.AnchoredText matplotlib.offsetbox.AnnotationBbox matplotlib.offsetbox.AuxTransformBox matplotlib.offsetbox.DrawingArea matplotlib.offsetbox.HPacker matplotlib.offsetbox.OffsetBox matplotlib.offsetbox.OffsetImage matplotlib.offsetbox.PackerBase matplotlib.offsetbox.PaddedBox matplotlib.offsetbox.TextArea matplotlib.offsetbox.VPacker matplotlib.patches.Annulus matplotlib.patches.Arc matplotlib.patches.Arrow matplotlib.patches.Circle matplotlib.patches.CirclePolygon matplotlib.patches.ConnectionPatch matplotlib.patches.Ellipse matplotlib.patches.FancyArrow matplotlib.patches.FancyArrowPatch matplotlib.patches.FancyBboxPatch matplotlib.patches.Patch matplotlib.patches.PathPatch matplotlib.patches.Polygon matplotlib.patches.Rectangle matplotlib.patches.RegularPolygon matplotlib.patches.Shadow matplotlib.patches.StepPatch matplotlib.patches.Wedge matplotlib.projections.geo.AitoffAxes matplotlib.projections.geo.GeoAxes matplotlib.projections.geo.HammerAxes matplotlib.projections.geo.LambertAxes matplotlib.projections.geo.MollweideAxes matplotlib.projections.polar.PolarAxes matplotlib.projections.polar.RadialAxis matplotlib.projections.polar.RadialTick matplotlib.projections.polar.ThetaAxis matplotlib.projections.polar.ThetaTick matplotlib.quiver.Barbs matplotlib.quiver.Quiver matplotlib.quiver.QuiverKey matplotlib.spines.Spine matplotlib.table.Cell matplotlib.table.Table matplotlib.text.Annotation matplotlib.text.Text matplotlib.tri.TriContourSet
+.. inheritance-diagram:: matplotlib.axes._axes.Axes matplotlib.axes._base._AxesBase matplotlib.axis.Axis matplotlib.axis.Tick matplotlib.axis.XAxis matplotlib.axis.XTick matplotlib.axis.YAxis matplotlib.axis.YTick matplotlib.collections.AsteriskPolygonCollection matplotlib.collections.CircleCollection matplotlib.collections.Collection matplotlib.collections.EllipseCollection matplotlib.collections.EventCollection matplotlib.collections.LineCollection matplotlib.collections.PatchCollection matplotlib.collections.PathCollection matplotlib.collections.PolyCollection matplotlib.collections.QuadMesh matplotlib.collections.RegularPolyCollection matplotlib.collections.StarPolygonCollection matplotlib.collections.TriMesh matplotlib.collections._CollectionWithSizes matplotlib.contour.ContourSet matplotlib.contour.QuadContourSet matplotlib.figure.FigureBase matplotlib.figure.Figure matplotlib.figure.SubFigure matplotlib.image.AxesImage matplotlib.image.BboxImage matplotlib.image.FigureImage matplotlib.image.NonUniformImage matplotlib.image.PcolorImage matplotlib.image._ImageBase matplotlib.legend.Legend matplotlib.lines.Line2D matplotlib.offsetbox.AnchoredOffsetbox matplotlib.offsetbox.AnchoredText matplotlib.offsetbox.AnnotationBbox matplotlib.offsetbox.AuxTransformBox matplotlib.offsetbox.DrawingArea matplotlib.offsetbox.HPacker matplotlib.offsetbox.OffsetBox matplotlib.offsetbox.OffsetImage matplotlib.offsetbox.PackerBase matplotlib.offsetbox.PaddedBox matplotlib.offsetbox.TextArea matplotlib.offsetbox.VPacker matplotlib.patches.Annulus matplotlib.patches.Arc matplotlib.patches.Arrow matplotlib.patches.Circle matplotlib.patches.CirclePolygon matplotlib.patches.ConnectionPatch matplotlib.patches.Ellipse matplotlib.patches.FancyArrow matplotlib.patches.FancyArrowPatch matplotlib.patches.FancyBboxPatch matplotlib.patches.Patch matplotlib.patches.PathPatch matplotlib.patches.Polygon matplotlib.patches.Rectangle matplotlib.patches.RegularPolygon matplotlib.patches.Shadow matplotlib.patches.StepPatch matplotlib.patches.Wedge matplotlib.projections.geo.AitoffAxes matplotlib.projections.geo.GeoAxes matplotlib.projections.geo.HammerAxes matplotlib.projections.geo.LambertAxes matplotlib.projections.geo.MollweideAxes matplotlib.projections.polar.PolarAxes matplotlib.projections.polar.RadialAxis matplotlib.projections.polar.RadialTick matplotlib.projections.polar.ThetaAxis matplotlib.projections.polar.ThetaTick matplotlib.quiver.Barbs matplotlib.quiver.Quiver matplotlib.quiver.QuiverKey matplotlib.spines.Spine matplotlib.table.Cell matplotlib.table.Table matplotlib.text.Annotation matplotlib.text.Text matplotlib.tri.TriContourSet
    :parts: 1
    :private-bases:
 
diff --git a/doc/api/next_api_changes/removals/26907-DCH.rst b/doc/api/next_api_changes/removals/26907-DCH.rst
new file mode 100644
index 000000000000..889743ba9cb0
--- /dev/null
+++ b/doc/api/next_api_changes/removals/26907-DCH.rst
@@ -0,0 +1,14 @@
+``contour.ClabelText`` and ``ContourLabeler.set_label_props``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+... are removed.
+
+Use ``Text(..., transform_rotates_text=True)`` as a replacement for
+``contour.ClabelText(...)`` and ``text.set(text=text, color=color,
+fontproperties=labeler.labelFontProps, clip_box=labeler.axes.bbox)`` as a
+replacement for the ``ContourLabeler.set_label_props(label, text, color)``.
+
+``ContourLabeler`` attributes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+The ``labelFontProps``, ``labelFontSizeList``, and ``labelTextsList``
+attributes of `.ContourLabeler` have been removed.  Use the ``labelTexts``
+attribute and the font properties of the corresponding text objects instead.
diff --git a/lib/matplotlib/contour.py b/lib/matplotlib/contour.py
index dc5ed5d626bc..4104bebfceda 100644
--- a/lib/matplotlib/contour.py
+++ b/lib/matplotlib/contour.py
@@ -25,20 +25,6 @@
 import matplotlib.transforms as mtransforms
 
 
-@_api.deprecated("3.7", alternative="Text.set_transform_rotates_text")
-class ClabelText(Text):
-    """
-    Unlike the ordinary text, the get_rotation returns an updated
-    angle in the pixel coordinate assuming that the input rotation is
-    an angle in data coordinate (or whatever transform set).
-    """
-
-    def get_rotation(self):
-        new_angle, = self.get_transform().transform_angles(
-            [super().get_rotation()], [self.get_position()])
-        return new_angle
-
-
 def _contour_labeler_event_handler(cs, inline, inline_spacing, event):
     canvas = cs.axes.figure.canvas
     is_button = event.name == "button_press_event"
@@ -223,22 +209,6 @@ def clabel(self, levels=None, *,
 
         return cbook.silent_list('text.Text', self.labelTexts)
 
-    @_api.deprecated("3.7", alternative="cs.labelTexts[0].get_font()")
-    @property
-    def labelFontProps(self):
-        return self._label_font_props
-
-    @_api.deprecated("3.7", alternative=(
-        "[cs.labelTexts[0].get_font().get_size()] * len(cs.labelLevelList)"))
-    @property
-    def labelFontSizeList(self):
-        return [self._label_font_props.get_size()] * len(self.labelLevelList)
-
-    @_api.deprecated("3.7", alternative="cs.labelTexts")
-    @property
-    def labelTextsList(self):
-        return cbook.silent_list('text.Text', self.labelTexts)
-
     def print_label(self, linecontour, labelwidth):
         """Return whether a contour is long enough to hold a label."""
         return (len(linecontour) > 10 * labelwidth
@@ -260,14 +230,6 @@ def _get_nth_label_width(self, nth):
                      figure=fig, fontproperties=self._label_font_props)
                 .get_window_extent(renderer).width)
 
-    @_api.deprecated("3.7", alternative="Artist.set")
-    def set_label_props(self, label, text, color):
-        """Set the label properties - color, fontsize, text."""
-        label.set_text(text)
-        label.set_color(color)
-        label.set_fontproperties(self._label_font_props)
-        label.set_clip_box(self.axes.bbox)
-
     def get_text(self, lev, fmt):
         """Get the text of the label."""
         if isinstance(lev, str):
diff --git a/lib/matplotlib/contour.pyi b/lib/matplotlib/contour.pyi
index 4a1e1e1d9d2e..ca034c4af265 100644
--- a/lib/matplotlib/contour.pyi
+++ b/lib/matplotlib/contour.pyi
@@ -16,7 +16,7 @@ from collections.abc import Callable, Iterable, Sequence
 from typing import Literal
 from .typing import ColorType
 
-class ClabelText(Text): ...
+
 
 class ContourLabeler:
     labelFmt: str | Formatter | Callable[[float], str] | dict[float, str]
@@ -41,15 +41,8 @@ class ContourLabeler:
         rightside_up: bool = ...,
         zorder: float | None = ...
     ) -> list[Text]: ...
-    @property
-    def labelFontProps(self) -> FontProperties: ...
-    @property
-    def labelFontSizeList(self) -> list[float]: ...
-    @property
-    def labelTextsList(self) -> list[Text]: ...
     def print_label(self, linecontour: ArrayLike, labelwidth: float) -> bool: ...
     def too_close(self, x: float, y: float, lw: float) -> bool: ...
-    def set_label_props(self, label: Text, text: str, color: ColorType) -> None: ...
     def get_text(
         self,
         lev: float,

From 49dd3aac0e3fce2b132a30d1d6c5a0a244b93c62 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Tue, 10 Oct 2023 23:35:23 -0400
Subject: [PATCH 0267/1120] ci: Clean up Python 3.12 builds

The final release is out, as are non-prerelease wheels, so we can drop
those workarounds.
---
 .github/workflows/cibuildwheel.yml | 14 --------------
 .github/workflows/tests.yml        | 15 ++++++---------
 2 files changed, 6 insertions(+), 23 deletions(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 3b141f934e29..cdb62658e6c9 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -143,20 +143,6 @@ jobs:
         env:
           CIBW_BUILD: "cp312-*"
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
-          # Remove this once NumPy with Python 3.12 wheels is not pre-release.
-          CIBW_BEFORE_BUILD: >-
-            pip install "meson-python>=0.13.1" ninja "pybind11>=2.6" "setuptools>=42" "setuptools_scm>=7" &&
-            pip install --pre "numpy>=1.25" &&
-            rm -rf {package}/build
-          CIBW_BEFORE_BUILD_WINDOWS: >-
-            pip install delvewheel "meson-python>=0.13.1" ninja "pybind11>=2.6" "setuptools>=42" "setuptools_scm>=7" &&
-            pip install --pre "numpy>=1.25" &&
-            rm -rf {package}/build
-          CIBW_ENVIRONMENT: PIP_NO_BUILD_ISOLATION=0
-          # Remove this once contourpy has Python 3.12 wheels.
-          CIBW_BEFORE_TEST: >-
-            pip install "meson>=1.2.0" "meson-python>=0.13.1" "ninja" "pybind11>=2.10.4" &&
-            pip install --pre "numpy>=1.25"
 
       - name: Build wheels for CPython 3.11
         uses: pypa/cibuildwheel@fff9ec32ed25a9c576750c91e06b410ed0c15db7 # v2.16.2
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index a3d3d63c64fa..614f9235a5a4 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -77,9 +77,8 @@ jobs:
             pyside6-ver: '!=6.5.1'
             extra-requirements: '-r requirements/testing/extra.txt'
           - os: ubuntu-22.04
-            python-version: '3.12-dev'
+            python-version: '3.12'
             pyside6-ver: '!=6.5.1'
-            pre: true
           - os: macos-latest
             python-version: 3.9
             # https://bugreports.qt.io/projects/PYSIDE/issues/PYSIDE-2346
@@ -196,10 +195,8 @@ jobs:
           python -m pip install --upgrade pip setuptools wheel
 
           # Install pre-release versions during our weekly upcoming dependency tests.
-          # Also install for 3.12 to get working NumPy (remove when 1.26 is released)
-          if [[ "${{ github.event_name == 'schedule' &&
-                     matrix.name-suffix != '(Minimum Versions)' }}" = "true"
-                || "${{ matrix.pre }}" = "true" ]]; then
+          if [[ "${{ github.event_name }}" == 'schedule'
+                && "${{ matrix.name-suffix }}" != '(Minimum Versions)' ]]; then
             PRE="--pre"
           fi
 
@@ -241,7 +238,7 @@ jobs:
             echo 'PyQt5 is available' ||
             echo 'PyQt5 is not available'
           if [[ "${{ runner.os }}" != 'macOS'
-                && "${{ matrix.python-version != '3.12-dev'}}" = "true" ]]; then
+                && "${{ matrix.python-version }}" != '3.12' ]]; then
             python -mpip install --upgrade pyside2${{ matrix.pyside2-ver }} &&
               python -c 'import PySide2.QtCore' &&
               echo 'PySide2 is available' ||
@@ -254,14 +251,14 @@ jobs:
               echo 'PyQt6 is not available'
           fi
           if [[ "${{ runner.os }}" != 'macOS'
-                && "${{ matrix.python-version != '3.12-dev'}}" = "true" ]]; then
+                && "${{ matrix.python-version }}" != '3.12' ]]; then
             python -mpip install --upgrade pyside6${{ matrix.pyside6-ver }} &&
               python -c 'import PySide6.QtCore' &&
               echo 'PySide6 is available' ||
               echo 'PySide6 is not available'
           fi
 
-          if [[ "${{ matrix.python-version != '3.12-dev'}}" = "true" ]]; then
+          if [[ "${{ matrix.python-version }}" != '3.12' ]]; then
             python -mpip install --upgrade \
               -f "https://extras.wxpython.org/wxPython4/extras/linux/gtk3/${{ matrix.os }}" \
               wxPython &&

From f33f6cfcef3670bcee0ba1f3643ff3d72851b3f1 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 14 Sep 2023 07:25:26 -0400
Subject: [PATCH 0268/1120] Convert internal utilities to pybind11

---
 src/_c_internal_utils.cpp | 175 +++++++++++++++++++-------------------
 src/meson.build           |   2 +-
 2 files changed, 88 insertions(+), 89 deletions(-)

diff --git a/src/_c_internal_utils.cpp b/src/_c_internal_utils.cpp
index a8fc31fa8a7b..813aeb6f7d5a 100644
--- a/src/_c_internal_utils.cpp
+++ b/src/_c_internal_utils.cpp
@@ -1,11 +1,12 @@
+#include <stdexcept>
+
 #ifdef _WIN32
 #define WIN32_LEAN_AND_MEAN
 // Windows 10, for latest HiDPI API support.
 #define WINVER 0x0A00
 #define _WIN32_WINNT 0x0A00
 #endif
-#define PY_SSIZE_T_CLEAN
-#include <Python.h>
+#include <pybind11/pybind11.h>
 #ifdef __linux__
 #include <dlfcn.h>
 #endif
@@ -13,10 +14,16 @@
 #include <Objbase.h>
 #include <Shobjidl.h>
 #include <Windows.h>
+#define UNUSED_ON_NON_WINDOWS(x) x
+#else
+#define UNUSED_ON_NON_WINDOWS Py_UNUSED
 #endif
 
-static PyObject*
-mpl_display_is_valid(PyObject* module)
+namespace py = pybind11;
+using namespace pybind11::literals;
+
+static bool
+mpl_display_is_valid(void)
 {
 #ifdef __linux__
     void* libX11;
@@ -34,11 +41,10 @@ mpl_display_is_valid(PyObject* module)
             XCloseDisplay(display);
         }
         if (dlclose(libX11)) {
-            PyErr_SetString(PyExc_RuntimeError, dlerror());
-            return NULL;
+            throw std::runtime_error(dlerror());
         }
         if (display) {
-            Py_RETURN_TRUE;
+            return true;
         }
     }
     void* libwayland_client;
@@ -56,84 +62,74 @@ mpl_display_is_valid(PyObject* module)
             wl_display_disconnect(display);
         }
         if (dlclose(libwayland_client)) {
-            PyErr_SetString(PyExc_RuntimeError, dlerror());
-            return NULL;
+            throw std::runtime_error(dlerror());
         }
         if (display) {
-            Py_RETURN_TRUE;
+            return true;
         }
     }
-    Py_RETURN_FALSE;
+    return false;
 #else
-    Py_RETURN_TRUE;
+    return true;
 #endif
 }
 
-static PyObject*
-mpl_GetCurrentProcessExplicitAppUserModelID(PyObject* module)
+static py::object
+mpl_GetCurrentProcessExplicitAppUserModelID(void)
 {
 #ifdef _WIN32
     wchar_t* appid = NULL;
     HRESULT hr = GetCurrentProcessExplicitAppUserModelID(&appid);
     if (FAILED(hr)) {
-        return PyErr_SetFromWindowsErr(hr);
+        PyErr_SetFromWindowsErr(hr);
+        throw py::error_already_set();
     }
-    PyObject* py_appid = PyUnicode_FromWideChar(appid, -1);
+    auto py_appid = py::cast(appid);
     CoTaskMemFree(appid);
     return py_appid;
 #else
-    Py_RETURN_NONE;
+    return py::none();
 #endif
 }
 
-static PyObject*
-mpl_SetCurrentProcessExplicitAppUserModelID(PyObject* module, PyObject* arg)
+static void
+mpl_SetCurrentProcessExplicitAppUserModelID(const wchar_t* UNUSED_ON_NON_WINDOWS(appid))
 {
 #ifdef _WIN32
-    wchar_t* appid = PyUnicode_AsWideCharString(arg, NULL);
-    if (!appid) {
-        return NULL;
-    }
     HRESULT hr = SetCurrentProcessExplicitAppUserModelID(appid);
-    PyMem_Free(appid);
     if (FAILED(hr)) {
-        return PyErr_SetFromWindowsErr(hr);
+        PyErr_SetFromWindowsErr(hr);
+        throw py::error_already_set();
     }
-    Py_RETURN_NONE;
-#else
-    Py_RETURN_NONE;
 #endif
 }
 
-static PyObject*
-mpl_GetForegroundWindow(PyObject* module)
+static py::object
+mpl_GetForegroundWindow(void)
 {
 #ifdef _WIN32
-  return PyLong_FromVoidPtr(GetForegroundWindow());
+  return py::capsule(GetForegroundWindow(), "HWND");
 #else
-  Py_RETURN_NONE;
+  return py::none();
 #endif
 }
 
-static PyObject*
-mpl_SetForegroundWindow(PyObject* module, PyObject *arg)
+static void
+mpl_SetForegroundWindow(py::capsule UNUSED_ON_NON_WINDOWS(handle_p))
 {
 #ifdef _WIN32
-  HWND handle = PyLong_AsVoidPtr(arg);
-  if (PyErr_Occurred()) {
-    return NULL;
-  }
-  if (!SetForegroundWindow(handle)) {
-    return PyErr_Format(PyExc_RuntimeError, "Error setting window");
-  }
-  Py_RETURN_NONE;
-#else
-  Py_RETURN_NONE;
+    if (handle_p.name() != "HWND") {
+        throw std::runtime_error("Handle must be a value returned from Win32_GetForegroundWindow");
+    }
+    HWND handle = static_cast<HWND>(handle_p.get_pointer());
+    if (!SetForegroundWindow(handle)) {
+        throw std::runtime_error("Error setting window");
+    }
 #endif
 }
 
-static PyObject*
-mpl_SetProcessDpiAwareness_max(PyObject* module)
+static void
+mpl_SetProcessDpiAwareness_max(void)
 {
 #ifdef _WIN32
 #ifdef _DPI_AWARENESS_CONTEXTS_
@@ -171,49 +167,52 @@ mpl_SetProcessDpiAwareness_max(PyObject* module)
     SetProcessDPIAware();
 #endif
 #endif
-    Py_RETURN_NONE;
 }
 
-static PyMethodDef functions[] = {
-    {"display_is_valid", (PyCFunction)mpl_display_is_valid, METH_NOARGS,
-     "display_is_valid()\n--\n\n"
-     "Check whether the current X11 or Wayland display is valid.\n\n"
-     "On Linux, returns True if either $DISPLAY is set and XOpenDisplay(NULL)\n"
-     "succeeds, or $WAYLAND_DISPLAY is set and wl_display_connect(NULL)\n"
-     "succeeds.\n\n"
-     "On other platforms, always returns True."},
-    {"Win32_GetCurrentProcessExplicitAppUserModelID",
-     (PyCFunction)mpl_GetCurrentProcessExplicitAppUserModelID, METH_NOARGS,
-     "Win32_GetCurrentProcessExplicitAppUserModelID()\n--\n\n"
-     "Wrapper for Windows's GetCurrentProcessExplicitAppUserModelID.\n\n"
-     "On non-Windows platforms, always returns None."},
-    {"Win32_SetCurrentProcessExplicitAppUserModelID",
-     (PyCFunction)mpl_SetCurrentProcessExplicitAppUserModelID, METH_O,
-     "Win32_SetCurrentProcessExplicitAppUserModelID(appid, /)\n--\n\n"
-     "Wrapper for Windows's SetCurrentProcessExplicitAppUserModelID.\n\n"
-     "On non-Windows platforms, does nothing."},
-    {"Win32_GetForegroundWindow",
-     (PyCFunction)mpl_GetForegroundWindow, METH_NOARGS,
-     "Win32_GetForegroundWindow()\n--\n\n"
-     "Wrapper for Windows' GetForegroundWindow.\n\n"
-     "On non-Windows platforms, always returns None."},
-    {"Win32_SetForegroundWindow",
-     (PyCFunction)mpl_SetForegroundWindow, METH_O,
-     "Win32_SetForegroundWindow(hwnd, /)\n--\n\n"
-     "Wrapper for Windows' SetForegroundWindow.\n\n"
-     "On non-Windows platforms, does nothing."},
-    {"Win32_SetProcessDpiAwareness_max",
-     (PyCFunction)mpl_SetProcessDpiAwareness_max, METH_NOARGS,
-     "Win32_SetProcessDpiAwareness_max()\n--\n\n"
-     "Set Windows' process DPI awareness to best option available.\n\n"
-     "On non-Windows platforms, does nothing."},
-    {NULL, NULL}};  // sentinel.
-static PyModuleDef util_module = {
-    PyModuleDef_HEAD_INIT, "_c_internal_utils", NULL, 0, functions
-};
-
-#pragma GCC visibility push(default)
-PyMODINIT_FUNC PyInit__c_internal_utils(void)
+PYBIND11_MODULE(_c_internal_utils, m)
 {
-    return PyModule_Create(&util_module);
+    m.def(
+        "display_is_valid", &mpl_display_is_valid,
+        R"""(        --
+        Check whether the current X11 or Wayland display is valid.
+
+        On Linux, returns True if either $DISPLAY is set and XOpenDisplay(NULL)
+        succeeds, or $WAYLAND_DISPLAY is set and wl_display_connect(NULL)
+        succeeds.
+
+        On other platforms, always returns True.)""");
+    m.def(
+        "Win32_GetCurrentProcessExplicitAppUserModelID",
+        &mpl_GetCurrentProcessExplicitAppUserModelID,
+        R"""(        --
+        Wrapper for Windows's GetCurrentProcessExplicitAppUserModelID.
+
+        On non-Windows platforms, always returns None.)""");
+    m.def(
+        "Win32_SetCurrentProcessExplicitAppUserModelID",
+        &mpl_SetCurrentProcessExplicitAppUserModelID,
+        "appid"_a, py::pos_only(),
+        R"""(        --
+        Wrapper for Windows's SetCurrentProcessExplicitAppUserModelID.
+
+        On non-Windows platforms, does nothing.)""");
+    m.def(
+        "Win32_GetForegroundWindow", &mpl_GetForegroundWindow,
+        R"""(        --
+        Wrapper for Windows' GetForegroundWindow.
+
+        On non-Windows platforms, always returns None.)""");
+    m.def(
+        "Win32_SetForegroundWindow", &mpl_SetForegroundWindow,
+        "hwnd"_a,
+        R"""(        --
+        Wrapper for Windows' SetForegroundWindow.
+
+        On non-Windows platforms, does nothing.)""");
+    m.def(
+        "Win32_SetProcessDpiAwareness_max", &mpl_SetProcessDpiAwareness_max,
+        R"""(        --
+        Set Windows' process DPI awareness to best option available.
+
+        On non-Windows platforms, does nothing.)""");
 }
diff --git a/src/meson.build b/src/meson.build
index ce7a8cb034aa..54457d74aceb 100644
--- a/src/meson.build
+++ b/src/meson.build
@@ -84,7 +84,7 @@ extension_data = {
     'sources': files(
       '_c_internal_utils.cpp',
     ),
-    'dependencies': [py3_dep, dl, ole32, shell32, user32],
+    'dependencies': [pybind11_dep, dl, ole32, shell32, user32],
   },
   'ft2font': {
     'subdir': 'matplotlib',

From f0a3a09ed935bf937251372e201d91b4b670118c Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Wed, 11 Oct 2023 12:25:35 -0500
Subject: [PATCH 0269/1120] Only rotate the subsection of the Path

Closes #27062

The code for rotation had referred to the original path, when it should
only be rotating the connected segment, which had already been
extracted.
---
 lib/matplotlib/contour.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/contour.py b/lib/matplotlib/contour.py
index 6a4b27035dc1..adb72ef46017 100644
--- a/lib/matplotlib/contour.py
+++ b/lib/matplotlib/contour.py
@@ -383,7 +383,7 @@ def _split_path_and_get_label_rotation(self, path, idx, screen_pos, lw, spacing=
         # If the path is closed, rotate it s.t. it starts at the label.
         is_closed_path = codes[stop - 1] == Path.CLOSEPOLY
         if is_closed_path:
-            cc_xys = np.concatenate([xys[idx:-1], xys[:idx+1]])
+            cc_xys = np.concatenate([cc_xys[idx:-1], cc_xys[:idx+1]])
             idx = 0
 
         # Like np.interp, but additionally vectorized over fp.

From c06a97e84b8424a87d0e294c5eaf406a1f8d0a62 Mon Sep 17 00:00:00 2001
From: Gauri Chaudhari <chaudharigauri.9@gmail.com>
Date: Wed, 11 Oct 2023 17:43:10 -0400
Subject: [PATCH 0270/1120] Removing deprecated api from patches (#26890)

* Removed deprecated class SimpleEvents

* Removed deprecated SimpleEvents class

* Create 26886-GC.rst

* Removing whitespaces

* Removing whitespaces

* Rename 26886-GC.rst to 26888-GC.rst

* Update 26888-GC.rst

* Update 26888-GC.rst

* Rename 26888-GC.rst to 26889-GC.rst

* Update 26890-GC.rst
---
 doc/api/next_api_changes/removals/26889-GC.rst | 3 +++
 lib/matplotlib/patches.py                      | 6 ------
 lib/matplotlib/patches.pyi                     | 3 ---
 3 files changed, 3 insertions(+), 9 deletions(-)
 create mode 100644 doc/api/next_api_changes/removals/26889-GC.rst

diff --git a/doc/api/next_api_changes/removals/26889-GC.rst b/doc/api/next_api_changes/removals/26889-GC.rst
new file mode 100644
index 000000000000..2cccc9fee113
--- /dev/null
+++ b/doc/api/next_api_changes/removals/26889-GC.rst
@@ -0,0 +1,3 @@
+Removing Deprecated API SimpleEvent
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+``matplotlib.patches.ConnectionStyle._Base.SimpleEvent``
diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
index f80df92c62fc..7b9e6e7aa060 100644
--- a/lib/matplotlib/patches.py
+++ b/lib/matplotlib/patches.py
@@ -2707,12 +2707,6 @@ class _Base:
         points. This base class defines a __call__ method, and a few
         helper methods.
         """
-
-        @_api.deprecated("3.7")
-        class SimpleEvent:
-            def __init__(self, xy):
-                self.x, self.y = xy
-
         def _in_patch(self, patch):
             """
             Return a predicate function testing whether a point *xy* is
diff --git a/lib/matplotlib/patches.pyi b/lib/matplotlib/patches.pyi
index 29fe36aa6c6b..287ea0f738ab 100644
--- a/lib/matplotlib/patches.pyi
+++ b/lib/matplotlib/patches.pyi
@@ -455,9 +455,6 @@ class BoxStyle(_Style):
 
 class ConnectionStyle(_Style):
     class _Base(ConnectionStyle):
-        class SimpleEvent:
-            def __init__(self, xy: tuple[float, float]) -> None: ...
-
         def __call__(
             self,
             posA: tuple[float, float],

From 9923ef9eb98375c10811e3e3f86bd9a0e4614847 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Thu, 28 Sep 2023 16:28:16 -0400
Subject: [PATCH 0271/1120] add a mypy pre-commit hook and add more explicit
 excludes to mypy toml config

---
 .pre-commit-config.yaml | 17 +++++++++++++++++
 pyproject.toml          | 20 +++++++++++++++-----
 2 files changed, 32 insertions(+), 5 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 05a14a1a08cc..a60ec6ce0169 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -26,6 +26,23 @@ repos:
       - id: no-commit-to-branch #default is master and main
       - id: trailing-whitespace
         exclude_types: [svg]
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.1.1
+    hooks:
+      - id: mypy
+        additional_dependencies: [
+          pandas-stubs,
+          types-pillow,
+          types-python-dateutil,
+          types-psutil,
+          types-docutils,
+          types-PyYAML]
+        args: [
+          "--config-file=pyproject.toml",
+          "lib/matplotlib"
+          ]
+        files: lib/matplotlib #only run when files in lib/matplotlib are changed
+        pass_filenames: false
   - repo: https://github.com/pycqa/flake8
     rev: 6.0.0
     hooks:
diff --git a/pyproject.toml b/pyproject.toml
index e0c7e4e9dfee..50e533b0c15b 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -207,15 +207,25 @@ convention = "numpy"
 "galleries/users_explain/text/text_props.py" = ["E501"]
 
 [tool.mypy]
+ignore_missing_imports = true
+enable_incomplete_feature = [
+  "Unpack",
+]
 exclude = [
+  #stubtest
   ".*/matplotlib/(sphinxext|backends|testing/jpl_units)",
-  ".*/mpl_toolkits",
+  #mypy precommit
+  "galleries/",
+  "doc/",
+  "lib/matplotlib/backends/",
+  "lib/matplotlib/sphinxext",
+  "lib/matplotlib/testing/jpl_units",
+  "lib/mpl_toolkits/",
+  #removing tests causes errors in backends
+  "lib/matplotlib/tests/",
   # tinypages is used for testing the sphinx ext,
   # stubtest will import and run, opening a figure if not excluded
-  ".*/tinypages",
-]
-enable_incomplete_feature = [
-  "Unpack",
+  ".*/tinypages"
 ]
 
 [tool.rstcheck]

From 7c02e8528f1208e1206c62d26f629e4119de9ce3 Mon Sep 17 00:00:00 2001
From: yangyangdotcom <70668131+yangyangdotcom@users.noreply.github.com>
Date: Thu, 12 Oct 2023 13:23:17 -0500
Subject: [PATCH 0272/1120] Added test_hist in test_datetime.py (#27028)

* Added test_hist

* reset

* remove comment

* Added test_hist

* added test_hist.py to test_datetime.py

* comply with PEP8

* datetime as bins

* datetime as bins
---
 lib/matplotlib/tests/test_datetime.py | 47 +++++++++++++++++++++++++--
 1 file changed, 44 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 9c2be8ba541d..392ed7ead0d0 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -170,11 +170,52 @@ def test_hexbin(self):
         fig, ax = plt.subplots()
         ax.hexbin(...)
 
-    @pytest.mark.xfail(reason="Test for hist not written yet")
     @mpl.style.context("default")
     def test_hist(self):
-        fig, ax = plt.subplots()
-        ax.hist(...)
+        mpl.rcParams["date.converter"] = 'concise'
+
+        start_date = datetime.datetime(2023, 10, 1)
+        time_delta = datetime.timedelta(days=1)
+
+        values1 = np.random.randint(1, 10, 30)
+        values2 = np.random.randint(1, 10, 30)
+        values3 = np.random.randint(1, 10, 30)
+
+        bin_edges = [start_date + i * time_delta for i in range(31)]
+
+        fig, (ax1, ax2, ax3) = plt.subplots(3, 1, constrained_layout=True)
+        ax1.hist(
+            [start_date + i * time_delta for i in range(30)],
+            bins=10,
+            weights=values1
+        )
+        ax2.hist(
+            [start_date + i * time_delta for i in range(30)],
+            bins=10,
+            weights=values2
+        )
+        ax3.hist(
+            [start_date + i * time_delta for i in range(30)],
+            bins=10,
+            weights=values3
+        )
+
+        fig, (ax4, ax5, ax6) = plt.subplots(3, 1, constrained_layout=True)
+        ax4.hist(
+            [start_date + i * time_delta for i in range(30)],
+            bins=bin_edges,
+            weights=values1
+        )
+        ax5.hist(
+            [start_date + i * time_delta for i in range(30)],
+            bins=bin_edges,
+            weights=values2
+        )
+        ax6.hist(
+            [start_date + i * time_delta for i in range(30)],
+            bins=bin_edges,
+            weights=values3
+        )
 
     @pytest.mark.xfail(reason="Test for hist2d not written yet")
     @mpl.style.context("default")

From a68878188df30fac1031bb953c55d1591131a05a Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Thu, 12 Oct 2023 13:29:53 -0500
Subject: [PATCH 0273/1120] Remove datetime test stubs for spectral
 methods/table

---
 lib/matplotlib/tests/test_datetime.py | 48 ---------------------------
 1 file changed, 48 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 392ed7ead0d0..ef83b837348d 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -14,12 +14,6 @@ def test_acorr(self):
         fig, ax = plt.subplots()
         ax.acorr(...)
 
-    @pytest.mark.xfail(reason="Test for angle_spectrum not written yet")
-    @mpl.style.context("default")
-    def test_angle_spectrum(self):
-        fig, ax = plt.subplots()
-        ax.angle_spectrum(...)
-
     @pytest.mark.xfail(reason="Test for annotate not written yet")
     @mpl.style.context("default")
     def test_annotate(self):
@@ -110,12 +104,6 @@ def test_clabel(self):
         fig, ax = plt.subplots()
         ax.clabel(...)
 
-    @pytest.mark.xfail(reason="Test for cohere not written yet")
-    @mpl.style.context("default")
-    def test_cohere(self):
-        fig, ax = plt.subplots()
-        ax.cohere(...)
-
     @pytest.mark.xfail(reason="Test for contour not written yet")
     @mpl.style.context("default")
     def test_contour(self):
@@ -128,12 +116,6 @@ def test_contourf(self):
         fig, ax = plt.subplots()
         ax.contourf(...)
 
-    @pytest.mark.xfail(reason="Test for csd not written yet")
-    @mpl.style.context("default")
-    def test_csd(self):
-        fig, ax = plt.subplots()
-        ax.csd(...)
-
     @pytest.mark.xfail(reason="Test for errorbar not written yet")
     @mpl.style.context("default")
     def test_errorbar(self):
@@ -241,12 +223,6 @@ def test_loglog(self):
         fig, ax = plt.subplots()
         ax.loglog(...)
 
-    @pytest.mark.xfail(reason="Test for magnitude_spectrum not written yet")
-    @mpl.style.context("default")
-    def test_magnitude_spectrum(self):
-        fig, ax = plt.subplots()
-        ax.magnitude_spectrum(...)
-
     @pytest.mark.xfail(reason="Test for matshow not written yet")
     @mpl.style.context("default")
     def test_matshow(self):
@@ -277,12 +253,6 @@ def test_pcolormesh(self):
         fig, ax = plt.subplots()
         ax.pcolormesh(...)
 
-    @pytest.mark.xfail(reason="Test for phase_spectrum not written yet")
-    @mpl.style.context("default")
-    def test_phase_spectrum(self):
-        fig, ax = plt.subplots()
-        ax.phase_spectrum(...)
-
     @mpl.style.context("default")
     def test_plot(self):
         mpl.rcParams["date.converter"] = 'concise'
@@ -312,12 +282,6 @@ def test_plot_date(self):
         ax2.plot_date(x_dates, y_ranges)
         ax3.plot_date(x_ranges, y_dates)
 
-    @pytest.mark.xfail(reason="Test for psd not written yet")
-    @mpl.style.context("default")
-    def test_psd(self):
-        fig, ax = plt.subplots()
-        ax.psd(...)
-
     @pytest.mark.xfail(reason="Test for quiver not written yet")
     @mpl.style.context("default")
     def test_quiver(self):
@@ -348,12 +312,6 @@ def test_semilogy(self):
         fig, ax = plt.subplots()
         ax.semilogy(...)
 
-    @pytest.mark.xfail(reason="Test for specgram not written yet")
-    @mpl.style.context("default")
-    def test_specgram(self):
-        fig, ax = plt.subplots()
-        ax.specgram(...)
-
     @pytest.mark.xfail(reason="Test for spy not written yet")
     @mpl.style.context("default")
     def test_spy(self):
@@ -390,12 +348,6 @@ def test_streamplot(self):
         fig, ax = plt.subplots()
         ax.streamplot(...)
 
-    @pytest.mark.xfail(reason="Test for table not written yet")
-    @mpl.style.context("default")
-    def test_table(self):
-        fig, ax = plt.subplots()
-        ax.table(...)
-
     @pytest.mark.xfail(reason="Test for text not written yet")
     @mpl.style.context("default")
     def test_text(self):

From bda0b30f012c25fa108f949a073d6492b941bde4 Mon Sep 17 00:00:00 2001
From: Nivedita Chaudhari <76914526+niviPy@users.noreply.github.com>
Date: Thu, 12 Oct 2023 20:56:26 +0000
Subject: [PATCH 0274/1120] Issue 26990

Fix added for image not getting rendered properly.

Solution: Split image into two rows for two blocks of code resp.
---
 galleries/examples/misc/histogram_path.py | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/galleries/examples/misc/histogram_path.py b/galleries/examples/misc/histogram_path.py
index 55260f9699bb..3e30dcfa424d 100644
--- a/galleries/examples/misc/histogram_path.py
+++ b/galleries/examples/misc/histogram_path.py
@@ -20,7 +20,7 @@
 import matplotlib.patches as patches
 import matplotlib.path as path
 
-fig, axs = plt.subplots(2)
+fig, axs = plt.subplots(1)
 
 np.random.seed(19680801)  # Fixing random state for reproducibility
 
@@ -44,14 +44,16 @@
 # make a patch out of it, don't add a margin at y=0
 patch = patches.PathPatch(barpath)
 patch.sticky_edges.y[:] = [0]
-axs[0].add_patch(patch)
-axs[0].autoscale_view()
+axs.add_patch(patch)
+axs.autoscale_view()
+plt.show()
 
 # %%
 # Instead of creating a three-dimensional array and using
 # `~.path.Path.make_compound_path_from_polys`, we could as well create the
 # compound path directly using vertices and codes as shown below
 
+fig, axs = plt.subplots(1)
 nrects = len(left)
 nverts = nrects*(1+3+1)
 verts = np.zeros((nverts, 2))
@@ -72,9 +74,8 @@
 # make a patch out of it, don't add a margin at y=0
 patch = patches.PathPatch(barpath)
 patch.sticky_edges.y[:] = [0]
-axs[1].add_patch(patch)
-axs[1].autoscale_view()
-
+axs.add_patch(patch)
+axs.autoscale_view()
 plt.show()
 
 # %%

From 6b9615157c5447d10924f22cfa75c91f20961bf5 Mon Sep 17 00:00:00 2001
From: Nivedita Chaudhari <76914526+niviPy@users.noreply.github.com>
Date: Fri, 13 Oct 2023 10:32:40 +0000
Subject: [PATCH 0275/1120] Updated with comments suggestions.

---
 galleries/examples/misc/histogram_path.py | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/galleries/examples/misc/histogram_path.py b/galleries/examples/misc/histogram_path.py
index 3e30dcfa424d..d35e291aa8ce 100644
--- a/galleries/examples/misc/histogram_path.py
+++ b/galleries/examples/misc/histogram_path.py
@@ -20,8 +20,6 @@
 import matplotlib.patches as patches
 import matplotlib.path as path
 
-fig, axs = plt.subplots(1)
-
 np.random.seed(19680801)  # Fixing random state for reproducibility
 
 # histogram our data with numpy
@@ -44,8 +42,10 @@
 # make a patch out of it, don't add a margin at y=0
 patch = patches.PathPatch(barpath)
 patch.sticky_edges.y[:] = [0]
-axs.add_patch(patch)
-axs.autoscale_view()
+
+fig, ax = plt.subplots()
+ax.add_patch(patch)
+ax.autoscale_view()
 plt.show()
 
 # %%
@@ -53,7 +53,6 @@
 # `~.path.Path.make_compound_path_from_polys`, we could as well create the
 # compound path directly using vertices and codes as shown below
 
-fig, axs = plt.subplots(1)
 nrects = len(left)
 nverts = nrects*(1+3+1)
 verts = np.zeros((nverts, 2))
@@ -74,8 +73,10 @@
 # make a patch out of it, don't add a margin at y=0
 patch = patches.PathPatch(barpath)
 patch.sticky_edges.y[:] = [0]
-axs.add_patch(patch)
-axs.autoscale_view()
+
+fig, ax = plt.subplots()
+ax.add_patch(patch)
+ax.autoscale_view()
 plt.show()
 
 # %%

From 11ea9f5921200f3926a734a36c03f3a57104e20d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Melissa=20Weber=20Mendon=C3=A7a?= <melissawm@gmail.com>
Date: Fri, 13 Oct 2023 14:18:01 -0300
Subject: [PATCH 0276/1120] MAINT: Update environment.yml to match requirements
 files

---
 environment.yml | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/environment.yml b/environment.yml
index 095e3d240bd2..b655d972a1ea 100644
--- a/environment.yml
+++ b/environment.yml
@@ -31,18 +31,18 @@ dependencies:
   - graphviz
   - ipython
   - ipywidgets
-  - numpydoc>=0.8
-  - packaging
-  - pydata-sphinx-theme
+  - numpydoc>=1.0
+  - packaging>=20
+  - pydata-sphinx-theme~=0.13.1
   - pyyaml
-  - sphinx>=1.8.1,!=2.0.0
+  - sphinx>=3.0.0,!=6.1.2
   - sphinx-copybutton
-  - sphinx-gallery>=0.12
+  - sphinx-gallery>=0.12.0
   - sphinx-design
   - pip
   - pip:
-      - mpl-sphinx-theme
-      - sphinxcontrib-svg2pdfconverter
+      - mpl-sphinx-theme~=3.8.0
+      - sphinxcontrib-svg2pdfconverter>=1.1.0
       - pikepdf
   # testing
   - coverage

From 48b53ce21bb61c89aed7a0f68a4a7c5a786ff00b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Melissa=20Weber=20Mendon=C3=A7a?= <melissawm@gmail.com>
Date: Fri, 13 Oct 2023 16:03:34 -0300
Subject: [PATCH 0277/1120] DOC: Add tags infrastructure for gallery examples

Adds sphinx-tags as a dependency and some basic configuration to display tags with color, using sphinx-design.

Co-authored-by: hannah <story645@gmail.com>
Co-authored-by: esibinga <vegheadeva@gmail.com>
---
 .gitignore                                         |  1 +
 doc/_static/mpl.css                                |  5 +++++
 doc/conf.py                                        | 13 +++++++++++++
 environment.yml                                    |  1 +
 galleries/examples/README.txt                      |  4 ++++
 galleries/examples/animation/animated_histogram.py |  3 +++
 galleries/examples/animation/multiple_axes.py      |  2 ++
 galleries/examples/event_handling/resample.py      |  3 +++
 requirements/doc/doc-requirements.txt              |  1 +
 9 files changed, 33 insertions(+)

diff --git a/.gitignore b/.gitignore
index 1514710bd9be..471431dd3433 100644
--- a/.gitignore
+++ b/.gitignore
@@ -82,6 +82,7 @@ galleries/examples/*/*.svgz
 result_images
 doc/_static/constrained_layout*.png
 doc/.mpl_skip_subdirs.yaml
+doc/_tags
 
 # Nose/Pytest generated files #
 ###############################
diff --git a/doc/_static/mpl.css b/doc/_static/mpl.css
index 45ecb21d5511..370116d9af7d 100644
--- a/doc/_static/mpl.css
+++ b/doc/_static/mpl.css
@@ -3,6 +3,11 @@
     --pst-color-link-hover: var(--pst-color-secondary);
     --sd-color-primary: var(--pst-color-primary);
     --sd-color-primary-text: var(--pst-color-text-base);
+    --sd-color-secondary: #ee9040;
+    --sd-color-success: #28a745;
+    --sd-color-dark: #323232;
+    --sd-color-danger: #dc3545;
+    --sd-color-light: #c9c9c9;
 }
 
 .simple li>p {
diff --git a/doc/conf.py b/doc/conf.py
index c2cdadf0ec24..ca6aa25e8ac6 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -118,6 +118,7 @@ def _parse_skip_subdirs_file():
     'sphinxext.redirect_from',
     'sphinx_copybutton',
     'sphinx_design',
+    'sphinx_tags',
 ]
 
 exclude_patterns = [
@@ -282,6 +283,18 @@ def gallery_image_warning_filter(record):
     logger = logging.getLogger('sphinx')
     logger.addFilter(gallery_image_warning_filter)
 
+# Sphinx tags configuration
+tags_create_tags = True
+tags_page_title = "All tags"
+tags_create_badges = True
+tags_badge_colors = {
+    "animation": "primary",
+    "component:*": "secondary",
+    "event-handling": "success",
+    "interactivity:*": "dark",
+    "plot-type:*": "danger",
+    "*": "light"  # default value
+}
 
 mathmpl_fontsize = 11.0
 mathmpl_srcset = ['2x']
diff --git a/environment.yml b/environment.yml
index 095e3d240bd2..9b3c2231f4a1 100644
--- a/environment.yml
+++ b/environment.yml
@@ -39,6 +39,7 @@ dependencies:
   - sphinx-copybutton
   - sphinx-gallery>=0.12
   - sphinx-design
+  - sphinx-tags
   - pip
   - pip:
       - mpl-sphinx-theme
diff --git a/galleries/examples/README.txt b/galleries/examples/README.txt
index bab703b4168e..8ffe42358352 100644
--- a/galleries/examples/README.txt
+++ b/galleries/examples/README.txt
@@ -14,3 +14,7 @@ and source code.
 For longer tutorials, see our :ref:`tutorials page <tutorials>`.
 You can also find :ref:`external resources <resources-index>` and
 a :ref:`FAQ <faq-index>` in our :ref:`user guide <users-guide-index>`.
+
+
+.. note::
+    You can also browse the example gallery by :ref:`tags <tagoverview>`.
diff --git a/galleries/examples/animation/animated_histogram.py b/galleries/examples/animation/animated_histogram.py
index d23d174ad2ca..24aa1c11474d 100644
--- a/galleries/examples/animation/animated_histogram.py
+++ b/galleries/examples/animation/animated_histogram.py
@@ -55,3 +55,6 @@ def animate(frame_number):
 ani = animation.FuncAnimation(fig, prepare_animation(bar_container), 50,
                               repeat=False, blit=True)
 plt.show()
+
+# %%
+# .. tags:: plot-type:histogram, animation
diff --git a/galleries/examples/animation/multiple_axes.py b/galleries/examples/animation/multiple_axes.py
index 2c3442c36d63..189bf2fc6af2 100644
--- a/galleries/examples/animation/multiple_axes.py
+++ b/galleries/examples/animation/multiple_axes.py
@@ -80,3 +80,5 @@ def animate(i):
 #
 #    - `matplotlib.patches.ConnectionPatch`
 #    - `matplotlib.animation.FuncAnimation`
+#
+# .. tags:: component:axes, animation
diff --git a/galleries/examples/event_handling/resample.py b/galleries/examples/event_handling/resample.py
index c034254d060a..66b2a09e85d7 100644
--- a/galleries/examples/event_handling/resample.py
+++ b/galleries/examples/event_handling/resample.py
@@ -75,3 +75,6 @@ def update(self, ax):
 ax.callbacks.connect('xlim_changed', d.update)
 ax.set_xlim(16, 365)
 plt.show()
+
+# %%
+# .. tags:: interactivity:zoom, event-handling
diff --git a/requirements/doc/doc-requirements.txt b/requirements/doc/doc-requirements.txt
index f60e9addf47b..89ee5b74ef5b 100644
--- a/requirements/doc/doc-requirements.txt
+++ b/requirements/doc/doc-requirements.txt
@@ -21,3 +21,4 @@ sphinxcontrib-svg2pdfconverter>=1.1.0
 sphinx-gallery>=0.12.0
 sphinx-copybutton
 sphinx-design
+sphinx-tags

From c563085b554080ae57f61972271b91f9c71fa457 Mon Sep 17 00:00:00 2001
From: CozyFrog <garrett.sward@uconn.edu>
Date: Fri, 13 Oct 2023 15:27:19 -0400
Subject: [PATCH 0278/1120] Add test_barh in test_datetime.py

---
 lib/matplotlib/tests/test_datetime.py | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 53958229f174..46bcf5071295 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -80,11 +80,18 @@ def test_barbs(self):
         fig, ax = plt.subplots()
         ax.barbs(...)
 
-    @pytest.mark.xfail(reason="Test for barh not written yet")
     @mpl.style.context("default")
     def test_barh(self):
-        fig, ax = plt.subplots()
-        ax.barh(...)
+        mpl.rcParams["date.converter"] = 'concise'
+        N = 14
+        base = datetime.datetime(1970, 1, 1)
+        indices = np.arange(N)
+        dates = [base + datetime.timedelta(days=(7 * i)) for i in range(N)]
+        fig, (ax1, ax2, ax3) = plt.subplots(3, 1, layout='constrained')
+        error = np.random.rand(N)
+        ax1.barh(indices, dates, xerr=error)
+        ax2.barh(dates, indices)
+        ax3.barh(dates, dates)
 
     @pytest.mark.xfail(reason="Test for boxplot not written yet")
     @mpl.style.context("default")

From 18358eb2a99c8844c07414e8536277242647e86d Mon Sep 17 00:00:00 2001
From: CozyFrog <garrett.sward@uconn.edu>
Date: Fri, 13 Oct 2023 16:41:52 -0400
Subject: [PATCH 0279/1120] Add test for parameters width and left

---
 lib/matplotlib/tests/test_datetime.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index c5e55b3c3958..b035a7873083 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -81,11 +81,13 @@ def test_barh(self):
         base = datetime.datetime(1970, 1, 1)
         indices = np.arange(N)
         dates = [base + datetime.timedelta(days=(7 * i)) for i in range(N)]
-        fig, (ax1, ax2, ax3) = plt.subplots(3, 1, layout='constrained')
+        widths = [datetime.timedelta(days=(7*i)) for i in range(N)]
+        fig, (ax1, ax2, ax3, ax4) = plt.subplots(4, 1, layout='constrained')
         error = np.random.rand(N)
         ax1.barh(indices, dates, xerr=error)
         ax2.barh(dates, indices)
         ax3.barh(dates, dates)
+        ax4.barh(indices, width=widths, left=base)
 
     @pytest.mark.xfail(reason="Test for boxplot not written yet")
     @mpl.style.context("default")

From 1446d1c9df681c24c71a7d69a1523a6ec261029d Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 13 Oct 2023 22:40:11 -0400
Subject: [PATCH 0280/1120] Rename py namespace to mpl in extension code

This will allow using the standard namespace alias for pybind11.
---
 src/_backend_agg.cpp           |  4 ++--
 src/_backend_agg.h             | 10 +++++-----
 src/_backend_agg_basic_types.h |  4 ++--
 src/_backend_agg_wrapper.cpp   |  8 ++++----
 src/_path.h                    | 10 +++++-----
 src/_path_wrapper.cpp          | 28 ++++++++++++++--------------
 src/ft2font.cpp                |  2 +-
 src/numpy_cpp.h                |  6 +++---
 src/py_adaptors.h              | 15 +++++++--------
 src/py_converters.cpp          |  6 +++---
 src/py_exceptions.h            |  6 +++---
 11 files changed, 49 insertions(+), 50 deletions(-)

diff --git a/src/_backend_agg.cpp b/src/_backend_agg.cpp
index 335e40971948..aec7676b7951 100644
--- a/src/_backend_agg.cpp
+++ b/src/_backend_agg.cpp
@@ -128,11 +128,11 @@ RendererAgg::restore_region(BufferRegion &region, int xx1, int yy1, int xx2, int
     rendererBase.copy_from(rbuf, &rect, x, y);
 }
 
-bool RendererAgg::render_clippath(py::PathIterator &clippath,
+bool RendererAgg::render_clippath(mpl::PathIterator &clippath,
                                   const agg::trans_affine &clippath_trans,
                                   e_snap_mode snap_mode)
 {
-    typedef agg::conv_transform<py::PathIterator> transformed_path_t;
+    typedef agg::conv_transform<mpl::PathIterator> transformed_path_t;
     typedef PathNanRemover<transformed_path_t> nan_removed_t;
     /* Unlike normal Paths, the clip path cannot be clipped to the Figure bbox,
      * because it needs to remain a complete closed path, so there is no
diff --git a/src/_backend_agg.h b/src/_backend_agg.h
index dd73aecde0f2..0319b449dce2 100644
--- a/src/_backend_agg.h
+++ b/src/_backend_agg.h
@@ -244,7 +244,7 @@ class RendererAgg
     template <class R>
     void set_clipbox(const agg::rect_d &cliprect, R &rasterizer);
 
-    bool render_clippath(py::PathIterator &clippath, const agg::trans_affine &clippath_trans, e_snap_mode snap_mode);
+    bool render_clippath(mpl::PathIterator &clippath, const agg::trans_affine &clippath_trans, e_snap_mode snap_mode);
 
     template <class PathIteratorType>
     void _draw_path(PathIteratorType &path, bool has_clippath, const facepair_t &face, GCAgg &gc);
@@ -340,11 +340,11 @@ RendererAgg::_draw_path(path_t &path, bool has_clippath, const facepair_t &face,
         rendererBase.reset_clipping(true);
 
         // Create and transform the path
-        typedef agg::conv_transform<py::PathIterator> hatch_path_trans_t;
+        typedef agg::conv_transform<mpl::PathIterator> hatch_path_trans_t;
         typedef agg::conv_curve<hatch_path_trans_t> hatch_path_curve_t;
         typedef agg::conv_stroke<hatch_path_curve_t> hatch_path_stroke_t;
 
-        py::PathIterator hatch_path(gc.hatchpath);
+        mpl::PathIterator hatch_path(gc.hatchpath);
         agg::trans_affine hatch_trans;
         hatch_trans *= agg::trans_affine_scaling(1.0, -1.0);
         hatch_trans *= agg::trans_affine_translation(0.0, 1.0);
@@ -447,7 +447,7 @@ template <class PathIterator>
 inline void
 RendererAgg::draw_path(GCAgg &gc, PathIterator &path, agg::trans_affine &trans, agg::rgba &color)
 {
-    typedef agg::conv_transform<py::PathIterator> transformed_path_t;
+    typedef agg::conv_transform<mpl::PathIterator> transformed_path_t;
     typedef PathNanRemover<transformed_path_t> nan_removed_t;
     typedef PathClipper<nan_removed_t> clipped_t;
     typedef PathSnapper<clipped_t> snapped_t;
@@ -490,7 +490,7 @@ inline void RendererAgg::draw_markers(GCAgg &gc,
                                       agg::trans_affine &trans,
                                       agg::rgba color)
 {
-    typedef agg::conv_transform<py::PathIterator> transformed_path_t;
+    typedef agg::conv_transform<mpl::PathIterator> transformed_path_t;
     typedef PathNanRemover<transformed_path_t> nan_removed_t;
     typedef PathSnapper<nan_removed_t> snap_t;
     typedef agg::conv_curve<snap_t> curve_t;
diff --git a/src/_backend_agg_basic_types.h b/src/_backend_agg_basic_types.h
index 21a84bb6a5ae..95c7a3ca5a3c 100644
--- a/src/_backend_agg_basic_types.h
+++ b/src/_backend_agg_basic_types.h
@@ -14,7 +14,7 @@
 
 struct ClipPath
 {
-    py::PathIterator path;
+    mpl::PathIterator path;
     agg::trans_affine trans;
 };
 
@@ -103,7 +103,7 @@ class GCAgg
 
     e_snap_mode snap_mode;
 
-    py::PathIterator hatchpath;
+    mpl::PathIterator hatchpath;
     agg::rgba hatch_color;
     double hatch_linewidth;
 
diff --git a/src/_backend_agg_wrapper.cpp b/src/_backend_agg_wrapper.cpp
index 02832f1c3e69..7ff344f6c2e8 100644
--- a/src/_backend_agg_wrapper.cpp
+++ b/src/_backend_agg_wrapper.cpp
@@ -209,7 +209,7 @@ static void PyRendererAgg_dealloc(PyRendererAgg *self)
 static PyObject *PyRendererAgg_draw_path(PyRendererAgg *self, PyObject *args)
 {
     GCAgg gc;
-    py::PathIterator path;
+    mpl::PathIterator path;
     agg::trans_affine trans;
     PyObject *faceobj = NULL;
     agg::rgba face;
@@ -263,9 +263,9 @@ static PyObject *PyRendererAgg_draw_text_image(PyRendererAgg *self, PyObject *ar
 PyObject *PyRendererAgg_draw_markers(PyRendererAgg *self, PyObject *args)
 {
     GCAgg gc;
-    py::PathIterator marker_path;
+    mpl::PathIterator marker_path;
     agg::trans_affine marker_path_trans;
-    py::PathIterator path;
+    mpl::PathIterator path;
     agg::trans_affine trans;
     PyObject *faceobj = NULL;
     agg::rgba face;
@@ -328,7 +328,7 @@ PyRendererAgg_draw_path_collection(PyRendererAgg *self, PyObject *args)
 {
     GCAgg gc;
     agg::trans_affine master_transform;
-    py::PathGenerator paths;
+    mpl::PathGenerator paths;
     numpy::array_view<const double, 3> transforms;
     numpy::array_view<const double, 2> offsets;
     agg::trans_affine offset_trans;
diff --git a/src/_path.h b/src/_path.h
index 387a0a6737f4..10a1101612ae 100644
--- a/src/_path.h
+++ b/src/_path.h
@@ -856,7 +856,7 @@ inline bool segments_intersect(const double &x1,
 template <class PathIterator1, class PathIterator2>
 bool path_intersects_path(PathIterator1 &p1, PathIterator2 &p2)
 {
-    typedef PathNanRemover<py::PathIterator> no_nans_t;
+    typedef PathNanRemover<mpl::PathIterator> no_nans_t;
     typedef agg::conv_curve<no_nans_t> curve_t;
 
     if (p1.total_vertices() < 2 || p2.total_vertices() < 2) {
@@ -920,7 +920,7 @@ bool path_intersects_rectangle(PathIterator &path,
                                double rect_x2, double rect_y2,
                                bool filled)
 {
-    typedef PathNanRemover<py::PathIterator> no_nans_t;
+    typedef PathNanRemover<mpl::PathIterator> no_nans_t;
     typedef agg::conv_curve<no_nans_t> curve_t;
 
     if (path.total_vertices() == 0) {
@@ -966,7 +966,7 @@ void convert_path_to_polygons(PathIterator &path,
                               int closed_only,
                               std::vector<Polygon> &result)
 {
-    typedef agg::conv_transform<py::PathIterator> transformed_path_t;
+    typedef agg::conv_transform<mpl::PathIterator> transformed_path_t;
     typedef PathNanRemover<transformed_path_t> nan_removal_t;
     typedef PathClipper<nan_removal_t> clipped_t;
     typedef PathSimplifier<clipped_t> simplify_t;
@@ -1032,7 +1032,7 @@ void cleanup_path(PathIterator &path,
                   std::vector<double> &vertices,
                   std::vector<unsigned char> &codes)
 {
-    typedef agg::conv_transform<py::PathIterator> transformed_path_t;
+    typedef agg::conv_transform<mpl::PathIterator> transformed_path_t;
     typedef PathNanRemover<transformed_path_t> nan_removal_t;
     typedef PathClipper<nan_removal_t> clipped_t;
     typedef PathSnapper<clipped_t> snapped_t;
@@ -1189,7 +1189,7 @@ bool convert_to_string(PathIterator &path,
                        std::string& buffer)
 {
     size_t buffersize;
-    typedef agg::conv_transform<py::PathIterator> transformed_path_t;
+    typedef agg::conv_transform<mpl::PathIterator> transformed_path_t;
     typedef PathNanRemover<transformed_path_t> nan_removal_t;
     typedef PathClipper<nan_removal_t> clipped_t;
     typedef PathSimplifier<clipped_t> simplify_t;
diff --git a/src/_path_wrapper.cpp b/src/_path_wrapper.cpp
index 369d9e030880..fc4d35da6309 100644
--- a/src/_path_wrapper.cpp
+++ b/src/_path_wrapper.cpp
@@ -35,7 +35,7 @@ const char *Py_point_in_path__doc__ =
 static PyObject *Py_point_in_path(PyObject *self, PyObject *args)
 {
     double x, y, r;
-    py::PathIterator path;
+    mpl::PathIterator path;
     agg::trans_affine trans;
     bool result;
 
@@ -68,7 +68,7 @@ static PyObject *Py_points_in_path(PyObject *self, PyObject *args)
 {
     numpy::array_view<const double, 2> points;
     double r;
-    py::PathIterator path;
+    mpl::PathIterator path;
     agg::trans_affine trans;
 
     if (!PyArg_ParseTuple(args,
@@ -97,7 +97,7 @@ const char *Py_update_path_extents__doc__ =
 
 static PyObject *Py_update_path_extents(PyObject *self, PyObject *args)
 {
-    py::PathIterator path;
+    mpl::PathIterator path;
     agg::trans_affine trans;
     agg::rect_d rect;
     numpy::array_view<double, 1> minpos;
@@ -177,7 +177,7 @@ const char *Py_get_path_collection_extents__doc__ =
 static PyObject *Py_get_path_collection_extents(PyObject *self, PyObject *args)
 {
     agg::trans_affine master_transform;
-    py::PathGenerator paths;
+    mpl::PathGenerator paths;
     numpy::array_view<const double, 3> transforms;
     numpy::array_view<const double, 2> offsets;
     agg::trans_affine offset_trans;
@@ -227,7 +227,7 @@ static PyObject *Py_point_in_path_collection(PyObject *self, PyObject *args)
 {
     double x, y, radius;
     agg::trans_affine master_transform;
-    py::PathGenerator paths;
+    mpl::PathGenerator paths;
     numpy::array_view<const double, 3> transforms;
     numpy::array_view<const double, 2> offsets;
     agg::trans_affine offset_trans;
@@ -280,9 +280,9 @@ const char *Py_path_in_path__doc__ =
 
 static PyObject *Py_path_in_path(PyObject *self, PyObject *args)
 {
-    py::PathIterator a;
+    mpl::PathIterator a;
     agg::trans_affine atrans;
-    py::PathIterator b;
+    mpl::PathIterator b;
     agg::trans_affine btrans;
     bool result;
 
@@ -314,7 +314,7 @@ const char *Py_clip_path_to_rect__doc__ =
 
 static PyObject *Py_clip_path_to_rect(PyObject *self, PyObject *args)
 {
-    py::PathIterator path;
+    mpl::PathIterator path;
     agg::rect_d rect;
     bool inside;
     std::vector<Polygon> result;
@@ -407,8 +407,8 @@ const char *Py_path_intersects_path__doc__ =
 
 static PyObject *Py_path_intersects_path(PyObject *self, PyObject *args, PyObject *kwds)
 {
-    py::PathIterator p1;
-    py::PathIterator p2;
+    mpl::PathIterator p1;
+    mpl::PathIterator p2;
     agg::trans_affine t1;
     agg::trans_affine t2;
     int filled = 0;
@@ -453,7 +453,7 @@ const char *Py_path_intersects_rectangle__doc__ =
 
 static PyObject *Py_path_intersects_rectangle(PyObject *self, PyObject *args, PyObject *kwds)
 {
-    py::PathIterator path;
+    mpl::PathIterator path;
     double rect_x1, rect_y1, rect_x2, rect_y2;
     bool filled = false;
     const char *names[] = { "path", "rect_x1", "rect_y1", "rect_x2", "rect_y2", "filled", NULL };
@@ -489,7 +489,7 @@ const char *Py_convert_path_to_polygons__doc__ =
 
 static PyObject *Py_convert_path_to_polygons(PyObject *self, PyObject *args, PyObject *kwds)
 {
-    py::PathIterator path;
+    mpl::PathIterator path;
     agg::trans_affine trans;
     double width = 0.0, height = 0.0;
     int closed_only = 1;
@@ -524,7 +524,7 @@ const char *Py_cleanup_path__doc__ =
 
 static PyObject *Py_cleanup_path(PyObject *self, PyObject *args)
 {
-    py::PathIterator path;
+    mpl::PathIterator path;
     agg::trans_affine trans;
     bool remove_nans;
     agg::rect_d clip_rect;
@@ -631,7 +631,7 @@ const char *Py_convert_to_string__doc__ =
 
 static PyObject *Py_convert_to_string(PyObject *self, PyObject *args)
 {
-    py::PathIterator path;
+    mpl::PathIterator path;
     agg::trans_affine trans;
     agg::rect_d cliprect;
     PyObject *simplifyobj;
diff --git a/src/ft2font.cpp b/src/ft2font.cpp
index 975041374133..fbc00dc69696 100644
--- a/src/ft2font.cpp
+++ b/src/ft2font.cpp
@@ -195,7 +195,7 @@ static void ft_glyph_warn(FT_ULong charcode)
     Py_XDECREF(text_helpers);
     Py_XDECREF(tmp);
     if (PyErr_Occurred()) {
-        throw py::exception();
+        throw mpl::exception();
     }
 }
 
diff --git a/src/numpy_cpp.h b/src/numpy_cpp.h
index 36c763d1584e..e634b9a7271e 100644
--- a/src/numpy_cpp.h
+++ b/src/numpy_cpp.h
@@ -378,7 +378,7 @@ class array_view : public detail::array_view_accessors<array_view, T, ND>
     array_view(PyObject *arr, bool contiguous = false) : m_arr(NULL), m_data(NULL)
     {
         if (!set(arr, contiguous)) {
-            throw py::exception();
+            throw mpl::exception();
         }
     }
 
@@ -413,11 +413,11 @@ class array_view : public detail::array_view_accessors<array_view, T, ND>
     {
         PyObject *arr = PyArray_SimpleNew(ND, shape, type_num_of<T>::value);
         if (arr == NULL) {
-            throw py::exception();
+            throw mpl::exception();
         }
         if (!set(arr, true)) {
             Py_DECREF(arr);
-            throw py::exception();
+            throw mpl::exception();
         }
         Py_DECREF(arr);
     }
diff --git a/src/py_adaptors.h b/src/py_adaptors.h
index 7722137dc6e1..1863cd6efbb0 100644
--- a/src/py_adaptors.h
+++ b/src/py_adaptors.h
@@ -18,12 +18,11 @@ extern "C" {
 int convert_path(PyObject *obj, void *pathp);
 }
 
-namespace py
-{
+namespace mpl {
 
 /************************************************************
- * py::PathIterator acts as a bridge between Numpy and Agg.  Given a
- * pair of Numpy arrays, vertices and codes, it iterates over
+ * mpl::PathIterator acts as a bridge between NumPy and Agg.  Given a
+ * pair of NumPy arrays, vertices and codes, it iterates over
  * those vertices and codes, using the standard Agg vertex source
  * interface:
  *
@@ -66,14 +65,14 @@ class PathIterator
         : m_vertices(NULL), m_codes(NULL), m_iterator(0)
     {
         if (!set(vertices, codes, should_simplify, simplify_threshold))
-            throw py::exception();
+            throw mpl::exception();
     }
 
     inline PathIterator(PyObject *vertices, PyObject *codes)
         : m_vertices(NULL), m_codes(NULL), m_iterator(0)
     {
         if (!set(vertices, codes))
-            throw py::exception();
+            throw mpl::exception();
     }
 
     inline PathIterator(const PathIterator &other)
@@ -233,11 +232,11 @@ class PathGenerator
 
         item = PySequence_GetItem(m_paths, i % m_npaths);
         if (item == NULL) {
-            throw py::exception();
+            throw mpl::exception();
         }
         if (!convert_path(item, &path)) {
             Py_DECREF(item);
-            throw py::exception();
+            throw mpl::exception();
         }
         Py_DECREF(item);
         return path;
diff --git a/src/py_converters.cpp b/src/py_converters.cpp
index 04382c5f94d0..e700342d5c78 100644
--- a/src/py_converters.cpp
+++ b/src/py_converters.cpp
@@ -343,7 +343,7 @@ int convert_trans_affine(PyObject *obj, void *transp)
 
 int convert_path(PyObject *obj, void *pathp)
 {
-    py::PathIterator *path = (py::PathIterator *)pathp;
+    mpl::PathIterator *path = (mpl::PathIterator *)pathp;
 
     PyObject *vertices_obj = NULL;
     PyObject *codes_obj = NULL;
@@ -404,7 +404,7 @@ int convert_path(PyObject *obj, void *pathp)
 
 int convert_pathgen(PyObject *obj, void *pathgenp)
 {
-    py::PathGenerator *paths = (py::PathGenerator *)pathgenp;
+    mpl::PathGenerator *paths = (mpl::PathGenerator *)pathgenp;
     if (!paths->set(obj)) {
         PyErr_SetString(PyExc_TypeError, "Not an iterable of paths");
         return 0;
@@ -415,7 +415,7 @@ int convert_pathgen(PyObject *obj, void *pathgenp)
 int convert_clippath(PyObject *clippath_tuple, void *clippathp)
 {
     ClipPath *clippath = (ClipPath *)clippathp;
-    py::PathIterator path;
+    mpl::PathIterator path;
     agg::trans_affine trans;
 
     if (clippath_tuple != NULL && clippath_tuple != Py_None) {
diff --git a/src/py_exceptions.h b/src/py_exceptions.h
index c4accf263408..7a7e004a4a7a 100644
--- a/src/py_exceptions.h
+++ b/src/py_exceptions.h
@@ -6,8 +6,8 @@
 #include <exception>
 #include <stdexcept>
 
-namespace py
-{
+namespace mpl {
+
 class exception : public std::exception
 {
   public:
@@ -23,7 +23,7 @@ class exception : public std::exception
     {                                                                        \
         a;                                                                   \
     }                                                                        \
-    catch (const py::exception &)                                            \
+    catch (const mpl::exception &)                                           \
     {                                                                        \
         {                                                                    \
             cleanup;                                                         \

From 9fa1186da9f98994932118dc2914658610b89e8f Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 13 Oct 2023 23:12:11 -0400
Subject: [PATCH 0281/1120] Use pybind11's usual namespace alias in extensions

---
 src/_image_wrapper.cpp   | 72 +++++++++++++++++++++-------------------
 src/_ttconv.cpp          |  9 ++---
 src/py_converters_11.cpp |  4 +--
 src/py_converters_11.h   |  4 ++-
 src/tri/_tri_wrapper.cpp | 22 ++++++------
 5 files changed, 59 insertions(+), 52 deletions(-)

diff --git a/src/_image_wrapper.cpp b/src/_image_wrapper.cpp
index b18e93a50fb3..716116c0ba56 100644
--- a/src/_image_wrapper.cpp
+++ b/src/_image_wrapper.cpp
@@ -4,6 +4,8 @@
 #include "_image_resample.h"
 #include "py_converters_11.h"
 
+namespace py = pybind11;
+using namespace pybind11::literals;
 
 /**********************************************************************
  * Free functions
@@ -46,8 +48,8 @@ radius: float, default: 1
 )""";
 
 
-static pybind11::array_t<double>
-_get_transform_mesh(const pybind11::object& transform, const pybind11::ssize_t *dims)
+static py::array_t<double>
+_get_transform_mesh(const py::object& transform, const py::ssize_t *dims)
 {
     /* TODO: Could we get away with float, rather than double, arrays here? */
 
@@ -58,8 +60,8 @@ _get_transform_mesh(const pybind11::object& transform, const pybind11::ssize_t *
     // If attribute doesn't exist, raises Python AttributeError
     auto inverse = transform.attr("inverted")();
 
-    pybind11::ssize_t mesh_dims[2] = {dims[0]*dims[1], 2};
-    pybind11::array_t<double> input_mesh(mesh_dims);
+    py::ssize_t mesh_dims[2] = {dims[0]*dims[1], 2};
+    py::array_t<double> input_mesh(mesh_dims);
     auto p = input_mesh.mutable_data();
 
     for (auto y = 0; y < dims[0]; ++y) {
@@ -72,7 +74,7 @@ _get_transform_mesh(const pybind11::object& transform, const pybind11::ssize_t *
     auto output_mesh = inverse.attr("transform")(input_mesh);
 
     auto output_mesh_array =
-        pybind11::array_t<double, pybind11::array::c_style | pybind11::array::forcecast>(output_mesh);
+        py::array_t<double, py::array::c_style | py::array::forcecast>(output_mesh);
 
     if (output_mesh_array.ndim() != 2) {
         throw std::runtime_error(
@@ -84,12 +86,12 @@ _get_transform_mesh(const pybind11::object& transform, const pybind11::ssize_t *
 }
 
 
-// Using generic pybind::array for input and output arrays rather than the more usual
-// pybind::array_t<type> as function supports multiple array dtypes.
+// Using generic py::array for input and output arrays rather than the more usual
+// py::array_t<type> as this function supports multiple array dtypes.
 static void
-image_resample(pybind11::array input_array,
-               pybind11::array& output_array,
-               const pybind11::object& transform,
+image_resample(py::array input_array,
+               py::array& output_array,
+               const py::object& transform,
                interpolation_e interpolation,
                bool resample_,  // Avoid name clash with resample() function
                float alpha,
@@ -111,7 +113,7 @@ image_resample(pybind11::array input_array,
     }
 
     // Ensure input array is contiguous, regardless of dtype
-    input_array = pybind11::array::ensure(input_array, pybind11::array::c_style);
+    input_array = py::array::ensure(input_array, py::array::c_style);
 
     // Validate output array
     auto out_ndim = output_array.ndim();
@@ -132,7 +134,7 @@ image_resample(pybind11::array input_array,
         throw std::invalid_argument("Input and output arrays have mismatched types");
     }
 
-    if ((output_array.flags() & pybind11::array::c_style) == 0) {
+    if ((output_array.flags() & py::array::c_style) == 0) {
         throw std::invalid_argument("Output array must be C-contiguous");
     }
 
@@ -150,14 +152,14 @@ image_resample(pybind11::array input_array,
 
     // Only used if transform is not affine.
     // Need to keep it in scope for the duration of this function.
-    pybind11::array_t<double> transform_mesh;
+    py::array_t<double> transform_mesh;
 
     // Validate transform
     if (transform.is_none()) {
         params.is_affine = true;
     } else {
         // Raises Python AttributeError if no such attribute or TypeError if cast fails
-        bool is_affine = pybind11::cast<bool>(transform.attr("is_affine"));
+        bool is_affine = py::cast<bool>(transform.attr("is_affine"));
 
         if (is_affine) {
             convert_trans_affine(transform, params.affine);
@@ -171,20 +173,20 @@ image_resample(pybind11::array input_array,
 
     if (auto resampler =
             (ndim == 2) ? (
-                (dtype.is(pybind11::dtype::of<std::uint8_t>())) ? resample<agg::gray8> :
-                (dtype.is(pybind11::dtype::of<std::int8_t>())) ? resample<agg::gray8> :
-                (dtype.is(pybind11::dtype::of<std::uint16_t>())) ? resample<agg::gray16> :
-                (dtype.is(pybind11::dtype::of<std::int16_t>())) ? resample<agg::gray16> :
-                (dtype.is(pybind11::dtype::of<float>())) ? resample<agg::gray32> :
-                (dtype.is(pybind11::dtype::of<double>())) ? resample<agg::gray64> :
+                (dtype.is(py::dtype::of<std::uint8_t>())) ? resample<agg::gray8> :
+                (dtype.is(py::dtype::of<std::int8_t>())) ? resample<agg::gray8> :
+                (dtype.is(py::dtype::of<std::uint16_t>())) ? resample<agg::gray16> :
+                (dtype.is(py::dtype::of<std::int16_t>())) ? resample<agg::gray16> :
+                (dtype.is(py::dtype::of<float>())) ? resample<agg::gray32> :
+                (dtype.is(py::dtype::of<double>())) ? resample<agg::gray64> :
                 nullptr) : (
             // ndim == 3
-                (dtype.is(pybind11::dtype::of<std::uint8_t>())) ? resample<agg::rgba8> :
-                (dtype.is(pybind11::dtype::of<std::int8_t>())) ? resample<agg::rgba8> :
-                (dtype.is(pybind11::dtype::of<std::uint16_t>())) ? resample<agg::rgba16> :
-                (dtype.is(pybind11::dtype::of<std::int16_t>())) ? resample<agg::rgba16> :
-                (dtype.is(pybind11::dtype::of<float>())) ? resample<agg::rgba32> :
-                (dtype.is(pybind11::dtype::of<double>())) ? resample<agg::rgba64> :
+                (dtype.is(py::dtype::of<std::uint8_t>())) ? resample<agg::rgba8> :
+                (dtype.is(py::dtype::of<std::int8_t>())) ? resample<agg::rgba8> :
+                (dtype.is(py::dtype::of<std::uint16_t>())) ? resample<agg::rgba16> :
+                (dtype.is(py::dtype::of<std::int16_t>())) ? resample<agg::rgba16> :
+                (dtype.is(py::dtype::of<float>())) ? resample<agg::rgba32> :
+                (dtype.is(py::dtype::of<double>())) ? resample<agg::rgba64> :
                 nullptr)) {
         Py_BEGIN_ALLOW_THREADS
         resampler(
@@ -199,7 +201,7 @@ image_resample(pybind11::array input_array,
 
 
 PYBIND11_MODULE(_image, m) {
-    pybind11::enum_<interpolation_e>(m, "_InterpolationType")
+    py::enum_<interpolation_e>(m, "_InterpolationType")
         .value("NEAREST", NEAREST)
         .value("BILINEAR", BILINEAR)
         .value("BICUBIC", BICUBIC)
@@ -220,13 +222,13 @@ PYBIND11_MODULE(_image, m) {
         .export_values();
 
     m.def("resample", &image_resample,
-        pybind11::arg("input_array"),
-        pybind11::arg("output_array"),
-        pybind11::arg("transform"),
-        pybind11::arg("interpolation") = interpolation_e::NEAREST,
-        pybind11::arg("resample") = false,
-        pybind11::arg("alpha") = 1,
-        pybind11::arg("norm") = false,
-        pybind11::arg("radius") = 1,
+        "input_array"_a,
+        "output_array"_a,
+        "transform"_a,
+        "interpolation"_a = interpolation_e::NEAREST,
+        "resample"_a = false,
+        "alpha"_a = 1,
+        "norm"_a = false,
+        "radius"_a = 1,
         image_resample__doc__);
 }
diff --git a/src/_ttconv.cpp b/src/_ttconv.cpp
index 51c2531bed99..a682c26b17b0 100644
--- a/src/_ttconv.cpp
+++ b/src/_ttconv.cpp
@@ -12,6 +12,7 @@
 #include <vector>
 
 namespace py = pybind11;
+using namespace pybind11::literals;
 
 /**
  * An implementation of TTStreamWriter that writes to a Python
@@ -75,10 +76,10 @@ PYBIND11_MODULE(_ttconv, m) {
               "fonts to Postscript Type 3, Postscript Type 42 and "
               "Pdf Type 3 fonts.";
     m.def("convert_ttf_to_ps", &convert_ttf_to_ps,
-        py::arg("filename"),
-        py::arg("output"),
-        py::arg("fonttype"),
-        py::arg("glyph_ids") = py::none(),
+        "filename"_a,
+        "output"_a,
+        "fonttype"_a,
+        "glyph_ids"_a = py::none(),
         "Converts the Truetype font into a Type 3 or Type 42 Postscript font, "
         "optionally subsetting the font to only the desired set of characters.\n"
         "\n"
diff --git a/src/py_converters_11.cpp b/src/py_converters_11.cpp
index 982cc9ac6c46..830ee6336fb4 100644
--- a/src/py_converters_11.cpp
+++ b/src/py_converters_11.cpp
@@ -1,13 +1,13 @@
 #include "py_converters_11.h"
 
-void convert_trans_affine(const pybind11::object& transform, agg::trans_affine& affine)
+void convert_trans_affine(const py::object& transform, agg::trans_affine& affine)
 {
     // If None assume identity transform so leave affine unchanged
     if (transform.is_none()) {
         return;
     }
 
-    auto array = pybind11::array_t<double, pybind11::array::c_style>::ensure(transform);
+    auto array = py::array_t<double, py::array::c_style>::ensure(transform);
     if (!array || array.ndim() != 2 || array.shape(0) != 3 || array.shape(1) != 3) {
         throw std::invalid_argument("Invalid affine transformation matrix");
     }
diff --git a/src/py_converters_11.h b/src/py_converters_11.h
index 1017b2a3e5c1..9af617d3ee8b 100644
--- a/src/py_converters_11.h
+++ b/src/py_converters_11.h
@@ -6,8 +6,10 @@
 #include <pybind11/pybind11.h>
 #include <pybind11/numpy.h>
 
+namespace py = pybind11;
+
 #include "agg_trans_affine.h"
 
-void convert_trans_affine(const pybind11::object& transform, agg::trans_affine& affine);
+void convert_trans_affine(const py::object& transform, agg::trans_affine& affine);
 
 #endif
diff --git a/src/tri/_tri_wrapper.cpp b/src/tri/_tri_wrapper.cpp
index 1b0c3d75555e..d6c4fb10c5d0 100644
--- a/src/tri/_tri_wrapper.cpp
+++ b/src/tri/_tri_wrapper.cpp
@@ -1,5 +1,7 @@
 #include "_tri.h"
 
+using namespace pybind11::literals;
+
 PYBIND11_MODULE(_tri, m) {
     py::class_<Triangulation>(m, "Triangulation")
         .def(py::init<const Triangulation::CoordinateArray&,
@@ -9,13 +11,13 @@ PYBIND11_MODULE(_tri, m) {
                       const Triangulation::EdgeArray&,
                       const Triangulation::NeighborArray&,
                       bool>(),
-            py::arg("x"),
-            py::arg("y"),
-            py::arg("triangles"),
-            py::arg("mask"),
-            py::arg("edges"),
-            py::arg("neighbors"),
-            py::arg("correct_triangle_orientations"),
+            "x"_a,
+            "y"_a,
+            "triangles"_a,
+            "mask"_a,
+            "edges"_a,
+            "neighbors"_a,
+            "correct_triangle_orientations"_a,
             "Create a new C++ Triangulation object.\n"
             "This should not be called directly, use the python class\n"
             "matplotlib.tri.Triangulation instead.\n")
@@ -31,8 +33,8 @@ PYBIND11_MODULE(_tri, m) {
     py::class_<TriContourGenerator>(m, "TriContourGenerator")
         .def(py::init<Triangulation&,
                       const TriContourGenerator::CoordinateArray&>(),
-            py::arg("triangulation"),
-            py::arg("z"),
+            "triangulation"_a,
+            "z"_a,
             "Create a new C++ TriContourGenerator object.\n"
             "This should not be called directly, use the functions\n"
             "matplotlib.axes.tricontour and tricontourf instead.\n")
@@ -43,7 +45,7 @@ PYBIND11_MODULE(_tri, m) {
 
     py::class_<TrapezoidMapTriFinder>(m, "TrapezoidMapTriFinder")
         .def(py::init<Triangulation&>(),
-            py::arg("triangulation"),
+            "triangulation"_a,
             "Create a new C++ TrapezoidMapTriFinder object.\n"
             "This should not be called directly, use the python class\n"
             "matplotlib.tri.TrapezoidMapTriFinder instead.\n")

From 26f12fad6c95b6abaedaec20bd55587317080324 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 12 Oct 2023 04:13:08 -0400
Subject: [PATCH 0282/1120] Remove unused array_view.empty method

---
 src/numpy_cpp.h | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/src/numpy_cpp.h b/src/numpy_cpp.h
index 36c763d1584e..c1482005c7ab 100644
--- a/src/numpy_cpp.h
+++ b/src/numpy_cpp.h
@@ -519,11 +519,6 @@ class array_view : public detail::array_view_accessors<array_view, T, ND>
         }
     }
 
-    bool empty() const
-    {
-        return size() == 0;
-    }
-
     // Do not use this for array_view<bool, ND>.  See comment near top of file.
     const T *data() const
     {

From c1e6873b8dd31f45524b9a0f9950863e20bf7152 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 12 Oct 2023 02:51:03 -0400
Subject: [PATCH 0283/1120] Rename array_view.dim to shape

This matches the name from pybind11, and will make it easier to reuse
templated code with either.
---
 src/_backend_agg.h           | 30 +++++++++++++++---------------
 src/_backend_agg_wrapper.cpp |  2 +-
 src/_path.h                  |  6 +++---
 src/_path_wrapper.cpp        |  4 ++--
 src/_qhull_wrapper.cpp       |  4 ++--
 src/array.h                  |  4 ++--
 src/mplutils.h               |  8 ++++----
 src/numpy_cpp.h              |  4 ++--
 8 files changed, 31 insertions(+), 31 deletions(-)

diff --git a/src/_backend_agg.h b/src/_backend_agg.h
index dd73aecde0f2..82846ebb89bb 100644
--- a/src/_backend_agg.h
+++ b/src/_backend_agg.h
@@ -731,22 +731,22 @@ inline void RendererAgg::draw_text_image(GCAgg &gc, ImageArray &image, int x, in
     rendererBase.reset_clipping(true);
     if (angle != 0.0) {
         agg::rendering_buffer srcbuf(
-                image.data(), (unsigned)image.dim(1),
-                (unsigned)image.dim(0), (unsigned)image.dim(1));
+                image.data(), (unsigned)image.shape(1),
+                (unsigned)image.shape(0), (unsigned)image.shape(1));
         agg::pixfmt_gray8 pixf_img(srcbuf);
 
         set_clipbox(gc.cliprect, theRasterizer);
 
         agg::trans_affine mtx;
-        mtx *= agg::trans_affine_translation(0, -image.dim(0));
+        mtx *= agg::trans_affine_translation(0, -image.shape(0));
         mtx *= agg::trans_affine_rotation(-angle * (agg::pi / 180.0));
         mtx *= agg::trans_affine_translation(x, y);
 
         agg::path_storage rect;
         rect.move_to(0, 0);
-        rect.line_to(image.dim(1), 0);
-        rect.line_to(image.dim(1), image.dim(0));
-        rect.line_to(0, image.dim(0));
+        rect.line_to(image.shape(1), 0);
+        rect.line_to(image.shape(1), image.shape(0));
+        rect.line_to(0, image.shape(0));
         rect.line_to(0, 0);
         agg::conv_transform<agg::path_storage> rect2(rect, mtx);
 
@@ -767,10 +767,10 @@ inline void RendererAgg::draw_text_image(GCAgg &gc, ImageArray &image, int x, in
     } else {
         agg::rect_i fig, text;
 
-        int deltay = y - image.dim(0);
+        int deltay = y - image.shape(0);
 
         fig.init(0, 0, width, height);
-        text.init(x, deltay, x + image.dim(1), y);
+        text.init(x, deltay, x + image.shape(1), y);
         text.clip(fig);
 
         if (gc.cliprect.x1 != 0.0 || gc.cliprect.y1 != 0.0 || gc.cliprect.x2 != 0.0 || gc.cliprect.y2 != 0.0) {
@@ -832,19 +832,19 @@ inline void RendererAgg::draw_image(GCAgg &gc,
 
     agg::rendering_buffer buffer;
     buffer.attach(
-        image.data(), (unsigned)image.dim(1), (unsigned)image.dim(0), -(int)image.dim(1) * 4);
+        image.data(), (unsigned)image.shape(1), (unsigned)image.shape(0), -(int)image.shape(1) * 4);
     pixfmt pixf(buffer);
 
     if (has_clippath) {
         agg::trans_affine mtx;
         agg::path_storage rect;
 
-        mtx *= agg::trans_affine_translation((int)x, (int)(height - (y + image.dim(0))));
+        mtx *= agg::trans_affine_translation((int)x, (int)(height - (y + image.shape(0))));
 
         rect.move_to(0, 0);
-        rect.line_to(image.dim(1), 0);
-        rect.line_to(image.dim(1), image.dim(0));
-        rect.line_to(0, image.dim(0));
+        rect.line_to(image.shape(1), 0);
+        rect.line_to(image.shape(1), image.shape(0));
+        rect.line_to(0, image.shape(0));
         rect.line_to(0, 0);
 
         agg::conv_transform<agg::path_storage> rect2(rect, mtx);
@@ -880,7 +880,7 @@ inline void RendererAgg::draw_image(GCAgg &gc,
     } else {
         set_clipbox(gc.cliprect, rendererBase);
         rendererBase.blend_from(
-            pixf, 0, (int)x, (int)(height - (y + image.dim(0))), (agg::int8u)(alpha * 255));
+            pixf, 0, (int)x, (int)(height - (y + image.shape(0))), (agg::int8u)(alpha * 255));
     }
 
     rendererBase.reset_clipping(true);
@@ -1234,7 +1234,7 @@ inline void RendererAgg::draw_gouraud_triangles(GCAgg &gc,
     set_clipbox(gc.cliprect, theRasterizer);
     bool has_clippath = render_clippath(gc.clippath.path, gc.clippath.trans, gc.snap_mode);
 
-    for (int i = 0; i < points.dim(0); ++i) {
+    for (int i = 0; i < points.shape(0); ++i) {
         typename PointArray::sub_t point = points.subarray(i);
         typename ColorArray::sub_t color = colors.subarray(i);
 
diff --git a/src/_backend_agg_wrapper.cpp b/src/_backend_agg_wrapper.cpp
index 02832f1c3e69..86543b2567b4 100644
--- a/src/_backend_agg_wrapper.cpp
+++ b/src/_backend_agg_wrapper.cpp
@@ -466,7 +466,7 @@ PyRendererAgg_draw_gouraud_triangles(PyRendererAgg *self, PyObject *args)
         PyErr_Format(PyExc_ValueError,
                      "points and colors arrays must be the same length, got "
                      "%" NPY_INTP_FMT " points and %" NPY_INTP_FMT "colors",
-                     points.dim(0), colors.dim(0));
+                     points.shape(0), colors.shape(0));
         return NULL;
     }
 
diff --git a/src/_path.h b/src/_path.h
index 387a0a6737f4..cc11aee913df 100644
--- a/src/_path.h
+++ b/src/_path.h
@@ -379,7 +379,7 @@ void get_path_collection_extents(agg::trans_affine &master_transform,
                                  agg::trans_affine &offset_trans,
                                  extent_limits &extent)
 {
-    if (offsets.size() != 0 && offsets.dim(1) != 2) {
+    if (offsets.size() != 0 && offsets.shape(1) != 2) {
         throw std::runtime_error("Offsets array must have shape (N, 2)");
     }
 
@@ -709,7 +709,7 @@ clip_path_to_rect(PathIterator &path, agg::rect_d &rect, bool inside, std::vecto
 template <class VerticesArray, class ResultArray>
 void affine_transform_2d(VerticesArray &vertices, agg::trans_affine &trans, ResultArray &result)
 {
-    if (vertices.size() != 0 && vertices.dim(1) != 2) {
+    if (vertices.size() != 0 && vertices.shape(1) != 2) {
         throw std::runtime_error("Invalid vertices array.");
     }
 
@@ -739,7 +739,7 @@ void affine_transform_2d(VerticesArray &vertices, agg::trans_affine &trans, Resu
 template <class VerticesArray, class ResultArray>
 void affine_transform_1d(VerticesArray &vertices, agg::trans_affine &trans, ResultArray &result)
 {
-    if (vertices.dim(0) != 2) {
+    if (vertices.shape(0) != 2) {
         throw std::runtime_error("Invalid vertices array.");
     }
 
diff --git a/src/_path_wrapper.cpp b/src/_path_wrapper.cpp
index 369d9e030880..60704e92d1dd 100644
--- a/src/_path_wrapper.cpp
+++ b/src/_path_wrapper.cpp
@@ -118,10 +118,10 @@ static PyObject *Py_update_path_extents(PyObject *self, PyObject *args)
         return NULL;
     }
 
-    if (minpos.dim(0) != 2) {
+    if (minpos.shape(0) != 2) {
         PyErr_Format(PyExc_ValueError,
                      "minpos must be of length 2, got %" NPY_INTP_FMT,
-                     minpos.dim(0));
+                     minpos.shape(0));
         return NULL;
     }
 
diff --git a/src/_qhull_wrapper.cpp b/src/_qhull_wrapper.cpp
index ef374d8e42c0..3abce833fe6f 100644
--- a/src/_qhull_wrapper.cpp
+++ b/src/_qhull_wrapper.cpp
@@ -267,8 +267,8 @@ delaunay(PyObject *self, PyObject *args)
         return NULL;
     }
 
-    npoints = xarray.dim(0);
-    if (npoints != yarray.dim(0)) {
+    npoints = xarray.shape(0);
+    if (npoints != yarray.shape(0)) {
         PyErr_SetString(PyExc_ValueError,
                         "x and y must be 1D arrays of the same length");
         return NULL;
diff --git a/src/array.h b/src/array.h
index 47d82995541b..e5d8fb64b2fb 100644
--- a/src/array.h
+++ b/src/array.h
@@ -29,7 +29,7 @@ class scalar
         return m_value;
     }
 
-    int dim(size_t i)
+    int shape(size_t i)
     {
         return 1;
     }
@@ -65,7 +65,7 @@ class empty
         return empty<T>();
     }
 
-    int dim(size_t i) const
+    int shape(size_t i) const
     {
         return 0;
     }
diff --git a/src/mplutils.h b/src/mplutils.h
index 186449e8f63c..8c2921a1d2ff 100644
--- a/src/mplutils.h
+++ b/src/mplutils.h
@@ -72,10 +72,10 @@ inline int prepare_and_add_type(PyTypeObject *type, PyObject *module)
 template<typename T>
 inline bool check_trailing_shape(T array, char const* name, long d1)
 {
-    if (array.dim(1) != d1) {
+    if (array.shape(1) != d1) {
         PyErr_Format(PyExc_ValueError,
                      "%s must have shape (N, %ld), got (%ld, %ld)",
-                     name, d1, array.dim(0), array.dim(1));
+                     name, d1, array.shape(0), array.shape(1));
         return false;
     }
     return true;
@@ -84,10 +84,10 @@ inline bool check_trailing_shape(T array, char const* name, long d1)
 template<typename T>
 inline bool check_trailing_shape(T array, char const* name, long d1, long d2)
 {
-    if (array.dim(1) != d1 || array.dim(2) != d2) {
+    if (array.shape(1) != d1 || array.shape(2) != d2) {
         PyErr_Format(PyExc_ValueError,
                      "%s must have shape (N, %ld, %ld), got (%ld, %ld, %ld)",
-                     name, d1, d2, array.dim(0), array.dim(1), array.dim(2));
+                     name, d1, d2, array.shape(0), array.shape(1), array.shape(2));
         return false;
     }
     return true;
diff --git a/src/numpy_cpp.h b/src/numpy_cpp.h
index c1482005c7ab..0d3fd025890e 100644
--- a/src/numpy_cpp.h
+++ b/src/numpy_cpp.h
@@ -492,7 +492,7 @@ class array_view : public detail::array_view_accessors<array_view, T, ND>
         return true;
     }
 
-    npy_intp dim(size_t i) const
+    npy_intp shape(size_t i) const
     {
         if (i >= ND) {
             return 0;
@@ -515,7 +515,7 @@ class array_view : public detail::array_view_accessors<array_view, T, ND>
         if (empty) {
             return 0;
         } else {
-            return (size_t)dim(0);
+            return (size_t)shape(0);
         }
     }
 

From 02fa8fced30c7392e3a729c80cef6f0aab58eb4c Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 12 Oct 2023 03:39:36 -0400
Subject: [PATCH 0284/1120] Replace some calls to array_view.size with
 .shape(0)

The other dimensions have already been confirmed to be non-zero, so
size() == shape(0) in these cases.
---
 lib/matplotlib/tests/test_transforms.py |  4 ++--
 src/_backend_agg_wrapper.cpp            |  6 +++---
 src/_path.h                             |  2 +-
 src/_path_wrapper.cpp                   | 14 +++++++++++---
 4 files changed, 17 insertions(+), 9 deletions(-)

diff --git a/lib/matplotlib/tests/test_transforms.py b/lib/matplotlib/tests/test_transforms.py
index a9a92d33cff3..4145ff37f6f0 100644
--- a/lib/matplotlib/tests/test_transforms.py
+++ b/lib/matplotlib/tests/test_transforms.py
@@ -627,9 +627,9 @@ def test_invalid_arguments():
         t.transform([])
     with pytest.raises(RuntimeError):
         t.transform([1])
-    with pytest.raises(RuntimeError):
+    with pytest.raises(ValueError):
         t.transform([[1]])
-    with pytest.raises(RuntimeError):
+    with pytest.raises(ValueError):
         t.transform([[1, 2, 3]])
 
 
diff --git a/src/_backend_agg_wrapper.cpp b/src/_backend_agg_wrapper.cpp
index 86543b2567b4..a8c40969e427 100644
--- a/src/_backend_agg_wrapper.cpp
+++ b/src/_backend_agg_wrapper.cpp
@@ -456,13 +456,13 @@ PyRendererAgg_draw_gouraud_triangles(PyRendererAgg *self, PyObject *args)
                           &trans)) {
         return NULL;
     }
-    if (points.size() && !check_trailing_shape(points, "points", 3, 2)) {
+    if (points.shape(0) && !check_trailing_shape(points, "points", 3, 2)) {
         return NULL;
     }
-    if (colors.size() && !check_trailing_shape(colors, "colors", 3, 4)) {
+    if (colors.shape(0) && !check_trailing_shape(colors, "colors", 3, 4)) {
         return NULL;
     }
-    if (points.size() != colors.size()) {
+    if (points.shape(0) != colors.shape(0)) {
         PyErr_Format(PyExc_ValueError,
                      "points and colors arrays must be the same length, got "
                      "%" NPY_INTP_FMT " points and %" NPY_INTP_FMT "colors",
diff --git a/src/_path.h b/src/_path.h
index cc11aee913df..568618613bbc 100644
--- a/src/_path.h
+++ b/src/_path.h
@@ -713,7 +713,7 @@ void affine_transform_2d(VerticesArray &vertices, agg::trans_affine &trans, Resu
         throw std::runtime_error("Invalid vertices array.");
     }
 
-    size_t n = vertices.size();
+    size_t n = vertices.shape(0);
     double x;
     double y;
     double t0;
diff --git a/src/_path_wrapper.cpp b/src/_path_wrapper.cpp
index 60704e92d1dd..cc6d1c05ebca 100644
--- a/src/_path_wrapper.cpp
+++ b/src/_path_wrapper.cpp
@@ -83,7 +83,11 @@ static PyObject *Py_points_in_path(PyObject *self, PyObject *args)
         return NULL;
     }
 
-    npy_intp dims[] = { (npy_intp)points.size() };
+    if (!check_trailing_shape(points, "points", 2)) {
+        return NULL;
+    }
+
+    npy_intp dims[] = { (npy_intp)points.shape(0) };
     numpy::array_view<uint8_t, 1> results(dims);
 
     CALL_CPP("points_in_path", (points_in_path(points, r, path, trans, results)));
@@ -361,7 +365,11 @@ static PyObject *Py_affine_transform(PyObject *self, PyObject *args)
         numpy::array_view<double, 2> vertices(vertices_arr);
         Py_DECREF(vertices_arr);
 
-        npy_intp dims[] = { (npy_intp)vertices.size(), 2 };
+        if(!check_trailing_shape(vertices, "vertices", 2)) {
+            return NULL;
+        }
+
+        npy_intp dims[] = { (npy_intp)vertices.shape(0), 2 };
         numpy::array_view<double, 2> result(dims);
         CALL_CPP("affine_transform", (affine_transform_2d(vertices, trans, result)));
         return result.pyobj();
@@ -369,7 +377,7 @@ static PyObject *Py_affine_transform(PyObject *self, PyObject *args)
         numpy::array_view<double, 1> vertices(vertices_arr);
         Py_DECREF(vertices_arr);
 
-        npy_intp dims[] = { (npy_intp)vertices.size() };
+        npy_intp dims[] = { (npy_intp)vertices.shape(0) };
         numpy::array_view<double, 1> result(dims);
         CALL_CPP("affine_transform", (affine_transform_1d(vertices, trans, result)));
         return result.pyobj();

From 343fa1312f3ea485e0db2dfb5d4f5e0cf178df48 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 12 Oct 2023 03:57:57 -0400
Subject: [PATCH 0285/1120] Replace array_view.size with an external helper

This currently checks if any dimension is 0, and returns the first
dimension or 0. However, `pybind11::array_t.size()` returns the product
of the shapes, so we want to be explicit when we need the former.

I also checked the remaining `size` calls, and those will be fine with
either interpretation, so I did not change them.
---
 src/_backend_agg.h | 12 ++++++------
 src/_path.h        | 14 +++++++-------
 src/array.h        | 13 +++++++++++++
 src/numpy_cpp.h    | 45 +++++++++++++++++++++++++++------------------
 4 files changed, 53 insertions(+), 31 deletions(-)

diff --git a/src/_backend_agg.h b/src/_backend_agg.h
index 82846ebb89bb..2aafd8526171 100644
--- a/src/_backend_agg.h
+++ b/src/_backend_agg.h
@@ -918,15 +918,15 @@ inline void RendererAgg::_draw_path_collection_generic(GCAgg &gc,
     typedef agg::conv_curve<clipped_t> curve_t;
 
     size_t Npaths = path_generator.num_paths();
-    size_t Noffsets = offsets.size();
+    size_t Noffsets = safe_first_shape(offsets);
     size_t N = std::max(Npaths, Noffsets);
 
-    size_t Ntransforms = transforms.size();
-    size_t Nfacecolors = facecolors.size();
-    size_t Nedgecolors = edgecolors.size();
-    size_t Nlinewidths = linewidths.size();
+    size_t Ntransforms = safe_first_shape(transforms);
+    size_t Nfacecolors = safe_first_shape(facecolors);
+    size_t Nedgecolors = safe_first_shape(edgecolors);
+    size_t Nlinewidths = safe_first_shape(linewidths);
     size_t Nlinestyles = std::min(linestyles.size(), N);
-    size_t Naa = antialiaseds.size();
+    size_t Naa = safe_first_shape(antialiaseds);
 
     if ((Nfacecolors == 0 && Nedgecolors == 0) || Npaths == 0) {
         return;
diff --git a/src/_path.h b/src/_path.h
index 568618613bbc..75ac1779b091 100644
--- a/src/_path.h
+++ b/src/_path.h
@@ -113,7 +113,7 @@ void point_in_path_impl(PointArray &points, PathIterator &path, ResultArray &ins
     size_t i;
     bool all_done;
 
-    size_t n = points.size();
+    size_t n = safe_first_shape(points);
 
     std::vector<uint8_t> yflag0(n);
     std::vector<uint8_t> subpath_flag(n);
@@ -247,7 +247,7 @@ inline void points_in_path(PointArray &points,
     typedef agg::conv_contour<curve_t> contour_t;
 
     size_t i;
-    for (i = 0; i < points.size(); ++i) {
+    for (i = 0; i < safe_first_shape(points); ++i) {
         result[i] = false;
     }
 
@@ -384,9 +384,9 @@ void get_path_collection_extents(agg::trans_affine &master_transform,
     }
 
     size_t Npaths = paths.size();
-    size_t Noffsets = offsets.size();
+    size_t Noffsets = safe_first_shape(offsets);
     size_t N = std::max(Npaths, Noffsets);
-    size_t Ntransforms = std::min(transforms.size(), N);
+    size_t Ntransforms = std::min(safe_first_shape(transforms), N);
     size_t i;
 
     agg::trans_affine trans;
@@ -436,9 +436,9 @@ void point_in_path_collection(double x,
         return;
     }
 
-    size_t Noffsets = offsets.size();
+    size_t Noffsets = safe_first_shape(offsets);
     size_t N = std::max(Npaths, Noffsets);
-    size_t Ntransforms = std::min(transforms.size(), N);
+    size_t Ntransforms = std::min(safe_first_shape(transforms), N);
     size_t i;
 
     agg::trans_affine trans;
@@ -776,7 +776,7 @@ int count_bboxes_overlapping_bbox(agg::rect_d &a, BBoxArray &bboxes)
         std::swap(a.y1, a.y2);
     }
 
-    size_t num_bboxes = bboxes.size();
+    size_t num_bboxes = safe_first_shape(bboxes);
     for (size_t i = 0; i < num_bboxes; ++i) {
         b = agg::rect_d(bboxes(i, 0, 0), bboxes(i, 0, 1), bboxes(i, 1, 0), bboxes(i, 1, 1));
 
diff --git a/src/array.h b/src/array.h
index e5d8fb64b2fb..6694412b8df5 100644
--- a/src/array.h
+++ b/src/array.h
@@ -40,6 +40,13 @@ class scalar
     }
 };
 
+template <typename T, int ND>
+size_t
+safe_first_shape(scalar<T, ND>)
+{
+    return 1;
+}
+
 template <typename T>
 class empty
 {
@@ -75,6 +82,12 @@ class empty
         return 0;
     }
 };
+
+template <typename T>
+size_t safe_first_shape(empty<T>)
+{
+    return 0;
+}
 }
 
 #endif
diff --git a/src/numpy_cpp.h b/src/numpy_cpp.h
index 0d3fd025890e..b26f73e2c4fb 100644
--- a/src/numpy_cpp.h
+++ b/src/numpy_cpp.h
@@ -500,24 +500,7 @@ class array_view : public detail::array_view_accessors<array_view, T, ND>
         return m_shape[i];
     }
 
-    /*
-       In most cases, code should use size() instead of dim(0), since
-       size() == 0 when any dimension is 0.
-    */
-    size_t size() const
-    {
-        bool empty = (ND == 0);
-        for (size_t i = 0; i < ND; i++) {
-            if (m_shape[i] == 0) {
-                empty = true;
-            }
-        }
-        if (empty) {
-            return 0;
-        } else {
-            return (size_t)shape(0);
-        }
-    }
+    size_t size() const;
 
     // Do not use this for array_view<bool, ND>.  See comment near top of file.
     const T *data() const
@@ -567,6 +550,32 @@ class array_view : public detail::array_view_accessors<array_view, T, ND>
     }
 };
 
+/* In most cases, code should use safe_first_shape(obj) instead of obj.shape(0), since
+   safe_first_shape(obj) == 0 when any dimension is 0. */
+template <typename T, int ND>
+size_t
+safe_first_shape(const array_view<T, ND> &a)
+{
+    bool empty = (ND == 0);
+    for (size_t i = 0; i < ND; i++) {
+        if (a.shape(i) == 0) {
+            empty = true;
+        }
+    }
+    if (empty) {
+        return 0;
+    } else {
+        return (size_t)a.shape(0);
+    }
+}
+
+template <typename T, int ND>
+size_t
+array_view<T, ND>::size() const
+{
+    return safe_first_shape<T, ND>(*this);
+}
+
 } // namespace numpy
 
 

From 82503fbf7b9394f4d3a03fddfba9f67b33b9aa06 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Sat, 14 Oct 2023 15:55:24 +0200
Subject: [PATCH 0286/1120] Restore figaspect() API documentation

This was accidentally lost through #26629.
---
 doc/api/figure_api.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/doc/api/figure_api.rst b/doc/api/figure_api.rst
index 84d068f5c3af..316bd8322d32 100644
--- a/doc/api/figure_api.rst
+++ b/doc/api/figure_api.rst
@@ -306,3 +306,8 @@ FigureBase parent class
 =======================
 
 .. autoclass:: FigureBase
+
+Helper functions
+================
+
+.. autofunction:: figaspect

From ab1e1cbc6c3ff5b348d4522d22c1c5c4bc4d151d Mon Sep 17 00:00:00 2001
From: Ant Lockyer <antlockyer@gmail.com>
Date: Sat, 14 Oct 2023 15:40:10 +0100
Subject: [PATCH 0287/1120] Add test_step to test_datetime.py

---
 lib/matplotlib/tests/test_datetime.py | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index ef83b837348d..f441502334e2 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -336,11 +336,15 @@ def test_stem(self):
         fig, ax = plt.subplots()
         ax.stem(...)
 
-    @pytest.mark.xfail(reason="Test for step not written yet")
     @mpl.style.context("default")
     def test_step(self):
-        fig, ax = plt.subplots()
-        ax.step(...)
+        mpl.rcParams["date.converter"] = "concise"
+        N = 6
+        fig, (ax1, ax2, ax3) = plt.subplots(3, 1, layout='constrained')
+        x = np.array([datetime.datetime(2023, 9, n) for n in range(1, N)])
+        ax1.step(x, range(1, N))
+        ax2.step(range(1, N), x)
+        ax3.step(x, x)
 
     @pytest.mark.xfail(reason="Test for streamplot not written yet")
     @mpl.style.context("default")

From 34026319c0501d53bfc00f216e05a496058a269e Mon Sep 17 00:00:00 2001
From: Koustav Ghosh <ghosh.hardkots.koustav1@gmail.com>
Date: Sat, 14 Oct 2023 23:52:24 +0530
Subject: [PATCH 0288/1120] raising revision for test_bar in test_datetime.py

---
 lib/matplotlib/tests/test_datetime.py | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index bea744cb435d..deaef36fef51 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -60,20 +60,23 @@ def test_axvspan(self):
     def test_bar(self):
         mpl.rcParams["date.converter"] = "concise"
         range_threshold = 10
-        fig, (ax1, ax2, ax3) = plt.subplots(3, 1, layout="constrained")
+        fig, (ax1, ax2, ax3, ax4) = plt.subplots(4, 1, layout="constrained")
 
         x_dates = np.array(
-            [datetime.datetime(2023, 10, delta) for delta in range(1, range_threshold)]
+            [datetime.datetime(2023, 10, delta) for delta in range(1, range_threshold)],
+            dtype=np.datetime64,
         )
         y_dates = np.array(
-            [datetime.datetime(2023, 10, delta) for delta in range(1, range_threshold)]
+            [datetime.datetime(2023, 10, delta) for delta in range(1, range_threshold)],
+            dtype=np.datetime64,
         )
         x_ranges = np.array(range(1, range_threshold))
         y_ranges = np.array(range(1, range_threshold))
 
-        ax1.bar(x_dates, y_ranges)
-        ax2.bar(x_dates, y_dates)
-        ax3.bar(x_ranges, y_dates)
+        ax1.bar(x_dates, y_ranges, width=np.timedelta64(range_threshold, "D"))
+        ax2.bar(x_dates, y_dates, width=np.timedelta64(range_threshold, "D"))
+        ax3.bar(x_ranges, y_dates, width=np.timedelta64(range_threshold, "D"))
+        ax4.bar(x_ranges, y_ranges, bottom=datetime.datetime(2023, 10, 1))
 
     @pytest.mark.xfail(reason="Test for bar_label not written yet")
     @mpl.style.context("default")

From cc814f99de463debf522f42cb6c96e97457d8e59 Mon Sep 17 00:00:00 2001
From: Alice Descoeudres <descoeudres@genzentrum.lmu.de>
Date: Sun, 15 Oct 2023 15:22:56 +0200
Subject: [PATCH 0289/1120] make fonts.py, mathtext.py, text_intro.py confirm
 to docs guidelines

---
 galleries/users_explain/text/fonts.py      | 4 ++--
 galleries/users_explain/text/mathtext.py   | 2 +-
 galleries/users_explain/text/text_intro.py | 8 ++++----
 3 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/galleries/users_explain/text/fonts.py b/galleries/users_explain/text/fonts.py
index fdb2de82ff5c..7efb9a00aa09 100644
--- a/galleries/users_explain/text/fonts.py
+++ b/galleries/users_explain/text/fonts.py
@@ -73,7 +73,7 @@
   - Limited support with Matplotlib
 
 Font subsetting
-~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^
 
 The PDF and PostScript formats support embedding fonts in files, allowing the
 display program to correctly render the text, independent of what fonts are
@@ -93,7 +93,7 @@
 Currently Type 3, Type 42, and TrueType fonts are subsetted.  Type 1 fonts are not.
 
 Core Fonts
-~~~~~~~~~~
+^^^^^^^^^^
 
 In addition to the ability to embed fonts, as part of the `PostScript
 <https://en.wikipedia.org/wiki/PostScript_fonts#Core_Font_Set>`_ and `PDF
diff --git a/galleries/users_explain/text/mathtext.py b/galleries/users_explain/text/mathtext.py
index 27aad440dcb5..7ff317804f98 100644
--- a/galleries/users_explain/text/mathtext.py
+++ b/galleries/users_explain/text/mathtext.py
@@ -288,7 +288,7 @@
 # (not minus).
 #
 # Custom fonts
-# ~~~~~~~~~~~~
+# ^^^^^^^^^^^^
 # Mathtext also provides a way to use custom fonts for math.  This method is
 # fairly tricky to use, and should be considered an experimental feature for
 # patient users only.  By setting :rc:`mathtext.fontset` to ``custom``,
diff --git a/galleries/users_explain/text/text_intro.py b/galleries/users_explain/text/text_intro.py
index eccd584ce36f..54fcb00c7a86 100644
--- a/galleries/users_explain/text/text_intro.py
+++ b/galleries/users_explain/text/text_intro.py
@@ -238,7 +238,7 @@
 # locations, and how they are labelled.
 #
 # Terminology
-# ~~~~~~~~~~~
+# ^^^^^^^^^^^
 #
 # *Axes* have an `matplotlib.axis.Axis` object for the ``ax.xaxis`` and
 # ``ax.yaxis`` that contain the information about how the labels in the axis
@@ -254,7 +254,7 @@
 # that format the tick labels.
 #
 # Simple ticks
-# ~~~~~~~~~~~~
+# ^^^^^^^^^^^^
 #
 # It is often convenient to simply define the
 # tick values, and sometimes the tick labels, overriding the default
@@ -287,7 +287,7 @@
 
 # %%
 # Tick Locators and Formatters
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+# ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 #
 # Instead of making a list of all the ticklabels, we could have
 # used `matplotlib.ticker.StrMethodFormatter` (new-style ``str.format()``
@@ -380,7 +380,7 @@ def formatoddticks(x, pos):
 
 # %%
 # Dateticks
-# ~~~~~~~~~
+# ^^^^^^^^^
 #
 # Matplotlib can accept `datetime.datetime` and `numpy.datetime64`
 # objects as plotting arguments.  Dates and times require special

From d58860f58c76d0278ce8d933afa781605bcb837c Mon Sep 17 00:00:00 2001
From: Gurudatta Shanbhag <gurushan13@gmail.com>
Date: Sun, 15 Oct 2023 19:39:30 +0530
Subject: [PATCH 0290/1120] [Doc]: Move Automated Tests section to workflow
 docs #26998 (#27093)

* fixes #26998
---
 doc/devel/coding_guide.rst         | 50 +--------------------------
 doc/devel/development_workflow.rst | 54 ++++++++++++++++++++++++++++++
 2 files changed, 55 insertions(+), 49 deletions(-)

diff --git a/doc/devel/coding_guide.rst b/doc/devel/coding_guide.rst
index 8e2a0aa7df4b..49f35e3ad13e 100644
--- a/doc/devel/coding_guide.rst
+++ b/doc/devel/coding_guide.rst
@@ -339,55 +339,7 @@ Merging
 
 Automated tests
 ---------------
-
-Whenever a pull request is created or updated, various automated test tools
-will run on all supported platforms and versions of Python.
-
-* Make sure the Linting, GitHub Actions, AppVeyor, CircleCI, and Azure
-  pipelines are passing before merging (All checks are listed at the bottom of
-  the GitHub page of your pull request). Here are some tips for finding the
-  cause of the test failure:
-
-  - If *Linting* fails, you have a code style issue, which will be listed
-    as annotations on the pull request's diff.
-  - If *Mypy* or *Stubtest* fails, you have inconsistency in type hints, which
-    will be listed as annotations in the diff.
-  - If a GitHub Actions or AppVeyor run fails, search the log for ``FAILURES``.
-    The subsequent section will contain information on the failed tests.
-  - If CircleCI fails, likely you have some reStructuredText style issue in
-    the docs. Search the CircleCI log for ``WARNING``.
-  - If Azure pipelines fail with an image comparison error, you can find the
-    images as *artifacts* of the Azure job:
-
-    - Click *Details* on the check on the GitHub PR page.
-    - Click *View more details on Azure Pipelines* to go to Azure.
-    - On the overview page *artifacts* are listed in the section *Related*.
-
-
-* Codecov and CodeQL are currently for information only. Their failure is not
-  necessarily a blocker.
-
-* tox_ is not used in the automated testing. It is supported for testing
-  locally.
-
-  .. _tox: https://tox.readthedocs.io/
-
-* If you know only a subset of CIs need to be run, this can be controlled on
-  individual commits by including the following substrings in commit messages:
-
-  - ``[ci doc]``: restrict the CI to documentation checks. For when you only
-    changed documentation (this skip is automatic if the changes are only under
-    ``doc/`` or ``galleries/``).
-  - ``[skip circle]``: skip the documentation build check. For when you didn't
-    change documentation.
-  - Unit tests can be turned off for individual platforms with
-
-    - ``[skip actions]``: GitHub Actions
-    - ``[skip appveyor]`` (must be in the first line of the commit): AppVeyor
-    - ``[skip azp]``: Azure Pipelines
-
-  - ``[skip ci]``: skip all CIs.  Use this only if you know your changes do not
-    need to be tested at all, which is very rare.
+Before being merged, a PR should pass the :ref:`automated-tests`. If you are unsure why a test is failing, ask on the PR or in our `chat space <https://gitter.im/matplotlib/matplotlib>`_
 
 .. _pr-squashing:
 
diff --git a/doc/devel/development_workflow.rst b/doc/devel/development_workflow.rst
index c03dab47c759..addc4315b94a 100644
--- a/doc/devel/development_workflow.rst
+++ b/doc/devel/development_workflow.rst
@@ -426,3 +426,57 @@ thought it was.
 Be judicious with force-pushing.  It is effectively re-writing published
 history, and if anyone has fetched the old commits, it will have a different view
 of history which can cause confusion.
+
+.. _automated-tests:
+
+Automated tests
+---------------
+
+Whenever a pull request is created or updated, various automated test tools
+will run on all supported platforms and versions of Python.
+
+* Make sure the Linting, GitHub Actions, AppVeyor, CircleCI, and Azure
+  pipelines are passing before merging (All checks are listed at the bottom of
+  the GitHub page of your pull request). Here are some tips for finding the
+  cause of the test failure:
+
+  - If *Linting* fails, you have a code style issue, which will be listed
+    as annotations on the pull request's diff.
+  - If *Mypy* or *Stubtest* fails, you have inconsistency in type hints, which
+    will be listed as annotations in the diff.
+  - If a GitHub Actions or AppVeyor run fails, search the log for ``FAILURES``.
+    The subsequent section will contain information on the failed tests.
+  - If CircleCI fails, likely you have some reStructuredText style issue in
+    the docs. Search the CircleCI log for ``WARNING``.
+  - If Azure pipelines fail with an image comparison error, you can find the
+    images as *artifacts* of the Azure job:
+
+    - Click *Details* on the check on the GitHub PR page.
+    - Click *View more details on Azure Pipelines* to go to Azure.
+    - On the overview page *artifacts* are listed in the section *Related*.
+
+
+* Codecov and CodeQL are currently for information only. Their failure is not
+  necessarily a blocker.
+
+* tox_ is not used in the automated testing. It is supported for testing
+  locally.
+
+  .. _tox: https://tox.readthedocs.io/
+
+* If you know only a subset of CIs need to be run, this can be controlled on
+  individual commits by including the following substrings in commit messages:
+
+  - ``[ci doc]``: restrict the CI to documentation checks. For when you only
+    changed documentation (this skip is automatic if the changes are only under
+    ``doc/`` or ``galleries/``).
+  - ``[skip circle]``: skip the documentation build check. For when you didn't
+    change documentation.
+  - Unit tests can be turned off for individual platforms with
+
+    - ``[skip actions]``: GitHub Actions
+    - ``[skip appveyor]`` (must be in the first line of the commit): AppVeyor
+    - ``[skip azp]``: Azure Pipelines
+
+  - ``[skip ci]``: skip all CIs.  Use this only if you know your changes do not
+    need to be tested at all, which is very rare.

From 8d69190a840b37e467c199fca69c845ebc83db15 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Fri, 13 Oct 2023 11:53:40 +0200
Subject: [PATCH 0291/1120] Deprecate nth_coord parameter from
 FixedAxisArtistHelper.new_fixed_axis.

FixedAxisArtistHelpers place an axis on either the bottom, top, left, or
right of an axis per (`loc`); we already infer whether it's an x-axis or
a y-axis (`nth_coord`) from that and error out if there's a mismatch, so
we may just as well delete the nth_coord parameter (which was already
optional to start with).

While at it, also expire deprecation for passing inconsistent nth_coord
and loc.
---
 .../deprecations/27095-AL.rst                 | 10 +++++
 .../next_api_changes/removals/27095-AL.rst    |  5 +++
 lib/mpl_toolkits/axisartist/axislines.py      | 37 ++++++-------------
 .../axisartist/grid_helper_curvelinear.py     |  2 +
 4 files changed, 28 insertions(+), 26 deletions(-)
 create mode 100644 doc/api/next_api_changes/deprecations/27095-AL.rst
 create mode 100644 doc/api/next_api_changes/removals/27095-AL.rst

diff --git a/doc/api/next_api_changes/deprecations/27095-AL.rst b/doc/api/next_api_changes/deprecations/27095-AL.rst
new file mode 100644
index 000000000000..2e5b2e1ea5e5
--- /dev/null
+++ b/doc/api/next_api_changes/deprecations/27095-AL.rst
@@ -0,0 +1,10 @@
+*nth_coord* parameter to axisartist helpers for fixed axis
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Helper APIs in `.axisartist` for generating a "fixed" axis on rectilinear axes
+(`.FixedAxisArtistHelperRectilinear`) no longer take a *nth_coord* parameter,
+as that parameter is entirely inferred from the (required) *loc* parameter and
+having inconsistent *nth_coord* and *loc* is an error.
+
+For curvilinear axes, the *nth_coord* parameter remains supported (it affects
+the *ticks*, not the axis position itself), but that parameter will become
+keyword-only, for consistency with the rectilinear case.
diff --git a/doc/api/next_api_changes/removals/27095-AL.rst b/doc/api/next_api_changes/removals/27095-AL.rst
new file mode 100644
index 000000000000..7b8e5981ca79
--- /dev/null
+++ b/doc/api/next_api_changes/removals/27095-AL.rst
@@ -0,0 +1,5 @@
+Inconsistent *nth_coord* and *loc* passed to ``_FixedAxisArtistHelperBase``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+The value of the *nth_coord* parameter of ``_FixedAxisArtistHelperBase`` and
+its subclasses is now inferred from the value of *loc*; passing inconsistent
+values (e.g., requesting a "top y axis" or a "left x axis") has no more effect.
diff --git a/lib/mpl_toolkits/axisartist/axislines.py b/lib/mpl_toolkits/axisartist/axislines.py
index 35717da8eaa9..e61c9a9fa8c3 100644
--- a/lib/mpl_toolkits/axisartist/axislines.py
+++ b/lib/mpl_toolkits/axisartist/axislines.py
@@ -116,17 +116,11 @@ class _FixedAxisArtistHelperBase(_AxisArtistHelperBase):
         lambda self: {"left": (0, 0), "right": (1, 0),
                       "bottom": (0, 0), "top": (0, 1)}[self._loc]))
 
+    @_api.delete_parameter("3.9", "nth_coord")
     def __init__(self, loc, nth_coord=None):
         """``nth_coord = 0``: x-axis; ``nth_coord = 1``: y-axis."""
-        self.nth_coord = (
-            nth_coord if nth_coord is not None else
-            _api.check_getitem(
-                {"bottom": 0, "top": 0, "left": 1, "right": 1}, loc=loc))
-        if (nth_coord == 0 and loc not in ["left", "right"]
-                or nth_coord == 1 and loc not in ["bottom", "top"]):
-            _api.warn_deprecated(
-                "3.7", message=f"{loc=!r} is incompatible with "
-                "{nth_coord=}; support is deprecated since %(since)s")
+        self.nth_coord = _api.check_getitem(
+            {"bottom": 0, "top": 0, "left": 1, "right": 1}, loc=loc)
         self._loc = loc
         self._pos = {"bottom": 0, "top": 1, "left": 0, "right": 1}[loc]
         super().__init__()
@@ -184,12 +178,13 @@ def get_line(self, axes):
 
 class FixedAxisArtistHelperRectilinear(_FixedAxisArtistHelperBase):
 
+    @_api.delete_parameter("3.9", "nth_coord")
     def __init__(self, axes, loc, nth_coord=None):
         """
         nth_coord = along which coordinate value varies
         in 2D, nth_coord = 0 ->  x axis, nth_coord = 1 -> y axis
         """
-        super().__init__(loc, nth_coord)
+        super().__init__(loc)
         self.axis = [axes.xaxis, axes.yaxis][self.nth_coord]
 
     # TICK
@@ -333,6 +328,8 @@ def __init__(self, axes):
         super().__init__()
         self.axes = axes
 
+    @_api.delete_parameter(
+        "3.9", "nth_coord", addendum="'nth_coord' is now inferred from 'loc'.")
     def new_fixed_axis(self, loc,
                        nth_coord=None,
                        axis_direction=None,
@@ -345,8 +342,7 @@ def new_fixed_axis(self, loc,
             axes = self.axes
         if axis_direction is None:
             axis_direction = loc
-
-        helper = FixedAxisArtistHelperRectilinear(axes, loc, nth_coord)
+        helper = FixedAxisArtistHelperRectilinear(axes, loc)
         axisline = AxisArtist(axes, helper, offset=offset,
                               axis_direction=axis_direction)
         return axisline
@@ -359,7 +355,6 @@ def new_floating_axis(self, nth_coord, value,
             _api.warn_external(
                 "'new_floating_axis' explicitly requires the axes keyword.")
             axes = self.axes
-
         helper = FloatingAxisArtistHelperRectilinear(
             axes, nth_coord, value, axis_direction)
         axisline = AxisArtist(axes, helper, axis_direction=axis_direction)
@@ -494,21 +489,11 @@ def get_children(self):
         return children
 
     def new_fixed_axis(self, loc, offset=None):
-        gh = self.get_grid_helper()
-        axis = gh.new_fixed_axis(loc,
-                                 nth_coord=None,
-                                 axis_direction=None,
-                                 offset=offset,
-                                 axes=self,
-                                 )
-        return axis
+        return self.get_grid_helper().new_fixed_axis(loc, offset=offset, axes=self)
 
     def new_floating_axis(self, nth_coord, value, axis_direction="bottom"):
-        gh = self.get_grid_helper()
-        axis = gh.new_floating_axis(nth_coord, value,
-                                    axis_direction=axis_direction,
-                                    axes=self)
-        return axis
+        return self.get_grid_helper().new_floating_axis(
+            nth_coord, value, axis_direction=axis_direction, axes=self)
 
 
 class AxesZero(Axes):
diff --git a/lib/mpl_toolkits/axisartist/grid_helper_curvelinear.py b/lib/mpl_toolkits/axisartist/grid_helper_curvelinear.py
index f76fd84b55fe..d34a848780e3 100644
--- a/lib/mpl_toolkits/axisartist/grid_helper_curvelinear.py
+++ b/lib/mpl_toolkits/axisartist/grid_helper_curvelinear.py
@@ -8,6 +8,7 @@
 import numpy as np
 
 import matplotlib as mpl
+from matplotlib import _api
 from matplotlib.path import Path
 from matplotlib.transforms import Affine2D, IdentityTransform
 from .axislines import (
@@ -270,6 +271,7 @@ def update_grid_finder(self, aux_trans=None, **kwargs):
         self.grid_finder.update(**kwargs)
         self._old_limits = None  # Force revalidation.
 
+    @_api.make_keyword_only("3.9", "nth_coord")
     def new_fixed_axis(self, loc,
                        nth_coord=None,
                        axis_direction=None,

From 9c6db6670f490462f5e1a6d677db843408868928 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Mon, 16 Oct 2023 19:39:02 -0400
Subject: [PATCH 0292/1120] TST: Use importlib for subprocess tests

This allows running pytest with any import-mode option.
---
 lib/matplotlib/testing/__init__.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/testing/__init__.py b/lib/matplotlib/testing/__init__.py
index da21eb42c5b2..d740b625b7c1 100644
--- a/lib/matplotlib/testing/__init__.py
+++ b/lib/matplotlib/testing/__init__.py
@@ -122,11 +122,16 @@ def subprocess_run_helper(func, *args, timeout, extra_env=None):
     """
     target = func.__name__
     module = func.__module__
+    file = func.__code__.co_filename
     proc = subprocess_run_for_testing(
         [
             sys.executable,
             "-c",
-            f"from {module} import {target}; {target}()",
+            f"import importlib.util;"
+            f"_spec = importlib.util.spec_from_file_location({module!r}, {file!r});"
+            f"_module = importlib.util.module_from_spec(_spec);"
+            f"_spec.loader.exec_module(_module);"
+            f"_module.{target}()",
             *args
         ],
         env={**os.environ, "SOURCE_DATE_EPOCH": "0", **(extra_env or {})},

From 239ed51d7ac781241a9aa0d555f050012d3d362a Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Mon, 16 Oct 2023 20:04:47 -0400
Subject: [PATCH 0293/1120] BLD: Fix setting FreeType build type in extension

Previously, this used a macro defined on the command line to a literal,
which was "stringified" with macro magic. But if the command-line
definition isn't there, then you just get a stringified version of the
macro name.

Instead, don't do any stringification, so that it fails on error. Then
pass a string as the defnition.
---
 lib/matplotlib/__init__.py | 16 +++++++++-------
 src/ft2font_wrapper.cpp    |  5 +----
 src/meson.build            |  5 +++++
 3 files changed, 15 insertions(+), 11 deletions(-)

diff --git a/lib/matplotlib/__init__.py b/lib/matplotlib/__init__.py
index 0cdfa43b40d1..53f27c46314a 100644
--- a/lib/matplotlib/__init__.py
+++ b/lib/matplotlib/__init__.py
@@ -1315,13 +1315,15 @@ def _init_tests():
     if (ft2font.__freetype_version__ != LOCAL_FREETYPE_VERSION or
             ft2font.__freetype_build_type__ != 'local'):
         _log.warning(
-            f"Matplotlib is not built with the correct FreeType version to "
-            f"run tests.  Rebuild without setting system-freetype=true in "
-            f"Meson setup options.  Expect many image comparison failures below.  "
-            f"Expected freetype version {LOCAL_FREETYPE_VERSION}.  "
-            f"Found freetype version {ft2font.__freetype_version__}.  "
-            "Freetype build type is {}local".format(
-                "" if ft2font.__freetype_build_type__ == 'local' else "not "))
+            "Matplotlib is not built with the correct FreeType version to run tests.  "
+            "Rebuild without setting system-freetype=true in Meson setup options.  "
+            "Expect many image comparison failures below.  "
+            "Expected freetype version %s.  "
+            "Found freetype version %s.  "
+            "Freetype build type is %slocal.",
+            LOCAL_FREETYPE_VERSION,
+            ft2font.__freetype_version__,
+            "" if ft2font.__freetype_build_type__ == 'local' else "not ")
 
 
 def _replacer(data, value):
diff --git a/src/ft2font_wrapper.cpp b/src/ft2font_wrapper.cpp
index 7888a9c212a5..ef47a6574985 100644
--- a/src/ft2font_wrapper.cpp
+++ b/src/ft2font_wrapper.cpp
@@ -10,9 +10,6 @@
 #include <set>
 #include <algorithm>
 
-#define STRINGIFY(s) XSTRINGIFY(s)
-#define XSTRINGIFY(s) #s
-
 static PyObject *convert_xys_to_array(std::vector<double> &xys)
 {
     npy_intp dims[] = {(npy_intp)xys.size() / 2, 2 };
@@ -1532,7 +1529,7 @@ PyMODINIT_FUNC PyInit_ft2font(void)
         // Glyph is not constructible from Python, thus not added to the module.
         PyType_Ready(PyGlyph_init_type()) ||
         PyModule_AddStringConstant(m, "__freetype_version__", version_string) ||
-        PyModule_AddStringConstant(m, "__freetype_build_type__", STRINGIFY(FREETYPE_BUILD_TYPE)) ||
+        PyModule_AddStringConstant(m, "__freetype_build_type__", FREETYPE_BUILD_TYPE) ||
         PyModule_AddIntConstant(m, "SCALABLE", FT_FACE_FLAG_SCALABLE) ||
         PyModule_AddIntConstant(m, "FIXED_SIZES", FT_FACE_FLAG_FIXED_SIZES) ||
         PyModule_AddIntConstant(m, "FIXED_WIDTH", FT_FACE_FLAG_FIXED_WIDTH) ||
diff --git a/src/meson.build b/src/meson.build
index 6a33d2dfb12a..9cee34bfce8b 100644
--- a/src/meson.build
+++ b/src/meson.build
@@ -96,6 +96,11 @@ extension_data = {
     'dependencies': [
       freetype_dep, numpy_dep, agg_dep.partial_dependency(includes: true),
     ],
+    'cpp_args': [
+      '-DFREETYPE_BUILD_TYPE="@0@"'.format(
+        freetype_dep.type_name() == 'internal' ? 'local' : 'system',
+      ),
+    ],
   },
   '_image': {
     'subdir': 'matplotlib',

From 44a201076f4e96d736a2891ffa26f11791404080 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Tue, 17 Oct 2023 02:14:58 +0200
Subject: [PATCH 0294/1120] DOC: Move figure member sections one level down

so that we have the sections:

- Figure
- SubFigure
- FigureBase
- Helper functions
---
 doc/api/figure_api.rst | 27 +++++++++++++++------------
 1 file changed, 15 insertions(+), 12 deletions(-)

diff --git a/doc/api/figure_api.rst b/doc/api/figure_api.rst
index 316bd8322d32..937020afd8fc 100644
--- a/doc/api/figure_api.rst
+++ b/doc/api/figure_api.rst
@@ -8,8 +8,11 @@
    :no-members:
    :no-undoc-members:
 
-The Figure class
-================
+Figure
+======
+
+Figure class
+------------
 .. autosummary::
    :toctree: _as_gen
    :template: autosummary_class_only.rst
@@ -19,7 +22,7 @@ The Figure class
 
 
 Adding Axes and SubFigures
-==========================
+--------------------------
 
 .. autosummary::
    :toctree: _as_gen
@@ -38,7 +41,7 @@ Adding Axes and SubFigures
    Figure.add_subfigure
 
 Saving
-======
+------
 
 .. autosummary::
    :toctree: _as_gen
@@ -49,7 +52,7 @@ Saving
 
 
 Annotating
-==========
+----------
 
 .. autosummary::
    :toctree: _as_gen
@@ -72,7 +75,7 @@ Annotating
 
 
 Figure geometry
-===============
+---------------
 
 .. autosummary::
    :toctree: _as_gen
@@ -90,7 +93,7 @@ Figure geometry
    Figure.set_dpi
 
 Subplot layout
-==============
+--------------
 
 .. autosummary::
    :toctree: _as_gen
@@ -102,7 +105,7 @@ Subplot layout
    Figure.get_layout_engine
 
 Discouraged or deprecated
--------------------------
+^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autosummary::
    :toctree: _as_gen
@@ -118,7 +121,7 @@ Discouraged or deprecated
    Figure.get_constrained_layout_pads
 
 Interactive
-===========
+-----------
 
 .. seealso::
 
@@ -135,7 +138,7 @@ Interactive
    Figure.pick
 
 Modifying appearance
-====================
+--------------------
 
 .. autosummary::
    :toctree: _as_gen
@@ -152,7 +155,7 @@ Modifying appearance
    Figure.get_edgecolor
 
 Adding and getting Artists
-==========================
+--------------------------
 
 .. autosummary::
    :toctree: _as_gen
@@ -164,7 +167,7 @@ Adding and getting Artists
    Figure.figimage
 
 Getting and modifying state
-===========================
+---------------------------
 
 .. seealso::
 

From a5cb9ef1d1550db0540334deba7f32265f1173f3 Mon Sep 17 00:00:00 2001
From: Scott Shambaugh <scottshambaugh@users.noreply.github.com>
Date: Sun, 24 Sep 2023 02:57:04 -0600
Subject: [PATCH 0295/1120] Consolidate 3D masking and fix for Axes3D.plot()

Move function to cbook

Whitespace

Privatize cbook._broadcast_with_masks
---
 lib/matplotlib/cbook.py                       | 39 +++++++++++++++++++
 lib/matplotlib/cbook.pyi                      |  1 +
 lib/mpl_toolkits/mplot3d/axes3d.py            | 28 +++----------
 lib/mpl_toolkits/mplot3d/tests/test_axes3d.py | 18 +++++++++
 4 files changed, 63 insertions(+), 23 deletions(-)

diff --git a/lib/matplotlib/cbook.py b/lib/matplotlib/cbook.py
index b56de559532d..5e9d8b82eb5a 100644
--- a/lib/matplotlib/cbook.py
+++ b/lib/matplotlib/cbook.py
@@ -1088,6 +1088,45 @@ def _combine_masks(*args):
     return margs
 
 
+def _broadcast_with_masks(*args, compress=False):
+    """
+    Broadcast inputs, combining all masked arrays.
+
+    Parameters
+    ----------
+    *args : array-like
+        The inputs to broadcast.
+    compress : bool, default: False
+        Whether to compress the masked arrays. If False, the masked values
+        are replaced by NaNs.
+
+    Returns
+    -------
+    list of array-like
+        The broadcasted and masked inputs.
+    """
+    # extract the masks, if any
+    masks = [k.mask for k in args if isinstance(k, np.ma.MaskedArray)]
+    # broadcast to match the shape
+    bcast = np.broadcast_arrays(*args, *masks)
+    inputs = bcast[:len(args)]
+    masks = bcast[len(args):]
+    if masks:
+        # combine the masks into one
+        mask = functools.reduce(np.logical_or, masks)
+        # put mask on and compress
+        if compress:
+            inputs = [np.ma.array(k, mask=mask).compressed()
+                      for k in inputs]
+        else:
+            inputs = [np.ravel(np.ma.array(k, mask=mask,
+                                           dtype=float).filled(np.nan))
+                      for k in inputs]
+    else:
+        inputs = [np.ravel(k) for k in inputs]
+    return inputs
+
+
 def boxplot_stats(X, whis=1.5, bootstrap=None, labels=None,
                   autorange=False):
     r"""
diff --git a/lib/matplotlib/cbook.pyi b/lib/matplotlib/cbook.pyi
index a6ad1e54a51c..36516e368e8b 100644
--- a/lib/matplotlib/cbook.pyi
+++ b/lib/matplotlib/cbook.pyi
@@ -130,6 +130,7 @@ class GrouperView(Generic[_T]):
 
 def simple_linear_interpolation(a: ArrayLike, steps: int) -> np.ndarray: ...
 def delete_masked_points(*args): ...
+def _broadcast_with_masks(*args, compress: bool=False) -> list[ArrayLike]: ...
 def boxplot_stats(
     X: ArrayLike,
     whis: float | tuple[float, float] = ...,
diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index 0c18bce8ebd3..84bbd763f882 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -11,7 +11,6 @@
 """
 
 from collections import defaultdict
-import functools
 import itertools
 import math
 import textwrap
@@ -1909,8 +1908,7 @@ def plot(self, xs, ys, *args, zdir='z', **kwargs):
         else:
             zs = kwargs.pop('zs', 0)
 
-        # Match length
-        zs = np.broadcast_to(zs, np.shape(xs))
+        xs, ys, zs = cbook._broadcast_with_masks(xs, ys, zs)
 
         lines = super().plot(xs, ys, *args, **kwargs)
         for line in lines:
@@ -2665,8 +2663,7 @@ def scatter(self, xs, ys, zs=0, zdir='z', s=20, c=None, depthshade=True,
         had_data = self.has_data()
         zs_orig = zs
 
-        xs, ys, zs = np.broadcast_arrays(
-            *[np.ravel(np.ma.filled(t, np.nan)) for t in [xs, ys, zs]])
+        xs, ys, zs = cbook._broadcast_with_masks(xs, ys, zs)
         s = np.ma.ravel(s)  # This doesn't have to match x, y in size.
 
         xs, ys, zs, s, c, color = cbook.delete_masked_points(
@@ -2722,7 +2719,7 @@ def bar(self, left, height, zs=0, zdir='z', *args, **kwargs):
 
         patches = super().bar(left, height, *args, **kwargs)
 
-        zs = np.broadcast_to(zs, len(left))
+        zs = np.broadcast_to(zs, len(left), subok=True)
 
         verts = []
         verts_zs = []
@@ -2988,23 +2985,8 @@ def calc_arrows(UVW):
 
         had_data = self.has_data()
 
-        input_args = [X, Y, Z, U, V, W]
-
-        # extract the masks, if any
-        masks = [k.mask for k in input_args
-                 if isinstance(k, np.ma.MaskedArray)]
-        # broadcast to match the shape
-        bcast = np.broadcast_arrays(*input_args, *masks)
-        input_args = bcast[:6]
-        masks = bcast[6:]
-        if masks:
-            # combine the masks into one
-            mask = functools.reduce(np.logical_or, masks)
-            # put mask on and compress
-            input_args = [np.ma.array(k, mask=mask).compressed()
-                          for k in input_args]
-        else:
-            input_args = [np.ravel(k) for k in input_args]
+        input_args = cbook._broadcast_with_masks(X, Y, Z, U, V, W,
+                                                 compress=True)
 
         if any(len(v) == 0 for v in input_args):
             # No quivers, so just make an empty collection and return early
diff --git a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
index f3666fffc418..4024eeddcf17 100644
--- a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
@@ -668,6 +668,24 @@ def test_surface3d_masked():
     ax.view_init(30, -80, 0)
 
 
+@check_figures_equal(extensions=["png"])
+def test_plot_scatter_masks(fig_test, fig_ref):
+    x = np.linspace(0, 10, 100)
+    y = np.linspace(0, 10, 100)
+    z = np.sin(x) * np.cos(y)
+    mask = z > 0
+
+    z_masked = np.ma.array(z, mask=mask)
+    ax_test = fig_test.add_subplot(projection='3d')
+    ax_test.scatter(x, y, z_masked)
+    ax_test.plot(x, y, z_masked)
+
+    x[mask] = y[mask] = z[mask] = np.nan
+    ax_ref = fig_ref.add_subplot(projection='3d')
+    ax_ref.scatter(x, y, z)
+    ax_ref.plot(x, y, z)
+
+
 @check_figures_equal(extensions=["png"])
 def test_plot_surface_None_arg(fig_test, fig_ref):
     x, y = np.meshgrid(np.arange(5), np.arange(5))

From eca4a346ea6a4944ad0707eeba9c70119d2fa1ba Mon Sep 17 00:00:00 2001
From: Sheepfan0828 <100391900+Sheepfan0828@users.noreply.github.com>
Date: Tue, 17 Oct 2023 18:07:19 +1100
Subject: [PATCH 0296/1120] Remove datetime test for axes.pie (#27117)

* Added the smoke testing for pie function

* Fixed some typos and mistakes in test code.

* added further comments

* Remove the test for pie function

---------

Co-authored-by: YiLun Fan <u7277320@anu.edu.au>
---
 lib/matplotlib/tests/test_datetime.py | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index ef83b837348d..72701cd2d8cd 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -229,12 +229,6 @@ def test_matshow(self):
         fig, ax = plt.subplots()
         ax.matshow(...)
 
-    @pytest.mark.xfail(reason="Test for pie not written yet")
-    @mpl.style.context("default")
-    def test_pie(self):
-        fig, ax = plt.subplots()
-        ax.pcolor(...)
-
     @pytest.mark.xfail(reason="Test for pcolor not written yet")
     @mpl.style.context("default")
     def test_pcolor(self):

From fb2240f865cf500281918d68a310689cdf419cb9 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Tue, 17 Oct 2023 11:50:54 +0200
Subject: [PATCH 0297/1120] Update clabel comment.

Mostly because BlockingContourLabeler stopped existing a while ago, so
update that part.  Also reword the rest, while at it.
---
 lib/matplotlib/contour.py | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/lib/matplotlib/contour.py b/lib/matplotlib/contour.py
index dc5ed5d626bc..d8e317be7c0a 100644
--- a/lib/matplotlib/contour.py
+++ b/lib/matplotlib/contour.py
@@ -157,21 +157,19 @@ def clabel(self, levels=None, *,
             A list of `.Text` instances for the labels.
         """
 
-        # clabel basically takes the input arguments and uses them to
-        # add a list of "label specific" attributes to the ContourSet
-        # object.  These attributes are all of the form label* and names
-        # should be fairly self explanatory.
+        # Based on the input arguments, clabel() adds a list of "label
+        # specific" attributes to the ContourSet object.  These attributes are
+        # all of the form label* and names should be fairly self explanatory.
         #
-        # Once these attributes are set, clabel passes control to the
-        # labels method (case of automatic label placement) or
-        # `BlockingContourLabeler` (case of manual label placement).
+        # Once these attributes are set, clabel passes control to the labels()
+        # method (for automatic label placement) or blocking_input_loop and
+        # _contour_labeler_event_handler (for manual label placement).
 
         if fmt is None:
             fmt = ticker.ScalarFormatter(useOffset=False)
             fmt.create_dummy_axis()
         self.labelFmt = fmt
         self._use_clabeltext = use_clabeltext
-        # Detect if manual selection is desired and remove from argument list.
         self.labelManual = manual
         self.rightside_up = rightside_up
         self._clabel_zorder = 2 + self.get_zorder() if zorder is None else zorder

From 85008799417ff51d2623d734c982bab443f5c459 Mon Sep 17 00:00:00 2001
From: wemi3 <62965919+wemi3@users.noreply.github.com>
Date: Tue, 17 Oct 2023 08:27:28 -0700
Subject: [PATCH 0298/1120] Added documentation on getting full list of
 registered colormaps re: issue #26244 (#26930)

* closes #26244, added documentation on getting full list of registered colormaps
---
 galleries/users_explain/colors/colormaps.py | 5 +++++
 lib/matplotlib/cm.py                        | 5 +++++
 2 files changed, 10 insertions(+)

diff --git a/galleries/users_explain/colors/colormaps.py b/galleries/users_explain/colors/colormaps.py
index a38dd2af0fc9..92b56d298976 100644
--- a/galleries/users_explain/colors/colormaps.py
+++ b/galleries/users_explain/colors/colormaps.py
@@ -15,6 +15,11 @@
 help on creating your own colormaps, see
 :ref:`colormap-manipulation`.
 
+To get a list of all registered colormaps, you can do::
+
+    from matplotlib import colormaps
+    list(colormaps)
+
 Overview
 ========
 
diff --git a/lib/matplotlib/cm.py b/lib/matplotlib/cm.py
index a2cd3788114d..3911986f3673 100644
--- a/lib/matplotlib/cm.py
+++ b/lib/matplotlib/cm.py
@@ -74,6 +74,11 @@ class ColormapRegistry(Mapping):
     Additional colormaps can be added via `.ColormapRegistry.register`::
 
         mpl.colormaps.register(my_colormap)
+
+    To get a list of all registered colormaps, you can do::
+
+        from matplotlib import colormaps
+        list(colormaps)
     """
     def __init__(self, cmaps):
         self._cmaps = cmaps

From fb0802d333af9d20571c4368d775afc4484a191b Mon Sep 17 00:00:00 2001
From: CozyFrog <garrett.sward@uconn.edu>
Date: Tue, 17 Oct 2023 15:45:13 -0400
Subject: [PATCH 0299/1120] Make suggested modifications to test_barh in
 test_datetime.py

---
 lib/matplotlib/tests/test_datetime.py | 26 +++++++++++++++-----------
 1 file changed, 15 insertions(+), 11 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index b035a7873083..900eb3643a21 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -77,17 +77,21 @@ def test_barbs(self):
     @mpl.style.context("default")
     def test_barh(self):
         mpl.rcParams["date.converter"] = 'concise'
-        N = 14
-        base = datetime.datetime(1970, 1, 1)
-        indices = np.arange(N)
-        dates = [base + datetime.timedelta(days=(7 * i)) for i in range(N)]
-        widths = [datetime.timedelta(days=(7*i)) for i in range(N)]
-        fig, (ax1, ax2, ax3, ax4) = plt.subplots(4, 1, layout='constrained')
-        error = np.random.rand(N)
-        ax1.barh(indices, dates, xerr=error)
-        ax2.barh(dates, indices)
-        ax3.barh(dates, dates)
-        ax4.barh(indices, width=widths, left=base)
+        fig, (ax1, ax2) = plt.subplots(2, 1, layout='constrained')
+        birth_date = np.array([datetime.datetime(2020, 4, 10),
+                               datetime.datetime(2020, 5, 30),
+                               datetime.datetime(2020, 10, 12),
+                               datetime.datetime(2020, 11, 15)])
+        year_start = datetime.datetime(2020, 1, 1)
+        year_end = datetime.datetime(2020, 12, 31)
+        age = [21, 53, 20, 24]
+        ax1.set_xlabel('Age')
+        ax1.set_ylabel('Birth Date')
+        ax1.barh(birth_date, width=age, height=datetime.timedelta(days=10))
+        ax2.set_xlim(left=year_start, right=year_end)
+        ax2.set_xlabel('Birth Date')
+        ax2.set_ylabel('Order of Birth Dates')
+        ax2.barh(np.arange(4), birth_date-year_start, left=year_start)
 
     @pytest.mark.xfail(reason="Test for boxplot not written yet")
     @mpl.style.context("default")

From 027f38e4fd759ad6f0b765a153bbc181f2a9e3f5 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Tue, 17 Oct 2023 16:49:01 -0400
Subject: [PATCH 0300/1120] BLD: use python3 for shebang consistent with
 pep-394

https://peps.python.org/pep-0394/
---
 tools/generate_matplotlibrc.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tools/generate_matplotlibrc.py b/tools/generate_matplotlibrc.py
index 33d6277870da..b779187c1e0d 100755
--- a/tools/generate_matplotlibrc.py
+++ b/tools/generate_matplotlibrc.py
@@ -1,4 +1,4 @@
-#!/usr/bin/env python
+#!/usr/bin/env python3
 """
 Generate matplotlirc for installs.
 

From 2d70e18573048d993293385b953920bcea2199e2 Mon Sep 17 00:00:00 2001
From: danielcobej <danielcobej@gmail.com>
Date: Wed, 18 Oct 2023 02:07:29 +0200
Subject: [PATCH 0301/1120] added test_axvspan

---
 lib/matplotlib/tests/test_datetime.py | 29 ++++++++++++++++++++++++---
 1 file changed, 26 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 72701cd2d8cd..87e9e51afef1 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -50,11 +50,34 @@ def test_axvline(self):
         fig, ax = plt.subplots()
         ax.axvline(...)
 
-    @pytest.mark.xfail(reason="Test for axvspan not written yet")
     @mpl.style.context("default")
     def test_axvspan(self):
-        fig, ax = plt.subplots()
-        ax.axvspan(...)
+        mpl.rcParams["date.converter"] = 'concise'
+
+        start_date = datetime.datetime(2023, 1, 1)
+        time_delta = datetime.timedelta(days=1)
+
+        values1 = np.random.randint(1, 10, 30)
+        values2 = np.random.randint(1, 10, 30)
+        values3 = np.random.randint(1, 10, 30)
+
+        bin_edges = [start_date + i * time_delta for i in range(31)]
+
+        fig, (ax1, ax2, ax3) = plt.subplots(3, 1, constrained_layout=True)
+
+        axes = [ax1, ax2, ax3]
+        values_list = [values1, values2, values3]
+
+        for ax, values in zip(axes, values_list):
+            ax.hist(
+                [start_date + i * time_delta for i in range(30)],
+                bins=bin_edges,
+                weights=values
+            )
+            for i in range(np.random.randint(1, 5)):
+                xmin = start_date + np.random.randint(0, 30) * time_delta
+                xmax = xmin + np.random.randint(1, 3) * time_delta
+                ax.axvspan(xmin=xmin, xmax=xmax, facecolor='green', alpha=0.5)
 
     @pytest.mark.xfail(reason="Test for bar not written yet")
     @mpl.style.context("default")

From 74ff93b06db9b32a0379f3faefb5fc51678dc55d Mon Sep 17 00:00:00 2001
From: Jeremy Farrell <farrjere@isu.edu>
Date: Tue, 17 Oct 2023 18:17:48 -0600
Subject: [PATCH 0302/1120] 26865 removing deprecations to axislines.py

---
 doc/api/next_api_changes/removals/26900-jf.rst | 4 ++++
 lib/mpl_toolkits/axisartist/axislines.py       | 4 ----
 2 files changed, 4 insertions(+), 4 deletions(-)
 create mode 100644 doc/api/next_api_changes/removals/26900-jf.rst

diff --git a/doc/api/next_api_changes/removals/26900-jf.rst b/doc/api/next_api_changes/removals/26900-jf.rst
new file mode 100644
index 000000000000..5f14c1543ad8
--- /dev/null
+++ b/doc/api/next_api_changes/removals/26900-jf.rst
@@ -0,0 +1,4 @@
+``passthru_pt``
+~~~~~~~~~~~~~~~
+
+This attribute of ``AxisArtistHelper``\s has been removed.
diff --git a/lib/mpl_toolkits/axisartist/axislines.py b/lib/mpl_toolkits/axisartist/axislines.py
index e61c9a9fa8c3..cbcdefe38f7c 100644
--- a/lib/mpl_toolkits/axisartist/axislines.py
+++ b/lib/mpl_toolkits/axisartist/axislines.py
@@ -112,10 +112,6 @@ def _to_xy(self, values, const):
 class _FixedAxisArtistHelperBase(_AxisArtistHelperBase):
     """Helper class for a fixed (in the axes coordinate) axis."""
 
-    passthru_pt = _api.deprecated("3.7")(property(
-        lambda self: {"left": (0, 0), "right": (1, 0),
-                      "bottom": (0, 0), "top": (0, 1)}[self._loc]))
-
     @_api.delete_parameter("3.9", "nth_coord")
     def __init__(self, loc, nth_coord=None):
         """``nth_coord = 0``: x-axis; ``nth_coord = 1``: y-axis."""

From 103ca388cb00abeb2f2dc868d4abed6d4abecb95 Mon Sep 17 00:00:00 2001
From: 0taj <89607583+0taj@users.noreply.github.com>
Date: Tue, 17 Oct 2023 21:23:54 -0400
Subject: [PATCH 0303/1120] Update developer release guide to follow
 conventions (#27118)

* Update doc/devel/release_guide.rst

* Update doc/devel/release_guide.rst

Co-authored-by: hannah <story645@gmail.com>
---
 doc/devel/release_guide.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/doc/devel/release_guide.rst b/doc/devel/release_guide.rst
index fe7c1022e038..2bbe589282a3 100644
--- a/doc/devel/release_guide.rst
+++ b/doc/devel/release_guide.rst
@@ -157,7 +157,7 @@ Update release notes
 --------------------
 
 What's new
-~~~~~~~~~~
+^^^^^^^^^^
 
 *Only needed for major and minor releases. Bugfix releases should not have new
 features.*
@@ -167,7 +167,7 @@ file :file:`doc/users/prev_whats_new/whats_new_{X}.{Y}.0.rst` and delete the ind
 files.
 
 API changes
-~~~~~~~~~~~
+^^^^^^^^^^^
 
 *Primarily needed for major and minor releases. We may sometimes have API
 changes in bugfix releases.*
@@ -177,7 +177,7 @@ file :file:`doc/api/prev_api_changes/api_changes_{X}.{Y}.{Z}.rst` and delete the
 individual files.
 
 Release notes TOC
-~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^
 
 Update :file:`doc/users/release_notes.rst`:
 
@@ -202,7 +202,7 @@ Update :file:`doc/users/release_notes.rst`:
      prev_whats_new/github_stats_X.Y.Z.rst
 
 Update version switcher
-~~~~~~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^^^^^
 
 Update ``doc/_static/switcher.json``:
 

From eb0ff88cde0b1b497d17ffb836d19f13f923aeae Mon Sep 17 00:00:00 2001
From: danielcobej <danielcobej@gmail.com>
Date: Wed, 18 Oct 2023 03:37:36 +0200
Subject: [PATCH 0304/1120] added random seed number

---
 lib/matplotlib/tests/test_datetime.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 87e9e51afef1..fb6eedc3b5e0 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -53,6 +53,7 @@ def test_axvline(self):
     @mpl.style.context("default")
     def test_axvspan(self):
         mpl.rcParams["date.converter"] = 'concise'
+        np.random.seed(19680801)
 
         start_date = datetime.datetime(2023, 1, 1)
         time_delta = datetime.timedelta(days=1)

From f6b55a448e5970b03deab1c943c5ab975f74a166 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Wed, 18 Oct 2023 00:46:47 -0400
Subject: [PATCH 0305/1120] changed automated tests from subsection to section
 in workflow

Accidentally missed this in my review on #26998 but automated tests makes more sense as a standalone then as a subsection of commit history tasks.
---
 doc/devel/development_workflow.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/devel/development_workflow.rst b/doc/devel/development_workflow.rst
index addc4315b94a..50170ee4ade3 100644
--- a/doc/devel/development_workflow.rst
+++ b/doc/devel/development_workflow.rst
@@ -430,7 +430,7 @@ of history which can cause confusion.
 .. _automated-tests:
 
 Automated tests
----------------
+===============
 
 Whenever a pull request is created or updated, various automated test tools
 will run on all supported platforms and versions of Python.

From 1d1171fa04a7d1fc3c2826b593610a2f832374f0 Mon Sep 17 00:00:00 2001
From: Cameron <19280099+QuadroTec@users.noreply.github.com>
Date: Wed, 18 Oct 2023 20:09:16 +1100
Subject: [PATCH 0306/1120] add test_stackplot in test_datetime.py (#27114)

* add test_stackplot in test_datetime.py

* Remove stackplot test with datetime y-axis

* Refactor test_stackplot
---
 lib/matplotlib/tests/test_datetime.py | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index f42e0a0d04d8..276b7c179afe 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -325,11 +325,15 @@ def test_spy(self):
         fig, ax = plt.subplots()
         ax.spy(...)
 
-    @pytest.mark.xfail(reason="Test for stackplot not written yet")
     @mpl.style.context("default")
     def test_stackplot(self):
-        fig, ax = plt.subplots()
-        ax.stackplot(...)
+        mpl.rcParams["date.converter"] = 'concise'
+        N = 10
+        stacked_nums = np.tile(np.arange(1, N), (4, 1))
+        dates = np.array([datetime.datetime(2020 + i, 1, 1) for i in range(N - 1)])
+
+        fig, ax = plt.subplots(layout='constrained')
+        ax.stackplot(dates, stacked_nums)
 
     @pytest.mark.xfail(reason="Test for stairs not written yet")
     @mpl.style.context("default")

From 73c0bd69cb242c35fa9b8e1f87c018ec0081e4f7 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Wed, 11 Oct 2023 21:29:13 +0200
Subject: [PATCH 0307/1120] Close all plot windows of a blocking show() on
 Ctrl+C

Addresses the Qt part of #23385.

It appears that `qapp.quit()` does not automatically close the windows
of the app. We therefore do it explicitly.

A unit test for this would be quite complex. Test this
by hand by Ctrl+C in an interactive shell.
---
 lib/matplotlib/backends/qt_compat.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/backends/qt_compat.py b/lib/matplotlib/backends/qt_compat.py
index d587223ab9cf..98f9f9572d69 100644
--- a/lib/matplotlib/backends/qt_compat.py
+++ b/lib/matplotlib/backends/qt_compat.py
@@ -163,7 +163,7 @@ def _exec(obj):
 
 
 @contextlib.contextmanager
-def _maybe_allow_interrupt(qapp):
+def _maybe_allow_interrupt(qapp_or_eventloop):
     """
     This manager allows to terminate a plot by sending a SIGINT. It is
     necessary because the running Qt backend prevents Python interpreter to
@@ -215,7 +215,9 @@ def _may_clear_sock(*args):
     def handle(*args):
         nonlocal handler_args
         handler_args = args
-        qapp.quit()
+        if hasattr(qapp_or_eventloop, 'closeAllWindows'):
+            qapp_or_eventloop.closeAllWindows()
+        qapp_or_eventloop.quit()
 
     signal.signal(signal.SIGINT, handle)
     try:

From 3432b7ab46e2866e7d2a360e07d1c4c4f1835a8a Mon Sep 17 00:00:00 2001
From: Steffen Rehberg <steffen.rehberg@googlemail.com>
Date: Tue, 5 Sep 2023 10:16:58 +0200
Subject: [PATCH 0308/1120] DOC: Fix colLoc default

- fix colLoc default
- make docs in table.py conform to numpydoc
- move setting default value of loc of Cell from code to signature
---
 .../next_api_changes/behavior/26696-SR.rst    |  6 ++++
 lib/matplotlib/table.py                       | 31 +++++++++----------
 lib/matplotlib/table.pyi                      |  2 +-
 3 files changed, 22 insertions(+), 17 deletions(-)
 create mode 100644 doc/api/next_api_changes/behavior/26696-SR.rst

diff --git a/doc/api/next_api_changes/behavior/26696-SR.rst b/doc/api/next_api_changes/behavior/26696-SR.rst
new file mode 100644
index 000000000000..231f412e426d
--- /dev/null
+++ b/doc/api/next_api_changes/behavior/26696-SR.rst
@@ -0,0 +1,6 @@
+*loc* parameter of ``Cell`` doesn't accept ``None`` anymore
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The default value of the *loc* parameter has been changed from ``None`` to ``right``,
+which already was the default location. The behavior of `.Cell` didn't change when
+called without an explicit *loc* parameter.
diff --git a/lib/matplotlib/table.py b/lib/matplotlib/table.py
index d42cdf878d61..345ce98ccf60 100644
--- a/lib/matplotlib/table.py
+++ b/lib/matplotlib/table.py
@@ -57,7 +57,7 @@ def __init__(self, xy, width, height, *,
                  edgecolor='k', facecolor='w',
                  fill=True,
                  text='',
-                 loc=None,
+                 loc='right',
                  fontproperties=None,
                  visible_edges='closed',
                  ):
@@ -70,20 +70,21 @@ def __init__(self, xy, width, height, *,
             The cell width.
         height : float
             The cell height.
-        edgecolor : color
+        edgecolor : color, default: 'k'
             The color of the cell border.
-        facecolor : color
+        facecolor : color, default: 'w'
             The cell facecolor.
-        fill : bool
+        fill : bool, default: True
             Whether the cell background is filled.
-        text : str
+        text : str, optional
             The cell text.
-        loc : {'left', 'center', 'right'}, default: 'right'
+        loc : {'right', 'center', 'left'}
             The alignment of the text within the cell.
-        fontproperties : dict
+        fontproperties : dict, optional
             A dict defining the font properties of the text. Supported keys and
             values are the keyword arguments accepted by `.FontProperties`.
-        visible_edges : str, default: 'closed'
+        visible_edges : {'closed', 'open', 'horizontal', 'vertical'} or \
+substring of 'BRTL'
             The cell edges to be drawn with a line: a substring of 'BRTL'
             (bottom, right, top, left), or one of 'open' (no edges drawn),
             'closed' (all edges drawn), 'horizontal' (bottom and top),
@@ -97,8 +98,6 @@ def __init__(self, xy, width, height, *,
         self.visible_edges = visible_edges
 
         # Create text object
-        if loc is None:
-            loc = 'right'
         self._loc = loc
         self._text = Text(x=xy[0], y=xy[1], clip_on=False,
                           text=text, fontproperties=fontproperties,
@@ -283,7 +282,7 @@ def __init__(self, ax, loc=None, bbox=None, **kwargs):
         ----------
         ax : `~matplotlib.axes.Axes`
             The `~.axes.Axes` to plot the table into.
-        loc : str
+        loc : str, optional
             The position of the cell with respect to *ax*. This must be one of
             the `~.Table.codes`.
         bbox : `.Bbox` or [xmin, ymin, width, height], optional
@@ -685,7 +684,7 @@ def table(ax,
     cellColours : 2D list of colors, optional
         The background colors of the cells.
 
-    cellLoc : {'left', 'center', 'right'}, default: 'right'
+    cellLoc : {'right', 'center', 'left'}
         The alignment of the text within the cells.
 
     colWidths : list of float, optional
@@ -698,7 +697,7 @@ def table(ax,
     rowColours : list of colors, optional
         The colors of the row header cells.
 
-    rowLoc : {'left', 'center', 'right'}, default: 'left'
+    rowLoc : {'left', 'center', 'right'}
         The text alignment of the row header cells.
 
     colLabels : list of str, optional
@@ -707,10 +706,10 @@ def table(ax,
     colColours : list of colors, optional
         The colors of the column header cells.
 
-    colLoc : {'left', 'center', 'right'}, default: 'left'
+    colLoc : {'center', 'left', 'right'}
         The text alignment of the column header cells.
 
-    loc : str, optional
+    loc : str, default: 'bottom'
         The position of the cell with respect to *ax*. This must be one of
         the `~.Table.codes`.
 
@@ -718,7 +717,7 @@ def table(ax,
         A bounding box to draw the table into. If this is not *None*, this
         overrides *loc*.
 
-    edges : substring of 'BRTL' or {'open', 'closed', 'horizontal', 'vertical'}
+    edges : {'closed', 'open', 'horizontal', 'vertical'} or substring of 'BRTL'
         The cell edges to be drawn with a line. See also
         `~.Cell.visible_edges`.
 
diff --git a/lib/matplotlib/table.pyi b/lib/matplotlib/table.pyi
index 842c55edb5a3..0108ecd99f89 100644
--- a/lib/matplotlib/table.pyi
+++ b/lib/matplotlib/table.pyi
@@ -22,7 +22,7 @@ class Cell(Rectangle):
         facecolor: ColorType = ...,
         fill: bool = ...,
         text: str = ...,
-        loc: Literal["left", "center", "right"] | None = ...,
+        loc: Literal["left", "center", "right"] = ...,
         fontproperties: dict[str, Any] | None = ...,
         visible_edges: str | None = ...
     ) -> None: ...

From 994abce7bff31372b4e25f5c0e6f40836d9c1727 Mon Sep 17 00:00:00 2001
From: danielcobej <danielcobej@gmail.com>
Date: Wed, 18 Oct 2023 15:14:12 +0200
Subject: [PATCH 0309/1120] added test_axhspan

---
 lib/matplotlib/tests/test_datetime.py | 32 ++++++++++++++++++++++++---
 1 file changed, 29 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 276b7c179afe..3c5f664d7fdb 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -32,11 +32,37 @@ def test_axhline(self):
         fig, ax = plt.subplots()
         ax.axhline(...)
 
-    @pytest.mark.xfail(reason="Test for axhspan not written yet")
     @mpl.style.context("default")
     def test_axhspan(self):
-        fig, ax = plt.subplots()
-        ax.axhspan(...)
+        mpl.rcParams["date.converter"] = 'concise'
+        np.random.seed(19680801)
+
+        start_date = datetime.datetime(2023, 1, 1)
+        time_delta = datetime.timedelta(days=1)
+
+        values = np.random.randint(1, 10, 30)
+        bin_edges = [start_date + i * time_delta for i in range(31)]
+
+        fig, (ax1, ax2) = plt.subplots(2, 1, constrained_layout=True)
+
+        ax1.hist(
+            [start_date + i * time_delta for i in range(30)],
+            bins=bin_edges,
+            weights=values)
+
+        for i in range(np.random.randint(1, 5)):
+            ymin = np.random.randint(1, 8)
+            ymax = ymin + np.random.randint(1, 3)
+            ax1.axhspan(ymin=ymin, ymax=ymax, facecolor='green', alpha=0.5)
+
+        ax2.hist(
+            [start_date + i * time_delta for i in range(30)],
+            bins=bin_edges,
+            weights=values)
+
+        y_values = np.unique(values)
+        for i, y in enumerate(y_values[::2]):
+            ax2.axhspan(ymin=y, ymax=y+1, facecolor='green', alpha=0.5)
 
     @pytest.mark.xfail(reason="Test for axline not written yet")
     @mpl.style.context("default")

From a589856d2c1f8a5f8236808a4098a4efb341a17c Mon Sep 17 00:00:00 2001
From: Seohyeon Lee <96499556+seohyeon-lee-2025@users.noreply.github.com>
Date: Wed, 18 Oct 2023 12:13:26 -0700
Subject: [PATCH 0310/1120] Add scatter test for datetime units (#26882)

* test_axes

added 3 subplots with datetime array on the x axis, y axis, and both axes.

* incorporated issues in previous PR

* deleted whitespaces after end of line

* got rid of space in 311

* Simplified datetime array

* fixed mistake in previous commit

* Update test_datetime.py

I needed to rotate axis labels because they were still clogged after I reduced array length

* Update test_datetime.py

eliminated unused variable according to feedback ('lims')
---
 lib/matplotlib/tests/test_datetime.py | 22 +++++++++++++++++++---
 1 file changed, 19 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 276b7c179afe..c9455d450b70 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -301,11 +301,27 @@ def test_quiverkey(self):
         fig, ax = plt.subplots()
         ax.quiverkey(...)
 
-    @pytest.mark.xfail(reason="Test for scatter not written yet")
     @mpl.style.context("default")
     def test_scatter(self):
-        fig, ax = plt.subplots()
-        ax.scatter(...)
+        mpl.rcParams["date.converter"] = 'concise'
+        base = datetime.datetime(2005, 2, 1)
+        dates = [base + datetime.timedelta(hours=(2 * i)) for i in range(10)]
+        N = len(dates)
+        np.random.seed(19680801)
+        y = np.cumsum(np.random.randn(N))
+        fig, axs = plt.subplots(3, 1, layout='constrained', figsize=(6, 6))
+        # datetime array on x axis
+        axs[0].scatter(dates, y)
+        for label in axs[0].get_xticklabels():
+            label.set_rotation(40)
+            label.set_horizontalalignment('right')
+        # datetime on y axis
+        axs[1].scatter(y, dates)
+        # datetime on both x, y axes
+        axs[2].scatter(dates, dates)
+        for label in axs[2].get_xticklabels():
+            label.set_rotation(40)
+            label.set_horizontalalignment('right')
 
     @pytest.mark.xfail(reason="Test for semilogx not written yet")
     @mpl.style.context("default")

From 42c4ef04cdf64fc0618bcb9d1cd30d11fe0e5dbd Mon Sep 17 00:00:00 2001
From: danielcobej <danielcobej@gmail.com>
Date: Wed, 18 Oct 2023 23:09:25 +0200
Subject: [PATCH 0311/1120] switched x and y axis

---
 lib/matplotlib/tests/test_datetime.py | 28 +++++++++------------------
 1 file changed, 9 insertions(+), 19 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 3c5f664d7fdb..9a359d6c33b7 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -40,29 +40,19 @@ def test_axhspan(self):
         start_date = datetime.datetime(2023, 1, 1)
         time_delta = datetime.timedelta(days=1)
 
-        values = np.random.randint(1, 10, 30)
-        bin_edges = [start_date + i * time_delta for i in range(31)]
-
-        fig, (ax1, ax2) = plt.subplots(2, 1, constrained_layout=True)
-
-        ax1.hist(
-            [start_date + i * time_delta for i in range(30)],
-            bins=bin_edges,
-            weights=values)
+        fig, (ax1, ax2) = plt.subplots(2, 1, constrained_layout=True, figsize=(10, 8))
 
+        ax1.set_ylim(start_date, start_date + 29*time_delta)
         for i in range(np.random.randint(1, 5)):
-            ymin = np.random.randint(1, 8)
-            ymax = ymin + np.random.randint(1, 3)
+            ymin = start_date + np.random.randint(0, 30) * time_delta
+            ymax = ymin + np.random.randint(1, 3) * time_delta
             ax1.axhspan(ymin=ymin, ymax=ymax, facecolor='green', alpha=0.5)
 
-        ax2.hist(
-            [start_date + i * time_delta for i in range(30)],
-            bins=bin_edges,
-            weights=values)
-
-        y_values = np.unique(values)
-        for i, y in enumerate(y_values[::2]):
-            ax2.axhspan(ymin=y, ymax=y+1, facecolor='green', alpha=0.5)
+        ax2.set_ylim(start_date, start_date + 29*time_delta)
+        for i in range(0, 30, 2):
+            ymin = start_date + i * time_delta
+            ymax = ymin + time_delta
+            ax2.axhspan(ymin=ymin, ymax=ymax, facecolor='green', alpha=0.5)
 
     @pytest.mark.xfail(reason="Test for axline not written yet")
     @mpl.style.context("default")

From 3783494358d15a35fe63e9607a84cf1d57cbd18f Mon Sep 17 00:00:00 2001
From: Junpei Ota <otaj@purdue.edu>
Date: Thu, 19 Oct 2023 02:19:32 -0400
Subject: [PATCH 0312/1120] Added smoke test for Axes.text

---
 lib/matplotlib/tests/test_datetime.py | 28 ++++++++++++++++++++++++---
 1 file changed, 25 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index f42e0a0d04d8..5d9ca3bb8f18 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -355,11 +355,33 @@ def test_streamplot(self):
         fig, ax = plt.subplots()
         ax.streamplot(...)
 
-    @pytest.mark.xfail(reason="Test for text not written yet")
     @mpl.style.context("default")
     def test_text(self):
-        fig, ax = plt.subplots()
-        ax.text(...)
+        mpl.rcParams["date.converter"] = 'concise'
+        fig, (ax1, ax2, ax3) = plt.subplots(3, 1, layout="constrained")
+
+        limit_value = 10
+        font_properties = {'family': 'serif', 'size': 12, 'weight': 'bold'}
+        test_date = datetime.datetime(2023, 10, 1)
+
+        x_data = np.array(range(1, limit_value))
+        y_data = np.array(range(1, limit_value))
+
+        x_dates = np.array(
+            [datetime.datetime(2023, 10, n) for n in range(1, limit_value)]
+        )
+        y_dates = np.array(
+            [datetime.datetime(2023, 10, n) for n in range(1, limit_value)]
+        )
+
+        ax1.plot(x_dates, y_data)
+        ax1.text(test_date, 5, "Inserted Text", **font_properties)
+
+        ax2.plot(x_data, y_dates)
+        ax2.text(7, test_date, "Inserted Text", **font_properties)
+
+        ax3.plot(x_dates, y_dates)
+        ax3.text(test_date, test_date, "Inserted Text", **font_properties)
 
     @pytest.mark.xfail(reason="Test for tricontour not written yet")
     @mpl.style.context("default")

From 0762613cf07dcace06cffdae731b681e0a728dea Mon Sep 17 00:00:00 2001
From: Scott Shambaugh <14363975+scottshambaugh@users.noreply.github.com>
Date: Thu, 19 Oct 2023 09:36:56 -0600
Subject: [PATCH 0313/1120] Apply suggestions from code review

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Co-authored-by: Kyle Sunden <git@ksunden.space>
---
 lib/matplotlib/cbook.py  | 5 ++---
 lib/matplotlib/cbook.pyi | 2 +-
 2 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/lib/matplotlib/cbook.py b/lib/matplotlib/cbook.py
index 5e9d8b82eb5a..b0cde743482b 100644
--- a/lib/matplotlib/cbook.py
+++ b/lib/matplotlib/cbook.py
@@ -1113,14 +1113,13 @@ def _broadcast_with_masks(*args, compress=False):
     masks = bcast[len(args):]
     if masks:
         # combine the masks into one
-        mask = functools.reduce(np.logical_or, masks)
+        mask = np.logical_or.reduce(masks)
         # put mask on and compress
         if compress:
             inputs = [np.ma.array(k, mask=mask).compressed()
                       for k in inputs]
         else:
-            inputs = [np.ravel(np.ma.array(k, mask=mask,
-                                           dtype=float).filled(np.nan))
+            inputs = [np.ma.array(k, mask=mask, dtype=float).filled(np.nan).ravel()
                       for k in inputs]
     else:
         inputs = [np.ravel(k) for k in inputs]
diff --git a/lib/matplotlib/cbook.pyi b/lib/matplotlib/cbook.pyi
index 36516e368e8b..c60ae0781af1 100644
--- a/lib/matplotlib/cbook.pyi
+++ b/lib/matplotlib/cbook.pyi
@@ -130,7 +130,7 @@ class GrouperView(Generic[_T]):
 
 def simple_linear_interpolation(a: ArrayLike, steps: int) -> np.ndarray: ...
 def delete_masked_points(*args): ...
-def _broadcast_with_masks(*args, compress: bool=False) -> list[ArrayLike]: ...
+def _broadcast_with_masks(*args: ArrayLike, compress: bool = ...) -> list[ArrayLike]: ...
 def boxplot_stats(
     X: ArrayLike,
     whis: float | tuple[float, float] = ...,

From 585ba9f4f0e6a298bc521762cd054298b34696e1 Mon Sep 17 00:00:00 2001
From: Matthew Morrison <msm8275@rit.edu>
Date: Thu, 19 Oct 2023 16:19:06 -0400
Subject: [PATCH 0314/1120] Fixes to message about classic notebooks.
 Simplifying other text in the section

---
 .../users_explain/figure/interactive.rst      | 77 ++++++++++---------
 1 file changed, 39 insertions(+), 38 deletions(-)

diff --git a/galleries/users_explain/figure/interactive.rst b/galleries/users_explain/figure/interactive.rst
index a32d1a1eb847..1e82d37f10f4 100644
--- a/galleries/users_explain/figure/interactive.rst
+++ b/galleries/users_explain/figure/interactive.rst
@@ -7,7 +7,7 @@
 .. _interactive_figures:
 
 ===================
-Interactive figures
+Interactive Figures
 ===================
 
 When working with data, interactivity can be invaluable. The pan/zoom and
@@ -36,11 +36,16 @@ that include interactive tools, a toolbar, a tool-tip, and
 `.pyplot.subplots`
     Creates a new `.Figure` and fills it with a grid of `~.axes.Axes`
 
-`.pyplot` has a notion of "The Current Figure" which can be accessed
-through `.pyplot.gcf` and a notion of "The Current Axes" accessed
-through `.pyplot.gca`.  Almost all of the functions in `.pyplot` pass
-through the current `.Figure` / `~.axes.Axes` (or create one) as
-appropriate.
+`.pyplot.gcf`
+    Get the current `.Figure`. If there is current no figure on the pyplot figure
+    stack, a new figure is created
+
+`.pyplot.gca`
+    Get the current `~.axes.Axes`. If there is current no Axes on the Figure,
+    a new one is created
+
+Almost all of the functions in `.pyplot` pass through the current `.Figure` / `~.axes.Axes`
+(or create one) as appropriate.
 
 Matplotlib keeps a reference to all of the open figures
 created via `pyplot.figure` or `pyplot.subplots` so that the figures will not be garbage
@@ -51,14 +56,13 @@ collected. `.Figure`\s can be closed and deregistered from `.pyplot` individuall
 .. seealso::
 
    For more discussion of Matplotlib's event system and integrated event loops:
-
    - :ref:`interactive_figures_and_eventloops`
    - :ref:`event-handling`
 
 
 .. _ipython-pylab:
 
-IPython integration
+IPython Integration
 ===================
 
 We recommend using IPython for an interactive shell.  In addition to
@@ -189,7 +193,7 @@ the GUI main loop in some other way.
 
 .. warning::
 
-   Using `.Figure.show` it is possible to display a figure on
+   Using `.Figure.show`, it is possible to display a figure on
    the screen without starting the event loop and without being in
    interactive mode.  This may work (depending on the GUI toolkit) but
    will likely result in a non-responsive figure.
@@ -211,8 +215,7 @@ Interactive navigation
 .. image:: ../../../_static/toolbar.png
 
 All figure windows come with a navigation toolbar, which can be used
-to navigate through the data set.  Here is a description of each of
-the buttons at the bottom of the toolbar
+to navigate through the data set.
 
 .. image:: ../../../../lib/matplotlib/mpl-data/images/home_large.png
 
@@ -221,20 +224,19 @@ the buttons at the bottom of the toolbar
 .. image:: ../../../../lib/matplotlib/mpl-data/images/forward_large.png
 
 The ``Home``, ``Forward`` and ``Back`` buttons
-    These are akin to a web browser's home, forward and back controls.
+    These are similar to a web browser's home, forward and back controls.
     ``Forward`` and ``Back`` are used to navigate back and forth between
     previously defined views.  They have no meaning unless you have already
     navigated somewhere else using the pan and zoom buttons.  This is analogous
     to trying to click ``Back`` on your web browser before visiting a
     new page or ``Forward`` before you have gone back to a page --
-    nothing happens.  ``Home`` always takes you to the
-    first, default view of your data. Again, all of these buttons should
-    feel very familiar to any user of a web browser.
+    nothing happens.  ``Home`` takes you to the
+    first, default view of your data.
 
 .. image:: ../../../../lib/matplotlib/mpl-data/images/move_large.png
 
 The ``Pan/Zoom`` button
-    This button has two modes: pan and zoom.  Click the toolbar button
+    This button has two modes: pan and zoom.  Click the ``Pan/Zoom`` button
     to activate panning and zooming, then put your mouse somewhere
     over an axes.  Press the left mouse button and hold it to pan the
     figure, dragging it to a new position.  When you release it, the
@@ -244,8 +246,8 @@ The ``Pan/Zoom`` button
     the right mouse button to zoom, dragging it to a new position.
     The x axis will be zoomed in proportionately to the rightward
     movement and zoomed out proportionately to the leftward movement.
-    The same is true for the y axis and up/down motions.  The point under your
-    mouse when you begin the zoom remains stationary, allowing you to
+    The same is true for the y axis and up/down motions (up zooms in, down zooms out).
+    The point under your mouse when you begin the zoom remains stationary, allowing you to
     zoom in or out around that point as much as you wish.  You can use the
     modifier keys 'x', 'y' or 'CONTROL' to constrain the zoom to the x
     axis, the y axis, or aspect ratio preserve, respectively.
@@ -257,9 +259,8 @@ The ``Pan/Zoom`` button
 
 .. image:: ../../../../lib/matplotlib/mpl-data/images/zoom_to_rect_large.png
 
-The ``Zoom-to-rectangle`` button
-    Click this toolbar button to activate this mode.  Put your mouse somewhere
-    over an axes and press a mouse button.  Define a rectangular region by
+The ``Zoom-to-Rectangle`` button
+    Put your mouse somewhere over an axes and press a mouse button.  Define a rectangular region by
     dragging the mouse while holding the button to a new location.  When using
     the left mouse button, the axes view limits will be zoomed to the defined
     region.  When using the right mouse button, the axes view limits will be
@@ -268,8 +269,8 @@ The ``Zoom-to-rectangle`` button
 .. image:: ../../../../lib/matplotlib/mpl-data/images/subplots_large.png
 
 The ``Subplot-configuration`` button
-    Use this tool to configure the appearance of the subplot:
-    you can stretch or compress the left, right, top, or bottom
+    Use this button to configure the appearance of the subplot.
+    You can stretch or compress the left, right, top, or bottom
     side of the subplot, or the space between the rows or
     space between the columns.
 
@@ -313,7 +314,7 @@ Preserve aspect ratio              hold **CONTROL** when panning/zooming with mo
 
 .. _other-shells:
 
-Other Python prompts
+Other Python Prompts
 ====================
 
 Interactive mode works in the default Python prompt:
@@ -325,7 +326,7 @@ Interactive mode works in the default Python prompt:
    >>> plt.ion()
    >>>
 
-however this does not ensure that the event hook is properly installed
+However, this does not ensure that the event hook is properly installed
 and your figures may not be responsive.  Please consult the
 documentation of your GUI toolkit for details.
 
@@ -333,17 +334,7 @@ documentation of your GUI toolkit for details.
 .. _jupyter_notebooks_jupyterlab:
 
 Jupyter Notebooks / JupyterLab
-------------------------------
-
-.. note::
-
-   To get the interactive functionality described here, you must be
-   using an interactive backend.  The default backend in notebooks,
-   the inline backend, is not.  `~ipykernel.pylab.backend_inline`
-   renders the figure once and inserts a static image into the
-   notebook when the cell is executed.  Because the images are static, they
-   cannot be panned / zoomed, take user input, or be updated from other
-   cells.
+==============================
 
 To get interactive figures in the 'classic' notebook or Jupyter lab,
 use the `ipympl <https://matplotlib.org/ipympl>`__ backend
@@ -356,7 +347,7 @@ If ``ipympl`` is installed use the magic:
 
 to select and enable it.
 
-If you only need to use the classic notebook, you can use
+If you only need to use the classic notebook (i.e. `notebook<7`), you can use
 
 .. sourcecode:: ipython
 
@@ -365,8 +356,18 @@ If you only need to use the classic notebook, you can use
 which uses the `.backend_nbagg` backend provided by Matplotlib;
 however, nbagg does not work in Jupyter Lab.
 
+.. note::
+
+   To get the interactive functionality described here, you must be
+   using an interactive backend.  The default backend in notebooks,
+   the inline backend, is not.  `~ipykernel.pylab.backend_inline`
+   renders the figure once and inserts a static image into the
+   notebook when the cell is executed.  Because the images are static, they
+   cannot be panned / zoomed, take user input, or be updated from other
+   cells.
+
 GUIs + Jupyter
-^^^^^^^^^^^^^^
+--------------
 
 You can also use one of the non-``ipympl`` GUI backends in a Jupyter Notebook.
 If you are running your Jupyter kernel locally, the GUI window will spawn on

From 8325676e0d5b60b3175388404beaf2cfc5f776c5 Mon Sep 17 00:00:00 2001
From: Matthew Morrison <msm8275@rit.edu>
Date: Thu, 19 Oct 2023 16:23:00 -0400
Subject: [PATCH 0315/1120] Adding note about classic notebook to
 figure_intro.rst

---
 galleries/users_explain/figure/figure_intro.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/galleries/users_explain/figure/figure_intro.rst b/galleries/users_explain/figure/figure_intro.rst
index 000828bdee0b..c126b1bcf4c0 100644
--- a/galleries/users_explain/figure/figure_intro.rst
+++ b/galleries/users_explain/figure/figure_intro.rst
@@ -73,6 +73,13 @@ other than the default "inline" backend, you will likely need to use an ipython
 .. seealso::
     :ref:`interactive_figures`.
 
+.. note::
+
+   If you only need to use the classic notebook (i.e. `notebook<7`),
+   you can use:
+
+   .. sourcecode:: ipython
+
 Standalone scripts and interactive use
 --------------------------------------
 

From 5cf3da9a1f4086ab6d9e24a0a591701326b36850 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Thu, 19 Oct 2023 19:00:20 -0500
Subject: [PATCH 0316/1120] Add test for disconnected paths, remove invalidated
 paths

---
 lib/matplotlib/contour.py                     |   5 ++++
 .../contour_disconnected_segments.png         | Bin 0 -> 9795 bytes
 lib/matplotlib/tests/test_contour.py          |  23 ++++++++++++++++++
 3 files changed, 28 insertions(+)
 create mode 100644 lib/matplotlib/tests/baseline_images/test_contour/contour_disconnected_segments.png

diff --git a/lib/matplotlib/contour.py b/lib/matplotlib/contour.py
index adb72ef46017..ec343763cce0 100644
--- a/lib/matplotlib/contour.py
+++ b/lib/matplotlib/contour.py
@@ -350,6 +350,11 @@ def _split_path_and_get_label_rotation(self, path, idx, screen_pos, lw, spacing=
         taken into account when breaking the path, but not when computing the angle.
         """
         if hasattr(self, "_old_style_split_collections"):
+            vis = False
+            for coll in self._old_style_split_collections:
+                vis |= coll.get_visible()
+                coll.remove()
+            self.set_visible(vis)
             del self._old_style_split_collections  # Invalidate them.
 
         xys = path.vertices
diff --git a/lib/matplotlib/tests/baseline_images/test_contour/contour_disconnected_segments.png b/lib/matplotlib/tests/baseline_images/test_contour/contour_disconnected_segments.png
new file mode 100644
index 0000000000000000000000000000000000000000..ceb700e09de290f6c07c280904551e2b25114382
GIT binary patch
literal 9795
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

literal 0
HcmV?d00001

diff --git a/lib/matplotlib/tests/test_contour.py b/lib/matplotlib/tests/test_contour.py
index b3b7f575b07a..74165faad9fc 100644
--- a/lib/matplotlib/tests/test_contour.py
+++ b/lib/matplotlib/tests/test_contour.py
@@ -116,11 +116,31 @@ def test_contour_manual_labels(split_collections):
 
     plt.figure(figsize=(6, 2), dpi=200)
     cs = plt.contour(x, y, z)
+
+    _maybe_split_collections(split_collections)
+
     pts = np.array([(1.0, 3.0), (1.0, 4.4), (1.0, 6.0)])
     plt.clabel(cs, manual=pts)
     pts = np.array([(2.0, 3.0), (2.0, 4.4), (2.0, 6.0)])
     plt.clabel(cs, manual=pts, fontsize='small', colors=('r', 'g'))
 
+
+@pytest.mark.parametrize("split_collections", [False, True])
+@image_comparison(['contour_disconnected_segments'],
+                  remove_text=True, style='mpl20', extensions=['png'])
+def test_contour_label_with_disconnected_segments(split_collections):
+    x, y = np.mgrid[-1:1:21j, -1:1:21j]
+    z = 1 / np.sqrt(0.01 + (x + 0.3) ** 2 + y ** 2)
+    z += 1 / np.sqrt(0.01 + (x - 0.3) ** 2 + y ** 2)
+
+    plt.figure()
+    cs = plt.contour(x, y, z, levels=[7])
+
+    # Adding labels should invalidate the old style
+    _maybe_split_collections(split_collections)
+
+    cs.clabel(manual=[(0.2, 0.1)])
+
     _maybe_split_collections(split_collections)
 
 
@@ -232,6 +252,9 @@ def test_labels(split_collections):
     disp_units = [(216, 177), (359, 290), (521, 406)]
     data_units = [(-2, .5), (0, -1.5), (2.8, 1)]
 
+    # Adding labels should invalidate the old style
+    _maybe_split_collections(split_collections)
+
     CS.clabel()
 
     for x, y in data_units:

From 7f631a66817c4e0e1fbd0edc2199cd07d12717f8 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Tue, 10 Oct 2023 11:32:30 -0400
Subject: [PATCH 0317/1120] added info for getting compilation output from
 meson on autorebuild added force MSVC to troubleshooting added meson-python
 to intersphinx

Co-authored-by: Kyle Sunden <git@ksunden.space>
Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>
---
 doc/conf.py                     |  1 +
 doc/devel/development_setup.rst | 25 +++++++++++++++++++------
 doc/devel/troubleshooting.rst   | 20 ++++++++++++++++++++
 pyproject.toml                  |  3 +++
 4 files changed, 43 insertions(+), 6 deletions(-)

diff --git a/doc/conf.py b/doc/conf.py
index c2cdadf0ec24..b817d52ff62e 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -207,6 +207,7 @@ def _check_dependencies():
     'scipy': ('https://docs.scipy.org/doc/scipy/', None),
     'tornado': ('https://www.tornadoweb.org/en/stable/', None),
     'xarray': ('https://docs.xarray.dev/en/stable/', None),
+    'meson-python': ('https://meson-python.readthedocs.io/en/stable/', None)
 }
 
 
diff --git a/doc/devel/development_setup.rst b/doc/devel/development_setup.rst
index 0e7db431163f..cad0d3084f8a 100644
--- a/doc/devel/development_setup.rst
+++ b/doc/devel/development_setup.rst
@@ -164,12 +164,25 @@ command ::
 
 The 'editable/develop mode' builds everything and places links in your Python environment
 so that Python will be able to import Matplotlib from your development source directory.
-This allows you to import your modified version of Matplotlib without re-installing after
-every change. Note that before the merging of the `Meson port
-<https://github.com/matplotlib/matplotlib/pull/26621>`_, this is only true for ``*.py``
-files. If you change the C-extension source based on a commit before the change to the
-Meson build system (which might also happen if you change branches), you will have to
-re-run the above command.
+This allows you to import your modified version of Matplotlib without having to
+re-install after changing a ``.py`` or compiled extension file.
+
+When working on a branch that does not have Meson enabled, meaning it does not
+have :ghpull:`26621` in its history (log), you will have to reinstall from source
+each time you change any compiled extension code.
+
+Build options
+-------------
+If you are working heavily with files that need to be compiled, you may want to
+inspect the compilation log. This can be enabled by setting the environment
+variable :envvar:`MESONPY_EDITABLE_VERBOSE` or by setting the ``editable-verbose``
+config during installation ::
+
+   python -m pip install --no-build-isolation --config-settings=editable-verbose=true --editable .
+
+For more information on installation and other configuration options, see the
+Meson Python :external+meson-python:ref:`editable installs guide <how-to-guides-editable-installs>`.
+
 
 Verify the Installation
 =======================
diff --git a/doc/devel/troubleshooting.rst b/doc/devel/troubleshooting.rst
index 77c1b242399b..74ce81b2da00 100644
--- a/doc/devel/troubleshooting.rst
+++ b/doc/devel/troubleshooting.rst
@@ -43,3 +43,23 @@ unlink this file. Multiple versions of Matplotlib can be linked to the same DLL,
 for example a development version installed in a development conda environment
 and a stable version running in a Jupyter notebook. To resolve this error, fully
 close all running instances of Matplotlib.
+
+Windows compilation errors
+==========================
+If the compiled extensions are not building on Windows due to errors in linking to
+Windows' header files, for example ``../../src/_tkagg.cpp:133:10: error: 'WM_DPICHANGED' was not declared in this scope``,
+you should check which compiler Meson is using:
+
+.. code-block:: bat
+
+    Build type: native build
+    Project name: matplotlib
+    Project version: 3.9.0.dev0
+    C compiler for the host machine: cc (gcc 7.2.0 "cc (Rev1, Built by MSYS2 project) 7.2.0")
+    C linker for the host machine: cc ld.bfd 2.29.1
+    C++ compiler for the host machine: c++ (gcc 7.2.0 "c++ (Rev1, Built by MSYS2 project) 7.2.0")
+    C++ linker for the host machine: c++ ld.bfd 2.29.1
+
+Our :ref:`dependencies <dependencies>` documentation lists the minimum header
+version if you intended to use ``MSYS2``. If you intended to use ``MSVC`` then
+you may need to force Meson to :external+meson-python:ref:`use MSVC <vsenv-example>`.
diff --git a/pyproject.toml b/pyproject.toml
index 50e533b0c15b..4bdab4eb93c7 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -287,4 +287,7 @@ ignore_messages = [
     "Hyperlink target \".*\" is not referenced.",
     "Duplicate implicit target name: \".*\".",
     "Duplicate explicit target name: \".*\".",
+    # sphinx.ext.intersphinx directives
+    "No role entry for \"external+.*\".",
+    "Unknown interpreted text role \"external+.*\"."
 ]

From 0a139a0a60f9c2ccac679d7e1ba8c0259a288849 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Tue, 10 Oct 2023 23:00:25 -0400
Subject: [PATCH 0318/1120] reduced redundancy in headings and note required
 MinGW windows header version

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>
---
 doc/devel/dependencies.rst      | 109 +++++++++++++++++++-------------
 doc/devel/development_setup.rst |   2 +
 doc/users/installing/index.rst  |   2 +-
 3 files changed, 67 insertions(+), 46 deletions(-)

diff --git a/doc/devel/dependencies.rst b/doc/devel/dependencies.rst
index 0ffdaf65696a..458fff51b82f 100644
--- a/doc/devel/dependencies.rst
+++ b/doc/devel/dependencies.rst
@@ -1,15 +1,17 @@
 .. _dependencies:
 
-============
+************
 Dependencies
-============
+************
+
+.. _runtime_dependencies:
 
 Runtime dependencies
 ====================
 
 
-Mandatory dependencies
-----------------------
+Required
+--------
 
 When installing through a package manager like ``pip`` or ``conda``, the
 mandatory dependencies are automatically installed. This list is mainly for
@@ -31,8 +33,8 @@ reference.
 
 .. _optional_dependencies:
 
-Optional dependencies
----------------------
+Optional
+--------
 
 The following packages and tools are not required but extend the capabilities
 of Matplotlib.
@@ -106,10 +108,14 @@ Additionally, Matplotlib depends on:
 .. _FreeType: https://www.freetype.org/
 .. _Qhull: http://www.qhull.org/
 
-By default, Matplotlib downloads and builds its own copies of FreeType (this is
-necessary to run the test suite, because different versions of FreeType
-rasterize characters differently) and of Qhull.  As an exception, Matplotlib
-defaults to the system version of FreeType on AIX.
+
+Download during install
+^^^^^^^^^^^^^^^^^^^^^^^
+
+By default, Matplotlib downloads and builds its own copies of Qhull and FreeType.
+The vendored version of FreeType is necessary to run the test suite, because
+different versions of FreeType rasterize characters differently.
+
 
 Use system libraries
 ^^^^^^^^^^^^^^^^^^^^
@@ -176,9 +182,8 @@ remember to clear your artifacts before re-building::
 
   git clean -xfd
 
-
-Manual Download
-^^^^^^^^^^^^^^^
+From source files
+^^^^^^^^^^^^^^^^^
 
 If the automatic download does not work (for example, on air-gapped systems) it is
 preferable to instead use system libraries. However you can manually download the
@@ -202,19 +207,23 @@ In all cases the required version of pip is embedded in the CPython source.
 
 .. _development-dependencies:
 
-Dependencies for building Matplotlib
-====================================
+Build dependencies
+==================
+
 
 .. _setup-dependencies:
 
-Setup dependencies
-------------------
+Python
+------
+
+By default, ``pip`` will build packages using build isolation, meaning that these
+build dependencies are temporally installed by pip for the duration of the
+Matplotlib build process. However, build isolation is disabled when :ref:`installing Matplotlib for development <development-install>`;
+therefore we recommend using one of our :ref:`virtual environment configurations <dev-environment>` to
+create a development environment in which these packages are automatically installed.
 
-By default, ``pip`` will build packages using build isolation, and the following
-dependencies will be automatically installed in the isolated environment to build
-Matplotlib. However, for development, you may wish to make an editable install, which
-will require disabling build isolation, so these build dependencies should be installed
-in your target environment manually:
+If you are developing Matplotlib and unable to use our environment configurations,
+then you must manually install the following packages into your development environment:
 
 - `meson-python <https://meson-python.readthedocs.io/>`_ (>= 0.13.1).
 - `ninja <https://ninja-build.org/>`_ (>= 1.8.2). This may be available in your package
@@ -230,11 +239,13 @@ in your target environment manually:
 
 .. _compile-dependencies:
 
-C++ compiler
-------------
+Compiled extensions
+-------------------
 
 Matplotlib requires a C++ compiler that supports C++17, and each platform has a
 development environment that must be installed before a compiler can be installed.
+You may also need to install headers for various libraries used in the compiled extension
+source files.
 
 .. tab-set::
 
@@ -261,6 +272,8 @@ development environment that must be installed before a compiler can be installe
 
         Alternatively, you can install a Linux-like environment such as `CygWin <https://www.cygwin.com/>`_
         or `Windows Subsystem for Linux <https://learn.microsoft.com/en-us/windows/wsl/install>`_.
+        If using `MinGW-64 <https://www.mingw-w64.org/>`_, we require **v6** of the
+        ```Mingw-w64-x86_64-headers``.
 
 
 We highly recommend that you install a compiler using your platform tool, i.e.,
@@ -294,16 +307,19 @@ Xcode, VS Code or Linux package manager. Choose **one** compiler from this list:
 
 .. _test-dependencies:
 
-Dependencies for testing Matplotlib
-===================================
+Test dependencies
+=================
+
 This section lists the additional software required for
 :ref:`running the tests <testing>`.
 
-Required:
+Required
+--------
 
 - pytest_ (>= 7.0.0)
 
-Optional:
+Optional
+--------
 
 In addition to all of the optional dependencies on the main library, for
 testing the following will be used if they are installed.
@@ -357,11 +373,12 @@ them will be skipped by pytest.
 
 .. _doc-dependencies:
 
-Dependencies for building Matplotlib's documentation
-====================================================
+Documentation dependencies
+==========================
+
+Python
+------
 
-Python packages
----------------
 The additional Python packages required to build the
 :ref:`documentation <documenting-matplotlib>` are listed in
 :file:`doc-requirements.txt` and can be installed using ::
@@ -373,13 +390,22 @@ The content of :file:`doc-requirements.txt` is also shown below:
 .. include:: ../../requirements/doc/doc-requirements.txt
    :literal:
 
-Additional external dependencies
---------------------------------
-Required:
 
+External tools
+--------------
+
+The documentation requires LaTeX and Graphviz.  These are not
+Python packages and must be installed separately. The documentation can be
+built without Inkscape and optipng, but the build process will raise various
+warnings. If the build process warns that you are missing fonts, make sure
+your LaTeX distribution bundles cm-super or install it separately.
+
+Required
+^^^^^^^^
+
+* `Graphviz <http://www.graphviz.org/download>`_
 * a minimal working LaTeX distribution, e.g., `TeX Live <https://www.tug.org/texlive/>`_ or
   `MikTeX <https://miktex.org/>`_
-* `Graphviz <http://www.graphviz.org/download>`_
 * the following LaTeX packages (if your OS bundles TeX Live, the
   "complete" version of the installer, e.g. "texlive-full" or "texlive-all",
   will often automatically include these packages):
@@ -388,18 +414,11 @@ Required:
   * `dvipng <https://ctan.org/pkg/dvipng>`_
   * `underscore <https://ctan.org/pkg/underscore>`_
 
-Optional, but recommended:
+Optional
+^^^^^^^^
 
 * `Inkscape <https://inkscape.org>`_
 * `optipng <http://optipng.sourceforge.net>`_
 * the font "Humor Sans" (aka the "XKCD" font), or the free alternative
   `Comic Neue <http://comicneue.com/>`_
 * the font "Times New Roman"
-
-.. note::
-
-  The documentation will not build without LaTeX and Graphviz.  These are not
-  Python packages and must be installed separately. The documentation can be
-  built without Inkscape and optipng, but the build process will raise various
-  warnings. If the build process warns that you are missing fonts, make sure
-  your LaTeX distribution bundles cm-super or install it separately.
diff --git a/doc/devel/development_setup.rst b/doc/devel/development_setup.rst
index 0e7db431163f..a41a74351660 100644
--- a/doc/devel/development_setup.rst
+++ b/doc/devel/development_setup.rst
@@ -154,6 +154,8 @@ Most Python dependencies will be installed when :ref:`setting up the environment
 but non-Python dependencies like C++ compilers, LaTeX, and other system applications
 must be installed separately. For a full list, see :ref:`dependencies`.
 
+.. _development-install:
+
 Install Matplotlib in editable mode
 ===================================
 
diff --git a/doc/users/installing/index.rst b/doc/users/installing/index.rst
index c8c9ba549775..0d25ffbf76fa 100644
--- a/doc/users/installing/index.rst
+++ b/doc/users/installing/index.rst
@@ -31,7 +31,7 @@ precompiled wheel for your OS and Python.
 
    For support of other GUI frameworks, LaTeX rendering, saving
    animations and a larger selection of file formats, you can
-   install :ref:`optional_dependencies`.
+   install :ref:`optional dependencies <optional_dependencies>`.
 
 
 Third-party distributions

From a1868d4ec4e7d4487ef24ee2034339c399c40097 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Fri, 20 Oct 2023 11:47:49 +0200
Subject: [PATCH 0319/1120] Link xkcd color survey in named colors example

and slightly reword their description
---
 galleries/examples/color/named_colors.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/galleries/examples/color/named_colors.py b/galleries/examples/color/named_colors.py
index 0181e0f06742..9ae4ec4957f3 100644
--- a/galleries/examples/color/named_colors.py
+++ b/galleries/examples/color/named_colors.py
@@ -101,8 +101,10 @@ def plot_colortable(colors, *, ncols=4, sort_colors=True):
 # -----------
 # XKCD Colors
 # -----------
-# XKCD colors are supported, but they produce a large figure, so we skip them
-# for now. You can use the following code if desired::
+# Matplotlib supports colors from the
+# `xkcd color survey <https://xkcd.com/color/rgb/>`_, e.g. ``"xkcd:sky blue"``. Since
+# this contains almost 1000 colors, a figure of this would be very large and is thus
+# omitted here. You can use the following code to generate the overview yourself ::
 #
 #     xkcd_fig = plot_colortable(mcolors.XKCD_COLORS)
 #     xkcd_fig.savefig("XKCD_Colors.png")

From 4af86972fafe0a9ebf18ddded200e910d25c57d2 Mon Sep 17 00:00:00 2001
From: danielcobej <danielcobej@gmail.com>
Date: Fri, 20 Oct 2023 15:48:24 +0200
Subject: [PATCH 0320/1120] datetime vs number, number vs datetime, datetime vs
 datetime

---
 lib/matplotlib/tests/test_datetime.py | 45 ++++++++++++++++++---------
 1 file changed, 30 insertions(+), 15 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 9a359d6c33b7..ca8b746bad0d 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -35,24 +35,39 @@ def test_axhline(self):
     @mpl.style.context("default")
     def test_axhspan(self):
         mpl.rcParams["date.converter"] = 'concise'
-        np.random.seed(19680801)
 
         start_date = datetime.datetime(2023, 1, 1)
-        time_delta = datetime.timedelta(days=1)
-
-        fig, (ax1, ax2) = plt.subplots(2, 1, constrained_layout=True, figsize=(10, 8))
-
-        ax1.set_ylim(start_date, start_date + 29*time_delta)
-        for i in range(np.random.randint(1, 5)):
-            ymin = start_date + np.random.randint(0, 30) * time_delta
-            ymax = ymin + np.random.randint(1, 3) * time_delta
-            ax1.axhspan(ymin=ymin, ymax=ymax, facecolor='green', alpha=0.5)
-
-        ax2.set_ylim(start_date, start_date + 29*time_delta)
-        for i in range(0, 30, 2):
-            ymin = start_date + i * time_delta
-            ymax = ymin + time_delta
+        dates = [start_date + datetime.timedelta(days=i) for i in range(31)]
+        numbers = list(range(1, 32))
+
+        fig, (ax1, ax2, ax3) = plt.subplots(3, 1,
+                                            constrained_layout=True,
+                                            figsize=(10, 12))
+
+        ax1.plot(dates, numbers, marker='o', color='blue')
+        for i in range(0, 31, 2):
+            ax1.axhspan(ymin=i+1, ymax=i+2, facecolor='green', alpha=0.5)
+        ax1.set_title('Datetime vs. Number')
+        ax1.set_xlabel('Date')
+        ax1.set_ylabel('Number')
+
+        ax2.plot(numbers, dates, marker='o', color='blue')
+        for i in range(0, 31, 2):
+            ymin = start_date + datetime.timedelta(days=i)
+            ymax = ymin + datetime.timedelta(days=1)
             ax2.axhspan(ymin=ymin, ymax=ymax, facecolor='green', alpha=0.5)
+        ax2.set_title('Number vs. Datetime')
+        ax2.set_xlabel('Number')
+        ax2.set_ylabel('Date')
+
+        ax3.plot(dates, dates, marker='o', color='blue')
+        for i in range(0, 31, 2):
+            ymin = start_date + datetime.timedelta(days=i)
+            ymax = ymin + datetime.timedelta(days=1)
+            ax3.axhspan(ymin=ymin, ymax=ymax, facecolor='green', alpha=0.5)
+        ax3.set_title('Datetime vs. Datetime')
+        ax3.set_xlabel('Date')
+        ax3.set_ylabel('Date')
 
     @pytest.mark.xfail(reason="Test for axline not written yet")
     @mpl.style.context("default")

From fd16b352b1e16673bd7b2aae3a1e9ae8d6bcc3cf Mon Sep 17 00:00:00 2001
From: Koustav Ghosh <ghosh.hardkots.koustav1@gmail.com>
Date: Sat, 21 Oct 2023 18:57:39 +0530
Subject: [PATCH 0321/1120] raising revision for test_bar in test_datetime.py

---
 lib/matplotlib/tests/test_datetime.py | 25 ++++++++++++-------------
 1 file changed, 12 insertions(+), 13 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 69ff5d37c0d0..2ec3d03ae377 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -90,24 +90,23 @@ def test_axvspan(self):
     @mpl.style.context("default")
     def test_bar(self):
         mpl.rcParams["date.converter"] = "concise"
-        range_threshold = 10
-        fig, (ax1, ax2, ax3, ax4) = plt.subplots(4, 1, layout="constrained")
+
+        fig, (ax1, ax2) = plt.subplots(2, 1, layout="constrained")
 
         x_dates = np.array(
-            [datetime.datetime(2023, 10, delta) for delta in range(1, range_threshold)],
+            [
+                datetime(2020, 6, 30),
+                datetime(2020, 7, 22),
+                datetime(2020, 8, 3),
+                datetime(2020, 9, 14),
+            ],
             dtype=np.datetime64,
         )
-        y_dates = np.array(
-            [datetime.datetime(2023, 10, delta) for delta in range(1, range_threshold)],
-            dtype=np.datetime64,
-        )
-        x_ranges = np.array(range(1, range_threshold))
-        y_ranges = np.array(range(1, range_threshold))
+        x_ranges = [8800, 2600, 8500, 7400]
 
-        ax1.bar(x_dates, y_ranges, width=np.timedelta64(range_threshold, "D"))
-        ax2.bar(x_dates, y_dates, width=np.timedelta64(range_threshold, "D"))
-        ax3.bar(x_ranges, y_dates, width=np.timedelta64(range_threshold, "D"))
-        ax4.bar(x_ranges, y_ranges, bottom=datetime.datetime(2023, 10, 1))
+        x = np.datetime64(datetime(2020, 6, 1))
+        ax1.bar(x_dates, x_ranges, width=np.timedelta64(4, "D"))
+        ax2.bar(np.arange(4), x_dates, bottom=x)
 
     @pytest.mark.xfail(reason="Test for bar_label not written yet")
     @mpl.style.context("default")

From fbbbc53dcf0812fa40d28bac6f4eef8fb0e9bac2 Mon Sep 17 00:00:00 2001
From: Jirka <jirka.borovec@seznam.cz>
Date: Sat, 21 Oct 2023 16:23:23 +0200
Subject: [PATCH 0322/1120] docs: adding explanation for color in
 `set_facecolor`

---
 lib/matplotlib/axes/_base.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index 8d29df3b72e8..ee74ab188d98 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -1499,7 +1499,7 @@ def set_facecolor(self, color):
 
         Parameters
         ----------
-        color : color
+        color : color defined by string name, char abbreviation or hex, see :doc:`gallery/color/named_colors`
         """
         self._facecolor = color
         self.stale = True

From 86b12d3c8ccb840384cd53d49b1cf4d5ba6fcb84 Mon Sep 17 00:00:00 2001
From: Koustav Ghosh <ghosh.hardkots.koustav1@gmail.com>
Date: Sat, 21 Oct 2023 21:37:40 +0530
Subject: [PATCH 0323/1120] Update test_datetime.py

---
 lib/matplotlib/tests/test_datetime.py | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 2ec3d03ae377..30645f7ec1aa 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -95,16 +95,16 @@ def test_bar(self):
 
         x_dates = np.array(
             [
-                datetime(2020, 6, 30),
-                datetime(2020, 7, 22),
-                datetime(2020, 8, 3),
-                datetime(2020, 9, 14),
+                datetime.datetime(2020, 6, 30),
+                datetime.datetime(2020, 7, 22),
+                datetime.datetime(2020, 8, 3),
+                datetime.datetime(2020, 9, 14),
             ],
             dtype=np.datetime64,
         )
         x_ranges = [8800, 2600, 8500, 7400]
 
-        x = np.datetime64(datetime(2020, 6, 1))
+        x = np.datetime64(datetime.datetime(2020, 6, 1))
         ax1.bar(x_dates, x_ranges, width=np.timedelta64(4, "D"))
         ax2.bar(np.arange(4), x_dates, bottom=x)
 

From 63a11fac4490a0a4eb91ae1d48b7748ac01572e9 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Sat, 14 Oct 2023 22:27:15 -0400
Subject: [PATCH 0324/1120] move pytest configs from .ini to.toml remove
 configs that are now defaults

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>
---
 pyproject.toml |  7 +++++++
 pytest.ini     | 12 ------------
 2 files changed, 7 insertions(+), 12 deletions(-)
 delete mode 100644 pytest.ini

diff --git a/pyproject.toml b/pyproject.toml
index 4bdab4eb93c7..ba090844331e 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -291,3 +291,10 @@ ignore_messages = [
     "No role entry for \"external+.*\".",
     "Unknown interpreted text role \"external+.*\"."
 ]
+
+[tool.pytest.ini_options]
+# Because tests can be run from an installed copy, most of our Pytest
+# configuration is in the `pytest_configure` function in
+# `lib/matplotlib/testing/conftest.py`.
+minversion = "7.0"
+testpaths = ["lib"]
diff --git a/pytest.ini b/pytest.ini
deleted file mode 100644
index 68920f59be01..000000000000
--- a/pytest.ini
+++ /dev/null
@@ -1,12 +0,0 @@
-# Because tests can be run from an installed copy, most of our Pytest
-# configuration is in the `pytest_configure` function in
-# `lib/matplotlib/testing/conftest.py`. This configuration file exists only to
-# set a minimum pytest version and to prevent pytest from wasting time trying
-# to check examples and documentation files that are not really tests.
-
-[pytest]
-minversion = 7.0.0
-
-testpaths = lib
-python_files = test_*.py
-junit_family = xunit2

From 46e0dc258b019fc90cd5c0eb9e9584cbe3fd7837 Mon Sep 17 00:00:00 2001
From: danielcobej <danielcobej@gmail.com>
Date: Sun, 22 Oct 2023 17:53:05 +0200
Subject: [PATCH 0325/1120] datetime vs datetime, number vs datetime, datetime
 vs number

---
 lib/matplotlib/tests/test_datetime.py | 55 +++++++++++++++------------
 1 file changed, 31 insertions(+), 24 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index fb6eedc3b5e0..993948d8f106 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -53,32 +53,39 @@ def test_axvline(self):
     @mpl.style.context("default")
     def test_axvspan(self):
         mpl.rcParams["date.converter"] = 'concise'
-        np.random.seed(19680801)
 
         start_date = datetime.datetime(2023, 1, 1)
-        time_delta = datetime.timedelta(days=1)
-
-        values1 = np.random.randint(1, 10, 30)
-        values2 = np.random.randint(1, 10, 30)
-        values3 = np.random.randint(1, 10, 30)
-
-        bin_edges = [start_date + i * time_delta for i in range(31)]
-
-        fig, (ax1, ax2, ax3) = plt.subplots(3, 1, constrained_layout=True)
-
-        axes = [ax1, ax2, ax3]
-        values_list = [values1, values2, values3]
-
-        for ax, values in zip(axes, values_list):
-            ax.hist(
-                [start_date + i * time_delta for i in range(30)],
-                bins=bin_edges,
-                weights=values
-            )
-            for i in range(np.random.randint(1, 5)):
-                xmin = start_date + np.random.randint(0, 30) * time_delta
-                xmax = xmin + np.random.randint(1, 3) * time_delta
-                ax.axvspan(xmin=xmin, xmax=xmax, facecolor='green', alpha=0.5)
+        dates = [start_date + datetime.timedelta(days=i) for i in range(31)]
+        numbers = list(range(1, 32))
+
+        fig, (ax1, ax2, ax3) = plt.subplots(3, 1,
+                                            constrained_layout=True,
+                                            figsize=(10, 12))
+
+        ax1.plot(dates, numbers, marker='o', color='blue')
+        for i in range(0, 31, 2):
+            xmin = start_date + datetime.timedelta(days=i)
+            xmax = xmin + datetime.timedelta(days=1)
+            ax1.axvspan(xmin=xmin, xmax=xmax, facecolor='red', alpha=0.5)
+        ax1.set_title('Datetime vs. Number')
+        ax1.set_xlabel('Date')
+        ax1.set_ylabel('Number')
+
+        ax2.plot(numbers, dates, marker='o', color='blue')
+        for i in range(0, 31, 2):
+            ax2.axvspan(xmin=i+1, xmax=i+2, facecolor='red', alpha=0.5)
+        ax2.set_title('Number vs. Datetime')
+        ax2.set_xlabel('Number')
+        ax2.set_ylabel('Date')
+
+        ax3.plot(dates, dates, marker='o', color='blue')
+        for i in range(0, 31, 2):
+            xmin = start_date + datetime.timedelta(days=i)
+            xmax = xmin + datetime.timedelta(days=1)
+            ax3.axvspan(xmin=xmin, xmax=xmax, facecolor='red', alpha=0.5)
+        ax3.set_title('Datetime vs. Datetime')
+        ax3.set_xlabel('Date')
+        ax3.set_ylabel('Date')
 
     @pytest.mark.xfail(reason="Test for bar not written yet")
     @mpl.style.context("default")

From 8c55381236ca74e67874ed31fe7ae93dd63da047 Mon Sep 17 00:00:00 2001
From: CozyFrog <garrett.sward@uconn.edu>
Date: Mon, 23 Oct 2023 12:08:20 -0400
Subject: [PATCH 0326/1120] Add test_axhline in test_datetime.py

---
 lib/matplotlib/tests/test_datetime.py | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index c9455d450b70..7c188420d91f 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -29,8 +29,20 @@ def test_arrow(self):
     @pytest.mark.xfail(reason="Test for axhline not written yet")
     @mpl.style.context("default")
     def test_axhline(self):
-        fig, ax = plt.subplots()
-        ax.axhline(...)
+        mpl.rcParams["date.converter"] = 'concise'
+        fig, ax = plt.subplots(layout='constrained')
+        birth_date = np.array([datetime.datetime(2020, 4, 10),
+                               datetime.datetime(2020, 5, 30),
+                               datetime.datetime(2020, 10, 12),
+                               datetime.datetime(2020, 11, 15)])
+        year_start = datetime.datetime(2020, 1, 1)
+        year_end = datetime.datetime(2020, 12, 31)
+        age = [21, 53, 20, 24]
+        ax.set_xlabel('Birth Date')
+        ax.set_ylabel('Age')
+        ax.set_ylim(bottom=year_start, top=year_end)
+        ax.bar(x=age, height=birth_date)
+        ax.axhline(y=datetime.datetime(2020, 6, 1))
 
     @pytest.mark.xfail(reason="Test for axhspan not written yet")
     @mpl.style.context("default")

From 90dfb0b5d557977e9cf65e960bccd975a0376f8a Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Mon, 23 Oct 2023 15:06:58 -0500
Subject: [PATCH 0327/1120] Try/except import of Axes3D

On some installs, the `mpl_toolkits` namespace package gets an old
version which uses deprecated (And removed) code from the main library.

On such the import of Axes3D will error with an `ImportError`.
This prevents users from using any of `matplotlib`, since it is imported
unconditionally by default.

This just try/excepts the imports (and adjusts the registration code
accordingly) to allow users to continue using matplotlib (though not 3D
and possibly not other mpl_toolkits) even with older installs occluding
the mpl_toolkits.
---
 lib/matplotlib/projections/__init__.py | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/projections/__init__.py b/lib/matplotlib/projections/__init__.py
index 16a5651da1d1..17a5fadd2691 100644
--- a/lib/matplotlib/projections/__init__.py
+++ b/lib/matplotlib/projections/__init__.py
@@ -55,7 +55,11 @@
 from .. import axes, _docstring
 from .geo import AitoffAxes, HammerAxes, LambertAxes, MollweideAxes
 from .polar import PolarAxes
-from mpl_toolkits.mplot3d import Axes3D
+
+try:
+    from mpl_toolkits.mplot3d import Axes3D
+except ImportError:
+    Axes3D = None
 
 
 class ProjectionRegistry:
@@ -87,8 +91,12 @@ def get_projection_names(self):
     HammerAxes,
     LambertAxes,
     MollweideAxes,
-    Axes3D,
 )
+if Axes3D is not None:
+    projection_registry.register(Axes3D)
+else:
+    # remove from namespace if not importable
+    del Axes3D
 
 
 def register_projection(cls):

From 1344a9018f243281d09c29fdb788c9a966dc4714 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Mon, 23 Oct 2023 17:49:16 -0500
Subject: [PATCH 0328/1120] Restore default behavior of hexbin mincnt with C
 provided

---
 doc/api/next_api_changes/behavior/27179-KS.rst        |  7 +++++++
 .../prev_api_changes/api_changes_3.8.0/behaviour.rst  |  6 ++++++
 lib/matplotlib/axes/_axes.py                          | 11 ++++++++---
 lib/matplotlib/tests/test_axes.py                     |  2 ++
 4 files changed, 23 insertions(+), 3 deletions(-)
 create mode 100644 doc/api/next_api_changes/behavior/27179-KS.rst

diff --git a/doc/api/next_api_changes/behavior/27179-KS.rst b/doc/api/next_api_changes/behavior/27179-KS.rst
new file mode 100644
index 000000000000..fed4675a5f38
--- /dev/null
+++ b/doc/api/next_api_changes/behavior/27179-KS.rst
@@ -0,0 +1,7 @@
+Default behavior of ``hexbin`` with *C* provided requires at least 1 point
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The behavior changed in 3.8.0 to be inclusive of *mincnt*, however that resulted in
+errors or warnings with some reduction functions, so now the default is to require at
+least 1 point to call the reduction function. This effectively restores the default
+behavior to match that of Matplotlib 3.7 and before.
diff --git a/doc/api/prev_api_changes/api_changes_3.8.0/behaviour.rst b/doc/api/prev_api_changes/api_changes_3.8.0/behaviour.rst
index 9a528bdbc251..3476a05394df 100644
--- a/doc/api/prev_api_changes/api_changes_3.8.0/behaviour.rst
+++ b/doc/api/prev_api_changes/api_changes_3.8.0/behaviour.rst
@@ -165,3 +165,9 @@ PostScript paper type adds option to use figure size
 The :rc:`ps.papertype` rcParam can now be set to ``'figure'``, which will use
 a paper size that corresponds exactly with the size of the figure that is being
 saved.
+
+``hexbin`` *mincnt* parameter made consistently inclusive
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Previously, *mincnt* was inclusive with no *C* provided but exclusive when *C* is provided.
+It is now inclusive of *mincnt* in both cases.
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 0fcabac8c7c0..9199f1cafae3 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -4873,8 +4873,8 @@ def hexbin(self, x, y, C=None, gridsize=100, bins=None,
         yscale : {'linear', 'log'}, default: 'linear'
             Use a linear or log10 scale on the vertical axis.
 
-        mincnt : int > 0, default: *None*
-            If not *None*, only display cells with more than *mincnt*
+        mincnt : int >= 0, default: *None*
+            If not *None*, only display cells with at least *mincnt*
             number of points in the cell.
 
         marginals : bool, default: *False*
@@ -4941,6 +4941,11 @@ def reduce_C_function(C: array) -> float
             - `numpy.sum`: integral of the point values
             - `numpy.amax`: value taken from the largest point
 
+            By default will only reduce cells with at least 1 point because some
+            reduction functions (such as `numpy.amax`) will error/warn with empty
+            input. Changing *mincnt* will adjust the cutoff, and if set to 0 will
+            pass empty input to the reduction function.
+
         data : indexable object, optional
             DATA_PARAMETER_PLACEHOLDER
 
@@ -5038,7 +5043,7 @@ def reduce_C_function(C: array) -> float
                 else:
                     Cs_at_i2[i2[i]].append(C[i])
             if mincnt is None:
-                mincnt = 0
+                mincnt = 1
             accum = np.array(
                 [reduce_C_function(acc) if len(acc) >= mincnt else np.nan
                  for Cs_at_i in [Cs_at_i1, Cs_at_i2]
diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index 564bf6a86b52..c82c79272d87 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -971,6 +971,8 @@ def test_hexbin_empty():
     # From #23922: creating hexbin with log scaling from empty
     # dataset raises ValueError
     ax.hexbin([], [], bins='log')
+    # From #27103: np.max errors when handed empty data
+    ax.hexbin([], [], C=[], reduce_C_function=np.max)
 
 
 def test_hexbin_pickable():

From 865e87c82144b11ce43d06912be196b70b7c6730 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Tue, 24 Oct 2023 00:52:05 -0500
Subject: [PATCH 0329/1120] Add a warning

---
 lib/matplotlib/projections/__init__.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/lib/matplotlib/projections/__init__.py b/lib/matplotlib/projections/__init__.py
index 17a5fadd2691..7941cf7e8e5d 100644
--- a/lib/matplotlib/projections/__init__.py
+++ b/lib/matplotlib/projections/__init__.py
@@ -59,6 +59,10 @@
 try:
     from mpl_toolkits.mplot3d import Axes3D
 except ImportError:
+    import warnings
+    warnings.warn("Unable to import Axes3D. This may be due to multiple versions of"
+                  "Matplotlib being installed (e.g. as a system package and as a pip"
+                  "package). As a result, the 3D projection is not available.")
     Axes3D = None
 
 

From 92a8f88c2d2a6aaf317923e13008d738e319de29 Mon Sep 17 00:00:00 2001
From: i-jey <ilakkiyan.jeyakumar@gmail.com>
Date: Tue, 24 Oct 2023 10:10:47 -0700
Subject: [PATCH 0330/1120] Example for plotting a bihistogram

---
 .../statistics/histogram_bihistogram.py       | 40 +++++++++++++++++++
 1 file changed, 40 insertions(+)
 create mode 100644 galleries/examples/statistics/histogram_bihistogram.py

diff --git a/galleries/examples/statistics/histogram_bihistogram.py b/galleries/examples/statistics/histogram_bihistogram.py
new file mode 100644
index 000000000000..de574176cee0
--- /dev/null
+++ b/galleries/examples/statistics/histogram_bihistogram.py
@@ -0,0 +1,40 @@
+"""
+==========
+Bihistogram
+==========
+
+How to plot a bihistogram with Matplotlib.
+"""
+
+import matplotlib.pyplot as plt
+import numpy as np
+
+# Create a random number generator with a fixed seed for reproducibility
+rng = np.random.default_rng(19680801)
+
+# %%
+# Generate data and plot a bihistogram
+# -----------------------------------------
+#
+# To generate a bihistogram we need two datasets (each being a vector of numbers).
+# We will plot both histograms using plt.hist() and set the weights of the second one to be negative.
+# We'll generate data below and plot the bihistogram.
+
+N_points = 10_000
+n_bins = 30
+
+# Generate two normal distributions
+dataset1 = np.random.normal(0, 1, size=N_points)
+dataset2 = np.random.normal(1, 2, size=N_points)
+
+fig, ax = plt.subplots()
+
+# Plot the first histogram
+ax.hist(dataset1, bins=n_bins, label="Dataset 1")
+
+# Plot the second histogram (notice the negative weights, which flip the histogram upside down)
+ax.hist(dataset2, weights=-np.ones_like(dataset2), bins=n_bins, label="Dataset 2")
+ax.axhline(0, color="k")
+ax.legend()
+
+plt.show()

From 0ca30c29580a9d4175fbdb0f5f605558e792ef98 Mon Sep 17 00:00:00 2001
From: i-jey <ilakkiyan.jeyakumar@gmail.com>
Date: Tue, 24 Oct 2023 10:17:09 -0700
Subject: [PATCH 0331/1120] linting, line length

---
 galleries/examples/statistics/histogram_bihistogram.py | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/galleries/examples/statistics/histogram_bihistogram.py b/galleries/examples/statistics/histogram_bihistogram.py
index de574176cee0..9d0e6589c681 100644
--- a/galleries/examples/statistics/histogram_bihistogram.py
+++ b/galleries/examples/statistics/histogram_bihistogram.py
@@ -17,8 +17,8 @@
 # -----------------------------------------
 #
 # To generate a bihistogram we need two datasets (each being a vector of numbers).
-# We will plot both histograms using plt.hist() and set the weights of the second one to be negative.
-# We'll generate data below and plot the bihistogram.
+# We will plot both histograms using plt.hist() and set the weights of the second
+# one to be negative. We'll generate data below and plot the bihistogram.
 
 N_points = 10_000
 n_bins = 30
@@ -32,7 +32,8 @@
 # Plot the first histogram
 ax.hist(dataset1, bins=n_bins, label="Dataset 1")
 
-# Plot the second histogram (notice the negative weights, which flip the histogram upside down)
+# Plot the second histogram 
+# (notice the negative weights, which flip the histogram upside down)
 ax.hist(dataset2, weights=-np.ones_like(dataset2), bins=n_bins, label="Dataset 2")
 ax.axhline(0, color="k")
 ax.legend()

From 6ac62c8a054b3a45ec7fbbde267864521a198cd2 Mon Sep 17 00:00:00 2001
From: i-jey <ilakkiyan.jeyakumar@gmail.com>
Date: Tue, 24 Oct 2023 10:19:24 -0700
Subject: [PATCH 0332/1120] remove trailing whitespace

---
 galleries/examples/statistics/histogram_bihistogram.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/galleries/examples/statistics/histogram_bihistogram.py b/galleries/examples/statistics/histogram_bihistogram.py
index 9d0e6589c681..d311660123b9 100644
--- a/galleries/examples/statistics/histogram_bihistogram.py
+++ b/galleries/examples/statistics/histogram_bihistogram.py
@@ -32,7 +32,7 @@
 # Plot the first histogram
 ax.hist(dataset1, bins=n_bins, label="Dataset 1")
 
-# Plot the second histogram 
+# Plot the second histogram
 # (notice the negative weights, which flip the histogram upside down)
 ax.hist(dataset2, weights=-np.ones_like(dataset2), bins=n_bins, label="Dataset 2")
 ax.axhline(0, color="k")

From f767a760610d77d79cc7517199fa23390614139b Mon Sep 17 00:00:00 2001
From: i-jey <ilakkiyan.jeyakumar@gmail.com>
Date: Tue, 24 Oct 2023 10:49:33 -0700
Subject: [PATCH 0333/1120] Use constant bin widths to make histograms easier
 to compare visually

---
 galleries/examples/statistics/histogram_bihistogram.py | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/galleries/examples/statistics/histogram_bihistogram.py b/galleries/examples/statistics/histogram_bihistogram.py
index d311660123b9..46d3bbab1f75 100644
--- a/galleries/examples/statistics/histogram_bihistogram.py
+++ b/galleries/examples/statistics/histogram_bihistogram.py
@@ -21,20 +21,23 @@
 # one to be negative. We'll generate data below and plot the bihistogram.
 
 N_points = 10_000
-n_bins = 30
 
 # Generate two normal distributions
 dataset1 = np.random.normal(0, 1, size=N_points)
 dataset2 = np.random.normal(1, 2, size=N_points)
 
+# Use a constant bin width to make the two histograms easier to compare visually
+bin_width = 0.25
+bins=np.arange(np.min([dataset1, dataset2]), np.max([dataset1, dataset2]) + bin_width, bin_width)
+
 fig, ax = plt.subplots()
 
 # Plot the first histogram
-ax.hist(dataset1, bins=n_bins, label="Dataset 1")
+ax.hist(dataset1, bins=bins, label="Dataset 1")
 
 # Plot the second histogram
 # (notice the negative weights, which flip the histogram upside down)
-ax.hist(dataset2, weights=-np.ones_like(dataset2), bins=n_bins, label="Dataset 2")
+ax.hist(dataset2, weights=-np.ones_like(dataset2), bins=bins, label="Dataset 2")
 ax.axhline(0, color="k")
 ax.legend()
 

From 760812a61f28e0018a0355f62a771fac47c26536 Mon Sep 17 00:00:00 2001
From: i-jey <ilakkiyan.jeyakumar@gmail.com>
Date: Tue, 24 Oct 2023 10:57:30 -0700
Subject: [PATCH 0334/1120] satiate flake8

---
 galleries/examples/statistics/histogram_bihistogram.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/galleries/examples/statistics/histogram_bihistogram.py b/galleries/examples/statistics/histogram_bihistogram.py
index 46d3bbab1f75..83247542b7f1 100644
--- a/galleries/examples/statistics/histogram_bihistogram.py
+++ b/galleries/examples/statistics/histogram_bihistogram.py
@@ -28,7 +28,8 @@
 
 # Use a constant bin width to make the two histograms easier to compare visually
 bin_width = 0.25
-bins=np.arange(np.min([dataset1, dataset2]), np.max([dataset1, dataset2]) + bin_width, bin_width)
+bins = np.arange(np.min([dataset1, dataset2]),
+                    np.max([dataset1, dataset2]) + bin_width, bin_width)
 
 fig, ax = plt.subplots()
 

From 0c2f104457fd10c0dc69bc760bba654c257d4e16 Mon Sep 17 00:00:00 2001
From: CozyFrog <garrett.sward@uconn.edu>
Date: Tue, 24 Oct 2023 14:15:26 -0400
Subject: [PATCH 0335/1120] Simplified example code and added arguments for
 xmin and xmax

---
 lib/matplotlib/tests/test_datetime.py | 13 +------------
 1 file changed, 1 insertion(+), 12 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 7c188420d91f..1aafa437e98e 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -31,18 +31,7 @@ def test_arrow(self):
     def test_axhline(self):
         mpl.rcParams["date.converter"] = 'concise'
         fig, ax = plt.subplots(layout='constrained')
-        birth_date = np.array([datetime.datetime(2020, 4, 10),
-                               datetime.datetime(2020, 5, 30),
-                               datetime.datetime(2020, 10, 12),
-                               datetime.datetime(2020, 11, 15)])
-        year_start = datetime.datetime(2020, 1, 1)
-        year_end = datetime.datetime(2020, 12, 31)
-        age = [21, 53, 20, 24]
-        ax.set_xlabel('Birth Date')
-        ax.set_ylabel('Age')
-        ax.set_ylim(bottom=year_start, top=year_end)
-        ax.bar(x=age, height=birth_date)
-        ax.axhline(y=datetime.datetime(2020, 6, 1))
+        ax.axhline(y=datetime.datetime(2020, 6, 1), xmin=0.2, xmax=0.8)
 
     @pytest.mark.xfail(reason="Test for axhspan not written yet")
     @mpl.style.context("default")

From 72d604261ad49141dfedda203090d89f0aeb6beb Mon Sep 17 00:00:00 2001
From: i-jey <ilakkiyan.jeyakumar@gmail.com>
Date: Tue, 24 Oct 2023 11:28:56 -0700
Subject: [PATCH 0336/1120] fix delimiters

---
 galleries/examples/statistics/histogram_bihistogram.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/galleries/examples/statistics/histogram_bihistogram.py b/galleries/examples/statistics/histogram_bihistogram.py
index 83247542b7f1..7bfae14e9285 100644
--- a/galleries/examples/statistics/histogram_bihistogram.py
+++ b/galleries/examples/statistics/histogram_bihistogram.py
@@ -1,7 +1,7 @@
 """
-==========
+===========
 Bihistogram
-==========
+===========
 
 How to plot a bihistogram with Matplotlib.
 """
@@ -14,7 +14,7 @@
 
 # %%
 # Generate data and plot a bihistogram
-# -----------------------------------------
+# ------------------------------------
 #
 # To generate a bihistogram we need two datasets (each being a vector of numbers).
 # We will plot both histograms using plt.hist() and set the weights of the second

From e27da804a4779752f2aee9d3e9b8ff4f1519420f Mon Sep 17 00:00:00 2001
From: Koustav Ghosh <ghosh.hardkots.koustav1@gmail.com>
Date: Wed, 25 Oct 2023 00:09:29 +0530
Subject: [PATCH 0337/1120] Revising test_bar in test_datetime.py

---
 lib/matplotlib/tests/test_datetime.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 30645f7ec1aa..6aca1bc6eb4c 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -106,7 +106,7 @@ def test_bar(self):
 
         x = np.datetime64(datetime.datetime(2020, 6, 1))
         ax1.bar(x_dates, x_ranges, width=np.timedelta64(4, "D"))
-        ax2.bar(np.arange(4), x_dates, bottom=x)
+        ax2.bar(np.arange(4), x_dates - x, bottom=x)
 
     @pytest.mark.xfail(reason="Test for bar_label not written yet")
     @mpl.style.context("default")

From 875b441f54efe1b773acfd319fdbeec0ee771ecf Mon Sep 17 00:00:00 2001
From: CozyFrog <garrett.sward@uconn.edu>
Date: Tue, 24 Oct 2023 16:58:56 -0400
Subject: [PATCH 0338/1120] Add test_axhline in test_datetime.py

---
 lib/matplotlib/tests/test_datetime.py | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 1aafa437e98e..79389e818e71 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -26,12 +26,18 @@ def test_arrow(self):
         fig, ax = plt.subplots()
         ax.arrow(...)
 
-    @pytest.mark.xfail(reason="Test for axhline not written yet")
     @mpl.style.context("default")
     def test_axhline(self):
         mpl.rcParams["date.converter"] = 'concise'
-        fig, ax = plt.subplots(layout='constrained')
-        ax.axhline(y=datetime.datetime(2020, 6, 1), xmin=0.2, xmax=0.8)
+        fig, (ax1, ax2, ax3) = plt.subplots(3, 1, layout='constrained')
+        ax1.set_ylim(bottom=datetime.datetime(2020, 4, 1),
+                     top=datetime.datetime(2020, 8, 1))
+        ax2.set_ylim(bottom=np.datetime64('2005-01-01'),
+                     top=np.datetime64('2005-04-01'))
+        ax3.set_ylim(bottom=datetime.datetime(2023, 9, 1),
+                     top=datetime.datetime(2023, 11, 1))
+        ax1.axhline(y=datetime.datetime(2020, 6, 3), xmin=0.5, xmax=0.7)
+        ax2.axhline(np.datetime64('2005-02-25T03:30'), xmin=0.1, xmax=0.9)
 
     @pytest.mark.xfail(reason="Test for axhspan not written yet")
     @mpl.style.context("default")

From f8000bc3aa5493c36e0041721dd0e9e6b12ffa59 Mon Sep 17 00:00:00 2001
From: Ian Thomas <ianthomas23@gmail.com>
Date: Sun, 28 Aug 2022 21:06:07 +0100
Subject: [PATCH 0339/1120] Use pybind11 for qhull wrapper

---
 src/_qhull_wrapper.cpp | 172 ++++++++++++++++-------------------------
 src/meson.build        |   2 +-
 2 files changed, 68 insertions(+), 106 deletions(-)

diff --git a/src/_qhull_wrapper.cpp b/src/_qhull_wrapper.cpp
index 3abce833fe6f..9784a1698ba1 100644
--- a/src/_qhull_wrapper.cpp
+++ b/src/_qhull_wrapper.cpp
@@ -5,9 +5,9 @@
  * triangulation, construct an instance of the matplotlib.tri.Triangulation
  * class without specifying a triangles array.
  */
-#define PY_SSIZE_T_CLEAN
-#include "Python.h"
-#include "numpy_cpp.h"
+#include <pybind11/pybind11.h>
+#include <pybind11/numpy.h>
+
 #ifdef _MSC_VER
 /* The Qhull header does not declare this as extern "C", but only MSVC seems to
  * do name mangling on global variables. We thus need to declare this before
@@ -16,11 +16,11 @@ extern "C" {
 extern const char qh_version[];
 }
 #endif
+
 #include "libqhull_r/qhull_ra.h"
 #include <cstdio>
 #include <vector>
 
-
 #ifndef MPL_DEVNULL
 #error "MPL_DEVNULL must be defined as the OS-equivalent of /dev/null"
 #endif
@@ -28,6 +28,16 @@ extern const char qh_version[];
 #define STRINGIFY(x) STR(x)
 #define STR(x) #x
 
+namespace py = pybind11;
+using namespace pybind11::literals;
+
+// Input numpy array class.
+typedef py::array_t<double, py::array::c_style | py::array::forcecast> CoordArray;
+
+// Output numpy array class.
+typedef py::array_t<int> IndexArray;
+
+
 
 static const char* qhull_error_msg[6] = {
     "",                     /* 0 = qh_ERRnone */
@@ -64,17 +74,16 @@ get_facet_neighbours(const facetT* facet, std::vector<int>& tri_indices,
 /* Return true if the specified points arrays contain at least 3 unique points,
  * or false otherwise. */
 static bool
-at_least_3_unique_points(npy_intp npoints, const double* x, const double* y)
+at_least_3_unique_points(py::ssize_t npoints, const double* x, const double* y)
 {
-    int i;
-    const int unique1 = 0;  /* First unique point has index 0. */
-    int unique2 = 0;        /* Second unique point index is 0 until set. */
+    const py::ssize_t unique1 = 0;  /* First unique point has index 0. */
+    py::ssize_t unique2 = 0;        /* Second unique point index is 0 until set. */
 
     if (npoints < 3) {
         return false;
     }
 
-    for (i = 1; i < npoints; ++i) {
+    for (py::ssize_t i = 1; i < npoints; ++i) {
         if (unique2 == 0) {
             /* Looking for second unique point. */
             if (x[i] != x[unique1] || y[i] != y[unique1]) {
@@ -125,8 +134,8 @@ class QhullInfo {
 /* Delaunay implementation method.
  * If hide_qhull_errors is true then qhull error messages are discarded;
  * if it is false then they are written to stderr. */
-static PyObject*
-delaunay_impl(npy_intp npoints, const double* x, const double* y,
+static py::tuple
+delaunay_impl(py::ssize_t npoints, const double* x, const double* y,
               bool hide_qhull_errors)
 {
     qhT qh_qh;                  /* qh variable type and name must be like */
@@ -179,11 +188,13 @@ delaunay_impl(npy_intp npoints, const double* x, const double* y,
     exitcode = qh_new_qhull(qh, ndim, (int)npoints, points.data(), False,
                             (char*)"qhull d Qt Qbb Qc Qz", NULL, error_file);
     if (exitcode != qh_ERRnone) {
-        PyErr_Format(PyExc_RuntimeError,
-                     "Error in qhull Delaunay triangulation calculation: %s (exitcode=%d)%s",
-                     qhull_error_msg[exitcode], exitcode,
-                     hide_qhull_errors ? "; use python verbose option (-v) to see original qhull error." : "");
-        return NULL;
+        std::string msg =
+            py::str("Error in qhull Delaunay triangulation calculation: {} (exitcode={})")
+            .format(qhull_error_msg[exitcode], exitcode).cast<std::string>();
+        if (hide_qhull_errors) {
+            msg += "; use python verbose option (-v) to see original qhull error.";
+        }
+        throw std::runtime_error(msg);
     }
 
     /* Split facets so that they only have 3 points each. */
@@ -204,12 +215,12 @@ delaunay_impl(npy_intp npoints, const double* x, const double* y,
     std::vector<int> tri_indices(max_facet_id+1);
 
     /* Allocate Python arrays to return. */
-    npy_intp dims[2] = {ntri, 3};
-    numpy::array_view<int, ndim> triangles(dims);
-    int* triangles_ptr = triangles.data();
+    int dims[2] = {ntri, 3};
+    IndexArray triangles(dims);
+    int* triangles_ptr = triangles.mutable_data();
 
-    numpy::array_view<int, ndim> neighbors(dims);
-    int* neighbors_ptr = neighbors.data();
+    IndexArray neighbors(dims);
+    int* neighbors_ptr = neighbors.mutable_data();
 
     /* Determine triangles array and set tri_indices array. */
     i = 0;
@@ -238,103 +249,54 @@ delaunay_impl(npy_intp npoints, const double* x, const double* y,
         }
     }
 
-    PyObject* tuple = PyTuple_New(2);
-    if (tuple == 0) {
-        throw std::runtime_error("Failed to create Python tuple");
-    }
-
-    PyTuple_SET_ITEM(tuple, 0, triangles.pyobj());
-    PyTuple_SET_ITEM(tuple, 1, neighbors.pyobj());
-    return tuple;
+    return py::make_tuple(triangles, neighbors);
 }
 
 /* Process Python arguments and call Delaunay implementation method. */
-static PyObject*
-delaunay(PyObject *self, PyObject *args)
+static py::tuple
+delaunay(const CoordArray& x, const CoordArray& y, int verbose)
 {
-    numpy::array_view<double, 1> xarray;
-    numpy::array_view<double, 1> yarray;
-    PyObject* ret;
-    npy_intp npoints;
-    const double* x;
-    const double* y;
-    int verbose = 0;
-
-    if (!PyArg_ParseTuple(args, "O&O&i:delaunay",
-                          &xarray.converter_contiguous, &xarray,
-                          &yarray.converter_contiguous, &yarray,
-                          &verbose)) {
-        return NULL;
+    if (x.ndim() != 1 || y.ndim() != 1) {
+        throw std::invalid_argument("x and y must be 1D arrays");
     }
 
-    npoints = xarray.shape(0);
-    if (npoints != yarray.shape(0)) {
-        PyErr_SetString(PyExc_ValueError,
-                        "x and y must be 1D arrays of the same length");
-        return NULL;
+    auto npoints = x.shape(0);
+    if (npoints != y.shape(0)) {
+        throw std::invalid_argument("x and y must be 1D arrays of the same length");
     }
 
     if (npoints < 3) {
-        PyErr_SetString(PyExc_ValueError,
-                        "x and y arrays must have a length of at least 3");
-        return NULL;
+        throw std::invalid_argument("x and y arrays must have a length of at least 3");
     }
 
-    x = xarray.data();
-    y = yarray.data();
-
-    if (!at_least_3_unique_points(npoints, x, y)) {
-        PyErr_SetString(PyExc_ValueError,
-                        "x and y arrays must consist of at least 3 unique points");
-        return NULL;
+    if (!at_least_3_unique_points(npoints, x.data(), y.data())) {
+        throw std::invalid_argument("x and y arrays must consist of at least 3 unique points");
     }
 
-    CALL_CPP("qhull.delaunay",
-             (ret = delaunay_impl(npoints, x, y, verbose == 0)));
-
-    return ret;
-}
-
-/* Return qhull version string for assistance in debugging. */
-static PyObject*
-version(PyObject *self, PyObject *arg)
-{
-    return PyBytes_FromString(qh_version);
+    return delaunay_impl(npoints, x.data(), y.data(), verbose == 0);
 }
 
-static PyMethodDef qhull_methods[] = {
-    {"delaunay", delaunay, METH_VARARGS,
-     "delaunay(x, y, verbose, /)\n"
-     "--\n\n"
-     "Compute a Delaunay triangulation.\n"
-     "\n"
-     "Parameters\n"
-     "----------\n"
-     "x, y : 1d arrays\n"
-     "    The coordinates of the point set, which must consist of at least\n"
-     "    three unique points.\n"
-     "verbose : int\n"
-     "    Python's verbosity level.\n"
-     "\n"
-     "Returns\n"
-     "-------\n"
-     "triangles, neighbors : int arrays, shape (ntri, 3)\n"
-     "    Indices of triangle vertices and indices of triangle neighbors.\n"
-    },
-    {"version", version, METH_NOARGS,
-     "version()\n--\n\n"
-     "Return the qhull version string."},
-    {NULL, NULL, 0, NULL}
-};
-
-static struct PyModuleDef qhull_module = {
-    PyModuleDef_HEAD_INIT,
-    "qhull", "Computing Delaunay triangulations.\n", -1, qhull_methods
-};
-
-PyMODINIT_FUNC
-PyInit__qhull(void)
-{
-    import_array();
-    return PyModule_Create(&qhull_module);
+PYBIND11_MODULE(_qhull, m) {
+    m.doc() = "Computing Delaunay triangulations.\n";
+
+    m.def("delaunay", &delaunay, "x"_a, "y"_a, "verbose"_a,
+        "--\n\n"
+        "Compute a Delaunay triangulation.\n"
+        "\n"
+        "Parameters\n"
+        "----------\n"
+        "x, y : 1d arrays\n"
+        "    The coordinates of the point set, which must consist of at least\n"
+        "    three unique points.\n"
+        "verbose : int\n"
+        "    Python's verbosity level.\n"
+        "\n"
+        "Returns\n"
+        "-------\n"
+        "triangles, neighbors : int arrays, shape (ntri, 3)\n"
+        "    Indices of triangle vertices and indices of triangle neighbors.\n");
+
+    m.def("version", []() { return qh_version; },
+        "version()\n--\n\n"
+        "Return the qhull version string.");
 }
diff --git a/src/meson.build b/src/meson.build
index 9cee34bfce8b..7836f276f4bc 100644
--- a/src/meson.build
+++ b/src/meson.build
@@ -127,7 +127,7 @@ extension_data = {
     'sources': files(
       '_qhull_wrapper.cpp',
     ),
-    'dependencies': [numpy_dep, qhull_dep],
+    'dependencies': [pybind11_dep, qhull_dep],
     'c_args': [f'-DMPL_DEVNULL=@devnull@'],
     'cpp_args': [f'-DMPL_DEVNULL=@devnull@'],
   },

From 0d0f3c233d4f95ade5dd4e9d25f169c9f14f157f Mon Sep 17 00:00:00 2001
From: Junpei Ota <otaj@purdue.edu>
Date: Tue, 24 Oct 2023 22:09:44 -0400
Subject: [PATCH 0340/1120] Added smoke tests for errorbar

---
 lib/matplotlib/tests/test_datetime.py | 38 ++++++++++++++++++++++++---
 1 file changed, 35 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index f42e0a0d04d8..0116ba42524b 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -129,11 +129,43 @@ def test_contourf(self):
         fig, ax = plt.subplots()
         ax.contourf(...)
 
-    @pytest.mark.xfail(reason="Test for errorbar not written yet")
     @mpl.style.context("default")
     def test_errorbar(self):
-        fig, ax = plt.subplots()
-        ax.errorbar(...)
+        mpl.rcParams["date.converter"] = "concise" 
+        fig, (ax1, ax2, ax3, ax4) = plt.subplots(4, 1, layout="constrained")
+        limit = 7
+        start_date = datetime.datetime(2023, 1, 1)
+
+        x_dates = np.array([datetime.datetime(2023, 10, delta) for delta in range(1, limit)])
+        y_dates = np.array([datetime.datetime(2023, 10, delta) for delta in range(1, limit)])
+        x_date_error = datetime.timedelta(days=1)
+        y_date_error = datetime.timedelta(days=1)
+
+        x_values = list(range(1, limit))
+        y_values = list(range(1, limit))
+        x_value_error = 0.5
+        y_value_error = 0.5
+
+        ax1.errorbar(x_dates, y_values, 
+                    yerr=y_value_error,
+                    capsize=10,
+                    barsabove=True, 
+                    label='Data')
+        
+        ax2.errorbar(x_values, y_dates, 
+                    xerr=x_value_error, yerr=y_date_error,
+                    errorevery=(1, 2),
+                    fmt='-o', label='Data')
+        
+        ax3.errorbar(x_dates, y_dates, 
+                    xerr=x_date_error, yerr=y_date_error,
+                    lolims=True, xlolims=True,
+                    label='Data')
+        
+        ax4.errorbar(x_dates, y_values, 
+                    xerr=x_date_error, yerr=y_value_error,
+                    uplims=True, xuplims=True,
+                    label='Data')
 
     @pytest.mark.xfail(reason="Test for eventplot not written yet")
     @mpl.style.context("default")

From 1727e8d6c5581a5d2373a1e8768c6d21554f1e49 Mon Sep 17 00:00:00 2001
From: Junpei Ota <otaj@purdue.edu>
Date: Tue, 24 Oct 2023 22:29:05 -0400
Subject: [PATCH 0341/1120] Fixed code formatting

---
 lib/matplotlib/tests/test_datetime.py | 33 ++++++++++++---------------
 1 file changed, 15 insertions(+), 18 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index b544ae49e047..1dfb1131364f 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -216,8 +216,8 @@ def test_errorbar(self):
         limit = 7
         start_date = datetime.datetime(2023, 1, 1)
 
-        x_dates = np.array([datetime.datetime(2023, 10, delta) for delta in range(1, limit)])
-        y_dates = np.array([datetime.datetime(2023, 10, delta) for delta in range(1, limit)])
+        x_dates = np.array([datetime.datetime(2023, 10, d) for d in range(1, limit)])
+        y_dates = np.array([datetime.datetime(2023, 10, d) for d in range(1, limit)])
         x_date_error = datetime.timedelta(days=1)
         y_date_error = datetime.timedelta(days=1)
 
@@ -227,25 +227,22 @@ def test_errorbar(self):
         y_value_error = 0.5
 
         ax1.errorbar(x_dates, y_values, 
-                    yerr=y_value_error,
-                    capsize=10,
-                    barsabove=True, 
-                    label='Data')
-        
+                     yerr=y_value_error,
+                     capsize=10,
+                     barsabove=True, 
+                     label='Data')
         ax2.errorbar(x_values, y_dates, 
-                    xerr=x_value_error, yerr=y_date_error,
-                    errorevery=(1, 2),
-                    fmt='-o', label='Data')
-        
+                     xerr=x_value_error, yerr=y_date_error,
+                     errorevery=(1, 2),
+                     fmt='-o', label='Data')
         ax3.errorbar(x_dates, y_dates, 
-                    xerr=x_date_error, yerr=y_date_error,
-                    lolims=True, xlolims=True,
-                    label='Data')
-        
+                     xerr=x_date_error, yerr=y_date_error,
+                     lolims=True, xlolims=True,
+                     label='Data')
         ax4.errorbar(x_dates, y_values, 
-                    xerr=x_date_error, yerr=y_value_error,
-                    uplims=True, xuplims=True,
-                    label='Data')
+                     xerr=x_date_error, yerr=y_value_error,
+                     uplims=True, xuplims=True,
+                     label='Data')
 
     @pytest.mark.xfail(reason="Test for eventplot not written yet")
     @mpl.style.context("default")

From 931bf748c26d3c9ad205c4affc2785631c656fd1 Mon Sep 17 00:00:00 2001
From: Junpei Ota <otaj@purdue.edu>
Date: Tue, 24 Oct 2023 22:31:14 -0400
Subject: [PATCH 0342/1120] Removed Trailing Whitespace

---
 lib/matplotlib/tests/test_datetime.py | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 1dfb1131364f..47c54c1389be 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -211,7 +211,7 @@ def test_contourf(self):
 
     @mpl.style.context("default")
     def test_errorbar(self):
-        mpl.rcParams["date.converter"] = "concise" 
+        mpl.rcParams["date.converter"] = "concise"
         fig, (ax1, ax2, ax3, ax4) = plt.subplots(4, 1, layout="constrained")
         limit = 7
         start_date = datetime.datetime(2023, 1, 1)
@@ -226,20 +226,20 @@ def test_errorbar(self):
         x_value_error = 0.5
         y_value_error = 0.5
 
-        ax1.errorbar(x_dates, y_values, 
+        ax1.errorbar(x_dates, y_values,
                      yerr=y_value_error,
                      capsize=10,
-                     barsabove=True, 
+                     barsabove=True,
                      label='Data')
-        ax2.errorbar(x_values, y_dates, 
+        ax2.errorbar(x_values, y_dates,
                      xerr=x_value_error, yerr=y_date_error,
                      errorevery=(1, 2),
                      fmt='-o', label='Data')
-        ax3.errorbar(x_dates, y_dates, 
+        ax3.errorbar(x_dates, y_dates,
                      xerr=x_date_error, yerr=y_date_error,
                      lolims=True, xlolims=True,
                      label='Data')
-        ax4.errorbar(x_dates, y_values, 
+        ax4.errorbar(x_dates, y_values,
                      xerr=x_date_error, yerr=y_value_error,
                      uplims=True, xuplims=True,
                      label='Data')

From 3bd567202c82038a5d8e5f424ac6ae5b3a5437f7 Mon Sep 17 00:00:00 2001
From: Jirka <jirka.borovec@seznam.cz>
Date: Wed, 25 Oct 2023 08:17:56 +0200
Subject: [PATCH 0343/1120] suggestion

---
 lib/matplotlib/axes/_base.py           | 2 +-
 lib/matplotlib/axes/_secondary_axes.py | 2 +-
 lib/matplotlib/figure.py               | 4 ++--
 lib/matplotlib/lines.py                | 2 +-
 lib/matplotlib/patches.py              | 4 ++--
 lib/matplotlib/text.py                 | 4 ++--
 6 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index ee74ab188d98..b113b0f21156 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -1499,7 +1499,7 @@ def set_facecolor(self, color):
 
         Parameters
         ----------
-        color : color defined by string name, char abbreviation or hex, see :doc:`gallery/color/named_colors`
+        color : color; see :ref:`colors_def`
         """
         self._facecolor = color
         self.stale = True
diff --git a/lib/matplotlib/axes/_secondary_axes.py b/lib/matplotlib/axes/_secondary_axes.py
index f0ab4f3e3be8..4c757f61c7b6 100644
--- a/lib/matplotlib/axes/_secondary_axes.py
+++ b/lib/matplotlib/axes/_secondary_axes.py
@@ -233,7 +233,7 @@ def set_color(self, color):
 
         Parameters
         ----------
-        color : color
+        color : color; see :ref:`colors_def`
         """
         axis = self._axis_map[self._orientation]
         axis.set_tick_params(colors=color)
diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
index 2b83a7ae4a73..baea9232800f 100644
--- a/lib/matplotlib/figure.py
+++ b/lib/matplotlib/figure.py
@@ -410,7 +410,7 @@ def set_edgecolor(self, color):
 
         Parameters
         ----------
-        color : color
+        color : color; see :ref:`colors_def`
         """
         self.patch.set_edgecolor(color)
 
@@ -420,7 +420,7 @@ def set_facecolor(self, color):
 
         Parameters
         ----------
-        color : color
+        color : color; see :ref:`colors_def`
         """
         self.patch.set_facecolor(color)
 
diff --git a/lib/matplotlib/lines.py b/lib/matplotlib/lines.py
index 31b931a52c82..0b4b8d48adc2 100644
--- a/lib/matplotlib/lines.py
+++ b/lib/matplotlib/lines.py
@@ -1056,7 +1056,7 @@ def set_color(self, color):
 
         Parameters
         ----------
-        color : color
+        color : color; see :ref:`colors_def`
         """
         mcolors._check_color_like(color=color)
         self._color = color
diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
index 7b9e6e7aa060..d1537322ab76 100644
--- a/lib/matplotlib/patches.py
+++ b/lib/matplotlib/patches.py
@@ -332,7 +332,7 @@ def set_edgecolor(self, color):
 
         Parameters
         ----------
-        color : color or None
+        color : color or None; see :ref:`colors_def`
         """
         self._original_edgecolor = color
         self._set_edgecolor(color)
@@ -350,7 +350,7 @@ def set_facecolor(self, color):
 
         Parameters
         ----------
-        color : color or None
+        color : color or None; see :ref:`colors_def`
         """
         self._original_facecolor = color
         self._set_facecolor(color)
diff --git a/lib/matplotlib/text.py b/lib/matplotlib/text.py
index 7a58ce717200..6371e03603d6 100644
--- a/lib/matplotlib/text.py
+++ b/lib/matplotlib/text.py
@@ -965,7 +965,7 @@ def set_backgroundcolor(self, color):
 
         Parameters
         ----------
-        color : color
+        color : color; see :ref:`colors_def`
 
         See Also
         --------
@@ -985,7 +985,7 @@ def set_color(self, color):
 
         Parameters
         ----------
-        color : color
+        color : color; see :ref:`colors_def`
         """
         # "auto" is only supported by axisartist, but we can just let it error
         # out at draw time for simplicity.

From e4dcb7f4291b1ac58e830203975ac14498f62dac Mon Sep 17 00:00:00 2001
From: Artyom Romanov <artem.romanov.03@bk.ru>
Date: Wed, 25 Oct 2023 21:11:31 +0500
Subject: [PATCH 0344/1120] Fix typo in docstring of
 `matplotlib.colors.from_levels_and_colors`

---
 lib/matplotlib/colors.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/colors.py b/lib/matplotlib/colors.py
index b9866974d8a3..d81f761faa78 100644
--- a/lib/matplotlib/colors.py
+++ b/lib/matplotlib/colors.py
@@ -2757,8 +2757,8 @@ def from_levels_and_colors(levels, colors, extend='neither'):
 
     Returns
     -------
-    cmap : `~matplotlib.colors.Normalize`
-    norm : `~matplotlib.colors.Colormap`
+    cmap : `~matplotlib.colors.Colormap`
+    norm : `~matplotlib.colors.Normalize`
     """
     slice_map = {
         'both': slice(1, -1),

From d2b2a069066eb6fe137685c33ba4139100e45e94 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Wed, 25 Oct 2023 15:08:11 -0500
Subject: [PATCH 0345/1120] Grammar in release note for hexbin mincnt

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>
---
 doc/api/next_api_changes/behavior/27179-KS.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/api/next_api_changes/behavior/27179-KS.rst b/doc/api/next_api_changes/behavior/27179-KS.rst
index fed4675a5f38..873cd622bbd4 100644
--- a/doc/api/next_api_changes/behavior/27179-KS.rst
+++ b/doc/api/next_api_changes/behavior/27179-KS.rst
@@ -1,7 +1,7 @@
 Default behavior of ``hexbin`` with *C* provided requires at least 1 point
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The behavior changed in 3.8.0 to be inclusive of *mincnt*, however that resulted in
+The behavior changed in 3.8.0 to be inclusive of *mincnt*. However that resulted in
 errors or warnings with some reduction functions, so now the default is to require at
 least 1 point to call the reduction function. This effectively restores the default
 behavior to match that of Matplotlib 3.7 and before.

From 0b8b37e7deab69923fc85338e3da114b19f28ce3 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Wed, 25 Oct 2023 15:21:51 -0500
Subject: [PATCH 0346/1120] Fix spacing on line breaks

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>
---
 lib/matplotlib/projections/__init__.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/projections/__init__.py b/lib/matplotlib/projections/__init__.py
index 7941cf7e8e5d..8ce118986065 100644
--- a/lib/matplotlib/projections/__init__.py
+++ b/lib/matplotlib/projections/__init__.py
@@ -60,8 +60,8 @@
     from mpl_toolkits.mplot3d import Axes3D
 except ImportError:
     import warnings
-    warnings.warn("Unable to import Axes3D. This may be due to multiple versions of"
-                  "Matplotlib being installed (e.g. as a system package and as a pip"
+    warnings.warn("Unable to import Axes3D. This may be due to multiple versions of "
+                  "Matplotlib being installed (e.g. as a system package and as a pip "
                   "package). As a result, the 3D projection is not available.")
     Axes3D = None
 

From b9010535ce4f4158d7f22b43a4215f72768fff00 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Wed, 25 Oct 2023 17:37:52 -0400
Subject: [PATCH 0347/1120] DOC: clean up links under table formatting docs

I guess I forgot a space and nobody checked the final build - currently all the urls in the table are batched underneath and they should be hidden
---
 doc/devel/document.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/doc/devel/document.rst b/doc/devel/document.rst
index 095b42d689ce..261929d0298d 100644
--- a/doc/devel/document.rst
+++ b/doc/devel/document.rst
@@ -176,6 +176,7 @@ Given the size of the table and length of each entry, use:
 +-------------+-------------------------------+--------------------+
 
 For more information, see `rst tables <https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#tables>`_.
+
 .. _sg: https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#tables
 .. _lt: https://docutils.sourceforge.io/docs/ref/rst/directives.html#list-table
 .. _csv: https://docutils.sourceforge.io/docs/ref/rst/directives.html#toc-entry-22

From 689ab844d300e5209d38778dac748b9337919112 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Wed, 25 Oct 2023 23:58:01 +0200
Subject: [PATCH 0348/1120] DOC: Add role for custom informal types like color

The role is intended to be used for type references in
docstrings like
```
Parameters
----------
    color : :mpltype:`color`
```

It is easily extendable to other types.

The naming `mpltype` was a quick choice. I'm open to better names.

This PR contains one example usage in `widgets.Button` so that one can
see the effect in the built docs. Systematic application
throughout the codebase should be deferred to a separate PR.

Closes #24859.
Formalizes #27164.
---
 doc/sphinxext/custom_roles.py | 15 +++++++++++++++
 lib/matplotlib/widgets.py     |  2 +-
 2 files changed, 16 insertions(+), 1 deletion(-)

diff --git a/doc/sphinxext/custom_roles.py b/doc/sphinxext/custom_roles.py
index 3dcecc3df733..8961037ed0f1 100644
--- a/doc/sphinxext/custom_roles.py
+++ b/doc/sphinxext/custom_roles.py
@@ -64,8 +64,23 @@ def rcparam_role(name, rawtext, text, lineno, inliner, options={}, content=[]):
     return node_list, messages
 
 
+def mpltype_role(name, rawtext, text, lineno, inliner, options={}, content=[]):
+    mpltype = text
+    type_to_link_target = {
+        'color': 'colors_def',
+    }
+    if mpltype not in type_to_link_target:
+        raise ValueError(f"Unknown mpltype: {mpltype!r}")
+
+    ref_nodes, messages = inliner.interpreted(
+        mpltype, f'{mpltype} <{type_to_link_target[mpltype]}>', 'ref', lineno)
+    node_list = [ref_nodes]
+    return node_list, messages
+
+
 def setup(app):
     app.add_role("rc", rcparam_role)
+    app.add_role("mpltype", mpltype_role)
     app.add_node(
         QueryReference,
         html=(visit_query_reference_node, depart_query_reference_node),
diff --git a/lib/matplotlib/widgets.py b/lib/matplotlib/widgets.py
index cd9716408303..74cac5eec5a1 100644
--- a/lib/matplotlib/widgets.py
+++ b/lib/matplotlib/widgets.py
@@ -191,7 +191,7 @@ def __init__(self, ax, label, image=None,
         image : array-like or PIL Image
             The image to place in the button, if not *None*.  The parameter is
             directly forwarded to `~.axes.Axes.imshow`.
-        color : color
+        color : :mpltype:`color`
             The color of the button when not activated.
         hovercolor : color
             The color of the button when the mouse is over it.

From 3987f401b9f1f060110b0fa23417c1f2aa595d07 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Wed, 25 Oct 2023 18:32:43 -0400
Subject: [PATCH 0349/1120] fixed links to table docs

---
 doc/devel/document.rst | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/doc/devel/document.rst b/doc/devel/document.rst
index 261929d0298d..476a40c320b8 100644
--- a/doc/devel/document.rst
+++ b/doc/devel/document.rst
@@ -170,16 +170,17 @@ Given the size of the table and length of each entry, use:
 +-------------+-------------------------------+--------------------+
 |             | small table                   | large table        |
 +-------------+-------------------------------+--------------------+
-| short entry | `simple or grid table <sg>`_  | `grid table <sg>`_ |
+| short entry | `simple or grid table`_       | `grid table`_      |
 +-------------+-------------------------------+--------------------+
-| long entry  | `list table <lt>`_            | `csv table <csv>`_ |
+| long entry  | `list table`_                 | `csv table`_       |
 +-------------+-------------------------------+--------------------+
 
 For more information, see `rst tables <https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#tables>`_.
 
-.. _sg: https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#tables
-.. _lt: https://docutils.sourceforge.io/docs/ref/rst/directives.html#list-table
-.. _csv: https://docutils.sourceforge.io/docs/ref/rst/directives.html#toc-entry-22
+.. _`simple or grid table`: https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#tables
+.. _`grid table`: https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#grid-tables
+.. _`list table`: https://docutils.sourceforge.io/docs/ref/rst/directives.html#list-table
+.. _`csv table`: https://docutils.sourceforge.io/docs/ref/rst/directives.html#csv-table-1
 
 Function arguments
 ^^^^^^^^^^^^^^^^^^

From d8e2c5f6f629dfc77b7a59307a55938bcf52d780 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Mon, 23 Oct 2023 17:50:07 +0200
Subject: [PATCH 0350/1120] Deprecate mixing positional and keyword args for
 legend(handles, labels)

This was previously already a warning and also broken.
---
 doc/api/next_api_changes/deprecations/27175-AL.rst | 5 +++++
 lib/matplotlib/legend.py                           | 8 +++++---
 lib/matplotlib/tests/test_legend.py                | 8 ++++----
 3 files changed, 14 insertions(+), 7 deletions(-)
 create mode 100644 doc/api/next_api_changes/deprecations/27175-AL.rst

diff --git a/doc/api/next_api_changes/deprecations/27175-AL.rst b/doc/api/next_api_changes/deprecations/27175-AL.rst
new file mode 100644
index 000000000000..3fce05765a59
--- /dev/null
+++ b/doc/api/next_api_changes/deprecations/27175-AL.rst
@@ -0,0 +1,5 @@
+Mixing positional and keyword arguments for ``legend`` handles and labels
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+This previously only raised a warning, but is now formally deprecated.  If
+passing *handles* and *labels*, they must be passed either both positionally or
+both as keyword.
diff --git a/lib/matplotlib/legend.py b/lib/matplotlib/legend.py
index 58e5dfcfe3b8..c46770974567 100644
--- a/lib/matplotlib/legend.py
+++ b/lib/matplotlib/legend.py
@@ -1301,7 +1301,7 @@ def _parse_legend_args(axs, *args, handles=None, labels=None, **kwargs):
         legend(handles=handles, labels=labels)
 
     The behavior for a mixture of positional and keyword handles and labels
-    is undefined and issues a warning.
+    is undefined and issues a warning; it will be an error in the future.
 
     Parameters
     ----------
@@ -1334,8 +1334,10 @@ def _parse_legend_args(axs, *args, handles=None, labels=None, **kwargs):
     handlers = kwargs.get('handler_map')
 
     if (handles is not None or labels is not None) and args:
-        _api.warn_external("You have mixed positional and keyword arguments, "
-                           "some input may be discarded.")
+        _api.warn_deprecated("3.9", message=(
+            "You have mixed positional and keyword arguments, some input may "
+            "be discarded.  This is deprecated since %(since)s and will "
+            "become an error %(removal)s."))
 
     if (hasattr(handles, "__len__") and
             hasattr(labels, "__len__") and
diff --git a/lib/matplotlib/tests/test_legend.py b/lib/matplotlib/tests/test_legend.py
index 3a35b4051c71..90b0a3f38999 100644
--- a/lib/matplotlib/tests/test_legend.py
+++ b/lib/matplotlib/tests/test_legend.py
@@ -405,10 +405,10 @@ def test_warn_mixed_args_and_kwargs(self):
         th = np.linspace(0, 2*np.pi, 1024)
         lns, = ax.plot(th, np.sin(th), label='sin')
         lnc, = ax.plot(th, np.cos(th), label='cos')
-        with pytest.warns(UserWarning) as record:
+        with pytest.warns(DeprecationWarning) as record:
             ax.legend((lnc, lns), labels=('a', 'b'))
         assert len(record) == 1
-        assert str(record[0].message) == (
+        assert str(record[0].message).startswith(
             "You have mixed positional and keyword arguments, some input may "
             "be discarded.")
 
@@ -474,10 +474,10 @@ def test_warn_args_kwargs(self):
         fig, axs = plt.subplots(1, 2)
         lines = axs[0].plot(range(10))
         lines2 = axs[1].plot(np.arange(10) * 2.)
-        with pytest.warns(UserWarning) as record:
+        with pytest.warns(DeprecationWarning) as record:
             fig.legend((lines, lines2), labels=('a', 'b'))
         assert len(record) == 1
-        assert str(record[0].message) == (
+        assert str(record[0].message).startswith(
             "You have mixed positional and keyword arguments, some input may "
             "be discarded.")
 

From 89979cb5262b5891ab77dd39aef0f5eead3be21e Mon Sep 17 00:00:00 2001
From: Sebastian Berg <sebastianb@nvidia.com>
Date: Thu, 26 Oct 2023 13:13:03 +0200
Subject: [PATCH 0351/1120] BLD: Use NumPy nightly wheels for non-release
 builds

This uses the NumPy nightlies for non-release builds to ensure the
matplotlib nightlies uploaded are build against the new NumPy version.

These nightlies are not tested, but if they were they should actually
still be tested against the release NumPy.  This is necessary to allow
NumPy to enforce API changes, it does mean that potential C-API breaks
in NumPy need quicker follow-up unfortunately (either in NumPy or in
matplotlib).
---
 .github/workflows/cibuildwheel.yml | 35 +++++++++++++++++++++++++-----
 1 file changed, 29 insertions(+), 6 deletions(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index cdb62658e6c9..9b311cc5c863 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -90,12 +90,35 @@ jobs:
     name: Build wheels on ${{ matrix.os }} for ${{ matrix.cibw_archs }}
     runs-on: ${{ matrix.os }}
     env:
-      CIBW_BEFORE_BUILD: >-
-        pip install numpy>=1.25 &&
-        rm -rf {package}/build
-      CIBW_BEFORE_BUILD_WINDOWS: >-
-        pip install delvewheel numpy>=1.25 &&
-        rm -rf {package}/build
+      # The following commands branch based on whether we are on the main
+      # branch or have a PR into main.  For these, we use the NumPy 2.0
+      # nightlies to ensure future C-API/ABI compatibility.
+      # This branching becomes unnecessary when NumPy 2.0 is released.
+      # When using no-build-isolation we need to install all requirements.
+      CIBW_BEFORE_BUILD:
+        ${{ (((github.event_name == 'push' && github.ref == 'refs/heads/main') ||
+              (github.event_name == 'pull_request' && github.base_ref == 'refs/heads/main')) &&
+            'pip install meson-python pybind11 setuptools_scm "setuptools>=64" ninja &&
+             pip install "numpy>=2.0.0.dev0" --extra-index-url "https://pypi.anaconda.org/scientific-python-nightly-wheels/simple" &&
+             rm -rf {package}/build'
+          ) ||
+            'pip install "numpy>=1.25" &&
+             rm -rf {package}/build'
+        }}
+      CIBW_BEFORE_BUILD_WINDOWS:
+        ${{ (((github.event_name == 'push' && github.ref == 'refs/heads/main') ||
+              (github.event_name == 'pull_request' && github.base_ref == 'refs/heads/main')) &&
+            'pip install delvewheel meson-python pybind11 setuptools_scm "setuptools>=64" ninja &&
+             pip install "numpy>=2.0.0.dev0" --extra-index-url "https://pypi.anaconda.org/scientific-python-nightly-wheels/simple" &&
+             rm -rf {package}/build'
+          ) ||
+            'pip install delvewheel "numpy>=1.25" &&
+             rm -rf {package}/build'
+        }}
+      CIBW_BUILD_FRONTEND: >-
+        ${{ (((github.event_name == '' && github.ref == 'refs/heads/main') ||
+              (github.event_name == 'pull_request' && github.base_ref == 'refs/heads/main')) &&
+            'pip; args: --no-build-isolation') || 'build' }}
       CIBW_REPAIR_WHEEL_COMMAND_WINDOWS: >-
         delvewheel repair -w {dest_dir} {wheel}
       CIBW_AFTER_BUILD: >-

From 641a5b699812e1781435f05651a0fc5ee88a9e5b Mon Sep 17 00:00:00 2001
From: Joshua Stevenson <joshua.stevenson@udri.udayton.edu>
Date: Thu, 26 Oct 2023 09:43:46 -0400
Subject: [PATCH 0352/1120] Improve legend picking example

* Pass an actual pickradius instead of `True`. `True` (`1`) is a bad
user experience.
* Fix `on_pick` to work when the legend is draggable. (Early exit)
* For good measure, show that it works with draggable legends.
* Use higher visability syntax for single element destrturing for higher
readability.
* Refactor varible names. (`lined` -> `map_legend_to_ax`)
---
 .../examples/event_handling/legend_picking.py | 39 ++++++++++++-------
 1 file changed, 26 insertions(+), 13 deletions(-)

diff --git a/galleries/examples/event_handling/legend_picking.py b/galleries/examples/event_handling/legend_picking.py
index 79c27358a8ff..2fed3c9c1649 100644
--- a/galleries/examples/event_handling/legend_picking.py
+++ b/galleries/examples/event_handling/legend_picking.py
@@ -18,33 +18,46 @@
 import numpy as np
 
 t = np.linspace(0, 1)
-y1 = 2 * np.sin(2*np.pi*t)
-y2 = 4 * np.sin(2*np.pi*2*t)
+y1 = 2 * np.sin(2 * np.pi * t)
+y2 = 4 * np.sin(2 * np.pi * 2 * t)
 
 fig, ax = plt.subplots()
 ax.set_title('Click on legend line to toggle line on/off')
-line1, = ax.plot(t, y1, lw=2, label='1 Hz')
-line2, = ax.plot(t, y2, lw=2, label='2 Hz')
+(line1, ) = ax.plot(t, y1, lw=2, label='1 Hz')
+(line2, ) = ax.plot(t, y2, lw=2, label='2 Hz')
 leg = ax.legend(fancybox=True, shadow=True)
 
 lines = [line1, line2]
-lined = {}  # Will map legend lines to original lines.
-for legline, origline in zip(leg.get_lines(), lines):
-    legline.set_picker(True)  # Enable picking on the legend line.
-    lined[legline] = origline
+map_legend_to_ax = {}  # Will map legend lines to original lines.
+
+pickradius = 5  # Points (Pt). How close the click needs to be to trigger an event.
+
+for legend_line, ax_line in zip(leg.get_lines(), lines):
+    legend_line.set_picker(pickradius)  # Enable picking on the legend line.
+    map_legend_to_ax[legend_line] = ax_line
 
 
 def on_pick(event):
     # On the pick event, find the original line corresponding to the legend
     # proxy line, and toggle its visibility.
-    legline = event.artist
-    origline = lined[legline]
-    visible = not origline.get_visible()
-    origline.set_visible(visible)
+    legend_line = event.artist
+
+    # Do nothing if the source of the event is not a legend line.
+    if legend_line not in map_legend_to_ax:
+        return
+
+    ax_line = map_legend_to_ax[legend_line]
+    visible = not ax_line.get_visible()
+    ax_line.set_visible(visible)
     # Change the alpha on the line in the legend, so we can see what lines
     # have been toggled.
-    legline.set_alpha(1.0 if visible else 0.2)
+    legend_line.set_alpha(1.0 if visible else 0.2)
     fig.canvas.draw()
 
+
 fig.canvas.mpl_connect('pick_event', on_pick)
+
+# Works even if the legend is draggable. This is independent from picking legend lines.
+leg.set_draggable(True)
+
 plt.show()

From b2f32ac429fa9c66574565c65f2d42e4418cf34c Mon Sep 17 00:00:00 2001
From: Sebastian Berg <sebastian@sipsolutions.net>
Date: Thu, 26 Oct 2023 18:18:27 +0200
Subject: [PATCH 0353/1120] Update .github/workflows/cibuildwheel.yml

Co-authored-by: Thomas A Caswell <tcaswell@gmail.com>
---
 .github/workflows/cibuildwheel.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 9b311cc5c863..0ea480fc9a06 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -116,7 +116,7 @@ jobs:
              rm -rf {package}/build'
         }}
       CIBW_BUILD_FRONTEND: >-
-        ${{ (((github.event_name == '' && github.ref == 'refs/heads/main') ||
+        ${{ (((github.event_name == 'push' && github.ref == 'refs/heads/main') ||
               (github.event_name == 'pull_request' && github.base_ref == 'refs/heads/main')) &&
             'pip; args: --no-build-isolation') || 'build' }}
       CIBW_REPAIR_WHEEL_COMMAND_WINDOWS: >-

From f319e356af49381b29b7c7da63f1ddd5ce717398 Mon Sep 17 00:00:00 2001
From: CozyFrog <garrett.sward@uconn.edu>
Date: Thu, 26 Oct 2023 13:20:55 -0400
Subject: [PATCH 0354/1120] Add axhline to ax3

---
 lib/matplotlib/tests/test_datetime.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 79389e818e71..a8b6bcee3bd4 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -38,6 +38,7 @@ def test_axhline(self):
                      top=datetime.datetime(2023, 11, 1))
         ax1.axhline(y=datetime.datetime(2020, 6, 3), xmin=0.5, xmax=0.7)
         ax2.axhline(np.datetime64('2005-02-25T03:30'), xmin=0.1, xmax=0.9)
+        ax3.axhline(y=datetime.datetime(2023, 10, 24), xmin=0.4, xmax=0.7)
 
     @pytest.mark.xfail(reason="Test for axhspan not written yet")
     @mpl.style.context("default")

From d97c8a90e0aa848ea32a0c4f4b1dfe5bcec4d775 Mon Sep 17 00:00:00 2001
From: CozyFrog <garrett.sward@uconn.edu>
Date: Thu, 26 Oct 2023 13:24:58 -0400
Subject: [PATCH 0355/1120] Add test_axvline to test_datetime.py

---
 lib/matplotlib/tests/test_datetime.py | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index c9455d450b70..954151c18edb 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -44,11 +44,19 @@ def test_axline(self):
         fig, ax = plt.subplots()
         ax.axline(...)
 
-    @pytest.mark.xfail(reason="Test for axvline not written yet")
     @mpl.style.context("default")
     def test_axvline(self):
-        fig, ax = plt.subplots()
-        ax.axvline(...)
+        mpl.rcParams["date.converter"] = 'concise'
+        fig, (ax1, ax2, ax3) = plt.subplots(3, 1, layout='constrained')
+        ax1.set_xlim(left=datetime.datetime(2020, 4, 1),
+                     right=datetime.datetime(2020, 8, 1))
+        ax2.set_xlim(left=np.datetime64('2005-01-01'),
+                     right=np.datetime64('2005-04-01'))
+        ax3.set_xlim(left=datetime.datetime(2023, 9, 1),
+                     right=datetime.datetime(2023, 11, 1))
+        ax1.axvline(x=datetime.datetime(2020, 6, 3), ymin=0.5, ymax=0.7)
+        ax2.axvline(np.datetime64('2005-02-25T03:30'), ymin=0.1, ymax=0.9)
+        ax3.axvline(x=datetime.datetime(2023, 10, 24), ymin=0.4, ymax=0.7)
 
     @pytest.mark.xfail(reason="Test for axvspan not written yet")
     @mpl.style.context("default")

From 8081658910f69709ec93d01058b526937b1a592c Mon Sep 17 00:00:00 2001
From: Sebastian Berg <sebastianb@nvidia.com>
Date: Thu, 26 Oct 2023 19:36:16 +0200
Subject: [PATCH 0356/1120] Simplify everything and just use --pre, also remove
 pre install of NumPy?

---
 .github/workflows/cibuildwheel.yml | 40 ++++++++++--------------------
 1 file changed, 13 insertions(+), 27 deletions(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 0ea480fc9a06..16a5c4fdde8f 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -90,35 +90,21 @@ jobs:
     name: Build wheels on ${{ matrix.os }} for ${{ matrix.cibw_archs }}
     runs-on: ${{ matrix.os }}
     env:
-      # The following commands branch based on whether we are on the main
-      # branch or have a PR into main.  For these, we use the NumPy 2.0
-      # nightlies to ensure future C-API/ABI compatibility.
-      # This branching becomes unnecessary when NumPy 2.0 is released.
-      # When using no-build-isolation we need to install all requirements.
-      CIBW_BEFORE_BUILD:
-        ${{ (((github.event_name == 'push' && github.ref == 'refs/heads/main') ||
-              (github.event_name == 'pull_request' && github.base_ref == 'refs/heads/main')) &&
-            'pip install meson-python pybind11 setuptools_scm "setuptools>=64" ninja &&
-             pip install "numpy>=2.0.0.dev0" --extra-index-url "https://pypi.anaconda.org/scientific-python-nightly-wheels/simple" &&
-             rm -rf {package}/build'
-          ) ||
-            'pip install "numpy>=1.25" &&
-             rm -rf {package}/build'
-        }}
-      CIBW_BEFORE_BUILD_WINDOWS:
-        ${{ (((github.event_name == 'push' && github.ref == 'refs/heads/main') ||
-              (github.event_name == 'pull_request' && github.base_ref == 'refs/heads/main')) &&
-            'pip install delvewheel meson-python pybind11 setuptools_scm "setuptools>=64" ninja &&
-             pip install "numpy>=2.0.0.dev0" --extra-index-url "https://pypi.anaconda.org/scientific-python-nightly-wheels/simple" &&
-             rm -rf {package}/build'
-          ) ||
-            'pip install delvewheel "numpy>=1.25" &&
-             rm -rf {package}/build'
-        }}
+      CIBW_BEFORE_BUILD: >-
+        rm -rf {package}/build
+      CIBW_BEFORE_BUILD_WINDOWS: >-
+        pip install delvewheel &&
+        rm -rf {package}/build
+      # Live on the edge when building on main or a PR against main since
+      # these wheels are also used for nightlies and NumPy 2.0 transition
+      # requires using the NumPy 2.0 nightlies for compatibility.
+      # If using all `--pre` releases creates issues, the NumPy wheel can be
+      # istalled more targeted.
       CIBW_BUILD_FRONTEND: >-
-        ${{ (((github.event_name == 'push' && github.ref == 'refs/heads/main') ||
+        ${{ (((github.event_name == 'main' && github.ref == 'refs/heads/main') ||
               (github.event_name == 'pull_request' && github.base_ref == 'refs/heads/main')) &&
-            'pip; args: --no-build-isolation') || 'build' }}
+            'pip; args: --pre --extra-index-url "https://pypi.anaconda.org/scientific-python-nightly-wheels/simple"') ||
+            'build' }}
       CIBW_REPAIR_WHEEL_COMMAND_WINDOWS: >-
         delvewheel repair -w {dest_dir} {wheel}
       CIBW_AFTER_BUILD: >-

From 490f82804fe927eac4fbf3bbe127dda10595e823 Mon Sep 17 00:00:00 2001
From: Sebastian Berg <sebastian@sipsolutions.net>
Date: Thu, 26 Oct 2023 19:51:56 +0200
Subject: [PATCH 0357/1120] Update .github/workflows/cibuildwheel.yml

Co-authored-by: Thomas A Caswell <tcaswell@gmail.com>
---
 .github/workflows/cibuildwheel.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 16a5c4fdde8f..981411671436 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -101,7 +101,7 @@ jobs:
       # If using all `--pre` releases creates issues, the NumPy wheel can be
       # istalled more targeted.
       CIBW_BUILD_FRONTEND: >-
-        ${{ (((github.event_name == 'main' && github.ref == 'refs/heads/main') ||
+        ${{ (((github.event_name == 'push' && github.ref == 'refs/heads/main') ||
               (github.event_name == 'pull_request' && github.base_ref == 'refs/heads/main')) &&
             'pip; args: --pre --extra-index-url "https://pypi.anaconda.org/scientific-python-nightly-wheels/simple"') ||
             'build' }}

From 25ec2c0e43066c1bad3b0ca6111644cb8383181d Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Sat, 14 Oct 2023 11:57:55 +0100
Subject: [PATCH 0358/1120] Update find_nearest_contour to not use collections
 attribute

Co-authored-by: Antony Lee <anntzer.lee@gmail.com>
---
 lib/matplotlib/contour.py            | 70 +++++++++-------------------
 lib/matplotlib/contour.pyi           |  2 +-
 lib/matplotlib/tests/test_contour.py |  6 +--
 3 files changed, 27 insertions(+), 51 deletions(-)

diff --git a/lib/matplotlib/contour.py b/lib/matplotlib/contour.py
index dc5ed5d626bc..f65538f865a3 100644
--- a/lib/matplotlib/contour.py
+++ b/lib/matplotlib/contour.py
@@ -2,6 +2,7 @@
 Classes to support contour plotting and labelling for the Axes class.
 """
 
+from contextlib import ExitStack
 import functools
 import math
 from numbers import Integral
@@ -1409,64 +1410,39 @@ def find_nearest_contour(self, x, y, indices=None, pixel=True):
 
         Returns
         -------
-        contour : `.Collection`
-            The contour that is closest to ``(x, y)``.
-        segment : int
-            The index of the `.Path` in *contour* that is closest to
-            ``(x, y)``.
+        path : int
+            The index of the path that is closest to ``(x, y)``.  Each path corresponds
+            to one contour level.
+        subpath : int
+            The index within that closest path of the subpath that is closest to
+            ``(x, y)``.  Each subpath corresponds to one unbroken contour line.
         index : int
-            The index of the path segment in *segment* that is closest to
+            The index of the vertices within that subpath that are closest to
             ``(x, y)``.
         xmin, ymin : float
             The point in the contour plot that is closest to ``(x, y)``.
         d2 : float
             The squared distance from ``(xmin, ymin)`` to ``(x, y)``.
         """
+        segment = index = d2 = None
 
-        # This function uses a method that is probably quite
-        # inefficient based on converting each contour segment to
-        # pixel coordinates and then comparing the given point to
-        # those coordinates for each contour.  This will probably be
-        # quite slow for complex contours, but for normal use it works
-        # sufficiently well that the time is not noticeable.
-        # Nonetheless, improvements could probably be made.
+        with ExitStack() as stack:
+            if not pixel:
+                # _find_nearest_contour works in pixel space. We want axes space, so
+                # effectively disable the transformation here by setting to identity.
+                stack.enter_context(self._cm_set(
+                    transform=mtransforms.IdentityTransform()))
 
-        if self.filled:
-            raise ValueError("Method does not support filled contours.")
+            i_level, i_vtx, (xmin, ymin) = self._find_nearest_contour((x, y), indices)
 
-        if indices is None:
-            indices = range(len(self.collections))
+        if i_level is not None:
+            cc_cumlens = np.cumsum(
+                [*map(len, self._paths[i_level]._iter_connected_components())])
+            segment = cc_cumlens.searchsorted(i_vtx, "right")
+            index = i_vtx if segment == 0 else i_vtx - cc_cumlens[segment - 1]
+            d2 = (xmin-x)**2 + (ymin-y)**2
 
-        d2min = np.inf
-        conmin = None
-        segmin = None
-        imin = None
-        xmin = None
-        ymin = None
-
-        point = np.array([x, y])
-
-        for icon in indices:
-            con = self.collections[icon]
-            trans = con.get_transform()
-            paths = con.get_paths()
-
-            for segNum, linepath in enumerate(paths):
-                lc = linepath.vertices
-                # transfer all data points to screen coordinates if desired
-                if pixel:
-                    lc = trans.transform(lc)
-
-                d2, xc, leg = _find_closest_point_on_path(lc, point)
-                if d2 < d2min:
-                    d2min = d2
-                    conmin = icon
-                    segmin = segNum
-                    imin = leg[1]
-                    xmin = xc[0]
-                    ymin = xc[1]
-
-        return (conmin, segmin, imin, xmin, ymin, d2min)
+        return (i_level, segment, index, xmin, ymin, d2)
 
     def draw(self, renderer):
         paths = self._paths
diff --git a/lib/matplotlib/contour.pyi b/lib/matplotlib/contour.pyi
index 4a1e1e1d9d2e..8a987b762445 100644
--- a/lib/matplotlib/contour.pyi
+++ b/lib/matplotlib/contour.pyi
@@ -159,6 +159,6 @@ class ContourSet(ContourLabeler, Collection):
     ) -> tuple[list[Artist], list[str]]: ...
     def find_nearest_contour(
         self, x: float, y: float, indices: Iterable[int] | None = ..., pixel: bool = ...
-    ) -> tuple[Collection, int, int, float, float, float]: ...
+    ) -> tuple[int, int, int, float, float, float]: ...
 
 class QuadContourSet(ContourSet): ...
diff --git a/lib/matplotlib/tests/test_contour.py b/lib/matplotlib/tests/test_contour.py
index c911d499ea96..81328b0b3218 100644
--- a/lib/matplotlib/tests/test_contour.py
+++ b/lib/matplotlib/tests/test_contour.py
@@ -557,15 +557,15 @@ def test_find_nearest_contour_no_filled():
     cs = plt.contourf(img, 10)
 
     with pytest.warns(mpl._api.MatplotlibDeprecationWarning), \
-         pytest.raises(ValueError, match="Method does not support filled contours."):
+         pytest.raises(ValueError, match="Method does not support filled contours"):
         cs.find_nearest_contour(1, 1, pixel=False)
 
     with pytest.warns(mpl._api.MatplotlibDeprecationWarning), \
-         pytest.raises(ValueError, match="Method does not support filled contours."):
+         pytest.raises(ValueError, match="Method does not support filled contours"):
         cs.find_nearest_contour(1, 10, indices=(5, 7), pixel=False)
 
     with pytest.warns(mpl._api.MatplotlibDeprecationWarning), \
-         pytest.raises(ValueError, match="Method does not support filled contours."):
+         pytest.raises(ValueError, match="Method does not support filled contours"):
         cs.find_nearest_contour(2, 5, indices=(2, 7), pixel=True)
 
 

From e9a102f090d91dae6745b7f6313ecc6040def959 Mon Sep 17 00:00:00 2001
From: Jody Klymak <jklymak@gmail.com>
Date: Thu, 12 Oct 2023 15:05:15 -0700
Subject: [PATCH 0359/1120] MNT: revert contour deprecations

Co-authored-by: Ruth Comer <10599679+rcomer@users.noreply.github.com>
---
 .../deprecations/27088-JK.rst                 |  5 +++
 lib/matplotlib/contour.py                     |  9 +++---
 lib/matplotlib/tests/test_contour.py          | 32 +++++++------------
 3 files changed, 21 insertions(+), 25 deletions(-)
 create mode 100644 doc/api/next_api_changes/deprecations/27088-JK.rst

diff --git a/doc/api/next_api_changes/deprecations/27088-JK.rst b/doc/api/next_api_changes/deprecations/27088-JK.rst
new file mode 100644
index 000000000000..ea7fef5abf64
--- /dev/null
+++ b/doc/api/next_api_changes/deprecations/27088-JK.rst
@@ -0,0 +1,5 @@
+Deprecations removed in ``contour``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``contour.allsegs``, ``contour.allkinds``, and ``contour.find_nearest_contour`` are no
+longer marked for deprecation.
diff --git a/lib/matplotlib/contour.py b/lib/matplotlib/contour.py
index f65538f865a3..58a6d7937731 100644
--- a/lib/matplotlib/contour.py
+++ b/lib/matplotlib/contour.py
@@ -930,12 +930,12 @@ def __init__(self, ax, *args,
                 ", ".join(map(repr, kwargs))
             )
 
-    allsegs = _api.deprecated("3.8", pending=True)(property(lambda self: [
+    allsegs = property(lambda self: [
         [subp.vertices for subp in p._iter_connected_components()]
-        for p in self.get_paths()]))
-    allkinds = _api.deprecated("3.8", pending=True)(property(lambda self: [
+        for p in self.get_paths()])
+    allkinds = property(lambda self: [
         [subp.codes for subp in p._iter_connected_components()]
-        for p in self.get_paths()]))
+        for p in self.get_paths()])
     tcolors = _api.deprecated("3.8")(property(lambda self: [
         (tuple(rgba),) for rgba in self.to_rgba(self.cvalues, self.alpha)]))
     tlinewidths = _api.deprecated("3.8")(property(lambda self: [
@@ -1389,7 +1389,6 @@ def _find_nearest_contour(self, xy, indices=None):
 
         return idx_level_min, idx_vtx_min, proj_min
 
-    @_api.deprecated("3.8")
     def find_nearest_contour(self, x, y, indices=None, pixel=True):
         """
         Find the point in the contour plot that is closest to ``(x, y)``.
diff --git a/lib/matplotlib/tests/test_contour.py b/lib/matplotlib/tests/test_contour.py
index 81328b0b3218..b655649898bc 100644
--- a/lib/matplotlib/tests/test_contour.py
+++ b/lib/matplotlib/tests/test_contour.py
@@ -530,23 +530,19 @@ def test_find_nearest_contour():
     img = np.exp(-np.pi * (np.sum((xy - 5)**2, 0)/5.**2))
     cs = plt.contour(img, 10)
 
-    with pytest.warns(mpl._api.MatplotlibDeprecationWarning):
-        nearest_contour = cs.find_nearest_contour(1, 1, pixel=False)
+    nearest_contour = cs.find_nearest_contour(1, 1, pixel=False)
     expected_nearest = (1, 0, 33, 1.965966, 1.965966, 1.866183)
     assert_array_almost_equal(nearest_contour, expected_nearest)
 
-    with pytest.warns(mpl._api.MatplotlibDeprecationWarning):
-        nearest_contour = cs.find_nearest_contour(8, 1, pixel=False)
+    nearest_contour = cs.find_nearest_contour(8, 1, pixel=False)
     expected_nearest = (1, 0, 5, 7.550173, 1.587542, 0.547550)
     assert_array_almost_equal(nearest_contour, expected_nearest)
 
-    with pytest.warns(mpl._api.MatplotlibDeprecationWarning):
-        nearest_contour = cs.find_nearest_contour(2, 5, pixel=False)
+    nearest_contour = cs.find_nearest_contour(2, 5, pixel=False)
     expected_nearest = (3, 0, 21, 1.884384, 5.023335, 0.013911)
     assert_array_almost_equal(nearest_contour, expected_nearest)
 
-    with pytest.warns(mpl._api.MatplotlibDeprecationWarning):
-        nearest_contour = cs.find_nearest_contour(2, 5, indices=(5, 7), pixel=False)
+    nearest_contour = cs.find_nearest_contour(2, 5, indices=(5, 7), pixel=False)
     expected_nearest = (5, 0, 16, 2.628202, 5.0, 0.394638)
     assert_array_almost_equal(nearest_contour, expected_nearest)
 
@@ -556,16 +552,13 @@ def test_find_nearest_contour_no_filled():
     img = np.exp(-np.pi * (np.sum((xy - 5)**2, 0)/5.**2))
     cs = plt.contourf(img, 10)
 
-    with pytest.warns(mpl._api.MatplotlibDeprecationWarning), \
-         pytest.raises(ValueError, match="Method does not support filled contours"):
+    with pytest.raises(ValueError, match="Method does not support filled contours"):
         cs.find_nearest_contour(1, 1, pixel=False)
 
-    with pytest.warns(mpl._api.MatplotlibDeprecationWarning), \
-         pytest.raises(ValueError, match="Method does not support filled contours"):
+    with pytest.raises(ValueError, match="Method does not support filled contours"):
         cs.find_nearest_contour(1, 10, indices=(5, 7), pixel=False)
 
-    with pytest.warns(mpl._api.MatplotlibDeprecationWarning), \
-         pytest.raises(ValueError, match="Method does not support filled contours"):
+    with pytest.raises(ValueError, match="Method does not support filled contours"):
         cs.find_nearest_contour(2, 5, indices=(2, 7), pixel=True)
 
 
@@ -825,12 +818,11 @@ def test_allsegs_allkinds():
 
     cs = plt.contour(x, y, z, levels=[0, 0.5])
 
-    # Expect two levels, first with 5 segments and the second with 4.
-    with pytest.warns(PendingDeprecationWarning, match="all"):
-        for result in [cs.allsegs, cs.allkinds]:
-            assert len(result) == 2
-            assert len(result[0]) == 5
-            assert len(result[1]) == 4
+    # Expect two levels, the first with 5 segments and the second with 4.
+    for result in [cs.allsegs, cs.allkinds]:
+        assert len(result) == 2
+        assert len(result[0]) == 5
+        assert len(result[1]) == 4
 
 
 def test_deprecated_apis():

From 6b08ac2857aa07a5037dc915057fcc810ac4b7b3 Mon Sep 17 00:00:00 2001
From: Matthew Morrison <msm8275@rit.edu>
Date: Thu, 26 Oct 2023 15:58:20 -0400
Subject: [PATCH 0360/1120] Fixing sentence case for sections, adding info to
 empty note

---
 galleries/users_explain/figure/figure_intro.rst | 2 ++
 galleries/users_explain/figure/interactive.rst  | 6 +++---
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/galleries/users_explain/figure/figure_intro.rst b/galleries/users_explain/figure/figure_intro.rst
index c126b1bcf4c0..610885fc21f2 100644
--- a/galleries/users_explain/figure/figure_intro.rst
+++ b/galleries/users_explain/figure/figure_intro.rst
@@ -80,6 +80,8 @@ other than the default "inline" backend, you will likely need to use an ipython
 
    .. sourcecode:: ipython
 
+   %matplotlib notebook
+
 Standalone scripts and interactive use
 --------------------------------------
 
diff --git a/galleries/users_explain/figure/interactive.rst b/galleries/users_explain/figure/interactive.rst
index 1e82d37f10f4..adcabaaca1d0 100644
--- a/galleries/users_explain/figure/interactive.rst
+++ b/galleries/users_explain/figure/interactive.rst
@@ -7,7 +7,7 @@
 .. _interactive_figures:
 
 ===================
-Interactive Figures
+Interactive figures
 ===================
 
 When working with data, interactivity can be invaluable. The pan/zoom and
@@ -62,7 +62,7 @@ collected. `.Figure`\s can be closed and deregistered from `.pyplot` individuall
 
 .. _ipython-pylab:
 
-IPython Integration
+IPython integration
 ===================
 
 We recommend using IPython for an interactive shell.  In addition to
@@ -314,7 +314,7 @@ Preserve aspect ratio              hold **CONTROL** when panning/zooming with mo
 
 .. _other-shells:
 
-Other Python Prompts
+Other Python prompts
 ====================
 
 Interactive mode works in the default Python prompt:

From b0509d9c5c076b9341688094ab7d8556bde0d8b8 Mon Sep 17 00:00:00 2001
From: Sebastian Berg <sebastian@sipsolutions.net>
Date: Thu, 26 Oct 2023 22:00:59 +0200
Subject: [PATCH 0361/1120] Update .github/workflows/cibuildwheel.yml

---
 .github/workflows/cibuildwheel.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 981411671436..af733ff04502 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -102,7 +102,7 @@ jobs:
       # istalled more targeted.
       CIBW_BUILD_FRONTEND: >-
         ${{ (((github.event_name == 'push' && github.ref == 'refs/heads/main') ||
-              (github.event_name == 'pull_request' && github.base_ref == 'refs/heads/main')) &&
+              (github.event_name == 'pull_request' && github.base_ref == 'main')) &&
             'pip; args: --pre --extra-index-url "https://pypi.anaconda.org/scientific-python-nightly-wheels/simple"') ||
             'build' }}
       CIBW_REPAIR_WHEEL_COMMAND_WINDOWS: >-

From 71e1c63a6028aa24ccef1eb5138ba8a433c4eb8a Mon Sep 17 00:00:00 2001
From: CozyFrog <garrett.sward@uconn.edu>
Date: Thu, 26 Oct 2023 16:20:26 -0400
Subject: [PATCH 0362/1120] Add test_hlines to test_datetimes.py

---
 lib/matplotlib/tests/test_datetime.py | 22 +++++++++++++++++++---
 1 file changed, 19 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index c9455d450b70..3cac147c002f 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -218,11 +218,27 @@ def test_hist2d(self):
         fig, ax = plt.subplots()
         ax.hist2d(...)
 
-    @pytest.mark.xfail(reason="Test for hlines not written yet")
     @mpl.style.context("default")
     def test_hlines(self):
-        fig, ax = plt.subplots()
-        ax.hlines(...)
+        mpl.rcParams["date.converter"] = 'concise'
+        fig, axs = plt.subplots(2, 3, layout='constrained')
+        dateStrs = ['2023-03-08',
+                    '2023-04-09',
+                    '2023-05-13',
+                    '2023-07-28',
+                    '2023-12-24']
+        dates = [datetime.datetime(2023, m*2, 10) for m in range(1, 6)]
+        npDates = [np.datetime64(s) for s in dateStrs]
+        axs[0, 0].hlines(y=dates,
+                         xmin=[0.1, 0.2, 0.3, 0.4, 0.5],
+                         xmax=[0.5, 0.6, 0.7, 0.8, 0.9])
+        axs[0, 1].hlines(y=dates, xmin=0.2, xmax=0.8)
+        axs[0, 2].hlines(dates, xmin=0, xmax=1)
+        axs[1, 0].hlines(y=npDates,
+                         xmin=[0.5, 0.6, 0.7, 0.8, 0.9],
+                         xmax=[0.1, 0.2, 0.3, 0.4, 0.5])
+        axs[1, 1].hlines(y=npDates, xmin=0.45, xmax=0.65)
+        axs[1, 2].hlines(npDates, xmin=0, xmax=1)
 
     @pytest.mark.xfail(reason="Test for imshow not written yet")
     @mpl.style.context("default")

From 8b81c13cf394909b51ef66082a62ed00d749f8dc Mon Sep 17 00:00:00 2001
From: bersbersbers <12128514+bersbersbers@users.noreply.github.com>
Date: Fri, 27 Oct 2023 09:26:18 +0200
Subject: [PATCH 0363/1120] Add `@QtCore.Slot()` decorations

---
 lib/matplotlib/backends/backend_qt.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/backends/backend_qt.py b/lib/matplotlib/backends/backend_qt.py
index 2aa7874fbdb7..059eff768601 100644
--- a/lib/matplotlib/backends/backend_qt.py
+++ b/lib/matplotlib/backends/backend_qt.py
@@ -642,8 +642,13 @@ def __init__(self, canvas, parent=None, coordinates=True):
             if text is None:
                 self.addSeparator()
             else:
+                slot = getattr(self, callback)
+                # https://bugreports.qt.io/browse/PYSIDE-2512
+                slot = lambda slot=slot, *args: slot(*args)
+                slot = QtCore.Slot()(slot)
+
                 a = self.addAction(self._icon(image_file + '.png'),
-                                   text, getattr(self, callback))
+                                   text, slot)
                 self._actions[callback] = a
                 if callback in ['zoom', 'pan']:
                     a.setCheckable(True)

From 498b5b126191d9f927891b7623fd85df034c7524 Mon Sep 17 00:00:00 2001
From: bersbersbers <12128514+bersbersbers@users.noreply.github.com>
Date: Fri, 27 Oct 2023 17:38:06 +0200
Subject: [PATCH 0364/1120] Avoid `lambda` expression for `flake8`

---
 lib/matplotlib/backends/backend_qt.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/backends/backend_qt.py b/lib/matplotlib/backends/backend_qt.py
index 059eff768601..3d8882bf59fa 100644
--- a/lib/matplotlib/backends/backend_qt.py
+++ b/lib/matplotlib/backends/backend_qt.py
@@ -644,7 +644,7 @@ def __init__(self, canvas, parent=None, coordinates=True):
             else:
                 slot = getattr(self, callback)
                 # https://bugreports.qt.io/browse/PYSIDE-2512
-                slot = lambda slot=slot, *args: slot(*args)
+                slot = functools.partial(slot)
                 slot = QtCore.Slot()(slot)
 
                 a = self.addAction(self._icon(image_file + '.png'),

From 4ece8ab71d3073f263bb022c0dc0a4130589cf46 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Tue, 3 Oct 2023 17:56:47 -0400
Subject: [PATCH 0365/1120] prints font name in missing glyph warning lists all
 fallback fonts if glyph missing in all fonts removed
 ft_get_char_index_or_warn added a test for otf fonts on pdf + some windows
 fonts to tests

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Co-authored-by: Thomas A Caswell <tcaswell@gmail.com>
---
 lib/matplotlib/_text_helpers.py          |  9 ++--
 lib/matplotlib/tests/test_backend_pdf.py | 16 ++++++
 lib/matplotlib/tests/test_ft2font.py     | 46 ++++++++++-------
 lib/matplotlib/tests/test_text.py        |  5 +-
 src/ft2font.cpp                          | 63 +++++++++++++-----------
 src/ft2font.h                            |  2 +
 6 files changed, 89 insertions(+), 52 deletions(-)

diff --git a/lib/matplotlib/_text_helpers.py b/lib/matplotlib/_text_helpers.py
index 18bfb550c90b..8625186ba8ec 100644
--- a/lib/matplotlib/_text_helpers.py
+++ b/lib/matplotlib/_text_helpers.py
@@ -12,11 +12,12 @@
     "LayoutItem", ["ft_object", "char", "glyph_idx", "x", "prev_kern"])
 
 
-def warn_on_missing_glyph(codepoint):
+def warn_on_missing_glyph(codepoint, fontnames):
     _api.warn_external(
-        "Glyph {} ({}) missing from current font.".format(
-            codepoint,
-            chr(codepoint).encode("ascii", "namereplace").decode("ascii")))
+        f"Glyph {codepoint} "
+        f"({chr(codepoint).encode('ascii', 'namereplace').decode('ascii')}) "
+        f"missing from font(s) {fontnames}.")
+
     block = ("Hebrew" if 0x0590 <= codepoint <= 0x05ff else
              "Arabic" if 0x0600 <= codepoint <= 0x06ff else
              "Devanagari" if 0x0900 <= codepoint <= 0x097f else
diff --git a/lib/matplotlib/tests/test_backend_pdf.py b/lib/matplotlib/tests/test_backend_pdf.py
index 68ce02cc366c..ae17c7a4a4e3 100644
--- a/lib/matplotlib/tests/test_backend_pdf.py
+++ b/lib/matplotlib/tests/test_backend_pdf.py
@@ -443,3 +443,19 @@ def test_multi_font_type42():
 
     fig = plt.figure()
     fig.text(0.15, 0.475, "There are 几个汉字 in between!")
+
+
+@pytest.mark.parametrize('family_name, file_name',
+                         [("Noto Sans", "NotoSans-Regular.otf"),
+                          ("FreeMono", "FreeMono.otf")])
+def test_otf_font_smoke(family_name, file_name):
+    # checks that there's no segfault
+    fp = fm.FontProperties(family=[family_name])
+    if Path(fm.findfont(fp)).name != file_name:
+        pytest.skip(f"Font {family_name} may be missing")
+
+    plt.rc('font', family=[family_name], size=27)
+
+    fig = plt.figure()
+    fig.text(0.15, 0.475, "Привет мир!")
+    fig.savefig(io.BytesIO(), format="pdf")
diff --git a/lib/matplotlib/tests/test_ft2font.py b/lib/matplotlib/tests/test_ft2font.py
index 0139bdf41526..2e2ce673f4b8 100644
--- a/lib/matplotlib/tests/test_ft2font.py
+++ b/lib/matplotlib/tests/test_ft2font.py
@@ -30,25 +30,21 @@ def test_ft2font_positive_hinting_factor():
         ft2font.FT2Font(file_name, 0)
 
 
-def test_fallback_smoke():
-    fp = fm.FontProperties(family=["WenQuanYi Zen Hei"])
-    if Path(fm.findfont(fp)).name != "wqy-zenhei.ttc":
-        pytest.skip("Font wqy-zenhei.ttc may be missing")
-
-    fp = fm.FontProperties(family=["Noto Sans CJK JP"])
-    if Path(fm.findfont(fp)).name != "NotoSansCJK-Regular.ttc":
-        pytest.skip("Noto Sans CJK JP font may be missing.")
-
+@pytest.mark.parametrize('family_name, file_name',
+                          [("WenQuanYi Zen Hei",  "wqy-zenhei.ttc"),
+                           ("Noto Sans CJK JP", "NotoSansCJK.ttc"),
+                           ("Noto Sans TC", "NotoSansTC-Regular.otf")]
+                         )
+def test_fallback_smoke(family_name, file_name):
+    fp = fm.FontProperties(family=[family_name])
+    if Path(fm.findfont(fp)).name != file_name:
+        pytest.skip(f"Font {family_name} ({file_name}) is missing")
     plt.rcParams['font.size'] = 20
     fig = plt.figure(figsize=(4.75, 1.85))
     fig.text(0.05, 0.45, "There are 几个汉字 in between!",
-             family=['DejaVu Sans', "Noto Sans CJK JP"])
-    fig.text(0.05, 0.25, "There are 几个汉字 in between!",
-             family=['DejaVu Sans', "WenQuanYi Zen Hei"])
-    fig.text(0.05, 0.65, "There are 几个汉字 in between!",
-             family=["Noto Sans CJK JP"])
+             family=['DejaVu Sans', family_name])
     fig.text(0.05, 0.85, "There are 几个汉字 in between!",
-             family=["WenQuanYi Zen Hei"])
+             family=[family_name])
 
     # TODO enable fallback for other backends!
     for fmt in ['png', 'raw']:  # ["svg", "pdf", "ps"]:
@@ -57,7 +53,8 @@ def test_fallback_smoke():
 
 @pytest.mark.parametrize('family_name, file_name',
                          [("WenQuanYi Zen Hei",  "wqy-zenhei"),
-                          ("Noto Sans CJK JP", "NotoSansCJK")]
+                          ("Noto Sans CJK JP", "NotoSansCJK"),
+                          ("Noto Sans TC", "NotoSansTC-Regular.otf")]
                          )
 @check_figures_equal(extensions=["png", "pdf", "eps", "svg"])
 def test_font_fallback_chinese(fig_test, fig_ref, family_name, file_name):
@@ -78,11 +75,27 @@ def test_font_fallback_chinese(fig_test, fig_ref, family_name, file_name):
         fig_test.text(0.05, .85 - 0.15*j, txt, family=test_font)
 
 
+@pytest.mark.parametrize("font_list",
+                          [['DejaVu Serif', 'DejaVu Sans'],
+                           ['DejaVu Sans Mono']],
+                         ids=["two fonts", "one font"])
+def test_fallback_missing(recwarn, font_list):
+    fig = plt.figure()
+    fig.text(.5, .5, "Hello 🙃 World!", family=font_list)
+    fig.canvas.draw()
+    assert all(isinstance(warn.message, UserWarning) for warn in recwarn)
+    # not sure order is guaranteed on the font listing so
+    assert recwarn[0].message.args[0].startswith(
+           "Glyph 128579 (\\N{UPSIDE-DOWN FACE}) missing from font(s)")
+    assert all([font in recwarn[0].message.args[0] for font in font_list])
+
+
 @pytest.mark.parametrize(
     "family_name, file_name",
     [
         ("WenQuanYi Zen Hei", "wqy-zenhei"),
         ("Noto Sans CJK JP", "NotoSansCJK"),
+        ("Noto Sans TC", "NotoSansTC-Regular.otf")
     ],
 )
 def test__get_fontmap(family_name, file_name):
@@ -97,7 +110,6 @@ def test__get_fontmap(family_name, file_name):
             fm.FontProperties(family=["DejaVu Sans", family_name])
         )
     )
-
     fontmap = ft._get_fontmap(text)
     for char, font in fontmap.items():
         if ord(char) > 127:
diff --git a/lib/matplotlib/tests/test_text.py b/lib/matplotlib/tests/test_text.py
index 7222d5b00cf7..3c14357e45f3 100644
--- a/lib/matplotlib/tests/test_text.py
+++ b/lib/matplotlib/tests/test_text.py
@@ -817,12 +817,13 @@ def test_pdf_kerning():
 
 def test_unsupported_script(recwarn):
     fig = plt.figure()
-    fig.text(.5, .5, "\N{BENGALI DIGIT ZERO}")
+    t = fig.text(.5, .5, "\N{BENGALI DIGIT ZERO}")
     fig.canvas.draw()
     assert all(isinstance(warn.message, UserWarning) for warn in recwarn)
     assert (
         [warn.message.args for warn in recwarn] ==
-        [(r"Glyph 2534 (\N{BENGALI DIGIT ZERO}) missing from current font.",),
+        [(r"Glyph 2534 (\N{BENGALI DIGIT ZERO}) missing from font(s) "
+            + f"{t.get_fontname()}.",),
          (r"Matplotlib currently does not support Bengali natively.",)])
 
 
diff --git a/src/ft2font.cpp b/src/ft2font.cpp
index fbc00dc69696..ced138f9a2af 100644
--- a/src/ft2font.cpp
+++ b/src/ft2font.cpp
@@ -4,6 +4,7 @@
 
 #include <algorithm>
 #include <iterator>
+#include <set>
 #include <sstream>
 #include <stdexcept>
 #include <string>
@@ -184,11 +185,20 @@ FT2Image::draw_rect_filled(unsigned long x0, unsigned long y0, unsigned long x1,
     m_dirty = true;
 }
 
-static void ft_glyph_warn(FT_ULong charcode)
+static void ft_glyph_warn(FT_ULong charcode, std::set<FT_String*> family_names)
 {
     PyObject *text_helpers = NULL, *tmp = NULL;
+    std::set<FT_String*>::iterator it = family_names.begin();
+    std::stringstream ss;
+    ss<<*it;
+    while(++it != family_names.end()){
+        ss<<", "<<*it;
+    }
+
     if (!(text_helpers = PyImport_ImportModule("matplotlib._text_helpers")) ||
-        !(tmp = PyObject_CallMethod(text_helpers, "warn_on_missing_glyph", "k", charcode))) {
+        !(tmp = PyObject_CallMethod(text_helpers,
+                "warn_on_missing_glyph", "(k, s)",
+                charcode, ss.str().c_str()))) {
         goto exit;
     }
 exit:
@@ -199,19 +209,6 @@ static void ft_glyph_warn(FT_ULong charcode)
     }
 }
 
-static FT_UInt
-ft_get_char_index_or_warn(FT_Face face, FT_ULong charcode, bool warn = true)
-{
-    FT_UInt glyph_index = FT_Get_Char_Index(face, charcode);
-    if (glyph_index) {
-        return glyph_index;
-    }
-    if (warn) {
-        ft_glyph_warn(charcode);
-    }
-    return 0;
-}
-
 // ft_outline_decomposer should be passed to FT_Outline_Decompose.  On the
 // first pass, vertices and codes are set to NULL, and index is simply
 // incremented for each vertex that should be inserted, so that it is set, at
@@ -510,13 +507,13 @@ void FT2Font::set_text(
         FT_Pos last_advance;
 
         FT_Error charcode_error, glyph_error;
+        std::set<FT_String*> glyph_seen_fonts;
         FT2Font *ft_object_with_glyph = this;
         bool was_found = load_char_with_fallback(ft_object_with_glyph, glyph_index, glyphs,
                                                  char_to_font, glyph_to_font, codepoints[n], flags,
-                                                 charcode_error, glyph_error, false);
+                                                 charcode_error, glyph_error, glyph_seen_fonts, false);
         if (!was_found) {
-            ft_glyph_warn((FT_ULong)codepoints[n]);
-
+            ft_glyph_warn((FT_ULong)codepoints[n], glyph_seen_fonts);
             // render missing glyph tofu
             // come back to top-most font
             ft_object_with_glyph = this;
@@ -570,6 +567,7 @@ void FT2Font::load_char(long charcode, FT_Int32 flags, FT2Font *&ft_object, bool
     // if this is parent FT2Font, cache will be filled in 2 ways:
     // 1. set_text was previously called
     // 2. set_text was not called and fallback was enabled
+    std::set <FT_String *> glyph_seen_fonts;
     if (fallback && char_to_font.find(charcode) != char_to_font.end()) {
         ft_object = char_to_font[charcode];
         // since it will be assigned to ft_object anyway
@@ -579,10 +577,12 @@ void FT2Font::load_char(long charcode, FT_Int32 flags, FT2Font *&ft_object, bool
         FT_UInt final_glyph_index;
         FT_Error charcode_error, glyph_error;
         FT2Font *ft_object_with_glyph = this;
-        bool was_found = load_char_with_fallback(ft_object_with_glyph, final_glyph_index, glyphs, char_to_font,
-                                glyph_to_font, charcode, flags, charcode_error, glyph_error, true);
+        bool was_found = load_char_with_fallback(ft_object_with_glyph, final_glyph_index,
+                                                 glyphs, char_to_font, glyph_to_font,
+                                                 charcode, flags, charcode_error, glyph_error,
+                                                 glyph_seen_fonts, true);
         if (!was_found) {
-            ft_glyph_warn(charcode);
+            ft_glyph_warn(charcode, glyph_seen_fonts);
             if (charcode_error) {
                 throw_ft_error("Could not load charcode", charcode_error);
             }
@@ -592,9 +592,13 @@ void FT2Font::load_char(long charcode, FT_Int32 flags, FT2Font *&ft_object, bool
         }
         ft_object = ft_object_with_glyph;
     } else {
+        //no fallback case
         ft_object = this;
-        FT_UInt glyph_index = ft_get_char_index_or_warn(face, (FT_ULong)charcode);
-
+        FT_UInt glyph_index = FT_Get_Char_Index(face, (FT_ULong) charcode);
+        if (!glyph_index){
+            glyph_seen_fonts.insert((face != NULL)?face->family_name: NULL);
+            ft_glyph_warn((FT_ULong)charcode, glyph_seen_fonts);
+        }
         if (FT_Error error = FT_Load_Glyph(face, glyph_index, flags)) {
             throw_ft_error("Could not load charcode", error);
         }
@@ -640,19 +644,21 @@ bool FT2Font::load_char_with_fallback(FT2Font *&ft_object_with_glyph,
                                       FT_Int32 flags,
                                       FT_Error &charcode_error,
                                       FT_Error &glyph_error,
+                                      std::set<FT_String*> &glyph_seen_fonts,
                                       bool override = false)
 {
     FT_UInt glyph_index = FT_Get_Char_Index(face, charcode);
+    glyph_seen_fonts.insert(face->family_name);
 
     if (glyph_index || override) {
+
         charcode_error = FT_Load_Glyph(face, glyph_index, flags);
         if (charcode_error) {
             return false;
         }
-
         FT_Glyph thisGlyph;
         glyph_error = FT_Get_Glyph(face->glyph, &thisGlyph);
-        if (glyph_error) {
+        if (glyph_error){
             return false;
         }
 
@@ -667,12 +673,12 @@ bool FT2Font::load_char_with_fallback(FT2Font *&ft_object_with_glyph,
         parent_glyphs.push_back(thisGlyph);
         return true;
     }
-
     else {
         for (size_t i = 0; i < fallbacks.size(); ++i) {
             bool was_found = fallbacks[i]->load_char_with_fallback(
                 ft_object_with_glyph, final_glyph_index, parent_glyphs, parent_char_to_font,
-                parent_glyph_to_font, charcode, flags, charcode_error, glyph_error, override);
+                parent_glyph_to_font, charcode, flags, charcode_error, glyph_error,
+                glyph_seen_fonts, override);
             if (was_found) {
                 return true;
             }
@@ -721,8 +727,7 @@ FT_UInt FT2Font::get_char_index(FT_ULong charcode, bool fallback = false)
         ft_object = this;
     }
 
-    // historically, get_char_index never raises a warning
-    return ft_get_char_index_or_warn(ft_object->get_face(), charcode, false);
+    return FT_Get_Char_Index(ft_object->get_face(), charcode);
 }
 
 void FT2Font::get_width_height(long *width, long *height)
diff --git a/src/ft2font.h b/src/ft2font.h
index d566c3f9bd9d..69dafb66bdca 100644
--- a/src/ft2font.h
+++ b/src/ft2font.h
@@ -5,6 +5,7 @@
 #ifndef MPL_FT2FONT_H
 #define MPL_FT2FONT_H
 #include <vector>
+#include<set>
 #include <stdint.h>
 #include <unordered_map>
 
@@ -91,6 +92,7 @@ class FT2Font
                                  FT_Int32 flags,
                                  FT_Error &charcode_error,
                                  FT_Error &glyph_error,
+                                 std::set<FT_String*> &glyph_seen_fonts,
                                  bool override);
     void load_glyph(FT_UInt glyph_index, FT_Int32 flags, FT2Font *&ft_object, bool fallback);
     void load_glyph(FT_UInt glyph_index, FT_Int32 flags);

From 15c44a5a474f1213179882973c4096886c0fe1e7 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Fri, 27 Oct 2023 12:56:58 -0400
Subject: [PATCH 0366/1120] mend

---
 src/ft2font.cpp | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/src/ft2font.cpp b/src/ft2font.cpp
index ced138f9a2af..b20f224715bf 100644
--- a/src/ft2font.cpp
+++ b/src/ft2font.cpp
@@ -651,14 +651,13 @@ bool FT2Font::load_char_with_fallback(FT2Font *&ft_object_with_glyph,
     glyph_seen_fonts.insert(face->family_name);
 
     if (glyph_index || override) {
-
         charcode_error = FT_Load_Glyph(face, glyph_index, flags);
         if (charcode_error) {
             return false;
         }
         FT_Glyph thisGlyph;
         glyph_error = FT_Get_Glyph(face->glyph, &thisGlyph);
-        if (glyph_error){
+        if (glyph_error) {
             return false;
         }
 
@@ -676,9 +675,9 @@ bool FT2Font::load_char_with_fallback(FT2Font *&ft_object_with_glyph,
     else {
         for (size_t i = 0; i < fallbacks.size(); ++i) {
             bool was_found = fallbacks[i]->load_char_with_fallback(
-                ft_object_with_glyph, final_glyph_index, parent_glyphs, parent_char_to_font,
-                parent_glyph_to_font, charcode, flags, charcode_error, glyph_error,
-                glyph_seen_fonts, override);
+                ft_object_with_glyph, final_glyph_index, parent_glyphs,
+                parent_char_to_font, parent_glyph_to_font, charcode, flags,
+                charcode_error, glyph_error, glyph_seen_fonts, override);
             if (was_found) {
                 return true;
             }

From 86672afb63d0484e90ca6f6fb216662e8fd26d25 Mon Sep 17 00:00:00 2001
From: esibinga <vegheadeva@gmail.com>
Date: Thu, 21 Sep 2023 00:14:07 -0400
Subject: [PATCH 0367/1120] carriage breaks

---
 galleries/examples/tag_guidelines.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/galleries/examples/tag_guidelines.rst b/galleries/examples/tag_guidelines.rst
index 2fac2f8712c9..470b1b93e4c6 100644
--- a/galleries/examples/tag_guidelines.rst
+++ b/galleries/examples/tag_guidelines.rst
@@ -18,9 +18,9 @@ Every gallery example should be tagged with:
 * 1+ content tags
 * structural, domain, or internal tag(s) if helpful
 
-Examples with many tags may indicate that the entry is a showcase example.
+    Examples with many tags may indicate that the entry is a showcase example.
 
-Tags can repeat existing forms of organization (e.g. an example is in the Animation folder and also gets an ``animation`` tag).
+    Tags can repeat existing forms of organization (e.g. an example is in the Animation folder and also gets an ``animation`` tag).
 
 Tags are helpful to denote particularly good "byproduct" examples. E.g. the explicit purpose of a gallery example might be to demonstrate a colormap, but it's also a good demonstration of a legend. Tag ``legend`` to indicate that, rather than changing the title or the scope of the example.
 

From af6366e1891d0ec427f3273e5cda3a92c0aec6fb Mon Sep 17 00:00:00 2001
From: esibinga <vegheadeva@gmail.com>
Date: Thu, 21 Sep 2023 00:19:36 -0400
Subject: [PATCH 0368/1120] tabs

---
 galleries/examples/tag_guidelines.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/galleries/examples/tag_guidelines.rst b/galleries/examples/tag_guidelines.rst
index 470b1b93e4c6..5d360240bbe2 100644
--- a/galleries/examples/tag_guidelines.rst
+++ b/galleries/examples/tag_guidelines.rst
@@ -38,7 +38,7 @@ IV. Internal tags: what information is helpful for maintainers or contributors?
     3. New tags should be be added when they are relevant to existing gallery entries too. Avoid tags that will link to only a single gallery entry.
     4. Tags can recreate other forms of organization.
 
-Note: Tagging organization aims to work for 80-90% of cases. Some examples fall outside of the tagging structure. Niche or specific examples shouldn't be given standalone tags that won't apply to other examples.
+    Note: Tagging organization aims to work for 80-90% of cases. Some examples fall outside of the tagging structure. Niche or specific examples shouldn't be given standalone tags that won't apply to other examples.
 
 *How to tag?*
  where you put the directive is where the tag will show

From c87995e661c2d80e245806c2fd6ac4525c93c2c4 Mon Sep 17 00:00:00 2001
From: esibinga <vegheadeva@gmail.com>
Date: Thu, 21 Sep 2023 00:23:27 -0400
Subject: [PATCH 0369/1120] indentation

---
 galleries/examples/tag_guidelines.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/galleries/examples/tag_guidelines.rst b/galleries/examples/tag_guidelines.rst
index 5d360240bbe2..3354abfd963c 100644
--- a/galleries/examples/tag_guidelines.rst
+++ b/galleries/examples/tag_guidelines.rst
@@ -13,14 +13,14 @@ Guidelines for assigning tags to gallery examples
 
 *What gets a tag?*
 
-Every gallery example should be tagged with:
+    Every gallery example should be tagged with:
 
-* 1+ content tags
-* structural, domain, or internal tag(s) if helpful
+    * 1+ content tags
+    * structural, domain, or internal tag(s) if helpful
 
-    Examples with many tags may indicate that the entry is a showcase example.
+        Examples with many tags may indicate that the entry is a showcase example.
 
-    Tags can repeat existing forms of organization (e.g. an example is in the Animation folder and also gets an ``animation`` tag).
+        Tags can repeat existing forms of organization (e.g. an example is in the Animation folder and also gets an ``animation`` tag).
 
 Tags are helpful to denote particularly good "byproduct" examples. E.g. the explicit purpose of a gallery example might be to demonstrate a colormap, but it's also a good demonstration of a legend. Tag ``legend`` to indicate that, rather than changing the title or the scope of the example.
 

From c289586d91e92888d8686dae15dc6c77acd7a9cf Mon Sep 17 00:00:00 2001
From: esibinga <vegheadeva@gmail.com>
Date: Thu, 5 Oct 2023 23:39:46 -0400
Subject: [PATCH 0370/1120] styling changes and Melissa's suggested changes

---
 galleries/examples/tag_guidelines.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/galleries/examples/tag_guidelines.rst b/galleries/examples/tag_guidelines.rst
index 3354abfd963c..2fac2f8712c9 100644
--- a/galleries/examples/tag_guidelines.rst
+++ b/galleries/examples/tag_guidelines.rst
@@ -13,14 +13,14 @@ Guidelines for assigning tags to gallery examples
 
 *What gets a tag?*
 
-    Every gallery example should be tagged with:
+Every gallery example should be tagged with:
 
-    * 1+ content tags
-    * structural, domain, or internal tag(s) if helpful
+* 1+ content tags
+* structural, domain, or internal tag(s) if helpful
 
-        Examples with many tags may indicate that the entry is a showcase example.
+Examples with many tags may indicate that the entry is a showcase example.
 
-        Tags can repeat existing forms of organization (e.g. an example is in the Animation folder and also gets an ``animation`` tag).
+Tags can repeat existing forms of organization (e.g. an example is in the Animation folder and also gets an ``animation`` tag).
 
 Tags are helpful to denote particularly good "byproduct" examples. E.g. the explicit purpose of a gallery example might be to demonstrate a colormap, but it's also a good demonstration of a legend. Tag ``legend`` to indicate that, rather than changing the title or the scope of the example.
 
@@ -38,7 +38,7 @@ IV. Internal tags: what information is helpful for maintainers or contributors?
     3. New tags should be be added when they are relevant to existing gallery entries too. Avoid tags that will link to only a single gallery entry.
     4. Tags can recreate other forms of organization.
 
-    Note: Tagging organization aims to work for 80-90% of cases. Some examples fall outside of the tagging structure. Niche or specific examples shouldn't be given standalone tags that won't apply to other examples.
+Note: Tagging organization aims to work for 80-90% of cases. Some examples fall outside of the tagging structure. Niche or specific examples shouldn't be given standalone tags that won't apply to other examples.
 
 *How to tag?*
  where you put the directive is where the tag will show

From ad4dee28baa63a34be5f97cce6015098f898c714 Mon Sep 17 00:00:00 2001
From: esibinga <vegheadeva@gmail.com>
Date: Fri, 27 Oct 2023 14:24:49 -0400
Subject: [PATCH 0371/1120] changes to level and purpose

---
 galleries/examples/tag_glossary.rst | 80 +++++++++++++++++++----------
 1 file changed, 52 insertions(+), 28 deletions(-)

diff --git a/galleries/examples/tag_glossary.rst b/galleries/examples/tag_glossary.rst
index 439524f0b99c..5b4b79d07b5e 100644
--- a/galleries/examples/tag_glossary.rst
+++ b/galleries/examples/tag_glossary.rst
@@ -34,6 +34,9 @@ Tag Glossary
 +-----------------------------------+---------------------------------------------+
 |``styling: small-multiples``       |                                             |
 +-----------------------------------+---------------------------------------------+
+|``styling: conditional``           |styling is determined programmatically by a  |
+|                                   |condition being met                          |
++-----------------------------------+---------------------------------------------+
 |                                   |                                             |
 +-----------------------------------+---------------------------------------------+
 |**Primary or relevant plot component**                                           |
@@ -66,18 +69,28 @@ Tag Glossary
 +-----------------------------------+---------------------------------------------+
 |``component: error``               |                                             |
 +-----------------------------------+---------------------------------------------+
+|``component: animation``           |                                             |
++-----------------------------------+---------------------------------------------+
 |                                   |                                             |
 +-----------------------------------+---------------------------------------------+
 |**Interactivity**                                                                |
 +-----------------------------------+---------------------------------------------+
 |``interactivity: event handling``  |                                             |
 +-----------------------------------+---------------------------------------------+
+|``interactivity: click``           |                                             |
++-----------------------------------+---------------------------------------------+
+|``interactivity: mouseover``       |                                             |
++-----------------------------------+---------------------------------------------+
 |``interactivity: zoom``            |                                             |
 +-----------------------------------+---------------------------------------------+
 |``interactivity: pan``             |                                             |
 +-----------------------------------+---------------------------------------------+
 |``interactivity: brush``           |                                             |
 +-----------------------------------+---------------------------------------------+
+|``interactivity: drag``            |                                             |
++-----------------------------------+---------------------------------------------+
+|``interactivity: scroll``          |                                             |
++-----------------------------------+---------------------------------------------+
 |                                   |                                             |
 +-----------------------------------+---------------------------------------------+
 |**Plot Type**                                                                    |
@@ -96,27 +109,33 @@ Tag Glossary
 +-----------------------------------+---------------------------------------------+
 |``plot type: specialty``           |                                             |
 +-----------------------------------+---------------------------------------------+
-|``plot type:          ``           |                                             |
+|``plot type: scatter``             |                                             |
 +-----------------------------------+---------------------------------------------+
 
 
 *2. Structural tags: what format is the example? What context can we provide?*
 
-+-----------------------+-------------------------------------------------------------------+
-|``tag``                | use case                                                          |
-+=======================+===================================================================+
-|``level: reference``   |reference docs like "marker reference" or "list of named colors"   |
-|                       | - dense collection of short-format information                    |
-|                       | - well-defined scope, accessible information                      |
-+-----------------------+-------------------------------------------------------------------+
-|``level``              |level refers to how much context/background the user will need     |
-+-----------------------+-------------------------------------------------------------------+
-|``level: beginner``    |concepts are standalone, self-contained, require only one module   |
-+-----------------------+-------------------------------------------------------------------+
-|``level: intermediate``|concepts may require knowledge of other modules, have dependencies |
-+-----------------------+-------------------------------------------------------------------+
-|``level: advanced``    |concepts require multiple modules and have dependencies            |
-+-----------------------+-------------------------------------------------------------------+
++----------------------------+-------------------------------------------------------------------+
+|``tag``                     | use case                                                          |
++============================+===================================================================+
+|``level``                   |level refers to how much context/background the user will need     |
++----------------------------+-------------------------------------------------------------------+
+|``level: beginner``         |concepts are standalone, self-contained, require only one module   |
++----------------------------+-------------------------------------------------------------------+
+|``level: intermediate``     |concepts may require knowledge of other modules, have dependencies |
++----------------------------+-------------------------------------------------------------------+
+|``level: advanced``         |concepts require multiple modules and have dependencies            |
++----------------------------+-------------------------------------------------------------------+
+|``purpose``                 |what's it here for?                                                |
++----------------------------+-------------------------------------------------------------------+
+|``purpose: storytelling``   |storytelling exemplar -- build a visual argument                   |
++----------------------------+-------------------------------------------------------------------+
+|``purpose: reference``      |reference docs like "marker reference" or "list of named colors"   |
+|                            | - dense collection of short-format information                    |
+|                            | - well-defined scope, accessible information                      |
++----------------------------+-------------------------------------------------------------------+
+|``purpose: fun``            |just for fun!                                                      |
++----------------------------+-------------------------------------------------------------------+
 
 *3. Domain tags: what discipline(s) might seek this example consistently?*
 
@@ -124,7 +143,7 @@ Note: it's futile to draw fences around "who owns what", and that's not the poin
 
 +-------------------------------+----------------------------------------+
 |``tag``                        | use case                               |
-+=======================+================================================+
++===============================+========================================+
 |``domain``                     |for whom is the example relevant?       |
 +-------------------------------+----------------------------------------+
 |``domain: cartography``        |                                        |
@@ -142,14 +161,19 @@ Note: it's futile to draw fences around "who owns what", and that's not the poin
 
 *4. Internal tags: what information is helpful for maintainers or contributors?*
 
-+---------------------------+-----------------------------------------------------------------------+
-|``tag``                    | use case                                                              |
-+===========================+=======================================================================+
-|``internal: low bandwidth``|allows users to filter out bandwidth-intensive examples like animations|
-+---------------------------+-----------------------------------------------------------------------+
-|``internal: untagged``     |allows docs contributors to easily find untagged examples              |
-+---------------------------+-----------------------------------------------------------------------+
-|``internal: deprecated``   |examples containing deprecated functionality or concepts               |
-+---------------------------+-----------------------------------------------------------------------+
-|``internal: needs-review`` |example needs to be reviewed for accuracy or pedagogical value         |
-+---------------------------+-----------------------------------------------------------------------+
++-------------------------------+-----------------------------------------------------------------------+
+|``tag``                        | use case                                                              |
++===============================+=======================================================================+
+|``internal: low bandwidth``    |allows users to filter out bandwidth-intensive examples like animations|
++-------------------------------+-----------------------------------------------------------------------+
+|``internal: untagged``         |allows docs contributors to easily find untagged examples              |
++-------------------------------+-----------------------------------------------------------------------+
+|``internal: deprecated``       |examples containing deprecated functionality or concepts               |
++-------------------------------+-----------------------------------------------------------------------+
+|``internal: needs-review``     |example needs to be reviewed for accuracy or pedagogical value         |
++-------------------------------+-----------------------------------------------------------------------+
+|``internal: outstanding-todo`` |example has an unfinished to-do                                        |
++-------------------------------+-----------------------------------------------------------------------+
+|``internal: too-much``         |the example should be refined, split into multiple examples, or        |
+|                               |reformatted into a tutorial or reference                               |
++-------------------------------+-----------------------------------------------------------------------+

From 2ae0421894a9b4efada67120c275c2aa06954691 Mon Sep 17 00:00:00 2001
From: Eva Sibinga <46283995+esibinga@users.noreply.github.com>
Date: Fri, 27 Oct 2023 15:03:27 -0400
Subject: [PATCH 0372/1120] Apply suggestions from code review
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Melissa Weber Mendonça <melissawm@gmail.com>
---
 galleries/examples/tag_glossary.rst   | 10 ++++------
 galleries/examples/tag_guidelines.rst | 16 ++++++++--------
 2 files changed, 12 insertions(+), 14 deletions(-)

diff --git a/galleries/examples/tag_glossary.rst b/galleries/examples/tag_glossary.rst
index 5b4b79d07b5e..8aa7ebb18c60 100644
--- a/galleries/examples/tag_glossary.rst
+++ b/galleries/examples/tag_glossary.rst
@@ -3,10 +3,10 @@
 Tag Glossary
 ============
 
-    I. API tags: what content from the API reference is in the example?
-    II. Structural tags: what format is the example? What context can we provide?
-    III. Domain tags: what discipline(s) might seek this example consistently?
-    IV. Internal tags: what information is helpful for maintainers or contributors?
+I. API tags: what content from the API reference is in the example?
+II. Structural tags: what format is the example? What context can we provide?
+III. Domain tags: what discipline(s) might seek this example consistently?
+IV. Internal tags: what information is helpful for maintainers or contributors?
 
 
 *1. API tags: what content from the API reference is in the example?*
@@ -156,8 +156,6 @@ Note: it's futile to draw fences around "who owns what", and that's not the poin
 +-------------------------------+----------------------------------------+
 |``domain: signal-processing``  |                                        |
 +-------------------------------+----------------------------------------+
-|                               |                                        |
-+-------------------------------+----------------------------------------+
 
 *4. Internal tags: what information is helpful for maintainers or contributors?*
 
diff --git a/galleries/examples/tag_guidelines.rst b/galleries/examples/tag_guidelines.rst
index 2fac2f8712c9..1128699513eb 100644
--- a/galleries/examples/tag_guidelines.rst
+++ b/galleries/examples/tag_guidelines.rst
@@ -3,13 +3,13 @@ Guidelines for assigning tags to gallery examples
 
 *Why do we need tags?*
 
-    Tags serve multiple purposes.
+Tags serve multiple purposes.
 
-    Tags have a one-to-many organization (i.e. one example can have several tags), while the gallery structure requires that examples are placed in only one location. This means tags provide a secondary layer of organization and make the gallery of examples more flexible and more user-friendly.
+Tags have a one-to-many organization (i.e. one example can have several tags), while the gallery structure requires that examples are placed in only one location. This means tags provide a secondary layer of organization and make the gallery of examples more flexible and more user-friendly.
 
-    They allow for better discoverability, search, and browse functions. They are helpful for users struggling to write a search query for what they're looking for.
+They allow for better discoverability, search, and browse functions. They are helpful for users struggling to write a search query for what they're looking for.
 
-    Hidden tags provide additional functionality for maintainers and contributors.
+Hidden tags provide additional functionality for maintainers and contributors.
 
 *What gets a tag?*
 
@@ -33,10 +33,10 @@ IV. Internal tags: what information is helpful for maintainers or contributors?
 
 *Proposing new tags*
 
-    1. Review existing tag list, looking out for similar entries (i.e. ``axes`` and ``axis``).
-    2. If a relevant tag or subcategory does not yet exist, propose it. Each tag is two parts: ``subcategory: tag``. Tags should be one or two words.
-    3. New tags should be be added when they are relevant to existing gallery entries too. Avoid tags that will link to only a single gallery entry.
-    4. Tags can recreate other forms of organization.
+1. Review existing tag list, looking out for similar entries (i.e. ``axes`` and ``axis``).
+2. If a relevant tag or subcategory does not yet exist, propose it. Each tag is two parts: ``subcategory: tag``. Tags should be one or two words.
+3. New tags should be be added when they are relevant to existing gallery entries too. Avoid tags that will link to only a single gallery entry.
+4. Tags can recreate other forms of organization.
 
 Note: Tagging organization aims to work for 80-90% of cases. Some examples fall outside of the tagging structure. Niche or specific examples shouldn't be given standalone tags that won't apply to other examples.
 

From 44c57b4a3e33fbd5e7c3696e937c43691a484e21 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Fri, 27 Oct 2023 15:17:01 -0500
Subject: [PATCH 0373/1120] Fix type hints for undeprecated contour APIs

They whad been in the limbo land of deprecated APIs that I didn't bother to ensure were the _best_ type hints because they were deprecated. So I just added them to the allowlist for stubtest, but now that they are undeprecated, make sure that they are correct. While I'm here, may as well get rid of the allow list entries for all of them, even the ones that are still deprecated, as that is documented standard practice going forward that pyi match implementation for deprecations as well
---
 ci/mypy-stubtest-allowlist.txt |  6 ------
 lib/matplotlib/contour.pyi     | 11 ++++++++---
 lib/matplotlib/path.pyi        |  2 +-
 3 files changed, 9 insertions(+), 10 deletions(-)

diff --git a/ci/mypy-stubtest-allowlist.txt b/ci/mypy-stubtest-allowlist.txt
index e9256de10b36..9f3efd283906 100644
--- a/ci/mypy-stubtest-allowlist.txt
+++ b/ci/mypy-stubtest-allowlist.txt
@@ -41,12 +41,6 @@ matplotlib.figure.Figure.set_tight_layout
 matplotlib.cm.register_cmap
 matplotlib.cm.unregister_cmap
 
-# 3.8 deprecations
-matplotlib.contour.ContourSet.allkinds
-matplotlib.contour.ContourSet.allsegs
-matplotlib.contour.ContourSet.tcolors
-matplotlib.contour.ContourSet.tlinewidths
-
 # positional-only argument name lacking leading underscores
 matplotlib.axes._base._AxesBase.axis
 
diff --git a/lib/matplotlib/contour.pyi b/lib/matplotlib/contour.pyi
index 8a987b762445..d7bddfe8f1f5 100644
--- a/lib/matplotlib/contour.pyi
+++ b/lib/matplotlib/contour.pyi
@@ -103,12 +103,17 @@ class ContourSet(ContourLabeler, Collection):
     clip_path: Patch | Path | TransformedPath | TransformedPatchPath | None
     labelTexts: list[Text]
     labelCValues: list[ColorType]
-    allkinds: list[np.ndarray]
-    tcolors: list[tuple[float, float, float, float]]
+    @property
+    def tcolors(self) -> list[tuple[tuple[float, float, float, float]]]: ...
 
     # only for not filled
-    tlinewidths: list[tuple[float]]
+    @property
+    def tlinewidths(self) -> list[tuple[float]]: ...
 
+    @property
+    def allkinds(self) -> list[list[np.ndarray | None]]: ...
+    @property
+    def allsegs(self) -> list[list[np.ndarray]]: ...
     @property
     def alpha(self) -> float | None: ...
     @property
diff --git a/lib/matplotlib/path.pyi b/lib/matplotlib/path.pyi
index c96c5a0ba9e4..464fc6d9a912 100644
--- a/lib/matplotlib/path.pyi
+++ b/lib/matplotlib/path.pyi
@@ -30,7 +30,7 @@ class Path:
     @vertices.setter
     def vertices(self, vertices: ArrayLike) -> None: ...
     @property
-    def codes(self) -> ArrayLike: ...
+    def codes(self) -> ArrayLike | None: ...
     @codes.setter
     def codes(self, codes: ArrayLike) -> None: ...
     @property

From e5a8ef7550d559420611d49ba726dea209c61576 Mon Sep 17 00:00:00 2001
From: dohyun <dohyun@localhost.localdomain>
Date: Fri, 27 Oct 2023 19:33:00 -0400
Subject: [PATCH 0374/1120] regularized formatting

---
 .../examples/text_labels_and_annotations/angle_annotation.py  | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/galleries/examples/text_labels_and_annotations/angle_annotation.py b/galleries/examples/text_labels_and_annotations/angle_annotation.py
index 419d094bb6a9..fa46d8674443 100644
--- a/galleries/examples/text_labels_and_annotations/angle_annotation.py
+++ b/galleries/examples/text_labels_and_annotations/angle_annotation.py
@@ -30,7 +30,7 @@
 
 # %%
 # AngleAnnotation class
-# ~~~~~~~~~~~~~~~~~~~~~
+# ^^^^^^^^^^^^^^^^^^^^^
 # The essential idea here is to subclass `~.patches.Arc` and set its transform
 # to the `~.transforms.IdentityTransform`, making the parameters of the arc
 # defined in pixel space.
@@ -215,7 +215,7 @@ def R(a, r, w, h):
 # .. _angle-annotation-usage:
 #
 # Usage
-# ~~~~~
+# ^^^^^
 #
 # Required arguments to ``AngleAnnotation`` are the center of the arc, *xy*,
 # and two points, such that the arc spans between the two vectors connecting

From 10a23c89a0e64c2009d9b2ed663708e097dbcf3b Mon Sep 17 00:00:00 2001
From: dohyun <dohyun@localhost.localdomain>
Date: Fri, 27 Oct 2023 19:35:46 -0400
Subject: [PATCH 0375/1120] regularized formatting

---
 .../subplots_axes_and_figures/axes_box_aspect.py   | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/galleries/examples/subplots_axes_and_figures/axes_box_aspect.py b/galleries/examples/subplots_axes_and_figures/axes_box_aspect.py
index 9ad5a14b7649..00fdeff17ceb 100644
--- a/galleries/examples/subplots_axes_and_figures/axes_box_aspect.py
+++ b/galleries/examples/subplots_axes_and_figures/axes_box_aspect.py
@@ -15,7 +15,7 @@
 
 # %%
 # A square axes, independent of data
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+# ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 #
 # Produce a square axes, no matter what the data limits are.
 
@@ -31,7 +31,7 @@
 
 # %%
 # Shared square axes
-# ~~~~~~~~~~~~~~~~~~
+# ^^^^^^^^^^^^^^^^^^
 #
 # Produce shared subplots that are squared in size.
 #
@@ -47,7 +47,7 @@
 
 # %%
 # Square twin axes
-# ~~~~~~~~~~~~~~~~
+# ^^^^^^^^^^^^^^^^
 #
 # Produce a square axes, with a twin axes. The twinned axes takes over the
 # box aspect of the parent.
@@ -67,7 +67,7 @@
 
 # %%
 # Normal plot next to image
-# ~~~~~~~~~~~~~~~~~~~~~~~~~
+# ^^^^^^^^^^^^^^^^^^^^^^^^^
 #
 # When creating an image plot with fixed data aspect and the default
 # ``adjustable="box"`` next to a normal plot, the axes would be unequal in
@@ -90,7 +90,7 @@
 
 # %%
 # Square joint/marginal plot
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~
+# ^^^^^^^^^^^^^^^^^^^^^^^^^^
 #
 # It may be desirable to show marginal distributions next to a plot of joint
 # data. The following creates a square plot with the box aspect of the
@@ -116,7 +116,7 @@
 
 # %%
 # Square joint/marginal plot
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~
+# ^^^^^^^^^^^^^^^^^^^^^^^^^^
 #
 # When setting the box aspect, one may still set the data aspect as well.
 # Here we create an Axes with a box twice as long as tall and use an "equal"
@@ -133,7 +133,7 @@
 
 # %%
 # Box aspect for many subplots
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+# ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 #
 # It is possible to pass the box aspect to an Axes at initialization. The
 # following creates a 2 by 3 subplot grid with all square Axes.

From 40c67564b35c4b8114b9bf159b5552b080868f9b Mon Sep 17 00:00:00 2001
From: bersbersbers <12128514+bersbersbers@users.noreply.github.com>
Date: Sat, 28 Oct 2023 08:18:46 +0200
Subject: [PATCH 0376/1120] Maintain `__name__` for `PyQt`

---
 lib/matplotlib/backends/backend_qt.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/backends/backend_qt.py b/lib/matplotlib/backends/backend_qt.py
index 3d8882bf59fa..07849728b4c8 100644
--- a/lib/matplotlib/backends/backend_qt.py
+++ b/lib/matplotlib/backends/backend_qt.py
@@ -644,7 +644,7 @@ def __init__(self, canvas, parent=None, coordinates=True):
             else:
                 slot = getattr(self, callback)
                 # https://bugreports.qt.io/browse/PYSIDE-2512
-                slot = functools.partial(slot)
+                slot = functools.wraps(slot)(functools.partial(slot))
                 slot = QtCore.Slot()(slot)
 
                 a = self.addAction(self._icon(image_file + '.png'),

From faddff9a21095a9f2777016dcd244904812f8441 Mon Sep 17 00:00:00 2001
From: Greg Lucas <greg.m.lucas@gmail.com>
Date: Sat, 28 Oct 2023 09:28:14 -0600
Subject: [PATCH 0377/1120] FIX: Enable interrupts on macosx event loops

Follow the same logic with a context manager for the handling
of the event interrupts so that we can re-use the logic from
the main loop implementation in the start_event_loop function
as well.
---
 lib/matplotlib/backends/backend_macosx.py | 75 +++++++++++++++--------
 src/_macosx.m                             |  6 +-
 2 files changed, 51 insertions(+), 30 deletions(-)

diff --git a/lib/matplotlib/backends/backend_macosx.py b/lib/matplotlib/backends/backend_macosx.py
index ecf21b07aef4..a39f5b5b1497 100644
--- a/lib/matplotlib/backends/backend_macosx.py
+++ b/lib/matplotlib/backends/backend_macosx.py
@@ -1,3 +1,4 @@
+import contextlib
 import os
 import signal
 import socket
@@ -106,6 +107,13 @@ def resize(self, width, height):
         ResizeEvent("resize_event", self)._process()
         self.draw_idle()
 
+    def start_event_loop(self, timeout=0):
+        # docstring inherited
+        with _maybe_allow_interrupt():
+            # Call the objc implementation of the event loop after
+            # setting up the interrupt handling
+            self._start_event_loop(timeout=timeout)
+
 
 class NavigationToolbar2Mac(_macosx.NavigationToolbar2, NavigationToolbar2):
 
@@ -171,34 +179,8 @@ def start_main_loop(cls):
         # Set up a SIGINT handler to allow terminating a plot via CTRL-C.
         # The logic is largely copied from qt_compat._maybe_allow_interrupt; see its
         # docstring for details.  Parts are implemented by wake_on_fd_write in ObjC.
-
-        old_sigint_handler = signal.getsignal(signal.SIGINT)
-        if old_sigint_handler in (None, signal.SIG_IGN, signal.SIG_DFL):
-            _macosx.show()
-            return
-
-        handler_args = None
-        wsock, rsock = socket.socketpair()
-        wsock.setblocking(False)
-        rsock.setblocking(False)
-        old_wakeup_fd = signal.set_wakeup_fd(wsock.fileno())
-        _macosx.wake_on_fd_write(rsock.fileno())
-
-        def handle(*args):
-            nonlocal handler_args
-            handler_args = args
-            _macosx.stop()
-
-        signal.signal(signal.SIGINT, handle)
-        try:
+        with _maybe_allow_interrupt():
             _macosx.show()
-        finally:
-            wsock.close()
-            rsock.close()
-            signal.set_wakeup_fd(old_wakeup_fd)
-            signal.signal(signal.SIGINT, old_sigint_handler)
-            if handler_args is not None:
-                old_sigint_handler(*handler_args)
 
     def show(self):
         if not self._shown:
@@ -208,6 +190,45 @@ def show(self):
             self._raise()
 
 
+@contextlib.contextmanager
+def _maybe_allow_interrupt():
+    """
+    This manager allows to terminate a plot by sending a SIGINT. It is
+    necessary because the running backend prevents Python interpreter to
+    run and process signals (i.e., to raise KeyboardInterrupt exception). To
+    solve this one needs to somehow wake up the interpreter and make it close
+    the plot window. The implementation is taken from qt_compat, see that
+    docstring for a more detailed description.
+    """
+    old_sigint_handler = signal.getsignal(signal.SIGINT)
+    if old_sigint_handler in (None, signal.SIG_IGN, signal.SIG_DFL):
+        yield
+        return
+
+    handler_args = None
+    wsock, rsock = socket.socketpair()
+    wsock.setblocking(False)
+    rsock.setblocking(False)
+    old_wakeup_fd = signal.set_wakeup_fd(wsock.fileno())
+    _macosx.wake_on_fd_write(rsock.fileno())
+
+    def handle(*args):
+        nonlocal handler_args
+        handler_args = args
+        _macosx.stop()
+
+    signal.signal(signal.SIGINT, handle)
+    try:
+        yield
+    finally:
+        wsock.close()
+        rsock.close()
+        signal.set_wakeup_fd(old_wakeup_fd)
+        signal.signal(signal.SIGINT, old_sigint_handler)
+        if handler_args is not None:
+            old_sigint_handler(*handler_args)
+
+
 @_Backend.export
 class _BackendMac(_Backend):
     FigureCanvas = FigureCanvasMac
diff --git a/src/_macosx.m b/src/_macosx.m
index e9677a40e6b5..6df00d0eca8e 100755
--- a/src/_macosx.m
+++ b/src/_macosx.m
@@ -451,7 +451,7 @@ int mpl_check_modifier(
 }
 
 static PyObject*
-FigureCanvas_start_event_loop(FigureCanvas* self, PyObject* args, PyObject* keywords)
+FigureCanvas__start_event_loop(FigureCanvas* self, PyObject* args, PyObject* keywords)
 {
     float timeout = 0.0;
 
@@ -522,8 +522,8 @@ int mpl_check_modifier(
          (PyCFunction)FigureCanvas_remove_rubberband,
          METH_NOARGS,
          "Remove the current rubberband rectangle."},
-        {"start_event_loop",
-         (PyCFunction)FigureCanvas_start_event_loop,
+        {"_start_event_loop",
+         (PyCFunction)FigureCanvas__start_event_loop,
          METH_KEYWORDS | METH_VARARGS,
          NULL},  // docstring inherited
         {"stop_event_loop",

From b6d26414a75ba6ed912625c489cfd94f13cb22e3 Mon Sep 17 00:00:00 2001
From: Eva Sibinga <46283995+esibinga@users.noreply.github.com>
Date: Sun, 29 Oct 2023 18:00:44 -0400
Subject: [PATCH 0378/1120] Apply suggestions from code review
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Melissa Weber Mendonça <melissawm@gmail.com>
---
 galleries/examples/tag_glossary.rst   | 12 ++++++++----
 galleries/examples/tag_guidelines.rst | 23 +++++++++++++++--------
 2 files changed, 23 insertions(+), 12 deletions(-)

diff --git a/galleries/examples/tag_glossary.rst b/galleries/examples/tag_glossary.rst
index 8aa7ebb18c60..2bb2057d003f 100644
--- a/galleries/examples/tag_glossary.rst
+++ b/galleries/examples/tag_glossary.rst
@@ -9,7 +9,8 @@ III. Domain tags: what discipline(s) might seek this example consistently?
 IV. Internal tags: what information is helpful for maintainers or contributors?
 
 
-*1. API tags: what content from the API reference is in the example?*
+1. API tags: what content from the API reference is in the example?
+-------------------------------------------------------------------
 
 +-----------------------------------+---------------------------------------------+
 |``tag``                            | use case - if not obvious                   |
@@ -113,7 +114,8 @@ IV. Internal tags: what information is helpful for maintainers or contributors?
 +-----------------------------------+---------------------------------------------+
 
 
-*2. Structural tags: what format is the example? What context can we provide?*
+2. Structural tags: what format is the example? What context can we provide?
+----------------------------------------------------------------------------
 
 +----------------------------+-------------------------------------------------------------------+
 |``tag``                     | use case                                                          |
@@ -137,7 +139,8 @@ IV. Internal tags: what information is helpful for maintainers or contributors?
 |``purpose: fun``            |just for fun!                                                      |
 +----------------------------+-------------------------------------------------------------------+
 
-*3. Domain tags: what discipline(s) might seek this example consistently?*
+3. Domain tags: what discipline(s) might seek this example consistently?
+------------------------------------------------------------------------
 
 Note: it's futile to draw fences around "who owns what", and that's not the point of domain tags. Domain tags help groups of people to privately organize relevant information, and so are not displayed publicly. See below for a list of existing domain tags. If you don't see the one you're looking for and you think it should exist, consider proposing it.
 
@@ -157,7 +160,8 @@ Note: it's futile to draw fences around "who owns what", and that's not the poin
 |``domain: signal-processing``  |                                        |
 +-------------------------------+----------------------------------------+
 
-*4. Internal tags: what information is helpful for maintainers or contributors?*
+4. Internal tags: what information is helpful for maintainers or contributors?
+------------------------------------------------------------------------------
 
 +-------------------------------+-----------------------------------------------------------------------+
 |``tag``                        | use case                                                              |
diff --git a/galleries/examples/tag_guidelines.rst b/galleries/examples/tag_guidelines.rst
index 1128699513eb..d6061fc16647 100644
--- a/galleries/examples/tag_guidelines.rst
+++ b/galleries/examples/tag_guidelines.rst
@@ -1,7 +1,8 @@
 Guidelines for assigning tags to gallery examples
 =================================================
 
-*Why do we need tags?*
+Why do we need tags?
+--------------------
 
 Tags serve multiple purposes.
 
@@ -11,7 +12,8 @@ They allow for better discoverability, search, and browse functions. They are he
 
 Hidden tags provide additional functionality for maintainers and contributors.
 
-*What gets a tag?*
+What gets a tag?
+----------------
 
 Every gallery example should be tagged with:
 
@@ -24,14 +26,15 @@ Tags can repeat existing forms of organization (e.g. an example is in the Animat
 
 Tags are helpful to denote particularly good "byproduct" examples. E.g. the explicit purpose of a gallery example might be to demonstrate a colormap, but it's also a good demonstration of a legend. Tag ``legend`` to indicate that, rather than changing the title or the scope of the example.
 
-*Tag Categories* - See :doc:`Tag Glossary <tag_glossary>` for a complete list of tags.
+**Tag Categories** - See :doc:`Tag Glossary <tag_glossary>` for a complete list of tags.
 
 I. API tags: what content from the API reference is in the example?
 II. Structural tags: what format is the example? What context can we provide?
 III. Domain tags: what discipline(s) might seek this example consistently?
 IV. Internal tags: what information is helpful for maintainers or contributors?
 
-*Proposing new tags*
+Proposing new tags
+------------------
 
 1. Review existing tag list, looking out for similar entries (i.e. ``axes`` and ``axis``).
 2. If a relevant tag or subcategory does not yet exist, propose it. Each tag is two parts: ``subcategory: tag``. Tags should be one or two words.
@@ -40,12 +43,15 @@ IV. Internal tags: what information is helpful for maintainers or contributors?
 
 Note: Tagging organization aims to work for 80-90% of cases. Some examples fall outside of the tagging structure. Niche or specific examples shouldn't be given standalone tags that won't apply to other examples.
 
-*How to tag?*
+How to tag?
+-----------
  where you put the directive is where the tag will show
 
-**Related content**
+Related content
+---------------
 
-*What is a gallery example?*
+What is a gallery example?
+^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The gallery of examples contains visual demonstrations of matplolib features. Gallery examples exist so that users can scan through visual examples.
 
@@ -53,7 +59,8 @@ Unlike tutorials or user guides, gallery examples teach by demonstration, rather
 
 Gallery examples should avoid instruction or excessive explanation except for brief clarifying code comments. Instead, they can tag related concepts and/or link to relevant tutorials or user guides.
 
-Format:
+Format
+^^^^^^
 
 All gallery examples should aim to follow the following format:
 

From ed45c85bba7dd3d7e92ea366d67e0eb05667baa0 Mon Sep 17 00:00:00 2001
From: Eva Sibinga <46283995+esibinga@users.noreply.github.com>
Date: Sun, 29 Oct 2023 19:04:07 -0400
Subject: [PATCH 0379/1120] Apply suggestions from code review

Co-authored-by: hannah <story645@gmail.com>
---
 galleries/examples/tag_guidelines.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/galleries/examples/tag_guidelines.rst b/galleries/examples/tag_guidelines.rst
index d6061fc16647..b0514e65e30d 100644
--- a/galleries/examples/tag_guidelines.rst
+++ b/galleries/examples/tag_guidelines.rst
@@ -8,7 +8,7 @@ Tags serve multiple purposes.
 
 Tags have a one-to-many organization (i.e. one example can have several tags), while the gallery structure requires that examples are placed in only one location. This means tags provide a secondary layer of organization and make the gallery of examples more flexible and more user-friendly.
 
-They allow for better discoverability, search, and browse functions. They are helpful for users struggling to write a search query for what they're looking for.
+They allow for better discoverability, search, and browse functionality. They are helpful for users struggling to write a search query for what they're looking for.
 
 Hidden tags provide additional functionality for maintainers and contributors.
 

From 71f25f49856b86700c423fae500f274998357837 Mon Sep 17 00:00:00 2001
From: esibinga <vegheadeva@gmail.com>
Date: Sun, 29 Oct 2023 21:20:45 -0400
Subject: [PATCH 0380/1120] move docs back to devel, updates from review

---
 {galleries/examples => doc/devel}/tag_glossary.rst   |  2 ++
 {galleries/examples => doc/devel}/tag_guidelines.rst | 12 +++++-------
 2 files changed, 7 insertions(+), 7 deletions(-)
 rename {galleries/examples => doc/devel}/tag_glossary.rst (98%)
 rename {galleries/examples => doc/devel}/tag_guidelines.rst (86%)

diff --git a/galleries/examples/tag_glossary.rst b/doc/devel/tag_glossary.rst
similarity index 98%
rename from galleries/examples/tag_glossary.rst
rename to doc/devel/tag_glossary.rst
index 2bb2057d003f..e73a557a850a 100644
--- a/galleries/examples/tag_glossary.rst
+++ b/doc/devel/tag_glossary.rst
@@ -38,6 +38,8 @@ IV. Internal tags: what information is helpful for maintainers or contributors?
 |``styling: conditional``           |styling is determined programmatically by a  |
 |                                   |condition being met                          |
 +-----------------------------------+---------------------------------------------+
+|``styling: showcase``              |good showcase example                        |
++-----------------------------------+---------------------------------------------+
 |                                   |                                             |
 +-----------------------------------+---------------------------------------------+
 |**Primary or relevant plot component**                                           |
diff --git a/galleries/examples/tag_guidelines.rst b/doc/devel/tag_guidelines.rst
similarity index 86%
rename from galleries/examples/tag_guidelines.rst
rename to doc/devel/tag_guidelines.rst
index b0514e65e30d..ca6b8cfde01d 100644
--- a/galleries/examples/tag_guidelines.rst
+++ b/doc/devel/tag_guidelines.rst
@@ -20,8 +20,6 @@ Every gallery example should be tagged with:
 * 1+ content tags
 * structural, domain, or internal tag(s) if helpful
 
-Examples with many tags may indicate that the entry is a showcase example.
-
 Tags can repeat existing forms of organization (e.g. an example is in the Animation folder and also gets an ``animation`` tag).
 
 Tags are helpful to denote particularly good "byproduct" examples. E.g. the explicit purpose of a gallery example might be to demonstrate a colormap, but it's also a good demonstration of a legend. Tag ``legend`` to indicate that, rather than changing the title or the scope of the example.
@@ -45,7 +43,7 @@ Note: Tagging organization aims to work for 80-90% of cases. Some examples fall
 
 How to tag?
 -----------
- where you put the directive is where the tag will show
+Put each tag as a directive at the bottom of the page.
 
 Related content
 ---------------
@@ -53,7 +51,7 @@ Related content
 What is a gallery example?
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-The gallery of examples contains visual demonstrations of matplolib features. Gallery examples exist so that users can scan through visual examples.
+The gallery of examples contains visual demonstrations of matplotlib features. Gallery examples exist so that users can scan through visual examples.
 
 Unlike tutorials or user guides, gallery examples teach by demonstration, rather than by explanation or instruction.
 
@@ -62,7 +60,7 @@ Gallery examples should avoid instruction or excessive explanation except for br
 Format
 ^^^^^^
 
-All gallery examples should aim to follow the following format:
+All :ref:`examples-index` should aim to follow the following format:
 
 * Title: 1-6 words, descriptive of content
 * Subtitle: 10-50 words, action-oriented description of the example subject
@@ -71,7 +69,7 @@ All gallery examples should aim to follow the following format:
 
 Example:
 
-``bbox_intersect`` gallery example showcases the point of visual examples
+The ``bbox_intersect`` gallery example demonstrates the point of visual examples:
 
-* messy example/ hard to categorize, but the gallery is definitely the right spot for it because it's the kind of thing you'd find by visual search
+* this example is "messy" in that it's hard to categorize, but the gallery is the right spot for it because it makes sense to find it by visual search
 * https://matplotlib.org/devdocs/gallery/misc/bbox_intersect.html#sphx-glr-gallery-misc-bbox-intersect-py

From 00ba10d8f157e7ee7908e530dfa2500c8c30b58e Mon Sep 17 00:00:00 2001
From: Eva Sibinga <46283995+esibinga@users.noreply.github.com>
Date: Mon, 30 Oct 2023 11:10:43 -0400
Subject: [PATCH 0381/1120] Apply suggestions from code review
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Melissa Weber Mendonça <melissawm@gmail.com>
---
 doc/devel/index.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/devel/index.rst b/doc/devel/index.rst
index 75088bce774a..1d91aa2790b5 100644
--- a/doc/devel/index.rst
+++ b/doc/devel/index.rst
@@ -146,7 +146,7 @@ Policies and guidelines
 
          document
          style_guide
-         ../gallery/tag_guidelines
+         tag_guidelines
 
    .. grid-item-card::
       :shadow: none

From 87261c1934974e5e4527a8dbd0971aaa1fd48b97 Mon Sep 17 00:00:00 2001
From: esibinga <vegheadeva@gmail.com>
Date: Mon, 30 Oct 2023 14:19:33 -0400
Subject: [PATCH 0382/1120] clarify component and styling

---
 doc/devel/tag_glossary.rst | 58 ++++++++++++++++++--------------------
 1 file changed, 28 insertions(+), 30 deletions(-)

diff --git a/doc/devel/tag_glossary.rst b/doc/devel/tag_glossary.rst
index e73a557a850a..8f775879aa75 100644
--- a/doc/devel/tag_glossary.rst
+++ b/doc/devel/tag_glossary.rst
@@ -15,38 +15,9 @@ IV. Internal tags: what information is helpful for maintainers or contributors?
 +-----------------------------------+---------------------------------------------+
 |``tag``                            | use case - if not obvious                   |
 +===================================+=============================================+
-|**Styling**                                                                      |
-+-----------------------------------+---------------------------------------------+
-|``styling: color``                 |                                             |
-+-----------------------------------+---------------------------------------------+
-|``styling: shape``                 |                                             |
-+-----------------------------------+---------------------------------------------+
-|``styling: size``                  |                                             |
-+-----------------------------------+---------------------------------------------+
-|``styling: position``              |                                             |
-+-----------------------------------+---------------------------------------------+
-|``styling: texture``               |                                             |
-+-----------------------------------+---------------------------------------------+
-|``styling: colormap``              |                                             |
-+-----------------------------------+---------------------------------------------+
-|``styling: colorbar``              |                                             |
-+-----------------------------------+---------------------------------------------+
-|``styling: linestyle``             |                                             |
-+-----------------------------------+---------------------------------------------+
-|``styling: small-multiples``       |                                             |
-+-----------------------------------+---------------------------------------------+
-|``styling: conditional``           |styling is determined programmatically by a  |
-|                                   |condition being met                          |
-+-----------------------------------+---------------------------------------------+
-|``styling: showcase``              |good showcase example                        |
-+-----------------------------------+---------------------------------------------+
-|                                   |                                             |
-+-----------------------------------+---------------------------------------------+
 |**Primary or relevant plot component**                                           |
 +-----------------------------------+---------------------------------------------+
-|Use these tags when plot contains a teachable example                            |
-+-----------------------------------+---------------------------------------------+
-|``component: axes``                |                                             |
+|``component: axes``                |remarkable or very clear use of component    |
 +-----------------------------------+---------------------------------------------+
 |``component: axis``                |                                             |
 +-----------------------------------+---------------------------------------------+
@@ -76,6 +47,33 @@ IV. Internal tags: what information is helpful for maintainers or contributors?
 +-----------------------------------+---------------------------------------------+
 |                                   |                                             |
 +-----------------------------------+---------------------------------------------+
+|**Styling**                                                                      |
++-----------------------------------+---------------------------------------------+
+|Use these tags when plot contains a teachable example                            |
++-----------------------------------+---------------------------------------------+
+|``styling: color``                 |                                             |
++-----------------------------------+---------------------------------------------+
+|``styling: shape``                 |                                             |
++-----------------------------------+---------------------------------------------+
+|``styling: size``                  |                                             |
++-----------------------------------+---------------------------------------------+
+|``styling: position``              |                                             |
++-----------------------------------+---------------------------------------------+
+|``styling: texture``               |                                             |
++-----------------------------------+---------------------------------------------+
+|``styling: colormap``              |                                             |
++-----------------------------------+---------------------------------------------+
+|``styling: linestyle``             |                                             |
++-----------------------------------+---------------------------------------------+
+|``styling: small-multiples``       |                                             |
++-----------------------------------+---------------------------------------------+
+|``styling: conditional``           |styling is determined programmatically by a  |
+|                                   |condition being met                          |
++-----------------------------------+---------------------------------------------+
+|``styling: showcase``              |good showcase example                        |
++-----------------------------------+---------------------------------------------+
+|                                   |                                             |
++-----------------------------------+---------------------------------------------+
 |**Interactivity**                                                                |
 +-----------------------------------+---------------------------------------------+
 |``interactivity: event handling``  |                                             |

From 20a51b670e6e13c2f944f698632709d950f9a52a Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Mon, 30 Oct 2023 12:53:14 -0400
Subject: [PATCH 0383/1120] link out to troubleshooting guide in install

---
 doc/devel/development_setup.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/doc/devel/development_setup.rst b/doc/devel/development_setup.rst
index 944a91b456f7..5827fe929d61 100644
--- a/doc/devel/development_setup.rst
+++ b/doc/devel/development_setup.rst
@@ -173,6 +173,11 @@ When working on a branch that does not have Meson enabled, meaning it does not
 have :ghpull:`26621` in its history (log), you will have to reinstall from source
 each time you change any compiled extension code.
 
+If the installation is not working, please consult the :ref:`troubleshooting guide <troubleshooting-faq>`.
+If the guide does not offer a solution, please reach out via `chat <https://gitter.im/matplotlib/matplotlib>`_
+or :ref:`open an issue <submitting-a-bug-report>`.
+
+
 Build options
 -------------
 If you are working heavily with files that need to be compiled, you may want to

From c45922bad4ecac90a302659c2fd15aa511ac5b47 Mon Sep 17 00:00:00 2001
From: esibinga <vegheadeva@gmail.com>
Date: Mon, 30 Oct 2023 16:44:53 -0400
Subject: [PATCH 0384/1120] updates from review

---
 doc/devel/tag_glossary.rst | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/doc/devel/tag_glossary.rst b/doc/devel/tag_glossary.rst
index 8f775879aa75..61765d5b7826 100644
--- a/doc/devel/tag_glossary.rst
+++ b/doc/devel/tag_glossary.rst
@@ -9,8 +9,8 @@ III. Domain tags: what discipline(s) might seek this example consistently?
 IV. Internal tags: what information is helpful for maintainers or contributors?
 
 
-1. API tags: what content from the API reference is in the example?
--------------------------------------------------------------------
+API tags: what content from the API reference is in the example?
+----------------------------------------------------------------
 
 +-----------------------------------+---------------------------------------------+
 |``tag``                            | use case - if not obvious                   |
@@ -70,8 +70,6 @@ IV. Internal tags: what information is helpful for maintainers or contributors?
 |``styling: conditional``           |styling is determined programmatically by a  |
 |                                   |condition being met                          |
 +-----------------------------------+---------------------------------------------+
-|``styling: showcase``              |good showcase example                        |
-+-----------------------------------+---------------------------------------------+
 |                                   |                                             |
 +-----------------------------------+---------------------------------------------+
 |**Interactivity**                                                                |
@@ -114,8 +112,8 @@ IV. Internal tags: what information is helpful for maintainers or contributors?
 +-----------------------------------+---------------------------------------------+
 
 
-2. Structural tags: what format is the example? What context can we provide?
-----------------------------------------------------------------------------
+Structural tags: what format is the example? What context can we provide?
+-------------------------------------------------------------------------
 
 +----------------------------+-------------------------------------------------------------------+
 |``tag``                     | use case                                                          |
@@ -138,11 +136,13 @@ IV. Internal tags: what information is helpful for maintainers or contributors?
 +----------------------------+-------------------------------------------------------------------+
 |``purpose: fun``            |just for fun!                                                      |
 +----------------------------+-------------------------------------------------------------------+
+|``styling: showcase``       |good showcase example                                              |
++----------------------------+-------------------------------------------------------------------+
 
-3. Domain tags: what discipline(s) might seek this example consistently?
-------------------------------------------------------------------------
+Domain tags: what discipline(s) might seek this example consistently?
+---------------------------------------------------------------------
 
-Note: it's futile to draw fences around "who owns what", and that's not the point of domain tags. Domain tags help groups of people to privately organize relevant information, and so are not displayed publicly. See below for a list of existing domain tags. If you don't see the one you're looking for and you think it should exist, consider proposing it.
+It's futile to draw fences around "who owns what", and that's not the point of domain tags. Domain tags help groups of people to privately organize relevant information, and so are not displayed publicly. See below for a list of existing domain tags. If you don't see the one you're looking for and you think it should exist, consider proposing it.
 
 +-------------------------------+----------------------------------------+
 |``tag``                        | use case                               |
@@ -160,8 +160,8 @@ Note: it's futile to draw fences around "who owns what", and that's not the poin
 |``domain: signal-processing``  |                                        |
 +-------------------------------+----------------------------------------+
 
-4. Internal tags: what information is helpful for maintainers or contributors?
-------------------------------------------------------------------------------
+Internal tags: what information is helpful for maintainers or contributors?
+---------------------------------------------------------------------------
 
 +-------------------------------+-----------------------------------------------------------------------+
 |``tag``                        | use case                                                              |

From 6e3ed38a8a975144789c56562a643ab20b7846e9 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Mon, 30 Oct 2023 21:20:51 +0100
Subject: [PATCH 0385/1120] Query macOS for available system fonts.

... instead of only relying on a fixed list of directories to check.
Note that both previously and with this PR, we continue also querying
fontconfig.
---
 lib/matplotlib/font_manager.py | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/font_manager.py b/lib/matplotlib/font_manager.py
index 68b22ccf7df1..addf808afe15 100644
--- a/lib/matplotlib/font_manager.py
+++ b/lib/matplotlib/font_manager.py
@@ -36,6 +36,7 @@
 from numbers import Number
 import os
 from pathlib import Path
+import plistlib
 import re
 import subprocess
 import sys
@@ -261,6 +262,14 @@ def _get_fontconfig_fonts():
     return [Path(os.fsdecode(fname)) for fname in out.split(b'\n')]
 
 
+@lru_cache
+def _get_macos_fonts():
+    """Cache and list the font paths known to ``system_profiler SPFontsDataType``."""
+    d, = plistlib.loads(
+        subprocess.check_output(["system_profiler", "-xml", "SPFontsDataType"]))
+    return [Path(entry["path"]) for entry in d["_items"]]
+
+
 def findSystemFonts(fontpaths=None, fontext='ttf'):
     """
     Search for fonts in the specified font paths.  If no paths are
@@ -279,6 +288,7 @@ def findSystemFonts(fontpaths=None, fontext='ttf'):
         else:
             installed_fonts = _get_fontconfig_fonts()
             if sys.platform == 'darwin':
+                installed_fonts += _get_macos_fonts()
                 fontpaths = [*X11FontDirectories, *OSXFontDirectories]
             else:
                 fontpaths = X11FontDirectories
@@ -1011,7 +1021,7 @@ class FontManager:
     # Increment this version number whenever the font cache data
     # format or behavior has changed and requires an existing font
     # cache files to be rebuilt.
-    __version__ = 330
+    __version__ = 390
 
     def __init__(self, size=None, weight='normal'):
         self._version = self.__version__

From afa15c4afe1b63736afe263fc750c73cdc042f76 Mon Sep 17 00:00:00 2001
From: Eva Sibinga <46283995+esibinga@users.noreply.github.com>
Date: Mon, 30 Oct 2023 23:23:58 -0400
Subject: [PATCH 0386/1120] Apply suggestions from code review

Co-authored-by: hannah <story645@gmail.com>
---
 doc/devel/tag_glossary.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/devel/tag_glossary.rst b/doc/devel/tag_glossary.rst
index 61765d5b7826..9b70a2a96159 100644
--- a/doc/devel/tag_glossary.rst
+++ b/doc/devel/tag_glossary.rst
@@ -136,7 +136,7 @@ Structural tags: what format is the example? What context can we provide?
 +----------------------------+-------------------------------------------------------------------+
 |``purpose: fun``            |just for fun!                                                      |
 +----------------------------+-------------------------------------------------------------------+
-|``styling: showcase``       |good showcase example                                              |
+|``purpose: showcase``       |good showcase example                                              |
 +----------------------------+-------------------------------------------------------------------+
 
 Domain tags: what discipline(s) might seek this example consistently?

From cd34b80582f00a6e5a8278cd30b4aac5756d8160 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Melissa=20Weber=20Mendon=C3=A7a?= <melissawm@gmail.com>
Date: Tue, 31 Oct 2023 09:43:45 +0000
Subject: [PATCH 0387/1120] Addressing review comments

* Add minimum sphinx-tags version
* Fix trailing whitespace
* Change admonition title
---
 environment.yml                                    | 2 +-
 galleries/examples/README.txt                      | 3 ++-
 galleries/examples/animation/animated_histogram.py | 2 +-
 galleries/examples/animation/multiple_axes.py      | 2 +-
 galleries/examples/event_handling/resample.py      | 2 +-
 requirements/doc/doc-requirements.txt              | 2 +-
 6 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/environment.yml b/environment.yml
index 9b3c2231f4a1..e613743b4439 100644
--- a/environment.yml
+++ b/environment.yml
@@ -39,7 +39,7 @@ dependencies:
   - sphinx-copybutton
   - sphinx-gallery>=0.12
   - sphinx-design
-  - sphinx-tags
+  - sphinx-tags>=0.3.0
   - pip
   - pip:
       - mpl-sphinx-theme
diff --git a/galleries/examples/README.txt b/galleries/examples/README.txt
index 8ffe42358352..31d4beae578d 100644
--- a/galleries/examples/README.txt
+++ b/galleries/examples/README.txt
@@ -16,5 +16,6 @@ You can also find :ref:`external resources <resources-index>` and
 a :ref:`FAQ <faq-index>` in our :ref:`user guide <users-guide-index>`.
 
 
-.. note::
+.. admonition:: Tagging!
+
     You can also browse the example gallery by :ref:`tags <tagoverview>`.
diff --git a/galleries/examples/animation/animated_histogram.py b/galleries/examples/animation/animated_histogram.py
index 24aa1c11474d..a5055f39c4e5 100644
--- a/galleries/examples/animation/animated_histogram.py
+++ b/galleries/examples/animation/animated_histogram.py
@@ -57,4 +57,4 @@ def animate(frame_number):
 plt.show()
 
 # %%
-# .. tags:: plot-type:histogram, animation
+# .. tags:: plot-type: histogram, animation
diff --git a/galleries/examples/animation/multiple_axes.py b/galleries/examples/animation/multiple_axes.py
index 189bf2fc6af2..8772b5b53d4f 100644
--- a/galleries/examples/animation/multiple_axes.py
+++ b/galleries/examples/animation/multiple_axes.py
@@ -81,4 +81,4 @@ def animate(i):
 #    - `matplotlib.patches.ConnectionPatch`
 #    - `matplotlib.animation.FuncAnimation`
 #
-# .. tags:: component:axes, animation
+# .. tags:: component: axes, animation
diff --git a/galleries/examples/event_handling/resample.py b/galleries/examples/event_handling/resample.py
index 66b2a09e85d7..913cac9cdf0c 100644
--- a/galleries/examples/event_handling/resample.py
+++ b/galleries/examples/event_handling/resample.py
@@ -77,4 +77,4 @@ def update(self, ax):
 plt.show()
 
 # %%
-# .. tags:: interactivity:zoom, event-handling
+# .. tags:: interactivity: zoom, event-handling
diff --git a/requirements/doc/doc-requirements.txt b/requirements/doc/doc-requirements.txt
index 89ee5b74ef5b..6b7f7c333787 100644
--- a/requirements/doc/doc-requirements.txt
+++ b/requirements/doc/doc-requirements.txt
@@ -21,4 +21,4 @@ sphinxcontrib-svg2pdfconverter>=1.1.0
 sphinx-gallery>=0.12.0
 sphinx-copybutton
 sphinx-design
-sphinx-tags
+sphinx-tags>=0.3.0

From 8326b514cd953c7b1c5e048303f921c32dea0584 Mon Sep 17 00:00:00 2001
From: esibinga <vegheadeva@gmail.com>
Date: Tue, 31 Oct 2023 09:02:54 -0400
Subject: [PATCH 0388/1120] add template for new tag proposal issues

---
 .github/ISSUE_TEMPLATE/tag_proposal.yml | 26 +++++++++++++++++++++++++
 1 file changed, 26 insertions(+)
 create mode 100644 .github/ISSUE_TEMPLATE/tag_proposal.yml

diff --git a/.github/ISSUE_TEMPLATE/tag_proposal.yml b/.github/ISSUE_TEMPLATE/tag_proposal.yml
new file mode 100644
index 000000000000..1e3bceedf70c
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/tag_proposal.yml
@@ -0,0 +1,26 @@
+name: Tag Proposal
+description: Suggest a new tag or subcategory for the gallery of examples
+title: "[Tag]: "
+labels: [Tag proposal]
+body:
+  - type: markdown
+    attributes:
+      value: |
+         Please search the [tag glossary]() for relevant tags before creating a new tag proposal.
+  - type: textarea
+    id: need
+    attributes:
+      label: Need
+      description: Briefly describe the need this tag will fill. (1-4 sentences)
+      placeholder: |
+        * A tag is needed for examples that share [...]
+        * Existing tags do not work because [...]
+        * Current gallery examples that would use this tag include [...]
+        * Indicate which subcategory this tag falls under, or whether a new subcategory is proposed.
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed solution
+      description: What should the tag be? All tags are in the format `subcategory: tag`

From 914b213b5ce753f02c7e8f5cbf1098547190c67c Mon Sep 17 00:00:00 2001
From: nbarlowATI <nbarlow@turing.ac.uk>
Date: Fri, 20 Oct 2023 16:45:17 +0100
Subject: [PATCH 0389/1120] Individual hatching styles for stackplot, as per
 Issue 27146

---
 doc/users/next_whats_new/stackplot_hatch.rst | 27 ++++++++++++++++++++
 lib/matplotlib/pyplot.py                     |  5 +++-
 lib/matplotlib/stackplot.py                  | 21 +++++++++++++--
 lib/matplotlib/stackplot.pyi                 |  1 +
 lib/matplotlib/tests/test_axes.py            | 21 +++++++++++++++
 5 files changed, 72 insertions(+), 3 deletions(-)
 create mode 100644 doc/users/next_whats_new/stackplot_hatch.rst

diff --git a/doc/users/next_whats_new/stackplot_hatch.rst b/doc/users/next_whats_new/stackplot_hatch.rst
new file mode 100644
index 000000000000..8fd4ca0f81b0
--- /dev/null
+++ b/doc/users/next_whats_new/stackplot_hatch.rst
@@ -0,0 +1,27 @@
+``hatch`` parameter for stackplot
+-------------------------------------------
+
+The `~.Axes.stackplot` *hatch* parameter now accepts a list of strings describing hatching styles that will be applied sequentially to the layers in the stack:
+
+.. plot::
+    :include-source: true
+    :alt: Two charts, identified as ax1 and ax2, showing "stackplots", i.e. one-dimensional distributions of data stacked on top of one another. The first plot, ax1 has cross-hatching on all slices, having been given a single string as the "hatch" argument. The second plot, ax2 has different styles of hatching on each slice - diagonal hatching in opposite directions on the first two slices, cross-hatching on the third slice, and open circles on the fourth.
+
+    import matplotlib.pyplot as plt
+    fig, (ax1, ax2) = plt.subplots(ncols=2, figsize=(10,5))
+
+    cols = 10
+    rows = 4
+    data = (
+    np.reshape(np.arange(0, cols, 1), (1, -1)) ** 2
+    + np.reshape(np.arange(0, rows), (-1, 1))
+    + np.random.random((rows, cols))*5
+    )
+    x = range(data.shape[1])
+    ax1.stackplot(x, data, hatch="x")
+    ax2.stackplot(x, data, hatch=["//","\\","x","o"])
+
+    ax1.set_title("hatch='x'")
+    ax2.set_title("hatch=['//','\\\\','x','o']")
+
+    plt.show()
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 7f4aa12c9ed6..05b0d1b8917b 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -3792,12 +3792,15 @@ def spy(
 
 # Autogenerated by boilerplate.py.  Do not edit as changes will be lost.
 @_copy_docstring_and_deprecators(Axes.stackplot)
-def stackplot(x, *args, labels=(), colors=None, baseline="zero", data=None, **kwargs):
+def stackplot(
+    x, *args, labels=(), colors=None, hatch=None, baseline="zero", data=None, **kwargs
+):
     return gca().stackplot(
         x,
         *args,
         labels=labels,
         colors=colors,
+        hatch=hatch,
         baseline=baseline,
         **({"data": data} if data is not None else {}),
         **kwargs,
diff --git a/lib/matplotlib/stackplot.py b/lib/matplotlib/stackplot.py
index 2629593683e5..4e933f52887d 100644
--- a/lib/matplotlib/stackplot.py
+++ b/lib/matplotlib/stackplot.py
@@ -16,7 +16,7 @@
 
 
 def stackplot(axes, x, *args,
-              labels=(), colors=None, baseline='zero',
+              labels=(), colors=None, hatch=None, baseline='zero',
               **kwargs):
     """
     Draw a stacked area plot.
@@ -55,6 +55,15 @@ def stackplot(axes, x, *args,
 
         If not specified, the colors from the Axes property cycle will be used.
 
+    hatch : list of str, default: None
+        A sequence of hatching styles.  See
+        :doc:`/gallery/shapes_and_collections/hatch_style_reference`.
+        The sequence will be cycled through for filling the
+        stacked areas from bottom to top.
+        It need not be exactly the same length as the number
+        of provided *y*, in which case the styles will repeat from the
+        beginning.
+
     data : indexable object, optional
         DATA_PARAMETER_PLACEHOLDER
 
@@ -76,6 +85,11 @@ def stackplot(axes, x, *args,
     else:
         colors = (axes._get_lines.get_next_color() for _ in y)
 
+    if hatch is None or isinstance(hatch, str):
+        hatch = itertools.cycle([hatch])
+    else:
+        hatch = itertools.cycle(hatch)
+
     # Assume data passed has not been 'stacked', so stack it here.
     # We'll need a float buffer for the upcoming calculations.
     stack = np.cumsum(y, axis=0, dtype=np.promote_types(y.dtype, np.float32))
@@ -113,7 +127,9 @@ def stackplot(axes, x, *args,
 
     # Color between x = 0 and the first array.
     coll = axes.fill_between(x, first_line, stack[0, :],
-                             facecolor=next(colors), label=next(labels, None),
+                             facecolor=next(colors),
+                             hatch=next(hatch),
+                             label=next(labels, None),
                              **kwargs)
     coll.sticky_edges.y[:] = [0]
     r = [coll]
@@ -122,6 +138,7 @@ def stackplot(axes, x, *args,
     for i in range(len(y) - 1):
         r.append(axes.fill_between(x, stack[i, :], stack[i + 1, :],
                                    facecolor=next(colors),
+                                   hatch=next(hatch),
                                    label=next(labels, None),
                                    **kwargs))
     return r
diff --git a/lib/matplotlib/stackplot.pyi b/lib/matplotlib/stackplot.pyi
index 503e282665d6..2981d449b566 100644
--- a/lib/matplotlib/stackplot.pyi
+++ b/lib/matplotlib/stackplot.pyi
@@ -12,6 +12,7 @@ def stackplot(
     *args: ArrayLike,
     labels: Iterable[str] = ...,
     colors: Iterable[ColorType] | None = ...,
+    hatch: Iterable[str] | str | None = ...,
     baseline: Literal["zero", "sym", "wiggle", "weighted_wiggle"] = ...,
     **kwargs
 ) -> list[PolyCollection]: ...
diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index c82c79272d87..799bf5ddd774 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -3084,6 +3084,27 @@ def layers(n, m):
     axs[1, 1].stackplot(range(100), d.T, baseline='weighted_wiggle')
 
 
+@check_figures_equal()
+def test_stackplot_hatching(fig_ref, fig_test):
+    x = np.linspace(0, 10, 10)
+    y1 = 1.0 * x
+    y2 = 2.0 * x + 1
+    y3 = 3.0 * x + 2
+    # stackplot with different hatching styles (issue #27146)
+    ax_test = fig_test.subplots()
+    ax_test.stackplot(x, y1, y2, y3, hatch=["x", "//", "\\\\"], colors=["white"])
+    ax_test.set_xlim((0, 10))
+    ax_test.set_ylim((0, 70))
+    # compare with result from hatching each layer individually
+    stack_baseline = np.zeros(len(x))
+    ax_ref = fig_ref.subplots()
+    ax_ref.fill_between(x, stack_baseline, y1, hatch="x", facecolor="white")
+    ax_ref.fill_between(x, y1, y1+y2, hatch="//", facecolor="white")
+    ax_ref.fill_between(x, y1+y2, y1+y2+y3, hatch="\\\\", facecolor="white")
+    ax_ref.set_xlim((0, 10))
+    ax_ref.set_ylim((0, 70))
+
+
 def _bxp_test_helper(
         stats_kwargs={}, transform_stats=lambda s: s, bxp_kwargs={}):
     np.random.seed(937)

From f4af444aa5721cd2aa7c5f14e1bebd208383efa3 Mon Sep 17 00:00:00 2001
From: CozyFrog <garrett.sward@uconn.edu>
Date: Tue, 31 Oct 2023 13:26:03 -0400
Subject: [PATCH 0390/1120] Add datetime arguments for xmin and xmax

---
 lib/matplotlib/tests/test_datetime.py | 18 ++++++++++++++----
 1 file changed, 14 insertions(+), 4 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 3cac147c002f..184962d12564 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -228,17 +228,27 @@ def test_hlines(self):
                     '2023-07-28',
                     '2023-12-24']
         dates = [datetime.datetime(2023, m*2, 10) for m in range(1, 6)]
+        date_start = [datetime.datetime(2023, 6, d) for d in range(5, 30, 5)]
+        date_end = [datetime.datetime(2023, 7, d) for d in range(5, 30, 5)]
         npDates = [np.datetime64(s) for s in dateStrs]
         axs[0, 0].hlines(y=dates,
                          xmin=[0.1, 0.2, 0.3, 0.4, 0.5],
                          xmax=[0.5, 0.6, 0.7, 0.8, 0.9])
-        axs[0, 1].hlines(y=dates, xmin=0.2, xmax=0.8)
-        axs[0, 2].hlines(dates, xmin=0, xmax=1)
+        axs[0, 1].hlines(dates,
+                         xmin=datetime.datetime(2020, 5, 10),
+                         xmax=datetime.datetime(2020, 5, 31))
+        axs[0, 2].hlines(dates,
+                         xmin=date_start,
+                         xmax=date_end)
         axs[1, 0].hlines(y=npDates,
                          xmin=[0.5, 0.6, 0.7, 0.8, 0.9],
                          xmax=[0.1, 0.2, 0.3, 0.4, 0.5])
-        axs[1, 1].hlines(y=npDates, xmin=0.45, xmax=0.65)
-        axs[1, 2].hlines(npDates, xmin=0, xmax=1)
+        axs[1, 2].hlines(y=npDates,
+                         xmin=date_start,
+                         xmax=date_end)
+        axs[1, 1].hlines(npDates,
+                         xmin=datetime.datetime(2020, 5, 10),
+                         xmax=datetime.datetime(2020, 5, 31))
 
     @pytest.mark.xfail(reason="Test for imshow not written yet")
     @mpl.style.context("default")

From 97213e54ef4365f6703f88cad64d085dbf750547 Mon Sep 17 00:00:00 2001
From: Matthew Morrison <msm8275@rit.edu>
Date: Tue, 31 Oct 2023 15:31:16 -0400
Subject: [PATCH 0391/1120] Suggested changes to commit

---
 galleries/users_explain/figure/figure_intro.rst | 2 +-
 galleries/users_explain/figure/interactive.rst  | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/galleries/users_explain/figure/figure_intro.rst b/galleries/users_explain/figure/figure_intro.rst
index 610885fc21f2..c2a823d815ce 100644
--- a/galleries/users_explain/figure/figure_intro.rst
+++ b/galleries/users_explain/figure/figure_intro.rst
@@ -75,7 +75,7 @@ other than the default "inline" backend, you will likely need to use an ipython
 
 .. note::
 
-   If you only need to use the classic notebook (i.e. `notebook<7`),
+   If you only need to use the classic notebook (i.e. ``notebook<7``),
    you can use:
 
    .. sourcecode:: ipython
diff --git a/galleries/users_explain/figure/interactive.rst b/galleries/users_explain/figure/interactive.rst
index adcabaaca1d0..9a4c4956ed6d 100644
--- a/galleries/users_explain/figure/interactive.rst
+++ b/galleries/users_explain/figure/interactive.rst
@@ -334,7 +334,7 @@ documentation of your GUI toolkit for details.
 .. _jupyter_notebooks_jupyterlab:
 
 Jupyter Notebooks / JupyterLab
-==============================
+------------------------------
 
 To get interactive figures in the 'classic' notebook or Jupyter lab,
 use the `ipympl <https://matplotlib.org/ipympl>`__ backend
@@ -347,7 +347,7 @@ If ``ipympl`` is installed use the magic:
 
 to select and enable it.
 
-If you only need to use the classic notebook (i.e. `notebook<7`), you can use
+If you only need to use the classic notebook (i.e. ``notebook<7``), you can use
 
 .. sourcecode:: ipython
 
@@ -367,7 +367,7 @@ however, nbagg does not work in Jupyter Lab.
    cells.
 
 GUIs + Jupyter
---------------
+^^^^^^^^^^^^^^
 
 You can also use one of the non-``ipympl`` GUI backends in a Jupyter Notebook.
 If you are running your Jupyter kernel locally, the GUI window will spawn on

From f05167c70a60e64fb324ace2c5536eb824252a56 Mon Sep 17 00:00:00 2001
From: Lucia Korpas <22487941+notchia@users.noreply.github.com>
Date: Tue, 31 Oct 2023 16:33:00 -0400
Subject: [PATCH 0392/1120] DOC: Add command to install appropriate
 `requirements.txt` during dev venv setup (#27237)

* clarify that requirements must be installed during venv setup step using same grammar as original doc
---
 doc/devel/development_setup.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/doc/devel/development_setup.rst b/doc/devel/development_setup.rst
index 5827fe929d61..57c063605c47 100644
--- a/doc/devel/development_setup.rst
+++ b/doc/devel/development_setup.rst
@@ -131,9 +131,13 @@ The simplest way to do this is to use either Python's virtual environment
       On some systems, you may need to type ``python3`` instead of ``python``.
       For a discussion of the technical reasons, see `PEP-394 <https://peps.python.org/pep-0394>`_.
 
+      Install the Python dependencies with ::
+
+        pip install -r requirements/dev/dev-requirements.txt
+
    .. tab-item:: conda environment
 
-      Create a new `conda`_ environment with ::
+      Create a new `conda`_ environment and install the Python dependencies with ::
 
         conda env create -f environment.yml
 

From 823d60d0d75dac4cc2f3866a8177d5849f04f0b8 Mon Sep 17 00:00:00 2001
From: Jody Klymak <jklymak@gmail.com>
Date: Thu, 31 Aug 2023 14:57:35 -0700
Subject: [PATCH 0393/1120] DOC: some debug steps for backend issues [ci doc]

---
 doc/users/faq.rst                             |   8 ++
 galleries/users_explain/figure/backends.rst   | 106 ++++++++++++++++--
 .../users_explain/figure/figure_intro.rst     |   6 +-
 .../users_explain/figure/interactive.rst      |   2 +-
 galleries/users_explain/quick_start.py        |   4 +-
 lib/matplotlib/figure.py                      |   2 +-
 6 files changed, 112 insertions(+), 16 deletions(-)

diff --git a/doc/users/faq.rst b/doc/users/faq.rst
index 42747c814f94..1ff21d739108 100644
--- a/doc/users/faq.rst
+++ b/doc/users/faq.rst
@@ -8,6 +8,13 @@
 Frequently Asked Questions
 ==========================
 
+.. _how-do-no-figure:
+
+I don't see a figure window
+---------------------------
+
+Please see :ref:`figures-not-showing`.
+
 .. _how-to-too-many-ticks:
 
 Why do I have so many ticks, and/or why are they out of order?
@@ -301,6 +308,7 @@ you must in that case use a *non-interactive backend* (typically Agg), because
 most GUI backends *require* being run from the main thread as well.
 
 .. _reporting-problems:
+.. _get-help:
 
 Get help
 --------
diff --git a/galleries/users_explain/figure/backends.rst b/galleries/users_explain/figure/backends.rst
index b769fcc12ba2..41345d46d6ff 100644
--- a/galleries/users_explain/figure/backends.rst
+++ b/galleries/users_explain/figure/backends.rst
@@ -11,17 +11,17 @@ Backends
 What is a backend?
 ------------------
 
-A lot of documentation on the website and in the mailing lists refers
-to the "backend" and many new users are confused by this term.
-Matplotlib targets many different use cases and output formats.  Some
-people use Matplotlib interactively from the Python shell and have
-plotting windows pop up when they type commands.  Some people run
-`Jupyter <https://jupyter.org>`_ notebooks and draw inline plots for
-quick data analysis. Others embed Matplotlib into graphical user
-interfaces like PyQt or PyGObject to build rich applications.  Some
-people use Matplotlib in batch scripts to generate postscript images
-from numerical simulations, and still others run web application
-servers to dynamically serve up graphs.
+Backends are used for displaying Matplotlib figures (see :ref:`figure-intro`),
+on the screen, or for writing to files. A lot of documentation on the website
+and in the mailing lists refers to the "backend" and many new users are
+confused by this term. Matplotlib targets many different use cases and output
+formats. Some people use Matplotlib interactively from the Python shell and
+have plotting windows pop up when they type commands. Some people run `Jupyter
+<https://jupyter.org>`_ notebooks and draw inline plots for quick data
+analysis. Others embed Matplotlib into graphical user interfaces like PyQt or
+PyGObject to build rich applications. Some people use Matplotlib in batch
+scripts to generate postscript images from numerical simulations, and still
+others run web application servers to dynamically serve up graphs.
 
 To support all of these use cases, Matplotlib can target different
 outputs, and each of these capabilities is called a backend; the
@@ -248,3 +248,87 @@ backend, use ``module://name.of.the.backend`` as the backend name, e.g.
 ``matplotlib.use('module://name.of.the.backend')``.
 
 Information for backend implementers is available at :ref:`writing_backend_interface`.
+
+.. _figures-not-showing:
+
+Debugging the figure windows not showing
+----------------------------------------
+
+Sometimes things do not work as expected, usually during an install.
+
+If you are using a Notebook or integrated development environment (see :ref:`notebooks-and-ides`),
+please consult their documentation for debugging figures not working in their
+environments.
+
+If you are using one of Matplotlib's graphics backends (see :ref:`standalone-scripts-and-interactive-use`), make sure you know which
+one is being used:
+
+.. code-block:: python3
+
+   import matplotlib
+
+   print(matplotlib.get_backend())
+
+Try a simple plot to see if the GUI opens:
+
+.. code-block:: python3
+
+   import matplotlib
+   import matplotlib.pyplot as plt
+
+   print(matplotlib.get_backend())
+   plt.plot((1, 4, 6))
+   plt.show()
+
+If it does not, you perhaps have an installation problem.  A good step at this
+point is to ensure that your GUI toolkit is installed properly, taking
+Matplotlib out of the testing.  Almost all GUI toolkits have a small test
+program that can be run to test basic functionality.  If this test fails, try re-installing.
+
+QtAgg, QtCairo, Qt5Agg, and Qt5Cairo
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Test ``PyQt5``.
+
+If you have ``PySide`` or ``PyQt6`` installed rather than ``PyQt5``, just change the import
+accordingly:
+
+.. code-block:: bash
+
+   python -c "from PyQt5.QtWidgets import *; app = QApplication([]); win = QMainWindow(); win.show(); app.exec()"
+
+
+TkAgg and TkCairo
+^^^^^^^^^^^^^^^^^
+
+Test ``tkinter``:
+
+.. code-block:: bash
+
+   python3 -c "from tkinter import Tk; Tk().mainloop()"
+
+GTK3Agg, GTK4Agg, GTK3Cairo, GTK4Cairo
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Test ``Gtk``:
+
+.. code-block:: bash
+
+   python3 -c "from gi.repository import Gtk; win = Gtk.Window(); win.connect('destroy', Gtk.main_quit); win.show(); Gtk.main()"
+
+wxAgg and wxCairo
+^^^^^^^^^^^^^^^^^
+
+Test ``wx``:
+
+.. code-block:: python3
+
+   import wx
+
+   app = wx.App(False)  # Create a new app, don't redirect stdout/stderr to a window.
+   frame = wx.Frame(None, wx.ID_ANY, "Hello World") # A Frame is a top-level window.
+   frame.Show(True)     # Show the frame.
+   app.MainLoop()
+
+If the test works for your desired backend but you still cannot get Matplotlib to display a figure, then contact us (see
+:ref:`get-help`).
diff --git a/galleries/users_explain/figure/figure_intro.rst b/galleries/users_explain/figure/figure_intro.rst
index c2a823d815ce..462a3fc848dc 100644
--- a/galleries/users_explain/figure/figure_intro.rst
+++ b/galleries/users_explain/figure/figure_intro.rst
@@ -1,7 +1,7 @@
 
 .. redirect-from:: /users/explain/figure
 
-.. _figure_explanation:
+.. _figure-intro:
 
 +++++++++++++++++++++++
 Introduction to Figures
@@ -36,6 +36,8 @@ We will discuss how to create Figures in more detail below, but first it is
 helpful to understand how to view a Figure.  This varies based on how you are
 using Matplotlib, and what :ref:`Backend <what-is-a-backend>` you are using.
 
+.. _notebooks-and-ides:
+
 Notebooks and IDEs
 ------------------
 
@@ -82,6 +84,8 @@ other than the default "inline" backend, you will likely need to use an ipython
 
    %matplotlib notebook
 
+.. _standalone-scripts-and-interactive-use:
+
 Standalone scripts and interactive use
 --------------------------------------
 
diff --git a/galleries/users_explain/figure/interactive.rst b/galleries/users_explain/figure/interactive.rst
index 9a4c4956ed6d..6fd908fcac7a 100644
--- a/galleries/users_explain/figure/interactive.rst
+++ b/galleries/users_explain/figure/interactive.rst
@@ -15,7 +15,7 @@ mouse-location tools built into the Matplotlib GUI windows are often sufficient,
 you can also use the event system to build customized data exploration tools.
 
 .. seealso::
-    :ref:`figure_explanation`.
+    :ref:`figure-intro`.
 
 
 Matplotlib ships with :ref:`backends <what-is-a-backend>` binding to
diff --git a/galleries/users_explain/quick_start.py b/galleries/users_explain/quick_start.py
index 16d0165ec7a6..eef9d13a016e 100644
--- a/galleries/users_explain/quick_start.py
+++ b/galleries/users_explain/quick_start.py
@@ -38,7 +38,7 @@
 #
 # Note that to get this Figure to display, you may have to call ``plt.show()``,
 # depending on your backend.  For more details of Figures and backends, see
-# :ref:`figure_explanation`.
+# :ref:`figure-intro`.
 #
 # .. _figure_parts:
 #
@@ -71,7 +71,7 @@
 # :ref:`Matplotlib backends <backends>` support zooming and
 # panning on figure windows.
 #
-# For more on Figures, see :ref:`figure_explanation`.
+# For more on Figures, see :ref:`figure-intro`.
 #
 # :class:`~matplotlib.axes.Axes`
 # ------------------------------
diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
index baea9232800f..86a9fdd1387e 100644
--- a/lib/matplotlib/figure.py
+++ b/lib/matplotlib/figure.py
@@ -24,7 +24,7 @@
 Some situations call for directly instantiating a `~.figure.Figure` class,
 usually inside an application of some sort (see :ref:`user_interfaces` for a
 list of examples) .  More information about Figures can be found at
-:ref:`figure_explanation`.
+:ref:`figure-intro`.
 """
 
 from contextlib import ExitStack

From 17557489e6cf3c8a0b9fa42c2d898c38f5761a1b Mon Sep 17 00:00:00 2001
From: dohyun <dohyun@localhost.localdomain>
Date: Tue, 31 Oct 2023 22:06:48 -0400
Subject: [PATCH 0394/1120] formatting, and fixing duplicate section name

---
 .../axes_box_aspect.py                        | 21 ++++++++++---------
 .../angle_annotation.py                       |  6 +++---
 2 files changed, 14 insertions(+), 13 deletions(-)

diff --git a/galleries/examples/subplots_axes_and_figures/axes_box_aspect.py b/galleries/examples/subplots_axes_and_figures/axes_box_aspect.py
index 00fdeff17ceb..8640af0e8c0a 100644
--- a/galleries/examples/subplots_axes_and_figures/axes_box_aspect.py
+++ b/galleries/examples/subplots_axes_and_figures/axes_box_aspect.py
@@ -15,7 +15,7 @@
 
 # %%
 # A square axes, independent of data
-# ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+# ----------------------------------
 #
 # Produce a square axes, no matter what the data limits are.
 
@@ -31,7 +31,7 @@
 
 # %%
 # Shared square axes
-# ^^^^^^^^^^^^^^^^^^
+# ------------------
 #
 # Produce shared subplots that are squared in size.
 #
@@ -47,7 +47,7 @@
 
 # %%
 # Square twin axes
-# ^^^^^^^^^^^^^^^^
+# ----------------
 #
 # Produce a square axes, with a twin axes. The twinned axes takes over the
 # box aspect of the parent.
@@ -67,7 +67,7 @@
 
 # %%
 # Normal plot next to image
-# ^^^^^^^^^^^^^^^^^^^^^^^^^
+# -------------------------
 #
 # When creating an image plot with fixed data aspect and the default
 # ``adjustable="box"`` next to a normal plot, the axes would be unequal in
@@ -90,7 +90,7 @@
 
 # %%
 # Square joint/marginal plot
-# ^^^^^^^^^^^^^^^^^^^^^^^^^^
+# --------------------------
 #
 # It may be desirable to show marginal distributions next to a plot of joint
 # data. The following creates a square plot with the box aspect of the
@@ -115,12 +115,13 @@
 plt.show()
 
 # %%
-# Square joint/marginal plot
-# ^^^^^^^^^^^^^^^^^^^^^^^^^^
+# Set data aspect with box aspect
+# -------------------------------
 #
 # When setting the box aspect, one may still set the data aspect as well.
-# Here we create an Axes with a box twice as long as tall and use an "equal"
-# data aspect for its contents, i.e. the circle actually stays circular.
+# Here we create an Axes with a box twice as long as it is tall and use 
+# an "equal" data aspect for its contents, i.e. the circle actually 
+# stays circular.
 
 fig6, ax = plt.subplots()
 
@@ -133,7 +134,7 @@
 
 # %%
 # Box aspect for many subplots
-# ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+# ----------------------------
 #
 # It is possible to pass the box aspect to an Axes at initialization. The
 # following creates a 2 by 3 subplot grid with all square Axes.
diff --git a/galleries/examples/text_labels_and_annotations/angle_annotation.py b/galleries/examples/text_labels_and_annotations/angle_annotation.py
index fa46d8674443..178f54863477 100644
--- a/galleries/examples/text_labels_and_annotations/angle_annotation.py
+++ b/galleries/examples/text_labels_and_annotations/angle_annotation.py
@@ -30,7 +30,7 @@
 
 # %%
 # AngleAnnotation class
-# ^^^^^^^^^^^^^^^^^^^^^
+# ---------------------
 # The essential idea here is to subclass `~.patches.Arc` and set its transform
 # to the `~.transforms.IdentityTransform`, making the parameters of the arc
 # defined in pixel space.
@@ -215,7 +215,7 @@ def R(a, r, w, h):
 # .. _angle-annotation-usage:
 #
 # Usage
-# ^^^^^
+# -----
 #
 # Required arguments to ``AngleAnnotation`` are the center of the arc, *xy*,
 # and two points, such that the arc spans between the two vectors connecting
@@ -254,7 +254,7 @@ def R(a, r, w, h):
 
 # %%
 # ``AngleLabel`` options
-# ~~~~~~~~~~~~~~~~~~~~~~
+# ----------------------
 #
 # The *textposition* and *unit* keyword arguments may be used to modify the
 # location of the text label, as shown below:

From b964da6e39595d1571d0638804ed109a74d3b4a0 Mon Sep 17 00:00:00 2001
From: dohyun <dohyun@localhost.localdomain>
Date: Tue, 31 Oct 2023 22:09:35 -0400
Subject: [PATCH 0395/1120] removed whitespace

---
 .../examples/subplots_axes_and_figures/axes_box_aspect.py     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/galleries/examples/subplots_axes_and_figures/axes_box_aspect.py b/galleries/examples/subplots_axes_and_figures/axes_box_aspect.py
index 8640af0e8c0a..26974dd49121 100644
--- a/galleries/examples/subplots_axes_and_figures/axes_box_aspect.py
+++ b/galleries/examples/subplots_axes_and_figures/axes_box_aspect.py
@@ -119,8 +119,8 @@
 # -------------------------------
 #
 # When setting the box aspect, one may still set the data aspect as well.
-# Here we create an Axes with a box twice as long as it is tall and use 
-# an "equal" data aspect for its contents, i.e. the circle actually 
+# Here we create an Axes with a box twice as long as it is tall and use
+# an "equal" data aspect for its contents, i.e. the circle actually
 # stays circular.
 
 fig6, ax = plt.subplots()

From 2526e51a41ffb13818ade03cbabb9742bb977113 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Tue, 5 Sep 2023 22:39:43 -0400
Subject: [PATCH 0396/1120] ported communications guide to development guide

---
 doc/devel/communication_guide.rst | 121 ++++++++++++++++++++++++++++++
 doc/devel/index.rst               |   1 +
 2 files changed, 122 insertions(+)
 create mode 100644 doc/devel/communication_guide.rst

diff --git a/doc/devel/communication_guide.rst b/doc/devel/communication_guide.rst
new file mode 100644
index 000000000000..0fc8559fbe62
--- /dev/null
+++ b/doc/devel/communication_guide.rst
@@ -0,0 +1,121 @@
+.. _communications-guidelines:
+
+========================
+Communication guidelines
+========================
+
+These guidelines are applicable when acting as a representative of Matplotlib,
+for example at sprints or when giving official talks or tutorials, and in any
+community venue managed by Matplotlib.
+
+.. _communication-channels:
+
+Official communication channels
+===============================
+The following venues are managed by Matplotlib maintainers and contributors:
+
+* https://github.com/matplotlib/matplotlib
+* https://discourse.matplotlib.org/
+* https://gitter.im/matplotlib/
+* https://github.com/matplotlib/matplotblog
+
+
+Social Media
+------------
+
+* https://twitter.com/matplotlib
+* https://instagram.com/matplotart/
+* https://www.tiktok.com/@matplotart
+
+
+Mailing lists
+----------------
+
+* https://mail.python.org/mailman/listinfo/matplotlib-announce
+* https://mail.python.org/mailman/listinfo/matplotlib-users
+* https://mail.python.org/mailman/listinfo/matplotlib-devel
+
+.. _social-media-coordination:
+
+Social media coordination
+-------------------------
+team mailing list: matplotlib-social@numfocus.org
+public chat room: https://gitter.im/matplotlib/community
+
+Content guidelines
+====================
+Communication on official channels, such as the Matplotlib homepage or on
+Matplotlib social accounts, should conform to the following standards:
+
+- be primarily about Matplotlib, 3rd party packages, and visualizations made with Matplotlib
+- also acceptable topics: Python, Visualization, NumFOCUS libraries
+- no gratuitous disparaging of other visualization libraries and tools; criticism is acceptable so long as it serves a constructive purpose
+- follow visualization communication best practices
+    - don't share non-expert visualizations when it could be harmful
+      - put on meeting agenda when answer isn't clearly to hold off on sharing.
+    - clearly state when the visualization data/conclusions cannot be verified
+      - do not rely on machine translations for sensitive visualizations
+    - example: https://twitter.com/matplotlib/status/1244178154618605568
+- verify sourcing of content (especially on instagram & blog)
+    - Instagram/blog: ensure mpl has right to repost/share content
+    - make sure content is clearly cited
+        - example: a tutorial using someone else’s example clearly cites the original source
+- Limited self/corporate promotion is acceptable, but should be no more than about a quarter of the content of the blog/discourse post.
+- if you think content is borderline, ask on the :ref:`_social-media-coordination` channels before publishing it
+- acceptable image guide:
+    - keep it geared towards science/data visualization, and non-controversial images
+    - must be conform to the guidelines of all sites it may be posed on:
+        - https://help.twitter.com/en/rules-and-policies/twitter-rules
+        - https://help.instagram.com/477434105621119
+
+Accessibility
+-------------
+Images in communications should be as accessible as possible:
+
+- add alt text to images and videos when the platform allows
+    - https://webaim.org/techniques/alttext/
+    - https://medium.com/nightingale/writing-alt-text-for-data-visualization-2a218ef43f81
+- warn on bright, strobing, images & turn off autoplay if possible
+- for images made by the social media team:
+  - make graphic perceivable to people who cannot perceive color well, due to color-blindness or low vision
+  - do not make bright, strobing images
+  - more guidelines at https://webaim.org/techniques/images/
+
+
+
+Social media account information
+================================
+
+Behavior
+--------
+When acting as a representative of the library, keep responses polite, and assume
+user statements are in good faith unless they violate the [Code of Conduct](https://www.python.org/psf/conduct/)
+
+Persona
+-------
+On social media, Matplotlib:
+
+* Is a sentient visualization library, so talks about itself as a we, us, our, and it. Avoids talking about itself in the 3rd person.
+* Is very earnest, eager to please, and aims to be patient & painfully oblivious to snark and sarcasm.
+* Gets over-excited over shiny visualizations - lots of emojis and the like - and encourages folks to share their work.
+* Highlights various parts of the library, especially the more obscure bits and bobbles.
+* Acknowledges that it is a sometimes frustrating tangle of bits & bobbles that can confuse even the folks who work on it & signal boosts their confuzzlment.
+
+Social graph
+------------
+- only follow organizations/projects - mostly NumFocus projects
+    - especially 3rd party packages
+    - should at least be visualization related
+    - sponsors are also acceptable
+- do not follow individual accounts for any reason (even maintainers/project leads/Guido!)
+
+Recurrent social campaigns
+--------------------------
+
+- Release Announcements
+    - Highlight new features & major deprecations
+    - Link to download/install instructions
+    - Ask folks to try it out.
+- signal  boost third party packages
+- GSOC work during GSOC recruiting and work times
+- John Hunter Excellence in Plotting, submission and winners
diff --git a/doc/devel/index.rst b/doc/devel/index.rst
index 2b358595255b..9537859c107a 100644
--- a/doc/devel/index.rst
+++ b/doc/devel/index.rst
@@ -167,6 +167,7 @@ Policies and guidelines
          :maxdepth: 1
 
          release_guide
+         communication_guide
          min_dep_policy
          MEP/index
 

From 22e2fe51eb3f1bc73743357c4c28d6d07335ed4a Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Wed, 6 Sep 2023 00:43:43 -0400
Subject: [PATCH 0397/1120] updated communications guidelines with current
 information

Fix section title formatting
Co-authored-by: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
---
 doc/devel/communication_guide.rst     | 226 ++++++++++++++++++--------
 doc/users/project/code_of_conduct.rst |   2 +-
 2 files changed, 158 insertions(+), 70 deletions(-)

diff --git a/doc/devel/communication_guide.rst b/doc/devel/communication_guide.rst
index 0fc8559fbe62..2b8e9f384037 100644
--- a/doc/devel/communication_guide.rst
+++ b/doc/devel/communication_guide.rst
@@ -8,28 +8,38 @@ These guidelines are applicable when acting as a representative of Matplotlib,
 for example at sprints or when giving official talks or tutorials, and in any
 community venue managed by Matplotlib.
 
+
+
 .. _communication-channels:
 
 Official communication channels
 ===============================
 The following venues are managed by Matplotlib maintainers and contributors:
 
-* https://github.com/matplotlib/matplotlib
-* https://discourse.matplotlib.org/
-* https://gitter.im/matplotlib/
-* https://github.com/matplotlib/matplotblog
+* library and docs: https://github.com/matplotlib/matplotlib
+* forum: https://discourse.matplotlib.org/
+* chat: `https://matrix.to/#/#matplotlib:matrix.org <https://matrix.to/#/#matplotlib:matrix.org>`_
+* blog: https://blog.scientific-python.org/
 
-
-Social Media
+Social media
 ------------
 
+Active social media
+^^^^^^^^^^^^^^^^^^^
+
 * https://twitter.com/matplotlib
 * https://instagram.com/matplotart/
+
+Official accounts
+^^^^^^^^^^^^^^^^^
+* https://bsky.app/profile/matplotlib.bsky.social
+* https://fosstodon.org/@matplotlib
 * https://www.tiktok.com/@matplotart
+* https://www.youtube.com/matplotlib
 
 
 Mailing lists
-----------------
+-------------
 
 * https://mail.python.org/mailman/listinfo/matplotlib-announce
 * https://mail.python.org/mailman/listinfo/matplotlib-users
@@ -39,83 +49,161 @@ Mailing lists
 
 Social media coordination
 -------------------------
-team mailing list: matplotlib-social@numfocus.org
-public chat room: https://gitter.im/matplotlib/community
+* Team mailing list: matplotlib-social@numfocus.org
+* Public chat room: `https://matrix.to/#/#matplotlib_community:gitter.im <https://matrix.to/#/#matplotlib_community:gitter.im>`_
+
+
+Maintenance
+-----------
+
+If you are interested in moderating the chat or forum or accessing the social
+media accounts:
+
+* Matplotlib maintainers should reach out to the `community-manager`_.
+
+* Everyone else should send an email to matplotlib-social-admin@numfocus.org:
+
+  * Introduce yourself - github handle and participation in the community.
+  * Describe the reason for wanting to moderate or contribute to social.
+
 
 Content guidelines
-====================
+==================
+
 Communication on official channels, such as the Matplotlib homepage or on
-Matplotlib social accounts, should conform to the following standards:
-
-- be primarily about Matplotlib, 3rd party packages, and visualizations made with Matplotlib
-- also acceptable topics: Python, Visualization, NumFOCUS libraries
-- no gratuitous disparaging of other visualization libraries and tools; criticism is acceptable so long as it serves a constructive purpose
-- follow visualization communication best practices
-    - don't share non-expert visualizations when it could be harmful
-      - put on meeting agenda when answer isn't clearly to hold off on sharing.
-    - clearly state when the visualization data/conclusions cannot be verified
-      - do not rely on machine translations for sensitive visualizations
-    - example: https://twitter.com/matplotlib/status/1244178154618605568
-- verify sourcing of content (especially on instagram & blog)
-    - Instagram/blog: ensure mpl has right to repost/share content
-    - make sure content is clearly cited
-        - example: a tutorial using someone else’s example clearly cites the original source
-- Limited self/corporate promotion is acceptable, but should be no more than about a quarter of the content of the blog/discourse post.
-- if you think content is borderline, ask on the :ref:`_social-media-coordination` channels before publishing it
-- acceptable image guide:
-    - keep it geared towards science/data visualization, and non-controversial images
-    - must be conform to the guidelines of all sites it may be posed on:
-        - https://help.twitter.com/en/rules-and-policies/twitter-rules
-        - https://help.instagram.com/477434105621119
+Matplotlib social accounts, should conform to the following standards. If you
+are unsure if content that you would like to post or share meets these
+guidelines, ask on the :ref:`social-media-coordination` channels before posting.
+
+General guidelines
+------------------
+
+* Focus on Matplotlib, 3rd party packages, and visualizations made with Matplotlib.
+* These are also acceptable topics:
+
+  * Visualization best practices and libraries.
+  * Projects and initiatives by NumFOCUS and Scientific Python.
+  * How to contribute to open source projects.
+  * Projects, such as scientific papers, that use Matplotlib.
+
+* No gratuitous disparaging of other visualization libraries and tools, but
+  criticism is acceptable so long as it serves a constructive purpose.
+
+* Follow communication best practices:
+
+  * Do not share non-expert visualizations when it could cause harm:
+
+    * e.g. https://twitter.com/matplotlib/status/1244178154618605568
+
+  * Clearly state when the visualization data/conclusions cannot be verified.
+  * Do not rely on machine translations for sensitive visualization.
+
+* Verify sourcing of content (especially on instagram & blog):
+
+  * Instagram/blog: ensure mpl has right to repost/share content
+  * Make sure content is clearly cited:
+
+    * e.g. a tutorial reworking an example must credit the original example
+
+* Limited self/corporate promotion is acceptable.
+
+  * Should be no more than about a quarter of the content.
+
+Visual media guidelines
+-----------------------
+
+Visual media, such as images and videos, must not violate the
+:ref:`code of conduct <code_of_conduct>`, nor any platform's rules.
+Specifically:
+
+* Visual media must conform to the guidelines of all sites it may be posted on:
+
+  * https://help.twitter.com/en/rules-and-policies/twitter-rules
+  * https://help.instagram.com/477434105621119
+
+* Emphasize the visualization techniques demonstrated by the visual media.
+* Clearly state that sharing is not an endorsement of the content.
+
+  * e.g. bitcoin related visualizations
 
 Accessibility
--------------
-Images in communications should be as accessible as possible:
+^^^^^^^^^^^^^
 
-- add alt text to images and videos when the platform allows
-    - https://webaim.org/techniques/alttext/
-    - https://medium.com/nightingale/writing-alt-text-for-data-visualization-2a218ef43f81
-- warn on bright, strobing, images & turn off autoplay if possible
-- for images made by the social media team:
-  - make graphic perceivable to people who cannot perceive color well, due to color-blindness or low vision
-  - do not make bright, strobing images
-  - more guidelines at https://webaim.org/techniques/images/
+Visual media in communications should be made as accessible as possible:
 
+* Add alt text to images and videos when the platform allows:
 
+  * `alt text for data viz <https://medium.com/nightingale/writing-alt-text-for-data-visualization-2a218ef43f81>`_
+  * `general alt text guide <https://webaim.org/techniques/alttext/>`_
 
-Social media account information
-================================
+* Warn on bright, strobing, images & turn off autoplay if possible.
+* For images and videos made by the social media team:
+
+  * Make graphic perceivable to people who cannot perceive color well due to
+    color-blindness, low vision, or any other reason.
+
+  * Do not make bright, strobing images.
+  * More guidelines at https://webaim.org/techniques/images/.
 
-Behavior
---------
-When acting as a representative of the library, keep responses polite, and assume
-user statements are in good faith unless they violate the [Code of Conduct](https://www.python.org/psf/conduct/)
+
+Social media
+============
+
+Please follow these guidelines to maintain a consistent brand identity across
+platforms.
 
 Persona
 -------
 On social media, Matplotlib:
 
-* Is a sentient visualization library, so talks about itself as a we, us, our, and it. Avoids talking about itself in the 3rd person.
-* Is very earnest, eager to please, and aims to be patient & painfully oblivious to snark and sarcasm.
-* Gets over-excited over shiny visualizations - lots of emojis and the like - and encourages folks to share their work.
-* Highlights various parts of the library, especially the more obscure bits and bobbles.
-* Acknowledges that it is a sometimes frustrating tangle of bits & bobbles that can confuse even the folks who work on it & signal boosts their confuzzlment.
+* Acts as a sentient visualization library, so talks about itself as a we, us,
+  our, and it. Avoids talking about itself in the 3rd person. Never uses 1st person.
+* Is very earnest, eager to please, and aims to be patient & painfully oblivious
+  to snark and sarcasm.
+* Gets over-excited over shiny visualizations - lots of emojis and the like -
+  and encourages folks to share their work.
+* Highlights various parts of the library, especially the more obscure bits and
+  bobbles.
+* Acknowledges that it is a sometimes frustrating tangle of bits & bobbles that
+  can confuse even the folks who work on it & signal boosts their confuzzlment.
+
+
+Behavior
+--------
+When acting as a representative of the library, keep responses polite and assume
+user statements are in good faith unless they violate the :ref:`code of conduct <code_of_conduct>`.
 
 Social graph
 ------------
-- only follow organizations/projects - mostly NumFocus projects
-    - especially 3rd party packages
-    - should at least be visualization related
-    - sponsors are also acceptable
-- do not follow individual accounts for any reason (even maintainers/project leads/Guido!)
-
-Recurrent social campaigns
---------------------------
-
-- Release Announcements
-    - Highlight new features & major deprecations
-    - Link to download/install instructions
-    - Ask folks to try it out.
-- signal  boost third party packages
-- GSOC work during GSOC recruiting and work times
-- John Hunter Excellence in Plotting, submission and winners
+
+Only follow **organizations and projects**, do not follow individual accounts for
+any reason, even maintainers/project leads/famous Python people!
+
+Following these types of accounts is encouraged:
+
+* NumFocus and Scientific Python projects
+* 3rd party packages
+* Visualization related projects and organizations
+* Open Source community projects
+* Sponsors
+
+Recurring campaigns
+-------------------
+
+Typically the social media accounts will promote the following:
+
+* Matplotlib releases:
+
+  * Highlight new features & major deprecations
+  * Link to download/install instructions
+  * Ask folks to try it out.
+
+* `third party packages <https://matplotlib.org/mpl-third-party/>`_
+* NumFocus/Scientific Python/open source visualization project releases
+* GSOC/GSOD recruiting and progress
+
+Retired campaigns
+^^^^^^^^^^^^^^^^^
+* John Hunter Excellence in Plotting, submission and winners
+
+.. _community-manager: https://matplotlib.org/governance/people.html#deputy-project-leads
diff --git a/doc/users/project/code_of_conduct.rst b/doc/users/project/code_of_conduct.rst
index 8deda909bd4c..ac8b268a4e30 100644
--- a/doc/users/project/code_of_conduct.rst
+++ b/doc/users/project/code_of_conduct.rst
@@ -1,4 +1,4 @@
-.. code_of_conduct
+.. _code_of_conduct:
 
 ====================================
 Contributor Covenant Code of Conduct

From d6592361ca9f663178ddb3d2f595c05233626314 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Thu, 5 Oct 2023 17:31:11 -0400
Subject: [PATCH 0398/1120] process for changing guidelines

---
 doc/devel/communication_guide.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/doc/devel/communication_guide.rst b/doc/devel/communication_guide.rst
index 2b8e9f384037..e21968a67f68 100644
--- a/doc/devel/communication_guide.rst
+++ b/doc/devel/communication_guide.rst
@@ -206,4 +206,15 @@ Retired campaigns
 ^^^^^^^^^^^^^^^^^
 * John Hunter Excellence in Plotting, submission and winners
 
+
+Changing the guidelines
+=======================
+
+As the person tasked with implementing communications, the `community-manager`_
+should be alerted to proposed changes to the communications guidelines. Similarly,
+specific platform guidelines (e.g. twitter, instagram) should be reviewed by the
+person responsible for that platform, when different from the community manager.
+If there is no consensus, decisions about communications guidelines revert to
+the community manager.
+
 .. _community-manager: https://matplotlib.org/governance/people.html#deputy-project-leads

From b9ebda8353eb9f82986748169dcbbdde091aed95 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Sat, 23 Sep 2023 21:27:43 -0400
Subject: [PATCH 0399/1120] update release guide to use contact info

---
 doc/_static/mpl.css               | 19 +++++++++++++++++++
 doc/devel/communication_guide.rst | 11 +++++++----
 doc/devel/release_guide.rst       | 25 ++++++++++++-------------
 doc/users/release_notes.rst       |  1 +
 4 files changed, 39 insertions(+), 17 deletions(-)

diff --git a/doc/_static/mpl.css b/doc/_static/mpl.css
index 45ecb21d5511..a37fb76a0436 100644
--- a/doc/_static/mpl.css
+++ b/doc/_static/mpl.css
@@ -161,3 +161,22 @@ div.wide-table table th.stub {
     font-style: italic;
     font-size:  large;
   }
+
+
+.checklist {
+    list-style: none;
+    padding: 0;
+    margin: 0;
+}
+.checklist li {
+    margin-left: 24px;
+    padding-left: 23px;
+    margin-right: 6px;
+}
+.checklist li:before {
+    content: "\2610\2001";
+    margin-left: -24px;
+}
+.checklist li p {
+    display: inline;
+}
diff --git a/doc/devel/communication_guide.rst b/doc/devel/communication_guide.rst
index e21968a67f68..b9fa301c0e46 100644
--- a/doc/devel/communication_guide.rst
+++ b/doc/devel/communication_guide.rst
@@ -9,7 +9,6 @@ for example at sprints or when giving official talks or tutorials, and in any
 community venue managed by Matplotlib.
 
 
-
 .. _communication-channels:
 
 Official communication channels
@@ -21,6 +20,8 @@ The following venues are managed by Matplotlib maintainers and contributors:
 * chat: `https://matrix.to/#/#matplotlib:matrix.org <https://matrix.to/#/#matplotlib:matrix.org>`_
 * blog: https://blog.scientific-python.org/
 
+.. _social-media:
+
 Social media
 ------------
 
@@ -38,12 +39,14 @@ Official accounts
 * https://www.youtube.com/matplotlib
 
 
+.. _mailing-lists:
+
 Mailing lists
 -------------
 
-* https://mail.python.org/mailman/listinfo/matplotlib-announce
-* https://mail.python.org/mailman/listinfo/matplotlib-users
-* https://mail.python.org/mailman/listinfo/matplotlib-devel
+* `matplotlib-announce@python.org <https://mail.python.org/mailman/listinfo/matplotlib-announce>`_
+* `matplotlib-users@python.org <https://mail.python.org/mailman/listinfo/matplotlib-users>`_
+* `matplotlib-devel@python.org <https://mail.python.org/mailman/listinfo/matplotlib-devel>`_
 
 .. _social-media-coordination:
 
diff --git a/doc/devel/release_guide.rst b/doc/devel/release_guide.rst
index 2bbe589282a3..4adc4546e879 100644
--- a/doc/devel/release_guide.rst
+++ b/doc/devel/release_guide.rst
@@ -455,22 +455,21 @@ Due to branch protections for the ``main`` branch, this is merged via a standard
 request, though the PR cleanliness status check is expected to fail. The PR should not
 be squashed because the intent is to merge the branch histories.
 
-Announcing
-==========
+Publicize this release
+======================
 
-The final step is to announce the release to the world.  A short
-version of the release notes along with acknowledgments should be sent to
+After the release is published to PyPI and conda, it should be announced
+through our communication channels:
 
-- matplotlib-users@python.org
-- matplotlib-devel@python.org
-- matplotlib-announce@python.org
-
-In addition, announcements should be made on social networks (e.g., Twitter via the
-``@matplotlib`` account, any other via personal accounts).
-
-Add a release announcement to the ``mpl-brochure-site`` "News" section of
-``docs/body.html``, linking to the discourse page for the announcement.
+.. rst-class:: checklist
 
+* Send a short version of the release notes and acknowledgments to all the :ref:`mailing-lists`
+* Post highlights and link to :ref:`What's new <release-notes>` on the
+  active :ref:`social media accounts <social-media>`
+* Add a release announcement to the  "News" section of
+  `matplotlib.org <https://github.com/matplotlib/mpl-brochure-site>`_ by editing
+  ``docs/body.html``. Link to the auto-generated announcement discourse post,
+  which is in `Announcements > matplotlib-announcements <https://discourse.matplotlib.org/c/announce/matplotlib-announce/10>`_.
 
 Conda packages
 ==============
diff --git a/doc/users/release_notes.rst b/doc/users/release_notes.rst
index 7862305af65e..c3cd17ce59ea 100644
--- a/doc/users/release_notes.rst
+++ b/doc/users/release_notes.rst
@@ -1,6 +1,7 @@
 .. redirect-from:: /api/api_changes_old
 .. redirect-from:: /users/whats_new_old
 
+.. _release-notes:
 
 =============
 Release notes

From 0887901f3e95115589d653e24430845df2388872 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Thu, 5 Oct 2023 14:14:10 -0400
Subject: [PATCH 0400/1120] coding guide

---
 doc/devel/coding_guide.rst | 9 ---------
 1 file changed, 9 deletions(-)

diff --git a/doc/devel/coding_guide.rst b/doc/devel/coding_guide.rst
index 49f35e3ad13e..0385d6d388f0 100644
--- a/doc/devel/coding_guide.rst
+++ b/doc/devel/coding_guide.rst
@@ -1,12 +1,3 @@
-.. raw:: html
-
-   <style>
-   .checklist { list-style: none; padding: 0; margin: 0; }
-   .checklist li { margin-left: 24px; padding-left: 23px;  margin-right: 6px; }
-   .checklist li:before { content: "\2610\2001"; margin-left: -24px; }
-   .checklist li p {display: inline; }
-   </style>
-
 .. _pr-guidelines:
 
 ***********************

From d2569a35729e1c7fd123f632c6463183abfab647 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Wed, 1 Nov 2023 13:29:06 +0100
Subject: [PATCH 0401/1120] Clarify semantics of plt.matshow(..., fignum=...).

The semantics of the fignum parameter are rather confusing (in
particular wrt. whether the figure gets resized or not -- it only does
if fignum=(None or a non-existing figure number) (which creates a new
figure), but not if fignum=0 (which also creates a new figure).

It's probably not worth fixing that (if anything we should just point
users to Axes.matshow, which is just fine), but we can still improve the
documentation.
---
 lib/matplotlib/pyplot.py | 17 +++++++----------
 1 file changed, 7 insertions(+), 10 deletions(-)

diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 7f4aa12c9ed6..c8822b97f418 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -2412,18 +2412,15 @@ def matshow(A: ArrayLike, fignum: None | int = None, **kwargs) -> AxesImage:
         The matrix to be displayed.
 
     fignum : None or int
-        If *None*, create a new figure window with automatic numbering.
+        If *None*, create a new, appropriately sized figure window.
 
-        If a nonzero integer, draw into the figure with the given number
-        (create it if it does not exist).
+        If 0, use the current Axes (creating one if there is none, without ever
+        adjusting the figure size).
 
-        If 0, use the current axes (or create one if it does not exist).
-
-        .. note::
-
-           Because of how `.Axes.matshow` tries to set the figure aspect
-           ratio to be the one of the array, strange things may happen if you
-           reuse an existing figure.
+        Otherwise, create a new Axes on the figure with the given number
+        (creating it at the appropriate size if it does not exist, but not
+        adjusting the figure size otherwise).  Note that this will be drawn on
+        top of any preexisting Axes on the figure.
 
     Returns
     -------

From e3abb2e7d64cdcea8a216727a714ec7d8b359087 Mon Sep 17 00:00:00 2001
From: CozyFrog <garrett.sward@uconn.edu>
Date: Wed, 1 Nov 2023 11:26:00 -0400
Subject: [PATCH 0402/1120] Added test for singular float xmin/xmax arguments

---
 lib/matplotlib/tests/test_datetime.py | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 184962d12564..a7d4f18080f4 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -221,7 +221,7 @@ def test_hist2d(self):
     @mpl.style.context("default")
     def test_hlines(self):
         mpl.rcParams["date.converter"] = 'concise'
-        fig, axs = plt.subplots(2, 3, layout='constrained')
+        fig, axs = plt.subplots(2, 4, layout='constrained')
         dateStrs = ['2023-03-08',
                     '2023-04-09',
                     '2023-05-13',
@@ -240,6 +240,9 @@ def test_hlines(self):
         axs[0, 2].hlines(dates,
                          xmin=date_start,
                          xmax=date_end)
+        axs[0, 3].hlines(dates,
+                         xmin=0.45,
+                         xmax=0.65)
         axs[1, 0].hlines(y=npDates,
                          xmin=[0.5, 0.6, 0.7, 0.8, 0.9],
                          xmax=[0.1, 0.2, 0.3, 0.4, 0.5])
@@ -249,6 +252,9 @@ def test_hlines(self):
         axs[1, 1].hlines(npDates,
                          xmin=datetime.datetime(2020, 5, 10),
                          xmax=datetime.datetime(2020, 5, 31))
+        axs[1, 3].hlines(npDates,
+                         xmin=0.45,
+                         xmax=0.65)
 
     @pytest.mark.xfail(reason="Test for imshow not written yet")
     @mpl.style.context("default")

From c9470177c5305509a321c4fd46c6eecdfd68ff51 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Wed, 1 Nov 2023 15:43:16 -0400
Subject: [PATCH 0403/1120] MNT: be more careful in Qt backend that there is
 actually a Figure

in mpl_gui we are being more proactive about breaking circular references when
closing a GUI window so that it is possible for a FigureCanvasQt to be in a
state where the figure attribute is None.

In that case short-circuit return in the UI events.
---
 lib/matplotlib/backends/backend_qt.py | 20 ++++++++++++++------
 1 file changed, 14 insertions(+), 6 deletions(-)

diff --git a/lib/matplotlib/backends/backend_qt.py b/lib/matplotlib/backends/backend_qt.py
index 2aa7874fbdb7..cbc490ef6cd1 100644
--- a/lib/matplotlib/backends/backend_qt.py
+++ b/lib/matplotlib/backends/backend_qt.py
@@ -261,6 +261,8 @@ def enterEvent(self, event):
         # Force querying of the modifiers, as the cached modifier state can
         # have been invalidated while the window was out of focus.
         mods = QtWidgets.QApplication.instance().queryKeyboardModifiers()
+        if self.figure is None:
+            return
         LocationEvent("figure_enter_event", self,
                       *self.mouseEventCoords(event),
                       modifiers=self._mpl_modifiers(mods),
@@ -268,6 +270,8 @@ def enterEvent(self, event):
 
     def leaveEvent(self, event):
         QtWidgets.QApplication.restoreOverrideCursor()
+        if self.figure is None:
+            return
         LocationEvent("figure_leave_event", self,
                       *self.mouseEventCoords(),
                       modifiers=self._mpl_modifiers(),
@@ -275,7 +279,7 @@ def leaveEvent(self, event):
 
     def mousePressEvent(self, event):
         button = self.buttond.get(event.button())
-        if button is not None:
+        if button is not None and self.figure is not None:
             MouseEvent("button_press_event", self,
                        *self.mouseEventCoords(event), button,
                        modifiers=self._mpl_modifiers(),
@@ -283,13 +287,15 @@ def mousePressEvent(self, event):
 
     def mouseDoubleClickEvent(self, event):
         button = self.buttond.get(event.button())
-        if button is not None:
+        if button is not None and self.figure is not None:
             MouseEvent("button_press_event", self,
                        *self.mouseEventCoords(event), button, dblclick=True,
                        modifiers=self._mpl_modifiers(),
                        guiEvent=event)._process()
 
     def mouseMoveEvent(self, event):
+        if self.figure is None:
+            return
         MouseEvent("motion_notify_event", self,
                    *self.mouseEventCoords(event),
                    modifiers=self._mpl_modifiers(),
@@ -297,7 +303,7 @@ def mouseMoveEvent(self, event):
 
     def mouseReleaseEvent(self, event):
         button = self.buttond.get(event.button())
-        if button is not None:
+        if button is not None and self.figure is not None:
             MouseEvent("button_release_event", self,
                        *self.mouseEventCoords(event), button,
                        modifiers=self._mpl_modifiers(),
@@ -311,7 +317,7 @@ def wheelEvent(self, event):
             steps = event.angleDelta().y() / 120
         else:
             steps = event.pixelDelta().y()
-        if steps:
+        if steps and self.figure is not None:
             MouseEvent("scroll_event", self,
                        *self.mouseEventCoords(event), step=steps,
                        modifiers=self._mpl_modifiers(),
@@ -319,14 +325,14 @@ def wheelEvent(self, event):
 
     def keyPressEvent(self, event):
         key = self._get_key(event)
-        if key is not None:
+        if key is not None and self.figure is not None:
             KeyEvent("key_press_event", self,
                      key, *self.mouseEventCoords(),
                      guiEvent=event)._process()
 
     def keyReleaseEvent(self, event):
         key = self._get_key(event)
-        if key is not None:
+        if key is not None and self.figure is not None:
             KeyEvent("key_release_event", self,
                      key, *self.mouseEventCoords(),
                      guiEvent=event)._process()
@@ -334,6 +340,8 @@ def keyReleaseEvent(self, event):
     def resizeEvent(self, event):
         if self._in_resize_event:  # Prevent PyQt6 recursion
             return
+        if self.figure is None:
+            return
         self._in_resize_event = True
         try:
             w = event.size().width() * self.device_pixel_ratio

From 93fa19b409142b1e8d84e6d00e097cb5a951e7a1 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 2 Nov 2023 04:52:17 -0400
Subject: [PATCH 0404/1120] webagg: Don't resize canvas if WebSocket isn't
 connected

- If it is still connecting, then we will get an initial resize from
  Python once it connects.
- If it has disconnected, then resizing will clear the canvas and never
  get anything back to refill it, so better to not resize and keep
  something visible.
---
 lib/matplotlib/backends/web_backend/js/mpl.js | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/backends/web_backend/js/mpl.js b/lib/matplotlib/backends/web_backend/js/mpl.js
index 140f5903852e..6e8ec449d92b 100644
--- a/lib/matplotlib/backends/web_backend/js/mpl.js
+++ b/lib/matplotlib/backends/web_backend/js/mpl.js
@@ -192,6 +192,15 @@ mpl.figure.prototype._init_canvas = function () {
     }
 
     this.resizeObserverInstance = new this.ResizeObserver(function (entries) {
+        // There's no need to resize if the WebSocket is not connected:
+        // - If it is still connecting, then we will get an initial resize from
+        //   Python once it connects.
+        // - If it has disconnected, then resizing will clear the canvas and
+        //   never get anything back to refill it, so better to not resize and
+        //   keep something visible.
+        if (fig.ws.readyState != 1) {
+            return;
+        }
         var nentries = entries.length;
         for (var i = 0; i < nentries; i++) {
             var entry = entries[i];
@@ -239,7 +248,7 @@ mpl.figure.prototype._init_canvas = function () {
             // And update the size in Python. We ignore the initial 0/0 size
             // that occurs as the element is placed into the DOM, which should
             // otherwise not happen due to the minimum size styling.
-            if (fig.ws.readyState == 1 && width != 0 && height != 0) {
+            if (width != 0 && height != 0) {
                 fig.request_resize(width, height);
             }
         }

From 1a83a434557ecfb1ff722a9bfebd034c798d9762 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Thu, 2 Nov 2023 11:58:26 +0100
Subject: [PATCH 0405/1120] Remove redundant axes_grid colorbar examples.

simple_colorbar is basically a shorter version of
demo_colorbar_with_axes_divider with no text explanation (and a really
confusing title -- we don't actually want most users to even look at
that example), so just delete it (with a redirection).

demo_colorbar_with_inset_axes is a version of
demo_colorbar_with_inset_locator, but specialized for adding a colorbar
to an inset axes.  That's a rather specialized case and anyways it works
"as is" without doing anything special -- it's just saying that you can
combine two relatively orthogonal features and they are happy together.
So just delete it (with a redirection).
---
 .../axes_grid1/demo_colorbar_of_inset_axes.py | 33 -------------------
 .../demo_colorbar_with_axes_divider.py        |  2 ++
 .../demo_colorbar_with_inset_locator.py       |  1 +
 .../examples/axes_grid1/simple_colorbar.py    | 22 -------------
 .../users_explain/toolkits/axes_grid.rst      |  4 +--
 5 files changed, 5 insertions(+), 57 deletions(-)
 delete mode 100644 galleries/examples/axes_grid1/demo_colorbar_of_inset_axes.py
 delete mode 100644 galleries/examples/axes_grid1/simple_colorbar.py

diff --git a/galleries/examples/axes_grid1/demo_colorbar_of_inset_axes.py b/galleries/examples/axes_grid1/demo_colorbar_of_inset_axes.py
deleted file mode 100644
index 341e11ff52b5..000000000000
--- a/galleries/examples/axes_grid1/demo_colorbar_of_inset_axes.py
+++ /dev/null
@@ -1,33 +0,0 @@
-"""
-===============================
-Adding a colorbar to inset axes
-===============================
-"""
-
-import matplotlib.pyplot as plt
-
-from matplotlib import cbook
-from mpl_toolkits.axes_grid1.inset_locator import inset_axes, zoomed_inset_axes
-
-fig, ax = plt.subplots(figsize=[5, 4])
-ax.set(aspect=1, xlim=(-15, 15), ylim=(-20, 5))
-
-Z = cbook.get_sample_data("axes_grid/bivariate_normal.npy")
-extent = (-3, 4, -4, 3)
-
-axins = zoomed_inset_axes(ax, zoom=2, loc='upper left')
-axins.set(xticks=[], yticks=[])
-im = axins.imshow(Z, extent=extent, origin="lower")
-
-# colorbar
-cax = inset_axes(axins,
-                 width="5%",  # width = 10% of parent_bbox width
-                 height="100%",  # height : 50%
-                 loc='lower left',
-                 bbox_to_anchor=(1.05, 0., 1, 1),
-                 bbox_transform=axins.transAxes,
-                 borderpad=0,
-                 )
-fig.colorbar(im, cax=cax)
-
-plt.show()
diff --git a/galleries/examples/axes_grid1/demo_colorbar_with_axes_divider.py b/galleries/examples/axes_grid1/demo_colorbar_with_axes_divider.py
index 9e4611c65bb7..0c0771013c9f 100644
--- a/galleries/examples/axes_grid1/demo_colorbar_with_axes_divider.py
+++ b/galleries/examples/axes_grid1/demo_colorbar_with_axes_divider.py
@@ -14,6 +14,8 @@
 Users should consider simply passing the main axes to the *ax* keyword argument of
 `~.Figure.colorbar` instead of creating a locatable axes manually like this.
 See :ref:`colorbar_placement`.
+
+.. redirect-from:: /gallery/axes_grid1/simple_colorbar
 """
 
 import matplotlib.pyplot as plt
diff --git a/galleries/examples/axes_grid1/demo_colorbar_with_inset_locator.py b/galleries/examples/axes_grid1/demo_colorbar_with_inset_locator.py
index 8ec7d0e7271b..e450485150d7 100644
--- a/galleries/examples/axes_grid1/demo_colorbar_with_inset_locator.py
+++ b/galleries/examples/axes_grid1/demo_colorbar_with_inset_locator.py
@@ -16,6 +16,7 @@
 Users should consider using `.Axes.inset_axes` instead (see
 :ref:`colorbar_placement`).
 
+.. redirect-from:: /gallery/axes_grid1/demo_colorbar_of_inset_axes
 """
 
 import matplotlib.pyplot as plt
diff --git a/galleries/examples/axes_grid1/simple_colorbar.py b/galleries/examples/axes_grid1/simple_colorbar.py
deleted file mode 100644
index 5617cb0b6b4b..000000000000
--- a/galleries/examples/axes_grid1/simple_colorbar.py
+++ /dev/null
@@ -1,22 +0,0 @@
-"""
-===============
-Simple Colorbar
-===============
-
-"""
-import matplotlib.pyplot as plt
-import numpy as np
-
-from mpl_toolkits.axes_grid1 import make_axes_locatable
-
-ax = plt.subplot()
-im = ax.imshow(np.arange(100).reshape((10, 10)))
-
-# create an Axes on the right side of ax. The width of cax will be 5%
-# of ax and the padding between cax and ax will be fixed at 0.05 inch.
-divider = make_axes_locatable(ax)
-cax = divider.append_axes("right", size="5%", pad=0.05)
-
-plt.colorbar(im, cax=cax)
-
-plt.show()
diff --git a/galleries/users_explain/toolkits/axes_grid.rst b/galleries/users_explain/toolkits/axes_grid.rst
index ba37c4cf7d78..6f7be49ed4c1 100644
--- a/galleries/users_explain/toolkits/axes_grid.rst
+++ b/galleries/users_explain/toolkits/axes_grid.rst
@@ -81,8 +81,8 @@ side ("left", "right", "top", "bottom") of the original axes.
 colorbar whose height (or width) is in sync with the main axes
 --------------------------------------------------------------
 
-.. figure:: /gallery/axes_grid1/images/sphx_glr_simple_colorbar_001.png
-   :target: /gallery/axes_grid1/simple_colorbar.html
+.. figure:: /gallery/axes_grid1/images/sphx_glr_demo_colorbar_with_axes_divider_001.png
+   :target: /gallery/axes_grid1/demo_colorbar_with_axes_divider.html
    :align: center
 
 scatter_hist.py with AxesDivider

From 177ae327ecee04e42704d9b333e6968f1d228017 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Thu, 2 Nov 2023 11:35:28 +0100
Subject: [PATCH 0406/1120] Copy-edit the standalone colorbar tutorial

- The tutorial is mostly about making standalone colorbars, so use that
  as title.
- Most users will still want the colorbar next to an existing axes, so
  explain how to do that.
- "Extended colorbar with continuous colorscale" is first about discrete
  colorbars (extensions are a second point), so adjust the title; also
  it already needs to introduce BoundaryNorm.  Adjust the next example's
  text accordingly as well, as it now only needs to introduce
  ListedColormap.
- In that next example, describe the additional kwargs to colorbar() in
  a bullet list.
- More consistently use fully qualified names the first time a new class
  is introduced, and unqualified names thereafter.
- Use constrained layout instead of manually adjusting figure
  geometries.
- Minor additional tweaks.
---
 .../users_explain/colors/colorbar_only.py     | 131 +++++++++---------
 1 file changed, 63 insertions(+), 68 deletions(-)

diff --git a/galleries/users_explain/colors/colorbar_only.py b/galleries/users_explain/colors/colorbar_only.py
index f9f126533a16..a47ced0a4ea6 100644
--- a/galleries/users_explain/colors/colorbar_only.py
+++ b/galleries/users_explain/colors/colorbar_only.py
@@ -1,39 +1,34 @@
 """
 .. redirect-from:: /tutorials/colors/colorbar_only
 
-=============================
-Customized Colorbars Tutorial
-=============================
+====================
+Standalone colorbars
+====================
 
 This tutorial shows how to build and customize standalone colorbars, i.e.
 without an attached plot.
 
-Customized Colorbars
-====================
-
 A `~.Figure.colorbar` needs a "mappable" (`matplotlib.cm.ScalarMappable`)
 object (typically, an image) which indicates the colormap and the norm to be
 used.  In order to create a colorbar without an attached image, one can instead
 use a `.ScalarMappable` with no associated data.
-
-Basic continuous colorbar
--------------------------
-
-Here we create a basic continuous colorbar with ticks and labels.
-
-The arguments to the `~.Figure.colorbar` call are the `.ScalarMappable`
-(constructed using the *norm* and *cmap* arguments), the axes where the
-colorbar should be drawn, and the colorbar's orientation.
-
-For more information see the :mod:`~matplotlib.colorbar` API.
 """
 
 import matplotlib.pyplot as plt
-
 import matplotlib as mpl
 
-fig, ax = plt.subplots(figsize=(6, 1))
-fig.subplots_adjust(bottom=0.5)
+# %%
+# Basic continuous colorbar
+# -------------------------
+# Here, we create a basic continuous colorbar with ticks and labels.
+#
+# The arguments to the `~.Figure.colorbar` call are the `.ScalarMappable`
+# (constructed using the *norm* and *cmap* arguments), the axes where the
+# colorbar should be drawn, and the colorbar's orientation.
+#
+# For more information see the `~matplotlib.colorbar` API.
+
+fig, ax = plt.subplots(figsize=(6, 1), layout='constrained')
 
 cmap = mpl.cm.cool
 norm = mpl.colors.Normalize(vmin=5, vmax=10)
@@ -41,16 +36,30 @@
 fig.colorbar(mpl.cm.ScalarMappable(norm=norm, cmap=cmap),
              cax=ax, orientation='horizontal', label='Some Units')
 
+# %%
+# Colorbar attached next to a pre-existing axes
+# ---------------------------------------------
+# All examples in this tutorial (except this one) show a standalone colorbar on
+# its own figure, but it is possible to display the colorbar *next* to a
+# pre-existing Axes *ax* by passing ``ax=ax`` to the colorbar() call (meaning
+# "draw the colorbar next to *ax*") rather than ``cax=ax`` (meaning "draw the
+# colorbar on *ax*").
+
+fig, ax = plt.subplots(layout='constrained')
+
+fig.colorbar(mpl.cm.ScalarMappable(norm=mpl.colors.Normalize(0, 1), cmap='magma'),
+             ax=ax, orientation='vertical', label='a colorbar label')
 
 # %%
-# Extended colorbar with continuous colorscale
-# --------------------------------------------
-#
-# The second example shows how to make a discrete colorbar based on a
-# continuous cmap. With the "extend" keyword argument the appropriate colors
-# are chosen to fill the colorspace, including the extensions:
-fig, ax = plt.subplots(figsize=(6, 1))
-fig.subplots_adjust(bottom=0.5)
+# Discrete and extended colorbar with continuous colorscale
+# ---------------------------------------------------------
+# The following example shows how to make a discrete colorbar based on a
+# continuous cmap.  We use `matplotlib.colors.BoundaryNorm` to describe the
+# interval boundaries (which must be in increasing order), and further pass the
+# *extend* argument to it to further display "over" and "under" colors (which
+# are used for data outside of the norm range).
+
+fig, ax = plt.subplots(figsize=(6, 1), layout='constrained')
 
 cmap = mpl.cm.viridis
 bounds = [-1, 2, 5, 7, 12, 15]
@@ -61,72 +70,58 @@
              label="Discrete intervals with extend='both' keyword")
 
 # %%
-# Discrete intervals colorbar
-# ---------------------------
-#
-# The third example illustrates the use of a
-# :class:`~matplotlib.colors.ListedColormap` which generates a colormap from a
-# set of listed colors, `.colors.BoundaryNorm` which generates a colormap
-# index based on discrete intervals and extended ends to show the "over" and
-# "under" value colors. Over and under are used to display data outside of the
-# normalized [0, 1] range. Here we pass colors as gray shades as a string
-# encoding a float in the 0-1 range.
+# Colorbar with arbitrary colors
+# ------------------------------
+# The following example still uses a `.BoundaryNorm` to describe discrete
+# interval boundaries, but now uses a `matplotlib.colors.ListedColormap` to
+# associate each interval with an arbitrary color (there must be as many
+# intervals than there are colors).  The "over" and "under" colors are set on
+# the colormap using `.Colormap.with_extremes`.
 #
-# If a :class:`~matplotlib.colors.ListedColormap` is used, the length of the
-# bounds array must be one greater than the length of the color list. The
-# bounds must be monotonically increasing.
+# We also pass additional arguments to `~.Figure.colorbar`:
 #
-# This time we pass additional arguments to
-# `~.Figure.colorbar`. For the out-of-range values to display on the colorbar
-# without using the *extend* keyword with
-# `.colors.BoundaryNorm`, we have to use the *extend* keyword argument directly
-# in the colorbar call.  Here we also
-# use the spacing argument to make
-# the length of each colorbar segment proportional to its corresponding
-# interval.
-
-fig, ax = plt.subplots(figsize=(6, 1))
-fig.subplots_adjust(bottom=0.5)
+# - To display the out-of-range values on the colorbar, we use the *extend*
+#   argument in the colorbar() call.  (This is equivalent to passing the
+#   *extend* argument in the `.BoundaryNorm` constructor as done in the
+#   previous example.)
+# - To make the length of each colorbar segment proportional to its
+#   corresponding interval, we use the *spacing* argument in the colorbar()
+#   call.
 
-cmap = (mpl.colors.ListedColormap(['red', 'green', 'blue', 'cyan'])
-        .with_extremes(over='0.25', under='0.75'))
+fig, ax = plt.subplots(figsize=(6, 1), layout='constrained')
 
+cmap = (mpl.colors.ListedColormap(['red', 'green', 'blue', 'cyan'])
+        .with_extremes(under='yellow', over='magenta'))
 bounds = [1, 2, 4, 7, 8]
 norm = mpl.colors.BoundaryNorm(bounds, cmap.N)
+
 fig.colorbar(
     mpl.cm.ScalarMappable(cmap=cmap, norm=norm),
-    cax=ax,
+    cax=ax, orientation='horizontal',
     extend='both',
-    ticks=bounds,
     spacing='proportional',
-    orientation='horizontal',
     label='Discrete intervals, some other units',
 )
 
 # %%
 # Colorbar with custom extension lengths
 # --------------------------------------
-#
-# Here we illustrate the use of custom length colorbar extensions, on a
-# colorbar with discrete intervals. To make the length of each extension the
+# We can customize the length colorbar extensions, on a colorbar with discrete
+# intervals. To make the length of each extension the
 # same as the length of the interior colors, use ``extendfrac='auto'``.
 
-fig, ax = plt.subplots(figsize=(6, 1))
-fig.subplots_adjust(bottom=0.5)
+fig, ax = plt.subplots(figsize=(6, 1), layout='constrained')
 
 cmap = (mpl.colors.ListedColormap(['royalblue', 'cyan', 'yellow', 'orange'])
         .with_extremes(over='red', under='blue'))
-
 bounds = [-1.0, -0.5, 0.0, 0.5, 1.0]
 norm = mpl.colors.BoundaryNorm(bounds, cmap.N)
+
 fig.colorbar(
     mpl.cm.ScalarMappable(cmap=cmap, norm=norm),
-    cax=ax,
-    extend='both',
-    extendfrac='auto',
-    ticks=bounds,
+    cax=ax, orientation='horizontal',
+    extend='both', extendfrac='auto',
     spacing='uniform',
-    orientation='horizontal',
     label='Custom extension lengths, some other units',
 )
 

From f73d048ffdf6e6ef9e23088583ca0461105f46c8 Mon Sep 17 00:00:00 2001
From: Sudhanshu Pandey <sp6370@nyu.edu>
Date: Thu, 2 Nov 2023 08:49:34 -0400
Subject: [PATCH 0407/1120] Tagging Example - Tags for multiple figs demo
 (#27236)

* chore: added new tags for demo
* Update multiple_figs_demo.py
---
 .../examples/subplots_axes_and_figures/multiple_figs_demo.py   | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/galleries/examples/subplots_axes_and_figures/multiple_figs_demo.py b/galleries/examples/subplots_axes_and_figures/multiple_figs_demo.py
index 9bb9962c8e28..1026dd110f4c 100644
--- a/galleries/examples/subplots_axes_and_figures/multiple_figs_demo.py
+++ b/galleries/examples/subplots_axes_and_figures/multiple_figs_demo.py
@@ -49,3 +49,6 @@
 ax.set_xticklabels([])
 
 plt.show()
+
+# %%
+# .. tags:: component: figure, plot type: line

From da5a48fc1fb94349968dfd343c2bf0d6a81dbd73 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Thu, 2 Nov 2023 14:14:14 -0500
Subject: [PATCH 0408/1120] Fix merge of environment.yml

---
 environment.yml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/environment.yml b/environment.yml
index 32c2e243fd9f..1487578a443b 100644
--- a/environment.yml
+++ b/environment.yml
@@ -16,6 +16,10 @@ dependencies:
   - importlib-resources>=3.2.0
   - kiwisolver>=1.3.1
   - pybind11>=2.6.0
+  - meson-python>=0.13.1
+  - numpy>=1.21
+  - pillow>=8
+  - pkg-config
   - pygobject
   - pyparsing>=2.3.1
   - pyqt

From c3a10cb617373a3c861d5b8a4054eea20576b99d Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Thu, 2 Nov 2023 14:16:01 -0500
Subject: [PATCH 0409/1120] Remove duplicated text from development setup (from
 manual backport)

---
 doc/devel/development_setup.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/doc/devel/development_setup.rst b/doc/devel/development_setup.rst
index f619b179ead5..9be22161a89a 100644
--- a/doc/devel/development_setup.rst
+++ b/doc/devel/development_setup.rst
@@ -194,11 +194,6 @@ config during installation ::
 For more information on installation and other configuration options, see the
 Meson Python :external+meson-python:ref:`editable installs guide <how-to-guides-editable-installs>`.
 
-
-If the installation is not working, please consult the :ref:`troubleshooting guide <troubleshooting-faq>`.
-If the guide does not offer a solution, please reach out via `chat <https://gitter.im/matplotlib/matplotlib>`_
-or :ref:`open an issue <submitting-a-bug-report>`.
-
 Verify the Installation
 =======================
 

From f21380127e0df2d3f2a16a78e72c25e3a700a7ff Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Wed, 1 Nov 2023 20:42:18 -0400
Subject: [PATCH 0410/1120] reasoning for the communications guidelines and
 social media voice + update to changing guidelines section to be name of doc
 agnostic
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Melissa Weber Mendonça <melissawm@gmail.com>
Co-authored-by: noatamir <6564007+noatamir@users.noreply.github.com>
---
 doc/devel/communication_guide.rst | 66 +++++++++++++++++++++++++------
 doc/users/project/mission.rst     |  2 +
 2 files changed, 56 insertions(+), 12 deletions(-)

diff --git a/doc/devel/communication_guide.rst b/doc/devel/communication_guide.rst
index b9fa301c0e46..aed52be84e32 100644
--- a/doc/devel/communication_guide.rst
+++ b/doc/devel/communication_guide.rst
@@ -1,18 +1,41 @@
 .. _communications-guidelines:
 
-========================
-Communication guidelines
-========================
+==========================
+Community management guide
+==========================
 
-These guidelines are applicable when acting as a representative of Matplotlib,
+These guidelines are applicable when **acting as a representative** of Matplotlib,
 for example at sprints or when giving official talks or tutorials, and in any
 community venue managed by Matplotlib.
 
+Our approach to community engagement is foremost guided by our :ref:`mission-statement`:
+
+* We demonstrate that we care about visualization as a practice
+* We deepen our practice and the community’s capacity to support users,
+  facilitate exploration, produce high quality visualizations, and be
+  understandable and extensible
+* We showcase advanced use of the library without adding maintenance burden to
+  the documentation and recognize contributions that happen outside of the github
+  workflow.
+* We use communications platforms to maintain relationships with contributors
+  who may no longer be active on GitHub, build relationships with potential
+  contributors, and connect with other projects and communities who use
+  Matplotlib.
+* In prioritizing understandability and extensiblity, we recognize that people
+  using Matplotlib, in whatever capacity, are part of our community. Doing so
+  empowers our community members to build community with each other, for example
+  by creating educational resources, building third party tools, and building
+  informal mentoring networks.
 
 .. _communication-channels:
 
 Official communication channels
 ===============================
+The Scientific Python community uses various communications platforms to stay
+updated on new features and projects, to contribute by telling us what is on
+their mind and suggest issues and bugs, and to showcase their use cases and the
+tools they have built.
+
 The following venues are managed by Matplotlib maintainers and contributors:
 
 * library and docs: https://github.com/matplotlib/matplotlib
@@ -148,12 +171,32 @@ Visual media in communications should be made as accessible as possible:
   * Do not make bright, strobing images.
   * More guidelines at https://webaim.org/techniques/images/.
 
+.. _social-media-brand:
 
 Social media
 ============
 
-Please follow these guidelines to maintain a consistent brand identity across
-platforms.
+Matplotlib aims for a single voice across all social media platforms to build and
+maintain a consistent brand identity for Matplotlib as an organization. This
+depersonalization is the norm on social media platforms because it enables
+constructive and productive conversations; People generally feel more comfortable
+giving negative and constructive feedback to a brand than to specific contributors.
+
+The current Matplotlib voice and persona aims to be kind, patient, supportive and
+educational. This is so that it can de-escalate tensions and facilitate
+constructive conversations; being perceived as negative or
+argumentative can escalate very fast into long-lasting brand damage, being
+perceived as personal leads to aggression and accusations faster than an
+impersonal account, and being perceived as friendly and approachable leads to
+higher engagement. Instead of speaking with a directive authority, which can be
+intimidating and lead to negative engagement, it speaks as a peer or educator to
+empower participation. The current voice encourages more input from folks we
+engage with, and also makes it possible for folks who are not in the core team
+to participate in managing the account.
+
+While the :ref:`brand identity <social-media-brand>` is casual, the showcased
+content is high quality, peer-led resource building. Please follow these
+guidelines to maintain a consistent brand identity across platforms.
 
 Persona
 -------
@@ -213,11 +256,10 @@ Retired campaigns
 Changing the guidelines
 =======================
 
-As the person tasked with implementing communications, the `community-manager`_
-should be alerted to proposed changes to the communications guidelines. Similarly,
-specific platform guidelines (e.g. twitter, instagram) should be reviewed by the
-person responsible for that platform, when different from the community manager.
-If there is no consensus, decisions about communications guidelines revert to
-the community manager.
+As the person tasked with implementing these guidelines, the `community-manager`_
+should be alerted to proposed changes. Similarly, specific platform guidelines
+(e.g. twitter, instagram) should be reviewed by the person responsible for that
+platform, when different from the community manager. If there is no consensus,
+decisions about guidelines revert to the community manager.
 
 .. _community-manager: https://matplotlib.org/governance/people.html#deputy-project-leads
diff --git a/doc/users/project/mission.rst b/doc/users/project/mission.rst
index 431da04e4891..438d2fce8b1d 100644
--- a/doc/users/project/mission.rst
+++ b/doc/users/project/mission.rst
@@ -1,3 +1,5 @@
+.. _mission-statement:
+
 Mission Statement
 =================
 

From f4d807de4dda558c93631b4a2b18f5e1264e343c Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Thu, 2 Nov 2023 18:53:18 -0500
Subject: [PATCH 0411/1120] Remove unecessary environment variable from
 cibuildwheel config

---
 .github/workflows/cibuildwheel.yml | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 749014ac40c1..af733ff04502 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -64,9 +64,6 @@ jobs:
         run: |
           python -m build --sdist
           python ci/export_sdist_name.py
-        env:
-          # Prevent including development runtime dependencies in metadata.
-          CIBUILDWHEEL: 1
 
       - name: Check README rendering for PyPI
         run: twine check dist/*

From 5143bad2be690d666e63ee3e6afcb9e220fe7310 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Thu, 26 Oct 2023 21:46:48 -0400
Subject: [PATCH 0412/1120] streamlined coding guide and added naming
 conventions table

Co-authored-by: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
---
 doc/api/next_api_changes/README.rst |  12 +-
 doc/devel/coding_guide.rst          | 214 ++++++-------------------
 doc/devel/contribute.rst            | 237 ++++++++++++++++++++++++----
 doc/devel/development_setup.rst     |   2 +
 doc/devel/development_workflow.rst  |  17 ++
 doc/users/next_whats_new/README.rst |  12 +-
 6 files changed, 292 insertions(+), 202 deletions(-)

diff --git a/doc/api/next_api_changes/README.rst b/doc/api/next_api_changes/README.rst
index de494911e6b2..75e70b456eb9 100644
--- a/doc/api/next_api_changes/README.rst
+++ b/doc/api/next_api_changes/README.rst
@@ -22,11 +22,17 @@ author's initials. Typically, each change will get its own file, but you may
 also amend existing files when suitable. The overall goal is a comprehensible
 documentation of the changes.
 
-Please avoid using references in section titles, as it causes links to be
-confusing in the table of contents. Instead, ensure that a reference is
-included in the descriptive text. A typical entry could look like this::
+A typical entry could look like this::
 
    Locators
    ~~~~~~~~
    The unused `Locator.autoscale()` method is deprecated (pass the axis
    limits to `Locator.view_limits()` instead).
+
+Please avoid using references in section titles, as it causes links to be
+confusing in the table of contents. Instead, ensure that a reference is
+included in the descriptive text.
+
+.. NOTE
+   Lines 5-30 of this file are include in :ref:`api_whats_new`;
+   therefore, please check the doc build after changing this file.
diff --git a/doc/devel/coding_guide.rst b/doc/devel/coding_guide.rst
index 0385d6d388f0..22873020f103 100644
--- a/doc/devel/coding_guide.rst
+++ b/doc/devel/coding_guide.rst
@@ -8,144 +8,82 @@ Pull request guidelines
 <https://docs.github.com/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests>`__
 are the mechanism for contributing to Matplotlib's code and documentation.
 
-It is recommended to check that your contribution complies with the following
-rules before submitting a pull request:
+We value contributions from people with all levels of experience. In particular,
+if this is your first PR not everything has to be perfect. We'll guide you
+through the PR process. Nevertheless, please try to follow our guidelines as well
+as you can to help make the PR process quick and smooth. If your pull request is
+incomplete or a work-in-progress, please mark it as a `draft pull requests <https://docs.github.com/en/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests#draft-pull-requests>`_
+on GitHub and specify what feedback from the developers would be helpful.
 
-* If your pull request addresses an issue, please use the title to describe the
-  issue (e.g. "Add ability to plot timedeltas") and mention the issue number
-  in the pull request description to ensure that a link is created to the
-  original issue (e.g. "Closes #8869" or "Fixes #8869"). This will ensure the
-  original issue mentioned is automatically closed when your PR is merged. See
-  `the GitHub documentation
-  <https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue>`__
-  for more details.
-
-* Formatting should follow the recommendations of PEP8_, as enforced by
-  flake8_. Matplotlib modifies PEP8 to extend the maximum line length to 88
-  characters. You can check flake8 compliance from the command line with ::
-
-    python -m pip install flake8
-    flake8 /path/to/module.py
-
-  or your editor may provide integration with it.  Note that Matplotlib
-  intentionally does not use the black_ auto-formatter (1__), in particular due
-  to its inability to understand the semantics of mathematical expressions
-  (2__, 3__).
-
-  .. _PEP8: https://www.python.org/dev/peps/pep-0008/
-  .. _flake8: https://flake8.pycqa.org/
-  .. _black: https://black.readthedocs.io/
-  .. __: https://github.com/matplotlib/matplotlib/issues/18796
-  .. __: https://github.com/psf/black/issues/148
-  .. __: https://github.com/psf/black/issues/1984
-
-* All public methods should have informative docstrings with sample usage when
-  appropriate. Use the :ref:`docstring standards <writing-docstrings>`.
-
-* For high-level plotting functions, consider adding a simple example either in
-  the ``Example`` section of the docstring or the
-  :ref:`examples gallery <gallery>`.
-
-* Changes (both new features and bugfixes) should have good test coverage. See
-  :ref:`testing` for more details.
-
-* Import the following modules using the standard scipy conventions::
+Please be patient with reviewers. We try our best to respond quickly, but we have
+limited bandwidth. If there is no feedback within a couple of days, please ping
+us by posting a comment to your PR or reaching out on a :ref:`communication channel <communication-channels>`
 
-     import numpy as np
-     import numpy.ma as ma
-     import matplotlib as mpl
-     import matplotlib.pyplot as plt
-     import matplotlib.cbook as cbook
-     import matplotlib.patches as mpatches
 
-  In general, Matplotlib modules should **not** import `.rcParams` using ``from
-  matplotlib import rcParams``, but rather access it as ``mpl.rcParams``.  This
-  is because some modules are imported very early, before the `.rcParams`
-  singleton is constructed.
-
-* If your change is a major new feature, add an entry to the ``What's new``
-  section by adding a new file in ``doc/users/next_whats_new`` (see
-  :file:`doc/users/next_whats_new/README.rst` for more information).
+Summary for pull request authors
+================================
 
-* If you change the API in a backward-incompatible way, please document it in
-  :file:`doc/api/next_api_changes/behavior`, by adding a new file with the
-  naming convention ``99999-ABC.rst`` where the pull request number is followed
-  by the contributor's initials. (see :file:`doc/api/api_changes.rst` for more
-  information)
+We recommend that you check that your contribution complies with the following
+guidelines before submitting a pull request:
 
-* If you add new public API or change public API, update or add the
-  corresponding type hints. Most often this is found in the corresponding
-  ``.pyi`` file for the ``.py`` file which was edited. Changes in ``pyplot.py``
-  are type hinted inline.
+.. rst-class:: checklist
 
-* See below for additional points about :ref:`keyword-argument-processing`, if
-  applicable for your pull request.
+* Changes, both new features and bugfixes, should have good test coverage. See
+  :ref:`testing` for more details.
 
-.. note::
+* Update the :ref:`documentation <pr-documentation>` if necessary.
 
-    The current state of the Matplotlib code base is not compliant with all
-    of these guidelines, but we expect that enforcing these constraints on all
-    new contributions will move the overall code base quality in the right
-    direction.
+* All public methods should have informative docstrings with sample usage when
+  appropriate. Use the :ref:`docstring standards <writing-docstrings>`.
 
+* For high-level plotting functions, consider adding a small example to the
+  :ref:`examples gallery <gallery>`.
 
-.. seealso::
+* If you add a major new feature or change the API in a backward-incompatible
+  way, please document it as described in :ref:`new-changed-api`
 
-  * :ref:`coding_guidelines`
-  * :ref:`testing`
-  * :ref:`documenting-matplotlib`
+* Code should follow our conventions as documented in our :ref:`coding_guidelines`
 
+* When adding or changing public function signatures, add :ref:`type hints <type-hints>`
 
+* When adding keyword arguments, see our guide to :ref:`keyword-argument-processing`.
 
-Summary for pull request authors
-================================
+When opening a pull request on Github, please ensure that:
 
-.. note::
+.. rst-class:: checklist
 
-   * We value contributions from people with all levels of experience. In
-     particular if this is your first PR not everything has to be perfect.
-     We'll guide you through the PR process.
-   * Nevertheless, please try to follow the guidelines below as well as you can to
-     help make the PR process quick and smooth.
-   * Be patient with reviewers. We try our best to respond quickly, but we
-     have limited bandwidth. If there is no feedback within a couple of days,
-     please ping us by posting a comment to your PR.
+* Changes were made on a :ref:`feature branch <make-feature-branch>`.
 
-When making a PR, pay attention to:
+* :ref:`pre-commit <pre-commit-hooks>` checks for spelling, formatting, etc pass
 
-.. rst-class:: checklist
+* The pull request targets the :ref:`main branch <pr-branch-selection>`
 
-* :ref:`Target the main branch <pr-branch-selection>`.
-* Adhere to the :ref:`coding_guidelines`.
-* Update the :ref:`documentation <pr-documentation>` if necessary.
-* Aim at making the PR as "ready-to-go" as you can. This helps to speed up
-  the review process.
-* It is ok to open incomplete or work-in-progress PRs if you need help or
-  feedback from the developers. You may mark these as
-  `draft pull requests <https://docs.github.com/en/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests#draft-pull-requests>`_
-  on GitHub.
-* When updating your PR, instead of adding new commits to fix something, please
-  consider amending your initial commit(s) to keep the history clean.
-  You can achieve this by using
+* If your pull request addresses an issue, please use the title to describe the
+  issue (e.g. "Add ability to plot timedeltas") and mention the issue number
+  in the pull request description to ensure that a link is created to the
+  original issue (e.g. "Closes #8869" or "Fixes #8869"). This will ensure the
+  original issue mentioned is automatically closed when your PR is merged. For more
+  details, see `linking an issue and pull request <https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue>`__.
 
-  .. code-block:: bash
+* :ref:`pr-automated-tests` pass
 
-     git commit --amend --no-edit
-     git push [your-remote-repo] [your-branch] --force-with-lease
+For guidance on creating and managing a pull request, please see our
+:ref:`contributing <contributing>` and :ref:`pull request workflow <edit-flow>`
+guides.
 
-See also :ref:`contributing` for how to make a PR.
 
 Summary for pull request reviewers
 ==================================
 
 .. redirect-from:: /devel/maintainer_workflow
 
-.. note::
+**Please help review and merge PRs!**
+
+If you have commit rights, then you are trusted to use them. Please be patient
+and `kind <https://youtu.be/tzFWz5fiVKU?t=49m30s>`__ with contributors.
 
-   * If you have commit rights, then you are trusted to use them.
-     **Please help review and merge PRs!**
-   * Be patient and `kind <https://youtu.be/tzFWz5fiVKU?t=49m30s>`__ with
-     contributors.
+When reviewing, please ensure that the pull request satisfies the following
+requirements before merging it:
 
 Content topics:
 
@@ -196,61 +134,6 @@ Documentation
 
 * See :ref:`documenting-matplotlib` for our documentation style guide.
 
-.. _release_notes:
-
-New features and API changes
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-When adding a major new feature or changing the API in a backward incompatible
-way, please document it by including a versioning directive in the docstring
-and adding an entry to the folder for either the what's new or API change notes.
-
-+-------------------+-----------------------------+----------------------------------+
-| for this addition | include this directive      | create entry in this folder      |
-+===================+=============================+==================================+
-| new feature       | ``.. versionadded:: 3.N``   | :file:`doc/users/next_whats_new/`|
-+-------------------+-----------------------------+----------------------------------+
-| API change        | ``.. versionchanged:: 3.N`` | :file:`doc/api/next_api_changes/`|
-|                   |                             |                                  |
-|                   |                             | probably in ``behavior/``        |
-+-------------------+-----------------------------+----------------------------------+
-
-The directives should be placed at the end of a description block. For example::
-
-  class Foo:
-      """
-      This is the summary.
-
-      Followed by a longer description block.
-
-      Consisting of multiple lines and paragraphs.
-
-      .. versionadded:: 3.5
-
-      Parameters
-      ----------
-      a : int
-          The first parameter.
-      b: bool, default: False
-          This was added later.
-
-          .. versionadded:: 3.6
-      """
-
-      def set_b(b):
-          """
-          Set b.
-
-          .. versionadded:: 3.6
-
-          Parameters
-          ----------
-          b: bool
-
-For classes and functions, the directive should be placed before the
-*Parameters* section. For parameters, the directive should be placed at the
-end of the parameter description. The patch release version is omitted and
-the directive should not be added to entire modules.
-
 .. _pr-labels:
 
 Labels
@@ -330,7 +213,8 @@ Merging
 
 Automated tests
 ---------------
-Before being merged, a PR should pass the :ref:`automated-tests`. If you are unsure why a test is failing, ask on the PR or in our `chat space <https://gitter.im/matplotlib/matplotlib>`_
+Before being merged, a PR should pass the :ref:`automated-tests`. If you are
+unsure why a test is failing, ask on the PR or in our :ref:`communication-channels`
 
 .. _pr-squashing:
 
diff --git a/doc/devel/contribute.rst b/doc/devel/contribute.rst
index 37f4e27765c7..a7d81cbc06d9 100644
--- a/doc/devel/contribute.rst
+++ b/doc/devel/contribute.rst
@@ -367,27 +367,160 @@ project that leads to a scientific publication, please follow the
 Coding guidelines
 =================
 
-API changes
------------
+While the current state of the Matplotlib code base is not compliant with all
+of these guidelines, our goal in enforcing these constraints on new
+contributions is that it improves the readability and consistency of the code base
+going forward.
 
-API consistency and stability are of great value. Therefore, API changes
-(e.g. signature changes, behavior changes, removals) will only be conducted
-if the added benefit is worth the user effort for adapting.
+PEP8, as enforced by flake8
+---------------------------
+
+Formatting should follow the recommendations of PEP8_, as enforced by flake8_.
+Matplotlib modifies PEP8 to extend the maximum line length to 88
+characters. You can check flake8 compliance from the command line with ::
+
+    python -m pip install flake8
+    flake8 /path/to/module.py
+
+or your editor may provide integration with it.  Note that Matplotlib intentionally
+does not use the black_ auto-formatter (1__), in particular due to its inability
+to understand the semantics of mathematical expressions (2__, 3__).
+
+.. _PEP8: https://www.python.org/dev/peps/pep-0008/
+.. _flake8: https://flake8.pycqa.org/
+.. _black: https://black.readthedocs.io/
+.. __: https://github.com/matplotlib/matplotlib/issues/18796
+.. __: https://github.com/psf/black/issues/148
+.. __: https://github.com/psf/black/issues/1984
+
+
+Package imports
+---------------
+Import the following modules using the standard scipy conventions::
+
+  import numpy as np
+  import numpy.ma as ma
+  import matplotlib as mpl
+  import matplotlib.pyplot as plt
+  import matplotlib.cbook as cbook
+  import matplotlib.patches as mpatches
+
+In general, Matplotlib modules should **not** import `.rcParams` using ``from
+matplotlib import rcParams``, but rather access it as ``mpl.rcParams``.  This
+is because some modules are imported very early, before the `.rcParams`
+singleton is constructed.
+
+Variable names
+--------------
+
+When feasible, please use our internal variable naming convention for objects
+of a given class and objects of any child class:
+
++------------------------------------+---------------+------------------------------------------+
+|             base class             | variable      |                multiples                 |
++====================================+===============+==========================================+
+| `~matplotlib.figure.FigureBase`    | ``fig``       |                                          |
++------------------------------------+---------------+------------------------------------------+
+| `~matplotlib.axes.Axes`            | ``ax``        |                                          |
++------------------------------------+---------------+------------------------------------------+
+| `~matplotlib.transforms.Transform` | ``trans``     | ``trans_<source>_<target>``              |
++                                    +               +                                          +
+|                                    |               | ``trans_<source>`` when target is screen |
++------------------------------------+---------------+------------------------------------------+
+
+Generally, denote more than one instance of the same class by adding suffixes to
+the variable names. If a format isn't specified in the table, use numbers or
+letters as appropriate.
+
+
+.. _type-hints:
+
+Type hints
+----------
+
+If you add new public API or change public API, update or add the
+corresponding `mypy <https://mypy.readthedocs.io/en/latest/>`_ type hints.
+We generally use `stub files
+<https://typing.readthedocs.io/en/latest/source/stubs.html#type-stubs>`_
+(``*.pyi``) to store the type information; for example ``colors.pyi`` contains
+the type information for ``colors.py``. A notable exception is ``pyplot.py``,
+which is type hinted inline.
+
+Type hints are checked by the mypy :ref:`pre-commit hook <pre-commit-hooks>`
+and can often be verified using ``tools\stubtest.py`` and occasionally may
+require the use of ``tools\check_typehints.py``.
+
+
+.. _new-changed-api:
 
-Because we are a visualization library our primary output is the final
-visualization the user sees.  Thus it is our :ref:`long standing
-<color_changes>` policy that the appearance of the figure is part of the API
-and any changes, either semantic or esthetic, will be treated as a
-backwards-incompatible API change.
+API changes and new features
+----------------------------
 
+API consistency and stability are of great value; Therefore, API changes
+(e.g. signature changes, behavior changes, removals) will only be conducted
+if the added benefit is worth the effort of adapting existing code.
+
+Because we are a visualization library, our primary output is the final
+visualization the user sees; therefore, the appearance of the figure is part of
+the API and any changes, either semantic or :ref:`esthetic <color_changes>`,
+are backwards-incompatible API changes.
+
+.. _api_whats_new:
+
+Announce changes, deprecations, and new features
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+When adding or changing the API in a backward in-compatible way, please add the
+appropriate :ref:`versioning directive <versioning-directives>` and document it
+for the release notes and add the entry to the appropriate folder:
+
++-------------------+-----------------------------+----------------------------------------------+
+| addition          |   versioning directive      |  announcement folder                         |
++===================+=============================+==============================================+
+| new feature       | ``.. versionadded:: 3.N``   | :file:`doc/users/next_whats_new/`            |
++-------------------+-----------------------------+----------------------------------------------+
+| API change        | ``.. versionchanged:: 3.N`` | :file:`doc/api/next_api_changes/[kind]`      |
++-------------------+-----------------------------+----------------------------------------------+
+
+API deprecations are first introduced and then expired. During the introduction
+period, users are warned that the API *will* change in the future.
+During the expiration period, code is changed as described in the notice posted
+during the introductory period.
+
++-----------+--------------------------------------------------+----------------------------------------------+
+|   stage   |                 required changes                 |             announcement folder              |
++===========+==================================================+==============================================+
+| introduce | :ref:`introduce deprecation <intro-deprecation>` | :file:`doc/api/next_api_changes/deprecation` |
++-----------+--------------------------------------------------+----------------------------------------------+
+| expire    | :ref:`expire deprecation <expire-deprecation>`   | :file:`doc/api/next_api_changes/[kind]`      |
++-----------+--------------------------------------------------+----------------------------------------------+
+
+For both change notes and what's new, please avoid using references in section
+titles, as it causes links to be confusing in the table of contents. Instead,
+ensure that a reference is included in the descriptive text.
+
+API Change Notes
+""""""""""""""""
+.. include:: ../api/next_api_changes/README.rst
+   :start-line: 5
+   :end-line: 31
+
+What's new
+""""""""""
+.. include:: ../users/next_whats_new/README.rst
+   :start-line: 5
+   :end-line: 24
+
+
+Deprecation
+^^^^^^^^^^^
 API changes in Matplotlib have to be performed following the deprecation process
-below, except in very rare circumstances as deemed necessary by the development team.
-This ensures that users are notified before the change will take effect and thus
-prevents unexpected breaking of code.
+below, except in very rare circumstances as deemed necessary by the development
+team. This ensures that users are notified before the change will take effect
+and thus prevents unexpected breaking of code.
 
 Rules
-^^^^^
-
+"""""
 - Deprecations are targeted at the next point.release (e.g. 3.x)
 - Deprecated API is generally removed two point-releases after introduction
   of the deprecation. Longer deprecations can be imposed by core developers on
@@ -398,12 +531,12 @@ Rules
 - If in doubt, decisions about API changes are finally made by the
   API consistency lead developer
 
-Introducing
-^^^^^^^^^^^
+.. _intro-deprecation:
+
+Introduce deprecation
+"""""""""""""""""""""
 
-#. Announce the deprecation in a new file
-   :file:`doc/api/next_api_changes/deprecations/99999-ABC.rst` where ``99999``
-   is the pull request number and ``ABC`` are the contributor's initials.
+#. Create :ref:`deprecation notice <api_whats_new>`
 
 #. If possible, issue a `~matplotlib.MatplotlibDeprecationWarning` when the
    deprecated API is used. There are a number of helper tools for this:
@@ -435,16 +568,13 @@ Introducing
      for the deleted parameter, even if it did not previously have one (e.g.
      ``param: <type> = ...``).
 
-Expiring
-^^^^^^^^
+.. _expire-deprecation:
+
+Expire deprecation
+""""""""""""""""""
 
-#. Announce the API changes in a new file
-   :file:`doc/api/next_api_changes/[kind]/99999-ABC.rst` where ``99999``
-   is the pull request number and ``ABC`` are the contributor's initials, and
-   ``[kind]`` is one of the folders :file:`behavior`, :file:`development`,
-   :file:`removals`. See :file:`doc/api/next_api_changes/README.rst` for more
-   information. For the content, you can usually copy the deprecation notice
-   and adapt it slightly.
+#. Create :ref:`deprecation announcement <api_whats_new>`. For the content,
+   you can usually copy the deprecation notice and adapt it slightly.
 
 #. Change the code functionality and remove any related deprecation warnings.
 
@@ -462,8 +592,8 @@ Expiring
      instead. For removed items that were not in the stub file, only deleting from the
      allowlist is required.
 
-Adding new API
---------------
+Adding new API and features
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Every new function, parameter and attribute that is not explicitly marked as
 private (i.e., starts with an underscore) becomes part of Matplotlib's public
@@ -481,6 +611,51 @@ take particular care when adding new API:
   __ https://emptysqua.re/blog/api-evolution-the-right-way/#adding-parameters
 
 
+.. _versioning-directives:
+
+Versioning directives
+"""""""""""""""""""""
+
+When making a backward incompatible change, please add a versioning directive in
+the docstring. The directives should be placed at the end of a description block.
+For example::
+
+  class Foo:
+      """
+      This is the summary.
+
+      Followed by a longer description block.
+
+      Consisting of multiple lines and paragraphs.
+
+      .. versionadded:: 3.5
+
+      Parameters
+      ----------
+      a : int
+          The first parameter.
+      b: bool, default: False
+          This was added later.
+
+          .. versionadded:: 3.6
+      """
+
+      def set_b(b):
+          """
+          Set b.
+
+          .. versionadded:: 3.6
+
+          Parameters
+          ----------
+          b: bool
+
+For classes and functions, the directive should be placed before the
+*Parameters* section. For parameters, the directive should be placed at the
+end of the parameter description. The patch release version is omitted and
+the directive should not be added to entire modules.
+
+
 New modules and files: installation
 -----------------------------------
 
diff --git a/doc/devel/development_setup.rst b/doc/devel/development_setup.rst
index 57c063605c47..c1c6767e1a80 100644
--- a/doc/devel/development_setup.rst
+++ b/doc/devel/development_setup.rst
@@ -212,6 +212,8 @@ you are aware of the existing issues beforehand.
 * Run test cases to verify installation :ref:`testing`
 * Verify documentation build :ref:`documenting-matplotlib`
 
+.. _pre-commit-hooks:
+
 Install pre-commit hooks
 ========================
 `pre-commit <https://pre-commit.com/>`_ hooks save time in the review process by
diff --git a/doc/devel/development_workflow.rst b/doc/devel/development_workflow.rst
index 50170ee4ade3..3f4fe956e37e 100644
--- a/doc/devel/development_workflow.rst
+++ b/doc/devel/development_workflow.rst
@@ -151,6 +151,23 @@ If you don't think your request is ready to be merged, just say so in your pull
 request message and use the "Draft PR" feature of GitHub. This is a good way of
 getting some preliminary code review.
 
+.. _update-pull-request:
+
+Update a pull request
+=====================
+
+When updating your pull request after making revisions, instead of adding new
+commits, please consider amending your initial commit(s) to keep the commit
+history clean.
+
+You can achieve this by using
+
+  .. code-block:: bash
+
+     git commit -a --amend --no-edit
+     git push [your-remote-repo] [your-branch] --force-with-lease
+
+
 Manage commit history
 =====================
 
diff --git a/doc/users/next_whats_new/README.rst b/doc/users/next_whats_new/README.rst
index e1b27ef97f1e..98b601ee32d8 100644
--- a/doc/users/next_whats_new/README.rst
+++ b/doc/users/next_whats_new/README.rst
@@ -11,9 +11,7 @@ something like :file:`cool_new_feature.rst` if you have added a brand new
 feature or something like :file:`updated_feature.rst` for extensions of
 existing features.
 
-Please avoid using references in section titles, as it causes links to be
-confusing in the table of contents.  Instead, ensure that a reference is
-included in the descriptive text.  Include contents of the form: ::
+Include contents of the form::
 
     Section title for feature
     -------------------------
@@ -23,3 +21,11 @@ included in the descriptive text.  Include contents of the form: ::
 
     A sub-section
     ~~~~~~~~~~~~~
+
+Please avoid using references in section titles, as it causes links to be
+confusing in the table of contents. Instead, ensure that a reference is
+included in the descriptive text.
+
+.. NOTE
+   Lines 5-24 of this file are include in :ref:`api_whats_new`;
+   therefore, please check the doc build after changing this file.

From ed46a19e9b804a3484c5cad1a9ef9e3eb670c9e5 Mon Sep 17 00:00:00 2001
From: zachjweiner <zachjweiner@gmail.com>
Date: Sat, 4 Nov 2023 11:46:04 -0700
Subject: [PATCH 0413/1120] add secondary axis support for Transform-type
 functions

---
 lib/matplotlib/axes/_secondary_axes.py        |   5 +++++
 .../test_axes/secondary_xy.png                | Bin 48775 -> 52572 bytes
 lib/matplotlib/tests/test_axes.py             |  15 +++++++++++++++
 3 files changed, 20 insertions(+)

diff --git a/lib/matplotlib/axes/_secondary_axes.py b/lib/matplotlib/axes/_secondary_axes.py
index 4c757f61c7b6..bb0237ee5332 100644
--- a/lib/matplotlib/axes/_secondary_axes.py
+++ b/lib/matplotlib/axes/_secondary_axes.py
@@ -6,6 +6,7 @@
 import matplotlib.ticker as mticker
 from matplotlib.axes._base import _AxesBase, _TransformedBoundsLocator
 from matplotlib.axis import Axis
+from matplotlib.transforms import Transform
 
 
 class SecondaryAxis(_AxesBase):
@@ -144,11 +145,15 @@ def set_functions(self, functions):
             If a transform is supplied, then the transform must have an
             inverse.
         """
+
         if (isinstance(functions, tuple) and len(functions) == 2 and
                 callable(functions[0]) and callable(functions[1])):
             # make an arbitrary convert from a two-tuple of functions
             # forward and inverse.
             self._functions = functions
+        elif isinstance(functions, Transform):
+            self._functions = (
+                    functions.transform, functions.inverted().transform)
         elif functions is None:
             self._functions = (lambda x: x, lambda x: x)
         else:
diff --git a/lib/matplotlib/tests/baseline_images/test_axes/secondary_xy.png b/lib/matplotlib/tests/baseline_images/test_axes/secondary_xy.png
index bbf9f9e13211db95a236de3696bfd31d5aac2ac7..b69241a06bc68f3e03383825a45aca1a606b201a 100644
GIT binary patch
literal 52572
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

literal 48775
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
b7CtJ&Rm@Kjn_Dht;I($mdaG>9E&KlhWfvw;

diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index 799bf5ddd774..3ae1a9376ceb 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -7494,6 +7494,20 @@ def test_annotate_across_transforms():
                 arrowprops=dict(arrowstyle="->"))
 
 
+class _Translation(mtransforms.Transform):
+    input_dims = 1
+    output_dims = 1
+
+    def __init__(self, dx):
+        self.dx = dx
+
+    def transform(self, values):
+        return values + self.dx
+
+    def inverted(self):
+        return _Translation(-self.dx)
+
+
 @image_comparison(['secondary_xy.png'], style='mpl20')
 def test_secondary_xy():
     fig, axs = plt.subplots(1, 2, figsize=(10, 5), constrained_layout=True)
@@ -7513,6 +7527,7 @@ def invert(x):
         secax(0.4, functions=(lambda x: 2 * x, lambda x: x / 2))
         secax(0.6, functions=(lambda x: x**2, lambda x: x**(1/2)))
         secax(0.8)
+        secax("top" if nn == 0 else "right", functions=_Translation(2))
 
 
 def test_secondary_fail():

From 1abf0a40181ec8ad1b493e941df5a06116306c46 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Sun, 5 Nov 2023 19:23:41 +0100
Subject: [PATCH 0414/1120] Copy-edit various examples.

Mostly removing "in Matplotlib" (where it is clear that it's a
Matplotlib example illustrating how to do stuff in Matplotlib), and
removing redundant subtitles.
---
 galleries/examples/color/README.txt              |  3 +--
 galleries/examples/color/named_colors.py         |  2 +-
 .../images_contours_and_fields/image_demo.py     |  8 +++-----
 .../images_contours_and_fields/pcolor_demo.py    | 12 +++++-------
 .../text_labels_and_annotations/accented_text.py |  6 +++---
 .../annotation_demo.py                           |  2 +-
 .../text_labels_and_annotations/font_file.py     |  6 +++---
 .../text_labels_and_annotations/legend_demo.py   |  2 --
 .../axes/constrainedlayout_guide.py              |  8 +++-----
 galleries/users_explain/axes/legend_guide.py     | 11 ++++-------
 .../users_explain/axes/tight_layout_guide.py     | 16 ++++++----------
 .../colors/colormap-manipulation.py              | 15 ++++++---------
 galleries/users_explain/colors/colormaps.py      |  6 +++---
 galleries/users_explain/text/text_intro.py       |  6 +++---
 14 files changed, 42 insertions(+), 61 deletions(-)

diff --git a/galleries/examples/color/README.txt b/galleries/examples/color/README.txt
index 4bcdb526f4d4..4b8b3bc4b751 100644
--- a/galleries/examples/color/README.txt
+++ b/galleries/examples/color/README.txt
@@ -3,6 +3,5 @@
 Color
 =====
 
-For more in-depth information about the colormaps available in matplotlib
-as well as a description of their properties,
+For a description of the colormaps available in Matplotlib,
 see the :ref:`colormaps tutorial <tutorials-colors>`.
diff --git a/galleries/examples/color/named_colors.py b/galleries/examples/color/named_colors.py
index 9ae4ec4957f3..d9a7259da773 100644
--- a/galleries/examples/color/named_colors.py
+++ b/galleries/examples/color/named_colors.py
@@ -3,7 +3,7 @@
 List of named colors
 ====================
 
-This plots a list of the named colors supported in matplotlib.
+This plots a list of the named colors supported by Matplotlib.
 For more information on colors in matplotlib see
 
 * the :ref:`colors_def` tutorial;
diff --git a/galleries/examples/images_contours_and_fields/image_demo.py b/galleries/examples/images_contours_and_fields/image_demo.py
index 884e68172698..213b6cdd28c2 100644
--- a/galleries/examples/images_contours_and_fields/image_demo.py
+++ b/galleries/examples/images_contours_and_fields/image_demo.py
@@ -1,9 +1,7 @@
 """
-==========
-Image demo
-==========
-
-Many ways to plot images in Matplotlib.
+========================
+Many ways to plot images
+========================
 
 The most common way to plot images in Matplotlib is with
 `~.axes.Axes.imshow`. The following examples demonstrate much of the
diff --git a/galleries/examples/images_contours_and_fields/pcolor_demo.py b/galleries/examples/images_contours_and_fields/pcolor_demo.py
index a783c83409df..7a8ef35caf96 100644
--- a/galleries/examples/images_contours_and_fields/pcolor_demo.py
+++ b/galleries/examples/images_contours_and_fields/pcolor_demo.py
@@ -1,13 +1,11 @@
 """
-===========
-Pcolor demo
-===========
+=============
+pcolor images
+=============
 
-Generating images with `~.axes.Axes.pcolor`.
-
-Pcolor allows you to generate 2D image-style plots. Below we will show how
-to do so in Matplotlib.
+`~.Axes.pcolor` generates 2D image-style plots, as illustrated below.
 """
+
 import matplotlib.pyplot as plt
 import numpy as np
 
diff --git a/galleries/examples/text_labels_and_annotations/accented_text.py b/galleries/examples/text_labels_and_annotations/accented_text.py
index f57b19532a43..7ff080afefd9 100644
--- a/galleries/examples/text_labels_and_annotations/accented_text.py
+++ b/galleries/examples/text_labels_and_annotations/accented_text.py
@@ -1,7 +1,7 @@
 r"""
-=================================
-Using accented text in Matplotlib
-=================================
+=============
+Accented text
+=============
 
 Matplotlib supports accented characters via TeX mathtext or Unicode.
 
diff --git a/galleries/examples/text_labels_and_annotations/annotation_demo.py b/galleries/examples/text_labels_and_annotations/annotation_demo.py
index 8b310a7a1865..26f3b80bf203 100644
--- a/galleries/examples/text_labels_and_annotations/annotation_demo.py
+++ b/galleries/examples/text_labels_and_annotations/annotation_demo.py
@@ -3,7 +3,7 @@
 Annotating Plots
 ================
 
-The following examples show how it is possible to annotate plots in Matplotlib.
+The following examples show ways to annotate plots in Matplotlib.
 This includes highlighting specific points of interest and using various
 visual tools to call attention to this point. For a more complete and in-depth
 description of the annotation and text tools in Matplotlib, see the
diff --git a/galleries/examples/text_labels_and_annotations/font_file.py b/galleries/examples/text_labels_and_annotations/font_file.py
index 8242b57839aa..b4a58808d716 100644
--- a/galleries/examples/text_labels_and_annotations/font_file.py
+++ b/galleries/examples/text_labels_and_annotations/font_file.py
@@ -1,7 +1,7 @@
 r"""
-===================================
-Using a ttf font file in Matplotlib
-===================================
+====================
+Using ttf font files
+====================
 
 Although it is usually not a good idea to explicitly point to a single ttf file
 for a font instance, you can do so by passing a `pathlib.Path` instance as the
diff --git a/galleries/examples/text_labels_and_annotations/legend_demo.py b/galleries/examples/text_labels_and_annotations/legend_demo.py
index a425d39b7d8f..2f550729837e 100644
--- a/galleries/examples/text_labels_and_annotations/legend_demo.py
+++ b/galleries/examples/text_labels_and_annotations/legend_demo.py
@@ -3,8 +3,6 @@
 Legend Demo
 ===========
 
-Plotting legends in Matplotlib.
-
 There are many ways to create and customize legends in Matplotlib. Below
 we'll show a few examples for how to do so.
 
diff --git a/galleries/users_explain/axes/constrainedlayout_guide.py b/galleries/users_explain/axes/constrainedlayout_guide.py
index 260a4f76bf71..4581f5f67808 100644
--- a/galleries/users_explain/axes/constrainedlayout_guide.py
+++ b/galleries/users_explain/axes/constrainedlayout_guide.py
@@ -40,15 +40,13 @@
 
 .. warning::
 
-    Calling ``plt.tight_layout()`` will turn off *constrained layout*!
+    Calling `~.pyplot.tight_layout` will turn off *constrained layout*!
 
 Simple example
 ==============
 
-In Matplotlib, the location of Axes (including subplots) are specified in
-normalized figure coordinates. It can happen that your axis labels or titles
-(or sometimes even ticklabels) go outside the figure area, and are thus
-clipped.
+With the default Axes positioning, the axes title, axis labels, or tick labels
+can sometimes go outside the figure area, and thus get clipped.
 """
 
 # sphinx_gallery_thumbnail_number = 18
diff --git a/galleries/users_explain/axes/legend_guide.py b/galleries/users_explain/axes/legend_guide.py
index 9900b0aa4bdd..3b138fe8ada3 100644
--- a/galleries/users_explain/axes/legend_guide.py
+++ b/galleries/users_explain/axes/legend_guide.py
@@ -7,13 +7,10 @@
 Legend guide
 ============
 
-Generating legends flexibly in Matplotlib.
-
 .. currentmodule:: matplotlib.pyplot
 
-This legend guide is an extension of the documentation available at
-:func:`~matplotlib.pyplot.legend` - please ensure you are familiar with
-contents of that documentation before proceeding with this guide.
+This legend guide extends the `~.Axes.legend` docstring -
+please read it before proceeding with this guide.
 
 This guide makes use of some common terms, which are documented here for
 clarity:
@@ -62,8 +59,8 @@
     line_down, = ax.plot([3, 2, 1], label='Line 1')
     ax.legend(handles=[line_up, line_down])
 
-In some cases, it is not possible to set the label of the handle, so it is
-possible to pass through the list of labels to :func:`legend`::
+In the rare case where the labels cannot directly be set on the handles, they
+can also be directly passed to :func:`legend`::
 
     fig, ax = plt.subplots()
     line_up, = ax.plot([1, 2, 3], label='Line 2')
diff --git a/galleries/users_explain/axes/tight_layout_guide.py b/galleries/users_explain/axes/tight_layout_guide.py
index 42c227b2e360..8525b9773f91 100644
--- a/galleries/users_explain/axes/tight_layout_guide.py
+++ b/galleries/users_explain/axes/tight_layout_guide.py
@@ -17,15 +17,11 @@
 An alternative to *tight_layout* is :ref:`constrained_layout
 <constrainedlayout_guide>`.
 
-
-Simple Example
+Simple example
 ==============
 
-In matplotlib, the location of axes (including subplots) are specified in
-normalized figure coordinates. It can happen that your axis labels or
-titles (or sometimes even ticklabels) go outside the figure area, and are thus
-clipped.
-
+With the default Axes positioning, the axes title, axis labels, or tick labels
+can sometimes go outside the figure area, and thus get clipped.
 """
 
 # sphinx_gallery_thumbnail_number = 7
@@ -190,8 +186,8 @@ def example_plot(ax, fontsize=12):
 
 # %%
 # You may provide an optional *rect* parameter, which specifies the bounding
-# box that the subplots will be fit inside. The coordinates must be in
-# normalized figure coordinates and the default is (0, 0, 1, 1).
+# box that the subplots will be fit inside. The coordinates are in
+# normalized figure coordinates and default to (0, 0, 1, 1) (the whole figure).
 
 fig = plt.figure()
 
@@ -245,7 +241,7 @@ def example_plot(ax, fontsize=12):
 # Use with AxesGrid1
 # ==================
 #
-# While limited, :mod:`mpl_toolkits.axes_grid1` is also supported.
+# Limited support for :mod:`mpl_toolkits.axes_grid1` is provided.
 
 from mpl_toolkits.axes_grid1 import Grid
 
diff --git a/galleries/users_explain/colors/colormap-manipulation.py b/galleries/users_explain/colors/colormap-manipulation.py
index 88e4c5befaf0..87269b87befa 100644
--- a/galleries/users_explain/colors/colormap-manipulation.py
+++ b/galleries/users_explain/colors/colormap-manipulation.py
@@ -3,9 +3,9 @@
 
 .. _colormap-manipulation:
 
-********************************
-Creating Colormaps in Matplotlib
-********************************
+******************
+Creating Colormaps
+******************
 
 Matplotlib has a number of built-in colormaps accessible via
 `.matplotlib.colormaps`.  There are also external libraries like
@@ -13,17 +13,15 @@
 
 .. _palettable: https://jiffyclub.github.io/palettable/
 
-However, we often want to create or manipulate colormaps in Matplotlib.
+However, we may also want to create or manipulate our own colormaps.
 This can be done using the class `.ListedColormap` or
 `.LinearSegmentedColormap`.
-Seen from the outside, both colormap classes map values between 0 and 1 to
-a bunch of colors. There are, however, slight differences, some of which are
-shown in the following.
+Both colormap classes map values between 0 and 1 to colors. There are however
+differences, as explained below.
 
 Before manually creating or manipulating colormaps, let us first see how we
 can obtain colormaps and their colors from existing colormap classes.
 
-
 Getting colormaps and accessing their values
 ============================================
 
@@ -32,7 +30,6 @@
 which returns a colormap object.  The length of the list of colors used
 internally to define the colormap can be adjusted via `.Colormap.resampled`.
 Below we use a modest value of 8 so there are not a lot of values to look at.
-
 """
 
 import matplotlib.pyplot as plt
diff --git a/galleries/users_explain/colors/colormaps.py b/galleries/users_explain/colors/colormaps.py
index 92b56d298976..b5db551cb5b5 100644
--- a/galleries/users_explain/colors/colormaps.py
+++ b/galleries/users_explain/colors/colormaps.py
@@ -3,9 +3,9 @@
 
 .. _colormaps:
 
-********************************
-Choosing Colormaps in Matplotlib
-********************************
+******************
+Choosing Colormaps
+******************
 
 Matplotlib has a number of built-in colormaps accessible via
 `.matplotlib.colormaps`.  There are also external libraries that
diff --git a/galleries/users_explain/text/text_intro.py b/galleries/users_explain/text/text_intro.py
index 54fcb00c7a86..948545667fa9 100644
--- a/galleries/users_explain/text/text_intro.py
+++ b/galleries/users_explain/text/text_intro.py
@@ -4,9 +4,9 @@
 
 .. _text_intro:
 
-========================
-Text in Matplotlib Plots
-========================
+==================
+Text in Matplotlib
+==================
 
 Introduction to plotting and working with text in Matplotlib.
 

From 7f2b989093c913a53408c14f91e6f55da43646fa Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Sun, 5 Nov 2023 22:43:36 -0500
Subject: [PATCH 0415/1120] minor fixes to dev workflow

---
 doc/devel/development_setup.rst    | 7 ++++---
 doc/devel/development_workflow.rst | 6 +++---
 2 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/doc/devel/development_setup.rst b/doc/devel/development_setup.rst
index 689a0ddc96d6..745a74dcf8bb 100644
--- a/doc/devel/development_setup.rst
+++ b/doc/devel/development_setup.rst
@@ -25,11 +25,12 @@ Fork the Matplotlib repository
 ==============================
 
 Matplotlib is hosted at https://github.com/matplotlib/matplotlib.git. If you
-plan on solving issues or submit pull requests to the main Matplotlib
+plan on solving issues or submitting pull requests to the main Matplotlib
 repository, you should first *fork* this repository by visiting
 https://github.com/matplotlib/matplotlib.git and clicking on the
-``Fork`` button on the top right of the page (see
-`the GitHub documentation <https://docs.github.com/get-started/quickstart/fork-a-repo>`__ for more details.)
+``Fork`` :octicon:`repo-forked` button on the top right of the page. See
+`the GitHub documentation <https://docs.github.com/get-started/quickstart/fork-a-repo>`__
+for more details.
 
 Retrieve the latest version of the code
 =======================================
diff --git a/doc/devel/development_workflow.rst b/doc/devel/development_workflow.rst
index 3f4fe956e37e..edb21bb862cd 100644
--- a/doc/devel/development_workflow.rst
+++ b/doc/devel/development_workflow.rst
@@ -162,10 +162,10 @@ history clean.
 
 You can achieve this by using
 
-  .. code-block:: bash
+.. code-block:: bash
 
-     git commit -a --amend --no-edit
-     git push [your-remote-repo] [your-branch] --force-with-lease
+    git commit -a --amend --no-edit
+    git push [your-remote-repo] [your-branch] --force-with-lease
 
 
 Manage commit history

From dce48368473c4506e34fb1235ce2215a0407206d Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Mon, 6 Nov 2023 20:32:22 +0100
Subject: [PATCH 0416/1120] Clarify behavior of `prune` parameter to
 MaxNLocator.

---
 lib/matplotlib/ticker.py | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/lib/matplotlib/ticker.py b/lib/matplotlib/ticker.py
index 41114aafbf3e..8f863582b33b 100644
--- a/lib/matplotlib/ticker.py
+++ b/lib/matplotlib/ticker.py
@@ -1996,13 +1996,11 @@ def __init__(self, nbins=None, **kwargs):
             If True, autoscaling will result in a range symmetric about zero.
 
         prune : {'lower', 'upper', 'both', None}, default: None
-            Remove edge ticks -- useful for stacked or ganged plots where
-            the upper tick of one axes overlaps with the lower tick of the
-            axes above it, primarily when :rc:`axes.autolimit_mode` is
-            ``'round_numbers'``.  If ``prune=='lower'``, the smallest tick will
-            be removed.  If ``prune == 'upper'``, the largest tick will be
-            removed.  If ``prune == 'both'``, the largest and smallest ticks
-            will be removed.  If *prune* is *None*, no ticks will be removed.
+            Remove the 'lower' tick, the 'upper' tick, or ticks on 'both' sides
+            *if they fall exactly on an axis' edge* (this typically occurs when
+            :rc:`axes.autolimit_mode` is 'round_numbers').  Removing such ticks
+            is mostly useful for stacked or ganged plots, where the upper tick
+            of an axes overlaps with the lower tick of the axes above it.
 
         min_n_ticks : int, default: 2
             Relax *nbins* and *integer* constraints if necessary to obtain

From d2d7e25ba35d6690aa80b4b673bedaed469b0b6c Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Mon, 6 Nov 2023 17:55:41 -0500
Subject: [PATCH 0417/1120] added rest of licenses to license page

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>
---
 doc/users/project/license.rst | 74 ++++++++++++++++++++++++++++++++++-
 1 file changed, 72 insertions(+), 2 deletions(-)

diff --git a/doc/users/project/license.rst b/doc/users/project/license.rst
index a55927d9f2c5..102edcb63da8 100644
--- a/doc/users/project/license.rst
+++ b/doc/users/project/license.rst
@@ -46,5 +46,75 @@ control logs.
 License agreement
 =================
 
-.. literalinclude:: ../../../LICENSE/LICENSE
-   :language: none
+.. dropdown:: License agreement for Matplotlib versions 1.3.0 and later
+   :open:
+
+   .. literalinclude:: ../../../LICENSE/LICENSE
+      :language: none
+
+
+
+Bundled software
+================
+
+.. dropdown:: JSX Tools Resize Observer
+
+   .. literalinclude:: ../../../LICENSE/LICENSE_JSXTOOLS_RESIZE_OBSERVER
+      :language: none
+
+.. dropdown:: QT4 Editor
+
+   .. literalinclude:: ../../../LICENSE/LICENSE_QT4_EDITOR
+      :language: none
+
+
+.. _licenses-cmaps-styles:
+
+Colormaps and themes
+--------------------
+
+.. dropdown:: ColorBrewer
+
+   .. literalinclude:: ../../../LICENSE/LICENSE_COLORBREWER
+      :language: none
+
+.. dropdown:: Solarized
+
+   .. literalinclude:: ../../../LICENSE/LICENSE_SOLARIZED
+      :language: none
+
+.. dropdown:: Yorick
+
+   .. literalinclude:: ../../../LICENSE/LICENSE_YORICK
+      :language: none
+
+
+.. _licenses-fonts:
+
+Fonts
+-----
+
+.. dropdown:: American Mathematical Society (AMS) fonts
+
+   .. literalinclude:: ../../../LICENSE/LICENSE_AMSFONTS
+      :language: none
+
+.. dropdown:: BaKoMa
+
+   .. literalinclude:: ../../../LICENSE/LICENSE_BAKOMA
+      :language: none
+
+.. dropdown:: Carlogo
+
+   .. literalinclude:: ../../../LICENSE/LICENSE_CARLOGO
+      :language: none
+
+.. dropdown:: Courier 10
+
+   .. literalinclude:: ../../../LICENSE/LICENSE_COURIERTEN
+      :language: none
+
+.. dropdown:: STIX
+
+   .. literalinclude:: ../../../LICENSE/LICENSE_STIX
+      :language: none

From 545d6daaa99bef1a65132aadd73f381b7ffc93db Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Mon, 6 Nov 2023 21:42:53 -0500
Subject: [PATCH 0418/1120] styling dropdown

---
 doc/_static/mpl.css           | 19 +++++++++++++++++++
 doc/users/project/license.rst | 11 +++++++++++
 2 files changed, 30 insertions(+)

diff --git a/doc/_static/mpl.css b/doc/_static/mpl.css
index 5ed418cb06c7..6f17005a810b 100644
--- a/doc/_static/mpl.css
+++ b/doc/_static/mpl.css
@@ -185,3 +185,22 @@ div.wide-table table th.stub {
 .checklist li p {
     display: inline;
 }
+
+.sdd.sd-dropdown {
+    box-shadow: none!important;
+}
+
+.sdd.sd-dropdown.sd-card{
+    border-style: solid !important;
+    border-color: var(--pst-color-border) !important;
+    border-width: thin !important;
+    border-radius: .05
+}
+
+.sdd.sd-dropdown .sd-card-header{
+    --pst-sd-dropdown-color: none;
+}
+
+.sdd.sd-dropdown .sd-card-header +.sd-card-body{
+    --pst-sd-dropdown-color: none;
+}
diff --git a/doc/users/project/license.rst b/doc/users/project/license.rst
index 102edcb63da8..3f9c1e30531b 100644
--- a/doc/users/project/license.rst
+++ b/doc/users/project/license.rst
@@ -48,6 +48,7 @@ License agreement
 
 .. dropdown:: License agreement for Matplotlib versions 1.3.0 and later
    :open:
+   :class-container: sdd
 
    .. literalinclude:: ../../../LICENSE/LICENSE
       :language: none
@@ -58,11 +59,13 @@ Bundled software
 ================
 
 .. dropdown:: JSX Tools Resize Observer
+   :class-container: sdd
 
    .. literalinclude:: ../../../LICENSE/LICENSE_JSXTOOLS_RESIZE_OBSERVER
       :language: none
 
 .. dropdown:: QT4 Editor
+   :class-container: sdd
 
    .. literalinclude:: ../../../LICENSE/LICENSE_QT4_EDITOR
       :language: none
@@ -74,16 +77,19 @@ Colormaps and themes
 --------------------
 
 .. dropdown:: ColorBrewer
+   :class-container: sdd
 
    .. literalinclude:: ../../../LICENSE/LICENSE_COLORBREWER
       :language: none
 
 .. dropdown:: Solarized
+   :class-container: sdd
 
    .. literalinclude:: ../../../LICENSE/LICENSE_SOLARIZED
       :language: none
 
 .. dropdown:: Yorick
+   :class-container: sdd
 
    .. literalinclude:: ../../../LICENSE/LICENSE_YORICK
       :language: none
@@ -95,26 +101,31 @@ Fonts
 -----
 
 .. dropdown:: American Mathematical Society (AMS) fonts
+   :class-container: sdd
 
    .. literalinclude:: ../../../LICENSE/LICENSE_AMSFONTS
       :language: none
 
 .. dropdown:: BaKoMa
+   :class-container: sdd
 
    .. literalinclude:: ../../../LICENSE/LICENSE_BAKOMA
       :language: none
 
 .. dropdown:: Carlogo
+   :class-container: sdd
 
    .. literalinclude:: ../../../LICENSE/LICENSE_CARLOGO
       :language: none
 
 .. dropdown:: Courier 10
+   :class-container: sdd
 
    .. literalinclude:: ../../../LICENSE/LICENSE_COURIERTEN
       :language: none
 
 .. dropdown:: STIX
+   :class-container: sdd
 
    .. literalinclude:: ../../../LICENSE/LICENSE_STIX
       :language: none

From c0ce04a6c32ff719ebad3d28203a188892a1af1f Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Mon, 6 Nov 2023 21:59:14 +0100
Subject: [PATCH 0419/1120] Tweak a few docstrings.

---
 lib/matplotlib/axes/_axes.py        |  5 +--
 lib/matplotlib/colors.py            | 64 ++++++++++++++---------------
 lib/matplotlib/legend.py            |  2 +-
 lib/matplotlib/projections/polar.py |  2 +-
 4 files changed, 34 insertions(+), 39 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 9199f1cafae3..2136ecb2eb94 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -3007,11 +3007,10 @@ def stem(self, *args, linefmt=None, markerfmt=None, basefmt=None, bottom=0,
             A format string defining the properties of the baseline.
 
         orientation : {'vertical', 'horizontal'}, default: 'vertical'
-            If 'vertical', will produce a plot with stems oriented vertically,
-            If 'horizontal', the stems will be oriented horizontally.
+            The orientation of the stems.
 
         bottom : float, default: 0
-            The y/x-position of the baseline (depending on orientation).
+            The y/x-position of the baseline (depending on *orientation*).
 
         label : str, default: None
             The label to use for the stems in legends.
diff --git a/lib/matplotlib/colors.py b/lib/matplotlib/colors.py
index d81f761faa78..2ce27a810a43 100644
--- a/lib/matplotlib/colors.py
+++ b/lib/matplotlib/colors.py
@@ -1245,21 +1245,19 @@ def __init__(self, vmin=None, vmax=None, clip=False):
             provided, they default to the minimum and maximum values of the input,
             respectively.
 
-
         clip : bool, default: False
             Determines the behavior for mapping values outside the range
             ``[vmin, vmax]``.
 
-            If *clip* is ``False``, values outside ``[vmin, vmax]`` are also transformed
-            linearly, leading to results outside ``[0, 1]``. For a standard use with
-            colormaps, this behavior is desired because colormaps mark these outside
-            values with specific colors for over or under.
-
-            If *clip* is ``True``, values outside ``[vmin, vmax]`` are set to 0 or 1,
-            depending on which boundary they're closer to. This makes these values
-            indistinguishable from regular boundary values and can lead to
-            misinterpretation of the data.
+            If clipping is off, values outside the range ``[vmin, vmax]`` are
+            also transformed, resulting in values outside ``[0, 1]``.  This
+            behavior is usually desirable, as colormaps can mark these *under*
+            and *over* values with specific colors.
 
+            If clipping is on, values below *vmin* are mapped to 0 and values
+            above *vmax* are mapped to 1. Such values become indistinguishable
+            from regular boundary values, which may cause misinterpretation of
+            the data.
 
         Notes
         -----
@@ -1567,15 +1565,15 @@ def __init__(self, vcenter=0, halfrange=None, clip=False):
             Determines the behavior for mapping values outside the range
             ``[vmin, vmax]``.
 
-            If clipping is off, values outside the range ``[vmin, vmax]`` are also
-            transformed, resulting in values outside ``[0, 1]``. For a
-            standard use with colormaps, this behavior is desired because colormaps
-            mark these outside values with specific colors for *over* or *under*.
+            If clipping is off, values outside the range ``[vmin, vmax]`` are
+            also transformed, resulting in values outside ``[0, 1]``.  This
+            behavior is usually desirable, as colormaps can mark these *under*
+            and *over* values with specific colors.
 
-            If ``True`` values falling outside the range ``[vmin, vmax]``,
-            are mapped to 0 or 1, whichever is closer. This makes these values
-            indistinguishable from regular boundary values and can lead to
-            misinterpretation of the data.
+            If clipping is on, values below *vmin* are mapped to 0 and values
+            above *vmax* are mapped to 1. Such values become indistinguishable
+            from regular boundary values, which may cause misinterpretation of
+            the data.
 
         Examples
         --------
@@ -1852,14 +1850,13 @@ def forward(values: array-like) -> array-like
         ``[vmin, vmax]``.
 
         If clipping is off, values outside the range ``[vmin, vmax]`` are also
-        transformed by the function, resulting in values outside ``[0, 1]``. For a
-        standard use with colormaps, this behavior is desired because colormaps
-        mark these outside values with specific colors for *over* or *under*.
-
-        If ``True`` values falling outside the range ``[vmin, vmax]``,
-        are mapped to 0 or 1, whichever is closer. This makes these values
-        indistinguishable from regular boundary values and can lead to
-        misinterpretation of the data.
+        transformed by the function, resulting in values outside ``[0, 1]``.
+        This behavior is usually desirable, as colormaps can mark these *under*
+        and *over* values with specific colors.
+
+        If clipping is on, values below *vmin* are mapped to 0 and values above
+        *vmax* are mapped to 1. Such values become indistinguishable from
+        regular boundary values, which may cause misinterpretation of the data.
     """
 
 
@@ -1957,14 +1954,13 @@ class PowerNorm(Normalize):
         ``[vmin, vmax]``.
 
         If clipping is off, values outside the range ``[vmin, vmax]`` are also
-        transformed by the power function, resulting in values outside ``[0, 1]``. For
-        a standard use with colormaps, this behavior is desired because colormaps
-        mark these outside values with specific colors for *over* or *under*.
-
-        If ``True`` values falling outside the range ``[vmin, vmax]``,
-        are mapped to 0 or 1, whichever is closer. This makes these values
-        indistinguishable from regular boundary values and can lead to
-        misinterpretation of the data.
+        transformed by the power function, resulting in values outside ``[0, 1]``.
+        This behavior is usually desirable, as colormaps can mark these *under*
+        and *over* values with specific colors.
+
+        If clipping is on, values below *vmin* are mapped to 0 and values above
+        *vmax* are mapped to 1. Such values become indistinguishable from
+        regular boundary values, which may cause misinterpretation of the data.
 
     Notes
     -----
diff --git a/lib/matplotlib/legend.py b/lib/matplotlib/legend.py
index c46770974567..93ec3d32c0b7 100644
--- a/lib/matplotlib/legend.py
+++ b/lib/matplotlib/legend.py
@@ -194,7 +194,7 @@ def _update_bbox_to_anchor(self, loc_in_canvas):
 
 edgecolor : "inherit" or color, default: :rc:`legend.edgecolor`
     The legend's background patch edge color.
-    If ``"inherit"``, use take :rc:`axes.edgecolor`.
+    If ``"inherit"``, use :rc:`axes.edgecolor`.
 
 mode : {"expand", None}
     If *mode* is set to ``"expand"`` the legend will be horizontally
diff --git a/lib/matplotlib/projections/polar.py b/lib/matplotlib/projections/polar.py
index f6fa0ea7b982..25338bca021f 100644
--- a/lib/matplotlib/projections/polar.py
+++ b/lib/matplotlib/projections/polar.py
@@ -201,7 +201,7 @@ def __init__(self, axis=None, use_rmin=True,
             Axis associated with this transform. This is used to get the
             minimum radial limit.
         use_rmin : `bool`, optional
-            If ``True`` add the minimum radial axis limit after
+            If ``True``, add the minimum radial axis limit after
             transforming from Cartesian coordinates. *axis* must also be
             specified for this to take effect.
         """

From ab70fac168df44cd456389092527af8c2d6e3d68 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Sun, 15 Oct 2023 17:40:47 +0200
Subject: [PATCH 0420/1120] axisartist cleanups.

Mostly just unwrapping long lists of arguments into a single line where
possible.
---
 lib/mpl_toolkits/axisartist/axislines.py      | 47 +++++--------------
 lib/mpl_toolkits/axisartist/floating_axes.py  | 22 ++-------
 .../axisartist/grid_helper_curvelinear.py     | 24 ++--------
 3 files changed, 22 insertions(+), 71 deletions(-)

diff --git a/lib/mpl_toolkits/axisartist/axislines.py b/lib/mpl_toolkits/axisartist/axislines.py
index cbcdefe38f7c..ced2703d1ed6 100644
--- a/lib/mpl_toolkits/axisartist/axislines.py
+++ b/lib/mpl_toolkits/axisartist/axislines.py
@@ -153,12 +153,10 @@ def get_axislabel_pos_angle(self, axes):
     # TICK
 
     def get_tick_transform(self, axes):
-        return [axes.get_xaxis_transform(),
-                axes.get_yaxis_transform()][self.nth_coord]
+        return [axes.get_xaxis_transform(), axes.get_yaxis_transform()][self.nth_coord]
 
 
 class _FloatingAxisArtistHelperBase(_AxisArtistHelperBase):
-
     def __init__(self, nth_coord, value):
         self.nth_coord = nth_coord
         self._value = value
@@ -168,8 +166,7 @@ def get_nth_coord(self):
         return self.nth_coord
 
     def get_line(self, axes):
-        raise RuntimeError(
-            "get_line method should be defined by the derived class")
+        raise RuntimeError("get_line method should be defined by the derived class")
 
 
 class FixedAxisArtistHelperRectilinear(_FixedAxisArtistHelperBase):
@@ -187,10 +184,7 @@ def __init__(self, axes, loc, nth_coord=None):
 
     def get_tick_iterators(self, axes):
         """tick_loc, tick_angle, tick_label"""
-        if self._loc in ["bottom", "top"]:
-            angle_normal, angle_tangent = 90, 0
-        else:  # "left", "right"
-            angle_normal, angle_tangent = 0, 90
+        angle_normal, angle_tangent = {0: (90, 0), 1: (0, 90)}[self.nth_coord]
 
         major = self.axis.major
         major_locs = major.locator()
@@ -207,8 +201,7 @@ def _f(locs, labels):
                 c = self._to_xy(loc, const=self._pos)
                 # check if the tick point is inside axes
                 c2 = tick_to_axes.transform(c)
-                if mpl.transforms._interval_contains_close(
-                        (0, 1), c2[self.nth_coord]):
+                if mpl.transforms._interval_contains_close((0, 1), c2[self.nth_coord]):
                     yield c, angle_normal, angle_tangent, label
 
         return _f(major_locs, major_labels), _f(minor_locs, minor_labels)
@@ -245,20 +238,14 @@ def get_axislabel_pos_angle(self, axes):
         data_to_axes = axes.transData - axes.transAxes
         p = data_to_axes.transform([self._value, self._value])
         verts = self._to_xy(0.5, const=p[fixed_coord])
-        if 0 <= verts[fixed_coord] <= 1:
-            return verts, angle
-        else:
-            return None, None
+        return (verts, angle) if 0 <= verts[fixed_coord] <= 1 else (None, None)
 
     def get_tick_transform(self, axes):
         return axes.transData
 
     def get_tick_iterators(self, axes):
         """tick_loc, tick_angle, tick_label"""
-        if self.nth_coord == 0:
-            angle_normal, angle_tangent = 90, 0
-        else:
-            angle_normal, angle_tangent = 0, 90
+        angle_normal, angle_tangent = {0: (90, 0), 1: (0, 90)}[self.nth_coord]
 
         major = self.axis.major
         major_locs = major.locator()
@@ -326,27 +313,18 @@ def __init__(self, axes):
 
     @_api.delete_parameter(
         "3.9", "nth_coord", addendum="'nth_coord' is now inferred from 'loc'.")
-    def new_fixed_axis(self, loc,
-                       nth_coord=None,
-                       axis_direction=None,
-                       offset=None,
-                       axes=None,
-                       ):
+    def new_fixed_axis(
+            self, loc, nth_coord=None, axis_direction=None, offset=None, axes=None):
         if axes is None:
             _api.warn_external(
                 "'new_fixed_axis' explicitly requires the axes keyword.")
             axes = self.axes
         if axis_direction is None:
             axis_direction = loc
-        helper = FixedAxisArtistHelperRectilinear(axes, loc)
-        axisline = AxisArtist(axes, helper, offset=offset,
-                              axis_direction=axis_direction)
-        return axisline
+        return AxisArtist(axes, FixedAxisArtistHelperRectilinear(axes, loc),
+                          offset=offset, axis_direction=axis_direction)
 
-    def new_floating_axis(self, nth_coord, value,
-                          axis_direction="bottom",
-                          axes=None,
-                          ):
+    def new_floating_axis(self, nth_coord, value, axis_direction="bottom", axes=None):
         if axes is None:
             _api.warn_external(
                 "'new_floating_axis' explicitly requires the axes keyword.")
@@ -404,8 +382,7 @@ def __call__(self, *args, **kwargs):
 
     def __init__(self, *args, grid_helper=None, **kwargs):
         self._axisline_on = True
-        self._grid_helper = (grid_helper if grid_helper
-                             else GridHelperRectlinear(self))
+        self._grid_helper = grid_helper if grid_helper else GridHelperRectlinear(self)
         super().__init__(*args, **kwargs)
         self.toggle_axisline(True)
 
diff --git a/lib/mpl_toolkits/axisartist/floating_axes.py b/lib/mpl_toolkits/axisartist/floating_axes.py
index 306ae2c5139a..24c9ce61afa7 100644
--- a/lib/mpl_toolkits/axisartist/floating_axes.py
+++ b/lib/mpl_toolkits/axisartist/floating_axes.py
@@ -158,11 +158,8 @@ def get_data_boundary(self, side):
                     bottom=(lat1, 1),
                     top=(lat2, 1))[side]
 
-    def new_fixed_axis(self, loc,
-                       nth_coord=None,
-                       axis_direction=None,
-                       offset=None,
-                       axes=None):
+    def new_fixed_axis(
+            self, loc, nth_coord=None, axis_direction=None, offset=None, axes=None):
         if axes is None:
             axes = self.axes
         if axis_direction is None:
@@ -179,23 +176,16 @@ def new_fixed_axis(self, loc,
 
     # new_floating_axis will inherit the grid_helper's extremes.
 
-    # def new_floating_axis(self, nth_coord,
-    #                       value,
-    #                       axes=None,
-    #                       axis_direction="bottom"
-    #                       ):
-
+    # def new_floating_axis(self, nth_coord, value, axes=None, axis_direction="bottom"):
     #     axis = super(GridHelperCurveLinear,
     #                  self).new_floating_axis(nth_coord,
     #                                          value, axes=axes,
     #                                          axis_direction=axis_direction)
-
     #     # set extreme values of the axis helper
     #     if nth_coord == 1:
     #         axis.get_helper().set_extremes(*self._extremes[:2])
     #     elif nth_coord == 0:
     #         axis.get_helper().set_extremes(*self._extremes[2:])
-
     #     return axis
 
     def _update_grid(self, x1, y1, x2, y2):
@@ -291,8 +281,6 @@ def adjust_axes_lim(self):
         self.set_ylim(bbox.ymin, bbox.ymax)
 
 
-floatingaxes_class_factory = cbook._make_class_factory(
-    FloatingAxesBase, "Floating{}")
-FloatingAxes = floatingaxes_class_factory(
-    host_axes_class_factory(axislines.Axes))
+floatingaxes_class_factory = cbook._make_class_factory(FloatingAxesBase, "Floating{}")
+FloatingAxes = floatingaxes_class_factory(host_axes_class_factory(axislines.Axes))
 FloatingSubplot = FloatingAxes
diff --git a/lib/mpl_toolkits/axisartist/grid_helper_curvelinear.py b/lib/mpl_toolkits/axisartist/grid_helper_curvelinear.py
index d34a848780e3..08031122c03b 100644
--- a/lib/mpl_toolkits/axisartist/grid_helper_curvelinear.py
+++ b/lib/mpl_toolkits/axisartist/grid_helper_curvelinear.py
@@ -272,11 +272,8 @@ def update_grid_finder(self, aux_trans=None, **kwargs):
         self._old_limits = None  # Force revalidation.
 
     @_api.make_keyword_only("3.9", "nth_coord")
-    def new_fixed_axis(self, loc,
-                       nth_coord=None,
-                       axis_direction=None,
-                       offset=None,
-                       axes=None):
+    def new_fixed_axis(
+            self, loc, nth_coord=None, axis_direction=None, offset=None, axes=None):
         if axes is None:
             axes = self.axes
         if axis_direction is None:
@@ -287,11 +284,7 @@ def new_fixed_axis(self, loc,
         # the floating_axig.GridHelperCurveLinear subclass?
         return axisline
 
-    def new_floating_axis(self, nth_coord,
-                          value,
-                          axes=None,
-                          axis_direction="bottom"
-                          ):
+    def new_floating_axis(self, nth_coord, value, axes=None, axis_direction="bottom"):
         if axes is None:
             axes = self.axes
         helper = FloatingAxisArtistHelper(
@@ -317,22 +310,15 @@ def get_gridlines(self, which="major", axis="both"):
         return grid_lines
 
     def get_tick_iterator(self, nth_coord, axis_side, minor=False):
-
-        # axisnr = dict(left=0, bottom=1, right=2, top=3)[axis_side]
         angle_tangent = dict(left=90, right=90, bottom=0, top=0)[axis_side]
-        # angle = [0, 90, 180, 270][axisnr]
         lon_or_lat = ["lon", "lat"][nth_coord]
         if not minor:  # major ticks
-            for (xy, a), l in zip(
+            for (xy, angle_normal), l in zip(
                     self._grid_info[lon_or_lat]["tick_locs"][axis_side],
                     self._grid_info[lon_or_lat]["tick_labels"][axis_side]):
-                angle_normal = a
                 yield xy, angle_normal, angle_tangent, l
         else:
-            for (xy, a), l in zip(
+            for (xy, angle_normal), l in zip(
                     self._grid_info[lon_or_lat]["tick_locs"][axis_side],
                     self._grid_info[lon_or_lat]["tick_labels"][axis_side]):
-                angle_normal = a
                 yield xy, angle_normal, angle_tangent, ""
-            # for xy, a, l in self._grid_info[lon_or_lat]["ticks"][axis_side]:
-            #     yield xy, a, ""

From 92de753e9c918b2bd590c2f7cfc0bf04a366e5c9 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Sat, 28 Oct 2023 13:12:03 +0200
Subject: [PATCH 0421/1120] Shorten contour._make_paths_from_contour_generator.

---
 lib/matplotlib/contour.py | 22 +++++++---------------
 1 file changed, 7 insertions(+), 15 deletions(-)

diff --git a/lib/matplotlib/contour.py b/lib/matplotlib/contour.py
index 49f87edc3907..42970a9b26df 100644
--- a/lib/matplotlib/contour.py
+++ b/lib/matplotlib/contour.py
@@ -1114,22 +1114,14 @@ def _make_paths_from_contour_generator(self):
         """Compute ``paths`` using C extension."""
         if self._paths is not None:
             return self._paths
-        paths = []
+        cg = self._contour_generator
         empty_path = Path(np.empty((0, 2)))
-        if self.filled:
-            lowers, uppers = self._get_lowers_and_uppers()
-            for level, level_upper in zip(lowers, uppers):
-                vertices, kinds = \
-                    self._contour_generator.create_filled_contour(
-                        level, level_upper)
-                paths.append(Path(np.concatenate(vertices), np.concatenate(kinds))
-                             if len(vertices) else empty_path)
-        else:
-            for level in self.levels:
-                vertices, kinds = self._contour_generator.create_contour(level)
-                paths.append(Path(np.concatenate(vertices), np.concatenate(kinds))
-                             if len(vertices) else empty_path)
-        return paths
+        vertices_and_codes = (
+            map(cg.create_filled_contour, *self._get_lowers_and_uppers())
+            if self.filled else
+            map(cg.create_contour, self.levels))
+        return [Path(np.concatenate(vs), np.concatenate(cs)) if len(vs) else empty_path
+                for vs, cs in vertices_and_codes]
 
     def _get_lowers_and_uppers(self):
         """

From 3bd9abe6b366afb86fe6ae2b5b350d43c15f6d9e Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Sun, 29 Oct 2023 00:10:03 +0200
Subject: [PATCH 0422/1120] Factor out common parts of qt and macos interrupt
 handling.

Note that we don't actually need to disable the QSocketNotifier at the
end, just letting it go out of scope should be sufficient as its
destructor also does that (see qsocketnotifier.cpp).
---
 lib/matplotlib/backend_bases.py           | 60 +++++++++++++++++++
 lib/matplotlib/backends/backend_macosx.py | 61 ++++---------------
 lib/matplotlib/backends/backend_qt.py     | 43 +++++++++++--
 lib/matplotlib/backends/qt_compat.py      | 73 -----------------------
 4 files changed, 108 insertions(+), 129 deletions(-)

diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
index a411cfbe3a4a..fd055fd7015d 100644
--- a/lib/matplotlib/backend_bases.py
+++ b/lib/matplotlib/backend_bases.py
@@ -35,6 +35,8 @@
 import itertools
 import logging
 import os
+import signal
+import socket
 import sys
 import time
 import weakref
@@ -1651,6 +1653,64 @@ def _is_non_interactive_terminal_ipython(ip):
             and getattr(ip.parent, 'interact', None) is False)
 
 
+@contextmanager
+def _allow_interrupt(prepare_notifier, handle_sigint):
+    """
+    A context manager that allows terminating a plot by sending a SIGINT.  It
+    is necessary because the running backend prevents the Python interpreter
+    from running and processing signals (i.e., to raise a KeyboardInterrupt).
+    To solve this, one needs to somehow wake up the interpreter and make it
+    close the plot window.  We do this by using the signal.set_wakeup_fd()
+    function which organizes a write of the signal number into a socketpair.
+    A backend-specific function, *prepare_notifier*, arranges to listen to
+    the pair's read socket while the event loop is running.  (If it returns a
+    notifier object, that object is kept alive while the context manager runs.)
+
+    If SIGINT was indeed caught, after exiting the on_signal() function the
+    interpreter reacts to the signal according to the handler function which
+    had been set up by a signal.signal() call; here, we arrange to call the
+    backend-specific *handle_sigint* function.  Finally, we call the old SIGINT
+    handler with the same arguments that were given to our custom handler.
+
+    We do this only if the old handler for SIGINT was not None, which means
+    that a non-python handler was installed, i.e. in Julia, and not SIG_IGN
+    which means we should ignore the interrupts.
+
+    Parameters
+    ----------
+    prepare_notifier : Callable[[socket.socket], object]
+    handle_sigint : Callable[[], object]
+    """
+
+    old_sigint_handler = signal.getsignal(signal.SIGINT)
+    if old_sigint_handler in (None, signal.SIG_IGN, signal.SIG_DFL):
+        yield
+        return
+
+    handler_args = None
+    wsock, rsock = socket.socketpair()
+    wsock.setblocking(False)
+    rsock.setblocking(False)
+    old_wakeup_fd = signal.set_wakeup_fd(wsock.fileno())
+    notifier = prepare_notifier(rsock)
+
+    def save_args_and_handle_sigint(*args):
+        nonlocal handler_args
+        handler_args = args
+        handle_sigint()
+
+    signal.signal(signal.SIGINT, save_args_and_handle_sigint)
+    try:
+        yield
+    finally:
+        wsock.close()
+        rsock.close()
+        signal.set_wakeup_fd(old_wakeup_fd)
+        signal.signal(signal.SIGINT, old_sigint_handler)
+        if handler_args is not None:
+            old_sigint_handler(*handler_args)
+
+
 class FigureCanvasBase:
     """
     The canvas the figure renders into.
diff --git a/lib/matplotlib/backends/backend_macosx.py b/lib/matplotlib/backends/backend_macosx.py
index a39f5b5b1497..822cd22ba6c7 100644
--- a/lib/matplotlib/backends/backend_macosx.py
+++ b/lib/matplotlib/backends/backend_macosx.py
@@ -1,7 +1,4 @@
-import contextlib
 import os
-import signal
-import socket
 
 import matplotlib as mpl
 from matplotlib import _api, cbook
@@ -10,7 +7,7 @@
 from .backend_agg import FigureCanvasAgg
 from matplotlib.backend_bases import (
     _Backend, FigureCanvasBase, FigureManagerBase, NavigationToolbar2,
-    ResizeEvent, TimerBase)
+    ResizeEvent, TimerBase, _allow_interrupt)
 
 
 class TimerMac(_macosx.Timer, TimerBase):
@@ -18,6 +15,12 @@ class TimerMac(_macosx.Timer, TimerBase):
     # completely implemented at the C-level (in _macosx.Timer)
 
 
+def _allow_interrupt_macos():
+    """A context manager that allows terminating a plot by sending a SIGINT."""
+    return _allow_interrupt(
+        lambda rsock: _macosx.wake_on_fd_write(rsock.fileno()), _macosx.stop)
+
+
 class FigureCanvasMac(FigureCanvasAgg, _macosx.FigureCanvas, FigureCanvasBase):
     # docstring inherited
 
@@ -109,10 +112,9 @@ def resize(self, width, height):
 
     def start_event_loop(self, timeout=0):
         # docstring inherited
-        with _maybe_allow_interrupt():
-            # Call the objc implementation of the event loop after
-            # setting up the interrupt handling
-            self._start_event_loop(timeout=timeout)
+        # Set up a SIGINT handler to allow terminating a plot via CTRL-C.
+        with _allow_interrupt_macos():
+            self._start_event_loop(timeout=timeout)  # Forward to ObjC implementation.
 
 
 class NavigationToolbar2Mac(_macosx.NavigationToolbar2, NavigationToolbar2):
@@ -177,9 +179,7 @@ def destroy(self):
     @classmethod
     def start_main_loop(cls):
         # Set up a SIGINT handler to allow terminating a plot via CTRL-C.
-        # The logic is largely copied from qt_compat._maybe_allow_interrupt; see its
-        # docstring for details.  Parts are implemented by wake_on_fd_write in ObjC.
-        with _maybe_allow_interrupt():
+        with _allow_interrupt_macos():
             _macosx.show()
 
     def show(self):
@@ -190,45 +190,6 @@ def show(self):
             self._raise()
 
 
-@contextlib.contextmanager
-def _maybe_allow_interrupt():
-    """
-    This manager allows to terminate a plot by sending a SIGINT. It is
-    necessary because the running backend prevents Python interpreter to
-    run and process signals (i.e., to raise KeyboardInterrupt exception). To
-    solve this one needs to somehow wake up the interpreter and make it close
-    the plot window. The implementation is taken from qt_compat, see that
-    docstring for a more detailed description.
-    """
-    old_sigint_handler = signal.getsignal(signal.SIGINT)
-    if old_sigint_handler in (None, signal.SIG_IGN, signal.SIG_DFL):
-        yield
-        return
-
-    handler_args = None
-    wsock, rsock = socket.socketpair()
-    wsock.setblocking(False)
-    rsock.setblocking(False)
-    old_wakeup_fd = signal.set_wakeup_fd(wsock.fileno())
-    _macosx.wake_on_fd_write(rsock.fileno())
-
-    def handle(*args):
-        nonlocal handler_args
-        handler_args = args
-        _macosx.stop()
-
-    signal.signal(signal.SIGINT, handle)
-    try:
-        yield
-    finally:
-        wsock.close()
-        rsock.close()
-        signal.set_wakeup_fd(old_wakeup_fd)
-        signal.signal(signal.SIGINT, old_sigint_handler)
-        if handler_args is not None:
-            old_sigint_handler(*handler_args)
-
-
 @_Backend.export
 class _BackendMac(_Backend):
     FigureCanvas = FigureCanvasMac
diff --git a/lib/matplotlib/backends/backend_qt.py b/lib/matplotlib/backends/backend_qt.py
index cbc490ef6cd1..273a746d0b79 100644
--- a/lib/matplotlib/backends/backend_qt.py
+++ b/lib/matplotlib/backends/backend_qt.py
@@ -9,13 +9,12 @@
 from matplotlib.backend_bases import (
     _Backend, FigureCanvasBase, FigureManagerBase, NavigationToolbar2,
     TimerBase, cursors, ToolContainerBase, MouseButton,
-    CloseEvent, KeyEvent, LocationEvent, MouseEvent, ResizeEvent)
+    CloseEvent, KeyEvent, LocationEvent, MouseEvent, ResizeEvent,
+    _allow_interrupt)
 import matplotlib.backends.qt_editor.figureoptions as figureoptions
 from . import qt_compat
 from .qt_compat import (
-    QtCore, QtGui, QtWidgets, __version__, QT_API,
-    _to_int, _isdeleted, _maybe_allow_interrupt
-)
+    QtCore, QtGui, QtWidgets, __version__, QT_API, _to_int, _isdeleted)
 
 
 # SPECIAL_KEYS are Qt::Key that do *not* return their Unicode name
@@ -148,6 +147,38 @@ def _create_qApp():
     return app
 
 
+def _allow_interrupt_qt(qapp_or_eventloop):
+    """A context manager that allows terminating a plot by sending a SIGINT."""
+
+    # Use QSocketNotifier to read the socketpair while the Qt event loop runs.
+
+    def prepare_notifier(rsock):
+        sn = QtCore.QSocketNotifier(rsock.fileno(), QtCore.QSocketNotifier.Type.Read)
+
+        @sn.activated.connect
+        def _may_clear_sock():
+            # Running a Python function on socket activation gives the interpreter a
+            # chance to handle the signal in Python land.  We also need to drain the
+            # socket with recv() to re-arm it, because it will be written to as part of
+            # the wakeup.  (We need this in case set_wakeup_fd catches a signal other
+            # than SIGINT and we shall continue waiting.)
+            try:
+                rsock.recv(1)
+            except BlockingIOError:
+                # This may occasionally fire too soon or more than once on Windows, so
+                # be forgiving about reading an empty socket.
+                pass
+
+        return sn  # Actually keep the notifier alive.
+
+    def handle_sigint():
+        if hasattr(qapp_or_eventloop, 'closeAllWindows'):
+            qapp_or_eventloop.closeAllWindows()
+        qapp_or_eventloop.quit()
+
+    return _allow_interrupt(prepare_notifier, handle_sigint)
+
+
 class TimerQT(TimerBase):
     """Subclass of `.TimerBase` using QTimer events."""
 
@@ -417,7 +448,7 @@ def start_event_loop(self, timeout=0):
         if timeout > 0:
             _ = QtCore.QTimer.singleShot(int(timeout * 1000), event_loop.quit)
 
-        with _maybe_allow_interrupt(event_loop):
+        with _allow_interrupt_qt(event_loop):
             qt_compat._exec(event_loop)
 
     def stop_event_loop(self, event=None):
@@ -598,7 +629,7 @@ def resize(self, width, height):
     def start_main_loop(cls):
         qapp = QtWidgets.QApplication.instance()
         if qapp:
-            with _maybe_allow_interrupt(qapp):
+            with _allow_interrupt_qt(qapp):
                 qt_compat._exec(qapp)
 
     def show(self):
diff --git a/lib/matplotlib/backends/qt_compat.py b/lib/matplotlib/backends/qt_compat.py
index 98f9f9572d69..d91f7c14cb22 100644
--- a/lib/matplotlib/backends/qt_compat.py
+++ b/lib/matplotlib/backends/qt_compat.py
@@ -13,9 +13,6 @@
 import os
 import platform
 import sys
-import signal
-import socket
-import contextlib
 
 from packaging.version import parse as parse_version
 
@@ -160,73 +157,3 @@ def _isdeleted(obj):
 def _exec(obj):
     # exec on PyQt6, exec_ elsewhere.
     obj.exec() if hasattr(obj, "exec") else obj.exec_()
-
-
-@contextlib.contextmanager
-def _maybe_allow_interrupt(qapp_or_eventloop):
-    """
-    This manager allows to terminate a plot by sending a SIGINT. It is
-    necessary because the running Qt backend prevents Python interpreter to
-    run and process signals (i.e., to raise KeyboardInterrupt exception). To
-    solve this one needs to somehow wake up the interpreter and make it close
-    the plot window. We do this by using the signal.set_wakeup_fd() function
-    which organizes a write of the signal number into a socketpair connected
-    to the QSocketNotifier (since it is part of the Qt backend, it can react
-    to that write event). Afterwards, the Qt handler empties the socketpair
-    by a recv() command to re-arm it (we need this if a signal different from
-    SIGINT was caught by set_wakeup_fd() and we shall continue waiting). If
-    the SIGINT was caught indeed, after exiting the on_signal() function the
-    interpreter reacts to the SIGINT according to the handle() function which
-    had been set up by a signal.signal() call: it causes the qt_object to
-    exit by calling its quit() method. Finally, we call the old SIGINT
-    handler with the same arguments that were given to our custom handle()
-    handler.
-
-    We do this only if the old handler for SIGINT was not None, which means
-    that a non-python handler was installed, i.e. in Julia, and not SIG_IGN
-    which means we should ignore the interrupts.
-    """
-
-    old_sigint_handler = signal.getsignal(signal.SIGINT)
-    if old_sigint_handler in (None, signal.SIG_IGN, signal.SIG_DFL):
-        yield
-        return
-
-    handler_args = None
-    wsock, rsock = socket.socketpair()
-    wsock.setblocking(False)
-    rsock.setblocking(False)
-    old_wakeup_fd = signal.set_wakeup_fd(wsock.fileno())
-    sn = QtCore.QSocketNotifier(rsock.fileno(), QtCore.QSocketNotifier.Type.Read)
-
-    # We do not actually care about this value other than running some Python code to
-    # ensure that the interpreter has a chance to handle the signal in Python land.  We
-    # also need to drain the socket because it will be written to as part of the wakeup!
-    # There are some cases where this may fire too soon / more than once on Windows so
-    # we should be forgiving about reading an empty socket.
-    # Clear the socket to re-arm the notifier.
-    @sn.activated.connect
-    def _may_clear_sock(*args):
-        try:
-            rsock.recv(1)
-        except BlockingIOError:
-            pass
-
-    def handle(*args):
-        nonlocal handler_args
-        handler_args = args
-        if hasattr(qapp_or_eventloop, 'closeAllWindows'):
-            qapp_or_eventloop.closeAllWindows()
-        qapp_or_eventloop.quit()
-
-    signal.signal(signal.SIGINT, handle)
-    try:
-        yield
-    finally:
-        wsock.close()
-        rsock.close()
-        sn.setEnabled(False)
-        signal.set_wakeup_fd(old_wakeup_fd)
-        signal.signal(signal.SIGINT, old_sigint_handler)
-        if handler_args is not None:
-            old_sigint_handler(*handler_args)

From df4480c18a0f465fec0b4fc873f1dbb1a9576323 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Tue, 7 Nov 2023 09:01:05 +0100
Subject: [PATCH 0423/1120] Shorten dviread helper definitions.

---
 lib/matplotlib/dviread.py | 80 +++++++++++----------------------------
 1 file changed, 22 insertions(+), 58 deletions(-)

diff --git a/lib/matplotlib/dviread.py b/lib/matplotlib/dviread.py
index b2177e5087bc..ee2032b17be3 100644
--- a/lib/matplotlib/dviread.py
+++ b/lib/matplotlib/dviread.py
@@ -125,64 +125,28 @@ def glyph_name_or_index(self):
 
 # Opcode argument parsing
 #
-# Each of the following functions takes a Dvi object and delta,
-# which is the difference between the opcode and the minimum opcode
-# with the same meaning. Dvi opcodes often encode the number of
-# argument bytes in this delta.
-
-def _arg_raw(dvi, delta):
-    """Return *delta* without reading anything more from the dvi file."""
-    return delta
-
-
-def _arg(nbytes, signed, dvi, _):
-    """
-    Read *nbytes* bytes, returning the bytes interpreted as a signed integer
-    if *signed* is true, unsigned otherwise.
-    """
-    return dvi._arg(nbytes, signed)
-
-
-def _arg_slen(dvi, delta):
-    """
-    Read *delta* bytes, returning None if *delta* is zero, and the bytes
-    interpreted as a signed integer otherwise.
-    """
-    if delta == 0:
-        return None
-    return dvi._arg(delta, True)
-
-
-def _arg_slen1(dvi, delta):
-    """
-    Read *delta*+1 bytes, returning the bytes interpreted as signed.
-    """
-    return dvi._arg(delta + 1, True)
-
-
-def _arg_ulen1(dvi, delta):
-    """
-    Read *delta*+1 bytes, returning the bytes interpreted as unsigned.
-    """
-    return dvi._arg(delta + 1, False)
-
-
-def _arg_olen1(dvi, delta):
-    """
-    Read *delta*+1 bytes, returning the bytes interpreted as
-    unsigned integer for 0<=*delta*<3 and signed if *delta*==3.
-    """
-    return dvi._arg(delta + 1, delta == 3)
-
-
-_arg_mapping = dict(raw=_arg_raw,
-                    u1=partial(_arg, 1, False),
-                    u4=partial(_arg, 4, False),
-                    s4=partial(_arg, 4, True),
-                    slen=_arg_slen,
-                    olen1=_arg_olen1,
-                    slen1=_arg_slen1,
-                    ulen1=_arg_ulen1)
+# Each of the following functions takes a Dvi object and delta, which is the
+# difference between the opcode and the minimum opcode with the same meaning.
+# Dvi opcodes often encode the number of argument bytes in this delta.
+_arg_mapping = dict(
+    # raw: Return delta as is.
+    raw=lambda dvi, delta: delta,
+    # u1: Read 1 byte as an unsigned number.
+    u1=lambda dvi, delta: dvi._arg(1, signed=False),
+    # u4: Read 4 bytes as an unsigned number.
+    u4=lambda dvi, delta: dvi._arg(4, signed=False),
+    # s4: Read 4 bytes as a signed number.
+    s4=lambda dvi, delta: dvi._arg(4, signed=True),
+    # slen: Read delta bytes as a signed number, or None if delta is None.
+    slen=lambda dvi, delta: dvi._arg(delta, signed=True) if delta else None,
+    # slen1: Read (delta + 1) bytes as a signed number.
+    slen1=lambda dvi, delta: dvi._arg(delta + 1, signed=True),
+    # ulen1: Read (delta + 1) bytes as an unsigned number.
+    ulen1=lambda dvi, delta: dvi._arg(delta + 1, signed=False),
+    # olen1: Read (delta + 1) bytes as an unsigned number if less than 4 bytes,
+    # as a signed number if 4 bytes.
+    olen1=lambda dvi, delta: dvi._arg(delta + 1, signed=(delta == 3)),
+)
 
 
 def _dispatch(table, min, max=None, state=None, args=('raw',)):

From 907f0b75b3742f7458fd832a0e14750e0e8ef902 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Wed, 8 Nov 2023 20:30:15 +0100
Subject: [PATCH 0424/1120] Use int.from_bytes instead of implementing the
 conversion ourselves.

int.from_bytes has been around since Python 3.2.
---
 lib/matplotlib/dviread.py | 10 ++--------
 1 file changed, 2 insertions(+), 8 deletions(-)

diff --git a/lib/matplotlib/dviread.py b/lib/matplotlib/dviread.py
index b2177e5087bc..e60c684f8c3a 100644
--- a/lib/matplotlib/dviread.py
+++ b/lib/matplotlib/dviread.py
@@ -392,16 +392,10 @@ def _read(self):
 
     def _arg(self, nbytes, signed=False):
         """
-        Read and return an integer argument *nbytes* long.
+        Read and return a big-endian integer *nbytes* long.
         Signedness is determined by the *signed* keyword.
         """
-        buf = self.file.read(nbytes)
-        value = buf[0]
-        if signed and value >= 0x80:
-            value = value - 0x100
-        for b in buf[1:]:
-            value = 0x100*value + b
-        return value
+        return int.from_bytes(self.file.read(nbytes), "big", signed=signed)
 
     @_dispatch(min=0, max=127, state=_dvistate.inpage)
     def _set_char_immediate(self, char):

From ca62d0b4249fc7c238baf7cbbed04fc74774f821 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Mon, 6 Nov 2023 11:17:05 -0500
Subject: [PATCH 0425/1120] MAINT: fix .yml in tag issue template

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>
---
 .github/ISSUE_TEMPLATE/tag_proposal.yml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.github/ISSUE_TEMPLATE/tag_proposal.yml b/.github/ISSUE_TEMPLATE/tag_proposal.yml
index 1e3bceedf70c..6876226f6240 100644
--- a/.github/ISSUE_TEMPLATE/tag_proposal.yml
+++ b/.github/ISSUE_TEMPLATE/tag_proposal.yml
@@ -23,4 +23,5 @@ body:
     id: solution
     attributes:
       label: Proposed solution
-      description: What should the tag be? All tags are in the format `subcategory: tag`
+      description: >
+        What should the tag be? All tags are in the format `subcategory: tag`

From 072226aca1787cd57b577a76d69d5fe7ad3df19a Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Wed, 8 Nov 2023 16:29:05 -0600
Subject: [PATCH 0426/1120] Ensure GIL while releasing buffer

---
 src/_macosx.m | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/_macosx.m b/src/_macosx.m
index 6df00d0eca8e..a580362f676f 100755
--- a/src/_macosx.m
+++ b/src/_macosx.m
@@ -1132,8 +1132,10 @@ - (void)setCanvas: (PyObject*)newCanvas
 }
 
 static void _buffer_release(void* info, const void* data, size_t size) {
+    PyGILState_STATE gstate = PyGILState_Ensure();
     PyBuffer_Release((Py_buffer *)info);
     free(info);
+    PyGILState_Release(gstate);
 }
 
 static int _copy_agg_buffer(CGContextRef cr, PyObject *renderer)

From cde6baf25ca55aabb8ad031c7b42d38e37a6f1ac Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Wed, 8 Nov 2023 17:20:37 -0600
Subject: [PATCH 0427/1120] Expand 3D import to handle any exception not just
 ImportError

Needed for the same reasons as #27178 (Namely that we should not be failing on import just because mpl_toolkits is broken), but mpl 3.6 presents with an AttributeError rather than ImportError

See discussion in #26827 and #27289

Just expanded liberally in case there are other presentations we have not seen
---
 lib/matplotlib/projections/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/projections/__init__.py b/lib/matplotlib/projections/__init__.py
index 8ce118986065..4c5ef8e2508d 100644
--- a/lib/matplotlib/projections/__init__.py
+++ b/lib/matplotlib/projections/__init__.py
@@ -58,7 +58,7 @@
 
 try:
     from mpl_toolkits.mplot3d import Axes3D
-except ImportError:
+except Exception:
     import warnings
     warnings.warn("Unable to import Axes3D. This may be due to multiple versions of "
                   "Matplotlib being installed (e.g. as a system package and as a pip "

From dd00bdee2ae211266818adca85d4071fe4d15719 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Tue, 7 Nov 2023 09:17:58 +0100
Subject: [PATCH 0428/1120] Remove idiosyncratic get_tick_iterator API.

It's only ever used essentially to expose GridHelperCurveLinear._grid_info
to FixedAxisArtistHelper.get_tick_iterators; it seems better to access
it from the sole caller.  (Note that floating_axes already does the same
direct access to the private _grid_info.)

Removing get_tick_iterator also removes the confusion with
get_tick_iterators (plural), which is a common API in axisartist.
Also note that the "minor" parameter of get_tick_iterator had a rather
peculiar meaning (it only switched the labels off).
---
 .../deprecations/27300-AL.rst                 |  3 +++
 .../axisartist/grid_helper_curvelinear.py     | 22 +++++++++++++------
 2 files changed, 18 insertions(+), 7 deletions(-)
 create mode 100644 doc/api/next_api_changes/deprecations/27300-AL.rst

diff --git a/doc/api/next_api_changes/deprecations/27300-AL.rst b/doc/api/next_api_changes/deprecations/27300-AL.rst
new file mode 100644
index 000000000000..87f4bb259537
--- /dev/null
+++ b/doc/api/next_api_changes/deprecations/27300-AL.rst
@@ -0,0 +1,3 @@
+``GridHelperCurveLinear.get_tick_iterator``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+... is deprecated with no replacement.
diff --git a/lib/mpl_toolkits/axisartist/grid_helper_curvelinear.py b/lib/mpl_toolkits/axisartist/grid_helper_curvelinear.py
index 08031122c03b..8dbfa6adf90f 100644
--- a/lib/mpl_toolkits/axisartist/grid_helper_curvelinear.py
+++ b/lib/mpl_toolkits/axisartist/grid_helper_curvelinear.py
@@ -3,7 +3,6 @@
 """
 
 import functools
-from itertools import chain
 
 import numpy as np
 
@@ -76,10 +75,18 @@ def get_tick_iterators(self, axes):
                     "top": "bottom", "bottom": "top"}[self.side]
         else:
             side = self.side
-        g = self.grid_helper
-        ti1 = g.get_tick_iterator(self.nth_coord_ticks, side)
-        ti2 = g.get_tick_iterator(1-self.nth_coord_ticks, side, minor=True)
-        return chain(ti1, ti2), iter([])
+
+        angle_tangent = dict(left=90, right=90, bottom=0, top=0)[side]
+
+        def iter_major():
+            for nth_coord, show_labels in [
+                    (self.nth_coord_ticks, True), (1 - self.nth_coord_ticks, False)]:
+                gi = self.grid_helper._grid_info[["lon", "lat"][nth_coord]]
+                for (xy, angle_normal), l in zip(
+                        gi["tick_locs"][side], gi["tick_labels"][side]):
+                    yield xy, angle_normal, angle_tangent, (l if show_labels else "")
+
+        return iter_major(), iter([])
 
 
 class FloatingAxisArtistHelper(_FloatingAxisArtistHelperBase):
@@ -211,14 +218,14 @@ def trf_xy(x, y):
         in_01 = functools.partial(
             mpl.transforms._interval_contains_close, (0, 1))
 
-        def f1():
+        def iter_major():
             for x, y, normal, tangent, lab \
                     in zip(xx1, yy1, angle_normal, angle_tangent, labels):
                 c2 = tick_to_axes.transform((x, y))
                 if in_01(c2[0]) and in_01(c2[1]):
                     yield [x, y], *np.rad2deg([normal, tangent]), lab
 
-        return f1(), iter([])
+        return iter_major(), iter([])
 
     def get_line_transform(self, axes):
         return axes.transData
@@ -309,6 +316,7 @@ def get_gridlines(self, which="major", axis="both"):
                 grid_lines.extend(gl)
         return grid_lines
 
+    @_api.deprecated("3.9")
     def get_tick_iterator(self, nth_coord, axis_side, minor=False):
         angle_tangent = dict(left=90, right=90, bottom=0, top=0)[axis_side]
         lon_or_lat = ["lon", "lat"][nth_coord]

From d916aae54f098daee33fa311f226bc87f8e3099e Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Thu, 9 Nov 2023 22:14:50 -0500
Subject: [PATCH 0429/1120] FIX: allow re-shown Qt windows to be re-destroyed

When a Qt window is closed we do not strip off the Qt components and it
is technically possible to re-show it.  However, the latch we use to
detect re-entrant destruction does not get reset so the figure can not be
re-destroyed.
---
 lib/matplotlib/backends/backend_qt.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/lib/matplotlib/backends/backend_qt.py b/lib/matplotlib/backends/backend_qt.py
index cbc490ef6cd1..b79698f1d661 100644
--- a/lib/matplotlib/backends/backend_qt.py
+++ b/lib/matplotlib/backends/backend_qt.py
@@ -602,6 +602,7 @@ def start_main_loop(cls):
                 qt_compat._exec(qapp)
 
     def show(self):
+        self.window._destroying = False
         self.window.show()
         if mpl.rcParams['figure.raise_window']:
             self.window.activateWindow()

From cc77c0b45deebbb02e26ba9f46c991c3b52ef172 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Sun, 12 Nov 2023 00:11:32 +0100
Subject: [PATCH 0430/1120] Simplify GridSpec setup in make_axes_gridspec.

Currently, make_axes_gridspec uses two nested gridspecs, first a
horizontal (1, 2) gridspec and second a vertical (3, 1) gridspec to
position an axes A and the associated left-colorbar C as
```
A.
AC
A.
```
(and similarly for colorbars on other sides of the main axes).  Instead,
this can be done with a single (3, 2) gridspec to position both A and C.
---
 lib/matplotlib/colorbar.py | 55 ++++++++++++++------------------------
 1 file changed, 20 insertions(+), 35 deletions(-)

diff --git a/lib/matplotlib/colorbar.py b/lib/matplotlib/colorbar.py
index 6c92f3795384..b54211654d13 100644
--- a/lib/matplotlib/colorbar.py
+++ b/lib/matplotlib/colorbar.py
@@ -1518,45 +1518,30 @@ def make_axes_gridspec(parent, *, location=None, orientation=None,
     wh_space = 2 * pad / (1 - pad)
 
     if location in ('left', 'right'):
-        # for shrinking
-        height_ratios = [
-                (1-anchor[1])*(1-shrink), shrink, anchor[1]*(1-shrink)]
-
+        gs = parent.get_subplotspec().subgridspec(
+            3, 2, wspace=wh_space, hspace=0,
+            height_ratios=[(1-anchor[1])*(1-shrink), shrink, anchor[1]*(1-shrink)])
         if location == 'left':
-            gs = parent.get_subplotspec().subgridspec(
-                    1, 2, wspace=wh_space,
-                    width_ratios=[fraction, 1-fraction-pad])
-            ss_main = gs[1]
-            ss_cb = gs[0].subgridspec(
-                    3, 1, hspace=0, height_ratios=height_ratios)[1]
+            gs.set_width_ratios([fraction, 1 - fraction - pad])
+            ss_main = gs[:, 1]
+            ss_cb = gs[1, 0]
         else:
-            gs = parent.get_subplotspec().subgridspec(
-                    1, 2, wspace=wh_space,
-                    width_ratios=[1-fraction-pad, fraction])
-            ss_main = gs[0]
-            ss_cb = gs[1].subgridspec(
-                    3, 1, hspace=0, height_ratios=height_ratios)[1]
+            gs.set_width_ratios([1 - fraction - pad, fraction])
+            ss_main = gs[:, 0]
+            ss_cb = gs[1, 1]
     else:
-        # for shrinking
-        width_ratios = [
-                anchor[0]*(1-shrink), shrink, (1-anchor[0])*(1-shrink)]
-
-        if location == 'bottom':
-            gs = parent.get_subplotspec().subgridspec(
-                    2, 1, hspace=wh_space,
-                    height_ratios=[1-fraction-pad, fraction])
-            ss_main = gs[0]
-            ss_cb = gs[1].subgridspec(
-                    1, 3, wspace=0, width_ratios=width_ratios)[1]
-            aspect = 1 / aspect
+        gs = parent.get_subplotspec().subgridspec(
+            2, 3, hspace=wh_space, wspace=0,
+            width_ratios=[anchor[0]*(1-shrink), shrink, (1-anchor[0])*(1-shrink)])
+        if location == 'top':
+            gs.set_height_ratios([fraction, 1 - fraction - pad])
+            ss_main = gs[1, :]
+            ss_cb = gs[0, 1]
         else:
-            gs = parent.get_subplotspec().subgridspec(
-                    2, 1, hspace=wh_space,
-                    height_ratios=[fraction, 1-fraction-pad])
-            ss_main = gs[1]
-            ss_cb = gs[0].subgridspec(
-                    1, 3, wspace=0, width_ratios=width_ratios)[1]
-            aspect = 1 / aspect
+            gs.set_height_ratios([1 - fraction - pad, fraction])
+            ss_main = gs[0, :]
+            ss_cb = gs[1, 1]
+        aspect = 1 / aspect
 
     parent.set_subplotspec(ss_main)
     if panchor is not False:

From 4e35ed6e1903dc937385025d8685fb5236ab81b2 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Sun, 12 Nov 2023 19:50:29 -0500
Subject: [PATCH 0431/1120] added redirect for step

---
 galleries/plot_types/basic/stairs.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/galleries/plot_types/basic/stairs.py b/galleries/plot_types/basic/stairs.py
index e8ca455c0e2f..9bc5d025f1e1 100644
--- a/galleries/plot_types/basic/stairs.py
+++ b/galleries/plot_types/basic/stairs.py
@@ -4,6 +4,8 @@
 ==============
 
 See `~matplotlib.axes.Axes.stairs`.
+
+.. redirect-from:: /plot_types/basic/step
 """
 import matplotlib.pyplot as plt
 import numpy as np

From 801fb26acb912a691feffefcf217ba1b8b200937 Mon Sep 17 00:00:00 2001
From: Stefan <96178532+stefan6419846@users.noreply.github.com>
Date: Mon, 13 Nov 2023 15:25:31 +0100
Subject: [PATCH 0432/1120] DOC: Synchronize LICENSE_STIX files

---
 LICENSE/LICENSE_STIX | 193 +++++++++++++++++++++++++++----------------
 1 file changed, 123 insertions(+), 70 deletions(-)

diff --git a/LICENSE/LICENSE_STIX b/LICENSE/LICENSE_STIX
index 2f7aeea331ce..6034d9474814 100644
--- a/LICENSE/LICENSE_STIX
+++ b/LICENSE/LICENSE_STIX
@@ -1,71 +1,124 @@
-TERMS AND CONDITIONS
-
-   1. Permission is hereby granted, free of charge, to any person 
-obtaining a copy of the STIX Fonts-TM set accompanying this license 
-(collectively, the "Fonts") and the associated documentation files 
-(collectively with the Fonts, the "Font Software"), to reproduce and 
-distribute the Font Software, including the rights to use, copy, merge 
-and publish copies of the Font Software, and to permit persons to whom 
-the Font Software is furnished to do so same, subject to the following 
-terms and conditions (the "License").
-
-   2. The following copyright and trademark notice and these Terms and 
-Conditions shall be included in all copies of one or more of the Font 
-typefaces and any derivative work created as permitted under this 
-License:
-
-	Copyright (c) 2001-2005 by the STI Pub Companies, consisting of 
-the American Institute of Physics, the American Chemical Society, the 
-American Mathematical Society, the American Physical Society, Elsevier, 
-Inc., and The Institute of Electrical and Electronic Engineers, Inc. 
-Portions copyright (c) 1998-2003 by MicroPress, Inc. Portions copyright 
-(c) 1990 by Elsevier, Inc. All rights reserved. STIX Fonts-TM is a 
-trademark of The Institute of Electrical and Electronics Engineers, Inc.
-
-   3. You may (a) convert the Fonts from one format to another (e.g., 
-from TrueType to PostScript), in which case the normal and reasonable 
-distortion that occurs during such conversion shall be permitted and (b) 
-embed or include a subset of the Fonts in a document for the purposes of 
-allowing users to read text in the document that utilizes the Fonts. In 
-each case, you may use the STIX Fonts-TM mark to designate the resulting 
-Fonts or subset of the Fonts.
-
-   4. You may also (a) add glyphs or characters to the Fonts, or modify 
-the shape of existing glyphs, so long as the base set of glyphs is not 
-removed and (b) delete glyphs or characters from the Fonts, provided 
-that the resulting font set is distributed with the following 
-disclaimer: "This [name] font does not include all the Unicode points 
-covered in the STIX Fonts-TM set but may include others." In each case, 
-the name used to denote the resulting font set shall not include the 
-term "STIX" or any similar term.
-
-   5. You may charge a fee in connection with the distribution of the 
-Font Software, provided that no copy of one or more of the individual 
-Font typefaces that form the STIX Fonts-TM set may be sold by itself.
-
-   6. THE FONT SOFTWARE IS PROVIDED "AS IS," WITHOUT WARRANTY OF ANY 
-KIND, EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, ANY WARRANTIES 
-OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT 
-OF COPYRIGHT, PATENT, TRADEMARK OR OTHER RIGHT. IN NO EVENT SHALL 
-MICROPRESS OR ANY OF THE STI PUB COMPANIES BE LIABLE FOR ANY CLAIM, 
-DAMAGES OR OTHER LIABILITY, INCLUDING, BUT NOT LIMITED TO, ANY GENERAL, 
-SPECIAL, INDIRECT, INCIDENTAL OR CONSEQUENTIAL DAMAGES, WHETHER IN AN 
-ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM OR OUT OF THE USE OR 
-INABILITY TO USE THE FONT SOFTWARE OR FROM OTHER DEALINGS IN THE FONT 
-SOFTWARE.
-
-   7. Except as contained in the notice set forth in Section 2, the 
-names MicroPress Inc. and STI Pub Companies, as well as the names of the 
-companies/organizations that compose the STI Pub Companies, shall not be 
-used in advertising or otherwise to promote the sale, use or other 
-dealings in the Font Software without the prior written consent of the 
-respective company or organization.
-
-   8. This License shall become null and void in the event of any 
-material breach of the Terms and Conditions herein by licensee.
-
-   9. A substantial portion of the STIX Fonts set was developed by 
-MicroPress Inc. for the STI Pub Companies. To obtain additional 
-mathematical fonts, please contact MicroPress, Inc., 68-30 Harrow 
-Street, Forest Hills, NY 11375, USA - Phone: (718) 575-1816.
+The STIX fonts distributed with matplotlib have been modified from
+their canonical form.  They have been converted from OTF to TTF format
+using Fontforge and this script:
 
+  #!/usr/bin/env fontforge
+  i=1
+  while ( i<$argc )
+    Open($argv[i])
+    Generate($argv[i]:r + ".ttf")
+    i = i+1
+  endloop
+
+The original STIX Font License begins below.
+
+-----------------------------------------------------------
+
+STIX Font License
+
+24 May 2010
+
+Copyright (c) 2001-2010 by the STI Pub Companies, consisting of the American
+Institute of Physics, the American Chemical Society, the American Mathematical
+Society, the American Physical Society, Elsevier, Inc., and The Institute of
+Electrical and Electronic Engineers, Inc. (www.stixfonts.org), with Reserved
+Font Name STIX Fonts, STIX Fonts (TM) is a  trademark of The Institute of
+Electrical and Electronics Engineers, Inc.
+
+Portions copyright (c) 1998-2003 by MicroPress, Inc. (www.micropress-inc.com),
+with Reserved Font Name TM Math. To obtain additional mathematical fonts, please
+contact MicroPress, Inc., 68-30 Harrow Street, Forest Hills, NY 11375, USA,
+Phone: (718) 575-1816.
+
+Portions copyright (c) 1990 by Elsevier, Inc.
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://scripts.sil.org/OFL
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

From dd81b6658e202614947b093794bacebafd374a0b Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 4 Oct 2023 02:58:40 -0400
Subject: [PATCH 0433/1120] Convert TkAgg utilities to pybind11

---
 lib/matplotlib/backends/_backend_tk.py  |  13 +-
 lib/matplotlib/backends/_tkagg.pyi      |  15 ++
 lib/matplotlib/tests/test_backend_tk.py |   8 +-
 src/_tkagg.cpp                          | 278 +++++++++++-------------
 src/meson.build                         |   2 +-
 5 files changed, 148 insertions(+), 168 deletions(-)

diff --git a/lib/matplotlib/backends/_backend_tk.py b/lib/matplotlib/backends/_backend_tk.py
index 89c380f8c96b..9a3ea70fbc24 100644
--- a/lib/matplotlib/backends/_backend_tk.py
+++ b/lib/matplotlib/backends/_backend_tk.py
@@ -23,6 +23,7 @@
     CloseEvent, KeyEvent, LocationEvent, MouseEvent, ResizeEvent)
 from matplotlib._pylab_helpers import Gcf
 from . import _tkagg
+from ._tkagg import TK_PHOTO_COMPOSITE_OVERLAY, TK_PHOTO_COMPOSITE_SET
 
 
 _log = logging.getLogger(__name__)
@@ -51,9 +52,6 @@ def _restore_foreground_window_at_end():
 # Initialize to a non-empty string that is not a Tcl command
 _blit_tcl_name = "mpl_blit_" + uuid.uuid4().hex
 
-TK_PHOTO_COMPOSITE_OVERLAY = 0  # apply transparency rules pixel-wise
-TK_PHOTO_COMPOSITE_SET = 1  # set image buffer directly
-
 
 def _blit(argsid):
     """
@@ -62,11 +60,11 @@ def _blit(argsid):
     *argsid* is a unique string identifier to fetch the correct arguments from
     the ``_blit_args`` dict, since arguments cannot be passed directly.
     """
-    photoimage, dataptr, offsets, bboxptr, comp_rule = _blit_args.pop(argsid)
+    photoimage, data, offsets, bbox, comp_rule = _blit_args.pop(argsid)
     if not photoimage.tk.call("info", "commands", photoimage):
         return
-    _tkagg.blit(photoimage.tk.interpaddr(), str(photoimage), dataptr,
-                comp_rule, offsets, bboxptr)
+    _tkagg.blit(photoimage.tk.interpaddr(), str(photoimage), data, comp_rule, offsets,
+                bbox)
 
 
 def blit(photoimage, aggimage, offsets, bbox=None):
@@ -87,7 +85,6 @@ def blit(photoimage, aggimage, offsets, bbox=None):
     """
     data = np.asarray(aggimage)
     height, width = data.shape[:2]
-    dataptr = (height, width, data.ctypes.data)
     if bbox is not None:
         (x1, y1), (x2, y2) = bbox.__array__()
         x1 = max(math.floor(x1), 0)
@@ -109,7 +106,7 @@ def blit(photoimage, aggimage, offsets, bbox=None):
 
     # tkapp.call coerces all arguments to strings, so to avoid string parsing
     # within _blit, pack up the arguments into a global data structure.
-    args = photoimage, dataptr, offsets, bboxptr, comp_rule
+    args = photoimage, data, offsets, bboxptr, comp_rule
     # Need a unique key to avoid thread races.
     # Again, make the key a string to avoid string parsing in _blit.
     argsid = str(id(args))
diff --git a/lib/matplotlib/backends/_tkagg.pyi b/lib/matplotlib/backends/_tkagg.pyi
index e69de29bb2d1..5c3f1112ec7c 100644
--- a/lib/matplotlib/backends/_tkagg.pyi
+++ b/lib/matplotlib/backends/_tkagg.pyi
@@ -0,0 +1,15 @@
+import numpy as np
+from numpy.typing import NDArray
+
+TK_PHOTO_COMPOSITE_OVERLAY: int
+TK_PHOTO_COMPOSITE_SET: int
+
+def blit(
+    interp: int,
+    photo_name: str,
+    data: NDArray[np.uint8],
+    comp_rule: int,
+    offset: tuple[int, int, int, int],
+    bbox: tuple[int, int, int, int],
+) -> None: ...
+def enable_dpi_awareness(frame_handle: int, interp: int) -> bool | None: ...
diff --git a/lib/matplotlib/tests/test_backend_tk.py b/lib/matplotlib/tests/test_backend_tk.py
index e44e5589452b..ee20a94042f7 100644
--- a/lib/matplotlib/tests/test_backend_tk.py
+++ b/lib/matplotlib/tests/test_backend_tk.py
@@ -81,9 +81,7 @@ def test_blit():
 
     fig, ax = plt.subplots()
     photoimage = fig.canvas._tkphoto
-    data = np.ones((4, 4, 4))
-    height, width = data.shape[:2]
-    dataptr = (height, width, data.ctypes.data)
+    data = np.ones((4, 4, 4), dtype=np.uint8)
     # Test out of bounds blitting.
     bad_boxes = ((-1, 2, 0, 2),
                  (2, 0, 0, 2),
@@ -94,8 +92,8 @@ def test_blit():
     for bad_box in bad_boxes:
         try:
             _tkagg.blit(
-                photoimage.tk.interpaddr(), str(photoimage), dataptr, 0,
-                (0, 1, 2, 3), bad_box)
+                photoimage.tk.interpaddr(), str(photoimage), data,
+                _tkagg.TK_PHOTO_COMPOSITE_OVERLAY, (0, 1, 2, 3), bad_box)
         except ValueError:
             print("success")
 
diff --git a/src/_tkagg.cpp b/src/_tkagg.cpp
index a967845707d4..ecc87de1aff4 100644
--- a/src/_tkagg.cpp
+++ b/src/_tkagg.cpp
@@ -9,6 +9,13 @@
 // rewritten, we have removed the PIL licensing information.  If you want PIL,
 // you can get it at https://python-pillow.org/
 
+#include <memory>
+#include <new>
+#include <stdexcept>
+#include <string>
+#include <tuple>
+#include <vector>
+
 #ifdef _WIN32
 #define WIN32_LEAN_AND_MEAN
 // Windows 8.1
@@ -16,8 +23,10 @@
 #define _WIN32_WINNT 0x0603
 #endif
 
-#define PY_SSIZE_T_CLEAN
-#include <Python.h>
+#include <pybind11/pybind11.h>
+#include <pybind11/numpy.h>
+namespace py = pybind11;
+using namespace pybind11::literals;
 
 #ifdef _WIN32
 #define WIN32_DLL
@@ -38,24 +47,29 @@ static inline PyObject *PyErr_SetFromWindowsErr(int ierr) {
 #endif
 
 #ifdef WIN32_DLL
-#include <string>
 #include <windows.h>
 #include <commctrl.h>
 #define PSAPI_VERSION 1
 #include <psapi.h>  // Must be linked with 'psapi' library
 #define dlsym GetProcAddress
+#define UNUSED_ON_NON_WINDOWS(x) x
 #else
 #include <dlfcn.h>
+#define UNUSED_ON_NON_WINDOWS Py_UNUSED
 #endif
 
 // Include our own excerpts from the Tcl / Tk headers
 #include "_tkmini.h"
 
-static int convert_voidptr(PyObject *obj, void *p)
+template <class T>
+static T
+convert_voidptr(const py::object &obj)
 {
-    void **val = (void **)p;
-    *val = PyLong_AsVoidPtr(obj);
-    return *val != NULL ? 1 : !PyErr_Occurred();
+    auto result = static_cast<T>(PyLong_AsVoidPtr(obj.ptr()));
+    if (PyErr_Occurred()) {
+        throw py::error_already_set();
+    }
+    return result;
 }
 
 // Global vars for Tk functions.  We load these symbols from the tkinter
@@ -66,61 +80,59 @@ static Tk_PhotoPutBlock_t TK_PHOTO_PUT_BLOCK;
 // extension module or loaded Tcl libraries at run-time.
 static Tcl_SetVar_t TCL_SETVAR;
 
-static PyObject *mpl_tk_blit(PyObject *self, PyObject *args)
+static void
+mpl_tk_blit(py::object interp_obj, const char *photo_name,
+            py::array_t<unsigned char> data, int comp_rule,
+            std::tuple<int, int, int, int> offset, std::tuple<int, int, int, int> bbox)
 {
-    Tcl_Interp *interp;
-    char const *photo_name;
-    int height, width;
-    unsigned char *data_ptr;
-    int comp_rule;
-    int put_retval;
-    int o0, o1, o2, o3;
-    int x1, x2, y1, y2;
+    auto interp = convert_voidptr<Tcl_Interp *>(interp_obj);
+
     Tk_PhotoHandle photo;
-    Tk_PhotoImageBlock block;
-    if (!PyArg_ParseTuple(args, "O&s(iiO&)i(iiii)(iiii):blit",
-                          convert_voidptr, &interp, &photo_name,
-                          &height, &width, convert_voidptr, &data_ptr,
-                          &comp_rule,
-                          &o0, &o1, &o2, &o3,
-                          &x1, &x2, &y1, &y2)) {
-        goto exit;
-    }
     if (!(photo = TK_FIND_PHOTO(interp, photo_name))) {
-        PyErr_SetString(PyExc_ValueError, "Failed to extract Tk_PhotoHandle");
-        goto exit;
+        throw py::value_error("Failed to extract Tk_PhotoHandle");
+    }
+
+    auto data_ptr = data.mutable_unchecked<3>();  // Checks ndim and writeable flag.
+    if (data.shape(2) != 4) {
+        throw py::value_error("Data pointer must be RGBA; last dimension is " +
+                              std::to_string(data.shape(2)) + ", not 4");
+    }
+    if (data.shape(0) > INT_MAX) {  // Limited by Tk_PhotoPutBlock argument type.
+        throw std::range_error(
+            "Height (" + std::to_string(data.shape(0)) +
+            ") exceeds maximum allowable size (" + std::to_string(INT_MAX) + ")");
+    }
+    if (data.shape(1) > INT_MAX / 4) {  // Limited by Tk_PhotoImageBlock.pitch field.
+        throw std::range_error(
+            "Width (" + std::to_string(data.shape(1)) +
+            ") exceeds maximum allowable size (" + std::to_string(INT_MAX / 4) + ")");
     }
+    const auto height = static_cast<int>(data.shape(0));
+    const auto width = static_cast<int>(data.shape(1));
+    int x1, x2, y1, y2;
+    std::tie(x1, x2, y1, y2) = bbox;
     if (0 > y1 || y1 > y2 || y2 > height || 0 > x1 || x1 > x2 || x2 > width) {
-        PyErr_SetString(PyExc_ValueError, "Attempting to draw out of bounds");
-        goto exit;
+        throw py::value_error("Attempting to draw out of bounds");
     }
     if (comp_rule != TK_PHOTO_COMPOSITE_OVERLAY && comp_rule != TK_PHOTO_COMPOSITE_SET) {
-        PyErr_SetString(PyExc_ValueError, "Invalid comp_rule argument");
-        goto exit;
+        throw py::value_error("Invalid comp_rule argument");
     }
 
-    Py_BEGIN_ALLOW_THREADS
-    block.pixelPtr = data_ptr + 4 * ((height - y2) * width + x1);
+    int put_retval;
+    Tk_PhotoImageBlock block;
+    block.pixelPtr = data_ptr.mutable_data(height - y2, x1, 0);
     block.width = x2 - x1;
     block.height = y2 - y1;
     block.pitch = 4 * width;
     block.pixelSize = 4;
-    block.offset[0] = o0;
-    block.offset[1] = o1;
-    block.offset[2] = o2;
-    block.offset[3] = o3;
-    put_retval = TK_PHOTO_PUT_BLOCK(
-        interp, photo, &block, x1, height - y2, x2 - x1, y2 - y1, comp_rule);
-    Py_END_ALLOW_THREADS
-    if (put_retval == TCL_ERROR) {
-        return PyErr_NoMemory();
+    std::tie(block.offset[0], block.offset[1], block.offset[2], block.offset[3]) = offset;
+    {
+        py::gil_scoped_release release;
+        put_retval = TK_PHOTO_PUT_BLOCK(
+            interp, photo, &block, x1, height - y2, x2 - x1, y2 - y1, comp_rule);
     }
-
-exit:
-    if (PyErr_Occurred()) {
-        return NULL;
-    } else {
-        Py_RETURN_NONE;
+    if (put_retval == TCL_ERROR) {
+        throw std::bad_alloc();
     }
 }
 
@@ -159,27 +171,13 @@ DpiSubclassProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam,
 }
 #endif
 
-static PyObject*
-mpl_tk_enable_dpi_awareness(PyObject* self, PyObject*const* args,
-                            Py_ssize_t nargs)
+static py::object
+mpl_tk_enable_dpi_awareness(py::object UNUSED_ON_NON_WINDOWS(frame_handle_obj),
+                            py::object UNUSED_ON_NON_WINDOWS(interp_obj))
 {
-    if (nargs != 2) {
-        return PyErr_Format(PyExc_TypeError,
-                            "enable_dpi_awareness() takes 2 positional "
-                            "arguments but %zd were given",
-                            nargs);
-    }
-
 #ifdef WIN32_DLL
-    HWND frame_handle = NULL;
-    Tcl_Interp *interp = NULL;
-
-    if (!convert_voidptr(args[0], &frame_handle)) {
-        return NULL;
-    }
-    if (!convert_voidptr(args[1], &interp)) {
-        return NULL;
-    }
+    auto frame_handle = convert_voidptr<HWND>(frame_handle_obj);
+    auto interp = convert_voidptr<Tcl_Interp *>(interp_obj);
 
 #ifdef _DPI_AWARENESS_CONTEXTS_
     HMODULE user32 = LoadLibrary("user32.dll");
@@ -190,7 +188,7 @@ mpl_tk_enable_dpi_awareness(PyObject* self, PyObject*const* args,
             user32, "GetWindowDpiAwarenessContext");
     if (GetWindowDpiAwarenessContextPtr == NULL) {
         FreeLibrary(user32);
-        Py_RETURN_FALSE;
+        return py::cast(false);
     }
 
     typedef BOOL (WINAPI *AreDpiAwarenessContextsEqual_t)(DPI_AWARENESS_CONTEXT,
@@ -200,7 +198,7 @@ mpl_tk_enable_dpi_awareness(PyObject* self, PyObject*const* args,
             user32, "AreDpiAwarenessContextsEqual");
     if (AreDpiAwarenessContextsEqualPtr == NULL) {
         FreeLibrary(user32);
-        Py_RETURN_FALSE;
+        return py::cast(false);
     }
 
     DPI_AWARENESS_CONTEXT ctx = GetWindowDpiAwarenessContextPtr(frame_handle);
@@ -217,20 +215,13 @@ mpl_tk_enable_dpi_awareness(PyObject* self, PyObject*const* args,
         SetWindowSubclass(frame_handle, DpiSubclassProc, 0, (DWORD_PTR)interp);
     }
     FreeLibrary(user32);
-    return PyBool_FromLong(per_monitor);
+    return py::cast(per_monitor);
 #endif
 #endif
 
-    Py_RETURN_NONE;
+    return py::none();
 }
 
-static PyMethodDef functions[] = {
-    { "blit", (PyCFunction)mpl_tk_blit, METH_VARARGS },
-    { "enable_dpi_awareness", (PyCFunction)mpl_tk_enable_dpi_awareness,
-      METH_FASTCALL },
-    { NULL, NULL } /* sentinel */
-};
-
 // Functions to fill global Tcl/Tk function pointers by dynamic loading.
 
 template <class T>
@@ -259,30 +250,26 @@ bool load_tcl_tk(T lib)
  * names.
  */
 
-void load_tkinter_funcs(void)
+static void
+load_tkinter_funcs()
 {
     HANDLE process = GetCurrentProcess();  // Pseudo-handle, doesn't need closing.
-    HMODULE* modules = NULL;
     DWORD size;
     if (!EnumProcessModules(process, NULL, 0, &size)) {
         PyErr_SetFromWindowsErr(0);
-        goto exit;
+        throw py::error_already_set();
     }
-    if (!(modules = static_cast<HMODULE*>(malloc(size)))) {
-        PyErr_NoMemory();
-        goto exit;
-    }
-    if (!EnumProcessModules(process, modules, size, &size)) {
+    auto count = size / sizeof(HMODULE);
+    auto modules = std::vector<HMODULE>(count);
+    if (!EnumProcessModules(process, modules.data(), size, &size)) {
         PyErr_SetFromWindowsErr(0);
-        goto exit;
+        throw py::error_already_set();
     }
-    for (unsigned i = 0; i < size / sizeof(HMODULE); ++i) {
-        if (load_tcl_tk(modules[i])) {
+    for (auto mod: modules) {
+        if (load_tcl_tk(mod)) {
             return;
         }
     }
-exit:
-    free(modules);
 }
 
 #else  // not Windows
@@ -293,85 +280,68 @@ void load_tkinter_funcs(void)
  * dynamic library (module).
  */
 
-void load_tkinter_funcs(void)
+static void
+load_tkinter_funcs()
 {
     // Load tkinter global funcs from tkinter compiled module.
-    void *main_program = NULL, *tkinter_lib = NULL;
-    PyObject *module = NULL, *py_path = NULL, *py_path_b = NULL;
-    char *path;
 
     // Try loading from the main program namespace first.
-    main_program = dlopen(NULL, RTLD_LAZY);
-    if (load_tcl_tk(main_program)) {
-        goto exit;
+    auto main_program = dlopen(NULL, RTLD_LAZY);
+    auto success = load_tcl_tk(main_program);
+    // We don't need to keep a reference open as the main program always exists.
+    if (dlclose(main_program)) {
+        throw std::runtime_error(dlerror());
+    }
+    if (success) {
+        return;
     }
-    // Clear exception triggered when we didn't find symbols above.
-    PyErr_Clear();
 
+    py::object module;
     // Handle PyPy first, as that import will correctly fail on CPython.
-    module = PyImport_ImportModule("_tkinter.tklib_cffi");   // PyPy
-    if (!module) {
-        PyErr_Clear();
-        module = PyImport_ImportModule("_tkinter");  // CPython
+    try {
+        module = py::module_::import("_tkinter.tklib_cffi");  // PyPy
+    } catch (py::error_already_set &e) {
+        module = py::module_::import("_tkinter");  // CPython
     }
-    if (!(module &&
-          (py_path = PyObject_GetAttrString(module, "__file__")) &&
-          (py_path_b = PyUnicode_EncodeFSDefault(py_path)) &&
-          (path = PyBytes_AsString(py_path_b)))) {
-        goto exit;
-    }
-    tkinter_lib = dlopen(path, RTLD_LAZY);
+    auto py_path = module.attr("__file__");
+    py::bytes py_path_b = py_path.attr("encode")(
+        Py_FileSystemDefaultEncoding, Py_FileSystemDefaultEncodeErrors);
+    std::string path = py_path_b;
+    auto tkinter_lib = dlopen(path.c_str(), RTLD_LAZY);
     if (!tkinter_lib) {
-        PyErr_SetString(PyExc_RuntimeError, dlerror());
-        goto exit;
-    }
-    if (load_tcl_tk(tkinter_lib)) {
-        goto exit;
+        throw std::runtime_error(dlerror());
     }
-
-exit:
-    // We don't need to keep a reference open as the main program & tkinter
-    // have been imported.  Try to close each library separately (otherwise the
-    // second dlclose could clear a dlerror from the first dlclose).
-    bool raised_dlerror = false;
-    if (main_program && dlclose(main_program) && !raised_dlerror) {
-        PyErr_SetString(PyExc_RuntimeError, dlerror());
-        raised_dlerror = true;
+    load_tcl_tk(tkinter_lib);
+    // We don't need to keep a reference open as tkinter has been imported.
+    if (dlclose(tkinter_lib)) {
+        throw std::runtime_error(dlerror());
     }
-    if (tkinter_lib && dlclose(tkinter_lib) && !raised_dlerror) {
-        PyErr_SetString(PyExc_RuntimeError, dlerror());
-        raised_dlerror = true;
-    }
-    Py_XDECREF(module);
-    Py_XDECREF(py_path);
-    Py_XDECREF(py_path_b);
 }
 #endif // end not Windows
 
-static PyModuleDef _tkagg_module = {
-    PyModuleDef_HEAD_INIT, "_tkagg", NULL, -1, functions
-};
-
-PyMODINIT_FUNC PyInit__tkagg(void)
+PYBIND11_MODULE(_tkagg, m)
 {
-    load_tkinter_funcs();
-    PyObject *type, *value, *traceback;
-    PyErr_Fetch(&type, &value, &traceback);
-    // Always raise ImportError (normalizing a previously set exception if
-    // needed) to interact properly with backend auto-fallback.
-    if (value) {
-        PyErr_NormalizeException(&type, &value, &traceback);
-        PyErr_SetObject(PyExc_ImportError, value);
-        return NULL;
-    } else if (!TCL_SETVAR) {
-        PyErr_SetString(PyExc_ImportError, "Failed to load Tcl_SetVar");
-        return NULL;
+    try {
+        load_tkinter_funcs();
+    } catch (py::error_already_set& e) {
+        // Always raise ImportError to interact properly with backend auto-fallback.
+        py::raise_from(e, PyExc_ImportError, "failed to load tkinter functions");
+        throw py::error_already_set();
+    }
+
+    if (!TCL_SETVAR) {
+        throw py::import_error("Failed to load Tcl_SetVar");
     } else if (!TK_FIND_PHOTO) {
-        PyErr_SetString(PyExc_ImportError, "Failed to load Tk_FindPhoto");
-        return NULL;
+        throw py::import_error("Failed to load Tk_FindPhoto");
     } else if (!TK_PHOTO_PUT_BLOCK) {
-        PyErr_SetString(PyExc_ImportError, "Failed to load Tk_PhotoPutBlock");
-        return NULL;
+        throw py::import_error("Failed to load Tk_PhotoPutBlock");
     }
-    return PyModule_Create(&_tkagg_module);
+
+    m.def("blit", &mpl_tk_blit,
+          "interp"_a, "photo_name"_a, "data"_a, "comp_rule"_a, "offset"_a, "bbox"_a);
+    m.def("enable_dpi_awareness", &mpl_tk_enable_dpi_awareness,
+          "frame_handle"_a, "interp"_a);
+
+    m.attr("TK_PHOTO_COMPOSITE_OVERLAY") = TK_PHOTO_COMPOSITE_OVERLAY;
+    m.attr("TK_PHOTO_COMPOSITE_SET") = TK_PHOTO_COMPOSITE_SET;
 }
diff --git a/src/meson.build b/src/meson.build
index 45f64e954866..db064a9c5ca1 100644
--- a/src/meson.build
+++ b/src/meson.build
@@ -139,7 +139,7 @@ extension_data = {
     'include_directories': include_directories('.'),
     # The dl/psapi libraries are needed for finding Tcl/Tk at run time.
     'dependencies': [
-      numpy_dep, agg_dep.partial_dependency(includes: true), dl, comctl32, psapi,
+      pybind11_dep, agg_dep.partial_dependency(includes: true), dl, comctl32, psapi,
     ],
   },
   '_tri': {

From 5aeb872ddd26fbe3634b1a4d386d7e6e5a4f3dbf Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Mon, 13 Nov 2023 21:39:48 -0500
Subject: [PATCH 0434/1120] BLD: Check for sufficient MinGW headers when using
 them

---
 src/_tkagg.cpp | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/_tkagg.cpp b/src/_tkagg.cpp
index ecc87de1aff4..567d7f88ba22 100644
--- a/src/_tkagg.cpp
+++ b/src/_tkagg.cpp
@@ -53,6 +53,11 @@ static inline PyObject *PyErr_SetFromWindowsErr(int ierr) {
 #include <psapi.h>  // Must be linked with 'psapi' library
 #define dlsym GetProcAddress
 #define UNUSED_ON_NON_WINDOWS(x) x
+// Check for old headers that do not defined HiDPI functions and constants.
+#if defined(__MINGW64_VERSION_MAJOR)
+static_assert(__MINGW64_VERSION_MAJOR >= 6,
+              "mingw-w64-x86_64-headers >= 6 are required when compiling with MinGW");
+#endif
 #else
 #include <dlfcn.h>
 #define UNUSED_ON_NON_WINDOWS Py_UNUSED

From 63b064a7176201f953541912e629a2a4d92547be Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Tue, 14 Nov 2023 17:26:41 +0100
Subject: [PATCH 0435/1120] [DOC] Minor fixes for savefig-docstring

---
 lib/matplotlib/figure.py | 40 ++++++++++++++++++++--------------------
 1 file changed, 20 insertions(+), 20 deletions(-)

diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
index 86a9fdd1387e..cd26af84ccbe 100644
--- a/lib/matplotlib/figure.py
+++ b/lib/matplotlib/figure.py
@@ -3186,10 +3186,10 @@ def savefig(self, fname, *, transparent=None, **kwargs):
 
         Call signature::
 
-          savefig(fname, *, dpi='figure', format=None, metadata=None,
-                  bbox_inches=None, pad_inches=0.1,
-                  facecolor='auto', edgecolor='auto',
-                  backend=None, **kwargs
+          savefig(fname, *, transparent=None, dpi='figure', format=None,
+                  metadata=None, bbox_inches=None, pad_inches=0.1,
+                  facecolor='auto', edgecolor='auto', backend=None,
+                  **kwargs
                  )
 
         The available output formats depend on the backend being used.
@@ -3214,6 +3214,22 @@ def savefig(self, fname, *, transparent=None, **kwargs):
 
         Other Parameters
         ----------------
+        transparent : bool, default: :rc:`savefig.transparent`
+            If *True*, the Axes patches will all be transparent; the
+            Figure patch will also be transparent unless *facecolor*
+            and/or *edgecolor* are specified via kwargs.
+
+            If *False* has no effect and the color of the Axes and
+            Figure patches are unchanged (unless the Figure patch
+            is specified via the *facecolor* and/or *edgecolor* keyword
+            arguments in which case those colors are used).
+
+            The transparency of these patches will be restored to their
+            original values upon exit of this function.
+
+            This is useful, for example, for displaying
+            a plot on top of a colored background on a web page.
+
         dpi : float or 'figure', default: :rc:`savefig.dpi`
             The resolution in dots per inch.  If 'figure', use the figure's
             dpi value.
@@ -3273,22 +3289,6 @@ def savefig(self, fname, *, transparent=None, **kwargs):
             'a10', 'b0' through 'b10'. Only supported for postscript
             output.
 
-        transparent : bool
-            If *True*, the Axes patches will all be transparent; the
-            Figure patch will also be transparent unless *facecolor*
-            and/or *edgecolor* are specified via kwargs.
-
-            If *False* has no effect and the color of the Axes and
-            Figure patches are unchanged (unless the Figure patch
-            is specified via the *facecolor* and/or *edgecolor* keyword
-            arguments in which case those colors are used).
-
-            The transparency of these patches will be restored to their
-            original values upon exit of this function.
-
-            This is useful, for example, for displaying
-            a plot on top of a colored background on a web page.
-
         bbox_extra_artists : list of `~matplotlib.artist.Artist`, optional
             A list of extra artists that will be considered when the
             tight bbox is calculated.

From 0c34e5e06fbaa3d8e5432df62f3628a576f9f353 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Mon, 6 Nov 2023 22:19:31 -0500
Subject: [PATCH 0436/1120] swap xkcd script for humor sans add xkcd-script
 font to doc build

Co-authored-by: Oscar Gustafsson <oscar.gustafsson@gmail.com>
---
 .circleci/config.yml                              |  6 +++---
 .devcontainer/devcontainer.json                   |  2 +-
 doc/devel/dependencies.rst                        |  3 +--
 lib/matplotlib/mpl-data/matplotlibrc              |  2 +-
 lib/matplotlib/mpl-data/stylelib/classic.mplstyle |  2 +-
 lib/matplotlib/pyplot.py                          | 12 ++++++------
 lib/matplotlib/tests/test_axes.py                 |  2 +-
 lib/matplotlib/textpath.py                        |  2 +-
 8 files changed, 15 insertions(+), 16 deletions(-)

diff --git a/.circleci/config.yml b/.circleci/config.yml
index e8c8c2fca394..2f79a6fbba5c 100644
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -49,7 +49,6 @@ commands:
               ffmpeg \
               fonts-crosextra-carlito \
               fonts-freefont-otf \
-              fonts-humor-sans \
               fonts-noto-cjk \
               fonts-wqy-zenhei \
               graphviz \
@@ -67,15 +66,16 @@ commands:
   fonts-install:
     steps:
       - restore_cache:
-          key: fonts-2
+          key: fonts-4
       - run:
           name: Install custom fonts
           command: |
             mkdir -p ~/.local/share/fonts
             wget -nc https://github.com/google/fonts/blob/master/ofl/felipa/Felipa-Regular.ttf?raw=true -O ~/.local/share/fonts/Felipa-Regular.ttf || true
+            wget -nc https://github.com/ipython/xkcd-font/blob/master/xkcd-script/font/xkcd-script.ttf?raw=true -O ~/.local/share/fonts/xkcd-Script.ttf || true
             fc-cache -f -v
       - save_cache:
-          key: fonts-2
+          key: fonts-4
           paths:
             - ~/.local/share/fonts/
 
diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
index 814c066c43b1..ddec2754d03a 100644
--- a/.devcontainer/devcontainer.json
+++ b/.devcontainer/devcontainer.json
@@ -7,7 +7,7 @@
   "features": {
     "ghcr.io/devcontainers/features/desktop-lite:1": {},
     "ghcr.io/rocker-org/devcontainer-features/apt-packages:1": {
-      "packages": "inkscape,ffmpeg,dvipng,lmodern,cm-super,texlive-latex-base,texlive-latex-extra,texlive-fonts-recommended,texlive-latex-recommended,texlive-pictures,texlive-xetex,fonts-wqy-zenhei,graphviz,fonts-crosextra-carlito,fonts-freefont-otf,fonts-humor-sans,fonts-noto-cjk,optipng"
+      "packages": "inkscape,ffmpeg,dvipng,lmodern,cm-super,texlive-latex-base,texlive-latex-extra,texlive-fonts-recommended,texlive-latex-recommended,texlive-pictures,texlive-xetex,fonts-wqy-zenhei,graphviz,fonts-crosextra-carlito,fonts-freefont-otf,fonts-comic-neue,fonts-noto-cjk,optipng"
     }
   },
   "onCreateCommand": ".devcontainer/setup.sh",
diff --git a/doc/devel/dependencies.rst b/doc/devel/dependencies.rst
index 458fff51b82f..c0e761d6beb6 100644
--- a/doc/devel/dependencies.rst
+++ b/doc/devel/dependencies.rst
@@ -419,6 +419,5 @@ Optional
 
 * `Inkscape <https://inkscape.org>`_
 * `optipng <http://optipng.sourceforge.net>`_
-* the font "Humor Sans" (aka the "XKCD" font), or the free alternative
-  `Comic Neue <http://comicneue.com/>`_
+* the font `xkcd script <https://github.com/ipython/xkcd-font/>`_ or `Comic Neue <http://comicneue.com/>`_
 * the font "Times New Roman"
diff --git a/lib/matplotlib/mpl-data/matplotlibrc b/lib/matplotlib/mpl-data/matplotlibrc
index 9bd8a622092e..301afc38456b 100644
--- a/lib/matplotlib/mpl-data/matplotlibrc
+++ b/lib/matplotlib/mpl-data/matplotlibrc
@@ -269,7 +269,7 @@
 #font.serif:      DejaVu Serif, Bitstream Vera Serif, Computer Modern Roman, New Century Schoolbook, Century Schoolbook L, Utopia, ITC Bookman, Bookman, Nimbus Roman No9 L, Times New Roman, Times, Palatino, Charter, serif
 #font.sans-serif: DejaVu Sans, Bitstream Vera Sans, Computer Modern Sans Serif, Lucida Grande, Verdana, Geneva, Lucid, Arial, Helvetica, Avant Garde, sans-serif
 #font.cursive:    Apple Chancery, Textile, Zapf Chancery, Sand, Script MT, Felipa, Comic Neue, Comic Sans MS, cursive
-#font.fantasy:    Chicago, Charcoal, Impact, Western, Humor Sans, xkcd, fantasy
+#font.fantasy:    Chicago, Charcoal, Impact, Western, xkcd script, fantasy
 #font.monospace:  DejaVu Sans Mono, Bitstream Vera Sans Mono, Computer Modern Typewriter, Andale Mono, Nimbus Mono L, Courier New, Courier, Fixed, Terminal, monospace
 
 
diff --git a/lib/matplotlib/mpl-data/stylelib/classic.mplstyle b/lib/matplotlib/mpl-data/stylelib/classic.mplstyle
index 8923ce6f0497..976ab291907b 100644
--- a/lib/matplotlib/mpl-data/stylelib/classic.mplstyle
+++ b/lib/matplotlib/mpl-data/stylelib/classic.mplstyle
@@ -91,7 +91,7 @@ font.size           : 12.0
 font.serif     : DejaVu Serif, New Century Schoolbook, Century Schoolbook L, Utopia, ITC Bookman, Bookman, Nimbus Roman No9 L, Times New Roman, Times, Palatino, Charter, serif
 font.sans-serif: DejaVu Sans, Lucida Grande, Verdana, Geneva, Lucid, Arial, Helvetica, Avant Garde, sans-serif
 font.cursive   : Apple Chancery, Textile, Zapf Chancery, Sand, Script MT, Felipa, cursive
-font.fantasy   : Comic Sans MS, Chicago, Charcoal, ImpactWestern, Humor Sans, fantasy
+font.fantasy   : Comic Sans MS, Chicago, Charcoal, ImpactWestern, xkcd script, fantasy
 font.monospace : DejaVu Sans Mono, Andale Mono, Nimbus Mono L, Courier New, Courier, Fixed, Terminal, monospace
 
 ### TEXT
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 70ebd69cddb5..ddbb6cb36728 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -706,11 +706,12 @@ def xkcd(
     scale: float = 1, length: float = 100, randomness: float = 2
 ) -> ExitStack:
     """
-    Turn on `xkcd <https://xkcd.com/>`_ sketch-style drawing mode.  This will
-    only have effect on things drawn after this function is called.
+    Turn on `xkcd <https://xkcd.com/>`_ sketch-style drawing mode.
 
-    For best results, the "Humor Sans" font should be installed: it is
-    not included with Matplotlib.
+    This will only have an effect on things drawn after this function is called.
+
+    For best results, install the `xkcd script <https://github.com/ipython/xkcd-font/>`_
+    font; xkcd fonts are not packaged with Matplotlib.
 
     Parameters
     ----------
@@ -749,8 +750,7 @@ def xkcd(
 
     from matplotlib import patheffects
     rcParams.update({
-        'font.family': ['xkcd', 'xkcd Script', 'Humor Sans', 'Comic Neue',
-                        'Comic Sans MS'],
+        'font.family': ['xkcd', 'xkcd Script', 'Comic Neue', 'Comic Sans MS'],
         'font.size': 14.0,
         'path.sketch': (scale, length, randomness),
         'path.effects': [
diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index 799bf5ddd774..dffbb2377a23 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -8848,7 +8848,7 @@ def test_tick_param_labelfont():
     fig, ax = plt.subplots()
     ax.plot([1, 2, 3, 4], [1, 2, 3, 4])
     ax.set_xlabel('X label in Impact font', fontname='Impact')
-    ax.set_ylabel('Y label in Humor Sans', fontname='Humor Sans')
+    ax.set_ylabel('Y label in xkcd script', fontname='xkcd script')
     ax.tick_params(color='r', labelfontfamily='monospace')
     plt.title('Title in sans-serif')
     for text in ax.get_xticklabels():
diff --git a/lib/matplotlib/textpath.py b/lib/matplotlib/textpath.py
index de97899f8a72..c00966d6e6c3 100644
--- a/lib/matplotlib/textpath.py
+++ b/lib/matplotlib/textpath.py
@@ -99,7 +99,7 @@ def get_text_path(self, prop, s, ismath=False):
             from matplotlib.text import TextToPath
             from matplotlib.font_manager import FontProperties
 
-            fp = FontProperties(family="Humor Sans", style="italic")
+            fp = FontProperties(family="Comic Neue", style="italic")
             verts, codes = TextToPath().get_text_path(fp, "ABC")
             path = Path(verts, codes, closed=False)
 

From 52bf8e9e236176753ec0f416ef41ed1b9f1ba599 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Thu, 16 Nov 2023 12:19:42 -0600
Subject: [PATCH 0437/1120] Omit MOVETO lines from nearest contour logic

Closes #27333
---
 lib/matplotlib/contour.py            | 21 ++++++++++++---------
 lib/matplotlib/tests/test_contour.py | 19 +++++++++++++++++++
 2 files changed, 31 insertions(+), 9 deletions(-)

diff --git a/lib/matplotlib/contour.py b/lib/matplotlib/contour.py
index d3ae83c613b1..7404151e7699 100644
--- a/lib/matplotlib/contour.py
+++ b/lib/matplotlib/contour.py
@@ -1339,15 +1339,18 @@ def _find_nearest_contour(self, xy, indices=None):
 
         for idx_level in indices:
             path = self._paths[idx_level]
-            if not len(path.vertices):
-                continue
-            lc = self.get_transform().transform(path.vertices)
-            d2, proj, leg = _find_closest_point_on_path(lc, xy)
-            if d2 < d2min:
-                d2min = d2
-                idx_level_min = idx_level
-                idx_vtx_min = leg[1]
-                proj_min = proj
+            idx_vtx_start = 0
+            for subpath in path._iter_connected_components():
+                if not len(subpath.vertices):
+                    continue
+                lc = self.get_transform().transform(subpath.vertices)
+                d2, proj, leg = _find_closest_point_on_path(lc, xy)
+                if d2 < d2min:
+                    d2min = d2
+                    idx_level_min = idx_level
+                    idx_vtx_min = leg[1] + idx_vtx_start
+                    proj_min = proj
+                idx_vtx_start += len(subpath)
 
         return idx_level_min, idx_vtx_min, proj_min
 
diff --git a/lib/matplotlib/tests/test_contour.py b/lib/matplotlib/tests/test_contour.py
index db8ef03925cd..f79584be4086 100644
--- a/lib/matplotlib/tests/test_contour.py
+++ b/lib/matplotlib/tests/test_contour.py
@@ -125,6 +125,25 @@ def test_contour_manual_labels(split_collections):
     plt.clabel(cs, manual=pts, fontsize='small', colors=('r', 'g'))
 
 
+def test_contour_manual_moveto():
+    x = np.linspace(-10, 10)
+    y = np.linspace(-10, 10)
+
+    X, Y = np.meshgrid(x, y)
+
+    Z = X**2 * 1 / Y**2 - 1
+
+    contours = plt.contour(X, Y, Z, levels=[0, 100])
+
+    # This point lies on the `MOVETO` line for the 100 contour
+    # but is actually closest to the 0 contour
+    point = (1.3, 1)
+    clabels = plt.clabel(contours, manual=[point])
+
+    # Ensure that the 0 contour was chosen, not the 100 contour
+    assert clabels[0].get_text() == "0"
+
+
 @pytest.mark.parametrize("split_collections", [False, True])
 @image_comparison(['contour_disconnected_segments'],
                   remove_text=True, style='mpl20', extensions=['png'])

From a15f571ed4dad5f0f604aa41420d91b4f979df95 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Fri, 17 Nov 2023 16:50:16 +0100
Subject: [PATCH 0438/1120] Fix draggable annotations on subfigures.

- Picking on subfigures was broken because `ax = getattr(a, 'axes', None)`
  would return the SubFigure.axes *list* when `a` is a subfigure, so the
  axes identity test would just be completely wrong.  Fix that by
  special-casing subfigures.  (Ideally I would entirely remove the axes
  equality test because that also breaks in the case of overlapping axes,
  but that's a much bigger change.)
- `ref_artist.figure._canvas_callbacks` would fail when the ref_artist
  is on a subfigure because subfigures don't have a _canvas_callbacks
  attribute; instead use `ref_artist.figure.canvas.callbacks` where
  accessing the canvas attribute correctly goes back to the toplevel
  figure first.

See test for an example (which would previously fail with an
AttributeError).
---
 lib/matplotlib/artist.py               |  3 ++-
 lib/matplotlib/offsetbox.py            |  3 +--
 lib/matplotlib/tests/test_offsetbox.py | 10 ++++++++++
 3 files changed, 13 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/artist.py b/lib/matplotlib/artist.py
index 4a495531d900..d0db945ab3e5 100644
--- a/lib/matplotlib/artist.py
+++ b/lib/matplotlib/artist.py
@@ -537,7 +537,8 @@ def pick(self, mouseevent):
         for a in self.get_children():
             # make sure the event happened in the same Axes
             ax = getattr(a, 'axes', None)
-            if (mouseevent.inaxes is None or ax is None
+            if (isinstance(a, mpl.figure.SubFigure)
+                    or mouseevent.inaxes is None or ax is None
                     or mouseevent.inaxes == ax):
                 # we need to check if mouseevent.inaxes is None
                 # because some objects associated with an Axes (e.g., a
diff --git a/lib/matplotlib/offsetbox.py b/lib/matplotlib/offsetbox.py
index acf93f5a34d9..0164638b1076 100644
--- a/lib/matplotlib/offsetbox.py
+++ b/lib/matplotlib/offsetbox.py
@@ -1458,7 +1458,7 @@ def __init__(self, ref_artist, use_blit=False):
             ref_artist.set_picker(True)
         self.got_artist = False
         self._use_blit = use_blit and self.canvas.supports_blit
-        callbacks = ref_artist.figure._canvas_callbacks
+        callbacks = self.canvas.callbacks
         self._disconnectors = [
             functools.partial(
                 callbacks.disconnect, callbacks._connect_picklable(name, func))
@@ -1471,7 +1471,6 @@ def __init__(self, ref_artist, use_blit=False):
 
     # A property, not an attribute, to maintain picklability.
     canvas = property(lambda self: self.ref_artist.figure.canvas)
-
     cids = property(lambda self: [
         disconnect.args[0] for disconnect in self._disconnectors[:2]])
 
diff --git a/lib/matplotlib/tests/test_offsetbox.py b/lib/matplotlib/tests/test_offsetbox.py
index 49b55e4c9326..f18fa7c777d1 100644
--- a/lib/matplotlib/tests/test_offsetbox.py
+++ b/lib/matplotlib/tests/test_offsetbox.py
@@ -450,3 +450,13 @@ def test_remove_draggable():
     an.draggable(True)
     an.remove()
     MouseEvent("button_release_event", fig.canvas, 1, 1)._process()
+
+
+def test_draggable_in_subfigure():
+    fig = plt.figure()
+    # Put annotation at lower left corner to make it easily pickable below.
+    ann = fig.subfigures().add_axes([0, 0, 1, 1]).annotate("foo", (0, 0))
+    ann.draggable(True)
+    fig.canvas.draw()  # Texts are non-pickable until the first draw.
+    MouseEvent("button_press_event", fig.canvas, 1, 1)._process()
+    assert ann._draggable.got_artist

From d8595f2617714c002b015e5110303c5aba57c4d0 Mon Sep 17 00:00:00 2001
From: Greg Lucas <greg.m.lucas@gmail.com>
Date: Sun, 19 Nov 2023 09:38:46 -0700
Subject: [PATCH 0439/1120] FIX: scale norm of collections when first array is
 set

Previously, Collections would defer auto-scaling the norm until
draw time. Now the collection is scaled anytime an array is set
and hasn't already been scaled previously.
---
 doc/api/next_api_changes/behavior/27347-GL.rst |  7 +++++++
 lib/matplotlib/cm.py                           |  2 ++
 lib/matplotlib/tests/test_collections.py       | 10 ++++++++++
 3 files changed, 19 insertions(+)
 create mode 100644 doc/api/next_api_changes/behavior/27347-GL.rst

diff --git a/doc/api/next_api_changes/behavior/27347-GL.rst b/doc/api/next_api_changes/behavior/27347-GL.rst
new file mode 100644
index 000000000000..2cf8f65cd745
--- /dev/null
+++ b/doc/api/next_api_changes/behavior/27347-GL.rst
@@ -0,0 +1,7 @@
+ScalarMappables auto-scale their norm when an array is set
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Collections previously deferred auto-scaling of the norm until draw time.
+This has been changed to scale the norm whenever the first array is set
+to align with the docstring and reduce unexpected behavior when
+accessing the norm before drawing.
diff --git a/lib/matplotlib/cm.py b/lib/matplotlib/cm.py
index 3911986f3673..53c60c8a8883 100644
--- a/lib/matplotlib/cm.py
+++ b/lib/matplotlib/cm.py
@@ -536,6 +536,8 @@ def set_array(self, A):
                             "converted to float")
 
         self._A = A
+        if not self.norm.scaled():
+            self.norm.autoscale_None(A)
 
     def get_array(self):
         """
diff --git a/lib/matplotlib/tests/test_collections.py b/lib/matplotlib/tests/test_collections.py
index 1f7c104a4c07..5baaeaa5d388 100644
--- a/lib/matplotlib/tests/test_collections.py
+++ b/lib/matplotlib/tests/test_collections.py
@@ -292,6 +292,16 @@ def check_segments(coll, positions, linelength, lineoffset, orientation):
         assert segment[1, pos2] == positions[i]
 
 
+def test_collection_norm_autoscale():
+    # norm should be autoscaled when array is set, not deferred to draw time
+    lines = np.arange(24).reshape((4, 3, 2))
+    coll = mcollections.LineCollection(lines, array=np.arange(4))
+    assert coll.norm(2) == 2 / 3
+    # setting a new array shouldn't update the already scaled limits
+    coll.set_array(np.arange(4) + 5)
+    assert coll.norm(2) == 2 / 3
+
+
 def test_null_collection_datalim():
     col = mcollections.PathCollection([])
     col_data_lim = col.get_datalim(mtransforms.IdentityTransform())

From c905a650877b8b3bdca3f93ddc6618ea94329cb8 Mon Sep 17 00:00:00 2001
From: Raghuram Sirigiri <raghuram9758@gmail.com>
Date: Sun, 19 Nov 2023 17:14:16 -0600
Subject: [PATCH 0440/1120] updated Api/animation documentation as per
 standards

---
 doc/api/animation_api.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/api/animation_api.rst b/doc/api/animation_api.rst
index c7134e302d2f..df39b5942199 100644
--- a/doc/api/animation_api.rst
+++ b/doc/api/animation_api.rst
@@ -166,7 +166,7 @@ A third method is to use closures to build up the required
 artists and functions.  A fourth method is to create a class.
 
 Examples
-~~~~~~~~
+^^^^^^^^
 
 * :doc:`../gallery/animation/animate_decay`
 * :doc:`../gallery/animation/bayes_update`
@@ -182,7 +182,7 @@ Examples
 -------------------
 
 Examples
-~~~~~~~~
+^^^^^^^^
 
 * :doc:`../gallery/animation/dynamic_image`
 

From 85e0f3ca9bcd8f110a23a5fa4f14338e8742cea0 Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@liu.se>
Date: Mon, 20 Nov 2023 16:29:31 +0100
Subject: [PATCH 0441/1120] Refactor AxisArtistHelpers

---
 lib/mpl_toolkits/axisartist/axislines.py | 20 +++++++++-----------
 1 file changed, 9 insertions(+), 11 deletions(-)

diff --git a/lib/mpl_toolkits/axisartist/axislines.py b/lib/mpl_toolkits/axisartist/axislines.py
index ced2703d1ed6..6f28e5c61a2f 100644
--- a/lib/mpl_toolkits/axisartist/axislines.py
+++ b/lib/mpl_toolkits/axisartist/axislines.py
@@ -84,9 +84,15 @@ def get_tick_iterators(self, axes):
             return iter_major, iter_minor
     """
 
+    def __init__(self, nth_coord):
+        self.nth_coord = nth_coord
+
     def update_lim(self, axes):
         pass
 
+    def get_nth_coord(self):
+        return self.nth_coord
+
     def _to_xy(self, values, const):
         """
         Create a (*values.shape, 2)-shape array representing (x, y) pairs.
@@ -115,17 +121,13 @@ class _FixedAxisArtistHelperBase(_AxisArtistHelperBase):
     @_api.delete_parameter("3.9", "nth_coord")
     def __init__(self, loc, nth_coord=None):
         """``nth_coord = 0``: x-axis; ``nth_coord = 1``: y-axis."""
-        self.nth_coord = _api.check_getitem(
-            {"bottom": 0, "top": 0, "left": 1, "right": 1}, loc=loc)
+        super().__init__(_api.check_getitem(
+            {"bottom": 0, "top": 0, "left": 1, "right": 1}, loc=loc))
         self._loc = loc
         self._pos = {"bottom": 0, "top": 1, "left": 0, "right": 1}[loc]
-        super().__init__()
         # axis line in transAxes
         self._path = Path(self._to_xy((0, 1), const=self._pos))
 
-    def get_nth_coord(self):
-        return self.nth_coord
-
     # LINE
 
     def get_line(self, axes):
@@ -158,12 +160,8 @@ def get_tick_transform(self, axes):
 
 class _FloatingAxisArtistHelperBase(_AxisArtistHelperBase):
     def __init__(self, nth_coord, value):
-        self.nth_coord = nth_coord
         self._value = value
-        super().__init__()
-
-    def get_nth_coord(self):
-        return self.nth_coord
+        super().__init__(nth_coord)
 
     def get_line(self, axes):
         raise RuntimeError("get_line method should be defined by the derived class")

From cca5161e538e38a78709123802d8fb004107f346 Mon Sep 17 00:00:00 2001
From: Scott Shambaugh <scottshambaugh@users.noreply.github.com>
Date: Mon, 20 Nov 2023 20:13:18 -0700
Subject: [PATCH 0442/1120] Update 3d axis limits whats new

---
 doc/users/next_whats_new/3d_axis_limits.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/doc/users/next_whats_new/3d_axis_limits.rst b/doc/users/next_whats_new/3d_axis_limits.rst
index 7e7d6b2e5133..b460cfdb4f73 100644
--- a/doc/users/next_whats_new/3d_axis_limits.rst
+++ b/doc/users/next_whats_new/3d_axis_limits.rst
@@ -12,7 +12,9 @@ automatically added.
 
     import matplotlib.pyplot as plt
     fig, axs = plt.subplots(1, 2, subplot_kw={'projection': '3d'})
-    plt.rcParams['axes3d.automargin'] = False  # the default in 3.9.0
-    axs[0].set(xlim=(0, 1), ylim=(0, 1), zlim=(0, 1), title='New Behavior')
+
     plt.rcParams['axes3d.automargin'] = True
-    axs[1].set(xlim=(0, 1), ylim=(0, 1), zlim=(0, 1), title='Old Behavior')
+    axs[0].set(xlim=(0, 1), ylim=(0, 1), zlim=(0, 1), title='Old Behavior')
+
+    plt.rcParams['axes3d.automargin'] = False  # the default in 3.9.0
+    axs[1].set(xlim=(0, 1), ylim=(0, 1), zlim=(0, 1), title='New Behavior')

From e08cbf197fde11619405895ec1067d1b1caf88a1 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Tue, 21 Nov 2023 14:57:21 -0500
Subject: [PATCH 0443/1120] Fix build on PyPy

It appears that `Py_FileSystemDefaultEncodeErrors` is not part of the
limited API, and PyPy does not have it.

Since pybind11 does not have a wrapper for `PyUnicode_EncodeFSDefault`
(the main reason I had switched to a `encode` call earlier), we need to
call it ourselves manually.
---
 src/_tkagg.cpp | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/_tkagg.cpp b/src/_tkagg.cpp
index 567d7f88ba22..3b58114a71c0 100644
--- a/src/_tkagg.cpp
+++ b/src/_tkagg.cpp
@@ -309,8 +309,8 @@ load_tkinter_funcs()
         module = py::module_::import("_tkinter");  // CPython
     }
     auto py_path = module.attr("__file__");
-    py::bytes py_path_b = py_path.attr("encode")(
-        Py_FileSystemDefaultEncoding, Py_FileSystemDefaultEncodeErrors);
+    auto py_path_b = py::reinterpret_steal<py::bytes>(
+        PyUnicode_EncodeFSDefault(py_path.ptr()));
     std::string path = py_path_b;
     auto tkinter_lib = dlopen(path.c_str(), RTLD_LAZY);
     if (!tkinter_lib) {

From 483fdb472620e39fb3ba8b4c0f2087aa0e7c5834 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Thu, 16 Nov 2023 13:23:17 -0500
Subject: [PATCH 0444/1120] frame stackplot limits in billions to make numbers
 clearer

Co-authored-by: Ruth Comer <10599679+rcomer@users.noreply.github.com>
---
 .../lines_bars_and_markers/stackplot_demo.py     | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/galleries/examples/lines_bars_and_markers/stackplot_demo.py b/galleries/examples/lines_bars_and_markers/stackplot_demo.py
index 890a827fa156..d02a9af73da3 100644
--- a/galleries/examples/lines_bars_and_markers/stackplot_demo.py
+++ b/galleries/examples/lines_bars_and_markers/stackplot_demo.py
@@ -16,15 +16,17 @@
 import matplotlib.pyplot as plt
 import numpy as np
 
+import matplotlib.ticker as mticker
+
 # data from United Nations World Population Prospects (Revision 2019)
 # https://population.un.org/wpp/, license: CC BY 3.0 IGO
 year = [1950, 1960, 1970, 1980, 1990, 2000, 2010, 2018]
 population_by_continent = {
-    'africa': [228, 284, 365, 477, 631, 814, 1044, 1275],
-    'americas': [340, 425, 519, 619, 727, 840, 943, 1006],
-    'asia': [1394, 1686, 2120, 2625, 3202, 3714, 4169, 4560],
-    'europe': [220, 253, 276, 295, 310, 303, 294, 293],
-    'oceania': [12, 15, 19, 22, 26, 31, 36, 39],
+    'Africa': [.228, .284, .365, .477, .631, .814, 1.044, 1.275],
+    'the Americas': [.340, .425, .519, .619, .727, .840, .943, 1.006],
+    'Asia': [1.394, 1.686, 2.120, 2.625, 3.202, 3.714, 4.169, 4.560],
+    'Europe': [.220, .253, .276, .295, .310, .303, .294, .293],
+    'Oceania': [.012, .015, .019, .022, .026, .031, .036, .039],
 }
 
 fig, ax = plt.subplots()
@@ -33,7 +35,9 @@
 ax.legend(loc='upper left', reverse=True)
 ax.set_title('World population')
 ax.set_xlabel('Year')
-ax.set_ylabel('Number of people (millions)')
+ax.set_ylabel('Number of people (billions)')
+# add tick at every 200 million people
+ax.yaxis.set_minor_locator(mticker.MultipleLocator(.2))
 
 plt.show()
 

From 78791894c96e6892c1d4413bade9fc655a38492f Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Wed, 22 Nov 2023 14:40:20 +0100
Subject: [PATCH 0445/1120] Fix removal of colorbars on nested subgridspecs.

Indiscriminately going back up to the topmost gridspec is wrong in the
presence of nested gridspecs.

We may want to add an API to just go up one level in gridspecs (i.e.
public access to _subplot_spec) but I'd like to first consider whether
we could e.g. merge GridSpecFromSubplotSpec into GridSpec with the only
difference that the former's get_parent() (or another similarly named
new method) returns another gridspec whereas the latter's returns a
figure.
---
 lib/matplotlib/colorbar.py            |  9 +++------
 lib/matplotlib/tests/test_colorbar.py | 21 +++++++++++----------
 2 files changed, 14 insertions(+), 16 deletions(-)

diff --git a/lib/matplotlib/colorbar.py b/lib/matplotlib/colorbar.py
index b54211654d13..920c0d67722a 100644
--- a/lib/matplotlib/colorbar.py
+++ b/lib/matplotlib/colorbar.py
@@ -1035,14 +1035,11 @@ def remove(self):
         except AttributeError:
             return
         try:
-            gs = ax.get_subplotspec().get_gridspec()
-            subplotspec = gs.get_topmost_subplotspec()
-        except AttributeError:
-            # use_gridspec was False
+            subplotspec = self.ax.get_subplotspec().get_gridspec()._subplot_spec
+        except AttributeError:  # use_gridspec was False
             pos = ax.get_position(original=True)
             ax._set_position(pos)
-        else:
-            # use_gridspec was True
+        else:  # use_gridspec was True
             ax.set_subplotspec(subplotspec)
 
     def _process_values(self):
diff --git a/lib/matplotlib/tests/test_colorbar.py b/lib/matplotlib/tests/test_colorbar.py
index 0cf098e787ee..509d08dae183 100644
--- a/lib/matplotlib/tests/test_colorbar.py
+++ b/lib/matplotlib/tests/test_colorbar.py
@@ -279,13 +279,16 @@ def test_colorbar_single_scatter():
     plt.colorbar(cs)
 
 
-@pytest.mark.parametrize('use_gridspec', [False, True],
-                         ids=['no gridspec', 'with gridspec'])
-def test_remove_from_figure(use_gridspec):
-    """
-    Test `remove` with the specified ``use_gridspec`` setting
-    """
-    fig, ax = plt.subplots()
+@pytest.mark.parametrize('use_gridspec', [True, False])
+@pytest.mark.parametrize('nested_gridspecs', [True, False])
+def test_remove_from_figure(nested_gridspecs, use_gridspec):
+    """Test `remove` with the specified ``use_gridspec`` setting."""
+    fig = plt.figure()
+    if nested_gridspecs:
+        gs = fig.add_gridspec(2, 2)[1, 1].subgridspec(2, 2)
+        ax = fig.add_subplot(gs[1, 1])
+    else:
+        ax = fig.add_subplot()
     sc = ax.scatter([1, 2], [3, 4])
     sc.set_array(np.array([5, 6]))
     pre_position = ax.get_position()
@@ -298,9 +301,7 @@ def test_remove_from_figure(use_gridspec):
 
 
 def test_remove_from_figure_cl():
-    """
-    Test `remove` with constrained_layout
-    """
+    """Test `remove` with constrained_layout."""
     fig, ax = plt.subplots(constrained_layout=True)
     sc = ax.scatter([1, 2], [3, 4])
     sc.set_array(np.array([5, 6]))

From d9f9abee868b2c126e755d300c56432e7d4450b0 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Wed, 22 Nov 2023 23:02:10 +0100
Subject: [PATCH 0446/1120] Implement SubFigure.remove.

---
 lib/matplotlib/figure.py            | 1 +
 lib/matplotlib/tests/test_figure.py | 7 +++++++
 2 files changed, 8 insertions(+)

diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
index cd26af84ccbe..11b42b1e1ac7 100644
--- a/lib/matplotlib/figure.py
+++ b/lib/matplotlib/figure.py
@@ -1577,6 +1577,7 @@ def add_subfigure(self, subplotspec, **kwargs):
         """
         sf = SubFigure(self, subplotspec, **kwargs)
         self.subfigs += [sf]
+        sf._remove_method = self.subfigs.remove
         return sf
 
     def sca(self, a):
diff --git a/lib/matplotlib/tests/test_figure.py b/lib/matplotlib/tests/test_figure.py
index 6d6a3d772f4e..24d4f1c0f059 100644
--- a/lib/matplotlib/tests/test_figure.py
+++ b/lib/matplotlib/tests/test_figure.py
@@ -1482,6 +1482,13 @@ def test_subfigures_wspace_hspace():
     np.testing.assert_allclose(sub_figs[1, 2].bbox.max, [w, h * 0.4])
 
 
+def test_subfigure_remove():
+    fig = plt.figure()
+    sfs = fig.subfigures(2, 2)
+    sfs[1, 1].remove()
+    assert len(fig.subfigs) == 3
+
+
 def test_add_subplot_kwargs():
     # fig.add_subplot() always creates new axes, even if axes kwargs differ.
     fig = plt.figure()

From 6a7cd0edb91e92645bed258b62fe7fe53ba32cfb Mon Sep 17 00:00:00 2001
From: Steffen Rehberg <steffen.rehberg@googlemail.com>
Date: Thu, 23 Nov 2023 13:19:09 +0100
Subject: [PATCH 0447/1120] [DOC]: Fix menu example

Make example independent on dpi setting when saving the output
with different resolutions to prevent shifting of texts and rects.
---
 galleries/examples/widgets/menu.py | 25 +++++++++++++------------
 1 file changed, 13 insertions(+), 12 deletions(-)

diff --git a/galleries/examples/widgets/menu.py b/galleries/examples/widgets/menu.py
index b8f5268a6477..8d3db3d1b9c3 100644
--- a/galleries/examples/widgets/menu.py
+++ b/galleries/examples/widgets/menu.py
@@ -3,13 +3,12 @@
 Menu
 ====
 
+Using texts to construct a simple menu.
 """
-
 import matplotlib.pyplot as plt
 
 import matplotlib.artist as artist
 import matplotlib.patches as patches
-from matplotlib.transforms import IdentityTransform
 
 
 class ItemProperties:
@@ -22,8 +21,8 @@ def __init__(self, fontsize=14, labelcolor='black', bgcolor='yellow',
 
 
 class MenuItem(artist.Artist):
-    padx = 5
-    pady = 5
+    padx = 0.05  # inches
+    pady = 0.05
 
     def __init__(self, fig, labelstr, props=None, hoverprops=None,
                  on_select=None):
@@ -41,14 +40,16 @@ def __init__(self, fig, labelstr, props=None, hoverprops=None,
 
         self.on_select = on_select
 
-        # Setting the transform to IdentityTransform() lets us specify
-        # coordinates directly in pixels.
-        self.label = fig.text(0, 0, labelstr, transform=IdentityTransform(),
+        # specify coordinates in inches.
+        self.label = fig.text(0, 0, labelstr, transform=fig.dpi_scale_trans,
                               size=props.fontsize)
         self.text_bbox = self.label.get_window_extent(
             fig.canvas.get_renderer())
+        self.text_bbox = fig.dpi_scale_trans.inverted().transform_bbox(self.text_bbox)
 
-        self.rect = patches.Rectangle((0, 0), 1, 1)  # Will be updated later.
+        self.rect = patches.Rectangle(
+            (0, 0), 1, 1, transform=fig.dpi_scale_trans
+        )  # Will be updated later.
 
         self.set_hover_props(False)
 
@@ -63,7 +64,7 @@ def check_select(self, event):
 
     def set_extent(self, x, y, w, h, depth):
         self.rect.set(x=x, y=y, width=w, height=h)
-        self.label.set(position=(x + self.padx, y + depth + self.pady/2))
+        self.label.set(position=(x + self.padx, y + depth + self.pady / 2))
         self.hover = False
 
     def draw(self, renderer):
@@ -97,10 +98,10 @@ def __init__(self, fig, menuitems):
         maxh = max(item.text_bbox.height for item in menuitems)
         depth = max(-item.text_bbox.y0 for item in menuitems)
 
-        x0 = 100
-        y0 = 400
+        x0 = 1
+        y0 = 4
 
-        width = maxw + 2*MenuItem.padx
+        width = maxw + 2 * MenuItem.padx
         height = maxh + MenuItem.pady
 
         for item in menuitems:

From 43e0692178fca4a30b380ac5fb4c7ae141e698c0 Mon Sep 17 00:00:00 2001
From: Steffen Rehberg <steffen.rehberg@googlemail.com>
Date: Thu, 23 Nov 2023 22:57:31 +0100
Subject: [PATCH 0448/1120] Fix _find_fonts_by_props docstring

to match actual return value (list instead of dict).
---
 lib/matplotlib/font_manager.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/lib/matplotlib/font_manager.py b/lib/matplotlib/font_manager.py
index 68b22ccf7df1..9996c59ea1d8 100644
--- a/lib/matplotlib/font_manager.py
+++ b/lib/matplotlib/font_manager.py
@@ -1339,10 +1339,10 @@ def _find_fonts_by_props(self, prop, fontext='ttf', directory=None,
         -----
         This is an extension/wrapper of the original findfont API, which only
         returns a single font for given font properties. Instead, this API
-        returns a dict containing multiple fonts and their filepaths
-        which closely match the given font properties.  Since this internally
-        uses the original API, there's no change to the logic of performing the
-        nearest neighbor search.  See `findfont` for more details.
+        returns a list of filepaths of multiple fonts which closely match the
+        given font properties.  Since this internally uses the original API,
+        there's no change to the logic of performing the nearest neighbor
+        search.  See `findfont` for more details.
         """
 
         prop = FontProperties._from_any(prop)

From b1a7e7be88899f668bae0a100a0e6d1e4be67590 Mon Sep 17 00:00:00 2001
From: tobias <tobias@freedom.localdomain>
Date: Sun, 26 Nov 2023 20:36:56 +0100
Subject: [PATCH 0449/1120] Fix get_path for 3d artists

This is a slightly adapted version of commit
1868c05e622ad521efd5671e47eef6bd35e0b8c9
---
 lib/mpl_toolkits/mplot3d/art3d.py             |  5 +++++
 lib/mpl_toolkits/mplot3d/tests/test_axes3d.py | 10 ++++++++++
 2 files changed, 15 insertions(+)

diff --git a/lib/mpl_toolkits/mplot3d/art3d.py b/lib/mpl_toolkits/mplot3d/art3d.py
index 4aff115b0c96..ea43549c33fa 100644
--- a/lib/mpl_toolkits/mplot3d/art3d.py
+++ b/lib/mpl_toolkits/mplot3d/art3d.py
@@ -448,6 +448,11 @@ def set_3d_properties(self, verts, zs=0, zdir='z'):
                            for ((x, y), z) in zip(verts, zs)]
 
     def get_path(self):
+        # docstring inherited
+        # self._path2d is not initialized until do_3d_projection
+        if not hasattr(self, '_path2d'):
+            self.axes.M = self.axes.get_proj()
+            self.do_3d_projection()
         return self._path2d
 
     def do_3d_projection(self):
diff --git a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
index 4024eeddcf17..1c6bbdd91670 100644
--- a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
@@ -2112,6 +2112,16 @@ def test_scatter_spiral():
     fig.canvas.draw()
 
 
+def test_Poly3DCollection_get_path():
+    # Smoke test to see that get_path does not raise
+    # See GH#27361
+    fig, ax = plt.subplots(subplot_kw={"projection": "3d"})
+    p = Circle((0, 0), 1.0)
+    ax.add_patch(p)
+    art3d.pathpatch_2d_to_3d(p)
+    p.get_path()
+
+
 def test_Poly3DCollection_get_facecolor():
     # Smoke test to see that get_facecolor does not raise
     # See GH#4067

From 40d01466b3b526fe9915a1fd1badc2b9b536552e Mon Sep 17 00:00:00 2001
From: Steffen Rehberg <steffen.rehberg@googlemail.com>
Date: Mon, 27 Nov 2023 11:25:40 +0100
Subject: [PATCH 0450/1120] MNT: add _version.py to .gitignore

_version.py is generated by setuptools_scm and should not be
tracked in version control
---
 .gitignore | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.gitignore b/.gitignore
index 471431dd3433..99e7a628cffd 100644
--- a/.gitignore
+++ b/.gitignore
@@ -44,6 +44,8 @@ pip-wheel-metadata/*
 # build subproject files
 subprojects/*/
 !subprojects/packagefiles/
+# file generated by setuptools_scm
+_version.py
 
 # OS generated files #
 ######################

From 7ff0760b49fd8912ea3eb11703e0df0a92a2ff6f Mon Sep 17 00:00:00 2001
From: Steffen Rehberg <steffen.rehberg@googlemail.com>
Date: Mon, 27 Nov 2023 13:31:09 +0100
Subject: [PATCH 0451/1120] TST: Make test_movie_writer_invalid_path
 locale-agnostic

Filtering on the error message failed on locales different from
English (just matching the error in brackets would also do).
---
 lib/matplotlib/tests/test_animation.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/tests/test_animation.py b/lib/matplotlib/tests/test_animation.py
index a4de96d77b62..d026dae59533 100644
--- a/lib/matplotlib/tests/test_animation.py
+++ b/lib/matplotlib/tests/test_animation.py
@@ -545,9 +545,9 @@ def test_disable_cache_warning(anim):
 
 def test_movie_writer_invalid_path(anim):
     if sys.platform == "win32":
-        match_str = re.escape("[WinError 3] The system cannot find the path specified:")
+        match_str = r"\[WinError 3] .*'\\\\foo\\\\bar\\\\aardvark'"
     else:
-        match_str = re.escape("[Errno 2] No such file or directory: '/foo")
+        match_str = r"\[Errno 2] .*'/foo"
     with pytest.raises(FileNotFoundError, match=match_str):
         anim.save("/foo/bar/aardvark/thiscannotreallyexist.mp4",
                   writer=animation.FFMpegFileWriter())

From e2c9cd4ac69d86d496ca4f171c3b6d57c2781e09 Mon Sep 17 00:00:00 2001
From: Samuel Diebolt <samuel@diebolt.io>
Date: Mon, 27 Nov 2023 17:22:21 +0100
Subject: [PATCH 0452/1120] [MNT] fix type annotations of `fignum_exists`
 (#27376)

* fix: fix type annotations of `fignum_exists`

* docs: expand documentation of `fignum_exists`

* fix(docs): fix documentation of `fignum_exists`

Co-authored-by: Ruth Comer <10599679+rcomer@users.noreply.github.com>

---------

Co-authored-by: Ruth Comer <10599679+rcomer@users.noreply.github.com>
---
 lib/matplotlib/pyplot.py | 21 ++++++++++++++++++---
 1 file changed, 18 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index ddbb6cb36728..1255818b41b5 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -999,9 +999,24 @@ def gcf() -> Figure:
         return figure()
 
 
-def fignum_exists(num: int) -> bool:
-    """Return whether the figure with the given id exists."""
-    return _pylab_helpers.Gcf.has_fignum(num) or num in get_figlabels()
+def fignum_exists(num: int | str) -> bool:
+    """Return whether the figure with the given id exists.
+
+    Parameters
+    ----------
+    num : int or str
+        A figure identifier.
+
+    Returns
+    -------
+    bool
+        Whether or not a figure with id *num* exists.
+    """
+    return (
+        _pylab_helpers.Gcf.has_fignum(num)
+        if isinstance(num, int)
+        else num in get_figlabels()
+    )
 
 
 def get_fignums() -> list[int]:

From 8b3eb71394985b471e733271f6a61880da55f772 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 22 Nov 2023 03:09:24 -0500
Subject: [PATCH 0453/1120] ci: Remove old condition

This condition was when we had Ubuntu 18.04 and added 20.04. When we
dropped 18.04, and moved to 20.04+22.04, this condition should've been
enabled everywhere.
---
 .github/workflows/tests.yml | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 614f9235a5a4..3826c7d5c412 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -286,11 +286,7 @@ jobs:
           # Set flag in a delayed manner to avoid issues with installing other
           # packages
           if [[ "${{ runner.os }}" != 'macOS' ]]; then
-            if [[ "$(lsb_release -r -s)" == "20.04" ]]; then
-              export CPPFLAGS='--coverage -fprofile-abs-path'
-            else
-              export CPPFLAGS='--coverage'
-            fi
+            export CPPFLAGS='--coverage -fprofile-abs-path'
           fi
 
           python -m pip install --no-deps --no-build-isolation --verbose \

From 05e7644a86992431e0d0bc50d80079eda1a3bf9e Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 22 Nov 2023 04:00:28 -0500
Subject: [PATCH 0454/1120] ci: Get coverage working for compiled macOS code

---
 .github/workflows/tests.yml | 24 +++++++++++++++++-------
 1 file changed, 17 insertions(+), 7 deletions(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 3826c7d5c412..33260e6fc2a9 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -285,7 +285,10 @@ jobs:
 
           # Set flag in a delayed manner to avoid issues with installing other
           # packages
-          if [[ "${{ runner.os }}" != 'macOS' ]]; then
+          if [[ "${{ runner.os }}" == 'macOS' ]]; then
+            export CPPFLAGS='-fprofile-instr-generate=default.%m.profraw'
+            export CPPFLAGS="$CPPFLAGS -fcoverage-mapping"
+          else
             export CPPFLAGS='--coverage -fprofile-abs-path'
           fi
 
@@ -310,12 +313,19 @@ jobs:
 
       - name: Filter C coverage
         run: |
-          lcov --rc lcov_branch_coverage=1 --capture --directory . --output-file coverage.info
-          lcov --rc lcov_branch_coverage=1 --output-file coverage.info \
-            --extract coverage.info $PWD/src/'*' $PWD/lib/'*'
-          lcov --rc lcov_branch_coverage=1 --list coverage.info
-          find . -name '*.gc*' -delete
-        if: ${{ runner.os != 'macOS' }}
+          if [[ "${{ runner.os }}" != 'macOS' ]]; then
+            lcov --rc lcov_branch_coverage=1 --capture --directory . \
+              --output-file coverage.info
+            lcov --rc lcov_branch_coverage=1 --output-file coverage.info \
+              --extract coverage.info $PWD/src/'*' $PWD/lib/'*'
+            lcov --rc lcov_branch_coverage=1 --list coverage.info
+            find . -name '*.gc*' -delete
+          else
+            xcrun llvm-profdata merge -sparse default.*.profraw \
+              -o default.profdata
+            xcrun llvm-cov export -format="lcov" build/*/src/*.so \
+              -instr-profile default.profdata > info.lcov
+          fi
       - name: Upload code coverage
         uses: codecov/codecov-action@v3
 

From c41d5d81487ace3237b6a18b56338781cd505007 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 22 Nov 2023 21:35:18 -0500
Subject: [PATCH 0455/1120] ci: Add names to each codecov build

Codecov shows the CI provider, but all jobs are tagged with the overall
workflow ID. Passing a name allows differentiating between each build
(i.e., Python version and system platform.)
---
 .appveyor.yml               | 2 +-
 .github/workflows/tests.yml | 2 ++
 azure-pipelines.yml         | 2 +-
 3 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/.appveyor.yml b/.appveyor.yml
index 6e71e94e58f5..ac9608ec56ea 100644
--- a/.appveyor.yml
+++ b/.appveyor.yml
@@ -94,7 +94,7 @@ artifacts:
 
 on_finish:
   - conda install codecov
-  - codecov -e PYTHON_VERSION PLATFORM
+  - codecov -e PYTHON_VERSION PLATFORM -n "$PYTHON_VERSION Windows"
 
 on_failure:
   # Generate a html for visual tests
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 33260e6fc2a9..0f9786430b35 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -328,6 +328,8 @@ jobs:
           fi
       - name: Upload code coverage
         uses: codecov/codecov-action@v3
+        with:
+          name: "${{ matrix.python-version }} ${{ matrix.os }} ${{ matrix.name-suffix }}"
 
       - uses: actions/upload-artifact@v3
         if: failure()
diff --git a/azure-pipelines.yml b/azure-pipelines.yml
index 8eb5cacfb55a..3a1006e1b273 100644
--- a/azure-pipelines.yml
+++ b/azure-pipelines.yml
@@ -157,7 +157,7 @@ stages:
         displayName: 'pytest'
 
       - bash: |
-          bash <(curl -s https://codecov.io/bash)  -f "!*.gcov" -X gcov
+          bash <(curl -s https://codecov.io/bash) -n "$PYTHON_VERSION $AGENT_OS" -f "!*.gcov" -X gcov
         displayName: 'Upload to codecov.io'
 
       - task: PublishTestResults@2

From dc759a157e59d58585e9d5a95eb299aee25d2cb5 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 22 Nov 2023 22:51:07 -0500
Subject: [PATCH 0456/1120] ci: Enable compiled code coverage on Azure

---
 azure-pipelines.yml | 130 +++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 123 insertions(+), 7 deletions(-)

diff --git a/azure-pipelines.yml b/azure-pipelines.yml
index 3a1006e1b273..44adc6f08422 100644
--- a/azure-pipelines.yml
+++ b/azure-pipelines.yml
@@ -88,8 +88,8 @@ stages:
 
       - bash: |
           set -e
-          case "$(python -c 'import sys; print(sys.platform)')" in
-          linux)
+          case "$AGENT_OS" in
+          Linux)
             echo 'Acquire::Retries "3";' | sudo tee /etc/apt/apt.conf.d/80-retries
             sudo apt update
             sudo apt install --no-install-recommends \
@@ -103,6 +103,7 @@ stages:
               gir1.2-gtk-3.0 \
               graphviz \
               inkscape \
+              lcov \
               libcairo2 \
               libgirepository-1.0-1 \
               lmodern \
@@ -116,13 +117,13 @@ stages:
               texlive-pictures \
               texlive-xetex
             ;;
-          darwin)
+          Darwin)
             brew install --cask xquartz
             brew install ccache ffmpeg imagemagick mplayer ninja pkg-config
             brew tap homebrew/cask-fonts
             brew install font-noto-sans-cjk-sc
             ;;
-          win32)
+          Windows_NT)
             choco install ninja
             ;;
           *)
@@ -139,8 +140,26 @@ stages:
         displayName: 'Install dependencies with pip'
 
       - bash: |
+          case "$AGENT_OS" in
+          Linux)
+            export CPPFLAGS='--coverage -fprofile-abs-path'
+            ;;
+          Darwin)
+            export CPPFLAGS='-fprofile-instr-generate=default.%m.profraw'
+            export CPPFLAGS="$CPPFLAGS -fcoverage-mapping"
+            ;;
+          Windows_NT)
+            CONFIG='--config-settings=setup-args=--vsenv'
+            CONFIG="$CONFIG --config-settings=setup-args=-Dcpp_link_args=-PROFILE"
+            CONFIG="$CONFIG --config-settings=setup-args=-Dbuildtype=debug"
+            ;;
+          *)
+            exit 1
+            ;;
+          esac
+
           python -m pip install \
-            --no-build-isolation --config-settings=setup-args="--vsenv" \
+            --no-build-isolation $CONFIG \
             --verbose --editable .[dev] ||
             [[ "$PYTHON_VERSION" = 'Pre' ]]
         displayName: "Install self"
@@ -152,12 +171,109 @@ stages:
         displayName: 'print pip'
 
       - bash: |
-          PYTHONFAULTHANDLER=1 python -m pytest --junitxml=junit/test-results.xml -raR --maxfail=50 --timeout=300 --durations=25 --cov-report= --cov=lib -n 2 ||
+          set -e
+          if [[ "$AGENT_OS" == 'Windows_NT' ]]; then
+            SESSION_ID=$(python -c "import uuid; print(uuid.uuid4(), end='')")
+            echo "Coverage session ID: ${SESSION_ID}"
+            VS=$(ls -d /c/Program\ Files*/Microsoft\ Visual\ Studio/*/Enterprise)
+            echo "Visual Studio: ${VS}"
+            DIR="$VS/Common7/IDE/Extensions/Microsoft/CodeCoverage.Console"
+            if [[ -d $DIR ]]; then
+              # This is for MSVC 2022 (on windows-latest).
+              TOOL="$DIR/Microsoft.CodeCoverage.Console.exe"
+              for f in build/cp*/src/*.pyd; do
+                echo $f
+                echo "=============================="
+                "$TOOL" instrument $f --session-id $SESSION_ID \
+                  --log-level Verbose --log-file instrument.log
+                cat instrument.log
+                rm instrument.log
+              done
+              echo "Starting $TOOL in server mode"
+              "$TOOL" collect \
+                  --session-id $SESSION_ID --server-mode \
+                  --output-format cobertura --output extensions.xml \
+                  --log-level Verbose --log-file extensions.log &
+              VS_VER=2022
+            else
+            DIR="$VS"/Team\ Tools/Dynamic\ Code\ Coverage\ Tools/amd64
+            if [[ -d $DIR ]]; then
+              # This is for MSVC 2019 (on windows-2019).
+              VSINSTR="$VS"/Team\ Tools/Performance\ Tools/vsinstr.exe
+              for f in build/cp*/src/*.pyd; do
+                "$VSINSTR" $f -Verbose -Coverage
+              done
+              TOOL="$DIR/CodeCoverage.exe"
+              cat > extensions.config << EOF
+          <CodeCoverage>
+            <CollectFromChildProcesses>true</CollectFromChildProcesses>
+            <ModulePaths>
+              <Include>
+                <ModulePath>.*\\.*\.pyd</ModulePath>
+              </Include>
+            </ModulePaths>
+          </CodeCoverage>
+          EOF
+              echo "Starting $TOOL in server mode"
+              "$TOOL" collect \
+                -config:extensions.config -session:$SESSION_ID \
+                -output:extensions.coverage -verbose &
+              echo "Started $TOOL"
+              VS_VER=2019
+            fi
+            fi
+            echo "##vso[task.setvariable variable=VS_COVERAGE_TOOL]$TOOL"
+          fi
+          PYTHONFAULTHANDLER=1 python -m pytest -raR -n 2 \
+              --maxfail=50 --timeout=300 --durations=25 \
+              --junitxml=junit/test-results.xml --cov-report=xml --cov=lib ||
             [[ "$PYTHON_VERSION" = 'Pre' ]]
+          if [[ -n $SESSION_ID ]]; then
+            if [[ $VS_VER == 2022 ]]; then
+              "$TOOL" shutdown $SESSION_ID
+              echo "Coverage collection log"
+              echo "======================="
+              cat extensions.log
+            else
+              "$TOOL" shutdown -session:$SESSION_ID
+            fi
+          fi
         displayName: 'pytest'
 
       - bash: |
-          bash <(curl -s https://codecov.io/bash) -n "$PYTHON_VERSION $AGENT_OS" -f "!*.gcov" -X gcov
+          case "$AGENT_OS" in
+          Linux)
+            lcov --rc lcov_branch_coverage=1 --capture --directory . \
+              --output-file coverage.info
+            lcov --rc lcov_branch_coverage=1 --output-file coverage.info \
+              --extract coverage.info $PWD/src/'*' $PWD/lib/'*'
+            lcov --rc lcov_branch_coverage=1 --list coverage.info
+            find . -name '*.gc*' -delete
+            ;;
+          Darwin)
+            xcrun llvm-profdata merge -sparse default.*.profraw \
+              -o default.profdata
+            xcrun llvm-cov export -format="lcov" build/*/src/*.so \
+              -instr-profile default.profdata > info.lcov
+            ;;
+          Windows_NT)
+            if [[ -f extensions.coverage ]]; then
+              # For MSVC 2019.
+              "$VS_COVERAGE_TOOL" analyze -output:extensions.xml \
+                -include_skipped_functions -include_skipped_modules \
+                extensions.coverage
+              rm extensions.coverage
+            fi
+            ;;
+          *)
+            exit 1
+            ;;
+          esac
+        displayName: 'Filter C coverage'
+      - bash: |
+          bash <(curl -s https://codecov.io/bash) \
+            -n "$PYTHON_VERSION $AGENT_OS" \
+            -f 'coverage.xml' -f 'extensions.xml'
         displayName: 'Upload to codecov.io'
 
       - task: PublishTestResults@2

From b06232512d0aabee11bec6dc3115ea0a6b1be493 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Tue, 28 Nov 2023 00:01:45 -0500
Subject: [PATCH 0457/1120] added version guarded admonishment

---
 doc/devel/index.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/doc/devel/index.rst b/doc/devel/index.rst
index 95572aa661cf..5bb1d240611e 100644
--- a/doc/devel/index.rst
+++ b/doc/devel/index.rst
@@ -4,6 +4,15 @@
 Contribute
 ##########
 
+.. ifconfig:: releaselevel != 'dev'
+
+   .. important::
+
+      If you plan to contribute to Matplotlib, please read the
+      `development version <https://matplotlib.org/devdocs/devel/index.html>`_
+      of this document as it will have the most up to date installation
+      instructions, workflow process, and contributing guidelines.
+
 Thank you for your interest in helping to improve Matplotlib! There are various
 ways to contribute: optimizing and refactoring code, detailing unclear
 documentation and writing new examples, reporting and fixing bugs and requesting

From ee37c24d28bff3870ff90d79ebebe6f1d3c01c98 Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Tue, 28 Nov 2023 08:17:59 +0000
Subject: [PATCH 0458/1120] Revert "MNT: add _version.py to .gitignore"

---
 .gitignore | 2 --
 1 file changed, 2 deletions(-)

diff --git a/.gitignore b/.gitignore
index 99e7a628cffd..471431dd3433 100644
--- a/.gitignore
+++ b/.gitignore
@@ -44,8 +44,6 @@ pip-wheel-metadata/*
 # build subproject files
 subprojects/*/
 !subprojects/packagefiles/
-# file generated by setuptools_scm
-_version.py
 
 # OS generated files #
 ######################

From 047ad3b724df167c3e3bfdcfadc1d45059207b26 Mon Sep 17 00:00:00 2001
From: Steffen Rehberg <steffen.rehberg@googlemail.com>
Date: Wed, 29 Nov 2023 16:45:37 +0100
Subject: [PATCH 0459/1120] MNT: Fix doc makefiles

- match make.bat with Makefile
- clean sg_execution_times.rst and git ignore it
  (see sphinx gallery #1198)
---
 .gitignore   | 1 +
 doc/Makefile | 1 +
 doc/make.bat | 3 +++
 3 files changed, 5 insertions(+)

diff --git a/.gitignore b/.gitignore
index 471431dd3433..41c97b62c51e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -83,6 +83,7 @@ result_images
 doc/_static/constrained_layout*.png
 doc/.mpl_skip_subdirs.yaml
 doc/_tags
+sg_execution_times.rst
 
 # Nose/Pytest generated files #
 ###############################
diff --git a/doc/Makefile b/doc/Makefile
index 53b7c02b68fa..7eda39d87624 100644
--- a/doc/Makefile
+++ b/doc/Makefile
@@ -26,6 +26,7 @@ clean:
 	rm -rf "$(SOURCEDIR)/savefig"
 	rm -rf "$(SOURCEDIR)/sphinxext/__pycache__"
 	rm -f $(SOURCEDIR)/_static/constrained_layout*.png
+	rm -f $(SOURCEDIR)/sg_execution_times.rst
 
 show:
 	@python -c "import webbrowser; webbrowser.open_new_tab('file://$(shell pwd)/build/html/index.html')"
diff --git a/doc/make.bat b/doc/make.bat
index 220523d74b60..37c74eb5079a 100644
--- a/doc/make.bat
+++ b/doc/make.bat
@@ -40,8 +40,11 @@ if "%1" == "clean" (
 	rmdir /s /q "%SOURCEDIR%\gallery"
 	rmdir /s /q "%SOURCEDIR%\plot_types"
 	rmdir /s /q "%SOURCEDIR%\tutorials"
+	rmdir /s /q "%SOURCEDIR%\users\explain"
 	rmdir /s /q "%SOURCEDIR%\savefig"
 	rmdir /s /q "%SOURCEDIR%\sphinxext\__pycache__"
+	del /q "%SOURCEDIR%\_static\constrained_layout*.png"
+	del /q "%SOURCEDIR%\sg_execution_times.rst"
 )
 goto end
 

From 631240929f08fd39fdb5cb28926a9e4bc61981e3 Mon Sep 17 00:00:00 2001
From: Joshua Stevenson <joshua.stevenson@udri.udayton.edu>
Date: Wed, 29 Nov 2023 15:27:28 -0500
Subject: [PATCH 0460/1120] SpanSelector widget: Improve doc for `extents`

---
 lib/matplotlib/widgets.py | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/widgets.py b/lib/matplotlib/widgets.py
index cd9716408303..354e18728447 100644
--- a/lib/matplotlib/widgets.py
+++ b/lib/matplotlib/widgets.py
@@ -2695,7 +2695,7 @@ def _press(self, event):
 
     @property
     def direction(self):
-        """Direction of the span selector: 'vertical' or 'horizontal'."""
+        """Direction of the span selector: 'vertical' or 'horizontal'. Writable."""
         return self._direction
 
     @direction.setter
@@ -2855,7 +2855,12 @@ def _snap(values, snap_values):
 
     @property
     def extents(self):
-        """Return extents of the span selector."""
+        """
+        (float, float)
+            The axis values for the start and end points of the current selection.
+            If there is no selection then the start and end values will be the same.
+            Writable.
+        """
         if self.direction == 'horizontal':
             vmin = self._selection_artist.get_x()
             vmax = vmin + self._selection_artist.get_width()

From 71a7abe70d99005bc2d3985b7ea51c1dbbde4066 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Wed, 29 Nov 2023 13:56:29 -0500
Subject: [PATCH 0461/1120] Moved dependencies under install because its
 version dependent and cleaned up the headings a bit

---
 doc/devel/development_setup.rst               | 12 +++++-
 doc/devel/index.rst                           |  6 ---
 .../installing}/dependencies.rst              |  4 +-
 doc/users/installing/index.rst                | 43 +++++++++++++------
 4 files changed, 44 insertions(+), 21 deletions(-)
 rename doc/{devel => users/installing}/dependencies.rst (99%)

diff --git a/doc/devel/development_setup.rst b/doc/devel/development_setup.rst
index 745a74dcf8bb..6e24c085829d 100644
--- a/doc/devel/development_setup.rst
+++ b/doc/devel/development_setup.rst
@@ -155,9 +155,16 @@ Remember to activate the environment whenever you start working on Matplotlib.
 
 Install Dependencies
 ====================
+
 Most Python dependencies will be installed when :ref:`setting up the environment <dev-environment>`
 but non-Python dependencies like C++ compilers, LaTeX, and other system applications
-must be installed separately. For a full list, see :ref:`dependencies`.
+must be installed separately.
+
+.. toctree::
+  :maxdepth: 2
+
+  ../users/installing/dependencies
+
 
 .. _development-install:
 
@@ -195,6 +202,9 @@ config during installation ::
 For more information on installation and other configuration options, see the
 Meson Python :external+meson-python:ref:`editable installs guide <how-to-guides-editable-installs>`.
 
+For a list of the other environment variables you can set before install, see :ref:`environment-variables`.
+
+
 Verify the Installation
 =======================
 
diff --git a/doc/devel/index.rst b/doc/devel/index.rst
index 95572aa661cf..3e1148d25df5 100644
--- a/doc/devel/index.rst
+++ b/doc/devel/index.rst
@@ -88,12 +88,6 @@ Development environment
 
          development_setup
 
-      .. toctree::
-         :maxdepth: 1
-
-         dependencies
-         ../users/installing/environment_variables_faq.rst
-
 
    .. grid-item-card::
       :shadow: none
diff --git a/doc/devel/dependencies.rst b/doc/users/installing/dependencies.rst
similarity index 99%
rename from doc/devel/dependencies.rst
rename to doc/users/installing/dependencies.rst
index c0e761d6beb6..ce83454db08a 100644
--- a/doc/devel/dependencies.rst
+++ b/doc/users/installing/dependencies.rst
@@ -1,3 +1,5 @@
+.. redirect-from: /devel/dependencies
+
 .. _dependencies:
 
 ************
@@ -387,7 +389,7 @@ The additional Python packages required to build the
 
 The content of :file:`doc-requirements.txt` is also shown below:
 
-.. include:: ../../requirements/doc/doc-requirements.txt
+.. include:: ../../../requirements/doc/doc-requirements.txt
    :literal:
 
 
diff --git a/doc/users/installing/index.rst b/doc/users/installing/index.rst
index 0d25ffbf76fa..bea9a47b582d 100644
--- a/doc/users/installing/index.rst
+++ b/doc/users/installing/index.rst
@@ -1,8 +1,8 @@
 .. redirect-from:: /users/installing
 
-============
+************
 Installation
-============
+************
 
 
 Install an official release
@@ -135,25 +135,42 @@ Configure build and behavior defaults
 =====================================
 
 Aspects of the build and install process and some behaviorial defaults of the
-library can be configured via :ref:`environment-variables`. Default plotting
-appearance and behavior can be configured via the
+library can be configured via:
+
+.. toctree::
+  :maxdepth: 2
+
+  environment_variables_faq.rst
+
+Default plotting appearance and behavior can be configured via the
 :ref:`rcParams file <customizing-with-matplotlibrc-files>`
 
 
+Dependencies
+============
+
+Mandatory dependencies should be installed automatically if you install Matplotlib using
+a package manager such as ``pip`` or ``conda``; therefore this list is primarily for
+reference and troubleshooting.
+
+.. toctree::
+  :maxdepth: 2
+
+  dependencies
+
 
 .. _installing-faq:
 
-==========================
 Frequently asked questions
-==========================
+===========================
 
 Report a compilation problem
-============================
+----------------------------
 
 See :ref:`reporting-problems`.
 
 Matplotlib compiled fine, but nothing shows up when I use it
-============================================================
+------------------------------------------------------------
 
 The first thing to try is a :ref:`clean install <clean-install>` and see if
 that helps.  If not, the best way to test your install is by running a script,
@@ -175,7 +192,7 @@ If you are still having trouble, see :ref:`reporting-problems`.
 .. _clean-install:
 
 How to completely remove Matplotlib
-===================================
+-----------------------------------
 
 Occasionally, problems with Matplotlib can be solved with a clean
 installation of the package.  In order to fully remove an installed Matplotlib:
@@ -187,12 +204,12 @@ installation of the package.  In order to fully remove an installed Matplotlib:
    directory <locating-matplotlib-install>`.
 
 OSX Notes
-=========
+---------
 
 .. _which-python-for-osx:
 
 Which python for OSX?
----------------------
+^^^^^^^^^^^^^^^^^^^^^
 
 Apple ships OSX with its own Python, in ``/usr/bin/python``, and its own copy
 of Matplotlib. Unfortunately, the way Apple currently installs its own copies
@@ -222,7 +239,7 @@ or Python.org Python.
 .. _install_osx_binaries:
 
 Installing OSX binary wheels
-----------------------------
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 If you are using Python from https://www.python.org, Homebrew, or Macports,
 then you can use the standard pip installer to install Matplotlib binaries in
@@ -242,7 +259,7 @@ You might also want to install IPython or the Jupyter notebook (``python3 -m pip
 install ipython notebook``).
 
 Checking your installation
---------------------------
+^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The new version of Matplotlib should now be on your Python "path".  Check this
 at the Terminal.app command line::

From a33125091cd08760e0f5a25801ca430a12b344a6 Mon Sep 17 00:00:00 2001
From: judfs <39133604+judfs@users.noreply.github.com>
Date: Wed, 29 Nov 2023 18:37:47 -0500
Subject: [PATCH 0462/1120] Update lib/matplotlib/widgets.py

Co-authored-by: hannah <story645@gmail.com>
---
 lib/matplotlib/widgets.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/widgets.py b/lib/matplotlib/widgets.py
index 354e18728447..717d1be83050 100644
--- a/lib/matplotlib/widgets.py
+++ b/lib/matplotlib/widgets.py
@@ -2857,7 +2857,7 @@ def _snap(values, snap_values):
     def extents(self):
         """
         (float, float)
-            The axis values for the start and end points of the current selection.
+            The values, in data coordinates, for the start and end points of the current selection.
             If there is no selection then the start and end values will be the same.
             Writable.
         """

From 24842ec53f443e053723c79d2897f41dc4da84b4 Mon Sep 17 00:00:00 2001
From: ElisaHeck <62849498+ElisaHeck@users.noreply.github.com>
Date: Thu, 30 Nov 2023 11:43:03 +0100
Subject: [PATCH 0463/1120] Add smoke test for Axes.barbs in test_datetime.py
 (#27331)

* added smoke test for Axes.barbs in test_datetime.py

* changed to use deterministic data
---
 lib/matplotlib/tests/test_datetime.py | 24 +++++++++++++++++++++---
 1 file changed, 21 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 316be793e47c..a3be7e2840a8 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -146,11 +146,29 @@ def test_bar_label(self):
         fig, ax = plt.subplots()
         ax.bar_label(...)
 
-    @pytest.mark.xfail(reason="Test for barbs not written yet")
     @mpl.style.context("default")
     def test_barbs(self):
-        fig, ax = plt.subplots()
-        ax.barbs(...)
+        plt.rcParams["date.converter"] = 'concise'
+
+        start_date = datetime.datetime(2022, 2, 8, 22)
+        dates = [start_date + datetime.timedelta(hours=i) for i in range(12)]
+
+        numbers = np.sin(np.linspace(0, 2 * np.pi, 12))
+
+        u = np.ones(12) * 10
+        v = np.arange(0, 120, 10)
+
+        fig, axes = plt.subplots(nrows=1, ncols=2, figsize=(12, 6))
+
+        axes[0].barbs(dates, numbers, u, v, length=7)
+        axes[0].set_title('Datetime vs. Numeric Data')
+        axes[0].set_xlabel('Datetime')
+        axes[0].set_ylabel('Numeric Data')
+
+        axes[1].barbs(numbers, dates, u, v, length=7)
+        axes[1].set_title('Numeric vs. Datetime Data')
+        axes[1].set_xlabel('Numeric Data')
+        axes[1].set_ylabel('Datetime')
 
     @mpl.style.context("default")
     def test_barh(self):

From c311ec5fd4a5397000d7fb3262fe29c9a2f63f97 Mon Sep 17 00:00:00 2001
From: Joshua Stevenson <joshua.stevenson@udri.udayton.edu>
Date: Thu, 30 Nov 2023 10:00:32 -0500
Subject: [PATCH 0464/1120] Fix formatting

---
 lib/matplotlib/widgets.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/widgets.py b/lib/matplotlib/widgets.py
index 717d1be83050..ba91d96a2e83 100644
--- a/lib/matplotlib/widgets.py
+++ b/lib/matplotlib/widgets.py
@@ -2857,9 +2857,9 @@ def _snap(values, snap_values):
     def extents(self):
         """
         (float, float)
-            The values, in data coordinates, for the start and end points of the current selection.
-            If there is no selection then the start and end values will be the same.
-            Writable.
+            The values, in data coordinates, for the start and end points of the current
+            selection. If there is no selection then the start and end values will be
+            the same. Writable.
         """
         if self.direction == 'horizontal':
             vmin = self._selection_artist.get_x()

From 01176429412373d67b67e942dd7eaf457b0e9bc9 Mon Sep 17 00:00:00 2001
From: rawwash <112187975+rawwash@users.noreply.github.com>
Date: Thu, 30 Nov 2023 22:35:35 -0500
Subject: [PATCH 0465/1120] Remove test_spy from test_datetime.py (#27392)

* added test case for spy plot

* adding datetime functionality

* removing plt.show()

* removing spy test
---
 lib/matplotlib/tests/test_datetime.py | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index a3be7e2840a8..83f1aee4f8bb 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -510,12 +510,6 @@ def test_semilogy(self):
         fig, ax = plt.subplots()
         ax.semilogy(...)
 
-    @pytest.mark.xfail(reason="Test for spy not written yet")
-    @mpl.style.context("default")
-    def test_spy(self):
-        fig, ax = plt.subplots()
-        ax.spy(...)
-
     @mpl.style.context("default")
     def test_stackplot(self):
         mpl.rcParams["date.converter"] = 'concise'

From 3c8b337a9bb2e4a5acdd1b210ba38aaf1b67855a Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 30 Nov 2023 23:32:13 -0500
Subject: [PATCH 0466/1120] ci: Block PyQt6 6.6.0 on Ubuntu

This seems to be a broken wheel release from upstream:
https://www.riverbankcomputing.com/pipermail/pyqt/2023-November/045606.html
---
 .github/workflows/tests.yml | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 614f9235a5a4..7f2e3266cb19 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -61,23 +61,30 @@ jobs:
             extra-requirements: '-r requirements/testing/extra.txt'
             CFLAGS: "-fno-lto"  # Ensure that disabling LTO works.
             # https://github.com/matplotlib/matplotlib/pull/26052#issuecomment-1574595954
-            pyqt6-ver: '!=6.5.1'
+            # https://www.riverbankcomputing.com/pipermail/pyqt/2023-November/045606.html
+            pyqt6-ver: '!=6.5.1,!=6.6.0'
             # https://bugreports.qt.io/projects/PYSIDE/issues/PYSIDE-2346
             pyside6-ver: '!=6.5.1'
           - os: ubuntu-20.04
             python-version: '3.10'
             extra-requirements: '-r requirements/testing/extra.txt'
             # https://github.com/matplotlib/matplotlib/pull/26052#issuecomment-1574595954
-            pyqt6-ver: '!=6.5.1'
+            # https://www.riverbankcomputing.com/pipermail/pyqt/2023-November/045606.html
+            pyqt6-ver: '!=6.5.1,!=6.6.0'
             # https://bugreports.qt.io/projects/PYSIDE/issues/PYSIDE-2346
             pyside6-ver: '!=6.5.1'
           - os: ubuntu-22.04
             python-version: '3.11'
+            # https://www.riverbankcomputing.com/pipermail/pyqt/2023-November/045606.html
+            pyqt6-ver: '!=6.6.0'
             # https://bugreports.qt.io/projects/PYSIDE/issues/PYSIDE-2346
             pyside6-ver: '!=6.5.1'
             extra-requirements: '-r requirements/testing/extra.txt'
           - os: ubuntu-22.04
             python-version: '3.12'
+            # https://www.riverbankcomputing.com/pipermail/pyqt/2023-November/045606.html
+            pyqt6-ver: '!=6.6.0'
+            # https://bugreports.qt.io/projects/PYSIDE/issues/PYSIDE-2346
             pyside6-ver: '!=6.5.1'
           - os: macos-latest
             python-version: 3.9

From ab67ee18426aaa48a189e32ff08ae539ca472a9e Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Thu, 30 Nov 2023 12:27:48 +0100
Subject: [PATCH 0467/1120] Check that xerr/yerr values are not None in
 errorbar

---
 lib/matplotlib/axes/_axes.py      |  5 +++++
 lib/matplotlib/tests/test_axes.py | 14 ++++++++++++++
 2 files changed, 19 insertions(+)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 2136ecb2eb94..90faa2ffab18 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -3682,6 +3682,11 @@ def apply_mask(arrays, mask):
                     f"'{dep_axis}err' (shape: {np.shape(err)}) must be a "
                     f"scalar or a 1D or (2, n) array-like whose shape matches "
                     f"'{dep_axis}' (shape: {np.shape(dep)})") from None
+            if err.dtype is np.dtype(object) and np.any(err == None):  # noqa: E711
+                raise ValueError(
+                    f"'{dep_axis}err' must not contain None. "
+                    "Use NaN if you want to skip a value.")
+
             res = np.zeros(err.shape, dtype=bool)  # Default in case of nan
             if np.any(np.less(err, -err, out=res, where=(err == err))):
                 # like err<0, but also works for timedelta and nan.
diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index dffbb2377a23..d5424f80c9e9 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -4127,6 +4127,20 @@ def test_xerr_yerr_not_negative():
                     yerr=datetime.timedelta(days=-10))
 
 
+def test_xerr_yerr_not_none():
+    ax = plt.figure().subplots()
+
+    with pytest.raises(ValueError,
+                       match="'xerr' must not contain None"):
+        ax.errorbar(x=[0], y=[0], xerr=[[None], [1]], yerr=[[None], [1]])
+    with pytest.raises(ValueError,
+                       match="'xerr' must not contain None"):
+        ax.errorbar(x=[0], y=[0], xerr=[[None], [1]])
+    with pytest.raises(ValueError,
+                       match="'yerr' must not contain None"):
+        ax.errorbar(x=[0], y=[0], yerr=[[None], [1]])
+
+
 @check_figures_equal()
 def test_errorbar_every(fig_test, fig_ref):
     x = np.linspace(0, 1, 15)

From 1ccb66176636de3e290b6f07e434056b21eee206 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Fri, 1 Dec 2023 14:02:43 +0100
Subject: [PATCH 0468/1120] Switch pytest fixture from tmpdir to tmp_path

tmp_path is the more modern version providing standard
pathlib.Path objects and preferred nowadays https://docs.pytest.org/en/7
.4.x/reference/reference.html#tmpdir.
---
 lib/matplotlib/tests/test_backend_ps.py   |  4 ++--
 lib/matplotlib/tests/test_figure.py       |  5 ++--
 lib/matplotlib/tests/test_font_manager.py | 10 ++++----
 lib/matplotlib/tests/test_mathtext.py     |  4 ++--
 lib/matplotlib/tests/test_matplotlib.py   | 14 +++++------
 lib/matplotlib/tests/test_pyplot.py       |  4 ++--
 lib/matplotlib/tests/test_rcparams.py     | 29 +++++++++++------------
 lib/matplotlib/tests/test_style.py        |  9 ++++---
 8 files changed, 37 insertions(+), 42 deletions(-)

diff --git a/lib/matplotlib/tests/test_backend_ps.py b/lib/matplotlib/tests/test_backend_ps.py
index cbf33ccc5a1b..c587a00c0af9 100644
--- a/lib/matplotlib/tests/test_backend_ps.py
+++ b/lib/matplotlib/tests/test_backend_ps.py
@@ -124,11 +124,11 @@ def test_patheffects():
 
 @needs_usetex
 @needs_ghostscript
-def test_tilde_in_tempfilename(tmpdir):
+def test_tilde_in_tempfilename(tmp_path):
     # Tilde ~ in the tempdir path (e.g. TMPDIR, TMP or TEMP on windows
     # when the username is very long and windows uses a short name) breaks
     # latex before https://github.com/matplotlib/matplotlib/pull/5928
-    base_tempdir = Path(tmpdir, "short-1")
+    base_tempdir = tmp_path / "short-1"
     base_tempdir.mkdir()
     # Change the path for new tempdirs, which is used internally by the ps
     # backend to write a file.
diff --git a/lib/matplotlib/tests/test_figure.py b/lib/matplotlib/tests/test_figure.py
index 24d4f1c0f059..99b2602bc4a7 100644
--- a/lib/matplotlib/tests/test_figure.py
+++ b/lib/matplotlib/tests/test_figure.py
@@ -1,7 +1,6 @@
 import copy
 from datetime import datetime
 import io
-from pathlib import Path
 import pickle
 import platform
 from threading import Timer
@@ -739,8 +738,8 @@ def test_add_artist(fig_test, fig_ref):
 
 
 @pytest.mark.parametrize("fmt", ["png", "pdf", "ps", "eps", "svg"])
-def test_fspath(fmt, tmpdir):
-    out = Path(tmpdir, f"test.{fmt}")
+def test_fspath(fmt, tmp_path):
+    out = tmp_path / f"test.{fmt}"
     plt.savefig(out)
     with out.open("rb") as file:
         # All the supported formats include the format name (case-insensitive)
diff --git a/lib/matplotlib/tests/test_font_manager.py b/lib/matplotlib/tests/test_font_manager.py
index ec901452ee20..79121a794d12 100644
--- a/lib/matplotlib/tests/test_font_manager.py
+++ b/lib/matplotlib/tests/test_font_manager.py
@@ -46,12 +46,11 @@ def test_score_weight():
             fontManager.score_weight(400, 400))
 
 
-def test_json_serialization(tmpdir):
+def test_json_serialization(tmp_path):
     # Can't open a NamedTemporaryFile twice on Windows, so use a temporary
     # directory instead.
-    path = Path(tmpdir, "fontlist.json")
-    json_dump(fontManager, path)
-    copy = json_load(path)
+    json_dump(fontManager, tmp_path / "fontlist.json")
+    copy = json_load(tmp_path / "fontlist.json")
     with warnings.catch_warnings():
         warnings.filterwarnings('ignore', 'findfont: Font family.*not found')
         for prop in ({'family': 'STIXGeneral'},
@@ -133,8 +132,7 @@ def test_find_noto():
         fig.savefig(BytesIO(), format=fmt)
 
 
-def test_find_invalid(tmpdir):
-    tmp_path = Path(tmpdir)
+def test_find_invalid(tmp_path):
 
     with pytest.raises(FileNotFoundError):
         get_font(tmp_path / 'non-existent-font-name.ttf')
diff --git a/lib/matplotlib/tests/test_mathtext.py b/lib/matplotlib/tests/test_mathtext.py
index 7ebc76dabc1d..e3659245d0e7 100644
--- a/lib/matplotlib/tests/test_mathtext.py
+++ b/lib/matplotlib/tests/test_mathtext.py
@@ -459,8 +459,8 @@ def test_mathtext_fallback(fallback, fontlist):
     mpl.font_manager.fontManager.ttflist.pop()
 
 
-def test_math_to_image(tmpdir):
-    mathtext.math_to_image('$x^2$', str(tmpdir.join('example.png')))
+def test_math_to_image(tmp_path):
+    mathtext.math_to_image('$x^2$', tmp_path / 'example.png')
     mathtext.math_to_image('$x^2$', io.BytesIO())
     mathtext.math_to_image('$x^2$', io.BytesIO(), color='Maroon')
 
diff --git a/lib/matplotlib/tests/test_matplotlib.py b/lib/matplotlib/tests/test_matplotlib.py
index ac1c3455c3d9..9ed8c46615bf 100644
--- a/lib/matplotlib/tests/test_matplotlib.py
+++ b/lib/matplotlib/tests/test_matplotlib.py
@@ -21,26 +21,26 @@ def test_parse_to_version_info(version_str, version_tuple):
                     reason="chmod() doesn't work as is on Windows")
 @pytest.mark.skipif(sys.platform != "win32" and os.geteuid() == 0,
                     reason="chmod() doesn't work as root")
-def test_tmpconfigdir_warning(tmpdir):
+def test_tmpconfigdir_warning(tmp_path):
     """Test that a warning is emitted if a temporary configdir must be used."""
-    mode = os.stat(tmpdir).st_mode
+    mode = os.stat(tmp_path).st_mode
     try:
-        os.chmod(tmpdir, 0)
+        os.chmod(tmp_path, 0)
         proc = subprocess.run(
             [sys.executable, "-c", "import matplotlib"],
-            env={**os.environ, "MPLCONFIGDIR": str(tmpdir)},
+            env={**os.environ, "MPLCONFIGDIR": str(tmp_path)},
             stderr=subprocess.PIPE, text=True, check=True)
         assert "set the MPLCONFIGDIR" in proc.stderr
     finally:
-        os.chmod(tmpdir, mode)
+        os.chmod(tmp_path, mode)
 
 
-def test_importable_with_no_home(tmpdir):
+def test_importable_with_no_home(tmp_path):
     subprocess.run(
         [sys.executable, "-c",
          "import pathlib; pathlib.Path.home = lambda *args: 1/0; "
          "import matplotlib.pyplot"],
-        env={**os.environ, "MPLCONFIGDIR": str(tmpdir)}, check=True)
+        env={**os.environ, "MPLCONFIGDIR": str(tmp_path)}, check=True)
 
 
 def test_use_doc_standard_backends():
diff --git a/lib/matplotlib/tests/test_pyplot.py b/lib/matplotlib/tests/test_pyplot.py
index 68a1de24a561..6ebc24c46e29 100644
--- a/lib/matplotlib/tests/test_pyplot.py
+++ b/lib/matplotlib/tests/test_pyplot.py
@@ -11,14 +11,14 @@
 from matplotlib import pyplot as plt
 
 
-def test_pyplot_up_to_date(tmpdir):
+def test_pyplot_up_to_date(tmp_path):
     pytest.importorskip("black")
 
     gen_script = Path(mpl.__file__).parents[2] / "tools/boilerplate.py"
     if not gen_script.exists():
         pytest.skip("boilerplate.py not found")
     orig_contents = Path(plt.__file__).read_text()
-    plt_file = tmpdir.join('pyplot.py')
+    plt_file = tmp_path / 'pyplot.py'
     plt_file.write_text(orig_contents, 'utf-8')
 
     subprocess_run_for_testing(
diff --git a/lib/matplotlib/tests/test_rcparams.py b/lib/matplotlib/tests/test_rcparams.py
index 65cd823f13a9..e3e10145533d 100644
--- a/lib/matplotlib/tests/test_rcparams.py
+++ b/lib/matplotlib/tests/test_rcparams.py
@@ -1,6 +1,5 @@
 import copy
 import os
-from pathlib import Path
 import subprocess
 import sys
 from unittest import mock
@@ -32,14 +31,14 @@
     _listify_validator)
 
 
-def test_rcparams(tmpdir):
+def test_rcparams(tmp_path):
     mpl.rc('text', usetex=False)
     mpl.rc('lines', linewidth=22)
 
     usetex = mpl.rcParams['text.usetex']
     linewidth = mpl.rcParams['lines.linewidth']
 
-    rcpath = Path(tmpdir) / 'test_rcparams.rc'
+    rcpath = tmp_path / 'test_rcparams.rc'
     rcpath.write_text('lines.linewidth: 33', encoding='utf-8')
 
     # test context given dictionary
@@ -197,8 +196,8 @@ def test_axes_titlecolor_rcparams():
     assert title.get_color() == 'r'
 
 
-def test_Issue_1713(tmpdir):
-    rcpath = Path(tmpdir) / 'test_rcparams.rc'
+def test_Issue_1713(tmp_path):
+    rcpath = tmp_path / 'test_rcparams.rc'
     rcpath.write_text('timezone: UTC', encoding='utf-8')
     with mock.patch('locale.getpreferredencoding', return_value='UTF-32-BE'):
         rc = mpl.rc_params_from_file(rcpath, True, False)
@@ -522,10 +521,10 @@ def test_rcparams_reset_after_fail():
 
 
 @pytest.mark.skipif(sys.platform != "linux", reason="Linux only")
-def test_backend_fallback_headless(tmpdir):
+def test_backend_fallback_headless(tmp_path):
     env = {**os.environ,
            "DISPLAY": "", "WAYLAND_DISPLAY": "",
-           "MPLBACKEND": "", "MPLCONFIGDIR": str(tmpdir)}
+           "MPLBACKEND": "", "MPLCONFIGDIR": str(tmp_path)}
     with pytest.raises(subprocess.CalledProcessError):
         subprocess.run(
             [sys.executable, "-c",
@@ -540,9 +539,9 @@ def test_backend_fallback_headless(tmpdir):
 @pytest.mark.skipif(
     sys.platform == "linux" and not _c_internal_utils.display_is_valid(),
     reason="headless")
-def test_backend_fallback_headful(tmpdir):
+def test_backend_fallback_headful(tmp_path):
     pytest.importorskip("tkinter")
-    env = {**os.environ, "MPLBACKEND": "", "MPLCONFIGDIR": str(tmpdir)}
+    env = {**os.environ, "MPLBACKEND": "", "MPLCONFIGDIR": str(tmp_path)}
     backend = subprocess.check_output(
         [sys.executable, "-c",
          "import matplotlib as mpl; "
@@ -620,12 +619,12 @@ def test_rcparams_legend_loc(value):
     (0.9, .7),
     (-0.9, .7),
 ])
-def test_rcparams_legend_loc_from_file(tmpdir, value):
+def test_rcparams_legend_loc_from_file(tmp_path, value):
     # rcParams['legend.loc'] should be settable from matplotlibrc.
     # if any of these are not allowed, an exception will be raised.
     # test for gh issue #22338
-    rc_path = tmpdir.join("matplotlibrc")
-    rc_path.write(f"legend.loc: {value}")
+    rc_path = tmp_path / "matplotlibrc"
+    rc_path.write_text(f"legend.loc: {value}")
 
     with mpl.rc_context(fname=rc_path):
         assert mpl.rcParams["legend.loc"] == value
@@ -647,8 +646,8 @@ def test_validate_sketch_error(value):
 
 
 @pytest.mark.parametrize("value", ['1, 2, 3', '(1,2,3)'])
-def test_rcparams_path_sketch_from_file(tmpdir, value):
-    rc_path = tmpdir.join("matplotlibrc")
-    rc_path.write(f"path.sketch: {value}")
+def test_rcparams_path_sketch_from_file(tmp_path, value):
+    rc_path = tmp_path / "matplotlibrc"
+    rc_path.write_text(f"path.sketch: {value}")
     with mpl.rc_context(fname=rc_path):
         assert mpl.rcParams["path.sketch"] == (1, 2, 3)
diff --git a/lib/matplotlib/tests/test_style.py b/lib/matplotlib/tests/test_style.py
index 96715ac0492b..be038965e33d 100644
--- a/lib/matplotlib/tests/test_style.py
+++ b/lib/matplotlib/tests/test_style.py
@@ -58,8 +58,8 @@ def test_use():
             assert mpl.rcParams[PARAM] == VALUE
 
 
-def test_use_url(tmpdir):
-    path = Path(tmpdir, 'file')
+def test_use_url(tmp_path):
+    path = tmp_path / 'file'
     path.write_text('axes.facecolor: adeade', encoding='utf-8')
     with temp_style('test', DUMMY_SETTINGS):
         url = ('file:'
@@ -69,10 +69,9 @@ def test_use_url(tmpdir):
             assert mpl.rcParams['axes.facecolor'] == "#adeade"
 
 
-def test_single_path(tmpdir):
+def test_single_path(tmp_path):
     mpl.rcParams[PARAM] = 'gray'
-    temp_file = f'text.{STYLE_EXTENSION}'
-    path = Path(tmpdir, temp_file)
+    path = tmp_path / f'text.{STYLE_EXTENSION}'
     path.write_text(f'{PARAM} : {VALUE}', encoding='utf-8')
     with style.context(path):
         assert mpl.rcParams[PARAM] == VALUE

From ee241ad35fc033560fb18fc414266bd5fdff824f Mon Sep 17 00:00:00 2001
From: Jacob Stevens-Haas
 <37048747+Jacob-Stevens-Haas@users.noreply.github.com>
Date: Fri, 1 Dec 2023 16:31:39 +0000
Subject: [PATCH 0469/1120] ENH: Change logging to warning when creating a
 legend with no labels (#27172)

* ENH: Change logging to warning when creating a legend with no labels

Fixes #27145

Also add test_legend_nolabels_warning()

* TST: Add mock labels to mock data.

* DOC: Note warning in legend() documentation

* DOC: Correct examples to no longer raise UserWarning

With modified explanation where appropriate

* TST: Add test for drawing empty legend()

* TST: Test legend for specific warning when no labels present

Also:
DOC: Correct Axes docstring when no labels in legend.

* TST: Filter no labels warning by message.

Also assert that a legend is at least created
---
 .../custom_legends.py                         |  5 +-
 lib/matplotlib/axes/_axes.py                  |  4 +-
 lib/matplotlib/legend.py                      |  2 +-
 lib/matplotlib/tests/test_legend.py           | 88 +++++++++++--------
 lib/matplotlib/tests/test_pickle.py           |  2 +-
 5 files changed, 59 insertions(+), 42 deletions(-)

diff --git a/galleries/examples/text_labels_and_annotations/custom_legends.py b/galleries/examples/text_labels_and_annotations/custom_legends.py
index f1714a21a481..18ace0513228 100644
--- a/galleries/examples/text_labels_and_annotations/custom_legends.py
+++ b/galleries/examples/text_labels_and_annotations/custom_legends.py
@@ -28,6 +28,7 @@
 # Fixing random state for reproducibility
 np.random.seed(19680801)
 
+# %%
 N = 10
 data = (np.geomspace(1, 10, 100) + np.random.randn(N, 100)).T
 cmap = plt.cm.coolwarm
@@ -35,10 +36,10 @@
 
 fig, ax = plt.subplots()
 lines = ax.plot(data)
-ax.legend()
 
 # %%
-# Note that no legend entries were created.
+# Since the data does not have any labels, creating a legend requires
+# us to define the icons and labels.
 # In this case, we can compose a legend using Matplotlib objects that aren't
 # explicitly tied to the data that was plotted. For example:
 
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 90faa2ffab18..da22d5366479 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -239,8 +239,8 @@ def legend(self, *args, **kwargs):
             selection by using a label starting with an underscore, "_".
             A string starting with an underscore is the default label for all
             artists, so calling `.Axes.legend` without any arguments and
-            without setting the labels manually will result in no legend being
-            drawn.
+            without setting the labels manually will result in a ``UserWarning``
+            and an empty legend being drawn.
 
 
         **2. Explicitly listing the artists and labels in the legend**
diff --git a/lib/matplotlib/legend.py b/lib/matplotlib/legend.py
index 93ec3d32c0b7..ba9ee10ef10c 100644
--- a/lib/matplotlib/legend.py
+++ b/lib/matplotlib/legend.py
@@ -1360,7 +1360,7 @@ def _parse_legend_args(axs, *args, handles=None, labels=None, **kwargs):
     elif len(args) == 0:  # 0 args: automatically detect labels and handles.
         handles, labels = _get_legend_handles_labels(axs, handlers)
         if not handles:
-            log.warning(
+            _api.warn_external(
                 "No artists with labels found to put in legend.  Note that "
                 "artists whose label start with an underscore are ignored "
                 "when legend() is called with no argument.")
diff --git a/lib/matplotlib/tests/test_legend.py b/lib/matplotlib/tests/test_legend.py
index 90b0a3f38999..8532c0d68314 100644
--- a/lib/matplotlib/tests/test_legend.py
+++ b/lib/matplotlib/tests/test_legend.py
@@ -636,6 +636,7 @@ def test_handler_numpoints():
 def test_text_nohandler_warning():
     """Test that Text artists with labels raise a warning"""
     fig, ax = plt.subplots()
+    ax.plot([0], label="mock data")
     ax.text(x=0, y=0, s="text", label="label")
     with pytest.warns(UserWarning) as record:
         ax.legend()
@@ -703,7 +704,7 @@ def test_legend_title_empty():
     # it comes back as an empty string, and that it is not
     # visible:
     fig, ax = plt.subplots()
-    ax.plot(range(10))
+    ax.plot(range(10), label="mock data")
     leg = ax.legend()
     assert leg.get_title().get_text() == ""
     assert not leg.get_title().get_visible()
@@ -736,7 +737,7 @@ def test_window_extent_cached_renderer():
 
 def test_legend_title_fontprop_fontsize():
     # test the title_fontsize kwarg
-    plt.plot(range(10))
+    plt.plot(range(10), label="mock data")
     with pytest.raises(ValueError):
         plt.legend(title='Aardvark', title_fontsize=22,
                    title_fontproperties={'family': 'serif', 'size': 22})
@@ -747,27 +748,27 @@ def test_legend_title_fontprop_fontsize():
 
     fig, axes = plt.subplots(2, 3, figsize=(10, 6))
     axes = axes.flat
-    axes[0].plot(range(10))
+    axes[0].plot(range(10), label="mock data")
     leg0 = axes[0].legend(title='Aardvark', title_fontsize=22)
     assert leg0.get_title().get_fontsize() == 22
-    axes[1].plot(range(10))
+    axes[1].plot(range(10), label="mock data")
     leg1 = axes[1].legend(title='Aardvark',
                           title_fontproperties={'family': 'serif', 'size': 22})
     assert leg1.get_title().get_fontsize() == 22
-    axes[2].plot(range(10))
+    axes[2].plot(range(10), label="mock data")
     mpl.rcParams['legend.title_fontsize'] = None
     leg2 = axes[2].legend(title='Aardvark',
                           title_fontproperties={'family': 'serif'})
     assert leg2.get_title().get_fontsize() == mpl.rcParams['font.size']
-    axes[3].plot(range(10))
+    axes[3].plot(range(10), label="mock data")
     leg3 = axes[3].legend(title='Aardvark')
     assert leg3.get_title().get_fontsize() == mpl.rcParams['font.size']
-    axes[4].plot(range(10))
+    axes[4].plot(range(10), label="mock data")
     mpl.rcParams['legend.title_fontsize'] = 20
     leg4 = axes[4].legend(title='Aardvark',
                           title_fontproperties={'family': 'serif'})
     assert leg4.get_title().get_fontsize() == 20
-    axes[5].plot(range(10))
+    axes[5].plot(range(10), label="mock data")
     leg5 = axes[5].legend(title='Aardvark')
     assert leg5.get_title().get_fontsize() == 20
 
@@ -1071,6 +1072,7 @@ def test_legend_labelcolor_rcparam_markerfacecolor_short():
         assert mpl.colors.same_color(text.get_color(), color)
 
 
+@pytest.mark.filterwarnings("ignore:No artists with labels found to put in legend")
 def test_get_set_draggable():
     legend = plt.legend()
     assert not legend.get_draggable()
@@ -1289,74 +1291,75 @@ def test_loc_invalid_tuple_exception():
     fig, ax = plt.subplots()
     with pytest.raises(ValueError, match=('loc must be string, coordinate '
                        'tuple, or an integer 0-10, not \\(1.1,\\)')):
-        ax.legend(loc=(1.1, ))
+        ax.legend(loc=(1.1, ), labels=["mock data"])
 
     with pytest.raises(ValueError, match=('loc must be string, coordinate '
                        'tuple, or an integer 0-10, not \\(0.481, 0.4227, 0.4523\\)')):
-        ax.legend(loc=(0.481, 0.4227, 0.4523))
+        ax.legend(loc=(0.481, 0.4227, 0.4523), labels=["mock data"])
 
     with pytest.raises(ValueError, match=('loc must be string, coordinate '
                        'tuple, or an integer 0-10, not \\(0.481, \'go blue\'\\)')):
-        ax.legend(loc=(0.481, "go blue"))
+        ax.legend(loc=(0.481, "go blue"), labels=["mock data"])
 
 
 def test_loc_valid_tuple():
     fig, ax = plt.subplots()
-    ax.legend(loc=(0.481, 0.442))
-    ax.legend(loc=(1, 2))
+    ax.legend(loc=(0.481, 0.442), labels=["mock data"])
+    ax.legend(loc=(1, 2), labels=["mock data"])
 
 
 def test_loc_valid_list():
     fig, ax = plt.subplots()
-    ax.legend(loc=[0.481, 0.442])
-    ax.legend(loc=[1, 2])
+    ax.legend(loc=[0.481, 0.442], labels=["mock data"])
+    ax.legend(loc=[1, 2], labels=["mock data"])
 
 
 def test_loc_invalid_list_exception():
     fig, ax = plt.subplots()
     with pytest.raises(ValueError, match=('loc must be string, coordinate '
                        'tuple, or an integer 0-10, not \\[1.1, 2.2, 3.3\\]')):
-        ax.legend(loc=[1.1, 2.2, 3.3])
+        ax.legend(loc=[1.1, 2.2, 3.3], labels=["mock data"])
 
 
 def test_loc_invalid_type():
     fig, ax = plt.subplots()
     with pytest.raises(ValueError, match=("loc must be string, coordinate "
                        "tuple, or an integer 0-10, not {'not': True}")):
-        ax.legend(loc={'not': True})
+        ax.legend(loc={'not': True}, labels=["mock data"])
 
 
 def test_loc_validation_numeric_value():
     fig, ax = plt.subplots()
-    ax.legend(loc=0)
-    ax.legend(loc=1)
-    ax.legend(loc=5)
-    ax.legend(loc=10)
+    ax.legend(loc=0, labels=["mock data"])
+    ax.legend(loc=1, labels=["mock data"])
+    ax.legend(loc=5, labels=["mock data"])
+    ax.legend(loc=10, labels=["mock data"])
     with pytest.raises(ValueError, match=('loc must be string, coordinate '
                        'tuple, or an integer 0-10, not 11')):
-        ax.legend(loc=11)
+        ax.legend(loc=11, labels=["mock data"])
 
     with pytest.raises(ValueError, match=('loc must be string, coordinate '
                        'tuple, or an integer 0-10, not -1')):
-        ax.legend(loc=-1)
+        ax.legend(loc=-1, labels=["mock data"])
 
 
 def test_loc_validation_string_value():
     fig, ax = plt.subplots()
-    ax.legend(loc='best')
-    ax.legend(loc='upper right')
-    ax.legend(loc='best')
-    ax.legend(loc='upper right')
-    ax.legend(loc='upper left')
-    ax.legend(loc='lower left')
-    ax.legend(loc='lower right')
-    ax.legend(loc='right')
-    ax.legend(loc='center left')
-    ax.legend(loc='center right')
-    ax.legend(loc='lower center')
-    ax.legend(loc='upper center')
+    labels = ["mock data"]
+    ax.legend(loc='best', labels=labels)
+    ax.legend(loc='upper right', labels=labels)
+    ax.legend(loc='best', labels=labels)
+    ax.legend(loc='upper right', labels=labels)
+    ax.legend(loc='upper left', labels=labels)
+    ax.legend(loc='lower left', labels=labels)
+    ax.legend(loc='lower right', labels=labels)
+    ax.legend(loc='right', labels=labels)
+    ax.legend(loc='center left', labels=labels)
+    ax.legend(loc='center right', labels=labels)
+    ax.legend(loc='lower center', labels=labels)
+    ax.legend(loc='upper center', labels=labels)
     with pytest.raises(ValueError, match="'wrong' is not a valid value for"):
-        ax.legend(loc='wrong')
+        ax.legend(loc='wrong', labels=labels)
 
 
 def test_legend_handle_label_mismatch():
@@ -1375,3 +1378,16 @@ def test_legend_handle_label_mismatch_no_len():
                         labels=iter(["pl1", "pl2", "pl3"]))
     assert len(legend.legend_handles) == 2
     assert len(legend.get_texts()) == 2
+
+
+def test_legend_nolabels_warning():
+    plt.plot([1, 2, 3])
+    with pytest.raises(UserWarning, match="No artists with labels found"):
+        plt.legend()
+
+
+@pytest.mark.filterwarnings("ignore:No artists with labels found to put in legend")
+def test_legend_nolabels_draw():
+    plt.plot([1, 2, 3])
+    plt.legend()
+    assert plt.gca().get_legend() is not None
diff --git a/lib/matplotlib/tests/test_pickle.py b/lib/matplotlib/tests/test_pickle.py
index e222a495e437..cab412bff561 100644
--- a/lib/matplotlib/tests/test_pickle.py
+++ b/lib/matplotlib/tests/test_pickle.py
@@ -90,7 +90,7 @@ def _generate_complete_test_figure(fig_ref):
     plt.legend(loc='upper left')
 
     plt.subplot(3, 3, 9)
-    plt.errorbar(x, x * -0.5, xerr=0.2, yerr=0.4)
+    plt.errorbar(x, x * -0.5, xerr=0.2, yerr=0.4, label='$-.5 x$')
     plt.legend(draggable=True)
 
     fig_ref.align_ylabels()  # Test handling of _align_label_groups Groupers.

From 6896ffd0154d96797e38d7c58b576ce270308a85 Mon Sep 17 00:00:00 2001
From: Steffen Rehberg <steffen.rehberg@googlemail.com>
Date: Fri, 1 Dec 2023 23:31:03 +0100
Subject: [PATCH 0470/1120] DOC: Add AsinhScale to list of built-in scales

---
 lib/matplotlib/axis.py     | 1 +
 lib/matplotlib/colorbar.py | 1 +
 2 files changed, 2 insertions(+)

diff --git a/lib/matplotlib/axis.py b/lib/matplotlib/axis.py
index e7f6724c4372..f89278323738 100644
--- a/lib/matplotlib/axis.py
+++ b/lib/matplotlib/axis.py
@@ -807,6 +807,7 @@ def _set_axes_scale(self, value, **kwargs):
             - `matplotlib.scale.SymmetricalLogScale`
             - `matplotlib.scale.LogitScale`
             - `matplotlib.scale.FuncScale`
+            - `matplotlib.scale.AsinhScale`
 
         Notes
         -----
diff --git a/lib/matplotlib/colorbar.py b/lib/matplotlib/colorbar.py
index 920c0d67722a..092d4afc54ac 100644
--- a/lib/matplotlib/colorbar.py
+++ b/lib/matplotlib/colorbar.py
@@ -998,6 +998,7 @@ def _set_scale(self, scale, **kwargs):
             - `matplotlib.scale.SymmetricalLogScale`
             - `matplotlib.scale.LogitScale`
             - `matplotlib.scale.FuncScale`
+            - `matplotlib.scale.AsinhScale`
 
         Notes
         -----

From 161d47b5fa1cef273bf93fea6dbb15ca7d8badba Mon Sep 17 00:00:00 2001
From: Matthew Morrison <120498834+mattymo30@users.noreply.github.com>
Date: Fri, 1 Dec 2023 23:55:54 -0500
Subject: [PATCH 0471/1120] Fixing Sentence Case on Section Titles in
 users_explain (#27325)

* Fixing sentence case usage inside user_explain/axes pages

* Fixing sentence case usage inside user_explain/animations pages

* Fixing sentence case usage inside user_explain/artists pages

* Fixing sentence case usage inside user_explain/colors pages

* Fixing sentence case usage inside user_explain/toolkits pages

* Update galleries/users_explain/artists/paths.py

Co-authored-by: hannah <story645@gmail.com>

* Update galleries/users_explain/artists/transforms_tutorial.py

Co-authored-by: hannah <story645@gmail.com>

* Update galleries/users_explain/colors/colormaps.py

Co-authored-by: hannah <story645@gmail.com>

* Update galleries/users_explain/colors/colorbar_only.py

Co-authored-by: hannah <story645@gmail.com>

* Update galleries/users_explain/axes/autoscale.py

Co-authored-by: hannah <story645@gmail.com>

* Update galleries/users_explain/colors/colormap-manipulation.py

Co-authored-by: hannah <story645@gmail.com>

* Update galleries/users_explain/colors/colormaps.py

Co-authored-by: hannah <story645@gmail.com>

---------

Co-authored-by: hannah <story645@gmail.com>
---
 galleries/users_explain/animations/animations.py        | 4 ++--
 galleries/users_explain/artists/patheffects_guide.py    | 4 ++--
 galleries/users_explain/axes/autoscale.py               | 4 ++--
 galleries/users_explain/axes/axes_ticks.py              | 2 +-
 galleries/users_explain/axes/colorbar_placement.py      | 2 +-
 galleries/users_explain/axes/constrainedlayout_guide.py | 2 +-
 galleries/users_explain/axes/legend_guide.py            | 2 +-
 galleries/users_explain/axes/tight_layout_guide.py      | 5 +++--
 galleries/users_explain/colors/colorbar_only.py         | 6 +++---
 galleries/users_explain/colors/colormap-manipulation.py | 6 +++---
 galleries/users_explain/colors/colormapnorms.py         | 2 +-
 galleries/users_explain/colors/colormaps.py             | 6 +++---
 galleries/users_explain/toolkits/axes_grid.rst          | 2 +-
 galleries/users_explain/toolkits/axisartist.rst         | 6 +++---
 14 files changed, 27 insertions(+), 26 deletions(-)

diff --git a/galleries/users_explain/animations/animations.py b/galleries/users_explain/animations/animations.py
index b022350c8985..fb8564f8318e 100644
--- a/galleries/users_explain/animations/animations.py
+++ b/galleries/users_explain/animations/animations.py
@@ -20,7 +20,7 @@
 import matplotlib.animation as animation
 
 # %%
-# Animation Classes
+# Animation classes
 # =================
 #
 # The animation process in Matplotlib can be thought of in 2 different ways:
@@ -158,7 +158,7 @@ def update(frame):
 plt.show()
 
 # %%
-# Animation Writers
+# Animation writers
 # =================
 #
 # Animation objects can be saved to disk using various multimedia writers
diff --git a/galleries/users_explain/artists/patheffects_guide.py b/galleries/users_explain/artists/patheffects_guide.py
index 259261fb09d4..28a6b9dd1d03 100644
--- a/galleries/users_explain/artists/patheffects_guide.py
+++ b/galleries/users_explain/artists/patheffects_guide.py
@@ -64,7 +64,7 @@
 # automatically followed with the "normal" effect, whereas the latter
 # explicitly defines the two path effects to draw.
 #
-# Making an artist stand out
+# Making an Artist stand out
 # --------------------------
 #
 # One nice way of making artists visually stand out is to draw an outline in
@@ -93,7 +93,7 @@
 # its user interface.
 #
 #
-# Greater control of the path effect artist
+# Greater control of the path effect Artist
 # -----------------------------------------
 #
 # As already mentioned, some of the path effects operate at a lower level
diff --git a/galleries/users_explain/axes/autoscale.py b/galleries/users_explain/axes/autoscale.py
index a9d6b728866c..53435f4086c9 100644
--- a/galleries/users_explain/axes/autoscale.py
+++ b/galleries/users_explain/axes/autoscale.py
@@ -3,8 +3,8 @@
 
 .. _autoscale:
 
-Autoscaling
-===========
+Autoscaling Axis
+================
 
 The limits on an axis can be set manually (e.g. ``ax.set_xlim(xmin, xmax)``)
 or Matplotlib can set them automatically based on the data already on the axes.
diff --git a/galleries/users_explain/axes/axes_ticks.py b/galleries/users_explain/axes/axes_ticks.py
index aaec87c6a239..3870c26af70e 100644
--- a/galleries/users_explain/axes/axes_ticks.py
+++ b/galleries/users_explain/axes/axes_ticks.py
@@ -2,7 +2,7 @@
 .. _user_axes_ticks:
 
 ==========
-Axis Ticks
+Axis ticks
 ==========
 
 The x and y Axis on each Axes have default tick "locators" and "formatters"
diff --git a/galleries/users_explain/axes/colorbar_placement.py b/galleries/users_explain/axes/colorbar_placement.py
index 1e43d4940a98..8dbc2a356cb1 100644
--- a/galleries/users_explain/axes/colorbar_placement.py
+++ b/galleries/users_explain/axes/colorbar_placement.py
@@ -4,7 +4,7 @@
 .. redirect-from:: /gallery/subplots_axes_and_figures/colorbar_placement
 
 =================
-Placing Colorbars
+Placing colorbars
 =================
 
 Colorbars indicate the quantitative extent of image data.  Placing in
diff --git a/galleries/users_explain/axes/constrainedlayout_guide.py b/galleries/users_explain/axes/constrainedlayout_guide.py
index 4581f5f67808..d96b829df372 100644
--- a/galleries/users_explain/axes/constrainedlayout_guide.py
+++ b/galleries/users_explain/axes/constrainedlayout_guide.py
@@ -5,7 +5,7 @@
 .. _constrainedlayout_guide:
 
 ========================
-Constrained Layout Guide
+Constrained layout guide
 ========================
 
 Use *constrained layout* to fit plots within your figure cleanly.
diff --git a/galleries/users_explain/axes/legend_guide.py b/galleries/users_explain/axes/legend_guide.py
index 3b138fe8ada3..1482cdbc4a81 100644
--- a/galleries/users_explain/axes/legend_guide.py
+++ b/galleries/users_explain/axes/legend_guide.py
@@ -213,7 +213,7 @@
 plt.show()
 
 # %%
-# Legend Handlers
+# Legend handlers
 # ===============
 #
 # In order to create legend entries, handles are given as an argument to an
diff --git a/galleries/users_explain/axes/tight_layout_guide.py b/galleries/users_explain/axes/tight_layout_guide.py
index 8525b9773f91..9074641d39ab 100644
--- a/galleries/users_explain/axes/tight_layout_guide.py
+++ b/galleries/users_explain/axes/tight_layout_guide.py
@@ -4,7 +4,7 @@
 .. _tight_layout_guide:
 
 ==================
-Tight Layout guide
+Tight layout guide
 ==================
 
 How to use tight-layout to fit plots within your figure cleanly.
@@ -17,6 +17,7 @@
 An alternative to *tight_layout* is :ref:`constrained_layout
 <constrainedlayout_guide>`.
 
+
 Simple example
 ==============
 
@@ -209,7 +210,7 @@ def example_plot(ax, fontsize=12):
 
 
 # %%
-# Legends and Annotations
+# Legends and annotations
 # =======================
 #
 # Pre Matplotlib 2.2, legends and annotations were excluded from the bounding
diff --git a/galleries/users_explain/colors/colorbar_only.py b/galleries/users_explain/colors/colorbar_only.py
index a47ced0a4ea6..4140ea454b99 100644
--- a/galleries/users_explain/colors/colorbar_only.py
+++ b/galleries/users_explain/colors/colorbar_only.py
@@ -1,9 +1,9 @@
 """
 .. redirect-from:: /tutorials/colors/colorbar_only
 
-====================
-Standalone colorbars
-====================
+=============================
+Customized Colorbars Tutorial
+=============================
 
 This tutorial shows how to build and customize standalone colorbars, i.e.
 without an attached plot.
diff --git a/galleries/users_explain/colors/colormap-manipulation.py b/galleries/users_explain/colors/colormap-manipulation.py
index 87269b87befa..0cd488857257 100644
--- a/galleries/users_explain/colors/colormap-manipulation.py
+++ b/galleries/users_explain/colors/colormap-manipulation.py
@@ -3,9 +3,9 @@
 
 .. _colormap-manipulation:
 
-******************
-Creating Colormaps
-******************
+********************************
+Creating Colormaps in Matplotlib
+********************************
 
 Matplotlib has a number of built-in colormaps accessible via
 `.matplotlib.colormaps`.  There are also external libraries like
diff --git a/galleries/users_explain/colors/colormapnorms.py b/galleries/users_explain/colors/colormapnorms.py
index f375b3af805b..3aa0ab729371 100644
--- a/galleries/users_explain/colors/colormapnorms.py
+++ b/galleries/users_explain/colors/colormapnorms.py
@@ -4,7 +4,7 @@
 
 .. _colormapnorms:
 
-Colormap Normalization
+Colormap normalization
 ======================
 
 Objects that use colormaps by default linearly map the colors in the
diff --git a/galleries/users_explain/colors/colormaps.py b/galleries/users_explain/colors/colormaps.py
index b5db551cb5b5..92b56d298976 100644
--- a/galleries/users_explain/colors/colormaps.py
+++ b/galleries/users_explain/colors/colormaps.py
@@ -3,9 +3,9 @@
 
 .. _colormaps:
 
-******************
-Choosing Colormaps
-******************
+********************************
+Choosing Colormaps in Matplotlib
+********************************
 
 Matplotlib has a number of built-in colormaps accessible via
 `.matplotlib.colormaps`.  There are also external libraries that
diff --git a/galleries/users_explain/toolkits/axes_grid.rst b/galleries/users_explain/toolkits/axes_grid.rst
index 6f7be49ed4c1..694fd1178c04 100644
--- a/galleries/users_explain/toolkits/axes_grid.rst
+++ b/galleries/users_explain/toolkits/axes_grid.rst
@@ -60,7 +60,7 @@ The examples below show what you can do with ImageGrid.
    :target: /gallery/axes_grid1/demo_axes_grid.html
    :align: center
 
-AxesDivider Class
+AxesDivider class
 -----------------
 
 Behind the scenes, ImageGrid (and RGBAxes, described below) rely on
diff --git a/galleries/users_explain/toolkits/axisartist.rst b/galleries/users_explain/toolkits/axisartist.rst
index 4927f9a3c940..eff2b575a63f 100644
--- a/galleries/users_explain/toolkits/axisartist.rst
+++ b/galleries/users_explain/toolkits/axisartist.rst
@@ -99,7 +99,7 @@ Here is an example that uses ParasiteAxes.
    :target: /gallery/axisartist/demo_parasite_axes2.html
    :align: center
 
-Curvilinear Grid
+Curvilinear grid
 ----------------
 
 The motivation behind the AxisArtist module is to support a curvilinear grid
@@ -298,7 +298,7 @@ HowTo
    To change the pad between ticklabels and axis label,
    axis.label.set_pad method.
 
-Rotation and Alignment of TickLabels
+Rotation and alignment of TickLabels
 ====================================
 
 This is also quite different from standard Matplotlib and can be
@@ -566,7 +566,7 @@ way is to add it as an item of Axes's axis attribute.::
 
 See the first example of this page.
 
-Current Limitations and TODO's
+Current limitations and TODO's
 ==============================
 
 The code need more refinement. Here is a incomplete list of issues and TODO's

From 73b2152954ee3ef3db59e38a5ed25221cc853ac1 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Sat, 2 Dec 2023 04:30:59 -0500
Subject: [PATCH 0472/1120] TST: Cache available interactive backends

There are currently 7 backends, and this function is called 8 times
during test collection. This means that `XOpenDisplay` would be called
56 times (multiplied by process count if using xdist).

Locally, I'm seeing a deadlock after too many calls to `XOpenDisplay`
during collection. While this is not directly our bug, it seems prudent
to cut this down to only the one check per collection process.

I don't think we can cache this globally, as one might want to re-try a
GUI figure after starting an X server (e.g., over SSH or similar),
without restarting Python/Matplotlib.
---
 .../tests/test_backends_interactive.py        | 26 +++++++++++--------
 1 file changed, 15 insertions(+), 11 deletions(-)

diff --git a/lib/matplotlib/tests/test_backends_interactive.py b/lib/matplotlib/tests/test_backends_interactive.py
index 6048b2647b17..3a714319ab81 100644
--- a/lib/matplotlib/tests/test_backends_interactive.py
+++ b/lib/matplotlib/tests/test_backends_interactive.py
@@ -1,3 +1,4 @@
+import functools
 import importlib
 import importlib.util
 import inspect
@@ -52,7 +53,10 @@ def wait_for(self, terminator):
 # PyPI-installable on CI.  They are not available for all tested Python
 # versions so we don't fail on missing backends.
 
-def _get_testable_interactive_backends():
+@functools.lru_cache
+def _get_available_interactive_backends():
+    _is_linux_and_display_invalid = (sys.platform == "linux" and
+                                     not _c_internal_utils.display_is_valid())
     envs = []
     for deps, env in [
             *[([qt_api],
@@ -70,8 +74,7 @@ def _get_testable_interactive_backends():
     ]:
         reason = None
         missing = [dep for dep in deps if not importlib.util.find_spec(dep)]
-        if (sys.platform == "linux" and
-                not _c_internal_utils.display_is_valid()):
+        if _is_linux_and_display_invalid:
             reason = "$DISPLAY and $WAYLAND_DISPLAY are unset"
         elif missing:
             reason = "{} cannot be imported".format(", ".join(missing))
@@ -85,8 +88,7 @@ def _get_testable_interactive_backends():
                 reason = "no usable GTK bindings"
         marks = []
         if reason:
-            marks.append(pytest.mark.skip(
-                reason=f"Skipping {env} because {reason}"))
+            marks.append(pytest.mark.skip(reason=f"Skipping {env} because {reason}"))
         elif env["MPLBACKEND"].startswith('wx') and sys.platform == 'darwin':
             # ignore on OSX because that's currently broken (github #16849)
             marks.append(pytest.mark.xfail(reason='github #16849'))
@@ -97,15 +99,17 @@ def _get_testable_interactive_backends():
               ):
             marks.append(  # https://github.com/actions/setup-python/issues/649
                 pytest.mark.xfail(reason='Tk version mismatch on Azure macOS CI'))
-        envs.append(
-            pytest.param(
-                {**env, 'BACKEND_DEPS': ','.join(deps)},
-                marks=marks, id=str(env)
-            )
-        )
+        envs.append(({**env, 'BACKEND_DEPS': ','.join(deps)}, marks))
     return envs
 
 
+def _get_testable_interactive_backends():
+    # We re-create this because some of the callers below might modify the markers.
+    return [pytest.param({**env}, marks=[*marks],
+                         id='-'.join(f'{k}={v}' for k, v in env.items()))
+            for env, marks in _get_available_interactive_backends()]
+
+
 def is_ci_environment():
     # Common CI variables
     ci_environment_variables = [

From 17d8bf0e7adb2c17f882dd87e40ed80e25caff76 Mon Sep 17 00:00:00 2001
From: Nidaa Rabah <136858218+nidaa-7@users.noreply.github.com>
Date: Sat, 2 Dec 2023 05:06:55 -0500
Subject: [PATCH 0473/1120] Add test_fill in test_datetime.py (#27401)

* added a test for fill in test_datetime.py

* Removed saving the picture from test code.

* reverted .gitignore changes

I had added my virtual environment to gitignore and pushed it. Reverted back before pull request

* added seed
---
 lib/matplotlib/tests/test_datetime.py | 27 ++++++++++++++++++++++++---
 1 file changed, 24 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 83f1aee4f8bb..ca8e1cb90732 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -284,11 +284,32 @@ def test_eventplot(self):
         fig, ax = plt.subplots()
         ax.eventplot(...)
 
-    @pytest.mark.xfail(reason="Test for fill not written yet")
     @mpl.style.context("default")
     def test_fill(self):
-        fig, ax = plt.subplots()
-        ax.fill(...)
+        mpl.rcParams["date.converter"] = "concise"
+        fig, (ax1, ax2, ax3, ax4) = plt.subplots(4, 1, layout="constrained")
+
+        np.random.seed(19680801)
+
+        x_base_date = datetime.datetime(2023, 1, 1)
+        x_dates = [x_base_date]
+        for _ in range(1, 5):
+            x_base_date += datetime.timedelta(days=np.random.randint(1, 5))
+            x_dates.append(x_base_date)
+
+        y_base_date = datetime.datetime(2023, 1, 1)
+        y_dates = [y_base_date]
+        for _ in range(1, 5):
+            y_base_date += datetime.timedelta(days=np.random.randint(1, 5))
+            y_dates.append(y_base_date)
+
+        x_values = np.random.rand(5) * 5
+        y_values = np.random.rand(5) * 5 - 2
+
+        ax1.fill(x_dates, y_values)
+        ax2.fill(x_values, y_dates)
+        ax3.fill(x_values, y_values)
+        ax4.fill(x_dates, y_dates)
 
     @pytest.mark.xfail(reason="Test for fill_between not written yet")
     @mpl.style.context("default")

From 50e70a41763eb598f312f49ddf085984443d8ec2 Mon Sep 17 00:00:00 2001
From: Eric Prestat <eric.prestat@gmail.com>
Date: Sat, 2 Dec 2023 11:14:08 +0100
Subject: [PATCH 0474/1120] Fix setting `_selection_completed` in
 `SpanSelector` when spanselector is initialised using `extents`

---
 lib/matplotlib/tests/test_widgets.py | 17 +++++++++++++++++
 lib/matplotlib/widgets.py            |  8 ++++++--
 2 files changed, 23 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/tests/test_widgets.py b/lib/matplotlib/tests/test_widgets.py
index de17bb79bd4b..16770321dee9 100644
--- a/lib/matplotlib/tests/test_widgets.py
+++ b/lib/matplotlib/tests/test_widgets.py
@@ -974,6 +974,23 @@ def onselect(vmin, vmax):
     assert tool.extents == (17, 35)
 
 
+def test_span_selector_extents(ax):
+    tool = widgets.SpanSelector(
+        ax, lambda a, b: None, "horizontal", ignore_event_outside=True
+        )
+    tool.extents = (5, 10)
+
+    assert tool.extents == (5, 10)
+    assert tool._selection_completed
+
+    # Since `ignore_event_outside=True`, this event should be ignored
+    press_data = (12, 14)
+    release_data = (20, 14)
+    click_and_drag(tool, start=press_data, end=release_data)
+
+    assert tool.extents == (5, 10)
+
+
 @pytest.mark.parametrize('kwargs', [
     dict(),
     dict(useblit=False, props=dict(color='red')),
diff --git a/lib/matplotlib/widgets.py b/lib/matplotlib/widgets.py
index cd9716408303..6d1b2a2914a9 100644
--- a/lib/matplotlib/widgets.py
+++ b/lib/matplotlib/widgets.py
@@ -2684,7 +2684,7 @@ def _press(self, event):
             # visibility to False and extents to (v, v)
             # update will be called when setting the extents
             self._visible = False
-            self.extents = v, v
+            self._set_extents((v, v))
             # We need to set the visibility back, so the span selector will be
             # drawn when necessary (span width > 0)
             self._visible = True
@@ -2797,7 +2797,7 @@ def _onmove(self, event):
             if vmin > vmax:
                 vmin, vmax = vmax, vmin
 
-        self.extents = vmin, vmax
+        self._set_extents((vmin, vmax))
 
         if self.onmove_callback is not None:
             self.onmove_callback(vmin, vmax)
@@ -2866,6 +2866,10 @@ def extents(self):
 
     @extents.setter
     def extents(self, extents):
+        self._set_extents(extents)
+        self._selection_completed = True
+
+    def _set_extents(self, extents):
         # Update displayed shape
         if self.snap_values is not None:
             extents = tuple(self._snap(extents, self.snap_values))

From d8e272fdff559c74199d2fd643560471b37ba9af Mon Sep 17 00:00:00 2001
From: Jody Klymak <jklymak@gmail.com>
Date: Sat, 2 Dec 2023 14:36:16 -0800
Subject: [PATCH 0475/1120] DOC: multilevel tick example (#27411)

* DOC: multilevel tick example

* Update galleries/examples/ticks/multilevel_ticks.py

fix typo

Co-authored-by: Ruth Comer <10599679+rcomer@users.noreply.github.com>

---------

Co-authored-by: Ruth Comer <10599679+rcomer@users.noreply.github.com>
---
 galleries/examples/ticks/multilevel_ticks.py | 99 ++++++++++++++++++++
 1 file changed, 99 insertions(+)
 create mode 100644 galleries/examples/ticks/multilevel_ticks.py

diff --git a/galleries/examples/ticks/multilevel_ticks.py b/galleries/examples/ticks/multilevel_ticks.py
new file mode 100644
index 000000000000..5b8d0ada5ae2
--- /dev/null
+++ b/galleries/examples/ticks/multilevel_ticks.py
@@ -0,0 +1,99 @@
+"""
+=========================
+Multilevel (nested) ticks
+=========================
+
+Sometimes we want another level of tick labels on an axis, perhaps to indicate
+a grouping of the ticks.
+
+Matplotlib does not provide an automated way to do this, but it is relatively
+straightforward to annotate below the main axis.
+
+These examples use `.Axes.secondary_xaxis`, which is one approach. It has the
+advantage that we can use Matplotlib Locators and Formatters on the axis that
+does the grouping if we want.
+
+This first example creates a secondary xaxis and manually adds the ticks and
+labels using `.Axes.set_xticks`.  Note that the tick labels have a newline
+(e.g. ``"\nOughts"``) at the beginning of them to put the second-level tick
+labels below the main tick labels.
+"""
+
+import matplotlib.pyplot as plt
+import numpy as np
+
+import matplotlib.dates as mdates
+
+rng = np.random.default_rng(19680801)
+
+fig, ax = plt.subplots(layout='constrained', figsize=(4, 4))
+
+ax.plot(np.arange(30))
+
+sec = ax.secondary_xaxis(location=0)
+sec.set_xticks([5, 15, 25], labels=['\nOughts', '\nTeens', '\nTwenties'])
+
+# %%
+# This second example adds a second level of annotation to a categorical axis.
+# Here we need to note that each animal (category) is assigned an integer, so
+# ``cats`` is at x=0, ``dogs`` at x=1 etc.  Then we place the ticks on the
+# second level on an x that is at the middle of the animal class we are trying
+# to delineate.
+#
+# This example also adds tick marks between the classes by adding a second
+# secondary xaxis, and placing long, wide ticks at the boundaries between the
+# animal classes.
+
+fig, ax = plt.subplots(layout='constrained', figsize=(7, 4))
+
+ax.plot(['cats', 'dogs', 'pigs', 'snakes', 'lizards', 'chickens',
+         'eagles', 'herons', 'buzzards'],
+        rng.normal(size=9), 'o')
+
+# label the classes:
+sec = ax.secondary_xaxis(location=0)
+sec.set_xticks([1, 3.5, 6.5], labels=['\n\nMammals', '\n\nReptiles', '\n\nBirds'])
+sec.tick_params('x', length=0)
+
+# lines between the classes:
+sec2 = ax.secondary_xaxis(location=0)
+sec2.set_xticks([-0.5, 2.5, 4.5, 8.5], labels=[])
+sec2.tick_params('x', length=40, width=1.5)
+ax.set_xlim(-0.6, 8.6)
+
+# %%
+# Dates are another common place where we may want to have a second level of
+# tick labels.  In this last example, we take advantage of the ability to add
+# an automatic locator and formatter to the secondary xaxis, which means we do
+# not need to set the ticks manually.
+#
+# This example also differs from the above, in that we placed it at a location
+# below the main axes ``location=-0.075`` and then we hide the spine by setting
+# the line width to zero.  That means that our formatter no longer needs the
+# carriage returns of the previous two examples.
+
+fig, ax = plt.subplots(layout='constrained', figsize=(7, 4))
+
+time = np.arange(np.datetime64('2020-01-01'), np.datetime64('2020-03-31'),
+                 np.timedelta64(1, 'D'))
+
+ax.plot(time, rng.random(size=len(time)))
+
+# just format the days:
+ax.xaxis.set_major_formatter(mdates.DateFormatter('%d'))
+
+# label the months:
+sec = ax.secondary_xaxis(location=-0.075)
+sec.xaxis.set_major_locator(mdates.MonthLocator(bymonthday=1))
+
+# note the extra spaces in the label to align the month label inside the month.
+# Note that this could have been done by changing ``bymonthday`` above as well:
+sec.xaxis.set_major_formatter(mdates.DateFormatter('  %b'))
+sec.tick_params('x', length=0)
+sec.spines['bottom'].set_linewidth(0)
+
+# label the xaxis, but note for this to look good, it needs to be on the
+# secondary xaxis.
+sec.set_xlabel('Dates (2020)')
+
+plt.show()

From 9a88b368a39ab97cc53ac406ce5de6273f87a6b6 Mon Sep 17 00:00:00 2001
From: "ddale1128@gmail.com" <ddale1128@gmail.com>
Date: Sun, 3 Dec 2023 18:11:51 -0800
Subject: [PATCH 0476/1120] Expand stairs plot-type entry intro

---
 galleries/plot_types/basic/stairs.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/galleries/plot_types/basic/stairs.py b/galleries/plot_types/basic/stairs.py
index 9bc5d025f1e1..3bf90ce37e9f 100644
--- a/galleries/plot_types/basic/stairs.py
+++ b/galleries/plot_types/basic/stairs.py
@@ -3,7 +3,8 @@
 stairs(values)
 ==============
 
-See `~matplotlib.axes.Axes.stairs`.
+See `~matplotlib.axes.Axes.stairs` when plotting $y$ between $(x_i, x_{i+1})$.
+For plotting $y$ at $x$, see `~matplotlib.axes.Axes.step`.
 
 .. redirect-from:: /plot_types/basic/step
 """

From 7b8814be56db6793b213ab9a90a21856ed761060 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Tue, 5 Dec 2023 00:18:05 -0500
Subject: [PATCH 0477/1120] Fix warning passing NumPy array to hexbin(bins=...)

---
 lib/matplotlib/axes/_axes.py      | 4 ++--
 lib/matplotlib/tests/test_axes.py | 5 +++--
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index da22d5366479..6a9353f45146 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -5103,10 +5103,10 @@ def reduce_C_function(C: array) -> float
             )
 
         # Set normalizer if bins is 'log'
-        if bins == 'log':
+        if cbook._str_equal(bins, 'log'):
             if norm is not None:
                 _api.warn_external("Only one of 'bins' and 'norm' arguments "
-                                   f"can be supplied, ignoring bins={bins}")
+                                   f"can be supplied, ignoring {bins=}")
             else:
                 norm = mcolors.LogNorm(vmin=vmin, vmax=vmax)
                 vmin = vmax = None
diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index d5424f80c9e9..836485b434e5 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -962,17 +962,18 @@ def test_hexbin_extent():
     ax.hexbin("x", "y", extent=[.1, .3, .6, .7], data=data)
 
 
-@image_comparison(['hexbin_empty.png', 'hexbin_empty.png'], remove_text=True)
+@image_comparison(['hexbin_empty.png'], remove_text=True)
 def test_hexbin_empty():
     # From #3886: creating hexbin from empty dataset raises ValueError
     fig, ax = plt.subplots()
     ax.hexbin([], [])
-    fig, ax = plt.subplots()
     # From #23922: creating hexbin with log scaling from empty
     # dataset raises ValueError
     ax.hexbin([], [], bins='log')
     # From #27103: np.max errors when handed empty data
     ax.hexbin([], [], C=[], reduce_C_function=np.max)
+    # No string-comparison warning from NumPy.
+    ax.hexbin([], [], bins=np.arange(10))
 
 
 def test_hexbin_pickable():

From 14dc7a8e63e432e2d53f4a0e34a2d6239934ec9d Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Tue, 5 Dec 2023 00:19:52 -0500
Subject: [PATCH 0478/1120] DOC: Fix colorbar label for log-scaled hexbin

Fixes #27383
---
 galleries/examples/statistics/hexbin_demo.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/galleries/examples/statistics/hexbin_demo.py b/galleries/examples/statistics/hexbin_demo.py
index 4bd0e0401424..b9a6206a934f 100644
--- a/galleries/examples/statistics/hexbin_demo.py
+++ b/galleries/examples/statistics/hexbin_demo.py
@@ -29,7 +29,7 @@
 hb = ax1.hexbin(x, y, gridsize=50, bins='log', cmap='inferno')
 ax1.set(xlim=xlim, ylim=ylim)
 ax1.set_title("With a log color scale")
-cb = fig.colorbar(hb, ax=ax1, label='log10(N)')
+cb = fig.colorbar(hb, ax=ax1, label='counts')
 
 plt.show()
 

From 79ef13c2de771f97f6710efc9960a86ff0703c5e Mon Sep 17 00:00:00 2001
From: "ddale1128@gmail.com" <ddale1128@gmail.com>
Date: Mon, 4 Dec 2023 21:46:26 -0800
Subject: [PATCH 0479/1120] Rewrite with math directive

---
 galleries/plot_types/basic/stairs.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/galleries/plot_types/basic/stairs.py b/galleries/plot_types/basic/stairs.py
index 3bf90ce37e9f..d917d3d4e626 100644
--- a/galleries/plot_types/basic/stairs.py
+++ b/galleries/plot_types/basic/stairs.py
@@ -3,8 +3,8 @@
 stairs(values)
 ==============
 
-See `~matplotlib.axes.Axes.stairs` when plotting $y$ between $(x_i, x_{i+1})$.
-For plotting $y$ at $x$, see `~matplotlib.axes.Axes.step`.
+See `~matplotlib.axes.Axes.stairs` when plotting :math:`y$` between :math:`(x_i, x_{i+1})`.
+For plotting :math:`y` at :math:`x`, see `~matplotlib.axes.Axes.step`.
 
 .. redirect-from:: /plot_types/basic/step
 """

From f3585ef56a4da75658c2f6feadf1ec16f077b951 Mon Sep 17 00:00:00 2001
From: linyilily <71032637+linyilily@users.noreply.github.com>
Date: Tue, 5 Dec 2023 07:00:01 -0500
Subject: [PATCH 0480/1120] Add test for fill_between in test_datetime.py
 (#27423)

* add test for fill_between in test_datetime.py

* fix error in checks

* make y values always increasing

* second plot removed as requested

* oops forgot to remove savefig

---------

Co-authored-by: Linyi Li <linyi.li@mail.utoronto.ca>
---
 lib/matplotlib/tests/test_datetime.py | 35 ++++++++++++++++++++++++---
 1 file changed, 32 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index ca8e1cb90732..ca9c09e45fe7 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -311,11 +311,40 @@ def test_fill(self):
         ax3.fill(x_values, y_values)
         ax4.fill(x_dates, y_dates)
 
-    @pytest.mark.xfail(reason="Test for fill_between not written yet")
     @mpl.style.context("default")
     def test_fill_between(self):
-        fig, ax = plt.subplots()
-        ax.fill_between(...)
+        mpl.rcParams["date.converter"] = "concise"
+        np.random.seed(19680801)
+
+        y_base_date = datetime.datetime(2023, 1, 1)
+        y_dates1 = [y_base_date]
+        for i in range(1, 10):
+            y_base_date += datetime.timedelta(days=np.random.randint(1, 5))
+            y_dates1.append(y_base_date)
+
+        y_dates2 = [y_base_date]
+        for i in range(1, 10):
+            y_base_date += datetime.timedelta(days=np.random.randint(1, 5))
+            y_dates2.append(y_base_date)
+        x_values = np.random.rand(10) * 10
+        x_values.sort()
+
+        y_values1 = np.random.rand(10) * 10
+        y_values2 = y_values1 + np.random.rand(10) * 10
+        y_values1.sort()
+        y_values2.sort()
+
+        x_base_date = datetime.datetime(2023, 1, 1)
+        x_dates = [x_base_date]
+        for i in range(1, 10):
+            x_base_date += datetime.timedelta(days=np.random.randint(1, 10))
+            x_dates.append(x_base_date)
+
+        fig, (ax1, ax2, ax3) = plt.subplots(3, 1, layout="constrained")
+
+        ax1.fill_between(x_values, y_dates1, y_dates2)
+        ax2.fill_between(x_dates, y_values1, y_values2)
+        ax3.fill_between(x_dates, y_dates1, y_dates2)
 
     @pytest.mark.xfail(reason="Test for fill_betweenx not written yet")
     @mpl.style.context("default")

From cad6d112f59663a03c51a2b9db2ca21ea91d0ae3 Mon Sep 17 00:00:00 2001
From: avramid9 <97982258+avramid9@users.noreply.github.com>
Date: Sun, 3 Dec 2023 16:55:59 +0000
Subject: [PATCH 0481/1120] Added test for broken_barh to test_datetime.py

---
 lib/matplotlib/tests/test_datetime.py | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index ca8e1cb90732..1af08ebee724 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -195,11 +195,18 @@ def test_boxplot(self):
         fig, ax = plt.subplots()
         ax.boxplot(...)
 
-    @pytest.mark.xfail(reason="Test for broken_barh not written yet")
     @mpl.style.context("default")
     def test_broken_barh(self):
+        # Horizontal bar plot with gaps
+        mpl.rcParams["date.converter"] = 'concise'
         fig, ax = plt.subplots()
-        ax.broken_barh(...)
+
+        ax.broken_barh([(datetime.datetime(2023, 1, 4), datetime.timedelta(days=2)),
+                        (datetime.datetime(2023, 1, 8), datetime.timedelta(days=3))],
+                        (10, 9), facecolors='tab:blue')
+        ax.broken_barh([(datetime.datetime(2023, 1, 2), datetime.timedelta(days=1)),
+                         (datetime.datetime(2023, 1, 4), datetime.timedelta(days=4))],
+                         (20, 9), facecolors=('tab:red'))
 
     @pytest.mark.xfail(reason="Test for bxp not written yet")
     @mpl.style.context("default")

From 72a18ccab6af9a7e833ed5afe9cbc5b1bb8958fc Mon Sep 17 00:00:00 2001
From: Joshua Stevenson <joshua.stevenson@udri.udayton.edu>
Date: Tue, 5 Dec 2023 14:38:51 -0500
Subject: [PATCH 0482/1120] remove "Writable." note

---
 lib/matplotlib/widgets.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/widgets.py b/lib/matplotlib/widgets.py
index ba91d96a2e83..0c00667ac936 100644
--- a/lib/matplotlib/widgets.py
+++ b/lib/matplotlib/widgets.py
@@ -2695,7 +2695,7 @@ def _press(self, event):
 
     @property
     def direction(self):
-        """Direction of the span selector: 'vertical' or 'horizontal'. Writable."""
+        """Direction of the span selector: 'vertical' or 'horizontal'."""
         return self._direction
 
     @direction.setter
@@ -2859,7 +2859,7 @@ def extents(self):
         (float, float)
             The values, in data coordinates, for the start and end points of the current
             selection. If there is no selection then the start and end values will be
-            the same. Writable.
+            the same.
         """
         if self.direction == 'horizontal':
             vmin = self._selection_artist.get_x()

From 273a2680de5bbea83b3935cd0697d01d2e7bc06c Mon Sep 17 00:00:00 2001
From: 0taj <89607583+0taj@users.noreply.github.com>
Date: Tue, 5 Dec 2023 15:27:07 -0500
Subject: [PATCH 0483/1120] Added smoke test for Axes.stem (#27135)

* Added smoke test for Axes.stem

* Updates to include bottom and orientation

* Move code to stem function

* Remove whitespace

* Changed dates

* Formatting Fixes
---
 lib/matplotlib/tests/test_datetime.py | 28 ++++++++++++++++++++++++---
 1 file changed, 25 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 7ca6f121a8ae..4e0128843c2a 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -591,11 +591,33 @@ def test_stairs(self):
         fig, ax = plt.subplots()
         ax.stairs(...)
 
-    @pytest.mark.xfail(reason="Test for stem not written yet")
     @mpl.style.context("default")
     def test_stem(self):
-        fig, ax = plt.subplots()
-        ax.stem(...)
+        mpl.rcParams["date.converter"] = "concise"
+
+        fig, (ax1, ax2, ax3, ax4, ax5, ax6) = plt.subplots(6, 1, layout="constrained")
+
+        limit_value = 10
+        above = datetime.datetime(2023, 9, 18)
+        below = datetime.datetime(2023, 11, 18)
+
+        x_ranges = np.arange(1, limit_value)
+        y_ranges = np.arange(1, limit_value)
+
+        x_dates = np.array(
+            [datetime.datetime(2023, 10, n) for n in range(1, limit_value)]
+        )
+        y_dates = np.array(
+            [datetime.datetime(2023, 10, n) for n in range(1, limit_value)]
+        )
+
+        ax1.stem(x_dates, y_dates, bottom=above)
+        ax2.stem(x_dates, y_ranges, bottom=5)
+        ax3.stem(x_ranges, y_dates, bottom=below)
+
+        ax4.stem(x_ranges, y_dates, orientation="horizontal", bottom=above)
+        ax5.stem(x_dates, y_ranges, orientation="horizontal", bottom=5)
+        ax6.stem(x_ranges, y_dates, orientation="horizontal", bottom=below)
 
     @mpl.style.context("default")
     def test_step(self):

From 092a40086045f17465cfca07c15df069b8ca0c16 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Tue, 5 Dec 2023 17:07:41 -0500
Subject: [PATCH 0484/1120] TST: Compress some hist geometry tests

We don't want to replicate the entire calculation from the
implementation, or they could both be buggy, but I think this is a
reasonable compromise.
---
 lib/matplotlib/tests/test_axes.py | 151 +++++++++---------------------
 1 file changed, 46 insertions(+), 105 deletions(-)

diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index d5424f80c9e9..c7843faee1ec 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -4410,134 +4410,75 @@ def test_hist_step_bottom():
     ax.hist(d1, bottom=np.arange(10), histtype="stepfilled")
 
 
-def test_hist_stepfilled_geometry():
-    bins = [0, 1, 2, 3]
-    data = [0, 0, 1, 1, 1, 2]
-    _, _, (polygon, ) = plt.hist(data,
-                                 bins=bins,
-                                 histtype='stepfilled')
-    xy = [[0, 0], [0, 2], [1, 2], [1, 3], [2, 3], [2, 1], [3, 1],
-          [3, 0], [2, 0], [2, 0], [1, 0], [1, 0], [0, 0]]
-    assert_array_equal(polygon.get_xy(), xy)
-
-
 def test_hist_step_geometry():
     bins = [0, 1, 2, 3]
     data = [0, 0, 1, 1, 1, 2]
-    _, _, (polygon, ) = plt.hist(data,
-                                 bins=bins,
-                                 histtype='step')
-    xy = [[0, 0], [0, 2], [1, 2], [1, 3], [2, 3], [2, 1], [3, 1], [3, 0]]
-    assert_array_equal(polygon.get_xy(), xy)
+    top = [[0, 0], [0, 2], [1, 2], [1, 3], [2, 3], [2, 1], [3, 1], [3, 0]]
+    bottom = [[2, 0], [2, 0], [1, 0], [1, 0], [0, 0]]
 
-
-def test_hist_stepfilled_bottom_geometry():
-    bins = [0, 1, 2, 3]
-    data = [0, 0, 1, 1, 1, 2]
-    _, _, (polygon, ) = plt.hist(data,
-                                 bins=bins,
-                                 bottom=[1, 2, 1.5],
-                                 histtype='stepfilled')
-    xy = [[0, 1], [0, 3], [1, 3], [1, 5], [2, 5], [2, 2.5], [3, 2.5],
-          [3, 1.5], [2, 1.5], [2, 2], [1, 2], [1, 1], [0, 1]]
-    assert_array_equal(polygon.get_xy(), xy)
+    for histtype, xy in [('step', top), ('stepfilled', top + bottom)]:
+        _, _, (polygon, ) = plt.hist(data, bins=bins, histtype=histtype)
+        assert_array_equal(polygon.get_xy(), xy)
 
 
 def test_hist_step_bottom_geometry():
     bins = [0, 1, 2, 3]
     data = [0, 0, 1, 1, 1, 2]
-    _, _, (polygon, ) = plt.hist(data,
-                                 bins=bins,
-                                 bottom=[1, 2, 1.5],
-                                 histtype='step')
-    xy = [[0, 1], [0, 3], [1, 3], [1, 5], [2, 5], [2, 2.5], [3, 2.5], [3, 1.5]]
-    assert_array_equal(polygon.get_xy(), xy)
-
+    top = [[0, 1], [0, 3], [1, 3], [1, 5], [2, 5], [2, 2.5], [3, 2.5], [3, 1.5]]
+    bottom = [[2, 1.5], [2, 2], [1, 2], [1, 1], [0, 1]]
 
-def test_hist_stacked_stepfilled_geometry():
-    bins = [0, 1, 2, 3]
-    data_1 = [0, 0, 1, 1, 1, 2]
-    data_2 = [0, 1, 2]
-    _, _, patches = plt.hist([data_1, data_2],
-                             bins=bins,
-                             stacked=True,
-                             histtype='stepfilled')
-
-    assert len(patches) == 2
-
-    polygon,  = patches[0]
-    xy = [[0, 0], [0, 2], [1, 2], [1, 3], [2, 3], [2, 1], [3, 1],
-          [3, 0], [2, 0], [2, 0], [1, 0], [1, 0], [0, 0]]
-    assert_array_equal(polygon.get_xy(), xy)
-
-    polygon,  = patches[1]
-    xy = [[0, 2], [0, 3], [1, 3], [1, 4], [2, 4], [2, 2], [3, 2],
-          [3, 1], [2, 1], [2, 3], [1, 3], [1, 2], [0, 2]]
-    assert_array_equal(polygon.get_xy(), xy)
+    for histtype, xy in [('step', top), ('stepfilled', top + bottom)]:
+        _, _, (polygon, ) = plt.hist(data, bins=bins, bottom=[1, 2, 1.5],
+                                     histtype=histtype)
+        assert_array_equal(polygon.get_xy(), xy)
 
 
 def test_hist_stacked_step_geometry():
     bins = [0, 1, 2, 3]
     data_1 = [0, 0, 1, 1, 1, 2]
     data_2 = [0, 1, 2]
-    _, _, patches = plt.hist([data_1, data_2],
-                             bins=bins,
-                             stacked=True,
-                             histtype='step')
-
-    assert len(patches) == 2
-
-    polygon,  = patches[0]
-    xy = [[0, 0], [0, 2], [1, 2], [1, 3], [2, 3], [2, 1], [3, 1], [3, 0]]
-    assert_array_equal(polygon.get_xy(), xy)
-
-    polygon,  = patches[1]
-    xy = [[0, 2], [0, 3], [1, 3], [1, 4], [2, 4], [2, 2], [3, 2], [3, 1]]
-    assert_array_equal(polygon.get_xy(), xy)
-
-
-def test_hist_stacked_stepfilled_bottom_geometry():
-    bins = [0, 1, 2, 3]
-    data_1 = [0, 0, 1, 1, 1, 2]
-    data_2 = [0, 1, 2]
-    _, _, patches = plt.hist([data_1, data_2],
-                             bins=bins,
-                             stacked=True,
-                             bottom=[1, 2, 1.5],
-                             histtype='stepfilled')
-
-    assert len(patches) == 2
-
-    polygon,  = patches[0]
-    xy = [[0, 1], [0, 3], [1, 3], [1, 5], [2, 5], [2, 2.5], [3, 2.5],
-          [3, 1.5], [2, 1.5], [2, 2], [1, 2], [1, 1], [0, 1]]
-    assert_array_equal(polygon.get_xy(), xy)
+    tops = [
+        [[0, 0], [0, 2], [1, 2], [1, 3], [2, 3], [2, 1], [3, 1], [3, 0]],
+        [[0, 2], [0, 3], [1, 3], [1, 4], [2, 4], [2, 2], [3, 2], [3, 1]],
+    ]
+    bottoms = [
+        [[2, 0], [2, 0], [1, 0], [1, 0], [0, 0]],
+        [[2, 1], [2, 3], [1, 3], [1, 2], [0, 2]],
+    ]
+    combined = [t + b for t, b in zip(tops, bottoms)]
 
-    polygon,  = patches[1]
-    xy = [[0, 3], [0, 4], [1, 4], [1, 6], [2, 6], [2, 3.5], [3, 3.5],
-          [3, 2.5], [2, 2.5], [2, 5], [1, 5], [1, 3], [0, 3]]
-    assert_array_equal(polygon.get_xy(), xy)
+    for histtype, xy in [('step', tops), ('stepfilled', combined)]:
+        _, _, patches = plt.hist([data_1, data_2], bins=bins, stacked=True,
+                                 histtype=histtype)
+        assert len(patches) == 2
+        polygon, = patches[0]
+        assert_array_equal(polygon.get_xy(), xy[0])
+        polygon, = patches[1]
+        assert_array_equal(polygon.get_xy(), xy[1])
 
 
 def test_hist_stacked_step_bottom_geometry():
     bins = [0, 1, 2, 3]
     data_1 = [0, 0, 1, 1, 1, 2]
     data_2 = [0, 1, 2]
-    _, _, patches = plt.hist([data_1, data_2],
-                             bins=bins,
-                             stacked=True,
-                             bottom=[1, 2, 1.5],
-                             histtype='step')
-
-    assert len(patches) == 2
-
-    polygon,  = patches[0]
-    xy = [[0, 1], [0, 3], [1, 3], [1, 5], [2, 5], [2, 2.5], [3, 2.5], [3, 1.5]]
-    assert_array_equal(polygon.get_xy(), xy)
-
-    polygon,  = patches[1]
-    xy = [[0, 3], [0, 4], [1, 4], [1, 6], [2, 6], [2, 3.5], [3, 3.5], [3, 2.5]]
-    assert_array_equal(polygon.get_xy(), xy)
+    tops = [
+        [[0, 1], [0, 3], [1, 3], [1, 5], [2, 5], [2, 2.5], [3, 2.5], [3, 1.5]],
+        [[0, 3], [0, 4], [1, 4], [1, 6], [2, 6], [2, 3.5], [3, 3.5], [3, 2.5]],
+    ]
+    bottoms = [
+        [[2, 1.5], [2, 2], [1, 2], [1, 1], [0, 1]],
+        [[2, 2.5], [2, 5], [1, 5], [1, 3], [0, 3]],
+    ]
+    combined = [t + b for t, b in zip(tops, bottoms)]
+
+    for histtype, xy in [('step', tops), ('stepfilled', combined)]:
+        _, _, patches = plt.hist([data_1, data_2], bins=bins, stacked=True,
+                                 bottom=[1, 2, 1.5], histtype=histtype)
+        assert len(patches) == 2
+        polygon, = patches[0]
+        assert_array_equal(polygon.get_xy(), xy[0])
+        polygon, = patches[1]
+        assert_array_equal(polygon.get_xy(), xy[1])
 
 
 @image_comparison(['hist_stacked_bar'])

From 580cda586deb17d46d83c68ee82573f12ecf83d7 Mon Sep 17 00:00:00 2001
From: Maggie Liu <72244627+mliu08@users.noreply.github.com>
Date: Tue, 5 Dec 2023 15:43:24 -0800
Subject: [PATCH 0485/1120] [TST] Add test_annotate in test_datetime.py
 (#27222)

* smoke test for axes.annotate in datetime

* fixed tests using numeric data instead of dates

* smoke test for axes.annotate in test.datetime
---
 lib/matplotlib/tests/test_datetime.py | 20 +++++++++++++++++---
 1 file changed, 17 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 4e0128843c2a..62a2fe2f2da9 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -14,11 +14,25 @@ def test_acorr(self):
         fig, ax = plt.subplots()
         ax.acorr(...)
 
-    @pytest.mark.xfail(reason="Test for annotate not written yet")
     @mpl.style.context("default")
     def test_annotate(self):
-        fig, ax = plt.subplots()
-        ax.annotate(...)
+        mpl.rcParams["date.converter"] = 'concise'
+        fig, (ax1, ax2, ax3, ax4) = plt.subplots(4, 1, layout="constrained")
+
+        start_date = datetime.datetime(2023, 10, 1)
+        dates = [start_date + datetime.timedelta(days=i) for i in range(31)]
+        data = list(range(1, 32))
+        test_text = "Test Text"
+
+        ax1.plot(dates, data)
+        ax1.annotate(text=test_text, xy=(dates[15], data[15]))
+        ax2.plot(data, dates)
+        ax2.annotate(text=test_text, xy=(data[5], dates[26]))
+        ax3.plot(dates, dates)
+        ax3.annotate(text=test_text, xy=(dates[15], dates[3]))
+        ax4.plot(dates, dates)
+        ax4.annotate(text=test_text, xy=(dates[5], dates[30]),
+                        xytext=(dates[1], dates[7]), arrowprops=dict(facecolor='red'))
 
     @pytest.mark.xfail(reason="Test for arrow not written yet")
     @mpl.style.context("default")

From 8be243c0e8f665d8365d9a6f263c4ffcd377f968 Mon Sep 17 00:00:00 2001
From: rawwash <112187975+rawwash@users.noreply.github.com>
Date: Tue, 5 Dec 2023 18:50:51 -0500
Subject: [PATCH 0486/1120] Add test_bxp in test_datetime.py (#27390)

* added test case for test_bxp

* adding datetime functionality

* removing plt.show()
---
 lib/matplotlib/tests/test_datetime.py | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index e7bb668165f5..fc1c5f5fbd98 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -237,11 +237,24 @@ def test_broken_barh(self):
                          (datetime.datetime(2023, 1, 4), datetime.timedelta(days=4))],
                          (20, 9), facecolors=('tab:red'))
 
-    @pytest.mark.xfail(reason="Test for bxp not written yet")
     @mpl.style.context("default")
     def test_bxp(self):
+        mpl.rcParams["date.converter"] = 'concise'
         fig, ax = plt.subplots()
-        ax.bxp(...)
+        data = [{
+            "med": datetime.datetime(2020, 1, 15),
+            "q1": datetime.datetime(2020, 1, 10),
+            "q3": datetime.datetime(2020, 1, 20),
+            "whislo": datetime.datetime(2020, 1, 5),
+            "whishi": datetime.datetime(2020, 1, 25),
+            "fliers": [
+                datetime.datetime(2020, 1, 3),
+                datetime.datetime(2020, 1, 27)
+            ]
+        }]
+        ax.bxp(data, vert=False)
+        ax.xaxis.set_major_formatter(mpl.dates.DateFormatter("%Y-%m-%d"))
+        ax.set_title('Box plot with datetime data')
 
     @pytest.mark.xfail(reason="Test for clabel not written yet")
     @mpl.style.context("default")

From ec2ff7b41312bde77d61d8109af11f8bfdc6b65f Mon Sep 17 00:00:00 2001
From: Drew Kinneer <drew@Kinneer5.com>
Date: Tue, 5 Dec 2023 18:26:01 -0600
Subject: [PATCH 0487/1120] remove quiverkey datetime test

---
 lib/matplotlib/tests/test_datetime.py | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index ca9c09e45fe7..56b974ab75e1 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -520,12 +520,6 @@ def test_quiver(self):
         fig, ax = plt.subplots()
         ax.quiver(...)
 
-    @pytest.mark.xfail(reason="Test for quiverkey not written yet")
-    @mpl.style.context("default")
-    def test_quiverkey(self):
-        fig, ax = plt.subplots()
-        ax.quiverkey(...)
-
     @mpl.style.context("default")
     def test_scatter(self):
         mpl.rcParams["date.converter"] = 'concise'

From f579544cf50fa130ce3c480e0e9818873fd02ff7 Mon Sep 17 00:00:00 2001
From: Jody Klymak <jklymak@gmail.com>
Date: Sun, 3 Dec 2023 08:59:17 -0800
Subject: [PATCH 0488/1120] MNT: remove xcorr and acorr from test_datetime

---
 lib/matplotlib/tests/test_datetime.py | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index fc1c5f5fbd98..94a3947b5a4f 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -8,12 +8,16 @@
 
 
 class TestDatetimePlotting:
+<<<<<<< HEAD
     @pytest.mark.xfail(reason="Test for acorr not written yet")
     @mpl.style.context("default")
     def test_acorr(self):
         fig, ax = plt.subplots()
         ax.acorr(...)
 
+=======
+    @pytest.mark.xfail(reason="Test for annotate not written yet")
+>>>>>>> 151199a8ef (MNT: remove xcorr and acorr from test_datetime)
     @mpl.style.context("default")
     def test_annotate(self):
         mpl.rcParams["date.converter"] = 'concise'
@@ -738,9 +742,3 @@ def test_violinplot(self):
     def test_vlines(self):
         fig, ax = plt.subplots()
         ax.vlines(...)
-
-    @pytest.mark.xfail(reason="Test for xcorr not written yet")
-    @mpl.style.context("default")
-    def test_xcorr(self):
-        fig, ax = plt.subplots()
-        ax.xcorr(...)

From 403873f6665dea73251c15198fb1df8e28ca8aad Mon Sep 17 00:00:00 2001
From: Jody Klymak <jklymak@gmail.com>
Date: Tue, 5 Dec 2023 16:53:04 -0800
Subject: [PATCH 0489/1120] DOC: note lack of unit handling in docstring [ci
 doc]

---
 lib/matplotlib/axes/_axes.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 6a9353f45146..358b12ca563d 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -1979,6 +1979,8 @@ def acorr(self, x, **kwargs):
         Parameters
         ----------
         x : array-like
+            Not run through Matplotlib's unit conversion, so this should
+            be a unit-less array.
 
         detrend : callable, default: `.mlab.detrend_none` (no detrending)
             A detrending function applied to *x*.  It must have the
@@ -2056,6 +2058,8 @@ def xcorr(self, x, y, normed=True, detrend=mlab.detrend_none,
         Parameters
         ----------
         x, y : array-like of length n
+            Neither *x* nor *y* are run through Matplotlib's unit conversion, so
+            these should be unit-less arrays.
 
         detrend : callable, default: `.mlab.detrend_none` (no detrending)
             A detrending function applied to *x* and *y*.  It must have the

From f2da1f00b8ea16e32096f9bf1f323468730317fe Mon Sep 17 00:00:00 2001
From: Jody Klymak <jklymak@gmail.com>
Date: Sun, 3 Dec 2023 08:54:22 -0800
Subject: [PATCH 0490/1120] DOC: normalizing histograms

---
 galleries/examples/statistics/hist.py         |   4 +-
 .../examples/statistics/histogram_features.py |  60 -----
 .../statistics/histogram_normalization.py     | 255 ++++++++++++++++++
 3 files changed, 257 insertions(+), 62 deletions(-)
 delete mode 100644 galleries/examples/statistics/histogram_features.py
 create mode 100644 galleries/examples/statistics/histogram_normalization.py

diff --git a/galleries/examples/statistics/hist.py b/galleries/examples/statistics/hist.py
index 9e1a308153ef..8b06093913df 100644
--- a/galleries/examples/statistics/hist.py
+++ b/galleries/examples/statistics/hist.py
@@ -36,6 +36,8 @@
 axs[0].hist(dist1, bins=n_bins)
 axs[1].hist(dist2, bins=n_bins)
 
+plt.show()
+
 
 # %%
 # Updating histogram colors
@@ -99,8 +101,6 @@
 # We can also define custom numbers of bins for each axis
 axs[2].hist2d(dist1, dist2, bins=(80, 10), norm=colors.LogNorm())
 
-plt.show()
-
 # %%
 #
 # .. admonition:: References
diff --git a/galleries/examples/statistics/histogram_features.py b/galleries/examples/statistics/histogram_features.py
deleted file mode 100644
index 21f74fd1ac44..000000000000
--- a/galleries/examples/statistics/histogram_features.py
+++ /dev/null
@@ -1,60 +0,0 @@
-"""
-==============================================
-Some features of the histogram (hist) function
-==============================================
-
-In addition to the basic histogram, this demo shows a few optional features:
-
-* Setting the number of data bins.
-* The *density* parameter, which normalizes bin heights so that the integral of
-  the histogram is 1. The resulting histogram is an approximation of the
-  probability density function.
-
-Selecting different bin counts and sizes can significantly affect the shape
-of a histogram. The Astropy docs have a great section_ on how to select these
-parameters.
-
-.. _section: http://docs.astropy.org/en/stable/visualization/histogram.html
-"""
-
-import matplotlib.pyplot as plt
-import numpy as np
-
-rng = np.random.default_rng(19680801)
-
-# example data
-mu = 106  # mean of distribution
-sigma = 17  # standard deviation of distribution
-x = rng.normal(loc=mu, scale=sigma, size=420)
-
-num_bins = 42
-
-fig, ax = plt.subplots()
-
-# the histogram of the data
-n, bins, patches = ax.hist(x, num_bins, density=True)
-
-# add a 'best fit' line
-y = ((1 / (np.sqrt(2 * np.pi) * sigma)) *
-     np.exp(-0.5 * (1 / sigma * (bins - mu))**2))
-ax.plot(bins, y, '--')
-ax.set_xlabel('Value')
-ax.set_ylabel('Probability density')
-ax.set_title('Histogram of normal distribution sample: '
-             fr'$\mu={mu:.0f}$, $\sigma={sigma:.0f}$')
-
-# Tweak spacing to prevent clipping of ylabel
-fig.tight_layout()
-plt.show()
-
-# %%
-#
-# .. admonition:: References
-#
-#    The use of the following functions, methods, classes and modules is shown
-#    in this example:
-#
-#    - `matplotlib.axes.Axes.hist` / `matplotlib.pyplot.hist`
-#    - `matplotlib.axes.Axes.set_title`
-#    - `matplotlib.axes.Axes.set_xlabel`
-#    - `matplotlib.axes.Axes.set_ylabel`
diff --git a/galleries/examples/statistics/histogram_normalization.py b/galleries/examples/statistics/histogram_normalization.py
new file mode 100644
index 000000000000..9418b7af002b
--- /dev/null
+++ b/galleries/examples/statistics/histogram_normalization.py
@@ -0,0 +1,255 @@
+"""
+.. redirect-from:: /gallery/statistics/histogram_features
+
+===================================
+Histogram bins, density, and weight
+===================================
+
+The `.Axes.hist` method can flexibly create histograms in a few different ways,
+which is flexible and helpful, but can also lead to confusion.  In particular,
+you can:
+
+- bin the data as you want, either with an automatically chosen number of
+  bins, or with fixed bin edges,
+- normalize the histogram so that its integral is one,
+- and assign weights to the data points, so that each data point affects the
+  count in its bin differently.
+
+The Matplotlib ``hist`` method calls `numpy.histogram` and plots the results,
+therefore users should consult the numpy documentation for a definitive guide.
+
+Histograms are created by defining bin edges, and taking a dataset of values
+and sorting them into the bins, and counting or summing how much data is in
+each bin.  In this simple example, 9 numbers between 1 and 4 are sorted into 3
+bins:
+"""
+
+import matplotlib.pyplot as plt
+import numpy as np
+
+rng = np.random.default_rng(19680801)
+
+xdata = np.array([1.2, 2.3, 3.3, 3.1, 1.7, 3.4, 2.1, 1.25, 1.3])
+xbins = np.array([1, 2, 3, 4])
+
+# changing the style of the histogram bars just to make it
+# very clear where the boundaries of the bins are:
+style = {'facecolor': 'none', 'edgecolor': 'C0', 'linewidth': 3}
+
+fig, ax = plt.subplots()
+ax.hist(xdata, bins=xbins, **style)
+
+# plot the xdata locations on the x axis:
+ax.plot(xdata, 0*xdata, 'd')
+ax.set_ylabel('Number per bin')
+ax.set_xlabel('x bins (dx=1.0)')
+
+# %%
+# Modifying bins
+# ==============
+#
+# Changing the bin size changes the shape of this sparse histogram, so its a
+# good idea to choose bins with some care with respect to your data.  Here we
+# make the bins half as wide.
+
+xbins = np.arange(1, 4.5, 0.5)
+
+fig, ax = plt.subplots()
+ax.hist(xdata, bins=xbins, **style)
+ax.plot(xdata, 0*xdata, 'd')
+ax.set_ylabel('Number per bin')
+ax.set_xlabel('x bins (dx=0.5)')
+
+# %%
+# We can also let numpy (via Matplotlib) choose the bins automatically, or
+# specify a number of bins to choose automatically:
+
+fig, ax = plt.subplot_mosaic([['auto', 'n4']],
+                             sharex=True, sharey=True, layout='constrained')
+
+ax['auto'].hist(xdata, **style)
+ax['auto'].plot(xdata, 0*xdata, 'd')
+ax['auto'].set_ylabel('Number per bin')
+ax['auto'].set_xlabel('x bins (auto)')
+
+ax['n4'].hist(xdata, bins=4, **style)
+ax['n4'].plot(xdata, 0*xdata, 'd')
+ax['n4'].set_xlabel('x bins ("bins=4")')
+
+# %%
+# Normalizing histograms: density and weight
+# ==========================================
+#
+# Counts-per-bin is the default length of each bar in the histogram.  However,
+# we can also normalize the bar lengths as a probability density function using
+# the ``density`` parameter:
+
+fig, ax = plt.subplots()
+ax.hist(xdata, bins=xbins, density=True, **style)
+ax.set_ylabel('Probability density [$V^{-1}$])')
+ax.set_xlabel('x bins (dx=0.5 $V$)')
+
+# %%
+# This normalization can be a little hard to interpret when just exploring the
+# data. The value attached to each bar is divided by the total number of data
+# points *and* the width of the bin, and thus the values _integrate_ to one
+# when integrating across the full range of data.
+# e.g. ::
+#
+#     density = counts / (sum(counts) * np.diff(bins))
+#     np.sum(density * np.diff(bins)) == 1
+#
+# This normalization is how `probability density functions
+# <https://en.wikipedia.org/wiki/Probability_density_function>`_ are defined in
+# statistics.  If :math:`X` is a random variable on :math:`x`, then :math:`f_X`
+# is is the probability density function if :math:`P[a<X<b] = \int_a^b f_X dx`.
+# If the units of x are Volts, then the units of :math:`f_X` are :math:`V^{-1}`
+# or probability per change in voltage.
+#
+# The usefulness of this normalization is a little more clear when we draw from
+# a known distribution and try to compare with theory.  So, choose 1000 points
+# from a `normal distribution
+# <https://en.wikipedia.org/wiki/Normal_distribution>`_, and also calculate the
+# known probability density function:
+
+xdata = rng.normal(size=1000)
+xpdf = np.arange(-4, 4, 0.1)
+pdf = 1 / (np.sqrt(2 * np.pi)) * np.exp(-xpdf**2 / 2)
+
+# %%
+# If we don't use ``density=True``, we need to scale the expected probability
+# distribution function by both the length of the data and the width of the
+# bins:
+
+fig, ax = plt.subplot_mosaic([['False', 'True']], layout='constrained')
+dx = 0.1
+xbins = np.arange(-4, 4, dx)
+ax['False'].hist(xdata, bins=xbins, density=False, histtype='step', label='Counts')
+
+# scale and plot the expected pdf:
+ax['False'].plot(xpdf, pdf * len(xdata) * dx, label=r'$N\,f_X(x)\,\delta x$')
+ax['False'].set_ylabel('Count per bin')
+ax['False'].set_xlabel('x bins [V]')
+ax['False'].legend()
+
+ax['True'].hist(xdata, bins=xbins, density=True, histtype='step', label='density')
+ax['True'].plot(xpdf, pdf, label='$f_X(x)$')
+ax['True'].set_ylabel('Probability density [$V^{-1}$]')
+ax['True'].set_xlabel('x bins [$V$]')
+ax['True'].legend()
+
+# %%
+# One advantage of using the density is therefore that the shape and amplitude
+# of the histogram does not depend on the size of the bins.  Consider an
+# extreme case where the bins do not have the same width.  In this example, the
+# bins below ``x=-1.25`` are six times wider than the rest of the bins.   By
+# normalizing by density, we preserve the shape of the distribution, whereas if
+# we do not, then the wider bins have much higher counts than the thinner bins:
+
+fig, ax = plt.subplot_mosaic([['False', 'True']], layout='constrained')
+dx = 0.1
+xbins = np.hstack([np.arange(-4, -1.25, 6*dx), np.arange(-1.25, 4, dx)])
+ax['False'].hist(xdata, bins=xbins, density=False, histtype='step', label='Counts')
+ax['False'].plot(xpdf, pdf * len(xdata) * dx, label=r'$N\,f_X(x)\,\delta x_0$')
+ax['False'].set_ylabel('Count per bin')
+ax['False'].set_xlabel('x bins [V]')
+ax['False'].legend()
+
+ax['True'].hist(xdata, bins=xbins, density=True, histtype='step', label='density')
+ax['True'].plot(xpdf, pdf, label='$f_X(x)$')
+ax['True'].set_ylabel('Probability density [$V^{-1}$]')
+ax['True'].set_xlabel('x bins [$V$]')
+ax['True'].legend()
+
+# %%
+# Similarly, if we want to compare histograms with different bin widths, we may
+# want to use ``density=True``:
+
+fig, ax = plt.subplot_mosaic([['False', 'True']], layout='constrained')
+
+# expected PDF
+ax['True'].plot(xpdf, pdf, '--', label='$f_X(x)$', color='k')
+
+for nn, dx in enumerate([0.1, 0.4, 1.2]):
+    xbins = np.arange(-4, 4, dx)
+    # expected histogram:
+    ax['False'].plot(xpdf, pdf*1000*dx, '--', color=f'C{nn}')
+    ax['False'].hist(xdata, bins=xbins, density=False, histtype='step')
+
+    ax['True'].hist(xdata, bins=xbins, density=True, histtype='step', label=dx)
+
+# Labels:
+ax['False'].set_xlabel('x bins [$V$]')
+ax['False'].set_ylabel('Count per bin')
+ax['True'].set_ylabel('Probability density [$V^{-1}$]')
+ax['True'].set_xlabel('x bins [$V$]')
+ax['True'].legend(fontsize='small', title='bin width:')
+
+# %%
+# Sometimes people want to normalize so that the sum of counts is one.  This is
+# analogous to a `probability mass function
+# <https://en.wikipedia.org/wiki/Probability_mass_function>`_ for a discrete
+# variable where the sum of probabilities for all the values equals one.  Using
+# ``hist``, we can get this normalization if we set the *weights* to 1/N.
+# Note that the amplitude of this normalized histogram still depends on
+# width and/or number of the bins:
+
+fig, ax = plt.subplots(layout='constrained', figsize=(3.5, 3))
+
+for nn, dx in enumerate([0.1, 0.4, 1.2]):
+    xbins = np.arange(-4, 4, dx)
+    ax.hist(xdata, bins=xbins, weights=1/len(xdata) * np.ones(len(xdata)),
+                   histtype='step', label=f'{dx}')
+ax.set_xlabel('x bins [$V$]')
+ax.set_ylabel('Bin count / N')
+ax.legend(fontsize='small', title='bin width:')
+
+# %%
+# The value of normalizing histograms is comparing two distributions that have
+# different sized populations.  Here we compare the distribution of ``xdata``
+# with a population of 1000, and ``xdata2`` with 100 members.
+
+xdata2 = rng.normal(size=100)
+
+fig, ax = plt.subplot_mosaic([['no_norm', 'density', 'weight']],
+                             layout='constrained', figsize=(8, 4))
+
+xbins = np.arange(-4, 4, 0.25)
+
+ax['no_norm'].hist(xdata, bins=xbins, histtype='step')
+ax['no_norm'].hist(xdata2, bins=xbins, histtype='step')
+ax['no_norm'].set_ylabel('Counts')
+ax['no_norm'].set_xlabel('x bins [$V$]')
+ax['no_norm'].set_title('No normalization')
+
+ax['density'].hist(xdata, bins=xbins, histtype='step', density=True)
+ax['density'].hist(xdata2, bins=xbins, histtype='step', density=True)
+ax['density'].set_ylabel('Probability density [$V^{-1}$]')
+ax['density'].set_title('Density=True')
+ax['density'].set_xlabel('x bins [$V$]')
+
+ax['weight'].hist(xdata, bins=xbins, histtype='step',
+                  weights=1 / len(xdata) * np.ones(len(xdata)),
+                  label='N=1000')
+ax['weight'].hist(xdata2, bins=xbins, histtype='step',
+                  weights=1 / len(xdata2) * np.ones(len(xdata2)),
+                  label='N=100')
+ax['weight'].set_xlabel('x bins [$V$]')
+ax['weight'].set_ylabel('Counts / N')
+ax['weight'].legend(fontsize='small')
+ax['weight'].set_title('Weight = 1/N')
+
+plt.show()
+
+# %%
+#
+# .. admonition:: References
+#
+#    The use of the following functions, methods, classes and modules is shown
+#    in this example:
+#
+#    - `matplotlib.axes.Axes.hist` / `matplotlib.pyplot.hist`
+#    - `matplotlib.axes.Axes.set_title`
+#    - `matplotlib.axes.Axes.set_xlabel`
+#    - `matplotlib.axes.Axes.set_ylabel`
+#    - `matplotlib.axes.Axes.legend`

From 444d473b560ee1616ab6ec54a8d1d07feba7817c Mon Sep 17 00:00:00 2001
From: "ddale1128@gmail.com" <ddale1128@gmail.com>
Date: Tue, 5 Dec 2023 21:20:28 -0800
Subject: [PATCH 0491/1120] Fix flake8 line length error

---
 galleries/plot_types/basic/stairs.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/galleries/plot_types/basic/stairs.py b/galleries/plot_types/basic/stairs.py
index d917d3d4e626..54c217a2dca0 100644
--- a/galleries/plot_types/basic/stairs.py
+++ b/galleries/plot_types/basic/stairs.py
@@ -3,8 +3,9 @@
 stairs(values)
 ==============
 
-See `~matplotlib.axes.Axes.stairs` when plotting :math:`y$` between :math:`(x_i, x_{i+1})`.
-For plotting :math:`y` at :math:`x`, see `~matplotlib.axes.Axes.step`.
+See `~matplotlib.axes.Axes.stairs` when plotting :math:`y$` between
+:math:`(x_i, x_{i+1})`. For plotting :math:`y` at :math:`x`, see
+`~matplotlib.axes.Axes.step`.
 
 .. redirect-from:: /plot_types/basic/step
 """

From 7cfd68888e08358a698e284d79d76734066d5c08 Mon Sep 17 00:00:00 2001
From: Jody Klymak <jklymak@gmail.com>
Date: Tue, 5 Dec 2023 21:59:31 -0800
Subject: [PATCH 0492/1120] DOC: note lack of unit handling in docstring [ci
 doc]

---
 lib/matplotlib/tests/test_datetime.py | 10 ----------
 1 file changed, 10 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 94a3947b5a4f..244ee2af2a58 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -8,16 +8,6 @@
 
 
 class TestDatetimePlotting:
-<<<<<<< HEAD
-    @pytest.mark.xfail(reason="Test for acorr not written yet")
-    @mpl.style.context("default")
-    def test_acorr(self):
-        fig, ax = plt.subplots()
-        ax.acorr(...)
-
-=======
-    @pytest.mark.xfail(reason="Test for annotate not written yet")
->>>>>>> 151199a8ef (MNT: remove xcorr and acorr from test_datetime)
     @mpl.style.context("default")
     def test_annotate(self):
         mpl.rcParams["date.converter"] = 'concise'

From 41afb903c4e8dabafe3d3344319056553112c81a Mon Sep 17 00:00:00 2001
From: Ruoyi Xie <105222584+xieruoyi@users.noreply.github.com>
Date: Wed, 6 Dec 2023 02:15:24 -0500
Subject: [PATCH 0493/1120] Added test_fill_betweenx in test_datetime.py 
 (#27425)

* Added test for fill_betweenx

* pull the newest update

* Deleted the second figure and only leave datetime figures

---------

Co-authored-by: Ruoyi <ruoyi.xie@mail.utoronto.ca>
---
 lib/matplotlib/tests/test_datetime.py | 35 ++++++++++++++++++++++++---
 1 file changed, 32 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 39a160d8ff03..61d1623c6bbc 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -389,11 +389,40 @@ def test_fill_between(self):
         ax2.fill_between(x_dates, y_values1, y_values2)
         ax3.fill_between(x_dates, y_dates1, y_dates2)
 
-    @pytest.mark.xfail(reason="Test for fill_betweenx not written yet")
     @mpl.style.context("default")
     def test_fill_betweenx(self):
-        fig, ax = plt.subplots()
-        ax.fill_betweenx(...)
+        mpl.rcParams["date.converter"] = "concise"
+        np.random.seed(19680801)
+
+        x_base_date = datetime.datetime(2023, 1, 1)
+        x_dates1 = [x_base_date]
+        for i in range(1, 10):
+            x_base_date += datetime.timedelta(days=np.random.randint(1, 5))
+            x_dates1.append(x_base_date)
+
+        x_dates2 = [x_base_date]
+        for i in range(1, 10):
+            x_base_date += datetime.timedelta(days=np.random.randint(1, 5))
+            x_dates2.append(x_base_date)
+        y_values = np.random.rand(10) * 10
+        y_values.sort()
+
+        x_values1 = np.random.rand(10) * 10
+        x_values2 = x_values1 + np.random.rand(10) * 10
+        x_values1.sort()
+        x_values2.sort()
+
+        y_base_date = datetime.datetime(2023, 1, 1)
+        y_dates = [y_base_date]
+        for i in range(1, 10):
+            y_base_date += datetime.timedelta(days=np.random.randint(1, 10))
+            y_dates.append(y_base_date)
+
+        fig, (ax1, ax2, ax3) = plt.subplots(1, 3, layout="constrained")
+
+        ax1.fill_betweenx(y_values, x_dates1, x_dates2)
+        ax2.fill_betweenx(y_dates, x_values1, x_values2)
+        ax3.fill_betweenx(y_dates, x_dates1, x_dates2)
 
     @pytest.mark.xfail(reason="Test for hexbin not written yet")
     @mpl.style.context("default")

From a4fd8d358ba6984d0578bdbe7263a20949bbc749 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Thu, 9 Nov 2023 08:43:02 +0100
Subject: [PATCH 0494/1120] Transpose grid_finder tick representation.

Instead of representing the information about tick and gridlines as
```
{
    "lon_lines": [line, ...],  # unused
    "lat_lines": [line, ...],
    "lon": [
        "tick_levels": [level, ...],
        "tick_locs": {"left": [(xy, angle), ...], "bottom": [(xy, angle), ...], ...},
        "tick_labels": {"left": [label, ...], "bottom": [label, ...], ...},
        "lines": [line, ...],
    ],
    "lat": ...,  # as for lon
}
```
where the locs and labels are implicitly associated by the iteration
order, group the information for each tick, and remove the redundant
gridlines info as well:
```
{
    "lon": {
        "lines": [line, ...],
        "ticks": {
            "left": [
                {"level": level, "loc": (xy, angle), "label": label}, ...
            ],
            "bottom": [...], ...,
        }
    }
    "lat": ...,  # as for lon
}
```
---
 lib/mpl_toolkits/axisartist/grid_finder.py    | 61 ++++++-------------
 .../axisartist/grid_helper_curvelinear.py     | 18 +++---
 2 files changed, 27 insertions(+), 52 deletions(-)

diff --git a/lib/mpl_toolkits/axisartist/grid_finder.py b/lib/mpl_toolkits/axisartist/grid_finder.py
index ff61887f9ef2..897a4152b0e7 100644
--- a/lib/mpl_toolkits/axisartist/grid_finder.py
+++ b/lib/mpl_toolkits/axisartist/grid_finder.py
@@ -192,25 +192,28 @@ def get_grid_info(self, x1, y1, x2, y2):
 
         grid_info = {
             "extremes": extremes,
-            "lon_lines": lon_lines,
-            "lat_lines": lat_lines,
-            "lon": self._clip_grid_lines_and_find_ticks(
-                lon_lines, lon_values, lon_levs, bb),
-            "lat": self._clip_grid_lines_and_find_ticks(
-                lat_lines, lat_values, lat_levs, bb),
+            # "lon", "lat", filled below.
         }
 
-        tck_labels = grid_info["lon"]["tick_labels"] = {}
-        for direction in ["left", "bottom", "right", "top"]:
-            levs = grid_info["lon"]["tick_levels"][direction]
-            tck_labels[direction] = self._format_ticks(
-                1, direction, lon_factor, levs)
-
-        tck_labels = grid_info["lat"]["tick_labels"] = {}
-        for direction in ["left", "bottom", "right", "top"]:
-            levs = grid_info["lat"]["tick_levels"][direction]
-            tck_labels[direction] = self._format_ticks(
-                2, direction, lat_factor, levs)
+        for idx, lon_or_lat, levs, factor, values, lines in [
+                (1, "lon", lon_levs, lon_factor, lon_values, lon_lines),
+                (2, "lat", lat_levs, lat_factor, lat_values, lat_lines),
+        ]:
+            grid_info[lon_or_lat] = gi = {
+                "lines": [[l] for l in lines],
+                "ticks": {"left": [], "right": [], "bottom": [], "top": []},
+            }
+            for (lx, ly), v, level in zip(lines, values, levs):
+                all_crossings = _find_line_box_crossings(np.column_stack([lx, ly]), bb)
+                for side, crossings in zip(
+                        ["left", "right", "bottom", "top"], all_crossings):
+                    for crossing in crossings:
+                        gi["ticks"][side].append({"level": level, "loc": crossing})
+            for side in gi["ticks"]:
+                levs = [tick["level"] for tick in gi["ticks"][side]]
+                labels = self._format_ticks(idx, side, factor, levs)
+                for tick, label in zip(gi["ticks"][side], labels):
+                    tick["label"] = label
 
         return grid_info
 
@@ -228,30 +231,6 @@ def _get_raw_grid_lines(self,
 
         return lon_lines, lat_lines
 
-    def _clip_grid_lines_and_find_ticks(self, lines, values, levs, bb):
-        gi = {
-            "values": [],
-            "levels": [],
-            "tick_levels": dict(left=[], bottom=[], right=[], top=[]),
-            "tick_locs": dict(left=[], bottom=[], right=[], top=[]),
-            "lines": [],
-        }
-
-        tck_levels = gi["tick_levels"]
-        tck_locs = gi["tick_locs"]
-        for (lx, ly), v, lev in zip(lines, values, levs):
-            tcks = _find_line_box_crossings(np.column_stack([lx, ly]), bb)
-            gi["levels"].append(v)
-            gi["lines"].append([(lx, ly)])
-
-            for tck, direction in zip(tcks,
-                                      ["left", "right", "bottom", "top"]):
-                for t in tck:
-                    tck_levels[direction].append(lev)
-                    tck_locs[direction].append(t)
-
-        return gi
-
     def set_transform(self, aux_trans):
         if isinstance(aux_trans, Transform):
             self._aux_transform = aux_trans
diff --git a/lib/mpl_toolkits/axisartist/grid_helper_curvelinear.py b/lib/mpl_toolkits/axisartist/grid_helper_curvelinear.py
index 8dbfa6adf90f..a7eb9d5cfe21 100644
--- a/lib/mpl_toolkits/axisartist/grid_helper_curvelinear.py
+++ b/lib/mpl_toolkits/axisartist/grid_helper_curvelinear.py
@@ -82,9 +82,9 @@ def iter_major():
             for nth_coord, show_labels in [
                     (self.nth_coord_ticks, True), (1 - self.nth_coord_ticks, False)]:
                 gi = self.grid_helper._grid_info[["lon", "lat"][nth_coord]]
-                for (xy, angle_normal), l in zip(
-                        gi["tick_locs"][side], gi["tick_labels"][side]):
-                    yield xy, angle_normal, angle_tangent, (l if show_labels else "")
+                for tick in gi["ticks"][side]:
+                    yield (*tick["loc"], angle_tangent,
+                           (tick["label"] if show_labels else ""))
 
         return iter_major(), iter([])
 
@@ -321,12 +321,8 @@ def get_tick_iterator(self, nth_coord, axis_side, minor=False):
         angle_tangent = dict(left=90, right=90, bottom=0, top=0)[axis_side]
         lon_or_lat = ["lon", "lat"][nth_coord]
         if not minor:  # major ticks
-            for (xy, angle_normal), l in zip(
-                    self._grid_info[lon_or_lat]["tick_locs"][axis_side],
-                    self._grid_info[lon_or_lat]["tick_labels"][axis_side]):
-                yield xy, angle_normal, angle_tangent, l
+            for tick in self._grid_info[lon_or_lat]["ticks"][axis_side]:
+                yield *tick["loc"], angle_tangent, tick["label"]
         else:
-            for (xy, angle_normal), l in zip(
-                    self._grid_info[lon_or_lat]["tick_locs"][axis_side],
-                    self._grid_info[lon_or_lat]["tick_labels"][axis_side]):
-                yield xy, angle_normal, angle_tangent, ""
+            for tick in self._grid_info[lon_or_lat]["ticks"][axis_side]:
+                yield *tick["loc"], angle_tangent, ""

From 94ef1b002454647a722db79ce0ae00a1dea0004f Mon Sep 17 00:00:00 2001
From: Jake <37048747+Jacob-Stevens-Haas@users.noreply.github.com>
Date: Wed, 6 Dec 2023 10:12:41 +0000
Subject: [PATCH 0495/1120] BLD: Update Qhull location

---
 .../{qhull-2020.2 => qhull-8.0.2}/meson.build             | 0
 subprojects/qhull.wrap                                    | 8 ++++----
 2 files changed, 4 insertions(+), 4 deletions(-)
 rename subprojects/packagefiles/{qhull-2020.2 => qhull-8.0.2}/meson.build (100%)

diff --git a/subprojects/packagefiles/qhull-2020.2/meson.build b/subprojects/packagefiles/qhull-8.0.2/meson.build
similarity index 100%
rename from subprojects/packagefiles/qhull-2020.2/meson.build
rename to subprojects/packagefiles/qhull-8.0.2/meson.build
diff --git a/subprojects/qhull.wrap b/subprojects/qhull.wrap
index f43ead300834..23f49da33d90 100644
--- a/subprojects/qhull.wrap
+++ b/subprojects/qhull.wrap
@@ -1,9 +1,9 @@
 [wrap-file]
 # Also bump the cache key in `.circleci/config.yml`.
 # Also update the docs in `docs/devel/dependencies.rst`.
-directory = qhull-2020.2
-source_url = http://www.qhull.org/download/qhull-2020-src-8.0.2.tgz
+directory = qhull-8.0.2
+source_url = https://github.com/qhull/qhull/archive/refs/tags/v8.0.2.tar.gz
 source_filename = qhull-2020-src-8.0.2.tgz
-source_hash = b5c2d7eb833278881b952c8a52d20179eab87766b00b865000469a45c1838b7e
+source_hash = 8774e9a12c70b0180b95d6b0b563c5aa4bea8d5960c15e18ae3b6d2521d64f8b
 
-patch_directory = qhull-2020.2
+patch_directory = qhull-8.0.2

From ff8d5f00b44ce50458bc17c6b008790a89b669ef Mon Sep 17 00:00:00 2001
From: Dale Dai <145884899+CouldNot@users.noreply.github.com>
Date: Wed, 6 Dec 2023 08:03:43 -0800
Subject: [PATCH 0496/1120] Remove stray simple

Co-authored-by: hannah <story645@gmail.com>
---
 galleries/plot_types/basic/stairs.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/galleries/plot_types/basic/stairs.py b/galleries/plot_types/basic/stairs.py
index 54c217a2dca0..de5761e3a7a5 100644
--- a/galleries/plot_types/basic/stairs.py
+++ b/galleries/plot_types/basic/stairs.py
@@ -3,7 +3,7 @@
 stairs(values)
 ==============
 
-See `~matplotlib.axes.Axes.stairs` when plotting :math:`y$` between
+See `~matplotlib.axes.Axes.stairs` when plotting :math:`y` between
 :math:`(x_i, x_{i+1})`. For plotting :math:`y` at :math:`x`, see
 `~matplotlib.axes.Axes.step`.
 

From 70dc609d4455986a7297b50409a2598d603becf7 Mon Sep 17 00:00:00 2001
From: madisonwong210 <mwong0210@gmail.com>
Date: Thu, 30 Nov 2023 17:40:29 -0500
Subject: [PATCH 0497/1120] Add test_vlines to test_datetime.py

---
 lib/matplotlib/tests/test_datetime.py | 22 +++++++++++++++++++---
 1 file changed, 19 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 61d1623c6bbc..cec2fa891e80 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -750,8 +750,24 @@ def test_violinplot(self):
         fig, ax = plt.subplots()
         ax.violinplot(...)
 
-    @pytest.mark.xfail(reason="Test for vlines not written yet")
     @mpl.style.context("default")
     def test_vlines(self):
-        fig, ax = plt.subplots()
-        ax.vlines(...)
+        mpl.rcParams["date.converter"] = 'concise'
+        fig, (ax1, ax2, ax3) = plt.subplots(3, 1, layout='constrained')
+        ax1.set_xlim(left=datetime.datetime(2023, 1, 1),
+                     right=datetime.datetime(2023, 6, 30))
+        ax1.vlines(x=[datetime.datetime(2023, 2, 10),
+                      datetime.datetime(2023, 5, 18),
+                      datetime.datetime(2023, 6, 6)],
+                   ymin=[0, 0.25, 0.5],
+                   ymax=[0.25, 0.5, 0.75])
+        ax2.set_xlim(left=0,
+                     right=0.5)
+        ax2.vlines(x=[0.3, 0.35],
+                   ymin=[np.datetime64('2023-03-20'), np.datetime64('2023-03-31')],
+                   ymax=[np.datetime64('2023-05-01'), np.datetime64('2023-05-16')])
+        ax3.set_xlim(left=datetime.datetime(2023, 7, 1),
+                     right=datetime.datetime(2023, 12, 31))
+        ax3.vlines(x=[datetime.datetime(2023, 9, 1), datetime.datetime(2023, 12, 10)],
+                   ymin=datetime.datetime(2023, 1, 15),
+                   ymax=datetime.datetime(2023, 1, 30))

From f80ff656e6095a1d322696bf8ddd59a47322d9d0 Mon Sep 17 00:00:00 2001
From: Issam <issam@cs.toronto.edu>
Date: Thu, 7 Dec 2023 00:09:31 +0300
Subject: [PATCH 0498/1120] Remove backend 3.7-deprecated API  (#26962)

* remove deprecated class PsBackendHelper

Signed-off-by: Issam Arabi <issam@cs.toronto.edu>

* remove deprecated class ServerThread

Signed-off-by: Issam Arabi <issam@cs.toronto.edu>

* remove deprecated class PsBackendHelper dependency

Signed-off-by: Issam Arabi <issam@cs.toronto.edu>

* remove blank lines

Signed-off-by: Issam Arabi <issam@cs.toronto.edu>

* Delete deprecated C++ methods PyBufferRegion_to_string and PyBufferRegion_to_string_argb

This commit removes two deprecated methods, PyBufferRegion_to_string and PyBufferRegion_to_string_argb, from src/_backend_agg_wrapper.cpp, deprecated since version 3.7.

Signed-off-by: Issam Arabi <issam@cs.toronto.edu>

* Update API change notes to document removal of deprecated classes and methods from 3.7

This commit updates the API change notes to reflect the removal of deprecated Python classes and C++ methods.

Signed-off-by: Issam Arabi <issam@cs.toronto.edu>

* Remove deprecated PyBufferRegion methods from _backend_agg_wrapper.cpp

Removed `to_string` and `to_string_argb` methods from `PyBufferRegion_init_type`

Signed-off-by: Issam Arabi <issam@cs.toronto.edu>

* Update format of API change note

Signed-off-by: Issam Arabi <issam@cs.toronto.edu>

* remove to_string_argb

Signed-off-by: Issam Arabi <issam@cs.toronto.edu>

* Update doc format

Co-authored-by: Kyle Sunden <git@ksunden.space>

* Update doc/api/next_api_changes/removals/26962-IA.rst

Update doc format

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>

* remove to_string_argb declaration

Signed-off-by: Issam Arabi <issam@cs.toronto.edu>

* refactor

* Update formatting of note

Co-authored-by: Kyle Sunden <git@ksunden.space>

---------

Signed-off-by: Issam Arabi <issam@cs.toronto.edu>
Co-authored-by: Kyle Sunden <git@ksunden.space>
Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>
---
 .../next_api_changes/removals/26962-IA.rst    | 19 ++++++++++
 lib/matplotlib/backends/backend_ps.py         |  8 -----
 lib/matplotlib/backends/backend_webagg.py     |  6 ----
 src/_backend_agg.cpp                          | 20 -----------
 src/_backend_agg.h                            |  2 --
 src/_backend_agg_wrapper.cpp                  | 36 -------------------
 6 files changed, 19 insertions(+), 72 deletions(-)
 create mode 100644 doc/api/next_api_changes/removals/26962-IA.rst

diff --git a/doc/api/next_api_changes/removals/26962-IA.rst b/doc/api/next_api_changes/removals/26962-IA.rst
new file mode 100644
index 000000000000..ac1ab46944b6
--- /dev/null
+++ b/doc/api/next_api_changes/removals/26962-IA.rst
@@ -0,0 +1,19 @@
+Deprecated Classes Removed
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The following deprecated classes from version 3.7 have been removed:
+
+- ``matplotlib.backends.backend_ps.PsBackendHelper``
+- ``matplotlib.backends.backend_webagg.ServerThread``
+
+These classes were previously marked as deprecated and have now been removed in accordance with the deprecation cycle.
+
+Deprecated C++ Methods Removed
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The following deprecated C++ methods from :file:`src/_backend_agg_wrapper.cpp`, deprecated since version 3.7, have also been removed:
+
+- ``PyBufferRegion_to_string``
+- ``PyBufferRegion_to_string_argb``
+
+These methods were previously marked as deprecated and have now been removed.
diff --git a/lib/matplotlib/backends/backend_ps.py b/lib/matplotlib/backends/backend_ps.py
index dad3049f51da..d760bef04d19 100644
--- a/lib/matplotlib/backends/backend_ps.py
+++ b/lib/matplotlib/backends/backend_ps.py
@@ -39,17 +39,9 @@
 debugPS = False
 
 
-@_api.deprecated("3.7")
-class PsBackendHelper:
-    def __init__(self):
-        self._cached = {}
-
-
 @_api.caching_module_getattr
 class __getattr__:
     # module-level deprecations
-    ps_backend_helper = _api.deprecated("3.7", obj_type="")(
-        property(lambda self: PsBackendHelper()))
     psDefs = _api.deprecated("3.8", obj_type="")(property(lambda self: _psDefs))
 
 
diff --git a/lib/matplotlib/backends/backend_webagg.py b/lib/matplotlib/backends/backend_webagg.py
index 14c0b525fb8f..dfc5747ef77c 100644
--- a/lib/matplotlib/backends/backend_webagg.py
+++ b/lib/matplotlib/backends/backend_webagg.py
@@ -37,12 +37,6 @@
     TimerAsyncio, TimerTornado)
 
 
-@mpl._api.deprecated("3.7")
-class ServerThread(threading.Thread):
-    def run(self):
-        tornado.ioloop.IOLoop.instance().start()
-
-
 webagg_server_thread = threading.Thread(
     target=lambda: tornado.ioloop.IOLoop.instance().start())
 
diff --git a/src/_backend_agg.cpp b/src/_backend_agg.cpp
index aec7676b7951..10a17f2dc9cb 100644
--- a/src/_backend_agg.cpp
+++ b/src/_backend_agg.cpp
@@ -5,26 +5,6 @@
 #include "_backend_agg.h"
 #include "mplutils.h"
 
-void BufferRegion::to_string_argb(uint8_t *buf)
-{
-    unsigned char *pix;
-    unsigned char tmp;
-    size_t i, j;
-
-    memcpy(buf, data, (size_t) height * stride);
-
-    for (i = 0; i < (size_t)height; ++i) {
-        pix = buf + i * stride;
-        for (j = 0; j < (size_t)width; ++j) {
-            // Convert rgba to argb
-            tmp = pix[2];
-            pix[2] = pix[0];
-            pix[0] = tmp;
-            pix += 4;
-        }
-    }
-}
-
 RendererAgg::RendererAgg(unsigned int width, unsigned int height, double dpi)
     : width(width),
       height(height),
diff --git a/src/_backend_agg.h b/src/_backend_agg.h
index 9f67c77eab64..c191f3448144 100644
--- a/src/_backend_agg.h
+++ b/src/_backend_agg.h
@@ -86,8 +86,6 @@ class BufferRegion
         return stride;
     }
 
-    void to_string_argb(uint8_t *buf);
-
   private:
     agg::int8u *data;
     agg::rect_i rect;
diff --git a/src/_backend_agg_wrapper.cpp b/src/_backend_agg_wrapper.cpp
index d4ce224d93c3..eaf4bf6f5f9d 100644
--- a/src/_backend_agg_wrapper.cpp
+++ b/src/_backend_agg_wrapper.cpp
@@ -44,18 +44,6 @@ static void PyBufferRegion_dealloc(PyBufferRegion *self)
     Py_TYPE(self)->tp_free((PyObject *)self);
 }
 
-static PyObject *PyBufferRegion_to_string(PyBufferRegion *self, PyObject *args)
-{
-    char const* msg =
-        "BufferRegion.to_string is deprecated since Matplotlib 3.7 and will "
-        "be removed two minor releases later; use np.asarray(region) instead.";
-    if (PyErr_WarnEx(PyExc_DeprecationWarning, msg, 1)) {
-        return NULL;
-    }
-    return PyBytes_FromStringAndSize((const char *)self->x->get_data(),
-                                     (Py_ssize_t) self->x->get_height() * self->x->get_stride());
-}
-
 /* TODO: This doesn't seem to be used internally.  Remove? */
 
 static PyObject *PyBufferRegion_set_x(PyBufferRegion *self, PyObject *args)
@@ -87,28 +75,6 @@ static PyObject *PyBufferRegion_get_extents(PyBufferRegion *self, PyObject *args
     return Py_BuildValue("IIII", rect.x1, rect.y1, rect.x2, rect.y2);
 }
 
-static PyObject *PyBufferRegion_to_string_argb(PyBufferRegion *self, PyObject *args)
-{
-    char const* msg =
-        "BufferRegion.to_string_argb is deprecated since Matplotlib 3.7 and "
-        "will be removed two minor releases later; use "
-        "np.take(region, [2, 1, 0, 3], axis=2) instead.";
-    if (PyErr_WarnEx(PyExc_DeprecationWarning, msg, 1)) {
-        return NULL;
-    }
-    PyObject *bufobj;
-    uint8_t *buf;
-    Py_ssize_t height, stride;
-    height = self->x->get_height();
-    stride = self->x->get_stride();
-    bufobj = PyBytes_FromStringAndSize(NULL, height * stride);
-    buf = (uint8_t *)PyBytes_AS_STRING(bufobj);
-
-    CALL_CPP_CLEANUP("to_string_argb", (self->x->to_string_argb(buf)), Py_DECREF(bufobj));
-
-    return bufobj;
-}
-
 int PyBufferRegion_get_buffer(PyBufferRegion *self, Py_buffer *buf, int flags)
 {
     Py_INCREF(self);
@@ -136,8 +102,6 @@ int PyBufferRegion_get_buffer(PyBufferRegion *self, Py_buffer *buf, int flags)
 static PyTypeObject *PyBufferRegion_init_type()
 {
     static PyMethodDef methods[] = {
-        { "to_string", (PyCFunction)PyBufferRegion_to_string, METH_NOARGS, NULL },
-        { "to_string_argb", (PyCFunction)PyBufferRegion_to_string_argb, METH_NOARGS, NULL },
         { "set_x", (PyCFunction)PyBufferRegion_set_x, METH_VARARGS, NULL },
         { "set_y", (PyCFunction)PyBufferRegion_set_y, METH_VARARGS, NULL },
         { "get_extents", (PyCFunction)PyBufferRegion_get_extents, METH_NOARGS, NULL },

From 302fd39a0fe373aa905e8c273b9f6d9f0020485a Mon Sep 17 00:00:00 2001
From: KheshavKumar <59756754+KheshavKumar@users.noreply.github.com>
Date: Wed, 6 Dec 2023 22:31:16 -0500
Subject: [PATCH 0499/1120] Added test for Axes.bar_label (#27431)

* Added test for Axes.bar_label

* Added test for Axes.bar_label after fixing typos

* Added test for Axes.bar_label after fixing typos

* Added test for Axes.bar_label after fixing typos

* Updated code based on review

* Update test_datetime.py

* removed the .show line and added bar_label back

* added bar_label, removed show, fixed linting issues

* Update lib/matplotlib/tests/test_datetime.py

Changed axs to ax

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>
---
 lib/matplotlib/tests/test_datetime.py | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index cec2fa891e80..529244c9656b 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -163,11 +163,20 @@ def test_bar(self):
         ax1.bar(x_dates, x_ranges, width=np.timedelta64(4, "D"))
         ax2.bar(np.arange(4), x_dates - x, bottom=x)
 
-    @pytest.mark.xfail(reason="Test for bar_label not written yet")
     @mpl.style.context("default")
     def test_bar_label(self):
-        fig, ax = plt.subplots()
-        ax.bar_label(...)
+        # Generate some example data with dateTime inputs
+        date_list = [datetime.datetime(2023, 1, 1) +
+                     datetime.timedelta(days=i) for i in range(5)]
+        values = [10, 20, 15, 25, 30]
+
+        # Creating the plot
+        fig, ax = plt.subplots(1, 1, figsize=(10, 8), layout='constrained')
+        bars = ax.bar(date_list, values)
+
+        # Add labels to the bars using bar_label
+        ax.bar_label(bars, labels=[f'{val}%' for val in values],
+                     label_type='edge', color='black')
 
     @mpl.style.context("default")
     def test_barbs(self):

From ea1b2df97b5b29ae65298ee73c2b92af5938ff58 Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@liu.se>
Date: Wed, 6 Dec 2023 16:03:47 +0100
Subject: [PATCH 0500/1120] Cleanup unit_cube-methods

---
 lib/mpl_toolkits/mplot3d/axes3d.py | 36 +++++-------------------------
 lib/mpl_toolkits/mplot3d/axis3d.py |  2 +-
 2 files changed, 7 insertions(+), 31 deletions(-)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index 84bbd763f882..da3d7906e2c0 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -225,9 +225,10 @@ def get_zaxis(self):
     get_zgridlines = _axis_method_wrapper("zaxis", "get_gridlines")
     get_zticklines = _axis_method_wrapper("zaxis", "get_ticklines")
 
-    def _unit_cube(self, vals=None):
-        minx, maxx, miny, maxy, minz, maxz = vals or self.get_w_lims()
-        return [(minx, miny, minz),
+    def _transformed_cube(self, vals):
+        """Return cube with limits from *vals* transformed by self.M."""
+        minx, maxx, miny, maxy, minz, maxz = vals
+        xyzs = [(minx, miny, minz),
                 (maxx, miny, minz),
                 (maxx, maxy, minz),
                 (minx, maxy, minz),
@@ -235,31 +236,7 @@ def _unit_cube(self, vals=None):
                 (maxx, miny, maxz),
                 (maxx, maxy, maxz),
                 (minx, maxy, maxz)]
-
-    def _tunit_cube(self, vals=None, M=None):
-        if M is None:
-            M = self.M
-        xyzs = self._unit_cube(vals)
-        tcube = proj3d._proj_points(xyzs, M)
-        return tcube
-
-    def _tunit_edges(self, vals=None, M=None):
-        tc = self._tunit_cube(vals, M)
-        edges = [(tc[0], tc[1]),
-                 (tc[1], tc[2]),
-                 (tc[2], tc[3]),
-                 (tc[3], tc[0]),
-
-                 (tc[0], tc[4]),
-                 (tc[1], tc[5]),
-                 (tc[2], tc[6]),
-                 (tc[3], tc[7]),
-
-                 (tc[4], tc[5]),
-                 (tc[5], tc[6]),
-                 (tc[6], tc[7]),
-                 (tc[7], tc[4])]
-        return edges
+        return proj3d._proj_points(xyzs, self.M)
 
     def set_aspect(self, aspect, adjustable=None, anchor=None, share=False):
         """
@@ -487,8 +464,7 @@ def draw(self, renderer):
         super().draw(renderer)
 
     def get_axis_position(self):
-        vals = self.get_w_lims()
-        tc = self._tunit_cube(vals, self.M)
+        tc = self._transformed_cube(self.get_w_lims())
         xhigh = tc[1][2] > tc[2][2]
         yhigh = tc[3][2] > tc[2][2]
         zhigh = tc[0][2] > tc[2][2]
diff --git a/lib/mpl_toolkits/mplot3d/axis3d.py b/lib/mpl_toolkits/mplot3d/axis3d.py
index dea831582288..7b738b705c2a 100644
--- a/lib/mpl_toolkits/mplot3d/axis3d.py
+++ b/lib/mpl_toolkits/mplot3d/axis3d.py
@@ -285,7 +285,7 @@ def _get_coord_info(self):
 
         # Project the bounds along the current position of the cube:
         bounds = mins[0], maxs[0], mins[1], maxs[1], mins[2], maxs[2]
-        bounds_proj = self.axes._tunit_cube(bounds, self.axes.M)
+        bounds_proj = self.axes._transformed_cube(bounds)
 
         # Determine which one of the parallel planes are higher up:
         means_z0 = np.zeros(3)

From dd19976c2d96e693a5b1b139900f5ab2114571ca Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Wed, 6 Dec 2023 16:08:14 -0500
Subject: [PATCH 0501/1120] TST: adding tests of current clear behavior on
 ticks

closes #23839
---
 lib/matplotlib/tests/test_axes.py | 40 +++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index d5424f80c9e9..37be1911d8e8 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -8898,3 +8898,43 @@ def test_axhvlinespan_interpolation():
     ax.axhline(1, c="C0", alpha=.5)
     ax.axhspan(.8, .9, fc="C1", alpha=.5)
     ax.axhspan(.6, .7, .8, .9, fc="C2", alpha=.5)
+
+
+@check_figures_equal(extensions=["png"])
+@pytest.mark.parametrize("which", ("x", "y"))
+def test_axes_clear_behavior(fig_ref, fig_test, which):
+    ax_test = fig_test.subplots()
+    ax_ref = fig_ref.subplots()
+    target = {
+        "direction": "in",
+        "length": 10,
+        "width": 10,
+        "color": "xkcd:wine red",
+        "pad": 0,
+        "labelfontfamily": "serif",
+        "zorder": 7,
+        "labelrotation": 45,
+        "labelcolor": "xkcd:shocking pink",
+        # this overrides color + labelcolor, skip
+        # colors: ,
+        "grid_color": "xkcd:fluorescent green",
+        "grid_alpha": 0.5,
+        "grid_linewidth": 3,
+        "grid_linestyle": ":",
+        "bottom": False,
+        "top": True,
+        "left": False,
+        "right": True,
+        "labelbottom": True,
+        "labeltop": True,
+        "labelleft": True,
+        "labelright": True,
+    }
+
+    ax_ref.tick_params(axis=which, **target)
+
+    ax_test.tick_params(axis=which, **target)
+    ax_test.clear()
+
+    ax_ref.grid(True)
+    ax_test.grid(True)

From 4e45a67c6a139a23a5c7e20faf595ec5331e4a20 Mon Sep 17 00:00:00 2001
From: Shriya Kalakata <shriyakalakata@10-18-248-97.dynapool.wireless.nyu.edu>
Date: Thu, 7 Dec 2023 17:49:30 -0500
Subject: [PATCH 0502/1120] Add test_eventplot to test_datetime.py

---
 lib/matplotlib/tests/test_datetime.py | 31 ++++++++++++++++++++++++---
 1 file changed, 28 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index b19124a1b764..54fd43bbb286 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -260,11 +260,36 @@ def test_errorbar(self):
                      uplims=True, xuplims=True,
                      label='Data')
 
-    @pytest.mark.xfail(reason="Test for eventplot not written yet")
     @mpl.style.context("default")
     def test_eventplot(self):
-        fig, ax = plt.subplots()
-        ax.eventplot(...)
+        mpl.rcParams["date.converter"] = "concise"
+
+        fig, (ax1, ax2) = plt.subplots(2, 1, layout="constrained")
+
+        x_dates1 = np.array([
+            datetime.datetime(2020, 6, 30),
+            datetime.datetime(2020, 7, 22),
+            datetime.datetime(2020, 8, 3),
+            datetime.datetime(2020, 9, 14),
+        ], dtype=np.datetime64)
+
+        ax1.eventplot(x_dates1)
+
+        x_dates2 = np.array([
+            [datetime.datetime(2020, 6, 30), datetime.datetime(2020, 7, 22),
+             datetime.datetime(2020, 8, 3), datetime.datetime(2020, 9, 14)],
+            [datetime.datetime(2020, 7, 18), datetime.datetime(2020, 7, 21),
+             datetime.datetime(2020, 8, 3), datetime.datetime(2020, 10, 14)]
+        ], dtype=np.datetime64)
+
+        colors = ['C{}'.format(i) for i in range(2)]
+        lineoffsets = np.array([1, 6])
+        linelengths = [5, 2]
+
+        ax2.eventplot(x_dates2,
+                      colors=colors,
+                      lineoffsets=lineoffsets,
+                      linelengths=linelengths)
 
     @pytest.mark.xfail(reason="Test for fill not written yet")
     @mpl.style.context("default")

From a676dce422688d5d9b52b0f6b5aceabb8a5a5fd3 Mon Sep 17 00:00:00 2001
From: Shriya Kalakata <shriyakalakata@Shriyas-MacBook-Pro.local>
Date: Thu, 7 Dec 2023 23:19:45 -0500
Subject: [PATCH 0503/1120] Modified test to check for input with varying
 lengths of data

---
 lib/matplotlib/tests/test_datetime.py | 43 ++++++++++++++-------------
 1 file changed, 22 insertions(+), 21 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 54fd43bbb286..11974d5782c4 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -266,30 +266,31 @@ def test_eventplot(self):
 
         fig, (ax1, ax2) = plt.subplots(2, 1, layout="constrained")
 
-        x_dates1 = np.array([
-            datetime.datetime(2020, 6, 30),
-            datetime.datetime(2020, 7, 22),
-            datetime.datetime(2020, 8, 3),
-            datetime.datetime(2020, 9, 14),
-        ], dtype=np.datetime64)
+        x_dates1 = np.array([datetime.datetime(2020, 6, 30),
+                             datetime.datetime(2020, 7, 22),
+                             datetime.datetime(2020, 8, 3),
+                             datetime.datetime(2020, 9, 14),],
+                            dtype=np.datetime64,
+                            )
 
         ax1.eventplot(x_dates1)
 
-        x_dates2 = np.array([
-            [datetime.datetime(2020, 6, 30), datetime.datetime(2020, 7, 22),
-             datetime.datetime(2020, 8, 3), datetime.datetime(2020, 9, 14)],
-            [datetime.datetime(2020, 7, 18), datetime.datetime(2020, 7, 21),
-             datetime.datetime(2020, 8, 3), datetime.datetime(2020, 10, 14)]
-        ], dtype=np.datetime64)
-
-        colors = ['C{}'.format(i) for i in range(2)]
-        lineoffsets = np.array([1, 6])
-        linelengths = [5, 2]
-
-        ax2.eventplot(x_dates2,
-                      colors=colors,
-                      lineoffsets=lineoffsets,
-                      linelengths=linelengths)
+        start_date = datetime.datetime(2020, 7, 1)
+        end_date = datetime.datetime(2020, 10, 15)
+        date_range = end_date - start_date
+
+        dates1 = start_date + np.random.rand(30) * date_range
+        dates2 = start_date + np.random.rand(10) * date_range
+        dates3 = start_date + np.random.rand(50) * date_range
+
+        colors1 = ['C1', 'C2', 'C3']
+        lineoffsets1 = np.array([1, 6, 8])
+        linelengths1 = [5, 2, 3]
+
+        ax2.eventplot([dates1, dates2, dates3],
+                      colors=colors1,
+                      lineoffsets=lineoffsets1,
+                      linelengths=linelengths1)
 
     @pytest.mark.xfail(reason="Test for fill not written yet")
     @mpl.style.context("default")

From bf397911866e825ea80248e896bacdec3bfb07c4 Mon Sep 17 00:00:00 2001
From: Shriya Kalakata <shriyakalakata123@gmail.com>
Date: Fri, 8 Dec 2023 00:47:51 -0500
Subject: [PATCH 0504/1120] Set random seed

---
 lib/matplotlib/tests/test_datetime.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 11974d5782c4..cf5bd82d2223 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -275,6 +275,8 @@ def test_eventplot(self):
 
         ax1.eventplot(x_dates1)
 
+        np.random.seed(19680801)
+
         start_date = datetime.datetime(2020, 7, 1)
         end_date = datetime.datetime(2020, 10, 15)
         date_range = end_date - start_date

From 60a21233dacb22315daffcae1addf9b52853cc82 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 8 Dec 2023 00:29:36 -0500
Subject: [PATCH 0505/1120] Fix test visualization tool for non-PNG files

For non-PNG files, our test diffing code creates a failed diff with a
suffix of `_{ext}-failed-diff.png`, but the expected image has a suffix
of `-expected_{ext}.png`. The test visualization was not correctly
handling this difference.
---
 tools/triage_tests.py    |  2 +-
 tools/visualize_tests.py | 33 ++++++++++++++++++++++++---------
 2 files changed, 25 insertions(+), 10 deletions(-)

diff --git a/tools/triage_tests.py b/tools/triage_tests.py
index d44d6fd743ea..5153b1c712cb 100644
--- a/tools/triage_tests.py
+++ b/tools/triage_tests.py
@@ -241,7 +241,7 @@ def __init__(self, path, root, source):
             if basename.endswith(f'_{ext}'):
                 display_extension = f'_{ext}'
                 extension = ext
-                basename = basename[:-4]
+                basename = basename[:-len(display_extension)]
                 break
         else:
             display_extension = ''
diff --git a/tools/visualize_tests.py b/tools/visualize_tests.py
index 5ff3e0add97b..72948d67fb1f 100644
--- a/tools/visualize_tests.py
+++ b/tools/visualize_tests.py
@@ -10,6 +10,8 @@
 import os
 from collections import defaultdict
 
+# Non-png image extensions
+NON_PNG_EXTENSIONS = ['pdf', 'svg', 'eps']
 
 html_template = """<html><head><style media="screen" type="text/css">
 img{{
@@ -68,28 +70,41 @@ def run(show_browser=True):
             fn, fext = os.path.splitext(file)
             if fext != ".png":
                 continue
-            # Always use / for URLs.
             if "-failed-diff" in fn:
-                pictures[fn[:-12]]["f"] = "/".join((subdir, file))
+                file_type = 'diff'
+                test_name = fn[:-len('-failed-diff')]
             elif "-expected" in fn:
-                pictures[fn[:-9]]["e"] = "/".join((subdir, file))
+                for ext in NON_PNG_EXTENSIONS:
+                    if fn.endswith(f'_{ext}'):
+                        display_extension = f'_{ext}'
+                        extension = ext
+                        fn = fn[:-len(display_extension)]
+                        break
+                else:
+                    display_extension = ''
+                    extension = 'png'
+                file_type = 'expected'
+                test_name = fn[:-len('-expected')] + display_extension
             else:
-                pictures[fn]["c"] = "/".join((subdir, file))
+                file_type = 'actual'
+                test_name = fn
+            # Always use / for URLs.
+            pictures[test_name][file_type] = '/'.join((subdir, file))
 
         subdir_rows = []
         for name, test in sorted(pictures.items()):
-            expected_image = test.get('e', '')
-            actual_image = test.get('c', '')
+            expected_image = test.get('expected', '')
+            actual_image = test.get('actual', '')
 
-            if 'f' in test:
+            if 'diff' in test:
                 # A real failure in the image generation, resulting in
                 # different images.
                 status = " (failed)"
-                failed = f'<a href="{test["f"]}">diff</a>'
+                failed = f'<a href="{test["diff"]}">diff</a>'
                 current = linked_image_template.format(actual_image)
                 failed_rows.append(row_template.format(name, "", current,
                                                        expected_image, failed))
-            elif 'c' not in test:
+            elif 'actual' not in test:
                 # A failure in the test, resulting in no current image
                 status = " (failed)"
                 failed = '--'

From e771206d4cc04683dda9f8f92a489fd3db1ab670 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 8 Dec 2023 00:49:55 -0500
Subject: [PATCH 0506/1120] TST: Make test image visualization valid HTML5

---
 tools/visualize_tests.py | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/tools/visualize_tests.py b/tools/visualize_tests.py
index 72948d67fb1f..9cff44cd72d1 100644
--- a/tools/visualize_tests.py
+++ b/tools/visualize_tests.py
@@ -13,7 +13,11 @@
 # Non-png image extensions
 NON_PNG_EXTENSIONS = ['pdf', 'svg', 'eps']
 
-html_template = """<html><head><style media="screen" type="text/css">
+html_template = """<!DOCTYPE html>
+<html lang="en"><head>
+<meta charset="utf-8">
+<title>Matplotlib test result visualization</title>
+<style media="screen">
 img{{
   width:100%;
   max-width:800px;
@@ -26,14 +30,18 @@
 """
 
 subdir_template = """<h2>{subdir}</h2><table>
-<thead><td>name</td><td>actual</td><td>expected</td><td>diff</td></thead>
+<thead><tr><th>name</th><th>actual</th><th>expected</th><th>diff</th></tr></thead>
+<tbody>
 {rows}
+</tbody>
 </table>
 """
 
 failed_template = """<h2>Only Failed</h2><table>
-<thead><td>name</td><td>actual</td><td>expected</td><td>diff</td></thead>
+<thead><tr><th>name</th><th>actual</th><th>expected</th><th>diff</th></tr></thead>
+<tbody>
 {rows}
+</tbody>
 </table>
 """
 

From eaa62624780024cb4c9292416387545f25d00a36 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Fri, 8 Dec 2023 02:11:15 -0500
Subject: [PATCH 0507/1120] Document visualizing_tests tool.

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>
---
 doc/devel/testing.rst                 | 25 ++++++++++++++++++++++++-
 doc/users/installing/dependencies.rst |  2 ++
 2 files changed, 26 insertions(+), 1 deletion(-)

diff --git a/doc/devel/testing.rst b/doc/devel/testing.rst
index 7a11c7c3eb18..500890680e02 100644
--- a/doc/devel/testing.rst
+++ b/doc/devel/testing.rst
@@ -59,6 +59,23 @@ not need to be installed, but Matplotlib should be)::
 
 .. _command-line parameters: http://doc.pytest.org/en/latest/usage.html
 
+Viewing image test output
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The output of :ref:`image-based <image-comparison>` tests is stored in a
+``result_images`` directory. These images can be compiled into one HTML page, containing
+hundreds of images, using the ``visualize_tests`` tool::
+
+    python tools/visualize_tests.py
+
+Image test failures can also be analysed using the ``triage_tests`` tool::
+
+    python tools/triage_tests.py
+
+The triage tool allows you to accept or reject test failures and will copy the new image
+to the folder where the baseline test images are stored. The triage tool requires that
+:ref:`QT <backend_dependencies>` is installed.
+
 
 Writing a simple test
 ---------------------
@@ -94,7 +111,9 @@ For numpy's default random number generator use::
 
 and then use ``rng`` when generating the random numbers.
 
-The seed is John Hunter's birthday.
+The seed is :ref:`John Hunter's <project_history>` birthday.
+
+.. _image-comparison:
 
 Writing an image comparison test
 --------------------------------
@@ -128,6 +147,10 @@ texts (labels, tick labels, etc) are not really part of what is tested, use
 ``remove_text=True`` as this will lead to smaller figures and reduce possible
 issues with font mismatch on different platforms.
 
+
+Compare two methods of creating an image
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
 Baseline images take a lot of space in the Matplotlib repository.
 An alternative approach for image comparison tests is to use the
 `~matplotlib.testing.decorators.check_figures_equal` decorator, which should be
diff --git a/doc/users/installing/dependencies.rst b/doc/users/installing/dependencies.rst
index ce83454db08a..0e81ff25fefe 100644
--- a/doc/users/installing/dependencies.rst
+++ b/doc/users/installing/dependencies.rst
@@ -41,6 +41,8 @@ Optional
 The following packages and tools are not required but extend the capabilities
 of Matplotlib.
 
+.. _backend_dependencies:
+
 Backends
 ^^^^^^^^
 

From a2a28093ba836366e7ff0c6f1edb4fd98b47a04d Mon Sep 17 00:00:00 2001
From: ConstableCatnip <38230539+ConstableCatnip@users.noreply.github.com>
Date: Fri, 8 Dec 2023 13:28:43 -0700
Subject: [PATCH 0508/1120] Added smoke test for Axes.matshow to
 test_datetime.py (#27474)

---
 lib/matplotlib/tests/test_datetime.py | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 529244c9656b..3c8cc8b5b8bb 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -542,11 +542,16 @@ def test_loglog(self):
         fig, ax = plt.subplots()
         ax.loglog(...)
 
-    @pytest.mark.xfail(reason="Test for matshow not written yet")
     @mpl.style.context("default")
     def test_matshow(self):
+        a = np.diag(range(5))
+        dt_start = datetime.datetime(1980, 4, 15)
+        dt_end = datetime.datetime(2020, 11, 11)
+        extent = (dt_start, dt_end, dt_start, dt_end)
         fig, ax = plt.subplots()
-        ax.matshow(...)
+        ax.matshow(a, extent=extent)
+        for label in ax.get_xticklabels():
+            label.set_rotation(90)
 
     @pytest.mark.xfail(reason="Test for pcolor not written yet")
     @mpl.style.context("default")

From 3c6d39d489513036b311c83f9b5893e4cbc0b8aa Mon Sep 17 00:00:00 2001
From: ConstableCatnip <38230539+ConstableCatnip@users.noreply.github.com>
Date: Fri, 8 Dec 2023 21:38:18 +0000
Subject: [PATCH 0509/1120] Added smoke test for Axes.imshow to
 test_datetime.py

---
 lib/matplotlib/tests/test_datetime.py | 40 +++++++++++++++++++++++++--
 1 file changed, 37 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 529244c9656b..77ec67bfb179 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -530,11 +530,45 @@ def test_hlines(self):
                          xmin=0.45,
                          xmax=0.65)
 
-    @pytest.mark.xfail(reason="Test for imshow not written yet")
     @mpl.style.context("default")
     def test_imshow(self):
-        fig, ax = plt.subplots()
-        ax.imshow(...)
+        mpl.rcParams["date.converter"] = "concise"
+        a = np.diag(range(5))
+        fig, axes = plt.subplots(nrows=2, ncols=2)
+
+        ax = axes[0, 0]
+        dt_start = datetime.datetime(1980, 4, 15)
+        dt_end = datetime.datetime(2010, 11, 11)
+        extent = (dt_start, dt_end, dt_start, dt_end)
+        ax.imshow(a, extent=extent)
+        for label in ax.get_xticklabels():
+            label.set_rotation(90)
+
+        ax = axes[0, 1]
+        dt_start = datetime.datetime(2010, 4, 15)
+        dt_end = datetime.datetime(2010, 11, 11)
+        extent = (dt_start, dt_end, dt_start, dt_end)
+        ax.imshow(a, extent=extent)
+        for label in ax.get_xticklabels():
+            label.set_rotation(90)
+
+        ax = axes[1, 0]
+        dt_start = datetime.datetime(2010, 11, 1)
+        dt_end = datetime.datetime(2010, 11, 11)
+        extent = (dt_start, dt_end, dt_start, dt_end)
+        ax.imshow(a, extent=extent)
+        for label in ax.get_xticklabels():
+            label.set_rotation(90)
+
+        ax = axes[1, 1]
+        dt_start = datetime.datetime(2010, 11, 10)
+        dt_end = datetime.datetime(2010, 11, 11)
+        extent = (dt_start, dt_end, dt_start, dt_end)
+        ax.imshow(a, extent=extent)
+        for label in ax.get_xticklabels():
+            label.set_rotation(90)
+
+        fig.tight_layout()
 
     @pytest.mark.xfail(reason="Test for loglog not written yet")
     @mpl.style.context("default")

From f55957e2d6d46eaefb520f16cc1bfa616a087e5e Mon Sep 17 00:00:00 2001
From: Shriya Kalakata <shriyakalakata123@gmail.com>
Date: Fri, 8 Dec 2023 18:04:33 -0500
Subject: [PATCH 0510/1120] Added third test for Axes.eventplot

---
 lib/matplotlib/tests/test_datetime.py | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index cf5bd82d2223..0b6ac467a062 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -264,7 +264,7 @@ def test_errorbar(self):
     def test_eventplot(self):
         mpl.rcParams["date.converter"] = "concise"
 
-        fig, (ax1, ax2) = plt.subplots(2, 1, layout="constrained")
+        fig, (ax1, ax2, ax3) = plt.subplots(3, 1, layout="constrained")
 
         x_dates1 = np.array([datetime.datetime(2020, 6, 30),
                              datetime.datetime(2020, 7, 22),
@@ -294,6 +294,17 @@ def test_eventplot(self):
                       lineoffsets=lineoffsets1,
                       linelengths=linelengths1)
 
+        lineoffsets2 = np.array([
+            datetime.datetime(2020, 7, 1),
+            datetime.datetime(2020, 7, 15),
+            datetime.datetime(2020, 8, 1)
+        ], dtype=np.datetime64)
+
+        ax3.eventplot([dates1, dates2, dates3],
+                      colors=colors1,
+                      lineoffsets=lineoffsets2,
+                      linelengths=linelengths1)
+
     @pytest.mark.xfail(reason="Test for fill not written yet")
     @mpl.style.context("default")
     def test_fill(self):

From 6c2b5ad54bd0ee1e0cef49c7a8c239c2cf0cadb2 Mon Sep 17 00:00:00 2001
From: Shriya Kalakata <shriyakalakata123@gmail.com>
Date: Sat, 9 Dec 2023 01:36:42 -0500
Subject: [PATCH 0511/1120] Fixing pylab documentation in API interface
 overview

---
 galleries/users_explain/figure/api_interfaces.rst | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/galleries/users_explain/figure/api_interfaces.rst b/galleries/users_explain/figure/api_interfaces.rst
index 6947817e6781..5279fe24634a 100644
--- a/galleries/users_explain/figure/api_interfaces.rst
+++ b/galleries/users_explain/figure/api_interfaces.rst
@@ -285,6 +285,11 @@ Appendix: "pylab" interface
 ---------------------------
 
 There is one further interface that is highly discouraged, and that is to
-basically do ``from matplotlib.pyplot import *``.  This allows users to simply
-call ``plot(x, y)``.  While convenient, this can lead to obvious problems if the
-user unwittingly names a variable the same name as a pyplot method.
+basically do ``from matplotlib.pylab import *``. This imports all the
+functions from ``matplotlib.pyplot``, ``numpy``, ``numpy.fft``, ``numpy.linalg``, and
+``numpy.random``, and some additional functions into the global namespace.
+
+Such a pattern is considered bad practice in modern python, as it clutters
+the global namespace. Even more severely, in the case of ``pylab``, this will
+overwrite some builtin functions (e.g. the builtin ``sum`` will be replaced by
+``numpy.sum``), which can lead to unexpected behavior.

From 978fd773822ebf4684d2df31b6ec8c34c217f671 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Mon, 6 Nov 2023 23:26:09 -0500
Subject: [PATCH 0512/1120] add collection-fontsrecommended to dependencies

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>
---
 doc/users/installing/dependencies.rst | 22 +++++++++++++---------
 1 file changed, 13 insertions(+), 9 deletions(-)

diff --git a/doc/users/installing/dependencies.rst b/doc/users/installing/dependencies.rst
index ce83454db08a..f063dfe7d414 100644
--- a/doc/users/installing/dependencies.rst
+++ b/doc/users/installing/dependencies.rst
@@ -397,28 +397,32 @@ External tools
 --------------
 
 The documentation requires LaTeX and Graphviz.  These are not
-Python packages and must be installed separately. The documentation can be
-built without Inkscape and optipng, but the build process will raise various
-warnings. If the build process warns that you are missing fonts, make sure
-your LaTeX distribution bundles cm-super or install it separately.
+Python packages and must be installed separately.
 
 Required
 ^^^^^^^^
 
 * `Graphviz <http://www.graphviz.org/download>`_
-* a minimal working LaTeX distribution, e.g., `TeX Live <https://www.tug.org/texlive/>`_ or
+* a minimal working LaTeX distribution, e.g. `TeX Live <https://www.tug.org/texlive/>`_ or
   `MikTeX <https://miktex.org/>`_
-* the following LaTeX packages (if your OS bundles TeX Live, the
-  "complete" version of the installer, e.g. "texlive-full" or "texlive-all",
-  will often automatically include these packages):
 
-  * `cm-super <https://ctan.org/pkg/cm-super>`_
+The following LaTeX packages:
+
   * `dvipng <https://ctan.org/pkg/dvipng>`_
   * `underscore <https://ctan.org/pkg/underscore>`_
+  * `cm-super <https://ctan.org/pkg/cm-super>`_
+  * ``collection-fontsrecommended``
+
+The complete version of many LaTex distribution installers, e.g.
+"texlive-full" or "texlive-all", will often automatically include these packages.
+
 
 Optional
 ^^^^^^^^
 
+The documentation can be built without Inkscape and optipng, but the build
+process will raise various warnings.
+
 * `Inkscape <https://inkscape.org>`_
 * `optipng <http://optipng.sourceforge.net>`_
 * the font `xkcd script <https://github.com/ipython/xkcd-font/>`_ or `Comic Neue <http://comicneue.com/>`_

From 9dbe278739af32f32a28b0da23e7f3734e1d7522 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Wed, 17 May 2023 22:45:55 +0200
Subject: [PATCH 0513/1120] Use annotate coordinate systems to simplify
 label_subplots.

The ability of annotate to specify various coordinates systems
simplifies label_subplots, by avoiding the need to explicitly construct
a ScaledTranslation (while maintaining exact functionality parity).
---
 .../label_subplots.py                         | 61 ++++++++++---------
 1 file changed, 32 insertions(+), 29 deletions(-)

diff --git a/galleries/examples/text_labels_and_annotations/label_subplots.py b/galleries/examples/text_labels_and_annotations/label_subplots.py
index fd66d46a5b52..2b71ddf26abf 100644
--- a/galleries/examples/text_labels_and_annotations/label_subplots.py
+++ b/galleries/examples/text_labels_and_annotations/label_subplots.py
@@ -3,46 +3,51 @@
 Labelling subplots
 ==================
 
-Labelling subplots is relatively straightforward, and varies,
-so Matplotlib does not have a general method for doing this.
+Labelling subplots is relatively straightforward, and varies, so Matplotlib
+does not have a general method for doing this.
 
-Simplest is putting the label inside the axes.  Note, here
-we use `.pyplot.subplot_mosaic`, and use the subplot labels
-as keys for the subplots, which is a nice convenience.  However,
-the same method works with `.pyplot.subplots` or keys that are
-different than what you want to label the subplot with.
+We showcase two methods to position text at a given physical offset (in
+fontsize units or in points) away from a corner of the Axes: one using
+`~.Axes.annotate`, and one using `.ScaledTranslation`.
+
+For convenience, this example uses `.pyplot.subplot_mosaic` and subplot
+labels as keys for the subplots.  However, the approach also works with
+`.pyplot.subplots` or keys that are different than what you want to label the
+subplot with.
 """
 
 import matplotlib.pyplot as plt
 
-import matplotlib.transforms as mtransforms
+from matplotlib.transforms import ScaledTranslation
 
+# %%
 fig, axs = plt.subplot_mosaic([['a)', 'c)'], ['b)', 'c)'], ['d)', 'd)']],
                               layout='constrained')
-
 for label, ax in axs.items():
-    # label physical distance in and down:
-    trans = mtransforms.ScaledTranslation(10/72, -5/72, fig.dpi_scale_trans)
-    ax.text(0.0, 1.0, label, transform=ax.transAxes + trans,
-            fontsize='medium', verticalalignment='top', fontfamily='serif',
-            bbox=dict(facecolor='0.7', edgecolor='none', pad=3.0))
-
-plt.show()
+    # Use Axes.annotate to put the label
+    # - at the top left corner (axes fraction (0, 1)),
+    # - offset half-a-fontsize right and half-a-fontsize down
+    #   (offset fontsize (+0.5, -0.5)),
+    # i.e. just inside the axes.
+    ax.annotate(
+        label,
+        xy=(0, 1), xycoords='axes fraction',
+        xytext=(+0.5, -0.5), textcoords='offset fontsize',
+        fontsize='medium', verticalalignment='top', fontfamily='serif',
+        bbox=dict(facecolor='0.7', edgecolor='none', pad=3.0))
 
 # %%
-# We may prefer the labels outside the axes, but still aligned
-# with each other, in which case we use a slightly different transform:
-
 fig, axs = plt.subplot_mosaic([['a)', 'c)'], ['b)', 'c)'], ['d)', 'd)']],
                               layout='constrained')
-
 for label, ax in axs.items():
-    # label physical distance to the left and up:
-    trans = mtransforms.ScaledTranslation(-20/72, 7/72, fig.dpi_scale_trans)
-    ax.text(0.0, 1.0, label, transform=ax.transAxes + trans,
-            fontsize='medium', va='bottom', fontfamily='serif')
-
-plt.show()
+    # Use ScaledTranslation to put the label
+    # - at the top left corner (axes fraction (0, 1)),
+    # - offset 20 pixels left and 7 pixels up (offset points (-20, +7)),
+    # i.e. just outside the axes.
+    ax.text(
+        0.0, 1.0, label, transform=(
+            ax.transAxes + ScaledTranslation(-20/72, +7/72, fig.dpi_scale_trans)),
+        fontsize='medium', va='bottom', fontfamily='serif')
 
 # %%
 # If we want it aligned with the title, either incorporate in the title or
@@ -50,7 +55,6 @@
 
 fig, axs = plt.subplot_mosaic([['a)', 'c)'], ['b)', 'c)'], ['d)', 'd)']],
                               layout='constrained')
-
 for label, ax in axs.items():
     ax.set_title('Normal Title', fontstyle='italic')
     ax.set_title(label, fontfamily='serif', loc='left', fontsize='medium')
@@ -67,5 +71,4 @@
 #    - `matplotlib.figure.Figure.subplot_mosaic` /
 #      `matplotlib.pyplot.subplot_mosaic`
 #    - `matplotlib.axes.Axes.set_title`
-#    - `matplotlib.axes.Axes.text`
-#    - `matplotlib.transforms.ScaledTranslation`
+#    - `matplotlib.axes.Axes.annotate`

From e0f5b239bedd0f8b367970081b5eac1530348aa5 Mon Sep 17 00:00:00 2001
From: ConstableCatnip <38230539+ConstableCatnip@users.noreply.github.com>
Date: Mon, 11 Dec 2023 17:34:54 +0000
Subject: [PATCH 0514/1120] Updates based on suggestions. By constraining the
 date range to a few days, the axes labels now look like dates instead of just
 the year.

---
 lib/matplotlib/tests/test_datetime.py | 34 ++-------------------------
 1 file changed, 2 insertions(+), 32 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 77ec67bfb179..07711644a85d 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -532,43 +532,13 @@ def test_hlines(self):
 
     @mpl.style.context("default")
     def test_imshow(self):
-        mpl.rcParams["date.converter"] = "concise"
+        fig, ax = plt.subplots()
         a = np.diag(range(5))
-        fig, axes = plt.subplots(nrows=2, ncols=2)
-
-        ax = axes[0, 0]
-        dt_start = datetime.datetime(1980, 4, 15)
-        dt_end = datetime.datetime(2010, 11, 11)
-        extent = (dt_start, dt_end, dt_start, dt_end)
-        ax.imshow(a, extent=extent)
-        for label in ax.get_xticklabels():
-            label.set_rotation(90)
-
-        ax = axes[0, 1]
-        dt_start = datetime.datetime(2010, 4, 15)
-        dt_end = datetime.datetime(2010, 11, 11)
-        extent = (dt_start, dt_end, dt_start, dt_end)
-        ax.imshow(a, extent=extent)
-        for label in ax.get_xticklabels():
-            label.set_rotation(90)
-
-        ax = axes[1, 0]
         dt_start = datetime.datetime(2010, 11, 1)
         dt_end = datetime.datetime(2010, 11, 11)
         extent = (dt_start, dt_end, dt_start, dt_end)
         ax.imshow(a, extent=extent)
-        for label in ax.get_xticklabels():
-            label.set_rotation(90)
-
-        ax = axes[1, 1]
-        dt_start = datetime.datetime(2010, 11, 10)
-        dt_end = datetime.datetime(2010, 11, 11)
-        extent = (dt_start, dt_end, dt_start, dt_end)
-        ax.imshow(a, extent=extent)
-        for label in ax.get_xticklabels():
-            label.set_rotation(90)
-
-        fig.tight_layout()
+        ax.tick_params(axis="x", labelrotation=90)
 
     @pytest.mark.xfail(reason="Test for loglog not written yet")
     @mpl.style.context("default")

From 6511483e7015eb728325a17533789b4377d8d37c Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 11 Dec 2023 19:47:09 +0000
Subject: [PATCH 0515/1120] Bump actions/setup-python from 4 to 5

Bumps [actions/setup-python](https://github.com/actions/setup-python) from 4 to 5.
- [Release notes](https://github.com/actions/setup-python/releases)
- [Commits](https://github.com/actions/setup-python/compare/v4...v5)

---
updated-dependencies:
- dependency-name: actions/setup-python
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 .github/workflows/cibuildwheel.yml    | 2 +-
 .github/workflows/codeql-analysis.yml | 2 +-
 .github/workflows/mypy-stubtest.yml   | 2 +-
 .github/workflows/reviewdog.yml       | 4 ++--
 .github/workflows/tests.yml           | 2 +-
 5 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index af733ff04502..23c05a7629d0 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -43,7 +43,7 @@ jobs:
         with:
           fetch-depth: 0
 
-      - uses: actions/setup-python@v4
+      - uses: actions/setup-python@v5
         name: Install Python
         with:
           python-version: 3.9
diff --git a/.github/workflows/codeql-analysis.yml b/.github/workflows/codeql-analysis.yml
index 5753b17922d6..b90d6b1f12c2 100644
--- a/.github/workflows/codeql-analysis.yml
+++ b/.github/workflows/codeql-analysis.yml
@@ -29,7 +29,7 @@ jobs:
         uses: actions/checkout@v4
 
       - name: Set up Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         if: matrix.language != 'javascript'
         with:
           python-version: '3.x'
diff --git a/.github/workflows/mypy-stubtest.yml b/.github/workflows/mypy-stubtest.yml
index 8d2943e38ecf..f042688feb62 100644
--- a/.github/workflows/mypy-stubtest.yml
+++ b/.github/workflows/mypy-stubtest.yml
@@ -14,7 +14,7 @@ jobs:
       - uses: actions/checkout@v4
 
       - name: Set up Python 3
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: 3.9
 
diff --git a/.github/workflows/reviewdog.yml b/.github/workflows/reviewdog.yml
index f9c1121581c0..f4495eda8b84 100644
--- a/.github/workflows/reviewdog.yml
+++ b/.github/workflows/reviewdog.yml
@@ -15,7 +15,7 @@ jobs:
       - uses: actions/checkout@v4
 
       - name: Set up Python 3
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: 3.9
 
@@ -45,7 +45,7 @@ jobs:
       - uses: actions/checkout@v4
 
       - name: Set up Python 3
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: 3.9
 
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 7f2e3266cb19..6058383c5aa0 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -97,7 +97,7 @@ jobs:
           fetch-depth: 0
 
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
 

From f1aa13abc347c29a7234811d307d8632664eb519 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Mon, 11 Dec 2023 21:35:21 +0100
Subject: [PATCH 0516/1120] Clarify that set_axisbelow doesn't move grids below
 images.

Even axisbelow(True) sets the grid zorder to 0.5, which is still over
images (zorder 0).  One may want to have grids *below* images if the
image's extent doesn't cover the whole axes limits (e.g. the image only
occupies the top left corner of the Axes and one wants to draw gridlines
on the rest but keep them below the image otherwise).
---
 lib/matplotlib/axes/_base.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index b113b0f21156..a0da0906eeb5 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -3157,13 +3157,18 @@ def set_axisbelow(self, b):
         b : bool or 'line'
             Possible values:
 
-            - *True* (zorder = 0.5): Ticks and gridlines are below all Artists.
+            - *True* (zorder = 0.5): Ticks and gridlines are below patches and
+              lines, though still above images.
             - 'line' (zorder = 1.5): Ticks and gridlines are above patches
               (e.g. rectangles, with default zorder = 1) but still below lines
               and markers (with their default zorder = 2).
             - *False* (zorder = 2.5): Ticks and gridlines are above patches
               and lines / markers.
 
+        Notes
+        -----
+        For more control, call the `~.Artist.set_zorder` method of each axis.
+
         See Also
         --------
         get_axisbelow

From 8470189d7c609fd2f31f884a0f9b9f847d422961 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Mon, 4 Dec 2023 15:21:00 +0100
Subject: [PATCH 0517/1120] Fix semantics of MEP22 image names.

See writeup in changelog note.
---
 .../next_api_changes/behavior/27492-AL.rst    | 12 +++++
 lib/matplotlib/backend_bases.py               | 49 ++++++++++++++-----
 lib/matplotlib/backend_tools.py               | 28 ++++++-----
 3 files changed, 65 insertions(+), 24 deletions(-)
 create mode 100644 doc/api/next_api_changes/behavior/27492-AL.rst

diff --git a/doc/api/next_api_changes/behavior/27492-AL.rst b/doc/api/next_api_changes/behavior/27492-AL.rst
new file mode 100644
index 000000000000..98a4900fa67d
--- /dev/null
+++ b/doc/api/next_api_changes/behavior/27492-AL.rst
@@ -0,0 +1,12 @@
+Image path semantics of toolmanager-based tools
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Previously, MEP22 ("toolmanager-based") Tools would try to load their icon
+(``tool.image``) relative to the current working directory, or, as a fallback,
+from Matplotlib's own image directory.  Because both approaches are problematic
+for third-party tools (the end-user may change the current working directory
+at any time, and third-parties cannot add new icons in Matplotlib's image
+directory), this behavior is deprecated; instead, ``tool.image`` is now
+interpreted relative to the directory containing the source file where the
+``Tool.image`` class attribute is defined.  (Defining ``tool.image`` as an
+absolute path also works and is compatible with both the old and the new
+semantics.)
diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
index fd055fd7015d..588ac995a034 100644
--- a/lib/matplotlib/backend_bases.py
+++ b/lib/matplotlib/backend_bases.py
@@ -35,6 +35,7 @@
 import itertools
 import logging
 import os
+import pathlib
 import signal
 import socket
 import sys
@@ -3284,7 +3285,7 @@ def add_tool(self, tool, group, position=-1):
             The position within the group to place this tool.
         """
         tool = self.toolmanager.get_tool(tool)
-        image = self._get_image_filename(tool.image)
+        image = self._get_image_filename(tool)
         toggle = getattr(tool, 'toggled', None) is not None
         self.add_toolitem(tool.name, group, position,
                           image, tool.description, toggle)
@@ -3295,20 +3296,44 @@ def add_tool(self, tool, group, position=-1):
             if tool.toggled:
                 self.toggle_toolitem(tool.name, True)
 
-    def _get_image_filename(self, image):
-        """Find the image based on its name."""
-        if not image:
+    def _get_image_filename(self, tool):
+        """Resolve a tool icon's filename."""
+        if not tool.image:
             return None
-
-        basedir = cbook._get_data_path("images")
-        for fname in [
-            image,
-            image + self._icon_extension,
-            str(basedir / image),
-            str(basedir / (image + self._icon_extension)),
+        if os.path.isabs(tool.image):
+            filename = tool.image
+        else:
+            if "image" in getattr(tool, "__dict__", {}):
+                raise ValueError("If 'tool.image' is an instance variable, "
+                                 "it must be an absolute path")
+            for cls in type(tool).__mro__:
+                if "image" in vars(cls):
+                    try:
+                        src = inspect.getfile(cls)
+                        break
+                    except (OSError, TypeError):
+                        raise ValueError("Failed to locate source file "
+                                         "where 'tool.image' is defined") from None
+            else:
+                raise ValueError("Failed to find parent class defining 'tool.image'")
+            filename = str(pathlib.Path(src).parent / tool.image)
+        for filename in [filename, filename + self._icon_extension]:
+            if os.path.isfile(filename):
+                return os.path.abspath(filename)
+        for fname in [  # Fallback; once deprecation elapses.
+            tool.image,
+            tool.image + self._icon_extension,
+            cbook._get_data_path("images", tool.image),
+            cbook._get_data_path("images", tool.image + self._icon_extension),
         ]:
             if os.path.isfile(fname):
-                return fname
+                _api.warn_deprecated(
+                    "3.9", message=f"Loading icon {tool.image!r} from the current "
+                    "directory or from Matplotlib's image directory.  This behavior "
+                    "is deprecated since %(since)s and will be removed %(removal)s; "
+                    "Tool.image should be set to a path relative to the Tool's source "
+                    "file, or to an absolute path.")
+                return os.path.abspath(fname)
 
     def trigger_tool(self, name):
         """
diff --git a/lib/matplotlib/backend_tools.py b/lib/matplotlib/backend_tools.py
index ac2a20f1ffa9..a9daa0c4b400 100644
--- a/lib/matplotlib/backend_tools.py
+++ b/lib/matplotlib/backend_tools.py
@@ -97,10 +97,14 @@ class ToolBase:
 
     image = None
     """
-    Filename of the image.
-
-    `str`: Filename of the image to use in a Toolbar.  If None, the *name* is
-    used as a label in the toolbar button.
+    Icon filename.
+
+    ``str | None``: Filename of the Toolbar icon; either absolute, or
+    relative to the directory containing the Python source file where the
+    ``Tool.image``class attribute is defined (in the latter case, this cannot
+    be defined as an instance attribute).  In either case, the extension is
+    optional; leaving it off lets individual backends select the icon format
+    they prefer.  If None, the *name* is used as a label in the toolbar button.
     """
 
     def __init__(self, toolmanager, name):
@@ -601,7 +605,7 @@ class ToolHome(ViewsPositionsBase):
     """Restore the original view limits."""
 
     description = 'Reset original view'
-    image = 'home'
+    image = 'mpl-data/images/home'
     default_keymap = property(lambda self: mpl.rcParams['keymap.home'])
     _on_trigger = 'home'
 
@@ -610,7 +614,7 @@ class ToolBack(ViewsPositionsBase):
     """Move back up the view limits stack."""
 
     description = 'Back to previous view'
-    image = 'back'
+    image = 'mpl-data/images/back'
     default_keymap = property(lambda self: mpl.rcParams['keymap.back'])
     _on_trigger = 'back'
 
@@ -619,7 +623,7 @@ class ToolForward(ViewsPositionsBase):
     """Move forward in the view lim stack."""
 
     description = 'Forward to next view'
-    image = 'forward'
+    image = 'mpl-data/images/forward'
     default_keymap = property(lambda self: mpl.rcParams['keymap.forward'])
     _on_trigger = 'forward'
 
@@ -628,14 +632,14 @@ class ConfigureSubplotsBase(ToolBase):
     """Base tool for the configuration of subplots."""
 
     description = 'Configure subplots'
-    image = 'subplots'
+    image = 'mpl-data/images/subplots'
 
 
 class SaveFigureBase(ToolBase):
     """Base tool for figure saving."""
 
     description = 'Save the figure'
-    image = 'filesave'
+    image = 'mpl-data/images/filesave'
     default_keymap = property(lambda self: mpl.rcParams['keymap.save'])
 
 
@@ -710,7 +714,7 @@ class ToolZoom(ZoomPanBase):
     """A Tool for zooming using a rectangle selector."""
 
     description = 'Zoom to rectangle'
-    image = 'zoom_to_rect'
+    image = 'mpl-data/images/zoom_to_rect'
     default_keymap = property(lambda self: mpl.rcParams['keymap.zoom'])
     cursor = cursors.SELECT_REGION
     radio_group = 'default'
@@ -832,7 +836,7 @@ class ToolPan(ZoomPanBase):
 
     default_keymap = property(lambda self: mpl.rcParams['keymap.pan'])
     description = 'Pan axes with left mouse, zoom with right'
-    image = 'move'
+    image = 'mpl-data/images/move'
     cursor = cursors.MOVE
     radio_group = 'default'
 
@@ -896,7 +900,7 @@ def _mouse_move(self, event):
 class ToolHelpBase(ToolBase):
     description = 'Print tool list, shortcuts and description'
     default_keymap = property(lambda self: mpl.rcParams['keymap.help'])
-    image = 'help'
+    image = 'mpl-data/images/help'
 
     @staticmethod
     def format_shortcut(key_sequence):

From 6d32e3fd9249024da3eb339da0219a496c95fc23 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Tue, 12 Dec 2023 00:42:46 +0100
Subject: [PATCH 0518/1120] Remove unnecessary del local variables at end of
 Gcf.destroy.

`del manager, num` made sense prior to 9f3861f when we used to then call
gc.collect(1) (so we needed to delete the variables from the local frame
so that they can be gc'ed if needed), but we have since then removed the
explicit gc call; thus the del statement doesn't really do anything
anymore (the local frame is about to be destroyed and thus all local
variables will be decref'ed anyways).
---
 lib/matplotlib/_pylab_helpers.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/lib/matplotlib/_pylab_helpers.py b/lib/matplotlib/_pylab_helpers.py
index d32a69d4ff99..cb6ca41d02c9 100644
--- a/lib/matplotlib/_pylab_helpers.py
+++ b/lib/matplotlib/_pylab_helpers.py
@@ -64,7 +64,6 @@ def destroy(cls, num):
         if hasattr(manager, "_cidgcf"):
             manager.canvas.mpl_disconnect(manager._cidgcf)
         manager.destroy()
-        del manager, num
 
     @classmethod
     def destroy_fig(cls, fig):

From 92cc8f5457b0c8a83ce040082309930b655a5884 Mon Sep 17 00:00:00 2001
From: Koustav Ghosh <ghosh.hardkots.koustav1@gmail.com>
Date: Tue, 12 Dec 2023 14:58:08 +0530
Subject: [PATCH 0519/1120] Add test_contour under test_datetime.py (#27013)

* Add test_contour #26864

* Add test_contour #26864

Modify test_contour #26864

* Removed test_cohere and repetitive tests
---
 lib/matplotlib/tests/test_datetime.py | 24 +++++++++++++++++++++---
 1 file changed, 21 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 91402acb2b4e..d9bd8ba84a20 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -265,11 +265,29 @@ def test_clabel(self):
         fig, ax = plt.subplots()
         ax.clabel(...)
 
-    @pytest.mark.xfail(reason="Test for contour not written yet")
     @mpl.style.context("default")
     def test_contour(self):
-        fig, ax = plt.subplots()
-        ax.contour(...)
+        mpl.rcParams["date.converter"] = "concise"
+        range_threshold = 10
+        fig, (ax1, ax2, ax3) = plt.subplots(3, 1, layout="constrained")
+
+        x_dates = np.array(
+            [datetime.datetime(2023, 10, delta) for delta in range(1, range_threshold)]
+        )
+        y_dates = np.array(
+            [datetime.datetime(2023, 10, delta) for delta in range(1, range_threshold)]
+        )
+        x_ranges = np.array(range(1, range_threshold))
+        y_ranges = np.array(range(1, range_threshold))
+
+        X_dates, Y_dates = np.meshgrid(x_dates, y_dates)
+        X_ranges, Y_ranges = np.meshgrid(x_ranges, y_ranges)
+
+        Z_ranges = np.cos(X_ranges / 4) + np.sin(Y_ranges / 4)
+
+        ax1.contour(X_dates, Y_dates, Z_ranges)
+        ax2.contour(X_dates, Y_ranges, Z_ranges)
+        ax3.contour(X_ranges, Y_dates, Z_ranges)
 
     @mpl.style.context("default")
     def test_contourf(self):

From 9531b8aba3f7c28c9a4eb5e1cc85e5884e65156c Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Tue, 12 Dec 2023 11:47:37 +0000
Subject: [PATCH 0520/1120] DOC: correct return type for axline [ci doc]

---
 lib/matplotlib/axes/_axes.py  | 2 +-
 lib/matplotlib/axes/_axes.pyi | 4 ++--
 lib/matplotlib/pyplot.py      | 4 ++--
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 358b12ca563d..5392a592314c 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -895,7 +895,7 @@ def axline(self, xy1, xy2=None, *, slope=None, **kwargs):
 
         Returns
         -------
-        `.Line2D`
+        `.AxLine`
 
         Other Parameters
         ----------------
diff --git a/lib/matplotlib/axes/_axes.pyi b/lib/matplotlib/axes/_axes.pyi
index 51e905517f3d..919a22872999 100644
--- a/lib/matplotlib/axes/_axes.pyi
+++ b/lib/matplotlib/axes/_axes.pyi
@@ -17,7 +17,7 @@ from matplotlib.contour import ContourSet, QuadContourSet
 from matplotlib.image import AxesImage, PcolorImage
 from matplotlib.legend import Legend
 from matplotlib.legend_handler import HandlerBase
-from matplotlib.lines import Line2D
+from matplotlib.lines import Line2D, AxLine
 from matplotlib.mlab import GaussianKDE
 from matplotlib.patches import Rectangle, FancyArrow, Polygon, StepPatch, Wedge
 from matplotlib.quiver import Quiver, QuiverKey, Barbs
@@ -150,7 +150,7 @@ class Axes(_AxesBase):
         *,
         slope: float | None = ...,
         **kwargs
-    ) -> Line2D: ...
+    ) -> AxLine: ...
     def axhspan(
         self, ymin: float, ymax: float, xmin: float = ..., xmax: float = ..., **kwargs
     ) -> Polygon: ...
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 1255818b41b5..9272855d06ec 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -129,7 +129,7 @@
 
 # We may not need the following imports here:
 from matplotlib.colors import Normalize
-from matplotlib.lines import Line2D
+from matplotlib.lines import Line2D, AxLine
 from matplotlib.text import Text, Annotation
 from matplotlib.patches import Polygon, Rectangle, Circle, Arrow
 from matplotlib.widgets import Button, Slider, Widget
@@ -2720,7 +2720,7 @@ def axline(
     *,
     slope: float | None = None,
     **kwargs,
-) -> Line2D:
+) -> AxLine:
     return gca().axline(xy1, xy2=xy2, slope=slope, **kwargs)
 
 

From 280340764ce97aa211b78a075def2a0b7cb9f33e Mon Sep 17 00:00:00 2001
From: zachjweiner <zachjweiner@gmail.com>
Date: Tue, 12 Dec 2023 07:01:14 -0800
Subject: [PATCH 0521/1120] secondary axes: lazily invert forward transform

---
 lib/matplotlib/axes/_secondary_axes.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/axes/_secondary_axes.py b/lib/matplotlib/axes/_secondary_axes.py
index bb0237ee5332..7ee3c8b13c07 100644
--- a/lib/matplotlib/axes/_secondary_axes.py
+++ b/lib/matplotlib/axes/_secondary_axes.py
@@ -153,7 +153,9 @@ def set_functions(self, functions):
             self._functions = functions
         elif isinstance(functions, Transform):
             self._functions = (
-                    functions.transform, functions.inverted().transform)
+                 functions.transform,
+                 lambda x: functions.inverted().transform(x)
+            )
         elif functions is None:
             self._functions = (lambda x: x, lambda x: x)
         else:

From 1c6fb79979843f6e85bdf36a0c682df26fa7fbc9 Mon Sep 17 00:00:00 2001
From: ifEricReturnTrue <86877855+ifEricReturnTrue@users.noreply.github.com>
Date: Tue, 12 Dec 2023 19:00:08 -0500
Subject: [PATCH 0522/1120] Added Axes.stairs test in test_datetime.py (#27424)

* Completed Axes.stairs test_datetime.py

Tested error-free

* Update test_datetime.py

* Reverting unexpected changes in test_datetime.py in the previous commit

* Update test_stairs as requested

* Fixing linting errors

* Adding Baseline data for the test

* Fixing linting error

* Update stairs test as suggested

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>

* Update stairs test as suggested

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>

---------

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>
---
 lib/matplotlib/tests/test_datetime.py | 22 +++++++++++++++++++---
 1 file changed, 19 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index d9bd8ba84a20..104a649e1464 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -711,11 +711,27 @@ def test_stackplot(self):
         fig, ax = plt.subplots(layout='constrained')
         ax.stackplot(dates, stacked_nums)
 
-    @pytest.mark.xfail(reason="Test for stairs not written yet")
     @mpl.style.context("default")
     def test_stairs(self):
-        fig, ax = plt.subplots()
-        ax.stairs(...)
+        mpl.rcParams["date.converter"] = 'concise'
+
+        start_date = datetime.datetime(2023, 12, 1)
+        time_delta = datetime.timedelta(days=1)
+        baseline_date = datetime.datetime(1980, 1, 1)
+
+        bin_edges = [start_date + i * time_delta for i in range(31)]
+        edge_int = np.arange(31)
+        np.random.seed(123456)
+        values1 = np.random.randint(1, 100, 30)
+        values2 = [start_date + datetime.timedelta(days=int(i))
+                   for i in np.random.randint(1, 10000, 30)]
+        values3 = [start_date + datetime.timedelta(days=int(i))
+                   for i in np.random.randint(-10000, 10000, 30)]
+
+        fig, (ax1, ax2, ax3) = plt.subplots(3, 1, constrained_layout=True)
+        ax1.stairs(values1, edges=bin_edges)
+        ax2.stairs(values2, edges=edge_int, baseline=baseline_date)
+        ax3.stairs(values3, edges=bin_edges, baseline=baseline_date)
 
     @mpl.style.context("default")
     def test_stem(self):

From 60d2f95bdb7fed1701dbe979f89291aad85a8901 Mon Sep 17 00:00:00 2001
From: James Salsman <jsalsman@gmail.com>
Date: Wed, 13 Dec 2023 03:09:26 -0800
Subject: [PATCH 0523/1120] DOC: Show and correct default alignment parameters
 in text.py (#27346)

* Show and correct default alignment parameters in text.py

For issue [Doc]: text alignment defaults #27345

* Update text.py: line too long

* Show defaults in text_alignment.py

* Make setter method defaults match new docstrings in text.py

See https://github.com/matplotlib/matplotlib/pull/27346#pullrequestreview-1742239150

* IDL text alignment set_ method defaults for text.pyi

* revert interface defaults in text.pyi

* revert defaults in alignment set_ methods text.py

did change the order of allowed arguments for set_verticalalignment per @StefRe

* Document  text alignment defaults in _axes.py

Because this is where the header at https://matplotlib.org/devdocs/api/_as_gen/matplotlib.pyplot.text.html comes from.

* rm trailing whitespace in _axes.py
---
 .../examples/text_labels_and_annotations/text_alignment.py   | 3 ++-
 lib/matplotlib/axes/_axes.py                                 | 5 ++++-
 lib/matplotlib/text.py                                       | 4 ++--
 3 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/galleries/examples/text_labels_and_annotations/text_alignment.py b/galleries/examples/text_labels_and_annotations/text_alignment.py
index 7ad0d07c6572..4c0351e0bbc5 100644
--- a/galleries/examples/text_labels_and_annotations/text_alignment.py
+++ b/galleries/examples/text_labels_and_annotations/text_alignment.py
@@ -4,7 +4,8 @@
 ==============
 
 Texts are aligned relative to their anchor point depending on the properties
-``horizontalalignment`` and ``verticalalignment``.
+``horizontalalignment`` (default: ``left``) and ``verticalalignment``
+(default: ``baseline``.)
 
 .. redirect-from:: /gallery/pyplots/text_layout
 
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 5392a592314c..ab4a7e36cb5b 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -632,7 +632,10 @@ def text(self, x, y, s, fontdict=None, **kwargs):
         """
         Add text to the Axes.
 
-        Add the text *s* to the Axes at location *x*, *y* in data coordinates.
+        Add the text *s* to the Axes at location *x*, *y* in data coordinates,
+        with a default ``horizontalalignment`` on the ``left`` and
+        ``verticalalignment`` at the ``baseline``. See
+        :doc:`/gallery/text_labels_and_annotations/text_alignment`.
 
         Parameters
         ----------
diff --git a/lib/matplotlib/text.py b/lib/matplotlib/text.py
index 6371e03603d6..8734131dddc9 100644
--- a/lib/matplotlib/text.py
+++ b/lib/matplotlib/text.py
@@ -123,7 +123,7 @@ def __init__(self,
 
         The text is aligned relative to the anchor point (*x*, *y*) according
         to ``horizontalalignment`` (default: 'left') and ``verticalalignment``
-        (default: 'bottom'). See also
+        (default: 'baseline'). See also
         :doc:`/gallery/text_labels_and_annotations/text_alignment`.
 
         While Text accepts the 'label' keyword argument, by default it is not
@@ -1251,7 +1251,7 @@ def set_verticalalignment(self, align):
 
         Parameters
         ----------
-        align : {'bottom', 'baseline', 'center', 'center_baseline', 'top'}
+        align : {'baseline', 'bottom', 'center', 'center_baseline', 'top'}
         """
         _api.check_in_list(
             ['top', 'bottom', 'center', 'baseline', 'center_baseline'],

From 32bd3cbfa26731d6ca0648975572ae8bdcf3d90b Mon Sep 17 00:00:00 2001
From: Jacob Stevens-Haas
 <37048747+Jacob-Stevens-Haas@users.noreply.github.com>
Date: Wed, 13 Dec 2023 14:39:38 +0000
Subject: [PATCH 0524/1120] BLD: Make subprojects/qhull.wrap filenames match

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>
---
 subprojects/qhull.wrap | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/subprojects/qhull.wrap b/subprojects/qhull.wrap
index 23f49da33d90..c52b07d790cd 100644
--- a/subprojects/qhull.wrap
+++ b/subprojects/qhull.wrap
@@ -2,8 +2,8 @@
 # Also bump the cache key in `.circleci/config.yml`.
 # Also update the docs in `docs/devel/dependencies.rst`.
 directory = qhull-8.0.2
-source_url = https://github.com/qhull/qhull/archive/refs/tags/v8.0.2.tar.gz
-source_filename = qhull-2020-src-8.0.2.tgz
+source_url = https://github.com/qhull/qhull/archive/v8.0.2/qhull-8.0.2.tar.gz
+source_filename = qhull-8.0.2.tgz
 source_hash = 8774e9a12c70b0180b95d6b0b563c5aa4bea8d5960c15e18ae3b6d2521d64f8b
 
 patch_directory = qhull-8.0.2

From a840b8515c3e07868d6778d95a86132be3c4a68f Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 13 Dec 2023 05:01:51 -0500
Subject: [PATCH 0525/1120] TST: Add tests for Affine2D

This is implicitly tested via all plots and layout. However, this makes
it difficult to work on the transform stack directly, which these tests
rectify.
---
 lib/matplotlib/tests/test_transforms.py | 386 ++++++++++++++++++++----
 1 file changed, 327 insertions(+), 59 deletions(-)

diff --git a/lib/matplotlib/tests/test_transforms.py b/lib/matplotlib/tests/test_transforms.py
index 4145ff37f6f0..c36ec7002d61 100644
--- a/lib/matplotlib/tests/test_transforms.py
+++ b/lib/matplotlib/tests/test_transforms.py
@@ -14,6 +14,333 @@
 from matplotlib.testing.decorators import image_comparison, check_figures_equal
 
 
+class TestAffine2D:
+    single_point = [1.0, 1.0]
+    multiple_points = [[0.0, 2.0], [3.0, 3.0], [4.0, 0.0]]
+    pivot = single_point
+
+    def test_init(self):
+        Affine2D([[1, 2, 3], [4, 5, 6], [7, 8, 9]])
+        Affine2D(np.array([[1, 2, 3], [4, 5, 6], [7, 8, 9]], int))
+        Affine2D(np.array([[1, 2, 3], [4, 5, 6], [7, 8, 9]], float))
+
+    def test_values(self):
+        np.random.seed(19680801)
+        values = np.random.random(6)
+        assert_array_equal(Affine2D.from_values(*values).to_values(), values)
+
+    def test_modify_inplace(self):
+        # Some polar transforms require modifying the matrix in place.
+        trans = Affine2D()
+        mtx = trans.get_matrix()
+        mtx[0, 0] = 42
+        assert_array_equal(trans.get_matrix(), [[42, 0, 0], [0, 1, 0], [0, 0, 1]])
+
+    def test_clear(self):
+        a = Affine2D(np.random.rand(3, 3) + 5)  # Anything non-identity.
+        a.clear()
+        assert_array_equal(a.get_matrix(), [[1, 0, 0], [0, 1, 0], [0, 0, 1]])
+
+    def test_rotate(self):
+        r_pi_2 = Affine2D().rotate(np.pi / 2)
+        r90 = Affine2D().rotate_deg(90)
+        assert_array_equal(r_pi_2.get_matrix(), r90.get_matrix())
+        assert_array_almost_equal(r90.transform(self.single_point), [-1, 1])
+        assert_array_almost_equal(r90.transform(self.multiple_points),
+                                  [[-2, 0], [-3, 3], [0, 4]])
+
+        r_pi = Affine2D().rotate(np.pi)
+        r180 = Affine2D().rotate_deg(180)
+        assert_array_equal(r_pi.get_matrix(), r180.get_matrix())
+        assert_array_almost_equal(r180.transform(self.single_point), [-1, -1])
+        assert_array_almost_equal(r180.transform(self.multiple_points),
+                                  [[0, -2], [-3, -3], [-4, 0]])
+
+        r_pi_3_2 = Affine2D().rotate(3 * np.pi / 2)
+        r270 = Affine2D().rotate_deg(270)
+        assert_array_equal(r_pi_3_2.get_matrix(), r270.get_matrix())
+        assert_array_almost_equal(r270.transform(self.single_point), [1, -1])
+        assert_array_almost_equal(r270.transform(self.multiple_points),
+                                  [[2, 0], [3, -3], [0, -4]])
+
+        assert_array_equal((r90 + r90).get_matrix(), r180.get_matrix())
+        assert_array_equal((r90 + r180).get_matrix(), r270.get_matrix())
+
+    def test_rotate_around(self):
+        r_pi_2 = Affine2D().rotate_around(*self.pivot, np.pi / 2)
+        r90 = Affine2D().rotate_deg_around(*self.pivot, 90)
+        assert_array_equal(r_pi_2.get_matrix(), r90.get_matrix())
+        assert_array_almost_equal(r90.transform(self.single_point), [1, 1])
+        assert_array_almost_equal(r90.transform(self.multiple_points),
+                                  [[0, 0], [-1, 3], [2, 4]])
+
+        r_pi = Affine2D().rotate_around(*self.pivot, np.pi)
+        r180 = Affine2D().rotate_deg_around(*self.pivot, 180)
+        assert_array_equal(r_pi.get_matrix(), r180.get_matrix())
+        assert_array_almost_equal(r180.transform(self.single_point), [1, 1])
+        assert_array_almost_equal(r180.transform(self.multiple_points),
+                                  [[2, 0], [-1, -1], [-2, 2]])
+
+        r_pi_3_2 = Affine2D().rotate_around(*self.pivot, 3 * np.pi / 2)
+        r270 = Affine2D().rotate_deg_around(*self.pivot, 270)
+        assert_array_equal(r_pi_3_2.get_matrix(), r270.get_matrix())
+        assert_array_almost_equal(r270.transform(self.single_point), [1, 1])
+        assert_array_almost_equal(r270.transform(self.multiple_points),
+                                  [[2, 2], [3, -1], [0, -2]])
+
+        assert_array_almost_equal((r90 + r90).get_matrix(), r180.get_matrix())
+        assert_array_almost_equal((r90 + r180).get_matrix(), r270.get_matrix())
+
+    def test_scale(self):
+        sx = Affine2D().scale(3, 1)
+        sy = Affine2D().scale(1, -2)
+        trans = Affine2D().scale(3, -2)
+        assert_array_equal((sx + sy).get_matrix(), trans.get_matrix())
+        assert_array_equal(trans.transform(self.single_point), [3, -2])
+        assert_array_equal(trans.transform(self.multiple_points),
+                           [[0, -4], [9, -6], [12, 0]])
+
+    def test_skew(self):
+        trans_rad = Affine2D().skew(np.pi / 8, np.pi / 12)
+        trans_deg = Affine2D().skew_deg(22.5, 15)
+        assert_array_equal(trans_rad.get_matrix(), trans_deg.get_matrix())
+        # Using ~atan(0.5), ~atan(0.25) produces roundish numbers on output.
+        trans = Affine2D().skew_deg(26.5650512, 14.0362435)
+        assert_array_almost_equal(trans.transform(self.single_point), [1.5, 1.25])
+        assert_array_almost_equal(trans.transform(self.multiple_points),
+                                  [[1, 2], [4.5, 3.75], [4, 1]])
+
+    def test_translate(self):
+        tx = Affine2D().translate(23, 0)
+        ty = Affine2D().translate(0, 42)
+        trans = Affine2D().translate(23, 42)
+        assert_array_equal((tx + ty).get_matrix(), trans.get_matrix())
+        assert_array_equal(trans.transform(self.single_point), [24, 43])
+        assert_array_equal(trans.transform(self.multiple_points),
+                           [[23, 44], [26, 45], [27, 42]])
+
+    def test_rotate_plus_other(self):
+        trans = Affine2D().rotate_deg(90).rotate_deg_around(*self.pivot, 180)
+        trans_added = (Affine2D().rotate_deg(90) +
+                       Affine2D().rotate_deg_around(*self.pivot, 180))
+        assert_array_equal(trans.get_matrix(), trans_added.get_matrix())
+        assert_array_almost_equal(trans.transform(self.single_point), [3, 1])
+        assert_array_almost_equal(trans.transform(self.multiple_points),
+                                  [[4, 2], [5, -1], [2, -2]])
+
+        trans = Affine2D().rotate_deg(90).scale(3, -2)
+        trans_added = Affine2D().rotate_deg(90) + Affine2D().scale(3, -2)
+        assert_array_equal(trans.get_matrix(), trans_added.get_matrix())
+        assert_array_almost_equal(trans.transform(self.single_point), [-3, -2])
+        assert_array_almost_equal(trans.transform(self.multiple_points),
+                                  [[-6, -0], [-9, -6], [0, -8]])
+
+        trans = (Affine2D().rotate_deg(90)
+                 .skew_deg(26.5650512, 14.0362435))  # ~atan(0.5), ~atan(0.25)
+        trans_added = (Affine2D().rotate_deg(90) +
+                       Affine2D().skew_deg(26.5650512, 14.0362435))
+        assert_array_equal(trans.get_matrix(), trans_added.get_matrix())
+        assert_array_almost_equal(trans.transform(self.single_point), [-0.5, 0.75])
+        assert_array_almost_equal(trans.transform(self.multiple_points),
+                                  [[-2, -0.5], [-1.5, 2.25], [2, 4]])
+
+        trans = Affine2D().rotate_deg(90).translate(23, 42)
+        trans_added = Affine2D().rotate_deg(90) + Affine2D().translate(23, 42)
+        assert_array_equal(trans.get_matrix(), trans_added.get_matrix())
+        assert_array_almost_equal(trans.transform(self.single_point), [22, 43])
+        assert_array_almost_equal(trans.transform(self.multiple_points),
+                                  [[21, 42], [20, 45], [23, 46]])
+
+    def test_rotate_around_plus_other(self):
+        trans = Affine2D().rotate_deg_around(*self.pivot, 90).rotate_deg(180)
+        trans_added = (Affine2D().rotate_deg_around(*self.pivot, 90) +
+                       Affine2D().rotate_deg(180))
+        assert_array_equal(trans.get_matrix(), trans_added.get_matrix())
+        assert_array_almost_equal(trans.transform(self.single_point), [-1, -1])
+        assert_array_almost_equal(trans.transform(self.multiple_points),
+                                  [[0, 0], [1, -3], [-2, -4]])
+
+        trans = Affine2D().rotate_deg_around(*self.pivot, 90).scale(3, -2)
+        trans_added = (Affine2D().rotate_deg_around(*self.pivot, 90) +
+                       Affine2D().scale(3, -2))
+        assert_array_equal(trans.get_matrix(), trans_added.get_matrix())
+        assert_array_almost_equal(trans.transform(self.single_point), [3, -2])
+        assert_array_almost_equal(trans.transform(self.multiple_points),
+                                  [[0, 0], [-3, -6], [6, -8]])
+
+        trans = (Affine2D().rotate_deg_around(*self.pivot, 90)
+                 .skew_deg(26.5650512, 14.0362435))  # ~atan(0.5), ~atan(0.25)
+        trans_added = (Affine2D().rotate_deg_around(*self.pivot, 90) +
+                       Affine2D().skew_deg(26.5650512, 14.0362435))
+        assert_array_equal(trans.get_matrix(), trans_added.get_matrix())
+        assert_array_almost_equal(trans.transform(self.single_point), [1.5, 1.25])
+        assert_array_almost_equal(trans.transform(self.multiple_points),
+                                  [[0, 0], [0.5, 2.75], [4, 4.5]])
+
+        trans = Affine2D().rotate_deg_around(*self.pivot, 90).translate(23, 42)
+        trans_added = (Affine2D().rotate_deg_around(*self.pivot, 90) +
+                       Affine2D().translate(23, 42))
+        assert_array_equal(trans.get_matrix(), trans_added.get_matrix())
+        assert_array_almost_equal(trans.transform(self.single_point), [24, 43])
+        assert_array_almost_equal(trans.transform(self.multiple_points),
+                                  [[23, 42], [22, 45], [25, 46]])
+
+    def test_scale_plus_other(self):
+        trans = Affine2D().scale(3, -2).rotate_deg(90)
+        trans_added = Affine2D().scale(3, -2) + Affine2D().rotate_deg(90)
+        assert_array_equal(trans.get_matrix(), trans_added.get_matrix())
+        assert_array_equal(trans.transform(self.single_point), [2, 3])
+        assert_array_almost_equal(trans.transform(self.multiple_points),
+                                  [[4, 0], [6, 9], [0, 12]])
+
+        trans = Affine2D().scale(3, -2).rotate_deg_around(*self.pivot, 90)
+        trans_added = (Affine2D().scale(3, -2) +
+                       Affine2D().rotate_deg_around(*self.pivot, 90))
+        assert_array_equal(trans.get_matrix(), trans_added.get_matrix())
+        assert_array_equal(trans.transform(self.single_point), [4, 3])
+        assert_array_almost_equal(trans.transform(self.multiple_points),
+                                  [[6, 0], [8, 9], [2, 12]])
+
+        trans = (Affine2D().scale(3, -2)
+                 .skew_deg(26.5650512, 14.0362435))  # ~atan(0.5), ~atan(0.25)
+        trans_added = (Affine2D().scale(3, -2) +
+                       Affine2D().skew_deg(26.5650512, 14.0362435))
+        assert_array_equal(trans.get_matrix(), trans_added.get_matrix())
+        assert_array_almost_equal(trans.transform(self.single_point), [2, -1.25])
+        assert_array_almost_equal(trans.transform(self.multiple_points),
+                                  [[-2, -4], [6, -3.75], [12, 3]])
+
+        trans = Affine2D().scale(3, -2).translate(23, 42)
+        trans_added = Affine2D().scale(3, -2) + Affine2D().translate(23, 42)
+        assert_array_equal(trans.get_matrix(), trans_added.get_matrix())
+        assert_array_equal(trans.transform(self.single_point), [26, 40])
+        assert_array_equal(trans.transform(self.multiple_points),
+                           [[23, 38], [32, 36], [35, 42]])
+
+    def test_skew_plus_other(self):
+        # Using ~atan(0.5), ~atan(0.25) produces roundish numbers on output.
+        trans = Affine2D().skew_deg(26.5650512, 14.0362435).rotate_deg(90)
+        trans_added = (Affine2D().skew_deg(26.5650512, 14.0362435) +
+                       Affine2D().rotate_deg(90))
+        assert_array_equal(trans.get_matrix(), trans_added.get_matrix())
+        assert_array_almost_equal(trans.transform(self.single_point), [-1.25, 1.5])
+        assert_array_almost_equal(trans.transform(self.multiple_points),
+                                  [[-2, 1], [-3.75, 4.5], [-1, 4]])
+
+        trans = (Affine2D().skew_deg(26.5650512, 14.0362435)
+                 .rotate_deg_around(*self.pivot, 90))
+        trans_added = (Affine2D().skew_deg(26.5650512, 14.0362435) +
+                       Affine2D().rotate_deg_around(*self.pivot, 90))
+        assert_array_equal(trans.get_matrix(), trans_added.get_matrix())
+        assert_array_almost_equal(trans.transform(self.single_point), [0.75, 1.5])
+        assert_array_almost_equal(trans.transform(self.multiple_points),
+                                  [[0, 1], [-1.75, 4.5], [1, 4]])
+
+        trans = Affine2D().skew_deg(26.5650512, 14.0362435).scale(3, -2)
+        trans_added = (Affine2D().skew_deg(26.5650512, 14.0362435) +
+                       Affine2D().scale(3, -2))
+        assert_array_equal(trans.get_matrix(), trans_added.get_matrix())
+        assert_array_almost_equal(trans.transform(self.single_point), [4.5, -2.5])
+        assert_array_almost_equal(trans.transform(self.multiple_points),
+                                  [[3, -4], [13.5, -7.5], [12, -2]])
+
+        trans = Affine2D().skew_deg(26.5650512, 14.0362435).translate(23, 42)
+        trans_added = (Affine2D().skew_deg(26.5650512, 14.0362435) +
+                       Affine2D().translate(23, 42))
+        assert_array_equal(trans.get_matrix(), trans_added.get_matrix())
+        assert_array_almost_equal(trans.transform(self.single_point), [24.5, 43.25])
+        assert_array_almost_equal(trans.transform(self.multiple_points),
+                                  [[24, 44], [27.5, 45.75], [27, 43]])
+
+    def test_translate_plus_other(self):
+        trans = Affine2D().translate(23, 42).rotate_deg(90)
+        trans_added = Affine2D().translate(23, 42) + Affine2D().rotate_deg(90)
+        assert_array_equal(trans.get_matrix(), trans_added.get_matrix())
+        assert_array_almost_equal(trans.transform(self.single_point), [-43, 24])
+        assert_array_almost_equal(trans.transform(self.multiple_points),
+                                  [[-44, 23], [-45, 26], [-42, 27]])
+
+        trans = Affine2D().translate(23, 42).rotate_deg_around(*self.pivot, 90)
+        trans_added = (Affine2D().translate(23, 42) +
+                       Affine2D().rotate_deg_around(*self.pivot, 90))
+        assert_array_equal(trans.get_matrix(), trans_added.get_matrix())
+        assert_array_almost_equal(trans.transform(self.single_point), [-41, 24])
+        assert_array_almost_equal(trans.transform(self.multiple_points),
+                                  [[-42, 23], [-43, 26], [-40, 27]])
+
+        trans = Affine2D().translate(23, 42).scale(3, -2)
+        trans_added = Affine2D().translate(23, 42) + Affine2D().scale(3, -2)
+        assert_array_equal(trans.get_matrix(), trans_added.get_matrix())
+        assert_array_almost_equal(trans.transform(self.single_point), [72, -86])
+        assert_array_almost_equal(trans.transform(self.multiple_points),
+                                  [[69, -88], [78, -90], [81, -84]])
+
+        trans = (Affine2D().translate(23, 42)
+                 .skew_deg(26.5650512, 14.0362435))  # ~atan(0.5), ~atan(0.25)
+        trans_added = (Affine2D().translate(23, 42) +
+                       Affine2D().skew_deg(26.5650512, 14.0362435))
+        assert_array_equal(trans.get_matrix(), trans_added.get_matrix())
+        assert_array_almost_equal(trans.transform(self.single_point), [45.5, 49])
+        assert_array_almost_equal(trans.transform(self.multiple_points),
+                                  [[45, 49.75], [48.5, 51.5], [48, 48.75]])
+
+    def test_invalid_transform(self):
+        t = mtransforms.Affine2D()
+        # There are two different exceptions, since the wrong number of
+        # dimensions is caught when constructing an array_view, and that
+        # raises a ValueError, and a wrong shape with a possible number
+        # of dimensions is caught by our CALL_CPP macro, which always
+        # raises the less precise RuntimeError.
+        with pytest.raises(ValueError):
+            t.transform(1)
+        with pytest.raises(ValueError):
+            t.transform([[[1]]])
+        with pytest.raises(RuntimeError):
+            t.transform([])
+        with pytest.raises(RuntimeError):
+            t.transform([1])
+        with pytest.raises(ValueError):
+            t.transform([[1]])
+        with pytest.raises(ValueError):
+            t.transform([[1, 2, 3]])
+
+    def test_copy(self):
+        a = mtransforms.Affine2D()
+        b = mtransforms.Affine2D()
+        s = a + b
+        # Updating a dependee should invalidate a copy of the dependent.
+        s.get_matrix()  # resolve it.
+        s1 = copy.copy(s)
+        assert not s._invalid and not s1._invalid
+        a.translate(1, 2)
+        assert s._invalid and s1._invalid
+        assert (s1.get_matrix() == a.get_matrix()).all()
+        # Updating a copy of a dependee shouldn't invalidate a dependent.
+        s.get_matrix()  # resolve it.
+        b1 = copy.copy(b)
+        b1.translate(3, 4)
+        assert not s._invalid
+        assert_array_equal(s.get_matrix(), a.get_matrix())
+
+    def test_deepcopy(self):
+        a = mtransforms.Affine2D()
+        b = mtransforms.Affine2D()
+        s = a + b
+        # Updating a dependee shouldn't invalidate a deepcopy of the dependent.
+        s.get_matrix()  # resolve it.
+        s1 = copy.deepcopy(s)
+        assert not s._invalid and not s1._invalid
+        a.translate(1, 2)
+        assert s._invalid and not s1._invalid
+        assert_array_equal(s1.get_matrix(), mtransforms.Affine2D().get_matrix())
+        # Updating a deepcopy of a dependee shouldn't invalidate a dependent.
+        s.get_matrix()  # resolve it.
+        b1 = copy.deepcopy(b)
+        b1.translate(3, 4)
+        assert not s._invalid
+        assert_array_equal(s.get_matrix(), a.get_matrix())
+
+
 def test_non_affine_caching():
     class AssertingNonAffineTransform(mtransforms.Transform):
         """
@@ -612,27 +939,6 @@ def test_nonsingular():
         assert_array_equal(out, zero_expansion)
 
 
-def test_invalid_arguments():
-    t = mtransforms.Affine2D()
-    # There are two different exceptions, since the wrong number of
-    # dimensions is caught when constructing an array_view, and that
-    # raises a ValueError, and a wrong shape with a possible number
-    # of dimensions is caught by our CALL_CPP macro, which always
-    # raises the less precise RuntimeError.
-    with pytest.raises(ValueError):
-        t.transform(1)
-    with pytest.raises(ValueError):
-        t.transform([[[1]]])
-    with pytest.raises(RuntimeError):
-        t.transform([])
-    with pytest.raises(RuntimeError):
-        t.transform([1])
-    with pytest.raises(ValueError):
-        t.transform([[1]])
-    with pytest.raises(ValueError):
-        t.transform([[1, 2, 3]])
-
-
 def test_transformed_path():
     points = [(0, 0), (1, 0), (1, 1), (0, 1)]
     path = Path(points, closed=True)
@@ -706,44 +1012,6 @@ def test_lockable_bbox(locked_element):
         assert getattr(locked, elem) == getattr(orig, elem)
 
 
-def test_copy():
-    a = mtransforms.Affine2D()
-    b = mtransforms.Affine2D()
-    s = a + b
-    # Updating a dependee should invalidate a copy of the dependent.
-    s.get_matrix()  # resolve it.
-    s1 = copy.copy(s)
-    assert not s._invalid and not s1._invalid
-    a.translate(1, 2)
-    assert s._invalid and s1._invalid
-    assert (s1.get_matrix() == a.get_matrix()).all()
-    # Updating a copy of a dependee shouldn't invalidate a dependent.
-    s.get_matrix()  # resolve it.
-    b1 = copy.copy(b)
-    b1.translate(3, 4)
-    assert not s._invalid
-    assert (s.get_matrix() == a.get_matrix()).all()
-
-
-def test_deepcopy():
-    a = mtransforms.Affine2D()
-    b = mtransforms.Affine2D()
-    s = a + b
-    # Updating a dependee shouldn't invalidate a deepcopy of the dependent.
-    s.get_matrix()  # resolve it.
-    s1 = copy.deepcopy(s)
-    assert not s._invalid and not s1._invalid
-    a.translate(1, 2)
-    assert s._invalid and not s1._invalid
-    assert (s1.get_matrix() == mtransforms.Affine2D().get_matrix()).all()
-    # Updating a deepcopy of a dependee shouldn't invalidate a dependent.
-    s.get_matrix()  # resolve it.
-    b1 = copy.deepcopy(b)
-    b1.translate(3, 4)
-    assert not s._invalid
-    assert (s.get_matrix() == a.get_matrix()).all()
-
-
 def test_transformwrapper():
     t = mtransforms.TransformWrapper(mtransforms.Affine2D())
     with pytest.raises(ValueError, match=(

From d2526652ae3ca9c0cf58f7855a6cc0ce15e218a7 Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Thu, 14 Dec 2023 08:57:23 +0100
Subject: [PATCH 0526/1120] Fix docs and add tests

---
 lib/matplotlib/tests/test_transforms.py | 18 ++++++++++++++++++
 lib/matplotlib/transforms.py            |  2 +-
 2 files changed, 19 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/tests/test_transforms.py b/lib/matplotlib/tests/test_transforms.py
index c36ec7002d61..95e76ad95c4f 100644
--- a/lib/matplotlib/tests/test_transforms.py
+++ b/lib/matplotlib/tests/test_transforms.py
@@ -1054,3 +1054,21 @@ def test_transformedbbox_contains():
     assert bb.contains(1.25, 1.5)
     assert not bb.fully_contains(1.25, 1.5)
     assert not bb.fully_contains(.1, .1)
+
+
+def test_interval_contains():
+    assert mtransforms.interval_contains((0, 1), 0.5)
+    assert mtransforms.interval_contains((0, 1), 0)
+    assert mtransforms.interval_contains((0, 1), 1)
+    assert not mtransforms.interval_contains((0, 1), -1)
+    assert not mtransforms.interval_contains((0, 1), 2)
+    assert mtransforms.interval_contains((1, 0), 0.5)
+
+
+def test_interval_contains_open():
+    assert mtransforms.interval_contains_open((0, 1), 0.5)
+    assert not mtransforms.interval_contains_open((0, 1), 0)
+    assert not mtransforms.interval_contains_open((0, 1), 1)
+    assert not mtransforms.interval_contains_open((0, 1), -1)
+    assert not mtransforms.interval_contains_open((0, 1), 2)
+    assert mtransforms.interval_contains_open((1, 0), 0.5)
diff --git a/lib/matplotlib/transforms.py b/lib/matplotlib/transforms.py
index 5a7fd125a29b..b8602dafca61 100644
--- a/lib/matplotlib/transforms.py
+++ b/lib/matplotlib/transforms.py
@@ -2619,7 +2619,7 @@ def get_matrix(self):
 
 class BboxTransformToMaxOnly(BboxTransformTo):
     """
-    `BboxTransformTo` is a transformation that linearly transforms points from
+    `BboxTransformToMaxOnly` is a transformation that linearly transforms points from
     the unit bounding box to a given `Bbox` with a fixed upper left of (0, 0).
     """
     def get_matrix(self):

From 7d98270fc2c38edc9ab6ace394bfd951c7f2afda Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Thu, 14 Dec 2023 10:24:30 +0100
Subject: [PATCH 0527/1120] Deprecate BboxTransformToMaxOnly

---
 doc/api/next_api_changes/deprecations/27513-OG.rst | 5 +++++
 lib/matplotlib/transforms.py                       | 1 +
 2 files changed, 6 insertions(+)
 create mode 100644 doc/api/next_api_changes/deprecations/27513-OG.rst

diff --git a/doc/api/next_api_changes/deprecations/27513-OG.rst b/doc/api/next_api_changes/deprecations/27513-OG.rst
new file mode 100644
index 000000000000..46414744f59d
--- /dev/null
+++ b/doc/api/next_api_changes/deprecations/27513-OG.rst
@@ -0,0 +1,5 @@
+``BboxTransformToMaxOnly``
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+... is deprecated without replacement. If you rely on this, please make a copy of the
+code.
diff --git a/lib/matplotlib/transforms.py b/lib/matplotlib/transforms.py
index b8602dafca61..a2d5a2318720 100644
--- a/lib/matplotlib/transforms.py
+++ b/lib/matplotlib/transforms.py
@@ -2617,6 +2617,7 @@ def get_matrix(self):
         return self._mtx
 
 
+@_api.deprecated("3.9")
 class BboxTransformToMaxOnly(BboxTransformTo):
     """
     `BboxTransformToMaxOnly` is a transformation that linearly transforms points from

From f47d5614215eb4f801232e04b319d594c7993463 Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Thu, 14 Dec 2023 10:40:26 +0100
Subject: [PATCH 0528/1120] Improve check for bbox

---
 lib/matplotlib/transforms.py | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/lib/matplotlib/transforms.py b/lib/matplotlib/transforms.py
index 5a7fd125a29b..c0cb0f12159b 100644
--- a/lib/matplotlib/transforms.py
+++ b/lib/matplotlib/transforms.py
@@ -1101,7 +1101,7 @@ def __init__(self, bbox, transform, **kwargs):
         bbox : `Bbox`
         transform : `Transform`
         """
-        if not bbox.is_bbox:
+        if not getattr(bbox, 'is_bbox', False):
             raise ValueError("'bbox' is not a bbox")
         _api.check_isinstance(Transform, transform=transform)
         if transform.input_dims != 2 or transform.output_dims != 2:
@@ -1190,7 +1190,7 @@ def __init__(self, bbox, x0=None, y0=None, x1=None, y1=None, **kwargs):
             The locked value for y1, or None to leave unlocked.
 
         """
-        if not bbox.is_bbox:
+        if not getattr(bbox, 'is_bbox', False):
             raise ValueError("'bbox' is not a bbox")
 
         super().__init__(**kwargs)
@@ -2547,7 +2547,8 @@ def __init__(self, boxin, boxout, **kwargs):
         Create a new `BboxTransform` that linearly transforms
         points from *boxin* to *boxout*.
         """
-        if not boxin.is_bbox or not boxout.is_bbox:
+        if (not getattr(boxin, 'is_bbox', False) or
+                not getattr(boxout, 'is_bbox', False)):
             raise ValueError("'boxin' and 'boxout' must be bbox")
 
         super().__init__(**kwargs)
@@ -2591,7 +2592,7 @@ def __init__(self, boxout, **kwargs):
         Create a new `BboxTransformTo` that linearly transforms
         points from the unit bounding box to *boxout*.
         """
-        if not boxout.is_bbox:
+        if not getattr(boxout, 'is_bbox', False):
             raise ValueError("'boxout' must be bbox")
 
         super().__init__(**kwargs)
@@ -2645,7 +2646,7 @@ class BboxTransformFrom(Affine2DBase):
     is_separable = True
 
     def __init__(self, boxin, **kwargs):
-        if not boxin.is_bbox:
+        if not getattr(boxin, 'is_bbox', False):
             raise ValueError("'boxin' must be bbox")
 
         super().__init__(**kwargs)

From 19aa67c6a1a9cc33fa7f57f8bb7ffcee4724604f Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Fri, 15 Dec 2023 07:13:15 +0100
Subject: [PATCH 0529/1120] Deprecate is_bbox

---
 .../next_api_changes/behavior/27514-OG.rst    |  5 +++++
 .../deprecations/27514-OG.rst                 |  4 ++++
 lib/matplotlib/transforms.py                  | 22 +++++++------------
 3 files changed, 17 insertions(+), 14 deletions(-)
 create mode 100644 doc/api/next_api_changes/behavior/27514-OG.rst
 create mode 100644 doc/api/next_api_changes/deprecations/27514-OG.rst

diff --git a/doc/api/next_api_changes/behavior/27514-OG.rst b/doc/api/next_api_changes/behavior/27514-OG.rst
new file mode 100644
index 000000000000..8b2a7ab9ef2e
--- /dev/null
+++ b/doc/api/next_api_changes/behavior/27514-OG.rst
@@ -0,0 +1,5 @@
+Exception when not passing a Bbox to BboxTransform*-classes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The exception when not passing a Bbox to BboxTransform*-classes that expect one, e.g.,
+`~matplotlib.transforms.BboxTransform` has changed from ``ValueError`` to ``TypeError``.
diff --git a/doc/api/next_api_changes/deprecations/27514-OG.rst b/doc/api/next_api_changes/deprecations/27514-OG.rst
new file mode 100644
index 000000000000..f318ec8aa4bb
--- /dev/null
+++ b/doc/api/next_api_changes/deprecations/27514-OG.rst
@@ -0,0 +1,4 @@
+``TransformNode.is_bbox``
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+... is deprecated. Instead check the object using ``isinstance(..., BboxBase)``.
diff --git a/lib/matplotlib/transforms.py b/lib/matplotlib/transforms.py
index c0cb0f12159b..1ee1b41dac76 100644
--- a/lib/matplotlib/transforms.py
+++ b/lib/matplotlib/transforms.py
@@ -102,7 +102,7 @@ class TransformNode:
     # Some metadata about the transform, used to determine whether an
     # invalidation is affine-only
     is_affine = False
-    is_bbox = False
+    is_bbox = _api.deprecated("3.9")(_api.classproperty(lambda cls: False))
 
     pass_through = False
     """
@@ -220,7 +220,7 @@ class BboxBase(TransformNode):
     and height, but these are not stored explicitly.
     """
 
-    is_bbox = True
+    is_bbox = _api.deprecated("3.9")(_api.classproperty(lambda cls: True))
     is_affine = True
 
     if DEBUG:
@@ -1101,8 +1101,7 @@ def __init__(self, bbox, transform, **kwargs):
         bbox : `Bbox`
         transform : `Transform`
         """
-        if not getattr(bbox, 'is_bbox', False):
-            raise ValueError("'bbox' is not a bbox")
+        _api.check_isinstance(BboxBase, bbox=bbox)
         _api.check_isinstance(Transform, transform=transform)
         if transform.input_dims != 2 or transform.output_dims != 2:
             raise ValueError(
@@ -1190,9 +1189,7 @@ def __init__(self, bbox, x0=None, y0=None, x1=None, y1=None, **kwargs):
             The locked value for y1, or None to leave unlocked.
 
         """
-        if not getattr(bbox, 'is_bbox', False):
-            raise ValueError("'bbox' is not a bbox")
-
+        _api.check_isinstance(BboxBase, bbox=bbox)
         super().__init__(**kwargs)
         self._bbox = bbox
         self.set_children(bbox)
@@ -2547,9 +2544,8 @@ def __init__(self, boxin, boxout, **kwargs):
         Create a new `BboxTransform` that linearly transforms
         points from *boxin* to *boxout*.
         """
-        if (not getattr(boxin, 'is_bbox', False) or
-                not getattr(boxout, 'is_bbox', False)):
-            raise ValueError("'boxin' and 'boxout' must be bbox")
+        _api.check_isinstance(BboxBase, boxin=boxin)
+        _api.check_isinstance(BboxBase, boxout=boxout)
 
         super().__init__(**kwargs)
         self._boxin = boxin
@@ -2592,8 +2588,7 @@ def __init__(self, boxout, **kwargs):
         Create a new `BboxTransformTo` that linearly transforms
         points from the unit bounding box to *boxout*.
         """
-        if not getattr(boxout, 'is_bbox', False):
-            raise ValueError("'boxout' must be bbox")
+        _api.check_isinstance(BboxBase, boxout=boxout)
 
         super().__init__(**kwargs)
         self._boxout = boxout
@@ -2646,8 +2641,7 @@ class BboxTransformFrom(Affine2DBase):
     is_separable = True
 
     def __init__(self, boxin, **kwargs):
-        if not getattr(boxin, 'is_bbox', False):
-            raise ValueError("'boxin' must be bbox")
+        _api.check_isinstance(BboxBase, boxin=boxin)
 
         super().__init__(**kwargs)
         self._boxin = boxin

From ca72ba06fb6c4ca50763715faf90c520b56b430c Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@liu.se>
Date: Fri, 15 Dec 2023 08:14:19 +0100
Subject: [PATCH 0530/1120] Micro-optimizations related to list handling

---
 lib/mpl_toolkits/axisartist/axislines.py   | 8 ++------
 lib/mpl_toolkits/axisartist/grid_finder.py | 5 +++--
 2 files changed, 5 insertions(+), 8 deletions(-)

diff --git a/lib/mpl_toolkits/axisartist/axislines.py b/lib/mpl_toolkits/axisartist/axislines.py
index 6f28e5c61a2f..1d695c129ae2 100644
--- a/lib/mpl_toolkits/axisartist/axislines.py
+++ b/lib/mpl_toolkits/axisartist/axislines.py
@@ -354,9 +354,7 @@ def get_gridlines(self, which="major", axis="both"):
                 locs.extend(self.axes.xaxis.major.locator())
             if which in ("both", "minor"):
                 locs.extend(self.axes.xaxis.minor.locator())
-
-            for x in locs:
-                gridlines.append([[x, x], [y1, y2]])
+            gridlines.extend([[x, x], [y1, y2]] for x in locs)
 
         if axis in ("both", "y"):
             x1, x2 = self.axes.get_xlim()
@@ -365,9 +363,7 @@ def get_gridlines(self, which="major", axis="both"):
                 locs.extend(self.axes.yaxis.major.locator())
             if self.axes.yaxis._minor_tick_kw["gridOn"]:
                 locs.extend(self.axes.yaxis.minor.locator())
-
-            for y in locs:
-                gridlines.append([[x1, x2], [y, y]])
+            gridlines.extend([[x1, x2], [y, y]] for y in locs)
 
         return gridlines
 
diff --git a/lib/mpl_toolkits/axisartist/grid_finder.py b/lib/mpl_toolkits/axisartist/grid_finder.py
index ff61887f9ef2..4e963be6f5be 100644
--- a/lib/mpl_toolkits/axisartist/grid_finder.py
+++ b/lib/mpl_toolkits/axisartist/grid_finder.py
@@ -34,7 +34,7 @@ def _find_line_box_crossings(xys, bbox):
         umin, vmin = bbox.min[sl]
         umax, vmax = bbox.max[sl]
         for u0, inside in [(umin, us > umin), (umax, us < umax)]:
-            crossings.append([])
+            cross = []
             idxs, = (inside[:-1] ^ inside[1:]).nonzero()
             for idx in idxs:
                 v = vs[idx] + (u0 - us[idx]) * dvs[idx] / dus[idx]
@@ -42,7 +42,8 @@ def _find_line_box_crossings(xys, bbox):
                     continue
                 crossing = (u0, v)[sl]
                 theta = np.degrees(np.arctan2(*dxys[idx][::-1]))
-                crossings[-1].append((crossing, theta))
+                cross.append((crossing, theta))
+            crossings.append(cross)
     return crossings
 
 

From 338948ea67464dac2b70b0d3b8b50bfba69b589b Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@liu.se>
Date: Fri, 15 Dec 2023 09:03:59 +0100
Subject: [PATCH 0531/1120] [Doc] Improve/correct docs for 3D

---
 lib/mpl_toolkits/mplot3d/art3d.py  |  9 +++++--
 lib/mpl_toolkits/mplot3d/axes3d.py | 41 +++++++++++++++---------------
 2 files changed, 28 insertions(+), 22 deletions(-)

diff --git a/lib/mpl_toolkits/mplot3d/art3d.py b/lib/mpl_toolkits/mplot3d/art3d.py
index ea43549c33fa..44585ccd05e7 100644
--- a/lib/mpl_toolkits/mplot3d/art3d.py
+++ b/lib/mpl_toolkits/mplot3d/art3d.py
@@ -826,14 +826,17 @@ def patch_collection_2d_to_3d(col, zs=0, zdir='z', depthshade=True):
 
     Parameters
     ----------
+    col : `~matplotlib.collections.PatchCollection` or \
+`~matplotlib.collections.PathCollection`
+        The collection to convert.
     zs : float or array of floats
         The location or locations to place the patches in the collection along
         the *zdir* axis. Default: 0.
     zdir : {'x', 'y', 'z'}
         The axis in which to place the patches. Default: "z".
         See `.get_dir_vector` for a description of the values.
-    depthshade
-        Whether to shade the patches to give a sense of depth. Default: *True*.
+    depthshade : bool, default: True
+        Whether to shade the patches to give a sense of depth.
 
     """
     if isinstance(col, PathCollection):
@@ -1117,6 +1120,8 @@ def poly_collection_2d_to_3d(col, zs=0, zdir='z'):
 
     Parameters
     ----------
+    col : `~matplotlib.collections.PolyCollection`
+        The collection to convert.
     zs : float or array of floats
         The location or locations to place the polygons in the collection along
         the *zdir* axis. Default: 0.
diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index da3d7906e2c0..1845c701323e 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -1880,7 +1880,7 @@ def plot(self, xs, ys, *args, zdir='z', **kwargs):
         if args and not isinstance(args[0], str):
             zs, *args = args
             if 'zs' in kwargs:
-                raise TypeError("plot() for multiple values for argument 'z'")
+                raise TypeError("plot() for multiple values for argument 'zs'")
         else:
             zs = kwargs.pop('zs', 0)
 
@@ -1943,23 +1943,23 @@ def plot_surface(self, X, Y, Z, *, norm=None, vmin=None,
         color : color-like
             Color of the surface patches.
 
-        cmap : Colormap
+        cmap : Colormap, optional
             Colormap of the surface patches.
 
-        facecolors : array-like of colors.
+        facecolors : array-like of colors
             Colors of each individual patch.
 
-        norm : Normalize
+        norm : `~matplotlib.colors.Normalize`, optional
             Normalization for the colormap.
 
-        vmin, vmax : float
+        vmin, vmax : float, optional
             Bounds for the normalization.
 
         shade : bool, default: True
             Whether to shade the facecolors.  Shading is always disabled when
             *cmap* is specified.
 
-        lightsource : `~matplotlib.colors.LightSource`
+        lightsource : `~matplotlib.colors.LightSource`, optional
             The lightsource to use when *shade* is True.
 
         **kwargs
@@ -2242,14 +2242,14 @@ def plot_trisurf(self, *args, color=None, norm=None, vmin=None, vmax=None,
             Color of the surface patches.
         cmap
             A colormap for the surface patches.
-        norm : Normalize
+        norm : `~matplotlib.colors.Normalize`, optional
             An instance of Normalize to map values to colors.
-        vmin, vmax : float, default: None
+        vmin, vmax : float, optional
             Minimum and maximum value to map.
         shade : bool, default: True
             Whether to shade the facecolors.  Shading is always disabled when
             *cmap* is specified.
-        lightsource : `~matplotlib.colors.LightSource`
+        lightsource : `~matplotlib.colors.LightSource`, optional
             The lightsource to use when *shade* is True.
         **kwargs
             All other keyword arguments are passed on to
@@ -2379,7 +2379,7 @@ def contour(self, X, Y, Z, *args,
             Input data. See `.Axes.contour` for supported data shapes.
         extend3d : bool, default: False
             Whether to extend contour in 3D.
-        stride : int
+        stride : int, default: 5
             Step size for extending contour.
         zdir : {'x', 'y', 'z'}, default: 'z'
             The direction to use.
@@ -2423,7 +2423,7 @@ def tricontour(self, *args,
             Input data. See `.Axes.tricontour` for supported data shapes.
         extend3d : bool, default: False
             Whether to extend contour in 3D.
-        stride : int
+        stride : int, default: 5
             Step size for extending contour.
         zdir : {'x', 'y', 'z'}, default: 'z'
             The direction to use.
@@ -2558,13 +2558,14 @@ def add_collection3d(self, col, zs=0, zdir='z'):
         Add a 3D collection object to the plot.
 
         2D collection types are converted to a 3D version by
-        modifying the object and adding z coordinate information.
+        modifying the object and adding z coordinate information,
+        *zs* and *zdir*.
 
-        Supported are:
+        Supported 2D collection types are:
 
-        - PolyCollection
-        - LineCollection
-        - PatchCollection
+        - `.PolyCollection`
+        - `.LineCollection`
+        - `.PatchCollection`
         """
         zvals = np.atleast_1d(zs)
         zsortval = (np.min(zvals) if zvals.size
@@ -2676,7 +2677,7 @@ def bar(self, left, height, zs=0, zdir='z', *args, **kwargs):
             The x coordinates of the left sides of the bars.
         height : 1D array-like
             The height of the bars.
-        zs : float or 1D array-like
+        zs : float or 1D array-like, default: 0
             Z coordinate of bars; if a single value is specified, it will be
             used for all bars.
         zdir : {'x', 'y', 'z'}, default: 'z'
@@ -2759,14 +2760,14 @@ def bar3d(self, x, y, z, dx, dy, dz, color=None,
             5. -X
             6. +X
 
-        zsort : str, optional
+        zsort : {'average', 'min', 'max'}, default: 'average'
             The z-axis sorting scheme passed onto `~.art3d.Poly3DCollection`
 
         shade : bool, default: True
             When true, this shades the dark sides of the bars (relative
             to the plot's source of light).
 
-        lightsource : `~matplotlib.colors.LightSource`
+        lightsource : `~matplotlib.colors.LightSource`, optional
             The lightsource to use when *shade* is True.
 
         data : indexable object, optional
@@ -3063,7 +3064,7 @@ def voxels(self, *args, facecolors=None, edgecolors=None, shade=True,
         shade : bool, default: True
             Whether to shade the facecolors.
 
-        lightsource : `~matplotlib.colors.LightSource`
+        lightsource : `~matplotlib.colors.LightSource`, optional
             The lightsource to use when *shade* is True.
 
         **kwargs

From 24a74680c294d35d36abea319cb5b5968991acb6 Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Fri, 15 Dec 2023 09:06:35 +0100
Subject: [PATCH 0532/1120] Update lib/matplotlib/transforms.py

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>
---
 lib/matplotlib/transforms.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/lib/matplotlib/transforms.py b/lib/matplotlib/transforms.py
index 1ee1b41dac76..1a68ff12025f 100644
--- a/lib/matplotlib/transforms.py
+++ b/lib/matplotlib/transforms.py
@@ -2544,8 +2544,7 @@ def __init__(self, boxin, boxout, **kwargs):
         Create a new `BboxTransform` that linearly transforms
         points from *boxin* to *boxout*.
         """
-        _api.check_isinstance(BboxBase, boxin=boxin)
-        _api.check_isinstance(BboxBase, boxout=boxout)
+        _api.check_isinstance(BboxBase, boxin=boxin, boxout=boxout)
 
         super().__init__(**kwargs)
         self._boxin = boxin

From 7300cdc5ffdd17c88f52e6ff2bdc23d868844a11 Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Fri, 15 Dec 2023 09:13:32 +0100
Subject: [PATCH 0533/1120] [Doc] Minor consistency changes

---
 lib/matplotlib/markers.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/markers.py b/lib/matplotlib/markers.py
index e7096e66bc6a..166c0b1fad89 100644
--- a/lib/matplotlib/markers.py
+++ b/lib/matplotlib/markers.py
@@ -47,7 +47,7 @@
 ``11`` (``CARETDOWNBASE``)     |m36|  caretdown (centered at base)
 ``"none"`` or ``"None"``              nothing
 ``" "`` or  ``""``                    nothing
-``'$...$'``                    |m37|  Render the string using mathtext.
+``"$...$"``                    |m37|  Render the string using mathtext.
                                       E.g ``"$f$"`` for marker showing the
                                       letter ``f``.
 ``verts``                             A list of (x, y) pairs used for Path
@@ -55,7 +55,7 @@
                                       located at (0, 0) and the size is
                                       normalized, such that the created path
                                       is encapsulated inside the unit cell.
-path                                  A `~matplotlib.path.Path` instance.
+``path``                              A `~matplotlib.path.Path` instance.
 ``(numsides, 0, angle)``              A regular polygon with ``numsides``
                                       sides, rotated by ``angle``.
 ``(numsides, 1, angle)``              A star-like symbol with ``numsides``

From c79146493b9e5452468eae0b8d66e13c5fa5a581 Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Fri, 15 Dec 2023 11:47:49 +0000
Subject: [PATCH 0534/1120] Changes for stale GHA v9 [skip ci]

---
 .github/workflows/stale-tidy.yml | 23 +++++++++++++++++++++++
 .github/workflows/stale.yml      |  4 ++--
 2 files changed, 25 insertions(+), 2 deletions(-)
 create mode 100644 .github/workflows/stale-tidy.yml

diff --git a/.github/workflows/stale-tidy.yml b/.github/workflows/stale-tidy.yml
new file mode 100644
index 000000000000..372acde37c03
--- /dev/null
+++ b/.github/workflows/stale-tidy.yml
@@ -0,0 +1,23 @@
+name: 'Close inactive issues'
+on:
+  schedule:
+    - cron: '30 1 * * 2,4,6'
+
+jobs:
+  stale:
+    if: github.repository == 'matplotlib/matplotlib'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/stale@v9
+        with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+          operations-per-run: 300
+          days-before-stale: -1
+          stale-pr-label: "status: inactive"
+          days-before-pr-close: -1
+          stale-issue-label: "status: inactive"
+          close-issue-label: "status: closed as inactive"
+          days-before-issue-close: 30
+          ascending: true
+          exempt-issue-labels: "keep"
+          exempt-pr-labels: "keep,status: orphaned PR"
diff --git a/.github/workflows/stale.yml b/.github/workflows/stale.yml
index c4e168216145..c7268e1ea799 100644
--- a/.github/workflows/stale.yml
+++ b/.github/workflows/stale.yml
@@ -8,10 +8,10 @@ jobs:
     if: github.repository == 'matplotlib/matplotlib'
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/stale@v8
+      - uses: actions/stale@v9
         with:
           repo-token: ${{ secrets.GITHUB_TOKEN }}
-          operations-per-run: 150
+          operations-per-run: 20
           stale-pr-message: 'Since this Pull Request has not been updated in 60 days, it has been marked "inactive." This does not mean that it will be closed, though it may be moved to a "Draft" state.  This helps maintainers prioritize their reviewing efforts. You can pick the PR back up anytime - please ping us if you need a review or guidance to move the PR forward!  If you do not plan on continuing the work, please let us know so that we can either find someone to take the PR over, or close it.'
           stale-pr-label: "status: inactive"
           days-before-pr-stale: 60

From b2f72f908e5894c0b2bb661dd2548378627f62f1 Mon Sep 17 00:00:00 2001
From: Greg Lucas <greg.m.lucas@gmail.com>
Date: Fri, 15 Dec 2023 20:47:05 -0700
Subject: [PATCH 0535/1120] FIX: Add macos timers to the main thread

The macos timers need to be explicitly added to the main runloop
so the drawing takes place there. This causes issues if updating
data from other threads and wanting the plot to update.
---
 src/_macosx.m | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/src/_macosx.m b/src/_macosx.m
index a580362f676f..611486fe26fe 100755
--- a/src/_macosx.m
+++ b/src/_macosx.m
@@ -1726,11 +1726,15 @@ - (void)flagsChanged:(NSEvent *)event
     }
 
     // hold a reference to the timer so we can invalidate/stop it later
-    self->timer = [NSTimer scheduledTimerWithTimeInterval: interval
-                                            repeats: !single
-                                              block: ^(NSTimer *timer) {
+    self->timer = [NSTimer timerWithTimeInterval: interval
+                                         repeats: !single
+                                           block: ^(NSTimer *timer) {
         gil_call_method((PyObject*)self, "_on_timer");
     }];
+    // Schedule the timer on the main run loop which is needed
+    // when updating the UI from a background thread
+    [[NSRunLoop mainRunLoop] addTimer: self->timer forMode: NSRunLoopCommonModes];
+
 exit:
     Py_XDECREF(py_interval);
     Py_XDECREF(py_single);

From fd43a64437a4fa1116b4848deb93364e5a2640ce Mon Sep 17 00:00:00 2001
From: Greg Lucas <greg.m.lucas@gmail.com>
Date: Fri, 15 Dec 2023 21:09:33 -0700
Subject: [PATCH 0536/1120] FIX: Remove runloop execution while waiting for
 stdin

This would slow down the typing at a command prompt while waiting
for stdin from the programs because each character would bounce for
0.01 seconds adding up to noticeable slowdown when piping in
characters from an external source.
---
 src/_macosx.m | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/src/_macosx.m b/src/_macosx.m
index a580362f676f..d39f37063c9e 100755
--- a/src/_macosx.m
+++ b/src/_macosx.m
@@ -89,9 +89,6 @@ static int wait_for_stdin() {
                 if (!event) { break; }
                 [NSApp sendEvent: event];
             }
-            // We need to run the run loop for a short time to allow the
-            // events to be processed and keep flushing them while we wait for stdin
-            [[NSRunLoop currentRunLoop] runUntilDate: [NSDate dateWithTimeIntervalSinceNow: 0.01]];
         }
         // Remove the input handler as an observer
         [[NSNotificationCenter defaultCenter] removeObserver: stdinHandle];

From 8100cad224f37099ccc5e967c6f5950619a7c78a Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Fri, 15 Dec 2023 09:18:07 +0100
Subject: [PATCH 0537/1120] Remove incorrect info about MarkerStyle(None)

---
 lib/matplotlib/markers.py  | 35 +++++++++++++----------------------
 lib/matplotlib/markers.pyi |  2 +-
 2 files changed, 14 insertions(+), 23 deletions(-)

diff --git a/lib/matplotlib/markers.py b/lib/matplotlib/markers.py
index 166c0b1fad89..fa5e66e73ade 100644
--- a/lib/matplotlib/markers.py
+++ b/lib/matplotlib/markers.py
@@ -64,11 +64,6 @@
                                       rotated by ``angle``.
 ============================== ====== =========================================
 
-As a deprecated feature, ``None`` also means 'nothing' when directly
-constructing a `.MarkerStyle`, but note that there are other contexts where
-``marker=None`` instead means "the default marker" (e.g. :rc:`scatter.marker`
-for `.Axes.scatter`).
-
 Note that special symbols can be defined via the
 :ref:`STIX math font <mathtext>`,
 e.g. ``"$\u266B$"``. For an overview over the STIX font symbols refer to the
@@ -227,24 +222,22 @@ def __init__(self, marker,
         """
         Parameters
         ----------
-        marker : str, array-like, Path, MarkerStyle, or None
-            - Another instance of *MarkerStyle* copies the details of that
-              ``marker``.
-            - *None* means no marker.  This is the deprecated default.
+        marker : str, array-like, Path, MarkerStyle
+            - Another instance of `MarkerStyle` copies the details of that *marker*.
             - For other possible marker values, see the module docstring
               `matplotlib.markers`.
 
         fillstyle : str, default: :rc:`markers.fillstyle`
             One of 'full', 'left', 'right', 'bottom', 'top', 'none'.
 
-        transform : transforms.Transform, default: None
+        transform : `~matplotlib.transforms.Transform`, optional
             Transform that will be combined with the native transform of the
             marker.
 
-        capstyle : `.CapStyle` or %(CapStyle)s, default: None
+        capstyle : `.CapStyle` or %(CapStyle)s, optional
             Cap style that will override the default cap style of the marker.
 
-        joinstyle : `.JoinStyle` or %(JoinStyle)s, default: None
+        joinstyle : `.JoinStyle` or %(JoinStyle)s, optional
             Join style that will override the default join style of the marker.
         """
         self._marker_function = None
@@ -309,10 +302,8 @@ def _set_marker(self, marker):
 
         Parameters
         ----------
-        marker : str, array-like, Path, MarkerStyle, or None, default: None
-            - Another instance of *MarkerStyle* copies the details of that
-              ``marker``.
-            - *None* means no marker.
+        marker : str, array-like, Path, MarkerStyle
+            - Another instance of `MarkerStyle` copies the details of that *marker*.
             - For other possible marker values see the module docstring
               `matplotlib.markers`.
         """
@@ -388,13 +379,13 @@ def get_user_transform(self):
         if self._user_transform is not None:
             return self._user_transform.frozen()
 
-    def transformed(self, transform: Affine2D):
+    def transformed(self, transform):
         """
         Return a new version of this marker with the transform applied.
 
         Parameters
         ----------
-        transform : `~matplotlib.transforms.Affine2D`, default: None
+        transform : `~matplotlib.transforms.Affine2D`
             Transform will be combined with current user supplied transform.
         """
         new_marker = MarkerStyle(self)
@@ -410,10 +401,10 @@ def rotated(self, *, deg=None, rad=None):
 
         Parameters
         ----------
-        deg : float, default: None
+        deg : float, optional
             Rotation angle in degrees.
 
-        rad : float, default: None
+        rad : float, optional
             Rotation angle in radians.
 
         .. note:: You must specify exactly one of deg or rad.
@@ -437,14 +428,14 @@ def scaled(self, sx, sy=None):
         """
         Return new marker scaled by specified scale factors.
 
-        If *sy* is None, the same scale is applied in both the *x*- and
+        If *sy* is not given, the same scale is applied in both the *x*- and
         *y*-directions.
 
         Parameters
         ----------
         sx : float
             *X*-direction scaling factor.
-        sy : float, default: None
+        sy : float, optional
             *Y*-direction scaling factor.
         """
         if sy is None:
diff --git a/lib/matplotlib/markers.pyi b/lib/matplotlib/markers.pyi
index 3ee538838514..bd2f7dbcaf0c 100644
--- a/lib/matplotlib/markers.pyi
+++ b/lib/matplotlib/markers.pyi
@@ -26,7 +26,7 @@ class MarkerStyle:
 
     def __init__(
         self,
-        marker: str | ArrayLike | Path | MarkerStyle | None,
+        marker: str | ArrayLike | Path | MarkerStyle,
         fillstyle: FillStyleType | None = ...,
         transform: Transform | None = ...,
         capstyle: CapStyleType | None = ...,

From b986f60aa6c89f126acf8e6f9ea1513b058ac374 Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Fri, 15 Dec 2023 07:40:53 +0100
Subject: [PATCH 0538/1120] Best-legend-location microoptimization

---
 lib/matplotlib/legend.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/lib/matplotlib/legend.py b/lib/matplotlib/legend.py
index ba9ee10ef10c..67925b9a99bc 100644
--- a/lib/matplotlib/legend.py
+++ b/lib/matplotlib/legend.py
@@ -981,8 +981,7 @@ def _auto_legend_data(self):
             elif isinstance(artist, Collection):
                 transform, transOffset, hoffsets, _ = artist._prepare_points()
                 if len(hoffsets):
-                    for offset in transOffset.transform(hoffsets):
-                        offsets.append(offset)
+                    offsets.extend(transOffset.transform(hoffsets))
 
         return bboxes, lines, offsets
 

From a058010b8cc7849b298d269969a4f33af3d447f7 Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Sun, 17 Dec 2023 18:56:09 +0000
Subject: [PATCH 0539/1120] Update legend input types [ci doc]

---
 lib/matplotlib/axes/_axes.py  | 2 +-
 lib/matplotlib/axes/_axes.pyi | 8 ++++----
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index ab4a7e36cb5b..89081df90d9a 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -280,7 +280,7 @@ def legend(self, *args, **kwargs):
 
         Parameters
         ----------
-        handles : sequence of (`.Artist` or tuple of `.Artist`), optional
+        handles : list of (`.Artist` or tuple of `.Artist`), optional
             A list of Artists (lines, patches) to be added to the legend.
             Use this together with *labels*, if you need full control on what
             is shown in the legend and the automatic mechanism described above
diff --git a/lib/matplotlib/axes/_axes.pyi b/lib/matplotlib/axes/_axes.pyi
index 919a22872999..501cb933037a 100644
--- a/lib/matplotlib/axes/_axes.pyi
+++ b/lib/matplotlib/axes/_axes.pyi
@@ -30,7 +30,7 @@ import matplotlib.streamplot as mstream
 
 import datetime
 import PIL.Image
-from collections.abc import Callable, Sequence
+from collections.abc import Callable, Iterable, Sequence
 from typing import Any, Literal, overload
 import numpy as np
 from numpy.typing import ArrayLike
@@ -56,11 +56,11 @@ class Axes(_AxesBase):
     @overload
     def legend(self) -> Legend: ...
     @overload
-    def legend(self, handles: Sequence[Artist | tuple[Artist, ...]], labels: Sequence[str], **kwargs) -> Legend: ...
+    def legend(self, handles: Iterable[Artist | tuple[Artist, ...]], labels: Iterable[str], **kwargs) -> Legend: ...
     @overload
-    def legend(self, *, handles: Sequence[Artist | tuple[Artist, ...]], **kwargs) -> Legend: ...
+    def legend(self, *, handles: Iterable[Artist | tuple[Artist, ...]], **kwargs) -> Legend: ...
     @overload
-    def legend(self, labels: Sequence[str], **kwargs) -> Legend: ...
+    def legend(self, labels: Iterable[str], **kwargs) -> Legend: ...
     @overload
     def legend(self, **kwargs) -> Legend: ...
 

From 2d2e86326eb1cfa6d6e5e273485672b69a780414 Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Sun, 17 Dec 2023 18:37:08 +0000
Subject: [PATCH 0540/1120] Clarify AxLine Params [ci doc]

---
 lib/matplotlib/lines.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/lines.py b/lib/matplotlib/lines.py
index 0b4b8d48adc2..c94be8c512ae 100644
--- a/lib/matplotlib/lines.py
+++ b/lib/matplotlib/lines.py
@@ -1464,9 +1464,10 @@ def __init__(self, xy1, xy2, slope, **kwargs):
             The first set of (x, y) coordinates for the line to pass through.
         xy2 : (float, float) or None
             The second set of (x, y) coordinates for the line to pass through.
-            Either *xy2* or *slope* has to be given.
+            Both *xy2* and *slope* must be passed, but one of them must be None.
         slope : float or None
-            The slope of the line. Either *xy2* or *slope* has to be given.
+            The slope of the line. Both *xy2* and *slope* must be passed, but one of
+            them must be None.
         """
         super().__init__([0, 1], [0, 1], **kwargs)
 

From 7e3f4dbf373a2a7b6e27d8d2cfaf4065cb2cfd07 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 18 Dec 2023 19:28:47 +0000
Subject: [PATCH 0541/1120] Bump github/codeql-action from 2 to 3

Bumps [github/codeql-action](https://github.com/github/codeql-action) from 2 to 3.
- [Release notes](https://github.com/github/codeql-action/releases)
- [Changelog](https://github.com/github/codeql-action/blob/main/CHANGELOG.md)
- [Commits](https://github.com/github/codeql-action/compare/v2...v3)

---
updated-dependencies:
- dependency-name: github/codeql-action
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 .github/workflows/codeql-analysis.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/codeql-analysis.yml b/.github/workflows/codeql-analysis.yml
index b90d6b1f12c2..5950597a383f 100644
--- a/.github/workflows/codeql-analysis.yml
+++ b/.github/workflows/codeql-analysis.yml
@@ -47,7 +47,7 @@ jobs:
           echo "CODEQL_PYTHON=$(which python)" >> $GITHUB_ENV
 
       - name: Initialize CodeQL
-        uses: github/codeql-action/init@v2
+        uses: github/codeql-action/init@v3
         with:
           languages: ${{ matrix.language }}
           setup-python-dependencies: false
@@ -59,4 +59,4 @@ jobs:
           $CODEQL_PYTHON -m build
 
       - name: Perform CodeQL Analysis
-        uses: github/codeql-action/analyze@v2
+        uses: github/codeql-action/analyze@v3

From 20d0d14c126db88f2179a7aed60c58e8fc82736c Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Tue, 19 Dec 2023 11:11:03 -0500
Subject: [PATCH 0542/1120] moved coding guide contents to pr guide, cleaned up
 some checklists in PR guide

---
 doc/devel/{coding_guide.rst => pr_guide.rst} | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)
 rename doc/devel/{coding_guide.rst => pr_guide.rst} (99%)

diff --git a/doc/devel/coding_guide.rst b/doc/devel/pr_guide.rst
similarity index 99%
rename from doc/devel/coding_guide.rst
rename to doc/devel/pr_guide.rst
index 22873020f103..39beb7c92baf 100644
--- a/doc/devel/coding_guide.rst
+++ b/doc/devel/pr_guide.rst
@@ -85,7 +85,8 @@ and `kind <https://youtu.be/tzFWz5fiVKU?t=49m30s>`__ with contributors.
 When reviewing, please ensure that the pull request satisfies the following
 requirements before merging it:
 
-Content topics:
+Content
+-------
 
 .. rst-class:: checklist
 
@@ -98,9 +99,8 @@ Content topics:
   functional changes to the code. Reflowing a method or docstring as part of a
   larger refactor/rewrite is acceptable.
 
-
-Organizational topics:
-
+Workflow
+--------
 .. rst-class:: checklist
 
 * Make sure all :ref:`automated tests <pr-automated-tests>` pass.

From 81ebeb7d4f4125556ad88a4dc118eeea60239bb6 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Tue, 19 Dec 2023 11:26:32 -0500
Subject: [PATCH 0543/1120] moved coding guide out of contribute to its own
 page

---
 doc/devel/coding_guide.rst | 312 +++++++++++++++++++++++++++++++++++++
 1 file changed, 312 insertions(+)
 create mode 100644 doc/devel/coding_guide.rst

diff --git a/doc/devel/coding_guide.rst b/doc/devel/coding_guide.rst
new file mode 100644
index 000000000000..75b29c6fa26d
--- /dev/null
+++ b/doc/devel/coding_guide.rst
@@ -0,0 +1,312 @@
+.. _coding_guidelines:
+
+*****************
+Coding guidelines
+*****************
+
+While the current state of the Matplotlib code base is not compliant with all
+of these guidelines, our goal in enforcing these constraints on new
+contributions is that it improves the readability and consistency of the code base
+going forward.
+
+API changes
+===========
+
+If you are adding new features, changing behavior or function signatures, or
+removing classes, functions, methods, or properties, please see the :ref:`api_changes`
+guide.
+
+PEP8, as enforced by flake8
+===========================
+
+Formatting should follow the recommendations of PEP8_, as enforced by flake8_.
+Matplotlib modifies PEP8 to extend the maximum line length to 88
+characters. You can check flake8 compliance from the command line with ::
+
+    python -m pip install flake8
+    flake8 /path/to/module.py
+
+or your editor may provide integration with it.  Note that Matplotlib intentionally
+does not use the black_ auto-formatter (1__), in particular due to its inability
+to understand the semantics of mathematical expressions (2__, 3__).
+
+.. _PEP8: https://www.python.org/dev/peps/pep-0008/
+.. _flake8: https://flake8.pycqa.org/
+.. _black: https://black.readthedocs.io/
+.. __: https://github.com/matplotlib/matplotlib/issues/18796
+.. __: https://github.com/psf/black/issues/148
+.. __: https://github.com/psf/black/issues/1984
+
+
+Package imports
+===============
+
+Import the following modules using the standard scipy conventions::
+
+  import numpy as np
+  import numpy.ma as ma
+  import matplotlib as mpl
+  import matplotlib.pyplot as plt
+  import matplotlib.cbook as cbook
+  import matplotlib.patches as mpatches
+
+In general, Matplotlib modules should **not** import `.rcParams` using ``from
+matplotlib import rcParams``, but rather access it as ``mpl.rcParams``.  This
+is because some modules are imported very early, before the `.rcParams`
+singleton is constructed.
+
+Variable names
+==============
+
+When feasible, please use our internal variable naming convention for objects
+of a given class and objects of any child class:
+
++------------------------------------+---------------+------------------------------------------+
+|             base class             | variable      |                multiples                 |
++====================================+===============+==========================================+
+| `~matplotlib.figure.FigureBase`    | ``fig``       |                                          |
++------------------------------------+---------------+------------------------------------------+
+| `~matplotlib.axes.Axes`            | ``ax``        |                                          |
++------------------------------------+---------------+------------------------------------------+
+| `~matplotlib.transforms.Transform` | ``trans``     | ``trans_<source>_<target>``              |
++                                    +               +                                          +
+|                                    |               | ``trans_<source>`` when target is screen |
++------------------------------------+---------------+------------------------------------------+
+
+Generally, denote more than one instance of the same class by adding suffixes to
+the variable names. If a format isn't specified in the table, use numbers or
+letters as appropriate.
+
+.. _type-hints:
+
+Type hints
+==========
+
+If you add new public API or change public API, update or add the
+corresponding `mypy <https://mypy.readthedocs.io/en/latest/>`_ type hints.
+We generally use `stub files
+<https://typing.readthedocs.io/en/latest/source/stubs.html#type-stubs>`_
+(``*.pyi``) to store the type information; for example ``colors.pyi`` contains
+the type information for ``colors.py``. A notable exception is ``pyplot.py``,
+which is type hinted inline.
+
+Type hints are checked by the mypy :ref:`pre-commit hook <pre-commit-hooks>`
+and can often be verified using ``tools\stubtest.py`` and occasionally may
+require the use of ``tools\check_typehints.py``.
+
+New modules and files: installation
+===================================
+
+* If you have added new files or directories, or reorganized existing ones, make sure the
+  new files are included in the :file:`meson.build` in the corresponding directories.
+* New modules *may* be typed inline or using parallel stub file like existing modules.
+
+C/C++ extensions
+================
+
+* Extensions may be written in C or C++.
+
+* Code style should conform to PEP7 (understanding that PEP7 doesn't
+  address C++, but most of its admonitions still apply).
+
+* Python/C interface code should be kept separate from the core C/C++
+  code.  The interface code should be named :file:`FOO_wrap.cpp` or
+  :file:`FOO_wrapper.cpp`.
+
+* Header file documentation (aka docstrings) should be in Numpydoc
+  format.  We don't plan on using automated tools for these
+  docstrings, and the Numpydoc format is well understood in the
+  scientific Python community.
+
+* C/C++ code in the :file:`extern/` directory is vendored, and should be kept
+  close to upstream whenever possible.  It can be modified to fix bugs or
+  implement new features only if the required changes cannot be made elsewhere
+  in the codebase.  In particular, avoid making style fixes to it.
+
+.. _keyword-argument-processing:
+
+Keyword argument processing
+===========================
+
+Matplotlib makes extensive use of ``**kwargs`` for pass-through customizations
+from one function to another.  A typical example is
+`~matplotlib.axes.Axes.text`.  The definition of `matplotlib.pyplot.text` is a
+simple pass-through to `matplotlib.axes.Axes.text`::
+
+  # in pyplot.py
+  def text(x, y, s, fontdict=None, **kwargs):
+      return gca().text(x, y, s, fontdict=fontdict, **kwargs)
+
+`matplotlib.axes.Axes.text` (simplified for illustration) just
+passes all ``args`` and ``kwargs`` on to ``matplotlib.text.Text.__init__``::
+
+  # in axes/_axes.py
+  def text(self, x, y, s, fontdict=None, **kwargs):
+      t = Text(x=x, y=y, text=s, **kwargs)
+
+and ``matplotlib.text.Text.__init__`` (again, simplified)
+just passes them on to the `matplotlib.artist.Artist.update` method::
+
+  # in text.py
+  def __init__(self, x=0, y=0, text='', **kwargs):
+      super().__init__()
+      self.update(kwargs)
+
+``update`` does the work looking for methods named like
+``set_property`` if ``property`` is a keyword argument.  i.e., no one
+looks at the keywords, they just get passed through the API to the
+artist constructor which looks for suitably named methods and calls
+them with the value.
+
+As a general rule, the use of ``**kwargs`` should be reserved for
+pass-through keyword arguments, as in the example above.  If all the
+keyword args are to be used in the function, and not passed
+on, use the key/value keyword args in the function definition rather
+than the ``**kwargs`` idiom.
+
+In some cases, you may want to consume some keys in the local
+function, and let others pass through.  Instead of popping arguments to
+use off ``**kwargs``, specify them as keyword-only arguments to the local
+function.  This makes it obvious at a glance which arguments will be
+consumed in the function.  For example, in
+:meth:`~matplotlib.axes.Axes.plot`, ``scalex`` and ``scaley`` are
+local arguments and the rest are passed on as
+:meth:`~matplotlib.lines.Line2D` keyword arguments::
+
+  # in axes/_axes.py
+  def plot(self, *args, scalex=True, scaley=True, **kwargs):
+      lines = []
+      for line in self._get_lines(*args, **kwargs):
+          self.add_line(line)
+          lines.append(line)
+
+.. _using_logging:
+
+Using logging for debug messages
+================================
+
+Matplotlib uses the standard Python `logging` library to write verbose
+warnings, information, and debug messages. Please use it! In all those places
+you write `print` calls to do your debugging, try using `logging.debug`
+instead!
+
+
+To include `logging` in your module, at the top of the module, you need to
+``import logging``.  Then calls in your code like::
+
+  _log = logging.getLogger(__name__)  # right after the imports
+
+  # code
+  # more code
+  _log.info('Here is some information')
+  _log.debug('Here is some more detailed information')
+
+will log to a logger named ``matplotlib.yourmodulename``.
+
+If an end-user of Matplotlib sets up `logging` to display at levels more
+verbose than ``logging.WARNING`` in their code with the Matplotlib-provided
+helper::
+
+  plt.set_loglevel("debug")
+
+or manually with ::
+
+  import logging
+  logging.basicConfig(level=logging.DEBUG)
+  import matplotlib.pyplot as plt
+
+Then they will receive messages like
+
+.. code-block:: none
+
+   DEBUG:matplotlib.backends:backend MacOSX version unknown
+   DEBUG:matplotlib.yourmodulename:Here is some information
+   DEBUG:matplotlib.yourmodulename:Here is some more detailed information
+
+Avoid using pre-computed strings (``f-strings``, ``str.format``,etc.) for logging because
+of security and performance issues, and because they interfere with style handlers. For
+example, use ``_log.error('hello %s', 'world')``  rather than ``_log.error('hello
+{}'.format('world'))`` or ``_log.error(f'hello {s}')``.
+
+Which logging level to use?
+---------------------------
+
+There are five levels at which you can emit messages.
+
+- `logging.critical` and `logging.error` are really only there for errors that
+  will end the use of the library but not kill the interpreter.
+- `logging.warning` and `._api.warn_external` are used to warn the user,
+  see below.
+- `logging.info` is for information that the user may want to know if the
+  program behaves oddly. They are not displayed by default. For instance, if
+  an object isn't drawn because its position is ``NaN``, that can usually
+  be ignored, but a mystified user could call
+  ``logging.basicConfig(level=logging.INFO)`` and get an error message that
+  says why.
+- `logging.debug` is the least likely to be displayed, and hence can be the
+  most verbose.  "Expected" code paths (e.g., reporting normal intermediate
+  steps of layouting or rendering) should only log at this level.
+
+By default, `logging` displays all log messages at levels higher than
+``logging.WARNING`` to `sys.stderr`.
+
+The `logging tutorial`_ suggests that the difference between `logging.warning`
+and `._api.warn_external` (which uses `warnings.warn`) is that
+`._api.warn_external` should be used for things the user must change to stop
+the warning (typically in the source), whereas `logging.warning` can be more
+persistent. Moreover, note that `._api.warn_external` will by default only
+emit a given warning *once* for each line of user code, whereas
+`logging.warning` will display the message every time it is called.
+
+By default, `warnings.warn` displays the line of code that has the ``warn``
+call. This usually isn't more informative than the warning message itself.
+Therefore, Matplotlib uses `._api.warn_external` which uses `warnings.warn`,
+but goes up the stack and displays the first line of code outside of
+Matplotlib. For example, for the module::
+
+    # in my_matplotlib_module.py
+    import warnings
+
+    def set_range(bottom, top):
+        if bottom == top:
+            warnings.warn('Attempting to set identical bottom==top')
+
+running the script::
+
+    from matplotlib import my_matplotlib_module
+    my_matplotlib_module.set_range(0, 0)  # set range
+
+will display
+
+.. code-block:: none
+
+    UserWarning: Attempting to set identical bottom==top
+    warnings.warn('Attempting to set identical bottom==top')
+
+Modifying the module to use `._api.warn_external`::
+
+    from matplotlib import _api
+
+    def set_range(bottom, top):
+        if bottom == top:
+            _api.warn_external('Attempting to set identical bottom==top')
+
+and running the same script will display
+
+.. code-block:: none
+
+   UserWarning: Attempting to set identical bottom==top
+   my_matplotlib_module.set_range(0, 0)  # set range
+
+.. _logging tutorial: https://docs.python.org/3/howto/logging.html#logging-basic-tutorial
+
+
+.. _licence-coding-guide:
+
+.. include:: license.rst
+  :start-line: 2
+
+.. toctree::
+   :hidden:
+
+   license.rst

From 3289773591cc2d03531a51b6ed92ea170326574b Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Tue, 19 Dec 2023 11:01:26 -0500
Subject: [PATCH 0544/1120] reorganizing contributing docs to clean up toc
 create seperation between guidelines make contributing guide more newbie
 oriented streamline triage guide moved api guide out of coding guidelines
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Melissa Weber Mendonça <melissawm@gmail.com>
---
 doc/devel/api_changes.rst  | 211 ++++++++++++
 doc/devel/coding_guide.rst |   6 +-
 doc/devel/contribute.rst   | 665 +++++++------------------------------
 doc/devel/index.rst        |  29 +-
 doc/devel/license.rst      |   4 +-
 doc/devel/pr_guide.rst     |   6 +-
 doc/devel/triage.rst       |  89 +++--
 7 files changed, 383 insertions(+), 627 deletions(-)
 create mode 100644 doc/devel/api_changes.rst

diff --git a/doc/devel/api_changes.rst b/doc/devel/api_changes.rst
new file mode 100644
index 000000000000..b0904077ee0c
--- /dev/null
+++ b/doc/devel/api_changes.rst
@@ -0,0 +1,211 @@
+.. _api_changes:
+
+API changes
+===========
+
+API consistency and stability are of great value; Therefore, API changes
+(e.g. signature changes, behavior changes, removals) will only be conducted
+if the added benefit is worth the effort of adapting existing code.
+
+Because we are a visualization library, our primary output is the final
+visualization the user sees; therefore, the appearance of the figure is part of
+the API and any changes, either semantic or :ref:`aesthetic <color_changes>`,
+are backwards-incompatible API changes.
+
+.. toctree::
+   :hidden:
+
+   color_changes.rst
+
+.. _api_whats_new:
+
+Announce changes, deprecations, and new features
+------------------------------------------------
+
+When adding or changing the API in a backward in-compatible way, please add the
+appropriate :ref:`versioning directive <versioning-directives>` and document it
+for the release notes and add the entry to the appropriate folder:
+
++-------------------+-----------------------------+----------------------------------------------+
+| addition          |   versioning directive      |  announcement folder                         |
++===================+=============================+==============================================+
+| new feature       | ``.. versionadded:: 3.N``   | :file:`doc/users/next_whats_new/`            |
++-------------------+-----------------------------+----------------------------------------------+
+| API change        | ``.. versionchanged:: 3.N`` | :file:`doc/api/next_api_changes/[kind]`      |
++-------------------+-----------------------------+----------------------------------------------+
+
+API deprecations are first introduced and then expired. During the introduction
+period, users are warned that the API *will* change in the future.
+During the expiration period, code is changed as described in the notice posted
+during the introductory period.
+
++-----------+--------------------------------------------------+----------------------------------------------+
+|   stage   |                 required changes                 |             announcement folder              |
++===========+==================================================+==============================================+
+| introduce | :ref:`introduce deprecation <intro-deprecation>` | :file:`doc/api/next_api_changes/deprecation` |
++-----------+--------------------------------------------------+----------------------------------------------+
+| expire    | :ref:`expire deprecation <expire-deprecation>`   | :file:`doc/api/next_api_changes/[kind]`      |
++-----------+--------------------------------------------------+----------------------------------------------+
+
+For both change notes and what's new, please avoid using references in section
+titles, as it causes links to be confusing in the table of contents. Instead,
+ensure that a reference is included in the descriptive text.
+
+API Change Notes
+^^^^^^^^^^^^^^^^
+
+.. include:: ../api/next_api_changes/README.rst
+   :start-line: 5
+   :end-line: 31
+
+What's new
+^^^^^^^^^^
+
+.. include:: ../users/next_whats_new/README.rst
+   :start-line: 5
+   :end-line: 24
+
+
+Deprecation
+-----------
+
+API changes in Matplotlib have to be performed following the deprecation process
+below, except in very rare circumstances as deemed necessary by the development
+team. This ensures that users are notified before the change will take effect
+and thus prevents unexpected breaking of code.
+
+Rules
+^^^^^
+- Deprecations are targeted at the next point.release (e.g. 3.x)
+- Deprecated API is generally removed two point-releases after introduction
+  of the deprecation. Longer deprecations can be imposed by core developers on
+  a case-by-case basis to give more time for the transition
+- The old API must remain fully functional during the deprecation period
+- If alternatives to the deprecated API exist, they should be available
+  during the deprecation period
+- If in doubt, decisions about API changes are finally made by the
+  `API consistency lead <https://matplotlib.org/governance/people.html>`_ developer.
+
+.. _intro-deprecation:
+
+Introduce deprecation
+^^^^^^^^^^^^^^^^^^^^^
+
+#. Create :ref:`deprecation notice <api_whats_new>`
+
+#. If possible, issue a `~matplotlib.MatplotlibDeprecationWarning` when the
+   deprecated API is used. There are a number of helper tools for this:
+
+   - Use ``_api.warn_deprecated()`` for general deprecation warnings
+   - Use the decorator ``@_api.deprecated`` to deprecate classes, functions,
+     methods, or properties
+   - Use ``@_api.deprecate_privatize_attribute`` to annotate deprecation of
+     attributes while keeping the internal private version.
+   - To warn on changes of the function signature, use the decorators
+     ``@_api.delete_parameter``, ``@_api.rename_parameter``, and
+     ``@_api.make_keyword_only``
+
+   All these helpers take a first parameter *since*, which should be set to
+   the next point release, e.g. "3.x".
+
+   You can use standard rst cross references in *alternative*.
+
+#. Make appropriate changes to the type hints in the associated ``.pyi`` file.
+   The general guideline is to match runtime reported behavior.
+
+   - Items marked with ``@_api.deprecated`` or ``@_api.deprecate_privatize_attribute``
+     are generally kept during the expiry period, and thus no changes are needed on
+     introduction.
+   - Items decorated with ``@_api.rename_parameter`` or ``@_api.make_keyword_only``
+     report the *new* (post deprecation) signature at runtime, and thus *should* be
+     updated on introduction.
+   - Items decorated with ``@_api.delete_parameter`` should include a default value hint
+     for the deleted parameter, even if it did not previously have one (e.g.
+     ``param: <type> = ...``).
+
+.. _expire-deprecation:
+
+Expire deprecation
+^^^^^^^^^^^^^^^^^^
+
+#. Create :ref:`deprecation announcement <api_whats_new>`. For the content,
+   you can usually copy the deprecation notice and adapt it slightly.
+
+#. Change the code functionality and remove any related deprecation warnings.
+
+#. Make appropriate changes to the type hints in the associated ``.pyi`` file.
+
+   - Items marked with ``@_api.deprecated`` or ``@_api.deprecate_privatize_attribute``
+     are to be removed on expiry.
+   - Items decorated with ``@_api.rename_parameter`` or ``@_api.make_keyword_only``
+     will have been updated at introduction, and require no change now.
+   - Items decorated with ``@_api.delete_parameter`` will need to be updated to the
+     final signature, in the same way as the ``.py`` file signature is updated.
+   - Any entries in :file:`ci/mypy-stubtest-allowlist.txt` which indicate a deprecation
+     version should be double checked. In most cases this is not needed, though some
+     items were never type hinted in the first place and were added to this file
+     instead. For removed items that were not in the stub file, only deleting from the
+     allowlist is required.
+
+Adding new API and features
+---------------------------
+
+Every new function, parameter and attribute that is not explicitly marked as
+private (i.e., starts with an underscore) becomes part of Matplotlib's public
+API. As discussed above, changing the existing API is cumbersome. Therefore,
+take particular care when adding new API:
+
+- Mark helper functions and internal attributes as private by prefixing them
+  with an underscore.
+- Carefully think about good names for your functions and variables.
+- Try to adopt patterns and naming conventions from existing parts of the
+  Matplotlib API.
+- Consider making as many arguments keyword-only as possible. See also
+  `API Evolution the Right Way -- Add Parameters Compatibly`__.
+
+  __ https://emptysqua.re/blog/api-evolution-the-right-way/#adding-parameters
+
+
+.. _versioning-directives:
+
+Versioning directives
+---------------------
+
+When making a backward incompatible change, please add a versioning directive in
+the docstring. The directives should be placed at the end of a description block.
+For example::
+
+  class Foo:
+      """
+      This is the summary.
+
+      Followed by a longer description block.
+
+      Consisting of multiple lines and paragraphs.
+
+      .. versionadded:: 3.5
+
+      Parameters
+      ----------
+      a : int
+          The first parameter.
+      b: bool, default: False
+          This was added later.
+
+          .. versionadded:: 3.6
+      """
+
+      def set_b(b):
+          """
+          Set b.
+
+          .. versionadded:: 3.6
+
+          Parameters
+          ----------
+          b: bool
+
+For classes and functions, the directive should be placed before the
+*Parameters* section. For parameters, the directive should be placed at the
+end of the parameter description. The patch release version is omitted and
+the directive should not be added to entire modules.
diff --git a/doc/devel/coding_guide.rst b/doc/devel/coding_guide.rst
index 75b29c6fa26d..6564de906979 100644
--- a/doc/devel/coding_guide.rst
+++ b/doc/devel/coding_guide.rst
@@ -4,10 +4,8 @@
 Coding guidelines
 *****************
 
-While the current state of the Matplotlib code base is not compliant with all
-of these guidelines, our goal in enforcing these constraints on new
-contributions is that it improves the readability and consistency of the code base
-going forward.
+We appreciate these guidelines being followed because it improves the readability,
+consistency, and maintainability of the code base.
 
 API changes
 ===========
diff --git a/doc/devel/contribute.rst b/doc/devel/contribute.rst
index a7d81cbc06d9..9eacb2032dfd 100644
--- a/doc/devel/contribute.rst
+++ b/doc/devel/contribute.rst
@@ -2,9 +2,9 @@
 
 .. _contributing:
 
-==========
+**********
 Contribute
-==========
+**********
 
 You've discovered a bug or something else you want to change
 in Matplotlib — excellent!
@@ -90,6 +90,8 @@ active contributors, many of whom felt just like you when they started out and
 are happy to welcome you and support you as you get to know how we work, and
 where things are. Take a look at the next sections to learn more.
 
+.. _contributor_incubator:
+
 Contributor incubator
 ---------------------
 
@@ -104,6 +106,9 @@ documentation or a blog post, how to get involved in community work, or get a
 To join, please go to our public community_ channel, and ask to be added to
 ``#incubator``. One of our core developers will see your message and will add you.
 
+.. _gitter: https://gitter.im/matplotlib/matplotlib
+.. _community: https://gitter.im/matplotlib/community
+
 New Contributors Meeting
 ------------------------
 
@@ -206,18 +211,108 @@ Please post feature requests to the
 
 The Matplotlib developers will give feedback on the feature proposal. Since
 Matplotlib is an open source project with limited resources, we encourage
-users to then also
-:ref:`participate in the implementation <contributing-code>`.
+users to then also :ref:`participate in the implementation <contribute_code>`.
 
-.. _contributing-code:
+.. _contribute_code:
 
 Contribute code
 ===============
+You want to implement a feature or fix a bug or help with maintenance - much
+appreciated! Our library source code is found in
+
+* Python library code: :file:`lib/`
+* C-extension code: :file:`src/`
+* Tests: :file:`lib/matplotlib/tests/`
+
+Because many people use and work on Matplotlib, we have guidelines for keeping
+our code consistent and mitigating the impact of changes.
+
+* :ref:`coding_guidelines`
+* :ref:`api_changes`
+* :ref:`pr-guidelines`
+
+Code is contributed through pull requests, so we recommend that you start at
+:ref:`how-to-contribute` If you get stuck, please reach out on the
+:ref:`contributor_incubator`
+
+.. _contribute_documentation:
+
+Contribute documentation
+========================
+
+You as an end-user of Matplotlib can make a valuable contribution because you
+more clearly see the potential for improvement than a core developer. For example,
+you can:
+
+- Fix a typo
+- Clarify a docstring
+- Write or update an :ref:`example plot <gallery>`
+- Write or update a comprehensive :ref:`tutorial <tutorials>`
+
+Our code is documented inline in the source code files in :file:`matplotlib\lib`.
+Our website structure mirrors our folder structure, meaning that a narrative
+document's URL roughly corresponds to its location in our folder structure:
+
+.. grid:: 1 1 2 2
+
+  .. grid-item:: using the library
+
+      * :file:`galleries/plot_types/`
+      * :file:`users/getting_started/`
+      * :file:`galleries/user_explain/`
+      * :file:`galleries/tutorials/`
+      * :file:`galleries/examples/`
+      * :file:`doc/api`
+
+  .. grid-item:: information about the library
+
+      * :file:`doc/users/installing/`
+      * :file:`doc/users/project/`
+      * :file:`doc/users/resources/`
+      * :file:`doc/users/faq.rst`
+      * :file:`doc/devel/`
+
+Other documentation is generated from the following external sources:
+
+* matplotlib.org homepage: https://github.com/matplotlib/mpl-brochure-site
+* cheat sheets: https://github.com/matplotlib/cheatsheets
+* third party packages: https://github.com/matplotlib/mpl-third-party
+
+Instructions and guidelines for contributing documentation are found in:
+
+* :doc:`document`
+* :doc:`style_guide`
+* :doc:`tag_guidelines`
+
+Documentation is contributed through pull requests, so we recommend that you start
+at :ref:`how-to-contribute`. If that feels intimidating, we encourage you to
+`open an issue`_ describing what improvements you would make. If you get stuck,
+please reach out on the :ref:`contributor_incubator`
+
+.. _`open an issue`: https://github.com/matplotlib/matplotlib/issues/new?assignees=&labels=Documentation&projects=&template=documentation.yml&title=%5BDoc%5D%3A+
+
+
+.. _other_ways_to_contribute:
+
+Other ways to contribute
+========================
+
+It also helps us if you spread the word: reference the project from your blog
+and articles or link to it from your website!
+
+Matplotlib's community is built by its members, if you would like to help out
+see our :ref:`communications-guidelines`.
+
+If Matplotlib contributes to a project that leads to a scientific publication,
+please follow the :doc:`/users/project/citing` guidelines.
+
+If you have developed an extension to Matplotlib, please consider adding it to our
+`third party package <https://github.com/matplotlib/mpl-third-party>`_  list.
 
 .. _how-to-contribute:
 
-How to contribute
------------------
+How to contribute via pull request
+==================================
 
 The preferred way to contribute to Matplotlib is to fork the `main
 repository <https://github.com/matplotlib/matplotlib/>`__ on GitHub,
@@ -228,7 +323,7 @@ in-browser development environment that comes with the appropriated setup to
 contribute to Matplotlib.
 
 Workflow overview
-^^^^^^^^^^^^^^^^^
+-----------------
 
 A brief overview of the workflow is as follows.
 
@@ -292,17 +387,6 @@ A brief overview of the workflow is as follows.
 
      git push -u origin my-feature
 
-Open a pull request on Matplotlib
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-Finally, go to the web page of *your fork* of the Matplotlib repo, and click
-**Compare & pull request** to send your changes to the maintainers for review.
-The base repository is ``matplotlib/matplotlib`` and the base branch is
-generally ``main``. For more guidance, see GitHub's `pull request tutorial
-<https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork>`_.
-
-For more detailed instructions on how to set up Matplotlib for development and
-best practices for contribution, see :ref:`installing_for_devs`.
-
 GitHub Codespaces workflows
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -327,539 +411,16 @@ GitHub Codespaces workflows
   extension. Locate the ``doc/build/html`` folder in the Explorer, right click
   the file you want to open and select "Open with Live Server."
 
-.. _contributing_documentation:
-
-Contribute documentation
-========================
-
-You as an end-user of Matplotlib can make a valuable contribution because you
-more clearly see the potential for improvement than a core developer. For example, you can:
-
-- Fix a typo
-- Clarify a docstring
-- Write or update an :ref:`example plot <gallery>`
-- Write or update a comprehensive :ref:`tutorial <tutorials>`
-
-The documentation source files live in the same GitHub repository as the code.
-Contributions are proposed and accepted through the pull request process.
-For details see :ref:`how-to-contribute`.
-
-If you have trouble getting started, you may instead open an `issue`_
-describing the intended improvement.
-
-.. _issue: https://github.com/matplotlib/matplotlib/issues
-
-.. seealso::
-  * :ref:`documenting-matplotlib`
-
-.. _other_ways_to_contribute:
-
-Other ways to contribute
-========================
-
-It also helps us if you spread the word: reference the project from your blog
-and articles or link to it from your website!  If Matplotlib contributes to a
-project that leads to a scientific publication, please follow the
-:doc:`/users/project/citing` guidelines.
-
-.. _coding_guidelines:
-
-Coding guidelines
-=================
-
-While the current state of the Matplotlib code base is not compliant with all
-of these guidelines, our goal in enforcing these constraints on new
-contributions is that it improves the readability and consistency of the code base
-going forward.
-
-PEP8, as enforced by flake8
----------------------------
-
-Formatting should follow the recommendations of PEP8_, as enforced by flake8_.
-Matplotlib modifies PEP8 to extend the maximum line length to 88
-characters. You can check flake8 compliance from the command line with ::
-
-    python -m pip install flake8
-    flake8 /path/to/module.py
-
-or your editor may provide integration with it.  Note that Matplotlib intentionally
-does not use the black_ auto-formatter (1__), in particular due to its inability
-to understand the semantics of mathematical expressions (2__, 3__).
-
-.. _PEP8: https://www.python.org/dev/peps/pep-0008/
-.. _flake8: https://flake8.pycqa.org/
-.. _black: https://black.readthedocs.io/
-.. __: https://github.com/matplotlib/matplotlib/issues/18796
-.. __: https://github.com/psf/black/issues/148
-.. __: https://github.com/psf/black/issues/1984
-
-
-Package imports
----------------
-Import the following modules using the standard scipy conventions::
-
-  import numpy as np
-  import numpy.ma as ma
-  import matplotlib as mpl
-  import matplotlib.pyplot as plt
-  import matplotlib.cbook as cbook
-  import matplotlib.patches as mpatches
-
-In general, Matplotlib modules should **not** import `.rcParams` using ``from
-matplotlib import rcParams``, but rather access it as ``mpl.rcParams``.  This
-is because some modules are imported very early, before the `.rcParams`
-singleton is constructed.
-
-Variable names
---------------
-
-When feasible, please use our internal variable naming convention for objects
-of a given class and objects of any child class:
-
-+------------------------------------+---------------+------------------------------------------+
-|             base class             | variable      |                multiples                 |
-+====================================+===============+==========================================+
-| `~matplotlib.figure.FigureBase`    | ``fig``       |                                          |
-+------------------------------------+---------------+------------------------------------------+
-| `~matplotlib.axes.Axes`            | ``ax``        |                                          |
-+------------------------------------+---------------+------------------------------------------+
-| `~matplotlib.transforms.Transform` | ``trans``     | ``trans_<source>_<target>``              |
-+                                    +               +                                          +
-|                                    |               | ``trans_<source>`` when target is screen |
-+------------------------------------+---------------+------------------------------------------+
-
-Generally, denote more than one instance of the same class by adding suffixes to
-the variable names. If a format isn't specified in the table, use numbers or
-letters as appropriate.
-
-
-.. _type-hints:
-
-Type hints
-----------
-
-If you add new public API or change public API, update or add the
-corresponding `mypy <https://mypy.readthedocs.io/en/latest/>`_ type hints.
-We generally use `stub files
-<https://typing.readthedocs.io/en/latest/source/stubs.html#type-stubs>`_
-(``*.pyi``) to store the type information; for example ``colors.pyi`` contains
-the type information for ``colors.py``. A notable exception is ``pyplot.py``,
-which is type hinted inline.
-
-Type hints are checked by the mypy :ref:`pre-commit hook <pre-commit-hooks>`
-and can often be verified using ``tools\stubtest.py`` and occasionally may
-require the use of ``tools\check_typehints.py``.
-
-
-.. _new-changed-api:
-
-API changes and new features
-----------------------------
-
-API consistency and stability are of great value; Therefore, API changes
-(e.g. signature changes, behavior changes, removals) will only be conducted
-if the added benefit is worth the effort of adapting existing code.
-
-Because we are a visualization library, our primary output is the final
-visualization the user sees; therefore, the appearance of the figure is part of
-the API and any changes, either semantic or :ref:`esthetic <color_changes>`,
-are backwards-incompatible API changes.
-
-.. _api_whats_new:
-
-Announce changes, deprecations, and new features
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-When adding or changing the API in a backward in-compatible way, please add the
-appropriate :ref:`versioning directive <versioning-directives>` and document it
-for the release notes and add the entry to the appropriate folder:
-
-+-------------------+-----------------------------+----------------------------------------------+
-| addition          |   versioning directive      |  announcement folder                         |
-+===================+=============================+==============================================+
-| new feature       | ``.. versionadded:: 3.N``   | :file:`doc/users/next_whats_new/`            |
-+-------------------+-----------------------------+----------------------------------------------+
-| API change        | ``.. versionchanged:: 3.N`` | :file:`doc/api/next_api_changes/[kind]`      |
-+-------------------+-----------------------------+----------------------------------------------+
-
-API deprecations are first introduced and then expired. During the introduction
-period, users are warned that the API *will* change in the future.
-During the expiration period, code is changed as described in the notice posted
-during the introductory period.
-
-+-----------+--------------------------------------------------+----------------------------------------------+
-|   stage   |                 required changes                 |             announcement folder              |
-+===========+==================================================+==============================================+
-| introduce | :ref:`introduce deprecation <intro-deprecation>` | :file:`doc/api/next_api_changes/deprecation` |
-+-----------+--------------------------------------------------+----------------------------------------------+
-| expire    | :ref:`expire deprecation <expire-deprecation>`   | :file:`doc/api/next_api_changes/[kind]`      |
-+-----------+--------------------------------------------------+----------------------------------------------+
-
-For both change notes and what's new, please avoid using references in section
-titles, as it causes links to be confusing in the table of contents. Instead,
-ensure that a reference is included in the descriptive text.
-
-API Change Notes
-""""""""""""""""
-.. include:: ../api/next_api_changes/README.rst
-   :start-line: 5
-   :end-line: 31
-
-What's new
-""""""""""
-.. include:: ../users/next_whats_new/README.rst
-   :start-line: 5
-   :end-line: 24
-
-
-Deprecation
-^^^^^^^^^^^
-API changes in Matplotlib have to be performed following the deprecation process
-below, except in very rare circumstances as deemed necessary by the development
-team. This ensures that users are notified before the change will take effect
-and thus prevents unexpected breaking of code.
-
-Rules
-"""""
-- Deprecations are targeted at the next point.release (e.g. 3.x)
-- Deprecated API is generally removed two point-releases after introduction
-  of the deprecation. Longer deprecations can be imposed by core developers on
-  a case-by-case basis to give more time for the transition
-- The old API must remain fully functional during the deprecation period
-- If alternatives to the deprecated API exist, they should be available
-  during the deprecation period
-- If in doubt, decisions about API changes are finally made by the
-  API consistency lead developer
-
-.. _intro-deprecation:
-
-Introduce deprecation
-"""""""""""""""""""""
-
-#. Create :ref:`deprecation notice <api_whats_new>`
-
-#. If possible, issue a `~matplotlib.MatplotlibDeprecationWarning` when the
-   deprecated API is used. There are a number of helper tools for this:
-
-   - Use ``_api.warn_deprecated()`` for general deprecation warnings
-   - Use the decorator ``@_api.deprecated`` to deprecate classes, functions,
-     methods, or properties
-   - Use ``@_api.deprecate_privatize_attribute`` to annotate deprecation of
-     attributes while keeping the internal private version.
-   - To warn on changes of the function signature, use the decorators
-     ``@_api.delete_parameter``, ``@_api.rename_parameter``, and
-     ``@_api.make_keyword_only``
-
-   All these helpers take a first parameter *since*, which should be set to
-   the next point release, e.g. "3.x".
-
-   You can use standard rst cross references in *alternative*.
-
-#. Make appropriate changes to the type hints in the associated ``.pyi`` file.
-   The general guideline is to match runtime reported behavior.
-
-   - Items marked with ``@_api.deprecated`` or ``@_api.deprecate_privatize_attribute``
-     are generally kept during the expiry period, and thus no changes are needed on
-     introduction.
-   - Items decorated with ``@_api.rename_parameter`` or ``@_api.make_keyword_only``
-     report the *new* (post deprecation) signature at runtime, and thus *should* be
-     updated on introduction.
-   - Items decorated with ``@_api.delete_parameter`` should include a default value hint
-     for the deleted parameter, even if it did not previously have one (e.g.
-     ``param: <type> = ...``).
-
-.. _expire-deprecation:
-
-Expire deprecation
-""""""""""""""""""
-
-#. Create :ref:`deprecation announcement <api_whats_new>`. For the content,
-   you can usually copy the deprecation notice and adapt it slightly.
-
-#. Change the code functionality and remove any related deprecation warnings.
-
-#. Make appropriate changes to the type hints in the associated ``.pyi`` file.
-
-   - Items marked with ``@_api.deprecated`` or ``@_api.deprecate_privatize_attribute``
-     are to be removed on expiry.
-   - Items decorated with ``@_api.rename_parameter`` or ``@_api.make_keyword_only``
-     will have been updated at introduction, and require no change now.
-   - Items decorated with ``@_api.delete_parameter`` will need to be updated to the
-     final signature, in the same way as the ``.py`` file signature is updated.
-   - Any entries in :file:`ci/mypy-stubtest-allowlist.txt` which indicate a deprecation
-     version should be double checked. In most cases this is not needed, though some
-     items were never type hinted in the first place and were added to this file
-     instead. For removed items that were not in the stub file, only deleting from the
-     allowlist is required.
-
-Adding new API and features
-^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Every new function, parameter and attribute that is not explicitly marked as
-private (i.e., starts with an underscore) becomes part of Matplotlib's public
-API. As discussed above, changing the existing API is cumbersome. Therefore,
-take particular care when adding new API:
-
-- Mark helper functions and internal attributes as private by prefixing them
-  with an underscore.
-- Carefully think about good names for your functions and variables.
-- Try to adopt patterns and naming conventions from existing parts of the
-  Matplotlib API.
-- Consider making as many arguments keyword-only as possible. See also
-  `API Evolution the Right Way -- Add Parameters Compatibly`__.
-
-  __ https://emptysqua.re/blog/api-evolution-the-right-way/#adding-parameters
-
-
-.. _versioning-directives:
-
-Versioning directives
-"""""""""""""""""""""
-
-When making a backward incompatible change, please add a versioning directive in
-the docstring. The directives should be placed at the end of a description block.
-For example::
-
-  class Foo:
-      """
-      This is the summary.
-
-      Followed by a longer description block.
-
-      Consisting of multiple lines and paragraphs.
-
-      .. versionadded:: 3.5
-
-      Parameters
-      ----------
-      a : int
-          The first parameter.
-      b: bool, default: False
-          This was added later.
-
-          .. versionadded:: 3.6
-      """
-
-      def set_b(b):
-          """
-          Set b.
-
-          .. versionadded:: 3.6
-
-          Parameters
-          ----------
-          b: bool
-
-For classes and functions, the directive should be placed before the
-*Parameters* section. For parameters, the directive should be placed at the
-end of the parameter description. The patch release version is omitted and
-the directive should not be added to entire modules.
-
-
-New modules and files: installation
------------------------------------
-
-* If you have added new files or directories, or reorganized existing ones, make sure the
-  new files are included in the :file:`meson.build` in the corresponding directories.
-* New modules *may* be typed inline or using parallel stub file like existing modules.
-
-C/C++ extensions
-----------------
-
-* Extensions may be written in C or C++.
-
-* Code style should conform to PEP7 (understanding that PEP7 doesn't
-  address C++, but most of its admonitions still apply).
-
-* Python/C interface code should be kept separate from the core C/C++
-  code.  The interface code should be named :file:`FOO_wrap.cpp` or
-  :file:`FOO_wrapper.cpp`.
-
-* Header file documentation (aka docstrings) should be in Numpydoc
-  format.  We don't plan on using automated tools for these
-  docstrings, and the Numpydoc format is well understood in the
-  scientific Python community.
-
-* C/C++ code in the :file:`extern/` directory is vendored, and should be kept
-  close to upstream whenever possible.  It can be modified to fix bugs or
-  implement new features only if the required changes cannot be made elsewhere
-  in the codebase.  In particular, avoid making style fixes to it.
-
-.. _keyword-argument-processing:
-
-Keyword argument processing
----------------------------
-
-Matplotlib makes extensive use of ``**kwargs`` for pass-through customizations
-from one function to another.  A typical example is
-`~matplotlib.axes.Axes.text`.  The definition of `matplotlib.pyplot.text` is a
-simple pass-through to `matplotlib.axes.Axes.text`::
-
-  # in pyplot.py
-  def text(x, y, s, fontdict=None, **kwargs):
-      return gca().text(x, y, s, fontdict=fontdict, **kwargs)
-
-`matplotlib.axes.Axes.text` (simplified for illustration) just
-passes all ``args`` and ``kwargs`` on to ``matplotlib.text.Text.__init__``::
-
-  # in axes/_axes.py
-  def text(self, x, y, s, fontdict=None, **kwargs):
-      t = Text(x=x, y=y, text=s, **kwargs)
-
-and ``matplotlib.text.Text.__init__`` (again, simplified)
-just passes them on to the `matplotlib.artist.Artist.update` method::
-
-  # in text.py
-  def __init__(self, x=0, y=0, text='', **kwargs):
-      super().__init__()
-      self.update(kwargs)
-
-``update`` does the work looking for methods named like
-``set_property`` if ``property`` is a keyword argument.  i.e., no one
-looks at the keywords, they just get passed through the API to the
-artist constructor which looks for suitably named methods and calls
-them with the value.
-
-As a general rule, the use of ``**kwargs`` should be reserved for
-pass-through keyword arguments, as in the example above.  If all the
-keyword args are to be used in the function, and not passed
-on, use the key/value keyword args in the function definition rather
-than the ``**kwargs`` idiom.
-
-In some cases, you may want to consume some keys in the local
-function, and let others pass through.  Instead of popping arguments to
-use off ``**kwargs``, specify them as keyword-only arguments to the local
-function.  This makes it obvious at a glance which arguments will be
-consumed in the function.  For example, in
-:meth:`~matplotlib.axes.Axes.plot`, ``scalex`` and ``scaley`` are
-local arguments and the rest are passed on as
-:meth:`~matplotlib.lines.Line2D` keyword arguments::
-
-  # in axes/_axes.py
-  def plot(self, *args, scalex=True, scaley=True, **kwargs):
-      lines = []
-      for line in self._get_lines(*args, **kwargs):
-          self.add_line(line)
-          lines.append(line)
-
-.. _using_logging:
-
-Using logging for debug messages
---------------------------------
 
-Matplotlib uses the standard Python `logging` library to write verbose
-warnings, information, and debug messages. Please use it! In all those places
-you write `print` calls to do your debugging, try using `logging.debug`
-instead!
-
-
-To include `logging` in your module, at the top of the module, you need to
-``import logging``.  Then calls in your code like::
-
-  _log = logging.getLogger(__name__)  # right after the imports
-
-  # code
-  # more code
-  _log.info('Here is some information')
-  _log.debug('Here is some more detailed information')
-
-will log to a logger named ``matplotlib.yourmodulename``.
-
-If an end-user of Matplotlib sets up `logging` to display at levels more
-verbose than ``logging.WARNING`` in their code with the Matplotlib-provided
-helper::
-
-  plt.set_loglevel("debug")
-
-or manually with ::
-
-  import logging
-  logging.basicConfig(level=logging.DEBUG)
-  import matplotlib.pyplot as plt
-
-Then they will receive messages like
-
-.. code-block:: none
-
-   DEBUG:matplotlib.backends:backend MacOSX version unknown
-   DEBUG:matplotlib.yourmodulename:Here is some information
-   DEBUG:matplotlib.yourmodulename:Here is some more detailed information
-
-Avoid using pre-computed strings (``f-strings``, ``str.format``,etc.) for logging because
-of security and performance issues, and because they interfere with style handlers. For
-example, use ``_log.error('hello %s', 'world')``  rather than ``_log.error('hello
-{}'.format('world'))`` or ``_log.error(f'hello {s}')``.
-
-Which logging level to use?
-^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-There are five levels at which you can emit messages.
-
-- `logging.critical` and `logging.error` are really only there for errors that
-  will end the use of the library but not kill the interpreter.
-- `logging.warning` and `._api.warn_external` are used to warn the user,
-  see below.
-- `logging.info` is for information that the user may want to know if the
-  program behaves oddly. They are not displayed by default. For instance, if
-  an object isn't drawn because its position is ``NaN``, that can usually
-  be ignored, but a mystified user could call
-  ``logging.basicConfig(level=logging.INFO)`` and get an error message that
-  says why.
-- `logging.debug` is the least likely to be displayed, and hence can be the
-  most verbose.  "Expected" code paths (e.g., reporting normal intermediate
-  steps of layouting or rendering) should only log at this level.
-
-By default, `logging` displays all log messages at levels higher than
-``logging.WARNING`` to `sys.stderr`.
-
-The `logging tutorial`_ suggests that the difference between `logging.warning`
-and `._api.warn_external` (which uses `warnings.warn`) is that
-`._api.warn_external` should be used for things the user must change to stop
-the warning (typically in the source), whereas `logging.warning` can be more
-persistent. Moreover, note that `._api.warn_external` will by default only
-emit a given warning *once* for each line of user code, whereas
-`logging.warning` will display the message every time it is called.
-
-By default, `warnings.warn` displays the line of code that has the ``warn``
-call. This usually isn't more informative than the warning message itself.
-Therefore, Matplotlib uses `._api.warn_external` which uses `warnings.warn`,
-but goes up the stack and displays the first line of code outside of
-Matplotlib. For example, for the module::
-
-    # in my_matplotlib_module.py
-    import warnings
-
-    def set_range(bottom, top):
-        if bottom == top:
-            warnings.warn('Attempting to set identical bottom==top')
-
-running the script::
-
-    from matplotlib import my_matplotlib_module
-    my_matplotlib_module.set_range(0, 0)  # set range
-
-will display
-
-.. code-block:: none
-
-    UserWarning: Attempting to set identical bottom==top
-    warnings.warn('Attempting to set identical bottom==top')
-
-Modifying the module to use `._api.warn_external`::
-
-    from matplotlib import _api
-
-    def set_range(bottom, top):
-        if bottom == top:
-            _api.warn_external('Attempting to set identical bottom==top')
-
-and running the same script will display
-
-.. code-block:: none
+Open a pull request on Matplotlib
+---------------------------------
 
-   UserWarning: Attempting to set identical bottom==top
-   my_matplotlib_module.set_range(0, 0)  # set range
+Finally, go to the web page of *your fork* of the Matplotlib repo, and click
+**Compare & pull request** to send your changes to the maintainers for review.
+The base repository is ``matplotlib/matplotlib`` and the base branch is
+generally ``main``. For more guidance, see GitHub's `pull request tutorial
+<https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork>`_.
 
-.. _logging tutorial: https://docs.python.org/3/howto/logging.html#logging-basic-tutorial
-.. _gitter: https://gitter.im/matplotlib/matplotlib
-.. _community: https://gitter.im/matplotlib/community
+For more detailed instructions on how to set up Matplotlib for development and
+best practices for contribution, see :ref:`installing_for_devs` and
+:ref:`development-workflow`.
diff --git a/doc/devel/index.rst b/doc/devel/index.rst
index e6e16266968b..3ddbcba198a0 100644
--- a/doc/devel/index.rst
+++ b/doc/devel/index.rst
@@ -20,6 +20,10 @@ and implementing new features, helping the community...
 
 New contributors
 ================
+.. toctree::
+   :hidden:
+
+   contribute
 
 .. grid:: 1 1 2 2
    :class-row: sd-align-minor-center
@@ -58,14 +62,14 @@ New contributors
             :octicon:`bug;1em;sd-text-info` Submit bug report
 
          .. grid-item-card::
-            :link: contributing-code
+            :link: contribute_code
             :link-type: ref
             :shadow: none
 
             :octicon:`code;1em;sd-text-info` Contribute code
 
          .. grid-item-card::
-            :link: documenting-matplotlib
+            :link: contribute_documentation
             :link-type: ref
             :shadow: none
 
@@ -130,12 +134,11 @@ Policies and guidelines
       **Code**
       ^^^
 
-      | :ref:`coding_guidelines`
-
       .. toctree::
          :maxdepth: 1
 
          coding_guide
+         api_changes
          testing
 
    .. grid-item-card::
@@ -154,12 +157,14 @@ Policies and guidelines
    .. grid-item-card::
       :shadow: none
 
-      **Triage**
+      **Triage And Review**
       ^^^
 
-      | :ref:`bug_triaging`
-      | :ref:`triage_team`
-      | :ref:`triage_workflow`
+      .. toctree::
+         :maxdepth: 1
+
+         triage
+         pr_guide
 
    .. grid-item-card::
       :shadow: none
@@ -174,11 +179,3 @@ Policies and guidelines
          communication_guide
          min_dep_policy
          MEP/index
-
-.. toctree::
-   :hidden:
-
-   contribute
-   triage
-   license
-   color_changes
diff --git a/doc/devel/license.rst b/doc/devel/license.rst
index 8474fa432ff4..7596f2f92348 100644
--- a/doc/devel/license.rst
+++ b/doc/devel/license.rst
@@ -1,7 +1,7 @@
 .. _license-discussion:
 
-Licenses
-========
+Licenses for contributed code
+=============================
 
 Matplotlib only uses BSD compatible code.  If you bring in code from
 another project make sure it has a PSF, BSD, MIT or compatible license
diff --git a/doc/devel/pr_guide.rst b/doc/devel/pr_guide.rst
index 39beb7c92baf..257e218d8e1f 100644
--- a/doc/devel/pr_guide.rst
+++ b/doc/devel/pr_guide.rst
@@ -40,11 +40,11 @@ guidelines before submitting a pull request:
   :ref:`examples gallery <gallery>`.
 
 * If you add a major new feature or change the API in a backward-incompatible
-  way, please document it as described in :ref:`new-changed-api`
+  way, please document it as described in :ref:`api_changes`.
 
-* Code should follow our conventions as documented in our :ref:`coding_guidelines`
+* Code should follow our conventions as documented in our :ref:`coding_guidelines`.
 
-* When adding or changing public function signatures, add :ref:`type hints <type-hints>`
+* When adding or changing public function signatures, add :ref:`type hints <type-hints>`.
 
 * When adding keyword arguments, see our guide to :ref:`keyword-argument-processing`.
 
diff --git a/doc/devel/triage.rst b/doc/devel/triage.rst
index 94b6874af228..1b2849738c9c 100644
--- a/doc/devel/triage.rst
+++ b/doc/devel/triage.rst
@@ -1,8 +1,9 @@
 
 .. _bug_triaging:
 
+*******************************
 Bug triaging and issue curation
-===============================
+*******************************
 
 The `issue tracker <https://github.com/matplotlib/matplotlib/issues>`_
 is important to communication in the project because it serves as the
@@ -11,24 +12,28 @@ identifying major projects to work on, and discussing priorities.  For
 this reason, it is important to curate the issue list, adding labels
 to issues and closing issues that are resolved or unresolvable.
 
+Writing well defined issues increases their chances of being successfully
+resolved. Guidelines on writing a good issue can be found in :ref:`here
+<submitting-a-bug-report>`. The recommendations in this page are adapted from
+the `scikit learn <https://scikit-learn.org/stable/developers/bug_triaging.html>`_
+and `Pandas <https://pandas.pydata.org/docs/development/maintaining.html>`_
+contributing guides.
+
+
+Improve issue reports
+=====================
+
 Triaging issues does not require any particular expertise in the
 internals of Matplotlib, is extremely valuable to the project, and we
 welcome anyone to participate in issue triage!  However, people who
 are not part of the Matplotlib organization do not have `permissions
 to change milestones, add labels, or close issue
 <https://docs.github.com/en/organizations/managing-access-to-your-organizations-repositories/repository-permission-levels-for-an-organization>`_.
+
 If you do not have enough GitHub permissions do something (e.g. add a
 label, close an issue), please leave a comment with your
 recommendations!
 
-Working on issues to improve them
----------------------------------
-
-Improving issues increases their chances of being successfully resolved.
-Guidelines on submitting good issues can be found :ref:`here
-<submitting-a-bug-report>`.
-A third party can give useful feedback or even add
-comments on the issue.
 The following actions are typically useful:
 
 - documenting issues that are missing elements to reproduce the problem
@@ -62,30 +67,11 @@ The following actions are typically useful:
    explores how to lead online discussions in the context of open source.
 
 
-.. _triage_team:
-
-Triage team
------------
-
-
-If you would like to join the triage team:
-
-1. Correctly triage 2-3 issues.
-2. Ask someone on in the Matplotlib organization (publicly or privately) to
-   recommend you to the triage team (look for "Member" on the top-right of
-   comments on GitHub).  If you worked with someone on the issues triaged, they
-   would be a good person to ask.
-3. Responsibly exercise your new power!
-
-Anyone with commit or triage rights may nominate a user to be invited to join
-the triage team by emailing matplotlib-steering-council@numfocus.org .
-
+Maintainers and triage team members
+-----------------------------------
 
-Triaging operations for members of the core and triage teams
-------------------------------------------------------------
-
-In addition to the above, members of the core team and the triage team
-can do the following important tasks:
+In addition to the above, maintainers and the triage team can do the following
+important tasks:
 
 - Update labels for issues and PRs: see the list of `available GitHub
   labels <https://github.com/matplotlib/matplotlib/labels>`_.
@@ -113,7 +99,6 @@ can do the following important tasks:
     least a week) to add extra information
 
 
-
 .. topic:: Closing issues: a tough call
 
     When uncertain on whether an issue should be closed or not, it is
@@ -122,13 +107,19 @@ can do the following important tasks:
     question or has been considered as unclear for many years, then it
     should be closed.
 
+Preparing PRs for review
+========================
+
+Reviewing code is also encouraged. Contributors and users are welcome to
+participate to the review process following our :ref:`review guidelines
+<pr-guidelines>`.
 
 .. _triage_workflow:
 
-A typical workflow for triaging issues
---------------------------------------
+Triage workflow
+===============
 
-The following workflow [1]_ is a good way to approach issue triaging:
+The following workflow is a good way to approach issue triaging:
 
 #. Thank the reporter for opening an issue
 
@@ -208,22 +199,20 @@ The following workflow [1]_ is a good way to approach issue triaging:
    An additional useful step can be to tag the corresponding module e.g.
    the "GUI/Qt" label when relevant.
 
+.. _triage_team:
 
-.. [1] Adapted from the pandas project `maintainers guide
-       <https://pandas.pydata.org/docs/development/maintaining.html>`_ and
-       `the scikit-learn project
-       <https://scikit-learn.org/dev/developers/bug_triaging.html>`_ .
-
+Triage team
+===========
 
-Working on PRs to help review
-------------------------------
 
-Reviewing code is also encouraged. Contributors and users are welcome to
-participate to the review process following our :ref:`review guidelines
-<pr-guidelines>`.
+If you would like to join the triage team:
 
-Acknowledgments
----------------
+1. Correctly triage 2-3 issues.
+2. Ask someone on in the Matplotlib organization (publicly or privately) to
+   recommend you to the triage team (look for "Member" on the top-right of
+   comments on GitHub).  If you worked with someone on the issues triaged, they
+   would be a good person to ask.
+3. Responsibly exercise your new power!
 
-This page is lightly adapted from `the scikit-learn project
-<https://scikit-learn.org/dev/developers/bug_triaging.html>`_ .
+Anyone with commit or triage rights may nominate a user to be invited to join
+the triage team by emailing matplotlib-steering-council@numfocus.org .

From 2a0127734ada54d792a2dcd040872fdb1beb1d24 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 20 Dec 2023 01:51:40 -0500
Subject: [PATCH 0545/1120] MNT: Make unused imports explicit

... instead of using a full file ignore. This allows catching a few more
unused imports.
---
 .flake8                                 |  8 +-------
 lib/matplotlib/__init__.py              | 11 +++++------
 lib/matplotlib/_api/__init__.py         |  2 +-
 lib/matplotlib/axes/__init__.py         |  4 ++--
 lib/matplotlib/image.py                 |  2 +-
 lib/matplotlib/pyplot.py                | 26 ++++++++++++-------------
 lib/mpl_toolkits/axisartist/__init__.py | 11 ++++++-----
 lib/pylab.py                            |  2 +-
 8 files changed, 30 insertions(+), 36 deletions(-)

diff --git a/.flake8 b/.flake8
index 00cd213e0f79..6fc63524f227 100644
--- a/.flake8
+++ b/.flake8
@@ -31,26 +31,20 @@ exclude =
     .eggs
 
 per-file-ignores =
-    lib/matplotlib/__init__.py: E402, F401
     lib/matplotlib/_animation_data.py: E501
-    lib/matplotlib/_api/__init__.py: F401
     lib/matplotlib/_cm.py: E122, E202, E203, E302
     lib/matplotlib/_mathtext.py: E221, E251
     lib/matplotlib/_mathtext_data.py: E122, E203, E261
-    lib/matplotlib/axes/__init__.py: F401, F403
     lib/matplotlib/backends/backend_template.py: F401
     lib/matplotlib/font_manager.py: E501
-    lib/matplotlib/image.py: F401, F403
     lib/matplotlib/mathtext.py: E221
     lib/matplotlib/pylab.py: F401, F403
-    lib/matplotlib/pyplot.py: F401, F811
+    lib/matplotlib/pyplot.py: F811
     lib/matplotlib/tests/test_mathtext.py: E501
     lib/matplotlib/transforms.py: E201, E202, E203
     lib/matplotlib/tri/_triinterpolate.py: E201, E221
     lib/mpl_toolkits/axes_grid1/axes_size.py: E272
-    lib/mpl_toolkits/axisartist/__init__.py: F401
     lib/mpl_toolkits/axisartist/angle_helper.py: E221
-    lib/pylab.py: F401, F403
 
     doc/conf.py: E402
     galleries/users_explain/artists/paths.py: E402
diff --git a/lib/matplotlib/__init__.py b/lib/matplotlib/__init__.py
index 53f27c46314a..5836cd3a2ccf 100644
--- a/lib/matplotlib/__init__.py
+++ b/lib/matplotlib/__init__.py
@@ -151,9 +151,7 @@
 import subprocess
 import sys
 import tempfile
-import warnings
 
-import numpy
 from packaging.version import parse as parse_version
 
 # cbook must import matplotlib only within function
@@ -161,7 +159,8 @@
 from . import _api, _version, cbook, _docstring, rcsetup
 from matplotlib.cbook import sanitize_sequence
 from matplotlib._api import MatplotlibDeprecationWarning
-from matplotlib.rcsetup import validate_backend, cycler
+from matplotlib.rcsetup import cycler  # noqa: F401
+from matplotlib.rcsetup import validate_backend
 
 
 _log = logging.getLogger(__name__)
@@ -246,7 +245,7 @@ def _check_versions():
 
     # Quickfix to ensure Microsoft Visual C++ redistributable
     # DLLs are loaded before importing kiwisolver
-    from . import ft2font
+    from . import ft2font  # noqa: F401
 
     for modname, minver in [
             ("cycler", "0.10"),
@@ -1511,5 +1510,5 @@ def inner(ax, *args, data=None, **kwargs):
 
 # workaround: we must defer colormaps import to after loading rcParams, because
 # colormap creation depends on rcParams
-from matplotlib.cm import _colormaps as colormaps
-from matplotlib.colors import _color_sequences as color_sequences
+from matplotlib.cm import _colormaps as colormaps  # noqa: E402
+from matplotlib.colors import _color_sequences as color_sequences  # noqa: E402
diff --git a/lib/matplotlib/_api/__init__.py b/lib/matplotlib/_api/__init__.py
index 13319d867dc5..27d68529b7d4 100644
--- a/lib/matplotlib/_api/__init__.py
+++ b/lib/matplotlib/_api/__init__.py
@@ -16,7 +16,7 @@
 import sys
 import warnings
 
-from .deprecation import (
+from .deprecation import (  # noqa: F401
     deprecated, warn_deprecated,
     rename_parameter, delete_parameter, make_keyword_only,
     deprecate_method_override, deprecate_privatize_attribute,
diff --git a/lib/matplotlib/axes/__init__.py b/lib/matplotlib/axes/__init__.py
index f8c40889bce7..9f2913957194 100644
--- a/lib/matplotlib/axes/__init__.py
+++ b/lib/matplotlib/axes/__init__.py
@@ -1,8 +1,8 @@
 from . import _base
-from ._axes import *
+from ._axes import Axes  # noqa: F401
 
 # Backcompat.
-from ._axes import Axes as Subplot
+Subplot = Axes
 
 
 class _SubplotBaseMeta(type):
diff --git a/lib/matplotlib/image.py b/lib/matplotlib/image.py
index 3579bf57176f..8b672e5ad2b0 100644
--- a/lib/matplotlib/image.py
+++ b/lib/matplotlib/image.py
@@ -19,7 +19,7 @@
 from matplotlib import _image
 # For user convenience, the names from _image are also imported into
 # the image namespace
-from matplotlib._image import *
+from matplotlib._image import *  # noqa: F401, F403
 import matplotlib.artist as martist
 from matplotlib.backend_bases import FigureCanvasBase
 import matplotlib.colors as mcolors
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 9272855d06ec..dc59bc809638 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -45,20 +45,20 @@
 import importlib
 import inspect
 import logging
-import re
 import sys
 import threading
 import time
-from typing import cast, overload
+from typing import TYPE_CHECKING, cast, overload
 
-from cycler import cycler
+from cycler import cycler  # noqa: F401
 import matplotlib
 import matplotlib.colorbar
 import matplotlib.image
 from matplotlib import _api
-from matplotlib import (  # Re-exported for typing.
+from matplotlib import (  # noqa: F401 Re-exported for typing.
     cm as cm, get_backend as get_backend, rcParams as rcParams, style as style)
-from matplotlib import _pylab_helpers, interactive
+from matplotlib import _pylab_helpers
+from matplotlib import interactive  # noqa: F401
 from matplotlib import cbook
 from matplotlib import _docstring
 from matplotlib.backend_bases import (
@@ -67,19 +67,18 @@
 from matplotlib.gridspec import GridSpec, SubplotSpec
 from matplotlib import rcsetup, rcParamsDefault, rcParamsOrig
 from matplotlib.artist import Artist
-from matplotlib.axes import Axes, Subplot  # type: ignore
+from matplotlib.axes import Axes
+from matplotlib.axes import Subplot  # noqa: F401
 from matplotlib.projections import PolarAxes  # type: ignore
 from matplotlib import mlab  # for detrend_none, window_hanning
-from matplotlib.scale import get_scale_names
+from matplotlib.scale import get_scale_names  # noqa: F401
 
 from matplotlib.cm import _colormaps
-from matplotlib.cm import register_cmap  # type: ignore
+from matplotlib.cm import register_cmap  # type: ignore # noqa: F401
 from matplotlib.colors import _color_sequences
 
 import numpy as np
 
-from typing import TYPE_CHECKING, cast
-
 if TYPE_CHECKING:
     from collections.abc import Callable, Hashable, Iterable, Sequence
     import datetime
@@ -131,10 +130,11 @@
 from matplotlib.colors import Normalize
 from matplotlib.lines import Line2D, AxLine
 from matplotlib.text import Text, Annotation
-from matplotlib.patches import Polygon, Rectangle, Circle, Arrow
-from matplotlib.widgets import Button, Slider, Widget
+from matplotlib.patches import Arrow, Circle, Rectangle  # noqa: F401
+from matplotlib.patches import Polygon
+from matplotlib.widgets import Button, Slider, Widget  # noqa: F401
 
-from .ticker import (
+from .ticker import (  # noqa: F401
     TickHelper, Formatter, FixedFormatter, NullFormatter, FuncFormatter,
     FormatStrFormatter, ScalarFormatter, LogFormatter, LogFormatterExponent,
     LogFormatterMathtext, Locator, IndexLocator, FixedLocator, NullLocator,
diff --git a/lib/mpl_toolkits/axisartist/__init__.py b/lib/mpl_toolkits/axisartist/__init__.py
index 47242cf7f0c5..7b8d8c08ac22 100644
--- a/lib/mpl_toolkits/axisartist/__init__.py
+++ b/lib/mpl_toolkits/axisartist/__init__.py
@@ -1,9 +1,10 @@
-from .axislines import (
-    Axes, AxesZero, AxisArtistHelper, AxisArtistHelperRectlinear,
+from .axislines import Axes
+from .axislines import (  # noqa: F401
+    AxesZero, AxisArtistHelper, AxisArtistHelperRectlinear,
     GridHelperBase, GridHelperRectlinear, Subplot, SubplotZero)
-from .axis_artist import AxisArtist, GridlinesCollection
-from .grid_helper_curvelinear import GridHelperCurveLinear
-from .floating_axes import FloatingAxes, FloatingSubplot
+from .axis_artist import AxisArtist, GridlinesCollection  # noqa: F401
+from .grid_helper_curvelinear import GridHelperCurveLinear  # noqa: F401
+from .floating_axes import FloatingAxes, FloatingSubplot  # noqa: F401
 from mpl_toolkits.axes_grid1.parasite_axes import (
     host_axes_class_factory, parasite_axes_class_factory)
 
diff --git a/lib/pylab.py b/lib/pylab.py
index f9d135d36e2b..64ece55b1cb2 100644
--- a/lib/pylab.py
+++ b/lib/pylab.py
@@ -1,3 +1,3 @@
-from matplotlib.pylab import *
+from matplotlib.pylab import *  # noqa: F401, F403
 import matplotlib.pylab
 __doc__ = matplotlib.pylab.__doc__

From 33008a6629e032cd799a6c7b05b8c9ca2134a0c8 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 20 Dec 2023 01:53:20 -0500
Subject: [PATCH 0546/1120] MNT: Make some long line exceptions explicit

There's only one or two lines that need this exception, so the entire
file doesn't need to be exempted.
---
 .flake8                           | 2 --
 lib/matplotlib/_animation_data.py | 2 +-
 lib/matplotlib/font_manager.py    | 2 +-
 3 files changed, 2 insertions(+), 4 deletions(-)

diff --git a/.flake8 b/.flake8
index 6fc63524f227..9d83159f2585 100644
--- a/.flake8
+++ b/.flake8
@@ -31,12 +31,10 @@ exclude =
     .eggs
 
 per-file-ignores =
-    lib/matplotlib/_animation_data.py: E501
     lib/matplotlib/_cm.py: E122, E202, E203, E302
     lib/matplotlib/_mathtext.py: E221, E251
     lib/matplotlib/_mathtext_data.py: E122, E203, E261
     lib/matplotlib/backends/backend_template.py: F401
-    lib/matplotlib/font_manager.py: E501
     lib/matplotlib/mathtext.py: E221
     lib/matplotlib/pylab.py: F401, F403
     lib/matplotlib/pyplot.py: F811
diff --git a/lib/matplotlib/_animation_data.py b/lib/matplotlib/_animation_data.py
index 4bf2ae3148d2..8cbd312d8f14 100644
--- a/lib/matplotlib/_animation_data.py
+++ b/lib/matplotlib/_animation_data.py
@@ -251,7 +251,7 @@
     }}, 0);
   }})()
 </script>
-"""
+"""  # noqa: E501
 
 
 INCLUDED_FRAMES = """
diff --git a/lib/matplotlib/font_manager.py b/lib/matplotlib/font_manager.py
index 9996c59ea1d8..a06c853548f2 100644
--- a/lib/matplotlib/font_manager.py
+++ b/lib/matplotlib/font_manager.py
@@ -206,7 +206,7 @@ def win32FontDirectory():
       \\HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders\Fonts
 
     If the key is not found, ``%WINDIR%\Fonts`` will be returned.
-    """
+    """  # noqa: E501
     import winreg
     try:
         with winreg.OpenKey(winreg.HKEY_CURRENT_USER, MSFolders) as user:

From 01e0541a175456810d0c21c63a94a54613af2537 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 20 Dec 2023 01:56:19 -0500
Subject: [PATCH 0547/1120] MNT: Fix E122 continuation line missing indentation

There are really not very many of these to justify exempting the entire
file, and they are easily fixed.
---
 .flake8                          |   4 +-
 lib/matplotlib/_cm.py            | 202 ++++++++++++++++---------------
 lib/matplotlib/_mathtext_data.py |  75 +++++-------
 3 files changed, 136 insertions(+), 145 deletions(-)

diff --git a/.flake8 b/.flake8
index 9d83159f2585..40c07e0e324b 100644
--- a/.flake8
+++ b/.flake8
@@ -31,9 +31,9 @@ exclude =
     .eggs
 
 per-file-ignores =
-    lib/matplotlib/_cm.py: E122, E202, E203, E302
+    lib/matplotlib/_cm.py: E202, E203, E302
     lib/matplotlib/_mathtext.py: E221, E251
-    lib/matplotlib/_mathtext_data.py: E122, E203, E261
+    lib/matplotlib/_mathtext_data.py: E203, E261
     lib/matplotlib/backends/backend_template.py: F401
     lib/matplotlib/mathtext.py: E221
     lib/matplotlib/pylab.py: F401, F403
diff --git a/lib/matplotlib/_cm.py b/lib/matplotlib/_cm.py
index b7a7c878957f..1f1c36ac3240 100644
--- a/lib/matplotlib/_cm.py
+++ b/lib/matplotlib/_cm.py
@@ -965,52 +965,55 @@ def _g36(x): return 2 * x - 1
 # gist_earth_data and gist_ncar_data were simplified by a script and some
 # manual effort.
 
-_gist_earth_data = \
-{'red': (
-(0.0, 0.0, 0.0000),
-(0.2824, 0.1882, 0.1882),
-(0.4588, 0.2714, 0.2714),
-(0.5490, 0.4719, 0.4719),
-(0.6980, 0.7176, 0.7176),
-(0.7882, 0.7553, 0.7553),
-(1.0000, 0.9922, 0.9922),
-), 'green': (
-(0.0, 0.0, 0.0000),
-(0.0275, 0.0000, 0.0000),
-(0.1098, 0.1893, 0.1893),
-(0.1647, 0.3035, 0.3035),
-(0.2078, 0.3841, 0.3841),
-(0.2824, 0.5020, 0.5020),
-(0.5216, 0.6397, 0.6397),
-(0.6980, 0.7171, 0.7171),
-(0.7882, 0.6392, 0.6392),
-(0.7922, 0.6413, 0.6413),
-(0.8000, 0.6447, 0.6447),
-(0.8078, 0.6481, 0.6481),
-(0.8157, 0.6549, 0.6549),
-(0.8667, 0.6991, 0.6991),
-(0.8745, 0.7103, 0.7103),
-(0.8824, 0.7216, 0.7216),
-(0.8902, 0.7323, 0.7323),
-(0.8980, 0.7430, 0.7430),
-(0.9412, 0.8275, 0.8275),
-(0.9569, 0.8635, 0.8635),
-(0.9647, 0.8816, 0.8816),
-(0.9961, 0.9733, 0.9733),
-(1.0000, 0.9843, 0.9843),
-), 'blue': (
-(0.0, 0.0, 0.0000),
-(0.0039, 0.1684, 0.1684),
-(0.0078, 0.2212, 0.2212),
-(0.0275, 0.4329, 0.4329),
-(0.0314, 0.4549, 0.4549),
-(0.2824, 0.5004, 0.5004),
-(0.4667, 0.2748, 0.2748),
-(0.5451, 0.3205, 0.3205),
-(0.7843, 0.3961, 0.3961),
-(0.8941, 0.6651, 0.6651),
-(1.0000, 0.9843, 0.9843),
-)}
+_gist_earth_data = {
+    'red': (
+        (0.0, 0.0, 0.0000),
+        (0.2824, 0.1882, 0.1882),
+        (0.4588, 0.2714, 0.2714),
+        (0.5490, 0.4719, 0.4719),
+        (0.6980, 0.7176, 0.7176),
+        (0.7882, 0.7553, 0.7553),
+        (1.0000, 0.9922, 0.9922),
+    ),
+    'green': (
+        (0.0, 0.0, 0.0000),
+        (0.0275, 0.0000, 0.0000),
+        (0.1098, 0.1893, 0.1893),
+        (0.1647, 0.3035, 0.3035),
+        (0.2078, 0.3841, 0.3841),
+        (0.2824, 0.5020, 0.5020),
+        (0.5216, 0.6397, 0.6397),
+        (0.6980, 0.7171, 0.7171),
+        (0.7882, 0.6392, 0.6392),
+        (0.7922, 0.6413, 0.6413),
+        (0.8000, 0.6447, 0.6447),
+        (0.8078, 0.6481, 0.6481),
+        (0.8157, 0.6549, 0.6549),
+        (0.8667, 0.6991, 0.6991),
+        (0.8745, 0.7103, 0.7103),
+        (0.8824, 0.7216, 0.7216),
+        (0.8902, 0.7323, 0.7323),
+        (0.8980, 0.7430, 0.7430),
+        (0.9412, 0.8275, 0.8275),
+        (0.9569, 0.8635, 0.8635),
+        (0.9647, 0.8816, 0.8816),
+        (0.9961, 0.9733, 0.9733),
+        (1.0000, 0.9843, 0.9843),
+    ),
+    'blue': (
+        (0.0, 0.0, 0.0000),
+        (0.0039, 0.1684, 0.1684),
+        (0.0078, 0.2212, 0.2212),
+        (0.0275, 0.4329, 0.4329),
+        (0.0314, 0.4549, 0.4549),
+        (0.2824, 0.5004, 0.5004),
+        (0.4667, 0.2748, 0.2748),
+        (0.5451, 0.3205, 0.3205),
+        (0.7843, 0.3961, 0.3961),
+        (0.8941, 0.6651, 0.6651),
+        (1.0000, 0.9843, 0.9843),
+    )
+}
 
 _gist_gray_data = {
         'red': gfunc[3],
@@ -1024,58 +1027,61 @@ def _gist_heat_blue(x): return 4 * x - 3
 _gist_heat_data = {
     'red': _gist_heat_red, 'green': _gist_heat_green, 'blue': _gist_heat_blue}
 
-_gist_ncar_data = \
-{'red': (
-(0.0, 0.0, 0.0000),
-(0.3098, 0.0000, 0.0000),
-(0.3725, 0.3993, 0.3993),
-(0.4235, 0.5003, 0.5003),
-(0.5333, 1.0000, 1.0000),
-(0.7922, 1.0000, 1.0000),
-(0.8471, 0.6218, 0.6218),
-(0.8980, 0.9235, 0.9235),
-(1.0000, 0.9961, 0.9961),
-), 'green': (
-(0.0, 0.0, 0.0000),
-(0.0510, 0.3722, 0.3722),
-(0.1059, 0.0000, 0.0000),
-(0.1569, 0.7202, 0.7202),
-(0.1608, 0.7537, 0.7537),
-(0.1647, 0.7752, 0.7752),
-(0.2157, 1.0000, 1.0000),
-(0.2588, 0.9804, 0.9804),
-(0.2706, 0.9804, 0.9804),
-(0.3176, 1.0000, 1.0000),
-(0.3686, 0.8081, 0.8081),
-(0.4275, 1.0000, 1.0000),
-(0.5216, 1.0000, 1.0000),
-(0.6314, 0.7292, 0.7292),
-(0.6863, 0.2796, 0.2796),
-(0.7451, 0.0000, 0.0000),
-(0.7922, 0.0000, 0.0000),
-(0.8431, 0.1753, 0.1753),
-(0.8980, 0.5000, 0.5000),
-(1.0000, 0.9725, 0.9725),
-), 'blue': (
-(0.0, 0.5020, 0.5020),
-(0.0510, 0.0222, 0.0222),
-(0.1098, 1.0000, 1.0000),
-(0.2039, 1.0000, 1.0000),
-(0.2627, 0.6145, 0.6145),
-(0.3216, 0.0000, 0.0000),
-(0.4157, 0.0000, 0.0000),
-(0.4745, 0.2342, 0.2342),
-(0.5333, 0.0000, 0.0000),
-(0.5804, 0.0000, 0.0000),
-(0.6314, 0.0549, 0.0549),
-(0.6902, 0.0000, 0.0000),
-(0.7373, 0.0000, 0.0000),
-(0.7922, 0.9738, 0.9738),
-(0.8000, 1.0000, 1.0000),
-(0.8431, 1.0000, 1.0000),
-(0.8980, 0.9341, 0.9341),
-(1.0000, 0.9961, 0.9961),
-)}
+_gist_ncar_data = {
+    'red': (
+        (0.0, 0.0, 0.0000),
+        (0.3098, 0.0000, 0.0000),
+        (0.3725, 0.3993, 0.3993),
+        (0.4235, 0.5003, 0.5003),
+        (0.5333, 1.0000, 1.0000),
+        (0.7922, 1.0000, 1.0000),
+        (0.8471, 0.6218, 0.6218),
+        (0.8980, 0.9235, 0.9235),
+        (1.0000, 0.9961, 0.9961),
+    ),
+    'green': (
+        (0.0, 0.0, 0.0000),
+        (0.0510, 0.3722, 0.3722),
+        (0.1059, 0.0000, 0.0000),
+        (0.1569, 0.7202, 0.7202),
+        (0.1608, 0.7537, 0.7537),
+        (0.1647, 0.7752, 0.7752),
+        (0.2157, 1.0000, 1.0000),
+        (0.2588, 0.9804, 0.9804),
+        (0.2706, 0.9804, 0.9804),
+        (0.3176, 1.0000, 1.0000),
+        (0.3686, 0.8081, 0.8081),
+        (0.4275, 1.0000, 1.0000),
+        (0.5216, 1.0000, 1.0000),
+        (0.6314, 0.7292, 0.7292),
+        (0.6863, 0.2796, 0.2796),
+        (0.7451, 0.0000, 0.0000),
+        (0.7922, 0.0000, 0.0000),
+        (0.8431, 0.1753, 0.1753),
+        (0.8980, 0.5000, 0.5000),
+        (1.0000, 0.9725, 0.9725),
+    ),
+    'blue': (
+        (0.0, 0.5020, 0.5020),
+        (0.0510, 0.0222, 0.0222),
+        (0.1098, 1.0000, 1.0000),
+        (0.2039, 1.0000, 1.0000),
+        (0.2627, 0.6145, 0.6145),
+        (0.3216, 0.0000, 0.0000),
+        (0.4157, 0.0000, 0.0000),
+        (0.4745, 0.2342, 0.2342),
+        (0.5333, 0.0000, 0.0000),
+        (0.5804, 0.0000, 0.0000),
+        (0.6314, 0.0549, 0.0549),
+        (0.6902, 0.0000, 0.0000),
+        (0.7373, 0.0000, 0.0000),
+        (0.7922, 0.9738, 0.9738),
+        (0.8000, 1.0000, 1.0000),
+        (0.8431, 1.0000, 1.0000),
+        (0.8980, 0.9341, 0.9341),
+        (1.0000, 0.9961, 0.9961),
+    )
+}
 
 _gist_rainbow_data = (
         (0.000, (1.00, 0.00, 0.16)),
diff --git a/lib/matplotlib/_mathtext_data.py b/lib/matplotlib/_mathtext_data.py
index 8f0aece5de92..8928800a108b 100644
--- a/lib/matplotlib/_mathtext_data.py
+++ b/lib/matplotlib/_mathtext_data.py
@@ -1118,10 +1118,8 @@
 
 _stix_virtual_fonts: dict[str, Union[dict[
     str, list[_EntryTypeIn]], list[_EntryTypeIn]]] = {
-    'bb':
-        {
-        "rm":
-            [
+    'bb': {
+        "rm": [
             ("\N{DIGIT ZERO}",
              "\N{DIGIT NINE}",
              "rm",
@@ -1194,9 +1192,8 @@
              "\N{GREEK SMALL LETTER PI}",
              "rm",
              "\N{DOUBLE-STRUCK SMALL PI}"),
-            ],
-        "it":
-            [
+        ],
+        "it": [
             ("\N{DIGIT ZERO}",
              "\N{DIGIT NINE}",
              "rm",
@@ -1289,9 +1286,8 @@
              "\N{GREEK SMALL LETTER PI}",
              "it",
              "\N{DOUBLE-STRUCK SMALL PI}"),
-            ],
-        "bf":
-            [
+        ],
+        "bf": [
             ("\N{DIGIT ZERO}",
              "\N{DIGIT NINE}",
              "rm",
@@ -1384,19 +1380,16 @@
              "\N{GREEK SMALL LETTER PI}",
              "bf",
              "\N{DOUBLE-STRUCK SMALL PI}"),
-            ],
-        },
-    'cal':
-        [
+        ],
+    },
+    'cal': [
         ("\N{LATIN CAPITAL LETTER A}",
          "\N{LATIN CAPITAL LETTER Z}",
          "it",
          0xe22d),
-        ],
-    'frak':
-        {
-        "rm":
-            [
+    ],
+    'frak': {
+        "rm": [
             ("\N{LATIN CAPITAL LETTER A}",
              "\N{LATIN CAPITAL LETTER B}",
              "rm",
@@ -1438,8 +1431,7 @@
              "rm",
              "\N{MATHEMATICAL FRAKTUR SMALL A}"),
             ],
-        "bf":
-            [
+        "bf": [
             ("\N{LATIN CAPITAL LETTER A}",
              "\N{LATIN CAPITAL LETTER Z}",
              "bf",
@@ -1448,10 +1440,9 @@
              "\N{LATIN SMALL LETTER Z}",
              "bf",
              "\N{MATHEMATICAL BOLD FRAKTUR SMALL A}"),
-            ],
-        },
-    'scr':
-        [
+        ],
+    },
+    'scr': [
         ("\N{LATIN CAPITAL LETTER A}",
          "\N{LATIN CAPITAL LETTER A}",
          "it",
@@ -1532,11 +1523,9 @@
          "\N{LATIN SMALL LETTER Z}",
          "it",
          "\N{MATHEMATICAL SCRIPT SMALL P}"),
-        ],
-    'sf':
-        {
-        "rm":
-            [
+    ],
+    'sf': {
+        "rm": [
             ("\N{DIGIT ZERO}",
              "\N{DIGIT NINE}",
              "rm",
@@ -1581,9 +1570,8 @@
              "\N{PARTIAL DIFFERENTIAL}",
              "rm",
              0xe17c),
-            ],
-        "it":
-            [
+        ],
+        "it": [
             # These numerals are actually upright.  We don't actually
             # want italic numerals ever.
             ("\N{DIGIT ZERO}",
@@ -1626,9 +1614,8 @@
              "\N{GREEK LUNATE EPSILON SYMBOL}",
              "it",
              0xe1f1),
-            ],
-        "bf":
-            [
+        ],
+        "bf": [
             ("\N{DIGIT ZERO}",
              "\N{DIGIT NINE}",
              "bf",
@@ -1681,9 +1668,8 @@
              "\N{NABLA}",
              "bf",
              "\N{MATHEMATICAL SANS-SERIF BOLD NABLA}"),
-            ],
-        "bfit":
-            [
+        ],
+        "bfit": [
             ("\N{LATIN CAPITAL LETTER A}",
              "\N{LATIN CAPITAL LETTER Z}",
              "bfit",
@@ -1700,10 +1686,9 @@
              "\N{GREEK SMALL LETTER OMEGA}",
              "bfit",
              "\N{MATHEMATICAL BOLD ITALIC SMALL ALPHA}"),
-            ],
-        },
-    'tt':
-        [
+        ],
+    },
+    'tt': [
         ("\N{DIGIT ZERO}",
          "\N{DIGIT NINE}",
          "rm",
@@ -1716,8 +1701,8 @@
          "\N{LATIN SMALL LETTER Z}",
          "rm",
          "\N{MATHEMATICAL MONOSPACE SMALL A}")
-        ],
-    }
+    ],
+}
 
 
 @overload

From c36259ffd0922aef93667d50dd0f17f7d4837643 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Wed, 20 Dec 2023 11:25:29 -0500
Subject: [PATCH 0548/1120] DOC: typo fix in contribute doc

Accidentally used \ rather than / for a `` :file:`matplotlib/lib` `` so the \ didn't get rendered.
---
 doc/devel/contribute.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/devel/contribute.rst b/doc/devel/contribute.rst
index 9eacb2032dfd..b582aa455341 100644
--- a/doc/devel/contribute.rst
+++ b/doc/devel/contribute.rst
@@ -249,7 +249,7 @@ you can:
 - Write or update an :ref:`example plot <gallery>`
 - Write or update a comprehensive :ref:`tutorial <tutorials>`
 
-Our code is documented inline in the source code files in :file:`matplotlib\lib`.
+Our code is documented inline in the source code files in :file:`matplotlib/lib`.
 Our website structure mirrors our folder structure, meaning that a narrative
 document's URL roughly corresponds to its location in our folder structure:
 

From e5562bb7453c50321070784372cefa75339992e7 Mon Sep 17 00:00:00 2001
From: zoehcycy <46927076+zoehcycy@users.noreply.github.com>
Date: Wed, 20 Dec 2023 11:13:51 -0800
Subject: [PATCH 0549/1120] =?UTF-8?q?Check=20if=20the=20mappable=20is=20in?=
 =?UTF-8?q?=20a=20different=20Figure=20than=20the=20one=20fig.color?=
 =?UTF-8?q?=E2=80=A6=20(#27458)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* Check if the mappable is in a different Figure than the one fig.colorbar is being called on.
Ignore this check if the mappable has no host Figure.
Warn in case of a mismatch.

* Add figure repr in warning message.

* Use _api.warn_external instead of _log.warning. Only warn when the mismatch is inferred.

* Delete test_colorbar::test_colorbar_wrong_figure.

* Warn in all mismatches, inferred or not.

* Revert deletion of test_colorbar_wrong_figure, with warning test.

* Linting fixes

* Catch newly added warning raised in other test cases.

* Catch warning in existing test cases.

* edge case: subfigure. only warn when top level artist don't match.

* flake8 code style check fix

* code style fix.

* subfigure test cases revert: no warning.

* Fix edge case: axes.remove(); passing correct  pcolormesh object in galleries.

* remove redundant lines

* code stylistic fix
---
 .../users_explain/axes/colorbar_placement.py  |  4 +-
 lib/matplotlib/figure.py                      | 13 +++++++
 lib/matplotlib/tests/test_colorbar.py         |  3 +-
 lib/matplotlib/tests/test_figure.py           | 37 ++++++++++++++++++-
 4 files changed, 53 insertions(+), 4 deletions(-)

diff --git a/galleries/users_explain/axes/colorbar_placement.py b/galleries/users_explain/axes/colorbar_placement.py
index 8dbc2a356cb1..919600b070f3 100644
--- a/galleries/users_explain/axes/colorbar_placement.py
+++ b/galleries/users_explain/axes/colorbar_placement.py
@@ -53,7 +53,7 @@
 fig, axs = plt.subplots(2, 1, figsize=(4, 5), sharex=True)
 X = np.random.randn(20, 20)
 axs[0].plot(np.sum(X, axis=0))
-axs[1].pcolormesh(X)
+pcm = axs[1].pcolormesh(X)
 fig.colorbar(pcm, ax=axs[1], shrink=0.6)
 
 # %%
@@ -63,7 +63,7 @@
 
 fig, axs = plt.subplots(2, 1, figsize=(4, 5), sharex=True, layout='constrained')
 axs[0].plot(np.sum(X, axis=0))
-axs[1].pcolormesh(X)
+pcm = axs[1].pcolormesh(X)
 fig.colorbar(pcm, ax=axs[1], shrink=0.6)
 
 # %%
diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
index 11b42b1e1ac7..dd76c932b01e 100644
--- a/lib/matplotlib/figure.py
+++ b/lib/matplotlib/figure.py
@@ -1242,6 +1242,19 @@ def colorbar(
             fig.sca(current_ax)
             cax.grid(visible=False, which='both', axis='both')
 
+        if hasattr(mappable, "figure") and mappable.figure is not None:
+            # Get top level artists
+            mappable_host_fig = mappable.figure
+            if isinstance(mappable_host_fig, mpl.figure.SubFigure):
+                mappable_host_fig = mappable_host_fig.figure
+            # Warn in case of mismatch
+            if mappable_host_fig is not self.figure:
+                _api.warn_external(
+                        f'Adding colorbar to a different Figure '
+                        f'{repr(mappable.figure)} than '
+                        f'{repr(self.figure)} which '
+                        f'fig.colorbar is called on.')
+
         NON_COLORBAR_KEYS = [  # remove kws that cannot be passed to Colorbar
             'fraction', 'pad', 'shrink', 'aspect', 'anchor', 'panchor']
         cb = cbar.Colorbar(cax, mappable, **{
diff --git a/lib/matplotlib/tests/test_colorbar.py b/lib/matplotlib/tests/test_colorbar.py
index 509d08dae183..4566ce449aac 100644
--- a/lib/matplotlib/tests/test_colorbar.py
+++ b/lib/matplotlib/tests/test_colorbar.py
@@ -1228,7 +1228,8 @@ def test_colorbar_wrong_figure():
     im = fig_cl.add_subplot().imshow([[0, 1]])
     # Make sure this doesn't try to setup a gridspec-controlled colorbar on fig_cl,
     # which would crash CL.
-    fig_tl.colorbar(im)
+    with pytest.warns(UserWarning, match="different Figure"):
+        fig_tl.colorbar(im)
     fig_tl.draw_without_rendering()
     fig_cl.draw_without_rendering()
 
diff --git a/lib/matplotlib/tests/test_figure.py b/lib/matplotlib/tests/test_figure.py
index 99b2602bc4a7..0e1706f37b59 100644
--- a/lib/matplotlib/tests/test_figure.py
+++ b/lib/matplotlib/tests/test_figure.py
@@ -1358,7 +1358,6 @@ def test_subfigure_double():
         ax.set_xlabel('x-label', fontsize=fontsize)
         ax.set_ylabel('y-label', fontsize=fontsize)
         ax.set_title('Title', fontsize=fontsize)
-
     subfigsnest[0].colorbar(pc, ax=axsnest0)
 
     subfigsnest[1].suptitle('subfigsnest[1]')
@@ -1665,3 +1664,39 @@ def test_not_visible_figure():
     fig.savefig(buf, format='svg')
     buf.seek(0)
     assert '<g ' not in buf.read()
+
+
+def test_warn_colorbar_mismatch():
+    fig1, ax1 = plt.subplots()
+    fig2, (ax2_1, ax2_2) = plt.subplots(2)
+    im = ax1.imshow([[1, 2], [3, 4]])
+
+    fig1.colorbar(im)  # should not warn
+    with pytest.warns(UserWarning, match="different Figure"):
+        fig2.colorbar(im)
+    # warn mismatch even when the host figure is not inferred
+    with pytest.warns(UserWarning, match="different Figure"):
+        fig2.colorbar(im, ax=ax1)
+    with pytest.warns(UserWarning, match="different Figure"):
+        fig2.colorbar(im, ax=ax2_1)
+    with pytest.warns(UserWarning, match="different Figure"):
+        fig2.colorbar(im, cax=ax2_2)
+
+    # edge case: only compare top level artist in case of subfigure
+    fig3 = plt.figure()
+    fig4 = plt.figure()
+    subfig3_1 = fig3.subfigures()
+    subfig3_2 = fig3.subfigures()
+    subfig4_1 = fig4.subfigures()
+    ax3_1 = subfig3_1.subplots()
+    ax3_2 = subfig3_1.subplots()
+    ax4_1 = subfig4_1.subplots()
+    im3_1 = ax3_1.imshow([[1, 2], [3, 4]])
+    im3_2 = ax3_2.imshow([[1, 2], [3, 4]])
+    im4_1 = ax4_1.imshow([[1, 2], [3, 4]])
+
+    fig3.colorbar(im3_1)   # should not warn
+    subfig3_1.colorbar(im3_1)   # should not warn
+    subfig3_1.colorbar(im3_2)   # should not warn
+    with pytest.warns(UserWarning, match="different Figure"):
+        subfig3_1.colorbar(im4_1)

From aaf53c9d4b7d014daacf6dcaa3ac30d8306aa66b Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Thu, 24 Mar 2022 23:06:28 +0100
Subject: [PATCH 0550/1120] Proof of concept for adding kwdoc content to
 properties using a decorator

---
 lib/matplotlib/_docstring.py  | 28 ++++++++++++++++++++++++++++
 lib/matplotlib/_docstring.pyi |  3 +++
 lib/matplotlib/artist.py      |  3 +++
 lib/matplotlib/text.py        |  1 +
 4 files changed, 35 insertions(+)

diff --git a/lib/matplotlib/_docstring.py b/lib/matplotlib/_docstring.py
index ecd209ca0853..b49d5b43f068 100644
--- a/lib/matplotlib/_docstring.py
+++ b/lib/matplotlib/_docstring.py
@@ -3,6 +3,34 @@
 from . import _api
 
 
+def kwarg_doc(text):
+    """
+    Decorator for defining the kwdoc documentation of artist properties.
+
+    This decorator can be applied to artist property setter methods.
+    The given text is stored in a privat attribute ``_kwarg_doc`` on
+    the method.  It is used to overwrite auto-generated documentation
+    in the *kwdoc list* for artists. The kwdoc list is used to document
+    ``**kwargs`` when they are properties of an artist. See e.g. the
+    ``**kwargs`` section in `.Axes.text`.
+
+    The text should contain the supported types as well as the default value
+    if applicable, e.g.:
+
+        @_docstring.kwarg_doc("bool, default: :rc:`text.usetex`")
+        def set_usetex(self, usetex):
+
+    See Also
+    --------
+    matplotlib.artist.kwdoc
+
+    """
+    def decorator(func):
+        func._kwarg_doc = text
+        return func
+    return decorator
+
+
 class Substitution:
     """
     A decorator that performs %-substitution on an object's docstring.
diff --git a/lib/matplotlib/_docstring.pyi b/lib/matplotlib/_docstring.pyi
index 0377dc5fe95b..bcb4b29ab922 100644
--- a/lib/matplotlib/_docstring.pyi
+++ b/lib/matplotlib/_docstring.pyi
@@ -4,6 +4,9 @@ from typing import Any, Callable, TypeVar, overload
 _T = TypeVar('_T')
 
 
+def kwarg_doc(text: str) -> Callable[[_T], _T]: ...
+
+
 class Substitution:
     @overload
     def __init__(self, *args: str): ...
diff --git a/lib/matplotlib/artist.py b/lib/matplotlib/artist.py
index d0db945ab3e5..212a1c99241d 100644
--- a/lib/matplotlib/artist.py
+++ b/lib/matplotlib/artist.py
@@ -1482,6 +1482,9 @@ def get_valid_values(self, attr):
             raise AttributeError(f'{self.o} has no function {name}')
         func = getattr(self.o, name)
 
+        if hasattr(func, '_kwarg_doc'):
+            return func._kwarg_doc
+
         docstring = inspect.getdoc(func)
         if docstring is None:
             return 'unknown'
diff --git a/lib/matplotlib/text.py b/lib/matplotlib/text.py
index 8734131dddc9..f328c89d6559 100644
--- a/lib/matplotlib/text.py
+++ b/lib/matplotlib/text.py
@@ -1314,6 +1314,7 @@ def set_fontproperties(self, fp):
         self._fontproperties = FontProperties._from_any(fp).copy()
         self.stale = True
 
+    @_docstring.kwarg_doc("bool, default: :rc:`text.usetex`")
     def set_usetex(self, usetex):
         """
         Parameters

From d7946fbf02377eb834eba9b579e06d3c2a6cf3cd Mon Sep 17 00:00:00 2001
From: Cyril Gadal <cyril.gadal@imft.fr>
Date: Thu, 21 Dec 2023 17:53:10 +0100
Subject: [PATCH 0551/1120] Changes to SubFigures so it behave like a regular
 artist:

- changing self._get_draw_artists() so subfigs are now part of the
  artists list.
- changing draw() methods so subfigs are drawn like regular artists
---
 lib/matplotlib/figure.py | 11 -----------
 1 file changed, 11 deletions(-)

diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
index dd76c932b01e..5a231d27fa5f 100644
--- a/lib/matplotlib/figure.py
+++ b/lib/matplotlib/figure.py
@@ -152,12 +152,6 @@ def __init__(self, **kwargs):
     def _get_draw_artists(self, renderer):
         """Also runs apply_aspect"""
         artists = self.get_children()
-        for sfig in self.subfigs:
-            artists.remove(sfig)
-            childa = sfig.get_children()
-            for child in childa:
-                if child in artists:
-                    artists.remove(child)
 
         artists.remove(self.patch)
         artists = sorted(
@@ -2310,8 +2304,6 @@ def draw(self, renderer):
             self.patch.draw(renderer)
             mimage._draw_list_compositing_images(
                 renderer, self, artists, self.figure.suppressComposite)
-            for sfig in self.subfigs:
-                sfig.draw(renderer)
             renderer.close_group('subfigure')
 
         finally:
@@ -3117,9 +3109,6 @@ def draw(self, renderer):
                 mimage._draw_list_compositing_images(
                     renderer, self, artists, self.suppressComposite)
 
-                for sfig in self.subfigs:
-                    sfig.draw(renderer)
-
                 renderer.close_group('figure')
             finally:
                 self.stale = False

From 30a6af33b62f72a5005c42fb0e20a00c2988a612 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Mon, 16 Oct 2023 23:17:34 +0200
Subject: [PATCH 0552/1120] Use Axes instead of axes core library code

Part of #18726.
---
 lib/matplotlib/_constrained_layout.py         | 44 ++++++------
 lib/matplotlib/_layoutgrid.py                 |  4 +-
 lib/matplotlib/_tight_layout.py               | 30 ++++----
 lib/matplotlib/animation.py                   |  2 +-
 lib/matplotlib/artist.py                      |  8 +--
 lib/matplotlib/axes/_axes.py                  | 10 +--
 lib/matplotlib/axes/_base.py                  |  8 +--
 lib/matplotlib/axes/_secondary_axes.py        | 26 +++----
 lib/matplotlib/axis.py                        |  6 +-
 lib/matplotlib/backend_bases.py               |  2 +-
 lib/matplotlib/backend_tools.py               | 18 ++---
 lib/matplotlib/backends/backend_qt.py         |  4 +-
 lib/matplotlib/colorbar.py                    | 40 +++++------
 lib/matplotlib/contour.py                     |  4 +-
 lib/matplotlib/figure.py                      | 68 +++++++++----------
 lib/matplotlib/gridspec.py                    |  2 +-
 lib/matplotlib/image.py                       | 18 ++---
 lib/matplotlib/layout_engine.py               | 14 ++--
 lib/matplotlib/legend.py                      | 20 +++---
 lib/matplotlib/lines.py                       |  6 +-
 lib/matplotlib/offsetbox.py                   |  8 +--
 lib/matplotlib/patches.py                     | 24 +++----
 lib/matplotlib/projections/__init__.py        | 10 +--
 lib/matplotlib/projections/polar.py           |  6 +-
 lib/matplotlib/pyplot.py                      | 68 +++++++++----------
 lib/matplotlib/rcsetup.py                     | 20 +++---
 lib/matplotlib/sankey.py                      |  4 +-
 lib/matplotlib/table.py                       |  2 +-
 lib/matplotlib/testing/widgets.py             |  4 +-
 lib/matplotlib/tests/test_axes.py             |  2 +-
 .../tests/test_constrainedlayout.py           |  2 +-
 lib/matplotlib/tests/test_polar.py            |  2 +-
 lib/matplotlib/tests/test_skew.py             |  2 +-
 lib/matplotlib/tests/test_ticker.py           |  2 +-
 lib/matplotlib/tests/test_tightlayout.py      |  2 +-
 lib/matplotlib/text.py                        | 18 ++---
 lib/matplotlib/ticker.py                      |  4 +-
 lib/matplotlib/widgets.py                     |  6 +-
 lib/mpl_toolkits/mplot3d/axes3d.py            | 24 +++----
 39 files changed, 272 insertions(+), 272 deletions(-)

diff --git a/lib/matplotlib/_constrained_layout.py b/lib/matplotlib/_constrained_layout.py
index 907e7a24976e..b960f363e9d4 100644
--- a/lib/matplotlib/_constrained_layout.py
+++ b/lib/matplotlib/_constrained_layout.py
@@ -1,11 +1,11 @@
 """
-Adjust subplot layouts so that there are no overlapping axes or axes
-decorations.  All axes decorations are dealt with (labels, ticks, titles,
+Adjust subplot layouts so that there are no overlapping Axes or Axes
+decorations.  All Axes decorations are dealt with (labels, ticks, titles,
 ticklabels) and some dependent artists are also dealt with (colorbar,
 suptitle).
 
 Layout is done via `~matplotlib.gridspec`, with one constraint per gridspec,
-so it is possible to have overlapping axes if the gridspecs overlap (i.e.
+so it is possible to have overlapping Axes if the gridspecs overlap (i.e.
 using `~matplotlib.gridspec.GridSpecFromSubplotSpec`).  Axes placed using
 ``figure.subplots()`` or ``figure.add_subplots()`` will participate in the
 layout.  Axes manually placed via ``figure.add_axes()`` will not.
@@ -33,8 +33,8 @@
 is the width or height of each column/row minus the size of the margins.
 
 Then the size of the margins for each row and column are determined as the
-max width of the decorators on each axes that has decorators in that margin.
-For instance, a normal axes would have a left margin that includes the
+max width of the decorators on each Axes that has decorators in that margin.
+For instance, a normal Axes would have a left margin that includes the
 left ticklabels, and the ylabel if it exists.  The right margin may include a
 colorbar, the bottom margin the xaxis decorations, and the top margin the
 title.
@@ -73,11 +73,11 @@ def do_constrained_layout(fig, h_pad, w_pad,
         `.Figure` instance to do the layout in.
 
     h_pad, w_pad : float
-      Padding around the axes elements in figure-normalized units.
+      Padding around the Axes elements in figure-normalized units.
 
     hspace, wspace : float
        Fraction of the figure to dedicate to space between the
-       axes.  These are evenly spread between the gaps between the axes.
+       Axes.  These are evenly spread between the gaps between the Axes.
        A value of 0.2 for a three-column layout would have a space
        of 0.1 of the figure width between each column.
        If h/wspace < h/w_pad, then the pads are used instead.
@@ -111,7 +111,7 @@ def do_constrained_layout(fig, h_pad, w_pad,
         # larger/smaller).  This second reposition tends to be much milder,
         # so doing twice makes things work OK.
 
-        # make margins for all the axes and subfigures in the
+        # make margins for all the Axes and subfigures in the
         # figure.  Add margins for colorbars...
         make_layout_margins(layoutgrids, fig, renderer, h_pad=h_pad,
                             w_pad=w_pad, hspace=hspace, wspace=wspace)
@@ -128,7 +128,7 @@ def do_constrained_layout(fig, h_pad, w_pad,
 
         warn_collapsed = ('constrained_layout not applied because '
                           'axes sizes collapsed to zero.  Try making '
-                          'figure larger or axes decorations smaller.')
+                          'figure larger or Axes decorations smaller.')
         if check_no_collapsed_axes(layoutgrids, fig):
             reposition_axes(layoutgrids, fig, renderer, h_pad=h_pad,
                             w_pad=w_pad, hspace=hspace, wspace=wspace)
@@ -152,7 +152,7 @@ def make_layoutgrids(fig, layoutgrids, rect=(0, 0, 1, 1)):
 
     (Sub)Figures get a layoutgrid so we can have figure margins.
 
-    Gridspecs that are attached to axes get a layoutgrid so axes
+    Gridspecs that are attached to Axes get a layoutgrid so Axes
     can have margins.
     """
 
@@ -182,7 +182,7 @@ def make_layoutgrids(fig, layoutgrids, rect=(0, 0, 1, 1)):
     for sfig in fig.subfigs:
         layoutgrids = make_layoutgrids(sfig, layoutgrids)
 
-    # for each axes at the local level add its gridspec:
+    # for each Axes at the local level add its gridspec:
     for ax in fig._localaxes:
         gs = ax.get_gridspec()
         if gs is not None:
@@ -239,7 +239,7 @@ def make_layoutgrids_gs(layoutgrids, gs):
 
 def check_no_collapsed_axes(layoutgrids, fig):
     """
-    Check that no axes have collapsed to zero size.
+    Check that no Axes have collapsed to zero size.
     """
     for sfig in fig.subfigs:
         ok = check_no_collapsed_axes(layoutgrids, sfig)
@@ -270,7 +270,7 @@ def compress_fixed_aspect(layoutgrids, fig):
             extraw = np.zeros(gs.ncols)
             extrah = np.zeros(gs.nrows)
         elif _gs != gs:
-            raise ValueError('Cannot do compressed layout if axes are not'
+            raise ValueError('Cannot do compressed layout if Axes are not'
                              'all from the same gridspec')
         orig = ax.get_position(original=True)
         actual = ax.get_position(original=False)
@@ -282,7 +282,7 @@ def compress_fixed_aspect(layoutgrids, fig):
             extrah[sub.rowspan] = np.maximum(extrah[sub.rowspan], dh)
 
     if gs is None:
-        raise ValueError('Cannot do compressed layout if no axes '
+        raise ValueError('Cannot do compressed layout if no Axes '
                          'are part of a gridspec.')
     w = np.sum(extraw) / 2
     layoutgrids[fig].edit_margin_min('left', w)
@@ -313,7 +313,7 @@ def get_margin_from_padding(obj, *, w_pad=0, h_pad=0,
     nrows, ncols = gs.get_geometry()
     # there are two margins for each direction.  The "cb"
     # margins are for pads and colorbars, the non-"cb" are
-    # for the axes decorations (labels etc).
+    # for the Axes decorations (labels etc).
     margin = {'leftcb': w_pad, 'rightcb': w_pad,
               'bottomcb': h_pad, 'topcb': h_pad,
               'left': 0, 'right': 0,
@@ -335,7 +335,7 @@ def get_margin_from_padding(obj, *, w_pad=0, h_pad=0,
 def make_layout_margins(layoutgrids, fig, renderer, *, w_pad=0, h_pad=0,
                         hspace=0, wspace=0):
     """
-    For each axes, make a margin between the *pos* layoutbox and the
+    For each Axes, make a margin between the *pos* layoutbox and the
     *axes* layoutbox be a minimum size that can accommodate the
     decorations on the axis.
 
@@ -379,7 +379,7 @@ def make_layout_margins(layoutgrids, fig, renderer, *, w_pad=0, h_pad=0,
         margin = get_margin_from_padding(ax, w_pad=w_pad, h_pad=h_pad,
                                          hspace=hspace, wspace=wspace)
         pos, bbox = get_pos_and_bbox(ax, renderer)
-        # the margin is the distance between the bounding box of the axes
+        # the margin is the distance between the bounding box of the Axes
         # and its position (plus the padding from above)
         margin['left'] += pos.x0 - bbox.x0
         margin['right'] += bbox.x1 - pos.x1
@@ -388,7 +388,7 @@ def make_layout_margins(layoutgrids, fig, renderer, *, w_pad=0, h_pad=0,
         margin['top'] += bbox.y1 - pos.y1
 
         # make margin for colorbars.  These margins go in the
-        # padding margin, versus the margin for axes decorators.
+        # padding margin, versus the margin for Axes decorators.
         for cbax in ax._colorbars:
             # note pad is a fraction of the parent width...
             pad = colorbar_get_pad(layoutgrids, cbax)
@@ -493,14 +493,14 @@ def match_submerged_margins(layoutgrids, fig):
     """
     Make the margins that are submerged inside an Axes the same size.
 
-    This allows axes that span two columns (or rows) that are offset
+    This allows Axes that span two columns (or rows) that are offset
     from one another to have the same size.
 
     This gives the proper layout for something like::
         fig = plt.figure(constrained_layout=True)
         axs = fig.subplot_mosaic("AAAB\nCCDD")
 
-    Without this routine, the axes D will be wider than C, because the
+    Without this routine, the Axes D will be wider than C, because the
     margin width between the two columns in C has no width by default,
     whereas the margins between the two columns of D are set by the
     width of the margin between A and B. However, obviously the user would
@@ -613,7 +613,7 @@ def get_cb_parent_spans(cbax):
 
 def get_pos_and_bbox(ax, renderer):
     """
-    Get the position and the bbox for the axes.
+    Get the position and the bbox for the Axes.
 
     Parameters
     ----------
@@ -642,7 +642,7 @@ def get_pos_and_bbox(ax, renderer):
 def reposition_axes(layoutgrids, fig, renderer, *,
                     w_pad=0, h_pad=0, hspace=0, wspace=0):
     """
-    Reposition all the axes based on the new inner bounding box.
+    Reposition all the Axes based on the new inner bounding box.
     """
     trans_fig_to_subfig = fig.transFigure - fig.transSubfigure
     for sfig in fig.subfigs:
diff --git a/lib/matplotlib/_layoutgrid.py b/lib/matplotlib/_layoutgrid.py
index 8bef9283112c..8f81b14765b6 100644
--- a/lib/matplotlib/_layoutgrid.py
+++ b/lib/matplotlib/_layoutgrid.py
@@ -5,8 +5,8 @@
 
 Each box is defined by left[ncols], right[ncols], bottom[nrows] and top[nrows],
 and by two editable margins for each side.  The main margin gets its value
-set by the size of ticklabels, titles, etc on each axes that is in the figure.
-The outer margin is the padding around the axes, and space for any
+set by the size of ticklabels, titles, etc on each Axes that is in the figure.
+The outer margin is the padding around the Axes, and space for any
 colorbars.
 
 The "inner" widths and heights of these boxes are then constrained to be the
diff --git a/lib/matplotlib/_tight_layout.py b/lib/matplotlib/_tight_layout.py
index e99ba49bd284..548da79fff04 100644
--- a/lib/matplotlib/_tight_layout.py
+++ b/lib/matplotlib/_tight_layout.py
@@ -1,7 +1,7 @@
 """
 Routines to adjust subplot params so that subplots are
-nicely fit in the figure. In doing so, only axis labels, tick labels, axes
-titles and offsetboxes that are anchored to axes are currently considered.
+nicely fit in the figure. In doing so, only axis labels, tick labels, Axes
+titles and offsetboxes that are anchored to Axes are currently considered.
 
 Internally, this module assumes that the margins (left margin, etc.) which are
 differences between ``Axes.get_tightbbox`` and ``Axes.bbox`` are independent of
@@ -22,7 +22,7 @@ def _auto_adjust_subplotpars(
         ax_bbox_list=None, pad=1.08, h_pad=None, w_pad=None, rect=None):
     """
     Return a dict of subplot parameters to adjust spacing between subplots
-    or ``None`` if resulting axes would have zero height or width.
+    or ``None`` if resulting Axes would have zero height or width.
 
     Note that this function ignores geometry information of subplot itself, but
     uses what is given by the *shape* and *subplot_list* parameters.  Also, the
@@ -91,7 +91,7 @@ def _auto_adjust_subplotpars(
 
     fig_width_inch, fig_height_inch = fig.get_size_inches()
 
-    # margins can be negative for axes with aspect applied, so use max(, 0) to
+    # margins can be negative for Axes with aspect applied, so use max(, 0) to
     # make them nonnegative.
     if not margin_left:
         margin_left = max(hspaces[:, 0].max(), 0) + pad_inch/fig_width_inch
@@ -119,12 +119,12 @@ def _auto_adjust_subplotpars(
     if margin_left + margin_right >= 1:
         _api.warn_external('Tight layout not applied. The left and right '
                            'margins cannot be made large enough to '
-                           'accommodate all axes decorations.')
+                           'accommodate all Axes decorations.')
         return None
     if margin_bottom + margin_top >= 1:
         _api.warn_external('Tight layout not applied. The bottom and top '
                            'margins cannot be made large enough to '
-                           'accommodate all axes decorations.')
+                           'accommodate all Axes decorations.')
         return None
 
     kwargs = dict(left=margin_left,
@@ -138,8 +138,8 @@ def _auto_adjust_subplotpars(
         h_axes = (1 - margin_right - margin_left - hspace * (cols - 1)) / cols
         if h_axes < 0:
             _api.warn_external('Tight layout not applied. tight_layout '
-                               'cannot make axes width small enough to '
-                               'accommodate all axes decorations')
+                               'cannot make Axes width small enough to '
+                               'accommodate all Axes decorations')
             return None
         else:
             kwargs["wspace"] = hspace / h_axes
@@ -148,8 +148,8 @@ def _auto_adjust_subplotpars(
         v_axes = (1 - margin_top - margin_bottom - vspace * (rows - 1)) / rows
         if v_axes < 0:
             _api.warn_external('Tight layout not applied. tight_layout '
-                               'cannot make axes height small enough to '
-                               'accommodate all axes decorations.')
+                               'cannot make Axes height small enough to '
+                               'accommodate all Axes decorations.')
             return None
         else:
             kwargs["hspace"] = vspace / v_axes
@@ -159,9 +159,9 @@ def _auto_adjust_subplotpars(
 
 def get_subplotspec_list(axes_list, grid_spec=None):
     """
-    Return a list of subplotspec from the given list of axes.
+    Return a list of subplotspec from the given list of Axes.
 
-    For an instance of axes that does not support subplotspec, None is inserted
+    For an instance of Axes that does not support subplotspec, None is inserted
     in the list.
 
     If grid_spec is given, None is inserted for those not from the given
@@ -201,7 +201,7 @@ def get_tight_layout_figure(fig, axes_list, subplotspec_list, renderer,
     fig : Figure
     axes_list : list of Axes
     subplotspec_list : list of `.SubplotSpec`
-        The subplotspecs of each axes.
+        The subplotspecs of each Axes.
     renderer : renderer
     pad : float
         Padding between the figure edge and the edges of subplots, as a
@@ -221,7 +221,7 @@ def get_tight_layout_figure(fig, axes_list, subplotspec_list, renderer,
         None if tight_layout could not be accomplished.
     """
 
-    # Multiple axes can share same subplotspec (e.g., if using axes_grid1);
+    # Multiple Axes can share same subplotspec (e.g., if using axes_grid1);
     # we need to group them together.
     ss_to_subplots = {ss: [] for ss in subplotspec_list}
     for ax, ss in zip(axes_list, subplotspec_list):
@@ -240,7 +240,7 @@ def get_tight_layout_figure(fig, axes_list, subplotspec_list, renderer,
 
     span_pairs = []
     for ss in ss_to_subplots:
-        # The intent here is to support axes from different gridspecs where
+        # The intent here is to support Axes from different gridspecs where
         # one's nrows (or ncols) is a multiple of the other (e.g. 2 and 4),
         # but this doesn't actually work because the computed wspace, in
         # relative-axes-height, corresponds to different physical spacings for
diff --git a/lib/matplotlib/animation.py b/lib/matplotlib/animation.py
index e7d09e7d7847..ccc332b04071 100644
--- a/lib/matplotlib/animation.py
+++ b/lib/matplotlib/animation.py
@@ -1171,7 +1171,7 @@ def _blit_draw(self, artists):
         # of the entire figure.
         updated_ax = {a.axes for a in artists}
         # Enumerate artists to cache Axes backgrounds. We do not draw
-        # artists yet to not cache foreground from plots with shared axes
+        # artists yet to not cache foreground from plots with shared Axes
         for ax in updated_ax:
             # If we haven't cached the background for the current view of this
             # Axes object, do so now. This might not always be reliable, but
diff --git a/lib/matplotlib/artist.py b/lib/matplotlib/artist.py
index d0db945ab3e5..8500557c98e0 100644
--- a/lib/matplotlib/artist.py
+++ b/lib/matplotlib/artist.py
@@ -224,10 +224,10 @@ def remove(self):
 
         The effect will not be visible until the figure is redrawn, e.g.,
         with `.FigureCanvasBase.draw_idle`.  Call `~.axes.Axes.relim` to
-        update the axes limits if desired.
+        update the Axes limits if desired.
 
         Note: `~.axes.Axes.relim` will not see collections even if the
-        collection was added to the axes with *autolim* = True.
+        collection was added to the Axes with *autolim* = True.
 
         Note: there is no support for removing the artist's legend entry.
         """
@@ -299,7 +299,7 @@ def axes(self):
     def axes(self, new_axes):
         if (new_axes is not None and self._axes is not None
                 and new_axes != self._axes):
-            raise ValueError("Can not reset the axes.  You are probably "
+            raise ValueError("Can not reset the Axes.  You are probably "
                              "trying to re-use an artist in more than one "
                              "Axes which is not supported")
         self._axes = new_axes
@@ -340,7 +340,7 @@ def get_window_extent(self, renderer=None):
         Be careful when using this function, the results will not update
         if the artist window extent of the artist changes.  The extent
         can change due to any changes in the transform stack, such as
-        changing the axes limits, the figure size, or the canvas used
+        changing the Axes limits, the figure size, or the canvas used
         (as is done when saving a figure).  This can lead to unexpected
         behavior where interactive figures will look fine on the screen,
         but will save incorrectly.
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 89081df90d9a..74243b71a152 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -460,8 +460,8 @@ def indicate_inset(self, bounds, inset_ax=None, *, transform=None,
             visibility to True if the automatic choice is not deemed correct.
 
         """
-        # to make the axes connectors work, we need to apply the aspect to
-        # the parent axes.
+        # to make the Axes connectors work, we need to apply the aspect to
+        # the parent Axes.
         self.apply_aspect()
 
         if transform is None:
@@ -5782,7 +5782,7 @@ def imshow(self, X, cmap=None, norm=None, *, aspect=None,
         im.set_data(X)
         im.set_alpha(alpha)
         if im.get_clip_path() is None:
-            # image does not already have clipping set, clip to axes patch
+            # image does not already have clipping set, clip to Axes patch
             im.set_clip_path(self.patch)
         im._scale_norm(norm, vmin, vmax)
         im.set_url(url)
@@ -6519,7 +6519,7 @@ def pcolorfast(self, *args, alpha=None, norm=None, cmap=None, vmin=None,
             ret._scale_norm(norm, vmin, vmax)
 
         if ret.get_clip_path() is None:
-            # image does not already have clipping set, clip to axes patch
+            # image does not already have clipping set, clip to Axes patch
             ret.set_clip_path(self.patch)
 
         ret.sticky_edges.x[:] = [xl, xr]
@@ -8471,7 +8471,7 @@ def violin(self, vpstats, positions=None, vert=True, widths=0.5,
 
     def _get_aspect_ratio(self):
         """
-        Convenience method to calculate the aspect ratio of the axes in
+        Convenience method to calculate the aspect ratio of the Axes in
         the display coordinate system.
         """
         figure_size = self.get_figure().get_size_inches()
diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index a0da0906eeb5..29490d77a50f 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -1595,7 +1595,7 @@ def set_prop_cycle(self, *args, **kwargs):
 
     def get_aspect(self):
         """
-        Return the aspect ratio of the axes scaling.
+        Return the aspect ratio of the Axes scaling.
 
         This is either "auto" or a float giving the ratio of y/x-scale.
         """
@@ -1603,7 +1603,7 @@ def get_aspect(self):
 
     def set_aspect(self, aspect, adjustable=None, anchor=None, share=False):
         """
-        Set the aspect ratio of the axes scaling, i.e. y/x-scale.
+        Set the aspect ratio of the Axes scaling, i.e. y/x-scale.
 
         Parameters
         ----------
@@ -2056,7 +2056,7 @@ def axis(self, arg=None, /, *, emit=True, **kwargs):
 
         Notes
         -----
-        For 3D axes, this method additionally takes *zmin*, *zmax* as
+        For 3D Axes, this method additionally takes *zmin*, *zmax* as
         parameters and likewise returns them.
         """
         if isinstance(arg, (str, bool)):
@@ -2808,7 +2808,7 @@ def autoscale(self, enable=True, axis='both', tight=None):
             None leaves the autoscaling state unchanged.
         axis : {'both', 'x', 'y'}, default: 'both'
             The axis on which to operate.  (For 3D Axes, *axis* can also be set
-            to 'z', and 'both' refers to all three axes.)
+            to 'z', and 'both' refers to all three Axes.)
         tight : bool or None, default: None
             If True, first set the margins to zero.  Then, this argument is
             forwarded to `~.axes.Axes.autoscale_view` (regardless of
diff --git a/lib/matplotlib/axes/_secondary_axes.py b/lib/matplotlib/axes/_secondary_axes.py
index 7ee3c8b13c07..81333a8a201c 100644
--- a/lib/matplotlib/axes/_secondary_axes.py
+++ b/lib/matplotlib/axes/_secondary_axes.py
@@ -58,7 +58,7 @@ def __init__(self, parent, orientation, location, functions, **kwargs):
     def set_alignment(self, align):
         """
         Set if axes spine and labels are drawn at top or bottom (or left/right)
-        of the axes.
+        of the Axes.
 
         Parameters
         ----------
@@ -85,7 +85,7 @@ def set_location(self, location):
             The position to put the secondary axis.  Strings can be 'top' or
             'bottom' for orientation='x' and 'right' or 'left' for
             orientation='y'. A float indicates the relative position on the
-            parent axes to put the new axes, 0.0 being the bottom (or left)
+            parent Axes to put the new Axes, 0.0 being the bottom (or left)
             and 1.0 being the top (or right).
         """
 
@@ -130,7 +130,7 @@ def set_ticks(self, ticks, labels=None, *, minor=False, **kwargs):
 
     def set_functions(self, functions):
         """
-        Set how the secondary axis converts limits from the parent axes.
+        Set how the secondary axis converts limits from the parent Axes.
 
         Parameters
         ----------
@@ -159,7 +159,7 @@ def set_functions(self, functions):
         elif functions is None:
             self._functions = (lambda x: x, lambda x: x)
         else:
-            raise ValueError('functions argument of secondary axes '
+            raise ValueError('functions argument of secondary Axes '
                              'must be a two-tuple of callable functions '
                              'with the first function being the transform '
                              'and the second being the inverse')
@@ -167,12 +167,12 @@ def set_functions(self, functions):
 
     def draw(self, renderer):
         """
-        Draw the secondary axes.
+        Draw the secondary Axes.
 
-        Consults the parent axes for its limits and converts them
+        Consults the parent Axes for its limits and converts them
         using the converter specified by
         `~.axes._secondary_axes.set_functions` (or *functions*
-        parameter when axes initialized.)
+        parameter when Axes initialized.)
         """
         self._set_lims()
         # this sets the scale in case the parent has set its scale.
@@ -211,7 +211,7 @@ def _set_scale(self):
     def _set_lims(self):
         """
         Set the limits based on parent limits and the convert method
-        between the parent and this secondary axes.
+        between the parent and this secondary Axes.
         """
         if self._orientation == 'x':
             lims = self._parent.get_xlim()
@@ -229,14 +229,14 @@ def _set_lims(self):
 
     def set_aspect(self, *args, **kwargs):
         """
-        Secondary axes cannot set the aspect ratio, so calling this just
+        Secondary Axes cannot set the aspect ratio, so calling this just
         sets a warning.
         """
-        _api.warn_external("Secondary axes can't set the aspect ratio")
+        _api.warn_external("Secondary Axes can't set the aspect ratio")
 
     def set_color(self, color):
         """
-        Change the color of the secondary axes and all decorators.
+        Change the color of the secondary Axes and all decorators.
 
         Parameters
         ----------
@@ -261,7 +261,7 @@ def set_color(self, color):
     The position to put the secondary axis.  Strings can be 'top' or
     'bottom' for orientation='x' and 'right' or 'left' for
     orientation='y'. A float indicates the relative position on the
-    parent axes to put the new axes, 0.0 being the bottom (or left)
+    parent Axes to put the new Axes, 0.0 being the bottom (or left)
     and 1.0 being the top (or right).
 
 functions : 2-tuple of func, or Transform with an inverse
@@ -285,6 +285,6 @@ def set_color(self, color):
 Other Parameters
 ----------------
 **kwargs : `~matplotlib.axes.Axes` properties.
-    Other miscellaneous axes parameters.
+    Other miscellaneous Axes parameters.
 '''
 _docstring.interpd.update(_secax_docstring=_secax_docstring)
diff --git a/lib/matplotlib/axis.py b/lib/matplotlib/axis.py
index f89278323738..9d478d30f77c 100644
--- a/lib/matplotlib/axis.py
+++ b/lib/matplotlib/axis.py
@@ -717,7 +717,7 @@ def isDefault_minfmt(self, value):
         self.minor._formatter_is_default = value
 
     def _get_shared_axes(self):
-        """Return Grouper of shared axes for current axis."""
+        """Return Grouper of shared Axes for current axis."""
         return self.axes._shared_axes[
             self._get_axis_name()].get_siblings(self.axes)
 
@@ -754,7 +754,7 @@ def set_label_coords(self, x, y, transform=None):
 
         By default, the x coordinate of the y label and the y coordinate of the
         x label are determined by the tick label bounding boxes, but this can
-        lead to poor alignment of multiple labels if there are multiple axes.
+        lead to poor alignment of multiple labels if there are multiple Axes.
 
         You can also specify the coordinate system of the label with the
         transform.  If None, the default coordinate system will be the axes
@@ -1235,7 +1235,7 @@ def _set_lim(self, v0, v1, *, emit=True, auto):
 
         if emit:
             self.axes.callbacks.process(f"{name}lim_changed", self.axes)
-            # Call all of the other axes that are shared with this one
+            # Call all of the other Axes that are shared with this one
             for other in self._get_shared_axes():
                 if other is self.axes:
                     continue
diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
index fd055fd7015d..fccde841aadc 100644
--- a/lib/matplotlib/backend_bases.py
+++ b/lib/matplotlib/backend_bases.py
@@ -1580,7 +1580,7 @@ def _mouse_handler(event):
             if last_axes is not None:
                 # Create a synthetic LocationEvent for the axes_leave_event.
                 # Its inaxes attribute needs to be manually set (because the
-                # cursor is actually *out* of that axes at that point); this is
+                # cursor is actually *out* of that Axes at that point); this is
                 # done with the internal _set_inaxes method which ensures that
                 # the xdata and ydata attributes are also correct.
                 try:
diff --git a/lib/matplotlib/backend_tools.py b/lib/matplotlib/backend_tools.py
index ac2a20f1ffa9..781089104f23 100644
--- a/lib/matplotlib/backend_tools.py
+++ b/lib/matplotlib/backend_tools.py
@@ -483,11 +483,11 @@ def add_figure(self, figure):
             self.home_views[figure] = WeakKeyDictionary()
             # Define Home
             self.push_current(figure)
-            # Make sure we add a home view for new axes as they're added
+            # Make sure we add a home view for new Axes as they're added
             figure.add_axobserver(lambda fig: self.update_home_views(fig))
 
     def clear(self, figure):
-        """Reset the axes stack."""
+        """Reset the Axes stack."""
         if figure in self.views:
             self.views[figure].clear()
             self.positions[figure].clear()
@@ -496,9 +496,9 @@ def clear(self, figure):
 
     def update_view(self):
         """
-        Update the view limits and position for each axes from the current
-        stack position. If any axes are present in the figure that aren't in
-        the current stack position, use the home view limits for those axes and
+        Update the view limits and position for each Axes from the current
+        stack position. If any Axes are present in the figure that aren't in
+        the current stack position, use the home view limits for those Axes and
         don't update *any* positions.
         """
 
@@ -541,7 +541,7 @@ def push_current(self, figure=None):
 
     def _axes_pos(self, ax):
         """
-        Return the original and modified positions for the specified axes.
+        Return the original and modified positions for the specified Axes.
 
         Parameters
         ----------
@@ -559,7 +559,7 @@ def _axes_pos(self, ax):
 
     def update_home_views(self, figure=None):
         """
-        Make sure that ``self.home_views`` has an entry for all axes present
+        Make sure that ``self.home_views`` has an entry for all Axes present
         in the figure.
         """
 
@@ -807,7 +807,7 @@ def _release(self, event):
                 self._cancel_action()
                 return
 
-            # detect twinx, twiny axes and avoid double zooming
+            # detect twinx, twiny Axes and avoid double zooming
             twinx = any(a.get_shared_x_axes().joined(a, a1) for a1 in done_ax)
             twiny = any(a.get_shared_y_axes().joined(a, a1) for a1 in done_ax)
             done_ax.append(a)
@@ -828,7 +828,7 @@ def _release(self, event):
 
 
 class ToolPan(ZoomPanBase):
-    """Pan axes with left mouse, zoom with right."""
+    """Pan Axes with left mouse, zoom with right."""
 
     default_keymap = property(lambda self: mpl.rcParams['keymap.pan'])
     description = 'Pan axes with left mouse, zoom with right'
diff --git a/lib/matplotlib/backends/backend_qt.py b/lib/matplotlib/backends/backend_qt.py
index c94e526a82d4..c6a6f3ad2e3a 100644
--- a/lib/matplotlib/backends/backend_qt.py
+++ b/lib/matplotlib/backends/backend_qt.py
@@ -741,7 +741,7 @@ def edit_parameters(self):
         axes = self.canvas.figure.get_axes()
         if not axes:
             QtWidgets.QMessageBox.warning(
-                self.canvas.parent(), "Error", "There are no axes to edit.")
+                self.canvas.parent(), "Error", "There are no Axes to edit.")
             return
         elif len(axes) == 1:
             ax, = axes
@@ -761,7 +761,7 @@ def edit_parameters(self):
                     titles[i] += f" (id: {id(ax):#x})"  # Deduplicate titles.
             item, ok = QtWidgets.QInputDialog.getItem(
                 self.canvas.parent(),
-                'Customize', 'Select axes:', titles, 0, False)
+                'Customize', 'Select Axes:', titles, 0, False)
             if not ok:
                 return
             ax = axes[titles.index(item)]
diff --git a/lib/matplotlib/colorbar.py b/lib/matplotlib/colorbar.py
index 092d4afc54ac..e09cdead7392 100644
--- a/lib/matplotlib/colorbar.py
+++ b/lib/matplotlib/colorbar.py
@@ -5,8 +5,8 @@
 .. note::
    Colorbars are typically created through `.Figure.colorbar` or its pyplot
    wrapper `.pyplot.colorbar`, which internally use `.Colorbar` together with
-   `.make_axes_gridspec` (for `.GridSpec`-positioned axes) or `.make_axes` (for
-   non-`.GridSpec`-positioned axes).
+   `.make_axes_gridspec` (for `.GridSpec`-positioned Axes) or `.make_axes` (for
+   non-`.GridSpec`-positioned Axes).
 
    End-users most likely won't need to directly use this module's API.
 """
@@ -29,7 +29,7 @@
 _docstring.interpd.update(
     _make_axes_kw_doc="""
 location : None or {'left', 'right', 'top', 'bottom'}
-    The location, relative to the parent axes, where the colorbar axes
+    The location, relative to the parent Axes, where the colorbar Axes
     is created.  It also determines the *orientation* of the colorbar
     (colorbars on the left and right are vertical, colorbars at the top
     and bottom are horizontal).  If None, the location will come from the
@@ -42,7 +42,7 @@
     incompatible values for *location* and *orientation* raises an exception.
 
 fraction : float, default: 0.15
-    Fraction of original axes to use for colorbar.
+    Fraction of original Axes to use for colorbar.
 
 shrink : float, default: 1.0
     Fraction by which to multiply the size of the colorbar.
@@ -51,14 +51,14 @@
     Ratio of long to short dimensions.
 
 pad : float, default: 0.05 if vertical, 0.15 if horizontal
-    Fraction of original axes between colorbar and new image axes.
+    Fraction of original Axes between colorbar and new image Axes.
 
 anchor : (float, float), optional
-    The anchor point of the colorbar axes.
+    The anchor point of the colorbar Axes.
     Defaults to (0.0, 0.5) if vertical; (0.5, 1.0) if horizontal.
 
 panchor : (float, float), or *False*, optional
-    The anchor point of the colorbar parent axes. If *False*, the parent
+    The anchor point of the colorbar parent Axes. If *False*, the parent
     axes' anchor will be unchanged.
     Defaults to (1.0, 0.5) if vertical; (0.5, 0.0) if horizontal.""",
     _colormap_kw_doc="""
@@ -145,7 +145,7 @@ def draw(self, renderer):
 
 class _ColorbarAxesLocator:
     """
-    Shrink the axes if there are triangular or rectangular extends.
+    Shrink the Axes if there are triangular or rectangular extends.
     """
     def __init__(self, cbar):
         self._cbar = cbar
@@ -195,7 +195,7 @@ def get_subplotspec(self):
 @_docstring.interpd
 class Colorbar:
     r"""
-    Draw a colorbar in an existing axes.
+    Draw a colorbar in an existing Axes.
 
     Typically, colorbars are created using `.Figure.colorbar` or
     `.pyplot.colorbar` and associated with `.ScalarMappable`\s (such as an
@@ -535,7 +535,7 @@ def _draw_all(self):
         self.vmin, self.vmax = self._boundaries[self._inside][[0, -1]]
         # Compute the X/Y mesh.
         X, Y = self._mesh()
-        # draw the extend triangles, and shrink the inner axes to accommodate.
+        # draw the extend triangles, and shrink the inner Axes to accommodate.
         # also adds the outline path to self.outline spine:
         self._do_extends()
         lower, upper = self.vmin, self.vmax
@@ -628,7 +628,7 @@ def _add_solids_patches(self, X, Y, C, mappable):
 
     def _do_extends(self, ax=None):
         """
-        Add the extend tri/rectangles on the outside of the axes.
+        Add the extend tri/rectangles on the outside of the Axes.
 
         ax is unused, but required due to the callbacks on xlim/ylim changed
         """
@@ -785,7 +785,7 @@ def add_lines(self, *args, **kwargs):
             self.lines = []
         self.lines.append(col)
 
-        # make a clip path that is just a linewidth bigger than the axes...
+        # make a clip path that is just a linewidth bigger than the Axes...
         fac = np.max(linewidths) / 72
         xy = np.array([[0, 0], [1, 0], [1, 1], [0, 1], [0, 0]])
         inches = self.ax.get_figure().dpi_scale_trans
@@ -1373,7 +1373,7 @@ def make_axes(parents, location=None, orientation=None, fraction=0.15,
     """
     Create an `~.axes.Axes` suitable for a colorbar.
 
-    The axes is placed in the figure of the *parents* axes, by resizing and
+    The Axes is placed in the figure of the *parents* Axes, by resizing and
     repositioning *parents*.
 
     Parameters
@@ -1385,7 +1385,7 @@ def make_axes(parents, location=None, orientation=None, fraction=0.15,
     Returns
     -------
     cax : `~matplotlib.axes.Axes`
-        The child axes.
+        The child Axes.
     kwargs : dict
         The reduced keyword dictionary to be passed when creating the colorbar
         instance.
@@ -1415,10 +1415,10 @@ def make_axes(parents, location=None, orientation=None, fraction=0.15,
     pad = kwargs.pop('pad', pad0)
 
     if not all(fig is ax.get_figure() for ax in parents):
-        raise ValueError('Unable to create a colorbar axes as not all '
+        raise ValueError('Unable to create a colorbar Axes as not all '
                          'parents share the same figure.')
 
-    # take a bounding box around all of the given axes
+    # take a bounding box around all of the given Axes
     parents_bbox = mtransforms.Bbox.union(
         [ax.get_position(original=True).frozen() for ax in parents])
 
@@ -1443,7 +1443,7 @@ def make_axes(parents, location=None, orientation=None, fraction=0.15,
     # new axes coordinates
     shrinking_trans = mtransforms.BboxTransform(parents_bbox, pb1)
 
-    # transform each of the axes in parents using the new transform
+    # transform each of the Axes in parents using the new transform
     for ax in parents:
         new_posn = shrinking_trans.transform(ax.get_position(original=True))
         new_posn = mtransforms.Bbox(new_posn)
@@ -1478,14 +1478,14 @@ def make_axes_gridspec(parent, *, location=None, orientation=None,
     """
     Create an `~.axes.Axes` suitable for a colorbar.
 
-    The axes is placed in the figure of the *parent* axes, by resizing and
+    The Axes is placed in the figure of the *parent* Axes, by resizing and
     repositioning *parent*.
 
     This function is similar to `.make_axes` and mostly compatible with it.
     Primary differences are
 
     - `.make_axes_gridspec` requires the *parent* to have a subplotspec.
-    - `.make_axes` positions the axes in figure coordinates;
+    - `.make_axes` positions the Axes in figure coordinates;
       `.make_axes_gridspec` positions it using a subplotspec.
     - `.make_axes` updates the position of the parent.  `.make_axes_gridspec`
       replaces the parent gridspec with a new one.
@@ -1499,7 +1499,7 @@ def make_axes_gridspec(parent, *, location=None, orientation=None,
     Returns
     -------
     cax : `~matplotlib.axes.Axes`
-        The child axes.
+        The child Axes.
     kwargs : dict
         The reduced keyword dictionary to be passed when creating the colorbar
         instance.
diff --git a/lib/matplotlib/contour.py b/lib/matplotlib/contour.py
index 7404151e7699..ab550b5d2acf 100644
--- a/lib/matplotlib/contour.py
+++ b/lib/matplotlib/contour.py
@@ -133,7 +133,7 @@ def clabel(self, levels=None, *,
 
         use_clabeltext : bool, default: False
             If ``True``, use `.Text.set_transform_rotates_text` to ensure that
-            label rotation is updated whenever the axes aspect changes.
+            label rotation is updated whenever the Axes aspect changes.
 
         zorder : float or None, default: ``(2 + contour.get_zorder())``
             zorder of the contour labels.
@@ -1032,7 +1032,7 @@ def _process_args(self, *args, **kwargs):
         """
         Process *args* and *kwargs*; override in derived classes.
 
-        Must set self.levels, self.zmin and self.zmax, and update axes limits.
+        Must set self.levels, self.zmin and self.zmax, and update Axes limits.
         """
         self.levels = args[0]
         allsegs = args[1]
diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
index dd76c932b01e..00b326112871 100644
--- a/lib/matplotlib/figure.py
+++ b/lib/matplotlib/figure.py
@@ -69,7 +69,7 @@ def _stale_figure_callback(self, val):
 
 class _AxesStack:
     """
-    Helper class to track axes in a figure.
+    Helper class to track Axes in a figure.
 
     Axes are tracked both in the order in which they have been added
     (``self._axes`` insertion/iteration order) and in the separate "gca" stack
@@ -77,30 +77,30 @@ class _AxesStack:
     """
 
     def __init__(self):
-        self._axes = {}  # Mapping of axes to "gca" order.
+        self._axes = {}  # Mapping of Axes to "gca" order.
         self._counter = itertools.count()
 
     def as_list(self):
-        """List the axes that have been added to the figure."""
+        """List the Axes that have been added to the figure."""
         return [*self._axes]  # This relies on dict preserving order.
 
     def remove(self, a):
-        """Remove the axes from the stack."""
+        """Remove the Axes from the stack."""
         self._axes.pop(a)
 
     def bubble(self, a):
-        """Move an axes, which must already exist in the stack, to the top."""
+        """Move an Axes, which must already exist in the stack, to the top."""
         if a not in self._axes:
             raise ValueError("Axes has not been added yet")
         self._axes[a] = next(self._counter)
 
     def add(self, a):
-        """Add an axes to the stack, ignoring it if already present."""
+        """Add an Axes to the stack, ignoring it if already present."""
         if a not in self._axes:
             self._axes[a] = next(self._counter)
 
     def current(self):
-        """Return the active axes, or None if the stack is empty."""
+        """Return the active Axes, or None if the stack is empty."""
         return max(self._axes, key=self._axes.__getitem__, default=None)
 
     def __getstate__(self):
@@ -137,7 +137,7 @@ def __init__(self, **kwargs):
         # axis._get_tick_boxes_siblings
         self._align_label_groups = {"x": cbook.Grouper(), "y": cbook.Grouper()}
 
-        self._localaxes = []  # track all axes
+        self._localaxes = []  # track all Axes
         self.artists = []
         self.lines = []
         self.patches = []
@@ -508,7 +508,7 @@ def add_axes(self, *args, **kwargs):
         sharex, sharey : `~matplotlib.axes.Axes`, optional
             Share the x or y `~matplotlib.axis` with sharex and/or sharey.
             The axis will have the same limits, ticks, and scale as the axis
-            of the shared axes.
+            of the shared Axes.
 
         label : str
             A label for the returned Axes.
@@ -516,7 +516,7 @@ def add_axes(self, *args, **kwargs):
         Returns
         -------
         `~.axes.Axes`, or a subclass of `~.axes.Axes`
-            The returned axes class depends on the projection used. It is
+            The returned Axes class depends on the projection used. It is
             `~.axes.Axes` if rectilinear projection is used and
             `.projections.polar.PolarAxes` if polar projection is used.
 
@@ -581,7 +581,7 @@ def add_axes(self, *args, **kwargs):
                 raise ValueError(f'all entries in rect must be finite not {rect}')
             projection_class, pkw = self._process_projection_requirements(**kwargs)
 
-            # create the new axes using the axes class given
+            # create the new Axes using the Axes class given
             a = projection_class(self, rect, **pkw)
             key = (projection_class, pkw)
 
@@ -644,7 +644,7 @@ def add_subplot(self, *args, **kwargs):
         sharex, sharey : `~matplotlib.axes.Axes`, optional
             Share the x or y `~matplotlib.axis` with sharex and/or sharey.
             The axis will have the same limits, ticks, and scale as the axis
-            of the shared axes.
+            of the shared Axes.
 
         label : str
             A label for the returned Axes.
@@ -877,14 +877,14 @@ def delaxes(self, ax):
 
     def _remove_axes(self, ax, owners):
         """
-        Common helper for removal of standard axes (via delaxes) and of child axes.
+        Common helper for removal of standard Axes (via delaxes) and of child Axes.
 
         Parameters
         ----------
         ax : `~.AxesBase`
             The Axes to remove.
         owners
-            List of objects (list or _AxesStack) "owning" the axes, from which the Axes
+            List of objects (list or _AxesStack) "owning" the Axes, from which the Axes
             will be remove()d.
         """
         for owner in owners:
@@ -894,7 +894,7 @@ def _remove_axes(self, ax, owners):
         self.stale = True
         self.canvas.release_mouse(ax)
 
-        for name in ax._axis_names:  # Break link between any shared axes
+        for name in ax._axis_names:  # Break link between any shared Axes
             grouper = ax._shared_axes[name]
             siblings = [other for other in grouper.get_siblings(ax) if other is not ax]
             if not siblings:  # Axes was not shared along this axis; we're done.
@@ -909,7 +909,7 @@ def _remove_axes(self, ax, owners):
             remaining_axis.get_minor_formatter().set_axis(remaining_axis)
             remaining_axis.get_minor_locator().set_axis(remaining_axis)
 
-        ax._twinned_axes.remove(ax)  # Break link between any twinned axes.
+        ax._twinned_axes.remove(ax)  # Break link between any twinned Axes.
 
     def clear(self, keep_observers=False):
         """
@@ -923,7 +923,7 @@ def clear(self, keep_observers=False):
         """
         self.suppressComposite = None
 
-        # first clear the axes in any subfigures
+        # first clear the Axes in any subfigures
         for subfig in self.subfigs:
             subfig.clear(keep_observers=keep_observers)
         self.subfigs = []
@@ -1192,12 +1192,12 @@ def colorbar(
         included automatically.
 
         The *shrink* kwarg provides a simple way to scale the colorbar with
-        respect to the axes. Note that if *cax* is specified, it determines the
+        respect to the Axes. Note that if *cax* is specified, it determines the
         size of the colorbar, and *shrink* and *aspect* are ignored.
 
         For more precise control, you can manually specify the positions of the
         axes objects in which the mappable and the colorbar are drawn.  In this
-        case, do not use any of the axes properties kwargs.
+        case, do not use any of the Axes properties kwargs.
 
         It is known that some vector graphics viewers (svg and pdf) render
         white gaps between segments of the colorbar.  This is due to bugs in
@@ -1224,7 +1224,7 @@ def colorbar(
                     'Either provide the *cax* argument to use as the Axes for '
                     'the Colorbar, provide the *ax* argument to steal space '
                     'from it, or add *mappable* to an Axes.')
-            fig = (  # Figure of first axes; logic copied from make_axes.
+            fig = (  # Figure of first Axes; logic copied from make_axes.
                 [*ax.flat] if isinstance(ax, np.ndarray)
                 else [*ax] if np.iterable(ax)
                 else [ax])[0].figure
@@ -1352,9 +1352,9 @@ def align_xlabels(self, axs=None):
             _log.debug(' Working on: %s', ax.get_xlabel())
             rowspan = ax.get_subplotspec().rowspan
             pos = ax.xaxis.get_label_position()  # top or bottom
-            # Search through other axes for label positions that are same as
+            # Search through other Axes for label positions that are same as
             # this one and that share the appropriate row number.
-            # Add to a grouper associated with each axes of siblings.
+            # Add to a grouper associated with each Axes of siblings.
             # This list is inspected in `axis.draw` by
             # `axis._update_label_position`.
             for axc in axs:
@@ -1412,9 +1412,9 @@ def align_ylabels(self, axs=None):
             _log.debug(' Working on: %s', ax.get_ylabel())
             colspan = ax.get_subplotspec().colspan
             pos = ax.yaxis.get_label_position()  # left or right
-            # Search through other axes for label positions that are same as
+            # Search through other Axes for label positions that are same as
             # this one and that share the appropriate column number.
-            # Add to a list associated with each axes of siblings.
+            # Add to a list associated with each Axes of siblings.
             # This list is inspected in `axis.draw` by
             # `axis._update_label_position`.
             for axc in axs:
@@ -1737,7 +1737,7 @@ def get_tightbbox(self, renderer=None, bbox_extra_artists=None):
 
         for ax in self.axes:
             if ax.get_visible():
-                # some axes don't take the bbox_extra_artists kwarg so we
+                # some Axes don't take the bbox_extra_artists kwarg so we
                 # need this conditional....
                 try:
                     bbox = ax.get_tightbbox(
@@ -1896,7 +1896,7 @@ def subplot_mosaic(self, mosaic, *, sharex=False, sharey=False,
         -------
         dict[label, Axes]
            A dictionary mapping the labels to the Axes objects.  The order of
-           the axes is left-to-right and top-to-bottom of their position in the
+           the Axes is left-to-right and top-to-bottom of their position in the
            total layout.
 
         """
@@ -2006,7 +2006,7 @@ def _do_layout(gs, mosaic, unique_ids, nested):
             """
             output = dict()
 
-            # we need to merge together the Axes at this level and the axes
+            # we need to merge together the Axes at this level and the Axes
             # in the (recursively) nested sub-mosaics so that we can add
             # them to the figure in the "natural" order if you were to
             # ravel in c-order all of the Axes that will be created
@@ -2046,7 +2046,7 @@ def _do_layout(gs, mosaic, unique_ids, nested):
                 # element is an Axes or a nested mosaic.
                 if method == 'axes':
                     slc = arg
-                    # add a single axes
+                    # add a single Axes
                     if name in output:
                         raise ValueError(f"There are duplicate keys {name} "
                                          f"in the layout\n{mosaic!r}")
@@ -2421,15 +2421,15 @@ def __init__(self,
             overlapping Axes decorations (labels, ticks, etc). Note that
             layout managers can have significant performance penalties.
 
-            - 'constrained': The constrained layout solver adjusts axes sizes
-              to avoid overlapping axes decorations.  Can handle complex plot
+            - 'constrained': The constrained layout solver adjusts Axes sizes
+              to avoid overlapping Axes decorations.  Can handle complex plot
               layouts and colorbars, and is thus recommended.
 
               See :ref:`constrainedlayout_guide` for examples.
 
             - 'compressed': uses the same algorithm as 'constrained', but
               removes extra space between fixed-aspect-ratio Axes.  Best for
-              simple grids of axes.
+              simple grids of Axes.
 
             - 'tight': Use the tight layout mechanism. This is a relatively
               simple algorithm that adjusts the subplot parameters so that
@@ -2545,7 +2545,7 @@ def __init__(self,
 
         self.subplotpars = subplotpars
 
-        self._axstack = _AxesStack()  # track all figure axes and current axes
+        self._axstack = _AxesStack()  # track all figure Axes and current Axes
         self.clear()
 
     def pick(self, mouseevent):
@@ -2914,7 +2914,7 @@ def figimage(self, X, xo=0, yo=0, alpha=None, norm=None, cmap=None,
 
         origin : {'upper', 'lower'}, default: :rc:`image.origin`
             Indicates where the [0, 0] index of the array is in the upper left
-            or lower left corner of the axes.
+            or lower left corner of the Axes.
 
         resize : bool
             If *True*, resize the figure to match the given image size.
@@ -3347,7 +3347,7 @@ def _recursively_make_axes_transparent(exit_stack, ax):
                 # set subfigure to appear transparent in printed image
                 for subfig in self.subfigs:
                     _recursively_make_subfig_transparent(stack, subfig)
-                # set axes to be transparent
+                # set Axes to be transparent
                 for ax in self.axes:
                     _recursively_make_axes_transparent(stack, ax)
             self.canvas.print_figure(fname, **kwargs)
diff --git a/lib/matplotlib/gridspec.py b/lib/matplotlib/gridspec.py
index 0b93ea93dd3d..c38f3a078b84 100644
--- a/lib/matplotlib/gridspec.py
+++ b/lib/matplotlib/gridspec.py
@@ -272,7 +272,7 @@ def subplots(self, *, sharex=False, sharey=False, squeeze=True,
         # don't mutate kwargs passed by user...
         subplot_kw = subplot_kw.copy()
 
-        # Create array to hold all axes.
+        # Create array to hold all Axes.
         axarr = np.empty((self._nrows, self._ncols), dtype=object)
         for row in range(self._nrows):
             for col in range(self._ncols):
diff --git a/lib/matplotlib/image.py b/lib/matplotlib/image.py
index 8b672e5ad2b0..e3e162a3d621 100644
--- a/lib/matplotlib/image.py
+++ b/lib/matplotlib/image.py
@@ -350,7 +350,7 @@ def _make_image(self, A, in_bbox, out_bbox, clip_bbox, magnification=1.0,
 
         If *round_to_pixel_border* is True, the output image size will be
         rounded to the nearest pixel boundary.  This makes the images align
-        correctly with the axes.  It should not be used if exact scaling is
+        correctly with the Axes.  It should not be used if exact scaling is
         needed, such as for `FigureImage`.
 
         Returns
@@ -403,7 +403,7 @@ def _make_image(self, A, in_bbox, out_bbox, clip_bbox, magnification=1.0,
                 .translate(-clipped_bbox.x0, -clipped_bbox.y0)
                 .scale(magnification)))
 
-        # So that the image is aligned with the edge of the axes, we want to
+        # So that the image is aligned with the edge of the Axes, we want to
         # round up the output width to the next integer.  This also means
         # scaling the transform slightly to account for the extra subpixel.
         if ((not unsampled) and t.is_affine and round_to_pixel_border and
@@ -854,7 +854,7 @@ class AxesImage(_ImageBase):
     Parameters
     ----------
     ax : `~matplotlib.axes.Axes`
-        The axes the image will belong to.
+        The Axes the image will belong to.
     cmap : str or `~matplotlib.colors.Colormap`, default: :rc:`image.cmap`
         The Colormap instance or registered colormap name used to map scalar
         data to colors.
@@ -872,7 +872,7 @@ class AxesImage(_ImageBase):
         applied (visual interpolation).
     origin : {'upper', 'lower'}, default: :rc:`image.origin`
         Place the [0, 0] index of the array in the upper left or lower left
-        corner of the axes. The convention 'upper' is typically used for
+        corner of the Axes. The convention 'upper' is typically used for
         matrices and images.
     extent : tuple, optional
         The data axes (left, right, bottom, top) for making image plots
@@ -956,8 +956,8 @@ def set_extent(self, extent, **kwargs):
             ``(left, right, bottom, top)`` in data coordinates.
         **kwargs
             Other parameters from which unit info (i.e., the *xunits*,
-            *yunits*, *zunits* (for 3D axes), *runits* and *thetaunits* (for
-            polar axes) entries are applied, if present.
+            *yunits*, *zunits* (for 3D Axes), *runits* and *thetaunits* (for
+            polar Axes) entries are applied, if present.
 
         Notes
         -----
@@ -1041,7 +1041,7 @@ def __init__(self, ax, *, interpolation='nearest', **kwargs):
         Parameters
         ----------
         ax : `~matplotlib.axes.Axes`
-            The axes the image will belong to.
+            The Axes the image will belong to.
         interpolation : {'nearest', 'bilinear'}, default: 'nearest'
             The interpolation scheme used in the resampling.
         **kwargs
@@ -1208,7 +1208,7 @@ def __init__(self, ax,
         Parameters
         ----------
         ax : `~matplotlib.axes.Axes`
-            The axes the image will belong to.
+            The Axes the image will belong to.
         x, y : 1D array-like, optional
             Monotonic arrays of length N+1 and M+1, respectively, specifying
             rectangle boundaries.  If not given, will default to
@@ -1566,7 +1566,7 @@ def imsave(fname, arr, vmin=None, vmax=None, cmap=None, format=None,
         is unset is documented under *fname*.
     origin : {'upper', 'lower'}, default: :rc:`image.origin`
         Indicates whether the ``(0, 0)`` index of the array is in the upper
-        left or lower left corner of the axes.
+        left or lower left corner of the Axes.
     dpi : float
         The DPI to store in the metadata of the file.  This does not affect the
         resolution of the output image.  Depending on file format, this may be
diff --git a/lib/matplotlib/layout_engine.py b/lib/matplotlib/layout_engine.py
index d751059f4e09..5a96745d0697 100644
--- a/lib/matplotlib/layout_engine.py
+++ b/lib/matplotlib/layout_engine.py
@@ -165,8 +165,8 @@ def execute(self, fig):
         Execute tight_layout.
 
         This decides the subplot parameters given the padding that
-        will allow the axes labels to not be covered by other labels
-        and axes.
+        will allow the Axes labels to not be covered by other labels
+        and Axes.
 
         Parameters
         ----------
@@ -226,12 +226,12 @@ def __init__(self, *, h_pad=None, w_pad=None,
         Parameters
         ----------
         h_pad, w_pad : float
-            Padding around the axes elements in inches.
+            Padding around the Axes elements in inches.
             Default to :rc:`figure.constrained_layout.h_pad` and
             :rc:`figure.constrained_layout.w_pad`.
         hspace, wspace : float
             Fraction of the figure to dedicate to space between the
-            axes.  These are evenly spread between the gaps between the axes.
+            axes.  These are evenly spread between the gaps between the Axes.
             A value of 0.2 for a three-column layout would have a space
             of 0.1 of the figure width between each column.
             If h/wspace < h/w_pad, then the pads are used instead.
@@ -259,7 +259,7 @@ def __init__(self, *, h_pad=None, w_pad=None,
 
     def execute(self, fig):
         """
-        Perform constrained_layout and move and resize axes accordingly.
+        Perform constrained_layout and move and resize Axes accordingly.
 
         Parameters
         ----------
@@ -284,12 +284,12 @@ def set(self, *, h_pad=None, w_pad=None,
         Parameters
         ----------
         h_pad, w_pad : float
-            Padding around the axes elements in inches.
+            Padding around the Axes elements in inches.
             Default to :rc:`figure.constrained_layout.h_pad` and
             :rc:`figure.constrained_layout.w_pad`.
         hspace, wspace : float
             Fraction of the figure to dedicate to space between the
-            axes.  These are evenly spread between the gaps between the axes.
+            axes.  These are evenly spread between the gaps between the Axes.
             A value of 0.2 for a three-column layout would have a space
             of 0.1 of the figure width between each column.
             If h/wspace < h/w_pad, then the pads are used instead.
diff --git a/lib/matplotlib/legend.py b/lib/matplotlib/legend.py
index 67925b9a99bc..3e3ed5d7a7f7 100644
--- a/lib/matplotlib/legend.py
+++ b/lib/matplotlib/legend.py
@@ -1,6 +1,6 @@
 """
 The legend module defines the Legend class, which is responsible for
-drawing legends associated with axes and/or figures.
+drawing legends associated with Axes and/or figures.
 
 .. important::
 
@@ -12,7 +12,7 @@
 The `Legend` class is a container of legend handles and legend texts.
 
 The legend handler map specifies how to create legend handles from artists
-(lines, patches, etc.) in the axes or figures. Default legend handlers are
+(lines, patches, etc.) in the Axes or figures. Default legend handlers are
 defined in the :mod:`~matplotlib.legend_handler` module. While not all artist
 types are covered by the default legend handlers, custom legend handlers can be
 defined to support arbitrary objects.
@@ -109,13 +109,13 @@ def _update_bbox_to_anchor(self, loc_in_canvas):
     If a 4-tuple or `.BboxBase` is given, then it specifies the bbox
     ``(x, y, width, height)`` that the legend is placed in.
     To put the legend in the best location in the bottom right
-    quadrant of the axes (or figure)::
+    quadrant of the Axes (or figure)::
 
         loc='best', bbox_to_anchor=(0.5, 0., 0.5, 0.5)
 
     A 2-tuple ``(x, y)`` places the corner of the legend specified by *loc* at
     x, y.  For example, to put the legend's upper right-hand corner in the
-    center of the axes (or figure) the following keywords can be used::
+    center of the Axes (or figure) the following keywords can be used::
 
         loc='upper right', bbox_to_anchor=(0.5, 0.5)
 
@@ -198,7 +198,7 @@ def _update_bbox_to_anchor(self, loc_in_canvas):
 
 mode : {"expand", None}
     If *mode* is set to ``"expand"`` the legend will be horizontally
-    expanded to fill the axes area (or *bbox_to_anchor* if defines
+    expanded to fill the Axes area (or *bbox_to_anchor* if defines
     the legend's size).
 
 bbox_transform : None or `~matplotlib.transforms.Transform`
@@ -241,7 +241,7 @@ def _update_bbox_to_anchor(self, loc_in_canvas):
     The pad between the legend handle and text, in font-size units.
 
 borderaxespad : float, default: :rc:`legend.borderaxespad`
-    The pad between the axes and legend border, in font-size units.
+    The pad between the Axes and legend border, in font-size units.
 
 columnspacing : float, default: :rc:`legend.columnspacing`
     The spacing between columns, in font-size units.
@@ -344,7 +344,7 @@ class Legend(Artist):
     Place a legend on the figure/axes.
     """
 
-    # 'best' is only implemented for axes legends
+    # 'best' is only implemented for Axes legends
     codes = {'best': 0, **AnchoredOffsetbox.codes}
     zorder = 5
 
@@ -372,7 +372,7 @@ def __init__(
         handlelength=None,   # length of the legend handles
         handleheight=None,   # height of the legend handles
         handletextpad=None,  # pad between the legend handle and text
-        borderaxespad=None,  # pad between the axes and legend border
+        borderaxespad=None,  # pad between the Axes and legend border
         columnspacing=None,  # spacing between columns
 
         ncols=1,     # number of columns
@@ -638,7 +638,7 @@ def __init__(
 
     def _set_artist_props(self, a):
         """
-        Set the boilerplate props for artists added to axes.
+        Set the boilerplate props for artists added to Axes.
         """
         a.set_figure(self.figure)
         if self.isaxes:
@@ -1247,7 +1247,7 @@ def _get_legend_handles(axs, legend_handler_map=None):
             *(a for a in ax._children
               if isinstance(a, (Line2D, Patch, Collection, Text))),
             *ax.containers]
-        # support parasite axes:
+        # support parasite Axes:
         if hasattr(ax, 'parasites'):
             for axx in ax.parasites:
                 handles_original += [
diff --git a/lib/matplotlib/lines.py b/lib/matplotlib/lines.py
index c94be8c512ae..5e5c19c9f69f 100644
--- a/lib/matplotlib/lines.py
+++ b/lib/matplotlib/lines.py
@@ -168,7 +168,7 @@ def _slice_or_none(in_v, slc):
                     f'markevery={markevery}')
             if ax is None:
                 raise ValueError(
-                    "markevery is specified relative to the axes size, but "
+                    "markevery is specified relative to the Axes size, but "
                     "the line does not have a Axes as parent")
 
             # calc cumulative distance along path (in display coords):
@@ -180,7 +180,7 @@ def _slice_or_none(in_v, slc):
             delta[0, :] = 0
             delta[1:, :] = disp_coords[1:, :] - disp_coords[:-1, :]
             delta = np.hypot(*delta.T).cumsum()
-            # calc distance between markers along path based on the axes
+            # calc distance between markers along path based on the Axes
             # bounding box diagonal being a distance of unity:
             (x0, y0), (x1, y1) = ax.transAxes.transform([[0, 0], [1, 1]])
             scale = np.hypot(x1 - x0, y1 - y0)
@@ -575,7 +575,7 @@ def set_markevery(self, every):
             - ``every=0.1``, (i.e. a float): markers will be spaced at
               approximately equal visual distances along the line; the distance
               along the line between markers is determined by multiplying the
-              display-coordinate distance of the axes bounding-box diagonal
+              display-coordinate distance of the Axes bounding-box diagonal
               by the value of *every*.
             - ``every=(0.5, 0.1)`` (i.e. a length-2 tuple of float): similar
               to ``every=0.1`` but the first marker will be offset along the
diff --git a/lib/matplotlib/offsetbox.py b/lib/matplotlib/offsetbox.py
index 0164638b1076..1667681fab59 100644
--- a/lib/matplotlib/offsetbox.py
+++ b/lib/matplotlib/offsetbox.py
@@ -877,7 +877,7 @@ class AnchoredOffsetbox(OffsetBox):
 
     AnchoredOffsetbox has a single child.  When multiple children are needed,
     use an extra OffsetBox to enclose them.  By default, the offset box is
-    anchored against its parent axes. You may explicitly specify the
+    anchored against its parent Axes. You may explicitly specify the
     *bbox_to_anchor*.
     """
     zorder = 5  # zorder of the legend
@@ -1230,13 +1230,13 @@ def __init__(self, offsetbox, xy, xybox=None, xycoords='data', boxcoords=None, *
 
         annotation_clip: bool or None, default: None
             Whether to clip (i.e. not draw) the annotation when the annotation
-            point *xy* is outside the axes area.
+            point *xy* is outside the Axes area.
 
             - If *True*, the annotation will be clipped when *xy* is outside
-              the axes.
+              the Axes.
             - If *False*, the annotation will always be drawn.
             - If *None*, the annotation will be clipped when *xy* is outside
-              the axes and *xycoords* is 'data'.
+              the Axes and *xycoords* is 'data'.
 
         pad : float, default: 0.4
             Padding around the offsetbox.
diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
index d1537322ab76..ef52a00b059b 100644
--- a/lib/matplotlib/patches.py
+++ b/lib/matplotlib/patches.py
@@ -161,7 +161,7 @@ def contains_point(self, point, radius=None):
         point : (float, float)
             The point (x, y) to check, in target coordinates of
             ``self.get_transform()``. These are display coordinates for patches
-            that are added to a figure or axes.
+            that are added to a figure or Axes.
         radius : float, optional
             Additional margin on the patch in target coordinates of
             ``self.get_transform()``. See `.Path.contains_point` for further
@@ -211,7 +211,7 @@ def contains_points(self, points, radius=None):
         points : (N, 2) array
             The points to check, in target coordinates of
             ``self.get_transform()``. These are display coordinates for patches
-            that are added to a figure or axes. Columns contain x and y values.
+            that are added to a figure or Axes. Columns contain x and y values.
         radius : float, optional
             Additional margin on the patch in target coordinates of
             ``self.get_transform()``. See `.Path.contains_point` for further
@@ -2085,7 +2085,7 @@ def segment_circle_intersect(x0, y0, x1, y1):
                 & (y0e - epsilon < ys) & (ys < y1e + epsilon)
             ]
 
-        # Transform the axes (or figure) box_path so that it is relative to
+        # Transform the Axes (or figure) box_path so that it is relative to
         # the unit circle in the same way that it is relative to the desired
         # ellipse.
         box_path_transform = (
@@ -4386,7 +4386,7 @@ def draw(self, renderer):
 
 
 class ConnectionPatch(FancyArrowPatch):
-    """A patch that connects two points (possibly in different axes)."""
+    """A patch that connects two points (possibly in different Axes)."""
 
     def __str__(self):
         return "ConnectionPatch((%g, %g), (%g, %g))" % \
@@ -4438,15 +4438,15 @@ def __init__(self, xyA, xyB, coordsA, coordsB=None, *,
         'subfigure points'   points from the lower left corner of the subfigure
         'subfigure pixels'   pixels from the lower left corner of the subfigure
         'subfigure fraction' fraction of the subfigure, 0, 0 is lower left.
-        'axes points'        points from lower left corner of axes
-        'axes pixels'        pixels from lower left corner of axes
-        'axes fraction'      0, 0 is lower left of axes and 1, 1 is upper right
+        'axes points'        points from lower left corner of the Axes
+        'axes pixels'        pixels from lower left corner of the Axes
+        'axes fraction'      0, 0 is lower left of Axes and 1, 1 is upper right
         'data'               use the coordinate system of the object being
                              annotated (default)
         'offset points'      offset (in points) from the *xy* value
         'polar'              you can specify *theta*, *r* for the annotation,
                              even in cartesian plots.  Note that if you are
-                             using a polar axes, you do not need to specify
+                             using a polar Axes, you do not need to specify
                              polar for the coordinate system since that is the
                              native "data" coordinate system.
         ==================== ==================================================
@@ -4493,7 +4493,7 @@ def __init__(self, xyA, xyB, coordsA, coordsB=None, *,
                          mutation_aspect=mutation_aspect,
                          clip_on=clip_on,
                          **kwargs)
-        # if True, draw annotation only if self.xy is inside the axes
+        # if True, draw annotation only if self.xy is inside the Axes
         self._annotation_clip = None
 
     def _get_xy(self, xy, s, axes=None):
@@ -4543,7 +4543,7 @@ def _get_xy(self, xy, s, axes=None):
             y = bb.y0 + y if y >= 0 else bb.y1 + y
             return x, y
         elif s == 'axes pixels':
-            # pixels from the lower left corner of the axes
+            # pixels from the lower left corner of the Axes
             bb = axes.bbox
             x = bb.x0 + x if x >= 0 else bb.x1 + x
             y = bb.y0 + y if y >= 0 else bb.y1 + y
@@ -4561,10 +4561,10 @@ def set_annotation_clip(self, b):
         ----------
         b : bool or None
             - True: The annotation will be clipped when ``self.xy`` is
-              outside the axes.
+              outside the Axes.
             - False: The annotation will always be drawn.
             - None: The annotation will be clipped when ``self.xy`` is
-              outside the axes and ``self.xycoords == "data"``.
+              outside the Axes and ``self.xycoords == "data"``.
         """
         self._annotation_clip = b
         self.stale = True
diff --git a/lib/matplotlib/projections/__init__.py b/lib/matplotlib/projections/__init__.py
index 4c5ef8e2508d..b58d1ceb754d 100644
--- a/lib/matplotlib/projections/__init__.py
+++ b/lib/matplotlib/projections/__init__.py
@@ -14,9 +14,9 @@
   has a facility to help with doing so.
 
 - Setting up default values (overriding `~.axes.Axes.cla`), since the defaults
-  for a rectilinear axes may not be appropriate.
+  for a rectilinear Axes may not be appropriate.
 
-- Defining the shape of the axes, for example, an elliptical axes, that will be
+- Defining the shape of the Axes, for example, an elliptical Axes, that will be
   used to draw the background of the plot and for clipping any data elements.
 
 - Defining custom locators and formatters for the projection.  For example, in
@@ -29,9 +29,9 @@
 
 - Any additional methods for additional convenience or features.
 
-Once the projection axes is defined, it can be used in one of two ways:
+Once the projection Axes is defined, it can be used in one of two ways:
 
-- By defining the class attribute ``name``, the projection axes can be
+- By defining the class attribute ``name``, the projection Axes can be
   registered with `matplotlib.projections.register_projection` and subsequently
   simply invoked by name::
 
@@ -39,7 +39,7 @@
 
 - For more complex, parameterisable projections, a generic "projection" object
   may be defined which includes the method ``_as_mpl_axes``. ``_as_mpl_axes``
-  should take no arguments and return the projection's axes subclass and a
+  should take no arguments and return the projection's Axes subclass and a
   dictionary of additional arguments to pass to the subclass' ``__init__``
   method.  Subsequently a parameterised projection can be initialised with::
 
diff --git a/lib/matplotlib/projections/polar.py b/lib/matplotlib/projections/polar.py
index 25338bca021f..8a4265c1a84a 100644
--- a/lib/matplotlib/projections/polar.py
+++ b/lib/matplotlib/projections/polar.py
@@ -141,7 +141,7 @@ class PolarAffine(mtransforms.Affine2DBase):
     r"""
     The affine part of the polar projection.
 
-    Scales the output so that maximum radius rests on the edge of the axes
+    Scales the output so that maximum radius rests on the edge of the Axes
     circle and the origin is mapped to (0.5, 0.5). The transform applied is
     the same to x and y components and given by:
 
@@ -504,7 +504,7 @@ class _ThetaShift(mtransforms.ScaledTranslation):
     Parameters
     ----------
     axes : `~matplotlib.axes.Axes`
-        The owning axes; used to determine limits.
+        The owning Axes; used to determine limits.
     pad : float
         The padding to apply, in points.
     mode : {'min', 'max', 'rlabel'}
@@ -739,7 +739,7 @@ def _is_full_circle_rad(thetamin, thetamax):
 
 class _WedgeBbox(mtransforms.Bbox):
     """
-    Transform (theta, r) wedge Bbox into axes bounding box.
+    Transform (theta, r) wedge Bbox into Axes bounding box.
 
     Parameters
     ----------
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index dc59bc809638..147ae1017c28 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -17,7 +17,7 @@
     plt.plot(x, y)
 
 The explicit object-oriented API is recommended for complex plots, though
-pyplot is still usually used to create the figure and often the axes in the
+pyplot is still usually used to create the figure and often the Axes in the
 figure. See `.pyplot.figure`, `.pyplot.subplots`, and
 `.pyplot.subplot_mosaic` to create figures, and
 :doc:`Axes API </api/axes_api>` for the plotting methods on an Axes::
@@ -838,8 +838,8 @@ def figure(
         overlapping Axes decorations (labels, ticks, etc). Note that layout
         managers can measurably slow down figure display.
 
-        - 'constrained': The constrained layout solver adjusts axes sizes
-          to avoid overlapping axes decorations.  Can handle complex plot
+        - 'constrained': The constrained layout solver adjusts Axes sizes
+          to avoid overlapping Axes decorations.  Can handle complex plot
           layouts and colorbars, and is thus recommended.
 
           See :ref:`constrainedlayout_guide`
@@ -847,7 +847,7 @@ def figure(
 
         - 'compressed': uses the same algorithm as 'constrained', but
           removes extra space between fixed-aspect-ratio Axes.  Best for
-          simple grids of axes.
+          simple grids of Axes.
 
         - 'tight': Use the tight layout mechanism. This is a relatively
           simple algorithm that adjusts the subplot parameters so that
@@ -1194,7 +1194,7 @@ def axes(
     Returns
     -------
     `~.axes.Axes`, or a subclass of `~.axes.Axes`
-        The returned axes class depends on the projection used. It is
+        The returned Axes class depends on the projection used. It is
         `~.axes.Axes` if rectilinear projection is used and
         `.projections.polar.PolarAxes` if polar projection is used.
 
@@ -1241,7 +1241,7 @@ def axes(
 
 def delaxes(ax: matplotlib.axes.Axes | None = None) -> None:
     """
-    Remove an `~.axes.Axes` (defaulting to the current axes) from its figure.
+    Remove an `~.axes.Axes` (defaulting to the current Axes) from its figure.
     """
     if ax is None:
         ax = gca()
@@ -1260,12 +1260,12 @@ def sca(ax: Axes) -> None:
 
 
 def cla() -> None:
-    """Clear the current axes."""
+    """Clear the current Axes."""
     # Not generated via boilerplate.py to allow a different docstring.
     return gca().cla()
 
 
-## More ways of creating axes ##
+## More ways of creating Axes ##
 
 @_docstring.dedent_interpd
 def subplot(*args, **kwargs) -> Axes:
@@ -1312,10 +1312,10 @@ def subplot(*args, **kwargs) -> Axes:
     sharex, sharey : `~matplotlib.axes.Axes`, optional
         Share the x or y `~matplotlib.axis` with sharex and/or sharey. The
         axis will have the same limits, ticks, and scale as the axis of the
-        shared axes.
+        shared Axes.
 
     label : str
-        A label for the returned axes.
+        A label for the returned Axes.
 
     Returns
     -------
@@ -1328,7 +1328,7 @@ def subplot(*args, **kwargs) -> Axes:
     Other Parameters
     ----------------
     **kwargs
-        This method also takes the keyword arguments for the returned axes
+        This method also takes the keyword arguments for the returned Axes
         base class; except for the *figure* argument. The keyword arguments
         for the rectilinear base class `~.axes.Axes` can be found in
         the following table but there might also be other keyword
@@ -1346,7 +1346,7 @@ def subplot(*args, **kwargs) -> Axes:
         plt.plot([1, 2, 3])
         # now create a subplot which represents the top plot of a grid
         # with 2 rows and 1 column. Since this subplot will overlap the
-        # first, the plot (and its axes) previously created, will be removed
+        # first, the plot (and its Axes) previously created, will be removed
         plt.subplot(211)
 
     If you do not want this behavior, use the `.Figure.add_subplot` method
@@ -1397,7 +1397,7 @@ def subplot(*args, **kwargs) -> Axes:
         # add ax2 to the figure again
         plt.subplot(ax2)
 
-        # make the first axes "current" again
+        # make the first Axes "current" again
         plt.subplot(221)
 
     """
@@ -1440,7 +1440,7 @@ def subplot(*args, **kwargs) -> Axes:
 
     for ax in fig.axes:
         # If we found an Axes at the position, we can re-use it if the user passed no
-        # kwargs or if the axes class and kwargs are identical.
+        # kwargs or if the Axes class and kwargs are identical.
         if (ax.get_subplotspec() == key
             and (kwargs == {}
                  or (ax._projection_init
@@ -1587,7 +1587,7 @@ def subplots(
         ax1.set_title('Sharing Y axis')
         ax2.scatter(x, y)
 
-        # Create four polar axes and access them through the returned array
+        # Create four polar Axes and access them through the returned array
         fig, axs = plt.subplots(2, 2, subplot_kw=dict(projection="polar"))
         axs[0, 0].plot(x, y)
         axs[1, 1].scatter(x, y)
@@ -1700,7 +1700,7 @@ def subplot_mosaic(
            x = [['A panel', 'A panel', 'edge'],
                 ['C panel', '.',       'edge']]
 
-        produces 4 axes:
+        produces 4 Axes:
 
         - 'A panel' which is 1 row high and spans the first two columns
         - 'edge' which is 2 rows high and is on the right edge
@@ -1778,7 +1778,7 @@ def subplot_mosaic(
 
     dict[label, Axes]
        A dictionary mapping the labels to the Axes objects.  The order of
-       the axes is left-to-right and top-to-bottom of their position in the
+       the Axes is left-to-right and top-to-bottom of their position in the
        total layout.
 
     """
@@ -1848,8 +1848,8 @@ def subplot2grid(
 
 def twinx(ax: matplotlib.axes.Axes | None = None) -> _AxesBase:
     """
-    Make and return a second axes that shares the *x*-axis.  The new axes will
-    overlay *ax* (or the current axes if *ax* is *None*), and its ticks will be
+    Make and return a second Axes that shares the *x*-axis.  The new Axes will
+    overlay *ax* (or the current Axes if *ax* is *None*), and its ticks will be
     on the right.
 
     Examples
@@ -1864,8 +1864,8 @@ def twinx(ax: matplotlib.axes.Axes | None = None) -> _AxesBase:
 
 def twiny(ax: matplotlib.axes.Axes | None = None) -> _AxesBase:
     """
-    Make and return a second axes that shares the *y*-axis.  The new axes will
-    overlay *ax* (or the current axes if *ax* is *None*), and its ticks will be
+    Make and return a second Axes that shares the *y*-axis.  The new Axes will
+    overlay *ax* (or the current Axes if *ax* is *None*), and its ticks will be
     on the top.
 
     Examples
@@ -1903,7 +1903,7 @@ def subplot_tool(targetfig: Figure | None = None) -> SubplotTool | None:
 
 def box(on: bool | None = None) -> None:
     """
-    Turn the axes box on or off on the current axes.
+    Turn the Axes box on or off on the current Axes.
 
     Parameters
     ----------
@@ -1926,7 +1926,7 @@ def box(on: bool | None = None) -> None:
 
 def xlim(*args, **kwargs) -> tuple[float, float]:
     """
-    Get or set the x limits of the current axes.
+    Get or set the x limits of the current Axes.
 
     Call signatures::
 
@@ -1950,9 +1950,9 @@ def xlim(*args, **kwargs) -> tuple[float, float]:
     Notes
     -----
     Calling this function with no arguments (e.g. ``xlim()``) is the pyplot
-    equivalent of calling `~.Axes.get_xlim` on the current axes.
+    equivalent of calling `~.Axes.get_xlim` on the current Axes.
     Calling this function with arguments is the pyplot equivalent of calling
-    `~.Axes.set_xlim` on the current axes. All arguments are passed though.
+    `~.Axes.set_xlim` on the current Axes. All arguments are passed though.
     """
     ax = gca()
     if not args and not kwargs:
@@ -1963,7 +1963,7 @@ def xlim(*args, **kwargs) -> tuple[float, float]:
 
 def ylim(*args, **kwargs) -> tuple[float, float]:
     """
-    Get or set the y-limits of the current axes.
+    Get or set the y-limits of the current Axes.
 
     Call signatures::
 
@@ -1987,9 +1987,9 @@ def ylim(*args, **kwargs) -> tuple[float, float]:
     Notes
     -----
     Calling this function with no arguments (e.g. ``ylim()``) is the pyplot
-    equivalent of calling `~.Axes.get_ylim` on the current axes.
+    equivalent of calling `~.Axes.get_ylim` on the current Axes.
     Calling this function with arguments is the pyplot equivalent of calling
-    `~.Axes.set_ylim` on the current axes. All arguments are passed though.
+    `~.Axes.set_ylim` on the current Axes. All arguments are passed though.
     """
     ax = gca()
     if not args and not kwargs:
@@ -2034,9 +2034,9 @@ def xticks(
     -----
     Calling this function with no arguments (e.g. ``xticks()``) is the pyplot
     equivalent of calling `~.Axes.get_xticks` and `~.Axes.get_xticklabels` on
-    the current axes.
+    the current Axes.
     Calling this function with arguments is the pyplot equivalent of calling
-    `~.Axes.set_xticks` and `~.Axes.set_xticklabels` on the current axes.
+    `~.Axes.set_xticks` and `~.Axes.set_xticklabels` on the current Axes.
 
     Examples
     --------
@@ -2105,9 +2105,9 @@ def yticks(
     -----
     Calling this function with no arguments (e.g. ``yticks()``) is the pyplot
     equivalent of calling `~.Axes.get_yticks` and `~.Axes.get_yticklabels` on
-    the current axes.
+    the current Axes.
     Calling this function with arguments is the pyplot equivalent of calling
-    `~.Axes.set_yticks` and `~.Axes.set_yticklabels` on the current axes.
+    `~.Axes.set_yticks` and `~.Axes.set_yticklabels` on the current Axes.
 
     Examples
     --------
@@ -2207,7 +2207,7 @@ def rgrids(
     """
     ax = gca()
     if not isinstance(ax, PolarAxes):
-        raise RuntimeError('rgrids only defined for polar axes')
+        raise RuntimeError('rgrids only defined for polar Axes')
     if all(p is None for p in [radii, labels, angle, fmt]) and not kwargs:
         lines_out: list[Line2D] = ax.yaxis.get_gridlines()
         labels_out: list[Text] = ax.yaxis.get_ticklabels()
@@ -2282,7 +2282,7 @@ def thetagrids(
     """
     ax = gca()
     if not isinstance(ax, PolarAxes):
-        raise RuntimeError('thetagrids only defined for polar axes')
+        raise RuntimeError('thetagrids only defined for polar Axes')
     if all(param is None for param in [angles, labels, fmt]) and not kwargs:
         lines_out: list[Line2D] = ax.xaxis.get_ticklines()
         labels_out: list[Text] = ax.xaxis.get_ticklabels()
diff --git a/lib/matplotlib/rcsetup.py b/lib/matplotlib/rcsetup.py
index 38d4606024d3..cf4dd07a6b98 100644
--- a/lib/matplotlib/rcsetup.py
+++ b/lib/matplotlib/rcsetup.py
@@ -1033,7 +1033,7 @@ def _convert_validator_spec(key, conv):
     "image.origin":          ["upper", "lower"],
     "image.resample":        validate_bool,
     # Specify whether vector graphics backends will combine all images on a
-    # set of axes into a single composite image
+    # set of Axes into a single composite image
     "image.composite_image": validate_bool,
 
     # contour props
@@ -1050,7 +1050,7 @@ def _convert_validator_spec(key, conv):
     "xaxis.labellocation": ["left", "center", "right"],
     "yaxis.labellocation": ["bottom", "center", "top"],
 
-    # axes props
+    # Axes props
     "axes.axisbelow":        validate_axisbelow,
     "axes.facecolor":        validate_color,  # background color
     "axes.edgecolor":        validate_color,  # edge color
@@ -1061,13 +1061,13 @@ def _convert_validator_spec(key, conv):
     "axes.spines.bottom":    validate_bool,  # denoting data boundary.
     "axes.spines.top":       validate_bool,
 
-    "axes.titlesize":     validate_fontsize,  # axes title fontsize
-    "axes.titlelocation": ["left", "center", "right"],  # axes title alignment
-    "axes.titleweight":   validate_fontweight,  # axes title font weight
-    "axes.titlecolor":    validate_color_or_auto,  # axes title font color
+    "axes.titlesize":     validate_fontsize,  # Axes title fontsize
+    "axes.titlelocation": ["left", "center", "right"],  # Axes title alignment
+    "axes.titleweight":   validate_fontweight,  # Axes title font weight
+    "axes.titlecolor":    validate_color_or_auto,  # Axes title font color
     # title location, axes units, None means auto
     "axes.titley":        validate_float_or_None,
-    # pad from axes top decoration to title in points
+    # pad from Axes top decoration to title in points
     "axes.titlepad":      validate_float,
     "axes.grid":          validate_bool,  # display grid or not
     "axes.grid.which":    ["minor", "both", "major"],  # which grids are drawn
@@ -1154,9 +1154,9 @@ def _convert_validator_spec(key, conv):
     "legend.handleheight":   validate_float,
     # the space between the legend line and legend text
     "legend.handletextpad":  validate_float,
-    # the border between the axes and legend edge
+    # the border between the Axes and legend edge
     "legend.borderaxespad":  validate_float,
-    # the border between the axes and legend edge
+    # the border between the Axes and legend edge
     "legend.columnspacing":  validate_float,
     "legend.facecolor":      validate_color_or_inherit,
     "legend.edgecolor":      validate_color_or_inherit,
@@ -1246,7 +1246,7 @@ def _convert_validator_spec(key, conv):
     # Much smaller than above because we don't need room for the text.
     "figure.constrained_layout.hspace": validate_float,
     "figure.constrained_layout.wspace": validate_float,
-    # buffer around the axes, in inches.
+    # buffer around the Axes, in inches.
     "figure.constrained_layout.h_pad": validate_float,
     "figure.constrained_layout.w_pad": validate_float,
 
diff --git a/lib/matplotlib/sankey.py b/lib/matplotlib/sankey.py
index b626abe30753..665b9d6deba2 100644
--- a/lib/matplotlib/sankey.py
+++ b/lib/matplotlib/sankey.py
@@ -138,7 +138,7 @@ def __init__(self, ax=None, scale=1.0, unit='', format='%G', gap=0.25,
             raise ValueError(
                 "'tolerance' is negative, but it must be a magnitude")
 
-        # Create axes if necessary.
+        # Create Axes if necessary.
         if ax is None:
             import matplotlib.pyplot as plt
             fig = plt.figure()
@@ -777,7 +777,7 @@ def _get_angle(a, r):
 
     def finish(self):
         """
-        Adjust the axes and return a list of information about the Sankey
+        Adjust the Axes and return a list of information about the Sankey
         subdiagram(s).
 
         Returns a list of subdiagrams with the following fields:
diff --git a/lib/matplotlib/table.py b/lib/matplotlib/table.py
index 345ce98ccf60..ff7fb06c0d08 100644
--- a/lib/matplotlib/table.py
+++ b/lib/matplotlib/table.py
@@ -671,7 +671,7 @@ def table(ax,
     *colLoc* respectively.
 
     For finer grained control over tables, use the `.Table` class and add it to
-    the axes with `.Axes.add_table`.
+    the Axes with `.Axes.add_table`.
 
     Parameters
     ----------
diff --git a/lib/matplotlib/testing/widgets.py b/lib/matplotlib/testing/widgets.py
index eb7551853653..748cdaccc7e9 100644
--- a/lib/matplotlib/testing/widgets.py
+++ b/lib/matplotlib/testing/widgets.py
@@ -12,7 +12,7 @@
 
 
 def get_ax():
-    """Create a plot and return its axes."""
+    """Create a plot and return its Axes."""
     fig, ax = plt.subplots(1, 1)
     ax.plot([0, 200], [0, 200])
     ax.set_aspect(1.0)
@@ -34,7 +34,7 @@ def mock_event(ax, button=1, xdata=0, ydata=0, key=None, step=1):
     Parameters
     ----------
     ax : `~matplotlib.axes.Axes`
-        The axes the event will be in.
+        The Axes the event will be in.
     xdata : float
         x coord of mouse in data coords.
     ydata : float
diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index 93a296e8f649..d8d7cb0144f1 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -7571,7 +7571,7 @@ def test_axis_options():
 
 def color_boxes(fig, ax):
     """
-    Helper for the tests below that test the extents of various axes elements
+    Helper for the tests below that test the extents of various Axes elements
     """
     fig.canvas.draw()
 
diff --git a/lib/matplotlib/tests/test_constrainedlayout.py b/lib/matplotlib/tests/test_constrainedlayout.py
index 6703dfe31523..4bcc1bdf75c6 100644
--- a/lib/matplotlib/tests/test_constrainedlayout.py
+++ b/lib/matplotlib/tests/test_constrainedlayout.py
@@ -347,7 +347,7 @@ def test_constrained_layout19():
 
 
 def test_constrained_layout20():
-    """Smoke test cl does not mess up added axes"""
+    """Smoke test cl does not mess up added Axes"""
     gx = np.linspace(-5, 5, 4)
     img = np.hypot(gx, gx[:, None])
 
diff --git a/lib/matplotlib/tests/test_polar.py b/lib/matplotlib/tests/test_polar.py
index 9d6e78da2cbc..702bd5e64af1 100644
--- a/lib/matplotlib/tests/test_polar.py
+++ b/lib/matplotlib/tests/test_polar.py
@@ -95,7 +95,7 @@ def test_polar_twice():
     fig = plt.figure()
     plt.polar([1, 2], [.1, .2])
     plt.polar([3, 4], [.3, .4])
-    assert len(fig.axes) == 1, 'More than one polar axes created.'
+    assert len(fig.axes) == 1, 'More than one polar Axes created.'
 
 
 @check_figures_equal()
diff --git a/lib/matplotlib/tests/test_skew.py b/lib/matplotlib/tests/test_skew.py
index df17b2f70a99..5760d6654ad7 100644
--- a/lib/matplotlib/tests/test_skew.py
+++ b/lib/matplotlib/tests/test_skew.py
@@ -1,5 +1,5 @@
 """
-Testing that skewed axes properly work.
+Testing that skewed Axes properly work.
 """
 
 from contextlib import ExitStack
diff --git a/lib/matplotlib/tests/test_ticker.py b/lib/matplotlib/tests/test_ticker.py
index 961daaa1d167..6d363a48aec8 100644
--- a/lib/matplotlib/tests/test_ticker.py
+++ b/lib/matplotlib/tests/test_ticker.py
@@ -334,7 +334,7 @@ def test_basic(self):
 
     def test_polar_axes(self):
         """
-        Polar axes have a different ticking logic.
+        Polar Axes have a different ticking logic.
         """
         fig, ax = plt.subplots(subplot_kw={'projection': 'polar'})
         ax.set_yscale('log')
diff --git a/lib/matplotlib/tests/test_tightlayout.py b/lib/matplotlib/tests/test_tightlayout.py
index 968f0da7b514..422c9c1dd444 100644
--- a/lib/matplotlib/tests/test_tightlayout.py
+++ b/lib/matplotlib/tests/test_tightlayout.py
@@ -253,7 +253,7 @@ def _subplots():
 
 
 def test_empty_layout():
-    """Test that tight layout doesn't cause an error when there are no axes."""
+    """Test that tight layout doesn't cause an error when there are no Axes."""
     fig = plt.gcf()
     fig.tight_layout()
 
diff --git a/lib/matplotlib/text.py b/lib/matplotlib/text.py
index 8734131dddc9..572ec76e223a 100644
--- a/lib/matplotlib/text.py
+++ b/lib/matplotlib/text.py
@@ -1545,10 +1545,10 @@ def set_annotation_clip(self, b):
         ----------
         b : bool or None
             - True: The annotation will be clipped when ``self.xy`` is
-              outside the axes.
+              outside the Axes.
             - False: The annotation will always be drawn.
             - None: The annotation will be clipped when ``self.xy`` is
-              outside the axes and ``self.xycoords == "data"``.
+              outside the Axes and ``self.xycoords == "data"``.
         """
         self._annotation_clip = b
 
@@ -1570,7 +1570,7 @@ def _check_xy(self, renderer=None):
             renderer = self.figure._get_renderer()
         b = self.get_annotation_clip()
         if b or (b is None and self.xycoords == "data"):
-            # check if self.xy is inside the axes.
+            # check if self.xy is inside the Axes.
             xy_pixel = self._get_position_xy(renderer)
             return self.axes.contains_point(xy_pixel)
         return True
@@ -1676,9 +1676,9 @@ def __init__(self, text, xy,
               'subfigure points'   Points from the lower left of the subfigure
               'subfigure pixels'   Pixels from the lower left of the subfigure
               'subfigure fraction' Fraction of subfigure from lower left
-              'axes points'        Points from lower left corner of axes
-              'axes pixels'        Pixels from lower left corner of axes
-              'axes fraction'      Fraction of axes from lower left
+              'axes points'        Points from lower left corner of the Axes
+              'axes pixels'        Pixels from lower left corner of the Axes
+              'axes fraction'      Fraction of Axes from lower left
               'data'               Use the coordinate system of the object
                                    being annotated (default)
               'polar'              *(theta, r)* if not native 'data'
@@ -1782,13 +1782,13 @@ def transform(renderer) -> Transform
 
         annotation_clip : bool or None, default: None
             Whether to clip (i.e. not draw) the annotation when the annotation
-            point *xy* is outside the axes area.
+            point *xy* is outside the Axes area.
 
             - If *True*, the annotation will be clipped when *xy* is outside
-              the axes.
+              the Axes.
             - If *False*, the annotation will always be drawn.
             - If *None*, the annotation will be clipped when *xy* is outside
-              the axes and *xycoords* is 'data'.
+              the Axes and *xycoords* is 'data'.
 
         **kwargs
             Additional kwargs are passed to `.Text`.
diff --git a/lib/matplotlib/ticker.py b/lib/matplotlib/ticker.py
index 8f863582b33b..7a9010ec2a5b 100644
--- a/lib/matplotlib/ticker.py
+++ b/lib/matplotlib/ticker.py
@@ -1635,7 +1635,7 @@ def nonsingular(self, v0, v1):
         Adjust a range as needed to avoid singularities.
 
         This method gets called during autoscaling, with ``(v0, v1)`` set to
-        the data limits on the axes if the axes contains any data, or
+        the data limits on the Axes if the Axes contains any data, or
         ``(-inf, +inf)`` if not.
 
         - If ``v0 == v1`` (possibly up to some floating point slop), this
@@ -2000,7 +2000,7 @@ def __init__(self, nbins=None, **kwargs):
             *if they fall exactly on an axis' edge* (this typically occurs when
             :rc:`axes.autolimit_mode` is 'round_numbers').  Removing such ticks
             is mostly useful for stacked or ganged plots, where the upper tick
-            of an axes overlaps with the lower tick of the axes above it.
+            of an Axes overlaps with the lower tick of the axes above it.
 
         min_n_ticks : int, default: 2
             Relax *nbins* and *integer* constraints if necessary to obtain
diff --git a/lib/matplotlib/widgets.py b/lib/matplotlib/widgets.py
index 55355c34ed60..4aab281c5291 100644
--- a/lib/matplotlib/widgets.py
+++ b/lib/matplotlib/widgets.py
@@ -152,7 +152,7 @@ def disconnect_events(self):
     def _get_data_coords(self, event):
         """Return *event*'s data coordinates in this widget's Axes."""
         # This method handles the possibility that event.inaxes != self.ax (which may
-        # occur if multiple axes are overlaid), in which case event.xdata/.ydata will
+        # occur if multiple Axes are overlaid), in which case event.xdata/.ydata will
         # be wrong.  Note that we still special-case the common case where
         # event.inaxes == self.ax and avoid re-running the inverse data transform,
         # because that can introduce floating point errors for synthetic events.
@@ -2261,7 +2261,7 @@ def _clean_event(self, event):
         Preprocess an event:
 
         - Replace *event* by the previous event if *event* has no ``xdata``.
-        - Get ``xdata`` and ``ydata`` from this widget's axes, and clip them to the axes
+        - Get ``xdata`` and ``ydata`` from this widget's Axes, and clip them to the axes
           limits.
         - Update the previous event.
         """
@@ -3066,7 +3066,7 @@ def closest(self, x, y):
     Parameters
     ----------
     ax : `~matplotlib.axes.Axes`
-        The parent axes for the widget.
+        The parent Axes for the widget.
 
     onselect : function
         A callback function that is called after a release event and the
diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index 1845c701323e..4d8c7e6b8e84 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -68,7 +68,7 @@ def __init__(
         fig : Figure
             The parent figure.
         rect : tuple (left, bottom, width, height), default: None.
-            The ``(left, bottom, width, height)`` axes position.
+            The ``(left, bottom, width, height)`` Axes position.
         elev : float, default: 30
             The elevation angle in degrees rotates the camera above and below
             the x-y plane, with a positive angle corresponding to a location
@@ -213,7 +213,7 @@ def set_top_view(self):
         self.stale = True
 
     def _init_axis(self):
-        """Init 3D axes; overrides creation of regular X/Y axes."""
+        """Init 3D Axes; overrides creation of regular X/Y Axes."""
         self.xaxis = axis3d.XAxis(self)
         self.yaxis = axis3d.YAxis(self)
         self.zaxis = axis3d.ZAxis(self)
@@ -1054,7 +1054,7 @@ def get_zlim(self):
         Parameters
         ----------
         value : {{"linear"}}
-            The axis scale type to apply.  3D axes currently only support
+            The axis scale type to apply.  3D Axes currently only support
             linear scales; other scales yield nonsensical results.
 
         **kwargs
@@ -1078,20 +1078,20 @@ def get_zlim(self):
 
         Notes
         -----
-        This function is merely provided for completeness, but 3D axes do not
+        This function is merely provided for completeness, but 3D Axes do not
         support dates for ticks, and so this may not work as expected.
         """)
 
     def clabel(self, *args, **kwargs):
-        """Currently not implemented for 3D axes, and returns *None*."""
+        """Currently not implemented for 3D Axes, and returns *None*."""
         return None
 
     def view_init(self, elev=None, azim=None, roll=None, vertical_axis="z",
                   share=False):
         """
-        Set the elevation and azimuth of the axes in degrees (not radians).
+        Set the elevation and azimuth of the Axes in degrees (not radians).
 
-        This can be used to rotate the axes programmatically.
+        This can be used to rotate the Axes programmatically.
 
         To look normal to the primary planes, the following elevation and
         azimuth angles can be used. A roll angle of 0, 90, 180, or 270 deg
@@ -1260,11 +1260,11 @@ def mouse_init(self, rotate_btn=1, pan_btn=2, zoom_btn=3):
         Parameters
         ----------
         rotate_btn : int or list of int, default: 1
-            The mouse button or buttons to use for 3D rotation of the axes.
+            The mouse button or buttons to use for 3D rotation of the Axes.
         pan_btn : int or list of int, default: 2
-            The mouse button or buttons to use to pan the 3D axes.
+            The mouse button or buttons to use to pan the 3D Axes.
         zoom_btn : int or list of int, default: 3
-            The mouse button or buttons to use to zoom the 3D axes.
+            The mouse button or buttons to use to zoom the 3D Axes.
         """
         self.button_pressed = None
         # coerce scalars into array-like, then convert into
@@ -1660,7 +1660,7 @@ def _zoom_data_limits(self, scale_u, scale_v, scale_w):
         transformed to the x, y, z data axes based on the current view angles.
         A scale factor > 1 zooms out and a scale factor < 1 zooms in.
 
-        For an axes that has had its aspect ratio set to 'equal', 'equalxy',
+        For an Axes that has had its aspect ratio set to 'equal', 'equalxy',
         'equalyz', or 'equalxz', the relevant axes are constrained to zoom
         equally.
 
@@ -1775,7 +1775,7 @@ def tick_params(self, axis='both', **kwargs):
         to 'both' autoscales all three axes.
 
         Also, because of how Axes3D objects are drawn very differently
-        from regular 2D axes, some of these settings may have
+        from regular 2D Axes, some of these settings may have
         ambiguous meaning.  For simplicity, the 'z' axis will
         accept settings as if it was like the 'y' axis.
 

From 826bf83751346b0c2944afdf991929a7f060dd1a Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Tue, 17 Oct 2023 01:21:52 +0200
Subject: [PATCH 0553/1120] Use Axes instead of axes in galleries

Part of #18726.
---
 galleries/examples/animation/multiple_axes.py |  2 +-
 galleries/examples/animation/random_walk.py   |  2 +-
 .../examples/axes_grid1/demo_axes_divider.py  | 10 ++--
 .../examples/axes_grid1/demo_axes_grid.py     | 12 ++---
 .../examples/axes_grid1/demo_axes_grid2.py    |  4 +-
 .../axes_grid1/demo_axes_hbox_divider.py      |  4 +-
 .../demo_colorbar_with_axes_divider.py        | 12 ++---
 .../demo_colorbar_with_inset_locator.py       |  2 +-
 .../examples/axes_grid1/demo_edge_colorbar.py |  4 +-
 .../axes_grid1/demo_fixed_size_axes.py        |  4 +-
 .../examples/axes_grid1/inset_locator_demo.py | 22 ++++-----
 .../axes_grid1/inset_locator_demo2.py         |  8 ++--
 .../axes_grid1/scatter_hist_locatable_axes.py | 10 ++--
 .../axes_grid1/simple_axes_divider1.py        |  6 +--
 .../axes_grid1/simple_axes_divider3.py        |  2 +-
 .../examples/axes_grid1/simple_axesgrid.py    |  4 +-
 .../axisartist/demo_axisline_style.py         |  2 +-
 .../axisartist/demo_curvelinear_grid.py       |  2 +-
 .../axisartist/demo_curvelinear_grid2.py      |  2 +-
 .../examples/axisartist/demo_floating_axes.py |  4 +-
 .../examples/axisartist/demo_parasite_axes.py |  2 +-
 .../examples/axisartist/simple_axisartist1.py |  2 +-
 galleries/examples/color/colorbar_basics.py   |  4 +-
 .../examples/event_handling/data_browser.py   |  2 +-
 .../event_handling/figure_axes_enter_leave.py |  2 +-
 .../examples/event_handling/pong_sgskip.py    |  2 +-
 .../image_annotated_heatmap.py                |  2 +-
 .../categorical_variables.py                  |  2 +-
 .../eventcollection_demo.py                   |  2 +-
 .../fill_between_demo.py                      |  4 +-
 .../lines_bars_and_markers/filled_step.py     |  4 +-
 .../lines_bars_and_markers/gradient_bar.py    |  2 +-
 .../lines_bars_and_markers/scatter_hist.py    | 32 ++++++-------
 .../vline_hline_demo.py                       |  2 +-
 galleries/examples/misc/coords_report.py      |  2 +-
 galleries/examples/misc/custom_projection.py  | 14 +++---
 galleries/examples/misc/fig_x.py              |  2 +-
 galleries/examples/misc/logos2.py             |  2 +-
 galleries/examples/misc/rasterization_demo.py |  2 +-
 galleries/examples/misc/svg_filter_pie.py     |  2 +-
 galleries/examples/misc/table_demo.py         |  2 +-
 galleries/examples/misc/transoffset.py        |  2 +-
 galleries/examples/misc/zorder_demo.py        |  2 +-
 galleries/examples/mplot3d/3d_bars.py         |  2 +-
 galleries/examples/mplot3d/mixed_subplots.py  |  2 +-
 galleries/examples/mplot3d/pathpatch3d.py     |  2 +-
 galleries/examples/mplot3d/subplot3d.py       |  4 +-
 .../pie_and_polar_charts/bar_of_pie.py        |  2 +-
 .../pie_and_polar_charts/nested_pie.py        |  2 +-
 .../pie_and_polar_charts/polar_legend.py      |  6 +--
 galleries/examples/pyplots/pyplot_text.py     |  2 +-
 .../shapes_and_collections/arrow_guide.py     |  2 +-
 .../shapes_and_collections/fancybox_demo.py   |  2 +-
 .../patch_collection.py                       |  2 +-
 .../specialty_plots/leftventricle_bullseye.py |  4 +-
 .../examples/specialty_plots/radar_chart.py   |  8 ++--
 .../spines/centered_spines_with_arrows.py     |  2 +-
 .../spines/multiple_yaxis_with_spines.py      |  4 +-
 galleries/examples/spines/spines.py           |  2 +-
 galleries/examples/statistics/boxplot.py      |  2 +-
 .../examples/statistics/confidence_ellipse.py |  4 +-
 .../statistics/errorbars_and_boxes.py         |  4 +-
 .../axes_box_aspect.py                        | 22 ++++-----
 .../subplots_axes_and_figures/axes_demo.py    |  6 +--
 .../subplots_axes_and_figures/axes_margins.py |  2 +-
 .../axes_zoom_effect.py                       | 12 ++---
 .../subplots_axes_and_figures/axhspan_demo.py | 10 ++--
 .../subplots_axes_and_figures/broken_axis.py  |  8 ++--
 .../demo_constrained_layout.py                |  8 ++--
 .../demo_tight_layout.py                      |  4 +-
 .../fahrenheit_celsius_scales.py              |  2 +-
 .../subplots_axes_and_figures/figure_title.py |  2 +-
 .../subplots_axes_and_figures/ganged_plots.py |  2 +-
 .../gridspec_and_subplots.py                  | 12 ++---
 .../multiple_figs_demo.py                     |  2 +-
 .../share_axis_lims_views.py                  |  2 +-
 .../shared_axis_demo.py                       |  2 +-
 .../subplots_axes_and_figures/subfigures.py   |  2 +-
 .../subplots_demo.py                          |  4 +-
 .../subplots_axes_and_figures/two_scales.py   | 12 ++---
 .../zoom_inset_axes.py                        |  6 +--
 .../align_ylabels.py                          |  2 +-
 .../annotation_demo.py                        | 20 ++++----
 .../text_labels_and_annotations/arrow_demo.py |  2 +-
 .../demo_text_rotation_mode.py                |  6 +--
 .../figlegend_demo.py                         |  2 +-
 .../label_subplots.py                         |  2 +-
 .../line_with_text.py                         |  2 +-
 .../placing_text_boxes.py                     |  2 +-
 .../titles_demo.py                            |  2 +-
 .../ticks/colorbar_tick_labelling_demo.py     |  4 +-
 .../examples/ticks/ticklabels_rotation.py     |  2 +-
 .../embedding_in_wx4_sgskip.py                |  2 +-
 .../user_interfaces/fourier_demo_wx_sgskip.py |  2 +-
 galleries/examples/widgets/multicursor.py     |  4 +-
 galleries/tutorials/artists.py                |  8 ++--
 galleries/tutorials/lifecycle.py              |  6 +--
 galleries/tutorials/pyplot.py                 | 24 +++++-----
 .../users_explain/artists/color_cycle.py      |  6 +--
 .../users_explain/artists/imshow_extent.py    |  8 ++--
 galleries/users_explain/artists/paths.py      |  2 +-
 .../artists/transforms_tutorial.py            | 30 ++++++------
 .../users_explain/axes/arranging_axes.py      |  6 +--
 galleries/users_explain/axes/autoscale.py     |  6 +--
 galleries/users_explain/axes/axes_ticks.py    |  2 +-
 .../users_explain/axes/colorbar_placement.py  | 46 +++++++++----------
 galleries/users_explain/axes/legend_guide.py  |  4 +-
 galleries/users_explain/axes/mosaic.py        | 10 ++--
 .../users_explain/axes/tight_layout_guide.py  | 14 +++---
 galleries/users_explain/customizing.py        |  2 +-
 galleries/users_explain/quick_start.py        | 18 ++++----
 galleries/users_explain/text/annotations.py   | 26 +++++------
 galleries/users_explain/text/text_props.py    |  4 +-
 113 files changed, 333 insertions(+), 333 deletions(-)

diff --git a/galleries/examples/animation/multiple_axes.py b/galleries/examples/animation/multiple_axes.py
index 8772b5b53d4f..b0bac3a5f6bc 100644
--- a/galleries/examples/animation/multiple_axes.py
+++ b/galleries/examples/animation/multiple_axes.py
@@ -1,6 +1,6 @@
 """
 =======================
-Multiple axes animation
+Multiple Axes animation
 =======================
 
 This example showcases:
diff --git a/galleries/examples/animation/random_walk.py b/galleries/examples/animation/random_walk.py
index d108da5633b5..10dcf5ade164 100644
--- a/galleries/examples/animation/random_walk.py
+++ b/galleries/examples/animation/random_walk.py
@@ -42,7 +42,7 @@ def update_lines(num, walks, lines):
 # Create lines initially without data
 lines = [ax.plot([], [], [])[0] for _ in walks]
 
-# Setting the axes properties
+# Setting the Axes properties
 ax.set(xlim3d=(0, 1), xlabel='X')
 ax.set(ylim3d=(0, 1), ylabel='Y')
 ax.set(zlim3d=(0, 1), zlabel='Z')
diff --git a/galleries/examples/axes_grid1/demo_axes_divider.py b/galleries/examples/axes_grid1/demo_axes_divider.py
index ed2e163154c4..42be8aacd8be 100644
--- a/galleries/examples/axes_grid1/demo_axes_divider.py
+++ b/galleries/examples/axes_grid1/demo_axes_divider.py
@@ -3,8 +3,8 @@
 Axes divider
 ============
 
-Axes divider to calculate location of axes and
-create a divider for them using existing axes instances.
+Axes divider to calculate location of Axes and
+create a divider for them using existing Axes instances.
 """
 
 import matplotlib.pyplot as plt
@@ -30,13 +30,13 @@ def demo_locatable_axes_hard(fig):
 
     divider = SubplotDivider(fig, 2, 2, 2, aspect=True)
 
-    # axes for image
+    # Axes for image
     ax = fig.add_subplot(axes_locator=divider.new_locator(nx=0, ny=0))
-    # axes for colorbar
+    # Axes for colorbar
     ax_cb = fig.add_subplot(axes_locator=divider.new_locator(nx=2, ny=0))
 
     divider.set_horizontal([
-        Size.AxesX(ax),  # main axes
+        Size.AxesX(ax),  # main Axes
         Size.Fixed(0.05),  # padding, 0.1 inch
         Size.Fixed(0.2),  # colorbar, 0.3 inch
     ])
diff --git a/galleries/examples/axes_grid1/demo_axes_grid.py b/galleries/examples/axes_grid1/demo_axes_grid.py
index 70bb19da38fa..d29ca6a05859 100644
--- a/galleries/examples/axes_grid1/demo_axes_grid.py
+++ b/galleries/examples/axes_grid1/demo_axes_grid.py
@@ -3,7 +3,7 @@
 Demo Axes Grid
 ==============
 
-Grid of 2x2 images with a single colorbar or with one colorbar per axes.
+Grid of 2x2 images with a single colorbar or with one colorbar per Axes.
 """
 
 import matplotlib.pyplot as plt
@@ -17,13 +17,13 @@
 
 
 # A grid of 2x2 images with 0.05 inch pad between images and only the
-# lower-left axes is labeled.
+# lower-left Axes is labeled.
 grid = ImageGrid(
     fig, 141,  # similar to fig.add_subplot(141).
      nrows_ncols=(2, 2), axes_pad=0.05, label_mode="1")
 for ax in grid:
     ax.imshow(Z, extent=extent)
-# This only affects axes in first column and second row as share_all=False.
+# This only affects Axes in first column and second row as share_all=False.
 grid.axes_llc.set(xticks=[-2, 0, 2], yticks=[-2, 0, 2])
 
 
@@ -37,7 +37,7 @@
 grid.cbar_axes[0].colorbar(im)
 for cax in grid.cbar_axes:
     cax.tick_params(labeltop=False)
-# This affects all axes as share_all = True.
+# This affects all Axes as share_all = True.
 grid.axes_llc.set(xticks=[-2, 0, 2], yticks=[-2, 0, 2])
 
 
@@ -50,7 +50,7 @@
     im = ax.imshow(Z, extent=extent)
     cax.colorbar(im)
     cax.tick_params(labeltop=False)
-# This affects all axes as share_all = True.
+# This affects all Axes as share_all = True.
 grid.axes_llc.set(xticks=[-2, 0, 2], yticks=[-2, 0, 2])
 
 
@@ -65,7 +65,7 @@
     im = ax.imshow(Z, extent=extent, vmin=vlim[0], vmax=vlim[1])
     cb = cax.colorbar(im)
     cb.set_ticks((vlim[0], vlim[1]))
-# This affects all axes as share_all = True.
+# This affects all Axes as share_all = True.
 grid.axes_llc.set(xticks=[-2, 0, 2], yticks=[-2, 0, 2])
 
 
diff --git a/galleries/examples/axes_grid1/demo_axes_grid2.py b/galleries/examples/axes_grid1/demo_axes_grid2.py
index 98eeb15ead51..458e83b6d68f 100644
--- a/galleries/examples/axes_grid1/demo_axes_grid2.py
+++ b/galleries/examples/axes_grid1/demo_axes_grid2.py
@@ -33,7 +33,7 @@ def add_inner_title(ax, title, loc, **kwargs):
 ZS = [Z[i::3, :] for i in range(3)]
 extent = extent[0], extent[1]/3., extent[2], extent[3]
 
-# *** Demo 1: colorbar at each axes ***
+# *** Demo 1: colorbar at each Axes ***
 grid = ImageGrid(
     # 211 = at the position of fig.add_subplot(211)
     fig, 211, nrows_ncols=(1, 3), axes_pad=0.05, label_mode="1", share_all=True,
@@ -60,7 +60,7 @@ def add_inner_title(ax, title, loc, **kwargs):
 for ax, z in zip(grid2, ZS):
     im = ax.imshow(z, clim=clim, origin="lower", extent=extent)
 
-# With cbar_mode="single", cax attribute of all axes are identical.
+# With cbar_mode="single", cax attribute of all Axes are identical.
 ax.cax.colorbar(im)
 
 for ax, im_title in zip(grid2, ["(a)", "(b)", "(c)"]):
diff --git a/galleries/examples/axes_grid1/demo_axes_hbox_divider.py b/galleries/examples/axes_grid1/demo_axes_hbox_divider.py
index 65d6764a3374..5188bdf66d6f 100644
--- a/galleries/examples/axes_grid1/demo_axes_hbox_divider.py
+++ b/galleries/examples/axes_grid1/demo_axes_hbox_divider.py
@@ -5,7 +5,7 @@
 
 Using an `.HBoxDivider` to arrange subplots.
 
-Note that both axes' location are adjusted so that they have
+Note that both Axes' location are adjusted so that they have
 equal heights while maintaining their aspect ratios.
 
 """
@@ -36,7 +36,7 @@
 # %%
 # Using a `.VBoxDivider` to arrange subplots.
 #
-# Note that both axes' location are adjusted so that they have
+# Note that both Axes' location are adjusted so that they have
 # equal widths while maintaining their aspect ratios.
 
 fig, (ax1, ax2) = plt.subplots(2, 1)
diff --git a/galleries/examples/axes_grid1/demo_colorbar_with_axes_divider.py b/galleries/examples/axes_grid1/demo_colorbar_with_axes_divider.py
index 0c0771013c9f..a04fac2c3ebe 100644
--- a/galleries/examples/axes_grid1/demo_colorbar_with_axes_divider.py
+++ b/galleries/examples/axes_grid1/demo_colorbar_with_axes_divider.py
@@ -5,14 +5,14 @@
 Colorbar with AxesDivider
 =========================
 
-The `.axes_divider.make_axes_locatable` function takes an existing axes, adds
+The `.axes_divider.make_axes_locatable` function takes an existing Axes, adds
 it to a new `.AxesDivider` and returns the `.AxesDivider`.  The `.append_axes`
-method of the `.AxesDivider` can then be used to create a new axes on a given
-side ("top", "right", "bottom", or "left") of the original axes. This example
-uses `.append_axes` to add colorbars next to axes.
+method of the `.AxesDivider` can then be used to create a new Axes on a given
+side ("top", "right", "bottom", or "left") of the original Axes. This example
+uses `.append_axes` to add colorbars next to Axes.
 
-Users should consider simply passing the main axes to the *ax* keyword argument of
-`~.Figure.colorbar` instead of creating a locatable axes manually like this.
+Users should consider simply passing the main Axes to the *ax* keyword argument of
+`~.Figure.colorbar` instead of creating a locatable Axes manually like this.
 See :ref:`colorbar_placement`.
 
 .. redirect-from:: /gallery/axes_grid1/simple_colorbar
diff --git a/galleries/examples/axes_grid1/demo_colorbar_with_inset_locator.py b/galleries/examples/axes_grid1/demo_colorbar_with_inset_locator.py
index e450485150d7..d989fb44bbab 100644
--- a/galleries/examples/axes_grid1/demo_colorbar_with_inset_locator.py
+++ b/galleries/examples/axes_grid1/demo_colorbar_with_inset_locator.py
@@ -8,7 +8,7 @@
 This example shows how to control the position, height, and width of colorbars
 using `~mpl_toolkits.axes_grid1.inset_locator.inset_axes`.
 
-Inset axes placement is controlled as for legends: either by providing a *loc*
+Inset Axes placement is controlled as for legends: either by providing a *loc*
 option ("upper right", "best", ...), or by providing a locator with respect to
 the parent bbox.  Parameters such as *bbox_to_anchor* and *borderpad* likewise
 work in the same way, and are also demonstrated here.
diff --git a/galleries/examples/axes_grid1/demo_edge_colorbar.py b/galleries/examples/axes_grid1/demo_edge_colorbar.py
index e0d5f2b45f77..bde482977991 100644
--- a/galleries/examples/axes_grid1/demo_edge_colorbar.py
+++ b/galleries/examples/axes_grid1/demo_edge_colorbar.py
@@ -44,7 +44,7 @@ def demo_bottom_cbar(fig):
     for cax in grid.cbar_axes:
         cax.axis[cax.orientation].set_label("Bar")
 
-    # This affects all axes as share_all = True.
+    # This affects all Axes as share_all = True.
     grid.axes_llc.set_xticks([-2, 0, 2])
     grid.axes_llc.set_yticks([-2, 0, 2])
 
@@ -73,7 +73,7 @@ def demo_right_cbar(fig):
     for cax in grid.cbar_axes:
         cax.axis[cax.orientation].set_label('Foo')
 
-    # This affects all axes because we set share_all = True.
+    # This affects all Axes because we set share_all = True.
     grid.axes_llc.set_xticks([-2, 0, 2])
     grid.axes_llc.set_yticks([-2, 0, 2])
 
diff --git a/galleries/examples/axes_grid1/demo_fixed_size_axes.py b/galleries/examples/axes_grid1/demo_fixed_size_axes.py
index 7f56c97ee126..a8f8685a115c 100644
--- a/galleries/examples/axes_grid1/demo_fixed_size_axes.py
+++ b/galleries/examples/axes_grid1/demo_fixed_size_axes.py
@@ -16,7 +16,7 @@
 
 fig = plt.figure(figsize=(6, 6))
 
-# The first items are for padding and the second items are for the axes.
+# The first items are for padding and the second items are for the Axes.
 # sizes are in inch.
 h = [Size.Fixed(1.0), Size.Fixed(4.5)]
 v = [Size.Fixed(0.7), Size.Fixed(5.)]
@@ -35,7 +35,7 @@
 fig = plt.figure(figsize=(6, 6))
 
 # The first & third items are for padding and the second items are for the
-# axes. Sizes are in inches.
+# Axes. Sizes are in inches.
 h = [Size.Fixed(1.0), Size.Scaled(1.), Size.Fixed(.2)]
 v = [Size.Fixed(0.7), Size.Scaled(1.), Size.Fixed(.5)]
 
diff --git a/galleries/examples/axes_grid1/inset_locator_demo.py b/galleries/examples/axes_grid1/inset_locator_demo.py
index b0af820a4253..fa9c4593d932 100644
--- a/galleries/examples/axes_grid1/inset_locator_demo.py
+++ b/galleries/examples/axes_grid1/inset_locator_demo.py
@@ -7,7 +7,7 @@
 
 # %%
 # The `.inset_locator`'s `~.inset_locator.inset_axes` allows
-# easily placing insets in the corners of the axes by specifying a width and
+# easily placing insets in the corners of the Axes by specifying a width and
 # height and optionally a location (loc) that accepts locations as codes,
 # similar to `~matplotlib.axes.Axes.legend`.
 # By default, the inset is offset by some points from the axes,
@@ -23,17 +23,17 @@
 # at the default upper right location
 axins = inset_axes(ax, width=1.3, height=0.9)
 
-# Create inset of width 30% and height 40% of the parent axes' bounding box
+# Create inset of width 30% and height 40% of the parent Axes' bounding box
 # at the lower left corner (loc=3)
 axins2 = inset_axes(ax, width="30%", height="40%", loc=3)
 
 # Create inset of mixed specifications in the second subplot;
-# width is 30% of parent axes' bounding box and
+# width is 30% of parent Axes' bounding box and
 # height is 1 inch at the upper left corner (loc=2)
 axins3 = inset_axes(ax2, width="30%", height=1., loc=2)
 
 # Create an inset in the lower right corner (loc=4) with borderpad=1, i.e.
-# 10 points padding (as 10pt is the default fontsize) to the parent axes
+# 10 points padding (as 10pt is the default fontsize) to the parent Axes
 axins4 = inset_axes(ax2, width="20%", height="20%", loc=4, borderpad=1)
 
 # Turn ticklabels of insets off
@@ -54,9 +54,9 @@
 fig = plt.figure(figsize=[5.5, 2.8])
 ax = fig.add_subplot(121)
 
-# We use the axes transform as bbox_transform. Therefore, the bounding box
+# We use the Axes transform as bbox_transform. Therefore, the bounding box
 # needs to be specified in axes coordinates ((0, 0) is the lower left corner
-# of the axes, (1, 1) is the upper right corner).
+# of the Axes, (1, 1) is the upper right corner).
 # The bounding box (.2, .4, .6, .5) starts at (.2, .4) and ranges to (.8, .9)
 # in those coordinates.
 # Inside this bounding box an inset of half the bounding box' width and
@@ -78,7 +78,7 @@
 
 
 # Note how the two following insets are created at the same positions, one by
-# use of the default parent axes' bbox and the other via a bbox in axes
+# use of the default parent Axes' bbox and the other via a bbox in Axes
 # coordinates and the respective transform.
 ax2 = fig.add_subplot(222)
 axins2 = inset_axes(ax2, width="30%", height="50%")
@@ -101,8 +101,8 @@
 
 
 # %%
-# In the above the axes transform together with 4-tuple bounding boxes has been
-# used as it mostly is useful to specify an inset relative to the axes it is
+# In the above the Axes transform together with 4-tuple bounding boxes has been
+# used as it mostly is useful to specify an inset relative to the Axes it is
 # an inset to. However, other use cases are equally possible. The following
 # example examines some of those.
 #
@@ -110,7 +110,7 @@
 fig = plt.figure(figsize=[5.5, 2.8])
 ax = fig.add_subplot(131)
 
-# Create an inset outside the axes
+# Create an inset outside the Axes
 axins = inset_axes(ax, width="100%", height="100%",
                    bbox_to_anchor=(1.05, .6, .5, .4),
                    bbox_transform=ax.transAxes, loc=2, borderpad=0)
@@ -134,7 +134,7 @@
                     bbox_transform=ax2.transData, loc=2, borderpad=0)
 
 # Create an inset horizontally centered in figure coordinates and vertically
-# bound to line up with the axes.
+# bound to line up with the Axes.
 from matplotlib.transforms import blended_transform_factory  # noqa
 
 transform = blended_transform_factory(fig.transFigure, ax2.transAxes)
diff --git a/galleries/examples/axes_grid1/inset_locator_demo2.py b/galleries/examples/axes_grid1/inset_locator_demo2.py
index 38a58a7df2ff..f648c38e8d55 100644
--- a/galleries/examples/axes_grid1/inset_locator_demo2.py
+++ b/galleries/examples/axes_grid1/inset_locator_demo2.py
@@ -26,7 +26,7 @@
 ax.set_aspect(1)
 
 axins = zoomed_inset_axes(ax, zoom=0.5, loc='upper right')
-# fix the number of ticks on the inset axes
+# fix the number of ticks on the inset Axes
 axins.yaxis.get_major_locator().set_params(nbins=7)
 axins.xaxis.get_major_locator().set_params(nbins=7)
 axins.tick_params(labelleft=False, labelbottom=False)
@@ -61,13 +61,13 @@ def add_sizebar(ax, size):
 x1, x2, y1, y2 = -1.5, -0.9, -2.5, -1.9
 axins2.set_xlim(x1, x2)
 axins2.set_ylim(y1, y2)
-# fix the number of ticks on the inset axes
+# fix the number of ticks on the inset Axes
 axins2.yaxis.get_major_locator().set_params(nbins=7)
 axins2.xaxis.get_major_locator().set_params(nbins=7)
 axins2.tick_params(labelleft=False, labelbottom=False)
 
-# draw a bbox of the region of the inset axes in the parent axes and
-# connecting lines between the bbox and the inset axes area
+# draw a bbox of the region of the inset Axes in the parent Axes and
+# connecting lines between the bbox and the inset Axes area
 mark_inset(ax2, axins2, loc1=2, loc2=4, fc="none", ec="0.5")
 
 plt.show()
diff --git a/galleries/examples/axes_grid1/scatter_hist_locatable_axes.py b/galleries/examples/axes_grid1/scatter_hist_locatable_axes.py
index 8304334b90eb..e5ff19d9ee08 100644
--- a/galleries/examples/axes_grid1/scatter_hist_locatable_axes.py
+++ b/galleries/examples/axes_grid1/scatter_hist_locatable_axes.py
@@ -6,12 +6,12 @@
 Show the marginal distributions of a scatter plot as histograms at the sides of
 the plot.
 
-For a nice alignment of the main axes with the marginals, the axes positions
+For a nice alignment of the main Axes with the marginals, the Axes positions
 are defined by a ``Divider``, produced via `.make_axes_locatable`.  Note that
-the ``Divider`` API allows setting axes sizes and pads in inches, which is its
+the ``Divider`` API allows setting Axes sizes and pads in inches, which is its
 main feature.
 
-If one wants to set axes sizes and pads relative to the main Figure, see the
+If one wants to set Axes sizes and pads relative to the main Figure, see the
 :doc:`/gallery/lines_bars_and_markers/scatter_hist` example.
 """
 
@@ -33,10 +33,10 @@
 # the scatter plot:
 ax.scatter(x, y)
 
-# Set aspect of the main axes.
+# Set aspect of the main Axes.
 ax.set_aspect(1.)
 
-# create new axes on the right and on the top of the current axes
+# create new Axes on the right and on the top of the current Axes
 divider = make_axes_locatable(ax)
 # below height and pad are in inches
 ax_histx = divider.append_axes("top", 1.2, pad=0.1, sharex=ax)
diff --git a/galleries/examples/axes_grid1/simple_axes_divider1.py b/galleries/examples/axes_grid1/simple_axes_divider1.py
index 4b7edc27ae9b..414672dc3596 100644
--- a/galleries/examples/axes_grid1/simple_axes_divider1.py
+++ b/galleries/examples/axes_grid1/simple_axes_divider1.py
@@ -20,7 +20,7 @@ def label_axes(ax, text):
 
 
 # %%
-# Fixed axes sizes; fixed paddings.
+# Fixed Axes sizes; fixed paddings.
 
 fig = plt.figure(figsize=(6, 6))
 fig.suptitle("Fixed axes sizes, fixed paddings")
@@ -30,7 +30,7 @@ def label_axes(ax, text):
 vert = [Size.Fixed(1.5), Size.Fixed(.5), Size.Fixed(1.)]
 
 rect = (0.1, 0.1, 0.8, 0.8)
-# Divide the axes rectangle into a grid with sizes specified by horiz * vert.
+# Divide the Axes rectangle into a grid with sizes specified by horiz * vert.
 div = Divider(fig, rect, horiz, vert, aspect=False)
 
 # The rect parameter will actually be ignored and overridden by axes_locator.
@@ -53,7 +53,7 @@ def label_axes(ax, text):
 vert = [Size.Scaled(1.), Size.Fixed(.5), Size.Scaled(1.5)]
 
 rect = (0.1, 0.1, 0.8, 0.8)
-# Divide the axes rectangle into a grid with sizes specified by horiz * vert.
+# Divide the Axes rectangle into a grid with sizes specified by horiz * vert.
 div = Divider(fig, rect, horiz, vert, aspect=False)
 
 # The rect parameter will actually be ignored and overridden by axes_locator.
diff --git a/galleries/examples/axes_grid1/simple_axes_divider3.py b/galleries/examples/axes_grid1/simple_axes_divider3.py
index 54050633d4ea..e2f195bcb753 100644
--- a/galleries/examples/axes_grid1/simple_axes_divider3.py
+++ b/galleries/examples/axes_grid1/simple_axes_divider3.py
@@ -21,7 +21,7 @@
 horiz = [Size.AxesX(ax[0]), Size.Fixed(.5), Size.AxesX(ax[1])]
 vert = [Size.AxesY(ax[0]), Size.Fixed(.5), Size.AxesY(ax[2])]
 
-# divide the axes rectangle into grid whose size is specified by horiz * vert
+# divide the Axes rectangle into grid whose size is specified by horiz * vert
 divider = Divider(fig, rect, horiz, vert, aspect=False)
 
 
diff --git a/galleries/examples/axes_grid1/simple_axesgrid.py b/galleries/examples/axes_grid1/simple_axesgrid.py
index ef13fdd74aee..bc9ffce692f8 100644
--- a/galleries/examples/axes_grid1/simple_axesgrid.py
+++ b/galleries/examples/axes_grid1/simple_axesgrid.py
@@ -18,8 +18,8 @@
 
 fig = plt.figure(figsize=(4., 4.))
 grid = ImageGrid(fig, 111,  # similar to subplot(111)
-                 nrows_ncols=(2, 2),  # creates 2x2 grid of axes
-                 axes_pad=0.1,  # pad between axes in inch.
+                 nrows_ncols=(2, 2),  # creates 2x2 grid of Axes
+                 axes_pad=0.1,  # pad between Axes in inch.
                  )
 
 for ax, im in zip(grid, [im1, im2, im3, im4]):
diff --git a/galleries/examples/axisartist/demo_axisline_style.py b/galleries/examples/axisartist/demo_axisline_style.py
index 644864be8103..3fd1d4d8b767 100644
--- a/galleries/examples/axisartist/demo_axisline_style.py
+++ b/galleries/examples/axisartist/demo_axisline_style.py
@@ -5,7 +5,7 @@
 
 This example shows some configurations for axis style.
 
-Note: The `mpl_toolkits.axisartist` axes classes may be confusing for new
+Note: The `mpl_toolkits.axisartist` Axes classes may be confusing for new
 users. If the only aim is to obtain arrow heads at the ends of the axes,
 rather check out the :doc:`/gallery/spines/centered_spines_with_arrows`
 example.
diff --git a/galleries/examples/axisartist/demo_curvelinear_grid.py b/galleries/examples/axisartist/demo_curvelinear_grid.py
index 76ade00ecb5e..fb1fbdd011ce 100644
--- a/galleries/examples/axisartist/demo_curvelinear_grid.py
+++ b/galleries/examples/axisartist/demo_curvelinear_grid.py
@@ -90,7 +90,7 @@ def curvelinear_test2(fig):
 
     ax1.grid(True, zorder=0)
 
-    # A parasite axes with given transform
+    # A parasite Axes with given transform
     ax2 = ax1.get_aux_axes(tr)
     # note that ax2.transData == tr + ax1.transData
     # Anything you draw in ax2 will match the ticks and grids of ax1.
diff --git a/galleries/examples/axisartist/demo_curvelinear_grid2.py b/galleries/examples/axisartist/demo_curvelinear_grid2.py
index 4a8c115f196f..9bf3c5598244 100644
--- a/galleries/examples/axisartist/demo_curvelinear_grid2.py
+++ b/galleries/examples/axisartist/demo_curvelinear_grid2.py
@@ -7,7 +7,7 @@
 
 This example demonstrates how to use GridHelperCurveLinear to define
 custom grids and ticklines by applying a transformation on the grid.
-As showcase on the plot, a 5x5 matrix is displayed on the axes.
+As showcase on the plot, a 5x5 matrix is displayed on the Axes.
 """
 
 import matplotlib.pyplot as plt
diff --git a/galleries/examples/axisartist/demo_floating_axes.py b/galleries/examples/axisartist/demo_floating_axes.py
index 87577b29c756..add03e266d3e 100644
--- a/galleries/examples/axisartist/demo_floating_axes.py
+++ b/galleries/examples/axisartist/demo_floating_axes.py
@@ -76,7 +76,7 @@ def setup_axes2(fig, rect):
         rect, axes_class=floating_axes.FloatingAxes, grid_helper=grid_helper)
     ax1.grid()
 
-    # create a parasite axes whose transData in RA, cz
+    # create a parasite Axes whose transData in RA, cz
     aux_ax = ax1.get_aux_axes(tr)
 
     aux_ax.patch = ax1.patch  # for aux_ax to have a clip path as in ax
@@ -134,7 +134,7 @@ def setup_axes3(fig, rect):
     ax1.axis["top"].label.set_text(r"$\alpha_{1950}$")
     ax1.grid()
 
-    # create a parasite axes whose transData in RA, cz
+    # create a parasite Axes whose transData in RA, cz
     aux_ax = ax1.get_aux_axes(tr)
 
     aux_ax.patch = ax1.patch  # for aux_ax to have a clip path as in ax
diff --git a/galleries/examples/axisartist/demo_parasite_axes.py b/galleries/examples/axisartist/demo_parasite_axes.py
index fb04e1e77873..8565ef455c7e 100644
--- a/galleries/examples/axisartist/demo_parasite_axes.py
+++ b/galleries/examples/axisartist/demo_parasite_axes.py
@@ -3,7 +3,7 @@
 Parasite Axes demo
 ==================
 
-Create a parasite axes. Such axes would share the x scale with a host axes,
+Create a parasite Axes. Such Axes would share the x scale with a host Axes,
 but show a different scale in y direction.
 
 This approach uses `mpl_toolkits.axes_grid1.parasite_axes.HostAxes` and
diff --git a/galleries/examples/axisartist/simple_axisartist1.py b/galleries/examples/axisartist/simple_axisartist1.py
index 4c0807d86d24..386347e142a1 100644
--- a/galleries/examples/axisartist/simple_axisartist1.py
+++ b/galleries/examples/axisartist/simple_axisartist1.py
@@ -19,7 +19,7 @@
 from mpl_toolkits import axisartist
 
 fig = plt.figure(figsize=(6, 3), layout="constrained")
-# To construct axes of two different classes, we need to use gridspec (or
+# To construct Axes of two different classes, we need to use gridspec (or
 # MATLAB-style add_subplot calls).
 gs = fig.add_gridspec(1, 2)
 
diff --git a/galleries/examples/color/colorbar_basics.py b/galleries/examples/color/colorbar_basics.py
index 30fb7ed3096b..506789916637 100644
--- a/galleries/examples/color/colorbar_basics.py
+++ b/galleries/examples/color/colorbar_basics.py
@@ -5,7 +5,7 @@
 
 Use `~.Figure.colorbar` by specifying the mappable object (here
 the `.AxesImage` returned by `~.axes.Axes.imshow`)
-and the axes to attach the colorbar to.
+and the Axes to attach the colorbar to.
 """
 
 import matplotlib.pyplot as plt
@@ -28,7 +28,7 @@
 
 # add the colorbar using the figure's method,
 # telling which mappable we're talking about and
-# which axes object it should be near
+# which Axes object it should be near
 fig.colorbar(pos, ax=ax1)
 
 # repeat everything above for the negative data
diff --git a/galleries/examples/event_handling/data_browser.py b/galleries/examples/event_handling/data_browser.py
index c24c77ecc57f..6d9068940285 100644
--- a/galleries/examples/event_handling/data_browser.py
+++ b/galleries/examples/event_handling/data_browser.py
@@ -23,7 +23,7 @@
 class PointBrowser:
     """
     Click on a point to select and highlight it -- the data that
-    generated the point will be shown in the lower axes.  Use the 'n'
+    generated the point will be shown in the lower Axes.  Use the 'n'
     and 'p' keys to browse through the next and previous points
     """
 
diff --git a/galleries/examples/event_handling/figure_axes_enter_leave.py b/galleries/examples/event_handling/figure_axes_enter_leave.py
index d55fb6e69d6a..0793f2901585 100644
--- a/galleries/examples/event_handling/figure_axes_enter_leave.py
+++ b/galleries/examples/event_handling/figure_axes_enter_leave.py
@@ -42,7 +42,7 @@ def on_leave_figure(event):
 
 
 fig, axs = plt.subplots(2, 1)
-fig.suptitle('mouse hover over figure or axes to trigger events')
+fig.suptitle('mouse hover over figure or Axes to trigger events')
 
 fig.canvas.mpl_connect('figure_enter_event', on_enter_figure)
 fig.canvas.mpl_connect('figure_leave_event', on_leave_figure)
diff --git a/galleries/examples/event_handling/pong_sgskip.py b/galleries/examples/event_handling/pong_sgskip.py
index 5b26c143e7ac..e93f89580621 100644
--- a/galleries/examples/event_handling/pong_sgskip.py
+++ b/galleries/examples/event_handling/pong_sgskip.py
@@ -234,7 +234,7 @@ def draw(self):
                 puck.disp.set_offsets([[puck.x, puck.y]])
                 self.ax.draw_artist(puck.disp)
 
-        # just redraw the axes rectangle
+        # just redraw the Axes rectangle
         self.canvas.blit(self.ax.bbox)
         self.canvas.flush_events()
         if self.cnt == 50000:
diff --git a/galleries/examples/images_contours_and_fields/image_annotated_heatmap.py b/galleries/examples/images_contours_and_fields/image_annotated_heatmap.py
index 1802af0e6823..23d9fd48dff8 100644
--- a/galleries/examples/images_contours_and_fields/image_annotated_heatmap.py
+++ b/galleries/examples/images_contours_and_fields/image_annotated_heatmap.py
@@ -114,7 +114,7 @@ def heatmap(data, row_labels, col_labels, ax=None,
         A list or array of length N with the labels for the columns.
     ax
         A `matplotlib.axes.Axes` instance to which the heatmap is plotted.  If
-        not provided, use current axes or create a new one.  Optional.
+        not provided, use current Axes or create a new one.  Optional.
     cbar_kw
         A dictionary with arguments to `matplotlib.Figure.colorbar`.  Optional.
     cbarlabel
diff --git a/galleries/examples/lines_bars_and_markers/categorical_variables.py b/galleries/examples/lines_bars_and_markers/categorical_variables.py
index bb42ec182ada..e28dda0dda47 100644
--- a/galleries/examples/lines_bars_and_markers/categorical_variables.py
+++ b/galleries/examples/lines_bars_and_markers/categorical_variables.py
@@ -20,7 +20,7 @@
 
 
 # %%
-# This works on both axes:
+# This works on both Axes:
 
 cat = ["bored", "happy", "bored", "bored", "happy", "bored"]
 dog = ["happy", "happy", "happy", "happy", "bored", "bored"]
diff --git a/galleries/examples/lines_bars_and_markers/eventcollection_demo.py b/galleries/examples/lines_bars_and_markers/eventcollection_demo.py
index f82fb829c248..18783e1649bc 100644
--- a/galleries/examples/lines_bars_and_markers/eventcollection_demo.py
+++ b/galleries/examples/lines_bars_and_markers/eventcollection_demo.py
@@ -4,7 +4,7 @@
 ====================
 
 Plot two curves, then use `.EventCollection`\s to mark the locations of the x
-and y data points on the respective axes for each curve.
+and y data points on the respective Axes for each curve.
 """
 
 import matplotlib.pyplot as plt
diff --git a/galleries/examples/lines_bars_and_markers/fill_between_demo.py b/galleries/examples/lines_bars_and_markers/fill_between_demo.py
index 1bdab8921415..656a8695ba18 100644
--- a/galleries/examples/lines_bars_and_markers/fill_between_demo.py
+++ b/galleries/examples/lines_bars_and_markers/fill_between_demo.py
@@ -113,8 +113,8 @@
 # Selectively marking horizontal regions across the whole Axes
 # ------------------------------------------------------------
 # The same selection mechanism can be applied to fill the full vertical height
-# of the axes. To be independent of y-limits, we add a transform that
-# interprets the x-values in data coordinates and the y-values in axes
+# of the Axes. To be independent of y-limits, we add a transform that
+# interprets the x-values in data coordinates and the y-values in Axes
 # coordinates.
 #
 # The following example marks the regions in which the y-data are above a
diff --git a/galleries/examples/lines_bars_and_markers/filled_step.py b/galleries/examples/lines_bars_and_markers/filled_step.py
index abc806fc5acf..65a7d31a425a 100644
--- a/galleries/examples/lines_bars_and_markers/filled_step.py
+++ b/galleries/examples/lines_bars_and_markers/filled_step.py
@@ -25,7 +25,7 @@ def filled_hist(ax, edges, values, bottoms=None, orientation='v',
     Parameters
     ----------
     ax : Axes
-        The axes to plot to
+        The Axes to plot to.
 
     edges : array
         A length n+1 array giving the left edges of each bin and the
@@ -85,7 +85,7 @@ def stack_hist(ax, stacked_data, sty_cycle, bottoms=None,
     Parameters
     ----------
     ax : axes.Axes
-        The axes to add artists too
+        The Axes to add artists to.
 
     stacked_data : array or Mapping
         A (M, N) shaped array.  The first dimension will be iterated over to
diff --git a/galleries/examples/lines_bars_and_markers/gradient_bar.py b/galleries/examples/lines_bars_and_markers/gradient_bar.py
index 1c61a4bb908e..4cd86f26590f 100644
--- a/galleries/examples/lines_bars_and_markers/gradient_bar.py
+++ b/galleries/examples/lines_bars_and_markers/gradient_bar.py
@@ -30,7 +30,7 @@ def gradient_image(ax, direction=0.3, cmap_range=(0, 1), **kwargs):
     Parameters
     ----------
     ax : Axes
-        The axes to draw on.
+        The Axes to draw on.
     direction : float
         The direction of the gradient. This is a number in
         range 0 (=vertical) to 1 (=horizontal).
diff --git a/galleries/examples/lines_bars_and_markers/scatter_hist.py b/galleries/examples/lines_bars_and_markers/scatter_hist.py
index 9e4598a15957..95a373961aa1 100644
--- a/galleries/examples/lines_bars_and_markers/scatter_hist.py
+++ b/galleries/examples/lines_bars_and_markers/scatter_hist.py
@@ -6,23 +6,23 @@
 Show the marginal distributions of a scatter plot as histograms at the sides of
 the plot.
 
-For a nice alignment of the main axes with the marginals, two options are shown
+For a nice alignment of the main Axes with the marginals, two options are shown
 below:
 
 .. contents::
    :local:
 
 While `.Axes.inset_axes` may be a bit more complex, it allows correct handling
-of main axes with a fixed aspect ratio.
+of main Axes with a fixed aspect ratio.
 
 An alternative method to produce a similar figure using the ``axes_grid1``
 toolkit is shown in the :doc:`/gallery/axes_grid1/scatter_hist_locatable_axes`
-example.  Finally, it is also possible to position all axes in absolute
+example.  Finally, it is also possible to position all Axes in absolute
 coordinates using `.Figure.add_axes` (not shown here).
 
 Let us first define a function that takes x and y data as input, as well
-as three axes, the main axes for the scatter, and two marginal axes. It will
-then create the scatter and histograms inside the provided axes.
+as three Axes, the main Axes for the scatter, and two marginal Axes. It will
+then create the scatter and histograms inside the provided Axes.
 """
 
 import matplotlib.pyplot as plt
@@ -56,7 +56,7 @@ def scatter_hist(x, y, ax, ax_histx, ax_histy):
 
 # %%
 #
-# Defining the axes positions using a gridspec
+# Defining the Axes positions using a gridspec
 # --------------------------------------------
 #
 # We define a gridspec with unequal width- and height-ratios to achieve desired
@@ -65,7 +65,7 @@ def scatter_hist(x, y, ax, ax_histx, ax_histy):
 # Start with a square Figure.
 fig = plt.figure(figsize=(6, 6))
 # Add a gridspec with two rows and two columns and a ratio of 1 to 4 between
-# the size of the marginal axes and the main axes in both directions.
+# the size of the marginal Axes and the main Axes in both directions.
 # Also adjust the subplot parameters for a square plot.
 gs = fig.add_gridspec(2, 2,  width_ratios=(4, 1), height_ratios=(1, 4),
                       left=0.1, right=0.9, bottom=0.1, top=0.9,
@@ -80,26 +80,26 @@ def scatter_hist(x, y, ax, ax_histx, ax_histy):
 
 # %%
 #
-# Defining the axes positions using inset_axes
+# Defining the Axes positions using inset_axes
 # --------------------------------------------
 #
 # `~.Axes.inset_axes` can be used to position marginals *outside* the main
-# axes.  The advantage of doing so is that the aspect ratio of the main axes
+# Axes.  The advantage of doing so is that the aspect ratio of the main Axes
 # can be fixed, and the marginals will always be drawn relative to the position
-# of the axes.
+# of the Axes.
 
 # Create a Figure, which doesn't have to be square.
 fig = plt.figure(layout='constrained')
-# Create the main axes, leaving 25% of the figure space at the top and on the
+# Create the main Axes, leaving 25% of the figure space at the top and on the
 # right to position marginals.
 ax = fig.add_gridspec(top=0.75, right=0.75).subplots()
-# The main axes' aspect can be fixed.
+# The main Axes' aspect can be fixed.
 ax.set(aspect=1)
-# Create marginal axes, which have 25% of the size of the main axes.  Note that
-# the inset axes are positioned *outside* (on the right and the top) of the
-# main axes, by specifying axes coordinates greater than 1.  Axes coordinates
+# Create marginal Axes, which have 25% of the size of the main Axes.  Note that
+# the inset Axes are positioned *outside* (on the right and the top) of the
+# main Axes, by specifying axes coordinates greater than 1.  Axes coordinates
 # less than 0 would likewise specify positions on the left and the bottom of
-# the main axes.
+# the main Axes.
 ax_histx = ax.inset_axes([0, 1.05, 1, 0.25], sharex=ax)
 ax_histy = ax.inset_axes([1.05, 0, 0.25, 1], sharey=ax)
 # Draw the scatter plot and marginals.
diff --git a/galleries/examples/lines_bars_and_markers/vline_hline_demo.py b/galleries/examples/lines_bars_and_markers/vline_hline_demo.py
index 564d44ce7401..c2f5d025b15c 100644
--- a/galleries/examples/lines_bars_and_markers/vline_hline_demo.py
+++ b/galleries/examples/lines_bars_and_markers/vline_hline_demo.py
@@ -21,7 +21,7 @@
 vax.plot(t, s + nse, '^')
 vax.vlines(t, [0], s)
 # By using ``transform=vax.get_xaxis_transform()`` the y coordinates are scaled
-# such that 0 maps to the bottom of the axes and 1 to the top.
+# such that 0 maps to the bottom of the Axes and 1 to the top.
 vax.vlines([1, 2], 0, 1, transform=vax.get_xaxis_transform(), colors='r')
 vax.set_xlabel('time (s)')
 vax.set_title('Vertical lines demo')
diff --git a/galleries/examples/misc/coords_report.py b/galleries/examples/misc/coords_report.py
index 127ce712fc1e..84503be35c5f 100644
--- a/galleries/examples/misc/coords_report.py
+++ b/galleries/examples/misc/coords_report.py
@@ -3,7 +3,7 @@
 Coords Report
 =============
 
-Override the default reporting of coords as the mouse moves over the axes
+Override the default reporting of coords as the mouse moves over the Axes
 in an interactive backend.
 """
 
diff --git a/galleries/examples/misc/custom_projection.py b/galleries/examples/misc/custom_projection.py
index e63ba8771ee1..1bd4ce772b0a 100644
--- a/galleries/examples/misc/custom_projection.py
+++ b/galleries/examples/misc/custom_projection.py
@@ -90,7 +90,7 @@ def _set_lim_and_transforms(self):
         # the inline documentation there.
 
         # The goal of the first two transformations is to get from the
-        # data space (in this case longitude and latitude) to axes
+        # data space (in this case longitude and latitude) to Axes
         # space.  It is separated into a non-affine and affine part so
         # that the non-affine part does not have to be recomputed when
         # a simple affine change to the figure has been made (such as
@@ -102,12 +102,12 @@ def _set_lim_and_transforms(self):
 
         # 2) The above has an output range that is not in the unit
         # rectangle, so scale and translate it so it fits correctly
-        # within the axes.  The peculiar calculations of xscale and
+        # within the Axes.  The peculiar calculations of xscale and
         # yscale are specific to an Aitoff-Hammer projection, so don't
         # worry about them too much.
         self.transAffine = self._get_affine_transform()
 
-        # 3) This is the transformation from axes space to display
+        # 3) This is the transformation from Axes space to display
         # space.
         self.transAxes = BboxTransformTo(self.bbox)
 
@@ -125,7 +125,7 @@ def _set_lim_and_transforms(self):
         # gridlines and tick labels.
 
         # Longitude gridlines and ticklabels.  The input to these
-        # transforms are in display space in x and axes space in y.
+        # transforms are in display space in x and Axes space in y.
         # Therefore, the input values will be in range (-xmin, 0),
         # (xmax, 1).  The goal of these transforms is to go from that
         # space to display space.  The tick labels will be offset 4
@@ -147,11 +147,11 @@ def _set_lim_and_transforms(self):
             Affine2D().translate(0.0, -4.0)
 
         # Now set up the transforms for the latitude ticks.  The input to
-        # these transforms are in axes space in x and display space in
+        # these transforms are in Axes space in x and display space in
         # y.  Therefore, the input values will be in range (0, -ymin),
         # (1, ymax).  The goal of these transforms is to go from that
         # space to display space.  The tick labels will be offset 4
-        # pixels from the edge of the axes ellipse.
+        # pixels from the edge of the Axes ellipse.
         yaxis_stretch = Affine2D().scale(np.pi*2, 1).translate(-np.pi, 0)
         yaxis_space = Affine2D().scale(1.0, 1.1)
         self._yaxis_transform = \
@@ -235,7 +235,7 @@ def _gen_axes_patch(self):
         Override this method to define the shape that is used for the
         background of the plot.  It should be a subclass of Patch.
 
-        In this case, it is a Circle (that may be warped by the axes
+        In this case, it is a Circle (that may be warped by the Axes
         transform into an ellipse).  Any data and gridlines will be
         clipped to this shape.
         """
diff --git a/galleries/examples/misc/fig_x.py b/galleries/examples/misc/fig_x.py
index 2985c2f1cffc..e2af3e766028 100644
--- a/galleries/examples/misc/fig_x.py
+++ b/galleries/examples/misc/fig_x.py
@@ -3,7 +3,7 @@
 Adding lines to figures
 =======================
 
-Adding lines to a figure without any axes.
+Adding lines to a figure without any Axes.
 
 .. redirect-from:: /gallery/pyplots/fig_x
 """
diff --git a/galleries/examples/misc/logos2.py b/galleries/examples/misc/logos2.py
index 3a070535f83f..aca348474e7b 100644
--- a/galleries/examples/misc/logos2.py
+++ b/galleries/examples/misc/logos2.py
@@ -36,7 +36,7 @@ def get_font_properties():
 
 def create_icon_axes(fig, ax_position, lw_bars, lw_grid, lw_border, rgrid):
     """
-    Create a polar axes containing the matplotlib radar plot.
+    Create a polar Axes containing the matplotlib radar plot.
 
     Parameters
     ----------
diff --git a/galleries/examples/misc/rasterization_demo.py b/galleries/examples/misc/rasterization_demo.py
index 7755e66745cb..ce0cf02dfac2 100644
--- a/galleries/examples/misc/rasterization_demo.py
+++ b/galleries/examples/misc/rasterization_demo.py
@@ -9,7 +9,7 @@
 
 Whether rasterization should be used can be specified per artist.  This can be
 useful to reduce the file size of large artists, while maintaining the
-advantages of vector graphics for other artists such as the axes
+advantages of vector graphics for other artists such as the Axes
 and text.  For instance a complicated `~.Axes.pcolormesh` or
 `~.Axes.contourf` can be made significantly simpler by rasterizing.
 Setting rasterization only affects vector backends such as PDF, SVG, or PS.
diff --git a/galleries/examples/misc/svg_filter_pie.py b/galleries/examples/misc/svg_filter_pie.py
index 052cde48a245..b823cc9670c9 100644
--- a/galleries/examples/misc/svg_filter_pie.py
+++ b/galleries/examples/misc/svg_filter_pie.py
@@ -17,7 +17,7 @@
 
 from matplotlib.patches import Shadow
 
-# make a square figure and axes
+# make a square figure and Axes
 fig = plt.figure(figsize=(6, 6))
 ax = fig.add_axes([0.1, 0.1, 0.8, 0.8])
 
diff --git a/galleries/examples/misc/table_demo.py b/galleries/examples/misc/table_demo.py
index 71fb98343d3f..c89fb5cf83df 100644
--- a/galleries/examples/misc/table_demo.py
+++ b/galleries/examples/misc/table_demo.py
@@ -40,7 +40,7 @@
 colors = colors[::-1]
 cell_text.reverse()
 
-# Add a table at the bottom of the axes
+# Add a table at the bottom of the Axes
 the_table = plt.table(cellText=cell_text,
                       rowLabels=rows,
                       rowColours=colors,
diff --git a/galleries/examples/misc/transoffset.py b/galleries/examples/misc/transoffset.py
index 5254974b46e6..b3163e8df703 100644
--- a/galleries/examples/misc/transoffset.py
+++ b/galleries/examples/misc/transoffset.py
@@ -31,7 +31,7 @@
 
 # If we want the same offset for each text instance,
 # we only need to make one transform.  To get the
-# transform argument to offset_copy, we need to make the axes
+# transform argument to offset_copy, we need to make the Axes
 # first; the subplot function above is one way to do this.
 trans_offset = mtransforms.offset_copy(ax.transData, fig=fig,
                                        x=0.05, y=0.10, units='inches')
diff --git a/galleries/examples/misc/zorder_demo.py b/galleries/examples/misc/zorder_demo.py
index 36c5e7965ba2..e077dc56d2d0 100644
--- a/galleries/examples/misc/zorder_demo.py
+++ b/galleries/examples/misc/zorder_demo.py
@@ -15,7 +15,7 @@
 `.Patch`, `.PatchCollection`                                        1
 `.Line2D`, `.LineCollection` (including minor ticks, grid lines)    2
 Major ticks                                                         2.01
-`.Text` (including axes labels and titles)                          3
+`.Text` (including Axes labels and titles)                          3
 `.Legend`                                                           5
 ================================================================    =======
 
diff --git a/galleries/examples/mplot3d/3d_bars.py b/galleries/examples/mplot3d/3d_bars.py
index 609adb8df380..40a09ae33f68 100644
--- a/galleries/examples/mplot3d/3d_bars.py
+++ b/galleries/examples/mplot3d/3d_bars.py
@@ -9,7 +9,7 @@
 import matplotlib.pyplot as plt
 import numpy as np
 
-# set up the figure and axes
+# set up the figure and Axes
 fig = plt.figure(figsize=(8, 3))
 ax1 = fig.add_subplot(121, projection='3d')
 ax2 = fig.add_subplot(122, projection='3d')
diff --git a/galleries/examples/mplot3d/mixed_subplots.py b/galleries/examples/mplot3d/mixed_subplots.py
index 963044020f47..dc196f05f90d 100644
--- a/galleries/examples/mplot3d/mixed_subplots.py
+++ b/galleries/examples/mplot3d/mixed_subplots.py
@@ -1,6 +1,6 @@
 """
 =============================
-2D and 3D axes in same figure
+2D and 3D Axes in same figure
 =============================
 
 This example shows a how to plot a 2D and a 3D plot on the same figure.
diff --git a/galleries/examples/mplot3d/pathpatch3d.py b/galleries/examples/mplot3d/pathpatch3d.py
index f195e19e17a9..335b68003d31 100644
--- a/galleries/examples/mplot3d/pathpatch3d.py
+++ b/galleries/examples/mplot3d/pathpatch3d.py
@@ -17,7 +17,7 @@
 
 def text3d(ax, xyz, s, zdir="z", size=None, angle=0, usetex=False, **kwargs):
     """
-    Plots the string *s* on the axes *ax*, with position *xyz*, size *size*,
+    Plots the string *s* on the Axes *ax*, with position *xyz*, size *size*,
     and rotation angle *angle*. *zdir* gives the axis which is to be treated as
     the third dimension. *usetex* is a boolean indicating whether the string
     should be run through a LaTeX subprocess or not.  Any additional keyword
diff --git a/galleries/examples/mplot3d/subplot3d.py b/galleries/examples/mplot3d/subplot3d.py
index 1dfeeb216f58..47e374dc74b9 100644
--- a/galleries/examples/mplot3d/subplot3d.py
+++ b/galleries/examples/mplot3d/subplot3d.py
@@ -18,7 +18,7 @@
 # =============
 # First subplot
 # =============
-# set up the axes for the first plot
+# set up the Axes for the first plot
 ax = fig.add_subplot(1, 2, 1, projection='3d')
 
 # plot a 3D surface like in the example mplot3d/surface3d_demo
@@ -35,7 +35,7 @@
 # ==============
 # Second subplot
 # ==============
-# set up the axes for the second plot
+# set up the Axes for the second plot
 ax = fig.add_subplot(1, 2, 2, projection='3d')
 
 # plot a 3D wireframe like in the example mplot3d/wire3d_demo
diff --git a/galleries/examples/pie_and_polar_charts/bar_of_pie.py b/galleries/examples/pie_and_polar_charts/bar_of_pie.py
index f386f11bc9aa..ef68b3d79971 100644
--- a/galleries/examples/pie_and_polar_charts/bar_of_pie.py
+++ b/galleries/examples/pie_and_polar_charts/bar_of_pie.py
@@ -6,7 +6,7 @@
 Make a "bar of pie" chart where the first slice of the pie is
 "exploded" into a bar chart with a further breakdown of said slice's
 characteristics. The example demonstrates using a figure with multiple
-sets of axes and using the axes patches list to add two ConnectionPatches
+sets of Axes and using the Axes patches list to add two ConnectionPatches
 to link the subplot charts.
 """
 
diff --git a/galleries/examples/pie_and_polar_charts/nested_pie.py b/galleries/examples/pie_and_polar_charts/nested_pie.py
index 8331618fe45c..c83b4f6f84ee 100644
--- a/galleries/examples/pie_and_polar_charts/nested_pie.py
+++ b/galleries/examples/pie_and_polar_charts/nested_pie.py
@@ -46,7 +46,7 @@
 
 # %%
 # However, you can accomplish the same output by using a bar plot on
-# axes with a polar coordinate system. This may give more flexibility on
+# Axes with a polar coordinate system. This may give more flexibility on
 # the exact design of the plot.
 #
 # In this case, we need to map x-values of the bar chart onto radians of
diff --git a/galleries/examples/pie_and_polar_charts/polar_legend.py b/galleries/examples/pie_and_polar_charts/polar_legend.py
index a4508b0e9f3a..7972b0aaffd4 100644
--- a/galleries/examples/pie_and_polar_charts/polar_legend.py
+++ b/galleries/examples/pie_and_polar_charts/polar_legend.py
@@ -17,9 +17,9 @@
 ax.plot(theta, r, color="tab:orange", lw=3, label="a line")
 ax.plot(0.5 * theta, r, color="tab:blue", ls="--", lw=3, label="another line")
 ax.tick_params(grid_color="palegoldenrod")
-# For polar axes, it may be useful to move the legend slightly away from the
-# axes center, to avoid overlap between the legend and the axes.  The following
-# snippet places the legend's lower left corner just outside the polar axes
+# For polar Axes, it may be useful to move the legend slightly away from the
+# Axes center, to avoid overlap between the legend and the Axes.  The following
+# snippet places the legend's lower left corner just outside the polar Axes
 # at an angle of 67.5 degrees in polar coordinates.
 angle = np.deg2rad(67.5)
 ax.legend(loc="lower left",
diff --git a/galleries/examples/pyplots/pyplot_text.py b/galleries/examples/pyplots/pyplot_text.py
index 9fb9f4f1608c..72f977c2f985 100644
--- a/galleries/examples/pyplots/pyplot_text.py
+++ b/galleries/examples/pyplots/pyplot_text.py
@@ -5,7 +5,7 @@
 
 Set the special text objects `~.pyplot.title`, `~.pyplot.xlabel`, and
 `~.pyplot.ylabel` through the dedicated pyplot functions.  Additional text
-objects can be placed in the axes using `~.pyplot.text`.
+objects can be placed in the Axes using `~.pyplot.text`.
 
 You can use TeX-like mathematical typesetting in all texts; see also
 :ref:`mathtext`.
diff --git a/galleries/examples/shapes_and_collections/arrow_guide.py b/galleries/examples/shapes_and_collections/arrow_guide.py
index 7ca969b7b190..d9fad893a873 100644
--- a/galleries/examples/shapes_and_collections/arrow_guide.py
+++ b/galleries/examples/shapes_and_collections/arrow_guide.py
@@ -69,7 +69,7 @@
 # change shape or position if you pan or scale the plot.
 #
 # In this case we use `.patches.FancyArrowPatch`, and pass the keyword argument
-# ``transform=ax.transAxes`` where ``ax`` is the axes we are adding the patch
+# ``transform=ax.transAxes`` where ``ax`` is the Axes we are adding the patch
 # to.
 #
 # Note that when the axis limits are changed, the arrow shape and location
diff --git a/galleries/examples/shapes_and_collections/fancybox_demo.py b/galleries/examples/shapes_and_collections/fancybox_demo.py
index 49692c1be5e6..91cc1d1749ea 100644
--- a/galleries/examples/shapes_and_collections/fancybox_demo.py
+++ b/galleries/examples/shapes_and_collections/fancybox_demo.py
@@ -90,7 +90,7 @@ def draw_control_points_for_patches(ax):
        title='boxstyle="round,pad=0.1"\n mutation_scale=2')
 
 ax = axs[1, 1]
-# When the aspect ratio of the axes is not 1, the fancy box may not be what you
+# When the aspect ratio of the Axes is not 1, the fancy box may not be what you
 # expected (green).
 fancy = add_fancy_patch_around(ax, bb, boxstyle="round,pad=0.2")
 fancy.set(facecolor="none", edgecolor="green")
diff --git a/galleries/examples/shapes_and_collections/patch_collection.py b/galleries/examples/shapes_and_collections/patch_collection.py
index 8ac9c3a7c304..ca0dd8e1045d 100644
--- a/galleries/examples/shapes_and_collections/patch_collection.py
+++ b/galleries/examples/shapes_and_collections/patch_collection.py
@@ -6,7 +6,7 @@
 This example demonstrates how to use `.collections.PatchCollection`.
 
 See also :doc:`/gallery/shapes_and_collections/artist_reference`, which instead
-adds each artist separately to its own axes.
+adds each artist separately to its own Axes.
 """
 
 import matplotlib.pyplot as plt
diff --git a/galleries/examples/specialty_plots/leftventricle_bullseye.py b/galleries/examples/specialty_plots/leftventricle_bullseye.py
index 70327f49c054..e3c3d52fa6a5 100644
--- a/galleries/examples/specialty_plots/leftventricle_bullseye.py
+++ b/galleries/examples/specialty_plots/leftventricle_bullseye.py
@@ -23,7 +23,7 @@ def bullseye_plot(ax, data, seg_bold=None, cmap="viridis", norm=None):
 
     Parameters
     ----------
-    ax : axes
+    ax : Axes
     data : list[float]
         The intensity values for each of the 17 segments.
     seg_bold : list[int], optional
@@ -95,7 +95,7 @@ def bullseye_plot(ax, data, seg_bold=None, cmap="viridis", norm=None):
 data = np.arange(17) + 1
 
 
-# Make a figure and axes with dimensions as desired.
+# Make a figure and Axes with dimensions as desired.
 fig = plt.figure(figsize=(10, 5), layout="constrained")
 fig.get_layout_engine().set(wspace=.1, w_pad=.2)
 axs = fig.subplots(1, 3, subplot_kw=dict(projection='polar'))
diff --git a/galleries/examples/specialty_plots/radar_chart.py b/galleries/examples/specialty_plots/radar_chart.py
index 3d17659d0bdf..a2f6df717544 100644
--- a/galleries/examples/specialty_plots/radar_chart.py
+++ b/galleries/examples/specialty_plots/radar_chart.py
@@ -9,7 +9,7 @@
 frames don't have proper gridlines (the lines are circles instead of polygons).
 It's possible to get a polygon grid by setting GRIDLINE_INTERPOLATION_STEPS in
 `matplotlib.axis` to the desired number of vertices, but the orientation of the
-polygon is not aligned with the radial axes.
+polygon is not aligned with the radial axis.
 
 .. [1] https://en.wikipedia.org/wiki/Radar_chart
 """
@@ -27,7 +27,7 @@
 
 def radar_factory(num_vars, frame='circle'):
     """
-    Create a radar chart with `num_vars` axes.
+    Create a radar chart with `num_vars` Axes.
 
     This function creates a RadarAxes projection and registers it.
 
@@ -36,7 +36,7 @@ def radar_factory(num_vars, frame='circle'):
     num_vars : int
         Number of variables for radar chart.
     frame : {'circle', 'polygon'}
-        Shape of frame surrounding axes.
+        Shape of frame surrounding Axes.
 
     """
     # calculate evenly-spaced axis angles
@@ -177,7 +177,7 @@ def example_data():
     fig.subplots_adjust(wspace=0.25, hspace=0.20, top=0.85, bottom=0.05)
 
     colors = ['b', 'r', 'g', 'm', 'y']
-    # Plot the four cases from the example data on separate axes
+    # Plot the four cases from the example data on separate Axes
     for ax, (title, case_data) in zip(axs.flat, data):
         ax.set_rgrids([0.2, 0.4, 0.6, 0.8])
         ax.set_title(title, weight='bold', size='medium', position=(0.5, 1.1),
diff --git a/galleries/examples/spines/centered_spines_with_arrows.py b/galleries/examples/spines/centered_spines_with_arrows.py
index 972e7ebd5e4e..f71d071a5f82 100644
--- a/galleries/examples/spines/centered_spines_with_arrows.py
+++ b/galleries/examples/spines/centered_spines_with_arrows.py
@@ -21,7 +21,7 @@
 # case, one of the coordinates (0) is a data coordinate (i.e., y = 0 or x = 0,
 # respectively) and the other one (1) is an axes coordinate (i.e., at the very
 # right/top of the axes).  Also, disable clipping (clip_on=False) as the marker
-# actually spills out of the axes.
+# actually spills out of the Axes.
 ax.plot(1, 0, ">k", transform=ax.get_yaxis_transform(), clip_on=False)
 ax.plot(0, 1, "^k", transform=ax.get_xaxis_transform(), clip_on=False)
 
diff --git a/galleries/examples/spines/multiple_yaxis_with_spines.py b/galleries/examples/spines/multiple_yaxis_with_spines.py
index c1dc95a62612..a0281bdeda0f 100644
--- a/galleries/examples/spines/multiple_yaxis_with_spines.py
+++ b/galleries/examples/spines/multiple_yaxis_with_spines.py
@@ -4,11 +4,11 @@
 ===========================
 
 Create multiple y axes with a shared x-axis. This is done by creating
-a `~.axes.Axes.twinx` axes, turning all spines but the right one invisible
+a `~.axes.Axes.twinx` Axes, turning all spines but the right one invisible
 and offset its position using `~.spines.Spine.set_position`.
 
 Note that this approach uses `matplotlib.axes.Axes` and their
-`~matplotlib.spines.Spine`\s.  Alternative approaches using non-standard axes
+`~matplotlib.spines.Spine`\s.  Alternative approaches using non-standard Axes
 are shown in the :doc:`/gallery/axisartist/demo_parasite_axes` and
 :doc:`/gallery/axisartist/demo_parasite_axes2` examples.
 """
diff --git a/galleries/examples/spines/spines.py b/galleries/examples/spines/spines.py
index fd42292112fd..2e28fb546d86 100644
--- a/galleries/examples/spines/spines.py
+++ b/galleries/examples/spines/spines.py
@@ -21,7 +21,7 @@
 x = np.linspace(0, 2 * np.pi, 100)
 y = 2 * np.sin(x)
 
-# Constrained layout makes sure the labels don't overlap the axes.
+# Constrained layout makes sure the labels don't overlap the Axes.
 fig, (ax0, ax1, ax2) = plt.subplots(nrows=3, layout='constrained')
 
 ax0.plot(x, y)
diff --git a/galleries/examples/statistics/boxplot.py b/galleries/examples/statistics/boxplot.py
index 419352380c76..79b05386c5d9 100644
--- a/galleries/examples/statistics/boxplot.py
+++ b/galleries/examples/statistics/boxplot.py
@@ -8,7 +8,7 @@
 individual components (note that the mean is the only value not shown by
 default). The second figure demonstrates how the styles of the artists can be
 customized. It also demonstrates how to set the limit of the whiskers to
-specific percentiles (lower right axes)
+specific percentiles (lower right Axes)
 
 A good general reference on boxplots and their history can be found here:
 https://vita.had.co.nz/papers/boxplots.pdf
diff --git a/galleries/examples/statistics/confidence_ellipse.py b/galleries/examples/statistics/confidence_ellipse.py
index 2a0427127773..27b06146a44e 100644
--- a/galleries/examples/statistics/confidence_ellipse.py
+++ b/galleries/examples/statistics/confidence_ellipse.py
@@ -30,7 +30,7 @@
 #
 # This function plots the confidence ellipse of the covariance of the given
 # array-like variables x and y. The ellipse is plotted into the given
-# axes-object ax.
+# Axes object *ax*.
 #
 # The radiuses of the ellipse can be controlled by n_std which is the number
 # of standard deviations. The default value is 3 which makes the ellipse
@@ -49,7 +49,7 @@ def confidence_ellipse(x, y, ax, n_std=3.0, facecolor='none', **kwargs):
         Input data.
 
     ax : matplotlib.axes.Axes
-        The axes object to draw the ellipse into.
+        The Axes object to draw the ellipse into.
 
     n_std : float
         The number of standard deviations to determine the ellipse's radiuses.
diff --git a/galleries/examples/statistics/errorbars_and_boxes.py b/galleries/examples/statistics/errorbars_and_boxes.py
index c182d53a701a..54c8786096c7 100644
--- a/galleries/examples/statistics/errorbars_and_boxes.py
+++ b/galleries/examples/statistics/errorbars_and_boxes.py
@@ -51,7 +51,7 @@ def make_error_boxes(ax, xdata, ydata, xerror, yerror, facecolor='r',
     pc = PatchCollection(errorboxes, facecolor=facecolor, alpha=alpha,
                          edgecolor=edgecolor)
 
-    # Add collection to axes
+    # Add collection to Axes
     ax.add_collection(pc)
 
     # Plot errorbars
@@ -61,7 +61,7 @@ def make_error_boxes(ax, xdata, ydata, xerror, yerror, facecolor='r',
     return artists
 
 
-# Create figure and axes
+# Create figure and Axes
 fig, ax = plt.subplots(1)
 
 # Call function to create error boxes
diff --git a/galleries/examples/subplots_axes_and_figures/axes_box_aspect.py b/galleries/examples/subplots_axes_and_figures/axes_box_aspect.py
index 26974dd49121..74b64f72c466 100644
--- a/galleries/examples/subplots_axes_and_figures/axes_box_aspect.py
+++ b/galleries/examples/subplots_axes_and_figures/axes_box_aspect.py
@@ -4,8 +4,8 @@
 ===============
 
 This demo shows how to set the aspect of an Axes box directly via
-`~.Axes.set_box_aspect`. The box aspect is the ratio between axes height
-and axes width in physical units, independent of the data limits.
+`~.Axes.set_box_aspect`. The box aspect is the ratio between Axes height
+and Axes width in physical units, independent of the data limits.
 This is useful to e.g. produce a square plot, independent of the data it
 contains, or to have a usual plot with the same axes dimensions next to
 an image plot with fixed (data-)aspect.
@@ -14,10 +14,10 @@
 """
 
 # %%
-# A square axes, independent of data
+# A square Axes, independent of data
 # ----------------------------------
 #
-# Produce a square axes, no matter what the data limits are.
+# Produce a square Axes, no matter what the data limits are.
 
 import matplotlib.pyplot as plt
 import numpy as np
@@ -30,7 +30,7 @@
 plt.show()
 
 # %%
-# Shared square axes
+# Shared square Axes
 # ------------------
 #
 # Produce shared subplots that are squared in size.
@@ -46,10 +46,10 @@
 plt.show()
 
 # %%
-# Square twin axes
+# Square twin Axes
 # ----------------
 #
-# Produce a square axes, with a twin axes. The twinned axes takes over the
+# Produce a square Axes, with a twin Axes. The twinned Axes takes over the
 # box aspect of the parent.
 #
 
@@ -70,9 +70,9 @@
 # -------------------------
 #
 # When creating an image plot with fixed data aspect and the default
-# ``adjustable="box"`` next to a normal plot, the axes would be unequal in
+# ``adjustable="box"`` next to a normal plot, the Axes would be unequal in
 # height. `~.Axes.set_box_aspect` provides an easy solution to that by allowing
-# to have the normal plot's axes use the images dimensions as box aspect.
+# to have the normal plot's Axes use the images dimensions as box aspect.
 #
 # This example also shows that *constrained layout* interplays nicely with
 # a fixed box aspect.
@@ -94,8 +94,8 @@
 #
 # It may be desirable to show marginal distributions next to a plot of joint
 # data. The following creates a square plot with the box aspect of the
-# marginal axes being equal to the width- and height-ratios of the gridspec.
-# This ensures that all axes align perfectly, independent on the size of the
+# marginal Axes being equal to the width- and height-ratios of the gridspec.
+# This ensures that all Axes align perfectly, independent on the size of the
 # figure.
 
 fig5, axs = plt.subplots(2, 2, sharex="col", sharey="row",
diff --git a/galleries/examples/subplots_axes_and_figures/axes_demo.py b/galleries/examples/subplots_axes_and_figures/axes_demo.py
index 46a353d7475b..f5620a9a980d 100644
--- a/galleries/examples/subplots_axes_and_figures/axes_demo.py
+++ b/galleries/examples/subplots_axes_and_figures/axes_demo.py
@@ -3,7 +3,7 @@
 Axes Demo
 =========
 
-Example use of ``fig.add_axes`` to create inset axes within the main plot axes.
+Example use of ``fig.add_axes`` to create inset Axes within the main plot Axes.
 
 Please see also the :ref:`axes_grid_examples` section, and the following three
 examples:
@@ -32,12 +32,12 @@
 main_ax.set_ylabel('current (nA)')
 main_ax.set_title('Gaussian colored noise')
 
-# this is an inset axes over the main axes
+# this is an inset Axes over the main Axes
 right_inset_ax = fig.add_axes([.65, .6, .2, .2], facecolor='k')
 right_inset_ax.hist(s, 400, density=True)
 right_inset_ax.set(title='Probability', xticks=[], yticks=[])
 
-# this is another inset axes over the main axes
+# this is another inset Axes over the main Axes
 left_inset_ax = fig.add_axes([.2, .6, .2, .2], facecolor='k')
 left_inset_ax.plot(t[:len(r)], r)
 left_inset_ax.set(title='Impulse response', xlim=(0, .2), xticks=[], yticks=[])
diff --git a/galleries/examples/subplots_axes_and_figures/axes_margins.py b/galleries/examples/subplots_axes_and_figures/axes_margins.py
index 934e5ac6366b..dd113c8c34e0 100644
--- a/galleries/examples/subplots_axes_and_figures/axes_margins.py
+++ b/galleries/examples/subplots_axes_and_figures/axes_margins.py
@@ -58,7 +58,7 @@ def f(t):
 ]
 fig, (ax1, ax2) = plt.subplots(ncols=2)
 
-# Here we set the stickiness of the axes object...
+# Here we set the stickiness of the Axes object...
 # ax1 we'll leave as the default, which uses sticky edges
 # and we'll turn off stickiness for ax2
 ax2.use_sticky_edges = False
diff --git a/galleries/examples/subplots_axes_and_figures/axes_zoom_effect.py b/galleries/examples/subplots_axes_and_figures/axes_zoom_effect.py
index a8076db48528..49a44b9e4f43 100644
--- a/galleries/examples/subplots_axes_and_figures/axes_zoom_effect.py
+++ b/galleries/examples/subplots_axes_and_figures/axes_zoom_effect.py
@@ -42,17 +42,17 @@ def connect_bbox(bbox1, bbox2,
 
 def zoom_effect01(ax1, ax2, xmin, xmax, **kwargs):
     """
-    Connect *ax1* and *ax2*. The *xmin*-to-*xmax* range in both axes will
+    Connect *ax1* and *ax2*. The *xmin*-to-*xmax* range in both Axes will
     be marked.
 
     Parameters
     ----------
     ax1
-        The main axes.
+        The main Axes.
     ax2
-        The zoomed axes.
+        The zoomed Axes.
     xmin, xmax
-        The limits of the colored area in both plot axes.
+        The limits of the colored area in both plot Axes.
     **kwargs
         Arguments passed to the patch constructor.
     """
@@ -80,8 +80,8 @@ def zoom_effect01(ax1, ax2, xmin, xmax, **kwargs):
 
 def zoom_effect02(ax1, ax2, **kwargs):
     """
-    ax1 : the main axes
-    ax1 : the zoomed axes
+    ax1 : the main Axes
+    ax1 : the zoomed Axes
 
     Similar to zoom_effect01.  The xmin & xmax will be taken from the
     ax1.viewLim.
diff --git a/galleries/examples/subplots_axes_and_figures/axhspan_demo.py b/galleries/examples/subplots_axes_and_figures/axhspan_demo.py
index bc1d7bff154b..e297f4adf462 100644
--- a/galleries/examples/subplots_axes_and_figures/axhspan_demo.py
+++ b/galleries/examples/subplots_axes_and_figures/axhspan_demo.py
@@ -3,8 +3,8 @@
 axhspan Demo
 ============
 
-Create lines or rectangles that span the axes in either the horizontal or
-vertical direction, and lines than span the axes with an arbitrary orientation.
+Create lines or rectangles that span the Axes in either the horizontal or
+vertical direction, and lines than span the Axes with an arbitrary orientation.
 """
 
 import matplotlib.pyplot as plt
@@ -24,13 +24,13 @@
 ax.axvline(x=1)
 # Thick blue vertical line at x=0 that spans the upper quadrant of the yrange.
 ax.axvline(x=0, ymin=0.75, linewidth=8, color='#1f77b4')
-# Default hline at y=.5 that spans the middle half of the axes.
+# Default hline at y=.5 that spans the middle half of the Axes.
 ax.axhline(y=.5, xmin=0.25, xmax=0.75)
 # Infinite black line going through (0, 0) to (1, 1).
 ax.axline((0, 0), (1, 1), color='k')
-# 50%-gray rectangle spanning the axes' width from y=0.25 to y=0.75.
+# 50%-gray rectangle spanning the Axes' width from y=0.25 to y=0.75.
 ax.axhspan(0.25, 0.75, facecolor='0.5')
-# Green rectangle spanning the axes' height from x=1.25 to x=1.55.
+# Green rectangle spanning the Axes' height from x=1.25 to x=1.55.
 ax.axvspan(1.25, 1.55, facecolor='#2ca02c')
 
 plt.show()
diff --git a/galleries/examples/subplots_axes_and_figures/broken_axis.py b/galleries/examples/subplots_axes_and_figures/broken_axis.py
index 343fe5d4865b..06263b9c120a 100644
--- a/galleries/examples/subplots_axes_and_figures/broken_axis.py
+++ b/galleries/examples/subplots_axes_and_figures/broken_axis.py
@@ -20,9 +20,9 @@
 # into two portions - use the top (ax1) for the outliers, and the bottom
 # (ax2) for the details of the majority of our data
 fig, (ax1, ax2) = plt.subplots(2, 1, sharex=True)
-fig.subplots_adjust(hspace=0.05)  # adjust space between axes
+fig.subplots_adjust(hspace=0.05)  # adjust space between Axes
 
-# plot the same data on both axes
+# plot the same data on both Axes
 ax1.plot(pts)
 ax2.plot(pts)
 
@@ -39,9 +39,9 @@
 
 # Now, let's turn towards the cut-out slanted lines.
 # We create line objects in axes coordinates, in which (0,0), (0,1),
-# (1,0), and (1,1) are the four corners of the axes.
+# (1,0), and (1,1) are the four corners of the Axes.
 # The slanted lines themselves are markers at those locations, such that the
-# lines keep their angle and position, independent of the axes size or scale
+# lines keep their angle and position, independent of the Axes size or scale
 # Finally, we need to disable clipping.
 
 d = .5  # proportion of vertical to horizontal extent of the slanted line
diff --git a/galleries/examples/subplots_axes_and_figures/demo_constrained_layout.py b/galleries/examples/subplots_axes_and_figures/demo_constrained_layout.py
index f16f419ece7a..9a67541e554e 100644
--- a/galleries/examples/subplots_axes_and_figures/demo_constrained_layout.py
+++ b/galleries/examples/subplots_axes_and_figures/demo_constrained_layout.py
@@ -1,11 +1,11 @@
 """
 =====================================
-Resizing axes with constrained layout
+Resizing Axes with constrained layout
 =====================================
 
 *Constrained layout* attempts to resize subplots in
-a figure so that there are no overlaps between axes objects and labels
-on the axes.
+a figure so that there are no overlaps between Axes objects and labels
+on the Axes.
 
 See :ref:`constrainedlayout_guide` for more details and
 :ref:`tight_layout_guide` for an alternative.
@@ -23,7 +23,7 @@ def example_plot(ax):
 
 
 # %%
-# If we don't use *constrained layout*, then labels overlap the axes
+# If we don't use *constrained layout*, then labels overlap the Axes
 
 fig, axs = plt.subplots(nrows=2, ncols=2, layout=None)
 
diff --git a/galleries/examples/subplots_axes_and_figures/demo_tight_layout.py b/galleries/examples/subplots_axes_and_figures/demo_tight_layout.py
index 0cc5f5301db4..7ac3a7376d67 100644
--- a/galleries/examples/subplots_axes_and_figures/demo_tight_layout.py
+++ b/galleries/examples/subplots_axes_and_figures/demo_tight_layout.py
@@ -1,10 +1,10 @@
 """
 ===============================
-Resizing axes with tight layout
+Resizing Axes with tight layout
 ===============================
 
 `~.Figure.tight_layout` attempts to resize subplots in a figure so that there
-are no overlaps between axes objects and labels on the axes.
+are no overlaps between Axes objects and labels on the Axes.
 
 See :ref:`tight_layout_guide` for more details and
 :ref:`constrainedlayout_guide` for an alternative.
diff --git a/galleries/examples/subplots_axes_and_figures/fahrenheit_celsius_scales.py b/galleries/examples/subplots_axes_and_figures/fahrenheit_celsius_scales.py
index 07b447c97521..216641657b06 100644
--- a/galleries/examples/subplots_axes_and_figures/fahrenheit_celsius_scales.py
+++ b/galleries/examples/subplots_axes_and_figures/fahrenheit_celsius_scales.py
@@ -1,6 +1,6 @@
 """
 =================================
-Different scales on the same axes
+Different scales on the same Axes
 =================================
 
 Demo of how to display two scales on the left and right y-axis.
diff --git a/galleries/examples/subplots_axes_and_figures/figure_title.py b/galleries/examples/subplots_axes_and_figures/figure_title.py
index 118157f0579c..85e5044c4eba 100644
--- a/galleries/examples/subplots_axes_and_figures/figure_title.py
+++ b/galleries/examples/subplots_axes_and_figures/figure_title.py
@@ -3,7 +3,7 @@
 Figure labels: suptitle, supxlabel, supylabel
 =============================================
 
-Each axes can have a title (or actually three - one each with *loc* "left",
+Each Axes can have a title (or actually three - one each with *loc* "left",
 "center", and "right"), but is sometimes desirable to give a whole figure
 (or `.SubFigure`) an overall title, using `.Figure.suptitle`.
 
diff --git a/galleries/examples/subplots_axes_and_figures/ganged_plots.py b/galleries/examples/subplots_axes_and_figures/ganged_plots.py
index b32d2aed83d6..e25bb16a15e5 100644
--- a/galleries/examples/subplots_axes_and_figures/ganged_plots.py
+++ b/galleries/examples/subplots_axes_and_figures/ganged_plots.py
@@ -21,7 +21,7 @@
 s3 = s1 * s2
 
 fig, axs = plt.subplots(3, 1, sharex=True)
-# Remove vertical space between axes
+# Remove vertical space between Axes
 fig.subplots_adjust(hspace=0)
 
 # Plot each graph, and manually set the y tick values
diff --git a/galleries/examples/subplots_axes_and_figures/gridspec_and_subplots.py b/galleries/examples/subplots_axes_and_figures/gridspec_and_subplots.py
index bff3ea579e9e..0535a7afdde4 100644
--- a/galleries/examples/subplots_axes_and_figures/gridspec_and_subplots.py
+++ b/galleries/examples/subplots_axes_and_figures/gridspec_and_subplots.py
@@ -3,12 +3,12 @@
 Combining two subplots using subplots and GridSpec
 ==================================================
 
-Sometimes we want to combine two subplots in an axes layout created with
-`~.Figure.subplots`.  We can get the `~.gridspec.GridSpec` from the axes
-and then remove the covered axes and fill the gap with a new bigger axes.
-Here we create a layout with the bottom two axes in the last column combined.
+Sometimes we want to combine two subplots in an Axes layout created with
+`~.Figure.subplots`.  We can get the `~.gridspec.GridSpec` from the Axes
+and then remove the covered Axes and fill the gap with a new bigger Axes.
+Here we create a layout with the bottom two Axes in the last column combined.
 
-To start with this layout (rather than removing the overlapping axes) use
+To start with this layout (rather than removing the overlapping Axes) use
 `~.pyplot.subplot_mosaic`.
 
 See also :ref:`arranging_axes`.
@@ -18,7 +18,7 @@
 
 fig, axs = plt.subplots(ncols=3, nrows=3)
 gs = axs[1, 2].get_gridspec()
-# remove the underlying axes
+# remove the underlying Axes
 for ax in axs[1:, -1]:
     ax.remove()
 axbig = fig.add_subplot(gs[1:, -1])
diff --git a/galleries/examples/subplots_axes_and_figures/multiple_figs_demo.py b/galleries/examples/subplots_axes_and_figures/multiple_figs_demo.py
index 1026dd110f4c..883cf075dfd2 100644
--- a/galleries/examples/subplots_axes_and_figures/multiple_figs_demo.py
+++ b/galleries/examples/subplots_axes_and_figures/multiple_figs_demo.py
@@ -3,7 +3,7 @@
 Managing multiple figures in pyplot
 ===================================
 
-`matplotlib.pyplot` uses the concept of a *current figure* and *current axes*.
+`matplotlib.pyplot` uses the concept of a *current figure* and *current Axes*.
 Figures are identified via a figure number that is passed to `~.pyplot.figure`.
 The figure with the given number is set as *current figure*. Additionally, if
 no figure with the number exists, a new one is created.
diff --git a/galleries/examples/subplots_axes_and_figures/share_axis_lims_views.py b/galleries/examples/subplots_axes_and_figures/share_axis_lims_views.py
index 751f7effc6a1..234a15660f2d 100644
--- a/galleries/examples/subplots_axes_and_figures/share_axis_lims_views.py
+++ b/galleries/examples/subplots_axes_and_figures/share_axis_lims_views.py
@@ -6,7 +6,7 @@
 with time as a common axis.  When you pan and zoom around on one, you want the
 other to move around with you.  To facilitate this, matplotlib Axes support a
 ``sharex`` and ``sharey`` attribute.  When you create a `~.pyplot.subplot` or
-`~.pyplot.axes`, you can pass in a keyword indicating what axes you want to
+`~.pyplot.axes`, you can pass in a keyword indicating what Axes you want to
 share with.
 """
 
diff --git a/galleries/examples/subplots_axes_and_figures/shared_axis_demo.py b/galleries/examples/subplots_axes_and_figures/shared_axis_demo.py
index cfe2d68701f0..6b3b3839a437 100644
--- a/galleries/examples/subplots_axes_and_figures/shared_axis_demo.py
+++ b/galleries/examples/subplots_axes_and_figures/shared_axis_demo.py
@@ -6,7 +6,7 @@
 You can share the x- or y-axis limits for one axis with another by
 passing an `~.axes.Axes` instance as a *sharex* or *sharey* keyword argument.
 
-Changing the axis limits on one axes will be reflected automatically
+Changing the axis limits on one Axes will be reflected automatically
 in the other, and vice-versa, so when you navigate with the toolbar
 the Axes will follow each other on their shared axis.  Ditto for
 changes in the axis scaling (e.g., log vs. linear).  However, it is
diff --git a/galleries/examples/subplots_axes_and_figures/subfigures.py b/galleries/examples/subplots_axes_and_figures/subfigures.py
index 9141ab61abef..6272de975c4d 100644
--- a/galleries/examples/subplots_axes_and_figures/subfigures.py
+++ b/galleries/examples/subplots_axes_and_figures/subfigures.py
@@ -69,7 +69,7 @@ def example_plot(ax, fontsize=12, hide_labels=False):
 for a in axs[:, 0]:
     a.remove()
 
-# plot data in remaining axes:
+# plot data in remaining Axes:
 for a in axs[:, 1:].flat:
     a.plot(np.arange(10))
 
diff --git a/galleries/examples/subplots_axes_and_figures/subplots_demo.py b/galleries/examples/subplots_axes_and_figures/subplots_demo.py
index 2e2dc3681cde..229ecd34cc9f 100644
--- a/galleries/examples/subplots_axes_and_figures/subplots_demo.py
+++ b/galleries/examples/subplots_axes_and_figures/subplots_demo.py
@@ -181,7 +181,7 @@
 
 # %%
 # If you want a more complex sharing structure, you can first create the
-# grid of axes with no sharing, and then call `.axes.Axes.sharex` or
+# grid of Axes with no sharing, and then call `.axes.Axes.sharex` or
 # `.axes.Axes.sharey` to add sharing info a posteriori.
 
 fig, axs = plt.subplots(2, 2)
@@ -197,7 +197,7 @@
 fig.tight_layout()
 
 # %%
-# Polar axes
+# Polar Axes
 # """"""""""
 #
 # The parameter *subplot_kw* of `.pyplot.subplots` controls the subplot
diff --git a/galleries/examples/subplots_axes_and_figures/two_scales.py b/galleries/examples/subplots_axes_and_figures/two_scales.py
index 857c22d5094d..249a65fd64fe 100644
--- a/galleries/examples/subplots_axes_and_figures/two_scales.py
+++ b/galleries/examples/subplots_axes_and_figures/two_scales.py
@@ -3,14 +3,14 @@
 Plots with different scales
 ===========================
 
-Two plots on the same axes with different left and right scales.
+Two plots on the same Axes with different left and right scales.
 
-The trick is to use *two different axes* that share the same *x* axis.
+The trick is to use *two different Axes* that share the same *x* axis.
 You can use separate `matplotlib.ticker` formatters and locators as
-desired since the two axes are independent.
+desired since the two Axes are independent.
 
-Such axes are generated by calling the `.Axes.twinx` method. Likewise,
-`.Axes.twiny` is available to generate axes that share a *y* axis but
+Such Axes are generated by calling the `.Axes.twinx` method. Likewise,
+`.Axes.twiny` is available to generate Axes that share a *y* axis but
 have different top and bottom scales.
 """
 import matplotlib.pyplot as plt
@@ -29,7 +29,7 @@
 ax1.plot(t, data1, color=color)
 ax1.tick_params(axis='y', labelcolor=color)
 
-ax2 = ax1.twinx()  # instantiate a second axes that shares the same x-axis
+ax2 = ax1.twinx()  # instantiate a second Axes that shares the same x-axis
 
 color = 'tab:blue'
 ax2.set_ylabel('sin', color=color)  # we already handled the x-label with ax1
diff --git a/galleries/examples/subplots_axes_and_figures/zoom_inset_axes.py b/galleries/examples/subplots_axes_and_figures/zoom_inset_axes.py
index 0d03db15b434..4cbd9875e4bc 100644
--- a/galleries/examples/subplots_axes_and_figures/zoom_inset_axes.py
+++ b/galleries/examples/subplots_axes_and_figures/zoom_inset_axes.py
@@ -1,9 +1,9 @@
 """
 ======================
-Zoom region inset axes
+Zoom region inset Axes
 ======================
 
-Example of an inset axes and a rectangle showing where the zoom is located.
+Example of an inset Axes and a rectangle showing where the zoom is located.
 """
 
 import numpy as np
@@ -22,7 +22,7 @@
 
 ax.imshow(Z2, extent=extent, origin="lower")
 
-# inset axes....
+# inset Axes....
 x1, x2, y1, y2 = -1.5, -0.9, -2.5, -1.9  # subregion of the original image
 axins = ax.inset_axes(
     [0.5, 0.5, 0.47, 0.47],
diff --git a/galleries/examples/text_labels_and_annotations/align_ylabels.py b/galleries/examples/text_labels_and_annotations/align_ylabels.py
index 7e6e4152da7f..168f5f6d8c19 100644
--- a/galleries/examples/text_labels_and_annotations/align_ylabels.py
+++ b/galleries/examples/text_labels_and_annotations/align_ylabels.py
@@ -43,7 +43,7 @@ def make_plot(axs):
 fig.subplots_adjust(left=0.2, wspace=0.6)
 make_plot(axs)
 
-# just align the last column of axes:
+# just align the last column of Axes:
 fig.align_ylabels(axs[:, 1])
 plt.show()
 
diff --git a/galleries/examples/text_labels_and_annotations/annotation_demo.py b/galleries/examples/text_labels_and_annotations/annotation_demo.py
index 26f3b80bf203..5358bfaac60a 100644
--- a/galleries/examples/text_labels_and_annotations/annotation_demo.py
+++ b/galleries/examples/text_labels_and_annotations/annotation_demo.py
@@ -29,15 +29,15 @@
 #  'figure points'   : points from the lower left corner of the figure
 #  'figure pixels'   : pixels from the lower left corner of the figure
 #  'figure fraction' : (0, 0) is lower left of figure and (1, 1) is upper right
-#  'axes points'     : points from lower left corner of axes
-#  'axes pixels'     : pixels from lower left corner of axes
-#  'axes fraction'   : (0, 0) is lower left of axes and (1, 1) is upper right
+#  'axes points'     : points from lower left corner of the Axes
+#  'axes pixels'     : pixels from lower left corner of the Axes
+#  'axes fraction'   : (0, 0) is lower left of Axes and (1, 1) is upper right
 #  'offset points'   : Specify an offset (in points) from the xy value
 #  'offset pixels'   : Specify an offset (in pixels) from the xy value
-#  'data'            : use the axes data coordinate system
+#  'data'            : use the Axes data coordinate system
 #
 # Note: for physical coordinate systems (points or pixels) the origin is the
-# (bottom, left) of the figure or axes.
+# (bottom, left) of the figure or Axes.
 #
 # Optionally, you can specify arrow properties which draws and arrow
 # from the text to the annotated point by giving a dictionary of arrow
@@ -85,7 +85,7 @@
             horizontalalignment='right', verticalalignment='top')
 
 # You may also use negative points or pixels to specify from (right, top).
-# E.g., (-10, 10) is 10 points to the left of the right side of the axes and 10
+# E.g., (-10, 10) is 10 points to the left of the right side of the Axes and 10
 # points above the bottom
 
 ax.annotate('pixel offset from axes fraction',
@@ -103,10 +103,10 @@
 #
 # You can specify the *xypoint* and the *xytext* in different positions and
 # coordinate systems, and optionally turn on a connecting line and mark the
-# point with a marker.  Annotations work on polar axes too.
+# point with a marker.  Annotations work on polar Axes too.
 #
 # In the example below, the *xy* point is in native coordinates (*xycoords*
-# defaults to 'data').  For a polar axes, this is in (theta, radius) space.
+# defaults to 'data').  For a polar Axes, this is in (theta, radius) space.
 # The text in the example is placed in the fractional figure coordinate system.
 # Text keyword arguments like horizontal and vertical alignment are respected.
 
@@ -127,7 +127,7 @@
             verticalalignment='bottom')
 
 # %%
-# You can also use polar notation on a cartesian axes.  Here the native
+# You can also use polar notation on a cartesian Axes.  Here the native
 # coordinate system ('data') is cartesian, so you need to specify the
 # xycoords and textcoords as 'polar' if you want to use (theta, radius).
 
@@ -144,7 +144,7 @@
             arrowprops=dict(facecolor='black', shrink=0.05),
             horizontalalignment='left',
             verticalalignment='bottom',
-            clip_on=True)  # clip to the axes bounding box
+            clip_on=True)  # clip to the Axes bounding box
 
 ax.set(xlim=[-20, 20], ylim=[-20, 20])
 
diff --git a/galleries/examples/text_labels_and_annotations/arrow_demo.py b/galleries/examples/text_labels_and_annotations/arrow_demo.py
index 9607818181dc..11c6c3ec0e5d 100644
--- a/galleries/examples/text_labels_and_annotations/arrow_demo.py
+++ b/galleries/examples/text_labels_and_annotations/arrow_demo.py
@@ -23,7 +23,7 @@ def make_arrow_graph(ax, data, size=4, display='length', shape='right',
     Parameters
     ----------
     ax
-        The axes where the graph is drawn.
+        The Axes where the graph is drawn.
     data
         Dict with probabilities for the bases and pair transitions.
     size
diff --git a/galleries/examples/text_labels_and_annotations/demo_text_rotation_mode.py b/galleries/examples/text_labels_and_annotations/demo_text_rotation_mode.py
index a571a07edf49..f8f3a108629c 100644
--- a/galleries/examples/text_labels_and_annotations/demo_text_rotation_mode.py
+++ b/galleries/examples/text_labels_and_annotations/demo_text_rotation_mode.py
@@ -7,7 +7,7 @@
 of rotated text.
 
 Rotated `.Text`\s are created by passing the parameter ``rotation`` to
-the constructor or the axes' method `~.axes.Axes.text`.
+the constructor or the Axes' method `~.axes.Axes.text`.
 
 The actual positioning depends on the additional parameters
 ``horizontalalignment``, ``verticalalignment`` and ``rotation_mode``.
@@ -45,11 +45,11 @@ def test_rotation_mode(fig, mode):
 
     texts = {}
 
-    # use a different text alignment in each axes
+    # use a different text alignment in each Axes
     for i, va in enumerate(va_list):
         for j, ha in enumerate(ha_list):
             ax = axs[i, j]
-            # prepare axes layout
+            # prepare Axes layout
             ax.set(xticks=[], yticks=[])
             ax.axvline(0.5, color="skyblue", zorder=0)
             ax.axhline(0.5, color="skyblue", zorder=0)
diff --git a/galleries/examples/text_labels_and_annotations/figlegend_demo.py b/galleries/examples/text_labels_and_annotations/figlegend_demo.py
index 9c19418ae261..f6f74b837c10 100644
--- a/galleries/examples/text_labels_and_annotations/figlegend_demo.py
+++ b/galleries/examples/text_labels_and_annotations/figlegend_demo.py
@@ -30,7 +30,7 @@
 plt.show()
 
 # %%
-# Sometimes we do not want the legend to overlap the axes.  If you use
+# Sometimes we do not want the legend to overlap the Axes.  If you use
 # *constrained layout* you can specify "outside right upper", and
 # *constrained layout* will make room for the legend.
 
diff --git a/galleries/examples/text_labels_and_annotations/label_subplots.py b/galleries/examples/text_labels_and_annotations/label_subplots.py
index 2b71ddf26abf..aa7b94cb74fe 100644
--- a/galleries/examples/text_labels_and_annotations/label_subplots.py
+++ b/galleries/examples/text_labels_and_annotations/label_subplots.py
@@ -12,7 +12,7 @@
 
 For convenience, this example uses `.pyplot.subplot_mosaic` and subplot
 labels as keys for the subplots.  However, the approach also works with
-`.pyplot.subplots` or keys that are different than what you want to label the
+`.pyplot.subplots` or keys that are different from what you want to label the
 subplot with.
 """
 
diff --git a/galleries/examples/text_labels_and_annotations/line_with_text.py b/galleries/examples/text_labels_and_annotations/line_with_text.py
index 389554bd5ae1..22f5580b33ba 100644
--- a/galleries/examples/text_labels_and_annotations/line_with_text.py
+++ b/galleries/examples/text_labels_and_annotations/line_with_text.py
@@ -28,7 +28,7 @@ def set_figure(self, figure):
         self.text.set_figure(figure)
         super().set_figure(figure)
 
-    # Override the axes property setter to set Axes on our children as well.
+    # Override the Axes property setter to set Axes on our children as well.
     @lines.Line2D.axes.setter
     def axes(self, new_axes):
         self.text.axes = new_axes
diff --git a/galleries/examples/text_labels_and_annotations/placing_text_boxes.py b/galleries/examples/text_labels_and_annotations/placing_text_boxes.py
index f3b07a25e135..7cf49bf6e0bb 100644
--- a/galleries/examples/text_labels_and_annotations/placing_text_boxes.py
+++ b/galleries/examples/text_labels_and_annotations/placing_text_boxes.py
@@ -2,7 +2,7 @@
 Placing text boxes
 ==================
 
-When decorating axes with text boxes, two useful tricks are to place the text
+When decorating Axes with text boxes, two useful tricks are to place the text
 in axes coordinates (see :ref:`transforms_tutorial`),
 so the text doesn't move around with changes in x or y limits.  You
 can also use the ``bbox`` property of text to surround the text with a
diff --git a/galleries/examples/text_labels_and_annotations/titles_demo.py b/galleries/examples/text_labels_and_annotations/titles_demo.py
index 7202ac9115ff..6fc0e350fdb2 100644
--- a/galleries/examples/text_labels_and_annotations/titles_demo.py
+++ b/galleries/examples/text_labels_and_annotations/titles_demo.py
@@ -4,7 +4,7 @@
 =================
 
 Matplotlib can display plot titles centered, flush with the left side of
-a set of axes, and flush with the right side of a set of axes.
+a set of Axes, and flush with the right side of a set of Axes.
 
 """
 import matplotlib.pyplot as plt
diff --git a/galleries/examples/ticks/colorbar_tick_labelling_demo.py b/galleries/examples/ticks/colorbar_tick_labelling_demo.py
index 8a1e5b28043d..6436748a46ec 100644
--- a/galleries/examples/ticks/colorbar_tick_labelling_demo.py
+++ b/galleries/examples/ticks/colorbar_tick_labelling_demo.py
@@ -6,8 +6,8 @@
 Vertical colorbars have ticks, tick labels, and labels visible on the *y* axis,
 horizontal colorbars on the *x* axis. The ``ticks`` parameter can be used to
 set the ticks and the ``format`` parameter can be used to format the tick labels
-of the visible colorbar axes. For further adjustments, the ``yaxis`` or
-``xaxis`` axes of the colorbar can be retrieved using its ``ax`` property.
+of the visible colorbar Axes. For further adjustments, the ``yaxis`` or
+``xaxis`` Axes of the colorbar can be retrieved using its ``ax`` property.
 """
 import matplotlib.pyplot as plt
 import numpy as np
diff --git a/galleries/examples/ticks/ticklabels_rotation.py b/galleries/examples/ticks/ticklabels_rotation.py
index 711a680def62..216b15d2762c 100644
--- a/galleries/examples/ticks/ticklabels_rotation.py
+++ b/galleries/examples/ticks/ticklabels_rotation.py
@@ -14,7 +14,7 @@
 plt.plot(x, y)
 # You can specify a rotation for the tick labels in degrees or with keywords.
 plt.xticks(x, labels, rotation='vertical')
-# Pad margins so that markers don't get clipped by the axes
+# Pad margins so that markers don't get clipped by the Axes
 plt.margins(0.2)
 # Tweak spacing to prevent clipping of tick-labels
 plt.subplots_adjust(bottom=0.15)
diff --git a/galleries/examples/user_interfaces/embedding_in_wx4_sgskip.py b/galleries/examples/user_interfaces/embedding_in_wx4_sgskip.py
index 56cb5f423980..b9504ff25dee 100644
--- a/galleries/examples/user_interfaces/embedding_in_wx4_sgskip.py
+++ b/galleries/examples/user_interfaces/embedding_in_wx4_sgskip.py
@@ -28,7 +28,7 @@ def __init__(self, canvas):
         self.Bind(wx.EVT_TOOL, self._on_custom, id=tool.GetId())
 
     def _on_custom(self, event):
-        # add some text to the axes in a random location in axes coords with a
+        # add some text to the Axes in a random location in axes coords with a
         # random color
         ax = self.canvas.figure.axes[0]
         x, y = np.random.rand(2)  # generate a random location
diff --git a/galleries/examples/user_interfaces/fourier_demo_wx_sgskip.py b/galleries/examples/user_interfaces/fourier_demo_wx_sgskip.py
index 56c62ae1ba77..f51917fda6b9 100644
--- a/galleries/examples/user_interfaces/fourier_demo_wx_sgskip.py
+++ b/galleries/examples/user_interfaces/fourier_demo_wx_sgskip.py
@@ -164,7 +164,7 @@ def mouseMotion(self, event):
         if self.state == '':
             return
         x, y = event.xdata, event.ydata
-        if x is None:  # outside the axes
+        if x is None:  # outside the Axes
             return
         x0, y0, f0Init, AInit = self.mouseInfo
         self.A.set(AInit + (AInit * (y - y0) / y0), self)
diff --git a/galleries/examples/widgets/multicursor.py b/galleries/examples/widgets/multicursor.py
index 3a80b9ef8230..bc0d58b6c749 100644
--- a/galleries/examples/widgets/multicursor.py
+++ b/galleries/examples/widgets/multicursor.py
@@ -5,9 +5,9 @@
 
 Showing a cursor on multiple plots simultaneously.
 
-This example generates three axes split over two different figures.  On
+This example generates three Axes split over two different figures.  On
 hovering the cursor over data in one subplot, the values of that datapoint are
-shown in all axes.
+shown in all Axes.
 """
 
 import matplotlib.pyplot as plt
diff --git a/galleries/tutorials/artists.py b/galleries/tutorials/artists.py
index 46303372d7ae..f5e4589e8a52 100644
--- a/galleries/tutorials/artists.py
+++ b/galleries/tutorials/artists.py
@@ -286,7 +286,7 @@ class in the Matplotlib API, and the one you will be working with most
 # :class:`~matplotlib.patches.Rectangle` which is stored in
 # :attr:`Figure.patch <matplotlib.figure.Figure.patch>`.  As
 # you add subplots (:meth:`~matplotlib.figure.Figure.add_subplot`) and
-# axes (:meth:`~matplotlib.figure.Figure.add_axes`) to the figure
+# Axes (:meth:`~matplotlib.figure.Figure.add_axes`) to the figure
 # these will be appended to the :attr:`Figure.axes
 # <matplotlib.figure.Figure.axes>`.  These are also returned by the
 # methods that create them:
@@ -443,7 +443,7 @@ class in the Matplotlib API, and the one you will be working with most
 #     # create a rectangle instance
 #     In [263]: rect = matplotlib.patches.Rectangle((1, 1), width=5, height=12)
 #
-#     # by default the axes instance is None
+#     # by default the Axes instance is None
 #     In [264]: print(rect.axes)
 #     None
 #
@@ -454,7 +454,7 @@ class in the Matplotlib API, and the one you will be working with most
 #     # now we add the Rectangle to the Axes
 #     In [266]: ax.add_patch(rect)
 #
-#     # and notice that the ax.add_patch method has set the axes
+#     # and notice that the ax.add_patch method has set the Axes
 #     # instance
 #     In [267]: print(rect.axes)
 #     Axes(0.125,0.1;0.775x0.8)
@@ -485,7 +485,7 @@ class in the Matplotlib API, and the one you will be working with most
 #                                  [  0. 100.   0.]
 #                                  [  0.   0.   1.]])))))))
 #
-#     # the default axes transformation is ax.transData
+#     # the default Axes transformation is ax.transData
 #     In [269]: print(ax.transData)
 #     CompositeGenericTransform(
 #         TransformWrapper(
diff --git a/galleries/tutorials/lifecycle.py b/galleries/tutorials/lifecycle.py
index 9df59a5d229f..4aae4d6c1dbc 100644
--- a/galleries/tutorials/lifecycle.py
+++ b/galleries/tutorials/lifecycle.py
@@ -86,7 +86,7 @@
 #
 # .. note::
 #
-#    Figures can have multiple axes on them. For information on how to do this,
+#    Figures can have multiple Axes on them. For information on how to do this,
 #    see the :ref:`Tight Layout tutorial
 #    <tight_layout_guide>`.
 
@@ -212,7 +212,7 @@ def currency(x, pos):
 
 # %%
 # We can then apply this function to the labels on our plot. To do this,
-# we use the ``xaxis`` attribute of our axes. This lets you perform
+# we use the ``xaxis`` attribute of our Axes. This lets you perform
 # actions on a specific axis on our plot.
 
 fig, ax = plt.subplots(figsize=(6, 8))
@@ -230,7 +230,7 @@ def currency(x, pos):
 #
 # It is possible to draw multiple plot elements on the same instance of
 # :class:`axes.Axes`. To do this we simply need to call another one of
-# the plot methods on that axes object.
+# the plot methods on that Axes object.
 
 fig, ax = plt.subplots(figsize=(8, 8))
 ax.barh(group_names, group_data)
diff --git a/galleries/tutorials/pyplot.py b/galleries/tutorials/pyplot.py
index 3c9f65a68c57..8062e5aa3793 100644
--- a/galleries/tutorials/pyplot.py
+++ b/galleries/tutorials/pyplot.py
@@ -26,10 +26,10 @@
 # In :mod:`matplotlib.pyplot` various states are preserved
 # across function calls, so that it keeps track of things like
 # the current figure and plotting area, and the plotting
-# functions are directed to the current axes (please note that "axes" here
-# and in most places in the documentation refers to the *axes*
+# functions are directed to the current Axes (please note that we use uppercase
+# Axes to refer to the `~.axes.Axes` concept, which is a central
 # :ref:`part of a figure <figure_parts>`
-# and not the strict mathematical term for more than one axis).
+# and not only the plural of *axis*).
 #
 # .. note::
 #
@@ -81,7 +81,7 @@
 # list of line styles and format strings.  The
 # `~.pyplot.axis` function in the example above takes a
 # list of ``[xmin, xmax, ymin, ymax]`` and specifies the viewport of the
-# axes.
+# Axes.
 #
 # If matplotlib were limited to working with lists, it would be fairly
 # useless for numeric processing.  Generally, you will use `numpy
@@ -241,12 +241,12 @@
 # .. _multiple-figs-axes:
 #
 #
-# Working with multiple figures and axes
+# Working with multiple figures and Axes
 # ======================================
 #
 # MATLAB, and :mod:`.pyplot`, have the concept of the current figure
-# and the current axes.  All plotting functions apply to the current
-# axes.  The function `~.pyplot.gca` returns the current axes (a
+# and the current Axes.  All plotting functions apply to the current
+# Axes.  The function `~.pyplot.gca` returns the current Axes (a
 # `matplotlib.axes.Axes` instance), and `~.pyplot.gcf` returns the current
 # figure (a `matplotlib.figure.Figure` instance). Normally, you don't have to
 # worry about this, because it is all taken care of behind the scenes.  Below
@@ -278,17 +278,17 @@ def f(t):
 # to ``subplot(2, 1, 1)``.
 #
 # You can create an arbitrary number of subplots
-# and axes.  If you want to place an Axes manually, i.e., not on a
+# and Axes.  If you want to place an Axes manually, i.e., not on a
 # rectangular grid, use `~.pyplot.axes`,
 # which allows you to specify the location as ``axes([left, bottom,
 # width, height])`` where all values are in fractional (0 to 1)
 # coordinates.  See :doc:`/gallery/subplots_axes_and_figures/axes_demo` for an example of
-# placing axes manually and :doc:`/gallery/subplots_axes_and_figures/subplot` for an
+# placing Axes manually and :doc:`/gallery/subplots_axes_and_figures/subplot` for an
 # example with lots of subplots.
 #
 # You can create multiple figures by using multiple
 # `~.pyplot.figure` calls with an increasing figure
-# number.  Of course, each figure can contain as many axes and subplots
+# number.  Of course, each figure can contain as many Axes and subplots
 # as your heart desires::
 #
 #     import matplotlib.pyplot as plt
@@ -309,8 +309,8 @@ def f(t):
 #     plt.title('Easy as 1, 2, 3') # subplot 211 title
 #
 # You can clear the current figure with `~.pyplot.clf`
-# and the current axes with `~.pyplot.cla`.  If you find
-# it annoying that states (specifically the current image, figure and axes)
+# and the current Axes with `~.pyplot.cla`.  If you find
+# it annoying that states (specifically the current image, figure and Axes)
 # are being maintained for you behind the scenes, don't despair: this is just a thin
 # stateful wrapper around an object-oriented API, which you can use
 # instead (see :ref:`artists_tutorial`)
diff --git a/galleries/users_explain/artists/color_cycle.py b/galleries/users_explain/artists/color_cycle.py
index 715b75a88ff4..a5d789028700 100644
--- a/galleries/users_explain/artists/color_cycle.py
+++ b/galleries/users_explain/artists/color_cycle.py
@@ -18,8 +18,8 @@
 This example demonstrates two different APIs:
 
 1. Setting the rc parameter specifying the default property cycle.
-   This affects all subsequent axes (but not axes already created).
-2. Setting the property cycle for a single pair of axes.
+   This affects all subsequent Axes (but not Axes already created).
+2. Setting the property cycle for a single pair of Axes.
 
 """
 from cycler import cycler
@@ -51,7 +51,7 @@
 plt.rc('axes', prop_cycle=default_cycler)
 
 # %%
-# Now we'll generate a figure with two axes, one on top of the other. On the
+# Now we'll generate a figure with two Axes, one on top of the other. On the
 # first axis, we'll plot with the default cycler. On the second axis, we'll
 # set the ``prop_cycle`` using :func:`matplotlib.axes.Axes.set_prop_cycle`,
 # which will only set the ``prop_cycle`` for this :mod:`matplotlib.axes.Axes`
diff --git a/galleries/users_explain/artists/imshow_extent.py b/galleries/users_explain/artists/imshow_extent.py
index d222af6aee26..d16a15f1e9f9 100644
--- a/galleries/users_explain/artists/imshow_extent.py
+++ b/galleries/users_explain/artists/imshow_extent.py
@@ -11,7 +11,7 @@
 will be used as-is) to a rectangular region in data space.  The orientation of
 the image in the final rendering is controlled by the *origin* and *extent*
 keyword arguments (and attributes on the resulting `.AxesImage` instance) and
-the data limits of the axes.
+the data limits of the Axes.
 
 The *extent* keyword arguments controls the bounding box in data coordinates
 that the image will fill specified as ``(left, right, bottom, top)`` in **data
@@ -218,9 +218,9 @@ def generate_imshow_demo_grid(extents, xlim=None, ylim=None):
 # By setting *extent* we define the coordinates of the image area. The
 # underlying image data is interpolated/resampled to fill that area.
 #
-# If the axes is set to autoscale, then the view limits of the axes are set
+# If the Axes is set to autoscale, then the view limits of the Axes are set
 # to match the *extent* which ensures that the coordinate set by
-# ``(left, bottom)`` is at the bottom left of the axes!  However, this
+# ``(left, bottom)`` is at the bottom left of the Axes!  However, this
 # may invert the axis so they do not increase in the 'natural' direction.
 #
 
@@ -240,7 +240,7 @@ def generate_imshow_demo_grid(extents, xlim=None, ylim=None):
 # -------------------------------
 #
 # If we fix the axes limits by explicitly setting `~.axes.Axes.set_xlim` /
-# `~.axes.Axes.set_ylim`, we force a certain size and orientation of the axes.
+# `~.axes.Axes.set_ylim`, we force a certain size and orientation of the Axes.
 # This can decouple the 'left-right' and 'top-bottom' sense of the image from
 # the orientation on the screen.
 #
diff --git a/galleries/users_explain/artists/paths.py b/galleries/users_explain/artists/paths.py
index b096d05d0751..669e18107e5c 100644
--- a/galleries/users_explain/artists/paths.py
+++ b/galleries/users_explain/artists/paths.py
@@ -186,7 +186,7 @@
 #     verts[3::5, 1] = bottom
 #
 # All that remains is to create the path, attach it to a
-# :class:`~matplotlib.patches.PathPatch`, and add it to our axes::
+# :class:`~matplotlib.patches.PathPatch`, and add it to our Axes::
 #
 #     barpath = path.Path(verts, codes)
 #     patch = patches.PathPatch(barpath, facecolor='green',
diff --git a/galleries/users_explain/artists/transforms_tutorial.py b/galleries/users_explain/artists/transforms_tutorial.py
index a39cf7a30192..bf99dfd81d2a 100644
--- a/galleries/users_explain/artists/transforms_tutorial.py
+++ b/galleries/users_explain/artists/transforms_tutorial.py
@@ -32,8 +32,8 @@
 +----------------+-----------------------------------+-----------------------------+
 |"axes"          |The coordinate system of the       |``ax.transAxes``             |
 |                |`~matplotlib.axes.Axes`; (0, 0)    |                             |
-|                |is bottom left of the axes, and    |                             |
-|                |(1, 1) is top right of the axes.   |                             |
+|                |is bottom left of the Axes, and    |                             |
+|                |(1, 1) is top right of the Axes.   |                             |
 +----------------+-----------------------------------+-----------------------------+
 |"subfigure"     |The coordinate system of the       |``subfigure.transSubfigure`` |
 |                |`.SubFigure`; (0, 0) is bottom left|                             |
@@ -104,7 +104,7 @@
 ================
 
 Let's start with the most commonly used coordinate, the *data* coordinate
-system.  Whenever you add data to the axes, Matplotlib updates the datalimits,
+system.  Whenever you add data to the Axes, Matplotlib updates the datalimits,
 most commonly updated with the :meth:`~matplotlib.axes.Axes.set_xlim` and
 :meth:`~matplotlib.axes.Axes.set_ylim` methods.  For example, in the figure
 below, the data limits stretch from 0 to 10 on the x-axis, and -1 to 1 on the
@@ -243,11 +243,11 @@
 #
 # After the *data* coordinate system, *axes* is probably the second most
 # useful coordinate system.  Here the point (0, 0) is the bottom left of
-# your axes or subplot, (0.5, 0.5) is the center, and (1.0, 1.0) is the top
+# your Axes or subplot, (0.5, 0.5) is the center, and (1.0, 1.0) is the top
 # right.  You can also refer to points outside the range, so (-0.1, 1.1)
-# is to the left and above your axes.  This coordinate system is extremely
-# useful when placing text in your axes, because you often want a text bubble
-# in a fixed, location, e.g., the upper left of the axes pane, and have that
+# is to the left and above your Axes.  This coordinate system is extremely
+# useful when placing text in your Axes, because you often want a text bubble
+# in a fixed, location, e.g., the upper left of the Axes pane, and have that
 # location remain fixed when you pan or zoom.  Here is a simple example that
 # creates four panels and labels them 'A', 'B', 'C', 'D' as you often see in
 # journals.  A more sophisticated approach for such labeling is presented at
@@ -266,13 +266,13 @@
 # this is less useful in my experience than using ``ax.transAxes`` for
 # placing text.  Nonetheless, here is a silly example which plots some
 # random dots in data space, and overlays a semi-transparent
-# :class:`~matplotlib.patches.Circle` centered in the middle of the axes
-# with a radius one quarter of the axes -- if your axes does not
+# :class:`~matplotlib.patches.Circle` centered in the middle of the Axes
+# with a radius one quarter of the Axes -- if your Axes does not
 # preserve aspect ratio (see :meth:`~matplotlib.axes.Axes.set_aspect`),
 # this will look like an ellipse.  Use the pan/zoom tool to move around,
 # or manually change the data xlim and ylim, and you will see the data
 # move, but the circle will remain fixed because it is not in *data*
-# coordinates and will always remain at the center of the axes.
+# coordinates and will always remain at the center of the Axes.
 
 fig, ax = plt.subplots()
 x, y = 10*np.random.rand(2, 1000)
@@ -348,7 +348,7 @@
 # interactively, you can see that changing the size of the figure does
 # not change the offset of the circle from the lower-left corner,
 # does not change its size, and the circle remains a circle regardless of
-# the aspect ratio of the axes.
+# the aspect ratio of the Axes.
 
 fig, ax = plt.subplots(figsize=(5, 4))
 x, y = 10*np.random.rand(2, 1000)
@@ -374,7 +374,7 @@
 
 # %%
 # Another use is putting a patch with a set physical dimension around a
-# data point on the axes.  Here we add together two transforms.  The
+# data point on the Axes.  Here we add together two transforms.  The
 # first sets the scaling of how large the ellipse should be and the second
 # sets its position.  The ellipse is then placed at the origin, and then
 # we use the helper transform :class:`~matplotlib.transforms.ScaledTranslation`
@@ -497,7 +497,7 @@
 # nonlinear projections and scales that happen in polar and logarithmic
 # plots, from the linear affine transformations that happen when you pan
 # and zoom.  There is an efficiency here, because you can pan and zoom
-# in your axes which affects the affine transformation, but you may not
+# in your Axes which affects the affine transformation, but you may not
 # need to compute the potentially expensive nonlinear scales or
 # projections on simple navigation events.  It is also possible to
 # multiply affine transformation matrices together, and then apply them
@@ -512,12 +512,12 @@
 #
 # We've been introduced to the ``transAxes`` instance above in
 # :ref:`axes-coords`, which maps the (0, 0), (1, 1) corners of the
-# axes or subplot bounding box to *display* space, so let's look at
+# Axes or subplot bounding box to *display* space, so let's look at
 # these other two pieces.
 #
 # ``self.transLimits`` is the transformation that takes you from
 # *data* to *axes* coordinates; i.e., it maps your view xlim and ylim
-# to the unit space of the axes (and ``transAxes`` then takes that unit
+# to the unit space of the Axes (and ``transAxes`` then takes that unit
 # space to display space).  We can see this in action here
 #
 # .. sourcecode:: ipython
diff --git a/galleries/users_explain/axes/arranging_axes.py b/galleries/users_explain/axes/arranging_axes.py
index 8068d3b92ad3..1f910393a9da 100644
--- a/galleries/users_explain/axes/arranging_axes.py
+++ b/galleries/users_explain/axes/arranging_axes.py
@@ -75,7 +75,7 @@
 location:
 
 `~matplotlib.figure.Figure.add_axes`
-    Adds a single axes at a location specified by
+    Adds a single Axes at a location specified by
     ``[left, bottom, width, height]`` in fractions of figure width or height.
 
 `~matplotlib.pyplot.subplot` or `.Figure.add_subplot`
@@ -91,7 +91,7 @@
 
 # %%
 #
-# As a simple example of manually adding an axes a, lets add a 3 inch x 2 inch
+# As a simple example of manually adding an Axes *ax*, lets add a 3 inch x 2 inch
 # Axes to a 4 inch x 3 inch figure.  Note that the location of the subplot is
 # defined as [left, bottom, width, height] in figure-normalized units:
 
@@ -161,7 +161,7 @@ def annotate_axes(ax, text, fontsize=18):
 # Grids of fixed-aspect ratio Axes
 # --------------------------------
 #
-# Fixed-aspect ratio axes are common for images or maps.  However, they
+# Fixed-aspect ratio Axes are common for images or maps.  However, they
 # present a challenge to layout because two sets of constraints are being
 # imposed on the size of the Axes - that they fit in the figure and that they
 # have a set aspect ratio.  This leads to large gaps between Axes by default:
diff --git a/galleries/users_explain/axes/autoscale.py b/galleries/users_explain/axes/autoscale.py
index 53435f4086c9..11c1afc53813 100644
--- a/galleries/users_explain/axes/autoscale.py
+++ b/galleries/users_explain/axes/autoscale.py
@@ -7,7 +7,7 @@
 ================
 
 The limits on an axis can be set manually (e.g. ``ax.set_xlim(xmin, xmax)``)
-or Matplotlib can set them automatically based on the data already on the axes.
+or Matplotlib can set them automatically based on the data already on the Axes.
 There are a number of options to this autoscaling behaviour, discussed below.
 """
 
@@ -165,8 +165,8 @@
 # ------------------------
 #
 # Autoscale works out of the box for all lines, patches, and images added to
-# the axes. One of the artists that it won't work with is a `.Collection`.
-# After adding a collection to the axes, one has to manually trigger the
+# the Axes. One of the artists that it won't work with is a `.Collection`.
+# After adding a collection to the Axes, one has to manually trigger the
 # `~matplotlib.axes.Axes.autoscale_view()` to recalculate
 # axes limits.
 
diff --git a/galleries/users_explain/axes/axes_ticks.py b/galleries/users_explain/axes/axes_ticks.py
index 3870c26af70e..111f2e776673 100644
--- a/galleries/users_explain/axes/axes_ticks.py
+++ b/galleries/users_explain/axes/axes_ticks.py
@@ -63,7 +63,7 @@
 # =======================
 #
 # Manually setting the ticks as above works well for specific final plots, but
-# does not adapt as the user interacts with the axes.   At a lower level,
+# does not adapt as the user interacts with the Axes.   At a lower level,
 # Matplotlib has ``Locators`` that are meant to automatically choose ticks
 # depending on the current view limits of the axis, and ``Formatters`` that are
 # meant to format the tick labels automatically.
diff --git a/galleries/users_explain/axes/colorbar_placement.py b/galleries/users_explain/axes/colorbar_placement.py
index 919600b070f3..3f4a16111d4c 100644
--- a/galleries/users_explain/axes/colorbar_placement.py
+++ b/galleries/users_explain/axes/colorbar_placement.py
@@ -13,8 +13,8 @@
 Automatic placement of colorbars
 ================================
 
-The simplest case is just attaching a colorbar to each axes.  Note in this
-example that the colorbars steal some space from the parent axes.
+The simplest case is just attaching a colorbar to each Axes.  Note in this
+example that the colorbars steal some space from the parent Axes.
 """
 import matplotlib.pyplot as plt
 import numpy as np
@@ -34,7 +34,7 @@
 # %%
 # The first column has the same type of data in both rows, so it may be
 # desirable to have just one colorbar. We do this by passing `.Figure.colorbar`
-# a list of axes with the *ax* kwarg.
+# a list of Axes with the *ax* kwarg.
 
 fig, axs = plt.subplots(2, 2)
 cmaps = ['RdBu_r', 'viridis']
@@ -46,7 +46,7 @@
     fig.colorbar(pcm, ax=axs[:, col], shrink=0.6)
 
 # %%
-# The stolen space can lead to axes in the same subplot layout
+# The stolen space can lead to Axes in the same subplot layout
 # being different sizes, which is often undesired if the the
 # x-axis on each plot is meant to be comparable as in the following:
 
@@ -58,7 +58,7 @@
 
 # %%
 # This is usually undesired, and can be worked around in various ways, e.g.
-# adding a colorbar to the other axes and then removing it.  However, the most
+# adding a colorbar to the other Axes and then removing it.  However, the most
 # straightforward is to use :ref:`constrained layout <constrainedlayout_guide>`:
 
 fig, axs = plt.subplots(2, 1, figsize=(4, 5), sharex=True, layout='constrained')
@@ -81,13 +81,13 @@
 fig.colorbar(pcm, ax=[axs[2, 1]], location='left')
 
 # %%
-# Adjusting the spacing between colorbars and parent axes
+# Adjusting the spacing between colorbars and parent Axes
 # =======================================================
 #
-# The distance a colorbar is from the parent axes can be adjusted with the
-# *pad* keyword argument.  This is in units of fraction of the parent axes
-# width, and the default for a vertical axes is 0.05 (or 0.15 for a horizontal
-# axes).
+# The distance a colorbar is from the parent Axes can be adjusted with the
+# *pad* keyword argument.  This is in units of fraction of the parent Axes
+# width, and the default for a vertical Axes is 0.05 (or 0.15 for a horizontal
+# Axes).
 
 fig, axs = plt.subplots(3, 1, layout='constrained', figsize=(5, 5))
 for ax, pad in zip(axs, [0.025, 0.05, 0.1]):
@@ -97,7 +97,7 @@
 
 # %%
 # Note that if you do not use constrained layout, the pad command makes the
-# parent axes shrink:
+# parent Axes shrink:
 
 fig, axs = plt.subplots(3, 1, figsize=(5, 5))
 for ax, pad in zip(axs, [0.025, 0.05, 0.1]):
@@ -110,17 +110,17 @@
 # =============================
 #
 # Sometimes the automatic placement provided by ``colorbar`` does not
-# give the desired effect.  We can manually create an axes and tell
-# ``colorbar`` to use that axes by passing the axes to the *cax* keyword
+# give the desired effect.  We can manually create an Axes and tell
+# ``colorbar`` to use that Axes by passing the Axes to the *cax* keyword
 # argument.
 #
 # Using ``inset_axes``
 # --------------------
 #
-# We can manually create any type of axes for the colorbar to use, but an
-# `.Axes.inset_axes` is useful because it is a child of the parent axes and can
+# We can manually create any type of Axes for the colorbar to use, but an
+# `.Axes.inset_axes` is useful because it is a child of the parent Axes and can
 # be positioned relative to the parent.  Here we add a colorbar centered near
-# the bottom of the parent axes.
+# the bottom of the parent Axes.
 
 fig, ax = plt.subplots(layout='constrained', figsize=(4, 4))
 pcm = ax.pcolormesh(np.random.randn(20, 20), cmap='viridis')
@@ -130,7 +130,7 @@
 
 # %%
 # `.Axes.inset_axes` can also specify its position in data coordinates
-# using the *transform* keyword argument if you want your axes at a
+# using the *transform* keyword argument if you want your Axes at a
 # certain data position on the graph:
 
 fig, ax = plt.subplots(layout='constrained', figsize=(4, 4))
@@ -140,11 +140,11 @@
 fig.colorbar(pcm, cax=cax, orientation='horizontal')
 
 # %%
-# Colorbars attached to fixed-aspect-ratio axes
+# Colorbars attached to fixed-aspect-ratio Axes
 # ---------------------------------------------
 #
-# Placing colorbars for axes with a fixed aspect ratio pose a particular
-# challenge as the parent axes changes size depending on the data view.
+# Placing colorbars for Axes with a fixed aspect ratio pose a particular
+# challenge as the parent Axes changes size depending on the data view.
 
 fig, axs = plt.subplots(2, 2,  layout='constrained')
 cmaps = ['RdBu_r', 'viridis']
@@ -161,9 +161,9 @@
             fig.colorbar(pcm, ax=ax, shrink=0.6)
 
 # %%
-# We solve this problem using `.Axes.inset_axes` to locate the axes in "axes
+# We solve this problem using `.Axes.inset_axes` to locate the Axes in "axes
 # coordinates" (see :ref:`transforms_tutorial`).  Note that if you zoom in on
-# the parent axes, and thus change the shape of it, the colorbar will also
+# the parent Axes, and thus change the shape of it, the colorbar will also
 # change position.
 
 fig, axs = plt.subplots(2, 2, layout='constrained')
@@ -184,7 +184,7 @@
 # %%
 # .. seealso::
 #
-#  :ref:`axes_grid` has methods for manually creating colorbar axes as well:
+#  :ref:`axes_grid` has methods for manually creating colorbar Axes as well:
 #
 #  - :ref:`demo-colorbar-with-inset-locator`
 #  - :ref:`demo-colorbar-with-axes-divider`
diff --git a/galleries/users_explain/axes/legend_guide.py b/galleries/users_explain/axes/legend_guide.py
index 1482cdbc4a81..3cefb3f83e9a 100644
--- a/galleries/users_explain/axes/legend_guide.py
+++ b/galleries/users_explain/axes/legend_guide.py
@@ -112,8 +112,8 @@
 # *loc*. Please see the documentation at :func:`legend` for more details.
 #
 # The ``bbox_to_anchor`` keyword gives a great degree of control for manual
-# legend placement. For example, if you want your axes legend located at the
-# figure's top right-hand corner instead of the axes' corner, simply specify
+# legend placement. For example, if you want your Axes legend located at the
+# figure's top right-hand corner instead of the Axes' corner, simply specify
 # the corner's location and the coordinate system of that location::
 #
 #     ax.legend(bbox_to_anchor=(1, 1),
diff --git a/galleries/users_explain/axes/mosaic.py b/galleries/users_explain/axes/mosaic.py
index 88d4562c7af6..d88c027688cb 100644
--- a/galleries/users_explain/axes/mosaic.py
+++ b/galleries/users_explain/axes/mosaic.py
@@ -13,11 +13,11 @@
 more complex layouts, such as Axes that span multiple columns / rows
 of the layout or leave some areas of the Figure blank, you can use
 `.gridspec.GridSpec` (see :ref:`arranging_axes`) or
-manually place your axes.  `.Figure.subplot_mosaic` aims to provide an
-interface to visually lay out your axes (as either ASCII art or nested
+manually place your Axes.  `.Figure.subplot_mosaic` aims to provide an
+interface to visually lay out your Axes (as either ASCII art or nested
 lists) to streamline this process.
 
-This interface naturally supports naming your axes.
+This interface naturally supports naming your Axes.
 `.Figure.subplot_mosaic` returns a dictionary keyed on the
 labels used to lay out the Figure.  By returning data structures with
 names, it is easier to write plotting code that is independent of the
@@ -75,7 +75,7 @@ def identify_axes(ax_dict, fontsize=48):
 
 # %%
 # Using `.Figure.subplot_mosaic` we can produce the same mosaic but give the
-# axes semantic names
+# Axes semantic names
 
 fig = plt.figure(layout="constrained")
 ax_dict = fig.subplot_mosaic(
@@ -103,7 +103,7 @@ def identify_axes(ax_dict, fontsize=48):
 # String short-hand
 # =================
 #
-# By restricting our axes labels to single characters we can
+# By restricting our Axes labels to single characters we can
 # "draw" the Axes we want as "ASCII art".  The following
 
 
diff --git a/galleries/users_explain/axes/tight_layout_guide.py b/galleries/users_explain/axes/tight_layout_guide.py
index 9074641d39ab..dcffa7437b94 100644
--- a/galleries/users_explain/axes/tight_layout_guide.py
+++ b/galleries/users_explain/axes/tight_layout_guide.py
@@ -46,7 +46,7 @@ def example_plot(ax, fontsize=12):
 example_plot(ax, fontsize=24)
 
 # %%
-# To prevent this, the location of axes needs to be adjusted. For
+# To prevent this, the location of Axes needs to be adjusted. For
 # subplots, this can be done manually by adjusting the subplot parameters
 # using `.Figure.subplots_adjust`. `.Figure.tight_layout` does this
 # automatically.
@@ -62,7 +62,7 @@ def example_plot(ax, fontsize=12):
 # equivalently, set :rc:`figure.autolayout` to ``True``.
 #
 # When you have multiple subplots, often you see labels of different
-# axes overlapping each other.
+# Axes overlapping each other.
 
 plt.close('all')
 
@@ -137,7 +137,7 @@ def example_plot(ax, fontsize=12):
 
 # %%
 # Although not thoroughly tested, it seems to work for subplots with
-# aspect != "auto" (e.g., axes with images).
+# aspect != "auto" (e.g., Axes with images).
 
 arr = np.arange(100).reshape((10, 10))
 
@@ -153,12 +153,12 @@ def example_plot(ax, fontsize=12):
 # Caveats
 # =======
 #
-# * `~matplotlib.pyplot.tight_layout` considers all artists on the axes by
+# * `~matplotlib.pyplot.tight_layout` considers all artists on the Axes by
 #   default.  To remove an artist from the layout calculation you can call
 #   `.Artist.set_in_layout`.
 #
 # * ``tight_layout`` assumes that the extra space needed for artists is
-#   independent of the original location of axes. This is often true, but there
+#   independent of the original location of Axes. This is often true, but there
 #   are rare cases where it is not.
 #
 # * ``pad=0`` can clip some texts by a few pixels. This may be a bug or
@@ -216,7 +216,7 @@ def example_plot(ax, fontsize=12):
 # Pre Matplotlib 2.2, legends and annotations were excluded from the bounding
 # box calculations that decide the layout.  Subsequently, these artists were
 # added to the calculation, but sometimes it is undesirable to include them.
-# For instance in this case it might be good to have the axes shrink a bit
+# For instance in this case it might be good to have the Axes shrink a bit
 # to make room for the legend:
 
 fig, ax = plt.subplots(figsize=(4, 3))
@@ -263,7 +263,7 @@ def example_plot(ax, fontsize=12):
 # ========
 #
 # If you create a colorbar with `.Figure.colorbar`, the created colorbar is
-# drawn in a Subplot as long as the parent axes is also a Subplot, so
+# drawn in a Subplot as long as the parent Axes is also a Subplot, so
 # `.Figure.tight_layout` will work.
 
 plt.close('all')
diff --git a/galleries/users_explain/customizing.py b/galleries/users_explain/customizing.py
index 58eccbcfa960..b0aaee03239e 100644
--- a/galleries/users_explain/customizing.py
+++ b/galleries/users_explain/customizing.py
@@ -210,7 +210,7 @@ def plotting_function():
 # Matplotlib uses :file:`matplotlibrc` configuration files to customize all
 # kinds of properties, which we call 'rc settings' or 'rc parameters'. You can
 # control the defaults of almost every property in Matplotlib: figure size and
-# DPI, line width, color and style, axes, axis and grid properties, text and
+# DPI, line width, color and style, Axes, axis and grid properties, text and
 # font properties and so on. The :file:`matplotlibrc` is read at startup to
 # configure Matplotlib. Matplotlib looks for :file:`matplotlibrc` in four
 # locations, in the following order:
diff --git a/galleries/users_explain/quick_start.py b/galleries/users_explain/quick_start.py
index 7cdd2b0b3208..cf5e73555e27 100644
--- a/galleries/users_explain/quick_start.py
+++ b/galleries/users_explain/quick_start.py
@@ -31,8 +31,8 @@
 # creating a Figure with an Axes is using `.pyplot.subplots`. We can then use
 # `.Axes.plot` to draw some data on the Axes:
 
-fig, ax = plt.subplots()  # Create a figure containing a single axes.
-ax.plot([1, 2, 3, 4], [1, 4, 2, 3])  # Plot some data on the axes.
+fig, ax = plt.subplots()  # Create a figure containing a single Axes.
+ax.plot([1, 2, 3, 4], [1, 4, 2, 3])  # Plot some data on the Axes.
 
 # %%
 #
@@ -62,7 +62,7 @@
 #    fig = plt.figure()  # an empty figure with no Axes
 #    fig, ax = plt.subplots()  # a figure with a single Axes
 #    fig, axs = plt.subplots(2, 2)  # a figure with a 2x2 grid of Axes
-#    # a figure with one axes on the left, and two on the right:
+#    # a figure with one Axes on the left, and two on the right:
 #    fig, axs = plt.subplot_mosaic([['left', 'right_top'],
 #                                   ['left', 'right_bottom']])
 #
@@ -170,12 +170,12 @@
 
 # Note that even in the OO-style, we use `.pyplot.figure` to create the Figure.
 fig, ax = plt.subplots(figsize=(5, 2.7), layout='constrained')
-ax.plot(x, x, label='linear')  # Plot some data on the axes.
-ax.plot(x, x**2, label='quadratic')  # Plot more data on the axes...
+ax.plot(x, x, label='linear')  # Plot some data on the Axes.
+ax.plot(x, x**2, label='quadratic')  # Plot more data on the Axes...
 ax.plot(x, x**3, label='cubic')  # ... and some more.
-ax.set_xlabel('x label')  # Add an x-label to the axes.
-ax.set_ylabel('y label')  # Add a y-label to the axes.
-ax.set_title("Simple Plot")  # Add a title to the axes.
+ax.set_xlabel('x label')  # Add an x-label to the Axes.
+ax.set_ylabel('y label')  # Add a y-label to the Axes.
+ax.set_title("Simple Plot")  # Add a title to the Axes.
 ax.legend()  # Add a legend.
 
 # %%
@@ -184,7 +184,7 @@
 x = np.linspace(0, 2, 100)  # Sample data.
 
 plt.figure(figsize=(5, 2.7), layout='constrained')
-plt.plot(x, x, label='linear')  # Plot some data on the (implicit) axes.
+plt.plot(x, x, label='linear')  # Plot some data on the (implicit) Axes.
 plt.plot(x, x**2, label='quadratic')  # etc.
 plt.plot(x, x**3, label='cubic')
 plt.xlabel('x label')
diff --git a/galleries/users_explain/text/annotations.py b/galleries/users_explain/text/annotations.py
index a28f5419a8ba..89787c4a6336 100644
--- a/galleries/users_explain/text/annotations.py
+++ b/galleries/users_explain/text/annotations.py
@@ -63,9 +63,9 @@
 # 'figure points'     points from the lower left corner of the figure
 # 'figure pixels'     pixels from the lower left corner of the figure
 # 'figure fraction'   (0, 0) is lower left of figure and (1, 1) is upper right
-# 'axes points'       points from lower left corner of axes
-# 'axes pixels'       pixels from lower left corner of axes
-# 'axes fraction'     (0, 0) is lower left of axes and (1, 1) is upper right
+# 'axes points'       points from lower left corner of the Axes
+# 'axes pixels'       pixels from lower left corner of the Axes
+# 'axes fraction'     (0, 0) is lower left of Axes and (1, 1) is upper right
 # 'data'              use the axes data coordinate system
 # ==================  ========================================================
 #
@@ -79,7 +79,7 @@
 # ==================  ========================================================
 #
 # For physical coordinate systems (points or pixels) the origin is the
-# bottom-left of the figure or axes. Points are
+# bottom-left of the figure or Axes. Points are
 # `typographic points <https://en.wikipedia.org/wiki/Point_(typography)>`_
 # meaning that they are a physical unit measuring 1/72 of an inch. Points and
 # pixels are discussed in further detail in :ref:`transforms-fig-scale-dpi`.
@@ -153,7 +153,7 @@
 # ==================== =====================================================
 #
 # In the example below, the *xy* point is in the data coordinate system
-# since *xycoords* defaults to 'data'. For a polar axes, this is in
+# since *xycoords* defaults to 'data'. For a polar Axes, this is in
 # (theta, radius) space. The text in this example is placed in the
 # fractional figure coordinate system. :class:`matplotlib.text.Text`
 # keyword arguments like *horizontalalignment*, *verticalalignment* and
@@ -505,7 +505,7 @@ def custom_box_style(x0, y0, width, height, mutation_size):
 #
 # The ellipse in the example below will have width and height
 # corresponding to 0.1 and 0.4 in data coordinates and will be
-# automatically scaled when the view limits of the axes change.
+# automatically scaled when the view limits of the Axes change.
 
 from matplotlib.patches import Ellipse
 from mpl_toolkits.axes_grid1.anchored_artists import AnchoredAuxTransformBox
@@ -517,7 +517,7 @@ def custom_box_style(x0, y0, width, height, mutation_size):
 ax.add_artist(box)
 
 # %%
-# Another method of anchoring an artist relative to a parent axes or anchor
+# Another method of anchoring an artist relative to a parent Axes or anchor
 # point is via the *bbox_to_anchor* argument of `.AnchoredOffsetbox`. This
 # artist can then be automatically positioned relative to another artist using
 # `.HPacker` and `.VPacker`:
@@ -580,7 +580,7 @@ def custom_box_style(x0, y0, width, height, mutation_size):
 
 # %%
 # Another commonly used `.Transform` instance is ``Axes.transData``. This
-# transform  is the coordinate system of the data plotted in the axes. In this
+# transform  is the coordinate system of the data plotted in the Axes. In this
 # example, it is used to draw an arrow between related data points in two
 # Axes. We have passed an empty text because in this case, the annotation
 # connects data points.
@@ -712,7 +712,7 @@ def custom_box_style(x0, y0, width, height, mutation_size):
 #
 # `.ConnectionPatch` is like an annotation without text. While `~.Axes.annotate`
 # is sufficient in most situations, `.ConnectionPatch` is useful when you want
-# to connect points in different axes. For example, here we connect the point
+# to connect points in different Axes. For example, here we connect the point
 # *xy* in the data coordinates of ``ax1`` to point *xy* in the data coordinates
 # of ``ax2``:
 
@@ -727,16 +727,16 @@ def custom_box_style(x0, y0, width, height, mutation_size):
 
 # %%
 # Here, we added the `.ConnectionPatch` to the *figure*
-# (with `~.Figure.add_artist`) rather than to either axes. This ensures that
-# the ConnectionPatch artist is drawn on top of both axes, and is also necessary
+# (with `~.Figure.add_artist`) rather than to either Axes. This ensures that
+# the ConnectionPatch artist is drawn on top of both Axes, and is also necessary
 # when using :ref:`constrained_layout <constrainedlayout_guide>`
-# for positioning the axes.
+# for positioning the Axes.
 #
 # Zoom effect between Axes
 # ^^^^^^^^^^^^^^^^^^^^^^^^
 #
 # `mpl_toolkits.axes_grid1.inset_locator` defines some patch classes useful for
-# interconnecting two axes.
+# interconnecting two Axes.
 #
 # .. figure:: /gallery/subplots_axes_and_figures/images/sphx_glr_axes_zoom_effect_001.png
 #    :target: /gallery/subplots_axes_and_figures/axes_zoom_effect.html
diff --git a/galleries/users_explain/text/text_props.py b/galleries/users_explain/text/text_props.py
index 20111f0775f5..c5ae22c02d38 100644
--- a/galleries/users_explain/text/text_props.py
+++ b/galleries/users_explain/text/text_props.py
@@ -59,8 +59,8 @@
 center or right justified.  Here is an example which uses the
 :func:`~matplotlib.pyplot.text` command to show the various alignment
 possibilities.  The use of ``transform=ax.transAxes`` throughout the
-code indicates that the coordinates are given relative to the axes
-bounding box, with (0, 0) being the lower left of the axes and (1, 1) the
+code indicates that the coordinates are given relative to the Axes
+bounding box, with (0, 0) being the lower left of the Axes and (1, 1) the
 upper right.
 """
 

From b7fe34dd4a2418bc3c4d83237150661489b9ac3e Mon Sep 17 00:00:00 2001
From: Cyril Gadal <cyril.gadal@imft.fr>
Date: Fri, 22 Dec 2023 10:41:03 +0100
Subject: [PATCH 0554/1120] Adding corresponding What's new entry

---
 doc/users/next_whats_new/subfigure_zorder.rst | 22 +++++++++++++++++++
 1 file changed, 22 insertions(+)
 create mode 100644 doc/users/next_whats_new/subfigure_zorder.rst

diff --git a/doc/users/next_whats_new/subfigure_zorder.rst b/doc/users/next_whats_new/subfigure_zorder.rst
new file mode 100644
index 000000000000..a740bbda8eb6
--- /dev/null
+++ b/doc/users/next_whats_new/subfigure_zorder.rst
@@ -0,0 +1,22 @@
+Subfigures have now controllable zorders
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Previously, setting the zorder of a subfigure had no effect, and those were plotted on top of any figure-level artists (i.e for example on top of fig-level legends). Now, subfigures behave like any other artists, and their zorder can be controlled, with default a zorder of 0.
+
+.. plot::
+    :include-source: true
+    :alt: Example on controlling the zorder of a subfigure
+
+    import matplotlib.pyplot as plt
+    import numpy as np
+    x = np.linspace(1, 10, 10)
+    y1, y2 = x, -x
+    fig = plt.figure(constrained_layout=True)
+    subfigs = fig.subfigures(nrows=1, ncols=2)
+    for subfig in subfigs:
+        axarr = subfig.subplots(2, 1)
+        for ax in axarr.flatten():
+            (l1,) = ax.plot(x, y1, label="line1")
+            (l2,) = ax.plot(x, y2, label="line2")
+    subfigs[0].set_zorder(6)
+    l = fig.legend(handles=[l1, l2], loc="upper center", ncol=2)

From 512da1cfa44841380cc1f922aeb7ba03a66d9bd3 Mon Sep 17 00:00:00 2001
From: Cyril Gadal <cyril.gadal@imft.fr>
Date: Fri, 22 Dec 2023 11:11:10 +0100
Subject: [PATCH 0555/1120] Modify test_figure.py::test_subfigure to check for
 draw zorder

---
 .../test_figure/test_subfigure.png            | Bin 62551 -> 63233 bytes
 lib/matplotlib/tests/test_figure.py           |   6 ++++++
 2 files changed, 6 insertions(+)

diff --git a/lib/matplotlib/tests/baseline_images/test_figure/test_subfigure.png b/lib/matplotlib/tests/baseline_images/test_figure/test_subfigure.png
index 17dfea29d844de1101a0b7ac64f0ad1e65d4c10e..bcfc4494b9444fda85297520e9fdaee77fdfa876 100644
GIT binary patch
literal 63233
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

literal 62551
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
UuM=KTqToYWLF0OX+^u{61^K|8Q~&?~

diff --git a/lib/matplotlib/tests/test_figure.py b/lib/matplotlib/tests/test_figure.py
index 0e1706f37b59..c3d177425723 100644
--- a/lib/matplotlib/tests/test_figure.py
+++ b/lib/matplotlib/tests/test_figure.py
@@ -1286,6 +1286,12 @@ def test_subfigure():
 
     fig.suptitle('Figure suptitle', fontsize='xx-large')
 
+    # below tests for the draw zorder of subfigures.
+    leg = fig.legend(handles=[plt.Line2D([0], [0], label='Line{}'.format(i))
+                     for i in range(5)], loc='center')
+    sub[0].set_zorder(leg.get_zorder() - 1)
+    sub[1].set_zorder(leg.get_zorder() + 1)
+
 
 def test_subfigure_tightbbox():
     # test that we can get the tightbbox with a subfigure...

From b96f272bf0e12a8ff8c997db3ac8d709be419439 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Mon, 25 Dec 2023 17:24:01 -0500
Subject: [PATCH 0556/1120] changed plot type to plot-type

---
 doc/devel/tag_glossary.rst                     | 18 +++++++++---------
 .../multiple_figs_demo.py                      |  2 +-
 2 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/doc/devel/tag_glossary.rst b/doc/devel/tag_glossary.rst
index 9b70a2a96159..9a53de6358c8 100644
--- a/doc/devel/tag_glossary.rst
+++ b/doc/devel/tag_glossary.rst
@@ -94,21 +94,21 @@ API tags: what content from the API reference is in the example?
 +-----------------------------------+---------------------------------------------+
 |**Plot Type**                                                                    |
 +-----------------------------------+---------------------------------------------+
-|``plot type: bar``                 |example contains a bar plot                  |
+|``plot-type: bar``                 |example contains a bar plot                  |
 +-----------------------------------+---------------------------------------------+
-|``plot type: line``                |example contains a line plot                 |
+|``plot-type: line``                |example contains a line plot                 |
 +-----------------------------------+---------------------------------------------+
-|``plot type: pie``                 |example contains a pie plot                  |
+|``plot-type: pie``                 |example contains a pie plot                  |
 +-----------------------------------+---------------------------------------------+
-|``plot type: polar``               |example contains a polar plot                |
+|``plot-type: polar``               |example contains a polar plot                |
 +-----------------------------------+---------------------------------------------+
-|``plot type: 3D``                  |example contains a 3D plot                   |
+|``plot-type: 3D``                  |example contains a 3D plot                   |
 +-----------------------------------+---------------------------------------------+
-|``plot type: histogram``           |example contains a histogram                 |
+|``plot-type: histogram``           |example contains a histogram                 |
 +-----------------------------------+---------------------------------------------+
-|``plot type: specialty``           |                                             |
+|``plot-type: specialty``           |                                             |
 +-----------------------------------+---------------------------------------------+
-|``plot type: scatter``             |                                             |
+|``plot-type: scatter``             |                                             |
 +-----------------------------------+---------------------------------------------+
 
 
@@ -166,7 +166,7 @@ Internal tags: what information is helpful for maintainers or contributors?
 +-------------------------------+-----------------------------------------------------------------------+
 |``tag``                        | use case                                                              |
 +===============================+=======================================================================+
-|``internal: low bandwidth``    |allows users to filter out bandwidth-intensive examples like animations|
+|``internal: high-bandwidth``   |allows users to filter out bandwidth-intensive examples like animations|
 +-------------------------------+-----------------------------------------------------------------------+
 |``internal: untagged``         |allows docs contributors to easily find untagged examples              |
 +-------------------------------+-----------------------------------------------------------------------+
diff --git a/galleries/examples/subplots_axes_and_figures/multiple_figs_demo.py b/galleries/examples/subplots_axes_and_figures/multiple_figs_demo.py
index 883cf075dfd2..d6b6a5ed48c6 100644
--- a/galleries/examples/subplots_axes_and_figures/multiple_figs_demo.py
+++ b/galleries/examples/subplots_axes_and_figures/multiple_figs_demo.py
@@ -51,4 +51,4 @@
 plt.show()
 
 # %%
-# .. tags:: component: figure, plot type: line
+# .. tags:: component: figure, plot-type: line

From 82e5abfb4619570d5196ce2312638bd81ac87a94 Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Thu, 28 Dec 2023 16:12:46 +0000
Subject: [PATCH 0557/1120] Add quotes round .[dev] in editable install cmd

---
 doc/devel/development_setup.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/devel/development_setup.rst b/doc/devel/development_setup.rst
index 6e24c085829d..15d2b2ae2e2f 100644
--- a/doc/devel/development_setup.rst
+++ b/doc/devel/development_setup.rst
@@ -174,7 +174,7 @@ Install Matplotlib in editable mode
 Install Matplotlib in editable mode from the :file:`matplotlib` directory using the
 command ::
 
-    python -m pip install --verbose --no-build-isolation --editable .[dev]
+    python -m pip install --verbose --no-build-isolation --editable ".[dev]"
 
 The 'editable/develop mode' builds everything and places links in your Python environment
 so that Python will be able to import Matplotlib from your development source directory.

From 265e49ebe3bd3a10979b55b54101eda5676506b6 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Thu, 28 Dec 2023 12:00:19 -0500
Subject: [PATCH 0558/1120] MNT: add the running version to pickle warning
 message

---
 lib/matplotlib/figure.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
index dd76c932b01e..a3b396c8b834 100644
--- a/lib/matplotlib/figure.py
+++ b/lib/matplotlib/figure.py
@@ -3168,8 +3168,8 @@ def __setstate__(self, state):
         if version != mpl.__version__:
             _api.warn_external(
                 f"This figure was saved with matplotlib version {version} and "
-                f"is unlikely to function correctly.")
-
+                f"loaded with {mpl.__version__} so is unlikely to function correctly."
+            )
         self.__dict__ = state
 
         # re-initialise some of the unstored state information

From b4482098a8068d691cb3049e858f8d65a0546872 Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Sun, 1 Jan 2023 19:24:38 +0000
Subject: [PATCH 0559/1120] Deprecated _apply_theta_transforms=True

---
 doc/api/next_api_changes/deprecations/24834-DS.rst    |  6 ++++++
 lib/matplotlib/projections/polar.py                   | 11 +++++++++++
 lib/matplotlib/text.py                                |  2 +-
 .../axisartist/tests/test_floating_axes.py            |  4 ++--
 .../axisartist/tests/test_grid_helper_curvelinear.py  |  6 ++++--
 5 files changed, 24 insertions(+), 5 deletions(-)
 create mode 100644 doc/api/next_api_changes/deprecations/24834-DS.rst

diff --git a/doc/api/next_api_changes/deprecations/24834-DS.rst b/doc/api/next_api_changes/deprecations/24834-DS.rst
new file mode 100644
index 000000000000..fd6b954d2396
--- /dev/null
+++ b/doc/api/next_api_changes/deprecations/24834-DS.rst
@@ -0,0 +1,6 @@
+Applying theta transforms in ``PolarTransform``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Applying theta transforms in `~matplotlib.projections.polar.PolarTransform`
+is deprecated. This is currently the default behaviour, so to prevent
+a warning, manually pass ``_apply_theta_transforms=False``, and
+apply any theta shift before passing points to this transform.
diff --git a/lib/matplotlib/projections/polar.py b/lib/matplotlib/projections/polar.py
index 25338bca021f..22badf0c7eca 100644
--- a/lib/matplotlib/projections/polar.py
+++ b/lib/matplotlib/projections/polar.py
@@ -52,6 +52,17 @@ def __init__(self, axis=None, use_rmin=True,
         self._use_rmin = use_rmin
         self._apply_theta_transforms = _apply_theta_transforms
         self._scale_transform = scale_transform
+        if _apply_theta_transforms:
+            _api.warn_deprecated(
+                "3.7",
+                message=(
+                    "Passing `_apply_theta_transforms=True` (the default) "
+                    "is deprecated. Support for this will be removed in "
+                    "Matplotlib %(removal)s. To prevent this warning, "
+                    "set `_apply_theta_transforms=False`, and make sure to "
+                    "shift theta values before being passed to this transform."
+                )
+            )
 
     __str__ = mtransforms._make_str_method(
         "_axis",
diff --git a/lib/matplotlib/text.py b/lib/matplotlib/text.py
index 8734131dddc9..08109c278372 100644
--- a/lib/matplotlib/text.py
+++ b/lib/matplotlib/text.py
@@ -1497,7 +1497,7 @@ def _get_xy_transform(self, renderer, coords):
             return self.axes.transData
         elif coords == 'polar':
             from matplotlib.projections import PolarAxes
-            tr = PolarAxes.PolarTransform()
+            tr = PolarAxes.PolarTransform(_apply_theta_transforms=False)
             trans = tr + self.axes.transData
             return trans
 
diff --git a/lib/mpl_toolkits/axisartist/tests/test_floating_axes.py b/lib/mpl_toolkits/axisartist/tests/test_floating_axes.py
index 31dcf24bb22d..128f97a774f2 100644
--- a/lib/mpl_toolkits/axisartist/tests/test_floating_axes.py
+++ b/lib/mpl_toolkits/axisartist/tests/test_floating_axes.py
@@ -24,7 +24,7 @@ def test_curvelinear3():
     fig = plt.figure(figsize=(5, 5))
 
     tr = (mtransforms.Affine2D().scale(np.pi / 180, 1) +
-          mprojections.PolarAxes.PolarTransform())
+          mprojections.PolarAxes.PolarTransform(_apply_theta_transforms=False))
     grid_helper = GridHelperCurveLinear(
         tr,
         extremes=(0, 360, 10, 3),
@@ -73,7 +73,7 @@ def test_curvelinear4():
     fig = plt.figure(figsize=(5, 5))
 
     tr = (mtransforms.Affine2D().scale(np.pi / 180, 1) +
-          mprojections.PolarAxes.PolarTransform())
+          mprojections.PolarAxes.PolarTransform(_apply_theta_transforms=False))
     grid_helper = GridHelperCurveLinear(
         tr,
         extremes=(120, 30, 10, 0),
diff --git a/lib/mpl_toolkits/axisartist/tests/test_grid_helper_curvelinear.py b/lib/mpl_toolkits/axisartist/tests/test_grid_helper_curvelinear.py
index eb7673fa1fa7..9da862776e82 100644
--- a/lib/mpl_toolkits/axisartist/tests/test_grid_helper_curvelinear.py
+++ b/lib/mpl_toolkits/axisartist/tests/test_grid_helper_curvelinear.py
@@ -82,7 +82,8 @@ def test_polar_box():
 
     # PolarAxes.PolarTransform takes radian. However, we want our coordinate
     # system in degree
-    tr = Affine2D().scale(np.pi / 180., 1.) + PolarAxes.PolarTransform()
+    tr = (Affine2D().scale(np.pi / 180., 1.) +
+          PolarAxes.PolarTransform(_apply_theta_transforms=False))
 
     # polar projection, which involves cycle, and also has limits in
     # its coordinates, needs a special method to find the extremes
@@ -144,7 +145,8 @@ def test_axis_direction():
 
     # PolarAxes.PolarTransform takes radian. However, we want our coordinate
     # system in degree
-    tr = Affine2D().scale(np.pi / 180., 1.) + PolarAxes.PolarTransform()
+    tr = (Affine2D().scale(np.pi / 180., 1.) +
+          PolarAxes.PolarTransform(_apply_theta_transforms=False))
 
     # polar projection, which involves cycle, and also has limits in
     # its coordinates, needs a special method to find the extremes

From 2c91f982853c1e8df3ac2e68a26170933621356b Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Sun, 8 Jan 2023 15:24:25 +0000
Subject: [PATCH 0560/1120] Deprecate in InvertedPolarTransform

---
 .../deprecations/24834-DS.rst                 |  1 +
 lib/matplotlib/projections/polar.py           | 26 ++++++++++++-------
 2 files changed, 17 insertions(+), 10 deletions(-)

diff --git a/doc/api/next_api_changes/deprecations/24834-DS.rst b/doc/api/next_api_changes/deprecations/24834-DS.rst
index fd6b954d2396..358fa632c5aa 100644
--- a/doc/api/next_api_changes/deprecations/24834-DS.rst
+++ b/doc/api/next_api_changes/deprecations/24834-DS.rst
@@ -1,6 +1,7 @@
 Applying theta transforms in ``PolarTransform``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 Applying theta transforms in `~matplotlib.projections.polar.PolarTransform`
+and `~matplotlib.projections.polar.InvertedPolarTransform`
 is deprecated. This is currently the default behaviour, so to prevent
 a warning, manually pass ``_apply_theta_transforms=False``, and
 apply any theta shift before passing points to this transform.
diff --git a/lib/matplotlib/projections/polar.py b/lib/matplotlib/projections/polar.py
index 22badf0c7eca..f9eaa5f1a815 100644
--- a/lib/matplotlib/projections/polar.py
+++ b/lib/matplotlib/projections/polar.py
@@ -15,6 +15,19 @@
 from matplotlib.spines import Spine
 
 
+def _apply_theta_transforms_warn():
+    _api.warn_deprecated(
+                "3.7",
+                message=(
+                    "Passing `_apply_theta_transforms=True` (the default) "
+                    "is deprecated. Support for this will be removed in "
+                    "Matplotlib %(removal)s. To prevent this warning, "
+                    "set `_apply_theta_transforms=False`, and make sure to "
+                    "shift theta values before being passed to this transform."
+                )
+            )
+
+
 class PolarTransform(mtransforms.Transform):
     r"""
     The base polar transform.
@@ -53,16 +66,7 @@ def __init__(self, axis=None, use_rmin=True,
         self._apply_theta_transforms = _apply_theta_transforms
         self._scale_transform = scale_transform
         if _apply_theta_transforms:
-            _api.warn_deprecated(
-                "3.7",
-                message=(
-                    "Passing `_apply_theta_transforms=True` (the default) "
-                    "is deprecated. Support for this will be removed in "
-                    "Matplotlib %(removal)s. To prevent this warning, "
-                    "set `_apply_theta_transforms=False`, and make sure to "
-                    "shift theta values before being passed to this transform."
-                )
-            )
+            _apply_theta_transforms_warn()
 
     __str__ = mtransforms._make_str_method(
         "_axis",
@@ -220,6 +224,8 @@ def __init__(self, axis=None, use_rmin=True,
         self._axis = axis
         self._use_rmin = use_rmin
         self._apply_theta_transforms = _apply_theta_transforms
+        if _apply_theta_transforms:
+            _apply_theta_transforms_warn()
 
     __str__ = mtransforms._make_str_method(
         "_axis",

From c57d8e198070afbd917ac9118bbfa03d178f4d5b Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Thu, 28 Dec 2023 17:40:54 +0000
Subject: [PATCH 0561/1120] Fix polar labels with negative theta limit

---
 lib/matplotlib/projections/polar.py | 2 +-
 lib/matplotlib/tests/test_polar.py  | 8 ++++++++
 2 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/projections/polar.py b/lib/matplotlib/projections/polar.py
index 25338bca021f..0da68257b520 100644
--- a/lib/matplotlib/projections/polar.py
+++ b/lib/matplotlib/projections/polar.py
@@ -298,7 +298,7 @@ def set_axis(self, axis):
     def __call__(self):
         lim = self.axis.get_view_interval()
         if _is_full_circle_deg(lim[0], lim[1]):
-            return np.arange(8) * 2 * np.pi / 8
+            return np.deg2rad(min(lim)) + np.arange(8) * 2 * np.pi / 8
         else:
             return np.deg2rad(self.base())
 
diff --git a/lib/matplotlib/tests/test_polar.py b/lib/matplotlib/tests/test_polar.py
index 9d6e78da2cbc..9a1c6be6fcff 100644
--- a/lib/matplotlib/tests/test_polar.py
+++ b/lib/matplotlib/tests/test_polar.py
@@ -446,3 +446,11 @@ def test_polar_log():
 
     n = 100
     ax.plot(np.linspace(0, 2 * np.pi, n), np.logspace(0, 2, n))
+
+
+def test_polar_neg_theta_lims():
+    fig = plt.figure()
+    ax = fig.add_subplot(projection='polar')
+    ax.set_thetalim(-np.pi, np.pi)
+    labels = [l.get_text() for l in ax.xaxis.get_ticklabels()]
+    assert labels == ['-180°', '-135°', '-90°', '-45°', '0°', '45°', '90°', '135°']

From 27971aae3cb6c0fb49ddae5c08689d98329f6fb8 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Thu, 28 Dec 2023 14:05:24 -0500
Subject: [PATCH 0562/1120] CI: install German lanugage packs an ubuntu test
 runners

Increase coverage of locale tests.
---
 .github/workflows/tests.yml | 1 +
 azure-pipelines.yml         | 1 +
 2 files changed, 2 insertions(+)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index e0869b2c05f0..80a6d90527ad 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -119,6 +119,7 @@ jobs:
               gir1.2-gtk-3.0 \
               graphviz \
               inkscape \
+              language-pack-de \
               lcov \
               libcairo2 \
               libcairo2-dev \
diff --git a/azure-pipelines.yml b/azure-pipelines.yml
index 44adc6f08422..52c82a887a47 100644
--- a/azure-pipelines.yml
+++ b/azure-pipelines.yml
@@ -103,6 +103,7 @@ stages:
               gir1.2-gtk-3.0 \
               graphviz \
               inkscape \
+              language-pack-de \
               lcov \
               libcairo2 \
               libgirepository-1.0-1 \

From 1e671bb62928ee898fc317214a3231d0ef338367 Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Sun, 8 Jan 2023 15:30:03 +0000
Subject: [PATCH 0563/1120] Fix warnings in examples

Fix example
---
 galleries/examples/axisartist/demo_axis_direction.py   | 5 ++++-
 galleries/examples/axisartist/demo_curvelinear_grid.py | 3 ++-
 galleries/examples/axisartist/demo_floating_axes.py    | 5 +++--
 galleries/examples/axisartist/demo_floating_axis.py    | 3 ++-
 galleries/examples/axisartist/simple_axis_pad.py       | 3 ++-
 5 files changed, 13 insertions(+), 6 deletions(-)

diff --git a/galleries/examples/axisartist/demo_axis_direction.py b/galleries/examples/axisartist/demo_axis_direction.py
index 00ba40004a59..8c57b6c5a351 100644
--- a/galleries/examples/axisartist/demo_axis_direction.py
+++ b/galleries/examples/axisartist/demo_axis_direction.py
@@ -20,7 +20,10 @@ def setup_axes(fig, rect):
     """Polar projection, but in a rectangular box."""
     # see demo_curvelinear_grid.py for details
     grid_helper = GridHelperCurveLinear(
-        Affine2D().scale(np.pi/180., 1.) + PolarAxes.PolarTransform(),
+        (
+            Affine2D().scale(np.pi/180., 1.) +
+            PolarAxes.PolarTransform(apply_theta_transforms=False)
+        ),
         extreme_finder=angle_helper.ExtremeFinderCycle(
             20, 20,
             lon_cycle=360, lat_cycle=None,
diff --git a/galleries/examples/axisartist/demo_curvelinear_grid.py b/galleries/examples/axisartist/demo_curvelinear_grid.py
index fb1fbdd011ce..fd878b456e10 100644
--- a/galleries/examples/axisartist/demo_curvelinear_grid.py
+++ b/galleries/examples/axisartist/demo_curvelinear_grid.py
@@ -54,7 +54,8 @@ def curvelinear_test2(fig):
 
     # PolarAxes.PolarTransform takes radian. However, we want our coordinate
     # system in degree
-    tr = Affine2D().scale(np.pi/180, 1) + PolarAxes.PolarTransform()
+    tr = Affine2D().scale(np.pi/180, 1) + PolarAxes.PolarTransform(
+        _apply_theta_transforms=False)
     # Polar projection, which involves cycle, and also has limits in
     # its coordinates, needs a special method to find the extremes
     # (min, max of the coordinate within the view).
diff --git a/galleries/examples/axisartist/demo_floating_axes.py b/galleries/examples/axisartist/demo_floating_axes.py
index add03e266d3e..7a12612a8a15 100644
--- a/galleries/examples/axisartist/demo_floating_axes.py
+++ b/galleries/examples/axisartist/demo_floating_axes.py
@@ -54,7 +54,7 @@ def setup_axes2(fig, rect):
     With custom locator and formatter.
     Note that the extreme values are swapped.
     """
-    tr = PolarAxes.PolarTransform()
+    tr = PolarAxes.PolarTransform(_apply_theta_transforms=False)
 
     pi = np.pi
     angle_ticks = [(0, r"$0$"),
@@ -99,7 +99,8 @@ def setup_axes3(fig, rect):
     # scale degree to radians
     tr_scale = Affine2D().scale(np.pi/180., 1.)
 
-    tr = tr_rotate + tr_scale + PolarAxes.PolarTransform()
+    tr = tr_rotate + tr_scale + PolarAxes.PolarTransform(
+        _apply_theta_transforms=False)
 
     grid_locator1 = angle_helper.LocatorHMS(4)
     tick_formatter1 = angle_helper.FormatterHMS()
diff --git a/galleries/examples/axisartist/demo_floating_axis.py b/galleries/examples/axisartist/demo_floating_axis.py
index 0894bf8f4ce1..1dc2999a7aea 100644
--- a/galleries/examples/axisartist/demo_floating_axis.py
+++ b/galleries/examples/axisartist/demo_floating_axis.py
@@ -22,7 +22,8 @@
 def curvelinear_test2(fig):
     """Polar projection, but in a rectangular box."""
     # see demo_curvelinear_grid.py for details
-    tr = Affine2D().scale(np.pi / 180., 1.) + PolarAxes.PolarTransform()
+    tr = Affine2D().scale(np.pi / 180., 1.) + PolarAxes.PolarTransform(
+        _apply_theta_transforms=False)
 
     extreme_finder = angle_helper.ExtremeFinderCycle(20,
                                                      20,
diff --git a/galleries/examples/axisartist/simple_axis_pad.py b/galleries/examples/axisartist/simple_axis_pad.py
index 7027a88d3549..99c96701caf3 100644
--- a/galleries/examples/axisartist/simple_axis_pad.py
+++ b/galleries/examples/axisartist/simple_axis_pad.py
@@ -21,7 +21,8 @@ def setup_axes(fig, rect):
     """Polar projection, but in a rectangular box."""
 
     # see demo_curvelinear_grid.py for details
-    tr = Affine2D().scale(np.pi/180., 1.) + PolarAxes.PolarTransform()
+    tr = Affine2D().scale(np.pi/180., 1.) + PolarAxes.PolarTransform(
+        _apply_theta_transforms=False)
 
     extreme_finder = angle_helper.ExtremeFinderCycle(20, 20,
                                                      lon_cycle=360,

From 10453dbde447855e13388d902f65a3afbb24d9c8 Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Sat, 18 Feb 2023 09:08:25 +0000
Subject: [PATCH 0564/1120] Make _apply_theta_transforms public

---
 .../deprecations/24834-DS.rst                 | 15 ++++++--
 .../axisartist/demo_curvelinear_grid.py       |  2 +-
 .../examples/axisartist/demo_floating_axes.py |  4 +--
 .../examples/axisartist/demo_floating_axis.py |  2 +-
 .../examples/axisartist/simple_axis_pad.py    |  2 +-
 lib/matplotlib/projections/polar.py           | 36 ++++++++++---------
 lib/matplotlib/tests/test_transforms.py       |  2 +-
 lib/matplotlib/text.py                        |  2 +-
 .../axisartist/tests/test_floating_axes.py    |  4 +--
 .../tests/test_grid_helper_curvelinear.py     |  4 +--
 10 files changed, 43 insertions(+), 30 deletions(-)

diff --git a/doc/api/next_api_changes/deprecations/24834-DS.rst b/doc/api/next_api_changes/deprecations/24834-DS.rst
index 358fa632c5aa..ef7132c7d6d7 100644
--- a/doc/api/next_api_changes/deprecations/24834-DS.rst
+++ b/doc/api/next_api_changes/deprecations/24834-DS.rst
@@ -2,6 +2,15 @@ Applying theta transforms in ``PolarTransform``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 Applying theta transforms in `~matplotlib.projections.polar.PolarTransform`
 and `~matplotlib.projections.polar.InvertedPolarTransform`
-is deprecated. This is currently the default behaviour, so to prevent
-a warning, manually pass ``_apply_theta_transforms=False``, and
-apply any theta shift before passing points to this transform.
+is deprecated, and will be removed in a future version of Matplotlib. This
+is currently the default behaviour when these transforms are used externally,
+but only takes affect when:
+
+- An axis is associated with the transform.
+- The axis has a non-zero theta offset or has theta values increasing in
+  a clockwise direction.
+
+To silence this warning and adopt future behaviour,
+set ``apply_theta_transforms=False``. If you need to retain the behaviour
+where theta values are transformed, chain the ``PolarTransform`` with
+another transform that performs the theta shift and/or sign shift.
diff --git a/galleries/examples/axisartist/demo_curvelinear_grid.py b/galleries/examples/axisartist/demo_curvelinear_grid.py
index fd878b456e10..40853dee12cb 100644
--- a/galleries/examples/axisartist/demo_curvelinear_grid.py
+++ b/galleries/examples/axisartist/demo_curvelinear_grid.py
@@ -55,7 +55,7 @@ def curvelinear_test2(fig):
     # PolarAxes.PolarTransform takes radian. However, we want our coordinate
     # system in degree
     tr = Affine2D().scale(np.pi/180, 1) + PolarAxes.PolarTransform(
-        _apply_theta_transforms=False)
+        apply_theta_transforms=False)
     # Polar projection, which involves cycle, and also has limits in
     # its coordinates, needs a special method to find the extremes
     # (min, max of the coordinate within the view).
diff --git a/galleries/examples/axisartist/demo_floating_axes.py b/galleries/examples/axisartist/demo_floating_axes.py
index 7a12612a8a15..632f6d237aa6 100644
--- a/galleries/examples/axisartist/demo_floating_axes.py
+++ b/galleries/examples/axisartist/demo_floating_axes.py
@@ -54,7 +54,7 @@ def setup_axes2(fig, rect):
     With custom locator and formatter.
     Note that the extreme values are swapped.
     """
-    tr = PolarAxes.PolarTransform(_apply_theta_transforms=False)
+    tr = PolarAxes.PolarTransform(apply_theta_transforms=False)
 
     pi = np.pi
     angle_ticks = [(0, r"$0$"),
@@ -100,7 +100,7 @@ def setup_axes3(fig, rect):
     tr_scale = Affine2D().scale(np.pi/180., 1.)
 
     tr = tr_rotate + tr_scale + PolarAxes.PolarTransform(
-        _apply_theta_transforms=False)
+        apply_theta_transforms=False)
 
     grid_locator1 = angle_helper.LocatorHMS(4)
     tick_formatter1 = angle_helper.FormatterHMS()
diff --git a/galleries/examples/axisartist/demo_floating_axis.py b/galleries/examples/axisartist/demo_floating_axis.py
index 1dc2999a7aea..5296b682367b 100644
--- a/galleries/examples/axisartist/demo_floating_axis.py
+++ b/galleries/examples/axisartist/demo_floating_axis.py
@@ -23,7 +23,7 @@ def curvelinear_test2(fig):
     """Polar projection, but in a rectangular box."""
     # see demo_curvelinear_grid.py for details
     tr = Affine2D().scale(np.pi / 180., 1.) + PolarAxes.PolarTransform(
-        _apply_theta_transforms=False)
+        apply_theta_transforms=False)
 
     extreme_finder = angle_helper.ExtremeFinderCycle(20,
                                                      20,
diff --git a/galleries/examples/axisartist/simple_axis_pad.py b/galleries/examples/axisartist/simple_axis_pad.py
index 99c96701caf3..9c613c820b2b 100644
--- a/galleries/examples/axisartist/simple_axis_pad.py
+++ b/galleries/examples/axisartist/simple_axis_pad.py
@@ -22,7 +22,7 @@ def setup_axes(fig, rect):
 
     # see demo_curvelinear_grid.py for details
     tr = Affine2D().scale(np.pi/180., 1.) + PolarAxes.PolarTransform(
-        _apply_theta_transforms=False)
+        apply_theta_transforms=False)
 
     extreme_finder = angle_helper.ExtremeFinderCycle(20, 20,
                                                      lon_cycle=360,
diff --git a/lib/matplotlib/projections/polar.py b/lib/matplotlib/projections/polar.py
index f9eaa5f1a815..726b0ee3901b 100644
--- a/lib/matplotlib/projections/polar.py
+++ b/lib/matplotlib/projections/polar.py
@@ -19,10 +19,10 @@ def _apply_theta_transforms_warn():
     _api.warn_deprecated(
                 "3.7",
                 message=(
-                    "Passing `_apply_theta_transforms=True` (the default) "
+                    "Passing `apply_theta_transforms=True` (the default) "
                     "is deprecated. Support for this will be removed in "
                     "Matplotlib %(removal)s. To prevent this warning, "
-                    "set `_apply_theta_transforms=False`, and make sure to "
+                    "set `apply_theta_transforms=False`, and make sure to "
                     "shift theta values before being passed to this transform."
                 )
             )
@@ -47,8 +47,8 @@ class PolarTransform(mtransforms.Transform):
 
     input_dims = output_dims = 2
 
-    def __init__(self, axis=None, use_rmin=True,
-                 _apply_theta_transforms=True, *, scale_transform=None):
+    def __init__(self, axis=None, use_rmin=True, *,
+                 apply_theta_transforms=True, scale_transform=None):
         """
         Parameters
         ----------
@@ -63,15 +63,15 @@ def __init__(self, axis=None, use_rmin=True,
         super().__init__()
         self._axis = axis
         self._use_rmin = use_rmin
-        self._apply_theta_transforms = _apply_theta_transforms
+        self._apply_theta_transforms = apply_theta_transforms
         self._scale_transform = scale_transform
-        if _apply_theta_transforms:
+        if apply_theta_transforms:
             _apply_theta_transforms_warn()
 
     __str__ = mtransforms._make_str_method(
         "_axis",
         use_rmin="_use_rmin",
-        _apply_theta_transforms="_apply_theta_transforms")
+        apply_theta_transforms="_apply_theta_transforms")
 
     def _get_rorigin(self):
         # Get lower r limit after being scaled by the radial scale transform
@@ -148,8 +148,10 @@ def transform_path_non_affine(self, path):
 
     def inverted(self):
         # docstring inherited
-        return PolarAxes.InvertedPolarTransform(self._axis, self._use_rmin,
-                                                self._apply_theta_transforms)
+        return PolarAxes.InvertedPolarTransform(
+            self._axis, self._use_rmin,
+            apply_theta_transforms=self._apply_theta_transforms
+        )
 
 
 class PolarAffine(mtransforms.Affine2DBase):
@@ -208,7 +210,7 @@ class InvertedPolarTransform(mtransforms.Transform):
     input_dims = output_dims = 2
 
     def __init__(self, axis=None, use_rmin=True,
-                 _apply_theta_transforms=True):
+                 *, apply_theta_transforms=True):
         """
         Parameters
         ----------
@@ -223,14 +225,14 @@ def __init__(self, axis=None, use_rmin=True,
         super().__init__()
         self._axis = axis
         self._use_rmin = use_rmin
-        self._apply_theta_transforms = _apply_theta_transforms
-        if _apply_theta_transforms:
+        self._apply_theta_transforms = apply_theta_transforms
+        if apply_theta_transforms:
             _apply_theta_transforms_warn()
 
     __str__ = mtransforms._make_str_method(
         "_axis",
         use_rmin="_use_rmin",
-        _apply_theta_transforms="_apply_theta_transforms")
+        apply_theta_transforms="_apply_theta_transforms")
 
     @_api.rename_parameter("3.8", "xy", "values")
     def transform_non_affine(self, values):
@@ -251,8 +253,10 @@ def transform_non_affine(self, values):
 
     def inverted(self):
         # docstring inherited
-        return PolarAxes.PolarTransform(self._axis, self._use_rmin,
-                                        self._apply_theta_transforms)
+        return PolarAxes.PolarTransform(
+            self._axis, self._use_rmin,
+            apply_theta_transforms=self._apply_theta_transforms
+        )
 
 
 class ThetaFormatter(mticker.Formatter):
@@ -896,7 +900,7 @@ def _set_lim_and_transforms(self):
         # data.  This one is aware of rmin
         self.transProjection = self.PolarTransform(
             self,
-            _apply_theta_transforms=False,
+            apply_theta_transforms=False,
             scale_transform=self.transScale
         )
         # Add dependency on rorigin.
diff --git a/lib/matplotlib/tests/test_transforms.py b/lib/matplotlib/tests/test_transforms.py
index 95e76ad95c4f..959814de82db 100644
--- a/lib/matplotlib/tests/test_transforms.py
+++ b/lib/matplotlib/tests/test_transforms.py
@@ -859,7 +859,7 @@ def test_str_transform():
         PolarTransform(
             PolarAxes(0.125,0.1;0.775x0.8),
             use_rmin=True,
-            _apply_theta_transforms=False)),
+            apply_theta_transforms=False)),
     CompositeGenericTransform(
         CompositeGenericTransform(
             PolarAffine(
diff --git a/lib/matplotlib/text.py b/lib/matplotlib/text.py
index 08109c278372..dcf1b7558b9f 100644
--- a/lib/matplotlib/text.py
+++ b/lib/matplotlib/text.py
@@ -1497,7 +1497,7 @@ def _get_xy_transform(self, renderer, coords):
             return self.axes.transData
         elif coords == 'polar':
             from matplotlib.projections import PolarAxes
-            tr = PolarAxes.PolarTransform(_apply_theta_transforms=False)
+            tr = PolarAxes.PolarTransform(apply_theta_transforms=False)
             trans = tr + self.axes.transData
             return trans
 
diff --git a/lib/mpl_toolkits/axisartist/tests/test_floating_axes.py b/lib/mpl_toolkits/axisartist/tests/test_floating_axes.py
index 128f97a774f2..7644fea16965 100644
--- a/lib/mpl_toolkits/axisartist/tests/test_floating_axes.py
+++ b/lib/mpl_toolkits/axisartist/tests/test_floating_axes.py
@@ -24,7 +24,7 @@ def test_curvelinear3():
     fig = plt.figure(figsize=(5, 5))
 
     tr = (mtransforms.Affine2D().scale(np.pi / 180, 1) +
-          mprojections.PolarAxes.PolarTransform(_apply_theta_transforms=False))
+          mprojections.PolarAxes.PolarTransform(apply_theta_transforms=False))
     grid_helper = GridHelperCurveLinear(
         tr,
         extremes=(0, 360, 10, 3),
@@ -73,7 +73,7 @@ def test_curvelinear4():
     fig = plt.figure(figsize=(5, 5))
 
     tr = (mtransforms.Affine2D().scale(np.pi / 180, 1) +
-          mprojections.PolarAxes.PolarTransform(_apply_theta_transforms=False))
+          mprojections.PolarAxes.PolarTransform(apply_theta_transforms=False))
     grid_helper = GridHelperCurveLinear(
         tr,
         extremes=(120, 30, 10, 0),
diff --git a/lib/mpl_toolkits/axisartist/tests/test_grid_helper_curvelinear.py b/lib/mpl_toolkits/axisartist/tests/test_grid_helper_curvelinear.py
index 9da862776e82..8e6aded047fe 100644
--- a/lib/mpl_toolkits/axisartist/tests/test_grid_helper_curvelinear.py
+++ b/lib/mpl_toolkits/axisartist/tests/test_grid_helper_curvelinear.py
@@ -83,7 +83,7 @@ def test_polar_box():
     # PolarAxes.PolarTransform takes radian. However, we want our coordinate
     # system in degree
     tr = (Affine2D().scale(np.pi / 180., 1.) +
-          PolarAxes.PolarTransform(_apply_theta_transforms=False))
+          PolarAxes.PolarTransform(apply_theta_transforms=False))
 
     # polar projection, which involves cycle, and also has limits in
     # its coordinates, needs a special method to find the extremes
@@ -146,7 +146,7 @@ def test_axis_direction():
     # PolarAxes.PolarTransform takes radian. However, we want our coordinate
     # system in degree
     tr = (Affine2D().scale(np.pi / 180., 1.) +
-          PolarAxes.PolarTransform(_apply_theta_transforms=False))
+          PolarAxes.PolarTransform(apply_theta_transforms=False))
 
     # polar projection, which involves cycle, and also has limits in
     # its coordinates, needs a special method to find the extremes

From 0a62fccd4c9da4bda7c8274b9e5bc1657294125c Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Thu, 28 Dec 2023 18:00:01 +0000
Subject: [PATCH 0565/1120] Fix polar type stubs

---
 lib/matplotlib/projections/polar.pyi | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/projections/polar.pyi b/lib/matplotlib/projections/polar.pyi
index 2592d4947184..de1cbc293900 100644
--- a/lib/matplotlib/projections/polar.pyi
+++ b/lib/matplotlib/projections/polar.pyi
@@ -17,8 +17,8 @@ class PolarTransform(mtransforms.Transform):
         self,
         axis: PolarAxes | None = ...,
         use_rmin: bool = ...,
-        _apply_theta_transforms: bool = ...,
         *,
+        apply_theta_transforms: bool = ...,
         scale_transform: mtransforms.Transform | None = ...,
     ) -> None: ...
     def inverted(self) -> InvertedPolarTransform: ...
@@ -35,7 +35,8 @@ class InvertedPolarTransform(mtransforms.Transform):
         self,
         axis: PolarAxes | None = ...,
         use_rmin: bool = ...,
-        _apply_theta_transforms: bool = ...,
+        *,
+        apply_theta_transforms: bool = ...,
     ) -> None: ...
     def inverted(self) -> PolarTransform: ...
 

From dbda379de3cf49e8bb67b3a7aa86e547ec26fdec Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Thu, 28 Dec 2023 21:00:35 +0000
Subject: [PATCH 0566/1120] Update deprecation message

---
 lib/matplotlib/projections/polar.py | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/lib/matplotlib/projections/polar.py b/lib/matplotlib/projections/polar.py
index 726b0ee3901b..60eb5a2920f3 100644
--- a/lib/matplotlib/projections/polar.py
+++ b/lib/matplotlib/projections/polar.py
@@ -17,13 +17,14 @@
 
 def _apply_theta_transforms_warn():
     _api.warn_deprecated(
-                "3.7",
+                "3.9",
                 message=(
                     "Passing `apply_theta_transforms=True` (the default) "
-                    "is deprecated. Support for this will be removed in "
-                    "Matplotlib %(removal)s. To prevent this warning, "
-                    "set `apply_theta_transforms=False`, and make sure to "
-                    "shift theta values before being passed to this transform."
+                    "is deprecated since Matplotlib %(since)s. "
+                    "Support for this will be removed in Matplotlib %(removal)s. "
+                    "To prevent this warning, set `apply_theta_transforms=False`, "
+                    "and make sure to shift theta values before being passed to "
+                    "this transform."
                 )
             )
 

From ee48fb30f462e3504d3c63fd13cf5a02027adfb5 Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Thu, 28 Dec 2023 21:03:19 +0000
Subject: [PATCH 0567/1120] Update api note

---
 doc/api/next_api_changes/deprecations/24834-DS.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/doc/api/next_api_changes/deprecations/24834-DS.rst b/doc/api/next_api_changes/deprecations/24834-DS.rst
index ef7132c7d6d7..3761daaf1275 100644
--- a/doc/api/next_api_changes/deprecations/24834-DS.rst
+++ b/doc/api/next_api_changes/deprecations/24834-DS.rst
@@ -13,4 +13,5 @@ but only takes affect when:
 To silence this warning and adopt future behaviour,
 set ``apply_theta_transforms=False``. If you need to retain the behaviour
 where theta values are transformed, chain the ``PolarTransform`` with
-another transform that performs the theta shift and/or sign shift.
+a `~matplotlib.transforms.Affine2D` transform that performs the theta shift
+and/or sign shift.

From d06d04b3787cf9e5da0525b1cca993c3b96cf720 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Thu, 28 Dec 2023 17:53:36 -0500
Subject: [PATCH 0568/1120] DOC: soften warning on miss-matched versions in
 unpickle

Co-authored-by: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
---
 lib/matplotlib/figure.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
index a3b396c8b834..1dd181e836c7 100644
--- a/lib/matplotlib/figure.py
+++ b/lib/matplotlib/figure.py
@@ -3168,7 +3168,7 @@ def __setstate__(self, state):
         if version != mpl.__version__:
             _api.warn_external(
                 f"This figure was saved with matplotlib version {version} and "
-                f"loaded with {mpl.__version__} so is unlikely to function correctly."
+                f"loaded with {mpl.__version__} so may not function correctly."
             )
         self.__dict__ = state
 

From 6fd141cfe7839274dc83b384fb9da5ccf9329078 Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Tue, 2 Jan 2024 08:28:15 +0000
Subject: [PATCH 0569/1120] Use macOS instead of OSX

---
 .github/workflows/tests.yml                   |  4 +--
 doc/users/installing/dependencies.rst         |  2 +-
 .../installing/environment_variables_faq.rst  |  2 +-
 doc/users/installing/index.rst                | 26 +++++++++----------
 .../installing/troubleshooting_faq.inc.rst    |  2 +-
 .../shapes_and_collections/hatch_demo.py      |  2 +-
 .../hatch_style_reference.py                  |  2 +-
 .../user_interfaces/svg_histogram_sgskip.py   |  2 +-
 .../users_explain/animations/blitting.py      |  2 +-
 galleries/users_explain/figure/backends.rst   |  2 +-
 .../users_explain/figure/event_handling.rst   |  2 +-
 .../figure/interactive_guide.rst              |  2 +-
 lib/matplotlib/animation.py                   |  4 +--
 lib/matplotlib/backends/backend_qt.py         |  2 +-
 .../tests/test_backends_interactive.py        |  2 +-
 meson_options.txt                             |  2 +-
 src/_macosx.m                                 |  4 +--
 17 files changed, 32 insertions(+), 32 deletions(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 80a6d90527ad..1ffa9c7524a5 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -227,7 +227,7 @@ jobs:
           # (sometimes, the install appears to be successful but shared
           # libraries cannot be loaded at runtime, so an actual import is a
           # better check).
-          # PyGObject, pycairo, and cariocffi do not install on OSX 10.12.
+          # PyGObject, pycairo, and cariocffi do not install on macOS 10.12.
           python -m pip install --upgrade pycairo 'cairocffi>=0.8' PyGObject &&
             (
               python -c 'import gi; gi.require_version("Gtk", "4.0"); from gi.repository import Gtk' &&
@@ -237,7 +237,7 @@ jobs:
               echo 'PyGObject 3 is available' || echo 'PyGObject 3 is not available'
             )
 
-          # There are no functioning wheels available for OSX 10.12 (as of
+          # There are no functioning wheels available for macOS 10.12 (as of
           # Sept 2020) for either pyqt5 (there are only wheels for 10.13+) or
           # pyside2 (the latest version (5.13.2) with 10.12 wheels has a
           # fatal to us bug, it was fixed in 5.14.0 which has 10.13 wheels)
diff --git a/doc/users/installing/dependencies.rst b/doc/users/installing/dependencies.rst
index 585138db8474..86e7e1bbe596 100644
--- a/doc/users/installing/dependencies.rst
+++ b/doc/users/installing/dependencies.rst
@@ -167,7 +167,7 @@ tool for locating FreeType:
 If not using pkg-config (in particular on Windows), you may need to set the
 include path (to the library headers) and link path (to the libraries)
 explicitly, if they are not in standard locations.  This can be done using
-standard environment variables -- on Linux and OSX:
+standard environment variables -- on Linux and macOS:
 
 .. code-block:: sh
 
diff --git a/doc/users/installing/environment_variables_faq.rst b/doc/users/installing/environment_variables_faq.rst
index e7a721026743..efbcd9980fd0 100644
--- a/doc/users/installing/environment_variables_faq.rst
+++ b/doc/users/installing/environment_variables_faq.rst
@@ -49,7 +49,7 @@ Environment variables
    The Python Qt wrapper to prefer when using Qt-based backends. See :ref:`the
    entry in the usage guide <QT_bindings>` for more information.
 
-.. _setting-linux-osx-environment-variables:
+.. _setting-linux-macos-environment-variables:
 
 Setting environment variables in Linux and macOS
 ================================================
diff --git a/doc/users/installing/index.rst b/doc/users/installing/index.rst
index bea9a47b582d..fa5187081b2f 100644
--- a/doc/users/installing/index.rst
+++ b/doc/users/installing/index.rst
@@ -203,15 +203,15 @@ installation of the package.  In order to fully remove an installed Matplotlib:
 2. Delete any Matplotlib directories or eggs from your :ref:`installation
    directory <locating-matplotlib-install>`.
 
-OSX Notes
----------
+macOS Notes
+-----------
 
-.. _which-python-for-osx:
+.. _which-python-for-macos:
 
-Which python for OSX?
-^^^^^^^^^^^^^^^^^^^^^
+Which python for macOS?
+^^^^^^^^^^^^^^^^^^^^^^^
 
-Apple ships OSX with its own Python, in ``/usr/bin/python``, and its own copy
+Apple ships macOS with its own Python, in ``/usr/bin/python``, and its own copy
 of Matplotlib. Unfortunately, the way Apple currently installs its own copies
 of NumPy, Scipy and Matplotlib means that these packages are difficult to
 upgrade (see `system python packages`_).  For that reason we strongly suggest
@@ -228,18 +228,18 @@ See the Anaconda web page for installation support.
 .. _Anaconda: https://www.anaconda.com/
 
 Other options for a fresh Python install are the standard installer from
-`python.org <https://www.python.org/downloads/mac-osx/>`_, or installing
-Python using a general OSX package management system such as `homebrew
+`python.org <https://www.python.org/downloads/macos/>`_, or installing
+Python using a general macOS package management system such as `homebrew
 <https://brew.sh/>`_ or `macports <https://www.macports.org>`_.  Power users on
-OSX will likely want one of homebrew or macports on their system to install
+macOS will likely want one of homebrew or macports on their system to install
 open source software packages, but it is perfectly possible to use these
 systems with another source for your Python binary, such as Anaconda
 or Python.org Python.
 
-.. _install_osx_binaries:
+.. _install_macos_binaries:
 
-Installing OSX binary wheels
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Installing macOS binary wheels
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 If you are using Python from https://www.python.org, Homebrew, or Macports,
 then you can use the standard pip installer to install Matplotlib binaries in
@@ -283,7 +283,7 @@ then check that the Python binary is the one you expected by running ::
   which python3
 
 If you get a result like ``/usr/bin/python...``, then you are getting the
-Python installed with OSX, which is probably not what you want.  Try closing
+Python installed with macOS, which is probably not what you want.  Try closing
 and restarting Terminal.app before running the check again. If that doesn't fix
 the problem, depending on which Python you wanted to use, consider reinstalling
 Python.org Python, or check your homebrew or macports setup.  Remember that
diff --git a/doc/users/installing/troubleshooting_faq.inc.rst b/doc/users/installing/troubleshooting_faq.inc.rst
index 60bad7ccffc9..2314187a9542 100644
--- a/doc/users/installing/troubleshooting_faq.inc.rst
+++ b/doc/users/installing/troubleshooting_faq.inc.rst
@@ -67,6 +67,6 @@ directory by default::
 If you would like to use a different configuration directory, you can
 do so by specifying the location in your :envvar:`MPLCONFIGDIR`
 environment variable -- see
-:ref:`setting-linux-osx-environment-variables`.  Note that
+:ref:`setting-linux-macos-environment-variables`.  Note that
 :envvar:`MPLCONFIGDIR` sets the location of both the configuration
 directory and the cache directory.
diff --git a/galleries/examples/shapes_and_collections/hatch_demo.py b/galleries/examples/shapes_and_collections/hatch_demo.py
index 7acb3ca1bba8..f2ca490c4e37 100644
--- a/galleries/examples/shapes_and_collections/hatch_demo.py
+++ b/galleries/examples/shapes_and_collections/hatch_demo.py
@@ -5,7 +5,7 @@
 
 Hatches can be added to most polygons in Matplotlib, including `~.Axes.bar`,
 `~.Axes.fill_between`, `~.Axes.contourf`, and children of `~.patches.Polygon`.
-They are currently supported in the PS, PDF, SVG, OSX, and Agg backends. The WX
+They are currently supported in the PS, PDF, SVG, macosx, and Agg backends. The WX
 and Cairo backends do not currently support hatching.
 
 See also :doc:`/gallery/images_contours_and_fields/contourf_hatching` for
diff --git a/galleries/examples/shapes_and_collections/hatch_style_reference.py b/galleries/examples/shapes_and_collections/hatch_style_reference.py
index 4d6b517e3876..724abde051b4 100644
--- a/galleries/examples/shapes_and_collections/hatch_style_reference.py
+++ b/galleries/examples/shapes_and_collections/hatch_style_reference.py
@@ -5,7 +5,7 @@
 
 Hatches can be added to most polygons in Matplotlib, including `~.Axes.bar`,
 `~.Axes.fill_between`, `~.Axes.contourf`, and children of `~.patches.Polygon`.
-They are currently supported in the PS, PDF, SVG, OSX, and Agg backends. The WX
+They are currently supported in the PS, PDF, SVG, macosx, and Agg backends. The WX
 and Cairo backends do not currently support hatching.
 
 See also :doc:`/gallery/images_contours_and_fields/contourf_hatching` for
diff --git a/galleries/examples/user_interfaces/svg_histogram_sgskip.py b/galleries/examples/user_interfaces/svg_histogram_sgskip.py
index 38546b4cb4c3..7a484d998e69 100644
--- a/galleries/examples/user_interfaces/svg_histogram_sgskip.py
+++ b/galleries/examples/user_interfaces/svg_histogram_sgskip.py
@@ -9,7 +9,7 @@
 The interactivity is encoded in ecmascript (javascript) and inserted in
 the SVG code in a post-processing step. To render the image, open it in
 a web browser. SVG is supported in most web browsers used by Linux and
-OSX users. Windows IE9 supports SVG, but earlier versions do not.
+macOS users. Windows IE9 supports SVG, but earlier versions do not.
 
 Notes
 -----
diff --git a/galleries/users_explain/animations/blitting.py b/galleries/users_explain/animations/blitting.py
index b6e658f8a3cb..725398f8cff4 100644
--- a/galleries/users_explain/animations/blitting.py
+++ b/galleries/users_explain/animations/blitting.py
@@ -44,7 +44,7 @@
 
 .. warning::
 
-   This code does not work with the OSX backend (but does work with other
+   This code does not work with the macosx backend (but does work with other
    GUI backends on Mac).
 
 Minimal example
diff --git a/galleries/users_explain/figure/backends.rst b/galleries/users_explain/figure/backends.rst
index 41345d46d6ff..0aa20fc58862 100644
--- a/galleries/users_explain/figure/backends.rst
+++ b/galleries/users_explain/figure/backends.rst
@@ -182,7 +182,7 @@ GTK3Agg   Agg rendering to a GTK_ 3.x canvas (requires PyGObject_ and
 GTK4Agg   Agg rendering to a GTK_ 4.x canvas (requires PyGObject_ and
           pycairo_).  This backend can be activated in IPython with
           ``%matplotlib gtk4``.
-macosx    Agg rendering into a Cocoa canvas in OSX.  This backend can be
+macosx    Agg rendering into a Cocoa canvas in macOS.  This backend can be
           activated in IPython with ``%matplotlib osx``.
 TkAgg     Agg rendering to a Tk_ canvas (requires TkInter_). This
           backend can be activated in IPython with ``%matplotlib tk``.
diff --git a/galleries/users_explain/figure/event_handling.rst b/galleries/users_explain/figure/event_handling.rst
index 079139df43fd..49d73afeb366 100644
--- a/galleries/users_explain/figure/event_handling.rst
+++ b/galleries/users_explain/figure/event_handling.rst
@@ -8,7 +8,7 @@ Event handling and picking
 **************************
 
 Matplotlib works with a number of user interface toolkits (wxpython,
-tkinter, qt, gtk, and macosx) and in order to support features like
+tkinter, qt, gtk, and macOS) and in order to support features like
 interactive panning and zooming of figures, it is helpful to the
 developers to have an API for interacting with the figure via key
 presses and mouse movements that is "GUI neutral" so we don't have to
diff --git a/galleries/users_explain/figure/interactive_guide.rst b/galleries/users_explain/figure/interactive_guide.rst
index b7ccbe4cab25..3b6f527f6d42 100644
--- a/galleries/users_explain/figure/interactive_guide.rst
+++ b/galleries/users_explain/figure/interactive_guide.rst
@@ -58,7 +58,7 @@ depending on the library, by methods with names like ``_exec``,
 ``run``, or ``start``.
 
 
-All GUI frameworks (Qt, Wx, Gtk, tk, OSX, or web) have some method of
+All GUI frameworks (Qt, Wx, Gtk, tk, macOS, or web) have some method of
 capturing user interactions and passing them back to the application
 (for example ``Signal`` / ``Slot`` framework in Qt) but the exact
 details depend on the toolkit.  Matplotlib has a :ref:`backend
diff --git a/lib/matplotlib/animation.py b/lib/matplotlib/animation.py
index ccc332b04071..9cfb4d486991 100644
--- a/lib/matplotlib/animation.py
+++ b/lib/matplotlib/animation.py
@@ -541,8 +541,8 @@ def output_args(self):
                       else mpl.rcParams[self._args_key])
         # For h264, the default format is yuv444p, which is not compatible
         # with quicktime (and others). Specifying yuv420p fixes playback on
-        # iOS, as well as HTML5 video in firefox and safari (on both Win and
-        # OSX). Also fixes internet explorer. This is as of 2015/10/29.
+        # iOS, as well as HTML5 video in firefox and safari (on both Windows and
+        # macOS). Also fixes internet explorer. This is as of 2015/10/29.
         if self.codec == 'h264' and '-pix_fmt' not in extra_args:
             args.extend(['-pix_fmt', 'yuv420p'])
         # For GIF, we're telling FFMPEG to split the video stream, to generate
diff --git a/lib/matplotlib/backends/backend_qt.py b/lib/matplotlib/backends/backend_qt.py
index c6a6f3ad2e3a..db593ae77ded 100644
--- a/lib/matplotlib/backends/backend_qt.py
+++ b/lib/matplotlib/backends/backend_qt.py
@@ -40,7 +40,7 @@
         ("Key_PageUp", "pageup"),
         ("Key_PageDown", "pagedown"),
         ("Key_Shift", "shift"),
-        # In OSX, the control and super (aka cmd/apple) keys are switched.
+        # In macOS, the control and super (aka cmd/apple) keys are switched.
         ("Key_Control", "control" if sys.platform != "darwin" else "cmd"),
         ("Key_Meta", "meta" if sys.platform != "darwin" else "control"),
         ("Key_Alt", "alt"),
diff --git a/lib/matplotlib/tests/test_backends_interactive.py b/lib/matplotlib/tests/test_backends_interactive.py
index 3a714319ab81..fb2457ba31b3 100644
--- a/lib/matplotlib/tests/test_backends_interactive.py
+++ b/lib/matplotlib/tests/test_backends_interactive.py
@@ -90,7 +90,7 @@ def _get_available_interactive_backends():
         if reason:
             marks.append(pytest.mark.skip(reason=f"Skipping {env} because {reason}"))
         elif env["MPLBACKEND"].startswith('wx') and sys.platform == 'darwin':
-            # ignore on OSX because that's currently broken (github #16849)
+            # ignore on macosx because that's currently broken (github #16849)
             marks.append(pytest.mark.xfail(reason='github #16849'))
         elif (env['MPLBACKEND'] == 'tkagg' and
               ('TF_BUILD' in os.environ or 'GITHUB_ACTION' in os.environ) and
diff --git a/meson_options.txt b/meson_options.txt
index 77f2b5ec22de..d21cbedb9bb9 100644
--- a/meson_options.txt
+++ b/meson_options.txt
@@ -11,7 +11,7 @@ option('system-qhull', type: 'boolean', value: false,
        description: 'Build against system version of Qhull')
 
 # Some of Matplotlib's components are optional: the MacOSX backend (installed
-# by default on MacOSX; requires the Cocoa headers included with XCode). You
+# by default on macOS; requires the Cocoa headers included with XCode). You
 # can control whether they are installed using the following options. Note that
 # the MacOSX backend is never built on Linux or Windows, regardless of the
 # config value.
diff --git a/src/_macosx.m b/src/_macosx.m
index 6be86cfe7367..ac9009965b4f 100755
--- a/src/_macosx.m
+++ b/src/_macosx.m
@@ -409,7 +409,7 @@ int mpl_check_modifier(
             [[NSCursor openHandCursor] set];
         }
         break;
-      /* OSX handles busy state itself so no need to set a cursor here */
+      /* macOS handles busy state itself so no need to set a cursor here */
       case 5: break;
       case 6: [[NSCursor resizeLeftRightCursor] set]; break;
       case 7: [[NSCursor resizeUpDownCursor] set]; break;
@@ -1792,7 +1792,7 @@ - (void)flagsChanged:(NSEvent *)event
         {"event_loop_is_running",
          (PyCFunction)event_loop_is_running,
          METH_NOARGS,
-         "Return whether the OSX backend has set up the NSApp main event loop."},
+         "Return whether the macosx backend has set up the NSApp main event loop."},
         {"wake_on_fd_write",
          (PyCFunction)wake_on_fd_write,
          METH_VARARGS,

From 3d6a349ca3bba1715f3bd3e2f9b947b557d71b91 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Sat, 23 Dec 2023 04:38:24 -0500
Subject: [PATCH 0570/1120] Avoid an extra copy/resample if imshow input has no
 alpha

This is probably the best we can do to fix #27554 at this time, without
delving into re-writing the Agg resampler (which, as the Python code
notes, does require RGBA.)
---
 lib/matplotlib/image.py            | 12 ++++++++----
 lib/matplotlib/tests/test_image.py | 26 ++++++++++++++++++++++++++
 2 files changed, 34 insertions(+), 4 deletions(-)

diff --git a/lib/matplotlib/image.py b/lib/matplotlib/image.py
index e3e162a3d621..0ab02c403d0d 100644
--- a/lib/matplotlib/image.py
+++ b/lib/matplotlib/image.py
@@ -555,11 +555,15 @@ def _make_image(self, A, in_bbox, out_bbox, clip_bbox, magnification=1.0,
                 if A.ndim == 2:  # _interpolation_stage == 'rgba'
                     self.norm.autoscale_None(A)
                     A = self.to_rgba(A)
-                if A.shape[2] == 3:
-                    A = _rgb_to_rgba(A)
                 alpha = self._get_scalar_alpha()
-                output_alpha = _resample(  # resample alpha channel
-                    self, A[..., 3], out_shape, t, alpha=alpha)
+                if A.shape[2] == 3:
+                    # No need to resample alpha or make a full array; NumPy will expand
+                    # this out and cast to uint8 if necessary when it's assigned to the
+                    # alpha channel below.
+                    output_alpha = (255 * alpha) if A.dtype == np.uint8 else alpha
+                else:
+                    output_alpha = _resample(  # resample alpha channel
+                        self, A[..., 3], out_shape, t, alpha=alpha)
                 output = _resample(  # resample rgb channels
                     self, _rgb_to_rgba(A[..., :3]), out_shape, t, alpha=alpha)
                 output[..., 3] = output_alpha  # recombine rgb and alpha
diff --git a/lib/matplotlib/tests/test_image.py b/lib/matplotlib/tests/test_image.py
index 4fb4e65137d4..9a40b9baa313 100644
--- a/lib/matplotlib/tests/test_image.py
+++ b/lib/matplotlib/tests/test_image.py
@@ -268,6 +268,32 @@ def test_image_alpha():
     ax3.imshow(Z, alpha=0.5, interpolation='nearest')
 
 
+@mpl.style.context('mpl20')
+@check_figures_equal(extensions=['png'])
+def test_imshow_alpha(fig_test, fig_ref):
+    np.random.seed(19680801)
+
+    rgbf = np.random.rand(6, 6, 3)
+    rgbu = np.uint8(rgbf * 255)
+    ((ax0, ax1), (ax2, ax3)) = fig_test.subplots(2, 2)
+    ax0.imshow(rgbf, alpha=0.5)
+    ax1.imshow(rgbf, alpha=0.75)
+    ax2.imshow(rgbu, alpha=0.5)
+    ax3.imshow(rgbu, alpha=0.75)
+
+    rgbaf = np.concatenate((rgbf, np.ones((6, 6, 1))), axis=2)
+    rgbau = np.concatenate((rgbu, np.full((6, 6, 1), 255, np.uint8)), axis=2)
+    ((ax0, ax1), (ax2, ax3)) = fig_ref.subplots(2, 2)
+    rgbaf[:, :, 3] = 0.5
+    ax0.imshow(rgbaf)
+    rgbaf[:, :, 3] = 0.75
+    ax1.imshow(rgbaf)
+    rgbau[:, :, 3] = 127
+    ax2.imshow(rgbau)
+    rgbau[:, :, 3] = 191
+    ax3.imshow(rgbau)
+
+
 def test_cursor_data():
     from matplotlib.backend_bases import MouseEvent
 

From 52a5dfdf7dc9dec580c015543e330253d44f1baf Mon Sep 17 00:00:00 2001
From: jsjeelshah <jeel16@somaiya.edu>
Date: Fri, 22 Sep 2023 17:13:11 -0400
Subject: [PATCH 0571/1120] Remove deprecated code from _fontconfig_patterns

---
 doc/api/next_api_changes/removals/26884-JS.rst  |  5 +++++
 lib/matplotlib/_fontconfig_pattern.py           | 13 ++-----------
 lib/matplotlib/tests/test_fontconfig_pattern.py |  2 +-
 3 files changed, 8 insertions(+), 12 deletions(-)
 create mode 100644 doc/api/next_api_changes/removals/26884-JS.rst

diff --git a/doc/api/next_api_changes/removals/26884-JS.rst b/doc/api/next_api_changes/removals/26884-JS.rst
new file mode 100644
index 000000000000..71608b8d94be
--- /dev/null
+++ b/doc/api/next_api_changes/removals/26884-JS.rst
@@ -0,0 +1,5 @@
+``parse_fontconfig_pattern`` raises on unknown constant names
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Previously, in a fontconfig pattern like ``DejaVu Sans:foo``, the unknown
+``foo`` constant name would be silently ignored.  This now raises an error.
diff --git a/lib/matplotlib/_fontconfig_pattern.py b/lib/matplotlib/_fontconfig_pattern.py
index d3933b9f396d..6802c6ae24d7 100644
--- a/lib/matplotlib/_fontconfig_pattern.py
+++ b/lib/matplotlib/_fontconfig_pattern.py
@@ -13,9 +13,7 @@
 import re
 
 from pyparsing import (
-    Group, Optional, ParseException, Regex, StringEnd, Suppress, ZeroOrMore)
-
-from matplotlib import _api
+    Optional, ParseException, Regex, StringEnd, Suppress, ZeroOrMore, oneOf)
 
 
 _family_punc = r'\\\-:,'
@@ -63,8 +61,7 @@ def comma_separated(elem):
     size = Regex(r"([0-9]+\.?[0-9]*|\.[0-9]+)")
     name = Regex(r"[a-z]+")
     value = Regex(fr"([^{_value_punc}]|(\\[{_value_punc}]))*")
-    # replace trailing `| name` by oneOf(_CONSTANTS) in mpl 3.9.
-    prop = Group((name + Suppress("=") + comma_separated(value)) | name)
+    prop = (name + Suppress("=") + comma_separated(value)) | oneOf(_CONSTANTS)
     return (
         Optional(comma_separated(family)("families"))
         + Optional("-" + comma_separated(size)("sizes"))
@@ -97,12 +94,6 @@ def parse_fontconfig_pattern(pattern):
         props["size"] = [*parse["sizes"]]
     for prop in parse.get("properties", []):
         if len(prop) == 1:
-            if prop[0] not in _CONSTANTS:
-                _api.warn_deprecated(
-                    "3.7", message=f"Support for unknown constants "
-                    f"({prop[0]!r}) is deprecated since %(since)s and "
-                    f"will be removed %(removal)s.")
-                continue
             prop = _CONSTANTS[prop[0]]
         k, *v = prop
         props.setdefault(k, []).extend(map(_value_unescape, v))
diff --git a/lib/matplotlib/tests/test_fontconfig_pattern.py b/lib/matplotlib/tests/test_fontconfig_pattern.py
index 792a8ed517c2..496a35b95cf2 100644
--- a/lib/matplotlib/tests/test_fontconfig_pattern.py
+++ b/lib/matplotlib/tests/test_fontconfig_pattern.py
@@ -73,5 +73,5 @@ def test_fontconfig_str():
 
 
 def test_fontconfig_unknown_constant():
-    with pytest.warns(DeprecationWarning):
+    with pytest.raises(ValueError, match="ParseException"):
         FontProperties(":unknown")

From 580740af67d89f6a07115c5613bbe5c160ef6285 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Wed, 3 Jan 2024 11:37:24 +0100
Subject: [PATCH 0572/1120] Fix is_sorted_and_has_non_nan for byteswapped
 inputs.

---
 lib/matplotlib/tests/test_lines.py | 2 ++
 src/_path_wrapper.cpp              | 4 ++--
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/tests/test_lines.py b/lib/matplotlib/tests/test_lines.py
index 68e378a20f88..80261b0ddb19 100644
--- a/lib/matplotlib/tests/test_lines.py
+++ b/lib/matplotlib/tests/test_lines.py
@@ -246,6 +246,8 @@ def test_is_sorted_and_has_non_nan():
     assert _path.is_sorted_and_has_non_nan(np.array([1, 2, 3]))
     assert _path.is_sorted_and_has_non_nan(np.array([1, np.nan, 3]))
     assert not _path.is_sorted_and_has_non_nan([3, 5] + [np.nan] * 100 + [0, 2])
+    # [2, 256] byteswapped:
+    assert not _path.is_sorted_and_has_non_nan(np.array([33554432, 65536], ">i4"))
     n = 2 * mlines.Line2D._subslice_optim_min_size
     plt.plot([np.nan] * n, range(n))
 
diff --git a/src/_path_wrapper.cpp b/src/_path_wrapper.cpp
index cdab886d86df..72774576574a 100644
--- a/src/_path_wrapper.cpp
+++ b/src/_path_wrapper.cpp
@@ -707,8 +707,8 @@ static PyObject *Py_is_sorted_and_has_non_nan(PyObject *self, PyObject *obj)
 {
     bool result;
 
-    PyArrayObject *array = (PyArrayObject *)PyArray_FromAny(
-        obj, NULL, 1, 1, 0, NULL);
+    PyArrayObject *array = (PyArrayObject *)PyArray_CheckFromAny(
+        obj, NULL, 1, 1, NPY_ARRAY_NOTSWAPPED, NULL);
 
     if (array == NULL) {
         return NULL;

From f8cd003fb77e1962a2441419953255b15bf0808c Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Wed, 3 Jan 2024 11:17:03 +0100
Subject: [PATCH 0573/1120] Cleanup viewlims example.

- No need to subclass Rectangle; a plain callback is fine.
- ax.get_xlim/ylim seems more idiomatic than accessing viewLims.
- Skip duplicated code in initialization.
---
 galleries/examples/event_handling/viewlims.py | 79 +++++++++----------
 1 file changed, 39 insertions(+), 40 deletions(-)

diff --git a/galleries/examples/event_handling/viewlims.py b/galleries/examples/event_handling/viewlims.py
index b47e3b5b0801..ebc3e6de5fb8 100644
--- a/galleries/examples/event_handling/viewlims.py
+++ b/galleries/examples/event_handling/viewlims.py
@@ -14,21 +14,15 @@
     You can copy and paste individual parts, or download the entire example
     using the link at the bottom of the page.
 """
+
+import functools
+
 import matplotlib.pyplot as plt
 import numpy as np
 
 from matplotlib.patches import Rectangle
 
 
-# We just subclass Rectangle so that it can be called with an Axes
-# instance, causing the rectangle to update its shape to match the
-# bounds of the Axes
-class UpdatingRect(Rectangle):
-    def __call__(self, ax):
-        self.set_bounds(*ax.viewLim.bounds)
-        ax.figure.canvas.draw_idle()
-
-
 # A class that will regenerate a fractal set as we zoom in, so that you
 # can actually see the increasing detail.  A box in the left panel will show
 # the area to which we are zoomed.
@@ -40,9 +34,9 @@ def __init__(self, h=500, w=500, niter=50, radius=2., power=2):
         self.radius = radius
         self.power = power
 
-    def compute_image(self, xstart, xend, ystart, yend):
-        self.x = np.linspace(xstart, xend, self.width)
-        self.y = np.linspace(ystart, yend, self.height).reshape(-1, 1)
+    def compute_image(self, xlim, ylim):
+        self.x = np.linspace(*xlim, self.width)
+        self.y = np.linspace(*ylim, self.height).reshape(-1, 1)
         c = self.x + 1.0j * self.y
         threshold_time = np.zeros((self.height, self.width))
         z = np.zeros(threshold_time.shape, dtype=complex)
@@ -56,38 +50,43 @@ def compute_image(self, xstart, xend, ystart, yend):
     def ax_update(self, ax):
         ax.set_autoscale_on(False)  # Otherwise, infinite loop
         # Get the number of points from the number of pixels in the window
-        self.width, self.height = \
-            np.round(ax.patch.get_window_extent().size).astype(int)
-        # Get the range for the new area
-        vl = ax.viewLim
-        extent = vl.x0, vl.x1, vl.y0, vl.y1
+        self.width, self.height = ax.patch.get_window_extent().size.round().astype(int)
         # Update the image object with our new data and extent
-        im = ax.images[-1]
-        im.set_data(self.compute_image(*extent))
-        im.set_extent(extent)
+        ax.images[-1].set(data=self.compute_image(ax.get_xlim(), ax.get_ylim()),
+                          extent=(*ax.get_xlim(), *ax.get_ylim()))
         ax.figure.canvas.draw_idle()
 
 
 md = MandelbrotDisplay()
-Z = md.compute_image(-2., 0.5, -1.25, 1.25)
-
-fig1, (ax1, ax2) = plt.subplots(1, 2)
-ax1.imshow(Z, origin='lower',
-           extent=(md.x.min(), md.x.max(), md.y.min(), md.y.max()))
-ax2.imshow(Z, origin='lower',
-           extent=(md.x.min(), md.x.max(), md.y.min(), md.y.max()))
-
-rect = UpdatingRect(
-    [0, 0], 0, 0, facecolor='none', edgecolor='black', linewidth=1.0)
-rect.set_bounds(*ax2.viewLim.bounds)
-ax1.add_patch(rect)
-
-# Connect for changing the view limits
-ax2.callbacks.connect('xlim_changed', rect)
-ax2.callbacks.connect('ylim_changed', rect)
-
-ax2.callbacks.connect('xlim_changed', md.ax_update)
-ax2.callbacks.connect('ylim_changed', md.ax_update)
-ax2.set_title("Zoom here")
+
+fig1, (ax_full, ax_zoom) = plt.subplots(1, 2)
+ax_zoom.imshow([[0]], origin="lower")  # Empty initial image.
+ax_zoom.set_title("Zoom here")
+
+rect = Rectangle(
+    [0, 0], 0, 0, facecolor="none", edgecolor="black", linewidth=1.0)
+ax_full.add_patch(rect)
+
+
+def update_rect(rect, ax):  # Let the rectangle track the bounds of the zoom axes.
+    xlo, xhi = ax.get_xlim()
+    ylo, yhi = ax.get_ylim()
+    rect.set_bounds((xlo, ylo, xhi - xlo, yhi - ylo))
+    ax.figure.canvas.draw_idle()
+
+
+# Connect for changing the view limits.
+ax_zoom.callbacks.connect("xlim_changed", functools.partial(update_rect, rect))
+ax_zoom.callbacks.connect("ylim_changed", functools.partial(update_rect, rect))
+
+ax_zoom.callbacks.connect("xlim_changed", md.ax_update)
+ax_zoom.callbacks.connect("ylim_changed", md.ax_update)
+
+# Initialize: trigger image computation by setting view limits; set colormap limits;
+# copy image to full view.
+ax_zoom.set(xlim=(-2, .5), ylim=(-1.25, 1.25))
+im = ax_zoom.images[0]
+ax_zoom.images[0].set(clim=(im.get_array().min(), im.get_array().max()))
+ax_full.imshow(im.get_array(), extent=im.get_extent(), origin="lower")
 
 plt.show()

From 26dfad29df673ccb19564c8b2e370e761ab341cd Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Sat, 23 Dec 2023 04:44:58 -0500
Subject: [PATCH 0574/1120] ci: Update to v4 of artifacts actions

---
 .github/workflows/cibuildwheel.yml | 12 ++++++------
 .github/workflows/tests.yml        |  2 +-
 2 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 23c05a7629d0..bf292d354c25 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -69,9 +69,9 @@ jobs:
         run: twine check dist/*
 
       - name: Upload sdist result
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
-          name: sdist
+          name: cibw-sdist
           path: dist/*.tar.gz
           if-no-files-found: error
 
@@ -140,9 +140,9 @@ jobs:
           platforms: arm64
 
       - name: Download sdist
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
-          name: sdist
+          name: cibw-sdist
           path: dist/
 
       - name: Build wheels for CPython 3.12
@@ -186,8 +186,8 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
         if: matrix.cibw_archs != 'aarch64'
 
-      - uses: actions/upload-artifact@v3
+      - uses: actions/upload-artifact@v4
         with:
-          name: wheels
+          name: cibw-wheels-${{ runner.os }}-${{ matrix.cibw_archs }}
           path: ./wheelhouse/*.whl
           if-no-files-found: error
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 1ffa9c7524a5..2e40b29cc449 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -339,7 +339,7 @@ jobs:
         with:
           name: "${{ matrix.python-version }} ${{ matrix.os }} ${{ matrix.name-suffix }}"
 
-      - uses: actions/upload-artifact@v3
+      - uses: actions/upload-artifact@v4
         if: failure()
         with:
           name: "${{ matrix.python-version }} ${{ matrix.os }} ${{ matrix.name-suffix }} result images"

From 4b9b43fe15654274b4727ee1a3cc53f3bad125dd Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Sat, 23 Dec 2023 04:55:51 -0500
Subject: [PATCH 0575/1120] ci: Add the release steps to publish to PyPI

---
 .github/workflows/cibuildwheel.yml | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index bf292d354c25..0dc2ef1f49cb 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -191,3 +191,25 @@ jobs:
           name: cibw-wheels-${{ runner.os }}-${{ matrix.cibw_archs }}
           path: ./wheelhouse/*.whl
           if-no-files-found: error
+
+  publish:
+    if: github.event_name == 'release' && github.event.action == 'published'
+    name: Upload release to PyPI
+    needs: [build_sdist, build_wheels]
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      id-token: write
+    steps:
+      - name: Download packages
+        uses: actions/download-artifact@v4
+        with:
+          pattern: cibw-*
+          path: dist
+          merge-multiple: true
+
+      - name: Print out packages
+        run: ls dist
+
+      - name: Publish package distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@b7f401de30cb6434a1e19f805ff006643653240e # v1.8.10

From a690651b6afb8ff2971afb8a088b00f5bec81311 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Fri, 5 Jan 2024 13:25:34 +0100
Subject: [PATCH 0576/1120] Clarify dollar_ticks example and FormatStrFormatter
 docs.

dollar_ticks only uses FormatStrFormatter implicitly.
---
 galleries/examples/ticks/dollar_ticks.py |  3 ++-
 lib/matplotlib/ticker.py                 | 16 +++++++++++++---
 2 files changed, 15 insertions(+), 4 deletions(-)

diff --git a/galleries/examples/ticks/dollar_ticks.py b/galleries/examples/ticks/dollar_ticks.py
index 4186e8c369e9..7abf967c053b 100644
--- a/galleries/examples/ticks/dollar_ticks.py
+++ b/galleries/examples/ticks/dollar_ticks.py
@@ -3,10 +3,11 @@
 Dollar ticks
 ============
 
-Use a `~.ticker.FormatStrFormatter` to prepend dollar signs on y-axis labels.
+Use a format string to prepend dollar signs on y-axis labels.
 
 .. redirect-from:: /gallery/pyplots/dollar_ticks
 """
+
 import matplotlib.pyplot as plt
 import numpy as np
 
diff --git a/lib/matplotlib/ticker.py b/lib/matplotlib/ticker.py
index 7a9010ec2a5b..50a505da154c 100644
--- a/lib/matplotlib/ticker.py
+++ b/lib/matplotlib/ticker.py
@@ -336,10 +336,11 @@ class FormatStrFormatter(Formatter):
     The format string should have a single variable format (%) in it.
     It will be applied to the value (not the position) of the tick.
 
-    Negative numeric values will use a dash, not a Unicode minus; use mathtext
-    to get a Unicode minus by wrapping the format specifier with $ (e.g.
-    "$%g$").
+    Negative numeric values (e.g., -1) will use a dash, not a Unicode minus;
+    use mathtext to get a Unicode minus by wrapping the format specifier with $
+    (e.g. "$%g$").
     """
+
     def __init__(self, fmt):
         self.fmt = fmt
 
@@ -358,7 +359,16 @@ class StrMethodFormatter(Formatter):
 
     The field used for the tick value must be labeled *x* and the field used
     for the tick position must be labeled *pos*.
+
+    Negative numeric values (e.g., -1) will use a dash, not a Unicode minus;
+    use mathtext to get a Unicode minus by wrapping the format specifier with $
+    (e.g. "${x}$").
+
+    It is typically unnecessary to explicitly construct `.StrMethodFormatter`
+    objects, as `~.Axis.set_major_formatter` directly accepts the format string
+    itself.
     """
+
     def __init__(self, fmt):
         self.fmt = fmt
 

From 3a3f5eea704702f54d86da1bf31c1f6d35b4523a Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Fri, 5 Jan 2024 18:27:07 +0100
Subject: [PATCH 0577/1120] Let FormatStrFormatter respect axes.unicode_minus.

This is better than the workaround of wrapping the expression in
mathtext (as suggested for the old-style FormatStrFormatter) because it
also works for the hover tooltip in the toolbar (which cannot display
mathtext).

Note that it is not as easy to do so for FormatStrFormatter
(%-formatting) as that would require manually parsing the format string;
I would not bother as that formatter seems to be mostly present for
backcompat.
---
 .../formatter_unicode_minus.rst               |  4 ++++
 lib/matplotlib/tests/test_ticker.py           | 19 ++++++++++++------
 lib/matplotlib/ticker.py                      | 20 +++++++++++++++----
 3 files changed, 33 insertions(+), 10 deletions(-)
 create mode 100644 doc/users/next_whats_new/formatter_unicode_minus.rst

diff --git a/doc/users/next_whats_new/formatter_unicode_minus.rst b/doc/users/next_whats_new/formatter_unicode_minus.rst
new file mode 100644
index 000000000000..1b12b216240e
--- /dev/null
+++ b/doc/users/next_whats_new/formatter_unicode_minus.rst
@@ -0,0 +1,4 @@
+``StrMethodFormatter`` now respects ``axes.unicode_minus``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+When formatting negative values, `.StrMethodFormatter` will now use unicode
+minus signs if :rc:`axes.unicode_minus` is set.
diff --git a/lib/matplotlib/tests/test_ticker.py b/lib/matplotlib/tests/test_ticker.py
index 6d363a48aec8..12eafba9ea2b 100644
--- a/lib/matplotlib/tests/test_ticker.py
+++ b/lib/matplotlib/tests/test_ticker.py
@@ -1434,14 +1434,21 @@ def test_basic(self):
 
 class TestStrMethodFormatter:
     test_data = [
-        ('{x:05d}', (2,), '00002'),
-        ('{x:03d}-{pos:02d}', (2, 1), '002-01'),
+        ('{x:05d}', (2,), False, '00002'),
+        ('{x:05d}', (2,), True, '00002'),
+        ('{x:05d}', (-2,), False, '-0002'),
+        ('{x:05d}', (-2,), True, '\N{MINUS SIGN}0002'),
+        ('{x:03d}-{pos:02d}', (2, 1), False, '002-01'),
+        ('{x:03d}-{pos:02d}', (2, 1), True, '002-01'),
+        ('{x:03d}-{pos:02d}', (-2, 1), False, '-02-01'),
+        ('{x:03d}-{pos:02d}', (-2, 1), True, '\N{MINUS SIGN}02-01'),
     ]
 
-    @pytest.mark.parametrize('format, input, expected', test_data)
-    def test_basic(self, format, input, expected):
-        fmt = mticker.StrMethodFormatter(format)
-        assert fmt(*input) == expected
+    @pytest.mark.parametrize('format, input, unicode_minus, expected', test_data)
+    def test_basic(self, format, input, unicode_minus, expected):
+        with mpl.rc_context({"axes.unicode_minus": unicode_minus}):
+            fmt = mticker.StrMethodFormatter(format)
+            assert fmt(*input) == expected
 
 
 class TestEngFormatter:
diff --git a/lib/matplotlib/ticker.py b/lib/matplotlib/ticker.py
index 50a505da154c..10ac8cad6ebc 100644
--- a/lib/matplotlib/ticker.py
+++ b/lib/matplotlib/ticker.py
@@ -135,6 +135,7 @@
 import locale
 import math
 from numbers import Integral
+import string
 
 import numpy as np
 
@@ -353,6 +354,18 @@ def __call__(self, x, pos=None):
         return self.fmt % x
 
 
+class _UnicodeMinusFormat(string.Formatter):
+    """
+    A specialized string formatter so that `.StrMethodFormatter` respects
+    :rc:`axes.unicode_minus`.  This implementation relies on the fact that the
+    format string is only ever called with kwargs *x* and *pos*, so it blindly
+    replaces dashes by unicode minuses without further checking.
+    """
+
+    def format_field(self, value, format_spec):
+        return Formatter.fix_minus(super().format_field(value, format_spec))
+
+
 class StrMethodFormatter(Formatter):
     """
     Use a new-style format string (as used by `str.format`) to format the tick.
@@ -360,9 +373,8 @@ class StrMethodFormatter(Formatter):
     The field used for the tick value must be labeled *x* and the field used
     for the tick position must be labeled *pos*.
 
-    Negative numeric values (e.g., -1) will use a dash, not a Unicode minus;
-    use mathtext to get a Unicode minus by wrapping the format specifier with $
-    (e.g. "${x}$").
+    The formatter will respect :rc:`axes.unicode_minus` when formatting
+    negative numeric values.
 
     It is typically unnecessary to explicitly construct `.StrMethodFormatter`
     objects, as `~.Axis.set_major_formatter` directly accepts the format string
@@ -379,7 +391,7 @@ def __call__(self, x, pos=None):
         *x* and *pos* are passed to `str.format` as keyword arguments
         with those exact names.
         """
-        return self.fmt.format(x=x, pos=pos)
+        return _UnicodeMinusFormat().format(self.fmt, x=x, pos=pos)
 
 
 class ScalarFormatter(Formatter):

From b4701cde7077f4bc456621b2f99cf078cc7e4c6f Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Sat, 6 Jan 2024 10:01:16 +0000
Subject: [PATCH 0578/1120] Don't clip PowerNorm inputs < vmin

---
 .../next_api_changes/behavior/27589-DS.rst    |  5 +++
 lib/matplotlib/colors.py                      | 32 ++++++++++++-------
 lib/matplotlib/tests/test_colors.py           | 17 ++++++++--
 3 files changed, 40 insertions(+), 14 deletions(-)
 create mode 100644 doc/api/next_api_changes/behavior/27589-DS.rst

diff --git a/doc/api/next_api_changes/behavior/27589-DS.rst b/doc/api/next_api_changes/behavior/27589-DS.rst
new file mode 100644
index 000000000000..314df582600b
--- /dev/null
+++ b/doc/api/next_api_changes/behavior/27589-DS.rst
@@ -0,0 +1,5 @@
+PowerNorm no longer clips values below vmin
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+When ``clip=False`` is set (the default) on `~matplotlib.colors.PowerNorm`,
+values below ``vmin`` are now linearly normalised. Previously they were clipped
+to zero. This fixes issues with the display of colorbars associated with a power norm.
diff --git a/lib/matplotlib/colors.py b/lib/matplotlib/colors.py
index 2ce27a810a43..5886b2065836 100644
--- a/lib/matplotlib/colors.py
+++ b/lib/matplotlib/colors.py
@@ -1953,10 +1953,10 @@ class PowerNorm(Normalize):
         Determines the behavior for mapping values outside the range
         ``[vmin, vmax]``.
 
-        If clipping is off, values outside the range ``[vmin, vmax]`` are also
-        transformed by the power function, resulting in values outside ``[0, 1]``.
-        This behavior is usually desirable, as colormaps can mark these *under*
-        and *over* values with specific colors.
+        If clipping is off, values above *vmax* are transformed by the power
+        function, resulting in values above 1, and values below *vmin* are linearly
+        transformed resulting in values below 0. This behavior is usually desirable, as
+        colormaps can mark these *under* and *over* values with specific colors.
 
         If clipping is on, values below *vmin* are mapped to 0 and values above
         *vmax* are mapped to 1. Such values become indistinguishable from
@@ -1969,6 +1969,8 @@ class PowerNorm(Normalize):
     .. math::
 
         \left ( \frac{x - v_{min}}{v_{max}  - v_{min}} \right )^{\gamma}
+
+    For input values below *vmin*, gamma is set to zero.
     """
     def __init__(self, gamma, vmin=None, vmax=None, clip=False):
         super().__init__(vmin, vmax, clip)
@@ -1994,9 +1996,8 @@ def __call__(self, value, clip=None):
                                      mask=mask)
             resdat = result.data
             resdat -= vmin
-            resdat[resdat < 0] = 0
-            np.power(resdat, gamma, resdat)
-            resdat /= (vmax - vmin) ** gamma
+            resdat /= (vmax - vmin)
+            resdat[resdat > 0] = np.power(resdat[resdat > 0], gamma)
 
             result = np.ma.array(resdat, mask=result.mask, copy=False)
         if is_scalar:
@@ -2006,14 +2007,21 @@ def __call__(self, value, clip=None):
     def inverse(self, value):
         if not self.scaled():
             raise ValueError("Not invertible until scaled")
+
+        result, is_scalar = self.process_value(value)
+
         gamma = self.gamma
         vmin, vmax = self.vmin, self.vmax
 
-        if np.iterable(value):
-            val = np.ma.asarray(value)
-            return np.ma.power(val, 1. / gamma) * (vmax - vmin) + vmin
-        else:
-            return pow(value, 1. / gamma) * (vmax - vmin) + vmin
+        resdat = result.data
+        resdat[resdat > 0] = np.power(resdat[resdat > 0], 1 / gamma)
+        resdat *= (vmax - vmin)
+        resdat += vmin
+
+        result = np.ma.array(resdat, mask=result.mask, copy=False)
+        if is_scalar:
+            result = result[0]
+        return result
 
 
 class BoundaryNorm(Normalize):
diff --git a/lib/matplotlib/tests/test_colors.py b/lib/matplotlib/tests/test_colors.py
index 139efbe17407..37b993ec8db7 100644
--- a/lib/matplotlib/tests/test_colors.py
+++ b/lib/matplotlib/tests/test_colors.py
@@ -555,12 +555,16 @@ def test_PowerNorm():
     assert_array_almost_equal(norm(a), pnorm(a))
 
     a = np.array([-0.5, 0, 2, 4, 8], dtype=float)
-    expected = [0, 0, 1/16, 1/4, 1]
+    expected = [-1/16, 0, 1/16, 1/4, 1]
     pnorm = mcolors.PowerNorm(2, vmin=0, vmax=8)
     assert_array_almost_equal(pnorm(a), expected)
     assert pnorm(a[0]) == expected[0]
     assert pnorm(a[2]) == expected[2]
-    assert_array_almost_equal(a[1:], pnorm.inverse(pnorm(a))[1:])
+    # Check inverse
+    a_roundtrip = pnorm.inverse(pnorm(a))
+    assert_array_almost_equal(a, a_roundtrip)
+    # PowerNorm inverse adds a mask, so check that is correct too
+    assert_array_equal(a_roundtrip.mask, np.zeros(a.shape, dtype=bool))
 
     # Clip = True
     a = np.array([-0.5, 0, 1, 8, 16], dtype=float)
@@ -591,6 +595,15 @@ def test_PowerNorm_translation_invariance():
     assert_array_almost_equal(pnorm(a - 2), expected)
 
 
+def test_powernorm_cbar_limits():
+    fig, ax = plt.subplots()
+    vmin, vmax = 300, 1000
+    data = np.arange(100*100).reshape(100, 100) + vmin
+    im = ax.imshow(data, norm=mcolors.PowerNorm(gamma=0.2, vmin=vmin, vmax=vmax))
+    cbar = fig.colorbar(im)
+    assert cbar.ax.get_ylim() == (vmin, vmax)
+
+
 def test_Normalize():
     norm = mcolors.Normalize()
     vals = np.arange(-10, 10, 1, dtype=float)

From aecc2db0ef8fd51d1bedf101c7cb98d73b9542ec Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Sat, 6 Jan 2024 11:36:53 +0000
Subject: [PATCH 0579/1120] Fix colorbar test

---
 lib/matplotlib/tests/test_colorbar.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/lib/matplotlib/tests/test_colorbar.py b/lib/matplotlib/tests/test_colorbar.py
index 4566ce449aac..74742d8c2369 100644
--- a/lib/matplotlib/tests/test_colorbar.py
+++ b/lib/matplotlib/tests/test_colorbar.py
@@ -552,10 +552,10 @@ def test_colorbar_lognorm_extension(extend):
 
 def test_colorbar_powernorm_extension():
     # Test that colorbar with powernorm is extended correctly
-    f, ax = plt.subplots()
-    cb = Colorbar(ax, norm=PowerNorm(gamma=0.5, vmin=0.0, vmax=1.0),
-                  orientation='vertical', extend='both')
-    assert cb._values[0] >= 0.0
+    # Just a smoke test that adding the colorbar doesn't raise an error or warning
+    fig, ax = plt.subplots()
+    Colorbar(ax, norm=PowerNorm(gamma=0.5, vmin=0.0, vmax=1.0),
+             orientation='vertical', extend='both')
 
 
 def test_colorbar_axes_kw():

From 4eaecf78a140acdc4fa8b43be1dfd334686ed4dc Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Sat, 6 Jan 2024 12:04:53 +0000
Subject: [PATCH 0580/1120] Pin black version

---
 environment.yml              | 2 +-
 requirements/testing/all.txt | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/environment.yml b/environment.yml
index 1487578a443b..e32d7bb71c4b 100644
--- a/environment.yml
+++ b/environment.yml
@@ -64,4 +64,4 @@ dependencies:
   - pytest-xdist
   - tornado
   - pytz
-  - black
+  - black~=23.0
diff --git a/requirements/testing/all.txt b/requirements/testing/all.txt
index 173c5a4a9909..150b2b5f5717 100644
--- a/requirements/testing/all.txt
+++ b/requirements/testing/all.txt
@@ -1,6 +1,6 @@
 # pip requirements for all the CI builds
 
-black
+black~=23.0
 certifi
 coverage!=6.3
 psutil

From b7ccc5bd9689e24e0e0075e766bec1a49fc3d7bc Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Sat, 6 Jan 2024 15:03:48 +0000
Subject: [PATCH 0581/1120] Pin max version

---
 environment.yml              | 2 +-
 requirements/testing/all.txt | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/environment.yml b/environment.yml
index e32d7bb71c4b..9f06ab7ff143 100644
--- a/environment.yml
+++ b/environment.yml
@@ -64,4 +64,4 @@ dependencies:
   - pytest-xdist
   - tornado
   - pytz
-  - black~=23.0
+  - black<24
diff --git a/requirements/testing/all.txt b/requirements/testing/all.txt
index 150b2b5f5717..4ca786fcf73e 100644
--- a/requirements/testing/all.txt
+++ b/requirements/testing/all.txt
@@ -1,6 +1,6 @@
 # pip requirements for all the CI builds
 
-black~=23.0
+black<24
 certifi
 coverage!=6.3
 psutil

From f8b3b27a623489c83aa83051c6742db0274d451a Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Sat, 6 Jan 2024 15:05:22 +0000
Subject: [PATCH 0582/1120] Ignore masked values in boxplot

---
 doc/api/next_api_changes/behavior/27605-DS.rst |  4 ++++
 lib/matplotlib/cbook.py                        |  3 ++-
 lib/matplotlib/tests/test_axes.py              | 14 ++++++++++++++
 3 files changed, 20 insertions(+), 1 deletion(-)
 create mode 100644 doc/api/next_api_changes/behavior/27605-DS.rst

diff --git a/doc/api/next_api_changes/behavior/27605-DS.rst b/doc/api/next_api_changes/behavior/27605-DS.rst
new file mode 100644
index 000000000000..a4bc04ccfb04
--- /dev/null
+++ b/doc/api/next_api_changes/behavior/27605-DS.rst
@@ -0,0 +1,4 @@
+Boxplots now ignore masked data points
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+`~matplotlib.axes.Axes.boxplot` and `~matplotlib.cbook.boxplot_stats` now ignore
+any masked points in the input data.
diff --git a/lib/matplotlib/cbook.py b/lib/matplotlib/cbook.py
index b0cde743482b..ff6b2a15ec35 100644
--- a/lib/matplotlib/cbook.py
+++ b/lib/matplotlib/cbook.py
@@ -1274,7 +1274,8 @@ def _compute_conf_interval(data, med, iqr, bootstrap):
             continue
 
         # up-convert to an array, just to be safe
-        x = np.asarray(x)
+        x = np.ma.asarray(x)
+        x = x.data[~x.mask].ravel()
 
         # arithmetic mean
         stats['mean'] = np.mean(x)
diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index d8d7cb0144f1..0557ac9941ec 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -3388,6 +3388,20 @@ def test_boxplot():
     ax.set_ylim((-30, 30))
 
 
+@check_figures_equal(extensions=["png"])
+def test_boxplot_masked(fig_test, fig_ref):
+    # Check that masked values are ignored when plotting a boxplot
+    x_orig = np.linspace(-1, 1, 200)
+
+    ax = fig_test.subplots()
+    x = x_orig[x_orig >= 0]
+    ax.boxplot(x)
+
+    x = np.ma.masked_less(x_orig, 0)
+    ax = fig_ref.subplots()
+    ax.boxplot(x)
+
+
 @image_comparison(['boxplot_custom_capwidths.png'],
                   savefig_kwarg={'dpi': 40}, style='default')
 def test_boxplot_custom_capwidths():

From cc2212f22fe39e7104a76d8b25fad2c27ae0d137 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Mon, 8 Jan 2024 18:50:41 -0500
Subject: [PATCH 0583/1120] Updated link in annotation API docs to point to
 annotation user guide entry.

---
 lib/matplotlib/text.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/text.py b/lib/matplotlib/text.py
index da11194c6427..e216d27d05c9 100644
--- a/lib/matplotlib/text.py
+++ b/lib/matplotlib/text.py
@@ -1799,7 +1799,7 @@ def transform(renderer) -> Transform
 
         See Also
         --------
-        :ref:`plotting-guide-annotation`
+        :ref:`annotations`
 
         """
         _AnnotationBase.__init__(self,

From 0d2e5e856752b4a73f5d3a98013ce165de6b17dc Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Mon, 8 Jan 2024 18:56:22 -0500
Subject: [PATCH 0584/1120] add spaces to PR template

---
 .github/PULL_REQUEST_TEMPLATE.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index c79f22ffdf8a..cd6cf5585a49 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -11,6 +11,8 @@ Also please summarize the changes in the title, for example "Raise ValueError on
 non-numeric input to set_xlim" and avoid non-descriptive titles such as "Addresses
 issue #8576".
 -->
+
+
 ## PR checklist
 <!-- Please mark any checkboxes that do not apply to this PR as [N/A].-->
 

From a7a365f2214b4ed6ad0b474bd3f0f1297bd9f8ba Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Mon, 8 Jan 2024 23:07:41 -0500
Subject: [PATCH 0585/1120] Fix some small typos found by new codespell

---
 .github/workflows/cibuildwheel.yml       |  2 +-
 lib/matplotlib/_mathtext.py              | 30 +++++++++++++-----------
 lib/matplotlib/animation.py              |  2 +-
 lib/matplotlib/artist.py                 |  5 ++--
 lib/matplotlib/axes/_axes.py             |  2 +-
 lib/matplotlib/axes/_base.py             |  2 +-
 lib/matplotlib/pyplot.py                 |  2 +-
 lib/matplotlib/scale.py                  |  2 +-
 lib/matplotlib/tests/test_tightlayout.py | 12 ++++++----
 9 files changed, 31 insertions(+), 28 deletions(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 23c05a7629d0..5af893a56bbc 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -99,7 +99,7 @@ jobs:
       # these wheels are also used for nightlies and NumPy 2.0 transition
       # requires using the NumPy 2.0 nightlies for compatibility.
       # If using all `--pre` releases creates issues, the NumPy wheel can be
-      # istalled more targeted.
+      # installed more targeted.
       CIBW_BUILD_FRONTEND: >-
         ${{ (((github.event_name == 'push' && github.ref == 'refs/heads/main') ||
               (github.event_name == 'pull_request' && github.base_ref == 'main')) &&
diff --git a/lib/matplotlib/_mathtext.py b/lib/matplotlib/_mathtext.py
index 0d8842772a5b..86091f79d5bb 100644
--- a/lib/matplotlib/_mathtext.py
+++ b/lib/matplotlib/_mathtext.py
@@ -2672,25 +2672,27 @@ def _genset(self, s: str, loc: int, toks: ParseResults) -> T.Any:
         thickness = self.get_state().get_current_underline_thickness()
 
         annotation.shrink()
-        cannotation = HCentered([annotation])
-        cbody = HCentered([body])
-        width = max(cannotation.width, cbody.width)
-        cannotation.hpack(width, 'exactly')
-        cbody.hpack(width, 'exactly')
+        centered_annotation = HCentered([annotation])
+        centered_body = HCentered([body])
+        width = max(centered_annotation.width, centered_body.width)
+        centered_annotation.hpack(width, 'exactly')
+        centered_body.hpack(width, 'exactly')
 
         vgap = thickness * 3
         if s[loc + 1] == "u":  # \underset
-            vlist = Vlist([cbody,                       # body
-                           Vbox(0, vgap),               # space
-                           cannotation                  # annotation
-                           ])
+            vlist = Vlist([
+                centered_body,               # body
+                Vbox(0, vgap),               # space
+                centered_annotation          # annotation
+            ])
             # Shift so the body sits in the same vertical position
-            vlist.shift_amount = cbody.depth + cannotation.height + vgap
+            vlist.shift_amount = centered_body.depth + centered_annotation.height + vgap
         else:  # \overset
-            vlist = Vlist([cannotation,                 # annotation
-                           Vbox(0, vgap),               # space
-                           cbody                        # body
-                           ])
+            vlist = Vlist([
+                centered_annotation,         # annotation
+                Vbox(0, vgap),               # space
+                centered_body                # body
+            ])
 
         # To add horizontal gap between symbols: wrap the Vlist into
         # an Hlist and extend it with an Hbox(0, horizontal_gap)
diff --git a/lib/matplotlib/animation.py b/lib/matplotlib/animation.py
index 9cfb4d486991..1efb72cb52e6 100644
--- a/lib/matplotlib/animation.py
+++ b/lib/matplotlib/animation.py
@@ -1032,7 +1032,7 @@ def func(current_frame: int, total_frames: int) -> Any
             # Convert interval in ms to frames per second
             fps = 1000. / self._interval
 
-        # Re-use the savefig DPI for ours if none is given
+        # Reuse the savefig DPI for ours if none is given.
         dpi = mpl._val_or_rc(dpi, 'savefig.dpi')
         if dpi == 'figure':
             dpi = self._fig.dpi
diff --git a/lib/matplotlib/artist.py b/lib/matplotlib/artist.py
index 8500557c98e0..a42fea8c12e4 100644
--- a/lib/matplotlib/artist.py
+++ b/lib/matplotlib/artist.py
@@ -299,9 +299,8 @@ def axes(self):
     def axes(self, new_axes):
         if (new_axes is not None and self._axes is not None
                 and new_axes != self._axes):
-            raise ValueError("Can not reset the Axes.  You are probably "
-                             "trying to re-use an artist in more than one "
-                             "Axes which is not supported")
+            raise ValueError("Can not reset the Axes. You are probably trying to reuse "
+                             "an artist in more than one Axes which is not supported")
         self._axes = new_axes
         if new_axes is not None and new_axes is not self:
             self.stale_callback = _stale_axes_callback
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 74243b71a152..18b928df41a8 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -6179,7 +6179,7 @@ def pcolormesh(self, *args, alpha=None, norm=None, cmap=None, vmin=None,
             and *Y* should be the same as those of *C* (if not, a ValueError
             will be raised).  For ``'nearest'`` the color ``C[i, j]`` is
             centered on ``(X[i, j], Y[i, j])``.  For ``'gouraud'``, a smooth
-            interpolation is caried out between the quadrilateral corners.
+            interpolation is carried out between the quadrilateral corners.
 
             If *X* and/or *Y* are 1-D arrays or column vectors they will be
             expanded as needed into the appropriate 2D arrays, making a
diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index 29490d77a50f..51347f08b989 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -4632,7 +4632,7 @@ def _draw_rasterized(figure, artists, renderer):
     shim class to be compatible with that decorator and then uses it to
     rasterize the list of artists.
 
-    This is maybe too-clever, but allows us to re-use the same code that is
+    This is maybe too-clever, but allows us to reuse the same code that is
     used on normal artists to participate in the "are we rasterizing"
     accounting.
 
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 147ae1017c28..2c1403900529 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -1439,7 +1439,7 @@ def subplot(*args, **kwargs) -> Axes:
     key = SubplotSpec._from_subplot_args(fig, args)
 
     for ax in fig.axes:
-        # If we found an Axes at the position, we can re-use it if the user passed no
+        # If we found an Axes at the position, we can reuse it if the user passed no
         # kwargs or if the Axes class and kwargs are identical.
         if (ax.get_subplotspec() == key
             and (kwargs == {}
diff --git a/lib/matplotlib/scale.py b/lib/matplotlib/scale.py
index d86de461efc8..7f90362b574b 100644
--- a/lib/matplotlib/scale.py
+++ b/lib/matplotlib/scale.py
@@ -54,7 +54,7 @@ def __init__(self, axis):
 
         Notes
         -----
-        The following note is for scale implementors.
+        The following note is for scale implementers.
 
         For back-compatibility reasons, scales take an `~matplotlib.axis.Axis`
         object as first argument.  However, this argument should not
diff --git a/lib/matplotlib/tests/test_tightlayout.py b/lib/matplotlib/tests/test_tightlayout.py
index 422c9c1dd444..0f83cca6b642 100644
--- a/lib/matplotlib/tests/test_tightlayout.py
+++ b/lib/matplotlib/tests/test_tightlayout.py
@@ -173,13 +173,15 @@ def test_outward_ticks():
     plt.tight_layout()
     # These values were obtained after visual checking that they correspond
     # to a tight layouting that did take the ticks into account.
-    ans = [[[0.091, 0.607], [0.433, 0.933]],
-           [[0.579, 0.607], [0.922, 0.933]],
-           [[0.091, 0.140], [0.433, 0.466]],
-           [[0.579, 0.140], [0.922, 0.466]]]
+    expected = [
+        [[0.091, 0.607], [0.433, 0.933]],
+        [[0.579, 0.607], [0.922, 0.933]],
+        [[0.091, 0.140], [0.433, 0.466]],
+        [[0.579, 0.140], [0.922, 0.466]],
+    ]
     for nn, ax in enumerate(fig.axes):
         assert_array_equal(np.round(ax.get_position().get_points(), 3),
-                           ans[nn])
+                           expected[nn])
 
 
 def add_offsetboxes(ax, size=10, margin=.1, color='black'):

From dc8fed71fc31dca0e6dcfea982bf408fb8ce4ebd Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 1 Jan 2024 17:29:38 +0000
Subject: [PATCH 0586/1120] [pre-commit.ci] pre-commit autoupdate
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

updates:
- [github.com/pre-commit/pre-commit-hooks: v4.4.0 → v4.5.0](https://github.com/pre-commit/pre-commit-hooks/compare/v4.4.0...v4.5.0)
- [github.com/pre-commit/mirrors-mypy: v1.1.1 → v1.8.0](https://github.com/pre-commit/mirrors-mypy/compare/v1.1.1...v1.8.0)
- [github.com/pycqa/flake8: 6.0.0 → 6.1.0](https://github.com/pycqa/flake8/compare/6.0.0...6.1.0)
- [github.com/codespell-project/codespell: v2.2.5 → v2.2.6](https://github.com/codespell-project/codespell/compare/v2.2.5...v2.2.6)
- [github.com/pycqa/isort: 5.12.0 → 5.13.2](https://github.com/pycqa/isort/compare/5.12.0...5.13.2)
---
 .pre-commit-config.yaml       | 10 +++++-----
 ci/codespell-ignore-words.txt | 10 ++--------
 2 files changed, 7 insertions(+), 13 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index a60ec6ce0169..aba2f7462223 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -13,7 +13,7 @@ exclude: |
     )
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.4.0
+    rev: v4.5.0
     hooks:
       - id: check-added-large-files
       - id: check-docstring-first
@@ -27,7 +27,7 @@ repos:
       - id: trailing-whitespace
         exclude_types: [svg]
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.1.1
+    rev: v1.8.0
     hooks:
       - id: mypy
         additional_dependencies: [
@@ -44,13 +44,13 @@ repos:
         files: lib/matplotlib #only run when files in lib/matplotlib are changed
         pass_filenames: false
   - repo: https://github.com/pycqa/flake8
-    rev: 6.0.0
+    rev: 6.1.0
     hooks:
       - id: flake8
         additional_dependencies: [pydocstyle>5.1.0, flake8-docstrings>1.4.0, flake8-force]
         args: ["--docstring-convention=all"]
   - repo: https://github.com/codespell-project/codespell
-    rev: v2.2.5
+    rev: v2.2.6
     hooks:
       - id: codespell
         files: ^.*\.(py|c|cpp|h|m|md|rst|yml)$
@@ -61,7 +61,7 @@ repos:
           "doc/users/project/credits.rst"
           ]
   - repo: https://github.com/pycqa/isort
-    rev: 5.12.0
+    rev: 5.13.2
     hooks:
       - id: isort
         name: isort (python)
diff --git a/ci/codespell-ignore-words.txt b/ci/codespell-ignore-words.txt
index 1a29d054cdc3..acbb2e8f39b5 100644
--- a/ci/codespell-ignore-words.txt
+++ b/ci/codespell-ignore-words.txt
@@ -1,23 +1,17 @@
 aas
-ans
 axises
-ba
-cannotation
-ccompiler
 coo
 curvelinear
-dedented
-falsy
+filll
 flate
 fpt
 hax
-hist
 inh
 inout
 ment
 nd
+oint
 oly
-resizeable
 te
 thisy
 whis

From 928e58c4d8ca5ef18e2b51c0c492efaa2552039b Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Tue, 9 Jan 2024 13:19:22 +0000
Subject: [PATCH 0587/1120] Error on bad input to hexbin extents

---
 lib/matplotlib/axes/_axes.py      |  4 ++++
 lib/matplotlib/tests/test_axes.py | 12 ++++++++++++
 2 files changed, 16 insertions(+)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 74243b71a152..ecb0e611af89 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -4999,6 +4999,10 @@ def reduce_C_function(C: array) -> float
             ty = np.log10(ty)
         if extent is not None:
             xmin, xmax, ymin, ymax = extent
+            if xmin > xmax:
+                raise ValueError("In extent, xmax must be greater than xmin")
+            if ymin > ymax:
+                raise ValueError("In extent, ymax must be greater than ymin")
         else:
             xmin, xmax = (tx.min(), tx.max()) if len(x) else (0, 1)
             ymin, ymax = (ty.min(), ty.max()) if len(y) else (0, 1)
diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index d8d7cb0144f1..d77b1662cf63 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -962,6 +962,18 @@ def test_hexbin_extent():
     ax.hexbin("x", "y", extent=[.1, .3, .6, .7], data=data)
 
 
+def test_hexbin_bad_extents():
+    fig, ax = plt.subplots()
+    data = (np.arange(2000) / 2000).reshape((2, 1000))
+    x, y = data
+
+    with pytest.raises(ValueError, match="In extent, xmax must be greater than xmin"):
+        ax.hexbin(x, y, extent=(1, 0, 0, 1))
+
+    with pytest.raises(ValueError, match="In extent, ymax must be greater than ymin"):
+        ax.hexbin(x, y, extent=(0, 1, 1, 0))
+
+
 @image_comparison(['hexbin_empty.png'], remove_text=True)
 def test_hexbin_empty():
     # From #3886: creating hexbin from empty dataset raises ValueError

From ba1b58965b5d0d5472a772e16035df4548ad4c15 Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Tue, 9 Jan 2024 13:21:17 +0000
Subject: [PATCH 0588/1120] Fix PowerNorm docstring

Co-authored-by: Thomas A Caswell <tcaswell@gmail.com>
---
 lib/matplotlib/colors.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/colors.py b/lib/matplotlib/colors.py
index 5886b2065836..70e275fdaeca 100644
--- a/lib/matplotlib/colors.py
+++ b/lib/matplotlib/colors.py
@@ -1970,7 +1970,7 @@ class PowerNorm(Normalize):
 
         \left ( \frac{x - v_{min}}{v_{max}  - v_{min}} \right )^{\gamma}
 
-    For input values below *vmin*, gamma is set to zero.
+    For input values below *vmin*, gamma is set to one.
     """
     def __init__(self, gamma, vmin=None, vmax=None, clip=False):
         super().__init__(vmin, vmax, clip)

From 8b6748e977d6104f152d820b9c7d2527f004a318 Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Tue, 9 Jan 2024 13:22:23 +0000
Subject: [PATCH 0589/1120] Reduce size of test data

---
 lib/matplotlib/tests/test_colors.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/tests/test_colors.py b/lib/matplotlib/tests/test_colors.py
index 37b993ec8db7..d77077340e8c 100644
--- a/lib/matplotlib/tests/test_colors.py
+++ b/lib/matplotlib/tests/test_colors.py
@@ -598,7 +598,7 @@ def test_PowerNorm_translation_invariance():
 def test_powernorm_cbar_limits():
     fig, ax = plt.subplots()
     vmin, vmax = 300, 1000
-    data = np.arange(100*100).reshape(100, 100) + vmin
+    data = np.arange(10*10).reshape(10, 10) + vmin
     im = ax.imshow(data, norm=mcolors.PowerNorm(gamma=0.2, vmin=vmin, vmax=vmax))
     cbar = fig.colorbar(im)
     assert cbar.ax.get_ylim() == (vmin, vmax)

From 1b9b6dc3cd96708d68574983bebde399a27b7a1c Mon Sep 17 00:00:00 2001
From: Ruth Comer <ruth.comer@metoffice.gov.uk>
Date: Tue, 9 Jan 2024 15:17:06 +0000
Subject: [PATCH 0590/1120] DOC: simplify histogram animation example

---
 .../examples/animation/animated_histogram.py  | 39 ++++++++-----------
 1 file changed, 17 insertions(+), 22 deletions(-)

diff --git a/galleries/examples/animation/animated_histogram.py b/galleries/examples/animation/animated_histogram.py
index a5055f39c4e5..665dcffae0ac 100644
--- a/galleries/examples/animation/animated_histogram.py
+++ b/galleries/examples/animation/animated_histogram.py
@@ -12,38 +12,34 @@
 
 import matplotlib.animation as animation
 
-# Fixing random state for reproducibility
-np.random.seed(19680801)
-# Fixing bin edges
+# Setting up a random number generator with a fixed state for reproducibility.
+rng = np.random.default_rng(seed=19680801)
+# Fixing bin edges.
 HIST_BINS = np.linspace(-4, 4, 100)
 
-# histogram our data with numpy
-data = np.random.randn(1000)
+# Histogram our data with numpy.
+data = rng.standard_normal(1000)
 n, _ = np.histogram(data, HIST_BINS)
 
 # %%
 # To animate the histogram, we need an ``animate`` function, which generates
-# a random set of numbers and updates the heights of rectangles. We utilize a
-# python closure to track an instance of `.BarContainer` whose `.Rectangle`
-# patches we shall update.
+# a random set of numbers and updates the heights of rectangles. The ``animate``
+# function updates the `.Rectangle` patches on a global instance of
+# `.BarContainer` (which in this case is defined below).
 
 
-def prepare_animation(bar_container):
+def animate(frame_number):
+    # Simulate new data coming in.
+    data = rng.standard_normal(1000)
+    n, _ = np.histogram(data, HIST_BINS)
+    for count, rect in zip(n, bar_container.patches):
+        rect.set_height(count)
 
-    def animate(frame_number):
-        # simulate new data coming in
-        data = np.random.randn(1000)
-        n, _ = np.histogram(data, HIST_BINS)
-        for count, rect in zip(n, bar_container.patches):
-            rect.set_height(count)
-        return bar_container.patches
-    return animate
+    return bar_container.patches
 
 # %%
 # Using :func:`~matplotlib.pyplot.hist` allows us to get an instance of
-# `.BarContainer`, which is a collection of `.Rectangle` instances. Calling
-# ``prepare_animation`` will define ``animate`` function working with supplied
-# `.BarContainer`, all this is used to setup `.FuncAnimation`.
+# `.BarContainer`, which is a collection of `.Rectangle` instances.
 
 # Output generated via `matplotlib.animation.Animation.to_jshtml`.
 
@@ -52,8 +48,7 @@ def animate(frame_number):
                               ec="yellow", fc="green", alpha=0.5)
 ax.set_ylim(top=55)  # set safe limit to ensure that all data is visible.
 
-ani = animation.FuncAnimation(fig, prepare_animation(bar_container), 50,
-                              repeat=False, blit=True)
+ani = animation.FuncAnimation(fig, animate, 50, repeat=False, blit=True)
 plt.show()
 
 # %%

From 0ce2f2b07d6c41ba2da1f8d5fa069e8286372cf4 Mon Sep 17 00:00:00 2001
From: Ruth Comer <ruth.comer@metoffice.gov.uk>
Date: Tue, 9 Jan 2024 18:03:50 +0000
Subject: [PATCH 0591/1120] DOC: demonstrate use of partial in FuncAnimation

---
 galleries/examples/animation/animated_histogram.py | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/galleries/examples/animation/animated_histogram.py b/galleries/examples/animation/animated_histogram.py
index 665dcffae0ac..b040cc3c3442 100644
--- a/galleries/examples/animation/animated_histogram.py
+++ b/galleries/examples/animation/animated_histogram.py
@@ -7,6 +7,8 @@
 histogram.
 """
 
+import functools
+
 import matplotlib.pyplot as plt
 import numpy as np
 
@@ -24,11 +26,10 @@
 # %%
 # To animate the histogram, we need an ``animate`` function, which generates
 # a random set of numbers and updates the heights of rectangles. The ``animate``
-# function updates the `.Rectangle` patches on a global instance of
-# `.BarContainer` (which in this case is defined below).
+# function updates the `.Rectangle` patches on an instance of `.BarContainer`.
 
 
-def animate(frame_number):
+def animate(frame_number, bar_container):
     # Simulate new data coming in.
     data = rng.standard_normal(1000)
     n, _ = np.histogram(data, HIST_BINS)
@@ -39,7 +40,9 @@ def animate(frame_number):
 
 # %%
 # Using :func:`~matplotlib.pyplot.hist` allows us to get an instance of
-# `.BarContainer`, which is a collection of `.Rectangle` instances.
+# `.BarContainer`, which is a collection of `.Rectangle` instances.  Since
+# `.FuncAnimation` will only pass the frame number parameter to the animation
+# function, we use `functools.partial` to fix the ``bar_container`` parameter.
 
 # Output generated via `matplotlib.animation.Animation.to_jshtml`.
 
@@ -48,7 +51,8 @@ def animate(frame_number):
                               ec="yellow", fc="green", alpha=0.5)
 ax.set_ylim(top=55)  # set safe limit to ensure that all data is visible.
 
-ani = animation.FuncAnimation(fig, animate, 50, repeat=False, blit=True)
+anim = functools.partial(animate, bar_container=bar_container)
+ani = animation.FuncAnimation(fig, anim, 50, repeat=False, blit=True)
 plt.show()
 
 # %%

From 9fd9a42625e0aa3c223d5ecf0ccc15ff20efc107 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Tue, 9 Jan 2024 17:59:38 -0600
Subject: [PATCH 0592/1120] Prepare for Pytest v8

The behavior of pytest.warns has changed, particularly with regards to handling of additional warnings
---
 lib/matplotlib/tests/test_backend_pdf.py | 4 ++++
 lib/matplotlib/tests/test_colors.py      | 3 +--
 lib/matplotlib/tests/test_rcparams.py    | 6 ++----
 lib/matplotlib/tests/test_ticker.py      | 4 ++++
 4 files changed, 11 insertions(+), 6 deletions(-)

diff --git a/lib/matplotlib/tests/test_backend_pdf.py b/lib/matplotlib/tests/test_backend_pdf.py
index ae17c7a4a4e3..e6cdc34d452d 100644
--- a/lib/matplotlib/tests/test_backend_pdf.py
+++ b/lib/matplotlib/tests/test_backend_pdf.py
@@ -3,6 +3,7 @@
 import io
 import os
 from pathlib import Path
+import warnings
 
 import numpy as np
 import pytest
@@ -84,6 +85,9 @@ def test_multipage_keep_empty(tmp_path):
     os.chdir(tmp_path)
 
     # test empty pdf files
+    # Due to order of `with` block execution, a warning for unclosed file is raised
+    # but the pytest.warns must happen before the PdfPages is created
+    warnings.filterwarnings("ignore", category=ResourceWarning)
 
     # an empty pdf is left behind with keep_empty unset
     with pytest.warns(mpl.MatplotlibDeprecationWarning), PdfPages("a.pdf") as pdf:
diff --git a/lib/matplotlib/tests/test_colors.py b/lib/matplotlib/tests/test_colors.py
index 139efbe17407..73afc1da8a37 100644
--- a/lib/matplotlib/tests/test_colors.py
+++ b/lib/matplotlib/tests/test_colors.py
@@ -147,8 +147,7 @@ def test_double_register_builtin_cmap():
     with pytest.raises(ValueError, match='A colormap named "viridis"'):
         with pytest.warns(mpl.MatplotlibDeprecationWarning):
             cm.register_cmap(name, mpl.colormaps[name])
-    with pytest.warns(UserWarning):
-        # TODO is warning more than once!
+    with pytest.warns(UserWarning), pytest.warns(mpl.MatplotlibDeprecationWarning):
         cm.register_cmap(name, mpl.colormaps[name], override_builtin=True)
 
 
diff --git a/lib/matplotlib/tests/test_rcparams.py b/lib/matplotlib/tests/test_rcparams.py
index e3e10145533d..782c390c9462 100644
--- a/lib/matplotlib/tests/test_rcparams.py
+++ b/lib/matplotlib/tests/test_rcparams.py
@@ -106,14 +106,12 @@ def test_rcparams_update():
     rc = mpl.RcParams({'figure.figsize': (3.5, 42)})
     bad_dict = {'figure.figsize': (3.5, 42, 1)}
     # make sure validation happens on input
-    with pytest.raises(ValueError), \
-         pytest.warns(UserWarning, match="validate"):
+    with pytest.raises(ValueError):
         rc.update(bad_dict)
 
 
 def test_rcparams_init():
-    with pytest.raises(ValueError), \
-         pytest.warns(UserWarning, match="validate"):
+    with pytest.raises(ValueError):
         mpl.RcParams({'figure.figsize': (3.5, 42, 1)})
 
 
diff --git a/lib/matplotlib/tests/test_ticker.py b/lib/matplotlib/tests/test_ticker.py
index 12eafba9ea2b..1e15bade5d59 100644
--- a/lib/matplotlib/tests/test_ticker.py
+++ b/lib/matplotlib/tests/test_ticker.py
@@ -3,6 +3,7 @@
 import locale
 import logging
 import re
+import warnings
 
 import numpy as np
 from numpy.testing import assert_almost_equal, assert_array_equal
@@ -914,6 +915,9 @@ def test_mathtext_ticks(self):
             'axes.formatter.use_mathtext': False
         })
 
+        # Glyph warning unrelated
+        warnings.filterwarnings("ignore", category=UserWarning, message="Glyph 8722")
+
         with pytest.warns(UserWarning, match='cmr10 font should ideally'):
             fig, ax = plt.subplots()
             ax.set_xticks([-1, 0, 1])

From 762a790113f9d2510a7cc87b22979e8c55995beb Mon Sep 17 00:00:00 2001
From: Matthew Feickert <matthew.feickert@cern.ch>
Date: Wed, 10 Jan 2024 01:11:05 -0600
Subject: [PATCH 0593/1120] CI: Group dependabot updates

* Group dependabot updates to reduce the number of PRs.
   - c.f. sp-repo-review GH212: Require GHA update grouping
     https://learn.scientific-python.org/development/guides/gha-basic/#GH212
---
 .github/dependabot.yml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/.github/dependabot.yml b/.github/dependabot.yml
index 5ace4600a1f2..d15c975eaccb 100644
--- a/.github/dependabot.yml
+++ b/.github/dependabot.yml
@@ -4,3 +4,7 @@ updates:
     directory: "/"
     schedule:
       interval: "weekly"
+    groups:
+      actions:
+        patterns:
+          - "*"

From c62b3c4f34ba56c84047504fa2dca849222708b7 Mon Sep 17 00:00:00 2001
From: Faisal Fawad <76597599+faisal-fawad@users.noreply.github.com>
Date: Wed, 10 Jan 2024 03:19:30 -0500
Subject: [PATCH 0594/1120] Fix marker validator with cycler (allow mix of
 classes) #27613

Add test

Add stubs

Private functions & updated test

Update test

Co-authored-by: Kyle Sunden <git@ksunden.space>

Add test

Private functions & updated test
---
 lib/matplotlib/rcsetup.py           | 24 +++++++++++++++++++-----
 lib/matplotlib/rcsetup.pyi          |  2 ++
 lib/matplotlib/tests/test_cycles.py |  5 +++++
 3 files changed, 26 insertions(+), 5 deletions(-)

diff --git a/lib/matplotlib/rcsetup.py b/lib/matplotlib/rcsetup.py
index cf4dd07a6b98..f730db0dee3b 100644
--- a/lib/matplotlib/rcsetup.py
+++ b/lib/matplotlib/rcsetup.py
@@ -209,6 +209,20 @@ def validator(s):
     validate_float, doc='return a list of floats')
 
 
+def _validate_marker(s):
+    try:
+        return validate_int(s)
+    except ValueError as e:
+        try:
+            return validate_string(s)
+        except ValueError as e:
+            raise ValueError('Supported markers are [string, int]') from e
+
+
+_validate_markerlist = _listify_validator(
+    _validate_marker, doc='return a list of markers')
+
+
 def _validate_pathlike(s):
     if isinstance(s, (str, os.PathLike)):
         # Store value as str because savefig.directory needs to distinguish
@@ -645,7 +659,7 @@ def _validate_minor_tick_ndivs(n):
         'markeredgecolor': validate_colorlist,
         'markevery': validate_markeverylist,
         'alpha': validate_floatlist,
-        'marker': validate_stringlist,
+        'marker': _validate_markerlist,
         'hatch': validate_hatchlist,
         'dashes': validate_dashlist,
     }
@@ -908,7 +922,7 @@ def _convert_validator_spec(key, conv):
     "lines.linewidth":       validate_float,  # line width in points
     "lines.linestyle":       _validate_linestyle,  # solid line
     "lines.color":           validate_color,  # first color in color cycle
-    "lines.marker":          validate_string,  # marker name
+    "lines.marker":          _validate_marker,  # marker name
     "lines.markerfacecolor": validate_color_or_auto,  # default color
     "lines.markeredgecolor": validate_color_or_auto,  # default color
     "lines.markeredgewidth": validate_float,
@@ -957,7 +971,7 @@ def _convert_validator_spec(key, conv):
     "boxplot.meanline":    validate_bool,
 
     "boxplot.flierprops.color":           validate_color,
-    "boxplot.flierprops.marker":          validate_string,
+    "boxplot.flierprops.marker":          _validate_marker,
     "boxplot.flierprops.markerfacecolor": validate_color_or_auto,
     "boxplot.flierprops.markeredgecolor": validate_color,
     "boxplot.flierprops.markeredgewidth": validate_float,
@@ -982,7 +996,7 @@ def _convert_validator_spec(key, conv):
     "boxplot.medianprops.linestyle": _validate_linestyle,
 
     "boxplot.meanprops.color":           validate_color,
-    "boxplot.meanprops.marker":          validate_string,
+    "boxplot.meanprops.marker":          _validate_marker,
     "boxplot.meanprops.markerfacecolor": validate_color,
     "boxplot.meanprops.markeredgecolor": validate_color,
     "boxplot.meanprops.markersize":      validate_float,
@@ -1107,7 +1121,7 @@ def _convert_validator_spec(key, conv):
     "axes3d.zaxis.panecolor":    validate_color,  # 3d background pane
 
     # scatter props
-    "scatter.marker":     validate_string,
+    "scatter.marker":     _validate_marker,
     "scatter.edgecolors": validate_string,
 
     "date.epoch": _validate_date,
diff --git a/lib/matplotlib/rcsetup.pyi b/lib/matplotlib/rcsetup.pyi
index 70e94a7694a9..1538dac7510e 100644
--- a/lib/matplotlib/rcsetup.pyi
+++ b/lib/matplotlib/rcsetup.pyi
@@ -39,6 +39,8 @@ def validate_int_or_None(s: Any) -> int | None: ...
 def validate_float(s: Any) -> float: ...
 def validate_float_or_None(s: Any) -> float | None: ...
 def validate_floatlist(s: Any) -> list[float]: ...
+def _validate_marker(s: Any) -> int | str: ...
+def _validate_markerlist(s: Any) -> list[int | str]: ...
 def validate_fonttype(s: Any) -> int: ...
 
 _auto_backend_sentinel: object
diff --git a/lib/matplotlib/tests/test_cycles.py b/lib/matplotlib/tests/test_cycles.py
index 9bbb9bc9f19c..4fa261619490 100644
--- a/lib/matplotlib/tests/test_cycles.py
+++ b/lib/matplotlib/tests/test_cycles.py
@@ -27,6 +27,11 @@ def test_marker_cycle():
     assert [l.get_marker() for l in ax.lines] == ['.', '*', 'x', '.']
 
 
+def test_valid_marker_cycles():
+    fig, ax = plt.subplots()
+    ax.set_prop_cycle(cycler(marker=[1, "+", ".", 4]))
+
+
 def test_marker_cycle_kwargs_arrays_iterators():
     fig, ax = plt.subplots()
     ax.set_prop_cycle(c=np.array(['r', 'g', 'y']),

From df3f93c71f3dd4062ddb8b1dc37d32ce0c6199b6 Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Wed, 10 Jan 2024 10:27:50 +0000
Subject: [PATCH 0595/1120] Reduce size of test data

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>
---
 lib/matplotlib/tests/test_axes.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index d77b1662cf63..e3379b7ed78f 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -964,7 +964,7 @@ def test_hexbin_extent():
 
 def test_hexbin_bad_extents():
     fig, ax = plt.subplots()
-    data = (np.arange(2000) / 2000).reshape((2, 1000))
+    data = (np.arange(20) / 20).reshape((2, 10))
     x, y = data
 
     with pytest.raises(ValueError, match="In extent, xmax must be greater than xmin"):

From 7ab966dacd62504ced169fc12cf57dcf57dcf287 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 10 Jan 2024 10:32:55 +0000
Subject: [PATCH 0596/1120] Bump the actions group with 2 updates

Bumps the actions group with 2 updates: [actions/upload-artifact](https://github.com/actions/upload-artifact) and [actions/download-artifact](https://github.com/actions/download-artifact).


Updates `actions/upload-artifact` from 3 to 4
- [Release notes](https://github.com/actions/upload-artifact/releases)
- [Commits](https://github.com/actions/upload-artifact/compare/v3...v4)

Updates `actions/download-artifact` from 3 to 4
- [Release notes](https://github.com/actions/download-artifact/releases)
- [Commits](https://github.com/actions/download-artifact/compare/v3...v4)

---
updated-dependencies:
- dependency-name: actions/upload-artifact
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: actions
- dependency-name: actions/download-artifact
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: actions
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 .github/workflows/cibuildwheel.yml | 6 +++---
 .github/workflows/tests.yml        | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 23c05a7629d0..cced163a4af6 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -69,7 +69,7 @@ jobs:
         run: twine check dist/*
 
       - name: Upload sdist result
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: sdist
           path: dist/*.tar.gz
@@ -140,7 +140,7 @@ jobs:
           platforms: arm64
 
       - name: Download sdist
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           name: sdist
           path: dist/
@@ -186,7 +186,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
         if: matrix.cibw_archs != 'aarch64'
 
-      - uses: actions/upload-artifact@v3
+      - uses: actions/upload-artifact@v4
         with:
           name: wheels
           path: ./wheelhouse/*.whl
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 1ffa9c7524a5..2e40b29cc449 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -339,7 +339,7 @@ jobs:
         with:
           name: "${{ matrix.python-version }} ${{ matrix.os }} ${{ matrix.name-suffix }}"
 
-      - uses: actions/upload-artifact@v3
+      - uses: actions/upload-artifact@v4
         if: failure()
         with:
           name: "${{ matrix.python-version }} ${{ matrix.os }} ${{ matrix.name-suffix }} result images"

From 198de8ab9596e5c13ff3b3036660d9103867e5ba Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Wed, 10 Jan 2024 13:28:35 +0000
Subject: [PATCH 0597/1120] Don't run push CI on dependabot branhches

---
 .github/workflows/tests.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 1ffa9c7524a5..a33bfe5680ad 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -9,6 +9,7 @@ on:
     branches-ignore:
       - auto-backport-of-pr-[0-9]+
       - v[0-9]+.[0-9]+.[0-9x]+-doc
+      - dependabot/**
   pull_request:
     branches-ignore:
       - v[0-9]+.[0-9]+.[0-9x]+-doc

From db875f5f2da2ab5fdfded2ef1901da0d4c36d6b3 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 10 Jan 2024 19:09:41 -0500
Subject: [PATCH 0598/1120] Auto-label PRs that modify conditional CI config

Namely, the cibuildwheel and Cygwin workflows.
---
 .github/labeler.yml           |  5 +++++
 .github/workflows/labeler.yml | 15 +++++++++++++++
 2 files changed, 20 insertions(+)
 create mode 100644 .github/labeler.yml
 create mode 100644 .github/workflows/labeler.yml

diff --git a/.github/labeler.yml b/.github/labeler.yml
new file mode 100644
index 000000000000..58e3f887d5ec
--- /dev/null
+++ b/.github/labeler.yml
@@ -0,0 +1,5 @@
+---
+"CI: Run cibuildwheel":
+  - any-glob-to-any-file: ['.github/workflows/cibuildwheel.yml']
+"CI: Run cygwin":
+  - any-glob-to-any-file: ['.github/workflows/cygwin.yml']
diff --git a/.github/workflows/labeler.yml b/.github/workflows/labeler.yml
new file mode 100644
index 000000000000..dc7a0716bfe8
--- /dev/null
+++ b/.github/workflows/labeler.yml
@@ -0,0 +1,15 @@
+---
+name: "Pull Request Labeler"
+on:
+  - pull_request_target
+
+jobs:
+  labeler:
+    permissions:
+      contents: read
+      pull-requests: write
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/labeler@v5
+        with:
+          sync-labels: true

From db5c33a1f2d3c54349f6902ce89dc3e238f89e89 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 10 Jan 2024 19:32:56 -0500
Subject: [PATCH 0599/1120] Auto-label PRs that change backend files

---
 .github/labeler.yml | 55 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 55 insertions(+)

diff --git a/.github/labeler.yml b/.github/labeler.yml
index 58e3f887d5ec..920206ac0ad3 100644
--- a/.github/labeler.yml
+++ b/.github/labeler.yml
@@ -3,3 +3,58 @@
   - any-glob-to-any-file: ['.github/workflows/cibuildwheel.yml']
 "CI: Run cygwin":
   - any-glob-to-any-file: ['.github/workflows/cygwin.yml']
+
+"backend: agg":
+  - any-glob-to-any-file:
+      - 'extern/agg24-svn/'
+      - 'lib/matplotlib/backends/_backend_agg.pyi'
+      - 'lib/matplotlib/backends/backend_agg.py*'
+      - 'src/_backend_agg*'
+"backend: cairo":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/backends/backend_*cairo.py*'
+"backend: pdf":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/backends/_backend_pdf_ps.py'
+      - 'lib/matplotlib/backends/backend_pdf.py'
+"backend: pgf":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/backends/backend_pgf.py'
+"backend: ps":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/backends/_backend_pdf_ps.py'
+      - 'lib/matplotlib/backends/backend_ps.py'
+"backend: svg":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/backends/backend_svg.py'
+
+"GUI: gtk":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/backends/_backend_gtk.py*'
+      - 'lib/matplotlib/backends/backend_gtk*'
+"GUI: MacOSX":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/backends/*_macosx.py*'
+      - 'src/_macosx.m'
+"GUI: nbagg":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/backends/*_nbagg*.py*'
+      - 'lib/matplotlib/backends/web_backend/js/nbagg_mpl.js'
+"GUI: Qt":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/backends/backend_qt*'
+      - 'lib/matplotlib/backends/qt_compat.py'
+      - 'lib/matplotlib/backends/qt_editor/**'
+"GUI: tk":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/backends/*backend_tk*'
+      - 'lib/matplotlib/backends/_tkagg.pyi'
+      - 'src/_tkagg.cpp'
+      - 'src/_tkmini.h'
+"GUI: webagg":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/backends/*_webagg*.py*'
+      - 'lib/matplotlib/backends/web_backend/**'
+"GUI: wx":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/backends/backend_wx*.py*'

From 6255ca05adc3091b79ec7700d1fbb90d930965de Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 10 Jan 2024 20:19:41 -0500
Subject: [PATCH 0600/1120] Auto-label PR topics based on changed files

This is not comprehensive as not all topics are split into individual
files.
---
 .github/labeler.yml | 132 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 132 insertions(+)

diff --git a/.github/labeler.yml b/.github/labeler.yml
index 920206ac0ad3..de40c1cc57ae 100644
--- a/.github/labeler.yml
+++ b/.github/labeler.yml
@@ -58,3 +58,135 @@
 "GUI: wx":
   - any-glob-to-any-file:
       - 'lib/matplotlib/backends/backend_wx*.py*'
+
+"topic: animation":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/animation.py*'
+      - 'lib/matplotlib/_animation_data.py*'
+"topic: axes":
+  - any-glob-to-any-file:
+      # Note, axes.py is not included here because it contains many plotting
+      # methods, for which changes would not be considered on topic.
+      - 'lib/matplotlib/axes/_base.py*'
+"topic: canvas and figure manager":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/backend_bases.py*'
+"topic: categorical":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/category.py*'
+"topic: collections and mappables":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/collections.py*'
+"topic: color/color & colormaps":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/colorbar.py*'
+      - 'lib/matplotlib/colors.py*'
+      - 'lib/matplotlib/_color_data.py*'
+      - 'lib/matplotlib/cm.py*'
+      - 'lib/matplotlib/_cm.py*'
+      - 'lib/matplotlib/_cm_listed.py*'
+"topic: contour":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/contour.py*'
+      - 'src/_qhull_wrapper.cpp'
+"topic: date handling":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/dates.py*'
+"topic: figures and subfigures":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/figure.py*'
+"topic: geometry manager":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/_constrained_layout.py*'
+      - 'lib/matplotlib/_layoutgrid.py*'
+      - 'lib/matplotlib/_tight_bbox.py*'
+      - 'lib/matplotlib/_tight_layout.py*'
+      - 'lib/matplotlib/gridspec.py*'
+      - 'lib/matplotlib/layout_engine.py*'
+"topic: hatch":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/hatch.py*'
+"topic: images":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/image.py*'
+      - 'lib/matplotlib/_image.pyi'
+      - 'src/_image_*'
+"topic: legend":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/legend.py*'
+      - 'lib/matplotlib/legend_handler.py*'
+"topic: markers":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/markers.py*'
+"topic: mpl_toolkit":
+  - any-glob-to-any-file:
+      - 'lib/mpl_toolkits/**'
+  - all-globs-to-all-files:
+      - '!lib/mpl_toolkits/mplot3d/**'
+"topic: mplot3d":
+  - any-glob-to-any-file:
+      - 'lib/mpl_toolkits/mplot3d/**'
+"topic: path handling":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/path.py*'
+      - 'lib/matplotlib/patheffects.py*'
+      - 'lib/matplotlib/_path.pyi'
+      - 'src/*path*'
+"topic: polar":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/projections/polar.py*'
+"topic: pyplot API":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/pyplot.py'
+      - 'lib/matplotlib/_pylab_helpers.py*'
+"topic: rcparams":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/rcsetup.py*'
+"topic: sankey":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/sankey.py*'
+"topic: sphinx extension":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/sphinxext/**'
+"topic: styles":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/mpl-data/stylelib/**'
+      - 'lib/matplotlib/style/**'
+"topic: table":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/table.py*'
+"topic: text":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/text.py*'
+      - 'lib/matplotlib/textpath.py*'
+"topic: text/fonts":
+  - any-glob-to-any-file:
+      - 'src/checkdep_freetype2.c'
+      - 'src/ft2font*'
+"topic: text/mathtext":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/mathtext.py*'
+      - 'lib/matplotlib/_mathtext.py*'
+      - 'lib/matplotlib/_mathtext_data.py*'
+"topic: ticks axis labels":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/axis.py*'
+      - 'lib/matplotlib/ticker.py*'
+"topic: toolbar":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/backend_managers.py*'
+      - 'lib/matplotlib/backend_tools.py*'
+"topic: transforms and scales":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/scale.py*'
+      - 'lib/matplotlib/transforms.py*'
+"topic: tri":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/tri/**'
+      - 'src/tri/**'
+"topic: units and array ducktypes":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/units.py*'
+"topic: widgets/UI":
+  - any-glob-to-any-file:
+      - 'lib/matplotlib/widgets.py*'

From bb144224a18ca1a632592dc49fec2e36b793295f Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 10 Jan 2024 21:48:28 -0500
Subject: [PATCH 0601/1120] circle: Make deploy stage into a normal step

Circle is warning about this being deprecated:
https://circleci.com/docs/migrate-from-deploy-to-run/
---
 .circleci/config.yml | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/.circleci/config.yml b/.circleci/config.yml
index 2f79a6fbba5c..995043c3e602 100644
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -1,6 +1,6 @@
 # Circle CI configuration file
 # https://circleci.com/docs/
-
+---
 version: 2.1
 
 
@@ -199,6 +199,12 @@ commands:
       - store_artifacts:
           path: doc/build/sphinx-gallery-files.tar.gz
 
+  deploy-docs:
+    steps:
+      - run:
+          name: "Deploy new docs"
+          command: ./.circleci/deploy-docs.sh
+
 
 ##########################################
 # Here is where the real jobs are defined.
@@ -236,9 +242,7 @@ jobs:
           fingerprints:
             - "be:c3:c1:d8:fb:a1:0e:37:71:72:d7:a3:40:13:8f:14"
 
-      - deploy:
-          name: "Deploy new docs"
-          command: ./.circleci/deploy-docs.sh
+      - deploy-docs
 
 #########################################
 # Defining workflows gets us parallelism.

From 463c73fc483721d5706b811908c5bcc78d5bfbe9 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 11 Jan 2024 03:07:59 -0500
Subject: [PATCH 0602/1120] Auto-label PRs that change documentation

---
 .github/labeler.yml | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/.github/labeler.yml b/.github/labeler.yml
index de40c1cc57ae..c57689a5f9ae 100644
--- a/.github/labeler.yml
+++ b/.github/labeler.yml
@@ -59,6 +59,32 @@
   - any-glob-to-any-file:
       - 'lib/matplotlib/backends/backend_wx*.py*'
 
+"Documentation: API":
+  - any-glob-to-any-file:
+      # Also files in lib/**, but we can't be sure those are only documentation.
+      - 'doc/api/**'
+"Documentation: build":
+  - any-glob-to-any-file:
+      - 'doc/conf.py'
+      - 'doc/Makefile'
+      - 'doc/make.bat'
+"Documentation: devdocs":
+  - any-glob-to-any-file:
+      - 'doc/devel/**'
+"Documentation: examples":
+  - any-glob-to-any-file:
+      - 'galleries/examples/**'
+"Documentation: plot types":
+  - any-glob-to-any-file:
+      - 'galleries/plot_types/**'
+"Documentation: tutorials":
+  - any-glob-to-any-file:
+      - 'galleries/tutorials/**'
+"Documentation: user guide":
+  - any-glob-to-any-file:
+      - 'doc/users/**'
+      - 'galleries/users_explain/**'
+
 "topic: animation":
   - any-glob-to-any-file:
       - 'lib/matplotlib/animation.py*'

From 1f53454fe290092be28e301ec651fd9dce87dd09 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Thu, 11 Jan 2024 13:58:43 -0600
Subject: [PATCH 0603/1120] Use context manager to supress certain warnings

---
 lib/matplotlib/tests/test_backend_pdf.py | 71 ++++++++++++------------
 lib/matplotlib/tests/test_colors.py      |  8 ++-
 lib/matplotlib/tests/test_ticker.py      | 13 +++--
 3 files changed, 50 insertions(+), 42 deletions(-)

diff --git a/lib/matplotlib/tests/test_backend_pdf.py b/lib/matplotlib/tests/test_backend_pdf.py
index e6cdc34d452d..f6497bc01c78 100644
--- a/lib/matplotlib/tests/test_backend_pdf.py
+++ b/lib/matplotlib/tests/test_backend_pdf.py
@@ -87,41 +87,42 @@ def test_multipage_keep_empty(tmp_path):
     # test empty pdf files
     # Due to order of `with` block execution, a warning for unclosed file is raised
     # but the pytest.warns must happen before the PdfPages is created
-    warnings.filterwarnings("ignore", category=ResourceWarning)
-
-    # an empty pdf is left behind with keep_empty unset
-    with pytest.warns(mpl.MatplotlibDeprecationWarning), PdfPages("a.pdf") as pdf:
-        pass
-    assert os.path.exists("a.pdf")
-
-    # an empty pdf is left behind with keep_empty=True
-    with pytest.warns(mpl.MatplotlibDeprecationWarning), \
-            PdfPages("b.pdf", keep_empty=True) as pdf:
-        pass
-    assert os.path.exists("b.pdf")
-
-    # an empty pdf deletes itself afterwards with keep_empty=False
-    with PdfPages("c.pdf", keep_empty=False) as pdf:
-        pass
-    assert not os.path.exists("c.pdf")
-
-    # test pdf files with content, they should never be deleted
-
-    # a non-empty pdf is left behind with keep_empty unset
-    with PdfPages("d.pdf") as pdf:
-        pdf.savefig(plt.figure())
-    assert os.path.exists("d.pdf")
-
-    # a non-empty pdf is left behind with keep_empty=True
-    with pytest.warns(mpl.MatplotlibDeprecationWarning), \
-            PdfPages("e.pdf", keep_empty=True) as pdf:
-        pdf.savefig(plt.figure())
-    assert os.path.exists("e.pdf")
-
-    # a non-empty pdf is left behind with keep_empty=False
-    with PdfPages("f.pdf", keep_empty=False) as pdf:
-        pdf.savefig(plt.figure())
-    assert os.path.exists("f.pdf")
+    with warnings.catch_warnings():
+        warnings.filterwarnings("ignore", category=ResourceWarning)
+
+        # an empty pdf is left behind with keep_empty unset
+        with pytest.warns(mpl.MatplotlibDeprecationWarning), PdfPages("a.pdf") as pdf:
+            pass
+        assert os.path.exists("a.pdf")
+
+        # an empty pdf is left behind with keep_empty=True
+        with pytest.warns(mpl.MatplotlibDeprecationWarning), \
+                PdfPages("b.pdf", keep_empty=True) as pdf:
+            pass
+        assert os.path.exists("b.pdf")
+
+        # an empty pdf deletes itself afterwards with keep_empty=False
+        with PdfPages("c.pdf", keep_empty=False) as pdf:
+            pass
+        assert not os.path.exists("c.pdf")
+
+        # test pdf files with content, they should never be deleted
+
+        # a non-empty pdf is left behind with keep_empty unset
+        with PdfPages("d.pdf") as pdf:
+            pdf.savefig(plt.figure())
+        assert os.path.exists("d.pdf")
+
+        # a non-empty pdf is left behind with keep_empty=True
+        with pytest.warns(mpl.MatplotlibDeprecationWarning), \
+                PdfPages("e.pdf", keep_empty=True) as pdf:
+            pdf.savefig(plt.figure())
+        assert os.path.exists("e.pdf")
+
+        # a non-empty pdf is left behind with keep_empty=False
+        with PdfPages("f.pdf", keep_empty=False) as pdf:
+            pdf.savefig(plt.figure())
+        assert os.path.exists("f.pdf")
 
 
 def test_composite_image():
diff --git a/lib/matplotlib/tests/test_colors.py b/lib/matplotlib/tests/test_colors.py
index 73afc1da8a37..b8f381f91082 100644
--- a/lib/matplotlib/tests/test_colors.py
+++ b/lib/matplotlib/tests/test_colors.py
@@ -1,6 +1,7 @@
 import copy
 import itertools
 import unittest.mock
+import warnings
 
 from io import BytesIO
 import numpy as np
@@ -147,8 +148,11 @@ def test_double_register_builtin_cmap():
     with pytest.raises(ValueError, match='A colormap named "viridis"'):
         with pytest.warns(mpl.MatplotlibDeprecationWarning):
             cm.register_cmap(name, mpl.colormaps[name])
-    with pytest.warns(UserWarning), pytest.warns(mpl.MatplotlibDeprecationWarning):
-        cm.register_cmap(name, mpl.colormaps[name], override_builtin=True)
+
+    with warnings.catch_warnings():
+        warnings.filterwarnings("ignore", category=mpl.MatplotlibDeprecationWarning)
+        with pytest.warns(UserWarning):
+            cm.register_cmap(name, mpl.colormaps[name], override_builtin=True)
 
 
 def test_unregister_builtin_cmap():
diff --git a/lib/matplotlib/tests/test_ticker.py b/lib/matplotlib/tests/test_ticker.py
index 1e15bade5d59..67e3764f0d2c 100644
--- a/lib/matplotlib/tests/test_ticker.py
+++ b/lib/matplotlib/tests/test_ticker.py
@@ -916,12 +916,15 @@ def test_mathtext_ticks(self):
         })
 
         # Glyph warning unrelated
-        warnings.filterwarnings("ignore", category=UserWarning, message="Glyph 8722")
+        with warnings.catch_warnings():
+            warnings.filterwarnings(
+                "ignore", category=UserWarning, message="Glyph 8722"
+            )
 
-        with pytest.warns(UserWarning, match='cmr10 font should ideally'):
-            fig, ax = plt.subplots()
-            ax.set_xticks([-1, 0, 1])
-            fig.canvas.draw()
+            with pytest.warns(UserWarning, match='cmr10 font should ideally'):
+                fig, ax = plt.subplots()
+                ax.set_xticks([-1, 0, 1])
+                fig.canvas.draw()
 
     def test_cmr10_substitutions(self, caplog):
         mpl.rcParams.update({

From be817936095dd07b760ad5e256cdc8b32f9bf80f Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Thu, 11 Jan 2024 15:15:00 -0500
Subject: [PATCH 0604/1120] Doc: typo fix for #22699

Got merged with small typo in docstring (surprised it wasn't caught by the pre-commit :/) so fixed that. Also added a comma b/c phrase seemed parenthetical.
---
 lib/matplotlib/_docstring.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/_docstring.py b/lib/matplotlib/_docstring.py
index b49d5b43f068..f44d7b2c7674 100644
--- a/lib/matplotlib/_docstring.py
+++ b/lib/matplotlib/_docstring.py
@@ -8,14 +8,14 @@ def kwarg_doc(text):
     Decorator for defining the kwdoc documentation of artist properties.
 
     This decorator can be applied to artist property setter methods.
-    The given text is stored in a privat attribute ``_kwarg_doc`` on
+    The given text is stored in a private attribute ``_kwarg_doc`` on
     the method.  It is used to overwrite auto-generated documentation
     in the *kwdoc list* for artists. The kwdoc list is used to document
     ``**kwargs`` when they are properties of an artist. See e.g. the
     ``**kwargs`` section in `.Axes.text`.
 
-    The text should contain the supported types as well as the default value
-    if applicable, e.g.:
+    The text should contain the supported types, as well as the default
+    value if applicable, e.g.:
 
         @_docstring.kwarg_doc("bool, default: :rc:`text.usetex`")
         def set_usetex(self, usetex):

From 1b56d96a1fbe0af2b8e0eec8a2aa071ba792a982 Mon Sep 17 00:00:00 2001
From: Jaroza727 <jaroza@umich.edu>
Date: Fri, 11 Dec 2020 20:47:07 -0500
Subject: [PATCH 0605/1120] added format_cursor_data function to
 NonUniformImage class

---
 lib/matplotlib/image.py | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/image.py b/lib/matplotlib/image.py
index 0ab02c403d0d..222896943d77 100644
--- a/lib/matplotlib/image.py
+++ b/lib/matplotlib/image.py
@@ -1038,7 +1038,6 @@ def get_cursor_data(self, event):
 
 
 class NonUniformImage(AxesImage):
-    mouseover = False  # This class still needs its own get_cursor_data impl.
 
     def __init__(self, ax, *, interpolation='nearest', **kwargs):
         """
@@ -1190,6 +1189,19 @@ def set_cmap(self, cmap):
             raise RuntimeError('Cannot change colors after loading data')
         super().set_cmap(cmap)
 
+    def get_cursor_data(self, event):
+        # docstring inherited
+        x, y = event.xdata, event.ydata
+        if (x < self._Ax[0] or x > self._Ax[-1] or
+                y < self._Ay[0] or y > self._Ay[-1]):
+            return None
+        j = np.searchsorted(self._Ax, x) - 1
+        i = np.searchsorted(self._Ay, y) - 1
+        try:
+            return self._A[i, j]
+        except IndexError:
+            return None
+
 
 class PcolorImage(AxesImage):
     """

From 2c8bb0d00b5be1c5b738941edd9b766f1d15862e Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Thu, 11 Jan 2024 21:10:00 +0000
Subject: [PATCH 0606/1120] Add NonUniformImage cursor format test

---
 lib/matplotlib/tests/test_image.py | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/lib/matplotlib/tests/test_image.py b/lib/matplotlib/tests/test_image.py
index 9a40b9baa313..8de9ee79bfb3 100644
--- a/lib/matplotlib/tests/test_image.py
+++ b/lib/matplotlib/tests/test_image.py
@@ -365,6 +365,33 @@ def test_cursor_data():
     assert im.get_cursor_data(event) == 44
 
 
+@pytest.mark.parametrize("xy, data", [
+    [[0.5, 0.5], 0 + 0],
+    [[0.5, 1.5], 0 + 1],
+    [[4.5, 0.5], 16 + 0],
+    [[9.5, 2.5], 81 + 4]
+    ]
+)
+def test_cursor_data_nonuniform(xy, data):
+    from matplotlib.backend_bases import MouseEvent
+
+    # Non-linear set of x-values
+    x = np.array([0, 1, 4, 9, 16])
+    y = np.array([0, 1, 2, 3, 4])
+    z = x[np.newaxis, :]**2 + y[:, np.newaxis]**2
+
+    fig, ax = plt.subplots()
+    im = NonUniformImage(ax, extent=(x.min(), x.max(), y.min(), y.max()))
+    im.set_data(x, y, z)
+    ax.add_image(im)
+    ax.set_xlim(x.min(), x.max())
+    ax.set_ylim(y.min(), y.max())
+
+    xdisp, ydisp = ax.transData.transform(xy)
+    event = MouseEvent('motion_notify_event', fig.canvas, xdisp, ydisp)
+    assert im.get_cursor_data(event) == data, (im.get_cursor_data(event), data)
+
+
 @pytest.mark.parametrize(
     "data, text", [
         ([[10001, 10000]], "[10001.000]"),

From 99f7b7d6c6168ccdba6361c105b3b760bc95a03b Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Thu, 11 Jan 2024 21:11:24 +0000
Subject: [PATCH 0607/1120] Add note on xy test values

---
 lib/matplotlib/tests/test_image.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/lib/matplotlib/tests/test_image.py b/lib/matplotlib/tests/test_image.py
index 8de9ee79bfb3..daeb1877fd67 100644
--- a/lib/matplotlib/tests/test_image.py
+++ b/lib/matplotlib/tests/test_image.py
@@ -366,6 +366,7 @@ def test_cursor_data():
 
 
 @pytest.mark.parametrize("xy, data", [
+    # x/y coords chosen to be 0.5 above boundaries so they lie within image pixels
     [[0.5, 0.5], 0 + 0],
     [[0.5, 1.5], 0 + 1],
     [[4.5, 0.5], 16 + 0],

From 381cacf74afffff5da425d94e14fbf922b3209ea Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Thu, 11 Jan 2024 21:14:18 +0000
Subject: [PATCH 0608/1120] Add extra test case

---
 lib/matplotlib/tests/test_image.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/lib/matplotlib/tests/test_image.py b/lib/matplotlib/tests/test_image.py
index daeb1877fd67..638fd5696acf 100644
--- a/lib/matplotlib/tests/test_image.py
+++ b/lib/matplotlib/tests/test_image.py
@@ -370,6 +370,7 @@ def test_cursor_data():
     [[0.5, 0.5], 0 + 0],
     [[0.5, 1.5], 0 + 1],
     [[4.5, 0.5], 16 + 0],
+    [[8.5, 0.5], 16 + 0],
     [[9.5, 2.5], 81 + 4]
     ]
 )

From bd3a6f17db490f54fd589af04ad0000d5768386d Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Thu, 11 Jan 2024 15:33:21 -0600
Subject: [PATCH 0609/1120] Version gate instead of ignoring, fix PDF to always
 properly close empty files

---
 lib/matplotlib/backends/backend_pdf.py   |  3 +-
 lib/matplotlib/tests/test_backend_pdf.py | 73 +++++++++++-------------
 lib/matplotlib/tests/test_colors.py      |  8 ++-
 lib/matplotlib/tests/test_ticker.py      | 15 ++---
 4 files changed, 49 insertions(+), 50 deletions(-)

diff --git a/lib/matplotlib/backends/backend_pdf.py b/lib/matplotlib/backends/backend_pdf.py
index d66e199b25b2..87f83af87061 100644
--- a/lib/matplotlib/backends/backend_pdf.py
+++ b/lib/matplotlib/backends/backend_pdf.py
@@ -2708,6 +2708,7 @@ def __enter__(self):
         return self
 
     def __exit__(self, exc_type, exc_val, exc_tb):
+        print(f"Closing file {self._filename}")
         self.close()
 
     def _ensure_file(self):
@@ -2728,7 +2729,7 @@ def close(self):
             _api.warn_deprecated("3.8", message=(
                 "Keeping empty pdf files is deprecated since %(since)s and support "
                 "will be removed %(removal)s."))
-            PdfFile(self._filename, metadata=self._metadata)  # touch the file.
+            PdfFile(self._filename, metadata=self._metadata).close()  # touch the file.
 
     def infodict(self):
         """
diff --git a/lib/matplotlib/tests/test_backend_pdf.py b/lib/matplotlib/tests/test_backend_pdf.py
index f6497bc01c78..ae17c7a4a4e3 100644
--- a/lib/matplotlib/tests/test_backend_pdf.py
+++ b/lib/matplotlib/tests/test_backend_pdf.py
@@ -3,7 +3,6 @@
 import io
 import os
 from pathlib import Path
-import warnings
 
 import numpy as np
 import pytest
@@ -85,44 +84,40 @@ def test_multipage_keep_empty(tmp_path):
     os.chdir(tmp_path)
 
     # test empty pdf files
-    # Due to order of `with` block execution, a warning for unclosed file is raised
-    # but the pytest.warns must happen before the PdfPages is created
-    with warnings.catch_warnings():
-        warnings.filterwarnings("ignore", category=ResourceWarning)
-
-        # an empty pdf is left behind with keep_empty unset
-        with pytest.warns(mpl.MatplotlibDeprecationWarning), PdfPages("a.pdf") as pdf:
-            pass
-        assert os.path.exists("a.pdf")
-
-        # an empty pdf is left behind with keep_empty=True
-        with pytest.warns(mpl.MatplotlibDeprecationWarning), \
-                PdfPages("b.pdf", keep_empty=True) as pdf:
-            pass
-        assert os.path.exists("b.pdf")
-
-        # an empty pdf deletes itself afterwards with keep_empty=False
-        with PdfPages("c.pdf", keep_empty=False) as pdf:
-            pass
-        assert not os.path.exists("c.pdf")
-
-        # test pdf files with content, they should never be deleted
-
-        # a non-empty pdf is left behind with keep_empty unset
-        with PdfPages("d.pdf") as pdf:
-            pdf.savefig(plt.figure())
-        assert os.path.exists("d.pdf")
-
-        # a non-empty pdf is left behind with keep_empty=True
-        with pytest.warns(mpl.MatplotlibDeprecationWarning), \
-                PdfPages("e.pdf", keep_empty=True) as pdf:
-            pdf.savefig(plt.figure())
-        assert os.path.exists("e.pdf")
-
-        # a non-empty pdf is left behind with keep_empty=False
-        with PdfPages("f.pdf", keep_empty=False) as pdf:
-            pdf.savefig(plt.figure())
-        assert os.path.exists("f.pdf")
+
+    # an empty pdf is left behind with keep_empty unset
+    with pytest.warns(mpl.MatplotlibDeprecationWarning), PdfPages("a.pdf") as pdf:
+        pass
+    assert os.path.exists("a.pdf")
+
+    # an empty pdf is left behind with keep_empty=True
+    with pytest.warns(mpl.MatplotlibDeprecationWarning), \
+            PdfPages("b.pdf", keep_empty=True) as pdf:
+        pass
+    assert os.path.exists("b.pdf")
+
+    # an empty pdf deletes itself afterwards with keep_empty=False
+    with PdfPages("c.pdf", keep_empty=False) as pdf:
+        pass
+    assert not os.path.exists("c.pdf")
+
+    # test pdf files with content, they should never be deleted
+
+    # a non-empty pdf is left behind with keep_empty unset
+    with PdfPages("d.pdf") as pdf:
+        pdf.savefig(plt.figure())
+    assert os.path.exists("d.pdf")
+
+    # a non-empty pdf is left behind with keep_empty=True
+    with pytest.warns(mpl.MatplotlibDeprecationWarning), \
+            PdfPages("e.pdf", keep_empty=True) as pdf:
+        pdf.savefig(plt.figure())
+    assert os.path.exists("e.pdf")
+
+    # a non-empty pdf is left behind with keep_empty=False
+    with PdfPages("f.pdf", keep_empty=False) as pdf:
+        pdf.savefig(plt.figure())
+    assert os.path.exists("f.pdf")
 
 
 def test_composite_image():
diff --git a/lib/matplotlib/tests/test_colors.py b/lib/matplotlib/tests/test_colors.py
index b8f381f91082..35030b6bea7a 100644
--- a/lib/matplotlib/tests/test_colors.py
+++ b/lib/matplotlib/tests/test_colors.py
@@ -1,7 +1,7 @@
 import copy
 import itertools
 import unittest.mock
-import warnings
+from packaging.version import parse as parse_version
 
 from io import BytesIO
 import numpy as np
@@ -149,10 +149,12 @@ def test_double_register_builtin_cmap():
         with pytest.warns(mpl.MatplotlibDeprecationWarning):
             cm.register_cmap(name, mpl.colormaps[name])
 
-    with warnings.catch_warnings():
-        warnings.filterwarnings("ignore", category=mpl.MatplotlibDeprecationWarning)
+    if parse_version(pytest.__version__).major < 8:
         with pytest.warns(UserWarning):
             cm.register_cmap(name, mpl.colormaps[name], override_builtin=True)
+    else:
+        with pytest.warns(UserWarning), pytest.warns(mpl.MatplotlibDeprecationWarning):
+            cm.register_cmap(name, mpl.colormaps[name], override_builtin=True)
 
 
 def test_unregister_builtin_cmap():
diff --git a/lib/matplotlib/tests/test_ticker.py b/lib/matplotlib/tests/test_ticker.py
index 67e3764f0d2c..4b37d5c52206 100644
--- a/lib/matplotlib/tests/test_ticker.py
+++ b/lib/matplotlib/tests/test_ticker.py
@@ -3,7 +3,7 @@
 import locale
 import logging
 import re
-import warnings
+from packaging.version import parse as parse_version
 
 import numpy as np
 from numpy.testing import assert_almost_equal, assert_array_equal
@@ -915,16 +915,17 @@ def test_mathtext_ticks(self):
             'axes.formatter.use_mathtext': False
         })
 
-        # Glyph warning unrelated
-        with warnings.catch_warnings():
-            warnings.filterwarnings(
-                "ignore", category=UserWarning, message="Glyph 8722"
-            )
-
+        if parse_version(pytest.__version__).major < 8:
             with pytest.warns(UserWarning, match='cmr10 font should ideally'):
                 fig, ax = plt.subplots()
                 ax.set_xticks([-1, 0, 1])
                 fig.canvas.draw()
+        else:
+            with (pytest.warns(UserWarning, match="Glyph 8722"),
+                  pytest.warns(UserWarning, match='cmr10 font should ideally')):
+                fig, ax = plt.subplots()
+                ax.set_xticks([-1, 0, 1])
+                fig.canvas.draw()
 
     def test_cmr10_substitutions(self, caplog):
         mpl.rcParams.update({

From f8c6c821882d686450f9f924cf440ceea942ec58 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 11 Jan 2024 18:19:47 -0500
Subject: [PATCH 0610/1120] Fix auto-labeler configuration

Somehow I lost the `changed-files` key, and this was copy-pasted to
every entry.
---
 .github/labeler.yml | 371 +++++++++++++++++++++++++-------------------
 1 file changed, 213 insertions(+), 158 deletions(-)

diff --git a/.github/labeler.yml b/.github/labeler.yml
index c57689a5f9ae..a3370aaf1e81 100644
--- a/.github/labeler.yml
+++ b/.github/labeler.yml
@@ -1,218 +1,273 @@
 ---
 "CI: Run cibuildwheel":
-  - any-glob-to-any-file: ['.github/workflows/cibuildwheel.yml']
+  - changed-files:
+      - any-glob-to-any-file: ['.github/workflows/cibuildwheel.yml']
 "CI: Run cygwin":
-  - any-glob-to-any-file: ['.github/workflows/cygwin.yml']
+  - changed-files:
+      - any-glob-to-any-file: ['.github/workflows/cygwin.yml']
 
 "backend: agg":
-  - any-glob-to-any-file:
-      - 'extern/agg24-svn/'
-      - 'lib/matplotlib/backends/_backend_agg.pyi'
-      - 'lib/matplotlib/backends/backend_agg.py*'
-      - 'src/_backend_agg*'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'extern/agg24-svn/'
+          - 'lib/matplotlib/backends/_backend_agg.pyi'
+          - 'lib/matplotlib/backends/backend_agg.py*'
+          - 'src/_backend_agg*'
 "backend: cairo":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/backends/backend_*cairo.py*'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/backends/backend_*cairo.py*'
 "backend: pdf":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/backends/_backend_pdf_ps.py'
-      - 'lib/matplotlib/backends/backend_pdf.py'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/backends/_backend_pdf_ps.py'
+          - 'lib/matplotlib/backends/backend_pdf.py'
 "backend: pgf":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/backends/backend_pgf.py'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/backends/backend_pgf.py'
 "backend: ps":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/backends/_backend_pdf_ps.py'
-      - 'lib/matplotlib/backends/backend_ps.py'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/backends/_backend_pdf_ps.py'
+          - 'lib/matplotlib/backends/backend_ps.py'
 "backend: svg":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/backends/backend_svg.py'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/backends/backend_svg.py'
 
 "GUI: gtk":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/backends/_backend_gtk.py*'
-      - 'lib/matplotlib/backends/backend_gtk*'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/backends/_backend_gtk.py*'
+          - 'lib/matplotlib/backends/backend_gtk*'
 "GUI: MacOSX":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/backends/*_macosx.py*'
-      - 'src/_macosx.m'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/backends/*_macosx.py*'
+          - 'src/_macosx.m'
 "GUI: nbagg":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/backends/*_nbagg*.py*'
-      - 'lib/matplotlib/backends/web_backend/js/nbagg_mpl.js'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/backends/*_nbagg*.py*'
+          - 'lib/matplotlib/backends/web_backend/js/nbagg_mpl.js'
 "GUI: Qt":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/backends/backend_qt*'
-      - 'lib/matplotlib/backends/qt_compat.py'
-      - 'lib/matplotlib/backends/qt_editor/**'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/backends/backend_qt*'
+          - 'lib/matplotlib/backends/qt_compat.py'
+          - 'lib/matplotlib/backends/qt_editor/**'
 "GUI: tk":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/backends/*backend_tk*'
-      - 'lib/matplotlib/backends/_tkagg.pyi'
-      - 'src/_tkagg.cpp'
-      - 'src/_tkmini.h'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/backends/*backend_tk*'
+          - 'lib/matplotlib/backends/_tkagg.pyi'
+          - 'src/_tkagg.cpp'
+          - 'src/_tkmini.h'
 "GUI: webagg":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/backends/*_webagg*.py*'
-      - 'lib/matplotlib/backends/web_backend/**'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/backends/*_webagg*.py*'
+          - 'lib/matplotlib/backends/web_backend/**'
 "GUI: wx":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/backends/backend_wx*.py*'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/backends/backend_wx*.py*'
 
 "Documentation: API":
-  - any-glob-to-any-file:
-      # Also files in lib/**, but we can't be sure those are only documentation.
-      - 'doc/api/**'
+  - changed-files:
+      - any-glob-to-any-file:
+          # Also files in lib/**, but we can't be sure those are only documentation.
+          - 'doc/api/**'
 "Documentation: build":
-  - any-glob-to-any-file:
-      - 'doc/conf.py'
-      - 'doc/Makefile'
-      - 'doc/make.bat'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'doc/conf.py'
+          - 'doc/Makefile'
+          - 'doc/make.bat'
 "Documentation: devdocs":
-  - any-glob-to-any-file:
-      - 'doc/devel/**'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'doc/devel/**'
 "Documentation: examples":
-  - any-glob-to-any-file:
-      - 'galleries/examples/**'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'galleries/examples/**'
 "Documentation: plot types":
-  - any-glob-to-any-file:
-      - 'galleries/plot_types/**'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'galleries/plot_types/**'
 "Documentation: tutorials":
-  - any-glob-to-any-file:
-      - 'galleries/tutorials/**'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'galleries/tutorials/**'
 "Documentation: user guide":
-  - any-glob-to-any-file:
-      - 'doc/users/**'
-      - 'galleries/users_explain/**'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'doc/users/**'
+          - 'galleries/users_explain/**'
 
 "topic: animation":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/animation.py*'
-      - 'lib/matplotlib/_animation_data.py*'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/animation.py*'
+          - 'lib/matplotlib/_animation_data.py*'
 "topic: axes":
-  - any-glob-to-any-file:
-      # Note, axes.py is not included here because it contains many plotting
-      # methods, for which changes would not be considered on topic.
-      - 'lib/matplotlib/axes/_base.py*'
+  - changed-files:
+      - any-glob-to-any-file:
+          # Note, axes.py is not included here because it contains many plotting
+          # methods, for which changes would not be considered on topic.
+          - 'lib/matplotlib/axes/_base.py*'
 "topic: canvas and figure manager":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/backend_bases.py*'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/backend_bases.py*'
 "topic: categorical":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/category.py*'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/category.py*'
 "topic: collections and mappables":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/collections.py*'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/collections.py*'
 "topic: color/color & colormaps":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/colorbar.py*'
-      - 'lib/matplotlib/colors.py*'
-      - 'lib/matplotlib/_color_data.py*'
-      - 'lib/matplotlib/cm.py*'
-      - 'lib/matplotlib/_cm.py*'
-      - 'lib/matplotlib/_cm_listed.py*'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/colorbar.py*'
+          - 'lib/matplotlib/colors.py*'
+          - 'lib/matplotlib/_color_data.py*'
+          - 'lib/matplotlib/cm.py*'
+          - 'lib/matplotlib/_cm.py*'
+          - 'lib/matplotlib/_cm_listed.py*'
 "topic: contour":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/contour.py*'
-      - 'src/_qhull_wrapper.cpp'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/contour.py*'
+          - 'src/_qhull_wrapper.cpp'
 "topic: date handling":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/dates.py*'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/dates.py*'
 "topic: figures and subfigures":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/figure.py*'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/figure.py*'
 "topic: geometry manager":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/_constrained_layout.py*'
-      - 'lib/matplotlib/_layoutgrid.py*'
-      - 'lib/matplotlib/_tight_bbox.py*'
-      - 'lib/matplotlib/_tight_layout.py*'
-      - 'lib/matplotlib/gridspec.py*'
-      - 'lib/matplotlib/layout_engine.py*'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/_constrained_layout.py*'
+          - 'lib/matplotlib/_layoutgrid.py*'
+          - 'lib/matplotlib/_tight_bbox.py*'
+          - 'lib/matplotlib/_tight_layout.py*'
+          - 'lib/matplotlib/gridspec.py*'
+          - 'lib/matplotlib/layout_engine.py*'
 "topic: hatch":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/hatch.py*'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/hatch.py*'
 "topic: images":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/image.py*'
-      - 'lib/matplotlib/_image.pyi'
-      - 'src/_image_*'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/image.py*'
+          - 'lib/matplotlib/_image.pyi'
+          - 'src/_image_*'
 "topic: legend":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/legend.py*'
-      - 'lib/matplotlib/legend_handler.py*'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/legend.py*'
+          - 'lib/matplotlib/legend_handler.py*'
 "topic: markers":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/markers.py*'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/markers.py*'
 "topic: mpl_toolkit":
-  - any-glob-to-any-file:
-      - 'lib/mpl_toolkits/**'
-  - all-globs-to-all-files:
-      - '!lib/mpl_toolkits/mplot3d/**'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/mpl_toolkits/**'
+      - all-globs-to-all-files:
+          - '!lib/mpl_toolkits/mplot3d/**'
 "topic: mplot3d":
-  - any-glob-to-any-file:
-      - 'lib/mpl_toolkits/mplot3d/**'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/mpl_toolkits/mplot3d/**'
 "topic: path handling":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/path.py*'
-      - 'lib/matplotlib/patheffects.py*'
-      - 'lib/matplotlib/_path.pyi'
-      - 'src/*path*'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/path.py*'
+          - 'lib/matplotlib/patheffects.py*'
+          - 'lib/matplotlib/_path.pyi'
+          - 'src/*path*'
 "topic: polar":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/projections/polar.py*'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/projections/polar.py*'
 "topic: pyplot API":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/pyplot.py'
-      - 'lib/matplotlib/_pylab_helpers.py*'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/pyplot.py'
+          - 'lib/matplotlib/_pylab_helpers.py*'
 "topic: rcparams":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/rcsetup.py*'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/rcsetup.py*'
 "topic: sankey":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/sankey.py*'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/sankey.py*'
 "topic: sphinx extension":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/sphinxext/**'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/sphinxext/**'
 "topic: styles":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/mpl-data/stylelib/**'
-      - 'lib/matplotlib/style/**'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/mpl-data/stylelib/**'
+          - 'lib/matplotlib/style/**'
 "topic: table":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/table.py*'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/table.py*'
 "topic: text":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/text.py*'
-      - 'lib/matplotlib/textpath.py*'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/text.py*'
+          - 'lib/matplotlib/textpath.py*'
 "topic: text/fonts":
-  - any-glob-to-any-file:
-      - 'src/checkdep_freetype2.c'
-      - 'src/ft2font*'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'src/checkdep_freetype2.c'
+          - 'src/ft2font*'
 "topic: text/mathtext":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/mathtext.py*'
-      - 'lib/matplotlib/_mathtext.py*'
-      - 'lib/matplotlib/_mathtext_data.py*'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/mathtext.py*'
+          - 'lib/matplotlib/_mathtext.py*'
+          - 'lib/matplotlib/_mathtext_data.py*'
 "topic: ticks axis labels":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/axis.py*'
-      - 'lib/matplotlib/ticker.py*'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/axis.py*'
+          - 'lib/matplotlib/ticker.py*'
 "topic: toolbar":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/backend_managers.py*'
-      - 'lib/matplotlib/backend_tools.py*'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/backend_managers.py*'
+          - 'lib/matplotlib/backend_tools.py*'
 "topic: transforms and scales":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/scale.py*'
-      - 'lib/matplotlib/transforms.py*'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/scale.py*'
+          - 'lib/matplotlib/transforms.py*'
 "topic: tri":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/tri/**'
-      - 'src/tri/**'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/tri/**'
+          - 'src/tri/**'
 "topic: units and array ducktypes":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/units.py*'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/units.py*'
 "topic: widgets/UI":
-  - any-glob-to-any-file:
-      - 'lib/matplotlib/widgets.py*'
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'lib/matplotlib/widgets.py*'

From e7572613d2b052750ef40c08b38114ee9d0c5efb Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 11 Jan 2024 21:13:53 -0500
Subject: [PATCH 0611/1120] ci: Update nightly upload for artifacts v4

---
 .github/workflows/nightlies.yml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/nightlies.yml b/.github/workflows/nightlies.yml
index 76e7fee0b205..703194a762ee 100644
--- a/.github/workflows/nightlies.yml
+++ b/.github/workflows/nightlies.yml
@@ -32,7 +32,7 @@ jobs:
           PROJECT_REPO="matplotlib/matplotlib"
           BRANCH="main"
           WORKFLOW_NAME="cibuildwheel.yml"
-          ARTIFACT_NAME="wheels"
+          ARTIFACT_PATTERN="cibw-wheels-*"
 
           gh run --repo "${PROJECT_REPO}" \
              list --branch "${BRANCH}" \
@@ -52,10 +52,10 @@ jobs:
           )
           gh run --repo "${PROJECT_REPO}" view "${RUN_ID}"
           gh run --repo "${PROJECT_REPO}" \
-             download "${RUN_ID}" --name "${ARTIFACT_NAME}"
+             download "${RUN_ID}" --pattern "${ARTIFACT_PATTERN}"
 
           mkdir dist
-          mv *.whl dist/
+          mv ${ARTIFACT_PATTERN}/*.whl dist/
           ls -l dist/
 
       - name: Upload wheels to Anaconda Cloud as nightlies

From 26b517238d28d59487cbe0e9ec3edad636659d4e Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 12 Jan 2024 20:52:09 -0500
Subject: [PATCH 0612/1120] ci: Fix mpl_toolkits label

The default is `any`, so the negated glob matches almost all PRs
accidentally. So we need to wrap this in an `all` so it's just
toolkits-but-not-mplot3d.
---
 .github/labeler.yml | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/.github/labeler.yml b/.github/labeler.yml
index a3370aaf1e81..8d899258a3e7 100644
--- a/.github/labeler.yml
+++ b/.github/labeler.yml
@@ -181,11 +181,12 @@
       - any-glob-to-any-file:
           - 'lib/matplotlib/markers.py*'
 "topic: mpl_toolkit":
-  - changed-files:
-      - any-glob-to-any-file:
-          - 'lib/mpl_toolkits/**'
-      - all-globs-to-all-files:
-          - '!lib/mpl_toolkits/mplot3d/**'
+  - all:
+      - changed-files:
+          - any-glob-to-any-file:
+              - 'lib/mpl_toolkits/**'
+          - all-globs-to-all-files:
+              - '!lib/mpl_toolkits/mplot3d/**'
 "topic: mplot3d":
   - changed-files:
       - any-glob-to-any-file:

From cb5cb9cbe3102e88b403512dc05cba901edc82bd Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 30 Nov 2023 23:19:04 -0500
Subject: [PATCH 0613/1120] Use class form of data classes

When these were added in #20118, we had no type annotations, so it made
sense to use the functional form. Now that we do, there's no reason not
to use the class form.

Also, as `FontEntry` has gained more methods, the functional form looks
less clear.
---
 doc/api/font_manager_api.rst           |  1 +
 lib/matplotlib/_text_helpers.py        | 23 +++++---
 lib/matplotlib/backends/backend_pdf.py |  7 +--
 lib/matplotlib/font_manager.py         | 72 ++++++++++++--------------
 4 files changed, 50 insertions(+), 53 deletions(-)

diff --git a/doc/api/font_manager_api.rst b/doc/api/font_manager_api.rst
index ba1d785ca939..1a1b06da1fa9 100644
--- a/doc/api/font_manager_api.rst
+++ b/doc/api/font_manager_api.rst
@@ -4,6 +4,7 @@
 
 .. automodule:: matplotlib.font_manager
    :members:
+   :exclude-members: FontEntry
    :undoc-members:
    :show-inheritance:
 
diff --git a/lib/matplotlib/_text_helpers.py b/lib/matplotlib/_text_helpers.py
index 8625186ba8ec..dc0540ea14e4 100644
--- a/lib/matplotlib/_text_helpers.py
+++ b/lib/matplotlib/_text_helpers.py
@@ -2,14 +2,21 @@
 Low-level text helper utilities.
 """
 
+from __future__ import annotations
+
 import dataclasses
 
 from . import _api
-from .ft2font import KERNING_DEFAULT, LOAD_NO_HINTING
+from .ft2font import KERNING_DEFAULT, LOAD_NO_HINTING, FT2Font
 
 
-LayoutItem = dataclasses.make_dataclass(
-    "LayoutItem", ["ft_object", "char", "glyph_idx", "x", "prev_kern"])
+@dataclasses.dataclass(frozen=True)
+class LayoutItem:
+    ft_object: FT2Font
+    char: str
+    glyph_idx: int
+    x: float
+    prev_kern: float
 
 
 def warn_on_missing_glyph(codepoint, fontnames):
@@ -38,9 +45,10 @@ def warn_on_missing_glyph(codepoint, fontnames):
 
 def layout(string, font, *, kern_mode=KERNING_DEFAULT):
     """
-    Render *string* with *font*.  For each character in *string*, yield a
-    (glyph-index, x-position) pair.  When such a pair is yielded, the font's
-    glyph is set to the corresponding character.
+    Render *string* with *font*.
+
+    For each character in *string*, yield a LayoutItem instance. When such an instance
+    is yielded, the font's glyph is set to the corresponding character.
 
     Parameters
     ----------
@@ -53,8 +61,7 @@ def layout(string, font, *, kern_mode=KERNING_DEFAULT):
 
     Yields
     ------
-    glyph_index : int
-    x_position : float
+    LayoutItem
     """
     x = 0
     prev_glyph_idx = None
diff --git a/lib/matplotlib/backends/backend_pdf.py b/lib/matplotlib/backends/backend_pdf.py
index d66e199b25b2..da105878b575 100644
--- a/lib/matplotlib/backends/backend_pdf.py
+++ b/lib/matplotlib/backends/backend_pdf.py
@@ -2378,8 +2378,7 @@ def draw_text(self, gc, x, y, s, prop, angle, ismath=False, mtext=None):
             multibyte_glyphs = []
             prev_was_multibyte = True
             prev_font = font
-            for item in _text_helpers.layout(
-                    s, font, kern_mode=KERNING_UNFITTED):
+            for item in _text_helpers.layout(s, font, kern_mode=KERNING_UNFITTED):
                 if _font_supports_glyph(fonttype, ord(item.char)):
                     if prev_was_multibyte or item.ft_object != prev_font:
                         singlebyte_chunks.append((item.ft_object, item.x, []))
@@ -2389,9 +2388,7 @@ def draw_text(self, gc, x, y, s, prop, angle, ismath=False, mtext=None):
                     singlebyte_chunks[-1][2].append(item.char)
                     prev_was_multibyte = False
                 else:
-                    multibyte_glyphs.append(
-                        (item.ft_object, item.x, item.glyph_idx)
-                    )
+                    multibyte_glyphs.append((item.ft_object, item.x, item.glyph_idx))
                     prev_was_multibyte = True
             # Do the rotation and global translation as a single matrix
             # concatenation up front
diff --git a/lib/matplotlib/font_manager.py b/lib/matplotlib/font_manager.py
index 52e6207c63ec..73da3c418dd7 100644
--- a/lib/matplotlib/font_manager.py
+++ b/lib/matplotlib/font_manager.py
@@ -25,6 +25,8 @@
 #   - setWeights function needs improvement
 #   - 'light' is an invalid weight value, remove it.
 
+from __future__ import annotations
+
 from base64 import b64encode
 from collections import namedtuple
 import copy
@@ -41,7 +43,6 @@
 import subprocess
 import sys
 import threading
-from typing import Union
 
 import matplotlib as mpl
 from matplotlib import _api, _afm, cbook, ft2font
@@ -304,42 +305,35 @@ def findSystemFonts(fontpaths=None, fontext='ttf'):
     return [fname for fname in fontfiles if os.path.exists(fname)]
 
 
-def _fontentry_helper_repr_png(fontent):
-    from matplotlib.figure import Figure  # Circular import.
-    fig = Figure()
-    font_path = Path(fontent.fname) if fontent.fname != '' else None
-    fig.text(0, 0, fontent.name, font=font_path)
-    with BytesIO() as buf:
-        fig.savefig(buf, bbox_inches='tight', transparent=True)
-        return buf.getvalue()
-
-
-def _fontentry_helper_repr_html(fontent):
-    png_stream = _fontentry_helper_repr_png(fontent)
-    png_b64 = b64encode(png_stream).decode()
-    return f"<img src=\"data:image/png;base64, {png_b64}\" />"
-
-
-FontEntry = dataclasses.make_dataclass(
-    'FontEntry', [
-        ('fname', str, dataclasses.field(default='')),
-        ('name', str, dataclasses.field(default='')),
-        ('style', str, dataclasses.field(default='normal')),
-        ('variant', str, dataclasses.field(default='normal')),
-        ('weight', Union[str, int], dataclasses.field(default='normal')),
-        ('stretch', str, dataclasses.field(default='normal')),
-        ('size', str, dataclasses.field(default='medium')),
-    ],
-    namespace={
-        '__doc__': """
+@dataclasses.dataclass(frozen=True)
+class FontEntry:
+    """
     A class for storing Font properties.
 
     It is used when populating the font lookup dictionary.
-    """,
-        '_repr_html_': lambda self: _fontentry_helper_repr_html(self),
-        '_repr_png_': lambda self: _fontentry_helper_repr_png(self),
-    }
-)
+    """
+
+    fname: str = ''
+    name: str = ''
+    style: str = 'normal'
+    variant: str = 'normal'
+    weight: str | int = 'normal'
+    stretch: str = 'normal'
+    size: str = 'medium'
+
+    def _repr_html_(self) -> str:
+        png_stream = self._repr_png_()
+        png_b64 = b64encode(png_stream).decode()
+        return f"<img src=\"data:image/png;base64, {png_b64}\" />"
+
+    def _repr_png_(self) -> bytes:
+        from matplotlib.figure import Figure  # Circular import.
+        fig = Figure()
+        font_path = Path(self.fname) if self.fname != '' else None
+        fig.text(0, 0, self.name, font=font_path)
+        with BytesIO() as buf:
+            fig.savefig(buf, bbox_inches='tight', transparent=True)
+            return buf.getvalue()
 
 
 def ttfFontProperty(font):
@@ -926,8 +920,7 @@ def default(self, o):
             try:
                 # Cache paths of fonts shipped with Matplotlib relative to the
                 # Matplotlib data path, which helps in the presence of venvs.
-                d["fname"] = str(
-                    Path(d["fname"]).relative_to(mpl.get_data_path()))
+                d["fname"] = str(Path(d["fname"]).relative_to(mpl.get_data_path()))
             except ValueError:
                 pass
             return d
@@ -944,10 +937,9 @@ def _json_decode(o):
         r.__dict__.update(o)
         return r
     elif cls == 'FontEntry':
-        r = FontEntry.__new__(FontEntry)
-        r.__dict__.update(o)
-        if not os.path.isabs(r.fname):
-            r.fname = os.path.join(mpl.get_data_path(), r.fname)
+        if not os.path.isabs(o['fname']):
+            o['fname'] = os.path.join(mpl.get_data_path(), o['fname'])
+        r = FontEntry(**o)
         return r
     else:
         raise ValueError("Don't know how to deserialize __class__=%s" % cls)

From 5e5962f805d57727b0840fb858a943519987f127 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 1 Dec 2023 00:04:19 -0500
Subject: [PATCH 0614/1120] DOC: Use a data class in the menu example

---
 galleries/examples/widgets/menu.py | 17 ++++++++++-------
 1 file changed, 10 insertions(+), 7 deletions(-)

diff --git a/galleries/examples/widgets/menu.py b/galleries/examples/widgets/menu.py
index 8d3db3d1b9c3..e948d5e00863 100644
--- a/galleries/examples/widgets/menu.py
+++ b/galleries/examples/widgets/menu.py
@@ -5,19 +5,22 @@
 
 Using texts to construct a simple menu.
 """
+
+from dataclasses import dataclass
+
 import matplotlib.pyplot as plt
 
 import matplotlib.artist as artist
 import matplotlib.patches as patches
+from matplotlib.typing import ColorType
 
 
+@dataclass
 class ItemProperties:
-    def __init__(self, fontsize=14, labelcolor='black', bgcolor='yellow',
-                 alpha=1.0):
-        self.fontsize = fontsize
-        self.labelcolor = labelcolor
-        self.bgcolor = bgcolor
-        self.alpha = alpha
+    fontsize: float = 14
+    labelcolor: ColorType = 'black'
+    bgcolor: ColorType = 'yellow'
+    alpha: float = 1.0
 
 
 class MenuItem(artist.Artist):
@@ -130,7 +133,7 @@ def on_move(self, event):
 menuitems = []
 for label in ('open', 'close', 'save', 'save as', 'quit'):
     def on_select(item):
-        print('you selected %s' % item.labelstr)
+        print(f'you selected {item.labelstr}')
     item = MenuItem(fig, label, props=props, hoverprops=hoverprops,
                     on_select=on_select)
     menuitems.append(item)

From 7c992b55b02f0d1e4b10e9e5bfdec0080710dfc9 Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Tue, 9 Jan 2024 14:48:09 +0000
Subject: [PATCH 0615/1120] Add configuration for running stubtest using tox

---
 .gitignore      |  1 +
 environment.yml |  3 ++-
 tox.ini         | 11 ++++++++++-
 3 files changed, 13 insertions(+), 2 deletions(-)

diff --git a/.gitignore b/.gitignore
index 41c97b62c51e..b6f9e1ee74f4 100644
--- a/.gitignore
+++ b/.gitignore
@@ -31,6 +31,7 @@
 ################
 # meson-python working directory
 build
+.mesonpy*
 
 # meson-python/build frontend dist directory
 dist
diff --git a/environment.yml b/environment.yml
index 9f06ab7ff143..d50e544edb0d 100644
--- a/environment.yml
+++ b/environment.yml
@@ -46,6 +46,7 @@ dependencies:
       - sphinxcontrib-svg2pdfconverter>=1.1.0
       - pikepdf
   # testing
+  - black<24
   - coverage
   - flake8>=3.8
   - flake8-docstrings>=1.4.0
@@ -64,4 +65,4 @@ dependencies:
   - pytest-xdist
   - tornado
   - pytz
-  - black<24
+  - tox
diff --git a/tox.ini b/tox.ini
index fc8479269160..cb2fcc979076 100644
--- a/tox.ini
+++ b/tox.ini
@@ -4,7 +4,7 @@
 # and then run "tox" from this directory.
 
 [tox]
-envlist = py38, py39, py310
+envlist = py38, py39, py310, stubtest
 
 [testenv]
 changedir = /tmp
@@ -25,3 +25,12 @@ commands =
 deps =
     pytest
     pytz
+
+[testenv:stubtest]
+changedir = {tox_root}
+commands =
+    python tools/stubtest.py
+usedevelop = False
+deps =
+    -r requirements/testing/mypy.txt
+    -r requirements/testing/all.txt

From b0dd5ab08c5433a64ce1b4484c4d0add8127eb00 Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Tue, 9 Jan 2024 14:55:36 +0000
Subject: [PATCH 0616/1120] Use tox in stubtest CI

Fix reviewdog sed

Add tox install stage
---
 .github/workflows/mypy-stubtest.yml | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/.github/workflows/mypy-stubtest.yml b/.github/workflows/mypy-stubtest.yml
index f042688feb62..1280926021f1 100644
--- a/.github/workflows/mypy-stubtest.yml
+++ b/.github/workflows/mypy-stubtest.yml
@@ -18,12 +18,6 @@ jobs:
         with:
           python-version: 3.9
 
-      - name: Install mypy
-        run: |
-          pip3 install -r requirements/testing/mypy.txt \
-            -r requirements/testing/all.txt
-          pip3 install .
-
       - name: Set up reviewdog
         run: |
           mkdir -p "$HOME/bin"
@@ -32,13 +26,16 @@ jobs:
               sh -s -- -b "$HOME/bin"
           echo "$HOME/bin" >> $GITHUB_PATH
 
+      - name: Install tox
+        run: python -m pip install tox
+
       - name: Run mypy stubtest
         env:
           REVIEWDOG_GITHUB_API_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
           set -o pipefail
-          MPLBACKEND=agg python tools/stubtest.py | \
-              sed -e "s!$pythonLocation/lib/python3.9/site-packages!lib!g" | \
+          tox -e stubtest | \
+              sed -e "s!.tox/stubtest/lib/python3.11/site-packages!lib!g" | \
               reviewdog \
                 -efm '%Eerror: %m' \
                 -efm '%CStub: in file %f:%l' \

From 106ce164d84f7a71ef83bb3c988ae21f45bef1b6 Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Wed, 10 Jan 2024 13:52:33 +0000
Subject: [PATCH 0617/1120] Add instructions on running stubtest

---
 doc/devel/coding_guide.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/doc/devel/coding_guide.rst b/doc/devel/coding_guide.rst
index 6564de906979..b1c0a810c965 100644
--- a/doc/devel/coding_guide.rst
+++ b/doc/devel/coding_guide.rst
@@ -88,9 +88,8 @@ We generally use `stub files
 the type information for ``colors.py``. A notable exception is ``pyplot.py``,
 which is type hinted inline.
 
-Type hints are checked by the mypy :ref:`pre-commit hook <pre-commit-hooks>`
-and can often be verified using ``tools\stubtest.py`` and occasionally may
-require the use of ``tools\check_typehints.py``.
+Type hints are checked by the mypy :ref:`pre-commit hook <pre-commit-hooks>`,
+can often be verified by running ``tox -e stubtest``.
 
 New modules and files: installation
 ===================================

From 6640e6063ff92893dc554df47f8f69218b44f81e Mon Sep 17 00:00:00 2001
From: saranti <tsarantis@proton.me>
Date: Sun, 14 Jan 2024 20:16:00 +1100
Subject: [PATCH 0618/1120] fix minorticks_on

---
 lib/matplotlib/tests/test_ticker.py | 30 +++++++++++++++++++++++++++++
 lib/matplotlib/ticker.py            |  2 +-
 2 files changed, 31 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/tests/test_ticker.py b/lib/matplotlib/tests/test_ticker.py
index 12eafba9ea2b..267178662865 100644
--- a/lib/matplotlib/tests/test_ticker.py
+++ b/lib/matplotlib/tests/test_ticker.py
@@ -12,6 +12,8 @@
 import matplotlib.pyplot as plt
 import matplotlib.ticker as mticker
 
+import random
+
 
 class TestMaxNLocator:
     basic_data = [
@@ -1796,3 +1798,31 @@ def test_set_offset_string(formatter):
     assert formatter.get_offset() == ''
     formatter.set_offset_string('mpl')
     assert formatter.get_offset() == 'mpl'
+
+
+def test_minorticks_on_multi_fig():
+    """
+    Turning on minor gridlines in a multi-Axes Figure
+    that contains more than one boxplot and shares the x-axis
+    should not raise an exception.
+    """
+    fig, ax = plt.subplots(sharex=True, ncols=2, nrows=2)
+
+    def values():
+        return [random.random() for _ in range(9)]
+
+    for x in range(3):
+        ax[0, 0].boxplot(values(), positions=[x])
+        ax[0, 1].boxplot(values(), positions=[x])
+        ax[1, 0].boxplot(values(), positions=[x])
+        ax[1, 1].boxplot(values(), positions=[x])
+
+    for a in ax.flatten():
+        a.grid(which="major")
+        a.grid(which="minor", linestyle="--")
+        a.minorticks_on()
+    fig.canvas.draw()
+
+    assert all(a.get_xgridlines() for a in ax.flatten())
+    assert all((isinstance(a.xaxis.get_minor_locator(), mpl.ticker.AutoMinorLocator)
+                for a in ax.flatten()))
diff --git a/lib/matplotlib/ticker.py b/lib/matplotlib/ticker.py
index 10ac8cad6ebc..1e9f0892c322 100644
--- a/lib/matplotlib/ticker.py
+++ b/lib/matplotlib/ticker.py
@@ -2903,7 +2903,7 @@ def __call__(self):
             _api.warn_external('AutoMinorLocator does not work on logarithmic scales')
             return []
 
-        majorlocs = self.axis.get_majorticklocs()
+        majorlocs = np.unique(self.axis.get_majorticklocs())
         if len(majorlocs) < 2:
             # Need at least two major ticks to find minor tick locations.
             # TODO: Figure out a way to still be able to display minor ticks with less

From 2a81372cd30a69fbe5eaa2599bd71554a357789b Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Sun, 14 Jan 2024 16:29:45 +0000
Subject: [PATCH 0619/1120] Test out of bounds

---
 lib/matplotlib/tests/test_image.py | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_image.py b/lib/matplotlib/tests/test_image.py
index 638fd5696acf..17d0c011ba63 100644
--- a/lib/matplotlib/tests/test_image.py
+++ b/lib/matplotlib/tests/test_image.py
@@ -371,7 +371,9 @@ def test_cursor_data():
     [[0.5, 1.5], 0 + 1],
     [[4.5, 0.5], 16 + 0],
     [[8.5, 0.5], 16 + 0],
-    [[9.5, 2.5], 81 + 4]
+    [[9.5, 2.5], 81 + 4],
+    [[-1, 0.5], None],
+    [[0.5, -1], None],
     ]
 )
 def test_cursor_data_nonuniform(xy, data):
@@ -386,8 +388,9 @@ def test_cursor_data_nonuniform(xy, data):
     im = NonUniformImage(ax, extent=(x.min(), x.max(), y.min(), y.max()))
     im.set_data(x, y, z)
     ax.add_image(im)
-    ax.set_xlim(x.min(), x.max())
-    ax.set_ylim(y.min(), y.max())
+    # Set lower min lim so we can test cursor outside image
+    ax.set_xlim(x.min() - 2, x.max())
+    ax.set_ylim(y.min() - 2, y.max())
 
     xdisp, ydisp = ax.transData.transform(xy)
     event = MouseEvent('motion_notify_event', fig.canvas, xdisp, ydisp)

From ed712e35ade7f7865119902d2703aeffa732bc62 Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Sun, 14 Jan 2024 16:35:30 +0000
Subject: [PATCH 0620/1120] Add what's new

---
 doc/users/next_whats_new/nonuniformimage_mousover.rst | 4 ++++
 1 file changed, 4 insertions(+)
 create mode 100644 doc/users/next_whats_new/nonuniformimage_mousover.rst

diff --git a/doc/users/next_whats_new/nonuniformimage_mousover.rst b/doc/users/next_whats_new/nonuniformimage_mousover.rst
new file mode 100644
index 000000000000..e5a7ab1bd155
--- /dev/null
+++ b/doc/users/next_whats_new/nonuniformimage_mousover.rst
@@ -0,0 +1,4 @@
+NonUniformImage now has mouseover support
+-----------------------------------------
+When mousing over a `~matplotlib.image.NonUniformImage` the data values are now
+displayed.

From 42e42d570665a546bfbd473a87953e23870a42c9 Mon Sep 17 00:00:00 2001
From: stevezhang1999 <stevezhang1999@gmail.com>
Date: Wed, 4 Oct 2023 23:53:37 -0400
Subject: [PATCH 0621/1120] fix incorrect use of _make_verts in QuiverKey

change doc for angle to horizonal axis

correct test_quiver_key_xy image

fix Quiver._angles_lengths

add tests and fix original test image
---
 lib/matplotlib/quiver.py                      |  30 ++++++----
 .../test_quiver/quiver_key_xy.png             | Bin 20249 -> 20122 bytes
 lib/matplotlib/tests/test_quiver.py           |  56 ++++++++++++++++++
 3 files changed, 73 insertions(+), 13 deletions(-)

diff --git a/lib/matplotlib/quiver.py b/lib/matplotlib/quiver.py
index 3089af5757dd..20e4f15dd903 100644
--- a/lib/matplotlib/quiver.py
+++ b/lib/matplotlib/quiver.py
@@ -263,7 +263,7 @@ def __init__(self, Q, X, Y, U, label,
             The key label (e.g., length and units of the key).
         angle : float, default: 0
             The angle of the key arrow, in degrees anti-clockwise from the
-            x-axis.
+            horizontal axis.
         coordinates : {'axes', 'figure', 'data', 'inches'}, default: 'axes'
             Coordinate system and units for *X*, *Y*: 'axes' and 'figure' are
             normalized coordinate systems with (0, 0) in the lower left and
@@ -327,10 +327,8 @@ def _init(self):
                                    Umask=ma.nomask):
                 u = self.U * np.cos(np.radians(self.angle))
                 v = self.U * np.sin(np.radians(self.angle))
-                angle = (self.Q.angles if isinstance(self.Q.angles, str)
-                         else 'uv')
-                self.verts = self.Q._make_verts(
-                    np.array([u]), np.array([v]), angle)
+                self.verts = self.Q._make_verts([[0., 0.]],
+                                                np.array([u]), np.array([v]), 'uv')
             kwargs = self.Q.polykw
             kwargs.update(self.kw)
             self.vector = mcollections.PolyCollection(
@@ -521,7 +519,7 @@ def _init(self):
             # _make_verts sets self.scale if not already specified
             if (self._dpi_at_last_init != self.axes.figure.dpi
                     and self.scale is None):
-                self._make_verts(self.U, self.V, self.angles)
+                self._make_verts(self.XY, self.U, self.V, self.angles)
 
             self._dpi_at_last_init = self.axes.figure.dpi
 
@@ -537,7 +535,7 @@ def get_datalim(self, transData):
     @martist.allow_rasterization
     def draw(self, renderer):
         self._init()
-        verts = self._make_verts(self.U, self.V, self.angles)
+        verts = self._make_verts(self.XY, self.U, self.V, self.angles)
         self.set_verts(verts, closed=False)
         super().draw(renderer)
         self.stale = False
@@ -594,33 +592,38 @@ def _set_transform(self):
         self.set_transform(trans)
         return trans
 
-    def _angles_lengths(self, U, V, eps=1):
-        xy = self.axes.transData.transform(self.XY)
+    # Calculate angles and lengths for segment between (x, y), (x+u, y+v)
+    def _angles_lengths(self, XY, U, V, eps=1):
+        xy = self.axes.transData.transform(XY)
         uv = np.column_stack((U, V))
-        xyp = self.axes.transData.transform(self.XY + eps * uv)
+        xyp = self.axes.transData.transform(XY + eps * uv)
         dxy = xyp - xy
         angles = np.arctan2(dxy[:, 1], dxy[:, 0])
         lengths = np.hypot(*dxy.T) / eps
         return angles, lengths
 
-    def _make_verts(self, U, V, angles):
+    # XY is stacked [X, Y].
+    # See quiver() doc for meaning of X, Y, U, V, angles.
+    def _make_verts(self, XY, U, V, angles):
         uv = (U + V * 1j)
         str_angles = angles if isinstance(angles, str) else ''
         if str_angles == 'xy' and self.scale_units == 'xy':
             # Here eps is 1 so that if we get U, V by diffing
             # the X, Y arrays, the vectors will connect the
             # points, regardless of the axis scaling (including log).
-            angles, lengths = self._angles_lengths(U, V, eps=1)
+            angles, lengths = self._angles_lengths(XY, U, V, eps=1)
         elif str_angles == 'xy' or self.scale_units == 'xy':
             # Calculate eps based on the extents of the plot
             # so that we don't end up with roundoff error from
             # adding a small number to a large.
             eps = np.abs(self.axes.dataLim.extents).max() * 0.001
-            angles, lengths = self._angles_lengths(U, V, eps=eps)
+            angles, lengths = self._angles_lengths(XY, U, V, eps=eps)
+
         if str_angles and self.scale_units == 'xy':
             a = lengths
         else:
             a = np.abs(uv)
+
         if self.scale is None:
             sn = max(10, math.sqrt(self.N))
             if self.Umask is not ma.nomask:
@@ -630,6 +633,7 @@ def _make_verts(self, U, V, angles):
             # crude auto-scaling
             # scale is typical arrow length as a multiple of the arrow width
             scale = 1.8 * amean * sn / self.span
+
         if self.scale_units is None:
             if self.scale is None:
                 self.scale = scale
diff --git a/lib/matplotlib/tests/baseline_images/test_quiver/quiver_key_xy.png b/lib/matplotlib/tests/baseline_images/test_quiver/quiver_key_xy.png
index 8475b027093083cf82d7d59ee6f62d3fa2717b86..f4b2b83d08e2b46844a64755c82588a38cc7442e 100644
GIT binary patch
literal 20122
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
aK3BHL{&xqmamGIACK((y(aF`a3I1Qf3w3J%

literal 20249
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
UzbwpE2SFj)$Mw{6R4qdO7lYS+MF0Q*

diff --git a/lib/matplotlib/tests/test_quiver.py b/lib/matplotlib/tests/test_quiver.py
index 6e032a54422a..7c5a9d343530 100644
--- a/lib/matplotlib/tests/test_quiver.py
+++ b/lib/matplotlib/tests/test_quiver.py
@@ -267,6 +267,62 @@ def test_quiverkey_angles():
     assert len(qk.verts) == 1
 
 
+def test_quiverkey_angles_xy_aitoff():
+    # GH 26316 and GH 26748
+    # Test that only one arrow will be plotted with non-cartesian
+    # when angles='xy' and/or scale_units='xy'
+
+    # only for test purpose
+    # scale_units='xy' may not be a valid use case for non-cartesian
+    kwargs_list = [
+        {'angles': 'xy'},
+        {'angles': 'xy', 'scale_units': 'xy'},
+        {'scale_units': 'xy'}
+    ]
+
+    for kwargs_dict in kwargs_list:
+
+        x = np.linspace(-np.pi, np.pi, 11)
+        y = np.ones_like(x) * np.pi / 6
+        vx = np.zeros_like(x)
+        vy = np.ones_like(x)
+
+        fig = plt.figure()
+        ax = fig.add_subplot(projection='aitoff')
+        q = ax.quiver(x, y, vx, vy, **kwargs_dict)
+        qk = ax.quiverkey(q, 0, 0, 1, '1 units')
+
+        fig.canvas.draw()
+        assert len(qk.verts) == 1
+
+
+def test_quiverkey_angles_scale_units_cartesian():
+    # GH 26316
+    # Test that only one arrow will be plotted with normal cartesian
+    # when angles='xy' and/or scale_units='xy'
+
+    kwargs_list = [
+        {'angles': 'xy'},
+        {'angles': 'xy', 'scale_units': 'xy'},
+        {'scale_units': 'xy'}
+    ]
+
+    for kwargs_dict in kwargs_list:
+        X = [0, -1, 0]
+        Y = [0, -1, 0]
+        U = [1, -1, 1]
+        V = [1, -1, 0]
+
+        fig, ax = plt.subplots()
+        q = ax.quiver(X, Y, U, V, **kwargs_dict)
+        ax.quiverkey(q, X=0.3, Y=1.1, U=1,
+                     label='Quiver key, length = 1', labelpos='E')
+        qk = ax.quiverkey(q, 0, 0, 1, '1 units')
+
+        fig.canvas.draw()
+        assert len(qk.verts) == 1
+
+
 def test_quiver_setuvc_numbers():
     """Check that it is possible to set all arrow UVC to the same numbers"""
 

From 25db754f08496b559894357f10ad4ce78d9075c9 Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Sun, 14 Jan 2024 20:12:02 +0000
Subject: [PATCH 0622/1120] Check for latex binary before building docs

---
 doc/conf.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/doc/conf.py b/doc/conf.py
index 544bddf2e5a1..2b09bfaf5db0 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -158,6 +158,10 @@ def _check_dependencies():
         raise OSError(
             "No binary named dot - graphviz must be installed to build the "
             "documentation")
+    if shutil.which('latex') is None:
+        raise OSError(
+            "No binary named latex - latex must be installed to build the "
+            "documentation")
 
 _check_dependencies()
 

From 6c2c8160179e2df166a0cefbd8eb6ba294b48ff0 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Thu, 11 Jan 2024 16:31:13 -0500
Subject: [PATCH 0623/1120] fixed link in PR template

---
 .github/PULL_REQUEST_TEMPLATE.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index cd6cf5585a49..7f17a80dc4b6 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -7,6 +7,7 @@ out the development guide https://matplotlib.org/devdocs/devel/index.html
 <!-- Please provide at least 1-2 sentences describing the pull request in detail
 (Why is this change required?  What problem does it solve?) and link to relevant
 issues and PRs.
+
 Also please summarize the changes in the title, for example "Raise ValueError on
 non-numeric input to set_xlim" and avoid non-descriptive titles such as "Addresses
 issue #8576".
@@ -19,7 +20,7 @@ issue #8576".
 - [ ] "closes #0000" is in the body of the PR description to [link the related issue](https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue)
 - [ ] new and changed code is [tested](https://matplotlib.org/devdocs/devel/testing.html)
 - [ ] *Plotting related* features are demonstrated in an [example](https://matplotlib.org/devdocs/devel/document.html#write-examples-and-tutorials)
-- [ ] *New Features* and *API Changes* are noted with a [directive and release note](https://matplotlib.org/devdocs/devel/coding_guide.html#new-features-and-api-changes)
+- [ ] *New Features* and *API Changes* are noted with a [directive and release note](https://matplotlib.org/devdocs/devel/api_changes.html#announce-changes-deprecations-and-new-features)
 - [ ] Documentation complies with [general](https://matplotlib.org/devdocs/devel/document.html#write-rest-pages) and [docstring](https://matplotlib.org/devdocs/devel/document.html#write-docstrings) guidelines
 
 <!--We understand that PRs can sometimes be overwhelming, especially as the

From 7d42980e29c2aa467b16495cf4e8393eefd31da1 Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Mon, 15 Jan 2024 09:58:15 +0000
Subject: [PATCH 0624/1120] Improve latex error message

Co-authored-by: hannah <story645@gmail.com>
---
 doc/conf.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/conf.py b/doc/conf.py
index 2b09bfaf5db0..f975b8076044 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -160,8 +160,8 @@ def _check_dependencies():
             "documentation")
     if shutil.which('latex') is None:
         raise OSError(
-            "No binary named latex - latex must be installed to build the "
-            "documentation")
+            "No binary named latex - a LaTeX distribution must be installed to build "
+            "the documentation")
 
 _check_dependencies()
 

From f023b561233a259a44a5908e96fd39422068a4ad Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 15 Jan 2024 20:00:08 +0000
Subject: [PATCH 0625/1120] Bump the actions group with 1 update

Bumps the actions group with 1 update: [pypa/gh-action-pypi-publish](https://github.com/pypa/gh-action-pypi-publish).


Updates `pypa/gh-action-pypi-publish` from 1.8.10 to 1.8.11
- [Release notes](https://github.com/pypa/gh-action-pypi-publish/releases)
- [Commits](https://github.com/pypa/gh-action-pypi-publish/compare/b7f401de30cb6434a1e19f805ff006643653240e...2f6f737ca5f74c637829c0f5c3acd0e29ea5e8bf)

---
updated-dependencies:
- dependency-name: pypa/gh-action-pypi-publish
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: actions
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 .github/workflows/cibuildwheel.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 1acae3baa719..b16e01a5ba7e 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -212,4 +212,4 @@ jobs:
         run: ls dist
 
       - name: Publish package distributions to PyPI
-        uses: pypa/gh-action-pypi-publish@b7f401de30cb6434a1e19f805ff006643653240e # v1.8.10
+        uses: pypa/gh-action-pypi-publish@2f6f737ca5f74c637829c0f5c3acd0e29ea5e8bf # v1.8.11

From 6089283df656fd24742d203ca3a3a3c633b066b4 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Mon, 15 Jan 2024 16:36:50 -0600
Subject: [PATCH 0626/1120] Fix Numpy 2.0 related test failures

---
 lib/matplotlib/pylab.py             |  2 ++
 lib/matplotlib/tests/test_axes.py   | 23 ++++++++++++++---------
 lib/matplotlib/tests/test_colors.py | 16 ++++++++--------
 3 files changed, 24 insertions(+), 17 deletions(-)

diff --git a/lib/matplotlib/pylab.py b/lib/matplotlib/pylab.py
index 77eb6506d87f..a50779cf6d26 100644
--- a/lib/matplotlib/pylab.py
+++ b/lib/matplotlib/pylab.py
@@ -60,6 +60,8 @@
 bytes = __import__("builtins").bytes
 # We also don't want the numpy version of these functions
 abs = __import__("builtins").abs
+bool = __import__("builtins").bool
 max = __import__("builtins").max
 min = __import__("builtins").min
+pow = __import__("builtins").pow
 round = __import__("builtins").round
diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index 5cafcdb5d2e9..530fddf127a8 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -5743,7 +5743,12 @@ def test_text_labelsize():
     ax.tick_params(direction='out')
 
 
-@image_comparison(['pie_default.png'])
+# Note: The `pie` image tests were affected by Numpy 2.0 changing promotions
+# (NEP 50). While the changes were only marginal, tolerances were introduced.
+# These tolerances could likely go away when numpy 2.0 is the minimum supported
+# numpy and the images are regenerated.
+
+@image_comparison(['pie_default.png'], tol=0.01)
 def test_pie_default():
     # The slices will be ordered and plotted counter-clockwise.
     labels = 'Frogs', 'Hogs', 'Dogs', 'Logs'
@@ -5756,7 +5761,7 @@ def test_pie_default():
 
 
 @image_comparison(['pie_linewidth_0', 'pie_linewidth_0', 'pie_linewidth_0'],
-                  extensions=['png'], style='mpl20')
+                  extensions=['png'], style='mpl20', tol=0.01)
 def test_pie_linewidth_0():
     # The slices will be ordered and plotted counter-clockwise.
     labels = 'Frogs', 'Hogs', 'Dogs', 'Logs'
@@ -5788,7 +5793,7 @@ def test_pie_linewidth_0():
     plt.axis('equal')
 
 
-@image_comparison(['pie_center_radius.png'], style='mpl20')
+@image_comparison(['pie_center_radius.png'], style='mpl20', tol=0.005)
 def test_pie_center_radius():
     # The slices will be ordered and plotted counter-clockwise.
     labels = 'Frogs', 'Hogs', 'Dogs', 'Logs'
@@ -5808,7 +5813,7 @@ def test_pie_center_radius():
     plt.axis('equal')
 
 
-@image_comparison(['pie_linewidth_2.png'], style='mpl20')
+@image_comparison(['pie_linewidth_2.png'], style='mpl20', tol=0.01)
 def test_pie_linewidth_2():
     # The slices will be ordered and plotted counter-clockwise.
     labels = 'Frogs', 'Hogs', 'Dogs', 'Logs'
@@ -5823,7 +5828,7 @@ def test_pie_linewidth_2():
     plt.axis('equal')
 
 
-@image_comparison(['pie_ccw_true.png'], style='mpl20')
+@image_comparison(['pie_ccw_true.png'], style='mpl20', tol=0.01)
 def test_pie_ccw_true():
     # The slices will be ordered and plotted counter-clockwise.
     labels = 'Frogs', 'Hogs', 'Dogs', 'Logs'
@@ -5838,7 +5843,7 @@ def test_pie_ccw_true():
     plt.axis('equal')
 
 
-@image_comparison(['pie_frame_grid.png'], style='mpl20')
+@image_comparison(['pie_frame_grid.png'], style='mpl20', tol=0.002)
 def test_pie_frame_grid():
     # The slices will be ordered and plotted counter-clockwise.
     labels = 'Frogs', 'Hogs', 'Dogs', 'Logs'
@@ -5865,7 +5870,7 @@ def test_pie_frame_grid():
     plt.axis('equal')
 
 
-@image_comparison(['pie_rotatelabels_true.png'], style='mpl20')
+@image_comparison(['pie_rotatelabels_true.png'], style='mpl20', tol=0.009)
 def test_pie_rotatelabels_true():
     # The slices will be ordered and plotted counter-clockwise.
     labels = 'Hogwarts', 'Frogs', 'Dogs', 'Logs'
@@ -5880,7 +5885,7 @@ def test_pie_rotatelabels_true():
     plt.axis('equal')
 
 
-@image_comparison(['pie_no_label.png'])
+@image_comparison(['pie_no_label.png'], tol=0.01)
 def test_pie_nolabel_but_legend():
     labels = 'Frogs', 'Hogs', 'Dogs', 'Logs'
     sizes = [15, 30, 45, 10]
@@ -5894,7 +5899,7 @@ def test_pie_nolabel_but_legend():
     plt.legend()
 
 
-@image_comparison(['pie_shadow.png'], style='mpl20')
+@image_comparison(['pie_shadow.png'], style='mpl20', tol=0.002)
 def test_pie_shadow():
     # Also acts as a test for the shade argument of Shadow
     sizes = [15, 30, 45, 10]
diff --git a/lib/matplotlib/tests/test_colors.py b/lib/matplotlib/tests/test_colors.py
index d77077340e8c..30cd5dfa844b 100644
--- a/lib/matplotlib/tests/test_colors.py
+++ b/lib/matplotlib/tests/test_colors.py
@@ -1379,38 +1379,38 @@ def test_scalarmappable_to_rgba(bytes):
     # uint8 RGBA
     x = np.ones((2, 3, 4), dtype=np.uint8)
     expected = x.copy() if bytes else x.astype(np.float32)/255
-    np.testing.assert_array_equal(sm.to_rgba(x, bytes=bytes), expected)
+    np.testing.assert_almost_equal(sm.to_rgba(x, bytes=bytes), expected)
     # uint8 RGB
     expected[..., 3] = alpha_1
-    np.testing.assert_array_equal(sm.to_rgba(x[..., :3], bytes=bytes), expected)
+    np.testing.assert_almost_equal(sm.to_rgba(x[..., :3], bytes=bytes), expected)
     # uint8 masked RGBA
     xm = np.ma.masked_array(x, mask=np.zeros_like(x))
     xm.mask[0, 0, 0] = True
     expected = x.copy() if bytes else x.astype(np.float32)/255
     expected[0, 0, 3] = 0
-    np.testing.assert_array_equal(sm.to_rgba(xm, bytes=bytes), expected)
+    np.testing.assert_almost_equal(sm.to_rgba(xm, bytes=bytes), expected)
     # uint8 masked RGB
     expected[..., 3] = alpha_1
     expected[0, 0, 3] = 0
-    np.testing.assert_array_equal(sm.to_rgba(xm[..., :3], bytes=bytes), expected)
+    np.testing.assert_almost_equal(sm.to_rgba(xm[..., :3], bytes=bytes), expected)
 
     # float RGBA
     x = np.ones((2, 3, 4), dtype=float) * 0.5
     expected = (x * 255).astype(np.uint8) if bytes else x.copy()
-    np.testing.assert_array_equal(sm.to_rgba(x, bytes=bytes), expected)
+    np.testing.assert_almost_equal(sm.to_rgba(x, bytes=bytes), expected)
     # float RGB
     expected[..., 3] = alpha_1
-    np.testing.assert_array_equal(sm.to_rgba(x[..., :3], bytes=bytes), expected)
+    np.testing.assert_almost_equal(sm.to_rgba(x[..., :3], bytes=bytes), expected)
     # float masked RGBA
     xm = np.ma.masked_array(x, mask=np.zeros_like(x))
     xm.mask[0, 0, 0] = True
     expected = (x * 255).astype(np.uint8) if bytes else x.copy()
     expected[0, 0, 3] = 0
-    np.testing.assert_array_equal(sm.to_rgba(xm, bytes=bytes), expected)
+    np.testing.assert_almost_equal(sm.to_rgba(xm, bytes=bytes), expected)
     # float masked RGB
     expected[..., 3] = alpha_1
     expected[0, 0, 3] = 0
-    np.testing.assert_array_equal(sm.to_rgba(xm[..., :3], bytes=bytes), expected)
+    np.testing.assert_almost_equal(sm.to_rgba(xm[..., :3], bytes=bytes), expected)
 
 
 def test_failed_conversions():

From 88e6aeb8d65626ec98014588ee99e4df9afb4236 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 20 Dec 2023 18:00:47 -0500
Subject: [PATCH 0627/1120] TST: Use importlib for importing in pytest

This fixes the rewriting so that we get detailed variable information
again, which was broken with the move to Meson (which does weird import
hacking for editable installs.)
---
 .github/workflows/cygwin.yml                  |  2 +-
 .github/workflows/tests.yml                   |  2 +-
 azure-pipelines.yml                           |  2 +-
 .../api_changes_3.5.0/deprecations.rst        |  2 +-
 .../api_changes_3.7.0/removals.rst            |  2 +-
 doc/devel/testing.rst                         | 39 ++++++++++++++-----
 pyproject.toml                                |  3 ++
 7 files changed, 37 insertions(+), 15 deletions(-)

diff --git a/.github/workflows/cygwin.yml b/.github/workflows/cygwin.yml
index 6968d7afb4f5..24253c5092e9 100644
--- a/.github/workflows/cygwin.yml
+++ b/.github/workflows/cygwin.yml
@@ -242,7 +242,7 @@ jobs:
         shell: bash.exe -eo pipefail -o igncr "{0}"
         id: cygwin-run-pytest
         run: |
-          xvfb-run python -mpytest -raR -n auto \
+          xvfb-run pytest -raR -n auto \
             --maxfail=50 --timeout=300 --durations=25 \
             --cov-report=xml --cov=lib --log-level=DEBUG --color=yes
 
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index b53a8794f20a..3abb1ae7e68b 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -316,7 +316,7 @@ jobs:
 
       - name: Run pytest
         run: |
-          python -mpytest -raR -n auto \
+          pytest -raR -n auto \
             --maxfail=50 --timeout=300 --durations=25 \
             --cov-report=xml --cov=lib --log-level=DEBUG --color=yes
 
diff --git a/azure-pipelines.yml b/azure-pipelines.yml
index 52c82a887a47..8cf1002b4aae 100644
--- a/azure-pipelines.yml
+++ b/azure-pipelines.yml
@@ -225,7 +225,7 @@ stages:
             fi
             echo "##vso[task.setvariable variable=VS_COVERAGE_TOOL]$TOOL"
           fi
-          PYTHONFAULTHANDLER=1 python -m pytest -raR -n 2 \
+          PYTHONFAULTHANDLER=1 pytest -raR -n 2 \
               --maxfail=50 --timeout=300 --durations=25 \
               --junitxml=junit/test-results.xml --cov-report=xml --cov=lib ||
             [[ "$PYTHON_VERSION" = 'Pre' ]]
diff --git a/doc/api/prev_api_changes/api_changes_3.5.0/deprecations.rst b/doc/api/prev_api_changes/api_changes_3.5.0/deprecations.rst
index 7bb9009fbe77..d10da55a97f8 100644
--- a/doc/api/prev_api_changes/api_changes_3.5.0/deprecations.rst
+++ b/doc/api/prev_api_changes/api_changes_3.5.0/deprecations.rst
@@ -353,7 +353,7 @@ is thus deprecated as well.
 To test an installed copy, be sure to specify both ``matplotlib`` and
 ``mpl_toolkits`` with ``--pyargs``::
 
-    python -m pytest --pyargs matplotlib.tests mpl_toolkits.tests
+    pytest --pyargs matplotlib.tests mpl_toolkits.tests
 
 See :ref:`testing` for more details.
 
diff --git a/doc/api/prev_api_changes/api_changes_3.7.0/removals.rst b/doc/api/prev_api_changes/api_changes_3.7.0/removals.rst
index 76ce9ff71819..03239be31057 100644
--- a/doc/api/prev_api_changes/api_changes_3.7.0/removals.rst
+++ b/doc/api/prev_api_changes/api_changes_3.7.0/removals.rst
@@ -185,7 +185,7 @@ is thus removed as well.
 To test an installed copy, be sure to specify both ``matplotlib`` and
 ``mpl_toolkits`` with ``--pyargs``::
 
-    python -m pytest --pyargs matplotlib.tests mpl_toolkits.tests
+    pytest --pyargs matplotlib.tests mpl_toolkits.tests
 
 See :ref:`testing` for more details.
 
diff --git a/doc/devel/testing.rst b/doc/devel/testing.rst
index 500890680e02..46bcec91ac19 100644
--- a/doc/devel/testing.rst
+++ b/doc/devel/testing.rst
@@ -37,11 +37,11 @@ Running the tests
 
 In the root directory of your development repository run::
 
-   python -m pytest
+   pytest
 
 
-pytest can be configured via a lot of `command-line parameters`_. Some
-particularly useful ones are:
+``pytest`` can be configured via many :external+pytest:doc:`command-line parameters
+<how-to/usage>`. Some particularly useful ones are:
 
 =============================  ===========
 ``-v`` or ``--verbose``        Be more verbose
@@ -50,14 +50,32 @@ particularly useful ones are:
 ``--capture=no`` or ``-s``     Do not capture stdout
 =============================  ===========
 
-To run a single test from the command line, you can provide a file path,
-optionally followed by the function separated by two colons, e.g., (tests do
-not need to be installed, but Matplotlib should be)::
+To run a single test from the command line, you can provide a file path, optionally
+followed by the function separated by two colons, e.g., (tests do not need to be
+installed, but Matplotlib should be)::
 
   pytest lib/matplotlib/tests/test_simplification.py::test_clipping
 
+If you want to use ``pytest`` as a module (via ``python -m pytest``), then you will need
+to avoid clashes between ``pytest``'s import mode and Python's search path:
 
-.. _command-line parameters: http://doc.pytest.org/en/latest/usage.html
+- On more recent Python, you may :external+python:std:option:`disable "unsafe import
+  paths" <-P>` (i.e., stop adding the current directory to the import path) with the
+  ``-P`` argument::
+
+      python -P -m pytest
+
+- On older Python, you may enable :external+python:std:option:`isolated mode <-I>`
+  (which stops adding the current directory to the import path, but has other
+  repercussions)::
+
+      python -I -m pytest
+
+- On any Python, set ``pytest``'s :external+pytest:doc:`import mode
+  <explanation/pythonpath>` to the older ``prepend`` mode (but note that this will break
+  ``pytest``'s assert rewriting)::
+
+      python -m pytest --import-mode prepend
 
 Viewing image test output
 ^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -302,11 +320,12 @@ is necessary for testing ``mpl_toolkits``.
 
 Run the tests
 ^^^^^^^^^^^^^
-To run the all the tests on your installed version of Matplotlib::
 
-    python -m pytest --pyargs matplotlib.tests
+To run all the tests on your installed version of Matplotlib::
+
+    pytest --pyargs matplotlib.tests
 
 The test discovery scope can be narrowed to single test modules or even single
 functions::
 
-    python -m pytest --pyargs matplotlib.tests.test_simplification.py::test_clipping
+    pytest --pyargs matplotlib.tests.test_simplification.py::test_clipping
diff --git a/pyproject.toml b/pyproject.toml
index ba090844331e..d20f76bade39 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -298,3 +298,6 @@ ignore_messages = [
 # `lib/matplotlib/testing/conftest.py`.
 minversion = "7.0"
 testpaths = ["lib"]
+addopts = [
+    "--import-mode=importlib",
+]

From 590d477a9f3ad2243ecef2ebe665279c26fb37e3 Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Tue, 16 Jan 2024 13:10:47 +0000
Subject: [PATCH 0628/1120] Fix tox stubtest python path

Co-authored-by: Kyle Sunden <git@ksunden.space>
---
 .github/workflows/mypy-stubtest.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/mypy-stubtest.yml b/.github/workflows/mypy-stubtest.yml
index 1280926021f1..f009720a43e0 100644
--- a/.github/workflows/mypy-stubtest.yml
+++ b/.github/workflows/mypy-stubtest.yml
@@ -35,7 +35,7 @@ jobs:
         run: |
           set -o pipefail
           tox -e stubtest | \
-              sed -e "s!.tox/stubtest/lib/python3.11/site-packages!lib!g" | \
+              sed -e "s!.tox/stubtest/lib/python3.9/site-packages!lib!g" | \
               reviewdog \
                 -efm '%Eerror: %m' \
                 -efm '%CStub: in file %f:%l' \

From f0a15772d12989ea6aacc2117bd2dbe924877e1d Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Tue, 16 Jan 2024 13:18:54 -0600
Subject: [PATCH 0629/1120] remove debug print

Co-authored-by: Thomas A Caswell <tcaswell@gmail.com>
---
 lib/matplotlib/backends/backend_pdf.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/lib/matplotlib/backends/backend_pdf.py b/lib/matplotlib/backends/backend_pdf.py
index 87f83af87061..573b401c1950 100644
--- a/lib/matplotlib/backends/backend_pdf.py
+++ b/lib/matplotlib/backends/backend_pdf.py
@@ -2708,7 +2708,6 @@ def __enter__(self):
         return self
 
     def __exit__(self, exc_type, exc_val, exc_tb):
-        print(f"Closing file {self._filename}")
         self.close()
 
     def _ensure_file(self):

From d0dcd9e851a16dbab1cbdd1b03f1f52c3b5c568f Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Thu, 11 Jan 2024 17:36:59 -0500
Subject: [PATCH 0630/1120] changed api changes to api guidelines and
 rearranged heirarchy a bit, added callout in coding guidelines to make more
 obvious.

Co-authored-by: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
---
 doc/devel/api_changes.rst  | 148 +++++++++++++++++++++----------------
 doc/devel/coding_guide.rst |   9 +--
 2 files changed, 87 insertions(+), 70 deletions(-)

diff --git a/doc/devel/api_changes.rst b/doc/devel/api_changes.rst
index b0904077ee0c..52d52ecbd6da 100644
--- a/doc/devel/api_changes.rst
+++ b/doc/devel/api_changes.rst
@@ -1,7 +1,7 @@
 .. _api_changes:
 
-API changes
-===========
+API guidelines
+==============
 
 API consistency and stability are of great value; Therefore, API changes
 (e.g. signature changes, behavior changes, removals) will only be conducted
@@ -17,67 +17,45 @@ are backwards-incompatible API changes.
 
    color_changes.rst
 
-.. _api_whats_new:
-
-Announce changes, deprecations, and new features
-------------------------------------------------
 
-When adding or changing the API in a backward in-compatible way, please add the
-appropriate :ref:`versioning directive <versioning-directives>` and document it
-for the release notes and add the entry to the appropriate folder:
+Add new API and features
+------------------------
 
-+-------------------+-----------------------------+----------------------------------------------+
-| addition          |   versioning directive      |  announcement folder                         |
-+===================+=============================+==============================================+
-| new feature       | ``.. versionadded:: 3.N``   | :file:`doc/users/next_whats_new/`            |
-+-------------------+-----------------------------+----------------------------------------------+
-| API change        | ``.. versionchanged:: 3.N`` | :file:`doc/api/next_api_changes/[kind]`      |
-+-------------------+-----------------------------+----------------------------------------------+
-
-API deprecations are first introduced and then expired. During the introduction
-period, users are warned that the API *will* change in the future.
-During the expiration period, code is changed as described in the notice posted
-during the introductory period.
-
-+-----------+--------------------------------------------------+----------------------------------------------+
-|   stage   |                 required changes                 |             announcement folder              |
-+===========+==================================================+==============================================+
-| introduce | :ref:`introduce deprecation <intro-deprecation>` | :file:`doc/api/next_api_changes/deprecation` |
-+-----------+--------------------------------------------------+----------------------------------------------+
-| expire    | :ref:`expire deprecation <expire-deprecation>`   | :file:`doc/api/next_api_changes/[kind]`      |
-+-----------+--------------------------------------------------+----------------------------------------------+
-
-For both change notes and what's new, please avoid using references in section
-titles, as it causes links to be confusing in the table of contents. Instead,
-ensure that a reference is included in the descriptive text.
-
-API Change Notes
-^^^^^^^^^^^^^^^^
+Every new function, parameter and attribute that is not explicitly marked as
+private (i.e., starts with an underscore) becomes part of Matplotlib's public
+API. As discussed above, changing the existing API is cumbersome. Therefore,
+take particular care when adding new API:
 
-.. include:: ../api/next_api_changes/README.rst
-   :start-line: 5
-   :end-line: 31
+- Mark helper functions and internal attributes as private by prefixing them
+  with an underscore.
+- Carefully think about good names for your functions and variables.
+- Try to adopt patterns and naming conventions from existing parts of the
+  Matplotlib API.
+- Consider making as many arguments keyword-only as possible. See also
+  `API Evolution the Right Way -- Add Parameters Compatibly`__.
 
-What's new
-^^^^^^^^^^
+  __ https://emptysqua.re/blog/api-evolution-the-right-way/#adding-parameters
 
-.. include:: ../users/next_whats_new/README.rst
-   :start-line: 5
-   :end-line: 24
 
+.. _deprecation-guidelines:
 
-Deprecation
------------
+Deprecate API
+-------------
 
 API changes in Matplotlib have to be performed following the deprecation process
 below, except in very rare circumstances as deemed necessary by the development
-team. This ensures that users are notified before the change will take effect
-and thus prevents unexpected breaking of code.
+team. Generally API deprecation happens in two stages:
+
+* **introduce:** warn users that the API *will* change
+* **expire:** API *is* changed as described in the introduction period
+
+This ensures that users are notified before the change will take effect and thus
+prevents unexpected breaking of code.
 
 Rules
 ^^^^^
-- Deprecations are targeted at the next point.release (e.g. 3.x)
-- Deprecated API is generally removed two point-releases after introduction
+- Deprecations are targeted at the next :ref:`minor release <pr-milestones>` (e.g. 3.x)
+- Deprecated API is generally removed (expired) two point-releases after introduction
   of the deprecation. Longer deprecations can be imposed by core developers on
   a case-by-case basis to give more time for the transition
 - The old API must remain fully functional during the deprecation period
@@ -147,29 +125,44 @@ Expire deprecation
      instead. For removed items that were not in the stub file, only deleting from the
      allowlist is required.
 
-Adding new API and features
----------------------------
 
-Every new function, parameter and attribute that is not explicitly marked as
-private (i.e., starts with an underscore) becomes part of Matplotlib's public
-API. As discussed above, changing the existing API is cumbersome. Therefore,
-take particular care when adding new API:
+.. redirect-from:: /devel/coding_guide#new-features-and-api-changes
 
-- Mark helper functions and internal attributes as private by prefixing them
-  with an underscore.
-- Carefully think about good names for your functions and variables.
-- Try to adopt patterns and naming conventions from existing parts of the
-  Matplotlib API.
-- Consider making as many arguments keyword-only as possible. See also
-  `API Evolution the Right Way -- Add Parameters Compatibly`__.
+.. _api_whats_new:
 
-  __ https://emptysqua.re/blog/api-evolution-the-right-way/#adding-parameters
+Announce new and deprecated API
+-------------------------------
+
+When adding or changing the API in a backward in-compatible way, please add the
+appropriate :ref:`versioning directive <versioning-directives>` and document it
+for the release notes and add the entry to the appropriate folder:
+
++-------------------+-----------------------------+----------------------------------------------+
+|                   |   versioning directive      |  announcement folder                         |
++===================+=============================+==============================================+
+| new feature       | ``.. versionadded:: 3.N``   | :file:`doc/users/next_whats_new/`            |
++-------------------+-----------------------------+----------------------------------------------+
+| API change        | ``.. versionchanged:: 3.N`` | :file:`doc/api/next_api_changes/[kind]`      |
++-------------------+-----------------------------+----------------------------------------------+
+
+When deprecating API, please add a notice as described in the
+:ref:`deprecation guidelines <deprecation-guidelines>` and summarized here:
 
++--------------------------------------------------+----------------------------------------------+
+|   stage                                          |             announcement folder              |
++===========+======================================+==============================================+
+| :ref:`introduce deprecation <intro-deprecation>` | :file:`doc/api/next_api_changes/deprecation` |
++-----------+--------------------------------------+----------------------------------------------+
+| :ref:`expire deprecation <expire-deprecation>`   | :file:`doc/api/next_api_changes/[kind]`      |
++-----------+--------------------------------------+----------------------------------------------+
+
+Generally the introduction notices can be repurposed for the expiration notice as they
+are expected to be describing the same API changes and removals.
 
 .. _versioning-directives:
 
 Versioning directives
----------------------
+^^^^^^^^^^^^^^^^^^^^^
 
 When making a backward incompatible change, please add a versioning directive in
 the docstring. The directives should be placed at the end of a description block.
@@ -209,3 +202,28 @@ For classes and functions, the directive should be placed before the
 *Parameters* section. For parameters, the directive should be placed at the
 end of the parameter description. The patch release version is omitted and
 the directive should not be added to entire modules.
+
+Release notes
+^^^^^^^^^^^^^
+
+For both change notes and what's new, please avoid using cross-references in section
+titles as it causes links to be confusing in the table of contents. Instead, ensure that
+a cross-reference is included in the descriptive text.
+
+.. _api-change-notes:
+
+API change notes
+""""""""""""""""
+
+.. include:: ../api/next_api_changes/README.rst
+   :start-line: 5
+   :end-line: 31
+
+.. _whats-new-notes:
+
+What's new notes
+""""""""""""""""
+
+.. include:: ../users/next_whats_new/README.rst
+   :start-line: 5
+   :end-line: 24
diff --git a/doc/devel/coding_guide.rst b/doc/devel/coding_guide.rst
index 6564de906979..05c63e43fe60 100644
--- a/doc/devel/coding_guide.rst
+++ b/doc/devel/coding_guide.rst
@@ -7,12 +7,11 @@ Coding guidelines
 We appreciate these guidelines being followed because it improves the readability,
 consistency, and maintainability of the code base.
 
-API changes
-===========
+.. admonition:: API guidelines
+    :class: seealso
 
-If you are adding new features, changing behavior or function signatures, or
-removing classes, functions, methods, or properties, please see the :ref:`api_changes`
-guide.
+    If adding new features, changing behavior or function signatures, or removing
+    public interfaces, please consult the :ref:`api_changes`.
 
 PEP8, as enforced by flake8
 ===========================

From 4a3df94d1829e581dad6c2f3214f1cc0437014e9 Mon Sep 17 00:00:00 2001
From: saranti <tsarantis@proton.me>
Date: Wed, 17 Jan 2024 16:10:21 +1100
Subject: [PATCH 0631/1120] Simplify test

---
 lib/matplotlib/tests/test_ticker.py | 35 +++++++++++------------------
 1 file changed, 13 insertions(+), 22 deletions(-)

diff --git a/lib/matplotlib/tests/test_ticker.py b/lib/matplotlib/tests/test_ticker.py
index 267178662865..fcfdf8ee92f5 100644
--- a/lib/matplotlib/tests/test_ticker.py
+++ b/lib/matplotlib/tests/test_ticker.py
@@ -12,8 +12,6 @@
 import matplotlib.pyplot as plt
 import matplotlib.ticker as mticker
 
-import random
-
 
 class TestMaxNLocator:
     basic_data = [
@@ -1806,23 +1804,16 @@ def test_minorticks_on_multi_fig():
     that contains more than one boxplot and shares the x-axis
     should not raise an exception.
     """
-    fig, ax = plt.subplots(sharex=True, ncols=2, nrows=2)
-
-    def values():
-        return [random.random() for _ in range(9)]
-
-    for x in range(3):
-        ax[0, 0].boxplot(values(), positions=[x])
-        ax[0, 1].boxplot(values(), positions=[x])
-        ax[1, 0].boxplot(values(), positions=[x])
-        ax[1, 1].boxplot(values(), positions=[x])
-
-    for a in ax.flatten():
-        a.grid(which="major")
-        a.grid(which="minor", linestyle="--")
-        a.minorticks_on()
-    fig.canvas.draw()
-
-    assert all(a.get_xgridlines() for a in ax.flatten())
-    assert all((isinstance(a.xaxis.get_minor_locator(), mpl.ticker.AutoMinorLocator)
-                for a in ax.flatten()))
+    fig, ax = plt.subplots()
+
+    ax.boxplot(np.arange(10), positions=[0])
+    ax.boxplot(np.arange(10), positions=[0])
+    ax.boxplot(np.arange(10), positions=[1])
+
+    ax.grid(which="major")
+    ax.grid(which="minor")
+    ax.minorticks_on()
+    fig.draw_without_rendering()
+
+    assert ax.get_xgridlines()
+    assert isinstance(ax.xaxis.get_minor_locator(), mpl.ticker.AutoMinorLocator)

From 680b70b3844859557b6e7b8bdcdec6e7b72c9b89 Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Tue, 9 Jan 2024 15:03:17 +0000
Subject: [PATCH 0632/1120] Use action to install reviewdog

---
 .github/workflows/mypy-stubtest.yml |  7 +------
 .github/workflows/reviewdog.yml     | 14 ++------------
 2 files changed, 3 insertions(+), 18 deletions(-)

diff --git a/.github/workflows/mypy-stubtest.yml b/.github/workflows/mypy-stubtest.yml
index f009720a43e0..969aacccad74 100644
--- a/.github/workflows/mypy-stubtest.yml
+++ b/.github/workflows/mypy-stubtest.yml
@@ -19,12 +19,7 @@ jobs:
           python-version: 3.9
 
       - name: Set up reviewdog
-        run: |
-          mkdir -p "$HOME/bin"
-          curl -sfL \
-            https://github.com/reviewdog/reviewdog/raw/master/install.sh | \
-              sh -s -- -b "$HOME/bin"
-          echo "$HOME/bin" >> $GITHUB_PATH
+        uses: reviewdog/action-setup@v1
 
       - name: Install tox
         run: python -m pip install tox
diff --git a/.github/workflows/reviewdog.yml b/.github/workflows/reviewdog.yml
index f4495eda8b84..aa3602571c03 100644
--- a/.github/workflows/reviewdog.yml
+++ b/.github/workflows/reviewdog.yml
@@ -23,12 +23,7 @@ jobs:
         run: pip3 install -r requirements/testing/flake8.txt
 
       - name: Set up reviewdog
-        run: |
-          mkdir -p "$HOME/bin"
-          curl -sfL \
-            https://github.com/reviewdog/reviewdog/raw/master/install.sh | \
-              sh -s -- -b "$HOME/bin"
-          echo "$HOME/bin" >> $GITHUB_PATH
+        uses: reviewdog/action-setup@v1
 
       - name: Run flake8
         env:
@@ -53,12 +48,7 @@ jobs:
         run: pip3 install -r requirements/testing/mypy.txt -r requirements/testing/all.txt
 
       - name: Set up reviewdog
-        run: |
-          mkdir -p "$HOME/bin"
-          curl -sfL \
-            https://github.com/reviewdog/reviewdog/raw/master/install.sh | \
-              sh -s -- -b "$HOME/bin"
-          echo "$HOME/bin" >> $GITHUB_PATH
+        uses: reviewdog/action-setup@v1
 
       - name: Run mypy
         env:

From 35e6e606d8e596c39d73f35aabced8f7169227d1 Mon Sep 17 00:00:00 2001
From: ShivamPathak99 <98941325+ShivamPathak99@users.noreply.github.com>
Date: Thu, 18 Jan 2024 19:47:47 +0530
Subject: [PATCH 0633/1120] Removed warning message of inset_axes

Removed warning message of inset_axes
This method is experimental as of 3.0, and the API may change.
---
 lib/matplotlib/axes/_axes.py | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index b1343b5c65bb..2998047e1eda 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -331,9 +331,7 @@ def inset_axes(self, bounds, *, transform=None, zorder=5, **kwargs):
         """
         Add a child inset Axes to this existing Axes.
 
-        Warnings
-        --------
-        This method is experimental as of 3.0, and the API may change.
+
 
         Parameters
         ----------

From bca6491d51b870801fca0228265990825bad023c Mon Sep 17 00:00:00 2001
From: ShivamPathak99 <98941325+ShivamPathak99@users.noreply.github.com>
Date: Thu, 18 Jan 2024 19:55:31 +0530
Subject: [PATCH 0634/1120] Created inset_axes.rst

Changed status from experimental to stable
---
 doc/users/next_whats_new/inset_axes.rst | 7 +++++++
 1 file changed, 7 insertions(+)
 create mode 100644 doc/users/next_whats_new/inset_axes.rst

diff --git a/doc/users/next_whats_new/inset_axes.rst b/doc/users/next_whats_new/inset_axes.rst
new file mode 100644
index 000000000000..d2595d31afb0
--- /dev/null
+++ b/doc/users/next_whats_new/inset_axes.rst
@@ -0,0 +1,7 @@
+'Axes.inset_axes' is no longer experimental
+-------------------------
+
+Axes.inset_axes is now cosidered stable for use.
+
+
+~~~~~~~~~~~~~

From 65ec53990d9336f6889283d4b736c20f09a23a72 Mon Sep 17 00:00:00 2001
From: ShivamPathak99 <98941325+ShivamPathak99@users.noreply.github.com>
Date: Fri, 19 Jan 2024 00:04:01 +0530
Subject: [PATCH 0635/1120] Update __init__.py Removed  deprecated warning

Removed warn_deprecated(...)
---
 lib/matplotlib/_api/__init__.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/lib/matplotlib/_api/__init__.py b/lib/matplotlib/_api/__init__.py
index 27d68529b7d4..bae8629653d7 100644
--- a/lib/matplotlib/_api/__init__.py
+++ b/lib/matplotlib/_api/__init__.py
@@ -305,7 +305,6 @@ def my_func(*args, **kwargs):
                 [lambda old1, old2: locals(), lambda new: locals()],
                 *args, **kwargs)
             if "old1" in params:
-                warn_deprecated(...)
                 old1, old2 = params.values()  # note that locals() is ordered.
             else:
                 new, = params.values()

From bafbe9c27488ab8e018274131c4f9315bcfb2682 Mon Sep 17 00:00:00 2001
From: Juhan Oskar Hennoste <juhanoskar@gmail.com>
Date: Thu, 18 Jan 2024 22:14:09 +0200
Subject: [PATCH 0636/1120] Change return type of ion and ioff to fix unbound
 variable errors with Pyright

---
 lib/matplotlib/pyplot.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 2c1403900529..a7d1bf2c0cb2 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -556,7 +556,7 @@ def isinteractive() -> bool:
     return matplotlib.is_interactive()
 
 
-def ioff() -> ExitStack:
+def ioff() -> AbstractContextManager:
     """
     Disable interactive mode.
 
@@ -586,7 +586,7 @@ def ioff() -> ExitStack:
             # ...
 
     To enable optional usage as a context manager, this function returns a
-    `~contextlib.ExitStack` object, which is not intended to be stored or
+    context manager object, which is not intended to be stored or
     accessed by the user.
     """
     stack = ExitStack()
@@ -596,7 +596,7 @@ def ioff() -> ExitStack:
     return stack
 
 
-def ion() -> ExitStack:
+def ion() -> AbstractContextManager:
     """
     Enable interactive mode.
 
@@ -626,7 +626,7 @@ def ion() -> ExitStack:
             # ...
 
     To enable optional usage as a context manager, this function returns a
-    `~contextlib.ExitStack` object, which is not intended to be stored or
+    context manager object, which is not intended to be stored or
     accessed by the user.
     """
     stack = ExitStack()

From 7a1461cbe0d51f7d6b7da61d1fcffc5ac4ed95ed Mon Sep 17 00:00:00 2001
From: Juhan Oskar Hennoste <juhanoskar@gmail.com>
Date: Fri, 19 Jan 2024 00:55:34 +0200
Subject: [PATCH 0637/1120] Add comment explaining rationale

---
 lib/matplotlib/pyplot.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index a7d1bf2c0cb2..a304c15ddfc8 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -556,6 +556,9 @@ def isinteractive() -> bool:
     return matplotlib.is_interactive()
 
 
+# Note: The return type of ioff being AbstractContextManager instead of ExitStack is deliberate.
+# See https://github.com/matplotlib/matplotlib/issues/27659 
+# and https://github.com/matplotlib/matplotlib/pull/27667 for more info.
 def ioff() -> AbstractContextManager:
     """
     Disable interactive mode.
@@ -596,6 +599,9 @@ def ioff() -> AbstractContextManager:
     return stack
 
 
+# Note: The return type of ion being AbstractContextManager instead of ExitStack is deliberate.
+# See https://github.com/matplotlib/matplotlib/issues/27659 
+# and https://github.com/matplotlib/matplotlib/pull/27667 for more info.
 def ion() -> AbstractContextManager:
     """
     Enable interactive mode.

From 2f56a2aaa8d7d7456d3f578d2136e7f2ebeaa62a Mon Sep 17 00:00:00 2001
From: Juhan Oskar Hennoste <juhanoskar@gmail.com>
Date: Fri, 19 Jan 2024 01:09:33 +0200
Subject: [PATCH 0638/1120] Fix flake8 lint error

---
 lib/matplotlib/pyplot.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index a304c15ddfc8..cb50a10fa8f5 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -556,7 +556,8 @@ def isinteractive() -> bool:
     return matplotlib.is_interactive()
 
 
-# Note: The return type of ioff being AbstractContextManager instead of ExitStack is deliberate.
+# Note: The return type of ioff being AbstractContextManager 
+# instead of ExitStack is deliberate.
 # See https://github.com/matplotlib/matplotlib/issues/27659 
 # and https://github.com/matplotlib/matplotlib/pull/27667 for more info.
 def ioff() -> AbstractContextManager:
@@ -599,7 +600,8 @@ def ioff() -> AbstractContextManager:
     return stack
 
 
-# Note: The return type of ion being AbstractContextManager instead of ExitStack is deliberate.
+# Note: The return type of ion being AbstractContextManager 
+# instead of ExitStack is deliberate.
 # See https://github.com/matplotlib/matplotlib/issues/27659 
 # and https://github.com/matplotlib/matplotlib/pull/27667 for more info.
 def ion() -> AbstractContextManager:

From f49c0e3d0bb51e9e7f613eb8967b82166e312c98 Mon Sep 17 00:00:00 2001
From: Juhan Oskar Hennoste <juhanoskar@gmail.com>
Date: Fri, 19 Jan 2024 01:11:41 +0200
Subject: [PATCH 0639/1120] Actually fix flake8 lint

---
 lib/matplotlib/pyplot.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index cb50a10fa8f5..d759d9ee6e5b 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -556,9 +556,9 @@ def isinteractive() -> bool:
     return matplotlib.is_interactive()
 
 
-# Note: The return type of ioff being AbstractContextManager 
+# Note: The return type of ioff being AbstractContextManager
 # instead of ExitStack is deliberate.
-# See https://github.com/matplotlib/matplotlib/issues/27659 
+# See https://github.com/matplotlib/matplotlib/issues/27659
 # and https://github.com/matplotlib/matplotlib/pull/27667 for more info.
 def ioff() -> AbstractContextManager:
     """
@@ -600,9 +600,9 @@ def ioff() -> AbstractContextManager:
     return stack
 
 
-# Note: The return type of ion being AbstractContextManager 
+# Note: The return type of ion being AbstractContextManager
 # instead of ExitStack is deliberate.
-# See https://github.com/matplotlib/matplotlib/issues/27659 
+# See https://github.com/matplotlib/matplotlib/issues/27659
 # and https://github.com/matplotlib/matplotlib/pull/27667 for more info.
 def ion() -> AbstractContextManager:
     """

From 75d1c023b35c06d2f4e92ada2641e2ed1d7573ff Mon Sep 17 00:00:00 2001
From: ShivamPathak99 <98941325+ShivamPathak99@users.noreply.github.com>
Date: Fri, 19 Jan 2024 08:37:16 +0530
Subject: [PATCH 0640/1120] restored warn_deprecated

---
 lib/matplotlib/_api/__init__.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/lib/matplotlib/_api/__init__.py b/lib/matplotlib/_api/__init__.py
index bae8629653d7..4fef7c3b5f83 100644
--- a/lib/matplotlib/_api/__init__.py
+++ b/lib/matplotlib/_api/__init__.py
@@ -305,6 +305,7 @@ def my_func(*args, **kwargs):
                 [lambda old1, old2: locals(), lambda new: locals()],
                 *args, **kwargs)
             if "old1" in params:
+                 warn_deprecated(...)
                 old1, old2 = params.values()  # note that locals() is ordered.
             else:
                 new, = params.values()

From 6d304f39e8061069bd7ee2a5b905edcd88219f39 Mon Sep 17 00:00:00 2001
From: ShivamPathak99 <98941325+ShivamPathak99@users.noreply.github.com>
Date: Fri, 19 Jan 2024 08:42:43 +0530
Subject: [PATCH 0641/1120] Update inset_axes.rst

---
 doc/users/next_whats_new/inset_axes.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/doc/users/next_whats_new/inset_axes.rst b/doc/users/next_whats_new/inset_axes.rst
index d2595d31afb0..3b3157996127 100644
--- a/doc/users/next_whats_new/inset_axes.rst
+++ b/doc/users/next_whats_new/inset_axes.rst
@@ -1,7 +1,7 @@
 'Axes.inset_axes' is no longer experimental
--------------------------
+-------------------------------------------
 
-Axes.inset_axes is now cosidered stable for use.
+Axes.inset_axes is cosidered stable for use.
 
-
-~~~~~~~~~~~~~
+Warning removed
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From 2d977895202f78bfef3c6debf916a9ba02b7628f Mon Sep 17 00:00:00 2001
From: ShivamPathak99 <98941325+ShivamPathak99@users.noreply.github.com>
Date: Fri, 19 Jan 2024 08:44:39 +0530
Subject: [PATCH 0642/1120] Update inset_axes.rst

---
 doc/users/next_whats_new/inset_axes.rst | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/doc/users/next_whats_new/inset_axes.rst b/doc/users/next_whats_new/inset_axes.rst
index 3b3157996127..6fd658d60b98 100644
--- a/doc/users/next_whats_new/inset_axes.rst
+++ b/doc/users/next_whats_new/inset_axes.rst
@@ -2,6 +2,3 @@
 -------------------------------------------
 
 Axes.inset_axes is cosidered stable for use.
-
-Warning removed
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From ea458a00b244c38418ebf09ea5dcb6c96cc5da2e Mon Sep 17 00:00:00 2001
From: ShivamPathak99 <98941325+ShivamPathak99@users.noreply.github.com>
Date: Fri, 19 Jan 2024 08:48:08 +0530
Subject: [PATCH 0643/1120] Update __init__.py

---
 lib/matplotlib/_api/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/_api/__init__.py b/lib/matplotlib/_api/__init__.py
index 4fef7c3b5f83..27d68529b7d4 100644
--- a/lib/matplotlib/_api/__init__.py
+++ b/lib/matplotlib/_api/__init__.py
@@ -305,7 +305,7 @@ def my_func(*args, **kwargs):
                 [lambda old1, old2: locals(), lambda new: locals()],
                 *args, **kwargs)
             if "old1" in params:
-                 warn_deprecated(...)
+                warn_deprecated(...)
                 old1, old2 = params.values()  # note that locals() is ordered.
             else:
                 new, = params.values()

From f8df6ba27115431c103432350c7f6381a6512fc7 Mon Sep 17 00:00:00 2001
From: Greg Lucas <greg.m.lucas@gmail.com>
Date: Thu, 18 Jan 2024 19:22:39 -0700
Subject: [PATCH 0644/1120] MNT: Implement macos AppDelegate

This suppresses a warning that appears with MacOS 14+.
WARNING: Secure coding is not enabled for restorable state!
---
 src/_macosx.m | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/src/_macosx.m b/src/_macosx.m
index ac9009965b4f..8038b72899df 100755
--- a/src/_macosx.m
+++ b/src/_macosx.m
@@ -100,6 +100,9 @@ static int wait_for_stdin() {
 }
 
 /* ---------------------------- Cocoa classes ---------------------------- */
+@interface MatplotlibAppDelegate : NSObject <NSApplicationDelegate>
+- (BOOL)applicationSupportsSecureRestorableState:(NSApplication *)app;
+@end
 
 @interface Window : NSWindow
 {   PyObject* manager;
@@ -195,6 +198,7 @@ static void lazy_init(void) {
 
     NSApp = [NSApplication sharedApplication];
     [NSApp setActivationPolicy:NSApplicationActivationPolicyRegular];
+    [NSApp setDelegate: [[[MatplotlibAppDelegate alloc] init] autorelease]];
 
     // Run our own event loop while waiting for stdin on the Python side
     // this is needed to keep the application responsive while waiting for input
@@ -779,6 +783,12 @@ int mpl_check_modifier(
     },
 };
 
+@implementation MatplotlibAppDelegate
+- (BOOL)applicationSupportsSecureRestorableState:(NSApplication *)app {
+    return YES;
+}
+@end
+
 @interface NavigationToolbar2Handler : NSObject
 {   PyObject* toolbar;
     NSButton* panbutton;

From 45bc8f7292deb346a2d82ab52ee2184774127f28 Mon Sep 17 00:00:00 2001
From: ShivamPathak99 <98941325+ShivamPathak99@users.noreply.github.com>
Date: Fri, 19 Jan 2024 09:08:40 +0530
Subject: [PATCH 0645/1120] Update inset_axes.rst

---
 doc/users/next_whats_new/inset_axes.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/doc/users/next_whats_new/inset_axes.rst b/doc/users/next_whats_new/inset_axes.rst
index 6fd658d60b98..23f7e6755f1a 100644
--- a/doc/users/next_whats_new/inset_axes.rst
+++ b/doc/users/next_whats_new/inset_axes.rst
@@ -2,3 +2,6 @@
 -------------------------------------------
 
 Axes.inset_axes is cosidered stable for use.
+
+
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From 30c1849ada179ce83856c771fd61129b5239e07f Mon Sep 17 00:00:00 2001
From: ShivamPathak99 <98941325+ShivamPathak99@users.noreply.github.com>
Date: Fri, 19 Jan 2024 09:13:13 +0530
Subject: [PATCH 0646/1120] Update inset_axes.rst

---
 doc/users/next_whats_new/inset_axes.rst | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/doc/users/next_whats_new/inset_axes.rst b/doc/users/next_whats_new/inset_axes.rst
index 23f7e6755f1a..4b8b374c7fff 100644
--- a/doc/users/next_whats_new/inset_axes.rst
+++ b/doc/users/next_whats_new/inset_axes.rst
@@ -1,7 +1,5 @@
 'Axes.inset_axes' is no longer experimental
--------------------------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Axes.inset_axes is cosidered stable for use.
 
-
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From d7b16a4bd19202407e44fe1ef98367f761a38d56 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 19 Jan 2024 23:23:44 -0500
Subject: [PATCH 0647/1120] BLD: Downgrade FreeType to 2.6.1 on Windows ARM

We needed the new version because autotools didn't know about
Windows-on-ARM. But we build with Meson now, and overlay a Meson build
system for FreeType, so it either works for both of us or it doesn't
(and it does).

Dropping down to the older version means that tests pass on Windows ARM
without any need to mess with tolerance or generating new images.
---
 doc/api/next_api_changes/development/27676-ES.rst | 6 ++++++
 extern/meson.build                                | 9 +--------
 subprojects/freetype-2.11.1.wrap                  | 7 -------
 3 files changed, 7 insertions(+), 15 deletions(-)
 create mode 100644 doc/api/next_api_changes/development/27676-ES.rst
 delete mode 100644 subprojects/freetype-2.11.1.wrap

diff --git a/doc/api/next_api_changes/development/27676-ES.rst b/doc/api/next_api_changes/development/27676-ES.rst
new file mode 100644
index 000000000000..5242c5cba943
--- /dev/null
+++ b/doc/api/next_api_changes/development/27676-ES.rst
@@ -0,0 +1,6 @@
+Windows on ARM64 support
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+Windows on ARM64 bundles FreeType 2.6.1 instead of 2.11.1 when building from source.
+This may cause small changes to text rendering, but should become consistent with all
+other platforms.
diff --git a/extern/meson.build b/extern/meson.build
index af809ce2531d..662feb7872da 100644
--- a/extern/meson.build
+++ b/extern/meson.build
@@ -14,14 +14,7 @@ else
   # must match the value in `lib/matplotlib.__init__.py`. Also update the docs
   # in `docs/devel/dependencies.rst`. Bump the cache key in
   # `.circleci/config.yml` when changing requirements.
-  TESTING_VERSION_OF_FREETYPE = '2.6.1'
-  if host_machine.system() == 'windows' and host_machine.cpu_family() == 'aarch64'
-    # Older versions of freetype are not supported for win/arm64
-    # Matplotlib tests will not pass
-    LOCAL_FREETYPE_VERSION = '2.11.1'
-  else
-    LOCAL_FREETYPE_VERSION = TESTING_VERSION_OF_FREETYPE
-  endif
+  LOCAL_FREETYPE_VERSION = '2.6.1'
 
   freetype_proj = subproject(
     f'freetype-@LOCAL_FREETYPE_VERSION@',
diff --git a/subprojects/freetype-2.11.1.wrap b/subprojects/freetype-2.11.1.wrap
deleted file mode 100644
index af4e91e2d0a5..000000000000
--- a/subprojects/freetype-2.11.1.wrap
+++ /dev/null
@@ -1,7 +0,0 @@
-[wrap-file]
-source_url = https://download.savannah.gnu.org/releases/freetype/freetype-2.11.1.tar.xz
-source_filename = freetype-2.11.1.tar.xz
-source_hash = 3333ae7cfda88429c97a7ae63b7d01ab398076c3b67182e960e5684050f2c5c8
-
-[provide]
-freetype-2.11.1 = freetype_dep

From ec683632d56fa9dcb335c06996d0aada86af5598 Mon Sep 17 00:00:00 2001
From: patel-zeel <patel_zeel@iitgn.ac.in>
Date: Sat, 20 Jan 2024 23:14:10 +0530
Subject: [PATCH 0648/1120] update _unpack_to_numpy to handle JAX and PyTorch
 arrays with sys.modules

---
 lib/matplotlib/cbook.py | 36 +++++++++++++++++++++++++++---------
 1 file changed, 27 insertions(+), 9 deletions(-)

diff --git a/lib/matplotlib/cbook.py b/lib/matplotlib/cbook.py
index 03678b0a968b..e897b654b4f8 100644
--- a/lib/matplotlib/cbook.py
+++ b/lib/matplotlib/cbook.py
@@ -19,6 +19,7 @@
 import time
 import traceback
 import types
+import warnings
 import weakref
 
 import numpy as np
@@ -2234,13 +2235,32 @@ def _picklable_class_constructor(mixin_class, fmt, attr_name, base_class):
     return cls.__new__(cls)
 
 
+def _is_torch_array(x):
+    try:
+        return isinstance(x, sys.modules['torch'].Tensor)
+    except (KeyError, AttributeError, TypeError):
+        return False
+    except Exception as e:
+        warnings.warn(f"Error checking if {x} is a PyTorch Tensor: \n {e} \
+                      \n Please report this issue to the developers.")
+        return False
+
+
+def _is_jax_array(x):
+    try:
+        return isinstance(x, sys.modules['jax'].Array)
+    except (KeyError, AttributeError, TypeError):
+        return False
+    except Exception as e:
+        warnings.warn(f"Error checking if {x} is a JAX Array: \n {e} \
+                      \n Please report this issue to the developers.")
+        return False
+
+
 def _unpack_to_numpy(x):
     """Internal helper to extract data from e.g. pandas and xarray objects."""
     if isinstance(x, np.ndarray):
-        # If numpy array, return directly
-        return x
-    if isinstance(x, np.generic):
-        # If numpy scalar, return directly
+        # If numpy, return directly
         return x
     if hasattr(x, 'to_numpy'):
         # Assume that any to_numpy() method actually returns a numpy array
@@ -2251,12 +2271,10 @@ def _unpack_to_numpy(x):
         # so in this case we do not want to return a function
         if isinstance(xtmp, np.ndarray):
             return xtmp
-    if hasattr(x, '__array__'):
-        # Assume that any to __array__() method returns a numpy array
-        # (e.g. TensorFlow, JAX or PyTorch arrays)
+    if _is_torch_array(x) or _is_jax_array(x):
         xtmp = x.__array__()
-        # Anything that doesn't return ndarray via __array__() method
-        # will be filtered by the following check
+
+        # In case __array__() method does not return a numpy array in future
         if isinstance(xtmp, np.ndarray):
             return xtmp
     return x

From 3d294d18f775f55e02791be70e6888999fd84f21 Mon Sep 17 00:00:00 2001
From: patel-zeel <patel_zeel@iitgn.ac.in>
Date: Sat, 20 Jan 2024 23:44:08 +0530
Subject: [PATCH 0649/1120] remove explicit exceptions from `_is_torch_array`
 and `_is_jax_array`

---
 lib/matplotlib/cbook.py | 13 ++-----------
 1 file changed, 2 insertions(+), 11 deletions(-)

diff --git a/lib/matplotlib/cbook.py b/lib/matplotlib/cbook.py
index e897b654b4f8..8501f116649f 100644
--- a/lib/matplotlib/cbook.py
+++ b/lib/matplotlib/cbook.py
@@ -19,7 +19,6 @@
 import time
 import traceback
 import types
-import warnings
 import weakref
 
 import numpy as np
@@ -2238,22 +2237,14 @@ def _picklable_class_constructor(mixin_class, fmt, attr_name, base_class):
 def _is_torch_array(x):
     try:
         return isinstance(x, sys.modules['torch'].Tensor)
-    except (KeyError, AttributeError, TypeError):
-        return False
-    except Exception as e:
-        warnings.warn(f"Error checking if {x} is a PyTorch Tensor: \n {e} \
-                      \n Please report this issue to the developers.")
+    except Exception as e:  # not using bare `except` to bypass flake8
         return False
 
 
 def _is_jax_array(x):
     try:
         return isinstance(x, sys.modules['jax'].Array)
-    except (KeyError, AttributeError, TypeError):
-        return False
-    except Exception as e:
-        warnings.warn(f"Error checking if {x} is a JAX Array: \n {e} \
-                      \n Please report this issue to the developers.")
+    except Exception as e:  # not using bare `except` to bypass flake8
         return False
 
 

From a72a1efc10ae4f9a3cb35f33639788a39856fe65 Mon Sep 17 00:00:00 2001
From: patel-zeel <patel_zeel@iitgn.ac.in>
Date: Sat, 20 Jan 2024 23:56:18 +0530
Subject: [PATCH 0650/1120] Add docstrings to `_is_torch_array` and
 `_is_jax_array`

---
 lib/matplotlib/cbook.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/lib/matplotlib/cbook.py b/lib/matplotlib/cbook.py
index 8501f116649f..033298ca9f98 100644
--- a/lib/matplotlib/cbook.py
+++ b/lib/matplotlib/cbook.py
@@ -2235,6 +2235,7 @@ def _picklable_class_constructor(mixin_class, fmt, attr_name, base_class):
 
 
 def _is_torch_array(x):
+    """Check if 'x' is a PyTorch Tensor."""
     try:
         return isinstance(x, sys.modules['torch'].Tensor)
     except Exception as e:  # not using bare `except` to bypass flake8
@@ -2242,6 +2243,7 @@ def _is_torch_array(x):
 
 
 def _is_jax_array(x):
+    """Check if 'x' is a JAX Array."""
     try:
         return isinstance(x, sys.modules['jax'].Array)
     except Exception as e:  # not using bare `except` to bypass flake8

From 66285a01823023784f90b71faf0b67eacbec58a2 Mon Sep 17 00:00:00 2001
From: ShivamPathak99 <98941325+ShivamPathak99@users.noreply.github.com>
Date: Sat, 20 Jan 2024 23:56:33 +0530
Subject: [PATCH 0651/1120] Update inset_axes.rst

---
 doc/users/next_whats_new/inset_axes.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/users/next_whats_new/inset_axes.rst b/doc/users/next_whats_new/inset_axes.rst
index 4b8b374c7fff..4509a94fa76a 100644
--- a/doc/users/next_whats_new/inset_axes.rst
+++ b/doc/users/next_whats_new/inset_axes.rst
@@ -1,4 +1,4 @@
-'Axes.inset_axes' is no longer experimental
+``Axes.inset_axes`` is no longer experimental
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Axes.inset_axes is cosidered stable for use.

From 5a2422c8de654d26d75453bbfb8ceaa8d5e7ada5 Mon Sep 17 00:00:00 2001
From: ShivamPathak99 <98941325+ShivamPathak99@users.noreply.github.com>
Date: Sun, 21 Jan 2024 00:25:33 +0530
Subject: [PATCH 0652/1120] Update inset_axes.rst

---
 doc/users/next_whats_new/inset_axes.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/doc/users/next_whats_new/inset_axes.rst b/doc/users/next_whats_new/inset_axes.rst
index 4509a94fa76a..b4fa7d0fe2b0 100644
--- a/doc/users/next_whats_new/inset_axes.rst
+++ b/doc/users/next_whats_new/inset_axes.rst
@@ -2,4 +2,3 @@
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Axes.inset_axes is cosidered stable for use.
-

From 13203f740ac5771d6ca97945af33ead6e3cb071b Mon Sep 17 00:00:00 2001
From: ShivamPathak99 <98941325+ShivamPathak99@users.noreply.github.com>
Date: Sun, 21 Jan 2024 00:44:55 +0530
Subject: [PATCH 0653/1120] Update inset_axes.rst

---
 doc/users/next_whats_new/inset_axes.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/users/next_whats_new/inset_axes.rst b/doc/users/next_whats_new/inset_axes.rst
index b4fa7d0fe2b0..4fd1f83276f8 100644
--- a/doc/users/next_whats_new/inset_axes.rst
+++ b/doc/users/next_whats_new/inset_axes.rst
@@ -1,4 +1,4 @@
 ``Axes.inset_axes`` is no longer experimental
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Axes.inset_axes is cosidered stable for use.

From 6d0759b84976feca63891cd839ce426ad50f50e9 Mon Sep 17 00:00:00 2001
From: ShivamPathak99 <98941325+ShivamPathak99@users.noreply.github.com>
Date: Sun, 21 Jan 2024 09:19:43 +0530
Subject: [PATCH 0654/1120] Update doc/users/next_whats_new/inset_axes.rst

Co-authored-by: Jody Klymak <jklymak@gmail.com>
---
 doc/users/next_whats_new/inset_axes.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/doc/users/next_whats_new/inset_axes.rst b/doc/users/next_whats_new/inset_axes.rst
index 4fd1f83276f8..7c1387586a2f 100644
--- a/doc/users/next_whats_new/inset_axes.rst
+++ b/doc/users/next_whats_new/inset_axes.rst
@@ -1,4 +1,5 @@
 ``Axes.inset_axes`` is no longer experimental
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Axes.inset_axes is cosidered stable for use.
+Axes.inset_axes is considered stable for use.
+

From 14786af101d9c13e661e8e8cb93819bf5702f3aa Mon Sep 17 00:00:00 2001
From: ShivamPathak99 <98941325+ShivamPathak99@users.noreply.github.com>
Date: Sun, 21 Jan 2024 09:21:15 +0530
Subject: [PATCH 0655/1120] Update inset_axes.rst

---
 doc/users/next_whats_new/inset_axes.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/doc/users/next_whats_new/inset_axes.rst b/doc/users/next_whats_new/inset_axes.rst
index 7c1387586a2f..d283dfc91b30 100644
--- a/doc/users/next_whats_new/inset_axes.rst
+++ b/doc/users/next_whats_new/inset_axes.rst
@@ -2,4 +2,3 @@
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Axes.inset_axes is considered stable for use.
-

From 95b7f6873abc72f331c0c12c1a0ae2ec2a806a04 Mon Sep 17 00:00:00 2001
From: ShivamPathak99 <98941325+ShivamPathak99@users.noreply.github.com>
Date: Sun, 21 Jan 2024 11:32:01 +0530
Subject: [PATCH 0656/1120] Update _axes.py

---
 lib/matplotlib/axes/_axes.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 2998047e1eda..ef7d3edfa0b9 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -332,7 +332,6 @@ def inset_axes(self, bounds, *, transform=None, zorder=5, **kwargs):
         Add a child inset Axes to this existing Axes.
 
 
-
         Parameters
         ----------
         bounds : [x0, y0, width, height]

From 95dbab0e4b8dba8d4d450094b0f005eca354c4f6 Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Sat, 20 Jan 2024 13:50:21 +0000
Subject: [PATCH 0657/1120] DOC: selecting individual colors from a colormap
 [ci doc]

---
 .flake8                                       |  1 +
 .../color/individual_colors_from_cmap.py      | 61 +++++++++++++++++++
 2 files changed, 62 insertions(+)
 create mode 100644 galleries/examples/color/individual_colors_from_cmap.py

diff --git a/.flake8 b/.flake8
index 40c07e0e324b..bfb5bb29b0e9 100644
--- a/.flake8
+++ b/.flake8
@@ -63,6 +63,7 @@ per-file-ignores =
     galleries/users_explain/text/text_props.py: E501
 
     galleries/examples/animation/frame_grabbing_sgskip.py: E402
+    galleries/examples/color/individual_colors_from_cmap.py: E402
     galleries/examples/images_contours_and_fields/tricontour_demo.py: E201
     galleries/examples/images_contours_and_fields/tripcolor_demo.py: E201
     galleries/examples/images_contours_and_fields/triplot_demo.py: E201
diff --git a/galleries/examples/color/individual_colors_from_cmap.py b/galleries/examples/color/individual_colors_from_cmap.py
new file mode 100644
index 000000000000..572fb33e6f11
--- /dev/null
+++ b/galleries/examples/color/individual_colors_from_cmap.py
@@ -0,0 +1,61 @@
+"""
+===========================================
+Selecting individual colors from a colormap
+===========================================
+
+Sometimes we want to use more colors or a different set of colors than the default color
+cycle provides. Selecting individual colors from one of the provided colormaps can be a
+convenient way to do this.
+
+Once we have hold of a `.Colormap` instance, the individual colors can be accessed
+by passing it an index.  If we want a specific number of colors taken at regular
+intervals from a continuous colormap, we can create a new colormap using the
+`~.Colormap.resampled` method.
+
+For more details about manipulating colormaps, see :ref:`colormap-manipulation`.
+"""
+
+import matplotlib.pyplot as plt
+
+import matplotlib as mpl
+
+n_lines = 21
+
+cmap = mpl.colormaps.get_cmap('plasma').resampled(n_lines)
+
+fig, ax = plt.subplots(layout='constrained')
+
+for i in range(n_lines):
+    ax.plot([0, i], color=cmap(i))
+
+plt.show()
+
+# %%
+# Instead of passing colors one by one to `~.Axes.plot`, we can replace the default
+# color cycle with a different set of colors.  Specifying a `~cycler.cycler` instance
+# within `.rcParams` achieves that.  See :ref:`color_cycle` for details.
+
+
+from cycler import cycler
+
+cmap = mpl.colormaps.get_cmap('Dark2')
+colors = cmap(range(cmap.N))  # cmap.N is number of unique colors in the colormap
+
+with mpl.rc_context({'axes.prop_cycle': cycler(color=colors)}):
+
+    fig, ax = plt.subplots(layout='constrained')
+
+    for i in range(n_lines):
+        ax.plot([0, i])
+
+plt.show()
+
+# %%
+#
+# .. admonition:: References
+#
+#    The use of the following functions, methods, classes and modules is shown
+#    in this example:
+#
+#    - `matplotlib.colors.Colormap`
+#    - `matplotlib.colors.Colormap.resampled`

From 87ee115d3989fea237b7ff4cefbdeeccef0cd66b Mon Sep 17 00:00:00 2001
From: patel-zeel <patel_zeel@iitgn.ac.in>
Date: Sun, 21 Jan 2024 15:56:30 +0530
Subject: [PATCH 0658/1120] document `_is_torch_array` and `_is_jax_array`. Add
 tests for them.

---
 lib/matplotlib/cbook.py            |  8 ++++--
 lib/matplotlib/tests/test_cbook.py | 44 ++++++++++++++++++++++++++++++
 2 files changed, 50 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/cbook.py b/lib/matplotlib/cbook.py
index 033298ca9f98..ffb394c27147 100644
--- a/lib/matplotlib/cbook.py
+++ b/lib/matplotlib/cbook.py
@@ -2237,16 +2237,20 @@ def _picklable_class_constructor(mixin_class, fmt, attr_name, base_class):
 def _is_torch_array(x):
     """Check if 'x' is a PyTorch Tensor."""
     try:
+        # we're intentionally not attempting to import torch. If somebody
+        # has created a torch array, torch should already be in sys.modules
         return isinstance(x, sys.modules['torch'].Tensor)
-    except Exception as e:  # not using bare `except` to bypass flake8
+    except Exception:
         return False
 
 
 def _is_jax_array(x):
     """Check if 'x' is a JAX Array."""
     try:
+        # we're intentionally not attempting to import jax. If somebody
+        # has created a jax array, jax should already be in sys.modules
         return isinstance(x, sys.modules['jax'].Array)
-    except Exception as e:  # not using bare `except` to bypass flake8
+    except Exception:
         return False
 
 
diff --git a/lib/matplotlib/tests/test_cbook.py b/lib/matplotlib/tests/test_cbook.py
index effe2338931f..322cacf2ea9b 100644
--- a/lib/matplotlib/tests/test_cbook.py
+++ b/lib/matplotlib/tests/test_cbook.py
@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import sys
 import itertools
 import pickle
 
@@ -16,6 +17,7 @@
 from matplotlib import _api, cbook
 import matplotlib.colors as mcolors
 from matplotlib.cbook import delete_masked_points
+from types import ModuleType
 
 
 class Test_delete_masked_points:
@@ -925,3 +927,45 @@ def test_auto_format_str(fmt, value, result):
     """Apply *value* to the format string *fmt*."""
     assert cbook._auto_format_str(fmt, value) == result
     assert cbook._auto_format_str(fmt, np.float64(value)) == result
+
+
+def test_unpack_to_numpy_from_torch():
+    """Test that torch tensors are converted to numpy arrays.
+    We don't want to create a dependency on torch in the test suite, so we mock it.
+    """
+    class Tensor:
+        def __init__(self, data):
+            self.data = data
+        def __array__(self):
+            return self.data
+    torch = ModuleType('torch')
+    torch.Tensor = Tensor
+    sys.modules['torch'] = torch
+
+    data = np.arange(10)
+    torch_tensor = torch.Tensor(data)
+
+    result = cbook._unpack_to_numpy(torch_tensor)
+    assert isinstance(result, np.ndarray)
+
+
+def test_unpack_to_numpy_from_jax():
+    """Test that jax arrays are converted to numpy arrays.
+    We don't want to create a dependency on jax in the test suite, so we mock it.
+    """
+    class Array:
+        def __init__(self, data):
+            self.data = data
+        def __array__(self):
+            return self.data
+
+    jax = ModuleType('jax')
+    jax.Array = Array
+
+    sys.modules['jax'] = jax
+
+    data = np.arange(10)
+    jax_array = jax.Array(data)
+
+    result = cbook._unpack_to_numpy(jax_array)
+    assert isinstance(result, np.ndarray)

From 21cd9ce70261dac0b981ee879a69fa600755cd0b Mon Sep 17 00:00:00 2001
From: patel-zeel <patel_zeel@iitgn.ac.in>
Date: Sun, 21 Jan 2024 16:06:51 +0530
Subject: [PATCH 0659/1120] remove unrelated changes (_version.py)

---
 lib/matplotlib/_version.py | 4 ----
 1 file changed, 4 deletions(-)
 delete mode 100644 lib/matplotlib/_version.py

diff --git a/lib/matplotlib/_version.py b/lib/matplotlib/_version.py
deleted file mode 100644
index 3f86119d7b7c..000000000000
--- a/lib/matplotlib/_version.py
+++ /dev/null
@@ -1,4 +0,0 @@
-# file generated by setuptools_scm
-# don't change, don't track in version control
-__version__ = version = '0.1.0.dev47143+gd027cda.d20230514'
-__version_tuple__ = version_tuple = (0, 1, 0, 'dev47143', 'gd027cda.d20230514')

From 87d05aea59a339b54477cf405dadb5a7bb9a8c08 Mon Sep 17 00:00:00 2001
From: Alan Lau <alanw.lau@mail.utoronto.ca>
Date: Thu, 7 Dec 2023 22:08:16 -0500
Subject: [PATCH 0660/1120] Fix legend auto-placement in the presence of text
 or PolyCollections

Co-authored-by: alextanned <74106760+alextanned@users.noreply.github.com>
---
 .../next_api_changes/behavior/27469-AL.rst    |  11 ++++++
 lib/matplotlib/legend.py                      |   5 +++
 .../test_legend/legend_stackplot.png          | Bin 28389 -> 29512 bytes
 lib/matplotlib/tests/test_legend.py           |  36 ++++++++++++++++++
 4 files changed, 52 insertions(+)
 create mode 100644 doc/api/next_api_changes/behavior/27469-AL.rst

diff --git a/doc/api/next_api_changes/behavior/27469-AL.rst b/doc/api/next_api_changes/behavior/27469-AL.rst
new file mode 100644
index 000000000000..c47397e873b7
--- /dev/null
+++ b/doc/api/next_api_changes/behavior/27469-AL.rst
@@ -0,0 +1,11 @@
+``loc='best'`` for ``legend`` now considers ``Text`` and ``PolyCollections``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The location selection ``legend`` now considers the existence of ``Text``
+and ``PolyCollections`` in the ``badness`` calculation.
+
+Note: The ``best`` option can already be quite slow for plots with large
+amounts of data. For ``PolyCollections``, it only considers the ``Path``
+of ``PolyCollections`` and not the enclosed area when checking for overlap
+to reduce additional latency. However, it can still be quite slow when
+there are large amounts of ``PolyCollections`` in the plot to check for.
diff --git a/lib/matplotlib/legend.py b/lib/matplotlib/legend.py
index 3e3ed5d7a7f7..111e08e00869 100644
--- a/lib/matplotlib/legend.py
+++ b/lib/matplotlib/legend.py
@@ -978,10 +978,15 @@ def _auto_legend_data(self):
             elif isinstance(artist, Patch):
                 lines.append(
                     artist.get_transform().transform_path(artist.get_path()))
+            elif isinstance(artist, PolyCollection):
+                lines.extend(artist.get_transform().transform_path(path)
+                             for path in artist.get_paths())
             elif isinstance(artist, Collection):
                 transform, transOffset, hoffsets, _ = artist._prepare_points()
                 if len(hoffsets):
                     offsets.extend(transOffset.transform(hoffsets))
+            elif isinstance(artist, Text):
+                bboxes.append(artist.get_window_extent())
 
         return bboxes, lines, offsets
 
diff --git a/lib/matplotlib/tests/baseline_images/test_legend/legend_stackplot.png b/lib/matplotlib/tests/baseline_images/test_legend/legend_stackplot.png
index 850dcc83cd40e21318da0a92f27f4313577a02dd..6467533558384824ba42ab1e6d20efc2a58bdfeb 100644
GIT binary patch
literal 29512
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
XIkz&xBu`^<rI3v!!{WM`NBDmM%Zp1)

literal 28389
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

diff --git a/lib/matplotlib/tests/test_legend.py b/lib/matplotlib/tests/test_legend.py
index 8532c0d68314..1cc8f535f57e 100644
--- a/lib/matplotlib/tests/test_legend.py
+++ b/lib/matplotlib/tests/test_legend.py
@@ -1391,3 +1391,39 @@ def test_legend_nolabels_draw():
     plt.plot([1, 2, 3])
     plt.legend()
     assert plt.gca().get_legend() is not None
+
+
+def test_legend_loc_polycollection():
+    # Test that the legend is placed in the correct
+    # position for 'best' for polycollection
+    x = [3, 4, 5]
+    y1 = [1, 1, 1]
+    y2 = [5, 5, 5]
+    leg_bboxes = []
+    fig, axs = plt.subplots(ncols=2, figsize=(10, 5))
+    for ax, loc in zip(axs.flat, ('best', 'lower left')):
+        ax.fill_between(x, y1, y2, color='gray', alpha=0.5, label='Shaded Area')
+        ax.set_xlim(0, 6)
+        ax.set_ylim(-1, 5)
+        leg = ax.legend(loc=loc)
+        fig.canvas.draw()
+        leg_bboxes.append(
+            leg.get_window_extent().transformed(ax.transAxes.inverted()))
+    assert_allclose(leg_bboxes[1].bounds, leg_bboxes[0].bounds)
+
+
+def test_legend_text():
+    # Test that legend is place in the correct
+    # position for 'best' when there is text in figure
+    fig, axs = plt.subplots(ncols=2, figsize=(10, 5))
+    leg_bboxes = []
+    for ax, loc in zip(axs.flat, ('best', 'lower left')):
+        x = [1, 2]
+        y = [2, 1]
+        ax.plot(x, y, label='plot name')
+        ax.text(1.5, 2, 'some text blahblah', verticalalignment='top')
+        leg = ax.legend(loc=loc)
+        fig.canvas.draw()
+        leg_bboxes.append(
+            leg.get_window_extent().transformed(ax.transAxes.inverted()))
+    assert_allclose(leg_bboxes[1].bounds, leg_bboxes[0].bounds)

From f390b4fb51990d6eaacb50619b6f960171153407 Mon Sep 17 00:00:00 2001
From: Christoph Hasse <hassec@users.noreply.github.com>
Date: Sun, 21 Jan 2024 19:59:17 -0500
Subject: [PATCH 0661/1120] doc: fix Patch.contains_point docstring example

---
 lib/matplotlib/patches.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
index ef52a00b059b..3ae087ae0613 100644
--- a/lib/matplotlib/patches.py
+++ b/lib/matplotlib/patches.py
@@ -190,10 +190,10 @@ def contains_point(self, point, radius=None):
         transform them first:
 
         >>> center = 0, 0
-        >>> c = Circle(center, radius=1)
+        >>> c = Circle(center, radius=3)
         >>> plt.gca().add_patch(c)
-        >>> transformed_center = c.get_transform().transform(center)
-        >>> c.contains_point(transformed_center)
+        >>> transformed_interior_point = c.get_data_transform().transform((0, 2))
+        >>> c.contains_point(transformed_interior_point)
         True
 
         """

From cfe8edb5d0c22adce5aabd24d5f4671179394cc4 Mon Sep 17 00:00:00 2001
From: patel-zeel <patel_zeel@iitgn.ac.in>
Date: Mon, 22 Jan 2024 10:50:35 +0530
Subject: [PATCH 0662/1120] update asserts for `test_unpack_to_numpy_from_jax`
 and `test_unpack_to_numpy_from_torch`

---
 lib/matplotlib/tests/test_cbook.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/tests/test_cbook.py b/lib/matplotlib/tests/test_cbook.py
index c42245e4c5e3..24fd02e65a5f 100644
--- a/lib/matplotlib/tests/test_cbook.py
+++ b/lib/matplotlib/tests/test_cbook.py
@@ -959,7 +959,7 @@ def __array__(self):
     torch_tensor = torch.Tensor(data)
 
     result = cbook._unpack_to_numpy(torch_tensor)
-    assert isinstance(result, np.ndarray)
+    assert result is torch_tensor.__array__()
 
 
 def test_unpack_to_numpy_from_jax():
@@ -981,4 +981,4 @@ def __array__(self):
     jax_array = jax.Array(data)
 
     result = cbook._unpack_to_numpy(jax_array)
-    assert isinstance(result, np.ndarray)
+    assert result is jax_array.__array__()

From 91ed132664532f6bc2196d921235ef1c0cacf1ec Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 22 Jan 2024 19:40:26 +0000
Subject: [PATCH 0663/1120] Bump the actions group with 1 update

Bumps the actions group with 1 update: [actions/cache](https://github.com/actions/cache).


Updates `actions/cache` from 3 to 4
- [Release notes](https://github.com/actions/cache/releases)
- [Changelog](https://github.com/actions/cache/blob/main/RELEASES.md)
- [Commits](https://github.com/actions/cache/compare/v3...v4)

---
updated-dependencies:
- dependency-name: actions/cache
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: actions
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 .github/workflows/cygwin.yml | 6 +++---
 .github/workflows/tests.yml  | 8 ++++----
 2 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/.github/workflows/cygwin.yml b/.github/workflows/cygwin.yml
index 24253c5092e9..4adb29dde46d 100644
--- a/.github/workflows/cygwin.yml
+++ b/.github/workflows/cygwin.yml
@@ -139,7 +139,7 @@ jobs:
         # FreeType build fails with bash, succeeds with dash
 
       - name: Cache pip
-        uses: actions/cache@v3
+        uses: actions/cache@v4
         with:
           path: C:\cygwin\home\runneradmin\.cache\pip
           key: Cygwin-py3.${{ matrix.python-minor-version }}-pip-${{ hashFiles('requirements/*/*.txt') }}
@@ -147,14 +147,14 @@ jobs:
             ${{ matrix.os }}-py3.${{ matrix.python-minor-version }}-pip-
 
       - name: Cache ccache
-        uses: actions/cache@v3
+        uses: actions/cache@v4
         with:
           path: C:\cygwin\home\runneradmin\.ccache
           key: Cygwin-py3.${{ matrix.python-minor-version }}-ccache-${{ hashFiles('src/*') }}
           restore-keys: Cygwin-py3.${{ matrix.python-minor-version }}-ccache-
 
       - name: Cache Matplotlib
-        uses: actions/cache@v3
+        uses: actions/cache@v4
         with:
           path: |
             C:\cygwin\home\runneradmin\.cache\matplotlib
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 3abb1ae7e68b..695464e8d5cf 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -162,7 +162,7 @@ jobs:
           esac
 
       - name: Cache pip
-        uses: actions/cache@v3
+        uses: actions/cache@v4
         if: startsWith(runner.os, 'Linux')
         with:
           path: ~/.cache/pip
@@ -170,7 +170,7 @@ jobs:
           restore-keys: |
             ${{ matrix.os }}-py${{ matrix.python-version }}-pip-
       - name: Cache pip
-        uses: actions/cache@v3
+        uses: actions/cache@v4
         if: startsWith(runner.os, 'macOS')
         with:
           path: ~/Library/Caches/pip
@@ -178,7 +178,7 @@ jobs:
           restore-keys: |
             ${{ matrix.os }}-py${{ matrix.python-version }}-pip-
       - name: Cache ccache
-        uses: actions/cache@v3
+        uses: actions/cache@v4
         with:
           path: |
             ~/.ccache
@@ -186,7 +186,7 @@ jobs:
           restore-keys: |
             ${{ matrix.os }}-py${{ matrix.python-version }}-ccache-
       - name: Cache Matplotlib
-        uses: actions/cache@v3
+        uses: actions/cache@v4
         with:
           path: |
             ~/.cache/matplotlib

From f2124dd88fd6782ce0b8bc9d5fd4fc788e539605 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Mon, 22 Jan 2024 14:32:56 -0600
Subject: [PATCH 0664/1120] Work around pyparsing diagnostic warnings

Closes #25204
---
 lib/matplotlib/_fontconfig_pattern.py |  4 ++--
 lib/matplotlib/_mathtext.py           | 12 ++++++++++--
 2 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/lib/matplotlib/_fontconfig_pattern.py b/lib/matplotlib/_fontconfig_pattern.py
index 6802c6ae24d7..a1341c633243 100644
--- a/lib/matplotlib/_fontconfig_pattern.py
+++ b/lib/matplotlib/_fontconfig_pattern.py
@@ -13,7 +13,7 @@
 import re
 
 from pyparsing import (
-    Optional, ParseException, Regex, StringEnd, Suppress, ZeroOrMore, oneOf)
+    Group, Optional, ParseException, Regex, StringEnd, Suppress, ZeroOrMore, oneOf)
 
 
 _family_punc = r'\\\-:,'
@@ -61,7 +61,7 @@ def comma_separated(elem):
     size = Regex(r"([0-9]+\.?[0-9]*|\.[0-9]+)")
     name = Regex(r"[a-z]+")
     value = Regex(fr"([^{_value_punc}]|(\\[{_value_punc}]))*")
-    prop = (name + Suppress("=") + comma_separated(value)) | oneOf(_CONSTANTS)
+    prop = Group((name + Suppress("=") + comma_separated(value)) | oneOf(_CONSTANTS))
     return (
         Optional(comma_separated(family)("families"))
         + Optional("-" + comma_separated(size)("sizes"))
diff --git a/lib/matplotlib/_mathtext.py b/lib/matplotlib/_mathtext.py
index 86091f79d5bb..6e4df209b1f9 100644
--- a/lib/matplotlib/_mathtext.py
+++ b/lib/matplotlib/_mathtext.py
@@ -2030,10 +2030,18 @@ def csnames(group: str, names: Iterable[str]) -> Regex:
         # elements is important for speed.)
         p.auto_delim       = Forward()
         p.placeable        = Forward()
+        p.named_placeable  = Forward()
         p.required_group   = Forward()
         p.optional_group   = Forward()
         p.token            = Forward()
 
+        # Workaround for placable being part of a cycle of definitions
+        # calling `p.placeable("name")` results in a copy, so not guaranteed
+        # to get the definition added after it is used.
+        # ref https://github.com/matplotlib/matplotlib/issues/25204
+        # xref https://github.com/pyparsing/pyparsing/issues/95
+        p.named_placeable <<= p.placeable
+
         set_names_and_parse_actions()  # for mutually recursive definitions.
 
         p.optional_group <<= "{" + ZeroOrMore(p.token)("group") + "}"
@@ -2043,7 +2051,7 @@ def csnames(group: str, names: Iterable[str]) -> Regex:
 
         p.accent = (
             csnames("accent", [*self._accent_map, *self._wide_accents])
-            - p.placeable("sym"))
+            - p.named_placeable("sym"))
 
         p.function = csnames("name", self._function_names)
 
@@ -2089,7 +2097,7 @@ def csnames(group: str, names: Iterable[str]) -> Regex:
              + OneOrMore(oneOf(["_", "^"]) - p.placeable)("subsuper")
              + Regex("'*")("apostrophes"))
             | Regex("'+")("apostrophes")
-            | (p.placeable("nucleus") + Regex("'*")("apostrophes"))
+            | (p.named_placeable("nucleus") + Regex("'*")("apostrophes"))
         )
 
         p.simple = p.space | p.customspace | p.font | p.subsuper

From 291c97796baf6239a996b1563af930bf9e1d17e3 Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Mon, 22 Jan 2024 21:21:16 +0000
Subject: [PATCH 0665/1120] Remove extra index error checks

---
 lib/matplotlib/image.py | 10 ++--------
 1 file changed, 2 insertions(+), 8 deletions(-)

diff --git a/lib/matplotlib/image.py b/lib/matplotlib/image.py
index 222896943d77..e3269062699c 100644
--- a/lib/matplotlib/image.py
+++ b/lib/matplotlib/image.py
@@ -1197,10 +1197,7 @@ def get_cursor_data(self, event):
             return None
         j = np.searchsorted(self._Ax, x) - 1
         i = np.searchsorted(self._Ay, y) - 1
-        try:
-            return self._A[i, j]
-        except IndexError:
-            return None
+        return self._A[i, j]
 
 
 class PcolorImage(AxesImage):
@@ -1334,10 +1331,7 @@ def get_cursor_data(self, event):
             return None
         j = np.searchsorted(self._Ax, x) - 1
         i = np.searchsorted(self._Ay, y) - 1
-        try:
-            return self._A[i, j]
-        except IndexError:
-            return None
+        return self._A[i, j]
 
 
 class FigureImage(_ImageBase):

From 27b55e00b1d232a754fc2b8cf5f68c17509f7fcb Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Tue, 23 Jan 2024 02:06:41 -0500
Subject: [PATCH 0666/1120] ci: Don't include API/what's new notes in general
 doc labels

---
 .github/labeler.yml | 23 +++++++++++++++--------
 1 file changed, 15 insertions(+), 8 deletions(-)

diff --git a/.github/labeler.yml b/.github/labeler.yml
index 8d899258a3e7..743e640652f7 100644
--- a/.github/labeler.yml
+++ b/.github/labeler.yml
@@ -75,10 +75,14 @@
           - 'lib/matplotlib/backends/backend_wx*.py*'
 
 "Documentation: API":
-  - changed-files:
-      - any-glob-to-any-file:
-          # Also files in lib/**, but we can't be sure those are only documentation.
-          - 'doc/api/**'
+  - all:
+    - changed-files:
+        - any-glob-to-any-file:
+            # Also files in lib/**, but we can't be sure those are only documentation.
+            - 'doc/api/**'
+        - all-globs-all-files:
+            - '!doc/api/next_api_changes/**'
+
 "Documentation: build":
   - changed-files:
       - any-glob-to-any-file:
@@ -102,10 +106,13 @@
       - any-glob-to-any-file:
           - 'galleries/tutorials/**'
 "Documentation: user guide":
-  - changed-files:
-      - any-glob-to-any-file:
-          - 'doc/users/**'
-          - 'galleries/users_explain/**'
+  - all:
+    - changed-files:
+        - any-glob-to-any-file:
+            - 'doc/users/**'
+            - 'galleries/users_explain/**'
+        - all-globs-to-all-files:
+            - '!doc/users/next_whats_new/**'
 
 "topic: animation":
   - changed-files:

From 892ad6d8d25959a8b52e307b26553c41e95cb102 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Tue, 23 Jan 2024 04:44:51 -0500
Subject: [PATCH 0667/1120] CI: skip code coverage upload on scheduled tests
 (#27688)

* CI: install pytest pre-release on one py3.12 run

This is to keep coverage in the test suite up

* CI: solve actual problem and skip upload on pre-release jobs
---
 .github/workflows/tests.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 3abb1ae7e68b..5ea0bd12bdc3 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -336,6 +336,7 @@ jobs:
               -instr-profile default.profdata > info.lcov
           fi
       - name: Upload code coverage
+        if: ${{ github.event_name != 'schedule' }}
         uses: codecov/codecov-action@v3
         with:
           name: "${{ matrix.python-version }} ${{ matrix.os }} ${{ matrix.name-suffix }}"

From 825283097f757940c5a084de4af94661f26ed7a8 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Tue, 23 Jan 2024 22:43:56 +0100
Subject: [PATCH 0668/1120] Remove "Past versions" section from release notes

This came in via #21251 and I vaguely remember it had
a purpose (possibly something with navigation / what
is rendered in the sidebars?) However, in the
current docs, it looks rather useless.
https://matplotlib.org/devdocs/users/release_notes.html
---
 doc/users/release_notes.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/doc/users/release_notes.rst b/doc/users/release_notes.rst
index ca09d218cae4..32bd02432068 100644
--- a/doc/users/release_notes.rst
+++ b/doc/users/release_notes.rst
@@ -75,10 +75,6 @@ Version 3.4
     prev_whats_new/github_stats_3.4.1.rst
     prev_whats_new/github_stats_3.4.0.rst
 
-=============
-Past versions
-=============
-
 Version 3.3
 ^^^^^^^^^^^
 .. toctree::

From b40a67c34bcd3a13939f1463dfc9300a35114f6d Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Thu, 28 Sep 2023 16:14:04 -0400
Subject: [PATCH 0669/1120] test that table uses repr and doesn't try to
 convert unitized data

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>

Co-authored-by: Ruth Comer <10599679+rcomer@users.noreply.github.com>
---
 lib/matplotlib/tests/test_table.py | 35 ++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/lib/matplotlib/tests/test_table.py b/lib/matplotlib/tests/test_table.py
index 328fd020c1ee..ea31ac124e4a 100644
--- a/lib/matplotlib/tests/test_table.py
+++ b/lib/matplotlib/tests/test_table.py
@@ -1,3 +1,6 @@
+import datetime
+from unittest.mock import Mock
+
 import numpy as np
 import pytest
 
@@ -7,6 +10,7 @@
 from matplotlib.table import CustomCell, Table
 from matplotlib.testing.decorators import image_comparison, check_figures_equal
 from matplotlib.transforms import Bbox
+import matplotlib.units as munits
 
 
 def test_non_square():
@@ -229,3 +233,34 @@ def test_table_bbox(fig_test, fig_ref):
                   loc='center',
                   bbox=Bbox.from_extents(0.1, 0.2, 0.9, 0.8)
                   )
+
+
+@check_figures_equal(extensions=['png'])
+def test_table_unit(fig_test, fig_ref):
+    # test that table doesn't participate in unit machinery, instead uses repr/str
+
+    class FakeUnit:
+        def __init__(self, thing):
+            pass
+        def __repr__(self):
+            return "Hello"
+
+    fake_convertor = munits.ConversionInterface()
+    # v, u, a = value, unit, axis
+    fake_convertor.convert = Mock(side_effect=lambda v, u, a: 0)
+    # not used, here for completeness
+    fake_convertor.default_units = Mock(side_effect=lambda v, a: None)
+    fake_convertor.axisinfo = Mock(side_effect=lambda u, a: munits.AxisInfo())
+
+    munits.registry[FakeUnit] = fake_convertor
+
+    data = [[FakeUnit("yellow"), FakeUnit(42)],
+            [FakeUnit(datetime.datetime(1968, 8, 1)), FakeUnit(True)]]
+
+    fig_test.subplots().table(data)
+    fig_ref.subplots().table([["Hello", "Hello"], ["Hello", "Hello"]])
+    fig_test.canvas.draw()
+    fake_convertor.convert.assert_not_called()
+
+    munits.registry.pop(FakeUnit)
+    assert not munits.registry.get_converter(FakeUnit)

From 8f949beb94fb84ef7b749a23feba402889c82bc7 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Wed, 24 Jan 2024 14:52:36 -0500
Subject: [PATCH 0670/1120] fix labeller [skip ci]

---
 .github/labeler.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/labeler.yml b/.github/labeler.yml
index 743e640652f7..4b6b6c607830 100644
--- a/.github/labeler.yml
+++ b/.github/labeler.yml
@@ -80,7 +80,7 @@
         - any-glob-to-any-file:
             # Also files in lib/**, but we can't be sure those are only documentation.
             - 'doc/api/**'
-        - all-globs-all-files:
+        - all-globs-to-all-files:
             - '!doc/api/next_api_changes/**'
 
 "Documentation: build":

From 9acfb5b85564144155cd41346f2affd88fcde37a Mon Sep 17 00:00:00 2001
From: patel-zeel <patel_zeel@iitgn.ac.in>
Date: Thu, 25 Jan 2024 10:49:44 +0530
Subject: [PATCH 0671/1120] improve note around `except Exception` for future
 devs

---
 lib/matplotlib/cbook.py | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/cbook.py b/lib/matplotlib/cbook.py
index 4eb4b0d6c046..9d03752c666c 100644
--- a/lib/matplotlib/cbook.py
+++ b/lib/matplotlib/cbook.py
@@ -2350,7 +2350,9 @@ def _is_torch_array(x):
         # we're intentionally not attempting to import torch. If somebody
         # has created a torch array, torch should already be in sys.modules
         return isinstance(x, sys.modules['torch'].Tensor)
-    except Exception:
+    except Exception:  # TypeError, KeyError, AttributeError, maybe others?
+        # we're attempting to access attributes on imported modules which
+        # may have arbitrary user code, so we deliberately catch all exceptions
         return False
 
 
@@ -2360,7 +2362,9 @@ def _is_jax_array(x):
         # we're intentionally not attempting to import jax. If somebody
         # has created a jax array, jax should already be in sys.modules
         return isinstance(x, sys.modules['jax'].Array)
-    except Exception:
+    except Exception:  # TypeError, KeyError, AttributeError, maybe others?
+        # we're attempting to access attributes on imported modules which
+        # may have arbitrary user code, so we deliberately catch all exceptions
         return False
 
 

From 762a15aefca61bad7704c0e622907d232b281782 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 26 Jan 2024 04:24:00 -0500
Subject: [PATCH 0672/1120] ci: Remove prerelease conditions from Azure
 Pipelines

The prerelease build was dropped about 3 years ago in
6dde94539f1cf997fa2f503e02f8bf71ffe032e2.
---
 azure-pipelines.yml | 18 ++++--------------
 1 file changed, 4 insertions(+), 14 deletions(-)

diff --git a/azure-pipelines.yml b/azure-pipelines.yml
index 8cf1002b4aae..3dc66ba0274a 100644
--- a/azure-pipelines.yml
+++ b/azure-pipelines.yml
@@ -78,13 +78,6 @@ stages:
           versionSpec: '$(python.version)'
           architecture: 'x64'
         displayName: 'Use Python $(python.version)'
-        condition: and(succeeded(), ne(variables['python.version'], 'Pre'))
-
-      - task: stevedower.python.InstallPython.InstallPython@1
-        displayName: 'Use prerelease Python'
-        inputs:
-          prerelease: true
-        condition: and(succeeded(), eq(variables['python.version'], 'Pre'))
 
       - bash: |
           set -e
@@ -136,8 +129,7 @@ stages:
       - bash: |
           python -m pip install --upgrade pip
           python -m pip install --upgrade meson-python pybind11
-          python -m pip install -r requirements/testing/all.txt -r requirements/testing/extra.txt ||
-            [[ "$PYTHON_VERSION" = 'Pre' ]]
+          python -m pip install -r requirements/testing/all.txt -r requirements/testing/extra.txt
         displayName: 'Install dependencies with pip'
 
       - bash: |
@@ -161,8 +153,7 @@ stages:
 
           python -m pip install \
             --no-build-isolation $CONFIG \
-            --verbose --editable .[dev] ||
-            [[ "$PYTHON_VERSION" = 'Pre' ]]
+            --verbose --editable .[dev]
         displayName: "Install self"
 
       - script: env
@@ -227,8 +218,7 @@ stages:
           fi
           PYTHONFAULTHANDLER=1 pytest -raR -n 2 \
               --maxfail=50 --timeout=300 --durations=25 \
-              --junitxml=junit/test-results.xml --cov-report=xml --cov=lib ||
-            [[ "$PYTHON_VERSION" = 'Pre' ]]
+              --junitxml=junit/test-results.xml --cov-report=xml --cov=lib
           if [[ -n $SESSION_ID ]]; then
             if [[ $VS_VER == 2022 ]]; then
               "$TOOL" shutdown $SESSION_ID
@@ -285,4 +275,4 @@ stages:
 
       - publish: $(System.DefaultWorkingDirectory)/result_images
         artifact: $(Agent.JobName)-result_images
-        condition: and(failed(), ne(variables['python.version'], 'Pre'))
+        condition: failed()

From d1e23ee02b27543699efa6850001d9b30d723e6e Mon Sep 17 00:00:00 2001
From: Shriya Kalakata <shriyakalakata123@gmail.com>
Date: Fri, 22 Dec 2023 16:42:04 -0500
Subject: [PATCH 0673/1120] Moved /users/project to /doc/project

---
 doc/{users => }/project/citing.rst          | 1 +
 doc/{users => }/project/code_of_conduct.rst | 1 +
 doc/{users => }/project/credits.rst         | 1 +
 doc/{users => }/project/history.rst         | 1 +
 doc/{users => }/project/index.rst           | 1 +
 doc/{users => }/project/license.rst         | 1 +
 doc/{users => }/project/mission.rst         | 1 +
 7 files changed, 7 insertions(+)
 rename doc/{users => }/project/citing.rst (99%)
 rename doc/{users => }/project/code_of_conduct.rst (99%)
 rename doc/{users => }/project/credits.rst (99%)
 rename doc/{users => }/project/history.rst (99%)
 rename doc/{users => }/project/index.rst (85%)
 rename doc/{users => }/project/license.rst (98%)
 rename doc/{users => }/project/mission.rst (95%)

diff --git a/doc/users/project/citing.rst b/doc/project/citing.rst
similarity index 99%
rename from doc/users/project/citing.rst
rename to doc/project/citing.rst
index d6b924afec2f..d2f2614b1497 100644
--- a/doc/users/project/citing.rst
+++ b/doc/project/citing.rst
@@ -1,4 +1,5 @@
 .. redirect-from:: /citing
+.. redirect-from:: /users/project/citing
 
 Citing Matplotlib
 =================
diff --git a/doc/users/project/code_of_conduct.rst b/doc/project/code_of_conduct.rst
similarity index 99%
rename from doc/users/project/code_of_conduct.rst
rename to doc/project/code_of_conduct.rst
index ac8b268a4e30..56fee2f25f6f 100644
--- a/doc/users/project/code_of_conduct.rst
+++ b/doc/project/code_of_conduct.rst
@@ -1,4 +1,5 @@
 .. _code_of_conduct:
+.. redirect-from:: /users/project/code_of_conduct
 
 ====================================
 Contributor Covenant Code of Conduct
diff --git a/doc/users/project/credits.rst b/doc/project/credits.rst
similarity index 99%
rename from doc/users/project/credits.rst
rename to doc/project/credits.rst
index c23d6ac11298..667f302b9155 100644
--- a/doc/users/project/credits.rst
+++ b/doc/project/credits.rst
@@ -1,6 +1,7 @@
 .. Note: This file is auto-generated using generate_credits.py
 
 .. redirect-from:: /users/credits
+.. redirect-from:: /users/project/credits
 
 .. _credits:
 
diff --git a/doc/users/project/history.rst b/doc/project/history.rst
similarity index 99%
rename from doc/users/project/history.rst
rename to doc/project/history.rst
index 18a94793736f..966b7a3caa38 100644
--- a/doc/users/project/history.rst
+++ b/doc/project/history.rst
@@ -1,4 +1,5 @@
 .. redirect-from:: /users/history
+.. redirect-from:: /users/project/history
 
 .. _project_history:
 
diff --git a/doc/users/project/index.rst b/doc/project/index.rst
similarity index 85%
rename from doc/users/project/index.rst
rename to doc/project/index.rst
index ad55576190ab..c7e230339dc9 100644
--- a/doc/users/project/index.rst
+++ b/doc/project/index.rst
@@ -1,4 +1,5 @@
 .. redirect-from:: /users/backmatter
+.. redirect-from:: /users/project/index
 
 Project information
 ===================
diff --git a/doc/users/project/license.rst b/doc/project/license.rst
similarity index 98%
rename from doc/users/project/license.rst
rename to doc/project/license.rst
index 3f9c1e30531b..2a5bb0af291f 100644
--- a/doc/users/project/license.rst
+++ b/doc/project/license.rst
@@ -1,6 +1,7 @@
 .. _license:
 
 .. redirect-from:: /users/license
+.. redirect-from:: /users/project/license
 
 *******
 License
diff --git a/doc/users/project/mission.rst b/doc/project/mission.rst
similarity index 95%
rename from doc/users/project/mission.rst
rename to doc/project/mission.rst
index 438d2fce8b1d..1b7a68afcc67 100644
--- a/doc/users/project/mission.rst
+++ b/doc/project/mission.rst
@@ -1,4 +1,5 @@
 .. _mission-statement:
+.. redirect-from:: /users/project/mission
 
 Mission Statement
 =================

From b1e81eb174b340723ca60b294db66872cc39c380 Mon Sep 17 00:00:00 2001
From: Shriya Kalakata <shriyakalakata123@gmail.com>
Date: Thu, 28 Dec 2023 08:22:10 +0530
Subject: [PATCH 0674/1120] Updated license paths

---
 doc/project/license.rst | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/doc/project/license.rst b/doc/project/license.rst
index 2a5bb0af291f..1005b5467b5a 100644
--- a/doc/project/license.rst
+++ b/doc/project/license.rst
@@ -51,7 +51,7 @@ License agreement
    :open:
    :class-container: sdd
 
-   .. literalinclude:: ../../../LICENSE/LICENSE
+   .. literalinclude:: ../../LICENSE/LICENSE
       :language: none
 
 
@@ -62,13 +62,13 @@ Bundled software
 .. dropdown:: JSX Tools Resize Observer
    :class-container: sdd
 
-   .. literalinclude:: ../../../LICENSE/LICENSE_JSXTOOLS_RESIZE_OBSERVER
+   .. literalinclude:: ../../LICENSE/LICENSE_JSXTOOLS_RESIZE_OBSERVER
       :language: none
 
 .. dropdown:: QT4 Editor
    :class-container: sdd
 
-   .. literalinclude:: ../../../LICENSE/LICENSE_QT4_EDITOR
+   .. literalinclude:: ../../LICENSE/LICENSE_QT4_EDITOR
       :language: none
 
 
@@ -80,19 +80,19 @@ Colormaps and themes
 .. dropdown:: ColorBrewer
    :class-container: sdd
 
-   .. literalinclude:: ../../../LICENSE/LICENSE_COLORBREWER
+   .. literalinclude:: ../../LICENSE/LICENSE_COLORBREWER
       :language: none
 
 .. dropdown:: Solarized
    :class-container: sdd
 
-   .. literalinclude:: ../../../LICENSE/LICENSE_SOLARIZED
+   .. literalinclude:: ../../LICENSE/LICENSE_SOLARIZED
       :language: none
 
 .. dropdown:: Yorick
    :class-container: sdd
 
-   .. literalinclude:: ../../../LICENSE/LICENSE_YORICK
+   .. literalinclude:: ../../LICENSE/LICENSE_YORICK
       :language: none
 
 
@@ -104,29 +104,29 @@ Fonts
 .. dropdown:: American Mathematical Society (AMS) fonts
    :class-container: sdd
 
-   .. literalinclude:: ../../../LICENSE/LICENSE_AMSFONTS
+   .. literalinclude:: ../../LICENSE/LICENSE_AMSFONTS
       :language: none
 
 .. dropdown:: BaKoMa
    :class-container: sdd
 
-   .. literalinclude:: ../../../LICENSE/LICENSE_BAKOMA
+   .. literalinclude:: ../../LICENSE/LICENSE_BAKOMA
       :language: none
 
 .. dropdown:: Carlogo
    :class-container: sdd
 
-   .. literalinclude:: ../../../LICENSE/LICENSE_CARLOGO
+   .. literalinclude:: ../../LICENSE/LICENSE_CARLOGO
       :language: none
 
 .. dropdown:: Courier 10
    :class-container: sdd
 
-   .. literalinclude:: ../../../LICENSE/LICENSE_COURIERTEN
+   .. literalinclude:: ../../LICENSE/LICENSE_COURIERTEN
       :language: none
 
 .. dropdown:: STIX
    :class-container: sdd
 
-   .. literalinclude:: ../../../LICENSE/LICENSE_STIX
+   .. literalinclude:: ../../LICENSE/LICENSE_STIX
       :language: none

From 5e041400f0b13f9c91a827769ceae4559c6e03f2 Mon Sep 17 00:00:00 2001
From: Shriya Kalakata <shriyakalakata123@gmail.com>
Date: Wed, 10 Jan 2024 22:29:27 +0530
Subject: [PATCH 0675/1120] Editing folder structure info for doc/project/

---
 doc/devel/contribute.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/devel/contribute.rst b/doc/devel/contribute.rst
index b582aa455341..0548421527d4 100644
--- a/doc/devel/contribute.rst
+++ b/doc/devel/contribute.rst
@@ -267,7 +267,7 @@ document's URL roughly corresponds to its location in our folder structure:
   .. grid-item:: information about the library
 
       * :file:`doc/users/installing/`
-      * :file:`doc/users/project/`
+      * :file:`doc/project/`
       * :file:`doc/users/resources/`
       * :file:`doc/users/faq.rst`
       * :file:`doc/devel/`

From e1b418d54bdc3d81872c0b98acf5139141e63346 Mon Sep 17 00:00:00 2001
From: Shriya Kalakata <shriyakalakata123@gmail.com>
Date: Wed, 10 Jan 2024 22:38:34 +0530
Subject: [PATCH 0676/1120] Editing folder structure info

---
 CODE_OF_CONDUCT.md          | 2 +-
 doc/devel/release_guide.rst | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
index 657eb14336b9..c2dfbe370445 100644
--- a/CODE_OF_CONDUCT.md
+++ b/CODE_OF_CONDUCT.md
@@ -3,4 +3,4 @@
 Our Code of Conduct is at
 https://matplotlib.org/stable/users/project/code_of_conduct.html
 
-It is rendered from `doc/users/project/code_of_conduct.rst`
+It is rendered from `doc/project/code_of_conduct.rst`
diff --git a/doc/devel/release_guide.rst b/doc/devel/release_guide.rst
index 4adc4546e879..77739100c1ce 100644
--- a/doc/devel/release_guide.rst
+++ b/doc/devel/release_guide.rst
@@ -315,8 +315,8 @@ automatically produce one once the tag is pushed). Add the DOI post-fix and vers
 the dictionary in :file:`tools/cache_zenodo_svg.py` and run the script.
 
 This will download the new SVG to :file:`doc/_static/zenodo_cache/{postfix}.svg` and
-edit :file:`doc/users/project/citing.rst`. Commit the new SVG, the change to
-:file:`tools/cache_zenodo_svg.py`, and the changes to :file:`doc/users/project/citing.rst`
+edit :file:`doc/project/citing.rst`. Commit the new SVG, the change to
+:file:`tools/cache_zenodo_svg.py`, and the changes to :file:`doc/project/citing.rst`
 to the VER-doc branch and push to GitHub. ::
 
   git checkout v3.7.0-doc

From 821d512df371a6505a4ee80c1cd10c4c6974a6b8 Mon Sep 17 00:00:00 2001
From: Shriya Kalakata <shriyakalakata123@gmail.com>
Date: Wed, 10 Jan 2024 22:48:25 +0530
Subject: [PATCH 0677/1120] Updated folder structure in pre-commit file

---
 .pre-commit-config.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index aba2f7462223..45d9aaa32591 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -58,7 +58,7 @@ repos:
           "--ignore-words",
           "ci/codespell-ignore-words.txt",
           "--skip",
-          "doc/users/project/credits.rst"
+          "doc/project/credits.rst"
           ]
   - repo: https://github.com/pycqa/isort
     rev: 5.13.2

From 25567d97b7411e8b24475e4ad04383f84182498d Mon Sep 17 00:00:00 2001
From: Shriya Kalakata <shriyakalakata123@gmail.com>
Date: Thu, 11 Jan 2024 00:08:35 +0530
Subject: [PATCH 0678/1120] Refactored references from users/project/ to
 project/ in affected files

---
 CODE_OF_CONDUCT.md        | 2 +-
 README.md                 | 2 +-
 doc/devel/contribute.rst  | 2 +-
 doc/index.rst             | 2 +-
 doc/project/credits.rst   | 2 +-
 tools/cache_zenodo_svg.py | 2 +-
 6 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
index c2dfbe370445..8fbbe8e7d6f3 100644
--- a/CODE_OF_CONDUCT.md
+++ b/CODE_OF_CONDUCT.md
@@ -1,6 +1,6 @@
 <!--placeholder page so Github knows we have a CoC-->
 
 Our Code of Conduct is at
-https://matplotlib.org/stable/users/project/code_of_conduct.html
+https://matplotlib.org/stable/project/code_of_conduct.html
 
 It is rendered from `doc/project/code_of_conduct.rst`
diff --git a/README.md b/README.md
index 5e15c645c9a2..fc3abb7e197c 100644
--- a/README.md
+++ b/README.md
@@ -69,5 +69,5 @@ If Matplotlib contributes to a project that leads to publication, please
 acknowledge this by citing Matplotlib.
 
 [A ready-made citation
-entry](https://matplotlib.org/stable/users/project/citing.html) is
+entry](https://matplotlib.org/stable/project/citing.html) is
 available.
diff --git a/doc/devel/contribute.rst b/doc/devel/contribute.rst
index 0548421527d4..510b67eead91 100644
--- a/doc/devel/contribute.rst
+++ b/doc/devel/contribute.rst
@@ -304,7 +304,7 @@ Matplotlib's community is built by its members, if you would like to help out
 see our :ref:`communications-guidelines`.
 
 If Matplotlib contributes to a project that leads to a scientific publication,
-please follow the :doc:`/users/project/citing` guidelines.
+please follow the :doc:`/project/citing` guidelines.
 
 If you have developed an extension to Matplotlib, please consider adding it to our
 `third party package <https://github.com/matplotlib/mpl-third-party>`_  list.
diff --git a/doc/index.rst b/doc/index.rst
index 4f42273d3dcc..00814b5ccc71 100644
--- a/doc/index.rst
+++ b/doc/index.rst
@@ -172,4 +172,4 @@ About us
         .. toctree::
             :maxdepth: 2
 
-            users/project/index.rst
+            project/index.rst
diff --git a/doc/project/credits.rst b/doc/project/credits.rst
index 667f302b9155..a57c35e8127d 100644
--- a/doc/project/credits.rst
+++ b/doc/project/credits.rst
@@ -14,7 +14,7 @@ Matplotlib was written by John D. Hunter, with contributions from an
 ever-increasing number of users and developers.  The current lead developer is
 Thomas A. Caswell, who is assisted by many `active developers
 <https://www.openhub.net/p/matplotlib/contributors>`_.
-Please also see our instructions on :doc:`/users/project/citing`.
+Please also see our instructions on :doc:`/project/citing`.
 
 The following is a list of contributors extracted from the
 git revision control history of the project:
diff --git a/tools/cache_zenodo_svg.py b/tools/cache_zenodo_svg.py
index cbd1304bd14c..7b53aff212ab 100644
--- a/tools/cache_zenodo_svg.py
+++ b/tools/cache_zenodo_svg.py
@@ -120,7 +120,7 @@ def _get_xdg_cache_dir():
     }
     doc_dir = Path(__file__).parent.parent.absolute() / "doc"
     target_dir = doc_dir / "_static/zenodo_cache"
-    citing = doc_dir / "users/project/citing.rst"
+    citing = doc_dir / "project/citing.rst"
     target_dir.mkdir(exist_ok=True, parents=True)
     header = []
     footer = []

From de170eb1dec8b2c4ff87455174bf052780014441 Mon Sep 17 00:00:00 2001
From: Shriya Kalakata <shriyakalakata123@gmail.com>
Date: Thu, 11 Jan 2024 01:06:39 +0530
Subject: [PATCH 0679/1120] Update CITATION.bib file path

---
 doc/project/citing.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/project/citing.rst b/doc/project/citing.rst
index d2f2614b1497..877113231f9e 100644
--- a/doc/project/citing.rst
+++ b/doc/project/citing.rst
@@ -9,12 +9,12 @@ please acknowledge this fact by citing `J. D. Hunter, "Matplotlib: A 2D
 Graphics Environment", Computing in Science & Engineering, vol. 9, no. 3,
 pp. 90-95, 2007 <https://doi.org/10.1109/MCSE.2007.55>`_.
 
-.. literalinclude:: ../../../CITATION.bib
+.. literalinclude:: ../../CITATION.bib
    :language: bibtex
 
 .. container:: sphx-glr-download
 
-   :download:`Download BibTeX bibliography file: CITATION.bib <../../../CITATION.bib>`
+   :download:`Download BibTeX bibliography file: CITATION.bib <../../CITATION.bib>`
 
 DOIs
 ----

From d7ba93f828f0da777345a37f4ca8f3dca63f0d8f Mon Sep 17 00:00:00 2001
From: Shriya Kalakata <shriyakalakata123@gmail.com>
Date: Thu, 11 Jan 2024 18:41:35 +0530
Subject: [PATCH 0680/1120] Update relative path to ../_static

---
 tools/cache_zenodo_svg.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tools/cache_zenodo_svg.py b/tools/cache_zenodo_svg.py
index 7b53aff212ab..f5e4f2f66527 100644
--- a/tools/cache_zenodo_svg.py
+++ b/tools/cache_zenodo_svg.py
@@ -148,7 +148,7 @@ def _get_xdg_cache_dir():
             fout.write(
                 f"""
 {version}
-   .. image:: ../../_static/zenodo_cache/{doi}.svg
+   .. image:: ../../doc/_static/zenodo_cache/{doi}.svg
       :target:  https://doi.org/10.5281/zenodo.{doi}"""
             )
         fout.write("\n\n")

From 45b6cfa8acf510a109ecff44e2dd87f4b5ffd474 Mon Sep 17 00:00:00 2001
From: Shriya Kalakata <shriyakalakata123@gmail.com>
Date: Thu, 11 Jan 2024 19:38:30 +0530
Subject: [PATCH 0681/1120] Update relative path to ../_static

---
 tools/cache_zenodo_svg.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tools/cache_zenodo_svg.py b/tools/cache_zenodo_svg.py
index f5e4f2f66527..77a3ea629a46 100644
--- a/tools/cache_zenodo_svg.py
+++ b/tools/cache_zenodo_svg.py
@@ -148,7 +148,7 @@ def _get_xdg_cache_dir():
             fout.write(
                 f"""
 {version}
-   .. image:: ../../doc/_static/zenodo_cache/{doi}.svg
+   .. image:: ../_static/zenodo_cache/{doi}.svg
       :target:  https://doi.org/10.5281/zenodo.{doi}"""
             )
         fout.write("\n\n")

From 4e7956be8857e263a7fc6627e36a396fcd496998 Mon Sep 17 00:00:00 2001
From: Shriya Kalakata <shriyakalakata123@gmail.com>
Date: Tue, 23 Jan 2024 18:03:06 -0500
Subject: [PATCH 0682/1120] Update output of tools/cache_zenodo_svg.py

---
 doc/project/citing.rst | 108 ++++++++++++++++++++---------------------
 1 file changed, 54 insertions(+), 54 deletions(-)

diff --git a/doc/project/citing.rst b/doc/project/citing.rst
index 877113231f9e..65fc3db413f0 100644
--- a/doc/project/citing.rst
+++ b/doc/project/citing.rst
@@ -31,166 +31,166 @@ By version
 
 
 v3.8.1
-   .. image:: ../../_static/zenodo_cache/10059757.svg
+   .. image:: ../_static/zenodo_cache/10059757.svg
       :target:  https://doi.org/10.5281/zenodo.10059757
 v3.8.0
-   .. image:: ../../_static/zenodo_cache/8347255.svg
+   .. image:: ../_static/zenodo_cache/8347255.svg
       :target:  https://doi.org/10.5281/zenodo.8347255
 v3.7.3
-   .. image:: ../../_static/zenodo_cache/8336761.svg
+   .. image:: ../_static/zenodo_cache/8336761.svg
       :target:  https://doi.org/10.5281/zenodo.8336761
 v3.7.2
-   .. image:: ../../_static/zenodo_cache/8118151.svg
+   .. image:: ../_static/zenodo_cache/8118151.svg
       :target:  https://doi.org/10.5281/zenodo.8118151
 v3.7.1
-   .. image:: ../../_static/zenodo_cache/7697899.svg
+   .. image:: ../_static/zenodo_cache/7697899.svg
       :target:  https://doi.org/10.5281/zenodo.7697899
 v3.7.0
-   .. image:: ../../_static/zenodo_cache/7637593.svg
+   .. image:: ../_static/zenodo_cache/7637593.svg
       :target:  https://doi.org/10.5281/zenodo.7637593
 v3.6.3
-   .. image:: ../../_static/zenodo_cache/7527665.svg
+   .. image:: ../_static/zenodo_cache/7527665.svg
       :target:  https://doi.org/10.5281/zenodo.7527665
 v3.6.2
-   .. image:: ../../_static/zenodo_cache/7275322.svg
+   .. image:: ../_static/zenodo_cache/7275322.svg
       :target:  https://doi.org/10.5281/zenodo.7275322
 v3.6.1
-   .. image:: ../../_static/zenodo_cache/7162185.svg
+   .. image:: ../_static/zenodo_cache/7162185.svg
       :target:  https://doi.org/10.5281/zenodo.7162185
 v3.6.0
-   .. image:: ../../_static/zenodo_cache/7084615.svg
+   .. image:: ../_static/zenodo_cache/7084615.svg
       :target:  https://doi.org/10.5281/zenodo.7084615
 v3.5.3
-   .. image:: ../../_static/zenodo_cache/6982547.svg
+   .. image:: ../_static/zenodo_cache/6982547.svg
       :target:  https://doi.org/10.5281/zenodo.6982547
 v3.5.2
-   .. image:: ../../_static/zenodo_cache/6513224.svg
+   .. image:: ../_static/zenodo_cache/6513224.svg
       :target:  https://doi.org/10.5281/zenodo.6513224
 v3.5.1
-   .. image:: ../../_static/zenodo_cache/5773480.svg
+   .. image:: ../_static/zenodo_cache/5773480.svg
       :target:  https://doi.org/10.5281/zenodo.5773480
 v3.5.0
-   .. image:: ../../_static/zenodo_cache/5706396.svg
+   .. image:: ../_static/zenodo_cache/5706396.svg
       :target:  https://doi.org/10.5281/zenodo.5706396
 v3.4.3
-   .. image:: ../../_static/zenodo_cache/5194481.svg
+   .. image:: ../_static/zenodo_cache/5194481.svg
       :target:  https://doi.org/10.5281/zenodo.5194481
 v3.4.2
-   .. image:: ../../_static/zenodo_cache/4743323.svg
+   .. image:: ../_static/zenodo_cache/4743323.svg
       :target:  https://doi.org/10.5281/zenodo.4743323
 v3.4.1
-   .. image:: ../../_static/zenodo_cache/4649959.svg
+   .. image:: ../_static/zenodo_cache/4649959.svg
       :target:  https://doi.org/10.5281/zenodo.4649959
 v3.4.0
-   .. image:: ../../_static/zenodo_cache/4638398.svg
+   .. image:: ../_static/zenodo_cache/4638398.svg
       :target:  https://doi.org/10.5281/zenodo.4638398
 v3.3.4
-   .. image:: ../../_static/zenodo_cache/4475376.svg
+   .. image:: ../_static/zenodo_cache/4475376.svg
       :target:  https://doi.org/10.5281/zenodo.4475376
 v3.3.3
-   .. image:: ../../_static/zenodo_cache/4268928.svg
+   .. image:: ../_static/zenodo_cache/4268928.svg
       :target:  https://doi.org/10.5281/zenodo.4268928
 v3.3.2
-   .. image:: ../../_static/zenodo_cache/4030140.svg
+   .. image:: ../_static/zenodo_cache/4030140.svg
       :target:  https://doi.org/10.5281/zenodo.4030140
 v3.3.1
-   .. image:: ../../_static/zenodo_cache/3984190.svg
+   .. image:: ../_static/zenodo_cache/3984190.svg
       :target:  https://doi.org/10.5281/zenodo.3984190
 v3.3.0
-   .. image:: ../../_static/zenodo_cache/3948793.svg
+   .. image:: ../_static/zenodo_cache/3948793.svg
       :target:  https://doi.org/10.5281/zenodo.3948793
 v3.2.2
-   .. image:: ../../_static/zenodo_cache/3898017.svg
+   .. image:: ../_static/zenodo_cache/3898017.svg
       :target:  https://doi.org/10.5281/zenodo.3898017
 v3.2.1
-   .. image:: ../../_static/zenodo_cache/3714460.svg
+   .. image:: ../_static/zenodo_cache/3714460.svg
       :target:  https://doi.org/10.5281/zenodo.3714460
 v3.2.0
-   .. image:: ../../_static/zenodo_cache/3695547.svg
+   .. image:: ../_static/zenodo_cache/3695547.svg
       :target:  https://doi.org/10.5281/zenodo.3695547
 v3.1.3
-   .. image:: ../../_static/zenodo_cache/3633844.svg
+   .. image:: ../_static/zenodo_cache/3633844.svg
       :target:  https://doi.org/10.5281/zenodo.3633844
 v3.1.2
-   .. image:: ../../_static/zenodo_cache/3563226.svg
+   .. image:: ../_static/zenodo_cache/3563226.svg
       :target:  https://doi.org/10.5281/zenodo.3563226
 v3.1.1
-   .. image:: ../../_static/zenodo_cache/3264781.svg
+   .. image:: ../_static/zenodo_cache/3264781.svg
       :target:  https://doi.org/10.5281/zenodo.3264781
 v3.1.0
-   .. image:: ../../_static/zenodo_cache/2893252.svg
+   .. image:: ../_static/zenodo_cache/2893252.svg
       :target:  https://doi.org/10.5281/zenodo.2893252
 v3.0.3
-   .. image:: ../../_static/zenodo_cache/2577644.svg
+   .. image:: ../_static/zenodo_cache/2577644.svg
       :target:  https://doi.org/10.5281/zenodo.2577644
 v3.0.2
-   .. image:: ../../_static/zenodo_cache/1482099.svg
+   .. image:: ../_static/zenodo_cache/1482099.svg
       :target:  https://doi.org/10.5281/zenodo.1482099
 v3.0.1
-   .. image:: ../../_static/zenodo_cache/1482098.svg
+   .. image:: ../_static/zenodo_cache/1482098.svg
       :target:  https://doi.org/10.5281/zenodo.1482098
 v2.2.5
-   .. image:: ../../_static/zenodo_cache/3633833.svg
+   .. image:: ../_static/zenodo_cache/3633833.svg
       :target:  https://doi.org/10.5281/zenodo.3633833
 v3.0.0
-   .. image:: ../../_static/zenodo_cache/1420605.svg
+   .. image:: ../_static/zenodo_cache/1420605.svg
       :target:  https://doi.org/10.5281/zenodo.1420605
 v2.2.4
-   .. image:: ../../_static/zenodo_cache/2669103.svg
+   .. image:: ../_static/zenodo_cache/2669103.svg
       :target:  https://doi.org/10.5281/zenodo.2669103
 v2.2.3
-   .. image:: ../../_static/zenodo_cache/1343133.svg
+   .. image:: ../_static/zenodo_cache/1343133.svg
       :target:  https://doi.org/10.5281/zenodo.1343133
 v2.2.2
-   .. image:: ../../_static/zenodo_cache/1202077.svg
+   .. image:: ../_static/zenodo_cache/1202077.svg
       :target:  https://doi.org/10.5281/zenodo.1202077
 v2.2.1
-   .. image:: ../../_static/zenodo_cache/1202050.svg
+   .. image:: ../_static/zenodo_cache/1202050.svg
       :target:  https://doi.org/10.5281/zenodo.1202050
 v2.2.0
-   .. image:: ../../_static/zenodo_cache/1189358.svg
+   .. image:: ../_static/zenodo_cache/1189358.svg
       :target:  https://doi.org/10.5281/zenodo.1189358
 v2.1.2
-   .. image:: ../../_static/zenodo_cache/1154287.svg
+   .. image:: ../_static/zenodo_cache/1154287.svg
       :target:  https://doi.org/10.5281/zenodo.1154287
 v2.1.1
-   .. image:: ../../_static/zenodo_cache/1098480.svg
+   .. image:: ../_static/zenodo_cache/1098480.svg
       :target:  https://doi.org/10.5281/zenodo.1098480
 v2.1.0
-   .. image:: ../../_static/zenodo_cache/1004650.svg
+   .. image:: ../_static/zenodo_cache/1004650.svg
       :target:  https://doi.org/10.5281/zenodo.1004650
 v2.0.2
-   .. image:: ../../_static/zenodo_cache/573577.svg
+   .. image:: ../_static/zenodo_cache/573577.svg
       :target:  https://doi.org/10.5281/zenodo.573577
 v2.0.1
-   .. image:: ../../_static/zenodo_cache/570311.svg
+   .. image:: ../_static/zenodo_cache/570311.svg
       :target:  https://doi.org/10.5281/zenodo.570311
 v2.0.0
-   .. image:: ../../_static/zenodo_cache/248351.svg
+   .. image:: ../_static/zenodo_cache/248351.svg
       :target:  https://doi.org/10.5281/zenodo.248351
 v1.5.3
-   .. image:: ../../_static/zenodo_cache/61948.svg
+   .. image:: ../_static/zenodo_cache/61948.svg
       :target:  https://doi.org/10.5281/zenodo.61948
 v1.5.2
-   .. image:: ../../_static/zenodo_cache/56926.svg
+   .. image:: ../_static/zenodo_cache/56926.svg
       :target:  https://doi.org/10.5281/zenodo.56926
 v1.5.1
-   .. image:: ../../_static/zenodo_cache/44579.svg
+   .. image:: ../_static/zenodo_cache/44579.svg
       :target:  https://doi.org/10.5281/zenodo.44579
 v1.5.0
-   .. image:: ../../_static/zenodo_cache/32914.svg
+   .. image:: ../_static/zenodo_cache/32914.svg
       :target:  https://doi.org/10.5281/zenodo.32914
 v1.4.3
-   .. image:: ../../_static/zenodo_cache/15423.svg
+   .. image:: ../_static/zenodo_cache/15423.svg
       :target:  https://doi.org/10.5281/zenodo.15423
 v1.4.2
-   .. image:: ../../_static/zenodo_cache/12400.svg
+   .. image:: ../_static/zenodo_cache/12400.svg
       :target:  https://doi.org/10.5281/zenodo.12400
 v1.4.1
-   .. image:: ../../_static/zenodo_cache/12287.svg
+   .. image:: ../_static/zenodo_cache/12287.svg
       :target:  https://doi.org/10.5281/zenodo.12287
 v1.4.0
-   .. image:: ../../_static/zenodo_cache/11451.svg
+   .. image:: ../_static/zenodo_cache/11451.svg
       :target:  https://doi.org/10.5281/zenodo.11451
 
 .. END OF AUTOGENERATED

From 5a9cd4e8dd292f83c50652746ba3e43185ad56df Mon Sep 17 00:00:00 2001
From: Eric Prestat <eric.prestat@gmail.com>
Date: Sat, 22 Jul 2023 10:18:19 +0100
Subject: [PATCH 0683/1120] Add `widths`, `heights` and `angles` setter to
 `EllipseCollection`

---
 lib/matplotlib/collections.py            | 12 +++++++++
 lib/matplotlib/tests/test_collections.py | 31 ++++++++++++++++++++++++
 2 files changed, 43 insertions(+)

diff --git a/lib/matplotlib/collections.py b/lib/matplotlib/collections.py
index cc20e5cebc1b..c3380c278e37 100644
--- a/lib/matplotlib/collections.py
+++ b/lib/matplotlib/collections.py
@@ -1795,6 +1795,18 @@ def _set_transforms(self):
             m[:2, 2:] = 0
             self.set_transform(_affine(m))
 
+    def set_widths(self, widths):
+        self._widths = 0.5 * np.asarray(widths).ravel()
+        self.stale = True
+
+    def set_angles(self, angles):
+        self._angles = np.deg2rad(angles).ravel()
+        self.stale = True
+
+    def set_heights(self, heights):
+        self._heights = 0.5 * np.asarray(heights).ravel()
+        self.stale = True
+
     @artist.allow_rasterization
     def draw(self, renderer):
         self._set_transforms()
diff --git a/lib/matplotlib/tests/test_collections.py b/lib/matplotlib/tests/test_collections.py
index 5baaeaa5d388..19ad4081715a 100644
--- a/lib/matplotlib/tests/test_collections.py
+++ b/lib/matplotlib/tests/test_collections.py
@@ -408,6 +408,37 @@ def test_EllipseCollection():
     ax.autoscale_view()
 
 
+def test_EllipseCollection_setter():
+    # Test widths, heights and angle setter
+    rng = np.random.default_rng(0)
+
+    widths = (2, )
+    heights = (3, )
+    angles = (45, )
+    offsets = rng.random((10, 2)) * 10
+
+    fig, ax = plt.subplots()
+
+    ec = mcollections.EllipseCollection(
+        widths=widths,
+        heights=heights,
+        angles=angles,
+        offsets=offsets,
+        units='x',
+        offset_transform=ax.transData,
+        )
+
+    ax.add_collection(ec)
+    ax.set_xlim(-2, 12)
+    ax.set_ylim(-2, 12)
+
+    new_widths = rng.random((10, 2)) * 2
+    new_heights = rng.random((10, 2)) * 3
+    new_angles = rng.random((10, 2)) * 180
+
+    ec.set(widths=new_widths, heights=new_heights, angles=new_angles)
+
+
 @image_comparison(['polycollection_close.png'], remove_text=True, style='mpl20')
 def test_polycollection_close():
     from mpl_toolkits.mplot3d import Axes3D  # type: ignore

From a62c25f630af24e3226c3457c4ecb8bee4d0f69f Mon Sep 17 00:00:00 2001
From: saranti <tsarantis@proton.me>
Date: Tue, 26 Dec 2023 17:11:19 +1100
Subject: [PATCH 0684/1120] fix boxplot legend entries

---
 lib/matplotlib/axes/_axes.py        |  7 +++++++
 lib/matplotlib/tests/test_legend.py | 32 +++++++++++++++++++++++++++++
 2 files changed, 39 insertions(+)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index ef7d3edfa0b9..b1aeb87e6b45 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -4004,6 +4004,9 @@ def boxplot(self, x, notch=None, sym=None, vert=None, whis=None,
             if 'color' in boxprops:
                 boxprops['edgecolor'] = boxprops.pop('color')
 
+        if labels:
+            boxprops['label'] = labels
+
         # if non-default sym value, put it into the flier dictionary
         # the logic for providing the default symbol ('b+') now lives
         # in bxp in the initial value of flierkw
@@ -4316,13 +4319,16 @@ def do_patch(xs, ys, **kwargs):
                 do_box = do_patch if patch_artist else do_plot
                 boxes.append(do_box(box_x, box_y, **box_kw))
             # draw the whiskers
+            whisker_kw.setdefault('label', '_nolegend_')
             whiskers.append(do_plot(whis_x, whislo_y, **whisker_kw))
             whiskers.append(do_plot(whis_x, whishi_y, **whisker_kw))
             # maybe draw the caps
             if showcaps:
+                cap_kw.setdefault('label', '_nolegend_')
                 caps.append(do_plot(cap_x, cap_lo, **cap_kw))
                 caps.append(do_plot(cap_x, cap_hi, **cap_kw))
             # draw the medians
+            median_kw.setdefault('label', '_nolegend_')
             medians.append(do_plot(med_x, med_y, **median_kw))
             # maybe draw the means
             if showmeans:
@@ -4335,6 +4341,7 @@ def do_patch(xs, ys, **kwargs):
                     means.append(do_plot([pos], [stats['mean']], **mean_kw))
             # maybe draw the fliers
             if showfliers:
+                flier_kw.setdefault('label', '_nolegend_')
                 flier_x = np.full(len(stats['fliers']), pos, dtype=np.float64)
                 flier_y = stats['fliers']
                 fliers.append(do_plot(flier_x, flier_y, **flier_kw))
diff --git a/lib/matplotlib/tests/test_legend.py b/lib/matplotlib/tests/test_legend.py
index 1cc8f535f57e..6357b4ce62a0 100644
--- a/lib/matplotlib/tests/test_legend.py
+++ b/lib/matplotlib/tests/test_legend.py
@@ -1427,3 +1427,35 @@ def test_legend_text():
         leg_bboxes.append(
             leg.get_window_extent().transformed(ax.transAxes.inverted()))
     assert_allclose(leg_bboxes[1].bounds, leg_bboxes[0].bounds)
+
+
+def test_boxplot_legend():
+    # Test that boxplot legends handles are patches
+    # and labels are generated from boxplot's labels parameter.
+    fig, axs = plt.subplots()
+    A = 5*np.random.rand(100, 1)
+    B = 10*np.random.rand(100, 1) - 5
+    C = 7*np.random.rand(100, 1) - 5
+    labels = ['a', 'b', 'c']
+
+    bp0 = axs.boxplot(A, positions=[0], patch_artist=True, labels=labels[0])
+    bp1 = axs.boxplot(B, positions=[1], patch_artist=True, labels=labels[1])
+    bp2 = axs.boxplot(C, positions=[2], patch_artist=True, labels=labels[2])
+    # red, blue, green
+    colors = [(1.0, 0.0, 0.0, 1), (0.0, 0.0, 1.0, 1), (0.0, 0.5, 0.0, 1)]
+    box_list = [bp0, bp1, bp2]
+    # Set colors to the boxes
+    lbl_index = 0
+    for b_plot, color in zip(box_list, colors):
+        for patch in b_plot['boxes']:
+            patch.set_color(color)
+            lbl_index += 1
+
+    legend = axs.legend()
+    index = 0
+    for i in legend.legend_handles:
+        assert isinstance(i, mpl.patches.Rectangle)
+        assert i.get_facecolor() == colors[index]
+        assert i.get_edgecolor() == colors[index]
+        assert i.get_label() == labels[index]
+        index += 1

From 659fec86be28d99f63ee2f0a3ceda0b8873f2b7e Mon Sep 17 00:00:00 2001
From: saranti <tsarantis@proton.me>
Date: Wed, 24 Jan 2024 19:51:12 +1100
Subject: [PATCH 0685/1120] add method to update arrow patch

---
 .../next_whats_new/update_arrow_patch.rst     | 30 ++++++++++++++
 lib/matplotlib/patches.py                     | 40 ++++++++++++++++---
 lib/matplotlib/patches.pyi                    |  9 ++++-
 lib/matplotlib/tests/test_patches.py          | 29 ++++++++++++++
 4 files changed, 101 insertions(+), 7 deletions(-)
 create mode 100644 doc/users/next_whats_new/update_arrow_patch.rst

diff --git a/doc/users/next_whats_new/update_arrow_patch.rst b/doc/users/next_whats_new/update_arrow_patch.rst
new file mode 100644
index 000000000000..894090587b5d
--- /dev/null
+++ b/doc/users/next_whats_new/update_arrow_patch.rst
@@ -0,0 +1,30 @@
+Update the position of arrow patch
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Adds a setter method that allows the user to update the position of the
+`.patches.Arrow` object without requiring a full re-draw.
+
+.. plot::
+    :include-source: true
+    :alt: Example of changing the position of the arrow with the new ``set_data`` method.
+
+    import matplotlib as mpl
+    import matplotlib.pyplot as plt
+    from matplotlib.patches import Arrow
+    import matplotlib.animation as animation
+
+    fig, ax = plt.subplots()
+    ax.set_xlim(0, 10)
+    ax.set_ylim(0, 10)
+
+    a = mpl.patches.Arrow(2, 0, 0, 10)
+    ax.add_patch(a)
+
+
+    # code for modifying the arrow
+    def update(i):
+        a.set_data(x=.5, dx=i, dy=6, width=2)
+
+
+    ani = animation.FuncAnimation(fig, update, frames=15, interval=90, blit=False)
+
+    plt.show()
diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
index ef52a00b059b..fc9d2c88897d 100644
--- a/lib/matplotlib/patches.py
+++ b/lib/matplotlib/patches.py
@@ -1297,12 +1297,7 @@ def __init__(self, x, y, dx, dy, *, width=1.0, **kwargs):
             properties.
         """
         super().__init__(**kwargs)
-        self._patch_transform = (
-            transforms.Affine2D()
-            .scale(np.hypot(dx, dy), width)
-            .rotate(np.arctan2(dy, dx))
-            .translate(x, y)
-            .frozen())
+        self.set_data(x, y, dx, dy, width)
 
     def get_path(self):
         return self._path
@@ -1310,6 +1305,39 @@ def get_path(self):
     def get_patch_transform(self):
         return self._patch_transform
 
+    def set_data(self, x=None, y=None, dx=None, dy=None, width=None):
+        """
+        Set `.Arrow` x, y, dx, dy and width.
+        Values left as None will not be updated.
+
+        Parameters
+        ----------
+        x, y : float or None, default: None
+            The x and y coordinates of the arrow base.
+
+        dx, dy : float or None, default: None
+            The length of the arrow along x and y direction.
+
+        width : float or None, default: None
+            Width of full arrow tail.
+        """
+        if x is not None:
+            self._x = x
+        if y is not None:
+            self._y = y
+        if dx is not None:
+            self._dx = dx
+        if dy is not None:
+            self._dy = dy
+        if width is not None:
+            self._width = width
+        self._patch_transform = (
+            transforms.Affine2D()
+            .scale(np.hypot(self._dx, self._dy), self._width)
+            .rotate(np.arctan2(self._dy, self._dx))
+            .translate(self._x, self._y)
+            .frozen())
+
 
 class FancyArrow(Polygon):
     """
diff --git a/lib/matplotlib/patches.pyi b/lib/matplotlib/patches.pyi
index 287ea0f738ab..f6c9ddf75839 100644
--- a/lib/matplotlib/patches.pyi
+++ b/lib/matplotlib/patches.pyi
@@ -181,7 +181,14 @@ class Arrow(Patch):
     def __init__(
         self, x: float, y: float, dx: float, dy: float, *, width: float = ..., **kwargs
     ) -> None: ...
-
+    def set_data(
+        self,
+        x: float | None = ...,
+        y: float | None = ...,
+        dx: float | None = ...,
+        dy: float | None = ...,
+        width: float | None = ...,
+    ) -> None: ...
 class FancyArrow(Polygon):
     def __init__(
         self,
diff --git a/lib/matplotlib/tests/test_patches.py b/lib/matplotlib/tests/test_patches.py
index b1af0abbc573..9530bcd19130 100644
--- a/lib/matplotlib/tests/test_patches.py
+++ b/lib/matplotlib/tests/test_patches.py
@@ -931,3 +931,32 @@ def test_modifying_arc(fig_test, fig_ref):
     fig_test.subplots().add_patch(arc2)
     arc2.set_width(.5)
     arc2.set_angle(20)
+
+
+def test_arrow_set_data():
+    fig, ax = plt.subplots()
+    arrow = mpl.patches.Arrow(2, 0, 0, 10)
+    expected1 = np.array(
+       [[1.9,  0.],
+        [2.1, -0.],
+        [2.1, 8.],
+        [2.3, 8.],
+        [2., 10.],
+        [1.7, 8.],
+        [1.9, 8.],
+        [1.9, 0.]]
+    )
+    assert np.allclose(expected1, np.round(arrow.get_verts(), 2))
+
+    expected2 = np.array(
+        [[0.39, 0.04],
+         [0.61, -0.04],
+         [3.01, 6.36],
+         [3.24, 6.27],
+         [3.5, 8.],
+         [2.56, 6.53],
+         [2.79, 6.44],
+         [0.39, 0.04]]
+    )
+    arrow.set_data(x=.5, dx=3, dy=8, width=1.2)
+    assert np.allclose(expected2, np.round(arrow.get_verts(), 2))

From c52ba6c2ae96cd02ffcdf8ab18417f57b7ab9c90 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 29 Jan 2024 19:12:01 +0000
Subject: [PATCH 0686/1120] Bump the actions group with 3 updates

Bumps the actions group with 3 updates: [pypa/cibuildwheel](https://github.com/pypa/cibuildwheel), [peter-evans/create-or-update-comment](https://github.com/peter-evans/create-or-update-comment) and [scientific-python/upload-nightly-action](https://github.com/scientific-python/upload-nightly-action).


Updates `pypa/cibuildwheel` from 2.16.2 to 2.16.4
- [Release notes](https://github.com/pypa/cibuildwheel/releases)
- [Changelog](https://github.com/pypa/cibuildwheel/blob/main/docs/changelog.md)
- [Commits](https://github.com/pypa/cibuildwheel/compare/fff9ec32ed25a9c576750c91e06b410ed0c15db7...0b04ab1040366101259658b355777e4ff2d16f83)

Updates `peter-evans/create-or-update-comment` from 3 to 4
- [Release notes](https://github.com/peter-evans/create-or-update-comment/releases)
- [Commits](https://github.com/peter-evans/create-or-update-comment/compare/v3...v4)

Updates `scientific-python/upload-nightly-action` from 0.2.0 to 0.3.0
- [Release notes](https://github.com/scientific-python/upload-nightly-action/releases)
- [Commits](https://github.com/scientific-python/upload-nightly-action/compare/5fb764c5bce1ac2297084c0f7161b1919f17c74f...6e9304f7a3a5501c6f98351537493ec898728299)

---
updated-dependencies:
- dependency-name: pypa/cibuildwheel
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: actions
- dependency-name: peter-evans/create-or-update-comment
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: actions
- dependency-name: scientific-python/upload-nightly-action
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: actions
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 .github/workflows/cibuildwheel.yml     | 10 +++++-----
 .github/workflows/good-first-issue.yml |  2 +-
 .github/workflows/nightlies.yml        |  2 +-
 3 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index b16e01a5ba7e..f3f5f5e9e6f3 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -146,7 +146,7 @@ jobs:
           path: dist/
 
       - name: Build wheels for CPython 3.12
-        uses: pypa/cibuildwheel@fff9ec32ed25a9c576750c91e06b410ed0c15db7 # v2.16.2
+        uses: pypa/cibuildwheel@0b04ab1040366101259658b355777e4ff2d16f83 # v2.16.4
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -154,7 +154,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.11
-        uses: pypa/cibuildwheel@fff9ec32ed25a9c576750c91e06b410ed0c15db7 # v2.16.2
+        uses: pypa/cibuildwheel@0b04ab1040366101259658b355777e4ff2d16f83 # v2.16.4
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -162,7 +162,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.10
-        uses: pypa/cibuildwheel@fff9ec32ed25a9c576750c91e06b410ed0c15db7 # v2.16.2
+        uses: pypa/cibuildwheel@0b04ab1040366101259658b355777e4ff2d16f83 # v2.16.4
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -170,7 +170,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.9
-        uses: pypa/cibuildwheel@fff9ec32ed25a9c576750c91e06b410ed0c15db7 # v2.16.2
+        uses: pypa/cibuildwheel@0b04ab1040366101259658b355777e4ff2d16f83 # v2.16.4
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -178,7 +178,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for PyPy
-        uses: pypa/cibuildwheel@fff9ec32ed25a9c576750c91e06b410ed0c15db7 # v2.16.2
+        uses: pypa/cibuildwheel@0b04ab1040366101259658b355777e4ff2d16f83 # v2.16.4
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
diff --git a/.github/workflows/good-first-issue.yml b/.github/workflows/good-first-issue.yml
index 30a9917d6d1e..baac893a6a7a 100644
--- a/.github/workflows/good-first-issue.yml
+++ b/.github/workflows/good-first-issue.yml
@@ -11,7 +11,7 @@ jobs:
       issues: write
     steps:
       - name: Add comment
-        uses: peter-evans/create-or-update-comment@v3
+        uses: peter-evans/create-or-update-comment@v4
         with:
           issue-number: ${{ github.event.issue.number }}
           body: |
diff --git a/.github/workflows/nightlies.yml b/.github/workflows/nightlies.yml
index 703194a762ee..8210fa237205 100644
--- a/.github/workflows/nightlies.yml
+++ b/.github/workflows/nightlies.yml
@@ -59,7 +59,7 @@ jobs:
           ls -l dist/
 
       - name: Upload wheels to Anaconda Cloud as nightlies
-        uses: scientific-python/upload-nightly-action@5fb764c5bce1ac2297084c0f7161b1919f17c74f # 0.2.0
+        uses: scientific-python/upload-nightly-action@6e9304f7a3a5501c6f98351537493ec898728299 # 0.3.0
         with:
           artifacts_path: dist
           anaconda_nightly_upload_token: ${{ secrets.ANACONDA_ORG_UPLOAD_TOKEN }}

From 75d260ad1d200f8d761454925b18da735adc5ae3 Mon Sep 17 00:00:00 2001
From: Allan Haldane <allan.haldane@gmail.com>
Date: Mon, 29 Jan 2024 17:29:15 -0500
Subject: [PATCH 0687/1120] corrected default image save format in gtk4 dialog

---
 lib/matplotlib/backends/backend_gtk4.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/backends/backend_gtk4.py b/lib/matplotlib/backends/backend_gtk4.py
index cb4006048d55..7e73a4863212 100644
--- a/lib/matplotlib/backends/backend_gtk4.py
+++ b/lib/matplotlib/backends/backend_gtk4.py
@@ -361,7 +361,7 @@ def save_figure(self, *args):
         formats = [formats[default_format], *formats[:default_format],
                    *formats[default_format+1:]]
         dialog.add_choice('format', 'File format', formats, formats)
-        dialog.set_choice('format', formats[default_format])
+        dialog.set_choice('format', formats[0])
 
         dialog.set_current_folder(Gio.File.new_for_path(
             os.path.expanduser(mpl.rcParams['savefig.directory'])))

From d3144b191e938c8fc2bec91ee80d4c1f52456624 Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Tue, 30 Jan 2024 16:01:35 +0000
Subject: [PATCH 0688/1120] Improve Locator docstrings (#27686)

* Improve Locator docstrings

* Minor improvements to Locator docstrings
---
 lib/matplotlib/ticker.py | 106 +++++++++++++++++++--------------------
 1 file changed, 52 insertions(+), 54 deletions(-)

diff --git a/lib/matplotlib/ticker.py b/lib/matplotlib/ticker.py
index 1e9f0892c322..16949204a218 100644
--- a/lib/matplotlib/ticker.py
+++ b/lib/matplotlib/ticker.py
@@ -1589,7 +1589,7 @@ def symbol(self, symbol):
 
 class Locator(TickHelper):
     """
-    Determine the tick locations;
+    Determine tick locations.
 
     Note that the same locator should not be used across multiple
     `~matplotlib.axis.Axis` because the locator stores references to the Axis
@@ -1679,10 +1679,10 @@ def view_limits(self, vmin, vmax):
 
 class IndexLocator(Locator):
     """
-    Place a tick on every multiple of some base number of points
-    plotted, e.g., on every 5th point.  It is assumed that you are doing
-    index plotting; i.e., the axis is 0, len(data).  This is mainly
-    useful for x ticks.
+    Place ticks at every nth point plotted.
+
+    IndexLocator assumes index plotting; i.e., that the ticks are placed at integer
+    values in the range between 0 and len(data) inclusive.
     """
     def __init__(self, base, offset):
         """Place ticks every *base* data point, starting at *offset*."""
@@ -1708,12 +1708,12 @@ def tick_values(self, vmin, vmax):
 
 class FixedLocator(Locator):
     """
-    Tick locations are fixed at *locs*.  If *nbins* is not None,
-    the *locs* array of possible positions will be subsampled to
-    keep the number of ticks <= *nbins* +1.
-    The subsampling will be done to include the smallest
-    absolute value; for example, if zero is included in the
-    array of possibilities, then it is guaranteed to be one of
+    Place ticks at a set of fixed values.
+
+    If *nbins* is None ticks are placed at all values. Otherwise, the *locs* array of
+    possible positions will be subsampled to keep the number of ticks <=
+    :math:`nbins* +1`. The subsampling will be done to include the smallest absolute
+    value; for example, if zero is included in the array of possibilities, then it of
     the chosen ticks.
     """
 
@@ -1773,7 +1773,7 @@ def tick_values(self, vmin, vmax):
 
 class LinearLocator(Locator):
     """
-    Determine the tick locations
+    Place ticks at evenly spaced values.
 
     The first time this function is called it will try to set the
     number of ticks to make a nice tick partitioning.  Thereafter, the
@@ -1854,8 +1854,7 @@ def view_limits(self, vmin, vmax):
 
 class MultipleLocator(Locator):
     """
-    Set a tick on each integer multiple of the *base* plus an *offset* within
-    the view interval.
+    Place ticks at every integer multiple of a base plus an offset.
     """
 
     def __init__(self, base=1.0, offset=0.0):
@@ -1983,7 +1982,9 @@ def ge(self, x):
 
 class MaxNLocator(Locator):
     """
-    Find nice tick locations with no more than *nbins* + 1 being within the
+    Place evenly spaced ticks, with a cap on the total number of ticks.
+
+    Finds nice tick locations with no more than :math:`nbins + 1` ticks being within the
     view limits. Locations beyond the limits are added to support autoscaling.
     """
     default_params = dict(nbins=10,
@@ -2266,38 +2267,34 @@ def _is_close_to_int(x):
 
 class LogLocator(Locator):
     """
+    Place logarithmically spaced ticks.
 
-    Determine the tick locations for log axes.
-
-    Place ticks on the locations : ``subs[j] * base**i``
-
-    Parameters
-    ----------
-    base : float, default: 10.0
-        The base of the log used, so major ticks are placed at
-        ``base**n``, where ``n`` is an integer.
-    subs : None or {'auto', 'all'} or sequence of float, default: (1.0,)
-        Gives the multiples of integer powers of the base at which
-        to place ticks.  The default of ``(1.0, )`` places ticks only at
-        integer powers of the base.
-        Permitted string values are ``'auto'`` and ``'all'``.
-        Both of these use an algorithm based on the axis view
-        limits to determine whether and how to put ticks between
-        integer powers of the base.  With ``'auto'``, ticks are
-        placed only between integer powers; with ``'all'``, the
-        integer powers are included.  A value of None is
-        equivalent to ``'auto'``.
-    numticks : None or int, default: None
-        The maximum number of ticks to allow on a given axis. The default
-        of ``None`` will try to choose intelligently as long as this
-        Locator has already been assigned to an axis using
-        `~.axis.Axis.get_tick_space`, but otherwise falls back to 9.
-
+    Places ticks at the values ``subs[j] * base**i``.
     """
 
     @_api.delete_parameter("3.8", "numdecs")
     def __init__(self, base=10.0, subs=(1.0,), numdecs=4, numticks=None):
-        """Place ticks on the locations : subs[j] * base**i."""
+        """
+        Parameters
+        ----------
+        base : float, default: 10.0
+            The base of the log used, so major ticks are placed at ``base**n``, where
+            ``n`` is an integer.
+        subs : None or {'auto', 'all'} or sequence of float, default: (1.0,)
+            Gives the multiples of integer powers of the base at which to place ticks.
+            The default of ``(1.0, )`` places ticks only at integer powers of the base.
+            Permitted string values are ``'auto'`` and ``'all'``. Both of these use an
+            algorithm based on the axis view limits to determine whether and how to put
+            ticks between integer powers of the base:
+            - ``'auto'``: Ticks are placed only between integer powers.
+            - ``'all'``: Ticks are placed between *and* at integer powers.
+            - ``None``: Equivalent to ``'auto'``.
+        numticks : None or int, default: None
+            The maximum number of ticks to allow on a given axis. The default of
+            ``None`` will try to choose intelligently as long as this Locator has
+            already been assigned to an axis using `~.axis.Axis.get_tick_space`, but
+            otherwise falls back to 9.
+        """
         if numticks is None:
             if mpl.rcParams['_internal.classic_mode']:
                 numticks = 15
@@ -2464,7 +2461,7 @@ def nonsingular(self, vmin, vmax):
 
 class SymmetricalLogLocator(Locator):
     """
-    Determine the tick locations for symmetric log axes.
+    Place ticks spaced linearly near zero and spaced logarithmically beyond a threshold.
     """
 
     def __init__(self, transform=None, subs=None, linthresh=None, base=None):
@@ -2618,10 +2615,9 @@ def view_limits(self, vmin, vmax):
 
 class AsinhLocator(Locator):
     """
-    An axis tick locator specialized for the inverse-sinh scale
+    Place ticks spaced evenly on an inverse-sinh scale.
 
-    This is very unlikely to have any use beyond
-    the `~.scale.AsinhScale` class.
+    Generally used with the `~.scale.AsinhScale` class.
 
     .. note::
 
@@ -2711,13 +2707,11 @@ def tick_values(self, vmin, vmax):
 
 class LogitLocator(MaxNLocator):
     """
-    Determine the tick locations for logit axes
+    Place ticks spaced evenly on a logit scale.
     """
 
     def __init__(self, minor=False, *, nbins="auto"):
         """
-        Place ticks on the logit locations
-
         Parameters
         ----------
         nbins : int or 'auto', optional
@@ -2859,9 +2853,11 @@ def nonsingular(self, vmin, vmax):
 
 class AutoLocator(MaxNLocator):
     """
-    Dynamically find major tick positions. This is actually a subclass
-    of `~matplotlib.ticker.MaxNLocator`, with parameters *nbins = 'auto'*
-    and *steps = [1, 2, 2.5, 5, 10]*.
+    Place evenly spaced ticks, with the step size and maximum number of ticks chosen
+    automatically.
+
+    This is a subclass of `~matplotlib.ticker.MaxNLocator`, with parameters
+    *nbins = 'auto'* and *steps = [1, 2, 2.5, 5, 10]*.
     """
     def __init__(self):
         """
@@ -2879,8 +2875,10 @@ def __init__(self):
 
 class AutoMinorLocator(Locator):
     """
-    Dynamically find minor tick positions based on the positions of
-    major ticks. The scale must be linear with major ticks evenly spaced.
+    Place evenly spaced minor ticks, with the step size and maximum number of ticks
+    chosen automatically.
+
+    The Axis scale must be linear with evenly spaced major ticks .
     """
 
     def __init__(self, n=None):

From 716355752c7a75c8681da9e7c78185b5f7cf8ec1 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Wed, 24 Jan 2024 17:12:48 -0500
Subject: [PATCH 0689/1120] clean up automated tests section of workflow docs
 turn ci information into tables

---
 .circleci/config.yml               |   2 +-
 doc/devel/coding_guide.rst         |   2 +
 doc/devel/development_workflow.rst | 116 +++++++++++++++++++----------
 3 files changed, 80 insertions(+), 40 deletions(-)

diff --git a/.circleci/config.yml b/.circleci/config.yml
index 995043c3e602..4fac8e28f322 100644
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -17,7 +17,7 @@ commands:
             export git_log=$(git log --max-count=1 --pretty=format:"%B" | tr "\n" " ")
             echo "Got commit message:"
             echo "${git_log}"
-            if [[ -v CIRCLE_PULL_REQUEST ]] && ([[ "$git_log" == *"[skip circle]"* ]] || [[ "$git_log" == *"[circle skip]"* ]]); then
+            if [[ -v CIRCLE_PULL_REQUEST ]] && [[ $git_log =~ (\[skip circle\]|\[circle skip\]|\[skip doc\]|\[doc skip\]) ]]; then
               echo "Skip detected, exiting job ${CIRCLE_JOB} for PR ${CIRCLE_PULL_REQUEST}."
               circleci-agent step halt;
             fi
diff --git a/doc/devel/coding_guide.rst b/doc/devel/coding_guide.rst
index 5368cda94e0f..77247ba9a3b2 100644
--- a/doc/devel/coding_guide.rst
+++ b/doc/devel/coding_guide.rst
@@ -13,6 +13,8 @@ consistency, and maintainability of the code base.
     If adding new features, changing behavior or function signatures, or removing
     public interfaces, please consult the :ref:`api_changes`.
 
+.. _code-style:
+
 PEP8, as enforced by flake8
 ===========================
 
diff --git a/doc/devel/development_workflow.rst b/doc/devel/development_workflow.rst
index edb21bb862cd..23e2c17732e2 100644
--- a/doc/devel/development_workflow.rst
+++ b/doc/devel/development_workflow.rst
@@ -452,48 +452,86 @@ Automated tests
 Whenever a pull request is created or updated, various automated test tools
 will run on all supported platforms and versions of Python.
 
-* Make sure the Linting, GitHub Actions, AppVeyor, CircleCI, and Azure
-  pipelines are passing before merging (All checks are listed at the bottom of
-  the GitHub page of your pull request). Here are some tips for finding the
-  cause of the test failure:
-
-  - If *Linting* fails, you have a code style issue, which will be listed
-    as annotations on the pull request's diff.
-  - If *Mypy* or *Stubtest* fails, you have inconsistency in type hints, which
-    will be listed as annotations in the diff.
-  - If a GitHub Actions or AppVeyor run fails, search the log for ``FAILURES``.
-    The subsequent section will contain information on the failed tests.
-  - If CircleCI fails, likely you have some reStructuredText style issue in
-    the docs. Search the CircleCI log for ``WARNING``.
-  - If Azure pipelines fail with an image comparison error, you can find the
-    images as *artifacts* of the Azure job:
-
-    - Click *Details* on the check on the GitHub PR page.
-    - Click *View more details on Azure Pipelines* to go to Azure.
-    - On the overview page *artifacts* are listed in the section *Related*.
-
-
-* Codecov and CodeQL are currently for information only. Their failure is not
-  necessarily a blocker.
-
 * tox_ is not used in the automated testing. It is supported for testing
   locally.
 
   .. _tox: https://tox.readthedocs.io/
 
-* If you know only a subset of CIs need to be run, this can be controlled on
-  individual commits by including the following substrings in commit messages:
-
-  - ``[ci doc]``: restrict the CI to documentation checks. For when you only
-    changed documentation (this skip is automatic if the changes are only under
-    ``doc/`` or ``galleries/``).
-  - ``[skip circle]``: skip the documentation build check. For when you didn't
-    change documentation.
-  - Unit tests can be turned off for individual platforms with
-
-    - ``[skip actions]``: GitHub Actions
-    - ``[skip appveyor]`` (must be in the first line of the commit): AppVeyor
-    - ``[skip azp]``: Azure Pipelines
+* Codecov and CodeQL are currently for information only. Their failure is not
+  necessarily a blocker.
 
-  - ``[skip ci]``: skip all CIs.  Use this only if you know your changes do not
-    need to be tested at all, which is very rare.
+Make sure the Linting, GitHub Actions, AppVeyor, CircleCI, and Azure pipelines are
+passing before merging. All checks are listed at the bottom of the GitHub page of your
+pull request.
+
+.. list-table::
+    :header-rows: 1
+    :stub-columns: 1
+    :widths: 20 20 60
+
+    * - Name
+      - Check
+      - Tips for finding cause of failure
+    * - Linting
+      - :ref:`code style <code-style>`
+      - Errors are displayed as annotations on the pull request diff.
+    * - | Mypy
+        | Stubtest
+      - :ref:`static type hints <type-hints>`
+      - Errors are displayed as annotations on the pull request diff.
+    * - CircleCI
+      - :ref:`documentation build <writing-rest-pages>`
+      - Search the CircleCI log for ``WARNING``.
+    * - | GitHub Actions
+        | AppVeyor
+        | Azure pipelines
+      - :ref:`tests <testing>`
+      - | Search the log for ``FAILURES``. Subsequent section should contain information
+          on failed tests.
+        |
+        | On Azure, find the images as *artifacts* of the Azure job:
+        | 1. Click *Details* on the check on the GitHub PR page.
+        | 2. Click *View more details on Azure Pipelines* to go to Azure.
+        | 3. On the overview page *artifacts* are listed in the section *Related*.
+
+Skip CI checks
+--------------
+
+If you know only a subset of CI checks need to be run, you can skip unneeded CI checks
+on individual commits by including the following strings in the commit message:
+
+.. list-table::
+    :header-rows: 1
+    :stub-columns: 1
+    :widths: 25 20 55
+
+    * - String
+      - Effect
+      - Notes
+    * - ``[ci doc]``
+      - Only run documentation checks.
+      - | For when you have only changed documentation.
+        | ``[ci doc]`` is applied automatically when the changes are only to files in
+          ``doc/**/`` or ``galleries/**/``
+    * - ``[skip doc]``
+      - Skip documentation checks.
+      - For when you didn't change documentation.
+    * - ``[skip appveyor]``
+      - Skip AppVeyor run.
+      - Substring must be in first line of commit message.
+    * - ``[skip azp]``
+      - Skip Azure Pipelines.
+      -
+    * - ``[skip actions]``
+      - Skip GitHub Actions.
+      -
+    * - ``[skip ci]``
+      - Skip all CI checks.
+      - Use only for changes where documentation checks and unit tests do not apply.
+
+
+``[skip actions]`` and ``[skip ci]`` only skip Github Actions CI workflows that are
+triggered on ``on: push`` and ``on: pull_request`` events. For more information,
+see `Skipping workflow runs`_.
+
+.. _`Skipping workflow runs`: https://docs.github.com/en/actions/managing-workflow-runs/skipping-workflow-runs

From 6ef9cce3ff653de8f1bb8fd5715abbf73841ca70 Mon Sep 17 00:00:00 2001
From: saranti <tsarantis@proton.me>
Date: Wed, 31 Jan 2024 13:14:02 +1100
Subject: [PATCH 0690/1120] improve test code

---
 lib/matplotlib/tests/test_legend.py | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/lib/matplotlib/tests/test_legend.py b/lib/matplotlib/tests/test_legend.py
index 6357b4ce62a0..820f9d967f24 100644
--- a/lib/matplotlib/tests/test_legend.py
+++ b/lib/matplotlib/tests/test_legend.py
@@ -1452,10 +1452,8 @@ def test_boxplot_legend():
             lbl_index += 1
 
     legend = axs.legend()
-    index = 0
-    for i in legend.legend_handles:
-        assert isinstance(i, mpl.patches.Rectangle)
-        assert i.get_facecolor() == colors[index]
-        assert i.get_edgecolor() == colors[index]
-        assert i.get_label() == labels[index]
-        index += 1
+    for index, handle in enumerate(legend.legend_handles):
+        assert isinstance(handle, mpl.patches.Rectangle)
+        assert handle.get_facecolor() == colors[index]
+        assert handle.get_edgecolor() == colors[index]
+        assert handle.get_label() == labels[index]

From 78657d46e5776473a2419295ea12adba003750bd Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Wed, 31 Jan 2024 15:47:15 -0500
Subject: [PATCH 0691/1120] TST: always set a (long) timeout for subprocess

If you are using this and really need unbounded timeouts, explicitly
pass `timeout=None`
---
 lib/matplotlib/testing/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/testing/__init__.py b/lib/matplotlib/testing/__init__.py
index d740b625b7c1..685b98cd99ec 100644
--- a/lib/matplotlib/testing/__init__.py
+++ b/lib/matplotlib/testing/__init__.py
@@ -50,7 +50,7 @@ def setup():
     set_reproducibility_for_testing()
 
 
-def subprocess_run_for_testing(command, env=None, timeout=None, stdout=None,
+def subprocess_run_for_testing(command, env=None, timeout=60, stdout=None,
                                stderr=None, check=False, text=True,
                                capture_output=False):
     """

From fd4ea1d6bb617121e76f3c464dc938c91b268a17 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Thu, 1 Feb 2024 09:05:08 +0100
Subject: [PATCH 0692/1120] Simplify Figure._suplabels.

Rely on alias normalization machinery to make alias checking simpler and
more robust (there are also aliases for fontproperties which were not
checked before).

While at it, also slightly reorder Text aliases (this has no actual
visible effect) to have the font properties and the alignments grouped.
---
 lib/matplotlib/figure.py | 27 ++++++++++-----------------
 lib/matplotlib/text.py   |  8 ++++----
 2 files changed, 14 insertions(+), 21 deletions(-)

diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
index 2cd1436ed1c9..388f2c4f64ea 100644
--- a/lib/matplotlib/figure.py
+++ b/lib/matplotlib/figure.py
@@ -287,8 +287,6 @@ def _suplabels(self, t, info, **kwargs):
             Additional kwargs are `matplotlib.text.Text` properties.
         """
 
-        suplab = getattr(self, info['name'])
-
         x = kwargs.pop('x', None)
         y = kwargs.pop('y', None)
         if info['name'] in ['_supxlabel', '_suptitle']:
@@ -300,29 +298,24 @@ def _suplabels(self, t, info, **kwargs):
         if y is None:
             y = info['y0']
 
-        if 'horizontalalignment' not in kwargs and 'ha' not in kwargs:
-            kwargs['horizontalalignment'] = info['ha']
-        if 'verticalalignment' not in kwargs and 'va' not in kwargs:
-            kwargs['verticalalignment'] = info['va']
-        if 'rotation' not in kwargs:
-            kwargs['rotation'] = info['rotation']
+        kwargs = cbook.normalize_kwargs(kwargs, Text)
+        kwargs.setdefault('horizontalalignment', info['ha'])
+        kwargs.setdefault('verticalalignment', info['va'])
+        kwargs.setdefault('rotation', info['rotation'])
 
         if 'fontproperties' not in kwargs:
-            if 'fontsize' not in kwargs and 'size' not in kwargs:
-                kwargs['size'] = mpl.rcParams[info['size']]
-            if 'fontweight' not in kwargs and 'weight' not in kwargs:
-                kwargs['weight'] = mpl.rcParams[info['weight']]
+            kwargs.setdefault('fontsize', mpl.rcParams[info['size']])
+            kwargs.setdefault('fontweight', mpl.rcParams[info['weight']])
 
-        sup = self.text(x, y, t, **kwargs)
+        suplab = getattr(self, info['name'])
         if suplab is not None:
             suplab.set_text(t)
             suplab.set_position((x, y))
-            suplab.update_from(sup)
-            sup.remove()
+            suplab.set(**kwargs)
         else:
-            suplab = sup
+            suplab = self.text(x, y, t, **kwargs)
+            setattr(self, info['name'], suplab)
         suplab._autopos = autopos
-        setattr(self, info['name'], suplab)
         self.stale = True
         return suplab
 
diff --git a/lib/matplotlib/text.py b/lib/matplotlib/text.py
index da11194c6427..ca9aca895f8f 100644
--- a/lib/matplotlib/text.py
+++ b/lib/matplotlib/text.py
@@ -80,17 +80,17 @@ def _get_text_metrics_with_cache_impl(
 @_docstring.interpd
 @_api.define_aliases({
     "color": ["c"],
-    "fontfamily": ["family"],
     "fontproperties": ["font", "font_properties"],
-    "horizontalalignment": ["ha"],
-    "multialignment": ["ma"],
+    "fontfamily": ["family"],
     "fontname": ["name"],
     "fontsize": ["size"],
     "fontstretch": ["stretch"],
     "fontstyle": ["style"],
     "fontvariant": ["variant"],
-    "verticalalignment": ["va"],
     "fontweight": ["weight"],
+    "horizontalalignment": ["ha"],
+    "verticalalignment": ["va"],
+    "multialignment": ["ma"],
 })
 class Text(Artist):
     """Handle storing and drawing of text in window or data coordinates."""

From 39c345c14aba34c3c769fa22368e9734f4797b03 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 1 Feb 2024 17:10:25 -0500
Subject: [PATCH 0693/1120] TST: Remove memory leak test

It is flaky, and our memory "limit" is pretty much arbitrary. Testing
with `tools/memleak.py` shows that memory usage generally rises and only
stabilizes close to 200 figures, while this test only does a warmup of
2 figures. Waiting for equilibrium would take too long for a general
test, so we might move this to a weekly job later.
---
 .../tests/test_backends_interactive.py        | 60 -------------------
 1 file changed, 60 deletions(-)

diff --git a/lib/matplotlib/tests/test_backends_interactive.py b/lib/matplotlib/tests/test_backends_interactive.py
index fb2457ba31b3..2464552d4b98 100644
--- a/lib/matplotlib/tests/test_backends_interactive.py
+++ b/lib/matplotlib/tests/test_backends_interactive.py
@@ -627,66 +627,6 @@ def test_blitting_events(env):
     assert 0 < ndraws < 5
 
 
-# The source of this function gets extracted and run in another process, so it
-# must be fully self-contained.
-def _test_figure_leak():
-    import gc
-    import sys
-
-    import psutil
-    from matplotlib import pyplot as plt
-    # Second argument is pause length, but if zero we should skip pausing
-    t = float(sys.argv[1])
-    p = psutil.Process()
-
-    # Warmup cycle, this reasonably allocates a lot
-    for _ in range(2):
-        fig = plt.figure()
-        if t:
-            plt.pause(t)
-        plt.close(fig)
-    mem = p.memory_info().rss
-    gc.collect()
-
-    for _ in range(5):
-        fig = plt.figure()
-        if t:
-            plt.pause(t)
-        plt.close(fig)
-        gc.collect()
-    growth = p.memory_info().rss - mem
-
-    print(growth)
-
-
-# TODO: "0.1" memory threshold could be reduced 10x by fixing tkagg
-@pytest.mark.skipif(sys.platform == "win32",
-                    reason="appveyor tests fail; gh-22988 suggests reworking")
-@pytest.mark.parametrize("env", _get_testable_interactive_backends())
-@pytest.mark.parametrize("time_mem", [(0.0, 2_000_000), (0.1, 30_000_000)])
-def test_figure_leak_20490(env, time_mem, request):
-    pytest.importorskip("psutil", reason="psutil needed to run this test")
-
-    # We haven't yet directly identified the leaks so test with a memory growth
-    # threshold.
-    pause_time, acceptable_memory_leakage = time_mem
-    if env["MPLBACKEND"] == "wx":
-        pytest.skip("wx backend is deprecated; tests failed on appveyor")
-
-    if env["MPLBACKEND"] == "macosx":
-        request.node.add_marker(pytest.mark.xfail(reason="macosx backend is leaky"))
-
-    if env["MPLBACKEND"] == "tkagg" and sys.platform == "darwin":
-        acceptable_memory_leakage += 11_000_000
-
-    result = _run_helper(
-        _test_figure_leak, str(pause_time),
-        timeout=_test_timeout, extra_env=env)
-
-    growth = int(result.stdout)
-    assert growth <= acceptable_memory_leakage
-
-
 def _impl_test_interactive_timers():
     # A timer with <1 millisecond gets converted to int and therefore 0
     # milliseconds, which the mac framework interprets as singleshot.

From 47c7f7d7c67df14e4de3372afe7758c2b1358c60 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Thu, 1 Feb 2024 15:26:18 -0500
Subject: [PATCH 0694/1120] Create explict rename legend entry section in guide

Co-authored-by: Ruth Comer <10599679+rcomer@users.noreply.github.com>

Co-authored-by: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
---
 galleries/users_explain/axes/legend_guide.py | 18 ++++++++++++++++--
 1 file changed, 16 insertions(+), 2 deletions(-)

diff --git a/galleries/users_explain/axes/legend_guide.py b/galleries/users_explain/axes/legend_guide.py
index 3cefb3f83e9a..f7771dcd0163 100644
--- a/galleries/users_explain/axes/legend_guide.py
+++ b/galleries/users_explain/axes/legend_guide.py
@@ -59,8 +59,11 @@
     line_down, = ax.plot([3, 2, 1], label='Line 1')
     ax.legend(handles=[line_up, line_down])
 
-In the rare case where the labels cannot directly be set on the handles, they
-can also be directly passed to :func:`legend`::
+Renaming legend entries
+-----------------------
+
+When the labels cannot directly be set on the handles, they can be directly passed to
+`.Axes.legend`::
 
     fig, ax = plt.subplots()
     line_up, = ax.plot([1, 2, 3], label='Line 2')
@@ -68,6 +71,17 @@
     ax.legend([line_up, line_down], ['Line Up', 'Line Down'])
 
 
+If the handles are not directly accessible, for example when using some
+`Third-party packages <https://matplotlib.org/mpl-third-party/>`_, they can be accessed
+via `.Axes.get_legend_handles_and_labels`. Here we use a dictionary to rename existing
+labels::
+
+    my_map = {'Line Up':'Up', 'Line Down':'Down'}
+
+    handles, labels = ax.get_legend_handles_labels()
+    ax.legend(handles, [my_map[l] for l in labels])
+
+
 .. _proxy_legend_handles:
 
 Creating artists specifically for adding to the legend (aka. Proxy artists)

From 7f23ee15f80c279100f5909ca1d681c575aeb23b Mon Sep 17 00:00:00 2001
From: UFEddy <eddy.rosales@ufl.edu>
Date: Fri, 29 Sep 2023 22:45:44 -0400
Subject: [PATCH 0695/1120] Remove deprecated register_cmap, unregister_cmap,
 and get_cmap

- deprecated cm api removal documentation
- Corrected formatting issues with documentation
- Removed corresponding type sub in related cm.pyi file and exceptions in mypy-stubtest
- Removed tests, updated documentation with code style for removed functions, moved code to pyplot from cm
- Revert "Removed tests, updated documentation with code style for removed functions, moved code to pyplot from cm"
  This reverts commit a8a4f7f022063a0feaf313c63d126e35e9b00481.
- Documetation updates to match code style for deprecated api's
- Removed tests for deprecated api's
- Corrected documentation with full path and verbiage on removals
- Removed handling of override builtin from ColorMaRegistry
---
 ci/mypy-stubtest-allowlist.txt                |   4 -
 .../next_api_changes/removals/26965-ER.rst    |  22 +++
 doc/api/prev_api_changes/api_changes_0.99.rst |   2 +-
 .../api_changes_3.2.0/behavior.rst            |   9 +-
 .../api_changes_3.3.0/deprecations.rst        |   2 +-
 .../api_changes_3.4.0/behaviour.rst           |   2 +-
 .../api_changes_3.6.0/behaviour.rst           |   8 +-
 .../api_changes_3.7.0/behaviour.rst           |   8 +-
 doc/users/prev_whats_new/whats_new_1.2.rst    |   2 +-
 doc/users/prev_whats_new/whats_new_3.4.0.rst  |   2 +-
 doc/users/prev_whats_new/whats_new_3.5.0.rst  |   6 +-
 galleries/examples/color/custom_cmap.py       |   2 +-
 lib/matplotlib/_cm.py                         |   2 +-
 lib/matplotlib/cm.py                          | 131 +-----------------
 lib/matplotlib/cm.pyi                         |   2 -
 lib/matplotlib/pyplot.py                      |  42 ++++--
 lib/matplotlib/tests/test_colors.py           |  68 +--------
 17 files changed, 77 insertions(+), 237 deletions(-)
 create mode 100644 doc/api/next_api_changes/removals/26965-ER.rst

diff --git a/ci/mypy-stubtest-allowlist.txt b/ci/mypy-stubtest-allowlist.txt
index 9f3efd283906..19fb0879b7a2 100644
--- a/ci/mypy-stubtest-allowlist.txt
+++ b/ci/mypy-stubtest-allowlist.txt
@@ -37,10 +37,6 @@ matplotlib.figure.Figure.set_constrained_layout
 matplotlib.figure.Figure.set_constrained_layout_pads
 matplotlib.figure.Figure.set_tight_layout
 
-# 3.7 deprecations
-matplotlib.cm.register_cmap
-matplotlib.cm.unregister_cmap
-
 # positional-only argument name lacking leading underscores
 matplotlib.axes._base._AxesBase.axis
 
diff --git a/doc/api/next_api_changes/removals/26965-ER.rst b/doc/api/next_api_changes/removals/26965-ER.rst
new file mode 100644
index 000000000000..b4ae71be3bff
--- /dev/null
+++ b/doc/api/next_api_changes/removals/26965-ER.rst
@@ -0,0 +1,22 @@
+Removal of top-level cmap registration and access functions in ``mpl.cm``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+As part of the `multi-step refactoring of colormap registration
+<https://github.com/matplotlib/matplotlib/issues/20853>`_, the following functions have
+been removed:
+
+- ``matplotlib.cm.get_cmap``; use ``matplotlib.colormaps[name]`` instead if you
+  have a `str`.
+
+  Use `matplotlib.cm.ColormapRegistry.get_cmap` if you have a `str`, `None` or a
+  `matplotlib.colors.Colormap` object that you want to convert to a `.Colormap`
+  object.
+- ``matplotlib.cm.register_cmap``; use `matplotlib.colormaps.register
+  <.ColormapRegistry.register>` instead.
+- ``matplotlib.cm.unregister_cmap``; use `matplotlib.colormaps.unregister
+  <.ColormapRegistry.unregister>` instead.
+- ``matplotlib.pyplot.register_cmap``; use `matplotlib.colormaps.register
+  <.ColormapRegistry.register>` instead.
+
+The `matplotlib.pyplot.get_cmap` function will stay available for backward
+compatibility.
diff --git a/doc/api/prev_api_changes/api_changes_0.99.rst b/doc/api/prev_api_changes/api_changes_0.99.rst
index 5d544eaec7f5..e03face0d075 100644
--- a/doc/api/prev_api_changes/api_changes_0.99.rst
+++ b/doc/api/prev_api_changes/api_changes_0.99.rst
@@ -7,7 +7,7 @@ Changes in 0.99
   NumPy arrays.
 
 * User-generated colormaps can now be added to the set recognized
-  by :func:`matplotlib.cm.get_cmap`.  Colormaps can be made the
+  by ``matplotlib.cm.get_cmap``.  Colormaps can be made the
   default and applied to the current image using
   :func:`matplotlib.pyplot.set_cmap`.
 
diff --git a/doc/api/prev_api_changes/api_changes_3.2.0/behavior.rst b/doc/api/prev_api_changes/api_changes_3.2.0/behavior.rst
index 407494bdb53f..6c1960c4dfaf 100644
--- a/doc/api/prev_api_changes/api_changes_3.2.0/behavior.rst
+++ b/doc/api/prev_api_changes/api_changes_3.2.0/behavior.rst
@@ -294,10 +294,11 @@ Exception changes
 ~~~~~~~~~~~~~~~~~
 Various APIs that raised a `ValueError` for incorrectly typed inputs now raise
 `TypeError` instead: `.backend_bases.GraphicsContextBase.set_clip_path`,
-``blocking_input.BlockingInput.__call__``, `.cm.register_cmap`, `.dviread.DviFont`,
-`.rcsetup.validate_hatch`, ``.rcsetup.validate_animation_writer_path``, `.spines.Spine`,
-many classes in the :mod:`matplotlib.transforms` module and :mod:`matplotlib.tri`
-package, and Axes methods that take a ``norm`` parameter.
+``blocking_input.BlockingInput.__call__``, ``matplotlib.cm.register_cmap``,
+`.dviread.DviFont`, `.rcsetup.validate_hatch`,
+``.rcsetup.validate_animation_writer_path``, `.spines.Spine`, many classes in
+the :mod:`matplotlib.transforms` module and :mod:`matplotlib.tri` package, and
+Axes methods that take a ``norm`` parameter.
 
 If extra kwargs are passed to `.LogScale`, `TypeError` will now be
 raised instead of `ValueError`.
diff --git a/doc/api/prev_api_changes/api_changes_3.3.0/deprecations.rst b/doc/api/prev_api_changes/api_changes_3.3.0/deprecations.rst
index d9d79adcfbd5..256c33ed762f 100644
--- a/doc/api/prev_api_changes/api_changes_3.3.0/deprecations.rst
+++ b/doc/api/prev_api_changes/api_changes_3.3.0/deprecations.rst
@@ -55,7 +55,7 @@ Please pass capstyles ("miter", "round", "bevel") and joinstyles ("butt",
 
 Passing raw data to ``register_cmap()``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Passing raw data via parameters *data* and *lut* to `.register_cmap()` is
+Passing raw data via parameters *data* and *lut* to ``matplotlib.cm.register_cmap()`` is
 deprecated. Instead, explicitly create a `.LinearSegmentedColormap` and pass
 it via the *cmap* parameter:
 ``register_cmap(cmap=LinearSegmentedColormap(name, data, lut))``.
diff --git a/doc/api/prev_api_changes/api_changes_3.4.0/behaviour.rst b/doc/api/prev_api_changes/api_changes_3.4.0/behaviour.rst
index df08097dba03..e35301c11986 100644
--- a/doc/api/prev_api_changes/api_changes_3.4.0/behaviour.rst
+++ b/doc/api/prev_api_changes/api_changes_3.4.0/behaviour.rst
@@ -203,7 +203,7 @@ time, not at draw time.
 Raise or warn on registering a colormap twice
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-When using `matplotlib.cm.register_cmap` to register a user provided or
+When using ``matplotlib.cm.register_cmap`` to register a user provided or
 third-party colormap it will now raise a `ValueError` if trying to over-write
 one of the built in colormaps and warn if trying to over write a user
 registered colormap. This may raise for user-registered colormaps in the
diff --git a/doc/api/prev_api_changes/api_changes_3.6.0/behaviour.rst b/doc/api/prev_api_changes/api_changes_3.6.0/behaviour.rst
index a35584b04961..91802692ebb4 100644
--- a/doc/api/prev_api_changes/api_changes_3.6.0/behaviour.rst
+++ b/doc/api/prev_api_changes/api_changes_3.6.0/behaviour.rst
@@ -4,10 +4,10 @@ Behaviour changes
 ``plt.get_cmap`` and ``matplotlib.cm.get_cmap`` return a copy
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Formerly, `~.pyplot.get_cmap` and `.cm.get_cmap` returned a global version of a
-`.Colormap`. This was prone to errors as modification of the colormap would
-propagate from one location to another without warning. Now, a new copy of the
-colormap is returned.
+Formerly, `~.pyplot.get_cmap` and ``matplotlib.cm.get_cmap`` returned a global version
+of a `.Colormap`. This was prone to errors as modification of the colormap would
+propagate from one location to another without warning. Now, a new copy of the colormap
+is returned.
 
 Large ``imshow`` images are now downsampled
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/doc/api/prev_api_changes/api_changes_3.7.0/behaviour.rst b/doc/api/prev_api_changes/api_changes_3.7.0/behaviour.rst
index a4fd8b57e419..2425087c6175 100644
--- a/doc/api/prev_api_changes/api_changes_3.7.0/behaviour.rst
+++ b/doc/api/prev_api_changes/api_changes_3.7.0/behaviour.rst
@@ -20,10 +20,10 @@ also be based on ``mpl_toolkits.axisartist``.  This behavior is consistent with
 ``plt.get_cmap`` and ``matplotlib.cm.get_cmap`` return a copy
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Formerly, `~.pyplot.get_cmap` and `.cm.get_cmap` returned a global version of a
-`.Colormap`. This was prone to errors as modification of the colormap would
-propagate from one location to another without warning. Now, a new copy of the
-colormap is returned.
+Formerly, `~.pyplot.get_cmap` and ``matplotlib.cm.get_cmap`` returned a global version
+of a `.Colormap`. This was prone to errors as modification of the colormap would
+propagate from one location to another without warning. Now, a new copy of the colormap
+is returned.
 
 ``TrapezoidMapTriFinder`` uses different random number generator
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/doc/users/prev_whats_new/whats_new_1.2.rst b/doc/users/prev_whats_new/whats_new_1.2.rst
index 260941d1ca9e..43c729999d5b 100644
--- a/doc/users/prev_whats_new/whats_new_1.2.rst
+++ b/doc/users/prev_whats_new/whats_new_1.2.rst
@@ -86,7 +86,7 @@ minimum and maximum colorbar extensions.
     Z = np.cos(X) * np.sin(0.5*Y)
 
     clevs = [-.75, -.5, -.25, 0., .25, .5, .75]
-    cmap = plt.cm.get_cmap(name='jet', lut=8)
+    cmap = plt.get_cmap(name='jet', lut=8)
 
     ax1 = plt.subplot(211)
     cs1 = plt.contourf(x, y, Z, clevs, cmap=cmap, extend='both')
diff --git a/doc/users/prev_whats_new/whats_new_3.4.0.rst b/doc/users/prev_whats_new/whats_new_3.4.0.rst
index e26a7c70d253..003cd85fa49d 100644
--- a/doc/users/prev_whats_new/whats_new_3.4.0.rst
+++ b/doc/users/prev_whats_new/whats_new_3.4.0.rst
@@ -547,7 +547,7 @@ for out-of-range and masked values.
 New ``cm.unregister_cmap`` function
 -----------------------------------
 
-`.cm.unregister_cmap` allows users to remove a colormap that they have
+``matplotlib.cm.unregister_cmap`` allows users to remove a colormap that they have
 previously registered.
 
 New ``CenteredNorm`` for symmetrical data around a center
diff --git a/doc/users/prev_whats_new/whats_new_3.5.0.rst b/doc/users/prev_whats_new/whats_new_3.5.0.rst
index 5a55cff17d02..e67573702218 100644
--- a/doc/users/prev_whats_new/whats_new_3.5.0.rst
+++ b/doc/users/prev_whats_new/whats_new_3.5.0.rst
@@ -148,9 +148,9 @@ To register new colormaps use::
 
     plt.colormaps.register(my_colormap)
 
-We recommend to use the new API instead of the `~.cm.get_cmap` and
-`~.cm.register_cmap` functions for new code. `matplotlib.cm.get_cmap` and
-`matplotlib.cm.register_cmap` will eventually be deprecated and removed.
+We recommend to use the new API instead of the ``matplotlib.cm.get_cmap`` and
+``matplotlib.cm.register_cmap`` functions for new code. ``matplotlib.cm.get_cmap`` and
+``matplotlib.cm.register_cmap`` will eventually be deprecated and removed.
 Within `.pyplot`, ``plt.get_cmap()`` and ``plt.register_cmap()`` will continue
 to be supported for backward compatibility.
 
diff --git a/galleries/examples/color/custom_cmap.py b/galleries/examples/color/custom_cmap.py
index ea3c06e13cac..667dc3133819 100644
--- a/galleries/examples/color/custom_cmap.py
+++ b/galleries/examples/color/custom_cmap.py
@@ -279,4 +279,4 @@
 #    - `matplotlib.colors.LinearSegmentedColormap.from_list`
 #    - `matplotlib.cm`
 #    - `matplotlib.cm.ScalarMappable.set_cmap`
-#    - `matplotlib.cm.register_cmap`
+#    - `matplotlib.cm.ColormapRegistry.register`
diff --git a/lib/matplotlib/_cm.py b/lib/matplotlib/_cm.py
index 1f1c36ac3240..59d260107f3b 100644
--- a/lib/matplotlib/_cm.py
+++ b/lib/matplotlib/_cm.py
@@ -66,7 +66,7 @@ def _ch_helper(gamma, s, r, h, p0, p1, x):
 def cubehelix(gamma=1.0, s=0.5, r=-1.5, h=1.0):
     """
     Return custom data dictionary of (r, g, b) conversion functions, which can
-    be used with :func:`register_cmap`, for the cubehelix color scheme.
+    be used with `.ColormapRegistry.register`, for the cubehelix color scheme.
 
     Unlike most other color schemes cubehelix was designed by D.A. Green to
     be monotonically increasing in terms of perceived brightness.
diff --git a/lib/matplotlib/cm.py b/lib/matplotlib/cm.py
index 53c60c8a8883..7e46cf567f70 100644
--- a/lib/matplotlib/cm.py
+++ b/lib/matplotlib/cm.py
@@ -83,8 +83,6 @@ class ColormapRegistry(Mapping):
     def __init__(self, cmaps):
         self._cmaps = cmaps
         self._builtin_cmaps = tuple(cmaps)
-        # A shim to allow register_cmap() to force an override
-        self._allow_override_builtin = False
 
     def __getitem__(self, item):
         try:
@@ -146,10 +144,8 @@ def register(self, cmap, *, name=None, force=False):
                 # unless explicitly asked to
                 raise ValueError(
                     f'A colormap named "{name}" is already registered.')
-            elif (name in self._builtin_cmaps
-                    and not self._allow_override_builtin):
-                # We don't allow overriding a builtin unless privately
-                # coming from register_cmap()
+            elif name in self._builtin_cmaps:
+                # We don't allow overriding a builtin.
                 raise ValueError("Re-registering the builtin cmap "
                                  f"{name!r} is not allowed.")
 
@@ -236,129 +232,6 @@ def get_cmap(self, cmap):
 globals().update(_colormaps)
 
 
-@_api.deprecated("3.7", alternative="``matplotlib.colormaps.register(name)``")
-def register_cmap(name=None, cmap=None, *, override_builtin=False):
-    """
-    Add a colormap to the set recognized by :func:`get_cmap`.
-
-    Register a new colormap to be accessed by name ::
-
-        LinearSegmentedColormap('swirly', data, lut)
-        register_cmap(cmap=swirly_cmap)
-
-    Parameters
-    ----------
-    name : str, optional
-       The name that can be used in :func:`get_cmap` or :rc:`image.cmap`
-
-       If absent, the name will be the :attr:`~matplotlib.colors.Colormap.name`
-       attribute of the *cmap*.
-
-    cmap : matplotlib.colors.Colormap
-       Despite being the second argument and having a default value, this
-       is a required argument.
-
-    override_builtin : bool
-
-        Allow built-in colormaps to be overridden by a user-supplied
-        colormap.
-
-        Please do not use this unless you are sure you need it.
-    """
-    _api.check_isinstance((str, None), name=name)
-    if name is None:
-        try:
-            name = cmap.name
-        except AttributeError as err:
-            raise ValueError("Arguments must include a name or a "
-                             "Colormap") from err
-    # override_builtin is allowed here for backward compatibility
-    # this is just a shim to enable that to work privately in
-    # the global ColormapRegistry
-    _colormaps._allow_override_builtin = override_builtin
-    _colormaps.register(cmap, name=name, force=override_builtin)
-    _colormaps._allow_override_builtin = False
-
-
-def _get_cmap(name=None, lut=None):
-    """
-    Get a colormap instance, defaulting to rc values if *name* is None.
-
-    Parameters
-    ----------
-    name : `~matplotlib.colors.Colormap` or str or None, default: None
-        If a `.Colormap` instance, it will be returned. Otherwise, the name of
-        a colormap known to Matplotlib, which will be resampled by *lut*. The
-        default, None, means :rc:`image.cmap`.
-    lut : int or None, default: None
-        If *name* is not already a Colormap instance and *lut* is not None, the
-        colormap will be resampled to have *lut* entries in the lookup table.
-
-    Returns
-    -------
-    Colormap
-    """
-    if name is None:
-        name = mpl.rcParams['image.cmap']
-    if isinstance(name, colors.Colormap):
-        return name
-    _api.check_in_list(sorted(_colormaps), name=name)
-    if lut is None:
-        return _colormaps[name]
-    else:
-        return _colormaps[name].resampled(lut)
-
-# do it in two steps like this so we can have an un-deprecated version in
-# pyplot.
-get_cmap = _api.deprecated(
-    '3.7',
-    name='get_cmap',
-    alternative=(
-        "``matplotlib.colormaps[name]`` " +
-        "or ``matplotlib.colormaps.get_cmap(obj)``"
-    )
-)(_get_cmap)
-
-
-@_api.deprecated("3.7",
-                 alternative="``matplotlib.colormaps.unregister(name)``")
-def unregister_cmap(name):
-    """
-    Remove a colormap recognized by :func:`get_cmap`.
-
-    You may not remove built-in colormaps.
-
-    If the named colormap is not registered, returns with no error, raises
-    if you try to de-register a default colormap.
-
-    .. warning::
-
-      Colormap names are currently a shared namespace that may be used
-      by multiple packages. Use `unregister_cmap` only if you know you
-      have registered that name before. In particular, do not
-      unregister just in case to clean the name before registering a
-      new colormap.
-
-    Parameters
-    ----------
-    name : str
-        The name of the colormap to be un-registered
-
-    Returns
-    -------
-    ColorMap or None
-        If the colormap was registered, return it if not return `None`
-
-    Raises
-    ------
-    ValueError
-       If you try to de-register a default built-in colormap.
-    """
-    cmap = _colormaps.get(name, None)
-    _colormaps.unregister(name)
-    return cmap
-
-
 def _auto_norm_from_scale(scale_cls):
     """
     Automatically generate a norm class from *scale_cls*.
diff --git a/lib/matplotlib/cm.pyi b/lib/matplotlib/cm.pyi
index be8f10b39cb6..da78d940ba4a 100644
--- a/lib/matplotlib/cm.pyi
+++ b/lib/matplotlib/cm.pyi
@@ -19,8 +19,6 @@ class ColormapRegistry(Mapping[str, colors.Colormap]):
 
 _colormaps: ColormapRegistry = ...
 
-def get_cmap(name: str | colors.Colormap | None = ..., lut: int | None = ...) -> colors.Colormap: ...
-
 class ScalarMappable:
     cmap: colors.Colormap | None
     colorbar: Colorbar | None
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 2c1403900529..18cee79d55b9 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -74,8 +74,7 @@
 from matplotlib.scale import get_scale_names  # noqa: F401
 
 from matplotlib.cm import _colormaps
-from matplotlib.cm import register_cmap  # type: ignore # noqa: F401
-from matplotlib.colors import _color_sequences
+from matplotlib.colors import _color_sequences, Colormap
 
 import numpy as np
 
@@ -104,7 +103,6 @@
         QuadMesh,
     )
     from matplotlib.colorbar import Colorbar
-    from matplotlib.colors import Colormap
     from matplotlib.container import (
         BarContainer,
         ErrorbarContainer,
@@ -2362,14 +2360,33 @@ def clim(vmin: float | None = None, vmax: float | None = None) -> None:
     im.set_clim(vmin, vmax)
 
 
-# eventually this implementation should move here, use indirection for now to
-# avoid having two copies of the code floating around.
-def get_cmap(
-    name: Colormap | str | None = None,
-    lut: int | None = None
-) -> Colormap:
-    return cm._get_cmap(name=name, lut=lut)  # type: ignore
-get_cmap.__doc__ = cm._get_cmap.__doc__  # type: ignore
+def get_cmap(name: Colormap | str | None = None, lut: int | None = None) -> Colormap:
+    """
+    Get a colormap instance, defaulting to rc values if *name* is None.
+
+    Parameters
+    ----------
+    name : `~matplotlib.colors.Colormap` or str or None, default: None
+        If a `.Colormap` instance, it will be returned. Otherwise, the name of
+        a colormap known to Matplotlib, which will be resampled by *lut*. The
+        default, None, means :rc:`image.cmap`.
+    lut : int or None, default: None
+        If *name* is not already a Colormap instance and *lut* is not None, the
+        colormap will be resampled to have *lut* entries in the lookup table.
+
+    Returns
+    -------
+    Colormap
+    """
+    if name is None:
+        name = rcParams['image.cmap']
+    if isinstance(name, Colormap):
+        return name
+    _api.check_in_list(sorted(_colormaps), name=name)
+    if lut is None:
+        return _colormaps[name]
+    else:
+        return _colormaps[name].resampled(lut)
 
 
 def set_cmap(cmap: Colormap | str) -> None:
@@ -2384,8 +2401,7 @@ def set_cmap(cmap: Colormap | str) -> None:
     See Also
     --------
     colormaps
-    matplotlib.cm.register_cmap
-    matplotlib.cm.get_cmap
+    get_cmap
     """
     cmap = get_cmap(cmap)
 
diff --git a/lib/matplotlib/tests/test_colors.py b/lib/matplotlib/tests/test_colors.py
index f23c8c143b7c..2d71fea83472 100644
--- a/lib/matplotlib/tests/test_colors.py
+++ b/lib/matplotlib/tests/test_colors.py
@@ -1,7 +1,6 @@
 import copy
 import itertools
 import unittest.mock
-from packaging.version import parse as parse_version
 
 from io import BytesIO
 import numpy as np
@@ -73,51 +72,6 @@ def test_resampled():
     assert_array_almost_equal(lc(np.nan), lc3(np.nan))
 
 
-def test_register_cmap():
-    new_cm = mpl.colormaps["viridis"]
-    target = "viridis2"
-    with pytest.warns(
-            mpl.MatplotlibDeprecationWarning,
-            match=r"matplotlib\.colormaps\.register\(name\)"
-    ):
-        cm.register_cmap(target, new_cm)
-    assert mpl.colormaps[target] == new_cm
-
-    with pytest.raises(ValueError,
-                       match="Arguments must include a name or a Colormap"):
-        with pytest.warns(
-            mpl.MatplotlibDeprecationWarning,
-            match=r"matplotlib\.colormaps\.register\(name\)"
-        ):
-            cm.register_cmap()
-
-    with pytest.warns(
-            mpl.MatplotlibDeprecationWarning,
-            match=r"matplotlib\.colormaps\.unregister\(name\)"
-    ):
-        cm.unregister_cmap(target)
-    with pytest.raises(ValueError,
-                       match=f'{target!r} is not a valid value for name;'):
-        with pytest.warns(
-                mpl.MatplotlibDeprecationWarning,
-                match=r"matplotlib\.colormaps\[name\]"
-        ):
-            cm.get_cmap(target)
-    with pytest.warns(
-            mpl.MatplotlibDeprecationWarning,
-            match=r"matplotlib\.colormaps\.unregister\(name\)"
-    ):
-        # test that second time is error free
-        cm.unregister_cmap(target)
-
-    with pytest.raises(TypeError, match="'cmap' must be"):
-        with pytest.warns(
-            mpl.MatplotlibDeprecationWarning,
-            match=r"matplotlib\.colormaps\.register\(name\)"
-        ):
-            cm.register_cmap('nome', cmap='not a cmap')
-
-
 def test_colormaps_get_cmap():
     cr = mpl.colormaps
 
@@ -142,27 +96,7 @@ def test_double_register_builtin_cmap():
     name = "viridis"
     match = f"Re-registering the builtin cmap {name!r}."
     with pytest.raises(ValueError, match=match):
-        matplotlib.colormaps.register(
-            mpl.colormaps[name], name=name, force=True
-        )
-    with pytest.raises(ValueError, match='A colormap named "viridis"'):
-        with pytest.warns(mpl.MatplotlibDeprecationWarning):
-            cm.register_cmap(name, mpl.colormaps[name])
-
-    if parse_version(pytest.__version__).major < 8:
-        with pytest.warns(UserWarning):
-            cm.register_cmap(name, mpl.colormaps[name], override_builtin=True)
-    else:
-        with pytest.warns(UserWarning), pytest.warns(mpl.MatplotlibDeprecationWarning):
-            cm.register_cmap(name, mpl.colormaps[name], override_builtin=True)
-
-
-def test_unregister_builtin_cmap():
-    name = "viridis"
-    match = f'cannot unregister {name!r} which is a builtin colormap.'
-    with pytest.raises(ValueError, match=match):
-        with pytest.warns(mpl.MatplotlibDeprecationWarning):
-            cm.unregister_cmap(name)
+        matplotlib.colormaps.register(mpl.colormaps[name], name=name, force=True)
 
 
 def test_colormap_copy():

From f90c0da7279b2241a916e89f932551d874fbe8be Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 1 Feb 2024 20:50:50 -0500
Subject: [PATCH 0696/1120] ci: Simplify CodeQL setup

The workflow is now warning that `CODEQL_PYTHON` should not be set, as
it is no longer used. According to the message, we also don't need to
install dependencies, so fold everything into the 'build-for-C++' step.
---
 .github/workflows/codeql-analysis.yml | 26 ++++----------------------
 1 file changed, 4 insertions(+), 22 deletions(-)

diff --git a/.github/workflows/codeql-analysis.yml b/.github/workflows/codeql-analysis.yml
index 5950597a383f..29d2859999bd 100644
--- a/.github/workflows/codeql-analysis.yml
+++ b/.github/workflows/codeql-analysis.yml
@@ -22,30 +22,12 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        language: ['cpp', 'javascript', 'python']
+        language: ['c-cpp', 'javascript', 'python']
 
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
 
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        if: matrix.language != 'javascript'
-        with:
-          python-version: '3.x'
-      - name: Install dependencies
-        if: matrix.language != 'javascript'
-        run: |
-          python -m pip install --upgrade pip setuptools wheel
-          # TODO: Use pip-tools instead when it supports build-system
-          # dependencies so we don't need another copy here.
-          # https://github.com/jazzband/pip-tools/pull/1681
-          python -m pip install --upgrade \
-            build contourpy cycler fonttools kiwisolver \
-            importlib_resources meson-python numpy packaging pillow pybind11 \
-            pyparsing python-dateutil setuptools-scm
-          echo "CODEQL_PYTHON=$(which python)" >> $GITHUB_ENV
-
       - name: Initialize CodeQL
         uses: github/codeql-action/init@v3
         with:
@@ -53,10 +35,10 @@ jobs:
           setup-python-dependencies: false
 
       - name: Build compiled code
-        if: matrix.language == 'cpp'
+        if: matrix.language == 'c-cpp'
         run: |
-          mkdir ~/.cache/matplotlib
-          $CODEQL_PYTHON -m build
+          pip install --user --upgrade pip
+          pip install --user -v .
 
       - name: Perform CodeQL Analysis
         uses: github/codeql-action/analyze@v3

From 80c097c42b61cae5964982e73d1ff03667ea90f9 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Fri, 2 Feb 2024 11:49:45 +0100
Subject: [PATCH 0697/1120] Fix incorrect API reference in docs

---
 galleries/users_explain/axes/legend_guide.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/galleries/users_explain/axes/legend_guide.py b/galleries/users_explain/axes/legend_guide.py
index f7771dcd0163..2ddf3e757850 100644
--- a/galleries/users_explain/axes/legend_guide.py
+++ b/galleries/users_explain/axes/legend_guide.py
@@ -73,7 +73,7 @@
 
 If the handles are not directly accessible, for example when using some
 `Third-party packages <https://matplotlib.org/mpl-third-party/>`_, they can be accessed
-via `.Axes.get_legend_handles_and_labels`. Here we use a dictionary to rename existing
+via `.Axes.get_legend_handles_labels`. Here we use a dictionary to rename existing
 labels::
 
     my_map = {'Line Up':'Up', 'Line Down':'Down'}

From cca84fcdfdb2d007eeebb7c003502cf0eaea72b9 Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Fri, 26 Jan 2024 20:20:42 +0000
Subject: [PATCH 0698/1120] DOC: update colors from colormaps example [ci doc]

---
 .flake8                                       |  1 -
 .../color/individual_colors_from_cmap.py      | 46 ++++++++++---------
 2 files changed, 25 insertions(+), 22 deletions(-)

diff --git a/.flake8 b/.flake8
index bfb5bb29b0e9..40c07e0e324b 100644
--- a/.flake8
+++ b/.flake8
@@ -63,7 +63,6 @@ per-file-ignores =
     galleries/users_explain/text/text_props.py: E501
 
     galleries/examples/animation/frame_grabbing_sgskip.py: E402
-    galleries/examples/color/individual_colors_from_cmap.py: E402
     galleries/examples/images_contours_and_fields/tricontour_demo.py: E201
     galleries/examples/images_contours_and_fields/tripcolor_demo.py: E201
     galleries/examples/images_contours_and_fields/triplot_demo.py: E201
diff --git a/galleries/examples/color/individual_colors_from_cmap.py b/galleries/examples/color/individual_colors_from_cmap.py
index 572fb33e6f11..1a14bd6b2ae1 100644
--- a/galleries/examples/color/individual_colors_from_cmap.py
+++ b/galleries/examples/color/individual_colors_from_cmap.py
@@ -7,50 +7,54 @@
 cycle provides. Selecting individual colors from one of the provided colormaps can be a
 convenient way to do this.
 
-Once we have hold of a `.Colormap` instance, the individual colors can be accessed
-by passing it an index.  If we want a specific number of colors taken at regular
-intervals from a continuous colormap, we can create a new colormap using the
-`~.Colormap.resampled` method.
+We can retrieve colors from any `.Colormap` by calling it with a float or a list of
+floats in the range [0, 1]; e.g. ``cmap(0.5)`` will give the middle color. See also
+`.Colormap.__call__`.
 
-For more details about manipulating colormaps, see :ref:`colormap-manipulation`.
+Extracting colors from a continuous colormap
+--------------------------------------------
 """
 
 import matplotlib.pyplot as plt
+import numpy as np
 
 import matplotlib as mpl
 
 n_lines = 21
+cmap = mpl.colormaps['plasma']
 
-cmap = mpl.colormaps.get_cmap('plasma').resampled(n_lines)
+# Take colors at regular intervals spanning the colormap.
+colors = cmap(np.linspace(0, 1, n_lines))
 
 fig, ax = plt.subplots(layout='constrained')
 
-for i in range(n_lines):
-    ax.plot([0, i], color=cmap(i))
+for i, color in enumerate(colors):
+    ax.plot([0, i], color=color)
 
 plt.show()
 
 # %%
-# Instead of passing colors one by one to `~.Axes.plot`, we can replace the default
-# color cycle with a different set of colors.  Specifying a `~cycler.cycler` instance
-# within `.rcParams` achieves that.  See :ref:`color_cycle` for details.
-
-
-from cycler import cycler
-
-cmap = mpl.colormaps.get_cmap('Dark2')
-colors = cmap(range(cmap.N))  # cmap.N is number of unique colors in the colormap
+#
+# Extracting colors from a discrete colormap
+# ------------------------------------------
+# The list of all colors in a `.ListedColormap` is available as the ``colors``
+# attribute.
 
-with mpl.rc_context({'axes.prop_cycle': cycler(color=colors)}):
+colors = mpl.colormaps['Dark2'].colors
 
-    fig, ax = plt.subplots(layout='constrained')
+fig, ax = plt.subplots(layout='constrained')
 
-    for i in range(n_lines):
-        ax.plot([0, i])
+for i, color in enumerate(colors):
+    ax.plot([0, i], color=color)
 
 plt.show()
 
 # %%
+# See Also
+# --------
+#
+# For more details about manipulating colormaps, see :ref:`colormap-manipulation`.  To
+# change the default color cycle, see :ref:`color_cycle`.
 #
 # .. admonition:: References
 #

From 2aaaf95e740b6110407d8310327173a63716d94c Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Wed, 10 Jan 2024 13:00:05 -0500
Subject: [PATCH 0699/1120] updated doc/readme.txt to current layout deleted
 doc/devel/readme.txt because gitwash is no longer used

Co-authored-by: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
---
 doc/README.txt       | 61 ++++++++++++++++++++++++++++++--------------
 doc/devel/README.txt |  9 -------
 2 files changed, 42 insertions(+), 28 deletions(-)
 delete mode 100644 doc/devel/README.txt

diff --git a/doc/README.txt b/doc/README.txt
index 0caf5e013c9b..c34dbd769712 100644
--- a/doc/README.txt
+++ b/doc/README.txt
@@ -9,35 +9,58 @@ See :file:`doc/devel/documenting_mpl.rst` for instructions to build the docs.
 Organization
 ------------
 
-This is the top level build directory for the Matplotlib
-documentation.  All of the documentation is written using sphinx, a
-python documentation system built on top of ReST.  This directory contains
+This is the top level directory for the Matplotlib
+documentation.  All of the documentation is written using Sphinx, a
+python documentation system based on reStructuredText.  This directory contains the
+following
 
-* users - the user documentation, e.g., installation, plotting tutorials,
-configuration tips, faq, explanations, etc.
+Files
+^^^^^
 
-* devel - documentation for Matplotlib developers
+* index.rst - the top level include document (and landing page) for the Matplotlib docs
 
-* api - placeholders to automatically generate the api documentation
+* conf.py - the sphinx configuration
 
-* tutorials, plot_types, and gallery - automatically
-generated by sphinx-gallery from ``../tutorials``, ``../plot_types``, and
-``../examples`` respectively (these are only present if docs have been
-built locally).
+* docutils.conf - htmnl output configuration
 
-* thirdpartypackages - redirect to <https://matplotlib.org/mpl-third-party/>
+* Makefile and make.bat - entry points for building the docs
 
-* mpl_toolkits - documentation of individual toolkits that ship with
-  Matplotlib
+* matplotlibrc - rcParam configuration for docs
 
-* index.rst - the top level include document for Matplotlib docs
+* missing-references.json - list of known missing/broken references
 
-* conf.py - the sphinx configuration
 
-* Makefile and make.bat - entry points for building the docs
+Content folders
+^^^^^^^^^^^^^^^
+
+* api - templates for generating the api documentation
 
-* _static - used by the sphinx build system
+* devel - documentation for contributing to Matplotlib
 
-* _templates - used by the sphinx build system
+* project - about Matplotlib, e.g. mission, code of conduct, licenses, history, etc.
+
+* users - usage documentation, e.g., installation, tutorials, faq, explanations, etc.
+
+* thirdpartypackages - redirect to <https://matplotlib.org/mpl-third-party/>
+
+Build folders
+^^^^^^^^^^^^^
+
+* _static - supplementary files; e.g. images, CSS, etc.
+
+* _templates - Sphinx page templates
 
 * sphinxext - Sphinx extensions for the Matplotlib docs
+
+Symlinks
+--------
+
+During the documentation build, sphinx-gallery creates symlinks from the source folders
+in `/galleries` to target_folders in '/doc'; therefore ensure that you are editing the
+real files rather than the symbolic links.
+
+Source files -> symlink:
+* galleries/tutorials -> doc/tutorials
+* galleries/plot_types -> doc/plot_types
+* galleries/examples -> doc/gallery
+* galleries/users_explain -> doc/users/explain
diff --git a/doc/devel/README.txt b/doc/devel/README.txt
deleted file mode 100644
index d7636cd4c37c..000000000000
--- a/doc/devel/README.txt
+++ /dev/null
@@ -1,9 +0,0 @@
-All documentation in the gitwash directory are automatically generated by running the gitwash_dumper.py
-script in the project's root directory using the following parameters:
-
-python gitwash_dumper.py doc/devel Matplotlib --repo-name=matplotlib --github-user=matplotlib \
-   --project-url=https://matplotlib.org \
-   --project-ml-url=https://mail.python.org/mailman/listinfo/matplotlib-devel
-
-The script is hosted at https://raw.githubusercontent.com/matthew-brett/gitwash/master/gitwash_dumper.py.
-For more information please visit https://github.com/matthew-brett/gitwash

From c144ab881be5c7a6984e231e9af36fbc7b8d235b Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 5 Feb 2024 19:15:37 +0000
Subject: [PATCH 0700/1120] Bump the actions group with 2 updates

Bumps the actions group with 2 updates: [pypa/cibuildwheel](https://github.com/pypa/cibuildwheel) and [codecov/codecov-action](https://github.com/codecov/codecov-action).


Updates `pypa/cibuildwheel` from 2.16.4 to 2.16.5
- [Release notes](https://github.com/pypa/cibuildwheel/releases)
- [Changelog](https://github.com/pypa/cibuildwheel/blob/main/docs/changelog.md)
- [Commits](https://github.com/pypa/cibuildwheel/compare/0b04ab1040366101259658b355777e4ff2d16f83...ce3fb7832089eb3e723a0a99cab7f3eaccf074fd)

Updates `codecov/codecov-action` from 3 to 4
- [Release notes](https://github.com/codecov/codecov-action/releases)
- [Changelog](https://github.com/codecov/codecov-action/blob/main/CHANGELOG.md)
- [Commits](https://github.com/codecov/codecov-action/compare/v3...v4)

---
updated-dependencies:
- dependency-name: pypa/cibuildwheel
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: actions
- dependency-name: codecov/codecov-action
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: actions
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 .github/workflows/cibuildwheel.yml | 10 +++++-----
 .github/workflows/cygwin.yml       |  2 +-
 .github/workflows/tests.yml        |  2 +-
 3 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index f3f5f5e9e6f3..903870f6e86e 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -146,7 +146,7 @@ jobs:
           path: dist/
 
       - name: Build wheels for CPython 3.12
-        uses: pypa/cibuildwheel@0b04ab1040366101259658b355777e4ff2d16f83 # v2.16.4
+        uses: pypa/cibuildwheel@ce3fb7832089eb3e723a0a99cab7f3eaccf074fd # v2.16.5
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -154,7 +154,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.11
-        uses: pypa/cibuildwheel@0b04ab1040366101259658b355777e4ff2d16f83 # v2.16.4
+        uses: pypa/cibuildwheel@ce3fb7832089eb3e723a0a99cab7f3eaccf074fd # v2.16.5
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -162,7 +162,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.10
-        uses: pypa/cibuildwheel@0b04ab1040366101259658b355777e4ff2d16f83 # v2.16.4
+        uses: pypa/cibuildwheel@ce3fb7832089eb3e723a0a99cab7f3eaccf074fd # v2.16.5
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -170,7 +170,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.9
-        uses: pypa/cibuildwheel@0b04ab1040366101259658b355777e4ff2d16f83 # v2.16.4
+        uses: pypa/cibuildwheel@ce3fb7832089eb3e723a0a99cab7f3eaccf074fd # v2.16.5
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -178,7 +178,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for PyPy
-        uses: pypa/cibuildwheel@0b04ab1040366101259658b355777e4ff2d16f83 # v2.16.4
+        uses: pypa/cibuildwheel@ce3fb7832089eb3e723a0a99cab7f3eaccf074fd # v2.16.5
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
diff --git a/.github/workflows/cygwin.yml b/.github/workflows/cygwin.yml
index 4adb29dde46d..06d90d4cecbd 100644
--- a/.github/workflows/cygwin.yml
+++ b/.github/workflows/cygwin.yml
@@ -247,4 +247,4 @@ jobs:
             --cov-report=xml --cov=lib --log-level=DEBUG --color=yes
 
       - name: Upload code coverage
-        uses: codecov/codecov-action@v3
+        uses: codecov/codecov-action@v4
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index f2c6b4ef853d..412621f3b6ee 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -337,7 +337,7 @@ jobs:
           fi
       - name: Upload code coverage
         if: ${{ github.event_name != 'schedule' }}
-        uses: codecov/codecov-action@v3
+        uses: codecov/codecov-action@v4
         with:
           name: "${{ matrix.python-version }} ${{ matrix.os }} ${{ matrix.name-suffix }}"
 

From ffa455615689457f6729b542d05ce5c6ba0f4799 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 1 Feb 2024 05:00:18 -0500
Subject: [PATCH 0701/1120] DOC: Improve colormap normalization example

- Turn each norm into a headed section.
- Link to each norm directly in text.
- Consistently use `Z` as data variable, and pass norms (or `vmin`) in
  the same order for every example.
- Label the colour bars.
- Tweak some descriptions to be clearer.
- Change data for SymLogNorm and use it for the custom norm and
  BoundaryNorm, in order to match their descriptions.
---
 .../colormap_normalizations.py                | 153 +++++++++---------
 1 file changed, 81 insertions(+), 72 deletions(-)

diff --git a/galleries/examples/images_contours_and_fields/colormap_normalizations.py b/galleries/examples/images_contours_and_fields/colormap_normalizations.py
index 40fa620df7b3..1d81336b4964 100644
--- a/galleries/examples/images_contours_and_fields/colormap_normalizations.py
+++ b/galleries/examples/images_contours_and_fields/colormap_normalizations.py
@@ -13,85 +13,90 @@
 
 import matplotlib.colors as colors
 
-# %%
-# Lognorm: Instead of pcolor log10(Z1) you can have colorbars that have
-# the exponential labels using a norm.
-
 N = 100
-X, Y = np.mgrid[-3:3:complex(0, N), -2:2:complex(0, N)]
 
-# A low hump with a spike coming out of the top.  Needs to have
-# z/colour axis on a log scale, so we see both hump and spike.
-# A linear scale only shows the spike.
+# %%
+# LogNorm
+# -------
+# This example data has a low hump with a spike coming out of its center. If plotted
+# using a linear colour scale, then only the spike will be visible. To see both hump and
+# spike, this requires the z/colour axis on a log scale.
+#
+# Instead of transforming the data with ``pcolor(log10(Z))``, the color mapping can be
+# made logarithmic using a `.LogNorm`.
 
+X, Y = np.mgrid[-3:3:complex(0, N), -2:2:complex(0, N)]
 Z1 = np.exp(-X**2 - Y**2)
 Z2 = np.exp(-(X * 10)**2 - (Y * 10)**2)
 Z = Z1 + 50 * Z2
 
 fig, ax = plt.subplots(2, 1)
 
-pcm = ax[0].pcolor(X, Y, Z,
-                   norm=colors.LogNorm(vmin=Z.min(), vmax=Z.max()),
-                   cmap='PuBu_r', shading='nearest')
-fig.colorbar(pcm, ax=ax[0], extend='max')
-
-pcm = ax[1].pcolor(X, Y, Z, cmap='PuBu_r', shading='nearest')
-fig.colorbar(pcm, ax=ax[1], extend='max')
+pcm = ax[0].pcolor(X, Y, Z, cmap='PuBu_r', shading='nearest')
+fig.colorbar(pcm, ax=ax[0], extend='max', label='linear scaling')
 
+pcm = ax[1].pcolor(X, Y, Z, cmap='PuBu_r', shading='nearest',
+                   norm=colors.LogNorm(vmin=Z.min(), vmax=Z.max()))
+fig.colorbar(pcm, ax=ax[1], extend='max', label='LogNorm')
 
 # %%
-# PowerNorm: Here a power-law trend in X partially obscures a rectified
-# sine wave in Y. We can remove the power law using a PowerNorm.
+# PowerNorm
+# ---------
+# This example data mixes a power-law trend in X with a rectified sine wave in Y. If
+# plotted using a linear colour scale, then the power-law trend in X partially obscures
+# the sine wave in Y.
+#
+# The power law can be removed using a `.PowerNorm`.
 
 X, Y = np.mgrid[0:3:complex(0, N), 0:2:complex(0, N)]
-Z1 = (1 + np.sin(Y * 10.)) * X**2
+Z = (1 + np.sin(Y * 10)) * X**2
 
 fig, ax = plt.subplots(2, 1)
 
-pcm = ax[0].pcolormesh(X, Y, Z1, norm=colors.PowerNorm(gamma=1. / 2.),
-                       cmap='PuBu_r', shading='nearest')
-fig.colorbar(pcm, ax=ax[0], extend='max')
+pcm = ax[0].pcolormesh(X, Y, Z, cmap='PuBu_r', shading='nearest')
+fig.colorbar(pcm, ax=ax[0], extend='max', label='linear scaling')
 
-pcm = ax[1].pcolormesh(X, Y, Z1, cmap='PuBu_r', shading='nearest')
-fig.colorbar(pcm, ax=ax[1], extend='max')
+pcm = ax[1].pcolormesh(X, Y, Z, cmap='PuBu_r', shading='nearest',
+                       norm=colors.PowerNorm(gamma=0.5))
+fig.colorbar(pcm, ax=ax[1], extend='max', label='PowerNorm')
 
 # %%
-# SymLogNorm: two humps, one negative and one positive, The positive
-# with 5-times the amplitude. Linearly, you cannot see detail in the
-# negative hump.  Here we logarithmically scale the positive and
-# negative data separately.
+# SymLogNorm
+# ----------
+# This example data has two humps, one negative and one positive, The positive hump has
+# 5 times the amplitude of the negative. If plotted with a linear colour scale, then
+# the detail in the negative hump is obscured.
+#
+# Here we logarithmically scale the positive and negative data separately with
+# `.SymLogNorm`.
 #
 # Note that colorbar labels do not come out looking very good.
 
 X, Y = np.mgrid[-3:3:complex(0, N), -2:2:complex(0, N)]
-Z = 5 * np.exp(-X**2 - Y**2)
+Z1 = np.exp(-X**2 - Y**2)
+Z2 = np.exp(-(X - 1)**2 - (Y - 1)**2)
+Z = (5 * Z1 - Z2) * 2
 
 fig, ax = plt.subplots(2, 1)
 
-pcm = ax[0].pcolormesh(X, Y, Z,
-                       norm=colors.SymLogNorm(linthresh=0.03, linscale=0.03,
-                                              vmin=-1.0, vmax=1.0, base=10),
-                       cmap='RdBu_r', shading='nearest')
-fig.colorbar(pcm, ax=ax[0], extend='both')
+pcm = ax[0].pcolormesh(X, Y, Z, cmap='RdBu_r', shading='nearest',
+                       vmin=-np.max(Z))
+fig.colorbar(pcm, ax=ax[0], extend='both', label='linear scaling')
 
-pcm = ax[1].pcolormesh(X, Y, Z, cmap='RdBu_r', vmin=-np.max(Z),
-                       shading='nearest')
-fig.colorbar(pcm, ax=ax[1], extend='both')
+pcm = ax[1].pcolormesh(X, Y, Z, cmap='RdBu_r', shading='nearest',
+                       norm=colors.SymLogNorm(linthresh=0.015,
+                                              vmin=-10.0, vmax=10.0, base=10))
+fig.colorbar(pcm, ax=ax[1], extend='both', label='SymLogNorm')
 
 # %%
-# Custom Norm: An example with a customized normalization.  This one
-# uses the example above, and normalizes the negative data differently
-# from the positive.
+# Custom Norm
+# -----------
+# Alternatively, the above example data can be scaled with a customized normalization.
+# This one normalizes the negative data differently from the positive.
 
-X, Y = np.mgrid[-3:3:complex(0, N), -2:2:complex(0, N)]
-Z1 = np.exp(-X**2 - Y**2)
-Z2 = np.exp(-(X - 1)**2 - (Y - 1)**2)
-Z = (Z1 - Z2) * 2
 
 # Example of making your own norm.  Also see matplotlib.colors.
 # From Joe Kington: This one gives two different linear ramps:
-
-
 class MidpointNormalize(colors.Normalize):
     def __init__(self, vmin=None, vmax=None, midpoint=None, clip=False):
         self.midpoint = midpoint
@@ -107,38 +112,42 @@ def __call__(self, value, clip=None):
 # %%
 fig, ax = plt.subplots(2, 1)
 
-pcm = ax[0].pcolormesh(X, Y, Z,
-                       norm=MidpointNormalize(midpoint=0.),
-                       cmap='RdBu_r', shading='nearest')
-fig.colorbar(pcm, ax=ax[0], extend='both')
+pcm = ax[0].pcolormesh(X, Y, Z, cmap='RdBu_r', shading='nearest',
+                       vmin=-np.max(Z))
+fig.colorbar(pcm, ax=ax[0], extend='both', label='linear scaling')
 
-pcm = ax[1].pcolormesh(X, Y, Z, cmap='RdBu_r', vmin=-np.max(Z),
-                       shading='nearest')
-fig.colorbar(pcm, ax=ax[1], extend='both')
+pcm = ax[1].pcolormesh(X, Y, Z, cmap='RdBu_r', shading='nearest',
+                       norm=MidpointNormalize(midpoint=0))
+fig.colorbar(pcm, ax=ax[1], extend='both', label='Custom norm')
 
 # %%
-# BoundaryNorm: For this one you provide the boundaries for your colors,
-# and the Norm puts the first color in between the first pair, the
-# second color between the second pair, etc.
-
-fig, ax = plt.subplots(3, 1, figsize=(8, 8))
-ax = ax.flatten()
-# even bounds gives a contour-like effect
-bounds = np.linspace(-1, 1, 10)
-norm = colors.BoundaryNorm(boundaries=bounds, ncolors=256)
-pcm = ax[0].pcolormesh(X, Y, Z,
-                       norm=norm,
-                       cmap='RdBu_r', shading='nearest')
-fig.colorbar(pcm, ax=ax[0], extend='both', orientation='vertical')
+# BoundaryNorm
+# ------------
+# For arbitrarily dividing the color scale, the `.BoundaryNorm` may be used; by
+# providing the boundaries for colors, this norm puts the first color in between the
+# first pair, the second color between the second pair, etc.
+
+fig, ax = plt.subplots(3, 1, layout='constrained')
 
-# uneven bounds changes the colormapping:
-bounds = np.array([-0.25, -0.125, 0, 0.5, 1])
+pcm = ax[0].pcolormesh(X, Y, Z, cmap='RdBu_r', shading='nearest',
+                       vmin=-np.max(Z))
+fig.colorbar(pcm, ax=ax[0], extend='both', orientation='vertical',
+             label='linear scaling')
+
+# Evenly-spaced bounds gives a contour-like effect.
+bounds = np.linspace(-2, 2, 11)
 norm = colors.BoundaryNorm(boundaries=bounds, ncolors=256)
-pcm = ax[1].pcolormesh(X, Y, Z, norm=norm, cmap='RdBu_r', shading='nearest')
-fig.colorbar(pcm, ax=ax[1], extend='both', orientation='vertical')
+pcm = ax[1].pcolormesh(X, Y, Z, cmap='RdBu_r', shading='nearest',
+                       norm=norm)
+fig.colorbar(pcm, ax=ax[1], extend='both', orientation='vertical',
+             label='BoundaryNorm\nlinspace(-2, 2, 11)')
 
-pcm = ax[2].pcolormesh(X, Y, Z, cmap='RdBu_r', vmin=-np.max(Z1),
-                       shading='nearest')
-fig.colorbar(pcm, ax=ax[2], extend='both', orientation='vertical')
+# Unevenly-spaced bounds changes the colormapping.
+bounds = np.array([-1, -0.5, 0, 2.5, 5])
+norm = colors.BoundaryNorm(boundaries=bounds, ncolors=256)
+pcm = ax[2].pcolormesh(X, Y, Z, cmap='RdBu_r', shading='nearest',
+                       norm=norm)
+fig.colorbar(pcm, ax=ax[2], extend='both', orientation='vertical',
+             label='BoundaryNorm\n[-1, -0.5, 0, 2.5, 5]')
 
 plt.show()

From d835dfafc2652f660160b87ade0114af73e563ae Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Tue, 6 Feb 2024 20:22:13 -0500
Subject: [PATCH 0702/1120] Use new name for Meson options file

This new name was added in Meson 1.1, which is our minimum requirement.
---
 meson_options.txt => meson.options | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 rename meson_options.txt => meson.options (100%)

diff --git a/meson_options.txt b/meson.options
similarity index 100%
rename from meson_options.txt
rename to meson.options

From 95c628b68001dcaf8fe7f491c8a4ea240e4989f1 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Thu, 25 Jan 2024 13:52:51 -0500
Subject: [PATCH 0703/1120] GOV: adopt EffVer

EffVer very closely articulates what we are already doing.

Co-authored-by: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
---
 doc/conf.py                        |  2 +-
 doc/devel/MEP/MEP13.rst            |  2 +-
 doc/devel/api_changes.rst          |  4 +-
 doc/devel/min_dep_policy.rst       |  9 ++--
 doc/devel/pr_guide.rst             | 18 ++++----
 doc/devel/release_guide.rst        | 73 +++++++++++++++++++++---------
 doc/devel/triage.rst               |  2 +-
 lib/matplotlib/_api/deprecation.py |  2 +-
 src/ft2font_wrapper.cpp            |  4 +-
 tools/github_stats.py              |  2 +-
 10 files changed, 75 insertions(+), 43 deletions(-)

diff --git a/doc/conf.py b/doc/conf.py
index f975b8076044..3805facbfbcc 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -482,7 +482,7 @@ def js_tag_with_cache_busting(js):
     "switcher": {
         # Add a unique query to the switcher.json url.  This will be ignored by
         # the server, but will be used as part of the key for caching by browsers
-        # so when we do a new minor release the switcher will update "promptly" on
+        # so when we do a new meso release the switcher will update "promptly" on
         # the stable and devdocs.
         "json_url": f"https://matplotlib.org/devdocs/_static/switcher.json?{SHA}",
         "version_match": (
diff --git a/doc/devel/MEP/MEP13.rst b/doc/devel/MEP/MEP13.rst
index 58131a9a06fb..b8b80f281b6e 100644
--- a/doc/devel/MEP/MEP13.rst
+++ b/doc/devel/MEP/MEP13.rst
@@ -63,7 +63,7 @@ The following steps can be done simultaneously: 1, 2, and 3; 4 and 5;
 
 Only the following steps must be done in the same release: 4, 5,
 and 6.  All other changes can be done in separate releases.  8 should
-be done several major releases after everything else.
+be done several macro releases after everything else.
 
 Backward compatibility
 ======================
diff --git a/doc/devel/api_changes.rst b/doc/devel/api_changes.rst
index 52d52ecbd6da..b7d0a4b063ce 100644
--- a/doc/devel/api_changes.rst
+++ b/doc/devel/api_changes.rst
@@ -54,7 +54,7 @@ prevents unexpected breaking of code.
 
 Rules
 ^^^^^
-- Deprecations are targeted at the next :ref:`minor release <pr-milestones>` (e.g. 3.x)
+- Deprecations are targeted at the next :ref:`meso release <pr-milestones>` (e.g. 3.x)
 - Deprecated API is generally removed (expired) two point-releases after introduction
   of the deprecation. Longer deprecations can be imposed by core developers on
   a case-by-case basis to give more time for the transition
@@ -200,7 +200,7 @@ For example::
 
 For classes and functions, the directive should be placed before the
 *Parameters* section. For parameters, the directive should be placed at the
-end of the parameter description. The patch release version is omitted and
+end of the parameter description. The micro release version is omitted and
 the directive should not be added to entire modules.
 
 Release notes
diff --git a/doc/devel/min_dep_policy.rst b/doc/devel/min_dep_policy.rst
index dd8e069f0b94..baf6db9811a8 100644
--- a/doc/devel/min_dep_policy.rst
+++ b/doc/devel/min_dep_policy.rst
@@ -4,10 +4,11 @@
 Dependency version policy
 =========================
 
-For the purpose of this document, 'minor version' is in the sense of
-SemVer (major, minor, patch) and includes both major and minor
-releases. For projects that use date-based versioning, every release
-is a 'minor version'.
+For the purpose of this document, 'minor version' is in the sense of SemVer
+(major, minor, patch) or 'meso version' in the sense of `EffVer
+<https://jacobtomlinson.dev/effver/>`_ (macro, meso, micro).  It includes both
+major/macro and minor/meso releases.  For projects that use date-based
+versioning, every release is a 'minor version'.
 
 Matplotlib follows `NEP 29
 <https://numpy.org/neps/nep-0029-deprecation_policy.html>`__.
diff --git a/doc/devel/pr_guide.rst b/doc/devel/pr_guide.rst
index 257e218d8e1f..055998549e78 100644
--- a/doc/devel/pr_guide.rst
+++ b/doc/devel/pr_guide.rst
@@ -151,11 +151,11 @@ Milestones
 
 Set the milestone according to these guidelines:
 
-* *New features and API changes* are milestoned for the next minor release
+* *New features and API changes* are milestoned for the next meso release
   ``v3.N.0``.
 
 * *Bugfixes, tests for released code, and docstring changes* may be milestoned
-  for the next patch release ``v3.N.M``.
+  for the next micro release ``v3.N.M``.
 
 * *Documentation changes* (only .rst files and examples) may be milestoned
   ``v3.N-doc``.
@@ -250,15 +250,15 @@ Current branches
 The current active branches are
 
 *main*
-  The current development version. Future minor releases (*v3.N.0*) will be
+  The current development version. Future meso (*v3.N.0*) or macro (*v4.0.0*) will be
   branched from this.
 
 *v3.N.x*
-  Maintenance branch for Matplotlib 3.N. Future patch releases will be
-  branched from this.
+  Maintenance branch for Matplotlib 3.N. Future micro releases will be
+  tagged from this.
 
 *v3.N.M-doc*
-  Documentation for the current release.  On a patch release, this will be
+  Documentation for the current micro release.  On a micro release, this will be
   replaced by a properly named branch for the new release.
 
 
@@ -279,14 +279,14 @@ work.
 Backport strategy
 -----------------
 
-Backports to the patch release branch (*v3.N.x*) are the changes that will be
+Backports to the micro release branch (*v3.N.x*) are the changes that will be
 included in the next patch (aka bug-fix) release.  The goal of the patch
 releases is to fix bugs without adding any new regressions or behavior changes.
 We will always attempt to backport:
 
 - critical bug fixes (segfault, failure to import, things that the
   user cannot work around)
-- fixes for regressions introduced in the last two minor releases
+- fixes for regressions introduced in the last two meso releases
 
 and may attempt to backport fixes for regressions introduced in older releases.
 
@@ -296,7 +296,7 @@ effort and risk of re-implementing the bug fix vs the severity of the bug.
 When in doubt, err on the side of not backporting.
 
 When backporting a Pull Request fails or is declined, re-milestone the original
-PR to the next minor release and leave a comment explaining why.
+PR to the next meso release and leave a comment explaining why.
 
 The only changes backported to the documentation branch (*v3.N.M-doc*)
 are changes to :file:`doc` or :file:`galleries`.  Any changes to :file:`lib`
diff --git a/doc/devel/release_guide.rst b/doc/devel/release_guide.rst
index 4adc4546e879..ab917a35575e 100644
--- a/doc/devel/release_guide.rst
+++ b/doc/devel/release_guide.rst
@@ -12,10 +12,35 @@ Release guide
    A guide for developers who are doing a Matplotlib release.
 
 
-.. note::
 
-   This assumes that a read-only remote for the canonical repository is
-   ``remote`` and a read/write remote is ``DANGER``
+Versioning Scheme
+=================
+
+Maplotlib follows the `Intended Effort Versioning (EffVer) <https://jacobtomlinson.dev/effver/>`_
+versioning scheme: *macro.meso.micro*.
+
+
+*macro*
+  A release that we expect a large effort from our users to upgrade to.  The v1 to v2 transition
+  included a complete overhaul of the default styles and the v2 to v3 transition involved
+  dropping support for Python 2.
+
+  Future macro versions would include changes of a comparable scale that can not be done
+  incrementally in meso releases.
+
+*meso*
+  A release that we expect some effort from our users to upgrade to.  We target a
+  *Meso* release every 6 months.  These release are primarily intended to release
+  new features to our users, however they also contain intentional feature deprecations and
+  removals per :ref:`our policy <deprecation-guidelines>`.
+
+*micro*
+  A release that we expect users to require little to no effort to upgrade to.  Per
+  our :ref:`backport-strategy` we only backport bug fixes to the maintenance branch.
+  We expect minimal impact on users other than possibly breaking work arounds to a
+  fixed bug or `bugs being used as features <https://xkcd.com/1172/>`_.
+
+  These are released as-needed, but typically every 1-2 months between meso releases.
 
 
 .. _release_feature_freeze:
@@ -23,9 +48,15 @@ Release guide
 Making the release branch
 =========================
 
-When a new minor release (vX.Y.0) is approaching, a new release branch must be made.
+.. note::
+
+   This assumes that a read-only remote for the canonical repository is
+   ``remote`` and a read/write remote is ``DANGER``
+
+
+When a new meso release (vX.Y.0) is approaching, a new release branch must be made.
 When precisely this should happen is up to the release manager, but this point is where
-most new features intended for the minor release are merged and you are entering a
+most new features intended for the meso release are merged and you are entering a
 feature freeze (i.e. newly implemented features will be going into vX.Y+1).
 This does not necessarily mean that no further changes will be made prior to release,
 just that those changes will be made using the backport system.
@@ -50,12 +81,12 @@ Micro versions should instead read::
    on-merge: backport to v3.7.x
 
 Check all active milestones for consistency. Older milestones should also backport
-to higher minor versions (e.g. ``v3.6.3`` and ``v3.6-doc`` should backport to both
+to higher meso versions (e.g. ``v3.6.3`` and ``v3.6-doc`` should backport to both
 ``v3.6.x`` and ``v3.7.x`` once the ``v3.7.x`` branch exists and while PR backports are
 still targeting ``v3.6.x``)
 
-Create the milestone for the next-next minor release (i.e. ``v3.9.0``, as ``v3.8.0``
-should already exist). While most active items should go in the next minor release,
+Create the milestone for the next-next meso release (i.e. ``v3.9.0``, as ``v3.8.0``
+should already exist). While most active items should go in the next meso release,
 this milestone can help with longer term planning, especially around deprecation
 cycles.
 
@@ -142,15 +173,15 @@ are going to tag on and delete the doc branch on GitHub.
 Update supported versions in Security Policy
 --------------------------------------------
 
-When making major or minor releases, update the supported versions in the Security
+When making macro or meso releases, update the supported versions in the Security
 Policy in :file:`SECURITY.md`.
 
-For minor version release update the table in :file:`SECURITY.md` to specify that the
-two most recent minor releases in the current major version series are supported.
+For meso version release update the table in :file:`SECURITY.md` to specify that the
+two most recent meso releases in the current macro version series are supported.
 
-For a major version release update the table in :file:`SECURITY.md` to specify that the
-last minor version in the previous major version series is still supported. Dropping
-support for the last version of a major version series will be handled on an ad-hoc
+For a macro version release update the table in :file:`SECURITY.md` to specify that the
+last meso version in the previous macro version series is still supported. Dropping
+support for the last version of a macro version series will be handled on an ad-hoc
 basis.
 
 Update release notes
@@ -159,7 +190,7 @@ Update release notes
 What's new
 ^^^^^^^^^^
 
-*Only needed for major and minor releases. Bugfix releases should not have new
+*Only needed for macro and meso releases. Bugfix releases should not have new
 features.*
 
 Merge the contents of all the files in :file:`doc/users/next_whats_new/` into a single
@@ -169,7 +200,7 @@ files.
 API changes
 ^^^^^^^^^^^
 
-*Primarily needed for major and minor releases. We may sometimes have API
+*Primarily needed for macro and meso releases. We may sometimes have API
 changes in bugfix releases.*
 
 Merge the contents of all the files in :file:`doc/api/next_api_changes/` into a single
@@ -181,7 +212,7 @@ Release notes TOC
 
 Update :file:`doc/users/release_notes.rst`:
 
-- For major and minor releases add a new section
+- For macro and meso releases add a new section
 
   .. code:: rst
 
@@ -207,7 +238,7 @@ Update version switcher
 Update ``doc/_static/switcher.json``:
 
 - If a bugfix release, :samp:`{X}.{Y}.{Z}`, no changes are needed.
-- If a major release, :samp:`{X}.{Y}.0`, change the name of :samp:`name: {X}.{Y+1}
+- If a macro release, :samp:`{X}.{Y}.0`, change the name of :samp:`name: {X}.{Y+1}
   (dev)` and :samp:`name: {X}.{Y} (stable)` as well as adding a new version for the
   previous stable (:samp:`name: {X}.{Y-1}`).
 
@@ -259,8 +290,8 @@ Finally, push the tag to GitHub::
 
 Congratulations, the scariest part is done!
 This assumes the release branch has already been made.
-Usually this is done at the time of feature freeze for a minor release (which often
-coincides with the last patch release of the previous minor version)
+Usually this is done at the time of feature freeze for a meso release (which often
+coincides with the last micro release of the previous meso version)
 
 .. [#] The tarball that is provided by GitHub is produced using `git archive`_.
        We use setuptools_scm_ which uses a format string in
@@ -298,7 +329,7 @@ with the ``v3.7-doc`` milestone to both the ``v3.7.x`` branch and the ``v3.7.0-d
    on-merge: backport to v3.7.0-doc
 
 Check all active milestones for consistency. Older doc milestones should also backport to
-higher minor versions (e.g. ``v3.6-doc`` should backport to both ``v3.6.x`` and ``v3.7.x``
+higher meso versions (e.g. ``v3.6-doc`` should backport to both ``v3.6.x`` and ``v3.7.x``
 if the ``v3.7.x`` branch exists)
 
 
diff --git a/doc/devel/triage.rst b/doc/devel/triage.rst
index 1b2849738c9c..ca06fd515c79 100644
--- a/doc/devel/triage.rst
+++ b/doc/devel/triage.rst
@@ -160,7 +160,7 @@ The following workflow is a good way to approach issue triaging:
 
    While we strive for a bug-free library, regressions are the highest
    priority.  If we have broken user-code that *used to* work, we should
-   fix that in the next patch release!
+   fix that in the next micro release!
 
    Try to determine when the regression happened by running the
    reproduction code against older versions of Matplotlib.  This can
diff --git a/lib/matplotlib/_api/deprecation.py b/lib/matplotlib/_api/deprecation.py
index 7c304173b2e5..d937311603aa 100644
--- a/lib/matplotlib/_api/deprecation.py
+++ b/lib/matplotlib/_api/deprecation.py
@@ -29,7 +29,7 @@ def _generate_deprecation_warning(
             raise ValueError(
                 "A pending deprecation cannot have a scheduled removal")
     else:
-        removal = f"in {removal}" if removal else "two minor releases later"
+        removal = f"in {removal}" if removal else "two meso releases later"
     if not message:
         message = (
             ("The %(name)s %(obj_type)s" if obj_type else "%(name)s")
diff --git a/src/ft2font_wrapper.cpp b/src/ft2font_wrapper.cpp
index ef47a6574985..f010557e6341 100644
--- a/src/ft2font_wrapper.cpp
+++ b/src/ft2font_wrapper.cpp
@@ -75,7 +75,7 @@ static PyObject *PyFT2Image_draw_rect(PyFT2Image *self, PyObject *args)
 {
     char const* msg =
         "FT2Image.draw_rect is deprecated since Matplotlib 3.8 and will be removed "
-        "two minor releases later as it is not used in the library. If you rely on "
+        "two meso releases later as it is not used in the library. If you rely on "
         "it, please let us know.";
     if (PyErr_WarnEx(PyExc_DeprecationWarning, msg, 1)) {
         return NULL;
@@ -841,7 +841,7 @@ static PyObject *PyFT2Font_get_xys(PyFT2Font *self, PyObject *args, PyObject *kw
 {
     char const* msg =
         "FT2Font.get_xys is deprecated since Matplotlib 3.8 and will be removed two "
-        "minor releases later as it is not used in the library. If you rely on it, "
+        "meso releases later as it is not used in the library. If you rely on it, "
         "please let us know.";
     if (PyErr_WarnEx(PyExc_DeprecationWarning, msg, 1)) {
         return NULL;
diff --git a/tools/github_stats.py b/tools/github_stats.py
index 54beac07ddf8..af0255fcefba 100755
--- a/tools/github_stats.py
+++ b/tools/github_stats.py
@@ -169,7 +169,7 @@ def report(issues, show_urls=False):
     parser.add_argument(
         '--since-tag', type=str,
         help='The git tag to use for the starting point '
-             '(typically the last major release).')
+             '(typically the last macro release).')
     parser.add_argument(
         '--milestone', type=str,
         help='The GitHub milestone to use for filtering issues [optional].')

From 53a2807e75a8b7285b3f5831d8cd5134fb65b9a6 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Thu, 25 Jan 2024 17:30:02 -0500
Subject: [PATCH 0704/1120] DOC: also standardize "bugfix release" -> "micro
 release"

---
 doc/api/prev_api_changes/api_changes_1.3.x.rst | 2 +-
 doc/devel/release_guide.rst                    | 6 +++---
 doc/users/prev_whats_new/whats_new_1.3.rst     | 2 +-
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/doc/api/prev_api_changes/api_changes_1.3.x.rst b/doc/api/prev_api_changes/api_changes_1.3.x.rst
index 0aeb47815fcc..2601824ba7d1 100644
--- a/doc/api/prev_api_changes/api_changes_1.3.x.rst
+++ b/doc/api/prev_api_changes/api_changes_1.3.x.rst
@@ -7,7 +7,7 @@ API Changes in 1.3.x
 Changes in 1.3.1
 ----------------
 
-It is rare that we make an API change in a bugfix release, however,
+It is rare that we make an API change in a micro release, however,
 for 1.3.1 since 1.3.0 the following change was made:
 
 - ``text.Text.cached`` (used to cache font objects) has been made into a
diff --git a/doc/devel/release_guide.rst b/doc/devel/release_guide.rst
index ab917a35575e..fa2cd33731bd 100644
--- a/doc/devel/release_guide.rst
+++ b/doc/devel/release_guide.rst
@@ -201,7 +201,7 @@ API changes
 ^^^^^^^^^^^
 
 *Primarily needed for macro and meso releases. We may sometimes have API
-changes in bugfix releases.*
+changes in micro releases.*
 
 Merge the contents of all the files in :file:`doc/api/next_api_changes/` into a single
 file :file:`doc/api/prev_api_changes/api_changes_{X}.{Y}.{Z}.rst` and delete the
@@ -224,7 +224,7 @@ Update :file:`doc/users/release_notes.rst`:
          prev_whats_new/whats_new_X.Y.0.rst
          ../api/prev_api_changes/api_changes_X.Y.0.rst
          prev_whats_new/github_stats_X.Y.0.rst
-- For bugfix releases add the GitHub stats and (if present) the API changes to
+- For micro releases add the GitHub stats and (if present) the API changes to
   the existing X.Y section
 
   .. code:: rst
@@ -237,7 +237,7 @@ Update version switcher
 
 Update ``doc/_static/switcher.json``:
 
-- If a bugfix release, :samp:`{X}.{Y}.{Z}`, no changes are needed.
+- If a micro release, :samp:`{X}.{Y}.{Z}`, no changes are needed.
 - If a macro release, :samp:`{X}.{Y}.0`, change the name of :samp:`name: {X}.{Y+1}
   (dev)` and :samp:`name: {X}.{Y} (stable)` as well as adding a new version for the
   previous stable (:samp:`name: {X}.{Y-1}`).
diff --git a/doc/users/prev_whats_new/whats_new_1.3.rst b/doc/users/prev_whats_new/whats_new_1.3.rst
index 855235069917..10811632c5c4 100644
--- a/doc/users/prev_whats_new/whats_new_1.3.rst
+++ b/doc/users/prev_whats_new/whats_new_1.3.rst
@@ -13,7 +13,7 @@ What's new in Matplotlib 1.3 (Aug 01, 2013)
 New in 1.3.1
 ------------
 
-1.3.1 is a bugfix release, primarily dealing with improved setup and
+1.3.1 is a micro release, primarily dealing with improved setup and
 handling of dependencies, and correcting and enhancing the
 documentation.
 

From 81aad0235b62478ab72b6b00c6306015d6eb93a3 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Tue, 6 Feb 2024 20:31:54 -0500
Subject: [PATCH 0705/1120] Use new Meson-provided dl lookup

This was added in 0.62, and maybe is a bit more portable.
---
 src/meson.build | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/meson.build b/src/meson.build
index db064a9c5ca1..d83dab0ffc28 100644
--- a/src/meson.build
+++ b/src/meson.build
@@ -52,7 +52,7 @@ if devnull == 'not-given'
 endif
 
 # Will only exist on Linux with older glibc.
-dl = cc.find_library('dl', required: false)
+dl = dependency('dl', required: false)
 
 # With Meson >= 1.2.0, use cpp_winlibs instead of manually searching.
 if ['cygwin', 'windows'].contains(host_machine.system())

From 7fd77096682f5bd12aee718145ea0031a689762b Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Tue, 6 Feb 2024 20:42:18 -0500
Subject: [PATCH 0706/1120] Add all License files to Meson metadata

This doesn't get used for anything effectively, but perhaps meson-python
will start using it eventually.
---
 meson.build                                         | 13 +++++++++++++
 .../packagefiles/freetype-2.6.1-meson/meson.build   | 10 ++++++++--
 subprojects/packagefiles/qhull-8.0.2/meson.build    |  6 +++++-
 3 files changed, 26 insertions(+), 3 deletions(-)

diff --git a/meson.build b/meson.build
index 41f080b3700e..21bc0ae95580 100644
--- a/meson.build
+++ b/meson.build
@@ -7,6 +7,19 @@ project(
   # Carlogo, STIX and Computer Modern is OFL
   # DejaVu is Bitstream Vera and Public Domain
   license: 'PSF-2.0 AND MIT AND CC0-1.0 AND OFL-1.1 AND Bitstream-Vera AND Public-Domain',
+  license_files: [
+    'LICENSE/LICENSE',
+    'LICENSE/LICENSE_AMSFONTS',
+    'LICENSE/LICENSE_BAKOMA',
+    'LICENSE/LICENSE_CARLOGO',
+    'LICENSE/LICENSE_COLORBREWER',
+    'LICENSE/LICENSE_COURIERTEN',
+    'LICENSE/LICENSE_JSXTOOLS_RESIZE_OBSERVER',
+    'LICENSE/LICENSE_QT4_EDITOR',
+    'LICENSE/LICENSE_SOLARIZED',
+    'LICENSE/LICENSE_STIX',
+    'LICENSE/LICENSE_YORICK',
+  ],
   meson_version: '>=1.1.0',
   default_options: [
     'b_lto=true',
diff --git a/subprojects/packagefiles/freetype-2.6.1-meson/meson.build b/subprojects/packagefiles/freetype-2.6.1-meson/meson.build
index dddfd67f6d09..9a5180ef7586 100644
--- a/subprojects/packagefiles/freetype-2.6.1-meson/meson.build
+++ b/subprojects/packagefiles/freetype-2.6.1-meson/meson.build
@@ -1,6 +1,12 @@
 project('freetype2', 'c',
-  license : ['FTL', 'GPL2'],
-  version: '2.6.1')
+  version: '2.6.1',
+  license: '(FTL OR GPL-2.0-or-later) AND BSD-3-Clause AND MIT AND MIT-Modern-Variant AND Zlib',
+  license_files: [
+    'docs/LICENSE.TXT',
+    'docs/FTL.TXT',
+    'docs/GPLv2.TXT',
+  ],
+  meson_version: '>=1.1.0')
 
 # NOTE about FreeType versions
 # There are 3 versions numbers associated with each releases:
diff --git a/subprojects/packagefiles/qhull-8.0.2/meson.build b/subprojects/packagefiles/qhull-8.0.2/meson.build
index 3d20c5d2ae55..7a27b4715c25 100644
--- a/subprojects/packagefiles/qhull-8.0.2/meson.build
+++ b/subprojects/packagefiles/qhull-8.0.2/meson.build
@@ -1,6 +1,10 @@
 project('qhull', 'c',
   version: '8.0.2',
-  license: 'Qhull')
+  license: 'Qhull',
+  license_files: [
+    'COPYING.txt',
+  ],
+  meson_version: '>=1.1.0')
 
 qhull_inc = include_directories('src')
 qhull_lib = static_library('qhull_r',

From cce86903e044595992eb09012076a8fa9e6bf258 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Tue, 6 Feb 2024 21:49:37 -0500
Subject: [PATCH 0707/1120] MNT: de-jargon hard-coded warning and deprecation
 decorator

---
 lib/matplotlib/_api/deprecation.py  | 9 ++++++---
 lib/matplotlib/tests/test_pyplot.py | 4 ++--
 src/ft2font_wrapper.cpp             | 4 ++--
 3 files changed, 10 insertions(+), 7 deletions(-)

diff --git a/lib/matplotlib/_api/deprecation.py b/lib/matplotlib/_api/deprecation.py
index d937311603aa..283a55f1beb0 100644
--- a/lib/matplotlib/_api/deprecation.py
+++ b/lib/matplotlib/_api/deprecation.py
@@ -29,14 +29,17 @@ def _generate_deprecation_warning(
             raise ValueError(
                 "A pending deprecation cannot have a scheduled removal")
     else:
-        removal = f"in {removal}" if removal else "two meso releases later"
+        if not removal:
+            macro, meso, *_ = since.split('.')
+            removal = f'{macro}.{int(meso) + 2}'
+        removal = f"in {removal}"
     if not message:
         message = (
             ("The %(name)s %(obj_type)s" if obj_type else "%(name)s")
             + (" will be deprecated in a future version"
                if pending else
-               (" was deprecated in Matplotlib %(since)s"
-                + (" and will be removed %(removal)s" if removal else "")))
+               " was deprecated in Matplotlib %(since)s and will be removed %(removal)s"
+               )
             + "."
             + (" Use %(alternative)s instead." if alternative else "")
             + (" %(addendum)s" if addendum else ""))
diff --git a/lib/matplotlib/tests/test_pyplot.py b/lib/matplotlib/tests/test_pyplot.py
index 6ebc24c46e29..a077aede8f8b 100644
--- a/lib/matplotlib/tests/test_pyplot.py
+++ b/lib/matplotlib/tests/test_pyplot.py
@@ -43,8 +43,8 @@ def test_pyplot_up_to_date(tmp_path):
 
 
 def test_copy_docstring_and_deprecators(recwarn):
-    @mpl._api.rename_parameter("(version)", "old", "new")
-    @mpl._api.make_keyword_only("(version)", "kwo")
+    @mpl._api.rename_parameter(mpl.__version__, "old", "new")
+    @mpl._api.make_keyword_only(mpl.__version__, "kwo")
     def func(new, kwo=None):
         pass
 
diff --git a/src/ft2font_wrapper.cpp b/src/ft2font_wrapper.cpp
index f010557e6341..1b03e5406147 100644
--- a/src/ft2font_wrapper.cpp
+++ b/src/ft2font_wrapper.cpp
@@ -75,8 +75,8 @@ static PyObject *PyFT2Image_draw_rect(PyFT2Image *self, PyObject *args)
 {
     char const* msg =
         "FT2Image.draw_rect is deprecated since Matplotlib 3.8 and will be removed "
-        "two meso releases later as it is not used in the library. If you rely on "
-        "it, please let us know.";
+        "in Matplotlib 3.10 releases later as it is not used in the library. "
+        "If you rely on it, please let us know.";
     if (PyErr_WarnEx(PyExc_DeprecationWarning, msg, 1)) {
         return NULL;
     }

From e1e1a32c0502cbb47674925d8ee4053cc065de59 Mon Sep 17 00:00:00 2001
From: Alec Vercruysse <vercruysse.alec@gmail.com>
Date: Wed, 7 Feb 2024 12:01:34 -0800
Subject: [PATCH 0708/1120] fix quiver3d incorrect arrow colors

---
 lib/mpl_toolkits/mplot3d/axes3d.py | 10 +---------
 1 file changed, 1 insertion(+), 9 deletions(-)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index 4d8c7e6b8e84..b5ece8709d15 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -2986,14 +2986,6 @@ def calc_arrows(UVW):
         # Normalize rows of UVW
         norm = np.linalg.norm(UVW, axis=1)
 
-        # If any row of UVW is all zeros, don't make a quiver for it
-        mask = norm > 0
-        XYZ = XYZ[mask]
-        if normalize:
-            UVW = UVW[mask] / norm[mask].reshape((-1, 1))
-        else:
-            UVW = UVW[mask]
-
         if len(XYZ) > 0:
             # compute the shaft lines all at once with an outer product
             shafts = (XYZ - np.multiply.outer(shaft_dt, UVW)).swapaxes(0, 1)
@@ -3006,7 +2998,7 @@ def calc_arrows(UVW):
             # transpose to get a list of lines
             heads = heads.swapaxes(0, 1)
 
-            lines = [*shafts, *heads]
+            lines = [*shafts, *heads[::2], *heads[1::2]]
         else:
             lines = []
 

From c3d60d37139d767f540ab47d8c201f3eebb15816 Mon Sep 17 00:00:00 2001
From: Alec Vercruysse <vercruysse.alec@gmail.com>
Date: Wed, 7 Feb 2024 13:09:06 -0800
Subject: [PATCH 0709/1120] revert quiver3d normalization

---
 lib/mpl_toolkits/mplot3d/axes3d.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index b5ece8709d15..403c29260beb 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -2986,6 +2986,10 @@ def calc_arrows(UVW):
         # Normalize rows of UVW
         norm = np.linalg.norm(UVW, axis=1)
 
+        # If any row of UVW is all zeros, don't make a quiver for it
+        if normalize:
+            UVW = UVW / norm.reshape((-1, 1))
+
         if len(XYZ) > 0:
             # compute the shaft lines all at once with an outer product
             shafts = (XYZ - np.multiply.outer(shaft_dt, UVW)).swapaxes(0, 1)

From 141eb39d8268f766ae0d1f27378e59725e42f526 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Wed, 7 Feb 2024 15:17:02 -0600
Subject: [PATCH 0710/1120] Allow threads during macos event loop

---
 src/_macosx.m | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/_macosx.m b/src/_macosx.m
index 8038b72899df..299fed1785a8 100755
--- a/src/_macosx.m
+++ b/src/_macosx.m
@@ -461,6 +461,8 @@ int mpl_check_modifier(
         return NULL;
     }
 
+    Py_BEGIN_ALLOW_THREADS
+
     NSDate* date =
         (timeout > 0.0) ? [NSDate dateWithTimeIntervalSinceNow: timeout]
                         : [NSDate distantFuture];
@@ -473,6 +475,8 @@ int mpl_check_modifier(
        [NSApp sendEvent: event];
     }
 
+    Py_END_ALLOW_THREADS
+
     Py_RETURN_NONE;
 }
 

From 86790e6b553a19f9221045344e333ca4ae4f0a17 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Wed, 7 Feb 2024 16:07:49 -0600
Subject: [PATCH 0711/1120] Add protections against infinite loop in bezier
 calculations

Closes #27753
---
 lib/matplotlib/bezier.py            |  8 ++++++++
 lib/matplotlib/tests/test_bezier.py | 17 +++++++++++++++++
 2 files changed, 25 insertions(+)
 create mode 100644 lib/matplotlib/tests/test_bezier.py

diff --git a/lib/matplotlib/bezier.py b/lib/matplotlib/bezier.py
index f310f287e2c0..069e20d05916 100644
--- a/lib/matplotlib/bezier.py
+++ b/lib/matplotlib/bezier.py
@@ -171,9 +171,17 @@ def find_bezier_t_intersecting_with_closedpath(
 
         if start_inside ^ middle_inside:
             t1 = middle_t
+            if end == middle:
+                # Edge case where infinite loop is possible
+                # Caused by large numbers relative to tolerance
+                return t0, t1
             end = middle
         else:
             t0 = middle_t
+            if start == middle:
+                # Edge case where infinite loop is possible
+                # Caused by large numbers relative to tolerance
+                return t0, t1
             start = middle
             start_inside = middle_inside
 
diff --git a/lib/matplotlib/tests/test_bezier.py b/lib/matplotlib/tests/test_bezier.py
new file mode 100644
index 000000000000..65e2c616e738
--- /dev/null
+++ b/lib/matplotlib/tests/test_bezier.py
@@ -0,0 +1,17 @@
+"""
+Tests specific to the bezier module.
+"""
+
+from matplotlib.bezier import inside_circle, split_bezier_intersecting_with_closedpath
+
+
+def test_split_bezier_with_large_values():
+    # These numbers come from gh-27753
+    arrow_path = [(96950809781500.0, 804.7503795623779),
+                  (96950809781500.0, 859.6242585800646),
+                  (96950809781500.0, 914.4981375977513)]
+    in_f = inside_circle(96950809781500.0, 804.7503795623779, 0.06)
+    split_bezier_intersecting_with_closedpath(arrow_path, in_f)
+    # All we are testing is that this completes
+    # The failure case is an infinite loop resulting from floating point precision
+    # pytest will timeout if that occurs

From 51fd57897aab406471446005b560cfdc50bb63a5 Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Wed, 7 Feb 2024 23:42:29 +0100
Subject: [PATCH 0712/1120] [Doc] Remove special casing for remove method

---
 doc/_templates/automodule.rst | 11 -----------
 1 file changed, 11 deletions(-)

diff --git a/doc/_templates/automodule.rst b/doc/_templates/automodule.rst
index fef899a38a5e..df3e8283f2f6 100644
--- a/doc/_templates/automodule.rst
+++ b/doc/_templates/automodule.rst
@@ -1,15 +1,5 @@
 {{ fullname | escape | underline}}
 
-{% if fullname in ['mpl_toolkits.axes_grid1.colorbar'] %}
-
-.. To prevent problems with the autosummary for the colorbar doc treat this
-   separately (sphinx-doc/sphinx/issues/4874)
-
-.. automodule:: {{ fullname }}
-   :members:
-
-{% else %}
-
 .. automodule:: {{ fullname }}
    :no-members:
    :no-inherited-members:
@@ -45,4 +35,3 @@ Functions
 
 {% endif %}
 {% endblock %}
-{% endif %}

From f8732779cda6064f5f3ebaa27fd33b3623c83361 Mon Sep 17 00:00:00 2001
From: Alec Vercruysse <vercruysse.alec@gmail.com>
Date: Wed, 7 Feb 2024 16:07:44 -0800
Subject: [PATCH 0713/1120] quiver: avoid divide by zero when normalizing

 - (avoid unnecessary computation otherwise)
---
 lib/mpl_toolkits/mplot3d/axes3d.py | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index 403c29260beb..74348d17730d 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -2984,10 +2984,9 @@ def calc_arrows(UVW):
         UVW = np.column_stack(input_args[3:]).astype(float)
 
         # Normalize rows of UVW
-        norm = np.linalg.norm(UVW, axis=1)
-
-        # If any row of UVW is all zeros, don't make a quiver for it
         if normalize:
+            norm = np.linalg.norm(UVW, axis=1)
+            norm[norm == 0] = 1
             UVW = UVW / norm.reshape((-1, 1))
 
         if len(XYZ) > 0:

From c0b24428b246529a0bff5ca50783ee3f02e16d1c Mon Sep 17 00:00:00 2001
From: Alec Vercruysse <vercruysse.alec@gmail.com>
Date: Wed, 7 Feb 2024 16:13:11 -0800
Subject: [PATCH 0714/1120] Add tol to quiver3d & errorbar3d_errorevery image
 comparison test

---
 lib/mpl_toolkits/mplot3d/tests/test_axes3d.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
index 1c6bbdd91670..752636e45ddd 100644
--- a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
@@ -836,7 +836,8 @@ def test_mixedsamplesraises():
         ax.plot_surface(X, Y, Z, cstride=50, rcount=10)
 
 
-@mpl3d_image_comparison(['quiver3d.png'], style='mpl20')
+# remove tolerance when regenerating the test image
+@mpl3d_image_comparison(['quiver3d.png'], style='mpl20', tol=0.003)
 def test_quiver3d():
     plt.rcParams['axes3d.automargin'] = True  # Remove when image is regenerated
     fig = plt.figure()
@@ -1555,7 +1556,8 @@ def test_minor_ticks():
     ax.set_zticklabels(["half"], minor=True)
 
 
-@mpl3d_image_comparison(['errorbar3d_errorevery.png'], style='mpl20')
+# remove tolerance when regenerating the test image
+@mpl3d_image_comparison(['errorbar3d_errorevery.png'], style='mpl20', tol=0.003)
 def test_errorbar3d_errorevery():
     """Tests errorevery functionality for 3D errorbars."""
     t = np.arange(0, 2*np.pi+.1, 0.01)

From a7178f9f74fe3c542d79ee4477022bff59a78fa5 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 8 Feb 2024 05:02:35 -0500
Subject: [PATCH 0715/1120] ci: Add CODECOV_TOKEN to upload step

---
 .github/workflows/cygwin.yml | 2 ++
 .github/workflows/tests.yml  | 1 +
 2 files changed, 3 insertions(+)

diff --git a/.github/workflows/cygwin.yml b/.github/workflows/cygwin.yml
index 06d90d4cecbd..fa4e76a773b7 100644
--- a/.github/workflows/cygwin.yml
+++ b/.github/workflows/cygwin.yml
@@ -248,3 +248,5 @@ jobs:
 
       - name: Upload code coverage
         uses: codecov/codecov-action@v4
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 412621f3b6ee..46cc935216be 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -340,6 +340,7 @@ jobs:
         uses: codecov/codecov-action@v4
         with:
           name: "${{ matrix.python-version }} ${{ matrix.os }} ${{ matrix.name-suffix }}"
+          token: ${{ secrets.CODECOV_TOKEN }}
 
       - uses: actions/upload-artifact@v4
         if: failure()

From 7333228f14b308f580712eca507f84940620ff1b Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Thu, 18 Jan 2024 16:14:49 -0500
Subject: [PATCH 0716/1120] prevent merge on label [skip circle] [skip azp]
 [skip appveyor]

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>
---
 .github/workflows/do_not_merge.yml | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)
 create mode 100644 .github/workflows/do_not_merge.yml

diff --git a/.github/workflows/do_not_merge.yml b/.github/workflows/do_not_merge.yml
new file mode 100644
index 000000000000..dde5bfb5ec81
--- /dev/null
+++ b/.github/workflows/do_not_merge.yml
@@ -0,0 +1,30 @@
+---
+name: Do Not Merge
+
+# action to block merging on specific labels
+on:
+  pull_request:
+    types: [synchronize, opened, reopened, labeled, unlabeled]
+
+permissions: {}
+
+jobs:
+  do-not-merge:
+    name: Prevent Merging
+    runs-on: ubuntu-latest
+    env:
+      has_tag: >-
+         ${{contains(github.event.pull_request.labels.*.name, 'status: needs comment/discussion') ||
+            contains(github.event.pull_request.labels.*.name, 'status: waiting for other PR')}}
+    steps:
+      - name: Check for label
+        if: ${{'true' == env.has_tag}}
+        run: |
+          echo "This PR cannot be merged because it has one of the following labels: "
+          echo "* status: needs comment/discussion"
+          echo "* status: waiting for other PR"
+          echo "${{env.has_tag}}"
+          exit 1
+      - name: Allow merging
+        if: ${{'false' == env.has_tag}}
+        run: exit 0

From 7ff4904d4950dad8a522b2a2bc57f1a20e792fb3 Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Sun, 17 Sep 2023 13:51:54 +0200
Subject: [PATCH 0717/1120] Bump minimum NumPy version to 1.23

---
 doc/api/next_api_changes/development/26800-OG.rst | 14 ++++++++++++++
 doc/devel/min_dep_policy.rst                      |  2 ++
 doc/users/installing/dependencies.rst             |  4 ++--
 environment.yml                                   |  2 +-
 lib/matplotlib/__init__.py                        |  2 +-
 pyproject.toml                                    |  2 +-
 requirements/testing/minver.txt                   |  2 +-
 7 files changed, 22 insertions(+), 6 deletions(-)
 create mode 100644 doc/api/next_api_changes/development/26800-OG.rst

diff --git a/doc/api/next_api_changes/development/26800-OG.rst b/doc/api/next_api_changes/development/26800-OG.rst
new file mode 100644
index 000000000000..d536f8240c76
--- /dev/null
+++ b/doc/api/next_api_changes/development/26800-OG.rst
@@ -0,0 +1,14 @@
+Increase to minimum supported versions of dependencies
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+For Matplotlib 3.9, the :ref:`minimum supported versions <dependencies>` are
+being bumped:
+
++------------+-----------------+---------------+
+| Dependency |  min in mpl3.8  | min in mpl3.9 |
++============+=================+===============+
+|   NumPy    |       1.21.0    |      1.23.0   |
++------------+-----------------+---------------+
+
+This is consistent with our :ref:`min_deps_policy` and `NEP29
+<https://numpy.org/neps/nep-0029-deprecation_policy.html>`__
diff --git a/doc/devel/min_dep_policy.rst b/doc/devel/min_dep_policy.rst
index baf6db9811a8..a702b5930fd8 100644
--- a/doc/devel/min_dep_policy.rst
+++ b/doc/devel/min_dep_policy.rst
@@ -88,6 +88,7 @@ specification of the dependencies.
 ==========  ========  ======
 Matplotlib  Python    NumPy
 ==========  ========  ======
+`3.9`_      3.9       1.23.0
 `3.8`_      3.9       1.21.0
 `3.7`_      3.8       1.20.0
 `3.6`_      3.8       1.19.0
@@ -108,6 +109,7 @@ Matplotlib  Python    NumPy
 1.0         2.4       1.1
 ==========  ========  ======
 
+.. _`3.9`: https://matplotlib.org/3.9.0/devel/dependencies.html
 .. _`3.8`: https://matplotlib.org/3.8.0/devel/dependencies.html
 .. _`3.7`: https://matplotlib.org/3.7.0/devel/dependencies.html
 .. _`3.6`: https://matplotlib.org/3.6.0/devel/dependencies.html
diff --git a/doc/users/installing/dependencies.rst b/doc/users/installing/dependencies.rst
index 86e7e1bbe596..fa666d280732 100644
--- a/doc/users/installing/dependencies.rst
+++ b/doc/users/installing/dependencies.rst
@@ -25,7 +25,7 @@ reference.
 * `dateutil <https://pypi.org/project/python-dateutil/>`_ (>= 2.7)
 * `fontTools <https://fonttools.readthedocs.io/en/latest/>`_ (>= 4.22.0)
 * `kiwisolver <https://github.com/nucleic/kiwi>`_ (>= 1.3.1)
-* `NumPy <https://numpy.org>`_ (>= 1.21)
+* `NumPy <https://numpy.org>`_ (>= 1.23)
 * `packaging <https://pypi.org/project/packaging/>`_ (>= 20.0)
 * `Pillow <https://pillow.readthedocs.io/en/latest/>`_ (>= 8.0)
 * `pyparsing <https://pypi.org/project/pyparsing/>`_ (>= 2.3.1)
@@ -238,7 +238,7 @@ then you must manually install the following packages into your development envi
 - `setuptools_scm <https://pypi.org/project/setuptools-scm/>`_ (>= 7).  Used to
   update the reported ``mpl.__version__`` based on the current git commit.
   Also a runtime dependency for editable installs.
-- `NumPy <https://numpy.org>`_ (>= 1.21).  Also a runtime dependency.
+- `NumPy <https://numpy.org>`_ (>= 1.22).  Also a runtime dependency.
 
 
 .. _compile-dependencies:
diff --git a/environment.yml b/environment.yml
index d50e544edb0d..174497df6b4d 100644
--- a/environment.yml
+++ b/environment.yml
@@ -17,7 +17,7 @@ dependencies:
   - kiwisolver>=1.3.1
   - pybind11>=2.6.0
   - meson-python>=0.13.1
-  - numpy>=1.21
+  - numpy>=1.23
   - pillow>=8
   - pkg-config
   - pygobject
diff --git a/lib/matplotlib/__init__.py b/lib/matplotlib/__init__.py
index 5836cd3a2ccf..cc94e530133b 100644
--- a/lib/matplotlib/__init__.py
+++ b/lib/matplotlib/__init__.py
@@ -251,7 +251,7 @@ def _check_versions():
             ("cycler", "0.10"),
             ("dateutil", "2.7"),
             ("kiwisolver", "1.3.1"),
-            ("numpy", "1.21"),
+            ("numpy", "1.23"),
             ("pyparsing", "2.3.1"),
     ]:
         module = importlib.import_module(modname)
diff --git a/pyproject.toml b/pyproject.toml
index d20f76bade39..7661d039d370 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -35,7 +35,7 @@ dependencies = [
     "cycler >= 0.10",
     "fonttools >= 4.22.0",
     "kiwisolver >= 1.3.1",
-    "numpy >= 1.21",
+    "numpy >= 1.23",
     "packaging >= 20.0",
     "pillow >= 8",
     "pyparsing >= 2.3.1",
diff --git a/requirements/testing/minver.txt b/requirements/testing/minver.txt
index b399bd996e08..1a95367eff14 100644
--- a/requirements/testing/minver.txt
+++ b/requirements/testing/minver.txt
@@ -7,7 +7,7 @@ importlib-resources==3.2.0
 kiwisolver==1.3.1
 meson-python==0.13.1
 meson==1.1.0
-numpy==1.21.0
+numpy==1.23.0
 packaging==20.0
 pillow==8.0.0
 pyparsing==2.3.1

From cc845e78da21ee0e4ca719a1cf09f48e4bde868d Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Wed, 31 Jan 2024 15:55:36 -0500
Subject: [PATCH 0718/1120] TST: use our subprocess helper

---
 lib/matplotlib/tests/test_backend_nbagg.py  |  9 ++++++---
 lib/matplotlib/tests/test_backend_webagg.py |  9 +++++----
 lib/matplotlib/tests/test_basic.py          |  8 +++++---
 lib/matplotlib/tests/test_determinism.py    | 10 ++++++----
 lib/matplotlib/tests/test_font_manager.py   | 10 +++++-----
 lib/matplotlib/tests/test_matplotlib.py     |  9 ++++++---
 lib/matplotlib/tests/test_rcparams.py       |  7 ++++---
 lib/matplotlib/tests/test_texmanager.py     |  8 +++++---
 8 files changed, 42 insertions(+), 28 deletions(-)

diff --git a/lib/matplotlib/tests/test_backend_nbagg.py b/lib/matplotlib/tests/test_backend_nbagg.py
index 4ebf3e1f56d1..37b097e9c5f6 100644
--- a/lib/matplotlib/tests/test_backend_nbagg.py
+++ b/lib/matplotlib/tests/test_backend_nbagg.py
@@ -1,10 +1,12 @@
 import os
 from pathlib import Path
-import subprocess
+
 from tempfile import TemporaryDirectory
 
 import pytest
 
+from matplotlib.testing import subprocess_run_for_testing
+
 nbformat = pytest.importorskip('nbformat')
 pytest.importorskip('nbconvert')
 pytest.importorskip('ipykernel')
@@ -17,11 +19,12 @@ def test_ipynb():
 
     with TemporaryDirectory() as tmpdir:
         out_path = Path(tmpdir, "out.ipynb")
-        subprocess.check_call(
+        subprocess_run_for_testing(
             ["jupyter", "nbconvert", "--to", "notebook",
              "--execute", "--ExecutePreprocessor.timeout=500",
              "--output", str(out_path), str(nb_path)],
-            env={**os.environ, "IPYTHONDIR": tmpdir})
+            env={**os.environ, "IPYTHONDIR": tmpdir},
+            check=True)
         with out_path.open() as out:
             nb = nbformat.read(out, nbformat.current_nbformat)
 
diff --git a/lib/matplotlib/tests/test_backend_webagg.py b/lib/matplotlib/tests/test_backend_webagg.py
index 237a279c6352..facdc3205f4b 100644
--- a/lib/matplotlib/tests/test_backend_webagg.py
+++ b/lib/matplotlib/tests/test_backend_webagg.py
@@ -1,9 +1,10 @@
-import subprocess
 import os
 import sys
 import pytest
 import matplotlib.backends.backend_webagg_core
 
+from matplotlib.testing import subprocess_run_for_testing
+
 
 @pytest.mark.parametrize("backend", ["webagg", "nbagg"])
 def test_webagg_fallback(backend):
@@ -23,9 +24,9 @@ def test_webagg_fallback(backend):
         + "print(plt.get_backend());"
         f"assert '{backend}' == plt.get_backend().lower();"
     )
-    ret = subprocess.call([sys.executable, "-c", test_code], env=env)
-
-    assert ret == 0
+    subprocess_run_for_testing(
+        [sys.executable, "-c", test_code], env=env, check=True
+    )
 
 
 def test_webagg_core_no_toolbar():
diff --git a/lib/matplotlib/tests/test_basic.py b/lib/matplotlib/tests/test_basic.py
index 6fad2bacaf3f..6bd417876857 100644
--- a/lib/matplotlib/tests/test_basic.py
+++ b/lib/matplotlib/tests/test_basic.py
@@ -1,9 +1,10 @@
 import builtins
 import os
-import subprocess
 import sys
 import textwrap
 
+from matplotlib.testing import subprocess_run_for_testing
+
 
 def test_simple():
     assert 1 + 1 == 2
@@ -41,6 +42,7 @@ def test_lazy_imports():
     assert 'urllib.request' not in sys.modules
     """)
 
-    subprocess.check_call(
+    subprocess_run_for_testing(
         [sys.executable, '-c', source],
-        env={**os.environ, "MPLBACKEND": "", "MATPLOTLIBRC": os.devnull})
+        env={**os.environ, "MPLBACKEND": "", "MATPLOTLIBRC": os.devnull},
+        check=True)
diff --git a/lib/matplotlib/tests/test_determinism.py b/lib/matplotlib/tests/test_determinism.py
index fe0fb34e128a..92f62f869c4a 100644
--- a/lib/matplotlib/tests/test_determinism.py
+++ b/lib/matplotlib/tests/test_determinism.py
@@ -12,6 +12,7 @@
 import matplotlib.testing.compare
 from matplotlib import pyplot as plt
 from matplotlib.testing._markers import needs_ghostscript, needs_usetex
+from matplotlib.testing import subprocess_run_for_testing
 
 
 def _save_figure(objects='mhi', fmt="pdf", usetex=False):
@@ -89,12 +90,13 @@ def test_determinism_check(objects, fmt, usetex):
         Output format.
     """
     plots = [
-        subprocess.check_output(
+        subprocess_run_for_testing(
             [sys.executable, "-R", "-c",
              f"from matplotlib.tests.test_determinism import _save_figure;"
              f"_save_figure({objects!r}, {fmt!r}, {usetex})"],
             env={**os.environ, "SOURCE_DATE_EPOCH": "946684800",
-                 "MPLBACKEND": "Agg"})
+                 "MPLBACKEND": "Agg"},
+            text=False, capture_output=True, check=True).stdout
         for _ in range(3)
     ]
     for p in plots[1:]:
@@ -129,10 +131,10 @@ def test_determinism_source_date_epoch(fmt, string):
     string : bytes
         Timestamp string for 2000-01-01 00:00 UTC.
     """
-    buf = subprocess.check_output(
+    buf = subprocess_run_for_testing(
         [sys.executable, "-R", "-c",
          f"from matplotlib.tests.test_determinism import _save_figure; "
          f"_save_figure('', {fmt!r})"],
         env={**os.environ, "SOURCE_DATE_EPOCH": "946684800",
-             "MPLBACKEND": "Agg"})
+             "MPLBACKEND": "Agg"}, capture_output=True, text=False, check=True).stdout
     assert string in buf
diff --git a/lib/matplotlib/tests/test_font_manager.py b/lib/matplotlib/tests/test_font_manager.py
index 79121a794d12..545fefebce1c 100644
--- a/lib/matplotlib/tests/test_font_manager.py
+++ b/lib/matplotlib/tests/test_font_manager.py
@@ -5,7 +5,6 @@
 from pathlib import Path
 from PIL import Image
 import shutil
-import subprocess
 import sys
 import warnings
 
@@ -17,6 +16,8 @@
     json_dump, json_load, get_font, is_opentype_cff_font,
     MSUserFontDirectories, _get_fontconfig_fonts, ttfFontProperty)
 from matplotlib import cbook, ft2font, pyplot as plt, rc_context, figure as mfigure
+from matplotlib.testing import subprocess_run_helper
+
 
 has_fclist = shutil.which('fc-list') is not None
 
@@ -275,11 +276,10 @@ def bad_idea(n):
 
 def test_fontcache_thread_safe():
     pytest.importorskip('threading')
-    import inspect
 
-    proc = subprocess.run(
-        [sys.executable, "-c",
-         inspect.getsource(_test_threading) + '\n_test_threading()']
+    proc = subprocess_run_helper(
+        _test_threading,
+        timeout=10
     )
     if proc.returncode:
         pytest.fail("The subprocess returned with non-zero exit status "
diff --git a/lib/matplotlib/tests/test_matplotlib.py b/lib/matplotlib/tests/test_matplotlib.py
index 9ed8c46615bf..d6fc1bb25459 100644
--- a/lib/matplotlib/tests/test_matplotlib.py
+++ b/lib/matplotlib/tests/test_matplotlib.py
@@ -5,6 +5,7 @@
 import pytest
 
 import matplotlib
+from matplotlib.testing import subprocess_run_for_testing
 
 
 @pytest.mark.parametrize('version_str, version_tuple', [
@@ -26,7 +27,7 @@ def test_tmpconfigdir_warning(tmp_path):
     mode = os.stat(tmp_path).st_mode
     try:
         os.chmod(tmp_path, 0)
-        proc = subprocess.run(
+        proc = subprocess_run_for_testing(
             [sys.executable, "-c", "import matplotlib"],
             env={**os.environ, "MPLCONFIGDIR": str(tmp_path)},
             stderr=subprocess.PIPE, text=True, check=True)
@@ -36,7 +37,7 @@ def test_tmpconfigdir_warning(tmp_path):
 
 
 def test_importable_with_no_home(tmp_path):
-    subprocess.run(
+    subprocess_run_for_testing(
         [sys.executable, "-c",
          "import pathlib; pathlib.Path.home = lambda *args: 1/0; "
          "import matplotlib.pyplot"],
@@ -74,4 +75,6 @@ def test_importable_with__OO():
         "import matplotlib.patches as mpatches"
     )
     cmd = [sys.executable, "-OO", "-c", program]
-    assert subprocess.call(cmd, env={**os.environ, "MPLBACKEND": ""}) == 0
+    subprocess_run_for_testing(
+        cmd, env={**os.environ, "MPLBACKEND": ""}, check=True
+        )
diff --git a/lib/matplotlib/tests/test_rcparams.py b/lib/matplotlib/tests/test_rcparams.py
index 782c390c9462..4823df0ce250 100644
--- a/lib/matplotlib/tests/test_rcparams.py
+++ b/lib/matplotlib/tests/test_rcparams.py
@@ -29,6 +29,7 @@
     validate_sketch,
     _validate_linestyle,
     _listify_validator)
+from matplotlib.testing import subprocess_run_for_testing
 
 
 def test_rcparams(tmp_path):
@@ -524,7 +525,7 @@ def test_backend_fallback_headless(tmp_path):
            "DISPLAY": "", "WAYLAND_DISPLAY": "",
            "MPLBACKEND": "", "MPLCONFIGDIR": str(tmp_path)}
     with pytest.raises(subprocess.CalledProcessError):
-        subprocess.run(
+        subprocess_run_for_testing(
             [sys.executable, "-c",
              "import matplotlib;"
              "matplotlib.use('tkagg');"
@@ -540,7 +541,7 @@ def test_backend_fallback_headless(tmp_path):
 def test_backend_fallback_headful(tmp_path):
     pytest.importorskip("tkinter")
     env = {**os.environ, "MPLBACKEND": "", "MPLCONFIGDIR": str(tmp_path)}
-    backend = subprocess.check_output(
+    backend = subprocess_run_for_testing(
         [sys.executable, "-c",
          "import matplotlib as mpl; "
          "sentinel = mpl.rcsetup._auto_backend_sentinel; "
@@ -549,7 +550,7 @@ def test_backend_fallback_headful(tmp_path):
          "assert mpl.rcParams._get('backend') == sentinel; "
          "import matplotlib.pyplot; "
          "print(matplotlib.get_backend())"],
-        env=env, text=True)
+        env=env, text=True, check=True, capture_output=True).stdout
     # The actual backend will depend on what's installed, but at least tkagg is
     # present.
     assert backend.strip().lower() != "agg"
diff --git a/lib/matplotlib/tests/test_texmanager.py b/lib/matplotlib/tests/test_texmanager.py
index fbff21144e60..8efe45fc8a22 100644
--- a/lib/matplotlib/tests/test_texmanager.py
+++ b/lib/matplotlib/tests/test_texmanager.py
@@ -1,7 +1,7 @@
 import os
 from pathlib import Path
 import re
-import subprocess
+
 import sys
 
 import matplotlib.pyplot as plt
@@ -9,6 +9,8 @@
 from matplotlib.testing._markers import needs_usetex
 import pytest
 
+from matplotlib.testing import subprocess_run_for_testing
+
 
 def test_fontconfig_preamble():
     """Test that the preamble is included in the source."""
@@ -64,11 +66,11 @@ def test_unicode_characters():
 
 @needs_usetex
 def test_openin_any_paranoid():
-    completed = subprocess.run(
+    completed = subprocess_run_for_testing(
         [sys.executable, "-c",
          'import matplotlib.pyplot as plt;'
          'plt.rcParams.update({"text.usetex": True});'
          'plt.title("paranoid");'
          'plt.show(block=False);'],
         env={**os.environ, 'openin_any': 'p'}, check=True, capture_output=True)
-    assert completed.stderr == b""
+    assert completed.stderr == ""

From 05158614a1571a012797ab4f2772d80fd2f9b952 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Thu, 8 Feb 2024 16:39:30 -0500
Subject: [PATCH 0719/1120] STY: formatting and import sorting

---
 lib/matplotlib/tests/test_backend_nbagg.py  | 1 -
 lib/matplotlib/tests/test_backend_webagg.py | 6 ++----
 lib/matplotlib/tests/test_determinism.py    | 1 -
 lib/matplotlib/tests/test_font_manager.py   | 8 +-------
 lib/matplotlib/tests/test_matplotlib.py     | 4 ++--
 lib/matplotlib/tests/test_texmanager.py     | 7 +++----
 6 files changed, 8 insertions(+), 19 deletions(-)

diff --git a/lib/matplotlib/tests/test_backend_nbagg.py b/lib/matplotlib/tests/test_backend_nbagg.py
index 37b097e9c5f6..40bee8f85c43 100644
--- a/lib/matplotlib/tests/test_backend_nbagg.py
+++ b/lib/matplotlib/tests/test_backend_nbagg.py
@@ -1,6 +1,5 @@
 import os
 from pathlib import Path
-
 from tempfile import TemporaryDirectory
 
 import pytest
diff --git a/lib/matplotlib/tests/test_backend_webagg.py b/lib/matplotlib/tests/test_backend_webagg.py
index facdc3205f4b..1d6769494ef9 100644
--- a/lib/matplotlib/tests/test_backend_webagg.py
+++ b/lib/matplotlib/tests/test_backend_webagg.py
@@ -1,8 +1,8 @@
 import os
 import sys
 import pytest
-import matplotlib.backends.backend_webagg_core
 
+import matplotlib.backends.backend_webagg_core
 from matplotlib.testing import subprocess_run_for_testing
 
 
@@ -24,9 +24,7 @@ def test_webagg_fallback(backend):
         + "print(plt.get_backend());"
         f"assert '{backend}' == plt.get_backend().lower();"
     )
-    subprocess_run_for_testing(
-        [sys.executable, "-c", test_code], env=env, check=True
-    )
+    subprocess_run_for_testing([sys.executable, "-c", test_code], env=env, check=True)
 
 
 def test_webagg_core_no_toolbar():
diff --git a/lib/matplotlib/tests/test_determinism.py b/lib/matplotlib/tests/test_determinism.py
index 92f62f869c4a..3865dbc7fa43 100644
--- a/lib/matplotlib/tests/test_determinism.py
+++ b/lib/matplotlib/tests/test_determinism.py
@@ -3,7 +3,6 @@
 """
 
 import os
-import subprocess
 import sys
 
 import pytest
diff --git a/lib/matplotlib/tests/test_font_manager.py b/lib/matplotlib/tests/test_font_manager.py
index 545fefebce1c..9563e4bf0869 100644
--- a/lib/matplotlib/tests/test_font_manager.py
+++ b/lib/matplotlib/tests/test_font_manager.py
@@ -277,13 +277,7 @@ def bad_idea(n):
 def test_fontcache_thread_safe():
     pytest.importorskip('threading')
 
-    proc = subprocess_run_helper(
-        _test_threading,
-        timeout=10
-    )
-    if proc.returncode:
-        pytest.fail("The subprocess returned with non-zero exit status "
-                    f"{proc.returncode}.")
+    subprocess_run_helper(_test_threading, timeout=10)
 
 
 def test_fontentry_dataclass():
diff --git a/lib/matplotlib/tests/test_matplotlib.py b/lib/matplotlib/tests/test_matplotlib.py
index d6fc1bb25459..a1aa4ec212d6 100644
--- a/lib/matplotlib/tests/test_matplotlib.py
+++ b/lib/matplotlib/tests/test_matplotlib.py
@@ -74,7 +74,7 @@ def test_importable_with__OO():
         "import matplotlib.cbook as cbook; "
         "import matplotlib.patches as mpatches"
     )
-    cmd = [sys.executable, "-OO", "-c", program]
     subprocess_run_for_testing(
-        cmd, env={**os.environ, "MPLBACKEND": ""}, check=True
+        [sys.executable, "-OO", "-c", program],
+        env={**os.environ, "MPLBACKEND": ""}, check=True
         )
diff --git a/lib/matplotlib/tests/test_texmanager.py b/lib/matplotlib/tests/test_texmanager.py
index 8efe45fc8a22..64dcbf46456d 100644
--- a/lib/matplotlib/tests/test_texmanager.py
+++ b/lib/matplotlib/tests/test_texmanager.py
@@ -1,15 +1,14 @@
 import os
 from pathlib import Path
 import re
-
 import sys
 
-import matplotlib.pyplot as plt
-from matplotlib.texmanager import TexManager
-from matplotlib.testing._markers import needs_usetex
 import pytest
 
+import matplotlib.pyplot as plt
 from matplotlib.testing import subprocess_run_for_testing
+from matplotlib.testing._markers import needs_usetex
+from matplotlib.texmanager import TexManager
 
 
 def test_fontconfig_preamble():

From 481969254326e4e87efffaa48783816c8f3c13e1 Mon Sep 17 00:00:00 2001
From: saranti <tsarantis@proton.me>
Date: Fri, 9 Feb 2024 16:58:13 +1100
Subject: [PATCH 0720/1120] increase size of legend in example

---
 galleries/users_explain/axes/legend_guide.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/galleries/users_explain/axes/legend_guide.py b/galleries/users_explain/axes/legend_guide.py
index 2ddf3e757850..94eade8c6221 100644
--- a/galleries/users_explain/axes/legend_guide.py
+++ b/galleries/users_explain/axes/legend_guide.py
@@ -260,7 +260,7 @@
 line1, = ax.plot([3, 2, 1], marker='o', label='Line 1')
 line2, = ax.plot([1, 2, 3], marker='o', label='Line 2')
 
-ax.legend(handler_map={line1: HandlerLine2D(numpoints=4)})
+ax.legend(handler_map={line1: HandlerLine2D(numpoints=4)}, handlelength=4)
 
 # %%
 # As you can see, "Line 1" now has 4 marker points, where "Line 2" has 2 (the

From 896d6809c59c3d284592bb861717734e131f9ec5 Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Sat, 10 Feb 2024 14:52:08 +0000
Subject: [PATCH 0721/1120] MNT: deprecate draw method args and kwargs

---
 doc/api/next_api_changes/deprecations/27768-REC.rst | 5 +++++
 galleries/examples/misc/demo_ribbon_box.py          | 4 ++--
 lib/matplotlib/axis.py                              | 2 ++
 lib/matplotlib/image.py                             | 2 ++
 4 files changed, 11 insertions(+), 2 deletions(-)
 create mode 100644 doc/api/next_api_changes/deprecations/27768-REC.rst

diff --git a/doc/api/next_api_changes/deprecations/27768-REC.rst b/doc/api/next_api_changes/deprecations/27768-REC.rst
new file mode 100644
index 000000000000..357545a41efe
--- /dev/null
+++ b/doc/api/next_api_changes/deprecations/27768-REC.rst
@@ -0,0 +1,5 @@
+``[XYZ]Axis.draw``, ``*Image.draw`` *args* and *kwargs*...
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+... are deprecated because they have no effect.  This will make the calling sequence
+consistent with the ``draw`` method of other artists.
diff --git a/galleries/examples/misc/demo_ribbon_box.py b/galleries/examples/misc/demo_ribbon_box.py
index 6e79e6f9fde1..d5121ba6ff5c 100644
--- a/galleries/examples/misc/demo_ribbon_box.py
+++ b/galleries/examples/misc/demo_ribbon_box.py
@@ -49,7 +49,7 @@ def __init__(self, ax, bbox, color, *, extent=(0, 1, 0, 1), **kwargs):
         self._ribbonbox = RibbonBox(color)
         self.set_transform(BboxTransformTo(bbox))
 
-    def draw(self, renderer, *args, **kwargs):
+    def draw(self, renderer):
         stretch_factor = self._bbox.height / self._bbox.width
 
         ny = int(stretch_factor*self._ribbonbox.nx)
@@ -57,7 +57,7 @@ def draw(self, renderer, *args, **kwargs):
             arr = self._ribbonbox.get_stretched_image(stretch_factor)
             self.set_array(arr)
 
-        super().draw(renderer, *args, **kwargs)
+        super().draw(renderer)
 
 
 def main():
diff --git a/lib/matplotlib/axis.py b/lib/matplotlib/axis.py
index 9d478d30f77c..b4d2810b67b8 100644
--- a/lib/matplotlib/axis.py
+++ b/lib/matplotlib/axis.py
@@ -1373,6 +1373,8 @@ def get_tick_padding(self):
             values.append(self.minorTicks[0].get_tick_padding())
         return max(values, default=0)
 
+    @_api.delete_parameter('3.9', 'args')
+    @_api.delete_parameter('3.9', 'kwargs')
     @martist.allow_rasterization
     def draw(self, renderer, *args, **kwargs):
         # docstring inherited
diff --git a/lib/matplotlib/image.py b/lib/matplotlib/image.py
index e3269062699c..4673c6c4d529 100644
--- a/lib/matplotlib/image.py
+++ b/lib/matplotlib/image.py
@@ -626,6 +626,8 @@ def _check_unsampled_image(self):
         """
         return False
 
+    @_api.delete_parameter('3.9', 'args')
+    @_api.delete_parameter('3.9', 'kwargs')
     @martist.allow_rasterization
     def draw(self, renderer, *args, **kwargs):
         # if not visible, declare victory and return

From b06c5b788c05be46b5a1e9d1b3d3d041b260bc25 Mon Sep 17 00:00:00 2001
From: saranti <tsarantis@proton.me>
Date: Sun, 11 Feb 2024 17:43:27 +1100
Subject: [PATCH 0722/1120] add small explanation

---
 galleries/users_explain/axes/legend_guide.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/galleries/users_explain/axes/legend_guide.py b/galleries/users_explain/axes/legend_guide.py
index 94eade8c6221..28311fce1ab7 100644
--- a/galleries/users_explain/axes/legend_guide.py
+++ b/galleries/users_explain/axes/legend_guide.py
@@ -264,7 +264,9 @@
 
 # %%
 # As you can see, "Line 1" now has 4 marker points, where "Line 2" has 2 (the
-# default). Try the above code, only change the map's key from ``line1`` to
+# default). We have also increased the length of the handles with the
+# ``handlelength`` keyword to fit the larger legend entry.
+# Try the above code, only change the map's key from ``line1`` to
 # ``type(line1)``. Notice how now both `.Line2D` instances get 4 markers.
 #
 # Along with handlers for complex plot types such as errorbars, stem plots

From 2a59cb2e6760cc43f1a28d553dbe6c94c381de3b Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Mon, 12 Feb 2024 00:36:40 +0100
Subject: [PATCH 0723/1120] Add marker-only and line+marker visuals to the
 plot() plot types

Inspired from the discussion in #27765: We should visually communicate
that `plot()` covers all three variants: markers only,
line+markers, line-only.
They are visually distinct enough that it's not possible
to infer the variants if you see only one.
In particular, it's important to communicate that you
can draw markers only. We don't want to automatically drive people who
want markers (e.g. some discrete measurements of a dependent variable y
(x)) to scatter because that's the only one showing
 discrete markers in the overview.
---
 galleries/plot_types/basic/plot.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/galleries/plot_types/basic/plot.py b/galleries/plot_types/basic/plot.py
index 3808137e52fd..e494fdf24918 100644
--- a/galleries/plot_types/basic/plot.py
+++ b/galleries/plot_types/basic/plot.py
@@ -13,12 +13,16 @@
 
 # make data
 x = np.linspace(0, 10, 100)
-y = 4 + 2 * np.sin(2 * x)
+y = 4 + 1 * np.sin(2 * x)
+x2 = np.linspace(0, 10, 25)
+y2 = 4 + 1 * np.sin(2 * x2)
 
 # plot
 fig, ax = plt.subplots()
 
+ax.plot(x2, y2 + 2.5, 'x', markeredgewidth=2)
 ax.plot(x, y, linewidth=2.0)
+ax.plot(x2, y2 - 2.5, 'o-', linewidth=2)
 
 ax.set(xlim=(0, 8), xticks=np.arange(1, 8),
        ylim=(0, 8), yticks=np.arange(1, 8))

From 90a3971386cf7c8a5f1fcda33060d4c0978950e7 Mon Sep 17 00:00:00 2001
From: Jody Klymak <jklymak@gmail.com>
Date: Sun, 11 Feb 2024 18:07:53 -0800
Subject: [PATCH 0724/1120] MNT: make pcolormesh more robust to masked array
 underflow

---
 lib/matplotlib/axes/_axes.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index b1aeb87e6b45..711d930a1253 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -5883,7 +5883,7 @@ def _pcolorargs(self, funcname, *args, shading='auto', **kwargs):
                 def _interp_grid(X):
                     # helper for below
                     if np.shape(X)[1] > 1:
-                        dX = np.diff(X, axis=1)/2.
+                        dX = np.diff(X, axis=1) * 0.5
                         if not (np.all(dX >= 0) or np.all(dX <= 0)):
                             _api.warn_external(
                                 f"The input coordinates to {funcname} are "

From 585bdce87ff005dc7c8d448ef523f0f636458362 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Mon, 12 Feb 2024 13:47:49 +0100
Subject: [PATCH 0725/1120] Better document the relation between figure and
 manager

Closes #27774.
---
 lib/matplotlib/backend_bases.py | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
index fccde841aadc..a353500f8725 100644
--- a/lib/matplotlib/backend_bases.py
+++ b/lib/matplotlib/backend_bases.py
@@ -2607,9 +2607,13 @@ class FigureManagerBase:
     backend-independent way. It's an adapter for the real (GUI) framework that
     represents the visual figure on screen.
 
-    GUI backends define from this class to translate common operations such
+    The figure manager is connected to a specific canvas instance, which in turn
+    is connected to a specific figure instance. To access a figure manager for
+    a given figure in user code, you typically use ``fig.canvas.manager``.
+
+    GUI backends derive from this class to translate common operations such
     as *show* or *resize* to the GUI-specific code. Non-GUI backends do not
-    support these operations an can just use the base class.
+    support these operations and can just use the base class.
 
     This following basic operations are accessible:
 
@@ -2794,6 +2798,11 @@ def set_window_title(self, title):
         Set the title text of the window containing the figure.
 
         This has no effect for non-GUI (e.g., PS) backends.
+
+        Examples
+        --------
+        >>> fig = plt.figure()
+        >>> fig.canvas.manager.set_window_title('My figure')
         """
 
 

From 793f1dfc4d9f5ab3021d16580c3010c1a792dc38 Mon Sep 17 00:00:00 2001
From: Jody Klymak <jklymak@gmail.com>
Date: Mon, 12 Feb 2024 07:56:09 -0800
Subject: [PATCH 0726/1120] TST: add a test for pcolormesh underflow

---
 lib/matplotlib/tests/test_axes.py | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index 5bf5b5e19971..f2f74f845338 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -1517,6 +1517,19 @@ def test_pcolorargs():
         ax.pcolormesh(X, Y, Z, shading='auto')
 
 
+def test_pcolormesh_underflow_error():
+    """
+    Test that underflow errors don't crop up in pcolormesh.  Probably
+    a numpy bug (https://github.com/numpy/numpy/issues/25810).
+    """
+    with np.errstate(under="raise"):
+        x = np.arange(0, 3, 0.1)
+        y = np.arange(0, 6, 0.1)
+        z = np.random.randn(len(y), len(x))
+        fig, ax = plt.subplots()
+        ax.pcolormesh(x, y, z)
+
+
 def test_pcolorargs_with_read_only():
     x = np.arange(6).reshape(2, 3)
     xmask = np.broadcast_to([False, True, False], x.shape)  # read-only array

From f763aae19b6280e4890910ac9add66d6b8b636a4 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Mon, 12 Feb 2024 12:11:21 -0600
Subject: [PATCH 0727/1120] Update stubtest delete_parameter for varargs/kwargs

---
 tools/stubtest.py | 35 +++++++++++++++++++++++++++--------
 1 file changed, 27 insertions(+), 8 deletions(-)

diff --git a/tools/stubtest.py b/tools/stubtest.py
index 7c93d2dae157..77676595cbf8 100644
--- a/tools/stubtest.py
+++ b/tools/stubtest.py
@@ -18,14 +18,33 @@ def __init__(self, filepath, output):
         self.output = output
 
     def visit_FunctionDef(self, node):
-        if any("delete_parameter" in ast.unparse(line) for line in node.decorator_list):
-            parents = []
-            if hasattr(node, "parent"):
-                parent = node.parent
-                while hasattr(parent, "parent") and not isinstance(parent, ast.Module):
-                    parents.insert(0, parent.name)
-                    parent = parent.parent
-            self.output.write(f"{'.'.join(self.context + parents)}.{node.name}\n")
+        # delete_parameter adds a private sentinel value that leaks
+        # we do not want that sentinel value in the type hints but it breaks typing
+        # Does not apply to variadic arguments (args/kwargs)
+        for dec in node.decorator_list:
+            if "delete_parameter" in ast.unparse(dec):
+                deprecated_arg = dec.args[1].value
+                if (
+                    node.args.vararg is not None
+                    and node.args.vararg.arg == deprecated_arg
+                ):
+                    continue
+                if (
+                    node.args.kwarg is not None
+                    and node.args.kwarg.arg == deprecated_arg
+                ):
+                    continue
+
+                parents = []
+                if hasattr(node, "parent"):
+                    parent = node.parent
+                    while hasattr(parent, "parent") and not isinstance(
+                        parent, ast.Module
+                    ):
+                        parents.insert(0, parent.name)
+                        parent = parent.parent
+                self.output.write(f"{'.'.join(self.context + parents)}.{node.name}\n")
+                break
 
     def visit_ClassDef(self, node):
         for dec in node.decorator_list:

From b9a45d9ad09380f0a91e01faf474fa79f40a0cfb Mon Sep 17 00:00:00 2001
From: samGreer <93655422+samGreer@users.noreply.github.com>
Date: Mon, 12 Feb 2024 19:33:07 -0500
Subject: [PATCH 0728/1120] Update README.md to fix citation link

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index fc3abb7e197c..5e15c645c9a2 100644
--- a/README.md
+++ b/README.md
@@ -69,5 +69,5 @@ If Matplotlib contributes to a project that leads to publication, please
 acknowledge this by citing Matplotlib.
 
 [A ready-made citation
-entry](https://matplotlib.org/stable/project/citing.html) is
+entry](https://matplotlib.org/stable/users/project/citing.html) is
 available.

From 1defb5798bcb0ed7c0869e86bd00ea98ae77e700 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Tue, 13 Feb 2024 13:28:13 +0100
Subject: [PATCH 0729/1120] Simplify example: Box plots with custom fill colors
 (#27781)

Simplify example: Box plots with custom fill colors

The [original example](https://matplotlib.org/3.8
.0/gallery/statistics/boxplot_color.html) was more complex than need be:

- The two plots only differed in the `notch=True` parameter,
  which is irrelevant for custom fill colors
  -> reduce to one
- rework to a more realistic-like plot

---------

Co-authored-by: Ruth Comer <10599679+rcomer@users.noreply.github.com>
---
 .../examples/statistics/boxplot_color.py      | 58 +++++++------------
 1 file changed, 20 insertions(+), 38 deletions(-)

diff --git a/galleries/examples/statistics/boxplot_color.py b/galleries/examples/statistics/boxplot_color.py
index eb3273e34717..496844236323 100644
--- a/galleries/examples/statistics/boxplot_color.py
+++ b/galleries/examples/statistics/boxplot_color.py
@@ -3,52 +3,34 @@
 Box plots with custom fill colors
 =================================
 
-This plot illustrates how to create two types of box plots
-(rectangular and notched), and how to fill them with custom
-colors by accessing the properties of the artists of the
-box plots. Additionally, the ``labels`` parameter is used to
-provide x-tick labels for each sample.
-
-A good general reference on boxplots and their history can be found
-here: http://vita.had.co.nz/papers/boxplots.pdf
+To color each box of a box plot individually:
+
+1) use the keyword argument ``patch_artist=True`` to create filled boxes.
+2) loop through the created boxes and adapt their color.
 """
 
 import matplotlib.pyplot as plt
 import numpy as np
 
-# Random test data
 np.random.seed(19680801)
-all_data = [np.random.normal(0, std, size=100) for std in range(1, 4)]
-labels = ['x1', 'x2', 'x3']
-
-fig, (ax1, ax2) = plt.subplots(nrows=1, ncols=2, figsize=(9, 4))
-
-# rectangular box plot
-bplot1 = ax1.boxplot(all_data,
-                     vert=True,  # vertical box alignment
-                     patch_artist=True,  # fill with color
-                     labels=labels)  # will be used to label x-ticks
-ax1.set_title('Rectangular box plot')
-
-# notch shape box plot
-bplot2 = ax2.boxplot(all_data,
-                     notch=True,  # notch shape
-                     vert=True,  # vertical box alignment
-                     patch_artist=True,  # fill with color
-                     labels=labels)  # will be used to label x-ticks
-ax2.set_title('Notched box plot')
+fruit_weights = [
+    np.random.normal(130, 10, size=100),
+    np.random.normal(125, 20, size=100),
+    np.random.normal(120, 30, size=100),
+]
+labels = ['peaches', 'oranges', 'tomatoes']
+colors = ['peachpuff', 'orange', 'tomato']
+
+fig, ax = plt.subplots()
+ax.set_ylabel('fruit weight (g)')
+
+bplot = ax.boxplot(fruit_weights,
+                   patch_artist=True,  # fill with color
+                   labels=labels)  # will be used to label x-ticks
 
 # fill with colors
-colors = ['pink', 'lightblue', 'lightgreen']
-for bplot in (bplot1, bplot2):
-    for patch, color in zip(bplot['boxes'], colors):
-        patch.set_facecolor(color)
-
-# adding horizontal grid lines
-for ax in [ax1, ax2]:
-    ax.yaxis.grid(True)
-    ax.set_xlabel('Three separate samples')
-    ax.set_ylabel('Observed values')
+for patch, color in zip(bplot['boxes'], colors):
+    patch.set_facecolor(color)
 
 plt.show()
 

From 41bf7cc1a17daf23d9eb711698b28b47f443f7c5 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Tue, 13 Feb 2024 10:53:09 -0500
Subject: [PATCH 0730/1120] FIX: be careful about communicating with subprocess

On windows on py312 we can not use `.communicate` during process shutdown
because it internally uses Python threads which can no longer be created during
interpreter shutdown.

Closes #27437
---
 lib/matplotlib/backends/backend_pgf.py | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/backends/backend_pgf.py b/lib/matplotlib/backends/backend_pgf.py
index 78d15fe29b88..ba01622bd068 100644
--- a/lib/matplotlib/backends/backend_pgf.py
+++ b/lib/matplotlib/backends/backend_pgf.py
@@ -257,7 +257,8 @@ def _setup_latex_process(self, *, expect_reply=True):
         # Open LaTeX process for real work; register it for deletion.  On
         # Windows, we must ensure that the subprocess has quit before being
         # able to delete the tmpdir in which it runs; in order to do so, we
-        # must first `kill()` it, and then `communicate()` with it.
+        # must first `kill()` it, and then `communicate()` with or `wait()` on
+        # it.
         try:
             self.latex = subprocess.Popen(
                 [mpl.rcParams["pgf.texsystem"], "-halt-on-error"],
@@ -274,7 +275,10 @@ def _setup_latex_process(self, *, expect_reply=True):
 
         def finalize_latex(latex):
             latex.kill()
-            latex.communicate()
+            try:
+                latex.communicate()
+            except RuntimeError:
+                latex.wait()
 
         self._finalize_latex = weakref.finalize(
             self, finalize_latex, self.latex)

From 3dfcb519887a9f24de6fdee9ce7d60ff5ca888de Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Tue, 13 Feb 2024 00:05:59 +0100
Subject: [PATCH 0731/1120] Partly revert #27711

This PR removes the propagation of `labels` to any artist legend labels.

Other than the rest of the plotting functions `labels` is not used for legend labels
but for xtick labels. This is only poorly documented via
https://matplotlib.org/stable/api/_as_gen/matplotlib.axes.Axes.bxp.html and in an
[example](https://matplotlib.org/stable/gallery/statistics/boxplot_color.html).

Whatever our way forward regarding the use of `labels` is, we should by no means
propagate them simultaneously to xticks and legend entries. This coupling would cripple
users' configurability and limit our ability to migrate to a clear API where legend
labels and tick labels can be configured independently.

Until we have sorted out a better API, the recommended solution for the original issue
#20512 is to grab the artists returned from `boxplot()` and either `set_label()` on
them or pass them to the legend call `ax.legend(handles, labels)`.
---
 lib/matplotlib/axes/_axes.py        |  6 ++---
 lib/matplotlib/tests/test_legend.py | 41 +++++++++--------------------
 2 files changed, 15 insertions(+), 32 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index b1aeb87e6b45..9eaf2dc331ed 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -3885,7 +3885,8 @@ def boxplot(self, x, notch=None, sym=None, vert=None, whis=None,
             boxes are drawn with Patch artists.
 
         labels : sequence, optional
-            Labels for each dataset (one per dataset).
+            Labels for each dataset (one per dataset). These are used for
+            x-tick labels; *not* for legend entries.
 
         manage_ticks : bool, default: True
             If True, the tick locations and labels will be adjusted to match
@@ -4004,9 +4005,6 @@ def boxplot(self, x, notch=None, sym=None, vert=None, whis=None,
             if 'color' in boxprops:
                 boxprops['edgecolor'] = boxprops.pop('color')
 
-        if labels:
-            boxprops['label'] = labels
-
         # if non-default sym value, put it into the flier dictionary
         # the logic for providing the default symbol ('b+') now lives
         # in bxp in the initial value of flierkw
diff --git a/lib/matplotlib/tests/test_legend.py b/lib/matplotlib/tests/test_legend.py
index 820f9d967f24..b23649f22e48 100644
--- a/lib/matplotlib/tests/test_legend.py
+++ b/lib/matplotlib/tests/test_legend.py
@@ -1429,31 +1429,16 @@ def test_legend_text():
     assert_allclose(leg_bboxes[1].bounds, leg_bboxes[0].bounds)
 
 
-def test_boxplot_legend():
-    # Test that boxplot legends handles are patches
-    # and labels are generated from boxplot's labels parameter.
-    fig, axs = plt.subplots()
-    A = 5*np.random.rand(100, 1)
-    B = 10*np.random.rand(100, 1) - 5
-    C = 7*np.random.rand(100, 1) - 5
-    labels = ['a', 'b', 'c']
-
-    bp0 = axs.boxplot(A, positions=[0], patch_artist=True, labels=labels[0])
-    bp1 = axs.boxplot(B, positions=[1], patch_artist=True, labels=labels[1])
-    bp2 = axs.boxplot(C, positions=[2], patch_artist=True, labels=labels[2])
-    # red, blue, green
-    colors = [(1.0, 0.0, 0.0, 1), (0.0, 0.0, 1.0, 1), (0.0, 0.5, 0.0, 1)]
-    box_list = [bp0, bp1, bp2]
-    # Set colors to the boxes
-    lbl_index = 0
-    for b_plot, color in zip(box_list, colors):
-        for patch in b_plot['boxes']:
-            patch.set_color(color)
-            lbl_index += 1
-
-    legend = axs.legend()
-    for index, handle in enumerate(legend.legend_handles):
-        assert isinstance(handle, mpl.patches.Rectangle)
-        assert handle.get_facecolor() == colors[index]
-        assert handle.get_edgecolor() == colors[index]
-        assert handle.get_label() == labels[index]
+def test_boxplot_labels():
+    # Test that boxplot(..., labels=) sets the tick labels but not legend entries
+    # This is not consistent with other plot types but is the current behavior.
+    fig, ax = plt.subplots()
+    np.random.seed(19680801)
+    data = np.random.random((10, 3))
+    bp = ax.boxplot(data, labels=['A', 'B', 'C'])
+    # Check that labels set the tick labels ...
+    assert [l.get_text() for l in ax.get_xticklabels()] == ['A', 'B', 'C']
+    # ... but not legend entries
+    handles, labels = ax.get_legend_handles_labels()
+    assert len(handles) == 0
+    assert len(labels) == 0

From 262ccbad35d003013d001665c37d6aaad7db011b Mon Sep 17 00:00:00 2001
From: David Gilbertson <gilbertson.david@gmail.com>
Date: Thu, 15 Feb 2024 15:31:32 +1100
Subject: [PATCH 0732/1120] Update figure_size_units.py

Remove old reference to 72 DPI
---
 .../subplots_axes_and_figures/figure_size_units.py       | 9 +--------
 1 file changed, 1 insertion(+), 8 deletions(-)

diff --git a/galleries/examples/subplots_axes_and_figures/figure_size_units.py b/galleries/examples/subplots_axes_and_figures/figure_size_units.py
index 4b87ff658f97..f4610b7cdd1d 100644
--- a/galleries/examples/subplots_axes_and_figures/figure_size_units.py
+++ b/galleries/examples/subplots_axes_and_figures/figure_size_units.py
@@ -57,19 +57,12 @@
 # tedious for quick iterations.
 #
 # Because of the default ``rcParams['figure.dpi'] = 100``, one can mentally
-# divide the needed pixel value by 100 [#]_:
+# divide the needed pixel value by 100:
 #
 plt.subplots(figsize=(6, 2))
 plt.text(0.5, 0.5, '600px x 200px', **text_kwargs)
 plt.show()
 
-# %%
-# .. [#] Unfortunately, this does not work well for the ``matplotlib inline``
-#        backend in Jupyter because that backend uses a different default of
-#        ``rcParams['figure.dpi'] = 72``. Additionally, it saves the figure
-#        with ``bbox_inches='tight'``, which crops the figure and makes the
-#        actual size unpredictable.
-
 # %%
 #
 # .. admonition:: References

From aa176c7b4de01551aee51087b04df40be93a4b01 Mon Sep 17 00:00:00 2001
From: Jacob Tomlinson <jtomlinson@nvidia.com>
Date: Thu, 15 Feb 2024 10:12:18 +0000
Subject: [PATCH 0733/1120] Add EffVer badge

---
 README.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/README.md b/README.md
index 5e15c645c9a2..4b91b0dd8aff 100644
--- a/README.md
+++ b/README.md
@@ -12,6 +12,7 @@
 [![Azure pipelines status](https://dev.azure.com/matplotlib/matplotlib/_apis/build/status/matplotlib.matplotlib?branchName=main)](https://dev.azure.com/matplotlib/matplotlib/_build/latest?definitionId=1&branchName=main)
 [![AppVeyor status](https://ci.appveyor.com/api/projects/status/github/matplotlib/matplotlib?branch=main&svg=true)](https://ci.appveyor.com/project/matplotlib/matplotlib)
 [![Codecov status](https://codecov.io/github/matplotlib/matplotlib/badge.svg?branch=main&service=github)](https://app.codecov.io/gh/matplotlib/matplotlib)
+[![EffVer Versioning](https://img.shields.io/badge/version_scheme-EffVer-0097a7)](https://jacobtomlinson.dev/effver)
 
 ![Matplotlib logotype](https://matplotlib.org/_static/logo2.svg)
 

From ffc7ab0990cf994f08fee286db326a2c28a8fce3 Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Sat, 10 Feb 2024 14:02:12 +0000
Subject: [PATCH 0734/1120] Update handling of sequence labels for plot

---
 .../next_api_changes/behavior/27767-REC.rst   |  7 +++++++
 .../deprecations/27767-REC.rst                |  9 +++++++++
 lib/matplotlib/axes/_base.py                  | 20 +++++++++++++------
 lib/matplotlib/tests/test_legend.py           | 10 +++++++++-
 4 files changed, 39 insertions(+), 7 deletions(-)
 create mode 100644 doc/api/next_api_changes/behavior/27767-REC.rst
 create mode 100644 doc/api/next_api_changes/deprecations/27767-REC.rst

diff --git a/doc/api/next_api_changes/behavior/27767-REC.rst b/doc/api/next_api_changes/behavior/27767-REC.rst
new file mode 100644
index 000000000000..f6b4dc156732
--- /dev/null
+++ b/doc/api/next_api_changes/behavior/27767-REC.rst
@@ -0,0 +1,7 @@
+Legend labels for ``plot``
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Previously if a sequence was passed to the *label* parameter of `~.Axes.plot` when
+plotting a single dataset, the sequence was automatically cast to string for the legend
+label.  Now, if the sequence has only one element, that element will be the legend
+label.  To keep the old behavior, cast the sequence to string before passing.
diff --git a/doc/api/next_api_changes/deprecations/27767-REC.rst b/doc/api/next_api_changes/deprecations/27767-REC.rst
new file mode 100644
index 000000000000..68781090df0a
--- /dev/null
+++ b/doc/api/next_api_changes/deprecations/27767-REC.rst
@@ -0,0 +1,9 @@
+Legend labels for ``plot``
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Previously if a sequence was passed to the *label* parameter of `~.Axes.plot` when
+plotting a single dataset, the sequence was automatically cast to string for the legend
+label.  This behavior is now deprecated and in future will error if the sequence length
+is not one (consistent with multi-dataset behavior, where the number of elements must
+match the number of datasets).  To keep the old behavior, cast the sequence to string
+before passing.
diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index 51347f08b989..0617fc7681bd 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -513,14 +513,22 @@ def _plot_args(self, axes, tup, kwargs, *,
 
         label = kwargs.get('label')
         n_datasets = max(ncx, ncy)
-        if n_datasets > 1 and not cbook.is_scalar_or_string(label):
-            if len(label) != n_datasets:
-                raise ValueError(f"label must be scalar or have the same "
-                                 f"length as the input data, but found "
-                                 f"{len(label)} for {n_datasets} datasets.")
+
+        if cbook.is_scalar_or_string(label):
+            labels = [label] * n_datasets
+        elif len(label) == n_datasets:
             labels = label
+        elif n_datasets == 1:
+            msg = (f'Passing label as a length {len(label)} sequence when '
+                    'plotting a single dataset is deprecated in Matplotlib 3.9 '
+                    'and will error in 3.11.  To keep the current behavior, '
+                    'cast the sequence to string before passing.')
+            _api.warn_deprecated('3.9', message=msg)
+            labels = [label]
         else:
-            labels = [label] * n_datasets
+            raise ValueError(
+                f"label must be scalar or have the same length as the input "
+                f"data, but found {len(label)} for {n_datasets} datasets.")
 
         result = (make_artist(axes, x[:, j % ncx], y[:, j % ncy], kw,
                               {**kwargs, 'label': label})
diff --git a/lib/matplotlib/tests/test_legend.py b/lib/matplotlib/tests/test_legend.py
index b23649f22e48..73892698882c 100644
--- a/lib/matplotlib/tests/test_legend.py
+++ b/lib/matplotlib/tests/test_legend.py
@@ -1197,12 +1197,20 @@ def test_plot_single_input_multiple_label(label_array):
     x = [1, 2, 3]
     y = [2, 5, 6]
     fig, ax = plt.subplots()
-    ax.plot(x, y, label=label_array)
+    with pytest.warns(mpl.MatplotlibDeprecationWarning,
+                      match='Passing label as a length 2 sequence'):
+        ax.plot(x, y, label=label_array)
     leg = ax.legend()
     assert len(leg.get_texts()) == 1
     assert leg.get_texts()[0].get_text() == str(label_array)
 
 
+def test_plot_single_input_list_label():
+    fig, ax = plt.subplots()
+    line, = ax.plot([[0], [1]], label=['A'])
+    assert line.get_label() == 'A'
+
+
 def test_plot_multiple_label_incorrect_length_exception():
     # check that exception is raised if multiple labels
     # are given, but number of on labels != number of lines

From 34d80c359ba090136e96a053de772097252857cc Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 4 Jan 2024 17:40:44 -0500
Subject: [PATCH 0735/1120] mypy: Warn about unreachable code

And also fix some types to fix those warnings.
---
 lib/matplotlib/_type1font.py | 7 +++++--
 pyproject.toml               | 1 +
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/_type1font.py b/lib/matplotlib/_type1font.py
index a3124a24579c..b3e08f52c035 100644
--- a/lib/matplotlib/_type1font.py
+++ b/lib/matplotlib/_type1font.py
@@ -21,12 +21,15 @@
   v1.1, 1993. ISBN 0-201-57044-0.
 """
 
+from __future__ import annotations
+
 import binascii
 import functools
 import logging
 import re
 import string
 import struct
+import typing as T
 
 import numpy as np
 
@@ -171,7 +174,7 @@ def value(self):
             return float(self.raw)
 
 
-def _tokenize(data: bytes, skip_ws: bool):
+def _tokenize(data: bytes, skip_ws: bool) -> T.Generator[_Token, int, None]:
     """
     A generator that produces _Token instances from Type-1 font code.
 
@@ -194,7 +197,7 @@ def _tokenize(data: bytes, skip_ws: bool):
     hex_re = re.compile(r'^<[0-9a-fA-F\0\t\r\f\n ]*>$')
     oct_re = re.compile(r'[0-7]{1,3}')
     pos = 0
-    next_binary = None
+    next_binary: int | None = None
 
     while pos < len(text):
         if next_binary is not None:
diff --git a/pyproject.toml b/pyproject.toml
index 7661d039d370..9f4eb539a358 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -227,6 +227,7 @@ exclude = [
   # stubtest will import and run, opening a figure if not excluded
   ".*/tinypages"
 ]
+warn_unreachable = true
 
 [tool.rstcheck]
 ignore_directives = [

From 91a82eaf949bf5c1934e8bda603f46971cc10b55 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 5 Jan 2024 01:38:11 -0500
Subject: [PATCH 0736/1120] TYP: Add more types for things that are public

---
 lib/matplotlib/__init__.pyi             | 2 ++
 lib/matplotlib/projections/__init__.pyi | 9 +++++++--
 lib/matplotlib/pyplot.py                | 6 +++---
 3 files changed, 12 insertions(+), 5 deletions(-)

diff --git a/lib/matplotlib/__init__.pyi b/lib/matplotlib/__init__.pyi
index 8ef23a3dc4c2..54b28a8318ef 100644
--- a/lib/matplotlib/__init__.pyi
+++ b/lib/matplotlib/__init__.pyi
@@ -68,6 +68,8 @@ def matplotlib_fname() -> str: ...
 class RcParams(dict[str, Any]):
     validate: dict[str, Callable]
     def __init__(self, *args, **kwargs) -> None: ...
+    def _set(self, key: str, val: Any) -> None: ...
+    def _get(self, key: str) -> Any: ...
     def __setitem__(self, key: str, val: Any) -> None: ...
     def __getitem__(self, key: str) -> Any: ...
     def __iter__(self) -> Generator[str, None, None]: ...
diff --git a/lib/matplotlib/projections/__init__.pyi b/lib/matplotlib/projections/__init__.pyi
index 0f8b6c09803c..4e0d210f1c9e 100644
--- a/lib/matplotlib/projections/__init__.pyi
+++ b/lib/matplotlib/projections/__init__.pyi
@@ -1,5 +1,10 @@
-from .geo import AitoffAxes, HammerAxes, LambertAxes, MollweideAxes
-from .polar import PolarAxes
+from .geo import (
+    AitoffAxes as AitoffAxes,
+    HammerAxes as HammerAxes,
+    LambertAxes as LambertAxes,
+    MollweideAxes as MollweideAxes,
+)
+from .polar import PolarAxes as PolarAxes
 from ..axes import Axes
 
 class ProjectionRegistry:
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 18cee79d55b9..6d314c212f73 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -69,7 +69,7 @@
 from matplotlib.artist import Artist
 from matplotlib.axes import Axes
 from matplotlib.axes import Subplot  # noqa: F401
-from matplotlib.projections import PolarAxes  # type: ignore
+from matplotlib.projections import PolarAxes
 from matplotlib import mlab  # for detrend_none, window_hanning
 from matplotlib.scale import get_scale_names  # noqa: F401
 
@@ -274,7 +274,7 @@ def _get_backend_mod() -> type[matplotlib.backend_bases._Backend]:
         # Use rcParams._get("backend") to avoid going through the fallback
         # logic (which will (re)import pyplot and then call switch_backend if
         # we need to resolve the auto sentinel)
-        switch_backend(rcParams._get("backend"))  # type: ignore[attr-defined]
+        switch_backend(rcParams._get("backend"))
     return cast(type[matplotlib.backend_bases._Backend], _backend_mod)
 
 
@@ -2504,7 +2504,7 @@ def polar(*args, **kwargs) -> list[Line2D]:
         and rcParams._get_backend_or_none() in (  # type: ignore
             set(rcsetup.interactive_bk) - {'WebAgg', 'nbAgg'})
         and cbook._get_running_interactive_framework()):  # type: ignore
-    rcParams._set("backend", rcsetup._auto_backend_sentinel)  # type: ignore
+    rcParams._set("backend", rcsetup._auto_backend_sentinel)
 
 # fmt: on
 

From f2cd6b27dae0c5eeb371da4ca955cf200c281eb5 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 5 Jan 2024 01:39:18 -0500
Subject: [PATCH 0737/1120] TYP: Make mypy stricter on error code checking

These options are based on Scientific Python development guide:
https://learn.scientific-python.org/development/guides/repo-review/?repo=matplotlib%2Fmatplotlib&branch=main
---
 lib/matplotlib/patheffects.pyi | 10 +++++-----
 lib/matplotlib/pyplot.py       | 10 +++++-----
 pyproject.toml                 |  5 +++++
 3 files changed, 15 insertions(+), 10 deletions(-)

diff --git a/lib/matplotlib/patheffects.pyi b/lib/matplotlib/patheffects.pyi
index 5d8dcfeab61a..2c1634ca9314 100644
--- a/lib/matplotlib/patheffects.pyi
+++ b/lib/matplotlib/patheffects.pyi
@@ -55,7 +55,7 @@ class Normal(AbstractPathEffect): ...
 class Stroke(AbstractPathEffect):
     def __init__(self, offset: tuple[float, float] = ..., **kwargs) -> None: ...
     # rgbFace becomes non-optional
-    def draw_path(self, renderer: RendererBase, gc: GraphicsContextBase, tpath: Path, affine: Transform, rgbFace: ColorType) -> None: ...  # type: ignore
+    def draw_path(self, renderer: RendererBase, gc: GraphicsContextBase, tpath: Path, affine: Transform, rgbFace: ColorType) -> None: ...  # type: ignore[override]
 
 class withStroke(Stroke): ...
 
@@ -69,7 +69,7 @@ class SimplePatchShadow(AbstractPathEffect):
         **kwargs
     ) -> None: ...
     # rgbFace becomes non-optional
-    def draw_path(self, renderer: RendererBase, gc: GraphicsContextBase, tpath: Path, affine: Transform, rgbFace: ColorType) -> None: ...  # type: ignore
+    def draw_path(self, renderer: RendererBase, gc: GraphicsContextBase, tpath: Path, affine: Transform, rgbFace: ColorType) -> None: ...  # type: ignore[override]
 
 class withSimplePatchShadow(SimplePatchShadow): ...
 
@@ -83,13 +83,13 @@ class SimpleLineShadow(AbstractPathEffect):
         **kwargs
     ) -> None: ...
     # rgbFace becomes non-optional
-    def draw_path(self, renderer: RendererBase, gc: GraphicsContextBase, tpath: Path, affine: Transform, rgbFace: ColorType) -> None: ...  # type: ignore
+    def draw_path(self, renderer: RendererBase, gc: GraphicsContextBase, tpath: Path, affine: Transform, rgbFace: ColorType) -> None: ...  # type: ignore[override]
 
 class PathPatchEffect(AbstractPathEffect):
     patch: Patch
     def __init__(self, offset: tuple[float, float] = ..., **kwargs) -> None: ...
     # rgbFace becomes non-optional
-    def draw_path(self, renderer: RendererBase, gc: GraphicsContextBase, tpath: Path, affine: Transform, rgbFace: ColorType) -> None: ...  # type: ignore
+    def draw_path(self, renderer: RendererBase, gc: GraphicsContextBase, tpath: Path, affine: Transform, rgbFace: ColorType) -> None: ...  # type: ignore[override]
 
 class TickedStroke(AbstractPathEffect):
     def __init__(
@@ -101,6 +101,6 @@ class TickedStroke(AbstractPathEffect):
         **kwargs
     ) -> None: ...
     # rgbFace becomes non-optional
-    def draw_path(self, renderer: RendererBase, gc: GraphicsContextBase, tpath: Path, affine: Transform, rgbFace: ColorType) -> None: ...  # type: ignore
+    def draw_path(self, renderer: RendererBase, gc: GraphicsContextBase, tpath: Path, affine: Transform, rgbFace: ColorType) -> None: ...  # type: ignore[override]
 
 class withTickedStroke(TickedStroke): ...
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 6d314c212f73..53d2cf755893 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -224,7 +224,7 @@ def install_repl_displayhook() -> None:
     ip.events.register("post_execute", _draw_all_if_interactive)
     _REPL_DISPLAYHOOK = _ReplDisplayHook.IPYTHON
 
-    from IPython.core.pylabtools import backend2gui  # type: ignore
+    from IPython.core.pylabtools import backend2gui
     # trigger IPython's eventloop integration, if available
     ipython_gui_name = backend2gui.get(get_backend())
     if ipython_gui_name:
@@ -235,7 +235,7 @@ def uninstall_repl_displayhook() -> None:
     """Disconnect from the display hook of the current shell."""
     global _REPL_DISPLAYHOOK
     if _REPL_DISPLAYHOOK is _ReplDisplayHook.IPYTHON:
-        from IPython import get_ipython  # type: ignore
+        from IPython import get_ipython
         ip = get_ipython()
         ip.events.unregister("post_execute", _draw_all_if_interactive)
     _REPL_DISPLAYHOOK = _ReplDisplayHook.NONE
@@ -744,7 +744,7 @@ def xkcd(
             "xkcd mode is not compatible with text.usetex = True")
 
     stack = ExitStack()
-    stack.callback(dict.update, rcParams, rcParams.copy())  # type: ignore
+    stack.callback(dict.update, rcParams, rcParams.copy())  # type: ignore[arg-type]
 
     from matplotlib import patheffects
     rcParams.update({
@@ -2501,9 +2501,9 @@ def polar(*args, **kwargs) -> list[Line2D]:
 # requested, ignore rcParams['backend'] and force selection of a backend that
 # is compatible with the current running interactive framework.
 if (rcParams["backend_fallback"]
-        and rcParams._get_backend_or_none() in (  # type: ignore
+        and rcParams._get_backend_or_none() in (  # type: ignore[attr-defined]
             set(rcsetup.interactive_bk) - {'WebAgg', 'nbAgg'})
-        and cbook._get_running_interactive_framework()):  # type: ignore
+        and cbook._get_running_interactive_framework()):
     rcParams._set("backend", rcsetup._auto_backend_sentinel)
 
 # fmt: on
diff --git a/pyproject.toml b/pyproject.toml
index 9f4eb539a358..8ef963069928 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -208,6 +208,11 @@ convention = "numpy"
 
 [tool.mypy]
 ignore_missing_imports = true
+enable_error_code = [
+  "ignore-without-code",
+  "redundant-expr",
+  "truthy-bool",
+]
 enable_incomplete_feature = [
   "Unpack",
 ]

From bbd3723f3861b6c316012f2d234cc845d74004f7 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 5 Jan 2024 02:28:27 -0500
Subject: [PATCH 0738/1120] TYP: Move mypy options into config file

Instead of putting them in CI, so that one can run `mypy` by itself and
not have to remember the flags to match CI.
---
 .github/workflows/reviewdog.yml | 3 +--
 pyproject.toml                  | 4 ++++
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/reviewdog.yml b/.github/workflows/reviewdog.yml
index aa3602571c03..fbd724571d80 100644
--- a/.github/workflows/reviewdog.yml
+++ b/.github/workflows/reviewdog.yml
@@ -55,8 +55,7 @@ jobs:
           REVIEWDOG_GITHUB_API_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
           set -o pipefail
-          mypy --config pyproject.toml lib/matplotlib \
-             --follow-imports silent | \
+          mypy --config pyproject.toml | \
             reviewdog -f=mypy -name=mypy \
               -tee -reporter=github-check -filter-mode nofilter
 
diff --git a/pyproject.toml b/pyproject.toml
index 8ef963069928..8d3ff39fc38e 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -232,6 +232,10 @@ exclude = [
   # stubtest will import and run, opening a figure if not excluded
   ".*/tinypages"
 ]
+files = [
+  "lib/matplotlib",
+]
+follow_imports = "silent"
 warn_unreachable = true
 
 [tool.rstcheck]

From 469959b319d5014cc6f1a433a0abba5ea1a1c851 Mon Sep 17 00:00:00 2001
From: David Gilbertson <gilbertson.david@gmail.com>
Date: Fri, 16 Feb 2024 16:30:47 +1100
Subject: [PATCH 0739/1120] Add back the bbox_inches part

---
 .../subplots_axes_and_figures/figure_size_units.py        | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/galleries/examples/subplots_axes_and_figures/figure_size_units.py b/galleries/examples/subplots_axes_and_figures/figure_size_units.py
index f4610b7cdd1d..0ce49c937d50 100644
--- a/galleries/examples/subplots_axes_and_figures/figure_size_units.py
+++ b/galleries/examples/subplots_axes_and_figures/figure_size_units.py
@@ -57,12 +57,18 @@
 # tedious for quick iterations.
 #
 # Because of the default ``rcParams['figure.dpi'] = 100``, one can mentally
-# divide the needed pixel value by 100:
+# divide the needed pixel value by 100 [#]_:
 #
 plt.subplots(figsize=(6, 2))
 plt.text(0.5, 0.5, '600px x 200px', **text_kwargs)
 plt.show()
 
+# %%
+# .. [#] Unfortunately, this does not work well for the ``matplotlib inline``
+#        backend in Jupyter because that backend saves the figure
+#        with ``bbox_inches='tight'``, which crops the figure and makes the
+#        actual size unpredictable.
+
 # %%
 #
 # .. admonition:: References

From 77c632527ef2ce3328f23453042521c7099b0ee0 Mon Sep 17 00:00:00 2001
From: Jody Klymak <jklymak@gmail.com>
Date: Sun, 24 Dec 2023 08:53:11 -0800
Subject: [PATCH 0740/1120] MNT: better arg handling GridSpecFromSubplotSpec

---
 lib/matplotlib/gridspec.py            |  7 ++++++-
 lib/matplotlib/tests/test_gridspec.py | 13 +++++++++++++
 2 files changed, 19 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/gridspec.py b/lib/matplotlib/gridspec.py
index c38f3a078b84..c6b363d36efa 100644
--- a/lib/matplotlib/gridspec.py
+++ b/lib/matplotlib/gridspec.py
@@ -484,7 +484,12 @@ def __init__(self, nrows, ncols,
         """
         self._wspace = wspace
         self._hspace = hspace
-        self._subplot_spec = subplot_spec
+        if isinstance(subplot_spec, SubplotSpec):
+            self._subplot_spec = subplot_spec
+        else:
+            raise TypeError(
+                            "subplot_spec must be type SubplotSpec, "
+                            "usually from GridSpec, or axes.get_subplotspec.")
         self.figure = self._subplot_spec.get_gridspec().figure
         super().__init__(nrows, ncols,
                          width_ratios=width_ratios,
diff --git a/lib/matplotlib/tests/test_gridspec.py b/lib/matplotlib/tests/test_gridspec.py
index 5d5d7523a2ed..deda73c3b6ab 100644
--- a/lib/matplotlib/tests/test_gridspec.py
+++ b/lib/matplotlib/tests/test_gridspec.py
@@ -1,4 +1,5 @@
 import matplotlib.gridspec as gridspec
+import matplotlib.pyplot as plt
 import pytest
 
 
@@ -35,3 +36,15 @@ def test_repr():
                            width_ratios=(1, 3))
     assert repr(ss) == \
         "GridSpec(2, 2, height_ratios=(3, 1), width_ratios=(1, 3))"
+
+
+def test_subplotspec_args():
+    fig, axs = plt.subplots(1, 2)
+    # should work:
+    gs = gridspec.GridSpecFromSubplotSpec(2, 1,
+                                          subplot_spec=axs[0].get_subplotspec())
+    assert gs.get_topmost_subplotspec() == axs[0].get_subplotspec()
+    with pytest.raises(TypeError, match="subplot_spec must be type SubplotSpec"):
+        gs = gridspec.GridSpecFromSubplotSpec(2, 1, subplot_spec=axs[0])
+    with pytest.raises(TypeError, match="subplot_spec must be type SubplotSpec"):
+        gs = gridspec.GridSpecFromSubplotSpec(2, 1, subplot_spec=axs)

From 67acbfaced5827068d32bbc95963efdad6f570f6 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Fri, 16 Feb 2024 21:29:22 +0100
Subject: [PATCH 0741/1120] Remove unused CSS for sphinx-gallery

The div.figure was removed in
https://github.com/sphinx-gallery/sphinx-gallery/pull/906

The workaround is also not needed anymore because that PR fixes the
centering.
---
 doc/_static/mpl.css | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/doc/_static/mpl.css b/doc/_static/mpl.css
index 6f17005a810b..fdc8975df65d 100644
--- a/doc/_static/mpl.css
+++ b/doc/_static/mpl.css
@@ -85,11 +85,6 @@ html[data-theme="dark"] .sphx-glr-thumbcontainer {
     background-color: rgb(63, 63, 63);
 }
 
-/* workaround: the default padding decenters the image inside the frame */
-.sphx-glr-thumbcontainer .figure {
-    padding: 0;
-}
-
 /* hide download buttons in example headers
  * https://sphinx-gallery.github.io/stable/advanced.html#hide-the-download-buttons-in-the-example-headers
  */

From 5d1f2aea676bc2d4f9cef52ea3910124465c9894 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Fri, 16 Feb 2024 21:34:06 +0100
Subject: [PATCH 0742/1120] Set a fixed height for sphinx gallery images

... so that lazy loading does not change heights. Without a fixed
height lazy loading of images interferes with anchor links: Clicking a
link goes to a certain position, but then the loaded images add content
and move the anchor to a different position.
---
 doc/_static/mpl.css | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/doc/_static/mpl.css b/doc/_static/mpl.css
index fdc8975df65d..2c43bcfa7a3d 100644
--- a/doc/_static/mpl.css
+++ b/doc/_static/mpl.css
@@ -85,6 +85,15 @@ html[data-theme="dark"] .sphx-glr-thumbcontainer {
     background-color: rgb(63, 63, 63);
 }
 
+/* Set a fixed height so that lazy loading does not change heights. Without a fixed
+ * height lazy loading of images interferes with anchor links: Clicking a link goes to
+ * a certain position, but then the loaded images add content and move the anchor to a
+ * different position.
+ */
+.sphx-glr-thumbcontainer img {
+    height: 112px;
+}
+
 /* hide download buttons in example headers
  * https://sphinx-gallery.github.io/stable/advanced.html#hide-the-download-buttons-in-the-example-headers
  */

From 2fa85ee5746786ee3669ed7d8ee4a156e6af7247 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Sat, 17 Feb 2024 12:46:03 -0500
Subject: [PATCH 0743/1120] DOC: clarify the default value of *radius* in
 Patch.contains_point (#27462)

... and friends.

closes #19807

Co-authored-by: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Co-authored-by: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
---
 lib/matplotlib/patches.py | 53 ++++++++++++++++++++++++++++++++++++---
 1 file changed, 50 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
index 7e3aaf6ecb24..7d6689c9a808 100644
--- a/lib/matplotlib/patches.py
+++ b/lib/matplotlib/patches.py
@@ -127,6 +127,29 @@ def contains(self, mouseevent, radius=None):
         """
         Test whether the mouse event occurred in the patch.
 
+        Parameters
+        ----------
+        mouseevent : `~matplotlib.backend_bases.MouseEvent`
+            Where the user clicked.
+
+        radius : float, optional
+            Additional margin on the patch in target coordinates of
+            `.Patch.get_transform`. See `.Path.contains_point` for further
+            details.
+
+            If `None`, the default value depends on the state of the object:
+
+            - If `.Artist.get_picker` is a number, the default
+              is that value.  This is so that picking works as expected.
+            - Otherwise if the edge color has a non-zero alpha, the default
+              is half of the linewidth.  This is so that all the colored
+              pixels are "in" the patch.
+            - Finally, if the edge has 0 alpha, the default is 0.  This is
+              so that patches without a stroked edge do not have points
+              outside of the filled region report as "in" due to an
+              invisible edge.
+
+
         Returns
         -------
         (bool, empty dict)
@@ -160,13 +183,25 @@ def contains_point(self, point, radius=None):
         ----------
         point : (float, float)
             The point (x, y) to check, in target coordinates of
-            ``self.get_transform()``. These are display coordinates for patches
+            ``.Patch.get_transform()``. These are display coordinates for patches
             that are added to a figure or Axes.
         radius : float, optional
             Additional margin on the patch in target coordinates of
-            ``self.get_transform()``. See `.Path.contains_point` for further
+            `.Patch.get_transform`. See `.Path.contains_point` for further
             details.
 
+            If `None`, the default value depends on the state of the object:
+
+            - If `.Artist.get_picker` is a number, the default
+              is that value.  This is so that picking works as expected.
+            - Otherwise if the edge color has a non-zero alpha, the default
+              is half of the linewidth.  This is so that all the colored
+              pixels are "in" the patch.
+            - Finally, if the edge has 0 alpha, the default is 0.  This is
+              so that patches without a stroked edge do not have points
+              outside of the filled region report as "in" due to an
+              invisible edge.
+
         Returns
         -------
         bool
@@ -214,9 +249,21 @@ def contains_points(self, points, radius=None):
             that are added to a figure or Axes. Columns contain x and y values.
         radius : float, optional
             Additional margin on the patch in target coordinates of
-            ``self.get_transform()``. See `.Path.contains_point` for further
+            `.Patch.get_transform`. See `.Path.contains_point` for further
             details.
 
+            If `None`, the default value depends on the state of the object:
+
+            - If `.Artist.get_picker` is a number, the default
+              is that value.  This is so that picking works as expected.
+            - Otherwise if the edge color has a non-zero alpha, the default
+              is half of the linewidth.  This is so that all the colored
+              pixels are "in" the patch.
+            - Finally, if the edge has 0 alpha, the default is 0.  This is
+              so that patches without a stroked edge do not have points
+              outside of the filled region report as "in" due to an
+              invisible edge.
+
         Returns
         -------
         length-N bool array

From abe447910a0687cbb1029ac96caf90454d95a745 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Fri, 16 Feb 2024 22:40:14 +0100
Subject: [PATCH 0744/1120] Deactivate sidebar for release notes

The release note page is only a structured collection of links to
sub-pages. The sidebar would repeat all the titles of the sub-pages and
thus basically repeat all the content of the page. Even worse, it does
not contain the version sectioning structure of the release notes page
itself. To keep the layout the sidebar gets one empty dummy section.
If we leave the sidebar completely empty, it will be deactivated and
change the layout of the page.

Related to https://github.com/matplotlib/matplotlib/pull/27690#issuecomment-1907277251
---
 doc/_templates/empty_sidebar.html | 1 +
 doc/conf.py                       | 4 ++++
 2 files changed, 5 insertions(+)
 create mode 100644 doc/_templates/empty_sidebar.html

diff --git a/doc/_templates/empty_sidebar.html b/doc/_templates/empty_sidebar.html
new file mode 100644
index 000000000000..2ebb29fad4dd
--- /dev/null
+++ b/doc/_templates/empty_sidebar.html
@@ -0,0 +1 @@
+<div class="sidebar-empty"></div>
diff --git a/doc/conf.py b/doc/conf.py
index 3805facbfbcc..ccde74304eb3 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -536,6 +536,10 @@ def js_tag_with_cache_busting(js):
         "cheatsheet_sidebar.html",
         "donate_sidebar.html",
     ],
+    # no sidebar for release notes, because that page is only a collection of links
+    # to sub-pages. The sidebar would repeat all the titles of the sub-pages and
+    # thus basically repeat all the content of the page.
+    "users/release_notes": ["empty_sidebar.html"],
     # '**': ['localtoc.html', 'pagesource.html']
 }
 

From f2e0b3cf590d43b5d0fbd929765c5c30497d872c Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Fri, 16 Feb 2024 22:09:51 +0100
Subject: [PATCH 0745/1120] Clarify that set_ticks() affects major/minor ticks
 independently

Closes #27701.
---
 lib/matplotlib/axis.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/axis.py b/lib/matplotlib/axis.py
index b4d2810b67b8..e76f9fdcf5aa 100644
--- a/lib/matplotlib/axis.py
+++ b/lib/matplotlib/axis.py
@@ -2114,7 +2114,7 @@ def set_ticks(self, ticks, labels=None, *, minor=False, **kwargs):
             If not set, the labels are generated using the axis tick `.Formatter`.
 
         minor : bool, default: False
-            If ``False``, set the major ticks; if ``True``, the minor ticks.
+            If ``False``, set only the major ticks; if ``True``, only the minor ticks.
 
         **kwargs
             `.Text` properties for the labels. Using these is only allowed if

From 3f1d8be68b2d986f7f7efbb3d5152bcacbb75e83 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Tue, 13 Feb 2024 22:45:41 +0100
Subject: [PATCH 0746/1120] Improve documentation on boxplot and violinplot

---
 lib/matplotlib/axes/_axes.py | 57 +++++++++++++++++++++++++-----------
 1 file changed, 40 insertions(+), 17 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 711d930a1253..5996713ccc3e 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -3801,7 +3801,7 @@ def boxplot(self, x, notch=None, sym=None, vert=None, whis=None,
             in *x*.  If a sequence of 1D arrays, a boxplot is drawn for each
             array in *x*.
 
-        notch : bool, default: False
+        notch : bool, default: :rc:`boxplot.notch`
             Whether to draw a notched boxplot (`True`), or a rectangular
             boxplot (`False`).  The notches represent the confidence interval
             (CI) around the median.  The documentation for *bootstrap*
@@ -3823,7 +3823,7 @@ def boxplot(self, x, notch=None, sym=None, vert=None, whis=None,
             the fliers.  If `None`, then the fliers default to 'b+'.  More
             control is provided by the *flierprops* parameter.
 
-        vert : bool, default: True
+        vert : bool, default: :rc:`boxplot.vertical`
             If `True`, draws vertical boxes.
             If `False`, draw horizontal boxes.
 
@@ -3880,7 +3880,7 @@ def boxplot(self, x, notch=None, sym=None, vert=None, whis=None,
             The widths of the boxes.  The default is 0.5, or ``0.15*(distance
             between extreme positions)``, if that is smaller.
 
-        patch_artist : bool, default: False
+        patch_artist : bool, default: :rc:`boxplot.patchartist`
             If `False` produces boxes with the Line2D artist. Otherwise,
             boxes are drawn with Patch artists.
 
@@ -3896,7 +3896,7 @@ def boxplot(self, x, notch=None, sym=None, vert=None, whis=None,
             75th percentiles are equal, *whis* is set to (0, 100) such
             that the whisker ends are at the minimum and maximum of the data.
 
-        meanline : bool, default: False
+        meanline : bool, default: :rc:`boxplot.meanline`
             If `True` (and *showmeans* is `True`), will try to render the
             mean as a line spanning the full width of the box according to
             *meanprops* (see below).  Not recommended if *shownotches* is also
@@ -3931,13 +3931,13 @@ def boxplot(self, x, notch=None, sym=None, vert=None, whis=None,
 
         Other Parameters
         ----------------
-        showcaps : bool, default: True
+        showcaps : bool, default: :rc:`boxplot.showcaps`
             Show the caps on the ends of whiskers.
-        showbox : bool, default: True
+        showbox : bool, default: :rc:`boxplot.showbox`
             Show the central box.
-        showfliers : bool, default: True
+        showfliers : bool, default: :rc:`boxplot.showfliers`
             Show the outliers beyond the caps.
-        showmeans : bool, default: False
+        showmeans : bool, default: :rc:`boxplot.showmeans`
             Show the arithmetic means.
         capprops : dict, default: None
             The style of the caps.
@@ -3958,6 +3958,7 @@ def boxplot(self, x, notch=None, sym=None, vert=None, whis=None,
 
         See Also
         --------
+        .Axes.bxp : Draw a boxplot from pre-computed statistics.
         violinplot : Draw an estimate of the probability density function.
         """
 
@@ -4086,13 +4087,26 @@ def bxp(self, bxpstats, positions=None, widths=None, vert=True,
             meanline=False, manage_ticks=True, zorder=None,
             capwidths=None):
         """
-        Drawing function for box and whisker plots.
+        Draw a box and whisker plot from pre-computed statistics.
+
+        The box extends from the first quartile *q1* to the third
+        quartile *q3* of the data, with a line at the median (*med*).
+        The whiskers extend from *whislow* to *whishi*.
+        Flier points are markers past the end of the whiskers.
+        See https://en.wikipedia.org/wiki/Box_plot for reference.
+
+        .. code-block:: none
+
+                   whislow    q1    med    q3    whishi
+                               |-----:-----|
+               o      |--------|     :     |--------|    o  o
+                               |-----:-----|
+             flier                                      fliers
 
-        Make a box and whisker plot for each column of *x* or each
-        vector in sequence *x*.  The box extends from the lower to
-        upper quartile values of the data, with a line at the median.
-        The whiskers extend from the box to show the range of the
-        data.  Flier points are those past the end of the whiskers.
+        .. note::
+            This is a low-level drawing function for when you already
+            have the statistical parameters. If you want a boxplot based
+            on a dataset, use `~.Axes.boxplot` instead.
 
         Parameters
         ----------
@@ -4172,9 +4186,9 @@ def bxp(self, bxpstats, positions=None, widths=None, vert=True,
           - ``fliers``: points representing data beyond the whiskers (fliers).
           - ``means``: points or lines representing the means.
 
-        Examples
+        See Also
         --------
-        .. plot:: gallery/statistics/bxp.py
+        boxplot : Draw a boxplot from data instead of pre-computed statistics.
         """
         # Clamp median line to edge of box by default.
         medianprops = {
@@ -8278,6 +8292,10 @@ def violinplot(self, dataset, positions=None, vert=True, widths=0.5,
             to identify the quantile values of each of the violin's
             distribution.
 
+        See Also
+        --------
+        .Axes.violin : Draw a violin from pre-computed statistics.
+        boxplot : Draw a box and whisker plot.
         """
 
         def _kde_method(X, coords):
@@ -8298,7 +8316,7 @@ def _kde_method(X, coords):
     def violin(self, vpstats, positions=None, vert=True, widths=0.5,
                showmeans=False, showextrema=True, showmedians=False):
         """
-        Drawing function for violin plots.
+        Draw a violin plot from pre-computed statistics.
 
         Draw a violin plot for each column of *vpstats*. Each filled area
         extends to represent the entire data range, with optional lines at the
@@ -8380,6 +8398,11 @@ def violin(self, vpstats, positions=None, vert=True, widths=0.5,
           - ``cquantiles``: A `~.collections.LineCollection` instance created
             to identify the quantiles values of each of the violin's
             distribution.
+
+        See Also
+        --------
+        violin :
+            Draw a violin plot from data instead of pre-computed statistics.
         """
 
         # Statistical quantities to be plotted on the violins

From 77f6c2faa00059652400d8339e35fb96fc88ce8f Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Tue, 20 Feb 2024 15:12:44 -0600
Subject: [PATCH 0747/1120] Remove self._renderer from AnnotationBbox and
 ConnectionPatch

As far as I can tell, these are unused, and cause problems for pickling

Closes #27805
---
 lib/matplotlib/offsetbox.py | 2 --
 lib/matplotlib/patches.py   | 2 --
 2 files changed, 4 deletions(-)

diff --git a/lib/matplotlib/offsetbox.py b/lib/matplotlib/offsetbox.py
index 1667681fab59..32c5bafcde1d 100644
--- a/lib/matplotlib/offsetbox.py
+++ b/lib/matplotlib/offsetbox.py
@@ -1407,8 +1407,6 @@ def update_positions(self, renderer):
 
     def draw(self, renderer):
         # docstring inherited
-        if renderer is not None:
-            self._renderer = renderer
         if not self.get_visible() or not self._check_xy(renderer):
             return
         renderer.open_group(self.__class__.__name__, gid=self.get_gid())
diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
index 7d6689c9a808..78af2f98b3bf 100644
--- a/lib/matplotlib/patches.py
+++ b/lib/matplotlib/patches.py
@@ -4696,8 +4696,6 @@ def _check_xy(self, renderer):
         return True
 
     def draw(self, renderer):
-        if renderer is not None:
-            self._renderer = renderer
         if not self.get_visible() or not self._check_xy(renderer):
             return
         super().draw(renderer)

From cf5245dbd6289c533acc3e63850bbdd9546d66e9 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Tue, 20 Feb 2024 17:19:19 -0600
Subject: [PATCH 0748/1120] Expand CI pytest reporting config to ignore xfails

---
 .appveyor.yml                | 2 +-
 .github/workflows/cygwin.yml | 2 +-
 .github/workflows/tests.yml  | 2 +-
 azure-pipelines.yml          | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/.appveyor.yml b/.appveyor.yml
index ac9608ec56ea..4235895a4348 100644
--- a/.appveyor.yml
+++ b/.appveyor.yml
@@ -24,7 +24,7 @@ environment:
   global:
     PYTHONFAULTHANDLER: 1
     PYTHONIOENCODING: UTF-8
-    PYTEST_ARGS: -raR --numprocesses=auto --timeout=300 --durations=25
+    PYTEST_ARGS: -rfEsXR --numprocesses=auto --timeout=300 --durations=25
                  --cov-report= --cov=lib --log-level=DEBUG
 
   matrix:
diff --git a/.github/workflows/cygwin.yml b/.github/workflows/cygwin.yml
index fa4e76a773b7..193e4c66082e 100644
--- a/.github/workflows/cygwin.yml
+++ b/.github/workflows/cygwin.yml
@@ -242,7 +242,7 @@ jobs:
         shell: bash.exe -eo pipefail -o igncr "{0}"
         id: cygwin-run-pytest
         run: |
-          xvfb-run pytest -raR -n auto \
+          xvfb-run pytest -rfEsXR -n auto \
             --maxfail=50 --timeout=300 --durations=25 \
             --cov-report=xml --cov=lib --log-level=DEBUG --color=yes
 
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 46cc935216be..f10dee502ff9 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -316,7 +316,7 @@ jobs:
 
       - name: Run pytest
         run: |
-          pytest -raR -n auto \
+          pytest -rfEsXR -n auto \
             --maxfail=50 --timeout=300 --durations=25 \
             --cov-report=xml --cov=lib --log-level=DEBUG --color=yes
 
diff --git a/azure-pipelines.yml b/azure-pipelines.yml
index 3dc66ba0274a..ac983fb58f6b 100644
--- a/azure-pipelines.yml
+++ b/azure-pipelines.yml
@@ -216,7 +216,7 @@ stages:
             fi
             echo "##vso[task.setvariable variable=VS_COVERAGE_TOOL]$TOOL"
           fi
-          PYTHONFAULTHANDLER=1 pytest -raR -n 2 \
+          PYTHONFAULTHANDLER=1 pytest -rfEsXR -n 2 \
               --maxfail=50 --timeout=300 --durations=25 \
               --junitxml=junit/test-results.xml --cov-report=xml --cov=lib
           if [[ -n $SESSION_ID ]]; then

From d9c35caca0aa462674f150e825b170120c860566 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 24 Jan 2024 05:18:34 -0500
Subject: [PATCH 0749/1120] Add linting to YAML files

---
 .appveyor.yml                              |  10 +-
 .circleci/config.yml                       |  11 +-
 .github/FUNDING.yml                        |   1 +
 .github/ISSUE_TEMPLATE/bug_report.yml      |   3 +-
 .github/ISSUE_TEMPLATE/config.yml          |   6 +-
 .github/ISSUE_TEMPLATE/documentation.yml   |   4 +-
 .github/ISSUE_TEMPLATE/feature_request.yml |   6 +-
 .github/ISSUE_TEMPLATE/maintenance.yml     |   3 +-
 .github/ISSUE_TEMPLATE/tag_proposal.yml    |   1 +
 .github/codecov.yml                        |   3 +-
 .github/dependabot.yml                     |   1 +
 .github/labeler.yml                        |  24 +-
 .github/workflows/cibuildwheel.yml         |  17 +-
 .github/workflows/clean_pr.yml             |   3 +-
 .github/workflows/cygwin.yml               |  13 +-
 .github/workflows/good-first-issue.yml     |  12 +-
 .github/workflows/nightlies.yml            |   2 +-
 .github/workflows/stale-tidy.yml           |   1 +
 .github/workflows/stale.yml                |  16 +-
 .meeseeksdev.yml                           |   1 +
 .pre-commit-config.yaml                    |  45 +-
 .yamllint.yml                              |   9 +
 azure-pipelines.yml                        | 503 +++++++++++----------
 environment.yml                            |   1 +
 src/.clang-format                          |  14 +-
 25 files changed, 388 insertions(+), 322 deletions(-)
 create mode 100644 .yamllint.yml

diff --git a/.appveyor.yml b/.appveyor.yml
index 4235895a4348..69d634a6fcc9 100644
--- a/.appveyor.yml
+++ b/.appveyor.yml
@@ -2,6 +2,7 @@
 # http://tjelvarolsson.com/blog/how-to-continuously-test-your-python-code-on-windows-using-appveyor/
 # https://packaging.python.org/en/latest/appveyor/
 # https://github.com/rmcgibbo/python-appveyor-conda-example
+---
 
 # Backslashes in quotes need to be escaped: \ -> "\\"
 branches:
@@ -38,7 +39,7 @@ environment:
 # We always use a 64-bit machine, but can build x86 distributions
 # with the PYTHON_ARCH variable
 platform:
-    - x64
+  - x64
 
 # all our python builds have to happen in tests_script...
 build: false
@@ -79,10 +80,13 @@ test_script:
   - if x%TEST_ALL% == xyes conda install -q ffmpeg inkscape miktex
   # missing packages on conda-forge for imagemagick
   # This install sometimes failed randomly :-(
-  #- choco install imagemagick
+  # - choco install imagemagick
 
   # Test import of tkagg backend
-  - python -c "import matplotlib as m; m.use('tkagg'); import matplotlib.pyplot as plt; print(plt.get_backend())"
+  - python -c
+    "import matplotlib as m; m.use('tkagg');
+    import matplotlib.pyplot as plt;
+    print(plt.get_backend())"
   # tests
   - echo The following args are passed to pytest %PYTEST_ARGS%
   - pytest %PYTEST_ARGS%
diff --git a/.circleci/config.yml b/.circleci/config.yml
index 4fac8e28f322..2d7c0da457ec 100644
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -17,7 +17,8 @@ commands:
             export git_log=$(git log --max-count=1 --pretty=format:"%B" | tr "\n" " ")
             echo "Got commit message:"
             echo "${git_log}"
-            if [[ -v CIRCLE_PULL_REQUEST ]] && [[ $git_log =~ (\[skip circle\]|\[circle skip\]|\[skip doc\]|\[doc skip\]) ]]; then
+            if [[ -v CIRCLE_PULL_REQUEST ]] &&
+               [[ $git_log =~ (\[skip circle\]|\[circle skip\]|\[skip doc\]|\[doc skip\]) ]]; then
               echo "Skip detected, exiting job ${CIRCLE_JOB} for PR ${CIRCLE_PULL_REQUEST}."
               circleci-agent step halt;
             fi
@@ -71,8 +72,12 @@ commands:
           name: Install custom fonts
           command: |
             mkdir -p ~/.local/share/fonts
-            wget -nc https://github.com/google/fonts/blob/master/ofl/felipa/Felipa-Regular.ttf?raw=true -O ~/.local/share/fonts/Felipa-Regular.ttf || true
-            wget -nc https://github.com/ipython/xkcd-font/blob/master/xkcd-script/font/xkcd-script.ttf?raw=true -O ~/.local/share/fonts/xkcd-Script.ttf || true
+            wget -nc \
+              https://github.com/google/fonts/blob/master/ofl/felipa/Felipa-Regular.ttf?raw=true \
+              -O ~/.local/share/fonts/Felipa-Regular.ttf || true
+            wget -nc \
+              https://github.com/ipython/xkcd-font/blob/master/xkcd-script/font/xkcd-script.ttf?raw=true \
+              -O ~/.local/share/fonts/xkcd-Script.ttf || true
             fc-cache -f -v
       - save_cache:
           key: fonts-4
diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml
index 5c9afed3c02b..a474d51d6f64 100644
--- a/.github/FUNDING.yml
+++ b/.github/FUNDING.yml
@@ -1,3 +1,4 @@
+---
 # These are supported funding model platforms
 github: [matplotlib, numfocus]
 custom: https://numfocus.org/donate-to-matplotlib
diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
index 985762649b67..ee840286ab75 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.yml
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -1,3 +1,4 @@
+---
 name: Bug Report
 description: Report a bug or issue with Matplotlib.
 title: "[Bug]: "
@@ -6,7 +7,7 @@ body:
     id: summary
     attributes:
       label: Bug summary
-      description:  Describe the bug in 1-2 short sentences
+      description: Describe the bug in 1-2 short sentences
       placeholder:
       value:
     validations:
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
index 10c9d5c0d580..dc80f6d7c91d 100644
--- a/.github/ISSUE_TEMPLATE/config.yml
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -1,5 +1,7 @@
-# Ref: https://help.github.com/en/github/building-a-strong-community/configuring-issue-templates-for-your-repository#configuring-the-template-chooser
-blank_issues_enabled: true # default
+# Reference:
+# https://help.github.com/en/github/building-a-strong-community/configuring-issue-templates-for-your-repository#configuring-the-template-chooser
+---
+blank_issues_enabled: true  # default
 contact_links:
   - name: Question/Support/Other
     url: https://discourse.matplotlib.org
diff --git a/.github/ISSUE_TEMPLATE/documentation.yml b/.github/ISSUE_TEMPLATE/documentation.yml
index ea0eb385baaf..0fc16a0f8bea 100644
--- a/.github/ISSUE_TEMPLATE/documentation.yml
+++ b/.github/ISSUE_TEMPLATE/documentation.yml
@@ -1,3 +1,4 @@
+---
 name: Documentation
 description: Create a report to help us improve the documentation
 title: "[Doc]: "
@@ -9,7 +10,8 @@ body:
       label: Documentation Link
       description: |
         Link to any documentation or examples that you are referencing.
-        Suggested improvements should be based on the development version of the docs: https://matplotlib.org/devdocs/
+        Suggested improvements should be based on the development version of the docs:
+        https://matplotlib.org/devdocs/
       placeholder: https://matplotlib.org/devdocs/...
   - type: textarea
     id: problem
diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml
index 5274c287569c..e174fb8994aa 100644
--- a/.github/ISSUE_TEMPLATE/feature_request.yml
+++ b/.github/ISSUE_TEMPLATE/feature_request.yml
@@ -1,3 +1,4 @@
+---
 name: Feature Request
 description: Suggest something to add to Matplotlib!
 title: "[ENH]: "
@@ -5,8 +6,9 @@ labels: [New feature]
 body:
   - type: markdown
     attributes:
-      value: |
-         Please search the [issues](https://github.com/matplotlib/matplotlib/issues) for relevant feature requests before creating a new feature request.
+      value: >-
+        Please search the [issues](https://github.com/matplotlib/matplotlib/issues) for relevant feature
+        requests before creating a new feature request.
   - type: textarea
     id: problem
     attributes:
diff --git a/.github/ISSUE_TEMPLATE/maintenance.yml b/.github/ISSUE_TEMPLATE/maintenance.yml
index 746ab55ef0e3..6ebb64c0c3e9 100644
--- a/.github/ISSUE_TEMPLATE/maintenance.yml
+++ b/.github/ISSUE_TEMPLATE/maintenance.yml
@@ -1,3 +1,4 @@
+---
 name: Maintenance
 description: Help improve performance, usability and/or consistency.
 title: "[MNT]: "
@@ -7,7 +8,7 @@ body:
     id: summary
     attributes:
       label: Summary
-      description:  Please provide 1-2 short sentences that succinctly describes what could be improved.
+      description: Please provide 1-2 short sentences that succinctly describes what could be improved.
     validations:
       required: true
   - type: textarea
diff --git a/.github/ISSUE_TEMPLATE/tag_proposal.yml b/.github/ISSUE_TEMPLATE/tag_proposal.yml
index 6876226f6240..6f7875d1a61a 100644
--- a/.github/ISSUE_TEMPLATE/tag_proposal.yml
+++ b/.github/ISSUE_TEMPLATE/tag_proposal.yml
@@ -1,3 +1,4 @@
+---
 name: Tag Proposal
 description: Suggest a new tag or subcategory for the gallery of examples
 title: "[Tag]: "
diff --git a/.github/codecov.yml b/.github/codecov.yml
index 14a17e58e1b9..b4318a386381 100644
--- a/.github/codecov.yml
+++ b/.github/codecov.yml
@@ -1,10 +1,11 @@
 # codecov used to be able to find this anywhere, now we have to manually
 # tell it where to look
+---
 comment: false
 
 codecov:
   notify:
-    require_ci_to_pass: no
+    require_ci_to_pass: false
 
 coverage:
   status:
diff --git a/.github/dependabot.yml b/.github/dependabot.yml
index d15c975eaccb..34902e5236df 100644
--- a/.github/dependabot.yml
+++ b/.github/dependabot.yml
@@ -1,3 +1,4 @@
+---
 version: 2
 updates:
   - package-ecosystem: "github-actions"
diff --git a/.github/labeler.yml b/.github/labeler.yml
index 4b6b6c607830..43a1246ba68a 100644
--- a/.github/labeler.yml
+++ b/.github/labeler.yml
@@ -76,12 +76,12 @@
 
 "Documentation: API":
   - all:
-    - changed-files:
-        - any-glob-to-any-file:
-            # Also files in lib/**, but we can't be sure those are only documentation.
-            - 'doc/api/**'
-        - all-globs-to-all-files:
-            - '!doc/api/next_api_changes/**'
+      - changed-files:
+          - any-glob-to-any-file:
+              # Also files in lib/**, but we can't be sure those are only documentation.
+              - 'doc/api/**'
+          - all-globs-to-all-files:
+              - '!doc/api/next_api_changes/**'
 
 "Documentation: build":
   - changed-files:
@@ -107,12 +107,12 @@
           - 'galleries/tutorials/**'
 "Documentation: user guide":
   - all:
-    - changed-files:
-        - any-glob-to-any-file:
-            - 'doc/users/**'
-            - 'galleries/users_explain/**'
-        - all-globs-to-all-files:
-            - '!doc/users/next_whats_new/**'
+      - changed-files:
+          - any-glob-to-any-file:
+              - 'doc/users/**'
+              - 'galleries/users_explain/**'
+          - all-globs-to-all-files:
+              - '!doc/users/next_whats_new/**'
 
 "topic: animation":
   - changed-files:
diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 903870f6e86e..3c9a6eefe704 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -101,9 +101,10 @@ jobs:
       # If using all `--pre` releases creates issues, the NumPy wheel can be
       # installed more targeted.
       CIBW_BUILD_FRONTEND: >-
-        ${{ (((github.event_name == 'push' && github.ref == 'refs/heads/main') ||
+        ${{ ((github.event_name == 'push' && github.ref == 'refs/heads/main') ||
               (github.event_name == 'pull_request' && github.base_ref == 'main')) &&
-            'pip; args: --pre --extra-index-url "https://pypi.anaconda.org/scientific-python-nightly-wheels/simple"') ||
+            'pip; args: --pre
+             --extra-index-url "https://pypi.anaconda.org/scientific-python-nightly-wheels/simple"' ||
             'build' }}
       CIBW_REPAIR_WHEEL_COMMAND_WINDOWS: >-
         delvewheel repair -w {dest_dir} {wheel}
@@ -146,7 +147,7 @@ jobs:
           path: dist/
 
       - name: Build wheels for CPython 3.12
-        uses: pypa/cibuildwheel@ce3fb7832089eb3e723a0a99cab7f3eaccf074fd # v2.16.5
+        uses: pypa/cibuildwheel@ce3fb7832089eb3e723a0a99cab7f3eaccf074fd  # v2.16.5
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -154,7 +155,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.11
-        uses: pypa/cibuildwheel@ce3fb7832089eb3e723a0a99cab7f3eaccf074fd # v2.16.5
+        uses: pypa/cibuildwheel@ce3fb7832089eb3e723a0a99cab7f3eaccf074fd  # v2.16.5
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -162,7 +163,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.10
-        uses: pypa/cibuildwheel@ce3fb7832089eb3e723a0a99cab7f3eaccf074fd # v2.16.5
+        uses: pypa/cibuildwheel@ce3fb7832089eb3e723a0a99cab7f3eaccf074fd  # v2.16.5
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -170,7 +171,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.9
-        uses: pypa/cibuildwheel@ce3fb7832089eb3e723a0a99cab7f3eaccf074fd # v2.16.5
+        uses: pypa/cibuildwheel@ce3fb7832089eb3e723a0a99cab7f3eaccf074fd  # v2.16.5
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -178,7 +179,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for PyPy
-        uses: pypa/cibuildwheel@ce3fb7832089eb3e723a0a99cab7f3eaccf074fd # v2.16.5
+        uses: pypa/cibuildwheel@ce3fb7832089eb3e723a0a99cab7f3eaccf074fd  # v2.16.5
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -212,4 +213,4 @@ jobs:
         run: ls dist
 
       - name: Publish package distributions to PyPI
-        uses: pypa/gh-action-pypi-publish@2f6f737ca5f74c637829c0f5c3acd0e29ea5e8bf # v1.8.11
+        uses: pypa/gh-action-pypi-publish@2f6f737ca5f74c637829c0f5c3acd0e29ea5e8bf  # v1.8.11
diff --git a/.github/workflows/clean_pr.yml b/.github/workflows/clean_pr.yml
index f3ccb3195d77..77e49f7c1d9e 100644
--- a/.github/workflows/clean_pr.yml
+++ b/.github/workflows/clean_pr.yml
@@ -48,5 +48,6 @@ jobs:
       - name: Check for branches opened against main
         if: github.ref_name == 'main'
         run: |
-          printf 'PR branch should not be main. See https://matplotlib.org/devdocs/devel/development_workflow.html#make-a-new-feature-branch'
+          echo 'PR branch should not be main.'
+          echo 'See https://matplotlib.org/devdocs/devel/development_workflow.html#make-a-new-feature-branch'
           exit 1
diff --git a/.github/workflows/cygwin.yml b/.github/workflows/cygwin.yml
index 193e4c66082e..27e9f141a310 100644
--- a/.github/workflows/cygwin.yml
+++ b/.github/workflows/cygwin.yml
@@ -118,8 +118,7 @@ jobs:
         # GitHub Actions runs everything as Administrator.  I don't
         # know how to test for this, so set the uid for the CI job so
         # that the existing unix root detection will work.
-        run: |
-           /bin/mkpasswd.exe -c | sed -e "s/$(id -u)/0/" >/etc/passwd
+        run: /bin/mkpasswd.exe -c | sed -e "s/$(id -u)/0/" >/etc/passwd
 
       - name: Mark test repo safe
         shell: bash.exe -eo pipefail -o igncr "{0}"
@@ -143,8 +142,7 @@ jobs:
         with:
           path: C:\cygwin\home\runneradmin\.cache\pip
           key: Cygwin-py3.${{ matrix.python-minor-version }}-pip-${{ hashFiles('requirements/*/*.txt') }}
-          restore-keys: |
-            ${{ matrix.os }}-py3.${{ matrix.python-minor-version }}-pip-
+          restore-keys: ${{ matrix.os }}-py3.${{ matrix.python-minor-version }}-pip-
 
       - name: Cache ccache
         uses: actions/cache@v4
@@ -215,7 +213,8 @@ jobs:
       - name: Find DLLs to rebase
         shell: bash.exe -eo pipefail -o igncr "{0}"
         run: |
-          find {/usr,/usr/local}/{bin,lib/python3.*/site-packages} /usr/lib/lapack . -name \*.exe -o -name \*.dll -print >files_to_rebase.txt
+          find {/usr,/usr/local}/{bin,lib/python3.*/site-packages} /usr/lib/lapack . \
+            -name \*.exe -o -name \*.dll -print >files_to_rebase.txt
 
       - name: Rebase DLL list
         shell: ash.exe "{0}"
@@ -236,7 +235,9 @@ jobs:
           oldmplrc=$(python -c "from matplotlib import matplotlib_fname as mplrc_file; print(mplrc_file())")
           echo "${oldmplrc}"
           mkdir -p ~/.matplotlib/
-          sed -E -e 's~#animation\.ffmpeg_path:.+~animation.ffmpeg_path: /usr/bin/ffmpeg.exe~' "${oldmplrc}" >~/.matplotlib/matplotlibrc
+          sed -E \
+            -e 's~#animation\.ffmpeg_path:.+~animation.ffmpeg_path: /usr/bin/ffmpeg.exe~' \
+            "${oldmplrc}" >~/.matplotlib/matplotlibrc
 
       - name: Run pytest
         shell: bash.exe -eo pipefail -o igncr "{0}"
diff --git a/.github/workflows/good-first-issue.yml b/.github/workflows/good-first-issue.yml
index baac893a6a7a..8905511fc01d 100644
--- a/.github/workflows/good-first-issue.yml
+++ b/.github/workflows/good-first-issue.yml
@@ -1,3 +1,4 @@
+---
 name: Add comment on good first issues
 on:
   issues:
@@ -17,8 +18,13 @@ jobs:
           body: |
             ### Good first issue - notes for new contributors
 
-            This issue is suited to new contributors because it does not require understanding of the Matplotlib internals. To get started, please see our [contributing guide](https://matplotlib.org/stable/devel/index).
+            This issue is suited to new contributors because it does not require understanding of the
+            Matplotlib internals. To get started, please see our [contributing
+            guide](https://matplotlib.org/stable/devel/index).
 
-            **We do not assign issues**. Check the *Development* section in the sidebar for linked pull requests (PRs). If there are none, feel free to start working on it. If there is an open PR, please collaborate on the work by reviewing it rather than duplicating it in a competing PR.
+            **We do not assign issues**. Check the *Development* section in the sidebar for linked pull
+            requests (PRs). If there are none, feel free to start working on it. If there is an open PR, please
+            collaborate on the work by reviewing it rather than duplicating it in a competing PR.
 
-            If something is unclear, please reach out on any of our [communication channels](https://matplotlib.org/stable/devel/contributing.html#get-connected).
+            If something is unclear, please reach out on any of our [communication
+            channels](https://matplotlib.org/stable/devel/contributing.html#get-connected).
diff --git a/.github/workflows/nightlies.yml b/.github/workflows/nightlies.yml
index 8210fa237205..840b134969e1 100644
--- a/.github/workflows/nightlies.yml
+++ b/.github/workflows/nightlies.yml
@@ -59,7 +59,7 @@ jobs:
           ls -l dist/
 
       - name: Upload wheels to Anaconda Cloud as nightlies
-        uses: scientific-python/upload-nightly-action@6e9304f7a3a5501c6f98351537493ec898728299 # 0.3.0
+        uses: scientific-python/upload-nightly-action@6e9304f7a3a5501c6f98351537493ec898728299  # 0.3.0
         with:
           artifacts_path: dist
           anaconda_nightly_upload_token: ${{ secrets.ANACONDA_ORG_UPLOAD_TOKEN }}
diff --git a/.github/workflows/stale-tidy.yml b/.github/workflows/stale-tidy.yml
index 372acde37c03..92a81ee856e4 100644
--- a/.github/workflows/stale-tidy.yml
+++ b/.github/workflows/stale-tidy.yml
@@ -1,3 +1,4 @@
+---
 name: 'Close inactive issues'
 on:
   schedule:
diff --git a/.github/workflows/stale.yml b/.github/workflows/stale.yml
index c7268e1ea799..c606d4288bd2 100644
--- a/.github/workflows/stale.yml
+++ b/.github/workflows/stale.yml
@@ -1,3 +1,4 @@
+---
 name: 'Label inactive PRs'
 on:
   schedule:
@@ -12,11 +13,22 @@ jobs:
         with:
           repo-token: ${{ secrets.GITHUB_TOKEN }}
           operations-per-run: 20
-          stale-pr-message: 'Since this Pull Request has not been updated in 60 days, it has been marked "inactive." This does not mean that it will be closed, though it may be moved to a "Draft" state.  This helps maintainers prioritize their reviewing efforts. You can pick the PR back up anytime - please ping us if you need a review or guidance to move the PR forward!  If you do not plan on continuing the work, please let us know so that we can either find someone to take the PR over, or close it.'
+          stale-pr-message: >-
+            Since this Pull Request has not been updated in 60 days, it has been marked "inactive." This does
+            not mean that it will be closed, though it may be moved to a "Draft" state. This helps maintainers
+            prioritize their reviewing efforts. You can pick the PR back up anytime - please ping us if you
+            need a review or guidance to move the PR forward! If you do not plan on continuing the work, please
+            let us know so that we can either find someone to take the PR over, or close it.
           stale-pr-label: "status: inactive"
           days-before-pr-stale: 60
           days-before-pr-close: -1
-          stale-issue-message: 'This issue has been marked "inactive" because it has been 365 days since the last comment. If this issue is still present in recent Matplotlib releases, or the feature request is still wanted, please leave a comment and this label will be removed. If there are no updates in another 30 days, this issue will be automatically closed, but you are free to re-open or create a new issue if needed. We value issue reports, and this procedure is meant to help us resurface and prioritize issues that have not been addressed yet, not make them disappear.  Thanks for your help!'
+          stale-issue-message: >-
+            This issue has been marked "inactive" because it has been 365 days since the last comment. If this
+            issue is still present in recent Matplotlib releases, or the feature request is still wanted,
+            please leave a comment and this label will be removed. If there are no updates in another 30 days,
+            this issue will be automatically closed, but you are free to re-open or create a new issue if
+            needed. We value issue reports, and this procedure is meant to help us resurface and prioritize
+            issues that have not been addressed yet, not make them disappear. Thanks for your help!
           stale-issue-label: "status: inactive"
           close-issue-label: "status: closed as inactive"
           days-before-issue-stale: 365
diff --git a/.meeseeksdev.yml b/.meeseeksdev.yml
index 8bfd1b8e4257..f9d44d44cfdf 100644
--- a/.meeseeksdev.yml
+++ b/.meeseeksdev.yml
@@ -1,3 +1,4 @@
+---
 users:
   Carreau:
     can:
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 45d9aaa32591..a7d31f2643ca 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -1,3 +1,4 @@
+---
 ci:
   autofix_prs: false
   autoupdate_schedule: 'quarterly'
@@ -23,43 +24,42 @@ repos:
       - id: mixed-line-ending
       - id: name-tests-test
         args: ["--pytest-test-first"]
-      - id: no-commit-to-branch #default is master and main
+      - id: no-commit-to-branch  # Default is master and main.
       - id: trailing-whitespace
         exclude_types: [svg]
   - repo: https://github.com/pre-commit/mirrors-mypy
     rev: v1.8.0
     hooks:
       - id: mypy
-        additional_dependencies: [
-          pandas-stubs,
-          types-pillow,
-          types-python-dateutil,
-          types-psutil,
-          types-docutils,
-          types-PyYAML]
-        args: [
-          "--config-file=pyproject.toml",
-          "lib/matplotlib"
-          ]
-        files: lib/matplotlib #only run when files in lib/matplotlib are changed
+        additional_dependencies:
+          - pandas-stubs
+          - types-pillow
+          - types-python-dateutil
+          - types-psutil
+          - types-docutils
+          - types-PyYAML
+        args: ["--config-file=pyproject.toml", "lib/matplotlib"]
+        files: lib/matplotlib  # Only run when files in lib/matplotlib are changed.
         pass_filenames: false
   - repo: https://github.com/pycqa/flake8
     rev: 6.1.0
     hooks:
       - id: flake8
-        additional_dependencies: [pydocstyle>5.1.0, flake8-docstrings>1.4.0, flake8-force]
+        additional_dependencies:
+          - pydocstyle>5.1.0
+          - flake8-docstrings>1.4.0
+          - flake8-force
         args: ["--docstring-convention=all"]
   - repo: https://github.com/codespell-project/codespell
     rev: v2.2.6
     hooks:
       - id: codespell
         files: ^.*\.(py|c|cpp|h|m|md|rst|yml)$
-        args: [
-          "--ignore-words",
-          "ci/codespell-ignore-words.txt",
-          "--skip",
-          "doc/project/credits.rst"
-          ]
+        args:
+          - "--ignore-words"
+          - "ci/codespell-ignore-words.txt"
+          - "--skip"
+          - "doc/project/credits.rst"
   - repo: https://github.com/pycqa/isort
     rev: 5.13.2
     hooks:
@@ -73,3 +73,8 @@ repos:
         additional_dependencies:
           - sphinx>=1.8.1
           - tomli
+  - repo: https://github.com/adrienverge/yamllint
+    rev: v1.29.0
+    hooks:
+      - id: yamllint
+        args: ["--strict", "--config-file=.yamllint.yml"]
diff --git a/.yamllint.yml b/.yamllint.yml
new file mode 100644
index 000000000000..3b30533ececa
--- /dev/null
+++ b/.yamllint.yml
@@ -0,0 +1,9 @@
+---
+extends: default
+
+rules:
+  line-length:
+    max: 111
+    allow-non-breakable-words: true
+  truthy:
+    check-keys: false
diff --git a/azure-pipelines.yml b/azure-pipelines.yml
index ac983fb58f6b..cb5be2379091 100644
--- a/azure-pipelines.yml
+++ b/azure-pipelines.yml
@@ -1,8 +1,10 @@
 # Python package
 # Create and test a Python package on multiple Python versions.
-# Add steps that analyze code, save the dist with the build record, publish to a PyPI-compatible index, and more:
+# Add steps that analyze code, save the dist with the build record, publish to a PyPI-compatible index, and
+# more:
 # https://docs.microsoft.com/en-us/azure/devops/pipelines/ecosystems/python?view=azure-devops
 
+---
 trigger:
   branches:
     exclude:
@@ -18,261 +20,266 @@ pr:
 
 stages:
 
-- stage: Check
-  jobs:
-  - job: Skip
-    pool:
-      vmImage: 'ubuntu-latest'
-    variables:
-      DECODE_PERCENTS: 'false'
-      RET: 'true'
-    steps:
-    - bash: |
-        git_log=`git log --max-count=1 --skip=1 --pretty=format:"%B" | tr "\n" " "`
-        echo "##vso[task.setvariable variable=log]$git_log"
-    - bash: echo "##vso[task.setvariable variable=RET]false"
-      condition: or(contains(variables.log, '[skip azp]'), contains(variables.log, '[azp skip]'), contains(variables.log, '[skip ci]'), contains(variables.log, '[ci skip]'), contains(variables.log, '[ci doc]'))
-    - bash: echo "##vso[task.setvariable variable=start_main;isOutput=true]$RET"
-      name: result
+  - stage: Check
+    jobs:
+      - job: Skip
+        pool:
+          vmImage: 'ubuntu-latest'
+        variables:
+          DECODE_PERCENTS: 'false'
+          RET: 'true'
+        steps:
+          - bash: |
+              git_log=`git log --max-count=1 --skip=1 --pretty=format:"%B" | tr "\n" " "`
+              echo "##vso[task.setvariable variable=log]$git_log"
+          - bash: echo "##vso[task.setvariable variable=RET]false"
+            condition: >-
+              or(contains(variables.log, '[skip azp]'),
+                 contains(variables.log, '[azp skip]'),
+                 contains(variables.log, '[skip ci]'),
+                 contains(variables.log, '[ci skip]'),
+                 contains(variables.log, '[ci doc]'))
+          - bash: echo "##vso[task.setvariable variable=start_main;isOutput=true]$RET"
+            name: result
 
-- stage: Main
-  condition: and(succeeded(), eq(dependencies.Check.outputs['Skip.result.start_main'], 'true'))
-  dependsOn: Check
-  jobs:
-    - job: Pytest
-      strategy:
-        matrix:
-          Linux_py39:
-            vmImage: 'ubuntu-20.04'  # keep one job pinned to the oldest image
-            python.version: '3.9'
-          Linux_py310:
-            vmImage: 'ubuntu-latest'
-            python.version: '3.10'
-          Linux_py311:
-            vmImage: 'ubuntu-latest'
-            python.version: '3.11'
-          macOS_py39:
-            vmImage: 'macOS-latest'
-            python.version: '3.9'
-          macOS_py310:
-            vmImage: 'macOS-latest'
-            python.version: '3.10'
-          macOS_py311:
-            vmImage: 'macOS-latest'
-            python.version: '3.11'
-          Windows_py39:
-            vmImage: 'windows-2019'  # keep one job pinned to the oldest image
-            python.version: '3.9'
-          Windows_py310:
-            vmImage: 'windows-latest'
-            python.version: '3.10'
-          Windows_py311:
-            vmImage: 'windows-latest'
-            python.version: '3.11'
-        maxParallel: 4
-      pool:
-        vmImage: '$(vmImage)'
-      steps:
-      - task: UsePythonVersion@0
-        inputs:
-          versionSpec: '$(python.version)'
-          architecture: 'x64'
-        displayName: 'Use Python $(python.version)'
+  - stage: Main
+    condition: and(succeeded(), eq(dependencies.Check.outputs['Skip.result.start_main'], 'true'))
+    dependsOn: Check
+    jobs:
+      - job: Pytest
+        strategy:
+          matrix:
+            Linux_py39:
+              vmImage: 'ubuntu-20.04'  # keep one job pinned to the oldest image
+              python.version: '3.9'
+            Linux_py310:
+              vmImage: 'ubuntu-latest'
+              python.version: '3.10'
+            Linux_py311:
+              vmImage: 'ubuntu-latest'
+              python.version: '3.11'
+            macOS_py39:
+              vmImage: 'macOS-latest'
+              python.version: '3.9'
+            macOS_py310:
+              vmImage: 'macOS-latest'
+              python.version: '3.10'
+            macOS_py311:
+              vmImage: 'macOS-latest'
+              python.version: '3.11'
+            Windows_py39:
+              vmImage: 'windows-2019'  # keep one job pinned to the oldest image
+              python.version: '3.9'
+            Windows_py310:
+              vmImage: 'windows-latest'
+              python.version: '3.10'
+            Windows_py311:
+              vmImage: 'windows-latest'
+              python.version: '3.11'
+          maxParallel: 4
+        pool:
+          vmImage: '$(vmImage)'
+        steps:
+          - task: UsePythonVersion@0
+            inputs:
+              versionSpec: '$(python.version)'
+              architecture: 'x64'
+            displayName: 'Use Python $(python.version)'
 
-      - bash: |
-          set -e
-          case "$AGENT_OS" in
-          Linux)
-            echo 'Acquire::Retries "3";' | sudo tee /etc/apt/apt.conf.d/80-retries
-            sudo apt update
-            sudo apt install --no-install-recommends \
-              cm-super \
-              dvipng \
-              ffmpeg \
-              fonts-freefont-otf \
-              fonts-noto-cjk \
-              fonts-wqy-zenhei \
-              gdb \
-              gir1.2-gtk-3.0 \
-              graphviz \
-              inkscape \
-              language-pack-de \
-              lcov \
-              libcairo2 \
-              libgirepository-1.0-1 \
-              lmodern \
-              ninja-build \
-              poppler-utils \
-              texlive-fonts-recommended \
-              texlive-latex-base \
-              texlive-latex-extra \
-              texlive-latex-recommended \
-              texlive-luatex \
-              texlive-pictures \
-              texlive-xetex
-            ;;
-          Darwin)
-            brew install --cask xquartz
-            brew install ccache ffmpeg imagemagick mplayer ninja pkg-config
-            brew tap homebrew/cask-fonts
-            brew install font-noto-sans-cjk-sc
-            ;;
-          Windows_NT)
-            choco install ninja
-            ;;
-          *)
-            exit 1
-            ;;
-          esac
-        displayName: 'Install dependencies'
+          - bash: |
+              set -e
+              case "$AGENT_OS" in
+              Linux)
+                echo 'Acquire::Retries "3";' | sudo tee /etc/apt/apt.conf.d/80-retries
+                sudo apt update
+                sudo apt install --no-install-recommends \
+                  cm-super \
+                  dvipng \
+                  ffmpeg \
+                  fonts-freefont-otf \
+                  fonts-noto-cjk \
+                  fonts-wqy-zenhei \
+                  gdb \
+                  gir1.2-gtk-3.0 \
+                  graphviz \
+                  inkscape \
+                  language-pack-de \
+                  lcov \
+                  libcairo2 \
+                  libgirepository-1.0-1 \
+                  lmodern \
+                  ninja-build \
+                  poppler-utils \
+                  texlive-fonts-recommended \
+                  texlive-latex-base \
+                  texlive-latex-extra \
+                  texlive-latex-recommended \
+                  texlive-luatex \
+                  texlive-pictures \
+                  texlive-xetex
+                ;;
+              Darwin)
+                brew install --cask xquartz
+                brew install ccache ffmpeg imagemagick mplayer ninja pkg-config
+                brew tap homebrew/cask-fonts
+                brew install font-noto-sans-cjk-sc
+                ;;
+              Windows_NT)
+                choco install ninja
+                ;;
+              *)
+                exit 1
+                ;;
+              esac
+            displayName: 'Install dependencies'
 
-      - bash: |
-          python -m pip install --upgrade pip
-          python -m pip install --upgrade meson-python pybind11
-          python -m pip install -r requirements/testing/all.txt -r requirements/testing/extra.txt
-        displayName: 'Install dependencies with pip'
+          - bash: |
+              python -m pip install --upgrade pip
+              python -m pip install --upgrade meson-python pybind11
+              python -m pip install -r requirements/testing/all.txt -r requirements/testing/extra.txt
+            displayName: 'Install dependencies with pip'
 
-      - bash: |
-          case "$AGENT_OS" in
-          Linux)
-            export CPPFLAGS='--coverage -fprofile-abs-path'
-            ;;
-          Darwin)
-            export CPPFLAGS='-fprofile-instr-generate=default.%m.profraw'
-            export CPPFLAGS="$CPPFLAGS -fcoverage-mapping"
-            ;;
-          Windows_NT)
-            CONFIG='--config-settings=setup-args=--vsenv'
-            CONFIG="$CONFIG --config-settings=setup-args=-Dcpp_link_args=-PROFILE"
-            CONFIG="$CONFIG --config-settings=setup-args=-Dbuildtype=debug"
-            ;;
-          *)
-            exit 1
-            ;;
-          esac
+          - bash: |
+              case "$AGENT_OS" in
+              Linux)
+                export CPPFLAGS='--coverage -fprofile-abs-path'
+                ;;
+              Darwin)
+                export CPPFLAGS='-fprofile-instr-generate=default.%m.profraw'
+                export CPPFLAGS="$CPPFLAGS -fcoverage-mapping"
+                ;;
+              Windows_NT)
+                CONFIG='--config-settings=setup-args=--vsenv'
+                CONFIG="$CONFIG --config-settings=setup-args=-Dcpp_link_args=-PROFILE"
+                CONFIG="$CONFIG --config-settings=setup-args=-Dbuildtype=debug"
+                ;;
+              *)
+                exit 1
+                ;;
+              esac
 
-          python -m pip install \
-            --no-build-isolation $CONFIG \
-            --verbose --editable .[dev]
-        displayName: "Install self"
+              python -m pip install \
+                --no-build-isolation $CONFIG \
+                --verbose --editable .[dev]
+            displayName: "Install self"
 
-      - script: env
-        displayName: 'print env'
+          - script: env
+            displayName: 'print env'
 
-      - script: pip list
-        displayName: 'print pip'
+          - script: pip list
+            displayName: 'print pip'
 
-      - bash: |
-          set -e
-          if [[ "$AGENT_OS" == 'Windows_NT' ]]; then
-            SESSION_ID=$(python -c "import uuid; print(uuid.uuid4(), end='')")
-            echo "Coverage session ID: ${SESSION_ID}"
-            VS=$(ls -d /c/Program\ Files*/Microsoft\ Visual\ Studio/*/Enterprise)
-            echo "Visual Studio: ${VS}"
-            DIR="$VS/Common7/IDE/Extensions/Microsoft/CodeCoverage.Console"
-            if [[ -d $DIR ]]; then
-              # This is for MSVC 2022 (on windows-latest).
-              TOOL="$DIR/Microsoft.CodeCoverage.Console.exe"
-              for f in build/cp*/src/*.pyd; do
-                echo $f
-                echo "=============================="
-                "$TOOL" instrument $f --session-id $SESSION_ID \
-                  --log-level Verbose --log-file instrument.log
-                cat instrument.log
-                rm instrument.log
-              done
-              echo "Starting $TOOL in server mode"
-              "$TOOL" collect \
-                  --session-id $SESSION_ID --server-mode \
-                  --output-format cobertura --output extensions.xml \
-                  --log-level Verbose --log-file extensions.log &
-              VS_VER=2022
-            else
-            DIR="$VS"/Team\ Tools/Dynamic\ Code\ Coverage\ Tools/amd64
-            if [[ -d $DIR ]]; then
-              # This is for MSVC 2019 (on windows-2019).
-              VSINSTR="$VS"/Team\ Tools/Performance\ Tools/vsinstr.exe
-              for f in build/cp*/src/*.pyd; do
-                "$VSINSTR" $f -Verbose -Coverage
-              done
-              TOOL="$DIR/CodeCoverage.exe"
-              cat > extensions.config << EOF
-          <CodeCoverage>
-            <CollectFromChildProcesses>true</CollectFromChildProcesses>
-            <ModulePaths>
-              <Include>
-                <ModulePath>.*\\.*\.pyd</ModulePath>
-              </Include>
-            </ModulePaths>
-          </CodeCoverage>
-          EOF
-              echo "Starting $TOOL in server mode"
-              "$TOOL" collect \
-                -config:extensions.config -session:$SESSION_ID \
-                -output:extensions.coverage -verbose &
-              echo "Started $TOOL"
-              VS_VER=2019
-            fi
-            fi
-            echo "##vso[task.setvariable variable=VS_COVERAGE_TOOL]$TOOL"
-          fi
-          PYTHONFAULTHANDLER=1 pytest -rfEsXR -n 2 \
-              --maxfail=50 --timeout=300 --durations=25 \
-              --junitxml=junit/test-results.xml --cov-report=xml --cov=lib
-          if [[ -n $SESSION_ID ]]; then
-            if [[ $VS_VER == 2022 ]]; then
-              "$TOOL" shutdown $SESSION_ID
-              echo "Coverage collection log"
-              echo "======================="
-              cat extensions.log
-            else
-              "$TOOL" shutdown -session:$SESSION_ID
-            fi
-          fi
-        displayName: 'pytest'
+          - bash: |
+              set -e
+              if [[ "$AGENT_OS" == 'Windows_NT' ]]; then
+                SESSION_ID=$(python -c "import uuid; print(uuid.uuid4(), end='')")
+                echo "Coverage session ID: ${SESSION_ID}"
+                VS=$(ls -d /c/Program\ Files*/Microsoft\ Visual\ Studio/*/Enterprise)
+                echo "Visual Studio: ${VS}"
+                DIR="$VS/Common7/IDE/Extensions/Microsoft/CodeCoverage.Console"
+                if [[ -d $DIR ]]; then
+                  # This is for MSVC 2022 (on windows-latest).
+                  TOOL="$DIR/Microsoft.CodeCoverage.Console.exe"
+                  for f in build/cp*/src/*.pyd; do
+                    echo $f
+                    echo "=============================="
+                    "$TOOL" instrument $f --session-id $SESSION_ID \
+                      --log-level Verbose --log-file instrument.log
+                    cat instrument.log
+                    rm instrument.log
+                  done
+                  echo "Starting $TOOL in server mode"
+                  "$TOOL" collect \
+                      --session-id $SESSION_ID --server-mode \
+                      --output-format cobertura --output extensions.xml \
+                      --log-level Verbose --log-file extensions.log &
+                  VS_VER=2022
+                else
+                DIR="$VS"/Team\ Tools/Dynamic\ Code\ Coverage\ Tools/amd64
+                if [[ -d $DIR ]]; then
+                  # This is for MSVC 2019 (on windows-2019).
+                  VSINSTR="$VS"/Team\ Tools/Performance\ Tools/vsinstr.exe
+                  for f in build/cp*/src/*.pyd; do
+                    "$VSINSTR" $f -Verbose -Coverage
+                  done
+                  TOOL="$DIR/CodeCoverage.exe"
+                  cat > extensions.config << EOF
+              <CodeCoverage>
+                <CollectFromChildProcesses>true</CollectFromChildProcesses>
+                <ModulePaths>
+                  <Include>
+                    <ModulePath>.*\\.*\.pyd</ModulePath>
+                  </Include>
+                </ModulePaths>
+              </CodeCoverage>
+              EOF
+                  echo "Starting $TOOL in server mode"
+                  "$TOOL" collect \
+                    -config:extensions.config -session:$SESSION_ID \
+                    -output:extensions.coverage -verbose &
+                  echo "Started $TOOL"
+                  VS_VER=2019
+                fi
+                fi
+                echo "##vso[task.setvariable variable=VS_COVERAGE_TOOL]$TOOL"
+              fi
+              PYTHONFAULTHANDLER=1 pytest -rfEsXR -n 2 \
+                  --maxfail=50 --timeout=300 --durations=25 \
+                  --junitxml=junit/test-results.xml --cov-report=xml --cov=lib
+              if [[ -n $SESSION_ID ]]; then
+                if [[ $VS_VER == 2022 ]]; then
+                  "$TOOL" shutdown $SESSION_ID
+                  echo "Coverage collection log"
+                  echo "======================="
+                  cat extensions.log
+                else
+                  "$TOOL" shutdown -session:$SESSION_ID
+                fi
+              fi
+            displayName: 'pytest'
 
-      - bash: |
-          case "$AGENT_OS" in
-          Linux)
-            lcov --rc lcov_branch_coverage=1 --capture --directory . \
-              --output-file coverage.info
-            lcov --rc lcov_branch_coverage=1 --output-file coverage.info \
-              --extract coverage.info $PWD/src/'*' $PWD/lib/'*'
-            lcov --rc lcov_branch_coverage=1 --list coverage.info
-            find . -name '*.gc*' -delete
-            ;;
-          Darwin)
-            xcrun llvm-profdata merge -sparse default.*.profraw \
-              -o default.profdata
-            xcrun llvm-cov export -format="lcov" build/*/src/*.so \
-              -instr-profile default.profdata > info.lcov
-            ;;
-          Windows_NT)
-            if [[ -f extensions.coverage ]]; then
-              # For MSVC 2019.
-              "$VS_COVERAGE_TOOL" analyze -output:extensions.xml \
-                -include_skipped_functions -include_skipped_modules \
-                extensions.coverage
-              rm extensions.coverage
-            fi
-            ;;
-          *)
-            exit 1
-            ;;
-          esac
-        displayName: 'Filter C coverage'
-      - bash: |
-          bash <(curl -s https://codecov.io/bash) \
-            -n "$PYTHON_VERSION $AGENT_OS" \
-            -f 'coverage.xml' -f 'extensions.xml'
-        displayName: 'Upload to codecov.io'
+          - bash: |
+              case "$AGENT_OS" in
+              Linux)
+                lcov --rc lcov_branch_coverage=1 --capture --directory . \
+                  --output-file coverage.info
+                lcov --rc lcov_branch_coverage=1 --output-file coverage.info \
+                  --extract coverage.info $PWD/src/'*' $PWD/lib/'*'
+                lcov --rc lcov_branch_coverage=1 --list coverage.info
+                find . -name '*.gc*' -delete
+                ;;
+              Darwin)
+                xcrun llvm-profdata merge -sparse default.*.profraw \
+                  -o default.profdata
+                xcrun llvm-cov export -format="lcov" build/*/src/*.so \
+                  -instr-profile default.profdata > info.lcov
+                ;;
+              Windows_NT)
+                if [[ -f extensions.coverage ]]; then
+                  # For MSVC 2019.
+                  "$VS_COVERAGE_TOOL" analyze -output:extensions.xml \
+                    -include_skipped_functions -include_skipped_modules \
+                    extensions.coverage
+                  rm extensions.coverage
+                fi
+                ;;
+              *)
+                exit 1
+                ;;
+              esac
+            displayName: 'Filter C coverage'
+          - bash: |
+              bash <(curl -s https://codecov.io/bash) \
+                -n "$PYTHON_VERSION $AGENT_OS" \
+                -f 'coverage.xml' -f 'extensions.xml'
+            displayName: 'Upload to codecov.io'
 
-      - task: PublishTestResults@2
-        inputs:
-          testResultsFiles: '**/test-results.xml'
-          testRunTitle: 'Python $(python.version)'
-        condition: succeededOrFailed()
+          - task: PublishTestResults@2
+            inputs:
+              testResultsFiles: '**/test-results.xml'
+              testRunTitle: 'Python $(python.version)'
+            condition: succeededOrFailed()
 
-      - publish: $(System.DefaultWorkingDirectory)/result_images
-        artifact: $(Agent.JobName)-result_images
-        condition: failed()
+          - publish: $(System.DefaultWorkingDirectory)/result_images
+            artifact: $(Agent.JobName)-result_images
+            condition: failed()
diff --git a/environment.yml b/environment.yml
index 174497df6b4d..b7220ad446c2 100644
--- a/environment.yml
+++ b/environment.yml
@@ -4,6 +4,7 @@
 #   conda activate mpl-dev
 #   pip install -e .[dev]
 #
+---
 name: mpl-dev
 channels:
   - conda-forge
diff --git a/src/.clang-format b/src/.clang-format
index d54ffcedf924..f3a6eb540777 100644
--- a/src/.clang-format
+++ b/src/.clang-format
@@ -1,5 +1,5 @@
 ---
-# BasedOnStyle:  LLVM
+# BasedOnStyle: LLVM
 AccessModifierOffset: -2
 ConstructorInitializerIndentWidth: 4
 AlignEscapedNewlinesLeft: false
@@ -13,7 +13,7 @@ BreakBeforeBinaryOperators: false
 BreakBeforeTernaryOperators: true
 BreakConstructorInitializersBeforeComma: false
 BinPackParameters: false
-ColumnLimit:     100
+ColumnLimit: 100
 ConstructorInitializerAllOnOneLineOrOnePerLine: true
 DerivePointerBinding: false
 ExperimentalAutoDetectBinPacking: false
@@ -30,14 +30,14 @@ PenaltyReturnTypeOnItsOwnLine: 60
 PointerBindsToType: false
 SpacesBeforeTrailingComments: 1
 Cpp11BracedListStyle: false
-Standard:        Cpp03
-IndentWidth:     4
-TabWidth:        8
-UseTab:          Never
+Standard: Cpp03
+IndentWidth: 4
+TabWidth: 8
+UseTab: Never
 BreakBeforeBraces: Linux
 IndentFunctionDeclarationAfterType: false
 SpacesInParentheses: false
-SpacesInAngles:  false
+SpacesInAngles: false
 SpaceInEmptyParentheses: false
 SpacesInCStyleCastParentheses: false
 SpaceAfterControlStatementKeyword: true

From 5f78211f19c25edc13082e1ea3fc4c79d1b35478 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 24 Jan 2024 05:31:27 -0500
Subject: [PATCH 0750/1120] ci: Fold some lines in config where possible

The `if:` expressions don't need to preserve newlines, for example.
---
 .github/ISSUE_TEMPLATE/bug_report.yml    | 4 ++--
 .github/ISSUE_TEMPLATE/documentation.yml | 7 +++----
 .github/ISSUE_TEMPLATE/tag_proposal.yml  | 6 +++---
 .github/workflows/cibuildwheel.yml       | 4 ++--
 .github/workflows/cygwin.yml             | 2 +-
 .github/workflows/tests.yml              | 6 ++----
 6 files changed, 13 insertions(+), 16 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
index ee840286ab75..3f28c6952a39 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.yml
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -16,7 +16,7 @@ body:
     id: reproduction
     attributes:
       label: Code for reproduction
-      description: |
+      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
@@ -26,7 +26,7 @@ body:
     id: actual
     attributes:
       label: Actual outcome
-      description: |
+      description: >-
         Paste the output produced by the code provided above, e.g.
         console output, images/videos produced by the code, any relevant screenshots/screencasts, etc.
     validations:
diff --git a/.github/ISSUE_TEMPLATE/documentation.yml b/.github/ISSUE_TEMPLATE/documentation.yml
index 0fc16a0f8bea..5f7a0d6c7176 100644
--- a/.github/ISSUE_TEMPLATE/documentation.yml
+++ b/.github/ISSUE_TEMPLATE/documentation.yml
@@ -8,10 +8,9 @@ body:
     id: link
     attributes:
       label: Documentation Link
-      description: |
-        Link to any documentation or examples that you are referencing.
-        Suggested improvements should be based on the development version of the docs:
-        https://matplotlib.org/devdocs/
+      description: >-
+        Link to any documentation or examples that you are referencing. Suggested improvements should be based
+        on [the development version of the docs](https://matplotlib.org/devdocs/)
       placeholder: https://matplotlib.org/devdocs/...
   - type: textarea
     id: problem
diff --git a/.github/ISSUE_TEMPLATE/tag_proposal.yml b/.github/ISSUE_TEMPLATE/tag_proposal.yml
index 6f7875d1a61a..aa3345336089 100644
--- a/.github/ISSUE_TEMPLATE/tag_proposal.yml
+++ b/.github/ISSUE_TEMPLATE/tag_proposal.yml
@@ -6,8 +6,8 @@ labels: [Tag proposal]
 body:
   - type: markdown
     attributes:
-      value: |
-         Please search the [tag glossary]() for relevant tags before creating a new tag proposal.
+      value: >-
+        Please search the [tag glossary]() for relevant tags before creating a new tag proposal.
   - type: textarea
     id: need
     attributes:
@@ -24,5 +24,5 @@ body:
     id: solution
     attributes:
       label: Proposed solution
-      description: >
+      description: >-
         What should the tag be? All tags are in the format `subcategory: tag`
diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 3c9a6eefe704..68e144d5b911 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -23,7 +23,7 @@ permissions:
 
 jobs:
   build_sdist:
-    if: |
+    if: >-
       github.event_name == 'push' ||
       github.event_name == 'pull_request' && (
         (
@@ -76,7 +76,7 @@ jobs:
           if-no-files-found: error
 
   build_wheels:
-    if: |
+    if: >-
       github.event_name == 'push' ||
       github.event_name == 'pull_request' && (
         (
diff --git a/.github/workflows/cygwin.yml b/.github/workflows/cygwin.yml
index 27e9f141a310..97c8c34afa60 100644
--- a/.github/workflows/cygwin.yml
+++ b/.github/workflows/cygwin.yml
@@ -49,7 +49,7 @@ jobs:
   test-cygwin:
     runs-on: windows-latest
     name: Python 3.${{ matrix.python-minor-version }} on Cygwin
-    if: |
+    if: >-
       github.event_name == 'workflow_dispatch' ||
       github.event_name == 'schedule' ||
       (
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index f10dee502ff9..a825b4cf263b 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -30,7 +30,7 @@ env:
 
 jobs:
   test:
-    if: |
+    if: >-
       github.event_name == 'workflow_dispatch' ||
       (
         github.repository == 'matplotlib/matplotlib' &&
@@ -278,9 +278,7 @@ jobs:
 
       - name: Install the nightly dependencies
         # Only install the nightly dependencies during the scheduled event
-        if: |
-          github.event_name == 'schedule' &&
-          matrix.name-suffix != '(Minimum Versions)'
+        if: github.event_name == 'schedule' && matrix.name-suffix != '(Minimum Versions)'
         run: |
           python -m pip install pytz tzdata  # Must be installed for Pandas.
           python -m pip install \

From c03bd130ff98fb8a156cf1702efa3afbafe2d727 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 24 Jan 2024 06:17:28 -0500
Subject: [PATCH 0751/1120] Verify schemas on YAML files

---
 .appveyor.yml                         |  2 +-
 .github/ISSUE_TEMPLATE/bug_report.yml |  4 +--
 .github/codecov.yml                   |  6 ++---
 .pre-commit-config.yaml               | 35 +++++++++++++++++++++++++++
 4 files changed, 40 insertions(+), 7 deletions(-)

diff --git a/.appveyor.yml b/.appveyor.yml
index 69d634a6fcc9..01f2a2fb6e21 100644
--- a/.appveyor.yml
+++ b/.appveyor.yml
@@ -94,7 +94,7 @@ test_script:
 artifacts:
   - path: result_images\*
     name: result_images
-    type: zip
+    type: Zip
 
 on_finish:
   - conda install codecov
diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
index 3f28c6952a39..045386dc7402 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.yml
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -8,8 +8,6 @@ body:
     attributes:
       label: Bug summary
       description: Describe the bug in 1-2 short sentences
-      placeholder:
-      value:
     validations:
       required: true
   - type: textarea
@@ -19,7 +17,7 @@ body:
       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
+      render: Python
     validations:
       required: true
   - type: textarea
diff --git a/.github/codecov.yml b/.github/codecov.yml
index b4318a386381..00e7612bd1e6 100644
--- a/.github/codecov.yml
+++ b/.github/codecov.yml
@@ -14,20 +14,20 @@ coverage:
         target: 50%
         if_no_uploads: error
         if_not_found: success
-        if_ci_failed: failure
+        if_ci_failed: error
     project:
       default: false
       library:
         target: 50%
         if_no_uploads: error
         if_not_found: success
-        if_ci_failed: failure
+        if_ci_failed: error
         paths:
           - '!lib/.*/tests/.*'
       tests:
         target: auto
         if_no_uploads: error
         if_not_found: success
-        if_ci_failed: failure
+        if_ci_failed: error
         paths:
           - 'lib/.*/tests/.*'
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index a7d31f2643ca..8ca946db10fa 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -78,3 +78,38 @@ repos:
     hooks:
       - id: yamllint
         args: ["--strict", "--config-file=.yamllint.yml"]
+  - repo: https://github.com/python-jsonschema/check-jsonschema
+    rev: 0.28.0
+    hooks:
+      # TODO: Re-enable this when https://github.com/microsoft/azure-pipelines-vscode/issues/567 is fixed.
+      # - id: check-azure-pipelines
+      - id: check-dependabot
+      - id: check-github-workflows
+      - id: check-jsonschema
+        files: ^\.appveyor\.yml$
+        args: ["--verbose", "--schemafile", "https://json.schemastore.org/appveyor.json"]
+      - id: check-jsonschema
+        files: ^\.circleci/config\.yml$
+        args: ["--verbose", "--schemafile", "https://json.schemastore.org/circleciconfig.json"]
+      - id: check-jsonschema
+        files: ^\.github/FUNDING\.yml$
+        args: ["--verbose", "--schemafile", "https://json.schemastore.org/github-funding.json"]
+      - id: check-jsonschema
+        files: ^\.github/ISSUE_TEMPLATE/config\.yml$
+        args: ["--verbose", "--schemafile", "https://json.schemastore.org/github-issue-config.json"]
+      - id: check-jsonschema
+        files: ^\.github/ISSUE_TEMPLATE/.*\.yml$
+        exclude: ^\.github/ISSUE_TEMPLATE/config\.yml$
+        args: ["--verbose", "--schemafile", "https://json.schemastore.org/github-issue-forms.json"]
+      - id: check-jsonschema
+        files: ^\.github/codecov\.yml$
+        args: ["--verbose", "--schemafile", "https://json.schemastore.org/codecov.json"]
+      - id: check-jsonschema
+        files: ^\.github/labeler\.yml$
+        args: ["--verbose", "--schemafile", "https://json.schemastore.org/pull-request-labeler-5.json"]
+      - id: check-jsonschema
+        files: ^environment\.yml$
+        args:
+          - "--verbose"
+          - "--schemafile"
+          - "https://github.com/microsoft/vscode-python/raw/main/schemas/conda-environment.json"

From 81709d43ec57f327223b302414760c90322c9cf6 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Mon, 12 Feb 2024 21:22:16 -0500
Subject: [PATCH 0752/1120] ci: Vendor remote YAML schemas

This is necessary because pre-commit CI doesn't have Internet access and
thus cannot download schemas itself.
---
 .pre-commit-config.yaml                |   29 +-
 ci/schemas/README.md                   |    5 +
 ci/schemas/appveyor.json               |  781 +++++++++++++
 ci/schemas/circleciconfig.json         | 1411 ++++++++++++++++++++++++
 ci/schemas/codecov.json                |  620 +++++++++++
 ci/schemas/conda-environment.json      |   53 +
 ci/schemas/github-funding.json         |  113 ++
 ci/schemas/github-issue-config.json    |   45 +
 ci/schemas/github-issue-forms.json     | 1295 ++++++++++++++++++++++
 ci/schemas/pull-request-labeler-5.json |   95 ++
 ci/schemas/vendor_schemas.py           |   50 +
 11 files changed, 4486 insertions(+), 11 deletions(-)
 create mode 100644 ci/schemas/README.md
 create mode 100644 ci/schemas/appveyor.json
 create mode 100644 ci/schemas/circleciconfig.json
 create mode 100644 ci/schemas/codecov.json
 create mode 100644 ci/schemas/conda-environment.json
 create mode 100644 ci/schemas/github-funding.json
 create mode 100644 ci/schemas/github-issue-config.json
 create mode 100644 ci/schemas/github-issue-forms.json
 create mode 100644 ci/schemas/pull-request-labeler-5.json
 create mode 100644 ci/schemas/vendor_schemas.py

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 8ca946db10fa..38fbae18c920 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -85,31 +85,38 @@ repos:
       # - id: check-azure-pipelines
       - id: check-dependabot
       - id: check-github-workflows
+      # NOTE: If any of the below schema files need to be changed, be sure to
+      # update the `ci/vendor_schemas.py` script.
       - id: check-jsonschema
+        name: "Validate AppVeyor config"
         files: ^\.appveyor\.yml$
-        args: ["--verbose", "--schemafile", "https://json.schemastore.org/appveyor.json"]
+        args: ["--verbose", "--schemafile", "ci/schemas/appveyor.json"]
       - id: check-jsonschema
+        name: "Validate CircleCI config"
         files: ^\.circleci/config\.yml$
-        args: ["--verbose", "--schemafile", "https://json.schemastore.org/circleciconfig.json"]
+        args: ["--verbose", "--schemafile", "ci/schemas/circleciconfig.json"]
       - id: check-jsonschema
+        name: "Validate GitHub funding file"
         files: ^\.github/FUNDING\.yml$
-        args: ["--verbose", "--schemafile", "https://json.schemastore.org/github-funding.json"]
+        args: ["--verbose", "--schemafile", "ci/schemas/github-funding.json"]
       - id: check-jsonschema
+        name: "Validate GitHub issue config"
         files: ^\.github/ISSUE_TEMPLATE/config\.yml$
-        args: ["--verbose", "--schemafile", "https://json.schemastore.org/github-issue-config.json"]
+        args: ["--verbose", "--schemafile", "ci/schemas/github-issue-config.json"]
       - id: check-jsonschema
+        name: "Validate GitHub issue templates"
         files: ^\.github/ISSUE_TEMPLATE/.*\.yml$
         exclude: ^\.github/ISSUE_TEMPLATE/config\.yml$
-        args: ["--verbose", "--schemafile", "https://json.schemastore.org/github-issue-forms.json"]
+        args: ["--verbose", "--schemafile", "ci/schemas/github-issue-forms.json"]
       - id: check-jsonschema
+        name: "Validate CodeCov config"
         files: ^\.github/codecov\.yml$
-        args: ["--verbose", "--schemafile", "https://json.schemastore.org/codecov.json"]
+        args: ["--verbose", "--schemafile", "ci/schemas/codecov.json"]
       - id: check-jsonschema
+        name: "Validate GitHub labeler config"
         files: ^\.github/labeler\.yml$
-        args: ["--verbose", "--schemafile", "https://json.schemastore.org/pull-request-labeler-5.json"]
+        args: ["--verbose", "--schemafile", "ci/schemas/pull-request-labeler-5.json"]
       - id: check-jsonschema
+        name: "Validate Conda environment file"
         files: ^environment\.yml$
-        args:
-          - "--verbose"
-          - "--schemafile"
-          - "https://github.com/microsoft/vscode-python/raw/main/schemas/conda-environment.json"
+        args: ["--verbose", "--schemafile", "ci/schemas/conda-environment.json"]
diff --git a/ci/schemas/README.md b/ci/schemas/README.md
new file mode 100644
index 000000000000..087fd31d2ab8
--- /dev/null
+++ b/ci/schemas/README.md
@@ -0,0 +1,5 @@
+YAML Schemas for linting and validation
+=======================================
+
+Since pre-commit CI doesn't have Internet access, we need to bundle these files
+in the repo. The schemas can be updated using `vendor_schemas.py`.
diff --git a/ci/schemas/appveyor.json b/ci/schemas/appveyor.json
new file mode 100644
index 000000000000..d19a10f23b75
--- /dev/null
+++ b/ci/schemas/appveyor.json
@@ -0,0 +1,781 @@
+{
+  "$schema": "http://json-schema.org/draft-04/schema#",
+  "allOf": [
+    {
+      "$ref": "#/definitions/job"
+    }
+  ],
+  "definitions": {
+    "possiblySecretString": {
+      "anyOf": [
+        {
+          "type": "string",
+          "description": "This value will be used directly (regular string)"
+        },
+        {
+          "type": "number",
+          "description": "This value will be treated as a string even though it is a number"
+        },
+        {
+          "title": "secret string",
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "secure": {
+              "type": "string",
+              "description": "This should have been encrypted by the same user account to which the project belongs"
+            }
+          }
+        }
+      ]
+    },
+    "commitFilter": {
+      "title": "commit filter",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "message": {
+          "type": "string",
+          "format": "regex",
+          "description": "Regex for matching commit message"
+        },
+        "author": {
+          "description": "Commit author's username, name, email or regexp matching one of these.",
+          "anyOf": [
+            {
+              "type": "string",
+              "format": "regex"
+            },
+            {
+              "type": "string"
+            }
+          ]
+        },
+        "files": {
+          "type": "array",
+          "description": "Only specific files (glob patterns)",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "command": {
+      "title": "command",
+      "oneOf": [
+        {
+          "type": "string",
+          "description": "Run a batch command"
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "ps": {
+              "type": "string",
+              "description": "Run a PowerShell command"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "pwsh": {
+              "type": "string",
+              "description": "Run a PowerShell Core command"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "description": "Run a batch command",
+          "additionalProperties": false,
+          "properties": {
+            "cmd": {
+              "type": "string"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "description": "Run a Bash command",
+          "additionalProperties": false,
+          "properties": {
+            "sh": {
+              "type": "string"
+            }
+          }
+        }
+      ]
+    },
+    "envVarHash": {
+      "title": "environment variable hash",
+      "type": "object",
+      "additionalProperties": {
+        "$ref": "#/definitions/possiblySecretString"
+      }
+    },
+    "platform": {
+      "enum": ["x86", "x64", "ARM", "ARM64", "Win32", "Any CPU"]
+    },
+    "configuration": {
+      "type": "string"
+    },
+    "imageName": {
+      "enum": [
+        "macOS",
+        "macOS-Mojave",
+        "macos-bigsur",
+        "macos-monterey",
+        "Previous macOS",
+        "Previous macOS-Mojave",
+        "Ubuntu",
+        "Ubuntu1604",
+        "Ubuntu1804",
+        "Ubuntu2004",
+        "Ubuntu2204",
+        "Previous Ubuntu",
+        "Previous Ubuntu1604",
+        "Previous Ubuntu1804",
+        "Previous Ubuntu2004",
+        "Visual Studio 2013",
+        "Visual Studio 2015",
+        "Visual Studio 2017",
+        "Visual Studio 2019",
+        "Visual Studio 2022",
+        "Visual Studio 2017 Preview",
+        "Visual Studio 2019 Preview",
+        "Previous Visual Studio 2013",
+        "Previous Visual Studio 2015",
+        "Previous Visual Studio 2017",
+        "Previous Visual Studio 2019",
+        "Previous Visual Studio 2022",
+        "zhaw18",
+        "WMF 5"
+      ]
+    },
+    "image": {
+      "description": "Build worker image (VM template) -DEV_VERSION",
+      "oneOf": [
+        {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/imageName"
+          }
+        },
+        {
+          "$ref": "#/definitions/imageName"
+        }
+      ]
+    },
+    "jobScalars": {
+      "title": "job scalars",
+      "type": "object",
+      "properties": {
+        "image": {
+          "$ref": "#/definitions/image"
+        },
+        "platform": {
+          "description": "Build platform, i.e. x86, x64, Any CPU. This setting is optional",
+          "oneOf": [
+            {
+              "$ref": "#/definitions/platform"
+            },
+            {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/platform"
+              }
+            }
+          ]
+        },
+        "configuration": {
+          "description": "Build Configuration, i.e. Debug, Release, etc.",
+          "oneOf": [
+            {
+              "$ref": "#/definitions/configuration"
+            },
+            {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/configuration"
+              }
+            }
+          ]
+        }
+      },
+      "allOf": [
+        {
+          "not": {
+            "required": ["skip_tags"]
+          }
+        },
+        {
+          "not": {
+            "required": ["skip_commits"]
+          }
+        },
+        {
+          "not": {
+            "required": ["skip_branch_with_pr"]
+          }
+        },
+        {
+          "not": {
+            "required": ["skip_non_tags"]
+          }
+        }
+      ]
+    },
+    "job": {
+      "title": "job",
+      "type": "object",
+      "properties": {
+        "version": {
+          "description": "Version format",
+          "type": "string"
+        },
+        "branches": {
+          "title": "branch options",
+          "type": "object",
+          "description": "Branches to build",
+          "additionalProperties": false,
+          "properties": {
+            "only": {
+              "description": "Whitelist",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "except": {
+              "type": "array",
+              "description": "Blacklist",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "skip_tags": {
+          "type": "boolean",
+          "description": "Do not build on tags (GitHub and BitBucket)"
+        },
+        "skip_non_tags": {
+          "type": "boolean",
+          "description": "Start builds on tags only (GitHub and BitBucket)"
+        },
+        "skip_commits": {
+          "$ref": "#/definitions/commitFilter",
+          "description": "Skipping commits with particular message or from specific user"
+        },
+        "only_commits": {
+          "$ref": "#/definitions/commitFilter",
+          "description": "Including commits with particular message or from specific user"
+        },
+        "skip_branch_with_pr": {
+          "type": "boolean",
+          "description": "Do not build feature branch with open Pull Requests"
+        },
+        "max_jobs": {
+          "description": "Maximum number of concurrent jobs for the project",
+          "type": "integer"
+        },
+        "notifications": {
+          "type": "array",
+          "items": {
+            "title": "notification",
+            "type": "object"
+          }
+        },
+        "image": {
+          "$ref": "#/definitions/image"
+        },
+        "init": {
+          "description": "Scripts that are called at very beginning, before repo cloning",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/command"
+          }
+        },
+        "clone_folder": {
+          "type": "string",
+          "description": "Clone directory"
+        },
+        "shallow_clone": {
+          "type": "boolean",
+          "description": "Fetch repository as zip archive",
+          "default": false
+        },
+        "clone_depth": {
+          "description": "Set git clone depth",
+          "type": "integer"
+        },
+        "hosts": {
+          "title": "host options",
+          "type": "object",
+          "description": "Setting up etc\\hosts file",
+          "additionalProperties": {
+            "type": "string",
+            "anyOf": [
+              {
+                "format": "ipv4"
+              },
+              {
+                "format": "ipv6"
+              }
+            ]
+          }
+        },
+        "environment": {
+          "description": "Environment variables",
+          "anyOf": [
+            {
+              "title": "environment options",
+              "type": "object",
+              "properties": {
+                "global": {
+                  "$ref": "#/definitions/envVarHash",
+                  "description": "variables defined here are no different than those defined at top level of 'environment' node"
+                },
+                "matrix": {
+                  "type": "array",
+                  "description": "an array of environment variables, each member of which is one dimension in the build matrix calculation",
+                  "items": {
+                    "$ref": "#/definitions/envVarHash"
+                  }
+                }
+              }
+            },
+            {
+              "$ref": "#/definitions/envVarHash"
+            }
+          ]
+        },
+        "matrix": {
+          "title": "matrix options",
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "fast_finish": {
+              "type": "boolean",
+              "description": "Set this flag to immediately finish build once one of the jobs fails"
+            },
+            "allow_failures": {
+              "type": "array",
+              "description": "This is how to allow failing jobs in the matrix",
+              "items": {
+                "$ref": "#/definitions/jobScalars"
+              }
+            },
+            "exclude": {
+              "type": "array",
+              "description": "Exclude configuration from the matrix. Works similarly to 'allow_failures' but build not even being started for excluded combination.",
+              "items": {
+                "$ref": "#/definitions/job"
+              }
+            }
+          }
+        },
+        "cache": {
+          "type": "array",
+          "description": "Build cache to preserve files/folders between builds",
+          "items": {
+            "type": "string"
+          }
+        },
+        "services": {
+          "type": "array",
+          "description": "Enable service required for build/tests",
+          "items": {
+            "enum": [
+              "docker",
+              "iis",
+              "mongodb",
+              "msmq",
+              "mssql",
+              "mssql2008r2sp2",
+              "mssql2008r2sp2rs",
+              "mssql2012sp1",
+              "mssql2012sp1rs",
+              "mssql2014",
+              "mssql2014rs",
+              "mssql2016",
+              "mssql2017",
+              "mysql",
+              "postgresql",
+              "postgresql93",
+              "postgresql94",
+              "postgresql95",
+              "postgresql96",
+              "postgresql10",
+              "postgresql11",
+              "postgresql12",
+              "postgresql13"
+            ]
+          }
+        },
+        "install": {
+          "description": "Scripts that run after cloning repository",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/command"
+          }
+        },
+        "assembly_info": {
+          "title": "assembly options",
+          "type": "object",
+          "description": "Enable patching of AssemblyInfo.* files",
+          "additionalProperties": false,
+          "properties": {
+            "patch": {
+              "type": "boolean"
+            },
+            "file": {
+              "type": "string"
+            },
+            "assembly_version": {
+              "type": "string"
+            },
+            "assembly_file_version": {
+              "type": "string"
+            },
+            "assembly_informational_version": {
+              "type": "string"
+            }
+          }
+        },
+        "nuget": {
+          "title": "NuGet options",
+          "type": "object",
+          "description": "Automatically register private account and/or project AppVeyor NuGet feeds",
+          "properties": {
+            "account_feed": {
+              "type": "boolean"
+            },
+            "project_feed": {
+              "type": "boolean"
+            },
+            "disable_publish_on_pr": {
+              "type": "boolean",
+              "description": "Disable publishing of .nupkg artifacts to account/project feeds for pull request builds"
+            }
+          }
+        },
+        "platform": {
+          "description": "Build platform, i.e. x86, x64, Any CPU. This setting is optional",
+          "oneOf": [
+            {
+              "$ref": "#/definitions/platform"
+            },
+            {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/platform"
+              }
+            }
+          ]
+        },
+        "configuration": {
+          "description": "Build Configuration, i.e. Debug, Release, etc.",
+          "oneOf": [
+            {
+              "$ref": "#/definitions/configuration"
+            },
+            {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/configuration"
+              }
+            }
+          ]
+        },
+        "build": {
+          "oneOf": [
+            {
+              "type": "boolean",
+              "enum": [false]
+            },
+            {
+              "title": "build options",
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "parallel": {
+                  "type": "boolean",
+                  "description": "Enable MSBuild parallel builds"
+                },
+                "project": {
+                  "type": "string",
+                  "description": "Path to Visual Studio solution or project"
+                },
+                "publish_wap": {
+                  "type": "boolean",
+                  "description": "Package Web Application Projects (WAP) for Web Deploy"
+                },
+                "publish_wap_xcopy": {
+                  "type": "boolean",
+                  "description": "Package Web Application Projects (WAP) for XCopy deployment"
+                },
+                "publish_wap_beanstalk": {
+                  "type": "boolean",
+                  "description": "Package Web Applications for AWS Elastic Beanstalk deployment"
+                },
+                "publish_wap_octopus": {
+                  "type": "boolean",
+                  "description": "Package Web Applications for Octopus deployment"
+                },
+                "publish_azure_webjob": {
+                  "type": "boolean",
+                  "description": "Package Azure WebJobs for Zip Push deployment"
+                },
+                "publish_azure": {
+                  "type": "boolean",
+                  "description": "Package Azure Cloud Service projects and push to artifacts"
+                },
+                "publish_aspnet_core": {
+                  "type": "boolean",
+                  "description": "Package ASP.NET Core projects"
+                },
+                "publish_core_console": {
+                  "type": "boolean",
+                  "description": "Package .NET Core console projects"
+                },
+                "publish_nuget": {
+                  "type": "boolean",
+                  "description": "Package projects with .nuspec files and push to artifacts"
+                },
+                "publish_nuget_symbols": {
+                  "type": "boolean",
+                  "description": "Generate and publish NuGet symbol packages"
+                },
+                "include_nuget_references": {
+                  "type": "boolean",
+                  "description": "Add -IncludeReferencedProjects option while packaging NuGet artifacts"
+                },
+                "verbosity": {
+                  "enum": ["quiet", "minimal", "normal", "detailed"],
+                  "description": "MSBuild verbosity level"
+                }
+              }
+            }
+          ]
+        },
+        "before_build": {
+          "description": "Scripts to run before build",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/command"
+          }
+        },
+        "before_package": {
+          "description": "Scripts to run *after* solution is built and *before* automatic packaging occurs (web apps, NuGet packages, Azure Cloud Services)",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/command"
+          }
+        },
+        "after_build": {
+          "description": "Scripts to run after build",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/command"
+          }
+        },
+        "build_script": {
+          "description": "To run your custom scripts instead of automatic MSBuild",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/command"
+          }
+        },
+        "before_test": {
+          "description": "Scripts to run before tests",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/command"
+          }
+        },
+        "test": {
+          "oneOf": [
+            {
+              "type": "boolean",
+              "enum": [false],
+              "description": "To disable automatic tests"
+            },
+            {
+              "title": "test options",
+              "description": "To run tests again only selected assemblies and/or categories",
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "assemblies": {
+                  "title": "assembly options",
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "only": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "except": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    }
+                  }
+                },
+                "categories": {
+                  "oneOf": [
+                    {
+                      "title": "category options",
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "only": {
+                          "type": "array",
+                          "items": {
+                            "type": "string"
+                          }
+                        },
+                        "except": {
+                          "type": "array",
+                          "items": {
+                            "type": "string"
+                          }
+                        }
+                      }
+                    },
+                    {
+                      "description": "To run tests from different categories as separate jobs in parallel",
+                      "type": "array",
+                      "items": {
+                        "oneOf": [
+                          {
+                            "type": "string",
+                            "description": "A category common for all jobs"
+                          },
+                          {
+                            "type": "array",
+                            "items": {
+                              "type": "string"
+                            }
+                          }
+                        ]
+                      }
+                    }
+                  ]
+                }
+              }
+            }
+          ]
+        },
+        "test_script": {
+          "description": "To run your custom scripts instead of automatic tests",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/command"
+          }
+        },
+        "after_test": {
+          "type": "array",
+          "description": "Scripts to run after tests",
+          "items": {
+            "$ref": "#/definitions/command"
+          }
+        },
+        "artifacts": {
+          "type": "array",
+          "items": {
+            "title": "artifact options",
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "path": {
+                "type": "string"
+              },
+              "name": {
+                "type": "string"
+              },
+              "type": {
+                "enum": [
+                  "Auto",
+                  "WebDeployPackage",
+                  "NuGetPackage",
+                  "AzureCloudService",
+                  "AzureCloudServiceConfig",
+                  "SsdtPackage",
+                  "Zip",
+                  "File"
+                ]
+              }
+            },
+            "required": ["path"]
+          }
+        },
+        "before_deploy": {
+          "type": "array",
+          "description": "Scripts to run before deployment",
+          "items": {
+            "$ref": "#/definitions/command"
+          }
+        },
+        "deploy": {
+          "oneOf": [
+            {
+              "enum": ["off"]
+            },
+            {
+              "type": "array",
+              "items": {
+                "title": "deployment options",
+                "type": "object"
+              }
+            }
+          ]
+        },
+        "deploy_script": {
+          "description": "To run your custom scripts instead of provider deployments",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/command"
+          }
+        },
+        "after_deploy": {
+          "type": "array",
+          "description": "Scripts to run after deployment",
+          "items": {
+            "$ref": "#/definitions/command"
+          }
+        },
+        "on_success": {
+          "type": "array",
+          "description": "On successful build",
+          "items": {
+            "$ref": "#/definitions/command"
+          }
+        },
+        "on_failure": {
+          "type": "array",
+          "description": "On build failure",
+          "items": {
+            "$ref": "#/definitions/command"
+          }
+        },
+        "on_finish": {
+          "type": "array",
+          "description": "After build failure or success",
+          "items": {
+            "$ref": "#/definitions/command"
+          }
+        }
+      }
+    }
+  },
+  "id": "https://json.schemastore.org/appveyor.json",
+  "title": "JSON schema for AppVeyor CI configuration files"
+}
diff --git a/ci/schemas/circleciconfig.json b/ci/schemas/circleciconfig.json
new file mode 100644
index 000000000000..076944098440
--- /dev/null
+++ b/ci/schemas/circleciconfig.json
@@ -0,0 +1,1411 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://json.schemastore.org/circleciconfig.json",
+  "definitions": {
+    "logical": {
+      "description": "https://circleci.com/docs/configuration-reference#logic-statements \n\nA logical statement to be used in dynamic configuration",
+      "oneOf": [
+        {
+          "type": ["string", "boolean", "integer", "number"]
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "minProperties": 1,
+          "maxProperties": 1,
+          "properties": {
+            "and": {
+              "description": "https://circleci.com/docs/configuration-reference#logic-statements \n\nLogical and: true when all statements in the list are true",
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/logical"
+              }
+            },
+            "or": {
+              "description": "https://circleci.com/docs/configuration-reference#logic-statements \n\nLogical or: true when at least one statements in the list is true",
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/logical"
+              }
+            },
+            "not": {
+              "$ref": "#/definitions/logical",
+              "description": "https://circleci.com/docs/configuration-reference#logic-statements \n\nLogical not: true when statement is false"
+            },
+            "equal": {
+              "description": "https://circleci.com/docs/configuration-reference#logic-statements \n\nTrue when all elements in the list are equal",
+              "type": "array"
+            },
+            "matches": {
+              "description": "https://circleci.com/docs/configuration-reference#logic-statements \n\nTrue when value matches the pattern",
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "pattern": {
+                  "type": "string"
+                },
+                "value": {
+                  "type": "string"
+                }
+              }
+            }
+          }
+        }
+      ]
+    },
+    "filter": {
+      "description": "A map defining rules for execution on specific branches",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "only": {
+          "description": "Either a single branch specifier, or a list of branch specifiers",
+          "oneOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ]
+        },
+        "ignore": {
+          "description": "Either a single branch specifier, or a list of branch specifiers",
+          "oneOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ]
+        }
+      }
+    },
+    "orbs": {
+      "description": "https://circleci.com/docs/configuration-reference#orbs-requires-version-21\n\nOrbs are reusable packages of CircleCI configuration that you may share across projects, enabling you to create encapsulated, parameterized commands, jobs, and executors that can be used across multiple projects.",
+      "type": "object",
+      "additionalProperties": {
+        "oneOf": [
+          {
+            "description": "https://circleci.com/docs/creating-orbs#semantic-versioning-in-orbs\n\nAn orb to depend on and its semver range, or volatile for the most recent release.",
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9_-]+/[a-z][a-z0-9_-]+@(dev:[\\.a-z0-9_-]+|\\d+|\\d+\\.\\d+|\\d+\\.\\d+\\.\\d+|volatile)$"
+          },
+          {
+            "description": "https://circleci.com/docs/creating-orbs#creating-inline-orbs\n\nInline orbs can be handy during development of an orb or as a convenience for name-spacing jobs and commands in lengthy configurations, particularly if you later intend to share the orb with others.",
+            "type": "object",
+            "properties": {
+              "orbs": {
+                "$ref": "#/definitions/orbs"
+              },
+              "commands": {
+                "$ref": "#/definitions/commands"
+              },
+              "executors": {
+                "$ref": "#/definitions/executors"
+              },
+              "jobs": {
+                "$ref": "#/definitions/jobs"
+              }
+            }
+          }
+        ]
+      }
+    },
+    "commands": {
+      "description": "https://circleci.com/docs/configuration-reference#commands-requires-version-21\n\nA command definition defines a sequence of steps as a map to be executed in a job, enabling you to reuse a single command definition across multiple jobs.",
+      "type": "object",
+      "additionalProperties": {
+        "description": "https://circleci.com/docs/configuration-reference#commands-requires-version-21\n\nDefinition of a custom command.",
+        "type": "object",
+        "required": ["steps"],
+        "properties": {
+          "steps": {
+            "description": "A sequence of steps run inside the calling job of the command.",
+            "type": "array",
+            "items": {
+              "$ref": "#/definitions/step"
+            }
+          },
+          "parameters": {
+            "description": "https://circleci.com/docs/reusing-config#using-the-parameters-declaration\n\nA map of parameter keys.",
+            "type": "object",
+            "patternProperties": {
+              "^[a-z][a-z0-9_-]+$": {
+                "oneOf": [
+                  {
+                    "description": "https://circleci.com/docs/reusing-config#string\n\nA string parameter.",
+                    "type": "object",
+                    "required": ["type"],
+                    "properties": {
+                      "type": {
+                        "enum": ["string"]
+                      },
+                      "description": {
+                        "type": "string"
+                      },
+                      "default": {
+                        "type": "string"
+                      }
+                    }
+                  },
+                  {
+                    "description": "https://circleci.com/docs/reusing-config#boolean\n\nA boolean parameter.",
+                    "type": "object",
+                    "required": ["type"],
+                    "properties": {
+                      "type": {
+                        "enum": ["boolean"]
+                      },
+                      "description": {
+                        "type": "string"
+                      },
+                      "default": {
+                        "type": "boolean"
+                      }
+                    }
+                  },
+                  {
+                    "description": "https://circleci.com/docs/reusing-config#integer\n\nAn integer parameter.",
+                    "type": "object",
+                    "required": ["type"],
+                    "properties": {
+                      "type": {
+                        "enum": ["integer"]
+                      },
+                      "description": {
+                        "type": "string"
+                      },
+                      "default": {
+                        "type": "integer"
+                      }
+                    }
+                  },
+                  {
+                    "description": "https://circleci.com/docs/reusing-config#enum\n\nThe `enum` parameter may be a list of any values. Use the `enum` parameter type when you want to enforce that the value must be one from a specific set of string values.",
+                    "type": "object",
+                    "required": ["type", "enum"],
+                    "properties": {
+                      "type": {
+                        "enum": ["enum"]
+                      },
+                      "enum": {
+                        "type": "array",
+                        "minItems": 1,
+                        "items": {
+                          "type": "string"
+                        }
+                      },
+                      "description": {
+                        "type": "string"
+                      },
+                      "default": {
+                        "type": "string"
+                      }
+                    }
+                  },
+                  {
+                    "description": "https://circleci.com/docs/reusing-config#executor\n\nUse an `executor` parameter type to allow the invoker of a job to decide what executor it will run on.",
+                    "type": "object",
+                    "required": ["type"],
+                    "properties": {
+                      "type": {
+                        "enum": ["executor"]
+                      },
+                      "description": {
+                        "type": "string"
+                      },
+                      "default": {
+                        "type": "string"
+                      }
+                    }
+                  },
+                  {
+                    "description": "https://circleci.com/docs/reusing-config#steps\n\nSteps are used when you have a job or command that needs to mix predefined and user-defined steps. When passed in to a command or job invocation, the steps passed as parameters are always defined as a sequence, even if only one step is provided.",
+                    "type": "object",
+                    "required": ["type"],
+                    "properties": {
+                      "type": {
+                        "enum": ["steps"]
+                      },
+                      "description": {
+                        "type": "string"
+                      },
+                      "default": {
+                        "type": "array",
+                        "items": {
+                          "$ref": "#/definitions/step"
+                        }
+                      }
+                    }
+                  },
+                  {
+                    "description": "https://circleci.com/docs/reusing-config#environment-variable-name\n\nThe environment variable name parameter is a string that must match a POSIX_NAME regexp (e.g. no spaces or special characters) and is a more meaningful parameter type that enables additional checks to be performed. ",
+                    "type": "object",
+                    "required": ["type"],
+                    "properties": {
+                      "type": {
+                        "enum": ["env_var_name"]
+                      },
+                      "description": {
+                        "type": "string"
+                      },
+                      "default": {
+                        "type": "string",
+                        "pattern": "^[a-zA-Z][a-zA-Z0-9_-]+$"
+                      }
+                    }
+                  }
+                ]
+              }
+            }
+          },
+          "description": {
+            "description": "A string that describes the purpose of the command.",
+            "type": "string"
+          }
+        }
+      }
+    },
+    "dockerLayerCaching": {
+      "description": "Set to `true` to enable [Docker Layer Caching](https://circleci.com/docs/docker-layer-caching). Note: If you haven't already, you must open a support ticket to have a CircleCI Sales representative contact you about enabling this feature on your account for an additional fee.",
+      "type": "boolean",
+      "default": "true"
+    },
+    "dockerExecutor": {
+      "description": "Options for the [docker executor](https://circleci.com/docs/configuration-reference#docker)",
+      "required": ["docker"],
+      "properties": {
+        "docker": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["image"],
+            "properties": {
+              "image": {
+                "description": "The name of a custom docker image to use",
+                "type": "string"
+              },
+              "name": {
+                "description": "The name the container is reachable by. By default, container services are accessible through `localhost`",
+                "type": "string"
+              },
+              "entrypoint": {
+                "description": "The command used as executable when launching the container",
+                "oneOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  }
+                ]
+              },
+              "command": {
+                "description": "The command used as pid 1 (or args for entrypoint) when launching the container",
+                "oneOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  }
+                ]
+              },
+              "user": {
+                "description": "Which user to run the command as",
+                "type": "string"
+              },
+              "environment": {
+                "description": "A map of environment variable names and values",
+                "type": "object",
+                "additionalProperties": {
+                  "type": ["string", "number", "boolean"]
+                }
+              },
+              "auth": {
+                "description": "Authentication for registries using standard `docker login` credentials",
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                  "username": {
+                    "type": "string"
+                  },
+                  "password": {
+                    "type": "string"
+                  }
+                }
+              },
+              "aws_auth": {
+                "description": "Authentication for AWS EC2 Container Registry (ECR). You can use the access/secret keys or OIDC.",
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                  "aws_access_key_id": {
+                    "type": "string"
+                  },
+                  "aws_secret_access_key": {
+                    "type": "string"
+                  },
+                  "oidc_role_arn": {
+                    "type": "string"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "resource_class": {
+          "description": "Amount of CPU and RAM allocated for each job. Note: A performance plan is required to access this feature.",
+          "type": "string",
+          "enum": [
+            "small",
+            "medium",
+            "medium+",
+            "large",
+            "xlarge",
+            "2xlarge",
+            "2xlarge+",
+            "arm.medium",
+            "arm.large",
+            "arm.xlarge",
+            "arm.2xlarge"
+          ]
+        }
+      }
+    },
+    "machineExecutor": {
+      "description": "Options for the [machine executor](https://circleci.com/docs/configuration-reference#machine)",
+      "type": "object",
+      "required": ["machine"],
+      "oneOf": [
+        {
+          "properties": {
+            "machine": {
+              "oneOf": [
+                { "const": "default" },
+                { "const": true },
+                {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": ["image"],
+                  "properties": {
+                    "image": {
+                      "description": "The VM image to use. View [available images](https://circleci.com/docs/configuration-reference/#available-linux-machine-images-cloud). **Note:** This key is **not** supported on the installable CircleCI. For information about customizing machine executor images on CircleCI installed on your servers, see our [VM Service documentation](https://circleci.com/docs/vm-service).",
+                      "type": "string",
+                      "enum": [
+                        "ubuntu-2004:2023.10.1",
+                        "ubuntu-2004:2023.07.1",
+                        "ubuntu-2004:2023.04.2",
+                        "ubuntu-2004:2023.04.1",
+                        "ubuntu-2004:2023.02.1",
+                        "ubuntu-2004:2022.10.1",
+                        "ubuntu-2004:2022.07.1",
+                        "ubuntu-2004:2022.04.2",
+                        "ubuntu-2004:2022.04.1",
+                        "ubuntu-2004:202201-02",
+                        "ubuntu-2004:202201-01",
+                        "ubuntu-2004:202111-02",
+                        "ubuntu-2004:202111-01",
+                        "ubuntu-2004:202107-02",
+                        "ubuntu-2004:202104-01",
+                        "ubuntu-2004:202101-01",
+                        "ubuntu-2004:202010-01",
+                        "ubuntu-2004:current",
+                        "ubuntu-2004:edge",
+                        "ubuntu-2204:2023.10.1",
+                        "ubuntu-2204:2023.07.2",
+                        "ubuntu-2204:2023.04.2",
+                        "ubuntu-2204:2023.04.1",
+                        "ubuntu-2204:2023.02.1",
+                        "ubuntu-2204:2022.10.2",
+                        "ubuntu-2204:2022.10.1",
+                        "ubuntu-2204:2022.07.2",
+                        "ubuntu-2204:2022.07.1",
+                        "ubuntu-2204:2022.04.2",
+                        "ubuntu-2204:2022.04.1",
+                        "ubuntu-2204:current",
+                        "ubuntu-2204:edge",
+                        "android:2023.11.1",
+                        "android:2023.10.1",
+                        "android:2023.09.1",
+                        "android:2023.08.1",
+                        "android:2023.07.1",
+                        "android:2023.06.1",
+                        "android:2023.05.1",
+                        "android:2023.04.1",
+                        "android:2023.03.1",
+                        "android:2023.02.1",
+                        "android:2022.12.1",
+                        "android:2022.09.1",
+                        "android:2022.08.1",
+                        "android:2022.07.1",
+                        "android:2022.06.2",
+                        "android:2022.06.1",
+                        "android:2022.04.1",
+                        "android:2022.03.1",
+                        "android:2022.01.1",
+                        "android:2021.12.1",
+                        "android:2021.10.1",
+                        "android:202102-01"
+                      ]
+                    },
+                    "docker_layer_caching": {
+                      "$ref": "#/definitions/dockerLayerCaching"
+                    }
+                  }
+                }
+              ]
+            },
+            "resource_class": {
+              "description": "Amount of CPU and RAM allocated for each job. View [available resource classes](https://circleci.com/docs/configuration-reference/#linuxvm-execution-environment)",
+              "type": "string",
+              "enum": [
+                "medium",
+                "large",
+                "xlarge",
+                "2xlarge",
+                "2xlarge+",
+                "arm.medium",
+                "arm.large",
+                "arm.xlarge",
+                "arm.2xlarge"
+              ]
+            }
+          }
+        },
+        {
+          "properties": {
+            "machine": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["image"],
+              "properties": {
+                "image": {
+                  "description": "The VM image to use. View [available images](https://circleci.com/docs/configuration-reference/#available-linux-gpu-images). **Note:** This key is **not** supported on the installable CircleCI. For information about customizing machine executor images on CircleCI installed on your servers, see our [VM Service documentation](https://circleci.com/docs/vm-service).",
+                  "type": "string",
+                  "enum": ["linux-cuda-11:default", "linux-cuda-12:default"]
+                },
+                "docker_layer_caching": {
+                  "$ref": "#/definitions/dockerLayerCaching"
+                }
+              }
+            },
+            "resource_class": {
+              "description": "Amount of CPU and RAM allocated for each job. View [available resource classes](https://circleci.com/docs/configuration-reference/#gpu-execution-environment-linux)",
+              "type": "string",
+              "enum": ["gpu.nvidia.medium", "gpu.nvidia.large"]
+            }
+          }
+        },
+        {
+          "properties": {
+            "machine": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["image"],
+              "properties": {
+                "image": {
+                  "description": "The VM image to use. View [available images](https://circleci.com/docs/configuration-reference/#available-windows-machine-images-cloud). **Note:** This key is **not** supported on the installable CircleCI. For information about customizing machine executor images on CircleCI installed on your servers, see our [VM Service documentation](https://circleci.com/docs/vm-service).",
+                  "type": "string",
+                  "enum": [
+                    "windows-server-2022-gui:2023.10.1",
+                    "windows-server-2022-gui:2023.09.1",
+                    "windows-server-2022-gui:2023.08.1",
+                    "windows-server-2022-gui:2023.07.1",
+                    "windows-server-2022-gui:2023.06.1",
+                    "windows-server-2022-gui:2023.05.1",
+                    "windows-server-2022-gui:2023.04.1",
+                    "windows-server-2022-gui:2023.03.1",
+                    "windows-server-2022-gui:2022.08.1",
+                    "windows-server-2022-gui:2022.07.1",
+                    "windows-server-2022-gui:2022.06.1",
+                    "windows-server-2022-gui:2022.04.1",
+                    "windows-server-2022-gui:current",
+                    "windows-server-2022-gui:edge",
+                    "windows-server-2019:2023.10.1",
+                    "windows-server-2019:2023.08.1",
+                    "windows-server-2019:2023.04.1",
+                    "windows-server-2019:2022.08.1",
+                    "windows-server-2019:current",
+                    "windows-server-2019:edge"
+                  ]
+                },
+                "docker_layer_caching": {
+                  "$ref": "#/definitions/dockerLayerCaching"
+                }
+              }
+            },
+            "resource_class": {
+              "description": "Amount of CPU and RAM allocated for each job. View [available resource classes](https://circleci.com/docs/configuration-reference/#windows-execution-environment)",
+              "type": "string",
+              "enum": [
+                "windows.medium",
+                "windows.large",
+                "windows.xlarge",
+                "windows.2xlarge"
+              ]
+            }
+          }
+        },
+        {
+          "properties": {
+            "machine": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["image"],
+              "properties": {
+                "image": {
+                  "description": "The VM image to use. View [available images](https://circleci.com/docs/configuration-reference/#available-windows-gpu-image). **Note:** This key is **not** supported on the installable CircleCI. For information about customizing machine executor images on CircleCI installed on your servers, see our [VM Service documentation](https://circleci.com/docs/vm-service).",
+                  "type": "string",
+                  "enum": [
+                    "windows-server-2019-cuda:current",
+                    "windows-server-2019-cuda:edge"
+                  ]
+                },
+                "docker_layer_caching": {
+                  "$ref": "#/definitions/dockerLayerCaching"
+                }
+              }
+            },
+            "resource_class": {
+              "description": "Amount of CPU and RAM allocated for each job. View [available resource classes](https://circleci.com/docs/configuration-reference/#gpu-execution-environment-windows)",
+              "type": "string",
+              "enum": ["windows.gpu.nvidia.medium"]
+            }
+          }
+        }
+      ]
+    },
+    "macosExecutor": {
+      "description": "Options for the [macOS executor](https://circleci.com/docs/configuration-reference#macos)",
+      "type": "object",
+      "required": ["macos"],
+      "properties": {
+        "macos": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["xcode"],
+          "properties": {
+            "xcode": {
+              "description": "The version of Xcode that is installed on the virtual machine, see the [Supported Xcode Versions section of the Testing iOS](https://circleci.com/docs/testing-ios#supported-xcode-versions) document for the complete list.",
+              "type": "string",
+              "enum": [
+                "15.2.0",
+                "15.1.0",
+                "15.0.0",
+                "14.3.1",
+                "14.2.0",
+                "14.1.0",
+                "14.0.1",
+                "13.4.1",
+                "12.5.1"
+              ]
+            }
+          }
+        },
+        "resource_class": {
+          "description": "Amount of CPU and RAM allocated for each job. View [available resource classes](https://circleci.com/docs/configuration-reference/#macos-execution-environment)",
+          "type": "string",
+          "enum": [
+            "macos.x86.medium.gen2",
+            "macos.m1.medium.gen1",
+            "macos.m1.large.gen1"
+          ]
+        }
+      }
+    },
+    "executorChoice": {
+      "type": "object",
+      "oneOf": [
+        {
+          "$ref": "#/definitions/dockerExecutor"
+        },
+        {
+          "$ref": "#/definitions/machineExecutor"
+        },
+        {
+          "$ref": "#/definitions/macosExecutor"
+        }
+      ]
+    },
+    "executors": {
+      "description": "Executors define the environment in which the steps of a job will be run, allowing you to reuse a single executor definition across multiple jobs.",
+      "type": "object",
+      "additionalProperties": {
+        "$ref": "#/definitions/executorChoice",
+        "type": "object",
+        "properties": {
+          "shell": {
+            "description": "Shell to use for execution command in all steps. Can be overridden by shell in each step (default: See [Default Shell Options](https://circleci.com/docs/configuration-reference#default-shell-options)",
+            "type": "string"
+          },
+          "working_directory": {
+            "description": "In which directory to run the steps.",
+            "type": "string"
+          },
+          "environment": {
+            "description": "A map of environment variable names and values.",
+            "type": "object",
+            "additionalProperties": {
+              "type": ["string", "number"]
+            }
+          }
+        }
+      }
+    },
+    "builtinSteps": {
+      "documentation": {
+        "run": {
+          "description": "https://circleci.com/docs/configuration-reference#run\n\nUsed for invoking all command-line programs, taking either a map of configuration values, or, when called in its short-form, a string that will be used as both the `command` and `name`. Run commands are executed using non-login shells by default, so you must explicitly source any dotfiles as part of the command."
+        },
+        "checkout": {
+          "description": "https://circleci.com/docs/configuration-reference#checkout\n\nSpecial step used to check out source code to the configured `path` (defaults to the `working_directory`). The reason this is a special step is because it is more of a helper function designed to make checking out code easy for you. If you require doing git over HTTPS you should not use this step as it configures git to checkout over ssh."
+        },
+        "setup_remote_docker": {
+          "description": "https://circleci.com/docs/configuration-reference#setup_remote_docker\n\nCreates a remote Docker environment configured to execute Docker commands."
+        },
+        "save_cache": {
+          "description": "https://circleci.com/docs/configuration-reference#save_cache\n\nGenerates and stores a cache of a file or directory of files such as dependencies or source code in our object storage. Later jobs can restore this cache using the `restore_cache` step."
+        },
+        "restore_cache": {
+          "description": "https://circleci.com/docs/configuration-reference#restore_cache\n\nRestores a previously saved cache based on a `key`. Cache needs to have been saved first for this key using the `save_cache` step."
+        },
+        "deploy": {
+          "description": "https://circleci.com/docs/configuration-reference#deploy\n\nSpecial step for deploying artifacts. `deploy` uses the same configuration map and semantics as run step. Jobs may have more than one deploy step. In general deploy step behaves just like run with two exceptions:\n* In a job with parallelism, the deploy step will only be executed by node #0 and only if all nodes succeed. Nodes other than #0 will skip this step.\n* In a job that runs with SSH, the deploy step will not execute"
+        },
+        "store_artifacts": {
+          "description": "https://circleci.com/docs/configuration-reference#store_artifacts\n\nStep to store artifacts (for example logs, binaries, etc) to be available in the web app or through the API."
+        },
+        "store_test_results": {
+          "description": "https://circleci.com/docs/configuration-reference#storetestresults\n\nSpecial step used to upload test results so they display in builds' Test Summary section and can be used for timing analysis. To also see test result as build artifacts, please use the `store_artifacts` step."
+        },
+        "persist_to_workspace": {
+          "description": "https://circleci.com/docs/configuration-reference#persist_to_workspace\n\nSpecial step used to persist a temporary file to be used by another job in the workflow"
+        },
+        "attach_workspace": {
+          "description": "https://circleci.com/docs/configuration-reference#attach_workspace\n\nSpecial step used to attach the workflow's workspace to the current container. The full contents of the workspace are downloaded and copied into the directory the workspace is being attached at."
+        },
+        "add_ssh_keys": {
+          "description": "https://circleci.com/docs/configuration-reference#add_ssh_keys\n\nSpecial step that adds SSH keys from a project's settings to a container. Also configures SSH to use these keys."
+        },
+        "when": {
+          "description": "https://circleci.com/docs/configuration-reference#the-when-step-requires-version-21 \n\nConditional step to run on custom conditions (determined at config-compile time) that are checked before a workflow runs"
+        },
+        "unless": {
+          "description": "https://circleci.com/docs/configuration-reference#the-when-step-requires-version-21 \n\nConditional step to run when custom conditions aren't met (determined at config-compile time) that are checked before a workflow runs"
+        }
+      },
+      "configuration": {
+        "run": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/builtinSteps/documentation/run"
+            }
+          ],
+          "oneOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["command"],
+              "properties": {
+                "command": {
+                  "description": "Command to run via the shell",
+                  "type": "string"
+                },
+                "name": {
+                  "description": "Title of the step to be shown in the CircleCI UI (default: full `command`)",
+                  "type": "string"
+                },
+                "shell": {
+                  "description": "Shell to use for execution command",
+                  "type": "string"
+                },
+                "environment": {
+                  "description": "Additional environmental variables, locally scoped to command",
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": ["string", "number"]
+                  }
+                },
+                "background": {
+                  "description": "Whether or not this step should run in the background (default: false)",
+                  "default": false,
+                  "type": "boolean"
+                },
+                "working_directory": {
+                  "description": "In which directory to run this step (default: `working_directory` of the job",
+                  "type": "string"
+                },
+                "no_output_timeout": {
+                  "description": "Elapsed time the command can run without output. The string is a decimal with unit suffix, such as \"20m\", \"1.25h\", \"5s\" (default: 10 minutes)",
+                  "type": "string",
+                  "pattern": "\\d+(\\.\\d+)?[mhs]",
+                  "default": "10m"
+                },
+                "when": {
+                  "description": "Specify when to enable or disable the step. Takes the following values: `always`, `on_success`, `on_fail` (default: `on_success`)",
+                  "enum": ["always", "on_success", "on_fail"]
+                }
+              }
+            }
+          ]
+        },
+        "checkout": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/builtinSteps/documentation/checkout"
+            }
+          ],
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "name": {
+              "description": "Title of the step to be shown in the CircleCI UI",
+              "type": "string"
+            },
+            "path": {
+              "description": "Checkout directory (default: job's `working_directory`)",
+              "type": "string"
+            }
+          }
+        },
+        "setup_remote_docker": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/builtinSteps/documentation/setup_remote_docker"
+            }
+          ],
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "name": {
+              "description": "Title of the step to be shown in the CircleCI UI",
+              "type": "string"
+            },
+            "docker_layer_caching": {
+              "description": "When `docker_layer_caching` is set to `true`, CircleCI will try to reuse Docker Images (layers) built during a previous job or workflow (Paid feature)",
+              "type": "boolean",
+              "default": false
+            },
+            "version": {
+              "description": "If your build requires a specific docker image, you can set it as an image attribute",
+              "anyOf": [
+                {
+                  "type": "string",
+                  "enum": [
+                    "20.10.24",
+                    "20.10.23",
+                    "20.10.18",
+                    "20.10.17",
+                    "20.10.14",
+                    "20.10.12",
+                    "20.10.11",
+                    "20.10.7",
+                    "20.10.6",
+                    "20.10.2",
+                    "19.03.13"
+                  ]
+                },
+                {
+                  "type": "string"
+                }
+              ]
+            }
+          }
+        },
+        "save_cache": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/builtinSteps/documentation/save_cache"
+            }
+          ],
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["paths", "key"],
+          "properties": {
+            "paths": {
+              "description": "List of directories which should be added to the cache",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "key": {
+              "description": "Unique identifier for this cache",
+              "type": "string"
+            },
+            "name": {
+              "type": "string",
+              "description": "Title of the step to be shown in the CircleCI UI (default: 'Saving Cache')"
+            },
+            "when": {
+              "description": "Specify when to enable or disable the step. Takes the following values: `always`, `on_success`, `on_fail` (default: `on_success`)",
+              "enum": ["always", "on_success", "on_fail"]
+            }
+          }
+        },
+        "restore_cache": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/builtinSteps/documentation/restore_cache"
+            }
+          ],
+          "oneOf": [
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["key"],
+              "properties": {
+                "key": {
+                  "type": "string",
+                  "description": "Single cache key to restore"
+                },
+                "name": {
+                  "type": "string",
+                  "description": "Title of the step to be shown in the CircleCI UI (default: 'Restoring Cache')"
+                }
+              }
+            },
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["keys"],
+              "properties": {
+                "name": {
+                  "type": "string",
+                  "description": "Title of the step to be shown in the CircleCI UI (default: 'Restoring Cache')"
+                },
+                "keys": {
+                  "description": "List of cache keys to lookup for a cache to restore. Only first existing key will be restored.",
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              }
+            }
+          ]
+        },
+        "deploy": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/builtinSteps/documentation/deploy"
+            },
+            {
+              "$ref": "#/definitions/builtinSteps/configuration/run"
+            }
+          ]
+        },
+        "store_artifacts": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/builtinSteps/documentation/store_artifacts"
+            }
+          ],
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["path"],
+          "properties": {
+            "name": {
+              "description": "Title of the step to be shown in the CircleCI UI",
+              "type": "string"
+            },
+            "path": {
+              "description": "Directory in the primary container to save as job artifacts",
+              "type": "string"
+            },
+            "destination": {
+              "description": "Prefix added to the artifact paths in the artifacts API (default: the directory of the file specified in `path`)",
+              "type": "string"
+            }
+          }
+        },
+        "store_test_results": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/builtinSteps/documentation/store_test_results"
+            }
+          ],
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["path"],
+          "properties": {
+            "name": {
+              "description": "Title of the step to be shown in the CircleCI UI",
+              "type": "string"
+            },
+            "path": {
+              "description": "Path (absolute, or relative to your `working_directory`) to directory containing subdirectories of JUnit XML or Cucumber JSON test metadata files",
+              "type": "string"
+            }
+          }
+        },
+        "persist_to_workspace": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/builtinSteps/documentation/persist_to_workspace"
+            }
+          ],
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["root", "paths"],
+          "properties": {
+            "name": {
+              "description": "Title of the step to be shown in the CircleCI UI",
+              "type": "string"
+            },
+            "root": {
+              "description": "Either an absolute path or a path relative to `working_directory`",
+              "type": "string"
+            },
+            "paths": {
+              "description": "Glob identifying file(s), or a non-glob path to a directory to add to the shared workspace. Interpreted as relative to the workspace root. Must not be the workspace root itself.",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "attach_workspace": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/builtinSteps/documentation/attach_workspace"
+            }
+          ],
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["at"],
+          "properties": {
+            "name": {
+              "description": "Title of the step to be shown in the CircleCI UI",
+              "type": "string"
+            },
+            "at": {
+              "description": "Directory to attach the workspace to",
+              "type": "string"
+            }
+          }
+        },
+        "add_ssh_keys": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/builtinSteps/documentation/add_ssh_keys"
+            }
+          ],
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "name": {
+              "description": "Title of the step to be shown in the CircleCI UI",
+              "type": "string"
+            },
+            "fingerprints": {
+              "description": "Directory to attach the workspace to",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "when": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/builtinSteps/documentation/when"
+            }
+          ],
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "condition": {
+              "$ref": "#/definitions/logical"
+            },
+            "steps": {
+              "description": "A list of steps to be performed",
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/step"
+              }
+            }
+          },
+          "required": ["condition", "steps"]
+        },
+        "unless": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/builtinSteps/documentation/unless"
+            }
+          ],
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "condition": {
+              "$ref": "#/definitions/logical"
+            },
+            "steps": {
+              "description": "A list of steps to be performed",
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/step"
+              }
+            }
+          },
+          "required": ["condition", "steps"]
+        }
+      }
+    },
+    "step": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/builtinSteps/documentation/checkout",
+          "enum": ["checkout"]
+        },
+        {
+          "$ref": "#/definitions/builtinSteps/documentation/setup_remote_docker",
+          "enum": ["setup_remote_docker"]
+        },
+        {
+          "$ref": "#/definitions/builtinSteps/documentation/add_ssh_keys",
+          "enum": ["add_ssh_keys"]
+        },
+        {
+          "description": "https://circleci.com/docs/reusing-config#invoking-reusable-commands\n\nA custom command defined via the top level commands key",
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9_-]+$"
+        },
+        {
+          "description": "https://circleci.com/docs/using-orbs#commands\n\nA custom command defined via an orb.",
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9_-]+/[a-z][a-z0-9_-]+$"
+        },
+        {
+          "type": "object",
+          "minProperties": 1,
+          "maxProperties": 1,
+          "properties": {
+            "run": {
+              "$ref": "#/definitions/builtinSteps/configuration/run"
+            },
+            "checkout": {
+              "$ref": "#/definitions/builtinSteps/configuration/checkout"
+            },
+            "setup_remote_docker": {
+              "$ref": "#/definitions/builtinSteps/configuration/setup_remote_docker"
+            },
+            "save_cache": {
+              "$ref": "#/definitions/builtinSteps/configuration/save_cache"
+            },
+            "restore_cache": {
+              "$ref": "#/definitions/builtinSteps/configuration/restore_cache"
+            },
+            "deploy": {
+              "$ref": "#/definitions/builtinSteps/configuration/deploy"
+            },
+            "store_artifacts": {
+              "$ref": "#/definitions/builtinSteps/configuration/store_artifacts"
+            },
+            "store_test_results": {
+              "$ref": "#/definitions/builtinSteps/configuration/store_test_results"
+            },
+            "persist_to_workspace": {
+              "$ref": "#/definitions/builtinSteps/configuration/persist_to_workspace"
+            },
+            "attach_workspace": {
+              "$ref": "#/definitions/builtinSteps/configuration/attach_workspace"
+            },
+            "add_ssh_keys": {
+              "$ref": "#/definitions/builtinSteps/configuration/add_ssh_keys"
+            },
+            "when": {
+              "$ref": "#/definitions/builtinSteps/configuration/when"
+            },
+            "unless": {
+              "$ref": "#/definitions/builtinSteps/configuration/unless"
+            }
+          },
+          "patternProperties": {
+            "^[a-z][a-z0-9_-]+$": {
+              "description": "https://circleci.com/docs/reusing-config#invoking-reusable-commands\n\nA custom command defined via the top level commands key"
+            },
+            "^[a-z][a-z0-9_-]+/[a-z][a-z0-9_-]+$": {
+              "description": "https://circleci.com/docs/using-orbs#commands\n\nA custom command defined via an orb."
+            }
+          }
+        }
+      ]
+    },
+    "jobRef": {
+      "description": "Run a job as part of this workflow",
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "requires": {
+          "description": "Jobs are run in parallel by default, so you must explicitly require any dependencies by their job name.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "name": {
+          "description": "The name key can be used to ensure build numbers are not appended when invoking the same job multiple times (e.g., sayhello-1, sayhello-2). The name assigned needs to be unique, otherwise numbers will still be appended to the job name",
+          "type": "string"
+        },
+        "context": {
+          "description": "Either a single context name, or a list of contexts. The default name is `org-global`",
+          "oneOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "default": "org-global"
+        },
+        "type": {
+          "description": "A job may have a `type` of `approval` indicating it must be manually approved before downstream jobs may proceed.",
+          "enum": ["approval"]
+        },
+        "filters": {
+          "description": "A map defining rules for execution on specific branches",
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "branches": {
+              "$ref": "#/definitions/filter"
+            },
+            "tags": {
+              "$ref": "#/definitions/filter"
+            }
+          }
+        },
+        "matrix": {
+          "description": "https://circleci.com/docs/configuration-reference#matrix-requires-version-21\n\nThe matrix stanza allows you to run a parameterized job multiple times with different arguments.",
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["parameters"],
+          "properties": {
+            "parameters": {
+              "description": "A map of parameter names to every value the job should be called with",
+              "type": "object",
+              "additionalProperties": {
+                "type": "array"
+              }
+            },
+            "exclude": {
+              "description": "A list of argument maps that should be excluded from the matrix",
+              "type": "array",
+              "items": {
+                "type": "object"
+              }
+            },
+            "alias": {
+              "description": "An alias for the matrix, usable from another job's requires stanza. Defaults to the name of the job being executed",
+              "type": "string"
+            }
+          }
+        }
+      }
+    },
+    "jobs": {
+      "description": "Jobs are collections of steps. All of the steps in the job are executed in a single unit, either within a fresh container or VM.",
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "oneOf": [
+          {
+            "$ref": "#/definitions/executorChoice"
+          },
+          {
+            "type": "object",
+            "required": ["executor"],
+            "properties": {
+              "executor": {
+                "description": "The name of the executor to use (defined via the top level executors map).",
+                "type": "string"
+              }
+            }
+          },
+          {
+            "type": "object",
+            "required": ["executor"],
+            "properties": {
+              "executor": {
+                "description": "Executor stanza to use for the job",
+                "type": "object",
+                "required": ["name"],
+                "properties": {
+                  "name": {
+                    "description": "The name of the executor to use (defined via the top level executors map).",
+                    "type": "string"
+                  }
+                }
+              }
+            }
+          }
+        ],
+        "required": ["steps"],
+        "properties": {
+          "shell": {
+            "description": "Shell to use for execution command in all steps. Can be overridden by shell in each step",
+            "type": "string"
+          },
+          "steps": {
+            "description": "A list of steps to be performed",
+            "type": "array",
+            "items": {
+              "$ref": "#/definitions/step"
+            }
+          },
+          "working_directory": {
+            "description": "In which directory to run the steps. (default: `~/project`. `project` is a literal string, not the name of the project.) You can also refer the directory with `$CIRCLE_WORKING_DIRECTORY` environment variable.",
+            "type": "string",
+            "default": "~/project"
+          },
+          "parallelism": {
+            "description": "Number of parallel instances of this job to run (default: 1)",
+            "default": 1,
+            "oneOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "string",
+                "pattern": "^<<.+\\..+>>$"
+              }
+            ]
+          },
+          "environment": {
+            "description": "A map of environment variable names and variables (NOTE: these will override any environment variables you set in the CircleCI web interface).",
+            "type": "object",
+            "additionalProperties": {
+              "type": ["string", "number"]
+            }
+          },
+          "branches": {
+            "description": "A map defining rules for whitelisting/blacklisting execution of specific branches for a single job that is **not** in a workflow (default: all whitelisted). See Workflows for configuring branch execution for jobs in a workflow.",
+            "type": "object",
+            "additionalProperties": {
+              "type": "string"
+            }
+          }
+        }
+      }
+    }
+  },
+  "properties": {
+    "version": {
+      "description": "The version field is intended to be used in order to issue warnings for deprecation or breaking changes.",
+      "default": 2.1,
+      "enum": [2, 2.1]
+    },
+    "orbs": {
+      "$ref": "#/definitions/orbs"
+    },
+    "commands": {
+      "$ref": "#/definitions/commands"
+    },
+    "executors": {
+      "$ref": "#/definitions/executors"
+    },
+    "jobs": {
+      "$ref": "#/definitions/jobs"
+    },
+    "workflows": {
+      "description": "Used for orchestrating all jobs. Each workflow consists of the workflow name as a key and a map as a value",
+      "type": "object",
+      "properties": {
+        "version": {
+          "description": "The Workflows `version` field is used to issue warnings for deprecation or breaking changes during v2 Beta. It is deprecated as of CircleCI v2.1",
+          "enum": [2]
+        }
+      },
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "triggers": {
+            "description": "Specifies which triggers will cause this workflow to be executed. Default behavior is to trigger the workflow when pushing to a branch.",
+            "type": "array",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "schedule": {
+                  "description": "A workflow may have a schedule indicating it runs at a certain time, for example a nightly build that runs every day at 12am UTC:",
+                  "type": "object",
+                  "properties": {
+                    "cron": {
+                      "description": "See the [crontab man page](http://pubs.opengroup.org/onlinepubs/7908799/xcu/crontab.html)",
+                      "type": "string"
+                    },
+                    "filters": {
+                      "description": "A map defining rules for execution on specific branches",
+                      "type": "object",
+                      "additionalProperties": false,
+                      "properties": {
+                        "branches": {
+                          "$ref": "#/definitions/filter"
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "jobs": {
+            "type": "array",
+            "items": {
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "object",
+                  "additionalProperties": {
+                    "$ref": "#/definitions/jobRef",
+                    "type": "object"
+                  }
+                }
+              ]
+            }
+          },
+          "when": {
+            "$ref": "#/definitions/logical",
+            "description": "Specify when to run the workflow."
+          },
+          "unless": {
+            "$ref": "#/definitions/logical",
+            "description": "Specify when *not* to run the workflow."
+          }
+        }
+      }
+    }
+  },
+  "required": ["version"],
+  "title": "JSON schema for CircleCI configuration files",
+  "type": "object"
+}
diff --git a/ci/schemas/codecov.json b/ci/schemas/codecov.json
new file mode 100644
index 000000000000..98decea44415
--- /dev/null
+++ b/ci/schemas/codecov.json
@@ -0,0 +1,620 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://json.schemastore.org/codecov",
+  "definitions": {
+    "default": {
+      "$comment": "See https://docs.codecov.com/docs/commit-status#basic-configuration",
+      "properties": {
+        "target": {
+          "type": ["string", "number"],
+          "pattern": "^(([0-9]+\\.?[0-9]*|\\.[0-9]+)%?|auto)$",
+          "default": "auto"
+        },
+        "threshold": {
+          "type": "string",
+          "default": "0%",
+          "pattern": "^([0-9]+\\.?[0-9]*|\\.[0-9]+)%?$"
+        },
+        "base": {
+          "type": "string",
+          "default": "auto",
+          "deprecated": true
+        },
+        "flags": {
+          "type": "array",
+          "default": []
+        },
+        "paths": {
+          "type": ["array", "string"],
+          "default": []
+        },
+        "branches": {
+          "type": "array",
+          "default": []
+        },
+        "if_not_found": {
+          "type": "string",
+          "enum": ["failure", "success"],
+          "default": "success"
+        },
+        "informational": {
+          "type": "boolean",
+          "default": false
+        },
+        "only_pulls": {
+          "type": "boolean",
+          "default": false
+        },
+        "if_ci_failed": {
+          "type": "string",
+          "enum": ["error", "success"]
+        },
+        "flag_coverage_not_uploaded_behavior": {
+          "type": "string",
+          "enum": ["include", "exclude", "pass"]
+        }
+      }
+    },
+    "flag": {
+      "type": "object",
+      "properties": {
+        "joined": {
+          "type": "boolean"
+        },
+        "required": {
+          "type": "boolean"
+        },
+        "ignore": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "paths": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "assume": {
+          "type": ["boolean", "array"],
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "layout": {
+      "anyOf": [
+        {},
+        {
+          "enum": [
+            "header",
+            "footer",
+            "diff",
+            "file",
+            "files",
+            "flag",
+            "flags",
+            "reach",
+            "sunburst",
+            "uncovered"
+          ]
+        }
+      ]
+    },
+    "notification": {
+      "type": "object",
+      "properties": {
+        "url": {
+          "type": "string"
+        },
+        "branches": {
+          "type": "string"
+        },
+        "threshold": {
+          "type": "string"
+        },
+        "message": {
+          "type": "string"
+        },
+        "flags": {
+          "type": "string"
+        },
+        "base": {
+          "enum": ["parent", "pr", "auto"]
+        },
+        "only_pulls": {
+          "type": "boolean"
+        },
+        "paths": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  },
+  "description": "Schema for codecov.yml files.",
+  "properties": {
+    "codecov": {
+      "description": "See https://docs.codecov.io/docs/codecov-yaml for details",
+      "type": "object",
+      "properties": {
+        "url": {
+          "type": "string"
+        },
+        "slug": {
+          "type": "string"
+        },
+        "bot": {
+          "description": "Team bot. See https://docs.codecov.io/docs/team-bot for details",
+          "type": "string"
+        },
+        "branch": {
+          "type": "string"
+        },
+        "ci": {
+          "description": "Detecting CI services. See https://docs.codecov.io/docs/detecting-ci-services for details.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "assume_all_flags": {
+          "type": "boolean"
+        },
+        "strict_yaml_branch": {
+          "type": "string"
+        },
+        "max_report_age": {
+          "type": ["string", "integer", "boolean"]
+        },
+        "disable_default_path_fixes": {
+          "type": "boolean"
+        },
+        "require_ci_to_pass": {
+          "type": "boolean"
+        },
+        "allow_pseudo_compare": {
+          "type": "boolean"
+        },
+        "archive": {
+          "type": "object",
+          "properties": {
+            "uploads": {
+              "type": "boolean"
+            }
+          }
+        },
+        "notify": {
+          "type": "object",
+          "properties": {
+            "after_n_builds": {
+              "type": "integer"
+            },
+            "countdown": {
+              "type": "integer"
+            },
+            "delay": {
+              "type": "integer"
+            },
+            "wait_for_ci": {
+              "type": "boolean"
+            }
+          }
+        },
+        "ui": {
+          "type": "object",
+          "properties": {
+            "hide_density": {
+              "type": ["boolean", "array"],
+              "items": {
+                "type": "string"
+              }
+            },
+            "hide_complexity": {
+              "type": ["boolean", "array"],
+              "items": {
+                "type": "string"
+              }
+            },
+            "hide_contextual": {
+              "type": "boolean"
+            },
+            "hide_sunburst": {
+              "type": "boolean"
+            },
+            "hide_search": {
+              "type": "boolean"
+            }
+          }
+        }
+      }
+    },
+    "coverage": {
+      "description": "Coverage configuration. See https://docs.codecov.io/docs/coverage-configuration for details.",
+      "type": "object",
+      "properties": {
+        "precision": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 5
+        },
+        "round": {
+          "enum": ["down", "up", "nearest"]
+        },
+        "range": {
+          "type": "string"
+        },
+        "notify": {
+          "description": "Notifications. See https://docs.codecov.io/docs/notifications for details.",
+          "type": "object",
+          "properties": {
+            "irc": {
+              "type": "object",
+              "properties": {
+                "url": {
+                  "type": "string"
+                },
+                "branches": {
+                  "type": "string"
+                },
+                "threshold": {
+                  "type": "string"
+                },
+                "message": {
+                  "type": "string"
+                },
+                "flags": {
+                  "type": "string"
+                },
+                "base": {
+                  "enum": ["parent", "pr", "auto"]
+                },
+                "only_pulls": {
+                  "type": "boolean"
+                },
+                "paths": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "channel": {
+                  "type": "string"
+                },
+                "password": {
+                  "type": "string"
+                },
+                "nickserv_password": {
+                  "type": "string"
+                },
+                "notice": {
+                  "type": "boolean"
+                }
+              }
+            },
+            "slack": {
+              "description": "Slack. See https://docs.codecov.io/docs/notifications#section-slack for details.",
+              "type": "object",
+              "properties": {
+                "url": {
+                  "type": "string"
+                },
+                "branches": {
+                  "type": "string"
+                },
+                "threshold": {
+                  "type": "string"
+                },
+                "message": {
+                  "type": "string"
+                },
+                "flags": {
+                  "type": "string"
+                },
+                "base": {
+                  "enum": ["parent", "pr", "auto"]
+                },
+                "only_pulls": {
+                  "type": "boolean"
+                },
+                "paths": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "attachments": {
+                  "$ref": "#/definitions/layout"
+                }
+              }
+            },
+            "gitter": {
+              "description": "Gitter. See https://docs.codecov.io/docs/notifications#section-gitter for details.",
+              "type": "object",
+              "properties": {
+                "url": {
+                  "type": "string"
+                },
+                "branches": {
+                  "type": "string"
+                },
+                "threshold": {
+                  "type": "string"
+                },
+                "message": {
+                  "type": "string"
+                },
+                "flags": {
+                  "type": "string"
+                },
+                "base": {
+                  "enum": ["parent", "pr", "auto"]
+                },
+                "only_pulls": {
+                  "type": "boolean"
+                },
+                "paths": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              }
+            },
+            "hipchat": {
+              "description": "Hipchat. See https://docs.codecov.io/docs/notifications#section-hipchat for details.",
+              "type": "object",
+              "properties": {
+                "url": {
+                  "type": "string"
+                },
+                "branches": {
+                  "type": "string"
+                },
+                "threshold": {
+                  "type": "string"
+                },
+                "message": {
+                  "type": "string"
+                },
+                "flags": {
+                  "type": "string"
+                },
+                "base": {
+                  "enum": ["parent", "pr", "auto"]
+                },
+                "only_pulls": {
+                  "type": "boolean"
+                },
+                "paths": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "card": {
+                  "type": "boolean"
+                },
+                "notify": {
+                  "type": "boolean"
+                }
+              }
+            },
+            "webhook": {
+              "type": "object",
+              "properties": {
+                "url": {
+                  "type": "string"
+                },
+                "branches": {
+                  "type": "string"
+                },
+                "threshold": {
+                  "type": "string"
+                },
+                "message": {
+                  "type": "string"
+                },
+                "flags": {
+                  "type": "string"
+                },
+                "base": {
+                  "enum": ["parent", "pr", "auto"]
+                },
+                "only_pulls": {
+                  "type": "boolean"
+                },
+                "paths": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              }
+            },
+            "email": {
+              "type": "object",
+              "properties": {
+                "url": {
+                  "type": "string"
+                },
+                "branches": {
+                  "type": "string"
+                },
+                "threshold": {
+                  "type": "string"
+                },
+                "message": {
+                  "type": "string"
+                },
+                "flags": {
+                  "type": "string"
+                },
+                "base": {
+                  "enum": ["parent", "pr", "auto"]
+                },
+                "only_pulls": {
+                  "type": "boolean"
+                },
+                "paths": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "layout": {
+                  "$ref": "#/definitions/layout"
+                },
+                "+to": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "status": {
+          "description": "Commit status. See https://docs.codecov.io/docs/commit-status for details.",
+          "type": ["boolean", "object"],
+          "additionalProperties": false,
+          "properties": {
+            "default_rules": {
+              "type": "object"
+            },
+            "project": {
+              "properties": {
+                "default": {
+                  "$ref": "#/definitions/default",
+                  "type": ["object", "boolean"]
+                }
+              },
+              "additionalProperties": {
+                "$ref": "#/definitions/default",
+                "type": ["object", "boolean"]
+              }
+            },
+            "patch": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/default",
+                  "type": "object"
+                },
+                {
+                  "type": "string",
+                  "enum": ["off"]
+                },
+                {
+                  "type": "boolean"
+                }
+              ]
+            },
+            "changes": {
+              "$ref": "#/definitions/default",
+              "type": ["object", "boolean"]
+            }
+          }
+        }
+      }
+    },
+    "ignore": {
+      "description": "Ignoring paths. see https://docs.codecov.io/docs/ignoring-paths for details.",
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "fixes": {
+      "description": "Fixing paths. See https://docs.codecov.io/docs/fixing-paths for details.",
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "flags": {
+      "description": "Flags. See https://docs.codecov.io/docs/flags for details.",
+      "oneOf": [
+        {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/flag"
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/definitions/flag"
+          }
+        }
+      ]
+    },
+    "comment": {
+      "description": "Pull request comments. See https://docs.codecov.io/docs/pull-request-comments for details.",
+      "oneOf": [
+        {
+          "type": "object",
+          "properties": {
+            "layout": {
+              "$ref": "#/definitions/layout"
+            },
+            "require_changes": {
+              "type": "boolean"
+            },
+            "require_base": {
+              "type": "boolean"
+            },
+            "require_head": {
+              "type": "boolean"
+            },
+            "branches": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "behavior": {
+              "enum": ["default", "once", "new", "spammy"]
+            },
+            "flags": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/flag"
+              }
+            },
+            "paths": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        {
+          "const": false
+        }
+      ]
+    },
+    "github_checks": {
+      "description": "GitHub Checks. See https://docs.codecov.com/docs/github-checks for details.",
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "annotations": {
+              "type": "boolean"
+            }
+          }
+        },
+        { "type": "boolean" },
+        { "type": "string", "enum": ["off"] }
+      ]
+    }
+  },
+  "title": "JSON schema for Codecov configuration files",
+  "type": "object"
+}
diff --git a/ci/schemas/conda-environment.json b/ci/schemas/conda-environment.json
new file mode 100644
index 000000000000..458676942a44
--- /dev/null
+++ b/ci/schemas/conda-environment.json
@@ -0,0 +1,53 @@
+{
+    "title": "conda environment file",
+    "description": "Support for conda's enviroment.yml files (e.g. `conda env export > environment.yml`)",
+    "id": "https://raw.githubusercontent.com/Microsoft/vscode-python/main/schemas/conda-environment.json",
+    "$schema": "http://json-schema.org/draft-04/schema#",
+    "definitions": {
+        "channel": {
+            "type": "string"
+        },
+        "package": {
+            "type": "string"
+        },
+        "path": {
+            "type": "string"
+        }
+    },
+    "properties": {
+        "name": {
+            "type": "string"
+        },
+        "channels": {
+            "type": "array",
+            "items": {
+                "$ref": "#/definitions/channel"
+            }
+        },
+        "dependencies": {
+            "type": "array",
+            "items": {
+                "anyOf": [
+                    {
+                        "$ref": "#/definitions/package"
+                    },
+                    {
+                        "type": "object",
+                        "properties": {
+                            "pip": {
+                                "type": "array",
+                                "items": {
+                                    "$ref": "#/definitions/package"
+                                }
+                            }
+                        },
+                        "required": ["pip"]
+                    }
+                ]
+            }
+        },
+        "prefix": {
+            "$ref": "#/definitions/path"
+        }
+    }
+}
diff --git a/ci/schemas/github-funding.json b/ci/schemas/github-funding.json
new file mode 100644
index 000000000000..d146d692c483
--- /dev/null
+++ b/ci/schemas/github-funding.json
@@ -0,0 +1,113 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://json.schemastore.org/github-funding.json",
+  "$comment": "https://docs.github.com/en/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository",
+  "additionalProperties": false,
+  "definitions": {
+    "github_username": {
+      "type": "string",
+      "maxLength": 39,
+      "pattern": "^[a-zA-Z0-9](-?[a-zA-Z0-9])*$",
+      "examples": ["SampleUserName"]
+    },
+    "nullable_string": {
+      "type": ["string", "null"]
+    }
+  },
+  "description": "You can add a sponsor button in your repository to increase the visibility of funding options for your open source project.",
+  "properties": {
+    "community_bridge": {
+      "$ref": "#/definitions/nullable_string",
+      "title": "CommunityBridge",
+      "description": "Project name on CommunityBridge.",
+      "minLength": 1
+    },
+    "github": {
+      "title": "GitHub Sponsors",
+      "description": "Username or usernames on GitHub.",
+      "oneOf": [
+        {
+          "$ref": "#/definitions/github_username"
+        },
+        {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/definitions/github_username"
+          }
+        }
+      ]
+    },
+    "issuehunt": {
+      "$ref": "#/definitions/nullable_string",
+      "title": "IssueHunt",
+      "description": "Username on IssueHunt.",
+      "minLength": 1
+    },
+    "ko_fi": {
+      "$ref": "#/definitions/nullable_string",
+      "title": "Ko-fi",
+      "description": "Username on Ko-fi.",
+      "minLength": 1
+    },
+    "liberapay": {
+      "$ref": "#/definitions/nullable_string",
+      "title": "Liberapay",
+      "description": "Username on Liberapay.",
+      "minLength": 1
+    },
+    "open_collective": {
+      "$ref": "#/definitions/nullable_string",
+      "title": "Open Collective",
+      "description": "Username on Open Collective.",
+      "minLength": 1
+    },
+    "otechie": {
+      "$ref": "#/definitions/nullable_string",
+      "title": "Otechie",
+      "description": "Username on Otechie.",
+      "minLength": 1
+    },
+    "patreon": {
+      "$ref": "#/definitions/nullable_string",
+      "title": "Patreon",
+      "description": "Username on Pateron.",
+      "minLength": 1,
+      "maxLength": 100
+    },
+    "tidelift": {
+      "$ref": "#/definitions/nullable_string",
+      "title": "Tidelift",
+      "description": "Platform and package on Tidelift.",
+      "pattern": "^(npm|pypi|rubygems|maven|packagist|nuget)/.+$"
+    },
+    "lfx_crowdfunding": {
+      "$ref": "#/definitions/nullable_string",
+      "title": "LFX Crowdfunding",
+      "description": "Project name on LFX Crowdfunding.",
+      "minLength": 1
+    },
+    "polar": {
+      "$ref": "#/definitions/github_username",
+      "title": "Polar",
+      "description": "Username on Polar.",
+      "minLength": 1
+    },
+    "custom": {
+      "title": "Custom URL",
+      "description": "Link or links where funding is accepted on external locations.",
+      "type": ["string", "array", "null"],
+      "format": "uri-reference",
+      "items": {
+        "title": "Link",
+        "description": "Link to an external location.",
+        "type": "string",
+        "format": "uri-reference"
+      },
+      "uniqueItems": true
+    }
+  },
+  "title": "GitHub Funding",
+  "type": "object"
+}
diff --git a/ci/schemas/github-issue-config.json b/ci/schemas/github-issue-config.json
new file mode 100644
index 000000000000..b46556bb04a5
--- /dev/null
+++ b/ci/schemas/github-issue-config.json
@@ -0,0 +1,45 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://json.schemastore.org/github-issue-config.json",
+  "$comment": "https://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/configuring-issue-templates-for-your-repository#configuring-the-template-chooser",
+  "properties": {
+    "blank_issues_enabled": {
+      "description": "Specify whether allow blank issue creation\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/configuring-issue-templates-for-your-repository#configuring-the-template-chooser",
+      "type": "boolean"
+    },
+    "contact_links": {
+      "title": "contact links",
+      "description": "Contact links\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/configuring-issue-templates-for-your-repository#configuring-the-template-chooser",
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["name", "url", "about"],
+        "properties": {
+          "name": {
+            "description": "A link title\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/configuring-issue-templates-for-your-repository#configuring-the-template-chooser",
+            "type": "string",
+            "minLength": 1,
+            "examples": ["Sample name"]
+          },
+          "url": {
+            "description": "A link URL\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/configuring-issue-templates-for-your-repository#configuring-the-template-chooser",
+            "type": "string",
+            "pattern": "^https?://",
+            "examples": ["https://sample/url"]
+          },
+          "about": {
+            "description": "A link description\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/configuring-issue-templates-for-your-repository#configuring-the-template-chooser",
+            "type": "string",
+            "minLength": 1,
+            "examples": ["Sample description"]
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false,
+  "title": "GitHub issue template chooser config file schema",
+  "type": "object"
+}
diff --git a/ci/schemas/github-issue-forms.json b/ci/schemas/github-issue-forms.json
new file mode 100644
index 000000000000..c928818dfdd1
--- /dev/null
+++ b/ci/schemas/github-issue-forms.json
@@ -0,0 +1,1295 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://json.schemastore.org/github-issue-forms.json",
+  "$comment": "https://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-issue-forms",
+  "additionalProperties": false,
+  "definitions": {
+    "type": {
+      "description": "A form item type\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#keys",
+      "type": "string",
+      "enum": ["checkboxes", "dropdown", "input", "markdown", "textarea"]
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[a-zA-Z0-9_-]+$",
+      "examples": ["SampleId"]
+    },
+    "validations": {
+      "title": "validation options",
+      "type": "object",
+      "properties": {
+        "required": {
+          "description": "Specify whether require a form item",
+          "type": "boolean",
+          "default": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "assignee": {
+      "type": "string",
+      "maxLength": 39,
+      "pattern": "^[a-zA-Z0-9](-?[a-zA-Z0-9])*$",
+      "examples": ["SampleAssignee"]
+    },
+    "label": {
+      "type": "string",
+      "minLength": 1,
+      "examples": ["Sample label"]
+    },
+    "description": {
+      "type": "string",
+      "default": "",
+      "examples": ["Sample description"]
+    },
+    "placeholder": {
+      "type": "string",
+      "default": "",
+      "examples": ["Sample placeholder"]
+    },
+    "value": {
+      "type": "string",
+      "minLength": 1,
+      "examples": ["Sample value"]
+    },
+    "form_item": {
+      "title": "form item",
+      "description": "A form item\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#about-githubs-form-schema",
+      "type": "object",
+      "required": ["type"],
+      "properties": {
+        "type": {
+          "$ref": "#/definitions/type"
+        }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "type": {
+                "const": "markdown"
+              }
+            }
+          },
+          "then": {
+            "$comment": "For `additionalProperties` to work `type` must also be present here.",
+            "title": "markdown",
+            "description": "Markdown\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#markdown",
+            "type": "object",
+            "required": ["type", "attributes"],
+            "properties": {
+              "type": {
+                "$ref": "#/definitions/type"
+              },
+              "attributes": {
+                "title": "markdown attributes",
+                "description": "Markdown attributes\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#attributes",
+                "type": "object",
+                "required": ["value"],
+                "properties": {
+                  "value": {
+                    "description": "A markdown code\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#attributes",
+                    "type": "string",
+                    "minLength": 1,
+                    "examples": ["Sample code"]
+                  }
+                },
+                "additionalProperties": false
+              }
+            },
+            "additionalProperties": false
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "type": {
+                "const": "textarea"
+              }
+            }
+          },
+          "then": {
+            "$comment": "For `additionalProperties` to work `type` must also be present here.",
+            "title": "textarea",
+            "description": "Textarea\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#textarea",
+            "type": "object",
+            "required": ["type", "attributes"],
+            "properties": {
+              "type": {
+                "$ref": "#/definitions/type"
+              },
+              "id": {
+                "$ref": "#/definitions/id",
+                "description": "A textarea id\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#keys"
+              },
+              "attributes": {
+                "title": "textarea attributes",
+                "description": "Textarea attributes\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#attributes-1",
+                "type": "object",
+                "required": ["label"],
+                "properties": {
+                  "label": {
+                    "$ref": "#/definitions/label",
+                    "description": "A short textarea description\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#attributes-1"
+                  },
+                  "description": {
+                    "$ref": "#/definitions/description",
+                    "description": "A long textarea description\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#attributes-1"
+                  },
+                  "placeholder": {
+                    "$ref": "#/definitions/placeholder",
+                    "description": "A textarea placeholder\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#attributes-1"
+                  },
+                  "value": {
+                    "$ref": "#/definitions/value",
+                    "description": "A textarea value\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#attributes-1"
+                  },
+                  "render": {
+                    "description": "A textarea syntax highlighting mode\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#attributes-1",
+                    "type": "string",
+                    "enum": [
+                      "1C Enterprise",
+                      "4D",
+                      "ABAP CDS",
+                      "ABAP",
+                      "ABNF",
+                      "AFDKO",
+                      "AGS Script",
+                      "AIDL",
+                      "AL",
+                      "AMPL",
+                      "ANTLR",
+                      "API Blueprint",
+                      "APL",
+                      "ASL",
+                      "ASN.1",
+                      "ASP.NET",
+                      "ATS",
+                      "ActionScript",
+                      "Ada",
+                      "Alloy",
+                      "Alpine Abuild",
+                      "Altium Designer",
+                      "AngelScript",
+                      "Ant Build System",
+                      "ApacheConf",
+                      "Apex",
+                      "Apollo Guidance Computer",
+                      "AppleScript",
+                      "Arc",
+                      "AsciiDoc",
+                      "AspectJ",
+                      "Assembly",
+                      "Astro",
+                      "Asymptote",
+                      "Augeas",
+                      "AutoHotkey",
+                      "AutoIt",
+                      "AutoIt3",
+                      "AutoItScript",
+                      "Avro IDL",
+                      "Awk",
+                      "BASIC",
+                      "Ballerina",
+                      "Batchfile",
+                      "Beef",
+                      "Befunge",
+                      "BibTeX",
+                      "Bicep",
+                      "Bison",
+                      "BitBake",
+                      "Blade",
+                      "BlitzBasic",
+                      "BlitzMax",
+                      "Boo",
+                      "Boogie",
+                      "Brainfuck",
+                      "Brightscript",
+                      "Browserslist",
+                      "C",
+                      "C#",
+                      "C++",
+                      "C-ObjDump",
+                      "C2hs Haskell",
+                      "CIL",
+                      "CLIPS",
+                      "CMake",
+                      "COBOL",
+                      "CODEOWNERS",
+                      "COLLADA",
+                      "CSON",
+                      "CSS",
+                      "CSV",
+                      "CUE",
+                      "CWeb",
+                      "Cabal Config",
+                      "Cabal",
+                      "Cap'n Proto",
+                      "Carto",
+                      "CartoCSS",
+                      "Ceylon",
+                      "Chapel",
+                      "Charity",
+                      "ChucK",
+                      "Cirru",
+                      "Clarion",
+                      "Classic ASP",
+                      "Clean",
+                      "Click",
+                      "Clojure",
+                      "Closure Templates",
+                      "Cloud Firestore Security Rules",
+                      "CoNLL",
+                      "CoNLL-U",
+                      "CoNLL-X",
+                      "ColdFusion CFC",
+                      "ColdFusion",
+                      "Common Lisp",
+                      "Common Workflow Language",
+                      "Component Pascal",
+                      "Containerfile",
+                      "Cool",
+                      "Coq",
+                      "Cpp-ObjDump",
+                      "Crystal",
+                      "Csound Document",
+                      "Csound Score",
+                      "Csound",
+                      "Cuda",
+                      "Cue Sheet",
+                      "Cycript",
+                      "Cython",
+                      "D-ObjDump",
+                      "DIGITAL Command Language",
+                      "DM",
+                      "DTrace",
+                      "Dafny",
+                      "Darcs Patch",
+                      "Dart",
+                      "DataWeave",
+                      "Dhall",
+                      "Diff",
+                      "Dlang",
+                      "Dockerfile",
+                      "Dogescript",
+                      "Dylan",
+                      "E",
+                      "E-mail",
+                      "EBNF",
+                      "ECL",
+                      "ECLiPSe",
+                      "EJS",
+                      "EQ",
+                      "Eagle",
+                      "Earthly",
+                      "Easybuild",
+                      "Ecere Projects",
+                      "EditorConfig",
+                      "Eiffel",
+                      "Elixir",
+                      "Elm",
+                      "Emacs Lisp",
+                      "EmberScript",
+                      "Erlang",
+                      "F#",
+                      "F*",
+                      "FIGfont",
+                      "FIGlet Font",
+                      "FLUX",
+                      "Factor",
+                      "Fancy",
+                      "Fantom",
+                      "Faust",
+                      "Fennel",
+                      "Filebench WML",
+                      "Filterscript",
+                      "Fluent",
+                      "Formatted",
+                      "Forth",
+                      "Fortran Free Form",
+                      "Fortran",
+                      "FreeBasic",
+                      "Frege",
+                      "Futhark",
+                      "G-code",
+                      "GAML",
+                      "GAMS",
+                      "GAP",
+                      "GCC Machine Description",
+                      "GDB",
+                      "GDScript",
+                      "GEDCOM",
+                      "GLSL",
+                      "GN",
+                      "Game Maker Language",
+                      "Gemfile.lock",
+                      "Genie",
+                      "Genshi",
+                      "Gentoo Eclass",
+                      "Gerber Image",
+                      "Gettext Catalog",
+                      "Gherkin",
+                      "Git Config",
+                      "Glyph Bitmap Distribution Format",
+                      "Glyph",
+                      "Gnuplot",
+                      "Go Checksums",
+                      "Go Module",
+                      "Go",
+                      "Golo",
+                      "Gosu",
+                      "Grace",
+                      "Gradle",
+                      "Grammatical Framework",
+                      "Graph Modeling Language",
+                      "GraphQL",
+                      "Graphviz (DOT)",
+                      "Groovy Server Pages",
+                      "Groovy",
+                      "HAProxy",
+                      "HCL",
+                      "HTML",
+                      "HTML+ECR",
+                      "HTML+EEX",
+                      "HTML+ERB",
+                      "HTML+PHP",
+                      "HTML+Razor",
+                      "HTTP",
+                      "HXML",
+                      "Hack",
+                      "Haml",
+                      "Handlebars",
+                      "Harbour",
+                      "HashiCorp Configuration Language",
+                      "Haskell",
+                      "Haxe",
+                      "HiveQL",
+                      "HolyC",
+                      "Hy",
+                      "IDL",
+                      "IGOR Pro",
+                      "IPython Notebook",
+                      "Idris",
+                      "Ignore List",
+                      "ImageJ Macro",
+                      "Inform 7",
+                      "Io",
+                      "Ioke",
+                      "Isabelle ROOT",
+                      "Isabelle",
+                      "J",
+                      "JAR Manifest",
+                      "JFlex",
+                      "JSON with Comments",
+                      "JSON",
+                      "JSON5",
+                      "JSONLD",
+                      "JSONiq",
+                      "Jasmin",
+                      "Java Properties",
+                      "Java Server Pages",
+                      "Java",
+                      "JavaScript",
+                      "JavaScript+ERB",
+                      "Jest Snapshot",
+                      "Jinja",
+                      "Jison Lex",
+                      "Jison",
+                      "Jolie",
+                      "Jsonnet",
+                      "Julia",
+                      "Jupyter Notebook",
+                      "Kaitai Struct",
+                      "KakouneScript",
+                      "KiCad Layout",
+                      "KiCad Legacy Layout",
+                      "KiCad Schematic",
+                      "Kit",
+                      "Kotlin",
+                      "Kusto",
+                      "LFE",
+                      "LLVM",
+                      "LOLCODE",
+                      "LSL",
+                      "LTspice Symbol",
+                      "LabVIEW",
+                      "Lark",
+                      "Lasso",
+                      "Lean",
+                      "Less",
+                      "Lex",
+                      "LilyPond",
+                      "Limbo",
+                      "Linker Script",
+                      "Linux Kernel Module",
+                      "Liquid",
+                      "Literate Agda",
+                      "Literate CoffeeScript",
+                      "Literate Haskell",
+                      "LiveScript",
+                      "Logos",
+                      "Logtalk",
+                      "LookML",
+                      "LoomScript",
+                      "Lua",
+                      "M",
+                      "M4",
+                      "M4Sugar",
+                      "MATLAB",
+                      "MAXScript",
+                      "MLIR",
+                      "MQL4",
+                      "MQL5",
+                      "MTML",
+                      "MUF",
+                      "Macaulay2",
+                      "Makefile",
+                      "Mako",
+                      "Markdown",
+                      "Marko",
+                      "Mathematica",
+                      "Max",
+                      "Mercury",
+                      "Meson",
+                      "Metal",
+                      "Microsoft Developer Studio Project",
+                      "Microsoft Visual Studio Solution",
+                      "MiniD",
+                      "Mirah",
+                      "Modelica",
+                      "Modula-2",
+                      "Modula-3",
+                      "Module Management System",
+                      "Monkey",
+                      "Moocode",
+                      "MoonScript",
+                      "Motoko",
+                      "Motorola 68K Assembly",
+                      "Muse",
+                      "Myghty",
+                      "NASL",
+                      "NCL",
+                      "NEON",
+                      "NPM Config",
+                      "NSIS",
+                      "NWScript",
+                      "Nearley",
+                      "Nemerle",
+                      "NeoSnippet",
+                      "NetLinx",
+                      "NetLinx+ERB",
+                      "NetLogo",
+                      "NewLisp",
+                      "Nextflow",
+                      "Nginx",
+                      "Ninja",
+                      "Nit",
+                      "Nix",
+                      "NumPy",
+                      "Nunjucks",
+                      "ObjDump",
+                      "Object Data Instance Notation",
+                      "ObjectScript",
+                      "Objective-C",
+                      "Objective-C++",
+                      "Objective-J",
+                      "Odin",
+                      "Omgrofl",
+                      "Opa",
+                      "Opal",
+                      "Open Policy Agent",
+                      "OpenCL",
+                      "OpenEdge ABL",
+                      "OpenQASM",
+                      "OpenRC runscript",
+                      "OpenSCAD",
+                      "OpenStep Property List",
+                      "OpenType Feature File",
+                      "Org",
+                      "Ox",
+                      "Oxygene",
+                      "Oz",
+                      "P4",
+                      "PEG.js",
+                      "PHP",
+                      "PLpgSQL",
+                      "POV-Ray SDL",
+                      "Pan",
+                      "Papyrus",
+                      "Parrot Assembly",
+                      "Parrot Internal Representation",
+                      "Parrot",
+                      "Pascal",
+                      "Pawn",
+                      "Pep8",
+                      "Perl",
+                      "Pickle",
+                      "PicoLisp",
+                      "PigLatin",
+                      "Pike",
+                      "PlantUML",
+                      "Pod 6",
+                      "Pod",
+                      "PogoScript",
+                      "Pony",
+                      "PostCSS",
+                      "PostScript",
+                      "PowerShell",
+                      "Prisma",
+                      "Processing",
+                      "Proguard",
+                      "Prolog",
+                      "Promela",
+                      "Propeller Spin",
+                      "Protocol Buffer",
+                      "Protocol Buffers",
+                      "Public Key",
+                      "Pug",
+                      "Puppet",
+                      "Pure Data",
+                      "PureBasic",
+                      "PureScript",
+                      "Python",
+                      "Q#",
+                      "QMake",
+                      "Qt Script",
+                      "Quake",
+                      "R",
+                      "RAML",
+                      "RDoc",
+                      "REALbasic",
+                      "REXX",
+                      "RMarkdown",
+                      "RPC",
+                      "RPM Spec",
+                      "Racket",
+                      "Ragel",
+                      "Raw token data",
+                      "ReScript",
+                      "Readline Config",
+                      "Reason",
+                      "Rebol",
+                      "Record Jar",
+                      "Red",
+                      "Redirect Rules",
+                      "Regular Expression",
+                      "RenderScript",
+                      "Rich Text Format",
+                      "Ring",
+                      "Riot",
+                      "RobotFramework",
+                      "Roff",
+                      "Rouge",
+                      "Rscript",
+                      "Ruby",
+                      "Rust",
+                      "SAS",
+                      "SCSS",
+                      "SELinux Kernel Policy Language",
+                      "SELinux Policy",
+                      "SMT",
+                      "SPARQL",
+                      "SQF",
+                      "SQL",
+                      "SQLPL",
+                      "SRecode Template",
+                      "SSH Config",
+                      "STON",
+                      "SVG",
+                      "SWIG",
+                      "Sage",
+                      "SaltStack",
+                      "Sass",
+                      "Scala",
+                      "Scaml",
+                      "Scheme",
+                      "Scilab",
+                      "Self",
+                      "ShaderLab",
+                      "Shell",
+                      "ShellCheck Config",
+                      "Sieve",
+                      "Singularity",
+                      "Slash",
+                      "Slice",
+                      "Slim",
+                      "SmPL",
+                      "Smalltalk",
+                      "SnipMate",
+                      "Solidity",
+                      "Soong",
+                      "SourcePawn",
+                      "Spline Font Database",
+                      "Squirrel",
+                      "Stan",
+                      "Standard ML",
+                      "Starlark",
+                      "StringTemplate",
+                      "Stylus",
+                      "SubRip Text",
+                      "SugarSS",
+                      "SuperCollider",
+                      "Svelte",
+                      "Swift",
+                      "SystemVerilog",
+                      "TI Program",
+                      "TLA",
+                      "TOML",
+                      "TSQL",
+                      "TSV",
+                      "TSX",
+                      "TXL",
+                      "Tcl",
+                      "Tcsh",
+                      "TeX",
+                      "Tea",
+                      "Terra",
+                      "Texinfo",
+                      "Text",
+                      "TextMate Properties",
+                      "Textile",
+                      "Thrift",
+                      "Turing",
+                      "Turtle",
+                      "Twig",
+                      "Type Language",
+                      "TypeScript",
+                      "UltiSnip",
+                      "UltiSnips",
+                      "Unified Parallel C",
+                      "Unity3D Asset",
+                      "Unix Assembly",
+                      "Uno",
+                      "UnrealScript",
+                      "Ur",
+                      "Ur/Web",
+                      "UrWeb",
+                      "V",
+                      "VBA",
+                      "VCL",
+                      "VHDL",
+                      "Vala",
+                      "Valve Data Format",
+                      "Verilog",
+                      "Vim Help File",
+                      "Vim Script",
+                      "Vim Snippet",
+                      "Visual Basic .NET",
+                      "Vue",
+                      "Wavefront Material",
+                      "Wavefront Object",
+                      "Web Ontology Language",
+                      "WebAssembly",
+                      "WebVTT",
+                      "Wget Config",
+                      "Wikitext",
+                      "Windows Registry Entries",
+                      "Wollok",
+                      "World of Warcraft Addon Data",
+                      "X BitMap",
+                      "X Font Directory Index",
+                      "X PixMap",
+                      "X10",
+                      "XC",
+                      "XCompose",
+                      "XML Property List",
+                      "XML",
+                      "XPages",
+                      "XProc",
+                      "XQuery",
+                      "XS",
+                      "XSLT",
+                      "Xojo",
+                      "Xonsh",
+                      "Xtend",
+                      "YAML",
+                      "YANG",
+                      "YARA",
+                      "YASnippet",
+                      "Yacc",
+                      "ZAP",
+                      "ZIL",
+                      "Zeek",
+                      "ZenScript",
+                      "Zephir",
+                      "Zig",
+                      "Zimpl",
+                      "abl",
+                      "abuild",
+                      "acfm",
+                      "aconf",
+                      "actionscript 3",
+                      "actionscript3",
+                      "ada2005",
+                      "ada95",
+                      "adobe composite font metrics",
+                      "adobe multiple font metrics",
+                      "advpl",
+                      "ags",
+                      "ahk",
+                      "altium",
+                      "amfm",
+                      "amusewiki",
+                      "apache",
+                      "apkbuild",
+                      "arexx",
+                      "as3",
+                      "asm",
+                      "asp",
+                      "aspx",
+                      "aspx-vb",
+                      "ats2",
+                      "au3",
+                      "autoconf",
+                      "b3d",
+                      "bash session",
+                      "bash",
+                      "bat",
+                      "batch",
+                      "bazel",
+                      "blitz3d",
+                      "blitzplus",
+                      "bmax",
+                      "bplus",
+                      "bro",
+                      "bsdmake",
+                      "byond",
+                      "bzl",
+                      "c++-objdump",
+                      "c2hs",
+                      "cURL Config",
+                      "cake",
+                      "cakescript",
+                      "cfc",
+                      "cfm",
+                      "cfml",
+                      "chpl",
+                      "clipper",
+                      "coccinelle",
+                      "coffee",
+                      "coffee-script",
+                      "coldfusion html",
+                      "console",
+                      "cperl",
+                      "cpp",
+                      "csharp",
+                      "csound-csd",
+                      "csound-orc",
+                      "csound-sco",
+                      "cucumber",
+                      "curlrc",
+                      "cwl",
+                      "dcl",
+                      "delphi",
+                      "desktop",
+                      "dircolors",
+                      "django",
+                      "dosbatch",
+                      "dosini",
+                      "dpatch",
+                      "dtrace-script",
+                      "eC",
+                      "ecr",
+                      "editor-config",
+                      "edn",
+                      "eeschema schematic",
+                      "eex",
+                      "elisp",
+                      "emacs muse",
+                      "emacs",
+                      "email",
+                      "eml",
+                      "erb",
+                      "fb",
+                      "fish",
+                      "flex",
+                      "foxpro",
+                      "fsharp",
+                      "fstar",
+                      "ftl",
+                      "fundamental",
+                      "gf",
+                      "git-ignore",
+                      "gitattributes",
+                      "gitconfig",
+                      "gitignore",
+                      "gitmodules",
+                      "go mod",
+                      "go sum",
+                      "go.mod",
+                      "go.sum",
+                      "golang",
+                      "groff",
+                      "gsp",
+                      "hbs",
+                      "heex",
+                      "help",
+                      "html+django",
+                      "html+jinja",
+                      "html+ruby",
+                      "htmlbars",
+                      "htmldjango",
+                      "hylang",
+                      "i7",
+                      "ignore",
+                      "igor",
+                      "igorpro",
+                      "ijm",
+                      "inc",
+                      "inform7",
+                      "inputrc",
+                      "irc logs",
+                      "irc",
+                      "java server page",
+                      "jq",
+                      "jruby",
+                      "js",
+                      "jsonc",
+                      "jsp",
+                      "kak",
+                      "kakscript",
+                      "keyvalues",
+                      "ksy",
+                      "lassoscript",
+                      "latex",
+                      "leex",
+                      "lhaskell",
+                      "lhs",
+                      "lisp",
+                      "litcoffee",
+                      "live-script",
+                      "ls",
+                      "m2",
+                      "m68k",
+                      "mIRC Script",
+                      "macruby",
+                      "mail",
+                      "make",
+                      "man page",
+                      "man",
+                      "man-page",
+                      "manpage",
+                      "markojs",
+                      "max/msp",
+                      "maxmsp",
+                      "mbox",
+                      "mcfunction",
+                      "mdoc",
+                      "mediawiki",
+                      "mf",
+                      "mma",
+                      "mumps",
+                      "mupad",
+                      "nanorc",
+                      "nasm",
+                      "ne-on",
+                      "nesC",
+                      "nette object notation",
+                      "nginx configuration file",
+                      "nixos",
+                      "njk",
+                      "node",
+                      "npmrc",
+                      "nroff",
+                      "nush",
+                      "nvim",
+                      "obj-c",
+                      "obj-c++",
+                      "obj-j",
+                      "objc",
+                      "objc++",
+                      "objectivec",
+                      "objectivec++",
+                      "objectivej",
+                      "objectpascal",
+                      "objj",
+                      "octave",
+                      "odin-lang",
+                      "odinlang",
+                      "oncrpc",
+                      "ooc",
+                      "openedge",
+                      "openrc",
+                      "osascript",
+                      "pandoc",
+                      "pasm",
+                      "pcbnew",
+                      "perl-6",
+                      "perl6",
+                      "pir",
+                      "plain text",
+                      "posh",
+                      "postscr",
+                      "pot",
+                      "pov-ray",
+                      "povray",
+                      "progress",
+                      "protobuf",
+                      "pwsh",
+                      "pycon",
+                      "pyrex",
+                      "python3",
+                      "q",
+                      "ql",
+                      "qsharp",
+                      "ragel-rb",
+                      "ragel-ruby",
+                      "rake",
+                      "raw",
+                      "razor",
+                      "rb",
+                      "rbx",
+                      "reStructuredText",
+                      "readline",
+                      "red/system",
+                      "redirects",
+                      "regex",
+                      "regexp",
+                      "renpy",
+                      "rhtml",
+                      "robots txt",
+                      "robots",
+                      "robots.txt",
+                      "rpcgen",
+                      "rs",
+                      "rs-274x",
+                      "rss",
+                      "rst",
+                      "rusthon",
+                      "salt",
+                      "saltstate",
+                      "sed",
+                      "sepolicy",
+                      "sh",
+                      "shell-script",
+                      "shellcheckrc",
+                      "sml",
+                      "snippet",
+                      "sourcemod",
+                      "soy",
+                      "specfile",
+                      "splus",
+                      "squeak",
+                      "terraform",
+                      "tl",
+                      "tm-properties",
+                      "troff",
+                      "ts",
+                      "udiff",
+                      "vb .net",
+                      "vb.net",
+                      "vb6",
+                      "vbnet",
+                      "vdf",
+                      "vim",
+                      "vimhelp",
+                      "viml",
+                      "visual basic 6",
+                      "visual basic for applications",
+                      "visual basic",
+                      "vlang",
+                      "wasm",
+                      "wast",
+                      "wdl",
+                      "wgetrc",
+                      "wiki",
+                      "winbatch",
+                      "wisp",
+                      "wl",
+                      "wolfram lang",
+                      "wolfram language",
+                      "wolfram",
+                      "wsdl",
+                      "xBase",
+                      "xbm",
+                      "xdr",
+                      "xhtml",
+                      "xml+genshi",
+                      "xml+kid",
+                      "xpm",
+                      "xsd",
+                      "xsl",
+                      "xten",
+                      "yas",
+                      "yml",
+                      "zsh"
+                    ]
+                  }
+                },
+                "additionalProperties": false
+              },
+              "validations": {
+                "$ref": "#/definitions/validations",
+                "title": "textarea validations",
+                "description": "Textarea validations\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#validations"
+              }
+            },
+            "additionalProperties": false
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "type": {
+                "const": "input"
+              }
+            }
+          },
+          "then": {
+            "$comment": "For `additionalProperties` to work `type` must also be present here.",
+            "title": "input",
+            "description": "Input\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#input",
+            "type": "object",
+            "required": ["type", "attributes"],
+            "properties": {
+              "type": {
+                "$ref": "#/definitions/type"
+              },
+              "id": {
+                "$ref": "#/definitions/id",
+                "description": "An input id\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#keys"
+              },
+              "attributes": {
+                "title": "input attributes",
+                "description": "Input attributes\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#attributes-2",
+                "type": "object",
+                "required": ["label"],
+                "properties": {
+                  "label": {
+                    "$ref": "#/definitions/label",
+                    "description": "A short input description\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#attributes-2"
+                  },
+                  "description": {
+                    "$ref": "#/definitions/description",
+                    "description": "A long input description\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#attributes-2"
+                  },
+                  "placeholder": {
+                    "$ref": "#/definitions/placeholder",
+                    "description": "An input placeholder\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#attributes-2"
+                  },
+                  "value": {
+                    "$ref": "#/definitions/value",
+                    "description": "An input value\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#attributes-2"
+                  }
+                },
+                "additionalProperties": false
+              },
+              "validations": {
+                "$ref": "#/definitions/validations",
+                "title": "input validations",
+                "description": "Input validations\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#validations-1"
+              }
+            },
+            "additionalProperties": false
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "type": {
+                "const": "dropdown"
+              }
+            }
+          },
+          "then": {
+            "$comment": "For `additionalProperties` to work `type` must also be present here.",
+            "title": "dropdown",
+            "description": "dropdown\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#dropdown",
+            "type": "object",
+            "required": ["type", "attributes"],
+            "properties": {
+              "type": {
+                "$ref": "#/definitions/type"
+              },
+              "id": {
+                "$ref": "#/definitions/id",
+                "description": "A dropdown id\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#keys"
+              },
+              "attributes": {
+                "title": "dropdown attributes",
+                "description": "Dropdown attributes\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#attributes-3",
+                "type": "object",
+                "required": ["label", "options"],
+                "properties": {
+                  "label": {
+                    "$ref": "#/definitions/label",
+                    "description": "A short dropdown description\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#attributes-3"
+                  },
+                  "description": {
+                    "$ref": "#/definitions/description",
+                    "description": "A long dropdown description\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#attributes-3"
+                  },
+                  "multiple": {
+                    "description": "Specify whether allow a multiple choices\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#attributes-3",
+                    "type": "boolean",
+                    "default": false
+                  },
+                  "options": {
+                    "description": "Dropdown choices\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#attributes-3",
+                    "type": "array",
+                    "minItems": 1,
+                    "uniqueItems": true,
+                    "items": {
+                      "type": "string",
+                      "minLength": 1,
+                      "examples": ["Sample choice"]
+                    }
+                  },
+                  "default": {
+                    "description": "Index of the default option\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#attributes-3",
+                    "type": "integer",
+                    "examples": [0]
+                  }
+                },
+                "additionalProperties": false
+              },
+              "validations": {
+                "$ref": "#/definitions/validations",
+                "title": "dropdown validations",
+                "description": "Dropdown validations\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#validations-2"
+              }
+            },
+            "additionalProperties": false
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "type": {
+                "const": "checkboxes"
+              }
+            }
+          },
+          "then": {
+            "$comment": "For `additionalProperties` to work `type` must also be present here.",
+            "title": "checkboxes",
+            "description": "Checkboxes\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#checkboxes",
+            "type": "object",
+            "required": ["type", "attributes"],
+            "properties": {
+              "type": {
+                "$ref": "#/definitions/type"
+              },
+              "id": {
+                "$ref": "#/definitions/id",
+                "description": "Checkbox list id\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#keys"
+              },
+              "attributes": {
+                "title": "checkbox list attributes",
+                "description": "Checkbox list attributes\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#attributes-4",
+                "type": "object",
+                "required": ["label", "options"],
+                "properties": {
+                  "label": {
+                    "$ref": "#/definitions/label",
+                    "description": "A short checkbox list description\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#attributes-4"
+                  },
+                  "description": {
+                    "$ref": "#/definitions/description",
+                    "description": "A long checkbox list description\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#attributes-4"
+                  },
+                  "options": {
+                    "description": "Checkbox list choices\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#attributes-4",
+                    "type": "array",
+                    "minItems": 1,
+                    "items": {
+                      "title": "checkbox list choice",
+                      "description": "Checkbox list choice\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#attributes-4",
+                      "type": "object",
+                      "required": ["label"],
+                      "properties": {
+                        "label": {
+                          "description": "A short checkbox list choice description\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#attributes-4",
+                          "type": "string",
+                          "minLength": 1,
+                          "examples": ["Sample label"]
+                        },
+                        "required": {
+                          "description": "Specify whether a choice is required\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-githubs-form-schema#attributes-4",
+                          "type": "boolean",
+                          "default": false
+                        }
+                      },
+                      "additionalProperties": false
+                    }
+                  }
+                },
+                "additionalProperties": false
+              }
+            },
+            "additionalProperties": false
+          }
+        }
+      ]
+    }
+  },
+  "properties": {
+    "name": {
+      "description": "An issue template name\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-issue-forms#top-level-syntax",
+      "type": "string",
+      "minLength": 1,
+      "examples": ["Sample name"]
+    },
+    "description": {
+      "description": "An issue template description\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-issue-forms#top-level-syntax",
+      "type": "string",
+      "minLength": 1,
+      "examples": ["Sample description"]
+    },
+    "body": {
+      "description": "An issue template body\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-issue-forms#top-level-syntax",
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "$ref": "#/definitions/form_item"
+      }
+    },
+    "assignees": {
+      "description": "An issue template assignees\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-issue-forms#top-level-syntax",
+      "oneOf": [
+        {
+          "$ref": "#/definitions/assignee"
+        },
+        {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/definitions/assignee"
+          }
+        }
+      ]
+    },
+    "labels": {
+      "description": "An issue template labels\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-issue-forms#top-level-syntax",
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "examples": [
+          "Sample label",
+          "bug",
+          "documentation",
+          "duplicate",
+          "enhancement",
+          "good first issue",
+          "help wanted",
+          "invalid",
+          "question",
+          "wontfix"
+        ]
+      }
+    },
+    "title": {
+      "description": "An issue template title\nhttps://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-issue-forms#top-level-syntax",
+      "type": "string",
+      "minLength": 1,
+      "examples": ["Sample title", "Bug: ", "Feature: "]
+    }
+  },
+  "required": ["name", "description", "body"],
+  "title": "GitHub issue forms config file schema",
+  "type": "object"
+}
diff --git a/ci/schemas/pull-request-labeler-5.json b/ci/schemas/pull-request-labeler-5.json
new file mode 100644
index 000000000000..22ad7955814f
--- /dev/null
+++ b/ci/schemas/pull-request-labeler-5.json
@@ -0,0 +1,95 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://json.schemastore.org/pull-request-labeler-5.json",
+  "$comment": "https://github.com/actions/labeler",
+  "$defs": {
+    "stringOrStringArray": {
+      "oneOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      ]
+    },
+    "match": {
+      "title": "Match",
+      "type": "object",
+      "properties": {
+        "changed-files": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "any-glob-to-any-file": { "$ref": "#/$defs/stringOrStringArray" },
+              "any-glob-to-all-files": {
+                "$ref": "#/$defs/stringOrStringArray"
+              },
+              "all-globs-to-any-file": {
+                "$ref": "#/$defs/stringOrStringArray"
+              },
+              "all-globs-to-all-files": {
+                "$ref": "#/$defs/stringOrStringArray"
+              }
+            },
+            "oneOf": [
+              { "required": ["any-glob-to-any-file"] },
+              { "required": ["any-glob-to-all-files"] },
+              { "required": ["all-globs-to-any-file"] },
+              { "required": ["all-globs-to-all-files"] }
+            ],
+            "additionalProperties": false
+          }
+        },
+        "base-branch": { "$ref": "#/$defs/stringOrStringArray" },
+        "head-branch": { "$ref": "#/$defs/stringOrStringArray" }
+      },
+      "oneOf": [
+        { "required": ["changed-files"] },
+        { "required": ["base-branch"] },
+        { "required": ["head-branch"] }
+      ],
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": {
+    "title": "Label",
+    "type": "array",
+    "items": {
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "all": {
+              "title": "All",
+              "type": "array",
+              "items": { "$ref": "#/$defs/match" }
+            }
+          },
+          "additionalProperties": false,
+          "required": ["all"]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "any": {
+              "title": "Any",
+              "type": "array",
+              "items": { "$ref": "#/$defs/match" }
+            }
+          },
+          "additionalProperties": false,
+          "required": ["any"]
+        },
+        { "$ref": "#/$defs/match" }
+      ]
+    }
+  },
+  "description": "A GitHub Action for automatically labelling pull requests.",
+  "title": "Pull Request Labeler",
+  "type": "object"
+}
diff --git a/ci/schemas/vendor_schemas.py b/ci/schemas/vendor_schemas.py
new file mode 100644
index 000000000000..a40e262e69f7
--- /dev/null
+++ b/ci/schemas/vendor_schemas.py
@@ -0,0 +1,50 @@
+#!/usr/bin/env python3
+"""
+Download YAML Schemas for linting and validation.
+
+Since pre-commit CI doesn't have Internet access, we need to bundle these files
+in the repo.
+"""
+
+import os
+import pathlib
+import urllib.request
+
+
+HERE = pathlib.Path(__file__).parent
+SCHEMAS = [
+    'https://json.schemastore.org/appveyor.json',
+    'https://json.schemastore.org/circleciconfig.json',
+    'https://json.schemastore.org/github-funding.json',
+    'https://json.schemastore.org/github-issue-config.json',
+    'https://json.schemastore.org/github-issue-forms.json',
+    'https://json.schemastore.org/codecov.json',
+    'https://json.schemastore.org/pull-request-labeler-5.json',
+    'https://github.com/microsoft/vscode-python/raw/'
+        'main/schemas/conda-environment.json',
+]
+
+
+def print_progress(block_count, block_size, total_size):
+    size = block_count * block_size
+    if total_size != -1:
+        size = min(size, total_size)
+        width = 50
+        percent = size / total_size * 100
+        filled = int(percent // (100 // width))
+        percent_str = '\N{Full Block}' * filled + '\N{Light Shade}' * (width - filled)
+    print(f'{percent_str} {size:6d} / {total_size:6d}', end='\r')
+
+
+# First clean up existing files.
+for json in HERE.glob('*.json'):
+    os.remove(json)
+
+for schema in SCHEMAS:
+    path = HERE / schema.rsplit('/', 1)[-1]
+    print(f'Downloading {schema} to {path}')
+    urllib.request.urlretrieve(schema, filename=path, reporthook=print_progress)
+    print()
+    # This seems weird, but it normalizes line endings to the current platform,
+    # so that Git doesn't complain about it.
+    path.write_text(path.read_text())

From c1b51aa1189dc085a83b7ed693348a65827ddfdb Mon Sep 17 00:00:00 2001
From: Zach Champion <zchampion2020@my.fit.edu>
Date: Wed, 15 Feb 2023 10:03:13 -0500
Subject: [PATCH 0753/1120] Allow passing a transformation to
 secondary_[xy]axis

Add transform argument to secondary axes

Update _secax_docstring

Move new params to end of functions

Add input check to secondary axes

Add tests

Add examples

Move transform type checks and improve docs

Add type stubs

Update _secax_docstring

Move new params to end of functions

Add input check to secondary axes

Move transform type checks and improve docs

Fix rebase error

Fix stub for SecondaryAxis.__init__

Clarify example

Add default param to secax constructor

Fix stub for secax constructor

Simplify imports

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>

Remove redundancy in docs

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>

Fix typo
---
 .../secondary_axis.py                         |  19 +++++++
 lib/matplotlib/axes/_axes.py                  |  52 +++++++++++++-----
 lib/matplotlib/axes/_axes.pyi                 |   2 +
 lib/matplotlib/axes/_secondary_axes.py        |  43 +++++++++++++--
 lib/matplotlib/axes/_secondary_axes.pyi       |   5 +-
 .../test_axes/secondary_xy.png                | Bin 52572 -> 55748 bytes
 lib/matplotlib/tests/test_axes.py             |   3 +
 7 files changed, 103 insertions(+), 21 deletions(-)

diff --git a/galleries/examples/subplots_axes_and_figures/secondary_axis.py b/galleries/examples/subplots_axes_and_figures/secondary_axis.py
index 27c64247a56f..8ae40ce48c84 100644
--- a/galleries/examples/subplots_axes_and_figures/secondary_axis.py
+++ b/galleries/examples/subplots_axes_and_figures/secondary_axis.py
@@ -40,6 +40,25 @@ def rad2deg(x):
 secax.set_xlabel('angle [rad]')
 plt.show()
 
+# %%
+# By default, the secondary axis is drawn in the Axes coordinate space.
+# We can also provide a custom transform to place it in a different
+# coordinate space. Here we put the axis at Y = 0 in data coordinates.
+
+fig, ax = plt.subplots(layout='constrained')
+x = np.arange(0, 10)
+np.random.seed(19680801)
+y = np.random.randn(len(x))
+ax.plot(x, y)
+ax.set_xlabel('X')
+ax.set_ylabel('Y')
+ax.set_title('Random data')
+
+# Pass ax.transData as a transform to place the axis relative to our data
+secax = ax.secondary_xaxis(0, transform=ax.transData)
+secax.set_xlabel('Axis at Y = 0')
+plt.show()
+
 # %%
 # Here is the case of converting from wavenumber to wavelength in a
 # log-log scale.
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 55f1d31740e2..f1b83c409ac8 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -551,7 +551,7 @@ def indicate_inset_zoom(self, inset_ax, **kwargs):
         return self.indicate_inset(rect, inset_ax, **kwargs)
 
     @_docstring.dedent_interpd
-    def secondary_xaxis(self, location, *, functions=None, **kwargs):
+    def secondary_xaxis(self, location, *, functions=None, transform=None, **kwargs):
         """
         Add a second x-axis to this `~.axes.Axes`.
 
@@ -582,18 +582,30 @@ def invert(x):
             secax = ax.secondary_xaxis('top', functions=(invert, invert))
             secax.set_xlabel('Period [s]')
             plt.show()
+
+        To add a secondary axis relative to your data, you can pass a transform
+        to the new axis.
+
+        .. plot::
+
+            fig, ax = plt.subplots()
+            ax.plot(range(0, 5), range(-1, 4))
+
+            # Pass 'ax.transData' as a transform to place the axis
+            # relative to your data at y=0
+            secax = ax.secondary_xaxis(0, transform=ax.transData)
         """
-        if location in ['top', 'bottom'] or isinstance(location, Real):
-            secondary_ax = SecondaryAxis(self, 'x', location, functions,
-                                         **kwargs)
-            self.add_child_axes(secondary_ax)
-            return secondary_ax
-        else:
+        if not (location in ['top', 'bottom'] or isinstance(location, Real)):
             raise ValueError('secondary_xaxis location must be either '
                              'a float or "top"/"bottom"')
 
+        secondary_ax = SecondaryAxis(self, 'x', location, functions,
+                                     transform, **kwargs)
+        self.add_child_axes(secondary_ax)
+        return secondary_ax
+
     @_docstring.dedent_interpd
-    def secondary_yaxis(self, location, *, functions=None, **kwargs):
+    def secondary_yaxis(self, location, *, functions=None, transform=None, **kwargs):
         """
         Add a second y-axis to this `~.axes.Axes`.
 
@@ -614,16 +626,28 @@ def secondary_yaxis(self, location, *, functions=None, **kwargs):
             secax = ax.secondary_yaxis('right', functions=(np.deg2rad,
                                                            np.rad2deg))
             secax.set_ylabel('radians')
+
+        To add a secondary axis relative to your data, you can pass a transform
+        to the new axis.
+
+        .. plot::
+
+            fig, ax = plt.subplots()
+            ax.plot(range(0, 5), range(-1, 4))
+
+            # Pass 'ax.transData' as a transform to place the axis
+            # relative to your data at x=3
+            secax = ax.secondary_yaxis(3, transform=ax.transData)
         """
-        if location in ['left', 'right'] or isinstance(location, Real):
-            secondary_ax = SecondaryAxis(self, 'y', location,
-                                         functions, **kwargs)
-            self.add_child_axes(secondary_ax)
-            return secondary_ax
-        else:
+        if not (location in ['left', 'right'] or isinstance(location, Real)):
             raise ValueError('secondary_yaxis location must be either '
                              'a float or "left"/"right"')
 
+        secondary_ax = SecondaryAxis(self, 'y', location, functions,
+                                     transform, **kwargs)
+        self.add_child_axes(secondary_ax)
+        return secondary_ax
+
     @_docstring.dedent_interpd
     def text(self, x, y, s, fontdict=None, **kwargs):
         """
diff --git a/lib/matplotlib/axes/_axes.pyi b/lib/matplotlib/axes/_axes.pyi
index 501cb933037a..c232465d48c4 100644
--- a/lib/matplotlib/axes/_axes.pyi
+++ b/lib/matplotlib/axes/_axes.pyi
@@ -94,6 +94,7 @@ class Axes(_AxesBase):
         ]
         | Transform
         | None = ...,
+        transform: Transform | None = ...,
         **kwargs
     ) -> SecondaryAxis: ...
     def secondary_yaxis(
@@ -105,6 +106,7 @@ class Axes(_AxesBase):
         ]
         | Transform
         | None = ...,
+        transform: Transform | None = ...,
         **kwargs
     ) -> SecondaryAxis: ...
     def text(
diff --git a/lib/matplotlib/axes/_secondary_axes.py b/lib/matplotlib/axes/_secondary_axes.py
index 81333a8a201c..e6f74a6f23af 100644
--- a/lib/matplotlib/axes/_secondary_axes.py
+++ b/lib/matplotlib/axes/_secondary_axes.py
@@ -2,7 +2,7 @@
 
 import numpy as np
 
-from matplotlib import _api, _docstring
+from matplotlib import _api, _docstring, transforms
 import matplotlib.ticker as mticker
 from matplotlib.axes._base import _AxesBase, _TransformedBoundsLocator
 from matplotlib.axis import Axis
@@ -14,7 +14,8 @@ class SecondaryAxis(_AxesBase):
     General class to hold a Secondary_X/Yaxis.
     """
 
-    def __init__(self, parent, orientation, location, functions, **kwargs):
+    def __init__(self, parent, orientation, location, functions, transform=None,
+                 **kwargs):
         """
         See `.secondary_xaxis` and `.secondary_yaxis` for the doc string.
         While there is no need for this to be private, it should really be
@@ -39,7 +40,7 @@ def __init__(self, parent, orientation, location, functions, **kwargs):
         self._parentscale = None
         # this gets positioned w/o constrained_layout so exclude:
 
-        self.set_location(location)
+        self.set_location(location, transform)
         self.set_functions(functions)
 
         # styling:
@@ -74,7 +75,7 @@ def set_alignment(self, align):
         self._axis.set_ticks_position(align)
         self._axis.set_label_position(align)
 
-    def set_location(self, location):
+    def set_location(self, location, transform=None):
         """
         Set the vertical or horizontal location of the axes in
         parent-normalized coordinates.
@@ -87,8 +88,17 @@ def set_location(self, location):
             orientation='y'. A float indicates the relative position on the
             parent Axes to put the new Axes, 0.0 being the bottom (or left)
             and 1.0 being the top (or right).
+
+        transform : `.Transform`, optional
+            Transform for the location to use. Defaults to
+            the parent's ``transAxes``, so locations are normally relative to
+            the parent axes.
+
+            .. versionadded:: 3.9
         """
 
+        _api.check_isinstance((transforms.Transform, None), transform=transform)
+
         # This puts the rectangle into figure-relative coordinates.
         if isinstance(location, str):
             _api.check_in_list(self._locstrings, location=location)
@@ -106,15 +116,28 @@ def set_location(self, location):
             # An x-secondary axes is like an inset axes from x = 0 to x = 1 and
             # from y = pos to y = pos + eps, in the parent's transAxes coords.
             bounds = [0, self._pos, 1., 1e-10]
+
+            # If a transformation is provided, use its y component rather than
+            # the parent's transAxes. This can be used to place axes in the data
+            # coords, for instance.
+            if transform is not None:
+                transform = transforms.blended_transform_factory(
+                    self._parent.transAxes, transform)
         else:  # 'y'
             bounds = [self._pos, 0, 1e-10, 1]
+            if transform is not None:
+                transform = transforms.blended_transform_factory(
+                    transform, self._parent.transAxes)  # Use provided x axis
+
+        # If no transform is provided, use the parent's transAxes
+        if transform is None:
+            transform = self._parent.transAxes
 
         # this locator lets the axes move in the parent axes coordinates.
         # so it never needs to know where the parent is explicitly in
         # figure coordinates.
         # it gets called in ax.apply_aspect() (of all places)
-        self.set_axes_locator(
-            _TransformedBoundsLocator(bounds, self._parent.transAxes))
+        self.set_axes_locator(_TransformedBoundsLocator(bounds, transform))
 
     def apply_aspect(self, position=None):
         # docstring inherited.
@@ -278,6 +301,14 @@ def set_color(self, color):
     See :doc:`/gallery/subplots_axes_and_figures/secondary_axis`
     for examples of making these conversions.
 
+transform : `.Transform`, optional
+    If specified, *location* will be
+    placed relative to this transform (in the direction of the axis)
+    rather than the parent's axis. i.e. a secondary x-axis will
+    use the provided y transform and the x transform of the parent.
+
+    .. versionadded:: 3.9
+
 Returns
 -------
 ax : axes._secondary_axes.SecondaryAxis
diff --git a/lib/matplotlib/axes/_secondary_axes.pyi b/lib/matplotlib/axes/_secondary_axes.pyi
index dcf1d2eb7723..afb429f740c4 100644
--- a/lib/matplotlib/axes/_secondary_axes.pyi
+++ b/lib/matplotlib/axes/_secondary_axes.pyi
@@ -18,13 +18,16 @@ class SecondaryAxis(_AxesBase):
             Callable[[ArrayLike], ArrayLike], Callable[[ArrayLike], ArrayLike]
         ]
         | Transform,
+        transform: Transform | None = ...,
         **kwargs
     ) -> None: ...
     def set_alignment(
         self, align: Literal["top", "bottom", "right", "left"]
     ) -> None: ...
     def set_location(
-        self, location: Literal["top", "bottom", "right", "left"] | float
+        self,
+        location: Literal["top", "bottom", "right", "left"] | float,
+        transform: Transform | None = ...
     ) -> None: ...
     def set_ticks(
         self,
diff --git a/lib/matplotlib/tests/baseline_images/test_axes/secondary_xy.png b/lib/matplotlib/tests/baseline_images/test_axes/secondary_xy.png
index b69241a06bc68f3e03383825a45aca1a606b201a..8398034d189107c69c9b2faf257b0625e4c895dd 100644
GIT binary patch
literal 55748
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

literal 52572
zcmc$`by!zh*Dm}+6p%)w1q1^{x};G+kPrmvPLYz9F6kDL5)csqX^=*c4n<N*q)|Gh
z`x^`Pv!CaE&wjsi{yK;2+HNm(t~J-3V~)7*d(5DRa*}x1l-MW~3Qy|3xFQOLK8r%3
zZD3)*pXA-ZWQPB#*xysLe`NL8-cjGy81+Ek-rB;--on)2@-t&wJ5#HtoGg4SY%E5`
z&v>}lZ<%m$b8tO2GB7gKXEEYn<KSdxXX9eJ{KVeg+K!)<)$;GrELOHAthrNWcJPMt
z*7w!n{{;HTe`p^>GE7mZZ#h!pca@wH7e}16lzty!u6E+Kq0XRxy!q+*jdHJBd8$Rq
zxr;6&cDEIzt5un;LPjbpj8s%u%JQb4vczc|F@7hN%1@ub#-<Pc!1kQOtF;5g*||bs
zi+%4IFK5Hdq01WPOd{X9`x`#aPPb_b4mw{H(dmzrG>Ze8_~}ohm)z-Zj0nlQf&x!|
zaJ?#e&vBJbP8w)cIT5k2u&l1FMOG&A%gD=1y12NcnPU5$(f;%-`op{C$fzivE0W=F
z-@iXgE$~cydwGN|>dSkU?EcBADFsEvKehG@3=GBQ19H!UDdkeT#|H}yA7=N#^X?uW
z9fr+w?-s#Z4z_+;mAmirxNOe*d3m8SWwN-VrTs!fad-Cj8|vy(da8PQ6vgk|qhnye
zOi4*uU0;t%Z`H`kV;04_%D^zSJo0IFsN~i~Y(K7h{dEmPso&?UmxuYZs$EE=(=Nb(
zCnJ?5_I?+Lh$80*uRrcc<U8YqML-Z+`O3w4CdtuPi-jy#qon8f+_`g7+A2Pa!xfJP
zhlYZAEQbQe$My6L4X<pijIlbXJM`pgmPzMJWvk?#MX@_BYh}u0$KF!S!?LonnwXfN
z^T(%VyhKfXFJGrx{OQxY-n2e-QPJlxTVi2hVT18nZ_$*8foU?a(%LFvrB-7sTH4y@
zP-u4+f0pI<9KhESk(1x3s;+K&d)LP|EiFy0=y4cVQ~%ra(yH|if%?%=9TAb6H>F;S
znrBvS4OiGn7F+&QQPa=}X3?(1a&&Y|QDSUT)pft7T?ZR##34IRxJ}F;H~!PA=3eI;
zp){7XyBK(szR#bZIUH*WAxmS)95pa7U~~Rs<hELeS?;hvYG7y>86O{Xbht00t&x-{
z;`zD9{7)Ne4GMK#Htw>G@#Z@0Q^S`p=Lhn%#gvpTULYp6Ioxx|(W%y$@0n+!r$6K2
z;c;JDy1vk`#d^FJt!lGhlh<xKv^Pz;t)&GMR!ZE$!XkQI*L8{e#zpL_*RM~`cBc*&
z=%Y_}B!%?$_D(YwlbV^yfDsisEU360ZVt3-stG9%&{SxJUz3R$hm8&l2@x|hW2~>Q
zhnfFkjQB`LPfwqP6Lo%;G7JMYVQ1sJyuP{lEeF1hPrut@Q$3H5;<(LYJYI)|;lbWq
z%gLI6ef8}~5=eDi8C8r`WW8-QD*oij4JKx0G*n(*-fV9saZgXr)x4ai!66|wla1%U
z#j&H4l9HmlQp5u2+1LnwmRd%YSI*;I;w7AF4$J;iu=(*L$KuE*vLcgC|B@1Jl-^`x
zkhQ&iBTP5pQ!l0R04a)`&-UsY*JVD~veNil*~#-msY;AQG&Fgh+TXr?BP1g7uCEsb
zTfXg>iEN&M?De;-8pT*6l@1MoL|5Lkq}Ao=R0o?RyOSEWgf|6~+<M#n<UQ;lKCN&l
zotXdl;r3X|>O=z^Z}0CJ@-kq>7s<#BVV~l7EMNDg^=hiAk%JLOynlZcRok5^Nkl~z
z!fx1nUrT-DRZNU%#`ihTC*>_YJr`y=lA=Cj`OC=3N$Bg-iHeGDd^h5tc<$q4b9CT5
zhn>pU)ZAPT|8D7LS#0G+SbGlJ>qK3K1_lNC4H&6{g4-V8F35%5c)`}r%FD|$see3+
zj)^a>t{xBPAzm&+OhN*qKS$k1*Yl7hRU%AOU7ccYdnE#V$bD^{YIoT48;p$g@1>&P
zqerK|#ruFU(O<rdQc+QH+US-nH0xu;rRG-xgA>nGsvjGp-QQaJF8|4GmxD#8DsXYp
z;`}Z1IM<Rf&-X#8si_KOZ5K0@7^`-t6Pz~tR5xAw5EnP!Hk&`GqoWgU`aON3dVAC-
zAt9mnH`n0ekD^<LB8JVlXE8BhovGva9kRIYaeEP->FDU#0pq8OZDV)evo|s})?b@!
zBIhs)?ET%>mi{1t&7cvhyuAFrwsf`o!CK2;rNgaK%b)&l-(J2X@C?^(ro->kCjoyv
zs_PEU4j*lQONY`3Q8GqjFAbG6IF7joY%Tp<AaK4dVe8yvl_44^{oRjn&-rR~P7agc
z?yo3vUhB)G%o<l6_z>GT6MB>|>Wz;1A}%hlyqx!2!fk@}>Gp=cY*iv^>M-Z^>6GGP
zrTGg~?;mBz%??)-DbVyY#<oq&&j))P?kQuF_+a4GgA=-%lXLWRxZJxTfPiXqVo4N>
zNvoXD>htdP>vD;KG(s+V%fl7q0?(LYShN{o(me2ijZIAxa~aA00Rfo!mw3IvQ>RuR
zQlkzd!YC*xqSH-`jN%#zBGWH}myQrQ;ssY$Xg<Ia7auRB4ZfEs9+f)gv;6zF-_1wq
zO8oMg8Q<?__q}`n{+GAV!)A%>zDZbxCw*DbV6HOB!tO8P<JC=HYvlSD6%~n-aDR(o
z)*PRner)d=e=M8bCz{$VXq{|^iHUiUghc9*68i4`zTs$<Gl~(PK*Vi_O?YqiifM=$
zN>^8xS3uwjKR+cp1}^HM4c)i6IPy@c+j5ihH*Vi1lNVe&d+E}p0;{pln0elJV11Qz
zC1|@oIj)44m=CDDj){xI^7K5$OsDec6gj@s;E(5%k-^Yw#y#q?!2F@l4E7Q6ea2v@
z$Ps_{?%nEaY6QKoFipa3t7dT0X)L)NzJ!Axjd89&czxE+ZpwWjE+N6N)(cIo+J*a#
z%lu7n38ZUlYlENN1z_oKz*>`%kzrC%QSI#Q(ev?96g_T#4lAB68&B_G+Q-Pm<SU)l
zbA01vOpJeHqc|@gUtLqvIq-aHC1xbep%mz>tgOhPv#q$KudjbW_2}*EA={Y_YMAW%
z_wOO&(f;KB=Z`J&R_QdwuRYmH+O8Ismh2XTY`=c}(rbUsy~l&*RaSNzT=jd#1UN0S
z-mh-!TQT}z5|F}c6k`=w>FDUrc)j>ybjE9SbCU!PU{qxe#_qTefv;!^Aw0F!hyyt$
zDTt5C?!c$!zlsW!iDi+}miD>Ezz_lf2B$)cMWgH~vk^x;Ip^ch8#ives4V8+KUnYd
z(_$H@F~K09VNz67gy9mH1T+^>G&>0pjtE5qAzNTK>%9S=MhE-mo1LA#vpbV~Ew9py
zyTo|+&u`_9u`1`HVm}dahouVpImPI86#3$U7;J2_*md7XTJ)#SIXF3O_O~p-EU4Pu
zeav4bCr7+`brDwkkMJhORZdP~vl2>h4h3c4;SycizI>@`Pq_VHUdT?~#f9J2*0w7}
z43kFs0df{6|08AU)@@2U$({mRFS5NQKFzc!P#E^$B#|HV+P^a`)PD?<I%gjy;p2xx
z1{MwO!>5qhKgg0@E4`Pdw23WVQ4=27$`;>i+5hLypSMbkkqHUrz1#K}gQQ|jrQ|G+
z%m{uO#K~qdBeRK<H6!3ZeQ#u;!5xOv_i~`76@@EQvYVoBsp^@V<HXDMk8l2-nL$TE
zn0pZ$J21W}1#gtK2$|qW+bUr8&n)~&?|bL&U9>Z2&geaU4F8&&G)XRCW5a&%#}DqW
zgR;uRqL)QPk`IR)2Rqw+4u=H?J0Hkre4psg)qEM={_>5F$6U{~vye<}Zosr&%G|$y
zM^Eo<ukq|il`}D{tYYk4aq+7ZH(MS{ZNDu8L%eej6CN$4j!i_QQ1rF4Q}W@%7amMp
z7q^=YqotcdCb(0ossx>!oePr_$oDIp3z8Es_bcWgMWVZL1FN*O^kv^=(>t+kx8%IH
zS69a+B*ev;zg9Q=S_$*>pB&YX+S=N>l#qb-_ekUc9o2>EUms!NE@+~iu9yN&(?9JG
z3jJRzil+DP6~&!}4?})1ywLu&>8StnP5+OFvgMni{cmzz^DKS{TC<Lq5~z|1&p=p0
z5}-=^x#urlyr86o*g~yU<3auO>C@GX4U0Yc2eP7~XD(d0pr^0z{YJ=DxGP{d=7Fx5
zNE;ZC^=ud2tLW&7NJ$#+>}+#R<)>P_kGUcOHjCsk8Y=8&tT*SCZ$wM``uo3gSm-Cv
zjdTixK#!xUs)}|8MF<Byn@i-%6|u7z7}${WvOnp%tZ!<16T<m=L7(!?+qYFwgcTJP
z4lb7<)h^8LByTOOFnz*Bxz<Q5j|FuAyZ!7#eM?Jb@RsXczo#ZA#o>{g`3(oV>k9{o
z%!SFvIVPQN>c4%HwO<@m*xB7ZFC!zfHW5HOKXbdel<Dk#MMZB(GSyTO6AzC{d1YlV
zq;VlS)h_2XH8t11%ZqTUMB%=?csShiL5UIV&IhF|4UzOpkI!~9;ZJ^+<`xteU(~L&
zCt6-!7R^)&&i}kOpR(XOOScT!xmtzoHAsK66OV_?^Y5lSyv)u{BpE@|1R<LZ68-n-
z>HX7~7;vDnu7tNgFx;H)<8@rV1T_v335j2-WW;1qr*H%0hgn*q9Ub^qRcjcKTX#X2
zeVo_NC7Zy52R<bzD5%_JlX2AZ*uCm#Z{hy^`>0yWAHCeoChAU3yhndxYc8{};AhAu
zH|MAqu{q2uJ>h!&*vxNYDy~~FYr*7y$bpSsy?UioUH{sHsI{}xb3E1yN~P{B<y(aw
zhc1U)NpcLs!^4e#ez%z)nxlL6U8R2)lSOBExn;V!uiDiSikM;P??~MO;YD%E(8tH8
z0<)S3az`AL0c4M1rOY^W9#2^|muB`nVzfWIsiO#M4!06K;-OqYyK_m<sX#xBU9Wwl
zlUc!i>+RShWf9fi8*|^!cm+m8<lA~wvs{QxObmr=U3$jkixCIpRa3Cpo9frVK<@r@
znZ)QAF2CYHLC{oK;bG5D4Jq7CE#C~pm&LNj_Ew#c!X%Y5msyuMAF^tdqfl7*`2DO?
z^YhqH?mWFxV#K&oL_29^c<g7N+4do7a8M1(p?B{4Tgn~zYxFkCUphK4P`v#7DzBGk
zXFnvXl7vY-nk$H^s;b%(6heHBhUW%l3{Cl2O+P*lw_Vm%>w=id_n6iedC3O{Zjc!F
zSB%YPrES|e1P2GNPKK}={A!JaIW(_LwV?I7Yhny`Dt@Y|A;CU(5&K?Jzd}OiM@T@`
z)Ya>ThW1k0;yzB#n}|8GEt4J*QJ|x}&F!HSa=&EmCTj`qS9N}7Z^K4eiIHT~ZT&&j
z-h4KJMa_1vIYFhC&Ket?c-ovO)?rl^lV&L{MAYM%-@lcUGr*;r@t7aShNfY%prO+7
zEHE9@q8mw+!wl^Xd&^Gdy50cuHt7AJz{bhh03I2QYmr-DM5e8+EnD%JRkJjwW8p*l
z0&8p=ZJg&ZM|w`h-j5gVo)e@;G!#CzNwu6KL-d1>etcLUz{WPSrX6Fwbqhycc=sv>
z{-wZsA*4d~6)u~f6B4LUm#<t&?b!e`KqjeHfP!<sClW3F*Ca`ksXqsA6I?%onilFu
z%NL|U#mio|QC6NB)Di)QT~Jt<X;;&yEVD9`^(r>@3KJ7<W@hHjS_^H8l8Reh-byKM
zL2_EUVkYC}@$+*y^Ht$PRY&0Ax}I>gwzs>_p3eKByQ46*-Ls}U*~H|14d}E1ezn6n
zHl9jwvYuGe9;?gA;nR2?*f_bmB9#!VhwJReO|zi<eAdLIBuJKXlheDO5E2vn2)pkI
zZrA{*0g)p52qG?ScSg-s{oROIG!)F;%Q@oQeJzDeUY>yn+3R9Z-ZO4ep~NL6RexGJ
z^!4oTdT8X5PPIg|Kv@m`;2aql*<sb*(>Bz;y4m)&yF32*y!M5$Y*kj&hvILLr$;6w
zjeJ<q6zkJEv<Unh^q^sQtYLTd%^Njge)7kEnvW-jJ38{}+}-4#K4p31G<lwvmsfA>
zvpe{&oM*cM7#m2b2(|Oq=vyeS;$klNJw0SCknsJL1u8yzMCV)k@|w)$*ft_kQk9iS
zh#$ChSz=N<vl+o_D}4+C1|6x?SMxrcX_-!kG7xuhs00Tb4+aXb4`Oz9_Bdg8e$;r9
z<7gdnTHA2wkYWR}P4MNA(_(@ryDudb`QF2j%lPZX11Pz7Ry>bGhKIG>J*R*DvetZx
zM!Baxy}TSwbVWk1``x|Pwl*;c6r@aQUXXvj)2;DP<Y|8!HxyUMI(=Q|h=Y_L&3E%p
zV}R#E|J8}AysU*8$n$WicyRgn_|!hT@j)uMk?eTy-aX~~RsC2`5vSF+M~@dgk3Kox
ziu~t{(A*JkZ)~lf4AP?e_WVgZzcSkDXEqO!|0Zh!@_ByP^_k%Q8XUHt?o4K7f}}bs
zDhjbm`-POqE0V!=K9~!~HIBEE_K!uy#LN%fm`jpZ*f}|~KN6_ssL}a8NwieQ+Oo6D
zG#9zuZ1MweA;1tm6ny-60j&ES)Q*!qX)<A>JYw|sM5uzRO_b`l!-5NU!}2?Da#aSd
zc0Nk}nWH?=8Ox%bWlQ4~uvH=($e35~5OZ#BuJy~8y8-yrX2aT^HIVi|IQ}&~{fF=>
zJ^jm9glBGfe16_nqje6&MBaa%6@Sb8<Ba)N_7`yejZ93g2nkU`N$HcDYZ)c1DziLO
z`J@#&NeMEKHtj5Rj(`0!LQdP|TI+nG9<}$2CO4P(QtQoiwY>;ycOF_*34Fx)^`Lm>
zV7fhF_0ON@(rM2#GEAZbB_GT?B$SBQIXVV>`s8ZZD+<}$dAhU0dvhGZ0*SaNCv)-3
z=>%DONAH`xU?NCK^5u)vJjbj&_-+gE-G>LSmjilZ>R*hRe3H*z-5Vg8a5K=gV)7`R
ztFK6TVvQtL9FIk@+*TWma}IUy@p|shUG^ogV6ah!9E(}=SEdrv4nIDMEiIXVRQTtQ
zUlA`)Qs@uoh(*T_eS&rlX1P(d^(N2R98e8>5L#Y6OO&mv*=j;Z>5z|yc#2T>(%18y
z<loG&hB7rZzIZh{m?$Qi9~4phyV9B$AsFD4EtOF@?I(nwyjH!JR{H~MNr^kqko4Wm
z+m}$SN(3z-Vhn|<+SekJU0k?gsenvvxS#m;YDXE#gy1CWQlXw&1}Vv3WAtInhW44#
z#Bwy0(@MTJyKt}O&^z!g8s!gabXq14&!fD^Fw0t~<V&io@sZq70f*kVR$xr0k*p@|
z&UN&d!;)KXRvN4Up1qoe*OE6evcigndW^T$kS+hrB68vql8?S470n=qNjoj_#$(6h
z?u=WF5capp%zs2)RO}!bwKnQ4j;a;$-<yhVd2sw@t4|+U?5K?I=MNT+CyAW1=o49K
zsYAPk03Zwr4E%6UbHB!@%CmqzvD3L2UB@FwEChe%Bwvl^O_CdLcefdI&^T9tyYobr
zO=44z7asPq$0Q)%;KW(3(=41i%Sio`Y&j~e?|ju--?>FTS7KX=0s{*y34f>i+N7}D
zAzR5GuDTtplb~u3TF_S`Bn9qkMNXWKdJm&Yx6gd$S0(CD6&|DR#P}q0I;eF1;RTgT
zSy(gq!as<LXxC!P=^N^iy#2alHnEdKr?VS%6b5GnZuT33y6+?89pL!h!>WE2lTssz
zK8tcX%#@4cYm}eN!X-cw`}kM3x%lhbi7mGa=h$M~3S6`taaV>^PM41fOni42`)IvQ
z8C9FmAV4?CiaVoxx_%0IeG|V&X4Xb_gRPI|c9xy8a83+Q$(Im(Y}?MFH3w=um&iL#
z_(OH0G6f4_MjYpjHK?cEDMD6QhoAe!<0gl%cryr;MOFfG`i@iv%bUQXJhbFE8*9c&
zgxVKu@M_-I0(LNr$nIO;=h+xIFfgaA8tP^JxrtpS3oqZ!Y=eB%tPt$%85_|;xDGms
z$?ZDUBTTl$0bisl3Dq#Iz&{QY44`FwT-zfX&Q0t(-hId44n}2S(G_g$%M7kAIG}1L
zBa_%GlJkr2QJg=SrbgOt{%@ns_#zBOwLMzloeW!zSCX_&&7<jpsNUMqSqotgbkypy
zoi<xxegq68IvFVa+Lrn83U7c|Y;OTqtl{A=9r8=#^bYFCL5U$e6Y^Q6Hiq~%3bg{3
z-5lT|qxmZGWHnP$Zw?qtZ`ti!Q^0FlnK*!Dh9NJBM90U*v>HoiFSZ)h?x$87SXlY5
zSDw_hsfvo}O)@__CtH8Zs;RdY>f2i3E{-$(^(r}r)veoWgEkx_92Bc{W0iC{v9Z0z
z6xU8BNqNm!L)=0jBvqBMemDJQb@y2EL}FmzeMbJI+L|L){KyQY7hk-7r~0s0W@Nx9
z=95v_FzVaRByRXM<GP`G+=TQk2@w&7zjnZ$-}{_y%S0O|W2<p(i+<gXxugHO|A{I4
zsA^?3ZLrEs?etj;s=d}<?;XXm>^wQsB)M|qVfie2oj(#@w0V&jim`Dtip_rvr9ljn
zqWE2pt*;fI&sd&uYIGV!sqBK!=;z$OHlb(!tj>rljc&4xPrQ~t3|+M-_|$70fA(aq
zYWLE9JL#{RCRTZ1mSWpkB=u7Xxt|_|cYWs%>^hwnLo%^u{&hsCa86$MUi85|UJ-{W
z9o`k6H^SkHvG>Hqdkvz^9pY+c1R+TYsL=B7o2oQ)8YoqaHC99rjMnjsPrkA{e7~6}
z^~F1>{*tcm_FYG-Qv-Wt?%?FS?d<0GnLg2z|1;*B`5uY+kFxkD?|OCcl0$aHjnd?i
zt)7W-_|ilQ)|Tyy({qq5o83^QUAQB>Ov?1lXve~hK(IT0qUt8%AtUQrZ{2Ko^&o>V
z%7tu8WqMFp=;DYV_4^ag)x`MEhlE2Nsn(4MZA04FoMEo2BYr(YX9Us%-h~7xo}Toa
z9$V@oBCvR!Z(eEfm&_S9YrEudXC4G0$LMOTrjox@g4|?%yB6=DlJ9!Q@`-&a-eexo
z-|Dd2;iE&3nYMKk&SapOn`LxRzaDWi%%SYV#VDRPqFNd(mn@kI3|(~3R{Z?SjirIX
zZ-v|O+DqZd*zxttFZ<P@u_(s&(Vu*!kuA0iyUmo8mTafbqgyhIaYVs#mZuwt*nJN5
z%&N>gN^Cnm9@#m+yVT?z2`5`9H7Tcm^ST9ZkWAU1aSQXHB+fnh+IG3WKJg_7v(AtQ
zsU(X@{a4ZOutzS2UNuF%#w9n9)#+XQh{F|EFmd&Q)l9<=74KGxl-b%7D~*S7^rcBn
z-M1iSe}6SP+i5+zh;04`bz_nzZ2E^%S{<zcAxUQ<Irr+v`u=jAIg^UWsJg=UOlq2O
z`s+B=-DTBL@V5IWZ?oW7=O(Warj(jLQ$BQ)kfNK+gXOO^W$826Bg?QkFypacYA^Wh
zCp`N-uLK6F;o;9VH8t%lm5o^gc(*a%hl7TO7N($@bnWWZ%XD;Tz|hS8C}I#461tX|
zn)3DQS3;mT76$UsQ3zB5KzvZPSvlm2{}&j|{T9rC(oyo7qpNvYI9<)7*pWo;-5nLt
zy~e_?q|-!!06923oERT}XsQEAF<{0ofJE);dI*4r)T3Ww<N&cLQT0_1ERR-)0E2g#
zm6gET+Z*c6nDqPfSCqdyJyg;NUu8B~{aIpB{E@36#?-y*XY53kaMnH(Ky!c@1GRMz
zN}iO5H)uZ7ccadqKVRS3DZjI`69~iswx1{+p!ymMEi=>8*eLqjx69~^0|6?+=H%q;
zE;N*!n3-V!I;<&x)?@IkgS2tad#U>Veii$L{s;EU!|JWSZP`5zoKpJC0NlO{Sk4tx
z;OeS%rc7q6<EXPF{566<9O?py*K5q(3K)%FZf@?A@9AOi38XwcJO)7hD#j`^0K1jF
z@w(WoPZ~uCFjjPBu}g*R@8H#~Em9g98iU!cl=|*&1=#BBy5va3a!<E{XZFN(I9u4s
z1KS~=SEw%xaN@jYSxfmp<5C|aC1(^i*X~om^7a{u3>@eP*w4POwzeh&Lo!$$udDz1
z72#zn<;H^k!ZqiII=RCz&s{U7w^%wqvA*Zgy*nln$a(u?LY94Mielzj6#Qa#824JZ
zZPa;&THnelKRFrTn58|+i(SBx+(4=~1q}^GUqX6DMrnY>ZT2?iG=x4Ej($sa-->VT
zI5PCv`xPbcD|?-oj8(^?%O%Zvsu|DS6PvCPcrWCSfhQ~RRp$N%kb_@-em>ZEh63gW
z)F(395~+NS%ZY42V;~Rn(9qXUDF>_z{`K&eD28(=oB7_G$gaSXf`N;~36r?u`vL2@
zoSdA&mzUQrsH!-6($GGgAq^1@`AjC9zd|NNMnib}Bkt`)9EG)tPj)kMKoe^Iz9Rrd
z9?^vh^Z<hR5{kO5HIV@Ws0eIA@0|1Nd7Rvo&~_!EExY!W5(JNfw_yY91fP8Ux<sqd
zN6eUP{8Q*vQhUFma_#Ng_p+htkBB-x9qeP;@HCazp!3A+o!x*%JX$$Ek_S3m9-)3q
zuxJ15E!VTMurvn|Gq6FGs-~ufLIGG6Tw8m`0sy_w*}1XmMUPV)7DVuy;`r>Y`w{{@
zY~IgL=@StV@mT~-4>)%qV#UqOvV4{Mk|k2_0?;OWxB>M3AHhdrg>JjH8!Kb9z_9el
z7ZnzI17V0P9`Jcx6?P^Y%Ojfeiu1pr8p6WE^Gi#+hN|uBBT3?S5Y^Cl-5A~1p4<|!
zNYDI6mn<xl9!<TQ+V|H1fv}vvtD3;WwF&`X*BA*j0YGUOt#)O1-Lg>A)I>)C$Acv)
zDY-aW{i#C6-HR@)U7R~}xf(;s?K(as*L}~|^7rp!EiNsEEptX@0X~61wn$ap5<we4
z_^#&wRvutCLIKBRaa-Gu;>wiy^UXdFem*n!n*NB_VG4gS=Ubtr%MBMNs%^(RH~Ti!
zd2D~(7u+7U0|?YIw_kO|OGiTkHYnqm-Z=uk3ARl2w;>lL9>BwlhunSuqM_~p?DpE|
zupMCcOHhID0HyU1*ixXMRpwvL8$&@q+n-A%5lT+ya1-wtV8(*`i$w@osFI_G23F=E
zwfSskRUemv<LpY!v9Lb@ZFpcHR-&-G#{5Uh_vPi}pPnt%7n^=ZC|<w@3p|fKu3o!_
zh6<+<3WoQGQgBL4ex08l-FbL}iT&A#RrwobEO|-u!K6{&Hj@Y$Z5<z=%2Nvp2mvVE
zGv$cKt*fi!^*pMw_dD!((en6RB{mLDLpZenP>4{c@>q@H=Bj8eIbuKUY^J+;^E{k)
zV0IaKo(>0^ym7{G-`nV}(E)%Kp5`={7F+OaNdwpmeW;`_s9N$ak2PoS$?X-a)z%N;
z2Ylt9l$FL`%>7m<BzTcd2ftmZVhw=T{KAL?>1y;!#Z2Ft8WA8eGm@X}{xL>^&5s{H
zl!YJv_-Oo)F?vsgl{J4)_)v_5gk++LOt-N$@=Dm2D1BjJVL?H`orV6~LZ>wYx82{d
z63%tmz*Jfc7NBLT=EqdN!mzWksRN210o|QkT#yrt@WK%2-UG!5*eM4GN5SKE%7eXy
zd~$BHi|`j+HJ+ZA_-w`J|I9Bf<kv_jC=dY&dDY?OCXY$SrBG@CQdkMVEb3DugoBl{
zRrJB*D#ofXfM~`;+g1O^7lZdkWOdmk+@r4FNP<ivMC{$zNVn%}j-L>N1^YZnNC|Hj
z-&_MqxE?4-&`u!F0=-D6Rm~yk=g*%B+;PiHrdIz^G;-+JJfP!>2bddxNxUu_H+U=t
zy?}wBTp~&fYX`8h=h<hAAK*MP%>;SLVo?qc$)%TsQi@A!!{^+IzFF&}y?y(Za=$#2
zYnE{tlqHRzBmrmKm8UJ>wmstb1n{ynvEpNky65Mden+crAOI@&Jf;Z*T!}Esa}en)
zKor#7|8tn%aTymFn8d_Oi-U#eAW5j7Xb2#pq-1n3Em8S@q!B22#+iZjRRJeb`%GNy
zu%FeR2&{c0$C4?Z!WV6~JO(}=Ka{2O^?1{ZYiV&kE1yi)jVP8?w;53qfVgEGwg6d<
zHP~~|s}y`~v3BLb?@Q`&SW$WhB%lg^^lYE1ZWDxrwNB5YM_+sJ5U8iRy87riK%3~G
zbIRLfA9e5!&o|9gvQ;{yV2W1$ZAie!3TYmG$Rt)*SG$gNmy`#n)O|ib2qkAfV`F3E
zv^SRl=p$qo_?ItV9#3&~1yCHk*sVkE7+{-y{ru>-xk*HhcCNgVo*Eekz-@ePE(ox|
zNl>mx0;0M)c6_8d|8f3TtvC98Sy^!{txMo{13=C&0r5XDJiNKedHo@TQimYCp3FxK
zkcj-ajBlEIt3nGO=&23J^c3Hcb3GvhG1OIk<4s2hqnCu;20sv3k%{U})cZNDx8G*B
znH1lc?M8=WqX~p)g}@JIwq<koCDDf-3R3>K<`qzVF5T&OZNB9KWecXE%?f5qXlSVP
zcTNrt-07D4Vw4F%^9y^M3kaQmw4QuC4yG>wlP`ck0#Y@@zAR+|_e*6arhU_0=5O~N
zRpK5h(TiCh^BfhdI#~%iS?m-A+EJdVka3NRCQB6?y6eAA3B+e#Rz!lR&x+6T%1Q)$
zFxm&+jTJcQh})&C9OCabD<K#05JcoHz%)^A(iCSQG{=Vz_vbn08{67&9;M4>Zq(&`
zpL^S9cA~i(WiU+bGeb!3Vl(4GvQI96=k8tR<SgppD$&3*F);~ZG>c=_EUj&CZ~w5x
zF(&_)o?=WE^c1Pi#~F{w^oRGJydPnfaGg;Z<V$58x{-{!JhIa@=;rP|vA7sIJNpEe
zoDFrSi7y}EV)ENh6C3*u>j;}4zw<BOt}ywQ9K_sxD0vGJuBnw<PoTH8$8%x=#E*rA
z<t3Wp1#I+Ci8(?CUJ}u<$-N*Z6x}+=`^j}mHDtM!)Y-a#rzNa?WxV8^9n^MN-EX~U
z{s&1!kJ@J6*H<?mtpfX}4=Oic2krrC?iDOV-TX{>zEgM~_liWQS8Oa9Ha2zvh{_H?
z&?e#7>H!)v+VVI_0|R=<#l!y4(<XZ!@d4Y10h%R{N+8lT&?%A&xfFwJsqI@lCp&~u
zkRVQUOVZwRa}$K15(@508iaD^=?aY7NM&Dhou8h@J8D<pn4X>{XVXKe<m-fGym7$>
z$rmyLvea-$WTdrq!W2K^us_x2>ammQ8cicP5_%X^pTqUUGL4#c9*Js<(bBYM5ON;G
zC%~G5uIRF$;3ZHU*2l3Mj)Q;(v~YJ=5Y|L?^6RaWav^Gd)Eu0-wWDJT0MCW)`_DkZ
zIN3t$*$B>T4HObGT6{vXmIT##%dhfWMZS{%$rNv%+=*AKvg5^3E#iKt5ns2walN>(
z$5!x(5x2V)B$D_ba{=HTg@Q^#%-NZ5sMJz(Q(>&+bDbuM@bQ5ih@t!-K}9u=*ZC~i
z(+)OQn!JmTk3VW&@jTKjG`Q!}f6EUI9RmxPpI^2WsLMdQG%+N*0U#8Hq}vj%v>Pv8
z5Tf0w$=%=E>z@<O@t^e}5GI831Tb$<kv0O6xVb&Xa~;s|3#djQQxP59%c!V(P(Of7
zgbYx3QjU08Bwe_8k$lU&A>WuZuq!RVw{u~?sVf3MBy@NZBZ5GY-)U7Z+VCq-8GeMK
zz-@*oq)ME}!NGwN>@sLDn?Tv4H8W$HwU0sd@7loQpd5^q5cU$tV#p_O*1q1#pIr&j
zp<0}oR*3cJpR<ReXv=%0?0fnHVh|S*e);m{jMvWQfbOk!S|CP2d8d)uZ)q{#)A{2Z
zW%vG4z8}oXZ)U9QJdTM~DrHETV)FjmferOix7|OCGghNj6<;^M_&ymdY=)ex+<E;v
zESR~wRhjGG%8xcX-y_I;FilNOA(;S2Jf81|fp9-%R%3YsrB6TnSznKQ`SJ{io<=i9
zy^J0|7R^;@0P1gCgbLP156-mFFVn8NK2iab4ZjfWCYmV!P=e;mKpVg-A^JC<mlbA)
zrC&nl<DnAXvRlHUd-3K?IIs|)j+tkrRM9;Bb{1CF0MJt+Mo_g{kFz(oKGWF(hGsMU
zjiS7wVj}GJXf3QZno^?lFVLM4h#U~Ie%>*NDs6hvSDIY(Z>S+N`W&gqWGIb?<pW!$
zrxqZ^^o@;GZSva`gepFzuEmERgj*x}zx>19&EmAQv}Bj}FrGboHrtaH(reu19%`)l
zDT}3cXS4g^j5*=B3Q<Rr<uPw!cdtm>@W{x-@-mA9g)+zH=ZqM!>rr(L4XHhSufCM`
z*-OW2vE1Hy6ojj;;*CMvpWOI6)UAB*CLuVw1MLdp<~Z_|^9caE$7j#G3DzuM{fNyq
z+uMu}m{I+g(%n33X;2fHgZ49y%k%;O4q!)KkUk)qz7R523>2cIlai8J-QJdjL#t<M
z8YJYpwHnYuX*6xl=HbruviF>I$)n30?^qAC$UDOD5KOF3N>M_%IX6N=<?hWhKZguk
zHXar~Ro)h>0;I**Z0xg8IIYN0*Q3guoSan%-rPG%?_$K0bf2#+0GM5gvRuqXV3eiA
zu=S^6%+x1O9Qyrp7eQHm_@!a(2_*_}Bm&1E)C*rvmn>~`zt{O1d6_Wfmw3M?*~Oy2
zLO-t>^WN4#@EN6Bu}^>N*ZW76KT->3q1hUwp~1$aI>q&dJDBTWy~|^iu^f$?-q_JH
z_}dvaBM3aV^!?5TU%c+tn~Y+&<*$`K!13#87X1r-(yVAAFJqy+{V`;GLN834$bF)3
z2=KrU-m>#Y+MwLUA!G5CNR5Ov*H9Ce_@_a+Y^IQZf6Pv?R_L)%BBm>2A#>H%#BkS8
z4`F&QDPZYO=Nv=U4pt_Hzei3Czv9{vp2h1P+)n38bJhO%w}MK{OlG)UOLo}lLPe7?
z)|zcC*@U~EmGZvOjDK&8zu8U0n3R5Fv%f`5?Nd4;4C#;cB!1m{KYH`Is=2v%$1IM#
zr2l%e-i7VEKy`e#*Kr^NP)}S(iqFMKKyRT~xFA~$Awk|X8$VtNCM(sw<C2FVEXNa=
z*iE*K-w!ZqSReui(h%;u@^-S`lw_rqw21EqU>2VOKyJkf=d!bw&8%WD>NAWAoee3K
z_P2X<Wv(pORdN7HTEFfs=Vlc4Gh72b7>L8#UJYGw(Co<gtv{XTbn!{??6PUZap>~d
zq;xFjP2Nq7`BJX*=BI7doA;g4DF8?g>RqJwwW>kcrBS(QXd0@DixewpNNJODqe-E=
zcz6h-Y9ZNH82CB35Oo2hWP_v)#?niX@0hV8<gBTS$Zh@bq!p)D+ZjSuJ&$jguDa}2
z3TnZySJK9*c~Kw^YzfN|4b`L#({!eMWt?4L+VRBSj`+IiowA}LbQI`tbRIqryl=ps
zrS<LL4}Gw7$?Q^Yqvz2sy+wb=%SxuG=-60HP%Iv*-4_?PuUSy{L(HUXUAn8|3#Fup
zHYzrv1u#=?Iw|x@+3V=2!Jj`l0SK0w?cEgEvmPDmJWrLe;a`##4-g^NcC#pKgosQB
z6XFtDTfe{c$!6{s8lza!{dCJgy|>Y+i58d^mOTxgbW6UlcZ$pydjbeeae_Tws03G1
z4&%NJyiHA@e)bK^FD;LT%!e-ZN^B(xXs(W+Urbd674(S&^W&j-k4^zud*!5vnE_?r
zbvet$0y~KtiIya==k30(0Fi2Zm{Khw{JhB}{nZ|rkmsEYo4(QKPI;m{qhE#x;EqXN
z(HG<jJ(DH4x1bV(j6|&E!#Vz#S3z@{op&DPHC&<AE_h6TN^1f<t6#qt)yl$j&&1Ky
zf`Gv9N`rGq1028J`hyke>yO=RFo3-g9Qs0XoHU4zZFhQTwJM_n&Qr-D_;96@lCK>c
z=JlA<7xCGuhXq=iC}`w07<xb5u@H4U8FF4*wzH`bk0J7rlK;~;(iRD%*lA&Yy~dH^
z2==QHsC$8PwWrkXM&JCZk;&}?6D<O@*XtT7h(!m<w>33}G1!!Sz^&84-!agjy^%}N
zp~(T<#5>aQhoTsdmw7`ta%&4%ED^p<Esh=h5|Pxk<;VAUJDFL;0%OrXW38aO-hw%X
z!(y~H9@?+*JYEqDfI)$ImW6+I2~X#kq&m{{K8zt!RWY1q6n~IEmtc{+<2>TQt}g}b
z{M^~^u)8sEUT`FrStT6Lo9|=^jSLj+5E|fD?5ot+h%3OWplhBpq);A@xg&1$4!?P%
zUWDH8VIHv)&meWO?>Wwsxy@>s;ip>&`nf&e+uJE^PA7BWOnh{0m=estYn$w;en%ep
z6NfXMe&tiC?58+3e}XOMBc3D)@AOOVLnY1AnbqCF6N$?W%+KL_+(5Rn{yEf7g@G+A
z05c{6-#=dK`YCtSKS$-r28_zZ7_;vDYGNL_rE^p=66`L7W!Uue#D5-GP@bwKLYL=)
z2#)&0PN*x<jJ&bB-u8@#N?G?jMHnm+d#L(j9)mGq1h)uWAc_xkXTQBUA(#`(AZ&C(
z*eY$5Sh(}j&aQm3mgAnJ0dA6bweLs5&dlgK;TiIQ795%61?<1pOYW)(om(5l#aL7J
z4?dhgRh+wp<8PORuvC$eKkX#^20mA!=)BfaMx7ju$WAwgy5_atYHo&tVtT_kiVR^!
z8u<FK32YeXISf9@9}{&jY#E<SWT^1Htn5!kq7K@*R%<zj1|irx3C2H4jHGVVn5ej(
zPE4HSCEWPXQ-<#N)5{<V-Nd^<Yet-_oGdyo^p?$pH)F^UC~Xc=0lD;X-Tg^46f5p(
zQ%y3y!O0uCCfdxZ%9og=+Z>z(Tk(>^R?uYZXbNN<kV9i+RC@Rf-OAIB2t_DdKs`!H
z1has+pYq?$`x49_A&eu5et>3ebhnf~QSu;7h!l6B@pORLd5XA-DW<Q*XBsMt>*j4n
z^!1yq<u*@Va+T-Mg*s%L0fo}JG)!Y9*mN=^EtzGsc`<3`VLAzUcL}qKFm1iH93H}D
z8=d93^vU0`rsgavj=PZnnC{5aZ5C-9YaVlaBUT|dKKInJ(AEO$8%0N^H|3=+Zc03W
zyD*@*qot(<NHbZNGANL;yE65Q)5;xs)Hto!;o8?Jw1dPnGaHNRhVK+JUqnWtd3t(+
zv`CQc7%FXEj|1LcwtSTi3;ysV9?wYeZ9Z~Goa4aIyA^VJMu7stG{hD!CK9Lau4gV6
z<$#n@K|ukLszB?^!NCDd<r|E18_-=MxHV|lWmYmfSa<~#kmEBm0Utix0Iz-9s83w{
ztlrY`%eAArU~A!-ZhWWRLi|f=nHrZ8zNjJ4OMcZKY$!QUh}OwzxnhQqd42iQiUFXF
zAZ!(fOv?KAR}#Pp>sneQp9cpqx`AqKdNJ5rg<*AInFbLgeEa2po5xP@2@SV<OlF@M
zf<OBC`9ZT;9S&=i7a&{{X|Xz4w(fX)@iRaq`A0<&BXW3{A)=>(!X7mF4q_@Y;^HV_
z0XJpZjv1kTZ`Y1Y6<(gGLgX<ZxjKQw4_aIAGig^|+}~bl*<2VPqNR-hc{HTH+*T>#
zo_|Jm?csR!HCQ+B)vmp*=-p7?`k!Q_Div-%Ae;nYH1w%~!s{#wbgl0|_jq4M#=O-G
zd~MaS__c|t<a`urT7<^SQ*h|+WN@pRHEbih_4pkW2(|A<ug5ZL`XkLOUl@{m<?Wt5
zdm1wonDxK7i*~)!2`O!>LpzOswd=OQ@2}AXrKK1s*+gC<P{cAmTNw@W1Z;yqF#WD;
zSHnMov*~o%*XYf<RjBu_B-ZR1NrF2d4sSQY{#aB*L`D_>X!jI?FCkzhXlIAZZN%n#
zKKKoh**&7|XxaKxAAmvAffkPGk1$oRKUn9_cgsh8F+zluyX!OAZnCf<o&Ss%bTP&b
zJmCTv;NJ22pFfm;Kwy6T9+r1>z{>*0EQ8DLC;E<G6J$hmS=cR)InIHe3OYjY+_!$1
ztPRv0k?6W_l0Y*POcT?}YK4)uWhwr3y{d`TWU_0g7?z$EEi03I-mPC3{MYx(%>6{s
z{6yDkZ5^lyW(jt8ccb@q_1(3iK;nt=N=-FPn+p#Q-*etJ@1og&eiw4hvZqbZ^kWSz
zV{Xu?6er-wf=?r;_WMs;46~17X791HvorUvxu8H<f5J1#2X6OhJIHVic{BDV24&NY
zy58PJI^iCFi}OC*-);b+f!2MaTP${FOE%1Mn<82`F@j(-MlcZ_zzo&2B{u++m045=
z*1V1gFJ4s27S0RO(jhAIBaBYRq1#wrR$URAJ?-g%lBBsYh!_ne<g!r<eFg=9dV#cV
z(YpnaZNi}oK01a9&%^qHLI{IzEhJsdCIL}sD6256#*Mp6*YbixiC`&7EQgBGR$D5P
zP<l_FhC?gS1ON>uXqTC+?i;x#D&3a5SbB=Ov>>Ybahat*3&fk+e$`n*pEfCA`ThnD
zldES?8)PL_j{7C909n(xWS6*L+UKeOJGEXbGzv`}50#XZejCoaK0y&hW?m2-_n~Dm
zTsj7|#!q=nIyXImplo`>rownxzmO0dfTN&gQQfpsBR6kL)MofiW})~S>89uTQz+D<
zy<NSDB7dR|wA#_p&&@yI_n8R36*=i)$esP~I94X_DUPKT9g(?BxBMRv4s0tL3Y6Xm
zs3Q2M^~$C;GpLt9VENG}XwUldDuutD89A80EPw=&Ad|eM%E%HNf7+enej^!ZDIgj?
zj2Rv^5QvP=BzsPu%lq)fGD5C9V4VzOhf;|*pE(?}J)^Rd0~FrCqvmLoU;|P{D5?h#
z|BJTYSU5P@;IjBJ-J#+HiJ~_&ASEUycI9f`#-$M?hwXie_zBrJr@}S|$$T^vX~be^
zCOUaX<^<xoc%LnjpFv0OE;5lv)dJ4y2>Sg=fLfpfIa!1jI`6~*;X#U6P(B(UeQn%k
zuU;8P1^wLmiC4AhxppduTgmVVWl0=sSbOUX4z1LBLKFxxs-vSL=&t4N&)1EBB3ICQ
zqTJPJ@`$s4f$r}{8VCN12!#!-0%(N8Y_ZUYBH7{V{#O~1LXr7ANEwUtft}S+Q6Yt3
z0HI~xZHFKD!#HUXD<K>76*pH1)@!j_YHT@Ccm3A)w(Q(nd}3xHg#BBxn3^Z>H>BZn
zG`gW|+GW|l3^28KNQjJKPH<rBdjRcbKb^JUvjH8`sO~2Nw<mpNIP_*%u#t>_yJQQk
zBz|DG*xTeMU6BXTAJ-s3zDQs9+j?g)Ye6<#XdwWoE#Ia>;yh9>bJCqXI&8mZ5hCX;
zi%}(#b*p*nF=QX_Vr~LhBN=|_u9Vby{%4DUfVeM++59Kx-xZ*<R>^L``wVZzL)RwP
zM_ue-bv`PcxZ}$XA_d__2hH7*)nwt65u*{uxKE9Pm>TQoUI2*u(jf#vx?S7fPYS|l
zr0W)*&JJCAfL{J{;4|Cc@27sy?235-4RuUDAE8P^0Qx;CL}A9w4)4)DCJShN#0X-m
zKizfYBSkiy<{%a0AVu`Rg3cT&xf*`JwxXec28Qla6e_=Zi}E7&xsEqNIOgW&K*-`j
z>nYNOI<Yk3B>5(n?`0@~#|Nw#JK7}>1v<dHzHkFs1M4M}B&SygB2X<Bbm8-cCo5$M
zy<4+mH8sNE;7(h075<7)TZ=#bj!@um2cc~twQu#uME0Jw@Jb=RQ@m@(mpdnmMFfhf
z&3u;eHcrs0Gz}6Sln5X>e~Co^0d4aOI<eKG{T0KV)d|o>*3Ny;KtlmycY}#Z{Qmtw
z59fGUe`xkbnw}Nj9E&JOsU1xjpGXtgRtmi&)L9h_$LV114?t}0<gnuG=FWom*p@;i
z6tAwRj$5|^O5s+u-yqW8(@l9OXl*VC9aA8VhfWTJU#$C}kZOIfV}r2GBF6`uz<;2|
zy<Nox`1$Dt1U}Vq=Ly=MyF~yLsE+%`E00Ac$HpBla9>{r%)!h^BdJzo`v8=XLMOtp
z^iF{Mk(Pim;KvwaiA8IF{Gb@~*k?|cPY#DpwW-XEH}#WEApp;AwhbT0xvtNPVR_4Y
z96_)?QUbV!<NmM@6pVpiOZdNy+0l$OrZ;G@G(gVEUS+O%DrvKY-c-=S?;Wp<x#FWh
zS&lSD59I5n)d~Uqn4?yB25b)H1s}Mxe@yfi_>p<{>=M_B0}(`;T*X&KOn=m4UuJp5
z4C~|@uKw1b))_sN<UO``BS2~dGxig5NSUMy?X7&WaO<~kIb06_tAtMh;?VlpGYNb9
zVvje#*vrb|f@b2;%xlm&!j`!6dV<=xfscX<sV5~KruXSD=cyqT73pJ+14mH;!M?Px
zUSsI#qDYMAG?@f!Ixsl+463oE#Sq$Lq1g}@(%kxn2BeV~+ImE>y#GeibL2X&_|{^I
zXf=CATt!D69oiG76PS(7F439E3N}Jn?)|lx|65RKUER*l0=6jqcHcKnOsx-2ATHb<
zFnokiLI^QPt`NmLhz&-artm<S?1vNi>eX4uw?XWJ9TO8X2(9AiWZ~K2glF3DuN#bX
zo0BY@Xg7<^Uv3d{Uq`+T;|BA<1a0KZ>Qoc1+UqZc&lCx8mrlwJr6hzp<uvIKmzKtc
zKnDHp*~uox#(t2%VgFk}4#1=Of&&iS>hgAM!P>wA%In${0YgQRvF4{|6rvD$VpawS
z-;l~WnV3V*l%-`R%4IS#JP#^I5X@a%TwFvtm;ySW*(TtV>&WtRP||{KdC=_u12sM}
zQ>ka5o9zEesy7G01m^EP%4=Grp0S>NNeObeoaA8~A9St1q<Nqk?RGprXgdi5t81P$
zf!N$M1bV5E@8oB^`Q4yD{6zifS8<6deWU&@{%IB6J$H6=cZ<ICUIyr)M``;=3|%=B
zqt+17XqM0aAZUY~FHr+6=g+Z5!<H{f;LR{S7yJv5uETputOz(zqNJF9ud%d<*CmZU
z(du;%)gc9<6TX^ys);6amOdAci}Yfoy1GbflPXjr9<oo=CX<xtXUDjjB54luw}M^2
z(b=D)Qm61H(}_Q`+4&QSZA-CgqsDeLlr)hTN(B|80$#98N!(GB>7|<2cvLc+7H@{A
zQck|^WjClekLS;9y{SH5fvd*ObM}guAgtGiI%GMs6#hZuRR&79lkWqUknP$zwP0t;
z7S)Exs^8${{ahLh#3g}Oc8gs!`^s+F_P-T?Ca;7OjSL~5n0m6LqABT@SS^IZ9^GE9
zmD3N;opA4J_^I$0g8N^D(yPhfEpl!(@WqoNTe$xZI?xj&;LAVDKm#cegt|K!Kp1^Q
zwi0`)<|L&F)?>x|OH_*-wVxy*D^pMFK=Rz#yj@G2MA7ku3)zfAmX&R58qk1Bo8tfo
zc28A4?XQJF6xQO+<9Y{{YH?o*9*fEglKw)Vl?VQSBw^ioYD00|ir;TNE7<z8q05a*
zC$<xOC#_g3z*GE9Lj)P8p6T_LAt@oYVq*9>9t?X9M#x;Dp~%b6@0`ol;(2-bPU&^%
zN<{kp0P}}VNkm!qPWpkWjSV|cv{=ym13J6e3@W>^8PaI|p7f}4YfiFo9#TZCnl!RN
z)?sIBYyGR02>SNkLZis+Xte;`uz;FcP7UaO!iD5&koUN`xgqKecUQD2)1v>T8MGXN
zuH68!0Q{7k9NY-OKUlzFC1lzHI;{jK9zY7KcA^+e?Z0>26y*hbB9n7_&tRSZ{g>2F
z^(#l~{f)&RkK*8_52*C9MMOl99!}wdRk6eW;Sv&Gl7w_VyJ;*Gy`Z3$NPFDAaK^(c
z5;?+*ZaQPEm8?fnSKkjDuRnpSBM_M&=z1ie&kqMW*b70}L+5L=-QA#7VS5kyuy6<n
z2oTnHVs`chT=tT7EPLCZ2YT<dq3Fd%o$(qhv(io5Eio0du*k7?a3Dz%a3rmE*+iOZ
zCNq*fveqi_9B{dMD`oNiQj{5P+exWcV2#;I?^J!(wci;)v-$P0QlZ~`v0Ui3P_*<l
z6c+rVj%OR>L3TN-2ukF;xhhwnxl=V?r)htsCSpL>lNxpy<@Jwh6nbuM<;kxPT7b7*
z1;F4Pbf-qAQ<;y=T#PXQek4%7?L?rPNEBRKy0xjH3c>2S{F_h$;T=@j(-Bb%3npkb
z?}m*;HUE_CbKYMnoA~w1*L)z4j*$@?=?C>V<OiA<ua<Xcacas3#2NHFJf&Ze75M*Y
z2|Wk**xUf836gn4L5w)fjE#Cg+TiGz@!-xHaXoH-?FYSo3&%+LaiWS7gL^i%mPbN<
z6qz&(4N;=lKnek!kp{qnD@I!=g8mC);)#?8woqh5ZT|?s;$|z}ppZFd>(UZ&BXM1O
zvqv@7_^7s6R!JaW+0FZz4!K~H;VG1sw0*xI1OEq^Tz9cEi10ulpcNgEJCKg2nx|C<
zb71#8ayv{p1l|xX6yk?lOorX?=;%4nKxU7ibskbm4WLqf@W|EhAtuyU>f~Kto{apQ
z>I3D+e@MS}|1JIEI`=vb`V&*2S|evSfbPlW!EK;jLv?AxPUO(pcYxu-vMw_3;wSjW
zJ5$ivI)t;r3JTa3$7*PSy@L{8G6Hsk)UY{}J%|UUPR62zLV;y3#M(GGz<nN{x{IR%
zTM1viGG(6%;oKREmIcsfd<E%3Xb&d~x{?ZYtS_R?K`Jb3Yc^o;@KGQ~%qdPxO}zqO
zN!pF>_l=E>dT^@*=oVe|MyrpwV?K8>cIg4eU!E9AK=vuvdU?f6a~(Z9<@+2!cHZ3P
z{Ybuq2)y8N;c%0}6qJ<y;G9rXbE!kGIZg1P`;Ul_5Cz~xu1W}8Vu9#rudltyX)jGm
zO2WH!>((L7R#prh{kwURSTmx+rN4U`bZ5gpFC{?)x_<#|$X;4T2Dxbg{DeN}(om?1
zs!2UU=u0(5?j}(Zfm|0DZpu;D6`}G9At!TU!}<Mh2f;!!|0(Lm!<pH}q8kUn2qFoC
zJQ6AdNvP~dS#?4owV02sIA-_nmvmTz&QC*l%V4P`)$`}itrrK`za<HfL7BC8D}~A~
z!Mw<_?e`zd>9HDIA|fFz2*nec@>Alr{~;20XeYSJp>VKuM<NYWi*P^0{Ra=40G7c@
z`#7nhw*A~tLP8?#H)N_=xY0_kAkMu5+K<V}Nj9rdLF5h<a0vJ8?YY2;F&Q#~b<6Rp
zSNe9Zk#D>5S{YjTvFa`kJb`*876E1s_cpUHenl=*f=eype{J3LMKZj#=>#hSxcLW^
zSD46sMxcW=nCnTq-aS23T-V-?2P`MlzXaO;fq_{n5Zp~Q8S9;IK}L`SNHN^PB_WpG
zXK=8yR_?S$51R1t$v-Xk#QqIa9CE=m5ugYJQG{f$?E`<1v_Q}H8TiAOFE2nWx%02<
zRL(*>JI2`deAR_eO|r1;`7_1J8v3f@y2W-+`#yAbXUNlnE<nXYr-TwNwYgs5ZdRfJ
zjpmrk6w81Byn9C<^~BC{sO!IUt6Fj`U8R5duk-*~QW{kB!&&S1-<GjLfrZXb5e8Sf
zjDv%&_dMR$g?2@H@UY<C03Y_&Vvz(_h7^yzy-Lt_Wc1|%D8xY!CZ%1eumHiYKTlh8
zjumeB0S!ehsDePWj$656H4`(w>(G6_gUNRvSl+V82EK<js@`x32`H(tQG|fFLak#6
zcQe5!y#Du%Do;l$&%J%u{<F-g<w}I00hc8U6nL=Hd0G``P=Kk5!SBH*oA+TrR*U57
zA*9TrIyy99?S*=EXY7}TknN57XbN{bWRGuKd;Hm>9z3M!aNUDc0S)zfyL2J?zr<2F
zALmg72f1p6qF8j|Ha3L_dIDljLVSGu`o2Ep1Gv+qht%>Na-#{j*v(@qv$2dZ<_kU|
z2ltSewV_LTO|b|kVPjW#XB-_q-d8d6BB)wqlZCaR-ImUGVoN~`eBM9bnnEZ_E}1}p
zpo}x8`j!&&hJS8G<rXeW3HSEbh|Sa&xlOQTxBfv!WG41iP|e|X`Kq&f&Fr5J0{ZLR
z8FM&XM8j_q-T+*Kf}3Vu=3vAVDr=3T$N&2M`);NZbPJGeZEe;Zvvnt@Wn^3dfP<Rf
zzH2Nw{&fJ|ru*KA0YV19TBLX4*SKOUq3cvqYWioU9q#lvtyOM~u<Gc>qHQV|e);yz
z7jE|fG&4H+cX}6`5<0+x!L5MorfZD2n%|!vgVIbp-T&l*k@nQm!$e(0|C<SN6I%1y
zgPQS%noc*KS6_Oa|L{u7QpMa~cZ)pCR06i()q8&z-6kQphUeO~YXq{6wzi@mIi^&)
zs32DU=~KhVi1s{(##OPo{o+q2x`a%};PJjn`b1ZL9(P_$lz@PM{anxQly$tc2+AnH
zjMB_ShdVD0X(jMLj|TT6Zi1G=_|V9|^D^4<ye1*IN}&$i?fB9Xo~r7=H1i9}d!s88
zg4Z`$UiFiLgd#ZajdW%khx#Rg*GR7DvA=YC__I3|q&K2>?%b&!P+sv8)~`PcTdn$9
zMNKUb)MW@dzsUk!nRH5y!E8_6xt>m6Z1_}y_w3$=-zT3FkB0{AN!&lNCs|rN&{Yp4
zjas3>Iq+%&Zub;ZTbWrJem%&r1{DK756MJT2xf!xqe-VOH&9LbB3fuzet^;H0UcR`
zj&3Tr59)C>XvRYtlSDje;C{Tl8eNawb9b7W?}%SL2f9hYnmqc%ef}TgZDc@283U5t
z43+l3u6iqJvjqLJv9a-!k=JBIoDvoHjN^*eu6ATE*LOEV3l?YMZA`#EK|b-%H^<2$
z?-rWf{#k5F3^LtNU>0uoGX@2kF>`-1=yV<$F(`I?>IZ#J@4|Ydp-#C9urTfqP>`ab
z{y)mz1RBeJZR5V9s1QPh5Y0qVGGwYmgF?nageWSrNT$q{q>?6c%8;p&d7dg|$QYSY
znL;A-@Ew2J&)(0wpZ$I7TWh~-@Ac-o@9VyX|8Sni@jGy?jCz|;1+>Wdy=rzWZ|*dZ
zOCK~iL~myuh`ygbwBbw5ud2+TjimE#pcA@BaLG;DqfwBiZ$9=oKUm*|=))-aK>Yy9
z=L-d2k44$Z)&481u3x`SpjOjUZF7nC68;L*{t8iZMAf|`G!)j}yFd0x<w3w;J+JKJ
zgUafWbdf~rdE6z|?2(U0?n^uEMkP=?{#%AL=gr53*DPIjNHZQw*p_0Wpl^HLXfy0%
z9kcx>BUI#2MzWn~x=B0YgCgkRndxL1AwfZ}W6zx0sa~Lj0RD(>PH2|ufX6H(XHhXR
zOYdwt8fTwzru-gW(_WPHvpG6@{9=}5g=+YwglT!&$OdaRqW8Gi&1ffk9;%1BS@sM`
zd9#-jc#8Tz34h+Ytz?{mt>g2j`jvsq^j-dM{}N%F1t;}8$hj_EzC2EYM<D1hk-DNs
zH+hbTj=?+t&p<D!>*8Iv+;cUXFs4Q}#g9|vgWGWH(WCe|wODokp^@6cbGtYoj7t8v
z{d=v{lYyzP@2McI68l^su$NX#M_ysXE8gA9CU)xJ@~2HEM&_&0axj6K@V=M@H&(J*
z&zg5yJKZ~F?@rU%pxF5_K}x)tpXjxyKCh|ZymL4@?p4Tk?d0&LZ{~Zrt9XFFF>5I!
zvT*eGel{8foCX<djg*6MQ<_DR?AM$`^h_-l;Acinug-}I#j9*Fu&~hY35bcnQW&r`
z<6Zg>kNVwpcGb{xv+9cs41BiNtr-(hMRK7;l}MVh+J%=pQm^AmW}*LA^!f8zAj616
znJgz*SFJL{_0i6D7}}2x(}|N%U=cSMG1rwGbBFq=+Px#Yx+TwF>ym?$UMcmY2d-ek
zltZyEGZunH(6TaMqqJ7sk^)WV@7xeQkIKDm&>REhA`C}>cj7hQ7|q1E;i2iwJ8$@_
z!qqtU{J77(d~>sptL4hnU3l0Uf$w3clp20dJ!S>9p4c^>w<q~B{HdP~`tG;ZWY+Cx
zh17^nb~WmKW<%oKyBJZMnh{(F)S4BH8>D@O-HZoSCKHv;>+=Pm@flofJ-ga-GvDPH
z0rq)S*@-35OV67JaMkRu&eZ5<blo6gM;f{K?fasSN8oX!-1>`9MyPS6_*Hu6CP>c_
zlXf;^=Aw7}TfCan$8J5=@Z3GBNu*Eq6$v1Im2^5(NnvGXU}QuMB_jqzBM^q5cFc#+
zw>LGHCg*tG^e;L{Q+u7?crsB@l9CTG*jP+;*w;=!%o@B?>vcbO=L(4fXS%=EFAob~
zxSH{Lv7_TgQCV$1L93}<b-Tsvvj!5nTD2RsIV5+phz4U9uF(`fhCzahBJ4UleR<F^
z^82$2fr3~4s||X7Fo^9r^5a@JoxZn?2im!ggjTxXHbNHzLe_EoI)gJBd1~9wM5g4i
z*AiTqquo)yI5xV~`svbntR}k;pS`H>HCdh(F5ozxW8-(jYaXotdvP}g+=W>+xNC4X
zFQ#P!S+RuXjEzLN*YIMwYUs1lfFwpmQy$p8MNVL1Zq2!JvLQtR^Da?KzI?e8vfSoy
zjt$cF1r>>3BANMvu5q$6ORF0yEaI~-?YL+qA(@t1(zRXLbEbDSDKG7XoD?GBXdXI0
z-y3feK4ZdO?a%q?fTb3{<>h`VhnzX$EWhoEJ<3`xF3vN0w`pu2DA7=|-)+LjUO6em
z$Jc3<mcF(i^zapC?&Z;TGZ%IC8v73TdqEY+H*;|ZQ86C2XO`khNO93!y*TFqFLp$m
z+_mV|@p-Ua+PRuVEL0wan0?u6e;#n)Y1H|n|LMP25;|PF=fF?13;u7|olje63X$WY
z3W)N~Y<ZW)r5&gD?}CdLMX5#2^XjV&(V1$VphkI<!>nEu1T)XH_nci%4)cNl>rH!c
z+<@W7(mQYdQ+Ma0ixS$Q19s1rRwi9nz#K9z`H5&ToA`;n`pws$oZFe%@7lyl+<!5|
z`b+d%cYmMnhwTf6qOGD?OFQeeJcmas5}@|df2CSKxav3>8ZLbs`8=$4e}ha&(w_=4
zp;zYqAJm+p*cL=b7me8rA-?_mPH?XiMq$yY?YjLaIzC*UH?cBsueePoInJx_xZvb#
z3xDi-i%M_v5Wd9m3=G~FeysK+Ep`!_mv|=Hqk4GMug%5pp!NUK{SfE&M$=UWL}2zG
zdfyPD##AE8okRTppBlJz`3ZcF_cTK^DoTqQ-|hEMzY#<F7ZE`kJ9Kq4S1r_NGvX@B
zhWn23#mjjR2^^|wk8y7v5>e}+FXMGMM%w?j2p0`)di(Gp>4i$G?Z)*y7{=GfhqJn0
z=ug2hC(~Zs&D<8b$_r(>hb=@E)OMNXp*0sA)mKGX=8t-E*I^GM#JckKr?*~pVeGnz
z@BcsqVh`))5{(T@SDUJ!{1p|VJJjYkFAO4Rig(dEj>OkIz<LjMZ|T=QK7|F|9ghz#
zM<KZO{7qfW^@hzS?%wPBsU6NK^Qa0{Tc7~;t*)`zVO4bKD{D~1qh~9dpL*>(XG9)i
z!BzNGqSyaJ9VCB?Q--UJ_`m;@Ex*)Q6YKV8LH_;8&sOSt`s_RR!SdJ!!X7ZQ_E{++
zY*TjP?zttQy`O33*xS&wSh$LQStpn)Y_69xefj2wja7at)M5wC$VonN$#md+3DwU7
zO#}Ic*V+?Tmd-y@o>)cAKidLZ6&WpP;qs>?PX>)Uxgzfwhth_|ATENCEmKG5`C3k@
z1u5X$;wRq?emzzD+Z&-k#karU(t2i5KM$+4p8;>y-0fQ&%3xo%`E<ej*{zfee(154
zQ<+y^?PhE4&Bke}B8k9=jy<=1Ia>bz$lu<y|I|Aq@86p>+;e~I%(hpO?y4=)$ybPO
zN951tJJy!&5&P&^M6&wz+<qOSn%dUn6l3~zBJx*ESE@!$Y}(DR-Ibj#grYDuQjEGj
zcFshurPeTL(ED9&3x8c?UKm7kJq+eYcE*-}6o7XW>ywTzU#Osqni=^oigfbf$nQl)
z$NXYce_YRqW$ZegBQ?Z3e|euoCY|Xknviof^`Psb{4C|P2#2X!`-QQe3z(z|@Mxa8
z+_UkyUe+q;Z?v=Q6FfCmit>=VoSanAS}c%Nxqq`;my=V+jB3j|(|IWxd4sZ(Cw4&u
zyQa2)9gPl=bW0ba7C~JQzFyPlo<A+sl>jS`bgL5cAFN6TU|*FF`t#|xq)pZT==6Ac
z{l{jTf)*axvLut!P4{ZH2-O%`y3sAj^oo{u{SAs7ABL{_yz1w_d#Y*b-&Trp;{4;%
zTApb*^vBaNQQdEB;2ga91G+SFk&O;Lxc~Ya(Xu)`iK3GUtF37-l%Q<;H>H^WsPaEi
zgC|T9Z^ujk$0o17J@DD_l=ePxO8#9J8SU}&rf-ZF9{&jx&j?<FsPtal5t!YRLd*L7
z!|DoXeE4UQRJMe}$gVB4X%h|S?(=fGx}T|sQ9grT^ybZ=r|6;fb}>H?L8CEJve`-m
zvYKb3V+;DiMyUVLG2B*_@To|G0)piH(ikM!(R`7=6|gd-h4qD!d^i7#y(|Cp1}2c0
zV}I!bg)hkM$)2%A=Mi`zPnSdQ^N%!FM5xCXvFyD#j;5yeLowI;8nNo2hBnOU*R>84
zCmgCE5FL;uETtVTwm0wI6_O<)DyI~=1q#6LfbutQ+7s$y4zyRQ$g7*{D5KG9O2438
zY>M!tpVuy?N=nsbFvvVwcNCjbC#R{yt{O{hp_*2DAhHB^7<=3;TerF&d*-1Te*jVg
zG!ID04IZr-V(cX(LcqPgpI;HUA)PkF*X&G9QbUS^D;1@^q@aJOR4rs-G99TYX}+H`
zycQzH^_j0r-gWIaIBn86)s}f_a5i810}BgF$KYU67_9j>iCGk@II>mz3p2Lqz+3qb
z*D(5+z3ONb&7PWpUHUz*i$nigGE&RSubkwa-94L&&$pvezGQwq$Y{U8#rBTu*Q<nd
zeW4u0t|AJb3k_T`SOnbZmTLpI0`?MVmaymHjj<IQs3^0uzOvtCnHRtm5&tz-DR5N;
ztd%(4<BA&R6~LYkf>sX%oTP0x1r3{X*VdbvU_c#FA^f~CMorIQi2(cj@_AtbW{Uq3
z@|JQ{#CHx1tU#S8wtStLCXQ8)u3VvC@{4CX^*q*Yn49iaIwTU2_xk@~NSp3>{N^rn
z3DwlIEJ2<DuDMhchi^la_l~bTirGjP?>sv19pAPaMX=-p{zlMExDQH9m|`?u{2$Cw
zQU^1xVC~(}lF!A{EnN{Ta@yOKAvEFqic7nRU`i;IeM_H9-SyN^Mdi97wAc5<esWi1
z&VhbyY;2qlP&NuulRc6lE6}GQv}oYs;c~r(&D9aD82MaDCziR-PTcz_m1CoYPOkm$
zERPu%a%>Fm`uepUE@eDmdx0LUhWg^v!E0}Pm-7C6TdDOkOh1u|0vW95YTBtox@^p%
zi?MIB-DCeFUmz))3VKuuS~@(0d`@9&w!k-IujmhOG@-~r`qzk!J?yv}PuG1gA7f`D
z?NCn&&_JCnfqGCcRbXc#jS43g=xEy%p|AjHT+$^TG4XIk1qEDrDl~>HZEW@*KfaO(
z7eSlbWm_j-OaG4)CT7+BL^av|r_lm*EDYa4-`{?-CcI?u`+NXze|1t20RevCClI9w
z49&NncAJcR>ru}hvRms(*);mQ^ouD<9RoPEoc|ZSYlEXR!}9Kbmd<dzILT+W>7Q|D
zwM=9eMGv+-MMXvBXTDVQaX*N{X68&xOo(m;BGo_;HR0M9(+N55D;0DN=pmpWM}`Xu
zP50OYY_4N3^Y}jW$8%j>U5)n%Wi|yB6(-_GOl!RyU(si-BB!5wMFQOQB-esP`K6^a
zpmH#r5QN@{ckw+grQ*z}24I?`SUgwLVByQY2dbzz;8D>i^c(FzI<+OKzj~_!_+g7E
zYEx5RLQJpXW}U(n2>|t)Z`UqX)F&tu*m7-qYnQ>S_WNX5Hg5^+xNG)%(-)Ao8_Z(s
zar-bVxpe=+5C&-^z>6^xkY#~O1zDYgu_-#pECtZ{q0UzL$RgJd*#>O&_4SN;6^&_K
z7hIQjbx=3&c&ru#gFeq|#q7k+MKipzvU!@$^c0l;8}nRcZ{Ow@dUXXeX>n;O*>(QD
zJOHiXzm++8vy%dN{Jg;LC(0ZswPJtm_z$&a-53fep%9(`{>JH&vx1`i3-GsrE&;&b
zYPUdIw-qk?!aK?`elR{0p>my&`TOQ!!h{<g?6^`IZcos7MG_kSuBE`xUiqh%k`gco
zh02Q3n_SoNMt~Yhyrm^^8u7xm-Bp*R)0CF-_72O19HWI<9f~~y6}NUgQ1ANvfvF1W
zgDAv(b1y^b{&1cQYO@7U1);z2Thcw$w^w1Q`+>HN2IYR76gR99*gE&;L<?Sv@p@NY
z4khaOTB5QWI(x05O`DCCH6OIej~br`p@u3z!K>r@cW-oSG+meW6s_qS&F*RFBfp>W
z^Go}vLuc$U1-6O|X|VvOndb!0`4Vp4eGxIQ&O4V<$BFB<;4J<~J(ZK<0tP3>I|GJ@
z><XC$s2`DJh@VNWGjvX)KMIf-(5t&Yr*dy_`8PCs59GPbjBFRD&~xlsDxmp1=GTro
z(Hp)G0S=p+{r*P-@)r}&_%ONpZ$Eq}VNsS^L`zFcLNrP(SFGt8&Hiild5+oV_uHE|
z;n;~!&CLzt`w!wQ7m6(|=b=e~EgVIf9R$fiA#EEW-E=p!rFL7$(YpQJG2P|;{GKnz
zgTIr-VlFQ2yCCH=!>rm*RQ0Ob+GsX=p@l+`J9&}=i#RlU7XwZFFOcO+69xjZ3>Y3A
z-TmOY?mx_H{@$H?Yii6=A#etmCT3SlLBZa+Pnuc`nFl|^gKYJ)eJ?!73vyIA#V?03
zDa-pSKVunhm@DZint*PP%m+76mb#8HlNVtX5M?f=OwSCuDjFE9BOL}{TiVmwT=rXA
zi(DQX@CQm|rVZ`w4T;%S&n12-iiZuKB^_5=l&M2AG9+l|*SKM_=)^QZ;h%H_ui4>i
zpki-Yg*WT2E8~_#1WydsK|yRND==YcAlB*-1$}s=LS)S{0&Ua}Rox4j9|y|~RcR^0
zFMG&@DPonf^l#R<EY{=F+wT~&LTt}g?wU<cxj&{&``&4r92D-XR?zWtid`&5@d>Pe
zWw^(LPY?S(Zkg3WQF`VCoM^bD?R|Z8Iy%iKWpA#&yUt7!>KIOaz5LLZV!XkN!aTj&
zGX}UtWpDXDJfIffzV;CVC&UA53}xpw^DpC>yRwAx6V{0P_}P8}X5#yQn5wC_xg-uc
zRIO~uI{26rYD`<~&CdMGOB=s;(1WIbZ(dnN#R|}*&)v{qR$X89Zy=j4&GR*!R|9!*
zBLtU~!MOGER~6fHDRrx)uUcV0d_M(@AJJt_U5v}?1N|~QtsL2*L`7;Wj{T79fJA`v
zj(Jf}?*x-n%Llzb0wdnVnrjai_QrrVIH?vQY~veNtic?}i}jHRFSK>v2PFb53~Nqr
z3ht2o7o%;S-?r?(rfE2uRO_HHQj*Wm^a;KcR(7eY=Cn|7N6k>nkotmuhtL71%gV<G
z1C1&9I_s%+IIB28bj`OPK2Kw+zYBAe%f|BWgf#zQI&NH$&o#}#5SJFVV&8ba{YtF^
z^4{2{zj+gM&h9=7yNAb6+Ue7qid;936nE~uIIlIUHN?38!+@`zD~E=nJ+8#`bOqF+
zkq@EuVTU9AZ)~<rqxn(p^9#!300e@GdAc*HVG-rJqJ8OCm)wu54#+Eb;M)!c-Rl!}
z>XMj#d<%vj37N1)mH=Dppubp)B~vWP6XVe4WmVc06z9s!ABgJ1o2BR8rQXl!T)RT=
zcoFD_c6Tlt9#otcGm*>kcg=82+N%SgGeSHiB0|`Q7iE3)SJtWAFHdo?-afrC|G-~&
z@89y^ZByo2Qf)riwe^y#;tTn}(8tl2;?@!@nyakO-~Y@>y+{0Cn7Eo{*)vC_05kPc
zqPg-j4dczXji^HyKfw*WA%ExrQKWt84uYEL++mB6v4wr+HH=b8bJzEO-O6SxVldHd
z0JGRua#S%nN)AWu%oX=AI&>oWwQ$i>IMXUC|53+Qec#|lZvi%c46rd7xBr8VjnuFJ
z*aTJZA0eL)NcaIY>2?2KSlK@a*}y;ys=QS8vS5Hb5}U5#+Q_j5-Rt!F@XU(zVENyt
ze1qn0!92wdrEi#1g^|7z2Wkh;FUu@ez62d{WGOjQx8<U29n-b`xGHuhc}7O8P+1~`
z&3N7TqG{=_p`+&|-+vQ%&fUOOl=YfC5h6RVwx@Y2r*;#ihYo`GVf{YNhY~f^hQyi}
zjRVWGDm$}=@wtD!CuUd3Q5*7}(5s1sm43Rrw(-P#PZD*_KdMIpB(%`lmK%_@gl;E0
zsS_#NUnJE@<4D{IdYFjWN!jmyZB}xcNZDvlMECceb@*rCGBqD)`bY%s5MSfU30>>+
z2URQqOETcvWqu$`uIViuUGKLz*X-W;=Hd=%Rz0b^e_ka#_^9F7j1L(?1ol;XX9_Jh
z18jehPmyo1A?0(Vh*Fd7%GDRY7Z#LKH5V=1!T&29GlX#Ltp=Xnm?hAO-mYqiJg(H_
zu-xighUKf2c>>SZiwMLbXL|3c?)6W5Dmtn*ib8XyEt|0#r9Ltoq%z_9tbB{M5^;l~
z%ax#W!m#UximllK(>4eKPLqD|`8Q^oyJC)%8HoG!Ak`({4^I~zf@_ubndUu$ACY{W
za_7%Ye4=zc_;pxGVEKdO7q^UxzP7GuEI2{V)C;ennF%yMN{yB){nCaz&J)d#imfFP
znDgB}{7-L7<o7bSW3@Nn@4ufsyFtkGE9uXm_}npQ2E*|DjrhCl^PHK*$gmBJ%Y0@L
zxQ7o9ndFj&)cQku6s<i=_|{JrR(j1BWcW*>Pb$rQ*>zL@gSUS)`)=ia|Ef_8TN}7&
zY$Hv=E4IT$54^D+MQjS1nS~c=gWCUkRaEK7c^3b-W#8^184t(<qk2x_RO1zn%}H(U
z359EQp8Zx(=E1Oa8|7YAmUnLi3exQsT>H^%<TT6t7EaUaAzF~Vr8$<Zv|!Vd`FSa5
zzp8gKLUdBPrY~#qO09j)j60AWa{gaWb=6&?UWhjD+@{{+B>}6h$3QE7n6Wsy9&-O7
z01(%P+Z+M_Vuir<cfr$sQO5t}R*B@7c-nueEOwG0&xz_r>sY#VBBJMrp+6IXr@AH%
z{oDm3X7u!JYo%7(<pdOJapoph4IbAw!d8rus_Qc!sCioTMMY$)(GS)W<2)TBt@)oS
zqVY9N2P-Y9FEzspz^I7sFA-!Ah~&qNBD!+EZ!N@uFYM?v_8{#z&A0P4uAuBMBI*8m
zSI0-L{G0S?oQ@yHvDeHV?Fq;Q&USrX4%X$Ljx&rH&(Tl@Y}Y690%h&<4=FZ(aXwX3
zH!#41MUgvoD)jCdCQ)DhXKOn4e6if4Ox;#ruPvLn^Sp8Nn{t7m%w2pU24khUPDZ@U
zqM?rqj}v0SvNXDI!R+e{H9jc82dc(gk^`CMKhyUTeoF%P0ms0pQ@;g04j%u$;zGx6
z7xwr4k5%s_6efk``mIRnA{UrF5Mc&eg8XgXTrj%vK``k5W{8*tD<3&R(m!Cl@`Ml|
z95u%eYB9@>$Ev@1^TrK4GnlgYKL`j49zf_D0&ti(I3OF%<7l|_ESZ&M_v2y|+0R}u
zav%4%;4?U<%c7xde4lIv$HyHYOp+3AL1Y|YYVi${eOy%y2|7Md+~+q<2H2c;zH-G9
zhNF{7MOaPAmC(M-aV~PLdyicTWFb)r%7@QiKRs!qGjR8T(d13>7`nq9UFSW1+b9%G
zbPgR4);51Sl1X`5N0M?x?R5qcP@rvG!(nv(q95cuL+^K1wj<Gt*b1?q@n+v?VgNvs
zhL9}aXIH?hLPrrczV+x83tt{NOEeVNV}H=i8EQ%~qCMsKjSWs3N`9{M)X&d0l|5bY
z|I1f%xm)r-kS3s~{_d2FD%%r#w1t(=gV?2%?h7x%<|^nZ8ydri)k4_FnVkAh;rl<+
zLPG|1VC~cpl#CQ~pxa{fKXW)aA2-yYSF?|mFhOdOp2{_fn9dLIBr0Ank1dZ|t#(<D
zQZt|X!;vL8R$5s4u_`5F<4MFxp(@~miw*@YjcLW>z34&DUxbu0ZYP5Y{18I~WPyw(
zO=%w=>Lly<WHjutFOJG67d!bU1qJfEI4Q%9)P_?Y`y%pDl}2ETKLik`;lfyhTsNe8
z@o3AS+p`Sh5o-k*-5;!kb&;r<X>xX1;Ax0SMk>N&^?T;vVdX_BfMt_X%$TGjk8Px+
z$faNM<2UKRYN?9#=i>7hC$noZFq7m05qlwpU|k{cDg{6<Ue^U;xJd|3p$n6Pn${A#
zHIvu|by6GouiU-*!9|b7t@zNeOmP|;puJc5zQN#g=2^m~jSr#9;v;O@*KeEU<VQ>&
z?Y^)Ng{W#Y>@O!p?Oim3%B%zYp*tYUAkG#JfB0M1i#QN4%J8&^G26We(qG4KJVu5&
zIix`NBP|Dg1)fF^&Xp^F<%b6PyoJCCJ1R-L-rB`%uay>zMbAevf&7GGRQ6|P%<vH+
z;34Rjmq|;z=6Sb&ltA|VO<oWti=LJKy`uYnrRROx&l6RB7Q%0>o}?XHS(g*CmdchJ
zvIGgz^{fAi=im*G2MOz`nj86`x_Wi-3|4%<P56__r5BQ<*!SzuTb<u+3mfYe$VmQW
zUwwnUf1Tv)P=ITGLBXOso0VO<MFexg`g%{bHH_e-4-11+MJTqK=e#bcITfCWFp|A<
zC~NNJlel)hFqltog@x%G@w5&8n=e?Kym__%SC~TyB=mf1_C!QEIa#WFYFFa_)1Xnk
zlWr@ZWvf4Zhv?4M<o3qA*;;!L5pnDp5IAh&0eq-o+xG3se*%Y`F+dcSl|3shL-I^B
z$tC&%wPl@9!^f!%N&FnfY#L~Gm?-kt2u7cQV;L%n_286(RI@5zo9s3sQlHGZbnx>V
zegoMfPb6e2y8~Qu=LV5(5j&KU%FcKYyLOF18E#427-Bo;(A^&u;?cUmn9FD?Dj=y9
zh_;vsI~;BH{MlwRk!3xOgi?ZKN_E|SzmS?KETtUAu&*jFNXal+h&S0w<fc8y#Y1^A
zel!I|r6N>ze!>G<>(Cc@ueH+7E@_ZwG?VajhSA^^jA!CrQQyc`4S;AuV`VKL(u)o^
zPe4RthP)V5E%qaeF=TSQ)Spuv`)&`k{5Txg#$-_}AjzpGQ_X%?ok0TXULKBvwt3*@
zkU8Yi^><7^VvARIM5vt9nV)MDkZl7V7s)VTLRuiy$*Qu_5O72D=+xaQGx3#$?C51-
z21pR1sl^pe{I>#i0r+-~iWp^gnDCV*PBCo#bl|7$D+K}%GP^+SHlrlC-+5ru@ke+t
z3`|Y6p2@WSTeU(Xdnsou9O#!WD087>Dnhc<5HfXus4~K?o<S&%mjrGCA%zmf!IO$c
zP>&X1&|+d|_rr{|cPTHhqLF_CqKZAVFMjsT@N;IHC1@jhEf+vO{bmWi=`{=@hIq*t
zKhIS$p#uI`!iEOzyM$eOh$%xMr7_ifHN4rrpr{^HGvJbXF6e5H94-8rf~%|EehoF9
zi>=vy+w-PZl0p@7L?5N4OCoO;pHYHRUosS69&^8CfStx@QzF)O#RG*;8R52DZByQo
zyE!w-Tmw(7xbx&Lw`=j4We|B|_@uajk4y{Ad&BlTFh)t{&p4h4!qY>x3W;%%me#vH
z>92usJJJFK?%-dQB$%9+{ewMN_~oSnv5DM+Z-of0=*PA3^^aMqc`*0#@GgFR{?pY%
zcQzG#&SoBUZ5V4DpNFksKw2aRnwN~_tme^&U#<lG%h-`!UBA@}ev9QOSXDng%E`QT
z?KVUJ7DHkljSxTRXZbMnd-?eItig){89OVKiz4GTcU$#WZ_Vy<-b&uHCZ*|vKR&<w
ze~Ys<KnaQHVqI5!2y1%=(Ihh_7d8}(BO#_PgfeqW(BUEA0}g3fipH6j&u}}Bs4kMj
zz#RFhH~xClt21y#7vgoqZy@nskm=D`VLJG}{WXnf>NnIc3sEy$ym+xM5Xp4t1nt1w
zPEgfb(>YKJW5pCt;#r7k2M|SqCR35k+tD_4bO#MbZ{vCTzsJEa11s53$thv|1mdye
z**ScsmgCJYZL_0kCuQ}I^mobbA#AxBz-O=UdNKh}PLh{^wA}}=#?mx<_sFio`OF!^
zD%w2XM-m4_WsqD)^5+!wCNp-F!noWj(aj$eS05k&7&T=bmS447M0a)bSwWVqn{K)H
z$+Kq-eM9~;CNcohk+enph+VyIF32}N4bY*?)Q_Drukd|Vczl<|$A$gHdVcyP(hS2-
zA(B|o-jM(Dj$3GxsN&+;_%C$%cgkH?iX7>qm8l}Bk{DRzRaHxZJ-}$&M=lD|5SQ^M
zw&J6TafJ_@KmUWeqX+I{Ll_k%?U5jJ9nZHfB;9`Csr&J}r1v)cGR2iz?K)AeFAo_%
z!|w2g+I!?-!VMV0nAiOb^)rrdeIJ2UCi5)Z3>cx|eE=NL<d!}w`5EX8CCtsCn9dCK
zGr+m3ORLidXP!>(Ge2wea>v_u?^eQq!Gr<-=&Y__Mpz%epy1K9lY$B(`t}EjkeYt>
z=juS0wC|QeBqwhE5>I7BbnZQ(9_H5C$YC2O4r><CcjI}x@Wzb8>pyYO9Ai1#p=Kn8
z3L-X}Jcot|<7cztHJ|@Q=6IeS^DsVM05iNNGMD@W;!i4>t=M!y+%M8PJS}Pc>)a~N
z$XDqfMWA+V%(}GQq%xENu4qa=&<k)o`L<+TI-+WyN@BF|xE54a4!S!+Vhv{Mq&+0$
zNHL~DKaA#5w~&gn&cGpM<uV<M94}0EdpF$?HL|l)Q`14)`frR6@1P(Jn;>m-JoeD{
zf_-{x_BU7>?f|*&by@NLp(q`c;PrE|Hs8@nU|PM}bl0FW5T^eAz@B8<_nVEhtyeml
zQMhPM#+vrrr6W}p8Eg<1@7IYYE<<*yo3y2|)rnt(QvYqM@vM#B)ri*34&ygW*>kf~
zWIc#3+(=gm`=ft$&IG2vpba_tw&02Xvs+196~pWkP{ols8}0B@>Ne7dpcdrYut8q-
z=%zco;^K|%l?e&{06^m*Bq?qroq2oC$VyyGe^}KHBV6|kLXHrU2Nhvyd{XW;oQn|_
z)ah28-oSJoLCCTFk4AUo2clHxIBaq@^<>m|_Dz5PB`Q|Gb<|u3S=b}z6}kgr^K4T{
zvDm6tU%2Z%wtpkDs?iQVH*TbXF>vlSK)~Pe;Ex9Amf{^k5I2L%%x|q59HPr{dtp<T
zy}4F`kEG&aEAc-$%5NWl<>c6T2<FJ@G-vbkjuDrFI@ZQ4Ri<!@M;3r=FI%bow`}62
z{)dc>HxMEXTxoi}$2q>XdObabuxu2*+tD=<5Yo@R0h2mx%ZGLKTAZ<mu>{iqPbHxO
z0&LoetZxE|N8olm6qtCQ`4n!h^}``|T*z-Hc(o}<!X0hz`nWvHWI>(G{NS}h)`y4c
zXb$bT(6lRitkp@hHK|tne;Id>H;t&~kSqTy=h!Lgvv>H8$C)m)D2(k>ja@Y}^Elb+
zu!XkHLup$_*oZC(TD8@66B|+K7J<LT%N^1?7J`w2>{HM;4x7EZ+(-<Db0UPH05rLM
z9XcAoq6AjYteL>l;R|vN$H54y!hA)b*}%2#A~y=%GGJDN{*Qx6X)H(C*f;UNIhb4)
zVG8n3E4!&DF}MFmtTKhfVH%$~a~h{ZCTjoQ@=RSJA6##AVYPbb+7Q&9Y*?~<nLzv=
z-o-@5fK7oBEI<@D1Sq#-m8zX-8@qS$$eo54Lxm9M@YflJ=MjdM#szWO@HyTs>(^5Q
zpfO3-iFKiz7v5lV{SzItqUL5!_!X``IPu%rz!z){MjIO&5aV@RWh}8a!0yNg#1^7K
zzn5OvWM1=>!R?w&*5D2?F-0`dERnt%`z|gRBeD_JokX5WK9rgQ$0f<CG{i2LD3*%Z
zWMckpm71F!lf~3ac{<U$Swvo|ZV6GK_FiG2`pjRL@lp`FmsEO%xjT9P(|1&Sb|7QM
z6tIK6m}8^Qna%r)R%)orA{-ALUZ@YC)e#pD2e<fP<m}h9ujiFobeSt??JP^Zw~G4M
zP%yiBLC+c)74^I3-?Ejb+cFNpQS`-cbEq5QDOCrZ2f&^Wb^Ojg(<KM7i`%v2=<2f@
z5)&_?mx4x+`N}ZrvDQBCNeN3?7~l|_&<Pj<7ywrx-FFF%%^CBfuhy`W3Drlq)SlFo
z{Ts+n6IRHh#h^04_{05>k`fs1d3y&Q#QLK@OCld}^gJUSduwcH*s&T#R)r)kcbVHF
z>g3D6&7^+Us)4UB_y-d+!)+J)IQ^m5IUVJwCrUoZb|GF|?Gw=UV7UTJ`N$$ZK|uyM
zq%5tiab9$PcmyEX(x99JmDw@^DJU#_V)k)A;^Y6hhv@C^@2`GFD>n1B)XYc?A#e)_
z=3N>*MR>Tbw*I`a=Qtn1{wXs%Zbab3h!7b^l<LpnN?9Y2l1VajZ_`RR1tD-Di+)(9
zd=e4_U8aW=Nv9q><c#7V*|VT4lP4(Iw33?`yI}v3D`~X>|2^t5hLlH7Zd@UTpXXPP
z+nO2q5G#hAK<9MzeczbY4Os<`&SpAo!a}<-X3#^(lZofbPj{6qtOTfwO$c}uiFv{4
zI}RN?whFqA)z%rhuP(Nn#0qtX$@?{`Dk|$v94$*UzUJo2#YEC6)WkwqOQOFqZnHrf
zbWyu|9$-;)yq;TxgjRvtz7hd2Wa$Sd@ilVp8IO(&)TMsIK2)QE+Td1yY>!<=7()IE
zT4{5hzW$uGIS1|nP;|*IHG66xYo(T6Dw47R>41B3-TMz8yx_yaXMPFNI#u1ay5$yT
zX^l_!oSIdQa>p2c=N2qjskH7n2q=$e|JlpF{uPt1Rwdr%_!m?3XeHBthY-uYOrv~=
z*%ktv>71OLV&4gCV=aRiMRyF?)oph~|KjD`&aGEWnisT&Z*AzPK9)E>Sj??*zhUl5
zA0T6x3&P?3R&Y8i&i)z!@hDQkle9NNxV1>ii-~BS;AX?7&HtCsBG>vgnDV)(8B&GR
zid<%k{y_};)T&f{L3IvKSWOnF!!VA7ACE=Lb?YGp1y|p!tuO`bM^NDtp(xe#^mKK}
zV729nLh*2p&O`OKRWXDe?QRW6p=N=KWAS9UANN;4vTVCTv<}R3cd4Nn!*sf3ymhnL
zTI`<hC-ZU;eSYuITz`wBuKMp;nxCfHOVAim-7Bxkth(-muIt0gSwXRSJIA8sbuAR^
zYVPUWGcnVAdTt==YV5ZQH9ChmOum%z#b<4c4ENnu_+EG?1WvloR8-g8+gU#BlJh+P
z`<lm<6BWN6m{z=(xY@|eO{1uDgw%&`(^E@6@GN4Vxc_>F{;nBA=r5b1cPYyG?+V)k
z0)f;qPClN<c6z#$C0$L^ox-Sio{rHYiUEVfJPzRU4xE0<dhWxiG|HE(%7TqN49-<7
z6pz0?erI_~{gk_0rAgx|?&Ut4NS6{$+S(OQ0c)+;8KXic)m+C_uDH-u>N#J*b)(Ia
zs>GTt^lS~i&Ssy&P}Jl}`JFu_OwFP_Omzr{&=1tF)W5NO0o<r!ILf8e=s>m6nk~~w
z;&gdAX*0{a7Qj8)BlpWLdu0eENWtK&oWK<s5y-NL?C!Q-C4Vs}nW~X0yiXEXcIT~K
zzQ^2!btB)TK(4^;>WQ8ocJEt*D5(nV6Zx9sBM0VNom)fRZYzFrbhB!l3U6(e#O^%S
zt54~>HlYN}067mNMe>B7E*=teJXRi_caX1;GwO|b>4^GP)y~d6>)C^NZd)@?*zwhJ
zxOePLNEs=i+<)|TzJu__I3)Kn=bhal#d^^k(oLdePlNXvn3n{EKjjw}UxP6bpgnh3
z>+J1!%S?8!&z|`Hh~kC{Hc{wc|Luhd=#<OEnQi*H#7!KWZXH=#&~nXqSMHH)Z>_ns
zt}F7F<`FY|ej(Y`oGf#zE1Xg<m3|N2$6j&t^Vhd`0+II)a1C}C%mj@FC0gLUdo+~$
zkm5W~NC<?<8Y@t;;vhJ@7cX9HNPHY)B^-W7bzHenG<(#JZx_`X_8;!br@H^BkJHPS
zIGh_kba!iAcV`V1=Vq_`(s#POFAf?KLJOEPsST#@?=RwA401W_c<z{H46(%k$!ihi
z29GQ^;&{L`N>ks+BFgXLb%<uLd3^1(x$;VU4c8aHfVpb61&#P^371&PowUdM9KAT4
z_q@uV^eZ@P_}22`4^&O!b<<wI_D)Uxy?*cxpz&lXErF25a%?~kYaug>V9@oJE|o)t
z%sKeTlVGSo>6=1pJ~?!{c3e5Hy?}Q1<H~ZN+ioG@_iMT6q@C?)aWUS|&`@mjYfr%s
zHS%Vn{M|cYtPhErWznKVTefVWP!RR0@t_i0OefC3lumA25$!DHGe!exro4-Va}_z?
z^Ykuc-9@x*|GaO!UQH!tm&1!YbeaK!6_ywGLBk8`Sa{BCOimZ}LPb7|K2V&zzSy#y
zBD^#H^QA4GF(OG!`{qA;X9)er#5*VM4<9`v9@bbxN9Vm@8`(NKee?oQrhV5$S=Lk>
z_4n}DA9TcSkzVxi)0nu4;udswdQ4XoxB1j!IQ8C5Lv7a7?0W+c686U-n?;7|)810t
zf-k3*`0US;+qBRxd>3dlasNgCE>?a98aw+Ut<EsFRIq!c529R!UIA)Y2k_)$&G9NN
z6%qD=CtpFB{Mi2Cz6d$wuOl=zdP{Ij^^Wj6dp~gp`&}A~rcgGGjh1Hfy3D_pD<vNX
z2E;a3$i;qa-zqD1Mf7IJ<2bQ%A2*PIg7Mz?B+`t*V+!qNILyRYQY~d<EW>&?FeqpV
z7Mt6&DUgNTfZnzDqaVkTIgevBM$JR<4s%)R6ghc)i|pa^L_o*Kx2)tz*Xh!m4qNIt
zq*_Y2^lvg;jg}ajQ~8au^ODq)B%vVg-3VNRydokiF+nea2#Nx={H_a4tl${UlZt3>
zt`~v+)tG5FPu5jN*Mrm)rM`w07SjFY^CMq`{&5QfO?4^$S}KpM*Tt)&sM#xeQq=kD
z)>~M7e6lQe;yWjn4w3j7unI#eq_JK@af39C?MElho2N<@WuvJnCL<OB60U=PXsUBh
zKj+IveTn$ERH`9iW9}NZr35*vm~b+6A26U#ggoXi>?s`{Cw96qE$?AhnH~?Z(B41r
zR_eD6Lx*jt)H&QE7A5?gctgQ;h`bE4>Sgl}7QxBmax@f!(fkz-7YJH{T%j4;QAv}*
z!)_<n|GZ)#aAlIfmQ|ght;rdw3%ox5HLr_83G|R$XRV^>Cx8P)F34{9#`mjFK1P(P
z$m66@&-F#ZVx6lo+Wv+VcckK-{`U47{R)K7&gm$==WYbB6Vgqk=1YDJKbso-s+JmH
zh}z~D!AZV{8V&ZG7t>Wsw(U`8uV|Zg+Wh|VN5wx!<a(~nPT8}JW6=%z(fltREe2%B
zsa?0G>X5~@Jr3OEMna&1O0_K8IrV2wd9+hvyrFf&(nU8`3>BBnbwkA~U+adyw+0Ln
zM+ms&ETuS1vFqaop866ue_9v_?hk)BfnylVJp#NZ$VZ7nW<cVG!)C2l#IMk&qD(tk
znkw})ANzC6fZC_~Qy0#N^Rz`Vd}kzLdoz0a?hWkok*RAnd1C3i2Bo`ve#*2G{g1qH
zQ>3y<N52KIl6Nj&?(m4vb9kr*d>3xYZGr-Hr+@CB1NoO&G2`~Jg?{nJ3YG^Bm-LrY
z+M`ch*kR$zLoU{Ok@%z~K!$gMf<TyINe6BR5*?p%Pm`sLt2U7@MbhNADy62(jAM_*
zIM@mEjj?<qBfVnIk`ahs=^**lPBz%<EO`6IEhZ{D7o{@qHlS5kNeu@0NjH-u;J`pb
zi>D8pCd)Lk$MpCq>mrlHW~I|#wtCul?Q_S<i=bPeg!W+C*L&NSe#O+@B7tq&ib<gw
z1$FEYLfYbczil3HogSjiott&C9c;~!S*56O82PTQ2aE2>LNF~etEh#GJ)a@0a4qM7
znb~lP!1zy}U6lM+E{Gnk$-T@{fxvsWy&g0WK1UH8?7@R_sGKshuuww@7hAqwWa$rD
zhV3Zb;~%|3Lb%X6L5FM!c8Q!QekcBZ(VI<+06>x)0w1g=45oUk=g-2i?U`XYj~4Hp
zMb~}iZ#C<vNn9+0;&$_*iTAVpzxf|i=Q|DN&>|*AH}?uVs{QB!=L1bcwz{!L{(Lb?
z--sqGhWg)fX3~z}b5Vopu8R*oRvvF7H;3JFH2{?%xm@dN!mF3!N-lrRRq3fjvyHu#
zA!<KSop3C7+F4gT*;o!(k}V>N!$t}oxeh+j>R3x5J?2%bXiz+)xM8=A)vQ&2lc=A-
zdJ%g3XbVs^@J*|s(~b=>F*m0}MoP#%t!H8Bn>TDAFqMPHjwM!4BU%bkB2GD2vkJv;
zrY2`G6~-zb_Wml)f{WRWxkZ|+N8X%G5mP(*e5QZpDy}ymVsbYwN@C~@zl75uwG+&u
zU*NA+L<R{7lti5#%*?rn;o%9Tr|q*{sgR6g)xdK<>Gh1;tU4yxGmqmrjVS2R2tPd*
zat#H6^<c<g{fk#k4xqtfef5rvnNT!iB|@ktMISySD2$zWb(R^u%hc8A@#|?R)5t|J
zJDBQ=;H4>m@N0B_K-y0pOKrRH$lZ?>SM<6y%+;%czCn2(D$R-Q&psl~e{zV0bVotx
zAsbU}N!hSU<K+mbh?lBdjVU}|DszN-@=jP-n^D;s3bxpgY?9sUGz7Y&l*iA{Pq-f>
zGVGaMx#vxv;3@nIfxsw*NNP+y&Bf+&mw7$C2Mt3Zf?OhJBtA+rPHEQE)UY6$U8>3_
zu=?!c?=Cj0oGQNN<Gf`=m?~*g?-Ainj;gLMX5q5S{q8?Lct`Pa&pp(h=v#7SvfPo9
z-{;!r`-ytbuBJ@8p--k^r_u1!etn)Dws%Wtx5?%Vvk)V;{10fqcMYH5I4&J_^h1sn
z@Fj^N6^zYU@keCC-{sXI6^-nw6LjVt=*2aABvzj#q*_$4*Kgdo#Ka_MD$j?W{VLkN
zUr=64uw#&%D{jH56Wjc+O)=GH!!_f<Oys$&J)t<W%k75G$@RjfgD0-A=(AS@`!6p}
zCeg`}-leTd0sk;ub05X~4eS$1LP2wV5k*;QXfe>3*FoHs*%eM67j#%VQuIB$KQeYJ
z1Fk4K`2q+GdO}u2rsM9%)N<(8r=0&J5>lUFBgY7_^g~heI3@Ul+yVkBscYWaV!E*y
zI8>Ontij;orlMcf?hc7M0%S`gvh2r)5n&h#th%Z0m4Q<9-nnV@&dIdk^tdv$_&RL4
z&tk<H)brt?C^%3Lb{$}5Upneh$^!cb`c|3`?qNxc6-@W5Y)PJykZ$gvlO7G1Hk%bq
z1RFuwPuO@H2=2BkwPU*9lzu%BorH!4^)Q=&W;<$O6gRXCh=4*_X5vY49W%4W!yQH_
zb&I<JSVIXKRKvHFUf-S@Q}e6WmUV2ZXHwBY<O+W(O;Z1{LdHWG1g7|{ah+6u+k7Ce
z61UUK9)N!_hn}wMI6`rAWgNJ%)w%hQu15d)&*{vN6u9~L(BkrVqw_Hj9EeJ1QT^S>
z$Wi*TQifb|5-@ZYYY(iAnITHX$baP7w>opV%{A%~_3JQoPh-yC_Th}S#OSi=oa+cr
zh9l<z62I?FkFBkr*2GNgRKeKcoV_tIZWK@&AM}hmFv20~&j<Wn#(fI%mm#r`Kp+zh
zL3|+^31H!#>}@o*ad(#EhYcLgpZ&^-80?OCtCk@#+0b|HBxD-1u*@y@)Rf>w6dwAa
zq9ZvB+aJ#bEeL_JuJMgIi6;ZWF-gPLn6ym~2hqHYV)@xt%b6@9R@6JBY+$gksv}y|
zpU-U1kIyWp7|bRM-EVxE04*xBsy|ko$L{hom>ekSG&srqeB1kE`zx2EdioGdjNRZS
z#EehKK0Q605>Igp2puaM=RQTGukxvwic_De#O^RRm0A(qRrIcqzHgJQ;vCUDz=sT}
zZ4uAM<Zl7wFl<STikc2$u4Jy`pq8w=wlBK$2G`KI=z5;|RVLc9JJ!rK1kNpk!Q=Kd
zCaU3F<&xK(4-l$-V6OXGbp-i9Z|MBYlukvIj&PY;e*JuOSIVv;Z$IAdnh0b}%-;!r
zh4!4m<H^JFtDs?hOV=VS(x?WNpYK6M`fm00*rGhWDC^NU9E4EfCrl&1PS0!1t|_el
zIpBJn$@zuI<L&<*;(dGF7KLyhITfK${JKW`a>pt}3#ar%GmV^|hjo#wvM}D-hrIKC
zKtGPnD!uDf?8V<y?Fg?~A0$wRjR5OSy=`s@LGydzWa6~NRZ%rx+&cMv+vwxB?jT0)
z=4UFR(wUd;)=}d*(0p**>!%>HjI9?vJo&(={Hu!Rs|&=_PQEaK`TonXZMl9)^j-Ql
zRuopbY0k?xe<Qh_J5DLK@T=f6rb`pMe>@jV{`QS&@xt;>A%WS!MtNoK(R3P{o$LsX
zD7GP<G2a`@s3oP_6Zd%qi-i@wjmJgl`>J9)W=(X8e0+DJkDLE24c%}h_&yzUsG2vH
z6~5Hd0rnBMZzs+(Qaz%u{E_mP+PZy>IywdftJAb#cRvta-=5lXXq-1z<Z;qkPS0oa
zq|6&2KAj7CBk=R%cc=hQES=g!@HXBkd(8g?;}`t39P%z9zF`%oe4;bx1<GXH^DbEh
zlXEd!N8i1evgMwZ0l0_<-(*tz;Mg4->06{85^*bY;M+JAbKyObi)fEuME3lA;P|bu
zN937MrN)AsHAu_g3yyr3ORdOx<j3QcG;{Sg|9mSR`cr;4%PM0X|NgERmAPH~a_yaf
zuvO=>4c}NJ9wcnE_guK1hhjgHeGBR{1$f@g%Py7O$z7nI`nxS^@od?uW>{Ey=U}ep
z;>|kvwvW^<2@BfZH^y7l&E7Y$2kh^eNPZz)guQroL-oAeJ0?&#{87xFGly?9TT;bl
zl$>p?U9QS}`lsC=arS?_D|2*Rb7fed8zW8qs7go6JIhe}9Bg6}nAobRLq7M<r@g;1
zek)LWKev<q=Ho2CP4`S1g?B7=mV7mzmTqQD-@WN+xVpO)=dpF23d>G5o>(u*N6!T&
z3ejcrC8-$oj_&l8#tbHQbot)xL=eiSR_u0h-^Cz);fpiN9+wNaU(XSZTz@&gtZpGG
zd;=Kp)lrIMn+YZess}RGttfc&N=tL0_l0a`1r(2w&SsW#3WbQ5qmN6g>Cz00&fPq^
z-7DPGsY~+wGO%}%_QGQIQXVJv#Zo4THF31wH?)bmAErK>*xkb$y)hG`Jc6u93W9AF
z5e;!~yZ&s|1Q^2sfJ`IeffgNDR5N{&lC~42#wtOx+%6rH)BakcPdbY0_9Ul@l%b}>
zRF8eL@0+_1Aix#Po?a<Y`W$c6MJQ?Jh2l?Av1SF3h^zpxkoEQVC;lo#>PGlf$ewQ$
zCIBV?bA1B>${_L}l_4}c>l{MP92V78%no4D8VrvOl6ZY=#k`%E#?~lUe_PpoJFE2j
z`q%E=Jo@u@ZRlBY2j!n2(AA4Hc3WDwC`@bD-T)x~G?rwHA#FgvjgGo<=S5?W4K1Pq
zHr4+1T2IwG!m`w=iv=i0ktHjLEZGZ>8l3loBHeyylI0TbVoG>=y7oJf8=5YDR2_Tn
z1UhD|MV?fna6Qk5gxa+he0<WDgE`};wr@BGN*FqVhVXQ2Jf#KM9jhDXug-O5qUa%@
zPk9vrLjyGB1N7STyq0gbknyTHaiD6;yJQnXW!o|0G>$xcn`Q(QIf~n}XV31QS+mh*
zk7>I9#F~2_boOi94cKYk>OGg`IRBcBZH3VoG0C-O?mx#7Xc*0xfCfOdgm6%?wV}G2
znH1@iHWeX!@CMj~xlN9U0=>Apt>k@@THr0U8&5S&($o9fmX7~acRo*pXJy$T>dBli
zAGCI<W9WMkmkaAt)j3CqDeO*p%OogjiNQP8=D6yUmvzjwU&(_(v)!-0X4jr!U*hcg
z!!M?zcC2r%^%s0G=gh8PnKw6@H5W|3Z)yL9ItkZVDKr5Q*>N4bBcza!-acc<SW!T*
zLCr?aT|+-T6i!{cuG8l6tJG`q(^9OYIB+SPo~@tgqvfKd^^tV_85?k>yXLZ4XH$r^
zlAol<k9`s+#muj=#JBBxwsH0E#AExP1q4Vli{6}cnd!4O6N-~XK3#HZ>VZ?I>hvGL
zV-ECRf8f}Kx;Qop!M&zmnGiv4-mnkNh@s<>kGeGBevwN@k8VpI_$Kpnx*=(L2`>nT
zZnS<o`6Rr~tjQS=e{nH5;;4<zd5#9Q-Y<{l@4}Nb5Mvi&EVRyCMpP=wP3GBav0u6y
z6eKO26O&EFf{-%9W6WzWY-8rCrk385`aL*X9_DBIZUw$6dv=8c|NW!=*01bdmo(H|
z4v#isnU_v~bi(9I#8JmW;-+OCAonHeSj2x*@?l&j6oj)~0XJ_dz;6rkJDxAH#=|1e
z0B@AWJsovT_hp>Q>$Xm<czj-vnT;8vvs5bu%R%LjVd-;0*ehWPMGINPq2LJRzS!93
zS4D1|;PElP^sb{Naw{2yT2hv=F5j6GSF@(O*$Cb?pCs2#QI}~4Y%nA7T;a)(LlPyB
zfy6RNK|ymR+W%1@bEpT9Fg|sDHcuv!LJU$6$+_s4y7cbu{p6tyx0Bc+9MuFcV|Z5x
zW;B5E!F_bo2C2LwAhBWNrK+x89Co>9%gc75(&yLrUkqH^ughPQ@rW9#KIWc1&i(F_
zC$)@F@|1(-1~RDArlw<W98nOxg<%pcJ)*e9d)?H$e2{;KOXspD-&Yl7#Io5dcosC|
z^lCr+B`&t<rcGzNxY&xDHbv!c-&S)o)fW}*zs)gX!YEnSTBmbq$7Q{>7g@`zXI(o!
zFEAZ8V}k<{dSZ1pB!#HxIvY&(XU$J5Jq_2Z3o9_KNLN++EB4|Iet23=OeNUjp5gmR
z@vm$Gh<IFqe{DCc41=x`4wnC(BgjY`vx-ABoQ{|5ve4!(Knn#jZKog3xVHpP_qD65
z2pc4rX~i9XJ+Ws;2eGa-?a7nHP}VsaT$YogY!ehT*X@d`x5~rDn5Z_O;S$YNzM%Jh
zdr9MOt2f(KNtBw&6y5Z6OK4d=zh^#V<|I-Qj$7b>qrlUZDyeifn;O>#jBIFV2zmgI
zygXMAnNj)LWLw9%JZKvUx=~C_?5)cR#gADUamZ-fY$=qqSO{~<&F)1!4T^J0p}xM|
ziy{NJur42}Ra0Ju(!~yge9CDfqxHyg-$d~RPt&J$GcWI6ARvg7keQWr!$UC(ax3Gv
z8DZqCOB@C%p33bkXkbC*!1$SI;AahKVYj%7B9Az9vt4;YLSNagw+F0Po|GYb?U{@$
zAC1(W=cTF8YXH}$y%eab`H$Uojt^lQC4fM2K0mczt+{Lt9YmsOa&U0)#UC$6FQ4qG
z(FW#7G2@G4Om&_?1>-vEvCDu!cIfmMGfU0I87q#;#de$PO>WE67NT*smv{Iuqw0CZ
zRz>&ycE=yi;uZcLou9=Q{_7`7=}Rb3Pzj!3@V9@MidS+S?7|qVef|9Q0z(W9fqwrq
zKoM(1jF-aqJ#W;;UtnfGfTl#y8In4J8b_SH1fox%5Kgc@2bn-Z@0HJzZttkevk_oK
z#IfA6Ya}yoX<e=EJJxREN0mD;+O5VM@N#oNU3&fLBJU2gfJh4xakoUPg02ntATb4I
zyLY8JPdkltyQAZRzynU)_Y$JX$N#N@9^35eJHMDjv#H6nw6uBMlc(om;2^}TQ=e@A
zb>!=smoh6>|2on!P_<ZJxzBG@=(7!`+|25U%>$Tr4=O1YqdG+a9%A<A@Nm5SEb^Rg
zaEh%!JCfoC?F+^RS_G^!hPa}DhM!gfykD%eNH6Y%@aaNN{&FN6@DSY)s%<@)TLTha
zZtC;BaiiFC84D>OAeyrFh@h+8fWorU#DM(;dK;%tN*Z+C6{i2ec_RK~%jeH=x)z^a
zY{YnsMU%$hZ;rSonOO|=3D!9nvbv#GKpmiY%kPz{GqL@BZE#3qkfreF(bv<a_J2?p
zn<xqDnEv=7>ugWs;%dCouMen!^>r9>FmdazOEJh2%~^Q(y4eE(-OSkIDq;+>hN@WU
z<?Gi9P?_4DdRnna8g)MWy#0`kppFrUR}70dBm95RNy#)i6;-_s`P)bxNEFEde!7lk
z1l<;BLAb|JgJS05VgT|Ipf%a#8!!Zu2>H7D*y^*w=)+@1iNITp3*s3cZ=O0V^Sq)g
z!3Y3oLaKv3AO%%Nv#uJAQh&o6dahJygZv$BO^fyv7PVIu?|XJ~kz9i2excw_ASB4I
zL38KipeQGw9?x7J|JJPqD6bLWl9;@oe63t>=kFv&vzkY-7k^#*w&tbKieQVD0|I56
z$kOpt1$`F-@Bb=y-h+iEr^Ka795!X2C3LHRG*H-s6nQ!X=}2x@>rymD4m{CG-@bkO
z*6rI@5tqRLHUiNOao;B+8ro0j!)ZJfGp~Q%^sNhe6R3odT+K^_CQv1C@CWs}Gakm@
zU=ncX7J)KW7+EW}pzL8(B!WNiDRuj~J9~St)Jmf2u)}%M7U3UH-%+dSf3&{7!vv#y
zn?|I$x#AD{L3fkanv!*w1K>VE$bv9Y(?Qzq0BLkz&c*%e!8>xgFlOw1Y4QP>?qcsP
zfxa9EowH|u@4aw&XU~8_;Myp3HFd;Z7GUlcc`SAduM5fVI&yDY0ceCIga`$fNDz&W
z2P-^jz$2rK(o+0%NTv|<XGPpV$0YGLOpWwVZ{GaO$Ggp`?c-A3IHkO~$r;S19{4o!
zi!oS?kJKo`PjT^l)2n5WLNuLG9}`qTJsaK$i~ipj$`LQmL@Hhg&NkC9wd*5IRN@$i
zj!MQ_$2QP9VQHsWXnx3x<%=D}4RsvWU_D}&_&XHGL?J>BZzXxIa&n{rEXSL}`7raw
zRtixT5~T`(<To}Czmk;qev+8v>a6;xRVnjrj@r!~eVw;XsL(KO=9E_)aWl06#8BiU
zp3wtPwF^V-*uM*cnZ_pT_kP@7Gx?Tv6T8fjXM*3;m~OQmO9bx~T$A}yf34F_1@!=>
z_uM`M0|wdOV6B{5j>s8rwDL?$HUSyQNI{&3Q+r-rT}o<d2|$MapoPeejP~|EzsLpB
zsCL>#E(r5|u*jt3Lvchl68PUh_;Ml5L^Q77WorZYtwqbQe_dDglKr)pPhrH{uxH-!
z7ZP0U2G==q?XfS$280B4?+lN+Xq0)jnvXQN$%tIzdd&AAhn?e0U(~}9leiqLmdMkD
zWnsZf$1~z%mWC?l50ZqN+E}#|hap3-E+8kO#ux)JXdqq;k9?P^pNJ;#jo9x~2-XM5
z0mIV`Ur)mDuijTW?X41dcwTNoPSXh+hj&`q81?YmdE-iFV~P><HT9=}V~o?YN7f%=
z)Diyksyu!5JDpc&BSN-Ajfvzs(L_QdJo-px+Vm{Y(|L)#^#m3YtM)7s))u5#;Xgq0
zGVMcdxw&~#!b^!u!uHN<u`T~8|H!1#MPIxjy1o|-3}hN8J(KkJPc)ju#V~^Bhp3On
z-QC~F)ipT9$;6zq$W@F`QSbSH{ei!BLdTn}+lspF$^z}O=r25M{?Zo<#vJE;XnP@p
zA;gn5*EueXb&3ZLEFt<gY=)#pWUk2E*_u8lkqE4mr2d7eMKiJR94Hw5`10kdX_)gW
zXip(@rzOS@U?9RHBlnF3HGErp0jWF2rl!|1j9$aTzZ~#;1j&t6IU;^r2#TT9uIn>>
z(a^V%Czx~%8Y;pbJra1h`vO0zs~dK4_@~?T-8<Wm7$OX@&t~ON)_qG;V1GJ|rwn?3
zFQzZ<XNb!0v9yyWmNF=rZ_|9P&1)?3fHZ{TTAso&aedR#hqVq|V@_i&m-=kEM?9bJ
z>yRDHD>NSnFdWw^lefxv(Q4*@?b=ERDfS5kU;p*Xnxrs*M6m(=h&Y>^(x<PDGEwv=
zUkVBL#*Z~Mslk{M4jq?e?n!)|<O-mz^9LldU&Azc0`l|g@mfjsXPp`BWSW~sOn5zk
zvpSWU^ML;h+h?|%RV7QwYRDyQn%{cxZk^);sj#6=L@zFqvmN++0@|ehk*-juV^R}e
z?=a>thE;xSAI`A)%-J=y9l{8w?&;Ki+L12DDs#!wu_MaLtFeYQ#6L(js62CX$wN==
z8qgG)PE*kO@*^|J6Z$RaCdfcnoqOMhfpZfPVxEC$dyEdW8LY}T<2DeGNHJapujuG#
zte;n5^=t@#OVh-lekq=NFX+B*y)~wCBd9K#Sw%;(;L5%^Rkty`%(QjY>>wJ-%<%z!
zD;-OWP`N&-?>b|LXE~OOk+=ykyjVe15z;HFnaW;+UB2|lfoUjH52{Eo*J)fhHHTq_
z(Rs$l%d76Jp8s$6QLCI2xD9}U^nYvhVR5NSyzAIkX*v7#W6_t%kYATi2vHyXKs0M0
z4rx7j4LUkv%TWlKxN?sstkS=;RUC_1Eyqyc?>SoLtk7hl?}h|N(m#c1-{K`p{4mUf
znBQ79bboznT_N<S?bwOKBA~uUdGFpuSS54-M-56b1Q4ujYz62*L=0=GtG6Sa9mo|V
z=#^8KC%=5@WPB9o4Ko-tg$!5%t99Dc)thkr?ocw}-E=|H@3`0Uh}I7&6VXh&QWHP%
zQkkilBToY27=zQN-FIJTI$OCzSwnQRQ(1m8D&^E1Ud@1h_umnla!y>!q~B{&pm*cM
zYM;-15=|Mq4%o^wrc3OK4L)P@*xcmJEneJ<akQCIYi55ZxptsppkQtN%V@CD>f+k9
zU8SlGR*4s6g%2Q~o}_?66eJ}jW#;S(v=n+}N}*EhL=SvSw0oLogamxT%%>7xw}qd-
z@EV)IPYh==qxsa>NOhx#?=L&@XOGfkd8+vg>H$TSm5i;et)eTsGHXw)ewNf)3a`3K
zoJxdZ*7wF=)*k?!&pLVG!i5e1MxcrC9#%a2zAVgl<T`KOtX=<yk#K>u0mIs+cb2WK
z(Od275a#&s(SLM4<iI@NZP9vz*sQ+1^Bv)w+S>``tspKO22sn-QU;|*yBQz@L}Z0$
zMS1PSmI16v9KK<exbqf&Q5AWB?h34l_k~Yitth!4c}MGFXY_~7s!!FUw46-OKW3%k
zjDP4FD2M25Mkkw@^eZn}jq1yIleFDeB-;C4>t3|lsU_gekxVCi2G(i&NM7L4hr9M-
z(~Bu$s9wk7kRC_iDI?jlYq9Prz(N^?y>*^)Fi51J*N5U?Z?;kh_2gjQ+)Z>^2rwGR
zJ>>nR?hO&p<awN~>lO?_(u3pvGBSe6E{4MB(KGkl$jKNG`W|ff16$GHEmhSCB9GIO
zjl_dL!d@k8R7#Kdfk=2TXeRnrMV6Lg(S{m><?#2T2nwYpG8$->`?B9lhR_n<Fjic4
zLWQhcdFpO&b&f@3@AJ>);xBS!IYLUAah#(jE!b-oblYvVj8|Wzf60l|gwZ0&ftQvr
zjX`b`+46(dzo?`n`dwQ}U)-@pA+|O@z6b(Ky2R0oW=1m8px<-gk0d8d>uO40CqBuq
zLXa!j=J1+_V&76ug1>IHBV6o7+jezt8?VD2oA+cG{B|JU&$l%sOO?HXZh*gIEYEUa
zUcIu?K+ZxwrOSfPu=(5;bq@LwyOMuthfv>E|CqGe=(9IVy0g}@x%w55C3>5@Cf~k+
zfo4R(`m3%C`Wn>HhduU&v?QD9GLZ`!=y}}cy08mY5BD^}ANj0*t-Qh`Dq%kHC~%pP
zoW)|FoxgTmm|`aipKo2>K}KP2K}!N6A!XbUbl3dAn!KUK19vsn<rgtGV^w~3p1$zW
zP|m{O|EH7@lARHnkt4kf@2_1`^g3x^*>G>%@Lxp4+b;$U3QJkG+>4)|&?O~U3GG1s
z$>udxoNrv!E)q4P%DKg%ee-HY&xI6p<CR#)9{I`-62NJ+M;cEIM={|6VziH@v0OJH
zdCKpY+u`-XyTaN2pT@2{9Ln|Yj}#R}QnsR0l8UIbQ??e0gp?&E$`UCf`x22-k~%1|
zlO-ifA=zoO?-WAER%90q@8_QByq$A?zxTS{x%xw0nR%Xh?)!Uxm(L<2#P>_}Zz54n
zrOB3S&HN>DO*>Byzo&nQOG8j^qw2Y*hGR*yF(fT#P0x>&0Bs(fj~<mjFF^2Oel&g|
z`=Q~m^2+lB6Qf{%{ZpJE?asZMZ=Nm=uba!xVR|cCf+hE(3d4w7q;I6QIWV<nb-!3`
zcV*HJ>1^&<I_sT(f~P|(T&Sr^z=rj&k9a6iR%JSn`4qjez1n){-Gx`FKUTlHXF6g!
z;B(7g&cM)!G4iQxw|v@{2S5+dY6L#W_=P1`GWH6TO--ai??xDz+MaIeNNEu8f0kSx
z6eTa)_6`^8Ykc%oaCZ8oHQQ&MBa!qyaMFNQXs{*O(Rw?NTpP5jfONYGran3kX0KlV
zZpKg((dtrJJ|0$|2bd2)GSZ0z%DTv}@V4HoYrl4s^Kv~??lSl!J#wBjVHc8FhHOv?
zx%78r9XR<xf!qiAIDOmC*Cs_n@pj9YGjH33zAFy4ER&mS;OHwoaXwI%u~KjAzx2kt
z?$Zy?^AFK|W+OLV;(3`uEC>LN_e14{fiMwcLvLX_RL)in99L7LTQ8OG8P|2XFbhN2
z?JU;Ifzqh*gj{g;Ggq|tuOCp)3CZz>qj<QQ$)<|>C1$3)WlSr8!vXQnJu7P$Wd)F<
zIN}Sy5)!l{+V+G|ju$lv*E`o>@6$8_^BemM=EwR^nBVmV8-7e$-FIevP8d|pZHh4d
ztV=JLN8M(E(NPy(w=S+}>KlB4pyp{iLmM|s6$BOtIk6ZIgk`2A!|L<LI*t$azviaw
zwH31bAka=93cyEv^Ux-0GoPp?KZeW#ulbJ;1161=7PxaD|Kp`dgd<J`*{TT1#J>^#
zKB!$|l=}XL2r1{U$6k(cXUg_WpSD^u;1n>Qa=p9n7N+9xZ^teVmp8Hd3(P!trGyS<
zj<6BB@Zp147mu7qkhn)hi%kvy(FX89;N5=F;8y)G1Onk1aKPa$KopuGKxpyvR+t$8
zh7>sN1cYVX)8#F8f6%}CLpf0`xjrH1)WVnYeoR|~@!{2IyKk~}n0M#Fd=ywp&6qAm
zpWE#R+x+>@EI#c-;->(CMj#4VIRq6T(j~lV6_B-q6{FfZIt6)o;qR`YW9Q7??VJ3$
z+sJW3o}Xf1JTqq7X9AIRIwWt~7Z&4wAB35<42z9e=3z$w$obE%w@_efRTUQ?P>R(t
zhk@R}AN18$c({V6qZC;gw-9eed3Gn0;*>5kCbhI*m6h^y_@L0ML5=;44_bcU_3h&k
zi^HnsvM)G)t$aUAu3X7QXH^WO@SCKV^ziT?D-EJ{q<W+nfD1%=NGKCn&`6}0__P`5
zs~Ms$=1{>Vj^D^KVw(5^cp{<4KZBaSx-I|S^vlqYYw}-c>!M8XUU+4lcO(5LMKxHX
zVW8xY4$UK(jqBFU13xxy*dEv+!TlorvSNo;iHVDQqHO>V){)*EZ9wx1t3u0}D8j7N
zy`5pVxsGGFT&#4;A?$VCsJyzkaLy4Az*v5I*J<w*ru=C<I#p!%J1>OusJ-48ZG;+p
zYe7kd)x}@|){>0RUphN;(e=d~1_Bv(qFDO(<&^(_5sf<8xF6))o+&ApL8!#Z8N*vK
zbLK}lo3_nkso<O+<3|EVqkQT5r$OmX^LE%8ULind1jM3(th_{~d=i^v4EFB-l5r$w
zyEPL7;VAR%CLgU?8Tz7&{7k0)R9QHkwr!pq#ZYcf^7kJ}<On!hqauS&_Oq{Tc8L?C
zaJ>I^&QTJ^7Ub>jjRlweidDcmJ8t<9O4hZ{ql2v0fGg6zEYn*4dNyTZysa#->O}~2
z)ewZzKgB+m9B+PiQHBm<rXLwGd1sknh@d>}u+Ypo;r|106qe!>;j6gDsqMIe*~}2C
zu`;~vUIF%u;j>AXx5}$53CPb~8c4UD*&$07q|`bQ9`Xwl$978pbe;n{0&O0ZuZ>zw
z5d^CFkwlr6D{(MnmT4guOuzL@Dq^_xO*181%w=qrP`+0VPxH1GDF6DEI@zQ%E#rU$
z^v<LeG?!11W6|%RRFJE<N3NG_)M-Egfkl~#Twm;&=9eytRloQ}&-nVl8AI&JlQ}ln
zlk^MI6Ip}{Lv#@P1>~CqhLJHBy<6oO88BF>3W9qOt+}H#=L%iF*xz`BNe{q^fh_K?
zyZwl#=8)Vr09omBT*Ch8;$vJgEul;lTO(Hvf|R9yjGfZ*imm)^S7!XLcKhS1d#+P_
zy8DUvI#3fA82DYpr#;V@^#y9&$b+0qrB_7oc5;u7UIVe>g&Z8Tc{%*Ia(7MLP43f>
z{%|%oR)WP~V)5iLA>at)E4o_PDgU{1G!D*nBbIMqB%+f%mz_P)rUfI;U}yxm_24W4
z>%lx%?63~zPq0`cn&J`?f}H`~RwLO$ypfZ(p;bG=5D|#EAf!~#>_9nHykE%41M&dJ
z>J{q*K(TmYS$3v8Xj$M}SEI;Tk{g~e{5-dcI`x-Qz8ig*<7o4JH>K@X4z+MS^R5HB
zN7q386?Drsl&!$;lhzUzryDv&vewgpU$$AgObMX9aMEZJ&6`S$wu?m@S7(pb>5vnb
zkjhRMu*AJzS!Fia!r`Oo^h!0TCvymu<|<iPA#e_f)flm2Bb_|3sd15PX-WoVEwTka
zcp}|NhVo{0x0xl2>ld$S_AblmY=59&|IgE0Ep41I5K*1pXDhISM31lRciMPsBxrT&
z0di+KM>2$X6DIA+_f#IdV=)FK_4=WxmOMBKVDs2MD)O*b8EfaY7Iq;I^IT$hb<-Bt
z(z{sq7zY^>VcOlkMqXkCKR(7fN%kESdfRIk__tQS*!XTVKRKX1eCMUqED8>2Vy3Q}
z!G%VjdVoAWKUs)3Wzvy+eyaqY5(R8Qoo~B=6GgqMDLzWjE~B5kC!{~~Z}@O_;*tvI
zBZk0yjB;<w29Mk>)^bC;4|6EFyUHieD9wzGrvIEok#^_7gUMW%GG=CGc>IpMnYslM
zA3&%Dy9Qpl1H!mJDRyN^V}lbqnq(9J8?c`Zc00<>&hK}*y`K9<NlUEAFXU)~WK!u=
zO-GILUWxVV3oufI*UKg-8EEWkjZnPV*4_O$+t$9WwWsXvrT(^(lzO6~_%3;$ZMxZe
zdmU*6y6{S`mSCOLB{2li49xQ8nCVdGYnQ`@<O9{?&^tMHzvr(8w$p!YVEceaY+7G^
zr^EaMYBK1vvJl+`rQyrLZ@Gc4)UtadaWb{rZ@4~Hs3H{iX1cpL%_-D=SrDgOjS&-i
z=zvEn;<SgKBLRDwc4>-oYrb|u2hkItIh<K-ZEb1+QWOgC^Z7vBxD2%GcM-hT)+i_m
zz(}%AhvVmZr`}Rj;!36#k|Lv~I$cIvJ+KXNG8&+XO?u>M)jVj--4fW=j$+?ePYIm}
zq`iYKGvh9`g4~b8OB#7WtH!x)fN6iAl+k=jn9IyGSVf<=_XT-6%0|k566iwTU97|W
z!Ud4@`@C9WrD?9Nuyg$lA+=kU(p#(@FdkPDS8Y;<rZE8ngKkI6UwoZ%g+@E$IOHc>
zNXWLDtb6F*EWQ6?^Pj$<M}`01S4MI~^j|8a@JWMcrgs1uT3c3K(P8d0Hqc6FNEo`T
zLYhQ@43^@@Oe!0)q=`;{RRbd<%`Y;`&PmMyZ+7dXa1?<TpM^tFq-5O}r(P@TY45C)
zPm0l=^?UH(29j!^oVzng^p0o!TAH@j|1ANb;2*`RJKEbJ*mbf4=X&Svi%nbO1xVur
zgitJeI5Of7*tuZq;s@%_MWTL3NjqS{piK0z;0W|XKBEno2SIkiM<LR-pwTol&vf9E
zB0Ni45+5P}BQzWQ`5_4H=6wvrz%#23B|2h24QdkQGE?jnLLY@<M+7o8pivv33Nt+%
zIz#lh)Ga(K=luuR)%&p+0IHRo1IKo<j_76C00mEc&Eut<8lM|AeVW2Y*4Q>Yq;CFi
z*nosRfdFFvLIz;)L}=k2oSbsGEiHmVE<Z`4Enc~lbCG6|v%$+=$2%`G+nCk>d85%|
z#!*wB$uIxEDH5$=xZ#g`_f}wJ2{_Vu5UtT)Gy|Jbu&cO`(V)t+valUr$Q1x@O?WmP
zG<{sXuN`OgbsxfI4h{)1+wv6i4Qv*EA{8&Sb@Y;;HGUwkc;dIfc<sq`MJ7*PQLK=g
zBX4m1`Ur)C3(zP95!HX4OpgB^(W9mBnwCZ_;89jkP`U{@cm&M{>T!iIy}t-S9Rv}g
z_=SJX1%oIdTNNgVk6fnhz;7iw3t&=^erfXg$_OP=FZvMk79>HbzsJZIuUsjCDI8{s
z9PE5jvw;A&H<-q@B!7X^L18Af4@;Kti7@k>7mqa9Fn<P4%}6zFf;<g@hBip)QwaVE
z-PvcDj(U}0wr_Lqk3ZVqOXPS!KbVpW7p;x3n@W9vb7wp8c?KS^>iiZ^t(@9qyD(=v
zaOjYIw-cg^58>AXU{nab7fFkc+adGT<=1yqlpCQY=@N?cOd-ZC{1=cCfB+yd1H79@
zOgkYGmkYK%AjP?$i6`il{|>eGb$vFRi~OwGT*w1?a~AyH{shin_0-rVq~`m;^g8*%
zVgUuM<Px-02Z^-x(xn{Euk2yzF^Dm$*;9y)Y>ryIsFIofSl^sQUj6T~DSX@t4(phG
z{{n#@)zb2WhDEAn>$KYx3Z`Lhb3k{r2{NfwYuH5_>8@%2=<BKRkB3UR9WF!I8QScG
zGyN?UUo1q|M#4KPz`h_fZd_$$zfq3;s2C;p-Me@t!z-48$N0~!V<h_|=hp{`o?_yV
zqH^Hn7((FmtD9InCmD^_C~^6l*+KZb9t5p1;oR^xbIpQo#0w~S;hw!zL=uLF`e~u-
zu|W{1M%BWtUv8ZAZjQ+DF>%08aj#z}&UM2&f$x2<-wf5lJf`VktJAn1>LwN-oiP<6
zWOvLoW>a`K8?)nxAlgdb(jn$Hi+IH%*@7%ZWy(2K!pH;xEWUEGf6w&j*0MAsQD5c5
zyG?bX1kdU5wi_P%v|XS*U1Pscdi3i@<&)1gjz;6dBP$6$y}KcK6*g{Pcz%=rmazI4
zjKe14@#8n5kIX+Vr4?MLJXM^!2S1%vX|4)nH~EM$7tHI}EG;cj=I*&TMQc_EbrWMt
z;{OVbHZG0CUGnz2f+d0Jb2cS?`<&jr*5amf2V?6~w(r_i(Abz!Jgmcj#4OMz+lim{
z<M49)fS2FA&GD`l5Y~f;H(!y7%0Irew}I)=l6=)Kt#n5GB`>fU=r-f}RB>^}8Z)rM
zqQ9gxl+s}3L4Unbqwf{+zCBElJ8n4OSyfe48DRbf(VhapjC$`{lgme22tM3%C~X4+
z9I*ZNPKeLKcnH|R{Gy^c&>c_@IA(?i`v#O0sZy9kBktaR95D%9^XnL!VRA=^NKkQ?
z3LGw+MS9zvmwqr;!&MkVhK>8+sHG-KphN^VgwZ>Zhk9Jn`4rF33aon4-NpO?k0P>W
zP3<A9FXBT6F9tID%{UBaQ4tXqU>@eOvB?9r5WP;lJb7E6tbBj@*V0Mv>=QZ3+XN`5
zXCuESqc%lAauo32uHC<XpPZLb;>v5WhdFWhM!*7^t|f&n1Z@^A^djPv6Z`>HV51wD
z_o`b<!K9DOzmPh|XM;U|P){oay6W=)g241eeAcX49#5V;A<zg&Uuhw>X?>A2X-bWw
ztk8EF)r?cFev5Ql5x^B9c2oqa4H--!wk-t>Mm<2w3@I>)tNHKWE2F2rA6uAk5)SEU
z-2zEM{%>CA_nRRKpa3`({mqcyko(cjwoltq)GIk=Tww5q7L<KL7GHz}`5QNr6Hd&C
zu&})jG{`vc08~V@V6^XBB<W|1-8&RLHi-xg@a19v9N<V)TM7*)1$6TjLDya|#O%s>
zUuYKg!&)lesECY=K444NF*GrW{gmx+99USL{P^B}2o}w9C4jG*XmHmb9~BlAJ%DNC
zN(G}7D@@bamTtK7@_AEVb*!&#Z(MBZz&QYG<wX3wu{I9sHg+uEW3Pel(i`GVUe0p?
z%DanFiW|^j*yF;fP6R2Yg0XST?Al)3675_!Zm@CFvu%AG^c$SnM;yxm%}UCa!Kh&F
z$~(cq8%}Fx4h{`n#W-)wK2*kujJS}A%}b~X!GxZe3n%H4M;G@#eC9-^^*S=<g>Z*y
zY-3Xsk-x%CS)e=AT@}p+sjDb)#kCkFVVSwp4;}1h%;;a*e0xxMzxD{?&GbYE2M*oy
zt>pyC0QwL?(Qq9fw}rGx9{3)DlhrS8+?fCMQx*>Z8doteqZmM`68*e<Y&U@{jqKu<
z#MXw;Q4WU`=QEad95FQyZwdb{Io4lTNrk`yv2ak8rEvq9fUNm`=IRi~-zCBZ>N=_o
zGD7y{JGnvb%71S3K1@wCO8nqC4EmJ-z9EDD-BVvv0(Vlyj)d%l2ryM$U;j3C?CGJ-
zx9R~ADSoT=x04eR3y(qp(1O6EK*15UGD?fo5DUi)U&y#W`T27>N5@wRnzg>bPkhGp
z<6+et@&Ai1eizMW3Lev$4P+f+3(_Cc=`F0@S+R+U?D$p-P$h6eFoU{dCxlZJ&?lyl
zGz+*n={N4Cs~LnmmW&sj&WM^sX0tL}o|VJ`tfRfi7V&NSiaBVqyZxTnS5&BxCN$8~
zM5gc}#6Cd%Kh?`c9s2g7H3A=tjeaMSJERoMw-YB$kl+pqUbt35vT-RtL<;xzR+$z7
zhm0zmhzLpNqJ&=vAP_15KkU7AAg;Tzj-AIMFtLne#Xa#D_K+asn|;FN**1ZNk@LI%
z!A2Luz4c-70Aoi&A!N<Yz#4`y{D?w}_>*E(2O_GEd|)=tYhhu5D0&VHBmUAJXnLV<
z(2#L?E%6F7xe*U{m6NIG-7roQ1fiRhCa|l%hFBu-)ywtpL+R6CEkV)A4>#w8uc{%F
zx<1{qbs=K)vOV_PM2`SEkJsSStJFJW`UOuj7gCpZka^;q`U%P<ffnRBoqrt~bm9v~
zxd*3a4BN`o7e_U5b47uZn;lZ74K3>=K)}oUE|%m85+aggVAifdFNF_-J@tU7&2UNr
zPB9D}NaBnEOdDN`PfzQ~SG2#;GC--W1d%HAbFHvG3yX>fZ5+6WUar2v`g$HXB1pao
zErnJ}9yS&R(TPJbwJ$7B0Y{*$9n_C7bpv1wff3biSoE~Hb9^t`H9&TcE%bfJxPi#$
z0d^H$^QE>4fJ|a_1N^{32$>aQ%3qmmxZnL#hi!TGUVkW|8refxInOJ^Gq)wt#V12H
z1&<PowV=hE*XImJ=I{Clf)4J}fApV5>`~Lw5~1>?wfFRRqqx!hApxj}8*Hd`#a-G2
z#N{Kk5`f}g0P?#A&Izu65#$bN9Q|b8_<RnYGRyeku~Ps#h;rXxE$eAaJh9o`f!5lA
z^NfIi?#s&V!upV*jT|$%86SzbhqQ7j5OebA5;JKCny&|c*09*e@8wQfeoJEL?~5;N
zF{ecBuyv&IZ?gy{DvPi>y$MKVy*~S3DmR$C+{cr2Ve)whx)u8Y5z>WRPV$9jX&iAW
zKqK&Vn&^6Po&nKMc=P6CIQp!>&IJRGerC$aU9E}k>4Z-^5zA>u?u?iWRSHEwE{eQ_
zoJnkmtvv4$5D;KHT)Hh<Jh}`}Q3({+iWU}0oDoA-R#fT|SO#YzRJPziEdsq2R;FAy
zz(7l0$Q`ni$_2=~dcc@Ag0(QzEHUy`qHvPS2F*fPR`%4~m4&$SYakk+>fq+Tr9|kR
z5ukjqG+yTCa!C2Ssb=~^OJYvL!_mbKDW^BxaK)FMw8w;YN&<6X|IE~reV?*k05gz}
z<DJ5Zc`+wZ`>8RiWs|2-R(NotOqk_L$9F)G=^Jy`sV!Ro7g+@3pnOQK5pf~F*}v_O
zS@0HcsM!=CCB;dwg=SVIxUclA0Ki~iZfpmOcoc#AfUsN>zyky}GPbq)=_y(F9Xve%
zxCu5LYq9NE0NF>}GKmO8NeJ{<6@umf1^bY0+Vp8l>1Ccxp^XnmdFY3MG`rMF_K6oN
zO7Rdw0CdwGt$Y*^7w)ib+oS{#S|Pd`Wayu2-l*Ptsh60!{bCnBVm<Clv<Lwf01m<f
zN?0{tx)bp(2xCg44}K(k{HROHIh-XN!RekpjKe3UIG=2W@NJt(HO0sfooOf%$?G4L
vCcRw3fAAB89swiAtYU_MKjUTJHp66)KYz`Q-D{Uq@H(h?L?KDe;OhSX8ikaa

diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index f2f74f845338..363c8e673eb7 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -7528,6 +7528,7 @@ def invert(x):
         secax(0.6, functions=(lambda x: x**2, lambda x: x**(1/2)))
         secax(0.8)
         secax("top" if nn == 0 else "right", functions=_Translation(2))
+        secax(6.25, transform=ax.transData)
 
 
 def test_secondary_fail():
@@ -7539,6 +7540,8 @@ def test_secondary_fail():
         ax.secondary_xaxis('right')
     with pytest.raises(ValueError):
         ax.secondary_yaxis('bottom')
+    with pytest.raises(TypeError):
+        ax.secondary_xaxis(0.2, transform='error')
 
 
 def test_secondary_resize():

From dcd1d236206b68361e504e0c6e8b04e827ebd669 Mon Sep 17 00:00:00 2001
From: Daniel Bergman <dbergma5@jh.edu>
Date: Fri, 23 Feb 2024 04:34:56 -0500
Subject: [PATCH 0754/1120] Fix Annulus width check (#27811)

* Update patches.py

Fix check on annulus width to reflect the error message printed. The logic is presented in this (slightly) convoluted form to better conform with the error message. Obviously, `if min(self.a, self.b) < width:` works just as well.

This fix will allow annuli to be equivalent to Circles (in terms of area plotted, not underlying object structure). This means plotting (`_recompute_path`, I believe) could be improved by checking for `if w==a or w==b: PLOT WITHOUT HOLE`. Not sure how that would work, but everything does seem to work even without that change.

* Update lib/matplotlib/patches.py

We're in agreement on this.

Co-authored-by: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>

* Update lib/matplotlib/patches.py

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>

---------

Co-authored-by: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>
---
 lib/matplotlib/patches.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
index 78af2f98b3bf..e7ad848b3e49 100644
--- a/lib/matplotlib/patches.py
+++ b/lib/matplotlib/patches.py
@@ -1840,9 +1840,9 @@ def set_width(self, width):
         ----------
         width : float
         """
-        if min(self.a, self.b) <= width:
+        if width > min(self.a, self.b):
             raise ValueError(
-                'Width of annulus must be less than or equal semi-minor axis')
+                'Width of annulus must be less than or equal to semi-minor axis')
 
         self._width = width
         self._path = None

From dae7d77f921d5ee324424a56843b2eaf3a4dffea Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Fri, 23 Feb 2024 01:31:26 +0100
Subject: [PATCH 0755/1120] DOC: Update violinplot() docs

Some corrections and small rewrites.

Co-authored-by: David Stansby <dstansby@gmail.com>
---
 lib/matplotlib/axes/_axes.py | 50 +++++++++++++++++-------------------
 lib/matplotlib/mlab.py       |  9 +++----
 2 files changed, 28 insertions(+), 31 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 186dd30f0ade..36f403831b8a 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -8206,26 +8206,26 @@ def violinplot(self, dataset, positions=None, vert=True, widths=0.5,
           The input data.
 
         positions : array-like, default: [1, 2, ..., n]
-          The positions of the violins. The ticks and limits are
-          automatically set to match the positions.
+          The positions of the violins; i.e. coordinates on the x-axis for
+          vertical violins (or y-axis for horizontal violins).
 
         vert : bool, default: True.
           If true, creates a vertical violin plot.
           Otherwise, creates a horizontal violin plot.
 
-        widths : array-like, default: 0.5
-          Either a scalar or a vector that sets the maximal width of
-          each violin. The default is 0.5, which uses about half of the
-          available horizontal space.
+        widths : float or array-like, default: 0.5
+          The maximum width of each violin in units of the *positions* axis.
+          The default is 0.5, which is half the available space when using default
+          *positions*.
 
         showmeans : bool, default: False
-          If `True`, will toggle rendering of the means.
+          Whether to show the mean with a line.
 
         showextrema : bool, default: True
-          If `True`, will toggle rendering of the extrema.
+          Whether to show extrema with a line.
 
         showmedians : bool, default: False
-          If `True`, will toggle rendering of the medians.
+          Whether to show the median with a line.
 
         quantiles : array-like, default: None
           If not None, set a list of floats in interval [0, 1] for each violin,
@@ -8233,16 +8233,14 @@ def violinplot(self, dataset, positions=None, vert=True, widths=0.5,
           violin.
 
         points : int, default: 100
-          Defines the number of points to evaluate each of the
-          gaussian kernel density estimations at.
+          The number of points to evaluate each of the gaussian kernel density
+          estimations at.
 
-        bw_method : str, scalar or callable, optional
-          The method used to calculate the estimator bandwidth.  This can be
-          'scott', 'silverman', a scalar constant or a callable.  If a
-          scalar, this will be used directly as `kde.factor`.  If a
+        bw_method : {'scott', 'silverman'} or float or callable, default: 'scott'
+          The method used to calculate the estimator bandwidth.  If a
+          float, this will be used directly as `kde.factor`.  If a
           callable, it should take a `matplotlib.mlab.GaussianKDE` instance as
-          its only parameter and return a scalar. If None (default), 'scott'
-          is used.
+          its only parameter and return a float.
 
         data : indexable object, optional
             DATA_PARAMETER_PLACEHOLDER
@@ -8329,26 +8327,26 @@ def violin(self, vpstats, positions=None, vert=True, widths=0.5,
             for this violin's dataset.
 
         positions : array-like, default: [1, 2, ..., n]
-          The positions of the violins. The ticks and limits are
-          automatically set to match the positions.
+          The positions of the violins; i.e. coordinates on the x-axis for
+          vertical violins (or y-axis for horizontal violins).
 
         vert : bool, default: True.
           If true, plots the violins vertically.
           Otherwise, plots the violins horizontally.
 
-        widths : array-like, default: 0.5
-          Either a scalar or a vector that sets the maximal width of
-          each violin. The default is 0.5, which uses about half of the
-          available horizontal space.
+        widths : float or array-like, default: 0.5
+          The maximum width of each violin in units of the *positions* axis.
+          The default is 0.5, which is half available space when using default
+          *positions*.
 
         showmeans : bool, default: False
-          If true, will toggle rendering of the means.
+          Whether to show the mean with a line.
 
         showextrema : bool, default: True
-          If true, will toggle rendering of the extrema.
+          Whether to show extrema with a line.
 
         showmedians : bool, default: False
-          If true, will toggle rendering of the medians.
+          Whether to show the median with a line.
 
         Returns
         -------
diff --git a/lib/matplotlib/mlab.py b/lib/matplotlib/mlab.py
index 1948e6333e83..e1f08c0da5ce 100644
--- a/lib/matplotlib/mlab.py
+++ b/lib/matplotlib/mlab.py
@@ -776,12 +776,11 @@ class GaussianKDE:
     dataset : array-like
         Datapoints to estimate from. In case of univariate data this is a 1-D
         array, otherwise a 2D array with shape (# of dims, # of data).
-    bw_method : str, scalar or callable, optional
-        The method used to calculate the estimator bandwidth.  This can be
-        'scott', 'silverman', a scalar constant or a callable.  If a
-        scalar, this will be used directly as `kde.factor`.  If a
+    bw_method : {'scott', 'silverman'} or float or callable, optional
+        The method used to calculate the estimator bandwidth.  If a
+        float, this will be used directly as `kde.factor`.  If a
         callable, it should take a `GaussianKDE` instance as only
-        parameter and return a scalar. If None (default), 'scott' is used.
+        parameter and return a float. If None (default), 'scott' is used.
 
     Attributes
     ----------

From 128fe0e979fba998c43144d44d75bc38368ec924 Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Sat, 24 Feb 2024 17:20:02 +0000
Subject: [PATCH 0756/1120] MNT: remove draw method args and kwargs

---
 ci/mypy-stubtest-allowlist.txt                      | 2 --
 doc/api/next_api_changes/deprecations/27768-REC.rst | 5 -----
 lib/matplotlib/axis.py                              | 4 +---
 lib/matplotlib/image.py                             | 4 +---
 lib/matplotlib/image.pyi                            | 2 +-
 5 files changed, 3 insertions(+), 14 deletions(-)
 delete mode 100644 doc/api/next_api_changes/deprecations/27768-REC.rst

diff --git a/ci/mypy-stubtest-allowlist.txt b/ci/mypy-stubtest-allowlist.txt
index 19fb0879b7a2..73dfb1d8ceb0 100644
--- a/ci/mypy-stubtest-allowlist.txt
+++ b/ci/mypy-stubtest-allowlist.txt
@@ -18,8 +18,6 @@ matplotlib.pyplot.*
 matplotlib.typing.*
 
 # Other decorator modifying signature
-# Runtime picks up  *args **kwargs, but only decorated by a decorator that uses @wraps so?
-matplotlib.axis.Axis.draw
 # Backcompat decorator which does not modify runtime reported signature
 matplotlib.offsetbox.*Offset[Bb]ox.get_offset
 
diff --git a/doc/api/next_api_changes/deprecations/27768-REC.rst b/doc/api/next_api_changes/deprecations/27768-REC.rst
deleted file mode 100644
index 357545a41efe..000000000000
--- a/doc/api/next_api_changes/deprecations/27768-REC.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-``[XYZ]Axis.draw``, ``*Image.draw`` *args* and *kwargs*...
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-... are deprecated because they have no effect.  This will make the calling sequence
-consistent with the ``draw`` method of other artists.
diff --git a/lib/matplotlib/axis.py b/lib/matplotlib/axis.py
index e76f9fdcf5aa..c0cd2617e878 100644
--- a/lib/matplotlib/axis.py
+++ b/lib/matplotlib/axis.py
@@ -1373,10 +1373,8 @@ def get_tick_padding(self):
             values.append(self.minorTicks[0].get_tick_padding())
         return max(values, default=0)
 
-    @_api.delete_parameter('3.9', 'args')
-    @_api.delete_parameter('3.9', 'kwargs')
     @martist.allow_rasterization
-    def draw(self, renderer, *args, **kwargs):
+    def draw(self, renderer):
         # docstring inherited
 
         if not self.get_visible():
diff --git a/lib/matplotlib/image.py b/lib/matplotlib/image.py
index 4673c6c4d529..73738fe3bdbe 100644
--- a/lib/matplotlib/image.py
+++ b/lib/matplotlib/image.py
@@ -626,10 +626,8 @@ def _check_unsampled_image(self):
         """
         return False
 
-    @_api.delete_parameter('3.9', 'args')
-    @_api.delete_parameter('3.9', 'kwargs')
     @martist.allow_rasterization
-    def draw(self, renderer, *args, **kwargs):
+    def draw(self, renderer):
         # if not visible, declare victory and return
         if not self.get_visible():
             self.stale = False
diff --git a/lib/matplotlib/image.pyi b/lib/matplotlib/image.pyi
index 426e34ec83c9..20fdc3ff946a 100644
--- a/lib/matplotlib/image.pyi
+++ b/lib/matplotlib/image.pyi
@@ -82,7 +82,7 @@ class _ImageBase(martist.Artist, cm.ScalarMappable):
     def make_image(
         self, renderer: RendererBase, magnification: float = ..., unsampled: bool = ...
     ) -> tuple[np.ndarray, float, float, Affine2D]: ...
-    def draw(self, renderer: RendererBase, *args, **kwargs) -> None: ...
+    def draw(self, renderer: RendererBase) -> None: ...
     def write_png(self, fname: str | pathlib.Path | BinaryIO) -> None: ...
     def set_data(self, A: ArrayLike | None) -> None: ...
     def set_array(self, A: ArrayLike | None) -> None: ...

From 052e4e704ce0a147f862f67536d679f17f6f5e62 Mon Sep 17 00:00:00 2001
From: DWesl <22566757+DWesl@users.noreply.github.com>
Date: Sat, 24 Feb 2024 21:47:20 -0500
Subject: [PATCH 0757/1120] BLD,Cygwin: Included Python.h first in
 src/_c_internal_utils.cpp

Python.h needs to be included before any system includes.  This is easiest if it is the first include.  Interestingly, pybind11/pybind11.h does not include Python, possibly depending on downstream projects including Python.h beforehand.
---
 src/_c_internal_utils.cpp | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/_c_internal_utils.cpp b/src/_c_internal_utils.cpp
index 813aeb6f7d5a..464aabcb2e3a 100644
--- a/src/_c_internal_utils.cpp
+++ b/src/_c_internal_utils.cpp
@@ -1,3 +1,6 @@
+#include <Python.h>
+/* Python.h must be included before any system headers,
+    to ensure visibility macros are properly set. */
 #include <stdexcept>
 
 #ifdef _WIN32

From 454225ac98eb051041c9b30e2fb7c9a118baf89e Mon Sep 17 00:00:00 2001
From: DWesl <22566757+DWesl@users.noreply.github.com>
Date: Sun, 25 Feb 2024 06:34:33 -0500
Subject: [PATCH 0758/1120] CI: Include Python.h first in _tkagg.cpp

Needs to be included before system headers to set visibility macros for pybind11
---
 src/_tkagg.cpp | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/_tkagg.cpp b/src/_tkagg.cpp
index 3b58114a71c0..91cf285202ed 100644
--- a/src/_tkagg.cpp
+++ b/src/_tkagg.cpp
@@ -9,6 +9,7 @@
 // rewritten, we have removed the PIL licensing information.  If you want PIL,
 // you can get it at https://python-pillow.org/
 
+#include <Python.h>
 #include <memory>
 #include <new>
 #include <stdexcept>

From c0f19daa075d057450eac70c7bccea094e2da18f Mon Sep 17 00:00:00 2001
From: DWesl <22566757+DWesl@users.noreply.github.com>
Date: Sun, 25 Feb 2024 06:37:00 -0500
Subject: [PATCH 0759/1120] BLD: Include Python.h first in _backend_agg.cpp

---
 src/_backend_agg.cpp | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/_backend_agg.cpp b/src/_backend_agg.cpp
index 10a17f2dc9cb..c35f92eb8fc1 100644
--- a/src/_backend_agg.cpp
+++ b/src/_backend_agg.cpp
@@ -2,6 +2,7 @@
 
 #define NO_IMPORT_ARRAY
 
+#include <Python.h>
 #include "_backend_agg.h"
 #include "mplutils.h"
 

From 25deb90a73145aae6fb8437389af9c415dead516 Mon Sep 17 00:00:00 2001
From: DWesl <22566757+DWesl@users.noreply.github.com>
Date: Sun, 25 Feb 2024 07:21:21 -0500
Subject: [PATCH 0760/1120] BLD: Include Python.h before pybind11/pybind11.h

pybind11 assumes Python.h is included first.
---
 src/_image_wrapper.cpp | 1 +
 src/_qhull_wrapper.cpp | 1 +
 src/_ttconv.cpp        | 1 +
 src/ft2font.h          | 8 +++++---
 src/numpy_cpp.h        | 8 ++++----
 src/py_converters_11.h | 1 +
 src/tri/_tri.h         | 1 +
 7 files changed, 14 insertions(+), 7 deletions(-)

diff --git a/src/_image_wrapper.cpp b/src/_image_wrapper.cpp
index 716116c0ba56..c40e3d5c8d67 100644
--- a/src/_image_wrapper.cpp
+++ b/src/_image_wrapper.cpp
@@ -1,3 +1,4 @@
+#include <Python.h>
 #include <pybind11/pybind11.h>
 #include <pybind11/numpy.h>
 
diff --git a/src/_qhull_wrapper.cpp b/src/_qhull_wrapper.cpp
index 9784a1698ba1..cae9aca959ee 100644
--- a/src/_qhull_wrapper.cpp
+++ b/src/_qhull_wrapper.cpp
@@ -5,6 +5,7 @@
  * triangulation, construct an instance of the matplotlib.tri.Triangulation
  * class without specifying a triangles array.
  */
+#include <Python.h>
 #include <pybind11/pybind11.h>
 #include <pybind11/numpy.h>
 
diff --git a/src/_ttconv.cpp b/src/_ttconv.cpp
index a682c26b17b0..559d898886cd 100644
--- a/src/_ttconv.cpp
+++ b/src/_ttconv.cpp
@@ -5,6 +5,7 @@
 
   Python wrapper for TrueType conversion library in ../ttconv.
  */
+#include <Python.h>
 #include "mplutils.h"
 
 #include <pybind11/pybind11.h>
diff --git a/src/ft2font.h b/src/ft2font.h
index 69dafb66bdca..6b8f05466700 100644
--- a/src/ft2font.h
+++ b/src/ft2font.h
@@ -2,8 +2,13 @@
 
 /* A python interface to FreeType */
 #pragma once
+
 #ifndef MPL_FT2FONT_H
 #define MPL_FT2FONT_H
+
+#define PY_SSIZE_T_CLEAN
+#include <Python.h>
+
 #include <vector>
 #include<set>
 #include <stdint.h>
@@ -19,9 +24,6 @@ extern "C" {
 #include FT_TRUETYPE_TABLES_H
 }
 
-#define PY_SSIZE_T_CLEAN
-#include <Python.h>
-
 /*
  By definition, FT_FIXED as 2 16bit values stored in a single long.
  */
diff --git a/src/numpy_cpp.h b/src/numpy_cpp.h
index a69c1cb29a50..6165789b7603 100644
--- a/src/numpy_cpp.h
+++ b/src/numpy_cpp.h
@@ -14,10 +14,6 @@
  * original.
  */
 
-#include "py_exceptions.h"
-
-#include <complex>
-
 #ifdef _POSIX_C_SOURCE
 #    undef _POSIX_C_SOURCE
 #endif
@@ -40,6 +36,10 @@
 #include <Python.h>
 #include <numpy/ndarrayobject.h>
 
+#include "py_exceptions.h"
+
+#include <complex>
+
 namespace numpy
 {
 
diff --git a/src/py_converters_11.h b/src/py_converters_11.h
index 9af617d3ee8b..ceef9ee542d1 100644
--- a/src/py_converters_11.h
+++ b/src/py_converters_11.h
@@ -3,6 +3,7 @@
 
 // pybind11 equivalent of py_converters.h
 
+#include <Python.h>
 #include <pybind11/pybind11.h>
 #include <pybind11/numpy.h>
 
diff --git a/src/tri/_tri.h b/src/tri/_tri.h
index c176b4c0e8f5..d7d2b4ebf413 100644
--- a/src/tri/_tri.h
+++ b/src/tri/_tri.h
@@ -63,6 +63,7 @@
 #ifndef MPL_TRI_H
 #define MPL_TRI_H
 
+#include <Python.h>
 #include <pybind11/pybind11.h>
 #include <pybind11/numpy.h>
 

From 59a2d1a7bde6c3d2a9ec50470094e124083399b8 Mon Sep 17 00:00:00 2001
From: DWesl <22566757+DWesl@users.noreply.github.com>
Date: Sun, 25 Feb 2024 08:16:11 -0500
Subject: [PATCH 0761/1120] CI: Specify python version for default pytest.

---
 .github/workflows/cygwin.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/cygwin.yml b/.github/workflows/cygwin.yml
index 97c8c34afa60..4a8edf40d49e 100644
--- a/.github/workflows/cygwin.yml
+++ b/.github/workflows/cygwin.yml
@@ -168,6 +168,7 @@ jobs:
         run: |
           /usr/sbin/alternatives --set python /usr/bin/python3.${{ matrix.python-minor-version }}
           /usr/sbin/alternatives --set python3 /usr/bin/python3.${{ matrix.python-minor-version }}
+          /usr/sbin/alternatives --set pytest /usr/bin/pytest-3.${{matrix.python-minor-version }}
 
       - name: Install Python dependencies
         shell: bash.exe -eo pipefail -o igncr "{0}"

From 242ddfcc997e4449fec818b552fdf741765bcc7c Mon Sep 17 00:00:00 2001
From: DWesl <22566757+DWesl@users.noreply.github.com>
Date: Sun, 25 Feb 2024 12:02:49 -0500
Subject: [PATCH 0762/1120] CI,Cygwin: Run pytest with python -m pytest

Cygwin pytest recently updated, and only installs pytest-3.9
---
 .github/workflows/cygwin.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/cygwin.yml b/.github/workflows/cygwin.yml
index 4a8edf40d49e..94395edf4088 100644
--- a/.github/workflows/cygwin.yml
+++ b/.github/workflows/cygwin.yml
@@ -244,7 +244,7 @@ jobs:
         shell: bash.exe -eo pipefail -o igncr "{0}"
         id: cygwin-run-pytest
         run: |
-          xvfb-run pytest -rfEsXR -n auto \
+          xvfb-run python -m pytest -rfEsXR -n auto \
             --maxfail=50 --timeout=300 --durations=25 \
             --cov-report=xml --cov=lib --log-level=DEBUG --color=yes
 

From 39e303ed734033e87eefba72f5ff9ba866c48234 Mon Sep 17 00:00:00 2001
From: DWesl <22566757+DWesl@users.noreply.github.com>
Date: Sun, 25 Feb 2024 12:19:56 -0500
Subject: [PATCH 0763/1120] CI,Cygwin: Revert use of alternatives to set pytest
 script.

Cygwin pytest only installs pytest-3.9.
I should possibly suggest using alternatives for that and pip.
---
 .github/workflows/cygwin.yml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/.github/workflows/cygwin.yml b/.github/workflows/cygwin.yml
index 94395edf4088..2fe94550dc4b 100644
--- a/.github/workflows/cygwin.yml
+++ b/.github/workflows/cygwin.yml
@@ -168,7 +168,6 @@ jobs:
         run: |
           /usr/sbin/alternatives --set python /usr/bin/python3.${{ matrix.python-minor-version }}
           /usr/sbin/alternatives --set python3 /usr/bin/python3.${{ matrix.python-minor-version }}
-          /usr/sbin/alternatives --set pytest /usr/bin/pytest-3.${{matrix.python-minor-version }}
 
       - name: Install Python dependencies
         shell: bash.exe -eo pipefail -o igncr "{0}"

From 8eb9f475d60b82e6da3ebb08f0c5d5b943bf0de7 Mon Sep 17 00:00:00 2001
From: DWesl <22566757+DWesl@users.noreply.github.com>
Date: Sun, 25 Feb 2024 13:07:52 -0500
Subject: [PATCH 0764/1120] CI,Cygwin: Avoid running pytest in root directory.

---
 .github/workflows/cygwin.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/workflows/cygwin.yml b/.github/workflows/cygwin.yml
index 2fe94550dc4b..efcfcc70db1f 100644
--- a/.github/workflows/cygwin.yml
+++ b/.github/workflows/cygwin.yml
@@ -243,6 +243,8 @@ jobs:
         shell: bash.exe -eo pipefail -o igncr "{0}"
         id: cygwin-run-pytest
         run: |
+          mkdir run-test 
+          cd run-test
           xvfb-run python -m pytest -rfEsXR -n auto \
             --maxfail=50 --timeout=300 --durations=25 \
             --cov-report=xml --cov=lib --log-level=DEBUG --color=yes

From 1b81830ec629064b65d9035ec92bd4d503f90b26 Mon Sep 17 00:00:00 2001
From: DWesl <22566757+DWesl@users.noreply.github.com>
Date: Sun, 25 Feb 2024 16:30:20 -0500
Subject: [PATCH 0765/1120] CI,Cygwin: Revert running pytest in different
 directory.

---
 .github/workflows/cygwin.yml | 2 --
 1 file changed, 2 deletions(-)

diff --git a/.github/workflows/cygwin.yml b/.github/workflows/cygwin.yml
index efcfcc70db1f..2fe94550dc4b 100644
--- a/.github/workflows/cygwin.yml
+++ b/.github/workflows/cygwin.yml
@@ -243,8 +243,6 @@ jobs:
         shell: bash.exe -eo pipefail -o igncr "{0}"
         id: cygwin-run-pytest
         run: |
-          mkdir run-test 
-          cd run-test
           xvfb-run python -m pytest -rfEsXR -n auto \
             --maxfail=50 --timeout=300 --durations=25 \
             --cov-report=xml --cov=lib --log-level=DEBUG --color=yes

From 4b131a14d90bfc2453ad0f43fa1174eedd7205c7 Mon Sep 17 00:00:00 2001
From: DWesl <22566757+DWesl@users.noreply.github.com>
Date: Sun, 25 Feb 2024 18:44:01 -0500
Subject: [PATCH 0766/1120] CI,Cygwin: Call pytest-3.9 explicitly.

---
 .github/workflows/cygwin.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/cygwin.yml b/.github/workflows/cygwin.yml
index 2fe94550dc4b..3e2a6144dece 100644
--- a/.github/workflows/cygwin.yml
+++ b/.github/workflows/cygwin.yml
@@ -243,7 +243,7 @@ jobs:
         shell: bash.exe -eo pipefail -o igncr "{0}"
         id: cygwin-run-pytest
         run: |
-          xvfb-run python -m pytest -rfEsXR -n auto \
+          xvfb-run pytest-3.${{ matrix.python-minor-version }} -rfEsXR -n auto \
             --maxfail=50 --timeout=300 --durations=25 \
             --cov-report=xml --cov=lib --log-level=DEBUG --color=yes
 

From bdfc4ce7ba0e9f794590599966f6511f1d771a26 Mon Sep 17 00:00:00 2001
From: DWesl <22566757+DWesl@users.noreply.github.com>
Date: Sun, 25 Feb 2024 21:04:10 -0500
Subject: [PATCH 0767/1120] BLD: Include Python.h first in src/_path.h

---
 src/_path.h | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/_path.h b/src/_path.h
index 239a3c760221..d45842df4cac 100644
--- a/src/_path.h
+++ b/src/_path.h
@@ -3,6 +3,7 @@
 #ifndef MPL_PATH_H
 #define MPL_PATH_H
 
+#include <Python.h>
 #include <limits>
 #include <math.h>
 #include <vector>

From bffe0bed55dec16881c76ed59318e4df0da2688f Mon Sep 17 00:00:00 2001
From: Ian Thomas <ianthomas23@gmail.com>
Date: Tue, 30 Jan 2024 10:36:00 +0000
Subject: [PATCH 0768/1120] Add BackendRegistry singleton class

---
 lib/matplotlib/backend_bases.py               | 16 ++---
 lib/matplotlib/backends/meson.build           |  1 +
 lib/matplotlib/backends/registry.py           | 61 +++++++++++++++++++
 lib/matplotlib/backends/registry.pyi          | 16 +++++
 lib/matplotlib/pyplot.py                      | 23 +++----
 lib/matplotlib/rcsetup.py                     | 45 +++++++++-----
 lib/matplotlib/tests/test_backend_registry.py | 59 ++++++++++++++++++
 lib/matplotlib/tests/test_matplotlib.py       |  6 +-
 8 files changed, 186 insertions(+), 41 deletions(-)
 create mode 100644 lib/matplotlib/backends/registry.py
 create mode 100644 lib/matplotlib/backends/registry.pyi
 create mode 100644 lib/matplotlib/tests/test_backend_registry.py

diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
index a353500f8725..39771e4170db 100644
--- a/lib/matplotlib/backend_bases.py
+++ b/lib/matplotlib/backend_bases.py
@@ -104,16 +104,12 @@ def _safe_pyplot_import():
         current_framework = cbook._get_running_interactive_framework()
         if current_framework is None:
             raise  # No, something else went wrong, likely with the install...
-        backend_mapping = {
-            'qt': 'qtagg',
-            'gtk3': 'gtk3agg',
-            'gtk4': 'gtk4agg',
-            'wx': 'wxagg',
-            'tk': 'tkagg',
-            'macosx': 'macosx',
-            'headless': 'agg',
-        }
-        backend = backend_mapping[current_framework]
+
+        from matplotlib.backends.registry import backendRegistry
+        backend = backendRegistry.framework_to_backend(current_framework)
+        if backend is None:
+            raise KeyError(backend)
+
         rcParams["backend"] = mpl.rcParamsOrig["backend"] = backend
         import matplotlib.pyplot as plt  # Now this should succeed.
     return plt
diff --git a/lib/matplotlib/backends/meson.build b/lib/matplotlib/backends/meson.build
index 050cc616b42c..1e3e47c0a915 100644
--- a/lib/matplotlib/backends/meson.build
+++ b/lib/matplotlib/backends/meson.build
@@ -33,6 +33,7 @@ python_sources = [
   'backend_wxagg.py',
   'backend_wxcairo.py',
   'qt_compat.py',
+  'registry.py',
 ]
 
 typing_sources = [
diff --git a/lib/matplotlib/backends/registry.py b/lib/matplotlib/backends/registry.py
new file mode 100644
index 000000000000..b445a89f96f0
--- /dev/null
+++ b/lib/matplotlib/backends/registry.py
@@ -0,0 +1,61 @@
+from enum import Enum
+
+
+class BackendFilter(Enum):
+    INTERACTIVE = 0
+    INTERACTIVE_NON_WEB = 1
+    NON_INTERACTIVE = 2
+
+
+class BackendRegistry:
+    """
+    Registry of backends available within Matplotlib.
+
+    This is the single source of truth for available backends.
+    """
+    def __init__(self):
+        # Built-in backends are those which are included in the Matplotlib repo.
+        # A backend with name 'name' is located in the module
+        # f'matplotlib.backends.backend_{name.lower()}'
+
+        # The capitalized forms are needed for ipython at present; this may
+        # change for later versions.
+        self._builtin_interactive = [
+            "GTK3Agg", "GTK3Cairo", "GTK4Agg", "GTK4Cairo",
+            "MacOSX",
+            "nbAgg",
+            "QtAgg", "QtCairo", "Qt5Agg", "Qt5Cairo",
+            "TkAgg", "TkCairo",
+            "WebAgg",
+            "WX", "WXAgg", "WXCairo",
+        ]
+        self._builtin_not_interactive = [
+            "agg", "cairo", "pdf", "pgf", "ps", "svg", "template",
+        ]
+        self._framework_to_backend_mapping = {
+            "qt": "qtagg",
+            "gtk3": "gtk3agg",
+            "gtk4": "gtk4agg",
+            "wx": "wxagg",
+            "tk": "tkagg",
+            "macosx": "macosx",
+            "headless": "agg",
+        }
+
+    def framework_to_backend(self, interactive_framework):
+        return self._framework_to_backend_mapping.get(interactive_framework)
+
+    def list_builtin(self, filter_=None):
+        if filter_ == BackendFilter.INTERACTIVE:
+            return self._builtin_interactive
+        elif filter_ == BackendFilter.INTERACTIVE_NON_WEB:
+            return list(filter(lambda x: x.lower() not in ("webagg", "nbagg"),
+                               self._builtin_interactive))
+        elif filter_ == BackendFilter.NON_INTERACTIVE:
+            return self._builtin_not_interactive
+
+        return self._builtin_interactive + self._builtin_not_interactive
+
+
+# Singleton
+backendRegistry = BackendRegistry()
diff --git a/lib/matplotlib/backends/registry.pyi b/lib/matplotlib/backends/registry.pyi
new file mode 100644
index 000000000000..e5646c3d1bdc
--- /dev/null
+++ b/lib/matplotlib/backends/registry.pyi
@@ -0,0 +1,16 @@
+from enum import Enum
+
+
+class BackendFilter(Enum):
+    INTERACTIVE: int
+    INTERACTIVE_NON_WEB: int
+    NON_INTERACTIVE: int
+
+
+class BackendRegistry:
+    def __init__(self) -> None: ...
+    def framework_to_backend(self, interactive_framework: str) -> str | None: ...
+    def list_builtin(self, filter_: BackendFilter | None) -> list[str]: ...
+
+
+backendRegistry: BackendRegistry
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 2cf0d5325a63..3442c778571b 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -69,6 +69,7 @@
 from matplotlib.artist import Artist
 from matplotlib.axes import Axes
 from matplotlib.axes import Subplot  # noqa: F401
+from matplotlib.backends.registry import BackendFilter, backendRegistry
 from matplotlib.projections import PolarAxes
 from matplotlib import mlab  # for detrend_none, window_hanning
 from matplotlib.scale import get_scale_names  # noqa: F401
@@ -301,16 +302,10 @@ def switch_backend(newbackend: str) -> None:
 
     if newbackend is rcsetup._auto_backend_sentinel:
         current_framework = cbook._get_running_interactive_framework()
-        mapping = {'qt': 'qtagg',
-                   'gtk3': 'gtk3agg',
-                   'gtk4': 'gtk4agg',
-                   'wx': 'wxagg',
-                   'tk': 'tkagg',
-                   'macosx': 'macosx',
-                   'headless': 'agg'}
-
-        if current_framework in mapping:
-            candidates = [mapping[current_framework]]
+
+        if (current_framework and
+                (backend := backendRegistry.framework_to_backend(current_framework))):
+            candidates = [backend]
         else:
             candidates = []
         candidates += [
@@ -2509,10 +2504,10 @@ def polar(*args, **kwargs) -> list[Line2D]:
 # requested, ignore rcParams['backend'] and force selection of a backend that
 # is compatible with the current running interactive framework.
 if (rcParams["backend_fallback"]
-        and rcParams._get_backend_or_none() in (  # type: ignore[attr-defined]
-            set(rcsetup.interactive_bk) - {'WebAgg', 'nbAgg'})
-        and cbook._get_running_interactive_framework()):
-    rcParams._set("backend", rcsetup._auto_backend_sentinel)
+        and rcParams._get_backend_or_none() in (  # type: ignore
+            set(backendRegistry.list_builtin(BackendFilter.INTERACTIVE_NON_WEB)))
+        and cbook._get_running_interactive_framework()):  # type: ignore
+    rcParams._set("backend", rcsetup._auto_backend_sentinel)  # type: ignore
 
 # fmt: on
 
diff --git a/lib/matplotlib/rcsetup.py b/lib/matplotlib/rcsetup.py
index f730db0dee3b..214656c9e60b 100644
--- a/lib/matplotlib/rcsetup.py
+++ b/lib/matplotlib/rcsetup.py
@@ -23,6 +23,7 @@
 import numpy as np
 
 from matplotlib import _api, cbook
+from matplotlib.backends.registry import BackendFilter, backendRegistry
 from matplotlib.cbook import ls_mapper
 from matplotlib.colors import Colormap, is_color_like
 from matplotlib._fontconfig_pattern import parse_fontconfig_pattern
@@ -32,20 +33,34 @@
 from cycler import Cycler, cycler as ccycler
 
 
-# The capitalized forms are needed for ipython at present; this may
-# change for later versions.
-interactive_bk = [
-    'GTK3Agg', 'GTK3Cairo', 'GTK4Agg', 'GTK4Cairo',
-    'MacOSX',
-    'nbAgg',
-    'QtAgg', 'QtCairo', 'Qt5Agg', 'Qt5Cairo',
-    'TkAgg', 'TkCairo',
-    'WebAgg',
-    'WX', 'WXAgg', 'WXCairo',
-]
-non_interactive_bk = ['agg', 'cairo',
-                      'pdf', 'pgf', 'ps', 'svg', 'template']
-all_backends = interactive_bk + non_interactive_bk
+# Deprecation of module-level attributes using PEP 562
+_deprecated_interactive_bk = backendRegistry.list_builtin(BackendFilter.INTERACTIVE)
+_deprecated_non_interactive_bk = backendRegistry.list_builtin(
+    BackendFilter.NON_INTERACTIVE)
+_deprecated_all_backends = backendRegistry.list_builtin()
+
+_deprecated_names_and_args = {
+    "interactive_bk": "matplotlib.backends.registry.BackendFilter.INTERACTIVE",
+    "non_interactive_bk": "matplotlib.backends.registry.BackendFilter.NON_INTERACTIVE",
+    "all_backends": "",
+}
+
+
+def __getattr__(name):
+    if name in _deprecated_names_and_args:
+        arg = _deprecated_names_and_args[name]
+        _api.warn_deprecated(
+            "3.9.0",
+            name=name,
+            alternative="``matplotlib.backends.registry.backendRegistry"
+                f".list_builtin({arg})``",
+        )
+        return globals()[f"_deprecated_{name}"]
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
+def __dir__():
+    return sorted(globals().keys() | _deprecated_names_and_args.keys())
 
 
 class ValidateInStrings:
@@ -256,7 +271,7 @@ def validate_fonttype(s):
 
 
 _validate_standard_backends = ValidateInStrings(
-    'backend', all_backends, ignorecase=True)
+    'backend', backendRegistry.list_builtin(), ignorecase=True)
 _auto_backend_sentinel = object()
 
 
diff --git a/lib/matplotlib/tests/test_backend_registry.py b/lib/matplotlib/tests/test_backend_registry.py
new file mode 100644
index 000000000000..98bdd9bd2793
--- /dev/null
+++ b/lib/matplotlib/tests/test_backend_registry.py
@@ -0,0 +1,59 @@
+from collections.abc import Sequence
+from typing import Any
+
+import pytest
+
+from matplotlib.backends.registry import BackendFilter, backendRegistry
+
+
+def has_duplicates(seq: Sequence[Any]) -> bool:
+    return len(seq) > len(set(seq))
+
+
+@pytest.mark.parametrize(
+    'framework,expected',
+    [
+        ('qt', 'qtagg'),
+        ('gtk3', 'gtk3agg'),
+        ('gtk4', 'gtk4agg'),
+        ('wx', 'wxagg'),
+        ('tk', 'tkagg'),
+        ('macosx', 'macosx'),
+        ('headless', 'agg'),
+        ('does not exist', None),
+    ]
+)
+def test_framework_to_backend(framework, expected):
+    assert backendRegistry.framework_to_backend(framework) == expected
+
+
+def test_list_builtin():
+    backends = backendRegistry.list_builtin()
+    assert not has_duplicates(backends)
+    # Compare using sets as order is not important
+    assert set(backends) == set((
+        'GTK3Agg', 'GTK3Cairo', 'GTK4Agg', 'GTK4Cairo', 'MacOSX', 'nbAgg', 'QtAgg',
+        'QtCairo', 'Qt5Agg', 'Qt5Cairo', 'TkAgg', 'TkCairo', 'WebAgg', 'WX', 'WXAgg',
+        'WXCairo', 'agg', 'cairo', 'pdf', 'pgf', 'ps', 'svg', 'template',
+    ))
+
+
+@pytest.mark.parametrize(
+    'filter,expected',
+    [
+        (BackendFilter.INTERACTIVE,
+         ['GTK3Agg', 'GTK3Cairo', 'GTK4Agg', 'GTK4Cairo', 'MacOSX', 'nbAgg', 'QtAgg',
+          'QtCairo', 'Qt5Agg', 'Qt5Cairo', 'TkAgg', 'TkCairo', 'WebAgg', 'WX', 'WXAgg',
+           'WXCairo']),
+        (BackendFilter.INTERACTIVE_NON_WEB,
+         ['GTK3Agg', 'GTK3Cairo', 'GTK4Agg', 'GTK4Cairo', 'MacOSX', 'QtAgg', 'QtCairo',
+          'Qt5Agg', 'Qt5Cairo', 'TkAgg', 'TkCairo', 'WX', 'WXAgg', 'WXCairo']),
+        (BackendFilter.NON_INTERACTIVE,
+         ['agg', 'cairo', 'pdf', 'pgf', 'ps', 'svg', 'template']),
+    ]
+)
+def test_list_builtin_with_filter(filter, expected):
+    backends = backendRegistry.list_builtin(filter)
+    assert not has_duplicates(backends)
+    # Compare using sets as order is not important
+    assert set(backends) == set(expected)
diff --git a/lib/matplotlib/tests/test_matplotlib.py b/lib/matplotlib/tests/test_matplotlib.py
index a1aa4ec212d6..6baef7c07e88 100644
--- a/lib/matplotlib/tests/test_matplotlib.py
+++ b/lib/matplotlib/tests/test_matplotlib.py
@@ -57,10 +57,12 @@ def parse(key):
             backends += [e.strip() for e in line.split(',') if e]
         return backends
 
+    from matplotlib.backends.registry import BackendFilter, backendRegistry
+
     assert (set(parse('- interactive backends:\n')) ==
-            set(matplotlib.rcsetup.interactive_bk))
+            set(backendRegistry.list_builtin(BackendFilter.INTERACTIVE)))
     assert (set(parse('- non-interactive backends:\n')) ==
-            set(matplotlib.rcsetup.non_interactive_bk))
+            set(backendRegistry.list_builtin(BackendFilter.NON_INTERACTIVE)))
 
 
 def test_importable_with__OO():

From acb7bf54fede713988b58989a6ae3b1109746a2e Mon Sep 17 00:00:00 2001
From: Ian Thomas <ianthomas23@gmail.com>
Date: Wed, 31 Jan 2024 11:07:46 +0000
Subject: [PATCH 0769/1120] Use backend_registry for name of singleton instance

---
 lib/matplotlib/backend_bases.py               |  4 ++--
 lib/matplotlib/backends/registry.py           |  2 +-
 lib/matplotlib/backends/registry.pyi          |  2 +-
 lib/matplotlib/pyplot.py                      |  4 ++--
 lib/matplotlib/rcsetup.py                     | 12 ++++++------
 lib/matplotlib/tests/test_backend_registry.py |  8 ++++----
 lib/matplotlib/tests/test_matplotlib.py       |  6 +++---
 7 files changed, 19 insertions(+), 19 deletions(-)

diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
index 39771e4170db..586900529cb2 100644
--- a/lib/matplotlib/backend_bases.py
+++ b/lib/matplotlib/backend_bases.py
@@ -105,8 +105,8 @@ def _safe_pyplot_import():
         if current_framework is None:
             raise  # No, something else went wrong, likely with the install...
 
-        from matplotlib.backends.registry import backendRegistry
-        backend = backendRegistry.framework_to_backend(current_framework)
+        from matplotlib.backends.registry import backend_registry
+        backend = backend_registry.framework_to_backend(current_framework)
         if backend is None:
             raise KeyError(backend)
 
diff --git a/lib/matplotlib/backends/registry.py b/lib/matplotlib/backends/registry.py
index b445a89f96f0..d7c50b66f1d2 100644
--- a/lib/matplotlib/backends/registry.py
+++ b/lib/matplotlib/backends/registry.py
@@ -58,4 +58,4 @@ def list_builtin(self, filter_=None):
 
 
 # Singleton
-backendRegistry = BackendRegistry()
+backend_registry = BackendRegistry()
diff --git a/lib/matplotlib/backends/registry.pyi b/lib/matplotlib/backends/registry.pyi
index e5646c3d1bdc..e847ca690629 100644
--- a/lib/matplotlib/backends/registry.pyi
+++ b/lib/matplotlib/backends/registry.pyi
@@ -13,4 +13,4 @@ class BackendRegistry:
     def list_builtin(self, filter_: BackendFilter | None) -> list[str]: ...
 
 
-backendRegistry: BackendRegistry
+backend_registry: BackendRegistry
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 3442c778571b..329de8b3d26f 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -304,7 +304,7 @@ def switch_backend(newbackend: str) -> None:
         current_framework = cbook._get_running_interactive_framework()
 
         if (current_framework and
-                (backend := backendRegistry.framework_to_backend(current_framework))):
+                (backend := backend_registry.framework_to_backend(current_framework))):
             candidates = [backend]
         else:
             candidates = []
@@ -2505,7 +2505,7 @@ def polar(*args, **kwargs) -> list[Line2D]:
 # is compatible with the current running interactive framework.
 if (rcParams["backend_fallback"]
         and rcParams._get_backend_or_none() in (  # type: ignore
-            set(backendRegistry.list_builtin(BackendFilter.INTERACTIVE_NON_WEB)))
+            set(backend_registry.list_builtin(BackendFilter.INTERACTIVE_NON_WEB)))
         and cbook._get_running_interactive_framework()):  # type: ignore
     rcParams._set("backend", rcsetup._auto_backend_sentinel)  # type: ignore
 
diff --git a/lib/matplotlib/rcsetup.py b/lib/matplotlib/rcsetup.py
index 214656c9e60b..6ef689241a6a 100644
--- a/lib/matplotlib/rcsetup.py
+++ b/lib/matplotlib/rcsetup.py
@@ -23,7 +23,7 @@
 import numpy as np
 
 from matplotlib import _api, cbook
-from matplotlib.backends.registry import BackendFilter, backendRegistry
+from matplotlib.backends.registry import BackendFilter, backend_registry
 from matplotlib.cbook import ls_mapper
 from matplotlib.colors import Colormap, is_color_like
 from matplotlib._fontconfig_pattern import parse_fontconfig_pattern
@@ -34,10 +34,10 @@
 
 
 # Deprecation of module-level attributes using PEP 562
-_deprecated_interactive_bk = backendRegistry.list_builtin(BackendFilter.INTERACTIVE)
-_deprecated_non_interactive_bk = backendRegistry.list_builtin(
+_deprecated_interactive_bk = backend_registry.list_builtin(BackendFilter.INTERACTIVE)
+_deprecated_non_interactive_bk = backend_registry.list_builtin(
     BackendFilter.NON_INTERACTIVE)
-_deprecated_all_backends = backendRegistry.list_builtin()
+_deprecated_all_backends = backend_registry.list_builtin()
 
 _deprecated_names_and_args = {
     "interactive_bk": "matplotlib.backends.registry.BackendFilter.INTERACTIVE",
@@ -52,7 +52,7 @@ def __getattr__(name):
         _api.warn_deprecated(
             "3.9.0",
             name=name,
-            alternative="``matplotlib.backends.registry.backendRegistry"
+            alternative="``matplotlib.backends.registry.backend_registry"
                 f".list_builtin({arg})``",
         )
         return globals()[f"_deprecated_{name}"]
@@ -271,7 +271,7 @@ def validate_fonttype(s):
 
 
 _validate_standard_backends = ValidateInStrings(
-    'backend', backendRegistry.list_builtin(), ignorecase=True)
+    'backend', backend_registry.list_builtin(), ignorecase=True)
 _auto_backend_sentinel = object()
 
 
diff --git a/lib/matplotlib/tests/test_backend_registry.py b/lib/matplotlib/tests/test_backend_registry.py
index 98bdd9bd2793..541243379768 100644
--- a/lib/matplotlib/tests/test_backend_registry.py
+++ b/lib/matplotlib/tests/test_backend_registry.py
@@ -3,7 +3,7 @@
 
 import pytest
 
-from matplotlib.backends.registry import BackendFilter, backendRegistry
+from matplotlib.backends.registry import BackendFilter, backend_registry
 
 
 def has_duplicates(seq: Sequence[Any]) -> bool:
@@ -24,11 +24,11 @@ def has_duplicates(seq: Sequence[Any]) -> bool:
     ]
 )
 def test_framework_to_backend(framework, expected):
-    assert backendRegistry.framework_to_backend(framework) == expected
+    assert backend_registry.framework_to_backend(framework) == expected
 
 
 def test_list_builtin():
-    backends = backendRegistry.list_builtin()
+    backends = backend_registry.list_builtin()
     assert not has_duplicates(backends)
     # Compare using sets as order is not important
     assert set(backends) == set((
@@ -53,7 +53,7 @@ def test_list_builtin():
     ]
 )
 def test_list_builtin_with_filter(filter, expected):
-    backends = backendRegistry.list_builtin(filter)
+    backends = backend_registry.list_builtin(filter)
     assert not has_duplicates(backends)
     # Compare using sets as order is not important
     assert set(backends) == set(expected)
diff --git a/lib/matplotlib/tests/test_matplotlib.py b/lib/matplotlib/tests/test_matplotlib.py
index 6baef7c07e88..9cc68fefaca0 100644
--- a/lib/matplotlib/tests/test_matplotlib.py
+++ b/lib/matplotlib/tests/test_matplotlib.py
@@ -57,12 +57,12 @@ def parse(key):
             backends += [e.strip() for e in line.split(',') if e]
         return backends
 
-    from matplotlib.backends.registry import BackendFilter, backendRegistry
+    from matplotlib.backends.registry import BackendFilter, backend_registry
 
     assert (set(parse('- interactive backends:\n')) ==
-            set(backendRegistry.list_builtin(BackendFilter.INTERACTIVE)))
+            set(backend_registry.list_builtin(BackendFilter.INTERACTIVE)))
     assert (set(parse('- non-interactive backends:\n')) ==
-            set(backendRegistry.list_builtin(BackendFilter.NON_INTERACTIVE)))
+            set(backend_registry.list_builtin(BackendFilter.NON_INTERACTIVE)))
 
 
 def test_importable_with__OO():

From c20c0ac994709953b0bbfdadf786eac12929ef50 Mon Sep 17 00:00:00 2001
From: Ian Thomas <ianthomas23@gmail.com>
Date: Wed, 31 Jan 2024 11:22:28 +0000
Subject: [PATCH 0770/1120] Use class variables for immutable collections

---
 lib/matplotlib/backends/registry.py | 65 ++++++++++++++---------------
 1 file changed, 32 insertions(+), 33 deletions(-)

diff --git a/lib/matplotlib/backends/registry.py b/lib/matplotlib/backends/registry.py
index d7c50b66f1d2..1fa11c555f57 100644
--- a/lib/matplotlib/backends/registry.py
+++ b/lib/matplotlib/backends/registry.py
@@ -13,48 +13,47 @@ class BackendRegistry:
 
     This is the single source of truth for available backends.
     """
-    def __init__(self):
-        # Built-in backends are those which are included in the Matplotlib repo.
-        # A backend with name 'name' is located in the module
-        # f'matplotlib.backends.backend_{name.lower()}'
-
-        # The capitalized forms are needed for ipython at present; this may
-        # change for later versions.
-        self._builtin_interactive = [
-            "GTK3Agg", "GTK3Cairo", "GTK4Agg", "GTK4Cairo",
-            "MacOSX",
-            "nbAgg",
-            "QtAgg", "QtCairo", "Qt5Agg", "Qt5Cairo",
-            "TkAgg", "TkCairo",
-            "WebAgg",
-            "WX", "WXAgg", "WXCairo",
-        ]
-        self._builtin_not_interactive = [
-            "agg", "cairo", "pdf", "pgf", "ps", "svg", "template",
-        ]
-        self._framework_to_backend_mapping = {
-            "qt": "qtagg",
-            "gtk3": "gtk3agg",
-            "gtk4": "gtk4agg",
-            "wx": "wxagg",
-            "tk": "tkagg",
-            "macosx": "macosx",
-            "headless": "agg",
-        }
+    # Built-in backends are those which are included in the Matplotlib repo.
+    # A backend with name 'name' is located in the module
+    # f'matplotlib.backends.backend_{name.lower()}'
+
+    # The capitalized forms are needed for ipython at present; this may
+    # change for later versions.
+    _BUILTIN_INTERACTIVE = [
+        "GTK3Agg", "GTK3Cairo", "GTK4Agg", "GTK4Cairo",
+        "MacOSX",
+        "nbAgg",
+        "QtAgg", "QtCairo", "Qt5Agg", "Qt5Cairo",
+        "TkAgg", "TkCairo",
+        "WebAgg",
+        "WX", "WXAgg", "WXCairo",
+    ]
+    _BUILTIN_NOT_INTERACTIVE = [
+        "agg", "cairo", "pdf", "pgf", "ps", "svg", "template",
+    ]
+    _FRAMEWORK_TO_BACKEND_MAPPING = {
+        "qt": "qtagg",
+        "gtk3": "gtk3agg",
+        "gtk4": "gtk4agg",
+        "wx": "wxagg",
+        "tk": "tkagg",
+        "macosx": "macosx",
+        "headless": "agg",
+    }
 
     def framework_to_backend(self, interactive_framework):
-        return self._framework_to_backend_mapping.get(interactive_framework)
+        return self._FRAMEWORK_TO_BACKEND_MAPPING.get(interactive_framework)
 
     def list_builtin(self, filter_=None):
         if filter_ == BackendFilter.INTERACTIVE:
-            return self._builtin_interactive
+            return self._BUILTIN_INTERACTIVE
         elif filter_ == BackendFilter.INTERACTIVE_NON_WEB:
             return list(filter(lambda x: x.lower() not in ("webagg", "nbagg"),
-                               self._builtin_interactive))
+                               self._BUILTIN_INTERACTIVE))
         elif filter_ == BackendFilter.NON_INTERACTIVE:
-            return self._builtin_not_interactive
+            return self._BUILTIN_NOT_INTERACTIVE
 
-        return self._builtin_interactive + self._builtin_not_interactive
+        return self._BUILTIN_INTERACTIVE + self._BUILTIN_NOT_INTERACTIVE
 
 
 # Singleton

From 9a952c1f663892f6f4b9e89832221c8b61674dc5 Mon Sep 17 00:00:00 2001
From: Ian Thomas <ianthomas23@gmail.com>
Date: Wed, 31 Jan 2024 11:33:39 +0000
Subject: [PATCH 0771/1120] Review comments

---
 lib/matplotlib/backend_bases.py               | 2 +-
 lib/matplotlib/backends/registry.py           | 6 +++---
 lib/matplotlib/backends/registry.pyi          | 2 +-
 lib/matplotlib/pyplot.py                      | 5 +++--
 lib/matplotlib/tests/test_backend_registry.py | 4 ++--
 5 files changed, 10 insertions(+), 9 deletions(-)

diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
index 586900529cb2..55d86973d7c8 100644
--- a/lib/matplotlib/backend_bases.py
+++ b/lib/matplotlib/backend_bases.py
@@ -106,7 +106,7 @@ def _safe_pyplot_import():
             raise  # No, something else went wrong, likely with the install...
 
         from matplotlib.backends.registry import backend_registry
-        backend = backend_registry.framework_to_backend(current_framework)
+        backend = backend_registry.backend_for_gui_framework(current_framework)
         if backend is None:
             raise KeyError(backend)
 
diff --git a/lib/matplotlib/backends/registry.py b/lib/matplotlib/backends/registry.py
index 1fa11c555f57..74e275415266 100644
--- a/lib/matplotlib/backends/registry.py
+++ b/lib/matplotlib/backends/registry.py
@@ -31,7 +31,7 @@ class BackendRegistry:
     _BUILTIN_NOT_INTERACTIVE = [
         "agg", "cairo", "pdf", "pgf", "ps", "svg", "template",
     ]
-    _FRAMEWORK_TO_BACKEND_MAPPING = {
+    _GUI_FRAMEWORK_TO_BACKEND_MAPPING = {
         "qt": "qtagg",
         "gtk3": "gtk3agg",
         "gtk4": "gtk4agg",
@@ -41,8 +41,8 @@ class BackendRegistry:
         "headless": "agg",
     }
 
-    def framework_to_backend(self, interactive_framework):
-        return self._FRAMEWORK_TO_BACKEND_MAPPING.get(interactive_framework)
+    def backend_for_gui_framework(self, framework):
+        return self._GUI_FRAMEWORK_TO_BACKEND_MAPPING.get(framework)
 
     def list_builtin(self, filter_=None):
         if filter_ == BackendFilter.INTERACTIVE:
diff --git a/lib/matplotlib/backends/registry.pyi b/lib/matplotlib/backends/registry.pyi
index e847ca690629..e68d55717c20 100644
--- a/lib/matplotlib/backends/registry.pyi
+++ b/lib/matplotlib/backends/registry.pyi
@@ -9,7 +9,7 @@ class BackendFilter(Enum):
 
 class BackendRegistry:
     def __init__(self) -> None: ...
-    def framework_to_backend(self, interactive_framework: str) -> str | None: ...
+    def backend_for_gui_framework(self, interactive_framework: str) -> str | None: ...
     def list_builtin(self, filter_: BackendFilter | None) -> list[str]: ...
 
 
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 329de8b3d26f..0c08e25cfb83 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -304,7 +304,8 @@ def switch_backend(newbackend: str) -> None:
         current_framework = cbook._get_running_interactive_framework()
 
         if (current_framework and
-                (backend := backend_registry.framework_to_backend(current_framework))):
+                (backend := backend_registry.backend_for_gui_framework(
+                current_framework))):
             candidates = [backend]
         else:
             candidates = []
@@ -2505,7 +2506,7 @@ def polar(*args, **kwargs) -> list[Line2D]:
 # is compatible with the current running interactive framework.
 if (rcParams["backend_fallback"]
         and rcParams._get_backend_or_none() in (  # type: ignore
-            set(backend_registry.list_builtin(BackendFilter.INTERACTIVE_NON_WEB)))
+            backend_registry.list_builtin(BackendFilter.INTERACTIVE_NON_WEB))
         and cbook._get_running_interactive_framework()):  # type: ignore
     rcParams._set("backend", rcsetup._auto_backend_sentinel)  # type: ignore
 
diff --git a/lib/matplotlib/tests/test_backend_registry.py b/lib/matplotlib/tests/test_backend_registry.py
index 541243379768..123243dae924 100644
--- a/lib/matplotlib/tests/test_backend_registry.py
+++ b/lib/matplotlib/tests/test_backend_registry.py
@@ -23,8 +23,8 @@ def has_duplicates(seq: Sequence[Any]) -> bool:
         ('does not exist', None),
     ]
 )
-def test_framework_to_backend(framework, expected):
-    assert backend_registry.framework_to_backend(framework) == expected
+def test_backend_for_gui_framework(framework, expected):
+    assert backend_registry.backend_for_gui_framework(framework) == expected
 
 
 def test_list_builtin():

From 5a7a7a2ef95e38c8cb42b0ee5e2f6102b4d257c3 Mon Sep 17 00:00:00 2001
From: Ian Thomas <ianthomas23@gmail.com>
Date: Fri, 2 Feb 2024 09:23:27 +0000
Subject: [PATCH 0772/1120] Update lib/matplotlib/backend_bases.py

Co-authored-by: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
---
 lib/matplotlib/backend_bases.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
index 55d86973d7c8..68eae35f1596 100644
--- a/lib/matplotlib/backend_bases.py
+++ b/lib/matplotlib/backend_bases.py
@@ -108,7 +108,7 @@ def _safe_pyplot_import():
         from matplotlib.backends.registry import backend_registry
         backend = backend_registry.backend_for_gui_framework(current_framework)
         if backend is None:
-            raise KeyError(backend)
+            raise RuntimeError(f"No suitable backend for the current GUI framework {current_framework!r}")
 
         rcParams["backend"] = mpl.rcParamsOrig["backend"] = backend
         import matplotlib.pyplot as plt  # Now this should succeed.

From 896b3e32ad882c9e8e694c31ad16b1cb85646348 Mon Sep 17 00:00:00 2001
From: Ian Thomas <ianthomas23@gmail.com>
Date: Fri, 2 Feb 2024 09:30:26 +0000
Subject: [PATCH 0773/1120] Linting/mypy fixes

---
 lib/matplotlib/backend_bases.py | 3 ++-
 lib/matplotlib/rcsetup.pyi      | 2 ++
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
index 68eae35f1596..9c99b05966ed 100644
--- a/lib/matplotlib/backend_bases.py
+++ b/lib/matplotlib/backend_bases.py
@@ -108,7 +108,8 @@ def _safe_pyplot_import():
         from matplotlib.backends.registry import backend_registry
         backend = backend_registry.backend_for_gui_framework(current_framework)
         if backend is None:
-            raise RuntimeError(f"No suitable backend for the current GUI framework {current_framework!r}")
+            raise RuntimeError("No suitable backend for the current GUI framework "
+                               f"{current_framework!r}")
 
         rcParams["backend"] = mpl.rcParamsOrig["backend"] = backend
         import matplotlib.pyplot as plt  # Now this should succeed.
diff --git a/lib/matplotlib/rcsetup.pyi b/lib/matplotlib/rcsetup.pyi
index 1538dac7510e..1d393e2797b0 100644
--- a/lib/matplotlib/rcsetup.pyi
+++ b/lib/matplotlib/rcsetup.pyi
@@ -8,6 +8,8 @@ interactive_bk: list[str]
 non_interactive_bk: list[str]
 all_backends: list[str]
 
+def __dir__() -> list[str]: ...
+
 _T = TypeVar("_T")
 
 def _listify_validator(s: Callable[[Any], _T]) -> Callable[[Any], list[_T]]: ...

From de94746d4af2ef424c49b84ec9ba8f3c651a078b Mon Sep 17 00:00:00 2001
From: Ian Thomas <ianthomas23@gmail.com>
Date: Fri, 9 Feb 2024 11:12:47 +0000
Subject: [PATCH 0774/1120] Remove INTERACTIVE_NON_WEB backend filter

---
 lib/matplotlib/backends/registry.py           | 6 +-----
 lib/matplotlib/backends/registry.pyi          | 1 -
 lib/matplotlib/pyplot.py                      | 3 ++-
 lib/matplotlib/tests/test_backend_registry.py | 3 ---
 4 files changed, 3 insertions(+), 10 deletions(-)

diff --git a/lib/matplotlib/backends/registry.py b/lib/matplotlib/backends/registry.py
index 74e275415266..94b976d51688 100644
--- a/lib/matplotlib/backends/registry.py
+++ b/lib/matplotlib/backends/registry.py
@@ -3,8 +3,7 @@
 
 class BackendFilter(Enum):
     INTERACTIVE = 0
-    INTERACTIVE_NON_WEB = 1
-    NON_INTERACTIVE = 2
+    NON_INTERACTIVE = 1
 
 
 class BackendRegistry:
@@ -47,9 +46,6 @@ def backend_for_gui_framework(self, framework):
     def list_builtin(self, filter_=None):
         if filter_ == BackendFilter.INTERACTIVE:
             return self._BUILTIN_INTERACTIVE
-        elif filter_ == BackendFilter.INTERACTIVE_NON_WEB:
-            return list(filter(lambda x: x.lower() not in ("webagg", "nbagg"),
-                               self._BUILTIN_INTERACTIVE))
         elif filter_ == BackendFilter.NON_INTERACTIVE:
             return self._BUILTIN_NOT_INTERACTIVE
 
diff --git a/lib/matplotlib/backends/registry.pyi b/lib/matplotlib/backends/registry.pyi
index e68d55717c20..ef3579bcd271 100644
--- a/lib/matplotlib/backends/registry.pyi
+++ b/lib/matplotlib/backends/registry.pyi
@@ -3,7 +3,6 @@ from enum import Enum
 
 class BackendFilter(Enum):
     INTERACTIVE: int
-    INTERACTIVE_NON_WEB: int
     NON_INTERACTIVE: int
 
 
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 0c08e25cfb83..b266a206e9c0 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -2506,7 +2506,8 @@ def polar(*args, **kwargs) -> list[Line2D]:
 # is compatible with the current running interactive framework.
 if (rcParams["backend_fallback"]
         and rcParams._get_backend_or_none() in (  # type: ignore
-            backend_registry.list_builtin(BackendFilter.INTERACTIVE_NON_WEB))
+            set(backend_registry.list_builtin(BackendFilter.INTERACTIVE)) -
+            {'WebAgg', 'nbAgg'})
         and cbook._get_running_interactive_framework()):  # type: ignore
     rcParams._set("backend", rcsetup._auto_backend_sentinel)  # type: ignore
 
diff --git a/lib/matplotlib/tests/test_backend_registry.py b/lib/matplotlib/tests/test_backend_registry.py
index 123243dae924..3c54b92b1662 100644
--- a/lib/matplotlib/tests/test_backend_registry.py
+++ b/lib/matplotlib/tests/test_backend_registry.py
@@ -45,9 +45,6 @@ def test_list_builtin():
          ['GTK3Agg', 'GTK3Cairo', 'GTK4Agg', 'GTK4Cairo', 'MacOSX', 'nbAgg', 'QtAgg',
           'QtCairo', 'Qt5Agg', 'Qt5Cairo', 'TkAgg', 'TkCairo', 'WebAgg', 'WX', 'WXAgg',
            'WXCairo']),
-        (BackendFilter.INTERACTIVE_NON_WEB,
-         ['GTK3Agg', 'GTK3Cairo', 'GTK4Agg', 'GTK4Cairo', 'MacOSX', 'QtAgg', 'QtCairo',
-          'Qt5Agg', 'Qt5Cairo', 'TkAgg', 'TkCairo', 'WX', 'WXAgg', 'WXCairo']),
         (BackendFilter.NON_INTERACTIVE,
          ['agg', 'cairo', 'pdf', 'pgf', 'ps', 'svg', 'template']),
     ]

From f852721b0029adf7a1ae98b0e39e2292caac7f6f Mon Sep 17 00:00:00 2001
From: Ian Thomas <ianthomas23@gmail.com>
Date: Wed, 14 Feb 2024 11:41:07 +0000
Subject: [PATCH 0775/1120] Small changes from review

---
 lib/matplotlib/pyplot.py                      | 2 +-
 lib/matplotlib/tests/test_backend_registry.py | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index b266a206e9c0..0e6fc6f8b7ca 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -305,7 +305,7 @@ def switch_backend(newbackend: str) -> None:
 
         if (current_framework and
                 (backend := backend_registry.backend_for_gui_framework(
-                current_framework))):
+                    current_framework))):
             candidates = [backend]
         else:
             candidates = []
diff --git a/lib/matplotlib/tests/test_backend_registry.py b/lib/matplotlib/tests/test_backend_registry.py
index 3c54b92b1662..ca1a667d5e36 100644
--- a/lib/matplotlib/tests/test_backend_registry.py
+++ b/lib/matplotlib/tests/test_backend_registry.py
@@ -31,11 +31,11 @@ def test_list_builtin():
     backends = backend_registry.list_builtin()
     assert not has_duplicates(backends)
     # Compare using sets as order is not important
-    assert set(backends) == set((
+    assert {*backends} == {
         'GTK3Agg', 'GTK3Cairo', 'GTK4Agg', 'GTK4Cairo', 'MacOSX', 'nbAgg', 'QtAgg',
         'QtCairo', 'Qt5Agg', 'Qt5Cairo', 'TkAgg', 'TkCairo', 'WebAgg', 'WX', 'WXAgg',
         'WXCairo', 'agg', 'cairo', 'pdf', 'pgf', 'ps', 'svg', 'template',
-    ))
+    }
 
 
 @pytest.mark.parametrize(
@@ -53,4 +53,4 @@ def test_list_builtin_with_filter(filter, expected):
     backends = backend_registry.list_builtin(filter)
     assert not has_duplicates(backends)
     # Compare using sets as order is not important
-    assert set(backends) == set(expected)
+    assert {*backends} == {*expected}

From a0363a3dc0ed0029eeb017fcf85dfb7d926b85e9 Mon Sep 17 00:00:00 2001
From: Ian Thomas <ianthomas23@gmail.com>
Date: Wed, 14 Feb 2024 11:50:43 +0000
Subject: [PATCH 0776/1120] Use _api.caching_module_getattr for deprecated
 module-level attributes

---
 lib/matplotlib/rcsetup.py                     | 39 +++++++++----------
 lib/matplotlib/tests/test_backend_registry.py | 11 ++++++
 2 files changed, 29 insertions(+), 21 deletions(-)

diff --git a/lib/matplotlib/rcsetup.py b/lib/matplotlib/rcsetup.py
index 6ef689241a6a..fc0bbe325649 100644
--- a/lib/matplotlib/rcsetup.py
+++ b/lib/matplotlib/rcsetup.py
@@ -39,28 +39,25 @@
     BackendFilter.NON_INTERACTIVE)
 _deprecated_all_backends = backend_registry.list_builtin()
 
-_deprecated_names_and_args = {
-    "interactive_bk": "matplotlib.backends.registry.BackendFilter.INTERACTIVE",
-    "non_interactive_bk": "matplotlib.backends.registry.BackendFilter.NON_INTERACTIVE",
-    "all_backends": "",
-}
-
-
-def __getattr__(name):
-    if name in _deprecated_names_and_args:
-        arg = _deprecated_names_and_args[name]
-        _api.warn_deprecated(
-            "3.9.0",
-            name=name,
-            alternative="``matplotlib.backends.registry.backend_registry"
-                f".list_builtin({arg})``",
-        )
-        return globals()[f"_deprecated_{name}"]
-    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
-
 
-def __dir__():
-    return sorted(globals().keys() | _deprecated_names_and_args.keys())
+@_api.caching_module_getattr
+class __getattr__:
+    interactive_bk = _api.deprecated(
+        "3.9",
+        alternative="``matplotlib.backends.registry.backend_registry.list_builtin"
+            "(matplotlib.backends.registry.BackendFilter.INTERACTIVE)``"
+    )(property(lambda self: _deprecated_interactive_bk))
+
+    non_interactive_bk = _api.deprecated(
+        "3.9",
+        alternative="``matplotlib.backends.registry.backend_registry.list_builtin"
+            "(matplotlib.backends.registry.BackendFilter.NON_INTERACTIVE)``"
+    )(property(lambda self: _deprecated_non_interactive_bk))
+
+    all_backends = _api.deprecated(
+        "3.9",
+        alternative="``matplotlib.backends.registry.backend_registry.list_builtin()``"
+    )(property(lambda self: _deprecated_all_backends))
 
 
 class ValidateInStrings:
diff --git a/lib/matplotlib/tests/test_backend_registry.py b/lib/matplotlib/tests/test_backend_registry.py
index ca1a667d5e36..f6217bd9e410 100644
--- a/lib/matplotlib/tests/test_backend_registry.py
+++ b/lib/matplotlib/tests/test_backend_registry.py
@@ -3,6 +3,7 @@
 
 import pytest
 
+import matplotlib as mpl
 from matplotlib.backends.registry import BackendFilter, backend_registry
 
 
@@ -54,3 +55,13 @@ def test_list_builtin_with_filter(filter, expected):
     assert not has_duplicates(backends)
     # Compare using sets as order is not important
     assert {*backends} == {*expected}
+
+
+def test_deprecated_rcsetup_attributes():
+    match = "was deprecated in Matplotlib 3.9"
+    with pytest.warns(mpl.MatplotlibDeprecationWarning, match=match):
+        mpl.rcsetup.interactive_bk
+    with pytest.warns(mpl.MatplotlibDeprecationWarning, match=match):
+        mpl.rcsetup.non_interactive_bk
+    with pytest.warns(mpl.MatplotlibDeprecationWarning, match=match):
+        mpl.rcsetup.all_backends

From ff8b24bcf79c53bd4c11585d49cd56b062af5603 Mon Sep 17 00:00:00 2001
From: Ian Thomas <ianthomas23@gmail.com>
Date: Wed, 14 Feb 2024 12:18:28 +0000
Subject: [PATCH 0777/1120] Add docstrings

---
 lib/matplotlib/backends/registry.py | 34 +++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/lib/matplotlib/backends/registry.py b/lib/matplotlib/backends/registry.py
index 94b976d51688..8c0687c6f6dd 100644
--- a/lib/matplotlib/backends/registry.py
+++ b/lib/matplotlib/backends/registry.py
@@ -2,6 +2,11 @@
 
 
 class BackendFilter(Enum):
+    """
+    Filter used with :meth:`~.BackendRegistry.list_builtins`
+
+    .. versionadded:: 3.9
+    """
     INTERACTIVE = 0
     NON_INTERACTIVE = 1
 
@@ -11,6 +16,8 @@ class BackendRegistry:
     Registry of backends available within Matplotlib.
 
     This is the single source of truth for available backends.
+
+    .. versionadded:: 3.9
     """
     # Built-in backends are those which are included in the Matplotlib repo.
     # A backend with name 'name' is located in the module
@@ -41,9 +48,36 @@ class BackendRegistry:
     }
 
     def backend_for_gui_framework(self, framework):
+        """
+        Return the name of the backend corresponding to the specified GUI framework.
+
+        Parameters
+        ----------
+        framework : str
+            GUI framework such as "qt".
+
+        Returns
+        -------
+        str
+            Backend name.
+        """
         return self._GUI_FRAMEWORK_TO_BACKEND_MAPPING.get(framework)
 
     def list_builtin(self, filter_=None):
+        """
+        Return list of backends that are built into Matplotlib.
+
+        Parameters
+        ----------
+        filter_ : `~.BackendFilter`, optional
+            Filter to apply to returned backends. For example, to return only
+            non-interactive backends use `.BackendFilter.NON_INTERACTIVE`.
+
+        Returns
+        -------
+        list of str
+            Backend names.
+        """
         if filter_ == BackendFilter.INTERACTIVE:
             return self._BUILTIN_INTERACTIVE
         elif filter_ == BackendFilter.NON_INTERACTIVE:

From 67bec5be504c347e3241dac37956c99f3d1c67b3 Mon Sep 17 00:00:00 2001
From: Ian Thomas <ianthomas23@gmail.com>
Date: Wed, 14 Feb 2024 12:34:08 +0000
Subject: [PATCH 0778/1120] Add api changes and what new docs

---
 doc/api/backend_registry_api.rst                   |  8 ++++++++
 doc/api/index_backend_api.rst                      |  1 +
 doc/api/next_api_changes/deprecations/27719-IT.rst | 12 ++++++++++++
 doc/users/next_whats_new/backend_registry.rst      |  5 +++++
 4 files changed, 26 insertions(+)
 create mode 100644 doc/api/backend_registry_api.rst
 create mode 100644 doc/api/next_api_changes/deprecations/27719-IT.rst
 create mode 100644 doc/users/next_whats_new/backend_registry.rst

diff --git a/doc/api/backend_registry_api.rst b/doc/api/backend_registry_api.rst
new file mode 100644
index 000000000000..ca184c67d0a2
--- /dev/null
+++ b/doc/api/backend_registry_api.rst
@@ -0,0 +1,8 @@
+********************************
+``matplotlib.backends.registry``
+********************************
+
+.. automodule:: matplotlib.backends.registry
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/doc/api/index_backend_api.rst b/doc/api/index_backend_api.rst
index 6012f71c52a4..66009d86825d 100644
--- a/doc/api/index_backend_api.rst
+++ b/doc/api/index_backend_api.rst
@@ -17,6 +17,7 @@
    backend_pdf_api.rst
    backend_pgf_api.rst
    backend_ps_api.rst
+   backend_registry_api.rst
    backend_qt_api.rst
    backend_svg_api.rst
    backend_tk_api.rst
diff --git a/doc/api/next_api_changes/deprecations/27719-IT.rst b/doc/api/next_api_changes/deprecations/27719-IT.rst
new file mode 100644
index 000000000000..4ae0c71a8098
--- /dev/null
+++ b/doc/api/next_api_changes/deprecations/27719-IT.rst
@@ -0,0 +1,12 @@
+`~.rcsetup.interactive_bk`, `~.rcsetup.non_interactive_bk` and `~.rcsetup.all_backends`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+... are deprecated and replaced by
+:meth:`matplotlib.backends.registry.backend_registry.list_builtin`
+with the following arguments
+
+- `matplotlib.backends.registry.BackendFilter.INTERACTIVE`
+- `matplotlib.backends.registry.BackendFilter.NON_INTERACTIVE`
+- ``None``
+
+respectively.
diff --git a/doc/users/next_whats_new/backend_registry.rst b/doc/users/next_whats_new/backend_registry.rst
new file mode 100644
index 000000000000..59e19403ff19
--- /dev/null
+++ b/doc/users/next_whats_new/backend_registry.rst
@@ -0,0 +1,5 @@
+BackendRegistry
+~~~~~~~~~~~~~~~
+
+New `~/.BackendRegistry` class is the single source of truth for available
+backends. The singleton instance is `matplotlib.backends.registry.backend_registry`.

From c77dc59bc778c0b048e96c27204a9e27e27ab737 Mon Sep 17 00:00:00 2001
From: Ian Thomas <ianthomas23@gmail.com>
Date: Wed, 14 Feb 2024 14:02:14 +0000
Subject: [PATCH 0779/1120] Fix docs

---
 doc/api/next_api_changes/deprecations/27719-IT.rst | 4 ++--
 doc/users/next_whats_new/backend_registry.rst      | 5 +++--
 lib/matplotlib/backends/registry.py                | 5 ++++-
 3 files changed, 9 insertions(+), 5 deletions(-)

diff --git a/doc/api/next_api_changes/deprecations/27719-IT.rst b/doc/api/next_api_changes/deprecations/27719-IT.rst
index 4ae0c71a8098..952403f2cd0e 100644
--- a/doc/api/next_api_changes/deprecations/27719-IT.rst
+++ b/doc/api/next_api_changes/deprecations/27719-IT.rst
@@ -1,8 +1,8 @@
-`~.rcsetup.interactive_bk`, `~.rcsetup.non_interactive_bk` and `~.rcsetup.all_backends`
+``rcsetup.interactive_bk``, ``rcsetup.non_interactive_bk`` and ``rcsetup.all_backends``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 ... are deprecated and replaced by
-:meth:`matplotlib.backends.registry.backend_registry.list_builtin`
+:meth:`matplotlib.backends.registry.BackendRegistry.list_builtin`
 with the following arguments
 
 - `matplotlib.backends.registry.BackendFilter.INTERACTIVE`
diff --git a/doc/users/next_whats_new/backend_registry.rst b/doc/users/next_whats_new/backend_registry.rst
index 59e19403ff19..3bdac58d6124 100644
--- a/doc/users/next_whats_new/backend_registry.rst
+++ b/doc/users/next_whats_new/backend_registry.rst
@@ -1,5 +1,6 @@
 BackendRegistry
 ~~~~~~~~~~~~~~~
 
-New `~/.BackendRegistry` class is the single source of truth for available
-backends. The singleton instance is `matplotlib.backends.registry.backend_registry`.
+New :class:`~matplotlib.backends.registry.BackendRegistry` class is the single
+source of truth for available backends. The singleton instance is
+``matplotlib.backends.registry.backend_registry``.
diff --git a/lib/matplotlib/backends/registry.py b/lib/matplotlib/backends/registry.py
index 8c0687c6f6dd..4b8b7bee7e91 100644
--- a/lib/matplotlib/backends/registry.py
+++ b/lib/matplotlib/backends/registry.py
@@ -3,7 +3,7 @@
 
 class BackendFilter(Enum):
     """
-    Filter used with :meth:`~.BackendRegistry.list_builtins`
+    Filter used with :meth:`~matplotlib.backends.registry.BackendRegistry.list_builtin`
 
     .. versionadded:: 3.9
     """
@@ -17,6 +17,9 @@ class BackendRegistry:
 
     This is the single source of truth for available backends.
 
+    All use of ``BackendRegistry`` should be via the singleton instance
+    ``backend_registry``.
+
     .. versionadded:: 3.9
     """
     # Built-in backends are those which are included in the Matplotlib repo.

From c2fa794d86869ba71abaf495d042fa34a78704eb Mon Sep 17 00:00:00 2001
From: Ian Thomas <ianthomas23@gmail.com>
Date: Thu, 15 Feb 2024 09:06:51 +0000
Subject: [PATCH 0780/1120] Inline the deprecation function calls

---
 lib/matplotlib/rcsetup.py | 31 +++++++++++++++----------------
 1 file changed, 15 insertions(+), 16 deletions(-)

diff --git a/lib/matplotlib/rcsetup.py b/lib/matplotlib/rcsetup.py
index fc0bbe325649..c955f9006676 100644
--- a/lib/matplotlib/rcsetup.py
+++ b/lib/matplotlib/rcsetup.py
@@ -33,31 +33,30 @@
 from cycler import Cycler, cycler as ccycler
 
 
-# Deprecation of module-level attributes using PEP 562
-_deprecated_interactive_bk = backend_registry.list_builtin(BackendFilter.INTERACTIVE)
-_deprecated_non_interactive_bk = backend_registry.list_builtin(
-    BackendFilter.NON_INTERACTIVE)
-_deprecated_all_backends = backend_registry.list_builtin()
-
-
 @_api.caching_module_getattr
 class __getattr__:
-    interactive_bk = _api.deprecated(
+    @_api.deprecated(
         "3.9",
         alternative="``matplotlib.backends.registry.backend_registry.list_builtin"
-            "(matplotlib.backends.registry.BackendFilter.INTERACTIVE)``"
-    )(property(lambda self: _deprecated_interactive_bk))
+            "(matplotlib.backends.registry.BackendFilter.INTERACTIVE)``")
+    @property
+    def interactive_bk(self):
+        return backend_registry.list_builtin(BackendFilter.INTERACTIVE)
 
-    non_interactive_bk = _api.deprecated(
+    @_api.deprecated(
         "3.9",
         alternative="``matplotlib.backends.registry.backend_registry.list_builtin"
-            "(matplotlib.backends.registry.BackendFilter.NON_INTERACTIVE)``"
-    )(property(lambda self: _deprecated_non_interactive_bk))
+            "(matplotlib.backends.registry.BackendFilter.NON_INTERACTIVE)``")
+    @property
+    def non_interactive_bk(self):
+        return backend_registry.list_builtin(BackendFilter.NON_INTERACTIVE)
 
-    all_backends = _api.deprecated(
+    @_api.deprecated(
         "3.9",
-        alternative="``matplotlib.backends.registry.backend_registry.list_builtin()``"
-    )(property(lambda self: _deprecated_all_backends))
+        alternative="``matplotlib.backends.registry.backend_registry.list_builtin()``")
+    @property
+    def all_backends(self):
+        return backend_registry.list_builtin()
 
 
 class ValidateInStrings:

From a5ae8dfa34dc224e7acb8aeb08a6718b62cb702e Mon Sep 17 00:00:00 2001
From: Ian Thomas <ianthomas23@gmail.com>
Date: Thu, 15 Feb 2024 09:35:34 +0000
Subject: [PATCH 0781/1120] Import BackendFilter and backend_registry into
 matplotlib.backends.__init__.py

---
 doc/api/next_api_changes/deprecations/27719-IT.rst |  7 +++----
 doc/users/next_whats_new/backend_registry.rst      |  2 +-
 lib/matplotlib/backend_bases.py                    |  2 +-
 lib/matplotlib/backends/__init__.py                |  2 ++
 lib/matplotlib/backends/registry.py                |  2 +-
 lib/matplotlib/pyplot.py                           |  2 +-
 lib/matplotlib/rcsetup.py                          | 12 ++++++------
 lib/matplotlib/tests/test_backend_registry.py      |  2 +-
 lib/matplotlib/tests/test_matplotlib.py            |  2 +-
 9 files changed, 17 insertions(+), 16 deletions(-)

diff --git a/doc/api/next_api_changes/deprecations/27719-IT.rst b/doc/api/next_api_changes/deprecations/27719-IT.rst
index 952403f2cd0e..c41e9d2c396f 100644
--- a/doc/api/next_api_changes/deprecations/27719-IT.rst
+++ b/doc/api/next_api_changes/deprecations/27719-IT.rst
@@ -1,12 +1,11 @@
 ``rcsetup.interactive_bk``, ``rcsetup.non_interactive_bk`` and ``rcsetup.all_backends``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-... are deprecated and replaced by
-:meth:`matplotlib.backends.registry.BackendRegistry.list_builtin`
+... are deprecated and replaced by ``matplotlib.backends.backend_registry.list_builtin``
 with the following arguments
 
-- `matplotlib.backends.registry.BackendFilter.INTERACTIVE`
-- `matplotlib.backends.registry.BackendFilter.NON_INTERACTIVE`
+- ``matplotlib.backends.BackendFilter.INTERACTIVE``
+- ``matplotlib.backends.BackendFilter.NON_INTERACTIVE``
 - ``None``
 
 respectively.
diff --git a/doc/users/next_whats_new/backend_registry.rst b/doc/users/next_whats_new/backend_registry.rst
index 3bdac58d6124..61b65a9d6470 100644
--- a/doc/users/next_whats_new/backend_registry.rst
+++ b/doc/users/next_whats_new/backend_registry.rst
@@ -3,4 +3,4 @@ BackendRegistry
 
 New :class:`~matplotlib.backends.registry.BackendRegistry` class is the single
 source of truth for available backends. The singleton instance is
-``matplotlib.backends.registry.backend_registry``.
+``matplotlib.backends.backend_registry``.
diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
index 9c99b05966ed..8e789c908152 100644
--- a/lib/matplotlib/backend_bases.py
+++ b/lib/matplotlib/backend_bases.py
@@ -105,7 +105,7 @@ def _safe_pyplot_import():
         if current_framework is None:
             raise  # No, something else went wrong, likely with the install...
 
-        from matplotlib.backends.registry import backend_registry
+        from matplotlib.backends import backend_registry
         backend = backend_registry.backend_for_gui_framework(current_framework)
         if backend is None:
             raise RuntimeError("No suitable backend for the current GUI framework "
diff --git a/lib/matplotlib/backends/__init__.py b/lib/matplotlib/backends/__init__.py
index 3e687f85b0be..cf0f682d5d4b 100644
--- a/lib/matplotlib/backends/__init__.py
+++ b/lib/matplotlib/backends/__init__.py
@@ -1,3 +1,5 @@
+from .registry import BackendFilter, backend_registry  # noqa: F401
+
 # NOTE: plt.switch_backend() (called at import time) will add a "backend"
 # attribute here for backcompat.
 _QT_FORCE_QT5_BINDING = False
diff --git a/lib/matplotlib/backends/registry.py b/lib/matplotlib/backends/registry.py
index 4b8b7bee7e91..484d6ed5f26d 100644
--- a/lib/matplotlib/backends/registry.py
+++ b/lib/matplotlib/backends/registry.py
@@ -18,7 +18,7 @@ class BackendRegistry:
     This is the single source of truth for available backends.
 
     All use of ``BackendRegistry`` should be via the singleton instance
-    ``backend_registry``.
+    ``backend_registry`` which can be imported from ``matplotlib.backends``.
 
     .. versionadded:: 3.9
     """
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 0e6fc6f8b7ca..f9a4ddf701a9 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -69,7 +69,7 @@
 from matplotlib.artist import Artist
 from matplotlib.axes import Axes
 from matplotlib.axes import Subplot  # noqa: F401
-from matplotlib.backends.registry import BackendFilter, backendRegistry
+from matplotlib.backends import BackendFilter, backend_registry
 from matplotlib.projections import PolarAxes
 from matplotlib import mlab  # for detrend_none, window_hanning
 from matplotlib.scale import get_scale_names  # noqa: F401
diff --git a/lib/matplotlib/rcsetup.py b/lib/matplotlib/rcsetup.py
index c955f9006676..6abc8372222d 100644
--- a/lib/matplotlib/rcsetup.py
+++ b/lib/matplotlib/rcsetup.py
@@ -23,7 +23,7 @@
 import numpy as np
 
 from matplotlib import _api, cbook
-from matplotlib.backends.registry import BackendFilter, backend_registry
+from matplotlib.backends import BackendFilter, backend_registry
 from matplotlib.cbook import ls_mapper
 from matplotlib.colors import Colormap, is_color_like
 from matplotlib._fontconfig_pattern import parse_fontconfig_pattern
@@ -37,23 +37,23 @@
 class __getattr__:
     @_api.deprecated(
         "3.9",
-        alternative="``matplotlib.backends.registry.backend_registry.list_builtin"
-            "(matplotlib.backends.registry.BackendFilter.INTERACTIVE)``")
+        alternative="``matplotlib.backends.backend_registry.list_builtin"
+            "(matplotlib.backends.BackendFilter.INTERACTIVE)``")
     @property
     def interactive_bk(self):
         return backend_registry.list_builtin(BackendFilter.INTERACTIVE)
 
     @_api.deprecated(
         "3.9",
-        alternative="``matplotlib.backends.registry.backend_registry.list_builtin"
-            "(matplotlib.backends.registry.BackendFilter.NON_INTERACTIVE)``")
+        alternative="``matplotlib.backends.backend_registry.list_builtin"
+            "(matplotlib.backends.BackendFilter.NON_INTERACTIVE)``")
     @property
     def non_interactive_bk(self):
         return backend_registry.list_builtin(BackendFilter.NON_INTERACTIVE)
 
     @_api.deprecated(
         "3.9",
-        alternative="``matplotlib.backends.registry.backend_registry.list_builtin()``")
+        alternative="``matplotlib.backends.backend_registry.list_builtin()``")
     @property
     def all_backends(self):
         return backend_registry.list_builtin()
diff --git a/lib/matplotlib/tests/test_backend_registry.py b/lib/matplotlib/tests/test_backend_registry.py
index f6217bd9e410..aed258f36413 100644
--- a/lib/matplotlib/tests/test_backend_registry.py
+++ b/lib/matplotlib/tests/test_backend_registry.py
@@ -4,7 +4,7 @@
 import pytest
 
 import matplotlib as mpl
-from matplotlib.backends.registry import BackendFilter, backend_registry
+from matplotlib.backends import BackendFilter, backend_registry
 
 
 def has_duplicates(seq: Sequence[Any]) -> bool:
diff --git a/lib/matplotlib/tests/test_matplotlib.py b/lib/matplotlib/tests/test_matplotlib.py
index 9cc68fefaca0..a2f467ac48de 100644
--- a/lib/matplotlib/tests/test_matplotlib.py
+++ b/lib/matplotlib/tests/test_matplotlib.py
@@ -57,7 +57,7 @@ def parse(key):
             backends += [e.strip() for e in line.split(',') if e]
         return backends
 
-    from matplotlib.backends.registry import BackendFilter, backend_registry
+    from matplotlib.backends import BackendFilter, backend_registry
 
     assert (set(parse('- interactive backends:\n')) ==
             set(backend_registry.list_builtin(BackendFilter.INTERACTIVE)))

From 7812db71aaaa2337626d4e63d6f5046ca9937d99 Mon Sep 17 00:00:00 2001
From: Ian Thomas <ianthomas23@gmail.com>
Date: Tue, 27 Feb 2024 11:32:48 +0000
Subject: [PATCH 0782/1120] Mypy fixes

---
 lib/matplotlib/pyplot.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index f9a4ddf701a9..778a9e132d43 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -2505,11 +2505,11 @@ def polar(*args, **kwargs) -> list[Line2D]:
 # requested, ignore rcParams['backend'] and force selection of a backend that
 # is compatible with the current running interactive framework.
 if (rcParams["backend_fallback"]
-        and rcParams._get_backend_or_none() in (  # type: ignore
+        and rcParams._get_backend_or_none() in (  # type: ignore[attr-defined]
             set(backend_registry.list_builtin(BackendFilter.INTERACTIVE)) -
             {'WebAgg', 'nbAgg'})
-        and cbook._get_running_interactive_framework()):  # type: ignore
-    rcParams._set("backend", rcsetup._auto_backend_sentinel)  # type: ignore
+        and cbook._get_running_interactive_framework()):
+    rcParams._set("backend", rcsetup._auto_backend_sentinel)
 
 # fmt: on
 

From d350e5687c32f9e5ce8383613233ad3e6a96ec7b Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Wed, 28 Feb 2024 10:55:19 +0100
Subject: [PATCH 0783/1120] Simplify color/marker disambiguation logic in
 _process_plot_format.

There's a bit of code in the parsing of plot() format shorthands to
disambiguate the "1" marker and the "1.0" grayscale color string.  It's
actually easier to just explicitly check for the bad strings.

This also makes it clearer that we *could* have supported "0" as
unambiguous color string (white) as there's no "0" marker (there's a
0 (int) marker, which is not the same...), but let's not bother with
changing any semantics.
---
 lib/matplotlib/axes/_base.py | 24 ++++++++----------------
 1 file changed, 8 insertions(+), 16 deletions(-)

diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index 0617fc7681bd..ed25a32d15bb 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -143,24 +143,16 @@ def _process_plot_format(fmt, *, ambiguous_fmt_datakey=False):
     marker = None
     color = None
 
-    # Is fmt just a colorspec?
-    try:
-        color = mcolors.to_rgba(fmt)
-
-        # We need to differentiate grayscale '1.0' from tri_down marker '1'
+    # First check whether fmt is just a colorspec, but specifically exclude the
+    # grayscale string "1" (not "1.0"), which is interpreted as the tri_down
+    # marker "1".  The grayscale string "0" could be unambiguously understood
+    # as a color (black) but also excluded for consistency.
+    if fmt not in ["0", "1"]:
         try:
-            fmtint = str(int(fmt))
+            color = mcolors.to_rgba(fmt)
+            return linestyle, marker, color
         except ValueError:
-            return linestyle, marker, color  # Yes
-        else:
-            if fmt != fmtint:
-                # user definitely doesn't want tri_down marker
-                return linestyle, marker, color  # Yes
-            else:
-                # ignore converted color
-                color = None
-    except ValueError:
-        pass  # No, not just a color.
+            pass
 
     errfmt = ("{!r} is neither a data key nor a valid format string ({})"
               if ambiguous_fmt_datakey else

From 8a98b6ca2e449baa7b55a9024d1aa345b01e79c4 Mon Sep 17 00:00:00 2001
From: Matthias Bussonnier <bussonniermatthias@gmail.com>
Date: Thu, 29 Feb 2024 15:14:32 +0100
Subject: [PATCH 0784/1120] DOC: use ... for continuation prompt in docstrings

Otherwise this is imporperly parsed and interpreted as the output that
should have been produced by the preceding line.
---
 lib/matplotlib/axis.py   | 2 +-
 lib/matplotlib/colors.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/axis.py b/lib/matplotlib/axis.py
index c0cd2617e878..dbd65aba4a17 100644
--- a/lib/matplotlib/axis.py
+++ b/lib/matplotlib/axis.py
@@ -1001,7 +1001,7 @@ def get_tick_params(self, which='major'):
         ::
 
             >>> ax.yaxis.set_tick_params(labelsize=30, labelcolor='red',
-                                         direction='out', which='major')
+            ...                          direction='out', which='major')
             >>> ax.yaxis.get_tick_params(which='major')
             {'direction': 'out',
             'left': True,
diff --git a/lib/matplotlib/colors.py b/lib/matplotlib/colors.py
index 70e275fdaeca..9a493c928fdb 100644
--- a/lib/matplotlib/colors.py
+++ b/lib/matplotlib/colors.py
@@ -1471,7 +1471,7 @@ def __init__(self, vcenter, vmin=None, vmax=None):
 
             >>> import matplotlib.colors as mcolors
             >>> offset = mcolors.TwoSlopeNorm(vmin=-4000.,
-                                              vcenter=0., vmax=10000)
+            ...                               vcenter=0., vmax=10000)
             >>> data = [-4000., -2000., 0., 2500., 5000., 7500., 10000.]
             >>> offset(data)
             array([0., 0.25, 0.5, 0.625, 0.75, 0.875, 1.0])

From 0adab7b62f5adf01efd9920ba8ab7b748819b0ca Mon Sep 17 00:00:00 2001
From: Anja Beck <anja.beck@cern.ch>
Date: Fri, 23 Feb 2024 15:12:58 +0000
Subject: [PATCH 0785/1120] add side option for violinplot

add test for side option in violinplot

add whats new for side in violinplot

add violin side option to _axes.pyi and pyplot.py

use side option in violinplot also for lines

add side option to violinplot example

use newer style and correct seed in violin test

update image

change option naming

use proper syntax for code in violin docs

Co-authored-by: Kyle Sunden <git@ksunden.space>

add changed violinplots (capstyle=projecting)

hardcode capstyle only for left-right violins

fix typo
---
 doc/users/next_whats_new/sides_violinplot.rst |   4 ++
 galleries/examples/statistics/violinplot.py   |  40 +++++++++++-----
 lib/matplotlib/axes/_axes.py                  |  45 ++++++++++++++----
 lib/matplotlib/axes/_axes.pyi                 |   2 +
 lib/matplotlib/pyplot.py                      |   2 +
 .../test_axes/violinplot_sides.png            | Bin 0 -> 11534 bytes
 lib/matplotlib/tests/test_axes.py             |  15 ++++++
 7 files changed, 88 insertions(+), 20 deletions(-)
 create mode 100644 doc/users/next_whats_new/sides_violinplot.rst
 create mode 100644 lib/matplotlib/tests/baseline_images/test_axes/violinplot_sides.png

diff --git a/doc/users/next_whats_new/sides_violinplot.rst b/doc/users/next_whats_new/sides_violinplot.rst
new file mode 100644
index 000000000000..f1643de8e322
--- /dev/null
+++ b/doc/users/next_whats_new/sides_violinplot.rst
@@ -0,0 +1,4 @@
+Add option to plot only one half of violin plot
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Setting the parameter *side* to 'low' or 'high' allows to only plot one half of the violin plot.
diff --git a/galleries/examples/statistics/violinplot.py b/galleries/examples/statistics/violinplot.py
index 8779022dd96c..afcc1c977034 100644
--- a/galleries/examples/statistics/violinplot.py
+++ b/galleries/examples/statistics/violinplot.py
@@ -28,55 +28,73 @@
 pos = [1, 2, 4, 5, 7, 8]
 data = [np.random.normal(0, std, size=100) for std in pos]
 
-fig, axs = plt.subplots(nrows=2, ncols=5, figsize=(10, 6))
+fig, axs = plt.subplots(nrows=2, ncols=6, figsize=(10, 4))
 
 axs[0, 0].violinplot(data, pos, points=20, widths=0.3,
                      showmeans=True, showextrema=True, showmedians=True)
-axs[0, 0].set_title('Custom violinplot 1', fontsize=fs)
+axs[0, 0].set_title('Custom violin 1', fontsize=fs)
 
 axs[0, 1].violinplot(data, pos, points=40, widths=0.5,
                      showmeans=True, showextrema=True, showmedians=True,
                      bw_method='silverman')
-axs[0, 1].set_title('Custom violinplot 2', fontsize=fs)
+axs[0, 1].set_title('Custom violin 2', fontsize=fs)
 
 axs[0, 2].violinplot(data, pos, points=60, widths=0.7, showmeans=True,
                      showextrema=True, showmedians=True, bw_method=0.5)
-axs[0, 2].set_title('Custom violinplot 3', fontsize=fs)
+axs[0, 2].set_title('Custom violin 3', fontsize=fs)
 
 axs[0, 3].violinplot(data, pos, points=60, widths=0.7, showmeans=True,
                      showextrema=True, showmedians=True, bw_method=0.5,
                      quantiles=[[0.1], [], [], [0.175, 0.954], [0.75], [0.25]])
-axs[0, 3].set_title('Custom violinplot 4', fontsize=fs)
+axs[0, 3].set_title('Custom violin 4', fontsize=fs)
 
 axs[0, 4].violinplot(data[-1:], pos[-1:], points=60, widths=0.7,
                      showmeans=True, showextrema=True, showmedians=True,
                      quantiles=[0.05, 0.1, 0.8, 0.9], bw_method=0.5)
-axs[0, 4].set_title('Custom violinplot 5', fontsize=fs)
+axs[0, 4].set_title('Custom violin 5', fontsize=fs)
+
+axs[0, 5].violinplot(data[-1:], pos[-1:], points=60, widths=0.7,
+                     showmeans=True, showextrema=True, showmedians=True,
+                     quantiles=[0.05, 0.1, 0.8, 0.9], bw_method=0.5, side='low')
+
+axs[0, 5].violinplot(data[-1:], pos[-1:], points=60, widths=0.7,
+                     showmeans=True, showextrema=True, showmedians=True,
+                     quantiles=[0.05, 0.1, 0.8, 0.9], bw_method=0.5, side='high')
+axs[0, 5].set_title('Custom violin 6', fontsize=fs)
 
 axs[1, 0].violinplot(data, pos, points=80, vert=False, widths=0.7,
                      showmeans=True, showextrema=True, showmedians=True)
-axs[1, 0].set_title('Custom violinplot 6', fontsize=fs)
+axs[1, 0].set_title('Custom violin 7', fontsize=fs)
 
 axs[1, 1].violinplot(data, pos, points=100, vert=False, widths=0.9,
                      showmeans=True, showextrema=True, showmedians=True,
                      bw_method='silverman')
-axs[1, 1].set_title('Custom violinplot 7', fontsize=fs)
+axs[1, 1].set_title('Custom violin 8', fontsize=fs)
 
 axs[1, 2].violinplot(data, pos, points=200, vert=False, widths=1.1,
                      showmeans=True, showextrema=True, showmedians=True,
                      bw_method=0.5)
-axs[1, 2].set_title('Custom violinplot 8', fontsize=fs)
+axs[1, 2].set_title('Custom violin 9', fontsize=fs)
 
 axs[1, 3].violinplot(data, pos, points=200, vert=False, widths=1.1,
                      showmeans=True, showextrema=True, showmedians=True,
                      quantiles=[[0.1], [], [], [0.175, 0.954], [0.75], [0.25]],
                      bw_method=0.5)
-axs[1, 3].set_title('Custom violinplot 9', fontsize=fs)
+axs[1, 3].set_title('Custom violin 10', fontsize=fs)
 
 axs[1, 4].violinplot(data[-1:], pos[-1:], points=200, vert=False, widths=1.1,
                      showmeans=True, showextrema=True, showmedians=True,
                      quantiles=[0.05, 0.1, 0.8, 0.9], bw_method=0.5)
-axs[1, 4].set_title('Custom violinplot 10', fontsize=fs)
+axs[1, 4].set_title('Custom violin 11', fontsize=fs)
+
+axs[1, 5].violinplot(data[-1:], pos[-1:], points=200, vert=False, widths=1.1,
+                     showmeans=True, showextrema=True, showmedians=True,
+                     quantiles=[0.05, 0.1, 0.8, 0.9], bw_method=0.5, side='low')
+
+axs[1, 5].violinplot(data[-1:], pos[-1:], points=200, vert=False, widths=1.1,
+                     showmeans=True, showextrema=True, showmedians=True,
+                     quantiles=[0.05, 0.1, 0.8, 0.9], bw_method=0.5, side='high')
+axs[1, 5].set_title('Custom violin 12', fontsize=fs)
 
 
 for ax in axs.flat:
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 55f1d31740e2..59d2862d775e 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -8205,7 +8205,7 @@ def matshow(self, Z, **kwargs):
     @_preprocess_data(replace_names=["dataset"])
     def violinplot(self, dataset, positions=None, vert=True, widths=0.5,
                    showmeans=False, showextrema=True, showmedians=False,
-                   quantiles=None, points=100, bw_method=None):
+                   quantiles=None, points=100, bw_method=None, side='both'):
         """
         Make a violin plot.
 
@@ -8258,6 +8258,10 @@ def violinplot(self, dataset, positions=None, vert=True, widths=0.5,
           its only parameter and return a scalar. If None (default), 'scott'
           is used.
 
+        side : {'both', 'low', 'high'}, default: 'both'
+            'both' plots standard violins. 'low'/'high' only
+            plots the side below/above the positions value.
+
         data : indexable object, optional
             DATA_PARAMETER_PLACEHOLDER
 
@@ -8309,10 +8313,10 @@ def _kde_method(X, coords):
                                      quantiles=quantiles)
         return self.violin(vpstats, positions=positions, vert=vert,
                            widths=widths, showmeans=showmeans,
-                           showextrema=showextrema, showmedians=showmedians)
+                           showextrema=showextrema, showmedians=showmedians, side=side)
 
     def violin(self, vpstats, positions=None, vert=True, widths=0.5,
-               showmeans=False, showextrema=True, showmedians=False):
+               showmeans=False, showextrema=True, showmedians=False, side='both'):
         """
         Draw a violin plot from pre-computed statistics.
 
@@ -8368,6 +8372,10 @@ def violin(self, vpstats, positions=None, vert=True, widths=0.5,
         showmedians : bool, default: False
           If true, will toggle rendering of the medians.
 
+        side : {'both', 'low', 'high'}, default: 'both'
+            'both' plots standard violins. 'low'/'high' only
+            plots the side below/above the positions value.
+
         Returns
         -------
         dict
@@ -8430,8 +8438,13 @@ def violin(self, vpstats, positions=None, vert=True, widths=0.5,
         elif len(widths) != N:
             raise ValueError(datashape_message.format("widths"))
 
+        # Validate side
+        _api.check_in_list(["both", "low", "high"], side=side)
+
         # Calculate ranges for statistics lines (shape (2, N)).
-        line_ends = [[-0.25], [0.25]] * np.array(widths) + positions
+        line_ends = [[-0.25 if side in ['both', 'low'] else 0],
+                     [0.25 if side in ['both', 'high'] else 0]] \
+                          * np.array(widths) + positions
 
         # Colors.
         if mpl.rcParams['_internal.classic_mode']:
@@ -8443,12 +8456,24 @@ def violin(self, vpstats, positions=None, vert=True, widths=0.5,
         # Check whether we are rendering vertically or horizontally
         if vert:
             fill = self.fill_betweenx
-            perp_lines = functools.partial(self.hlines, colors=linecolor)
-            par_lines = functools.partial(self.vlines, colors=linecolor)
+            if side in ['low', 'high']:
+                perp_lines = functools.partial(self.hlines, colors=linecolor,
+                                                capstyle='projecting')
+                par_lines = functools.partial(self.vlines, colors=linecolor,
+                                                capstyle='projecting')
+            else:
+                perp_lines = functools.partial(self.hlines, colors=linecolor)
+                par_lines = functools.partial(self.vlines, colors=linecolor)
         else:
             fill = self.fill_between
-            perp_lines = functools.partial(self.vlines, colors=linecolor)
-            par_lines = functools.partial(self.hlines, colors=linecolor)
+            if side in ['low', 'high']:
+                perp_lines = functools.partial(self.vlines, colors=linecolor,
+                                                capstyle='projecting')
+                par_lines = functools.partial(self.hlines, colors=linecolor,
+                                                capstyle='projecting')
+            else:
+                perp_lines = functools.partial(self.vlines, colors=linecolor)
+                par_lines = functools.partial(self.hlines, colors=linecolor)
 
         # Render violins
         bodies = []
@@ -8456,7 +8481,9 @@ def violin(self, vpstats, positions=None, vert=True, widths=0.5,
             # The 0.5 factor reflects the fact that we plot from v-p to v+p.
             vals = np.array(stats['vals'])
             vals = 0.5 * width * vals / vals.max()
-            bodies += [fill(stats['coords'], -vals + pos, vals + pos,
+            bodies += [fill(stats['coords'],
+                            -vals + pos if side in ['both', 'low'] else pos,
+                            vals + pos if side in ['both', 'high'] else pos,
                             facecolor=fillcolor, alpha=0.3)]
             means.append(stats['mean'])
             mins.append(stats['min'])
diff --git a/lib/matplotlib/axes/_axes.pyi b/lib/matplotlib/axes/_axes.pyi
index 501cb933037a..b40ee337206f 100644
--- a/lib/matplotlib/axes/_axes.pyi
+++ b/lib/matplotlib/axes/_axes.pyi
@@ -743,6 +743,7 @@ class Axes(_AxesBase):
         | float
         | Callable[[GaussianKDE], float]
         | None = ...,
+        side: Literal["both", "low", "high"] = ...,
         *,
         data=...,
     ) -> dict[str, Collection]: ...
@@ -755,6 +756,7 @@ class Axes(_AxesBase):
         showmeans: bool = ...,
         showextrema: bool = ...,
         showmedians: bool = ...,
+        side: Literal["both", "low", "high"] = ...,
     ) -> dict[str, Collection]: ...
 
     table = mtable.table
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 2cf0d5325a63..c5044fe7242f 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -4075,6 +4075,7 @@ def violinplot(
     | float
     | Callable[[GaussianKDE], float]
     | None = None,
+    side: Literal["both", "low", "high"] = "both",
     *,
     data=None,
 ) -> dict[str, Collection]:
@@ -4089,6 +4090,7 @@ def violinplot(
         quantiles=quantiles,
         points=points,
         bw_method=bw_method,
+        side=side,
         **({"data": data} if data is not None else {}),
     )
 
diff --git a/lib/matplotlib/tests/baseline_images/test_axes/violinplot_sides.png b/lib/matplotlib/tests/baseline_images/test_axes/violinplot_sides.png
new file mode 100644
index 0000000000000000000000000000000000000000..f30bc46b8c5c31be8070c4fb7d26c84d8d290a4c
GIT binary patch
literal 11534
zcmd^lc|6qZ_xEQ8k*sywN<^h@#8|Q=6xyX?EM-lI?E5-1-IXP4DHPFa84MC)EOSRD
z*-~T~gREJ{*al<FbA8<R@Av)VdH(u6|2<DHy}VqXbDis4=Q`Ip=X#$Ld*$+3e%`&j
z5Crj`KWB6ef{-`}LJafl03*jc2gblJbbzr{fSI>TK(M2qGi2fz;N#&P;Nf=jK#;Sa
zznixgN=ZctrF6?VNL^b4rJ~@fs;Q;wjB-}GrHWEjN2#Gy6c5}E2=MXOQC9Z+@5xHu
zey+;tldo360y}-qS^Gnfpd<Vrk*A;Q20@DU=Z#L8hh)xC?PK10W=k&*v2yX%%+Rc7
z4C-O=!5V+LuMc_TIwi%=8GOTKg$SM6`4=~Vdsi$`@uO2Cm$1vD&%>v7$4hx!{zH8@
zpEpXe@g5Fqa4W@u({cFxWs9J&tw1yttD85SHUBK@+58l<jxb%VmmQsfpPzolB;YaC
z^-Dy;OfY&>D-i)1s7w!tL6E_9<N?UQk<$Reec}OXdLRrTAl`!z68hr|#0edZhj^eX
z;s_z=CF=h-!gLJ=m##|#sxe7_OI&|*!O$H2l<5cIPKc9L?CLT5^_hJguL&)M4|d`N
z7e<rxo61}}{Oor?3;cF<5fb|B^$vggGor|0j?IMzLE%#7j<ChC^AiOKXntgKQ#b2m
zc+g6CjS={6Bf!)PT{MC?ac6VJrfxV3L~uZVT>2kqKODh9y42(w@1+*8Qkp`e<jqXE
zt2PjWhc;bj%F3n)PU0gYE1^b4A6mLy8H1jd+1U6{aOkKMFSSN{=B|2XcQLb){X<{E
z)igEb1%t-!)L(7GuBL4b4!xMwQL@V>+q1^?8GvdD%kpj<8N2m<X)!Pg2Q20dk_S?A
zOAFjw#BSy4t#9gYVz&+qW_gc#Z?)5GBdJfen%OKYkxpNjx2@TturF@D8Cpw-iCJr?
zU%7F$*n&>gXLlG!hUrXI72ioKC}3hIEHTIHn9a(K((6YsQ$LDt6zQ!?F71X84svMp
z=bPOT8|!(mZM!t<ye>$0jPCn6lUMwpFs%F`_`$o$y;x$D&U6&mD!zI6^$P7Sijxo8
znJ_9I8O;2Y+}B>!H?Xnp7|EQR{2oksJ2|=p?El>D-%a9svi)s}z1f=+s~sId`$rFO
zO7Q^O-#xwCk}X>&1nDoWYX|N_EC{7@gb2>8==|*2a@E$??+7^#>7HR}L_(VbS7^yH
z&??2ms8y4eOuUMyi563~Yy6RGTAb+Gku_d-2$Fi{MLD8BIT;m3ZuEx^%2s=B_%Hs6
zSdhxn$4V93)mG~O`+3HE429hCGlvA71sv|n3>!M~tVvlEpbMAfk;8~;MMF}wIyZ`?
zz5ayv0Cea{HB!q<L%3mXCXtMZ@y)1^?Kz?+UAYHB9C+1*@L9VgNGc%j>EKZ3UO<5Z
zPrfp(fg1h%IZfIgyH3wvvETXjtqg=TkTukA{Fdv<!72~M<WC}2BgGn$F^APPcY-Nj
zWR5{qGo${$i#Xda15-5;$meRcmCn8wid%=jpG)N(?wNov<8<wS353fLm|dtmF1nmo
z>$Eb-@BsX`wmi=M#(0Larcf<Z1`GFS%;aSyMVzUe?LQEt5@h>Yp}&(?P9IkJRD~NQ
zdmu1GbLF&<KeY4@wFv2iM(AZKZ<GA+CVXTL;!VE=3wJI@)_ciERwnqK)0ciM2!A+0
z<{kbug5q#6GU~DBd7J{g*v?yS2!FCjopun1iXciEUgKOXbZBJWB+K6%0=v2hcE!0k
z%MnqTyi!g*J@FEmo(9j8TohX93EK7S-cwR2yi<c|-r-(`iWlwYaOgme{Zk5s|B%8q
zyCIGR%+iMXJ*7B!-dh12!?sTWN;L+IpTWkL_7NG<feY;6I%qaU^o)1vZ|aQziXpXb
zc*S&Gog^G{Ak=Lo?mCmBnrOI8rA{1GJqh@_q`Gn~u;jz6!w}bb9wz|SYAxS677{5W
z+sMdNs=@c{l>IPS(3g`?ah)Ak$x+~`TNPK3$uZuyIZ_<a1eb5?@HH<3+9s<+F$u_u
z{We#Dn$oQoWrpW8ZhoAs9(9aYp(hv03`hJkF86K7%K9R8*Eb;_J(ykLMJngUKCyte
z^IX0AknJEg;3W7P#0|46_?I=gNsS73nRRi#=jsi1z@j{T!_^uY4%vO}<jt9B<!C(x
zlb?)|!lhm7K*X2q))IrMo;ZmmlU2D<pL9t!@TymbR+>B3izw9z+F=NHu9OGxR==7d
zA|yQ>WM#vO9Nr6o+kYm15=v}XXyboDZj)Qb+W_O(9&Y9s=CEAM8Qjw=<Rb-(d~{up
zB*>48z43Q|glHD5XOAY|OZEH%92^6N?9IqNK`lX84AlUqw^WWXIvOJT#@MO-9)o2$
zUuiOgoG9fY#l(0WgmUD->`Q(haO*!khjTWThJeV++hnPp!#@S@Ol*GBXCM3U*LhR;
zr~@+iL`Y;U&O(U*KUk2rG*$Jxm|-uehOqsk=|NKuc^$&G$0=`ZIaSZEc(s1xyAEA~
zZ`HH6cATm<m(;M{5p2xk`bmN!a+{~b*lpy=?#)`swwGptC(>Y2iDimR<euO8^0+;$
zlfimJTD`)DRN(z2zvCV@7a=LuLTwzE&cl>rw-IXAT&Ro621}3`>_K<rTS8|qSypAZ
zt29UEK{<!P_W1nx5J_S`3J2Rd`N9g2=}%zo|E`D)hrBdYR)5@Y_oaMJ54jp8GyDPG
z`Kf7boLQyUd2ktpeBdOa^}vcG$#G<&tvTbAt9X#oGcbS83{mD9<9JrspdGk0sO8RJ
z+wcCVAhh9P$E^^$flCuzZ7&b<apZPQ)ZxgtYVF7y{q-^J9UW?R{7|&~#XY}cIVcNy
zrpl!5KI_G$)N@=5Qg$^V!lv1JwK^bzrUEaiWndi!T|UW;GF1Cr6pCx+!7&y#*Ox+8
zrn|f8i{mW=X`Cd)*Y~@=booPSXy|-{(89?=ivp`6iz;Of97mcClxQn98r0AA$7s+#
zr=hdm>M2{b_BRC_bmYOEDeW?OIoV%*40xd;hwmUca=4i<cDGfe>$~PXQOFD)I32m|
zHIZ62t$Q-BY2KS>Dn-e#kk5AmXMuX9*MdwQ&4bRQbEiLqHKGIG0`+@(c0gs9j>4C8
z>ITW?`JLPA7h5?l83NVpT#=B+`J<=()bCj!{uwz;Lue(IwRM9iCr<vb>pCY%9X^9A
zi=wCulSUf}PjROKFV~G0Z&w~IeqaM~T}QGwv>2xo#@b$Lx^cMXZ&QOK7$~|vaou52
zn`*&@;(`gk2OA#BQq>GM0C(L-GU_+cjd6U!43_Os3-9nVF_TsnV<?Bl$I(&L7Kt#h
z8`V0a8B{t~*_mJ)&=CDbdZRayA|55PQJUm6OPCiNoez>Ei{Fg#l?*12W0|U7LOg@Q
zM9}8wz)_3{x(mHO5IywK-ZD@f?LUe!)9keHR1e%^(rt93QZv!GHl})!c71V*C`rUg
z_6YejdL3R^98+Hpy(kNP67FB6^zvo&E)$(j%<2t-KLnUg*!q3d`(!+W)Uxq}X{)X{
z_(!9KdR5t}Q}JeZA^g*)=+s?!-&iiqSuFV=A1-p_Df#ej=+~oO0ZM^E<&>r-a&Vm0
zawSdu+x~P%$(z(-Cu;G*y2TT>td*U*2_tW{V^e~#>PLM0vzpF_%O3Fa4voT1@?SJe
zlyN}#1R)RH`pIwWv0-AfELJ+DY58khb)bkD=n?J7=d@w3NcK|mxLMZMI1|EZc0!w%
zdZfa9+`{*|#+6Y$iNspTuTeAa`4Algn%?uc&<w8viRA%KgY>?j-X`N<-@qE$5V`sW
z*%&K4gV|4YD5uEmb*kYV#g=T{+n3ah-hZU+eCDzCk;0QqAptSh(mb(HrSyBrz@i(3
zMuP^kWky~0jB3fT&L;7~@iLvHl}N7(m!?$*)4iDU)2opTy^4F%x5zHy(bVvPTIN`(
zaqXHAAEivoHg9k0TiW-__2<e@2M>6>zFzb=Q{j{R@E@EcjsOWc*-y#|93Q4M=`KvU
zL9fB4jJb@EvdBF&A|vXyzG|YAM-){#*SS`4f*EqcW3+n%U30y@n!YZN*K#u@d>Wn_
zS#}Ruf2$oDP@I%)R(a75amoD8eU+4$Cx|OtK&iusu%X%{eY!n67G#Jg*b_ssWuL7l
z6y$r1gN3~-yhkGZrMxw~N7^RZ(0RXFG#cbEtYGX(Sy>FzloeF?JfL1zpi`Vk3XphC
zC@9deXqz@X;9=@@zahs<)rOu1ayX()AauzJaq0ZQ-ynM_shsbjhb?V1Ij*Jt5#_t)
zp%veYzM^dTr@dg*k-77Q&!0|H?t-j;Lys=x^OYCe_@2Yr!B%?_$+DizIRd^ia!;{l
z@hFfg!_GOWA)xB|dW8R0vr}4kLyM?}>s((#N$*cgYp&{{EVh_$4FYvD{uS+wTO_;v
zvqDQJv2eDQT33soEeg*_@RzK!IBC-rSAYtM6c}+{NuFAcj1ooVBORhFP=-A_acYZS
z{nV>p5wAxwU6$kqgS<!QCW^Gf|L{EF;Y93fnrX|e6_~--?Y*`Yvh~Z!CjBubIb=<9
zBwYbVbaXIzI&lzM%(Efr*8Elu^0XwB+g$Cw$CPN28T1-zqRdfDrI_EpEuIg5{L5X?
zK1=RfELgWf@%rDb7ojl+n+pD_0oI6LaC~6pou=^6`Z3S;15b<jk1?FG*B%Pkr}8@B
zlb^goYAx51CqSP2(ic3M#{Bgo1iQ5oJCh>$RE#tOI{9svo$87EH-1O!Rg7v>ur#Vm
zDO3TfS2}*-q(@TQ%EQ9xS$fr0mL2;U`n@CqwY&VHgxUvZ2@wCcnZ|96OmAgxd9wrR
zcHNEL{9Mlx^S4K;RsU8VA+9MgoNsB4S#kO`B1&lH(4_ff9Rz9Z0C(1mi?r<MA<0S7
z&IgiZ6EJ(RGxqEo!on6K^xFxeA?UW%$cP9+eZ9UdOMR(ZGRjeF0!nukK`jYGf>&&N
z=yAFA=}gt(zxj4aY0_vW`3g7?EZ)2QXb>Mo8KHCcX?@_iWe46u4oIgFUWdid(AbV6
z&~{R}^H4TNy4Hb&{0_~x_U2~0VZWOkCg8AWkh&Ie&-g$Y9FmbvAfQI!LLvAo>aABy
z<e1_6e1*h!aEL)Ri`{+erTZd`Cq$jw=Q425y5F?oA4Qz4Y4jiSQ$&`wZRc$vFC|Zn
z_bT9oh2O{zdjOvw@={Uza3B}T@P;VR9(dK0I1bxGyCp==-^zmokpI$j?J@{DVp8+_
z5ZS-gxBWCo6&DPwf6Bild~v?rT8Pw=1|mrvJsYSPN_i&f4;@23Gs$2gaSbZqqBB*h
z9b>%2-%y5V3<lFN9wX`Wv6|WzxtGlHj9Ake@vqOs=iy`IW%2lj^0L$JjH+t<Yr?_j
z_=kA>>->V-c=_ip*c+CeKZ!|{Fb4fK;SHg{Tv>QP{vz>lmxy+pK_ZBnXFVu_rE}4}
z0fru{l@v@3y~>MC55lrl+^6OHa~@U@ocb(EZ%-FEb^k2&C?3-2<cYtec=nZisMgog
zZ^qK3J|5h{7n`W^l~u#M8^M}}gY%f|QR!Lh<pzRIRiexwp?+({)9iEe>sa&+^3?m-
zl#19C<2|`?a+gzy$vlilxkxLLkk6m`jjBS>F9Q#zZSoCoCe>53v3kaPM~#=JWJ^N;
zOWb=yX)t1fo|8Wk(An7M7o4d?(Ym4TTj74+&?{{m+tPTXO_lpw2eFC=mkd0yZ|VLK
zRz*^rCpIv=lqIyrNo?q}-_aO1pF)0~^N^P6nRzT@&8yq)K_e}-s49l5<*^yBII?}|
zQ|c+`{!UvDW(aY9gqkxXZCf+6?A!TNO)`9T0~5c*plD(1Yw7FwhgyA>{Pj1=eXG}m
zgiJ;8QDmhS3!i*!ULGVRf)J|vJ7?cWTbQLxSlRr@oJ%l8|GV)Yx&vBg06RM72bosi
zHxN?jhS#ESfBF$wz7U}Qw&r%g=*YgqTfQlW$9QpN!q6`TrHaT*dyml-<4XOC(n0x2
z-{467rWp)_wNzS>KjNYPHlo^tFd>ztXf7a~qDZ`T$Q0*hnnr(XECdODBbtb@yRggp
zXN($YEHc|K^H{A(zD-o^5`*|M7}NQ=V$W*b=P(MncvF*o*2rjc96Oqw@D$}=Ft29#
zRhYP{QDD5^mHF`3xcqnv)3a&%Rkj)TfzUujvLtCaSMdSc>Cc}z`&J#j#g@%iwbWUt
zCSss8?PsOtrtLhXH*>z=L61UAK}90|{n5iBaRw7Q?>NE3Bw4nQxaH2n*kpNWF>YpH
z>@TK&cfRw|lJ2%rLU8ICT6q7oEdkf-9(A$``RQsZN)Bo_hQ{*v8pORdZEI{9bQhN6
z;9wI<>48Ml$Lk4OZ0h2g`&Ih~p9*9qBCS549^7!whvf8~RX7c#-kE4NGEJmu6~q#T
zS3NI-mBZlRn0Kh9&dDut)AWj@Dl8L9f(ufW6{3l+Tnt+(>Hg8=Gtk&@{Ah^Nk@%IM
zkM3EUm@;ByVffEaPTwLOyBD474FwDko(_j*z?+YIo;vYEnv~QG{4c)~uu+O*%&Q@q
z^NIM<xu{+NqV^@qR)bvy#cP4RDQp$YDq@6gDrwX*mJ<PrR7YfSUk~=|?CbjFZiTJ>
zb9JSIy1Mo*to-?`4ne=zi?}}9b3E?BSHGLc;gf|uGgkJ@?1|0Ih*keBI(rP8#gar-
z+B0ce9Rq2Q^)gkQ{R6v>ja-?jZWC%rnQCW_7H>_9Nwd$^)AwaZ&Q4;-i!TN3r%p7`
zTG_vp+3z|q)cOq?i`l7^mhvL4SnUVne@p$Lc@yv;fMJvR)jRb;EA;jC^;ww(EK896
z`4GPa**D&Iz~oN}vPx5o_-Zy0bArz|uzm=u8}GE-uoXj{D`AIdZl18==Ll|aAbvOv
z&K<wV$Y%9n<t&OqoycPw%$CXHo+9k;^-HEh8&;M3M_@F|*vN>OSs}GlR=@04?rBwA
zERV&mRbuXZe>K?QmL}a!cg2ibzOfy!8^0qO*H`=?gOd~vUK^zs7W7*KiN{_i&Uo%6
zt7x!FGQ>hW=Z9SC7o7Y(5nq}jNN-Bq_no+V<t=cHwh@tD6wNj)^ON-Y^^XOX1>xKz
z@2aL5Y>urWO~3Vy-LOZZg7v~tb9DJG&fv9qqK$Awq{sr%L|TkOE!x5)pDFX^_wQ4_
zf*s6w_~lPy-DW=?oa6^Qe&kktTeqoKXaq%&=~4*{Hkj^0B~v2x4TdoU&FH#mj*sk+
zzCp>?5wrVwbJFxApO&~+;BwOwpf7JKZcm4VT_^wek+F2P8WU4Fqi1JN;UAl;j>BB3
zcxjV%a+5%l@Cg6tc5A16zUlMH^DbJh5}XE!*C<`|<-){VSLwfgffO|8hy5H^1g11W
zQ|z=1d3@u_T%Vui$$Gx9Bc6N8lY@16d2ol#wf%*mKhL1ibQV5=R&1gtNmdywBx=?F
z9@%7Rv=4!_CnxUjuG0ct&LXt2{)n2HN@>CF$LDs6kR(m7ZDk}tA-MKb&&~S!mEy6w
zcv*9_h<>KxNOX$v=A-OP;BZj!^f2n@nK;kP`XMy$(9Q>pitFlhd)5uCF2h;(f~T2n
z2G){1HO}JbkL&5k&v;*RB(}raIZw*+DfU~dF?2tvD^SGLRE!w<K%W}vCEgTLHnqC6
zGuV(^-18zUDx%E!hCP4VeE-Qvae}QnX6mFy=%W2d%Fn5KWx-$4C&(9|`zP{d<g<WK
z&CRm1my7k-!0BcLih2Je8q0b2*w#>%Cq#A&6W2qA<{GGd&fjhv_pP}7T4XWtLh8%M
zI>{ne#uZ~B9zmb#;^EC#(q0<owX<exUS+%P(=?fSQ53uG1)dj*&$VtG2P$L<Ew754
z<b4Fd#AzrG8FC4{2L2vD#Ij$T|3P3-Ffj~@t=h~=P|w)L`@WTNfuj@qq_SE<LtR_s
z>TXaAr`@toXYo3WXyYXCKhaT+lh;5D>wTT?)Y--SHAeAdvVuY=dKxUDnK_@iiu!)l
zVl$J>uJ=XWh4_;<G=SLNp7;5B#%~v!9gkIL)t-R<i5`$`R3okaz5O6+b`@R6cRwv$
z-hMx`<l`K<SG3O4jxt+$z^1Fzea5PsC{muwbf0T}eYJU%BBH`sC^)PF!jEvljQr(k
zV%zb3WLv9&RVR;XnF?k}FaKx)le%@M+L1wj)n@JST)w~hVGiMDXIEzzS}{ZC-;|-N
z^majkP_27#_7CWp_IN&&!;foLNEE(W00DgK{%P~>I^@qYjnf787-vcH?`U7K9nmTq
zzVVJ&taxyepi?6%QKg9>U&Zui>Pr((bk`aAtqX48`)$ocgagsWwd{`s+2_>{@%;~K
za^Re&zuMx}sKfa0M`GnN4s|aeo`|bxG;#VlSJ8sC_J&B>6-42+=z+gte!}UOJPxFM
z;z&I?J8O`|>5!4JAfx??;&b2$(c2!v6TT}yHnDkhQA%s3p_j2?1)~jjyBbK%3VyL1
z4xU>>h47=_VA=u&M)ElvqKuCm{wJ3VM^wb_3sraPaNQcJsi_9js<juv>B_holC}YM
zWOpeysmqY`JgNNx3`j__gnUMp^8YKFl|~X~ZV~UAd#2PJzW73CSQJJBci!qNm%Vxp
zuX<ml05=H(N}Sg$0lJMhSMcW|y@7L2&i9<8&vXkYqtVm#!f5wNqXr@RJR_JPmiq{U
zl>x8QGaf^<d8VG8UeC}_nSK1XvSZUmOLW3Tkybv0v^0R-YniN=p)In%Jr{|(xuGAk
zwk0@T_iz@#<Vj%yFF_`~XsQABoGLRM^k_miPJOcKGMA6t$coJMOw3324Ew;%&{W#>
z992GH!^#sICPqWXd>JtqqW(`|stdy^xRjWn!ay$xQFTV@*}=gKb~#)2we5JVR8Am^
zRlB8D;6T>pMv-L!AU!z_<nNihaI8Z%b!eQJYSZM)*p)-<-A`dKDZ#=S!Ner89s})X
zIVb=6WOJm5u9Zlq(m_#a)|;-)_L!L4ey!lm`>f>}LY-4rp;#$8A1^C<ggEM7Atszr
zDV(9%<25w<*TDr(yo+V$jjXx92FFWv<8GVkE3Wp|w1vOmKH4F)Al$J%8<9+&Q9XcR
z#A)gec^~{)eDLQalfqIF2qo+hFsc10vEX(8<kNm{bT=A!tcGN-jSKIg^p8j@P0z&_
zXD=Lt{34zkH})ydCSDv}llj9g6Z`RaeCt(wP{X|DC+gJJC@qMcgo>*^FA16PBXS41
ztya7N?%@ow`V=7X)Rw>I>0brZSJ%EcT~%I1FC=jco;55#)cpY+K)HWJ_dA-Du#PQT
z;x!}ed$ll0?BF+SoLGrA2%)=c_MAU@sH!Ej1a@#!Z4a~L2T%1Mzjs;l{gq=$<;bI1
zt!)Z?J>7wg%|EEVZsNeZ7V}FN4~gqd{KC6P|Gpf2iq>SKOU%_hlP~typ<OQWxU*!1
zh!{~<VfNoi((@^nwr4Z9ZUx)yCEGgtu)-=A*A|18l$MnT?pO$8SA+Eil+kGWT_HV*
z<htQc9r-uj4GIwOGkMQ-nlN=&AG$xnoB}WJr6peJ*Le9d#*ouBv~U3}m>k$pLPLM_
zzUbdwx!@T(=Z41@4r1G6Z?3b-lNqe&m%;H*b@g+-x<6<?Kc#$gc9OaN_zhP)KwxS<
zq25*3iSn^aGm`iXjTo4o#*M|_gS5YX1!3=4t(VwZEa?e^w9tb2AOC4r$HKYt;jAm}
z?lGO15Q#FM-Y^XO?Y}XHVWg~-Q&ytq=+!IpLBGG-2D=fWJc=1#h#LAd@q*Axaw`Bi
z+eCoONGtTguVnQ&YU#$W7JJQQY2?U?LvNAye1W1OX8L{Ph495!mUiKO$CgFZJ=(?=
zXSsF#SF{beu0WaDmf})xs@KDg)4zYi^2BH+&K+Y^5=m>f`v=X1O^CY!+eR8Z%Lew(
z`Bg&W(?R9oa}IJQ8E=qUv|>L)61iD{k4zY>+#4HS*d-Yi<0!p@Ij3X<-uQ_l-K<}!
zPBo%ZWGcDGmOtBq$?W#}vNHW~)t5Tk|JJ6yC?lr2Hi*YxGF4ZER27XwLrIS;#n;Sj
z&vq5W9Q_!%E8^aS_#`Cft`Ye{1GQ9UDFj`5+upguWuoK>hUepZF&`uhUV;>AnRr*S
zPkuPZ?XhN-(jyppbx%A7$q}HvTPE8u>)|1R`7cO^6vxi<vH#$sp*XS_goe!Edcx^u
zOJt>Iqs_B2!ejWJWk$g)F4!Ro@qJ+{<F}EX|3a-#-iZzSWz7vQavF$`{@7+zrj_OL
z4L&+3Wt$cG!~OxAr=OLt{tM?GFOnIKzO9;BX0#0gUxajD%Q%Sqi|M9<gU3TZwWGk^
z|Cw%Lc6PeRqhQ>(6;U{?GhKZ?to>Sk*<eFhZQ@E;B%JkzHWeU-uN?Q>PYpU3R97V*
zn9uQ23OAJp4K~DyDUVG3$h9PISEqMF+(%b*NqwSsL3Jt$n<5O+eyuM}(x<x%3P#6U
z(yEkq;y4aLn2exDn0Ci}KEzOid-=m|_oqx%NXsWb<CLZ6KC~IR*Hm-X=2(B;^AAgO
zbLhua1OW7pYg-^qZC>W7nvY&bpd?@zBh~rD$JppQ1?WUk6hL6M(epXkNQD#to&-ky
zY3dnOckdkxe%$no;vMd~>p5)@Di($Nu}x?lg-bdB?L}Tb3zrLydqz<Wq}GLeY&BOA
zm(PJAiMLWa2&R|iSWJ8@yRKM;t$Ylu>GDnKhZ5&AosxIk2MyQsBtEn>ijc-tUuU@t
zRJl)&5pjwhACkAr8(%<uN>BU67%g9JBYggi2$b?qbp(b`R+`mi@OmaE*vg+INnP-{
z!X*!3;qEC=Tv<l=lwQKNKZb+uJ>w|I%JdH?7qD<rxw`V02+O~tP1aDE6e}NWR{3Oo
zdVN~%`A?+-f5P-BU1-wAtjFW}T%8vav?_&N2H!z-(?M=d-WSSr=UG#n6IxJhz>j|4
zCN>^{td5(Q7ep836q#CF?RFcz`)~Q^P#_c^lP9eeaiaUe2-B*t5V~vvw)^as_0CPw
zFUrO&F_thkFDlXB{$#tfbSodiFiIdxY+4ZFoKfSoe=APvaXQm-p33RbKyB`a>9)sB
z3b-!q0EXFmG*D#W6+$U+&+i8!Bx|^W_-0JuuBqw4X>S0kn!JeEr?tdh{I~e#fR6MR
zDbYI-Cr@8J+|p>0+XrjmjJ4=r5u+Cd<>{OCJi841w#QmhG}g82%aOghK3w!l6lZ2M
zxLRuNX@Q5N(5wjy6tE7o?OEc7UFQT~G4jA&R=8VVnr06Q7=D4zBidz7z~hP+71Eg#
zczKqFPZV|u=IjEB))s-0Gz?~C%Gx}z->RgwgofHCo>lSK$@q3`tnPs*3OtNKG4%8K
zL<<ySm!<Y9q`{e)1dDJ(F(cfxIXus>7_va`k9!KG!-ZV60)R3(_uE%72#}l?qRgtO
z5Nd}lkW(~P>@Ud(NVgO^bOhMm?sIiVd?;tiuMbY$nMpyLoAl49v6Z(g&0k7)uMrYn
zEEPf)h*r2J$LYsOB6`iGhOKGJ-gM*9+Abh#jai_ykuOF5tuz1V>Qr~LtQ|bwOD(^q
z_0**_UWcA(=mks^6wbquL%vzI8=@#Ywh9<Z^0|z#!wb#ljacJ&r|vG$Q4veH?dk@j
z>7YO0y_K8*4lS}`xk@QgEo?#~TH!*akzXMvp`%W6p-xn2@+G$e1}1$R#-k<sdh0^(
z#&v_t23dNtTK4vW#v?2o$mWX8*I?>zytuyYRjFN9bG^9yH^y;k0MY!R^qNqPYlhA6
z{xxOJ^=Xhd^1hrNas)<l;FSg)wIHSt(OrkWbUN-G6v6{8)ww*|Ltb2FJy(yV0R+kB
z3_3RfSp<a$!Jm!-<WlyvUe(C}YG7{ipVo*7@$DJbx2$$X_=SHfP`zKes@8q(J1ijJ
zE}I+^6BZc$`)emM2bgQL0W3zp##yd~)t3OmQ-Y5OPm#xeD1zQ>w0?@~I41CHPG?%@
zd4);XWiPm6;WQe3IGcN|Pi7c+jGqg%zhSvc<$&CvTf<Bcp*bfzwZ5hcGrF_K5~}aw
zMjc*a3&8dpd$<_VFfpHN>n3-<HW}pX->h$ddn#^%)VndayH36#qQ(U@aa@TRVU*Yv
zJJs6RM@C>US#)<Oq;Oh;t~wl(r^jobAB{c8Niuwm3=veetBJ`q&9>X$k#({q@;sz_
z8oUakg#iAlEe;SDUF?>wU2RxkU`@ojD&sI>f#-M|f|JD8{jpz?bnn-TkI~)kA_^H+
z9N;w(h0}k=k*)_-$m6&Txq$Q_@$~Te8G$$6*n0(Fh}_R8@M&660d&6T3$>y+2gE~k
z|A6hmq8ok4>u)i1h9>mWWFLCkBzavC>|gbq9oME7q~R9rG}Aaa+5!&d%Yi_swU+mz
z%4YZ#_|KP@b$4vig%-#ne^*&UepcIK1fVv3-pp*yPtV>7)I>ZB=73bc=x~=@(C0=4
z4v+oAXI+wXN5RMczKRH`VT20d`0$N}B+d30j>cZ-433a<+lzr}^FGzWFWoyPO2B<i
zJ~hbeuwl=R!U@K~Jo8jNxPuQHimP!(Y%hFZvf{Sr-QjI!ne}(o?w9H`l&ED-!UKLv
z$mTL$t1+!ZgZy9@lR`eJ+BoZrSrM&71SIjKhx^KZeR4&h$ec!T1_Ik_d^y1l+9RfF
z_JP%Zf~Rr&3;!<}rm!Lnn}$f*6QiKgAWGW--MW%i!P^TC1>TFKUt)|)K8S02hk$x-
zUFnwu+<^T&P?3zILD10z$Vztz0bSW^Ncs%I!b_CsEx32ajSnH#5ez|3&OnM;FkPa|
zFdQJRh?_yc^}STz?LY@=Ihvr2`@FOtf<9kGD1s;EKfQYw-T<cH(0C8BVUu(#L@H&0
zZ=kdg2V1=xCusz*+V1^(sV<L$*ZofqAnv>PKji;u1N<XLmD2`h_&;h2{7|JltYTf<
zQ)*XStf%)+_Y^dA=KoOI2lyUT6Fu3HO)ju3CM2dQ+fRW0DO@->RKbF7dC(3u-vR+=
zA!6`f-HR%q&r1yee${P0GftF1?C4C6dQCWEYH|<&L0jbMva)8v=*Ch%L0OL(IOi^c
zMw<lL)oq8zfDD<fe)~1*iAd_=t?H#Mmi`90Zf%XtQr>Lt&|AHTrO__K_@v>?hx&~c
z?0lI$W0Jiw6!W?HzA|L*%p(r8(XACotvWC{IZ0oh`T;r+(7K_EhZy6Kk3*e0X9VlN
zd-5vz5kuWi3`wB5@be5cXXo7FQbSFCG>)~U0X9&UkCzuMm?%p!)t(KfK9QN1nXXPO
z%hhj=lo<FVg!;d2*USNh{G>juL}6iH;D6RHKsaLcW^Ls9Kh20W7?zH#EZkcGe_@8P
zHUf1cH`GC0?P|hd@(}mlC>hKqoxJud8a#{ew<b^O>nDN6w$CkT%A?IGN1EF+9#4iy
zUI<APcGflRpldx@kUUtor3<jwo??4)2WGV_Z${O%As^B+07bQ>Y_=|CJzF=_uZzub
zHYAb!`u?Q&)uyFo$t1&_9V#O&9c5i#hu*0=DMJQ-1N(-XRFl4elyqpbZ73ejORu?%
zYD-1$&T=x6==kBUD{xqs9OIWYX=ufX1jhd#%K(?;KQ{gUVqa@ITiX4Uk!s%hhhhl)
OJ8yj1h;Z8Bum1(WIoWmq

literal 0
HcmV?d00001

diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index f2f74f845338..8c43b04e0eb7 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -3794,6 +3794,21 @@ def test_horiz_violinplot_custompoints_200():
                   showextrema=False, showmedians=False, points=200)
 
 
+@image_comparison(['violinplot_sides.png'], remove_text=True, style='mpl20')
+def test_violinplot_sides():
+    ax = plt.axes()
+    np.random.seed(19680801)
+    data = [np.random.normal(size=100)]
+    # Check horizontal violinplot
+    for pos, side in zip([0, -0.5, 0.5], ['both', 'low', 'high']):
+        ax.violinplot(data, positions=[pos], vert=False, showmeans=False,
+                      showextrema=True, showmedians=True, side=side)
+    # Check vertical violinplot
+    for pos, side in zip([4, 3.5, 4.5], ['both', 'low', 'high']):
+        ax.violinplot(data, positions=[pos], vert=True, showmeans=False,
+                      showextrema=True, showmedians=True, side=side)
+
+
 def test_violinplot_bad_positions():
     ax = plt.axes()
     # First 9 digits of frac(sqrt(47))

From 0d5f82259a3f974e8e45822381d3faddb114d3cb Mon Sep 17 00:00:00 2001
From: Alec Vercruysse <vercruysse.alec@gmail.com>
Date: Fri, 1 Mar 2024 12:56:03 -0800
Subject: [PATCH 0786/1120] add test for color coded quiver3d

---
 .../test_axes3d/quiver3d_colorcoded.png         | Bin 0 -> 55531 bytes
 lib/mpl_toolkits/mplot3d/tests/test_axes3d.py   |  13 +++++++++++++
 2 files changed, 13 insertions(+)
 create mode 100644 lib/mpl_toolkits/mplot3d/tests/baseline_images/test_axes3d/quiver3d_colorcoded.png

diff --git a/lib/mpl_toolkits/mplot3d/tests/baseline_images/test_axes3d/quiver3d_colorcoded.png b/lib/mpl_toolkits/mplot3d/tests/baseline_images/test_axes3d/quiver3d_colorcoded.png
new file mode 100644
index 0000000000000000000000000000000000000000..09b27c306c61417bd78658f98dfbd12ac7bfd7be
GIT binary patch
literal 55531
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%0AbrL2q|
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
aQVD;$-Kf9x(3J^)?b)?o{}Ijh;{O7)cy1E_

literal 0
HcmV?d00001

diff --git a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
index 752636e45ddd..2b7bfc117f88 100644
--- a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
@@ -885,6 +885,19 @@ def test_quiver3d_masked():
     ax.quiver(x, y, z, u, v, w, length=0.1, pivot='tip', normalize=True)
 
 
+@mpl3d_image_comparison(['quiver3d_colorcoded.png'], style='mpl20')
+def test_quiver3d_colorcoded():
+    fig = plt.figure()
+    ax = fig.add_subplot(projection='3d')
+
+    x = y = dx = dz = np.zeros(10)
+    z = dy = np.arange(10.)
+
+    color = plt.cm.Reds(dy/dy.max())
+    ax.quiver(x, y, z, dx, dy, dz, colors=color)
+    ax.set_ylim(0, 10)
+
+
 def test_patch_modification():
     fig = plt.figure()
     ax = fig.add_subplot(projection="3d")

From 034a540dd38340229ecf0672dd37c8afaef460b8 Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Sun, 3 Mar 2024 11:57:09 +0000
Subject: [PATCH 0787/1120] Make example in legend_elements doc more
 generalisable

---
 lib/matplotlib/collections.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/collections.py b/lib/matplotlib/collections.py
index cc20e5cebc1b..5cbffff314b6 100644
--- a/lib/matplotlib/collections.py
+++ b/lib/matplotlib/collections.py
@@ -1038,12 +1038,12 @@ def legend_elements(self, prop="colors", num="auto",
         Create legend handles and labels for a PathCollection.
 
         Each legend handle is a `.Line2D` representing the Path that was drawn,
-        and each label is a string what each Path represents.
+        and each label is a string that represents the Path.
 
         This is useful for obtaining a legend for a `~.Axes.scatter` plot;
         e.g.::
 
-            scatter = plt.scatter([1, 2, 3],  [4, 5, 6],  c=[7, 2, 3])
+            scatter = plt.scatter([1, 2, 3],  [4, 5, 6],  c=[7, 2, 3], num=None)
             plt.legend(*scatter.legend_elements())
 
         creates three legend elements, one for each color with the numerical

From 8ee9d929a2bfa7dfe7f6a141165f919b46be97ce Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Sun, 3 Mar 2024 18:11:09 +0000
Subject: [PATCH 0788/1120] Deprecate plot_date

---
 .../deprecations/27850-REC.rst                | 10 +++++++++
 lib/matplotlib/axes/_axes.py                  |  8 +++----
 lib/matplotlib/tests/test_axes.py             | 22 ++++++++++++-------
 lib/matplotlib/tests/test_datetime.py         |  7 +++---
 .../axes_grid1/tests/test_axes_grid1.py       |  3 ++-
 5 files changed, 34 insertions(+), 16 deletions(-)
 create mode 100644 doc/api/next_api_changes/deprecations/27850-REC.rst

diff --git a/doc/api/next_api_changes/deprecations/27850-REC.rst b/doc/api/next_api_changes/deprecations/27850-REC.rst
new file mode 100644
index 000000000000..2021c2737ecd
--- /dev/null
+++ b/doc/api/next_api_changes/deprecations/27850-REC.rst
@@ -0,0 +1,10 @@
+``plot_date``
+~~~~~~~~~~~~~
+
+Use of `~.Axes.plot_date` has been discouraged since Matplotlib 3.5 and the
+function is now formally deprecated.
+
+- ``datetime``-like data should directly be plotted using `~.Axes.plot`.
+-  If you need to plot plain numeric data as :ref:`date-format` or need to set
+   a timezone, call ``ax.xaxis.axis_date`` / ``ax.yaxis.axis_date`` before
+   `~.Axes.plot`. See `.Axis.axis_date`.
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 60921f69fc1b..3a1cc2fb9fb6 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -1742,17 +1742,17 @@ def plot(self, *args, scalex=True, scaley=True, data=None, **kwargs):
             self._request_autoscale_view("y")
         return lines
 
+    @_api.deprecated("3.9", alternative="plot")
     @_preprocess_data(replace_names=["x", "y"], label_namer="y")
     @_docstring.dedent_interpd
     def plot_date(self, x, y, fmt='o', tz=None, xdate=True, ydate=False,
                   **kwargs):
         """
-        [*Discouraged*] Plot coercing the axis to treat floats as dates.
+        Plot coercing the axis to treat floats as dates.
 
-        .. admonition:: Discouraged
+        .. deprecated:: 3.9
 
-            This method exists for historic reasons and will be deprecated in
-            the future.
+            This method exists for historic reasons and will be removed in version 3.11.
 
             - ``datetime``-like data should directly be plotted using
               `~.Axes.plot`.
diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index 8c43b04e0eb7..fbcafa76dcea 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -870,7 +870,8 @@ def test_single_date():
     data1 = [-65.54]
 
     fig, ax = plt.subplots(2, 1)
-    ax[0].plot_date(time1 + dt, data1, 'o', color='r')
+    with pytest.warns(mpl.MatplotlibDeprecationWarning):
+        ax[0].plot_date(time1 + dt, data1, 'o', color='r')
     ax[1].plot(time1, data1, 'o', color='r')
 
 
@@ -6897,11 +6898,13 @@ def test_date_timezone_x():
     # Same Timezone
     plt.figure(figsize=(20, 12))
     plt.subplot(2, 1, 1)
-    plt.plot_date(time_index, [3] * 3, tz='Canada/Eastern')
+    with pytest.warns(mpl.MatplotlibDeprecationWarning):
+        plt.plot_date(time_index, [3] * 3, tz='Canada/Eastern')
 
     # Different Timezone
     plt.subplot(2, 1, 2)
-    plt.plot_date(time_index, [3] * 3, tz='UTC')
+    with pytest.warns(mpl.MatplotlibDeprecationWarning):
+        plt.plot_date(time_index, [3] * 3, tz='UTC')
 
 
 @image_comparison(['date_timezone_y.png'])
@@ -6914,12 +6917,13 @@ def test_date_timezone_y():
     # Same Timezone
     plt.figure(figsize=(20, 12))
     plt.subplot(2, 1, 1)
-    plt.plot_date([3] * 3,
-                  time_index, tz='Canada/Eastern', xdate=False, ydate=True)
+    with pytest.warns(mpl.MatplotlibDeprecationWarning):
+        plt.plot_date([3] * 3, time_index, tz='Canada/Eastern', xdate=False, ydate=True)
 
     # Different Timezone
     plt.subplot(2, 1, 2)
-    plt.plot_date([3] * 3, time_index, tz='UTC', xdate=False, ydate=True)
+    with pytest.warns(mpl.MatplotlibDeprecationWarning):
+        plt.plot_date([3] * 3, time_index, tz='UTC', xdate=False, ydate=True)
 
 
 @image_comparison(['date_timezone_x_and_y.png'], tol=1.0)
@@ -6932,11 +6936,13 @@ def test_date_timezone_x_and_y():
     # Same Timezone
     plt.figure(figsize=(20, 12))
     plt.subplot(2, 1, 1)
-    plt.plot_date(time_index, time_index, tz='UTC', ydate=True)
+    with pytest.warns(mpl.MatplotlibDeprecationWarning):
+        plt.plot_date(time_index, time_index, tz='UTC', ydate=True)
 
     # Different Timezone
     plt.subplot(2, 1, 2)
-    plt.plot_date(time_index, time_index, tz='US/Eastern', ydate=True)
+    with pytest.warns(mpl.MatplotlibDeprecationWarning):
+        plt.plot_date(time_index, time_index, tz='US/Eastern', ydate=True)
 
 
 @image_comparison(['axisbelow.png'], remove_text=True)
diff --git a/lib/matplotlib/tests/test_datetime.py b/lib/matplotlib/tests/test_datetime.py
index 104a649e1464..4b693eb7d1ca 100644
--- a/lib/matplotlib/tests/test_datetime.py
+++ b/lib/matplotlib/tests/test_datetime.py
@@ -657,9 +657,10 @@ def test_plot_date(self):
         x_ranges = np.array(range(1, range_threshold))
         y_ranges = np.array(range(1, range_threshold))
 
-        ax1.plot_date(x_dates, y_dates)
-        ax2.plot_date(x_dates, y_ranges)
-        ax3.plot_date(x_ranges, y_dates)
+        with pytest.warns(mpl.MatplotlibDeprecationWarning):
+            ax1.plot_date(x_dates, y_dates)
+            ax2.plot_date(x_dates, y_ranges)
+            ax3.plot_date(x_ranges, y_dates)
 
     @pytest.mark.xfail(reason="Test for quiver not written yet")
     @mpl.style.context("default")
diff --git a/lib/mpl_toolkits/axes_grid1/tests/test_axes_grid1.py b/lib/mpl_toolkits/axes_grid1/tests/test_axes_grid1.py
index 328bb6e33fdf..b1a18d77747e 100644
--- a/lib/mpl_toolkits/axes_grid1/tests/test_axes_grid1.py
+++ b/lib/mpl_toolkits/axes_grid1/tests/test_axes_grid1.py
@@ -93,7 +93,8 @@ def test_twin_axes_empty_and_removed():
 
 def test_twin_axes_both_with_units():
     host = host_subplot(111)
-    host.plot_date([0, 1, 2], [0, 1, 2], xdate=False, ydate=True)
+    with pytest.warns(mpl.MatplotlibDeprecationWarning):
+        host.plot_date([0, 1, 2], [0, 1, 2], xdate=False, ydate=True)
     twin = host.twinx()
     twin.plot(["a", "b", "c"])
     assert host.get_yticklabels()[0].get_text() == "00:00:00"

From a96b4a11011dfd47a153fe99f101a06f7126a24a Mon Sep 17 00:00:00 2001
From: Jorge Moraleda <jorge.moraleda@gmail.com>
Date: Mon, 4 Mar 2024 08:12:39 -0500
Subject: [PATCH 0789/1120] Add support for High DPI displays to wxAgg backend

---
 lib/matplotlib/backends/backend_wx.py    | 61 ++++++++++++++----------
 lib/matplotlib/backends/backend_wxagg.py | 16 ++++---
 2 files changed, 45 insertions(+), 32 deletions(-)

diff --git a/lib/matplotlib/backends/backend_wx.py b/lib/matplotlib/backends/backend_wx.py
index 218be8947695..ed5d6c76d7c9 100644
--- a/lib/matplotlib/backends/backend_wx.py
+++ b/lib/matplotlib/backends/backend_wx.py
@@ -14,9 +14,6 @@
 import sys
 import weakref
 
-import numpy as np
-import PIL.Image
-
 import matplotlib as mpl
 from matplotlib.backend_bases import (
     _Backend, FigureCanvasBase, FigureManagerBase,
@@ -30,6 +27,7 @@
 from matplotlib.transforms import Affine2D
 
 import wx
+import wx.svg
 
 _log = logging.getLogger(__name__)
 
@@ -473,10 +471,8 @@ def __init__(self, parent, id, figure=None):
         FigureCanvasBase.__init__(self, figure)
         w, h = map(math.ceil, self.figure.bbox.size)
         # Set preferred window size hint - helps the sizer, if one is connected
-        wx.Panel.__init__(self, parent, id, size=wx.Size(w, h))
-        # Create the drawing bitmap
-        self.bitmap = wx.Bitmap(w, h)
-        _log.debug("%s - __init__() - bitmap w:%d h:%d", type(self), w, h)
+        wx.Panel.__init__(self, parent, id, size=parent.FromDIP(wx.Size(w, h)))
+        self.bitmap = None
         self._isDrawn = False
         self._rubberband_rect = None
         self._rubberband_pen_black = wx.Pen('BLACK', 1, wx.PENSTYLE_SHORT_DASH)
@@ -512,6 +508,12 @@ def __init__(self, parent, id, figure=None):
         self.SetBackgroundStyle(wx.BG_STYLE_PAINT)  # Reduce flicker.
         self.SetBackgroundColour(wx.WHITE)
 
+        if wx.Platform == '__WXMAC__':
+            # Initial scaling. Other platforms handle this automatically
+            dpiScale = self.GetDPIScaleFactor()
+            self.SetInitialSize(self.GetSize()*(1/dpiScale))
+            self._set_device_pixel_ratio(dpiScale)
+
     def Copy_to_Clipboard(self, event=None):
         """Copy bitmap of canvas to system clipboard."""
         bmp_obj = wx.BitmapDataObject()
@@ -524,6 +526,12 @@ def Copy_to_Clipboard(self, event=None):
                 wx.TheClipboard.Flush()
                 wx.TheClipboard.Close()
 
+    def _update_device_pixel_ratio(self, *args, **kwargs):
+        # We need to be careful in cases with mixed resolution displays if
+        # device_pixel_ratio changes.
+        if self._set_device_pixel_ratio(self.GetDPIScaleFactor()):
+            self.draw()
+
     def draw_idle(self):
         # docstring inherited
         _log.debug("%s - draw_idle()", type(self))
@@ -631,7 +639,7 @@ def _on_size(self, event):
         In this application we attempt to resize to fit the window, so it
         is better to take the performance hit and redraw the whole window.
         """
-
+        self._update_device_pixel_ratio()
         _log.debug("%s - _on_size()", type(self))
         sz = self.GetParent().GetSizer()
         if sz:
@@ -655,9 +663,10 @@ def _on_size(self, event):
             return  # Empty figure
 
         # Create a new, correctly sized bitmap
-        self.bitmap = wx.Bitmap(self._width, self._height)
-
         dpival = self.figure.dpi
+        if not wx.Platform == '__WXMSW__':
+            scale = self.GetDPIScaleFactor()
+            dpival /= scale
         winch = self._width / dpival
         hinch = self._height / dpival
         self.figure.set_size_inches(winch, hinch, forward=False)
@@ -712,7 +721,11 @@ def _mpl_coords(self, pos=None):
         else:
             x, y = pos.X, pos.Y
         # flip y so y=0 is bottom of canvas
-        return x, self.figure.bbox.height - y
+        if not wx.Platform == '__WXMSW__':
+            scale = self.GetDPIScaleFactor()
+            return x*scale, self.figure.bbox.height - y*scale
+        else:
+            return x, self.figure.bbox.height - y
 
     def _on_key_down(self, event):
         """Capture key press."""
@@ -898,8 +911,8 @@ def __init__(self, num, fig, *, canvas_class):
         # On Windows, canvas sizing must occur after toolbar addition;
         # otherwise the toolbar further resizes the canvas.
         w, h = map(math.ceil, fig.bbox.size)
-        self.canvas.SetInitialSize(wx.Size(w, h))
-        self.canvas.SetMinSize((2, 2))
+        self.canvas.SetInitialSize(self.FromDIP(wx.Size(w, h)))
+        self.canvas.SetMinSize(self.FromDIP(wx.Size(2, 2)))
         self.canvas.SetFocus()
 
         self.Fit()
@@ -1017,9 +1030,9 @@ def _set_frame_icon(frame):
 class NavigationToolbar2Wx(NavigationToolbar2, wx.ToolBar):
     def __init__(self, canvas, coordinates=True, *, style=wx.TB_BOTTOM):
         wx.ToolBar.__init__(self, canvas.GetParent(), -1, style=style)
+        if wx.Platform == '__WXMAC__':
+            self.SetToolBitmapSize(self.GetToolBitmapSize()*self.GetDPIScaleFactor())
 
-        if 'wxMac' in wx.PlatformInfo:
-            self.SetToolBitmapSize((24, 24))
         self.wx_ids = {}
         for text, tooltip_text, image_file, callback in self.toolitems:
             if text is None:
@@ -1028,7 +1041,7 @@ def __init__(self, canvas, coordinates=True, *, style=wx.TB_BOTTOM):
             self.wx_ids[text] = (
                 self.AddTool(
                     -1,
-                    bitmap=self._icon(f"{image_file}.png"),
+                    bitmap=self._icon(f"{image_file}.svg"),
                     bmpDisabled=wx.NullBitmap,
                     label=text, shortHelp=tooltip_text,
                     kind=(wx.ITEM_CHECK if text in ["Pan", "Zoom"]
@@ -1054,9 +1067,7 @@ def _icon(name):
         *name*, including the extension and relative to Matplotlib's "images"
         data directory.
         """
-        pilimg = PIL.Image.open(cbook._get_data_path("images", name))
-        # ensure RGBA as wx BitMap expects RGBA format
-        image = np.array(pilimg.convert("RGBA"))
+        svg = cbook._get_data_path("images", name).read_bytes()
         try:
             dark = wx.SystemSettings.GetAppearance().IsDark()
         except AttributeError:  # wxpython < 4.1
@@ -1068,11 +1079,9 @@ def _icon(name):
             fg_lum = (.299 * fg.red + .587 * fg.green + .114 * fg.blue) / 255
             dark = fg_lum - bg_lum > .2
         if dark:
-            fg = wx.SystemSettings.GetColour(wx.SYS_COLOUR_WINDOWTEXT)
-            black_mask = (image[..., :3] == 0).all(axis=-1)
-            image[black_mask, :3] = (fg.Red(), fg.Green(), fg.Blue())
-        return wx.Bitmap.FromBufferRGBA(
-            image.shape[1], image.shape[0], image.tobytes())
+            svg = svg.replace(b'fill:black;', b'fill:white;')
+        toolbarIconSize = wx.ArtProvider().GetDIPSizeHint(wx.ART_TOOLBAR)
+        return wx.BitmapBundle.FromSVG(svg, toolbarIconSize)
 
     def _update_buttons_checked(self):
         if "Pan" in self.wx_ids:
@@ -1123,7 +1132,9 @@ def save_figure(self, *args):
 
     def draw_rubberband(self, event, x0, y0, x1, y1):
         height = self.canvas.figure.bbox.height
-        self.canvas._rubberband_rect = (x0, height - y0, x1, height - y1)
+        sf = self.GetDPIScaleFactor()
+        self.canvas._rubberband_rect = (x0/sf, (height - y0)/sf,
+                                        x1/sf, (height - y1)/sf)
         self.canvas.Refresh()
 
     def remove_rubberband(self):
diff --git a/lib/matplotlib/backends/backend_wxagg.py b/lib/matplotlib/backends/backend_wxagg.py
index a5a9de07153d..ab7703ffa02b 100644
--- a/lib/matplotlib/backends/backend_wxagg.py
+++ b/lib/matplotlib/backends/backend_wxagg.py
@@ -12,13 +12,13 @@ def draw(self, drawDC=None):
         Render the figure using agg.
         """
         FigureCanvasAgg.draw(self)
-        self.bitmap = _rgba_to_wx_bitmap(self.get_renderer().buffer_rgba())
+        self.bitmap = self._create_bitmap()
         self._isDrawn = True
         self.gui_repaint(drawDC=drawDC)
 
     def blit(self, bbox=None):
         # docstring inherited
-        bitmap = _rgba_to_wx_bitmap(self.get_renderer().buffer_rgba())
+        bitmap = self._create_bitmap()
         if bbox is None:
             self.bitmap = bitmap
         else:
@@ -31,11 +31,13 @@ def blit(self, bbox=None):
             srcDC.SelectObject(wx.NullBitmap)
         self.gui_repaint()
 
-
-def _rgba_to_wx_bitmap(rgba):
-    """Convert an RGBA buffer to a wx.Bitmap."""
-    h, w, _ = rgba.shape
-    return wx.Bitmap.FromBufferRGBA(w, h, rgba)
+    def _create_bitmap(self):
+        """Create a wx.Bitmap from the renderer RGBA buffer"""
+        rgba = self.get_renderer().buffer_rgba()
+        h, w, _ = rgba.shape
+        bitmap = wx.Bitmap.FromBufferRGBA(w, h, rgba)
+        bitmap.SetScaleFactor(self.GetDPIScaleFactor())
+        return bitmap
 
 
 @_BackendWx.export

From fd806b9fa6527774eb4f900f4c4bafb812ecfa82 Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Mon, 4 Mar 2024 15:10:10 +0000
Subject: [PATCH 0790/1120] pin pytest

---
 environment.yml              | 2 +-
 requirements/testing/all.txt | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/environment.yml b/environment.yml
index b7220ad446c2..3e9b79c35845 100644
--- a/environment.yml
+++ b/environment.yml
@@ -59,7 +59,7 @@ dependencies:
   - psutil
   - pre-commit
   - pydocstyle>=5.1.0
-  - pytest!=4.6.0,!=5.4.0
+  - pytest!=4.6.0,!=5.4.0,!=8.1.0
   - pytest-cov
   - pytest-rerunfailures
   - pytest-timeout
diff --git a/requirements/testing/all.txt b/requirements/testing/all.txt
index 4ca786fcf73e..e386924a9b67 100644
--- a/requirements/testing/all.txt
+++ b/requirements/testing/all.txt
@@ -4,7 +4,7 @@ black<24
 certifi
 coverage!=6.3
 psutil
-pytest!=4.6.0,!=5.4.0
+pytest!=4.6.0,!=5.4.0,!=8.1.0
 pytest-cov
 pytest-rerunfailures
 pytest-timeout

From 83ea48487f1cb9430f020c65c05a1446e2a8ce59 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 4 Mar 2024 19:06:42 +0000
Subject: [PATCH 0791/1120] Bump the actions group with 2 updates

Bumps the actions group with 2 updates: [pypa/gh-action-pypi-publish](https://github.com/pypa/gh-action-pypi-publish) and [scientific-python/upload-nightly-action](https://github.com/scientific-python/upload-nightly-action).


Updates `pypa/gh-action-pypi-publish` from 1.8.11 to 1.8.12
- [Release notes](https://github.com/pypa/gh-action-pypi-publish/releases)
- [Commits](https://github.com/pypa/gh-action-pypi-publish/compare/2f6f737ca5f74c637829c0f5c3acd0e29ea5e8bf...e53eb8b103ffcb59469888563dc324e3c8ba6f06)

Updates `scientific-python/upload-nightly-action` from 0.3.0 to 0.5.0
- [Release notes](https://github.com/scientific-python/upload-nightly-action/releases)
- [Commits](https://github.com/scientific-python/upload-nightly-action/compare/6e9304f7a3a5501c6f98351537493ec898728299...b67d7fcc0396e1128a474d1ab2b48aa94680f9fc)

---
updated-dependencies:
- dependency-name: pypa/gh-action-pypi-publish
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: actions
- dependency-name: scientific-python/upload-nightly-action
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: actions
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 .github/workflows/cibuildwheel.yml | 2 +-
 .github/workflows/nightlies.yml    | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 68e144d5b911..91c63cb04b89 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -213,4 +213,4 @@ jobs:
         run: ls dist
 
       - name: Publish package distributions to PyPI
-        uses: pypa/gh-action-pypi-publish@2f6f737ca5f74c637829c0f5c3acd0e29ea5e8bf  # v1.8.11
+        uses: pypa/gh-action-pypi-publish@e53eb8b103ffcb59469888563dc324e3c8ba6f06  # v1.8.12
diff --git a/.github/workflows/nightlies.yml b/.github/workflows/nightlies.yml
index 840b134969e1..54e81f06b166 100644
--- a/.github/workflows/nightlies.yml
+++ b/.github/workflows/nightlies.yml
@@ -59,7 +59,7 @@ jobs:
           ls -l dist/
 
       - name: Upload wheels to Anaconda Cloud as nightlies
-        uses: scientific-python/upload-nightly-action@6e9304f7a3a5501c6f98351537493ec898728299  # 0.3.0
+        uses: scientific-python/upload-nightly-action@b67d7fcc0396e1128a474d1ab2b48aa94680f9fc  # 0.5.0
         with:
           artifacts_path: dist
           anaconda_nightly_upload_token: ${{ secrets.ANACONDA_ORG_UPLOAD_TOKEN }}

From 69ba4498cfe28f91ad8e18599a75603429f5d8d9 Mon Sep 17 00:00:00 2001
From: Ian Thomas <ianthomas23@gmail.com>
Date: Mon, 4 Mar 2024 20:18:26 +0000
Subject: [PATCH 0792/1120] Remove unused _safe_pyplot_import

---
 lib/matplotlib/backend_bases.py | 23 -----------------------
 1 file changed, 23 deletions(-)

diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
index 8e789c908152..a1e7eb4f3ffc 100644
--- a/lib/matplotlib/backend_bases.py
+++ b/lib/matplotlib/backend_bases.py
@@ -93,29 +93,6 @@
 }
 
 
-def _safe_pyplot_import():
-    """
-    Import and return ``pyplot``, correctly setting the backend if one is
-    already forced.
-    """
-    try:
-        import matplotlib.pyplot as plt
-    except ImportError:  # Likely due to a framework mismatch.
-        current_framework = cbook._get_running_interactive_framework()
-        if current_framework is None:
-            raise  # No, something else went wrong, likely with the install...
-
-        from matplotlib.backends import backend_registry
-        backend = backend_registry.backend_for_gui_framework(current_framework)
-        if backend is None:
-            raise RuntimeError("No suitable backend for the current GUI framework "
-                               f"{current_framework!r}")
-
-        rcParams["backend"] = mpl.rcParamsOrig["backend"] = backend
-        import matplotlib.pyplot as plt  # Now this should succeed.
-    return plt
-
-
 def register_backend(format, backend, description=None):
     """
     Register a backend for saving to a given file format.

From 13319f10d47cf97c97285fcf0759595a23ad289c Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Tue, 16 Jan 2024 15:21:19 +0000
Subject: [PATCH 0793/1120] Bump pydata-sphinx-theme to 0.15

---
 environment.yml                       | 2 +-
 requirements/doc/doc-requirements.txt | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/environment.yml b/environment.yml
index 3e9b79c35845..2930ccf17e83 100644
--- a/environment.yml
+++ b/environment.yml
@@ -34,7 +34,7 @@ dependencies:
   - ipywidgets
   - numpydoc>=1.0
   - packaging>=20
-  - pydata-sphinx-theme~=0.13.1
+  - pydata-sphinx-theme~=0.15.0
   - pyyaml
   - sphinx>=3.0.0,!=6.1.2
   - sphinx-copybutton
diff --git a/requirements/doc/doc-requirements.txt b/requirements/doc/doc-requirements.txt
index 6b7f7c333787..173fa30eafbf 100644
--- a/requirements/doc/doc-requirements.txt
+++ b/requirements/doc/doc-requirements.txt
@@ -14,7 +14,7 @@ ipywidgets
 ipykernel
 numpydoc>=1.0
 packaging>=20
-pydata-sphinx-theme~=0.13.1
+pydata-sphinx-theme~=0.15.0
 mpl-sphinx-theme~=3.8.0
 pyyaml
 sphinxcontrib-svg2pdfconverter>=1.1.0

From b68ed22875f9fdc7fe59ac4258df89effab48101 Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Tue, 16 Jan 2024 15:21:33 +0000
Subject: [PATCH 0794/1120] Fix search button placement in navbar

---
 doc/conf.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/doc/conf.py b/doc/conf.py
index ccde74304eb3..cfe03e6c2f9c 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -492,6 +492,7 @@ def js_tag_with_cache_busting(js):
             else 'devdocs')
     },
     "navbar_end": ["theme-switcher", "version-switcher", "mpl_icon_links"],
+    "navbar_persistent": ["search-button"],
     "secondary_sidebar_items": "page-toc.html",
     "footer_start": ["copyright", "sphinx-version", "doc_version"],
     # We override the announcement template from pydata-sphinx-theme, where

From 6f9eda7b1f3118e49603bccf0d2422334753c6e7 Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Tue, 16 Jan 2024 17:23:22 +0000
Subject: [PATCH 0795/1120] Fix doc sidebar

---
 doc/conf.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/doc/conf.py b/doc/conf.py
index cfe03e6c2f9c..54b34916d57b 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -493,7 +493,6 @@ def js_tag_with_cache_busting(js):
     },
     "navbar_end": ["theme-switcher", "version-switcher", "mpl_icon_links"],
     "navbar_persistent": ["search-button"],
-    "secondary_sidebar_items": "page-toc.html",
     "footer_start": ["copyright", "sphinx-version", "doc_version"],
     # We override the announcement template from pydata-sphinx-theme, where
     # this special value indicates the use of the unreleased banner. If we need

From bc2c8721adffcc907b551988ce95b1db9d66eb04 Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Mon, 4 Mar 2024 21:00:00 +0000
Subject: [PATCH 0796/1120] Fix version switcher url for circleCI

---
 doc/conf.py | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/doc/conf.py b/doc/conf.py
index 54b34916d57b..bab959bc9e28 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -484,7 +484,13 @@ def js_tag_with_cache_busting(js):
         # the server, but will be used as part of the key for caching by browsers
         # so when we do a new meso release the switcher will update "promptly" on
         # the stable and devdocs.
-        "json_url": f"https://matplotlib.org/devdocs/_static/switcher.json?{SHA}",
+        "json_url": (
+            "https://output.circle-artifacts.com/output/job/"
+            f"{os.environ['CIRCLE_WORKFLOW_JOB_ID']}/artifacts/"
+            f"{os.environ['CIRCLE_NODE_INDEX']}"
+            "/doc/build/html/_static/switcher.json" if CIRCLECI else
+            f"https://matplotlib.org/devdocs/_static/switcher.json?{SHA}"
+        ),
         "version_match": (
             # The start version to show. This must be in switcher.json.
             # We either go to 'stable' or to 'devdocs'

From 591cd650b39f8bbfb445e10f4b72ecec08309e62 Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Mon, 4 Mar 2024 21:03:17 +0000
Subject: [PATCH 0797/1120] Don't use custom CSS for announcement banner

---
 doc/_static/mpl.css | 23 -----------------------
 1 file changed, 23 deletions(-)

diff --git a/doc/_static/mpl.css b/doc/_static/mpl.css
index 2c43bcfa7a3d..aae167d1f6f8 100644
--- a/doc/_static/mpl.css
+++ b/doc/_static/mpl.css
@@ -14,29 +14,6 @@
     margin: 0;
 }
 
-/* Make announcement an error colour for unreleased documentation, and sticky. */
-#unreleased-message.bd-header-announcement {
-    border-bottom: solid var(--pst-color-danger-highlight);
-    color: var(--pst-color-danger-text);
-    font-weight: var(--pst-admonition-font-weight-heading);
-    position: sticky;
-    top: 0;
-    z-index: 1050;
-}
-
-#unreleased-message.bd-header-announcement:after {
-    background-color: var(--pst-color-danger);
-    opacity: 1;
-}
-
-#unreleased-message.bd-header-announcement a {
-    color: var(--pst-color-danger-text);
-}
-
-#unreleased-message.bd-header-announcement + .bd-navbar {
-    top: 3rem;  /* Minimum height of announcement header. */
-}
-
 /* multi column TOC */
 .contents ul {
     list-style-type: none;

From f178f5c52ab5a518cd9655633d876442a5f4b9df Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Mon, 4 Mar 2024 22:09:14 +0000
Subject: [PATCH 0798/1120] Disable parallel build

---
 .circleci/config.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.circleci/config.yml b/.circleci/config.yml
index 2d7c0da457ec..468bec6eee7d 100644
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -147,7 +147,7 @@ commands:
               export RELEASE_TAG='-t release'
             fi
             mkdir -p logs
-            make html O="-T $RELEASE_TAG -j4 -w /tmp/sphinxerrorswarnings.log"
+            make html O="-T $RELEASE_TAG -j1 -w /tmp/sphinxerrorswarnings.log"
             rm -r build/html/_sources
           working_directory: doc
       - save_cache:

From 5b2efbc795f8c10cd41c69a96fa4b6f9b16ee54a Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Tue, 5 Mar 2024 09:09:05 +0000
Subject: [PATCH 0799/1120] Add dtype/copy args to internal testing class

---
 lib/matplotlib/tests/test_units.py | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/tests/test_units.py b/lib/matplotlib/tests/test_units.py
index fa8e5709db64..a5fd32dfb3e5 100644
--- a/lib/matplotlib/tests/test_units.py
+++ b/lib/matplotlib/tests/test_units.py
@@ -282,8 +282,16 @@ class Kernel:
     def __init__(self, array):
         self._array = np.asanyarray(array)
 
-    def __array__(self):
-        return self._array
+    def __array__(self, dtype=None, copy=None):
+        if dtype is not None and dtype != self._array.dtype:
+            if copy is not None and not copy:
+                raise ValueError(
+                    f"Converting array from {self._array.dtype} to "
+                    f"{dtype} requires a copy"
+                )
+
+        arr = np.asarray(self._array, dtype=dtype)
+        return (arr if not copy else np.copy(arr))
 
     @property
     def shape(self):

From 935613755f3e32313e6a645af6bbd215e0b8f8d8 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 23 Feb 2024 00:37:04 -0500
Subject: [PATCH 0800/1120] Use pybind11 string formatter for exception
 messages

This can eventually be replaced by `std::format` when we require C++20.
---
 src/_image_wrapper.cpp | 16 ++++++++--------
 src/_tkagg.cpp         | 13 +++++++------
 2 files changed, 15 insertions(+), 14 deletions(-)

diff --git a/src/_image_wrapper.cpp b/src/_image_wrapper.cpp
index 716116c0ba56..65c8c8324ebc 100644
--- a/src/_image_wrapper.cpp
+++ b/src/_image_wrapper.cpp
@@ -78,8 +78,8 @@ _get_transform_mesh(const py::object& transform, const py::ssize_t *dims)
 
     if (output_mesh_array.ndim() != 2) {
         throw std::runtime_error(
-            "Inverse transformed mesh array should be 2D not " +
-            std::to_string(output_mesh_array.ndim()) + "D");
+            "Inverse transformed mesh array should be 2D not {}D"_s.format(
+                output_mesh_array.ndim()));
     }
 
     return output_mesh_array;
@@ -108,8 +108,8 @@ image_resample(py::array input_array,
 
     if (ndim == 3 && input_array.shape(2) != 4) {
         throw std::invalid_argument(
-            "3D input array must be RGBA with shape (M, N, 4), has trailing dimension of " +
-            std::to_string(input_array.shape(2)));
+            "3D input array must be RGBA with shape (M, N, 4), has trailing dimension of {}"_s.format(
+                input_array.shape(2)));
     }
 
     // Ensure input array is contiguous, regardless of dtype
@@ -120,14 +120,14 @@ image_resample(py::array input_array,
 
     if (out_ndim != ndim) {
         throw std::invalid_argument(
-            "Input (" + std::to_string(ndim) + "D) and output (" + std::to_string(out_ndim) +
-            "D) arrays have different dimensionalities");
+            "Input ({}D) and output ({}D) arrays have different dimensionalities"_s.format(
+                ndim, out_ndim));
     }
 
     if (out_ndim == 3 && output_array.shape(2) != 4) {
         throw std::invalid_argument(
-            "3D output array must be RGBA with shape (M, N, 4), has trailing dimension of " +
-            std::to_string(output_array.shape(2)));
+            "3D output array must be RGBA with shape (M, N, 4), has trailing dimension of {}"_s.format(
+                output_array.shape(2)));
     }
 
     if (!output_array.dtype().is(dtype)) {
diff --git a/src/_tkagg.cpp b/src/_tkagg.cpp
index 3b58114a71c0..d6c7574a6f9e 100644
--- a/src/_tkagg.cpp
+++ b/src/_tkagg.cpp
@@ -99,18 +99,19 @@ mpl_tk_blit(py::object interp_obj, const char *photo_name,
 
     auto data_ptr = data.mutable_unchecked<3>();  // Checks ndim and writeable flag.
     if (data.shape(2) != 4) {
-        throw py::value_error("Data pointer must be RGBA; last dimension is " +
-                              std::to_string(data.shape(2)) + ", not 4");
+        throw py::value_error(
+            "Data pointer must be RGBA; last dimension is {}, not 4"_s.format(
+                data.shape(2)));
     }
     if (data.shape(0) > INT_MAX) {  // Limited by Tk_PhotoPutBlock argument type.
         throw std::range_error(
-            "Height (" + std::to_string(data.shape(0)) +
-            ") exceeds maximum allowable size (" + std::to_string(INT_MAX) + ")");
+            "Height ({}) exceeds maximum allowable size ({})"_s.format(
+                data.shape(0), INT_MAX));
     }
     if (data.shape(1) > INT_MAX / 4) {  // Limited by Tk_PhotoImageBlock.pitch field.
         throw std::range_error(
-            "Width (" + std::to_string(data.shape(1)) +
-            ") exceeds maximum allowable size (" + std::to_string(INT_MAX / 4) + ")");
+            "Width ({}) exceeds maximum allowable size ({})"_s.format(
+                data.shape(1), INT_MAX / 4));
     }
     const auto height = static_cast<int>(data.shape(0));
     const auto width = static_cast<int>(data.shape(1));

From c908cd43a833c97b183abdc60f053e3b33edfef6 Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Wed, 6 Mar 2024 11:17:27 +0000
Subject: [PATCH 0801/1120] Don't show doc source link

---
 doc/conf.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/doc/conf.py b/doc/conf.py
index bab959bc9e28..4241ada05cf4 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -200,6 +200,7 @@ def _check_dependencies():
 missing_references_write_json = False
 missing_references_warn_unused_ignores = False
 
+
 intersphinx_mapping = {
     'Pillow': ('https://pillow.readthedocs.io/en/stable/', None),
     'cycler': ('https://matplotlib.org/cycler/', None),
@@ -549,6 +550,9 @@ def js_tag_with_cache_busting(js):
     # '**': ['localtoc.html', 'pagesource.html']
 }
 
+# Don't include link to doc source files
+html_show_sourcelink = False
+
 # Copies only relevant code, not the '>>>' prompt
 copybutton_prompt_text = r'>>> |\.\.\. '
 copybutton_prompt_is_regexp = True

From 4942cd153c9f2b3fb1b277ca398c0a402b15ea94 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 6 Mar 2024 06:22:15 -0500
Subject: [PATCH 0802/1120] Correctly set temporary pdf/pgf backends

Calling `FigureCanvasPdf(figure)` will call `figure.set_canvas(self)`,
meaning the `cbook._setattr_cm` context manager that wraps this change
will see the _new_ canvas, and the old canvas isn't restored.

Instead, just pass the `backend` parameter, as `savefig` already knows
how to correctly save and restore the canvas if it needs to change
backends.

Fixes #27865
---
 lib/matplotlib/backends/backend_pdf.py |  3 +-
 lib/matplotlib/backends/backend_pgf.py | 39 +++++++++++++-------------
 2 files changed, 20 insertions(+), 22 deletions(-)

diff --git a/lib/matplotlib/backends/backend_pdf.py b/lib/matplotlib/backends/backend_pdf.py
index a3aa2f66010a..7e3e09f034f5 100644
--- a/lib/matplotlib/backends/backend_pdf.py
+++ b/lib/matplotlib/backends/backend_pdf.py
@@ -2755,8 +2755,7 @@ def savefig(self, figure=None, **kwargs):
                 raise ValueError(f"No figure {figure}")
             figure = manager.canvas.figure
         # Force use of pdf backend, as PdfPages is tightly coupled with it.
-        with cbook._setattr_cm(figure, canvas=FigureCanvasPdf(figure)):
-            figure.savefig(self, format="pdf", **kwargs)
+        figure.savefig(self, format="pdf", backend="pdf", **kwargs)
 
     def get_pagecount(self):
         """Return the current number of pages in the multipage pdf file."""
diff --git a/lib/matplotlib/backends/backend_pgf.py b/lib/matplotlib/backends/backend_pgf.py
index ba01622bd068..9705f5fc6bce 100644
--- a/lib/matplotlib/backends/backend_pgf.py
+++ b/lib/matplotlib/backends/backend_pgf.py
@@ -987,26 +987,25 @@ def savefig(self, figure=None, **kwargs):
                 raise ValueError(f"No figure {figure}")
             figure = manager.canvas.figure
 
-        with cbook._setattr_cm(figure, canvas=FigureCanvasPgf(figure)):
-            width, height = figure.get_size_inches()
-            if self._n_figures == 0:
-                self._write_header(width, height)
-            else:
-                # \pdfpagewidth and \pdfpageheight exist on pdftex, xetex, and
-                # luatex<0.85; they were renamed to \pagewidth and \pageheight
-                # on luatex>=0.85.
-                self._file.write(
-                    (
-                        r'\newpage'
-                        r'\ifdefined\pdfpagewidth\pdfpagewidth'
-                        fr'\else\pagewidth\fi={width}in'
-                        r'\ifdefined\pdfpageheight\pdfpageheight'
-                        fr'\else\pageheight\fi={height}in'
-                        '%%\n'
-                    ).encode("ascii")
-                )
-            figure.savefig(self._file, format="pgf", **kwargs)
-            self._n_figures += 1
+        width, height = figure.get_size_inches()
+        if self._n_figures == 0:
+            self._write_header(width, height)
+        else:
+            # \pdfpagewidth and \pdfpageheight exist on pdftex, xetex, and
+            # luatex<0.85; they were renamed to \pagewidth and \pageheight
+            # on luatex>=0.85.
+            self._file.write(
+                (
+                    r'\newpage'
+                    r'\ifdefined\pdfpagewidth\pdfpagewidth'
+                    fr'\else\pagewidth\fi={width}in'
+                    r'\ifdefined\pdfpageheight\pdfpageheight'
+                    fr'\else\pageheight\fi={height}in'
+                    '%%\n'
+                ).encode("ascii")
+            )
+        figure.savefig(self._file, format="pgf", backend="pgf", **kwargs)
+        self._n_figures += 1
 
     def get_pagecount(self):
         """Return the current number of pages in the multipage pdf file."""

From 66149edad6dcec0a02f6347f855f09a3dbd4f17a Mon Sep 17 00:00:00 2001
From: DWesl <22566757+DWesl@users.noreply.github.com>
Date: Wed, 6 Mar 2024 10:29:31 -0500
Subject: [PATCH 0803/1120] BLD,BUG: Remove Python.h includes immediately
 preceeding pybind11/pybind11.h includes

pybind11 seems decent about including Python.h before any system headers, once you chase three layers of includes in to see that.
---
 src/_image_wrapper.cpp | 1 -
 src/_path.h            | 1 -
 src/_qhull_wrapper.cpp | 1 -
 src/_ttconv.cpp        | 4 +---
 src/py_converters_11.h | 1 -
 src/tri/_tri.h         | 1 -
 6 files changed, 1 insertion(+), 8 deletions(-)

diff --git a/src/_image_wrapper.cpp b/src/_image_wrapper.cpp
index c40e3d5c8d67..716116c0ba56 100644
--- a/src/_image_wrapper.cpp
+++ b/src/_image_wrapper.cpp
@@ -1,4 +1,3 @@
-#include <Python.h>
 #include <pybind11/pybind11.h>
 #include <pybind11/numpy.h>
 
diff --git a/src/_path.h b/src/_path.h
index d45842df4cac..239a3c760221 100644
--- a/src/_path.h
+++ b/src/_path.h
@@ -3,7 +3,6 @@
 #ifndef MPL_PATH_H
 #define MPL_PATH_H
 
-#include <Python.h>
 #include <limits>
 #include <math.h>
 #include <vector>
diff --git a/src/_qhull_wrapper.cpp b/src/_qhull_wrapper.cpp
index cae9aca959ee..9784a1698ba1 100644
--- a/src/_qhull_wrapper.cpp
+++ b/src/_qhull_wrapper.cpp
@@ -5,7 +5,6 @@
  * triangulation, construct an instance of the matplotlib.tri.Triangulation
  * class without specifying a triangles array.
  */
-#include <Python.h>
 #include <pybind11/pybind11.h>
 #include <pybind11/numpy.h>
 
diff --git a/src/_ttconv.cpp b/src/_ttconv.cpp
index 559d898886cd..715d46d4cf7a 100644
--- a/src/_ttconv.cpp
+++ b/src/_ttconv.cpp
@@ -5,10 +5,8 @@
 
   Python wrapper for TrueType conversion library in ../ttconv.
  */
-#include <Python.h>
-#include "mplutils.h"
-
 #include <pybind11/pybind11.h>
+#include "mplutils.h"
 #include "pprdrv.h"
 #include <vector>
 
diff --git a/src/py_converters_11.h b/src/py_converters_11.h
index ceef9ee542d1..9af617d3ee8b 100644
--- a/src/py_converters_11.h
+++ b/src/py_converters_11.h
@@ -3,7 +3,6 @@
 
 // pybind11 equivalent of py_converters.h
 
-#include <Python.h>
 #include <pybind11/pybind11.h>
 #include <pybind11/numpy.h>
 
diff --git a/src/tri/_tri.h b/src/tri/_tri.h
index d7d2b4ebf413..c176b4c0e8f5 100644
--- a/src/tri/_tri.h
+++ b/src/tri/_tri.h
@@ -63,7 +63,6 @@
 #ifndef MPL_TRI_H
 #define MPL_TRI_H
 
-#include <Python.h>
 #include <pybind11/pybind11.h>
 #include <pybind11/numpy.h>
 

From ff470cfb57eeecad6e08e1bcb61512e22bba3c33 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Wed, 6 Mar 2024 16:09:13 -0500
Subject: [PATCH 0804/1120] DOC: update comments and docstrings

Co-authored-by: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
---
 lib/matplotlib/tests/test_axes.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index 37be1911d8e8..73a3ead26ea0 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -8903,8 +8903,11 @@ def test_axhvlinespan_interpolation():
 @check_figures_equal(extensions=["png"])
 @pytest.mark.parametrize("which", ("x", "y"))
 def test_axes_clear_behavior(fig_ref, fig_test, which):
+    """Test that the given tick params are not reset by ax.clear()."""
     ax_test = fig_test.subplots()
     ax_ref = fig_ref.subplots()
+    # the following tick params values are chosen to each create a visual difference
+    # from their defaults 
     target = {
         "direction": "in",
         "length": 10,

From db252260f0f8eca0a52e91dce0738109bf847757 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Wed, 6 Mar 2024 00:33:55 +0100
Subject: [PATCH 0805/1120] DOC: Update some animation related topics

- use `set_data_3d`
- cross-reference `Line2d` `set_data`, `set_xdata`, `set_ydata`
- Rewrite parts of the FuncAnimation description

Inspired through #27830.
---
 galleries/examples/animation/random_walk.py   |  4 +-
 .../users_explain/animations/animations.py    | 44 +++++++++++--------
 lib/matplotlib/lines.py                       | 15 +++++++
 3 files changed, 41 insertions(+), 22 deletions(-)

diff --git a/galleries/examples/animation/random_walk.py b/galleries/examples/animation/random_walk.py
index 10dcf5ade164..4be0b461f933 100644
--- a/galleries/examples/animation/random_walk.py
+++ b/galleries/examples/animation/random_walk.py
@@ -25,9 +25,7 @@ def random_walk(num_steps, max_step=0.05):
 
 def update_lines(num, walks, lines):
     for line, walk in zip(lines, walks):
-        # NOTE: there is no .set_data() for 3 dim data...
-        line.set_data(walk[:num, :2].T)
-        line.set_3d_properties(walk[:num, 2])
+        line.set_data_3d(walk[:num, :].T)
     return lines
 
 
diff --git a/galleries/users_explain/animations/animations.py b/galleries/users_explain/animations/animations.py
index fb8564f8318e..0391d9bc030a 100644
--- a/galleries/users_explain/animations/animations.py
+++ b/galleries/users_explain/animations/animations.py
@@ -49,28 +49,33 @@
 # *func* that modifies the data plotted on the figure. It uses the *frames*
 # parameter to determine the length of the animation. The *interval* parameter
 # is used to determine time in milliseconds between drawing of two frames.
-# Animating using `.FuncAnimation` would usually follow the following
-# structure:
-#
-# - Plot the initial figure, including all the required artists. Save all the
-#   artists in variables so that they can be updated later on during the
-#   animation.
-# - Create an animation function that updates the data in each artist to
-#   generate the new frame at each function call.
-# - Create a `.FuncAnimation` object with the `.Figure` and the animation
-#   function, along with the keyword arguments that determine the animation
-#   properties.
-# - Use `.animation.Animation.save` or `.pyplot.show` to save or show the
-#   animation.
-#
-# The update function uses the ``set_*`` function for different artists to
-# modify the data. The following table shows a few plotting methods, the artist
-# types they return and some methods that can be used to update them.
+# Animating using `.FuncAnimation` typically requires these steps:
+#
+# 1) Plot the initial figure as you would in a static plot. Save all the created
+#    artists, which are returned by the plot functions, in variables so that you can
+#    access and modify them later in the animation function.
+# 2) Create an animation function that updates the artists for a given frame.
+#    Typically, this calls ``set_*`` methods of the artists.
+# 3) Create a `.FuncAnimation`, passing the `.Figure` and the animation function.
+# 4) Save or show the animation using one of the following methods:
+#
+#    - `.pyplot.show` to show the animation in a window
+#    - `.Animation.to_html5_video` to create a HTML ``<video>`` tag
+#    - `.Animation.to_jshtml` to create HTML code with interactive JavaScript animation
+#      controls
+#    - `.Animation.save` to save the animation to a file
+#
+# The following table shows a few plotting methods, the artists they return and some
+# commonly used ``set_*`` methods that update the underlying data. While updating data
+# is the most common operation in animations, you can also update other aspects such as
+# color or text position.
 #
 # ========================================  =============================  ===========================
-# Plotting method                           Artist                         Set method
+# Plotting method                           Artist                         Data set methods
 # ========================================  =============================  ===========================
-# `.Axes.plot`                              `.lines.Line2D`                `~.lines.Line2D.set_data`
+# `.Axes.plot`                              `.lines.Line2D`                `~.Line2D.set_data`,
+#                                                                          `~.Line2D.set_xdata`,
+#                                                                          `~.Line2D.set_ydata`
 # `.Axes.scatter`                           `.collections.PathCollection`  `~.collections.\
 #                                                                          PathCollection.set_offsets`
 # `.Axes.imshow`                            `.image.AxesImage`             ``AxesImage.set_data``
@@ -88,6 +93,7 @@
 #                                                                          `~.Ellipse.set_center`,
 #                                                                          `~.Ellipse.set_height`,
 #                                                                          `~.Ellipse.set_width`
+# `.Axes.set_title`, `.Axes.text`           `.text.Text`                   `~.Text.set_text`
 # ========================================  =============================  ===========================
 #
 # Covering the set methods for all types of artists is beyond the scope of this
diff --git a/lib/matplotlib/lines.py b/lib/matplotlib/lines.py
index 5e5c19c9f69f..258573c9474e 100644
--- a/lib/matplotlib/lines.py
+++ b/lib/matplotlib/lines.py
@@ -651,6 +651,11 @@ def set_data(self, *args):
         Parameters
         ----------
         *args : (2, N) array or two 1D arrays
+
+        See Also
+        --------
+        set_xdata
+        set_ydata
         """
         if len(args) == 1:
             (x, y), = args
@@ -1274,6 +1279,11 @@ def set_xdata(self, x):
         Parameters
         ----------
         x : 1D array
+
+        See Also
+        --------
+        set_data
+        set_ydata
         """
         if not np.iterable(x):
             raise RuntimeError('x must be a sequence')
@@ -1288,6 +1298,11 @@ def set_ydata(self, y):
         Parameters
         ----------
         y : 1D array
+
+        See Also
+        --------
+        set_data
+        set_xdata
         """
         if not np.iterable(y):
             raise RuntimeError('y must be a sequence')

From 5bc7c6727ea92ef5e962b4df2f262aa75a7293e7 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Wed, 6 Mar 2024 15:33:17 -0600
Subject: [PATCH 0806/1120] Update lib/matplotlib/tests/test_axes.py

---
 lib/matplotlib/tests/test_axes.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index 73a3ead26ea0..2751273db3d9 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -8907,7 +8907,7 @@ def test_axes_clear_behavior(fig_ref, fig_test, which):
     ax_test = fig_test.subplots()
     ax_ref = fig_ref.subplots()
     # the following tick params values are chosen to each create a visual difference
-    # from their defaults 
+    # from their defaults
     target = {
         "direction": "in",
         "length": 10,

From 7344ffdadd2af40eb0fec9c6c63edb0a263ba53f Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Thu, 22 Feb 2024 23:52:13 +0100
Subject: [PATCH 0807/1120] DOC: fix :mpltype:`color` role

`inline.interpreted()` already returns a list of nodes. We mustn't wrap
it in another list.
---
 doc/sphinxext/custom_roles.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/doc/sphinxext/custom_roles.py b/doc/sphinxext/custom_roles.py
index 8961037ed0f1..d76c92709865 100644
--- a/doc/sphinxext/custom_roles.py
+++ b/doc/sphinxext/custom_roles.py
@@ -72,9 +72,8 @@ def mpltype_role(name, rawtext, text, lineno, inliner, options={}, content=[]):
     if mpltype not in type_to_link_target:
         raise ValueError(f"Unknown mpltype: {mpltype!r}")
 
-    ref_nodes, messages = inliner.interpreted(
+    node_list, messages = inliner.interpreted(
         mpltype, f'{mpltype} <{type_to_link_target[mpltype]}>', 'ref', lineno)
-    node_list = [ref_nodes]
     return node_list, messages
 
 

From ab8e59029abef87f24b6066f698a55494274796a Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Fri, 22 Dec 2023 10:02:29 +0100
Subject: [PATCH 0808/1120] Use :mpltype:`color` for color types

---
 lib/matplotlib/axes/_axes.py                  | 38 +++++++++----------
 lib/matplotlib/axes/_base.py                  | 10 ++---
 lib/matplotlib/axes/_secondary_axes.py        |  2 +-
 lib/matplotlib/backend_bases.py               |  8 ++--
 lib/matplotlib/collections.py                 | 20 +++++-----
 lib/matplotlib/colorbar.py                    |  2 +-
 lib/matplotlib/colors.py                      |  4 +-
 lib/matplotlib/contour.py                     |  4 +-
 lib/matplotlib/figure.py                      |  8 ++--
 lib/matplotlib/lines.py                       | 10 ++---
 lib/matplotlib/patches.py                     |  6 +--
 lib/matplotlib/patheffects.py                 |  4 +-
 lib/matplotlib/pyplot.py                      |  4 +-
 lib/matplotlib/quiver.py                      | 10 ++---
 lib/matplotlib/spines.py                      |  2 +-
 lib/matplotlib/stackplot.py                   |  2 +-
 lib/matplotlib/streamplot.py                  |  2 +-
 lib/matplotlib/table.py                       | 10 ++---
 lib/matplotlib/text.py                        |  4 +-
 lib/matplotlib/tri/_tricontour.py             |  2 +-
 lib/matplotlib/widgets.py                     | 20 +++++-----
 lib/mpl_toolkits/axisartist/axisline_style.py |  2 +-
 lib/mpl_toolkits/mplot3d/axes3d.py            |  8 ++--
 lib/mpl_toolkits/mplot3d/axis3d.py            |  2 +-
 24 files changed, 92 insertions(+), 92 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 3a1cc2fb9fb6..b06832767b76 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -427,10 +427,10 @@ def indicate_inset(self, bounds, inset_ax=None, *, transform=None,
             `ax.transAxes`, i.e. the units of *rect* are in Axes-relative
             coordinates.
 
-        facecolor : color, default: 'none'
+        facecolor : :mpltype:`color`, default: 'none'
             Facecolor of the rectangle.
 
-        edgecolor : color, default: '0.5'
+        edgecolor : :mpltype:`color`, default: '0.5'
             Color of the rectangle and color of the connecting lines.
 
         alpha : float, default: 0.5
@@ -1073,7 +1073,7 @@ def hlines(self, y, xmin, xmax, colors=None, linestyles='solid',
             Respective beginning and end of each line. If scalars are
             provided, all lines will have the same length.
 
-        colors : color or list of colors, default: :rc:`lines.color`
+        colors : :mpltype:`color` or list of color , default: :rc:`lines.color`
 
         linestyles : {'solid', 'dashed', 'dashdot', 'dotted'}, default: 'solid'
 
@@ -1164,7 +1164,7 @@ def vlines(self, x, ymin, ymax, colors=None, linestyles='solid',
             Respective beginning and end of each line. If scalars are
             provided, all lines will have the same length.
 
-        colors : color or list of colors, default: :rc:`lines.color`
+        colors : :mpltype:`color` or list of color, default: :rc:`lines.color`
 
         linestyles : {'solid', 'dashed', 'dashdot', 'dotted'}, default: 'solid'
 
@@ -1300,7 +1300,7 @@ def eventplot(self, positions, orientation='horizontal', lineoffsets=1,
             If *positions* is 2D, this can be a sequence with length matching
             the length of *positions*.
 
-        colors : color or list of colors, default: :rc:`lines.color`
+        colors : :mpltype:`color` or list of color, default: :rc:`lines.color`
             The color(s) of the event lines.
 
             If *positions* is 2D, this can be a sequence with length matching
@@ -2333,10 +2333,10 @@ def bar(self, x, height, width=0.8, bottom=None, *, align="center",
 
         Other Parameters
         ----------------
-        color : color or list of color, optional
+        color : :mpltype:`color` or list of :mpltype:`color`, optional
             The colors of the bar faces.
 
-        edgecolor : color or list of color, optional
+        edgecolor : :mpltype:`color` or list of :mpltype:`color`, optional
             The colors of the bar edges.
 
         linewidth : float or array-like, optional
@@ -2368,7 +2368,7 @@ def bar(self, x, height, width=0.8, bottom=None, *, align="center",
             See :doc:`/gallery/statistics/errorbar_features` for an example on
             the usage of *xerr* and *yerr*.
 
-        ecolor : color or list of color, default: 'black'
+        ecolor : :mpltype:`color` or list of :mpltype:`color`, default: 'black'
             The line color of the errorbars.
 
         capsize : float, default: :rc:`errorbar.capsize`
@@ -2646,10 +2646,10 @@ def barh(self, y, width, height=0.8, left=None, *, align="center",
 
         Other Parameters
         ----------------
-        color : color or list of color, optional
+        color : :mpltype:`color` or list of :mpltype:`color`, optional
             The colors of the bar faces.
 
-        edgecolor : color or list of color, optional
+        edgecolor : :mpltype:`color` or list of :mpltype:`color`, optional
             The colors of the bar edges.
 
         linewidth : float or array-like, optional
@@ -2681,7 +2681,7 @@ def barh(self, y, width, height=0.8, left=None, *, align="center",
             See :doc:`/gallery/statistics/errorbar_features` for an example on
             the usage of *xerr* and *yerr*.
 
-        ecolor : color or list of color, default: 'black'
+        ecolor : :mpltype:`color` or list of :mpltype:`color`, default: 'black'
             The line color of the errorbars.
 
         capsize : float, default: :rc:`errorbar.capsize`
@@ -3139,7 +3139,7 @@ def pie(self, x, explode=None, labels=None, colors=None,
         labels : list, default: None
             A sequence of strings providing the labels for each wedge
 
-        colors : color or array-like of color, default: None
+        colors : :mpltype:`color` or list of :mpltype:`color`, default: None
             A sequence of colors through which the pie chart will cycle.  If
             *None*, will use the colors in the currently active cycle.
 
@@ -3434,7 +3434,7 @@ def errorbar(self, x, y, yerr=None, xerr=None,
             Use 'none' (case-insensitive) to plot errorbars without any data
             markers.
 
-        ecolor : color, default: None
+        ecolor : :mpltype:`color`, default: None
             The color of the errorbar lines.  If None, use the color of the
             line connecting the markers.
 
@@ -4416,9 +4416,9 @@ def _parse_scatter_color_args(c, edgecolors, kwargs, xsize,
 
         Parameters
         ----------
-        c : color or sequence or sequence of color or None
+        c : :mpltype:`color` or array-like or list of :mpltype:`color` or None
             See argument description of `.Axes.scatter`.
-        edgecolors : color or sequence of color or {'face', 'none'} or None
+        edgecolors : :mpltype:`color` or sequence of color or {'face', 'none'} or None
             See argument description of `.Axes.scatter`.
         kwargs : dict
             Additional kwargs. If these keys exist, we pop and process them:
@@ -4575,7 +4575,7 @@ def scatter(self, x, y, s=None, c=None, marker=None, cmap=None, norm=None,
             To eliminate the marker edge either set *linewidth=0* or
             *edgecolor='none'*.
 
-        c : array-like or list of colors or color, optional
+        c : array-like or list of :mpltype:`color` or :mpltype:`color`, optional
             The marker colors. Possible values:
 
             - A scalar or sequence of n numbers to be mapped to colors using
@@ -4625,8 +4625,8 @@ def scatter(self, x, y, s=None, c=None, marker=None, cmap=None, norm=None,
             The linewidth of the marker edges. Note: The default *edgecolors*
             is 'face'. You may want to change this as well.
 
-        edgecolors : {'face', 'none', *None*} or color or sequence of color, \
-default: :rc:`scatter.edgecolors`
+        edgecolors : {'face', 'none', *None*} or :mpltype:`color` or list of \
+:mpltype:`color`, default: :rc:`scatter.edgecolors`
             The edge color of the marker. Possible values:
 
             - 'face': The edge color will always be the same as the face color.
@@ -6738,7 +6738,7 @@ def hist(self, x, bins=None, range=None, density=False, weights=None,
         log : bool, default: False
             If ``True``, the histogram axis will be set to a log scale.
 
-        color : color or array-like of colors or None, default: None
+        color : :mpltype:`color` or list of :mpltype:`color` or None, default: None
             Color or sequence of colors, one per dataset.  Default (``None``)
             uses the standard line color sequence.
 
diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index 0617fc7681bd..5d612c581270 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -1507,7 +1507,7 @@ def set_facecolor(self, color):
 
         Parameters
         ----------
-        color : color; see :ref:`colors_def`
+        color : :mpltype:`color`
         """
         self._facecolor = color
         self.stale = True
@@ -3379,17 +3379,17 @@ def tick_params(self, axis='both', **kwargs):
             Tick length in points.
         width : float
             Tick width in points.
-        color : color
+        color : :mpltype:`color`
             Tick color.
         pad : float
             Distance in points between tick and label.
         labelsize : float or str
             Tick label font size in points or as a string (e.g., 'large').
-        labelcolor : color
+        labelcolor : :mpltype:`color`
             Tick label color.
         labelfontfamily : str
             Tick label font.
-        colors : color
+        colors : :mpltype:`color`
             Tick color and label color.
         zorder : float
             Tick and label zorder.
@@ -3399,7 +3399,7 @@ def tick_params(self, axis='both', **kwargs):
             Whether to draw the respective tick labels.
         labelrotation : float
             Tick label rotation
-        grid_color : color
+        grid_color : :mpltype:`color`
             Gridline color.
         grid_alpha : float
             Transparency of gridlines: 0 (transparent) to 1 (opaque).
diff --git a/lib/matplotlib/axes/_secondary_axes.py b/lib/matplotlib/axes/_secondary_axes.py
index 81333a8a201c..c63738f01561 100644
--- a/lib/matplotlib/axes/_secondary_axes.py
+++ b/lib/matplotlib/axes/_secondary_axes.py
@@ -240,7 +240,7 @@ def set_color(self, color):
 
         Parameters
         ----------
-        color : color; see :ref:`colors_def`
+        color : :mpltype:`color`
         """
         axis = self._axis_map[self._orientation]
         axis.set_tick_params(colors=color)
diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
index a353500f8725..d25f3c636fe3 100644
--- a/lib/matplotlib/backend_bases.py
+++ b/lib/matplotlib/backend_bases.py
@@ -218,7 +218,7 @@ def draw_markers(self, gc, marker_path, marker_trans, path,
             The locations to draw the markers.
         trans : `~matplotlib.transforms.Transform`
             An affine transform applied to the path.
-        rgbFace : color, optional
+        rgbFace : :mpltype:`color`, optional
         """
         for vertices, codes in path.iter_segments(trans, simplify=False):
             if len(vertices):
@@ -956,7 +956,7 @@ def set_foreground(self, fg, isRGBA=False):
 
         Parameters
         ----------
-        fg : color
+        fg : :mpltype:`color`
         isRGBA : bool
             If *fg* is known to be an ``(r, g, b, a)`` tuple, *isRGBA* can be
             set to True to improve performance.
@@ -2111,11 +2111,11 @@ def print_figure(
         dpi : float, default: :rc:`savefig.dpi`
             The dots per inch to save the figure in.
 
-        facecolor : color or 'auto', default: :rc:`savefig.facecolor`
+        facecolor : :mpltype:`color` or 'auto', default: :rc:`savefig.facecolor`
             The facecolor of the figure.  If 'auto', use the current figure
             facecolor.
 
-        edgecolor : color or 'auto', default: :rc:`savefig.edgecolor`
+        edgecolor : :mpltype:`color` or 'auto', default: :rc:`savefig.edgecolor`
             The edgecolor of the figure.  If 'auto', use the current figure
             edgecolor.
 
diff --git a/lib/matplotlib/collections.py b/lib/matplotlib/collections.py
index 5cbffff314b6..3724cf506ed9 100644
--- a/lib/matplotlib/collections.py
+++ b/lib/matplotlib/collections.py
@@ -96,11 +96,11 @@ def __init__(self, *,
         """
         Parameters
         ----------
-        edgecolors : color or list of colors, default: :rc:`patch.edgecolor`
+        edgecolors : :mpltype:`color` or list of colors, default: :rc:`patch.edgecolor`
             Edge color for each patch making up the collection. The special
             value 'face' can be passed to make the edgecolor match the
             facecolor.
-        facecolors : color or list of colors, default: :rc:`patch.facecolor`
+        facecolors : :mpltype:`color` or list of colors, default: :rc:`patch.facecolor`
             Face color for each patch making up the collection.
         linewidths : float or list of floats, default: :rc:`patch.linewidth`
             Line width for each patch making up the collection.
@@ -745,7 +745,7 @@ def set_color(self, c):
 
         Parameters
         ----------
-        c : color or list of RGBA tuples
+        c : :mpltype:`color` or list of RGBA tuples
 
         See Also
         --------
@@ -776,7 +776,7 @@ def set_facecolor(self, c):
 
         Parameters
         ----------
-        c : color or list of colors
+        c : :mpltype:`color` or list of :mpltype:`color`
         """
         if isinstance(c, str) and c.lower() in ("none", "face"):
             c = c.lower()
@@ -821,7 +821,7 @@ def set_edgecolor(self, c):
 
         Parameters
         ----------
-        c : color or list of colors or 'face'
+        c : :mpltype:`color` or list of :mpltype:`color` or 'face'
             The collection edgecolor(s).  If a sequence, the patches cycle
             through it.  If 'face', match the facecolor.
         """
@@ -1368,7 +1368,7 @@ def __init__(self, segments,  # Can be None.
             can have a different number of segments.
         linewidths : float or list of float, default: :rc:`lines.linewidth`
             The width of each line in points.
-        colors : color or list of color, default: :rc:`lines.color`
+        colors : :mpltype:`color` or list of color, default: :rc:`lines.color`
             A sequence of RGBA tuples (e.g., arbitrary color strings, etc, not
             allowed).
         antialiaseds : bool or list of bool, default: :rc:`lines.antialiased`
@@ -1376,7 +1376,7 @@ def __init__(self, segments,  # Can be None.
         zorder : float, default: 2
             zorder of the lines once drawn.
 
-        facecolors : color or list of color, default: 'none'
+        facecolors : :mpltype:`color` or list of :mpltype:`color`, default: 'none'
             When setting *facecolors*, each line is interpreted as a boundary
             for an area, implicitly closing the path from the last point to the
             first point. The enclosed area is filled with *facecolor*.
@@ -1455,7 +1455,7 @@ def set_color(self, c):
 
         Parameters
         ----------
-        c : color or list of colors
+        c : :mpltype:`color` or list of :mpltype:`color`
             Single color (all lines have same color), or a
             sequence of RGBA tuples; if it is a sequence the lines will
             cycle through the sequence.
@@ -1483,7 +1483,7 @@ def set_gapcolor(self, gapcolor):
 
         Parameters
         ----------
-        gapcolor : color or list of colors or None
+        gapcolor : :mpltype:`color` or list of :mpltype:`color` or None
             The color with which to fill the gaps. If None, the gaps are
             unfilled.
         """
@@ -1556,7 +1556,7 @@ def __init__(self,
             ``lineoffset - linelength/2`` to ``lineoffset + linelength/2``).
         linewidth : float or list thereof, default: :rc:`lines.linewidth`
             The line width of the event lines, in points.
-        color : color or list of colors, default: :rc:`lines.color`
+        color : :mpltype:`color` or list of :mpltype:`color`, default: :rc:`lines.color`
             The color of the event lines.
         linestyle : str or tuple or list thereof, default: 'solid'
             Valid strings are ['solid', 'dashed', 'dashdot', 'dotted',
diff --git a/lib/matplotlib/colorbar.py b/lib/matplotlib/colorbar.py
index e09cdead7392..af61e4671ff4 100644
--- a/lib/matplotlib/colorbar.py
+++ b/lib/matplotlib/colorbar.py
@@ -730,7 +730,7 @@ def add_lines(self, *args, **kwargs):
         ----------
         levels : array-like
             The positions of the lines.
-        colors : color or list of colors
+        colors : :mpltype:`color` or list of :mpltype:`color`
             Either a single color applying to all lines or one color value for
             each line.
         linewidths : float or array-like
diff --git a/lib/matplotlib/colors.py b/lib/matplotlib/colors.py
index 9a493c928fdb..ed59a6e2178d 100644
--- a/lib/matplotlib/colors.py
+++ b/lib/matplotlib/colors.py
@@ -164,7 +164,7 @@ def register(self, name, color_list):
         name : str
             The name for the color sequence.
 
-        color_list : list of colors
+        color_list : list of :mpltype:`color`
             An iterable returning valid Matplotlib colors when iterating over.
             Note however that the returned color sequence will always be a
             list regardless of the input type.
@@ -1042,7 +1042,7 @@ def from_list(name, colors, N=256, gamma=1.0):
         ----------
         name : str
             The name of the colormap.
-        colors : array-like of colors or array-like of (value, color)
+        colors : list of :mpltype:`color` or list of (value, color)
             If only colors are given, they are equidistantly mapped from the
             range :math:`[0, 1]`; i.e. 0 maps to ``colors[0]`` and 1 maps to
             ``colors[-1]``.
diff --git a/lib/matplotlib/contour.py b/lib/matplotlib/contour.py
index ab550b5d2acf..90167bd320e8 100644
--- a/lib/matplotlib/contour.py
+++ b/lib/matplotlib/contour.py
@@ -78,7 +78,7 @@ def clabel(self, levels=None, *,
             Size in points or relative size e.g., 'smaller', 'x-large'.
             See `.Text.set_size` for accepted string values.
 
-        colors : color or colors or None, default: None
+        colors : :mpltype:`color` or colors or None, default: None
             The label colors:
 
             - If *None*, the color of each label matches the color of
@@ -1653,7 +1653,7 @@ def _initialize_x_y(self, z):
     nearest those points are always masked out, other triangular
     corners comprising three unmasked points are contoured as usual.
 
-colors : color string or sequence of colors, optional
+colors : :mpltype:`color` or list of :mpltype:`color`, optional
     The colors of the levels, i.e. the lines for `.contour` and the
     areas for `.contourf`.
 
diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
index 12ab090288a5..087c193d48c3 100644
--- a/lib/matplotlib/figure.py
+++ b/lib/matplotlib/figure.py
@@ -397,7 +397,7 @@ def set_edgecolor(self, color):
 
         Parameters
         ----------
-        color : color; see :ref:`colors_def`
+        color : :mpltype:`color`
         """
         self.patch.set_edgecolor(color)
 
@@ -407,7 +407,7 @@ def set_facecolor(self, color):
 
         Parameters
         ----------
-        color : color; see :ref:`colors_def`
+        color : :mpltype:`color`
         """
         self.patch.set_facecolor(color)
 
@@ -3261,11 +3261,11 @@ def savefig(self, fname, *, transparent=None, **kwargs):
             compressed layout engine; ignored if one of those engines is not in
             use.
 
-        facecolor : color or 'auto', default: :rc:`savefig.facecolor`
+        facecolor : :mpltype:`color` or 'auto', default: :rc:`savefig.facecolor`
             The facecolor of the figure.  If 'auto', use the current figure
             facecolor.
 
-        edgecolor : color or 'auto', default: :rc:`savefig.edgecolor`
+        edgecolor : :mpltype:`color` or 'auto', default: :rc:`savefig.edgecolor`
             The edgecolor of the figure.  If 'auto', use the current figure
             edgecolor.
 
diff --git a/lib/matplotlib/lines.py b/lib/matplotlib/lines.py
index 5e5c19c9f69f..6e0d027c5c90 100644
--- a/lib/matplotlib/lines.py
+++ b/lib/matplotlib/lines.py
@@ -1056,7 +1056,7 @@ def set_color(self, color):
 
         Parameters
         ----------
-        color : color; see :ref:`colors_def`
+        color : :mpltype:`color`
         """
         mcolors._check_color_like(color=color)
         self._color = color
@@ -1111,7 +1111,7 @@ def set_gapcolor(self, gapcolor):
 
         Parameters
         ----------
-        gapcolor : color or None
+        gapcolor : :mpltype:`color` or None
             The color with which to fill the gaps. If None, the gaps are
             unfilled.
         """
@@ -1214,7 +1214,7 @@ def set_markeredgecolor(self, ec):
 
         Parameters
         ----------
-        ec : color
+        ec : :mpltype:`color`
         """
         self._set_markercolor("markeredgecolor", True, ec)
 
@@ -1224,7 +1224,7 @@ def set_markerfacecolor(self, fc):
 
         Parameters
         ----------
-        fc : color
+        fc : :mpltype:`color`
         """
         self._set_markercolor("markerfacecolor", True, fc)
 
@@ -1234,7 +1234,7 @@ def set_markerfacecoloralt(self, fc):
 
         Parameters
         ----------
-        fc : color
+        fc : :mpltype:`color`
         """
         self._set_markercolor("markerfacecoloralt", False, fc)
 
diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
index e7ad848b3e49..b5be74af781a 100644
--- a/lib/matplotlib/patches.py
+++ b/lib/matplotlib/patches.py
@@ -379,7 +379,7 @@ def set_edgecolor(self, color):
 
         Parameters
         ----------
-        color : color or None; see :ref:`colors_def`
+        color : :mpltype:`color` or None
         """
         self._original_edgecolor = color
         self._set_edgecolor(color)
@@ -397,7 +397,7 @@ def set_facecolor(self, color):
 
         Parameters
         ----------
-        color : color or None; see :ref:`colors_def`
+        color : :mpltype:`color` or None
         """
         self._original_facecolor = color
         self._set_facecolor(color)
@@ -408,7 +408,7 @@ def set_color(self, c):
 
         Parameters
         ----------
-        c : color
+        c : :mpltype:`color`
 
         See Also
         --------
diff --git a/lib/matplotlib/patheffects.py b/lib/matplotlib/patheffects.py
index 5bb4c8e2a501..110868717936 100644
--- a/lib/matplotlib/patheffects.py
+++ b/lib/matplotlib/patheffects.py
@@ -228,7 +228,7 @@ def __init__(self, offset=(2, -2),
         ----------
         offset : (float, float), default: (2, -2)
             The (x, y) offset of the shadow in points.
-        shadow_rgbFace : color
+        shadow_rgbFace : :mpltype:`color`
             The shadow color.
         alpha : float, default: 0.3
             The alpha transparency of the created shadow patch.
@@ -295,7 +295,7 @@ def __init__(self, offset=(2, -2),
         ----------
         offset : (float, float), default: (2, -2)
             The (x, y) offset to apply to the path, in points.
-        shadow_color : color, default: 'black'
+        shadow_color : :mpltype:`color`, default: 'black'
             The shadow color.
             A value of ``None`` takes the original artist's color
             with a scale factor of *rho*.
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index c5044fe7242f..249e1bcdec80 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -822,10 +822,10 @@ def figure(
     dpi : float, default: :rc:`figure.dpi`
         The resolution of the figure in dots-per-inch.
 
-    facecolor : color, default: :rc:`figure.facecolor`
+    facecolor : :mpltype:`color`, default: :rc:`figure.facecolor`
         The background color.
 
-    edgecolor : color, default: :rc:`figure.edgecolor`
+    edgecolor : :mpltype:`color`, default: :rc:`figure.edgecolor`
         The border color.
 
     frameon : bool, default: True
diff --git a/lib/matplotlib/quiver.py b/lib/matplotlib/quiver.py
index 20e4f15dd903..db4ef35f3034 100644
--- a/lib/matplotlib/quiver.py
+++ b/lib/matplotlib/quiver.py
@@ -179,7 +179,7 @@
     Minimum length as a multiple of shaft width; if an arrow length
     is less than this, plot a dot (hexagon) of this diameter instead.
 
-color : color or color sequence, optional
+color : :mpltype:`color` or list :mpltype:`color`, optional
     Explicit color(s) for the arrows. If *C* has been set, *color* has no
     effect.
 
@@ -271,14 +271,14 @@ def __init__(self, Q, X, Y, U, label,
             (used for the locations of the vectors in the quiver plot itself);
             'inches' is position in the figure in inches, with (0, 0) at the
             lower left corner.
-        color : color
+        color : :mpltype:`color`
             Overrides face and edge colors from *Q*.
         labelpos : {'N', 'S', 'E', 'W'}
             Position the label above, below, to the right, to the left of the
             arrow, respectively.
         labelsep : float, default: 0.1
             Distance in inches between the arrow and the label.
-        labelcolor : color, default: :rc:`text.color`
+        labelcolor : :mpltype:`color`, default: :rc:`text.color`
             Label color.
         fontproperties : dict, optional
             A dictionary with keyword arguments accepted by the
@@ -796,12 +796,12 @@ def _h_arrows(self, length):
     rotates about this point. This can also be a number, which shifts the
     start of the barb that many points away from grid point.
 
-barbcolor : color or color sequence
+barbcolor : :mpltype:`color` or color sequence
     The color of all parts of the barb except for the flags.  This parameter
     is analogous to the *edgecolor* parameter for polygons, which can be used
     instead. However this parameter will override facecolor.
 
-flagcolor : color or color sequence
+flagcolor : :mpltype:`color` or color sequence
     The color of any flags on the barb.  This parameter is analogous to the
     *facecolor* parameter for polygons, which can be used instead. However,
     this parameter will override facecolor.  If this is not set (and *C* has
diff --git a/lib/matplotlib/spines.py b/lib/matplotlib/spines.py
index 9077ae478d71..39cb99c53d72 100644
--- a/lib/matplotlib/spines.py
+++ b/lib/matplotlib/spines.py
@@ -472,7 +472,7 @@ def set_color(self, c):
 
         Parameters
         ----------
-        c : color
+        c : :mpltype:`color`
 
         Notes
         -----
diff --git a/lib/matplotlib/stackplot.py b/lib/matplotlib/stackplot.py
index 4e933f52887d..0d9b896f6f4c 100644
--- a/lib/matplotlib/stackplot.py
+++ b/lib/matplotlib/stackplot.py
@@ -47,7 +47,7 @@ def stackplot(axes, x, *args,
         A sequence of labels to assign to each data series. If unspecified,
         then no labels will be applied to artists.
 
-    colors : list of color, optional
+    colors : list of :mpltype:`color`, optional
         A sequence of colors to be cycled through and used to color the stacked
         areas. The sequence need not be exactly the same length as the number
         of provided *y*, in which case the colors will repeat from the
diff --git a/lib/matplotlib/streamplot.py b/lib/matplotlib/streamplot.py
index daae8fc5b35c..84f99732c709 100644
--- a/lib/matplotlib/streamplot.py
+++ b/lib/matplotlib/streamplot.py
@@ -42,7 +42,7 @@ def streamplot(axes, x, y, u, v, density=1, linewidth=None, color=None,
         The width of the streamlines. With a 2D array the line width can be
         varied across the grid. The array must have the same shape as *u*
         and *v*.
-    color : color or 2D array
+    color : :mpltype:`color` or 2D array
         The streamline color. If given an array, its values are converted to
         colors using *cmap* and *norm*.  The array must have the same shape
         as *u* and *v*.
diff --git a/lib/matplotlib/table.py b/lib/matplotlib/table.py
index ff7fb06c0d08..7d8c8ec4c3f4 100644
--- a/lib/matplotlib/table.py
+++ b/lib/matplotlib/table.py
@@ -70,9 +70,9 @@ def __init__(self, xy, width, height, *,
             The cell width.
         height : float
             The cell height.
-        edgecolor : color, default: 'k'
+        edgecolor : :mpltype:`color`, default: 'k'
             The color of the cell border.
-        facecolor : color, default: 'w'
+        facecolor : :mpltype:`color`, default: 'w'
             The cell facecolor.
         fill : bool, default: True
             Whether the cell background is filled.
@@ -681,7 +681,7 @@ def table(ax,
         *Note*: Line breaks in the strings are currently not accounted for and
         will result in the text exceeding the cell boundaries.
 
-    cellColours : 2D list of colors, optional
+    cellColours : 2D list of :mpltype:`color`, optional
         The background colors of the cells.
 
     cellLoc : {'right', 'center', 'left'}
@@ -694,7 +694,7 @@ def table(ax,
     rowLabels : list of str, optional
         The text of the row header cells.
 
-    rowColours : list of colors, optional
+    rowColours : list of :mpltype:`color`, optional
         The colors of the row header cells.
 
     rowLoc : {'left', 'center', 'right'}
@@ -703,7 +703,7 @@ def table(ax,
     colLabels : list of str, optional
         The text of the column header cells.
 
-    colColours : list of colors, optional
+    colColours : list of :mpltype:`color`, optional
         The colors of the column header cells.
 
     colLoc : {'center', 'left', 'right'}
diff --git a/lib/matplotlib/text.py b/lib/matplotlib/text.py
index 5a40a808e36d..e1f3a88809de 100644
--- a/lib/matplotlib/text.py
+++ b/lib/matplotlib/text.py
@@ -965,7 +965,7 @@ def set_backgroundcolor(self, color):
 
         Parameters
         ----------
-        color : color; see :ref:`colors_def`
+        color : :mpltype:`color`
 
         See Also
         --------
@@ -985,7 +985,7 @@ def set_color(self, color):
 
         Parameters
         ----------
-        color : color; see :ref:`colors_def`
+        color : :mpltype:`color`
         """
         # "auto" is only supported by axisartist, but we can just let it error
         # out at draw time for simplicity.
diff --git a/lib/matplotlib/tri/_tricontour.py b/lib/matplotlib/tri/_tricontour.py
index 5b6d745372f8..5dc1eb81593c 100644
--- a/lib/matplotlib/tri/_tricontour.py
+++ b/lib/matplotlib/tri/_tricontour.py
@@ -130,7 +130,7 @@ def _contour_args(self, args, kwargs):
 
 Other Parameters
 ----------------
-colors : color string or sequence of colors, optional
+colors : :mpltype:`color` or list of :mpltype:`color`, optional
     The colors of the levels, i.e., the contour %%(type)s.
 
     The sequence is cycled for the levels in ascending order. If the sequence
diff --git a/lib/matplotlib/widgets.py b/lib/matplotlib/widgets.py
index 4aab281c5291..88eafcd21a9e 100644
--- a/lib/matplotlib/widgets.py
+++ b/lib/matplotlib/widgets.py
@@ -193,7 +193,7 @@ def __init__(self, ax, label, image=None,
             directly forwarded to `~.axes.Axes.imshow`.
         color : :mpltype:`color`
             The color of the button when not activated.
-        hovercolor : color
+        hovercolor : :mpltype:`color`
             The color of the button when the mouse is over it.
         useblit : bool, default: True
             Use blitting for faster drawing if supported by the backend.
@@ -406,11 +406,11 @@ def __init__(self, ax, label, valmin, valmax, *, valinit=0.5, valfmt=None,
         orientation : {'horizontal', 'vertical'}, default: 'horizontal'
             The orientation of the slider.
 
-        initcolor : color, default: 'r'
+        initcolor : :mpltype:`color`, default: 'r'
             The color of the line at the *valinit* position. Set to ``'none'``
             for no line.
 
-        track_color : color, default: 'lightgrey'
+        track_color : :mpltype:`color`, default: 'lightgrey'
             The color of the background track. The track is accessible for
             further styling via the *track* attribute.
 
@@ -678,7 +678,7 @@ def __init__(
         orientation : {'horizontal', 'vertical'}, default: 'horizontal'
             The orientation of the slider.
 
-        track_color : color, default: 'lightgrey'
+        track_color : :mpltype:`color`, default: 'lightgrey'
             The color of the background track. The track is accessible for
             further styling via the *track* attribute.
 
@@ -1312,9 +1312,9 @@ class TextBox(AxesWidget):
         The parent Axes for the widget.
     label : `~matplotlib.text.Text`
 
-    color : color
+    color : :mpltype:`color`
         The color of the text box when not hovering.
-    hovercolor : color
+    hovercolor : :mpltype:`color`
         The color of the text box when hovering.
     """
 
@@ -1330,9 +1330,9 @@ def __init__(self, ax, label, initial='', *,
             Label for this text box.
         initial : str
             Initial value in the text box.
-        color : color
+        color : :mpltype:`color`
             The color of the box.
-        hovercolor : color
+        hovercolor : :mpltype:`color`
             The color of the box when the mouse is over it.
         label_pad : float
             The distance between the label and the right side of the textbox.
@@ -1567,7 +1567,7 @@ class RadioButtons(AxesWidget):
     ----------
     ax : `~matplotlib.axes.Axes`
         The parent Axes for the widget.
-    activecolor : color
+    activecolor : :mpltype:`color`
         The color of the selected button.
     labels : list of `.Text`
         The button labels.
@@ -1592,7 +1592,7 @@ def __init__(self, ax, labels, active=0, activecolor=None, *,
             The button labels.
         active : int
             The index of the initially selected button.
-        activecolor : color
+        activecolor : :mpltype:`color`
             The color of the selected button. The default is ``'blue'`` if not
             specified here or in *radio_props*.
         useblit : bool, default: True
diff --git a/lib/mpl_toolkits/axisartist/axisline_style.py b/lib/mpl_toolkits/axisartist/axisline_style.py
index 5ae188021bb8..7f25b98082ef 100644
--- a/lib/mpl_toolkits/axisartist/axisline_style.py
+++ b/lib/mpl_toolkits/axisartist/axisline_style.py
@@ -171,7 +171,7 @@ def __init__(self, size=1, facecolor=None):
             ----------
             size : float
                 Size of the arrow as a fraction of the ticklabel size.
-            facecolor : color, default: :rc:`axes.edgecolor`
+            facecolor : :mpltype:`color`, default: :rc:`axes.edgecolor`
                 Fill color.
 
                 .. versionadded:: 3.7
diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index 74348d17730d..9a3c13daad6b 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -1940,13 +1940,13 @@ def plot_surface(self, X, Y, Z, *, norm=None, vmin=None,
             'classic' mode uses a default of ``rstride = cstride = 10`` instead
             of the new default of ``rcount = ccount = 50``.
 
-        color : color-like
+        color : :mpltype:`color`
             Color of the surface patches.
 
         cmap : Colormap, optional
             Colormap of the surface patches.
 
-        facecolors : array-like of colors
+        facecolors : list of :mpltype:`color`
             Colors of each individual patch.
 
         norm : `~matplotlib.colors.Normalize`, optional
@@ -2613,7 +2613,7 @@ def scatter(self, xs, ys, zs=0, zdir='z', s=20, c=None, depthshade=True,
             The marker size in points**2. Either an array of the same length
             as *xs* and *ys* or a single value to make all markers the same
             size.
-        c : color, sequence, or sequence of colors, optional
+        c : :mpltype:`color`, sequence, or sequence of colors, optional
             The marker color. Possible values:
 
             - A single color format string.
@@ -3260,7 +3260,7 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None, fmt='',
             Use 'none' (case-insensitive) to plot errorbars without any data
             markers.
 
-        ecolor : color, default: None
+        ecolor : :mpltype:`color`, default: None
             The color of the errorbar lines.  If None, use the color of the
             line connecting the markers.
 
diff --git a/lib/mpl_toolkits/mplot3d/axis3d.py b/lib/mpl_toolkits/mplot3d/axis3d.py
index 7b738b705c2a..79b78657bdb9 100644
--- a/lib/mpl_toolkits/mplot3d/axis3d.py
+++ b/lib/mpl_toolkits/mplot3d/axis3d.py
@@ -250,7 +250,7 @@ def set_pane_color(self, color, alpha=None):
 
         Parameters
         ----------
-        color : color
+        color : :mpltype:`color`
             Color for axis pane.
         alpha : float, optional
             Alpha value for axis pane. If None, base it on *color*.

From 268392f33373c073ce1e742739e22da6d036fea9 Mon Sep 17 00:00:00 2001
From: Jorge Moraleda <jorge.moraleda@gmail.com>
Date: Wed, 6 Mar 2024 18:07:30 -0500
Subject: [PATCH 0809/1120] Set per-monitor awareness on MSW when matplotlib
 creates the wx application.

---
 lib/matplotlib/backends/backend_wx.py | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/backends/backend_wx.py b/lib/matplotlib/backends/backend_wx.py
index ed5d6c76d7c9..650694063f00 100644
--- a/lib/matplotlib/backends/backend_wx.py
+++ b/lib/matplotlib/backends/backend_wx.py
@@ -43,6 +43,10 @@ def _create_wxapp():
     wxapp = wx.App(False)
     wxapp.SetExitOnFrameDelete(True)
     cbook._setup_new_guiapp()
+    if wx.Platform == '__WXMSW__':
+        # Set per-process DPI awareness. See https://docs.microsoft.com/en-us/windows/win32/api/shellscalingapi/ne-shellscalingapi-process_dpi_awareness
+        import ctypes
+        ctypes.windll.shcore.SetProcessDpiAwareness(2)
     return wxapp
 
 
@@ -469,9 +473,11 @@ def __init__(self, parent, id, figure=None):
         """
 
         FigureCanvasBase.__init__(self, figure)
-        w, h = map(math.ceil, self.figure.bbox.size)
+        size = wx.Size(*map(math.ceil, self.figure.bbox.size))
+        if wx.Platform != '__WXMSW__':
+            size = parent.FromDIP(size)
         # Set preferred window size hint - helps the sizer, if one is connected
-        wx.Panel.__init__(self, parent, id, size=parent.FromDIP(wx.Size(w, h)))
+        wx.Panel.__init__(self, parent, id, size=size)
         self.bitmap = None
         self._isDrawn = False
         self._rubberband_rect = None
@@ -1132,7 +1138,7 @@ def save_figure(self, *args):
 
     def draw_rubberband(self, event, x0, y0, x1, y1):
         height = self.canvas.figure.bbox.height
-        sf = self.GetDPIScaleFactor()
+        sf = 1 if wx.Platform == '__WXMSW__' else self.GetDPIScaleFactor()
         self.canvas._rubberband_rect = (x0/sf, (height - y0)/sf,
                                         x1/sf, (height - y1)/sf)
         self.canvas.Refresh()

From 0da2da00d5a884db9c7991c31ee81d1b5dc57b63 Mon Sep 17 00:00:00 2001
From: Ian Hunt-Isaak <ianhuntisaak@gmail.com>
Date: Thu, 7 Mar 2024 03:49:50 -0500
Subject: [PATCH 0810/1120] doc: add description of **kwargs usage to
 collections (#27872)

* doc: add description of **kwargs usage to collections
* Update lib/matplotlib/collections.py

Co-authored-by: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>

---------

Co-authored-by: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
---
 lib/matplotlib/collections.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/lib/matplotlib/collections.py b/lib/matplotlib/collections.py
index 5cbffff314b6..52c5add2e700 100644
--- a/lib/matplotlib/collections.py
+++ b/lib/matplotlib/collections.py
@@ -151,6 +151,9 @@ def __init__(self, *,
         zorder : float, default: 1
             The drawing order, shared by all Patches in the Collection. See
             :doc:`/gallery/misc/zorder_demo` for all defaults and examples.
+        **kwargs
+            Remaining keyword arguments will be used to set properties as
+            ``Collection.set_{key}(val)`` for each key-value pair in *kwargs*.
         """
         artist.Artist.__init__(self)
         cm.ScalarMappable.__init__(self, norm, cmap)

From dd94ac37a168b6edd3f38ee80c4a7df347d5e673 Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Sun, 3 Mar 2024 15:37:35 +0000
Subject: [PATCH 0811/1120] FIX: handle nans in RGBA input with ScalarMappables

---
 lib/matplotlib/cm.py                |  8 +++++++-
 lib/matplotlib/tests/test_colors.py | 26 ++++++++++++++++++++++++++
 2 files changed, 33 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/cm.py b/lib/matplotlib/cm.py
index 7e46cf567f70..e9a7aad6c456 100644
--- a/lib/matplotlib/cm.py
+++ b/lib/matplotlib/cm.py
@@ -328,7 +328,7 @@ def to_rgba(self, x, alpha=None, bytes=False, norm=True):
         treated as an RGB or RGBA array, and no mapping will be done.
         The array can be `~numpy.uint8`, or it can be floats with
         values in the 0-1 range; otherwise a ValueError will be raised.
-        If it is a masked array, any masked elements will be set to 0 alpha.
+        Any NaNs or masked elements will be set to 0 alpha.
         If the last dimension is 3, the *alpha* kwarg (defaulting to 1)
         will be used to fill in the transparency.  If the last dimension
         is 4, the *alpha* kwarg is ignored; it does not
@@ -360,6 +360,12 @@ def to_rgba(self, x, alpha=None, bytes=False, norm=True):
                 else:
                     raise ValueError("Third dimension must be 3 or 4")
                 if xx.dtype.kind == 'f':
+                    # If any of R, G, B, or A is nan, set to 0
+                    if np.any(nans := np.isnan(x)):
+                        if xx.shape[2] == 4:
+                            xx = xx.copy()
+                        xx[np.any(nans, axis=2), :] = 0
+
                     if norm and (xx.max() > 1 or xx.min() < 0):
                         raise ValueError("Floating point image RGB values "
                                          "must be in the 0..1 range.")
diff --git a/lib/matplotlib/tests/test_colors.py b/lib/matplotlib/tests/test_colors.py
index 2d71fea83472..5b5332100c2a 100644
--- a/lib/matplotlib/tests/test_colors.py
+++ b/lib/matplotlib/tests/test_colors.py
@@ -1352,6 +1352,32 @@ def test_scalarmappable_to_rgba(bytes):
     np.testing.assert_almost_equal(sm.to_rgba(xm[..., :3], bytes=bytes), expected)
 
 
+@pytest.mark.parametrize("bytes", (True, False))
+def test_scalarmappable_nan_to_rgba(bytes):
+    sm = cm.ScalarMappable()
+
+    # RGBA
+    x = np.ones((2, 3, 4), dtype=float) * 0.5
+    x[0, 0, 0] = np.nan
+    expected = x.copy()
+    expected[0, 0, :] = 0
+    if bytes:
+        expected = (expected * 255).astype(np.uint8)
+    np.testing.assert_almost_equal(sm.to_rgba(x, bytes=bytes), expected)
+    assert np.any(np.isnan(x))  # Input array should not be changed
+
+    # RGB
+    expected[..., 3] = 255 if bytes else 1
+    expected[0, 0, 3] = 0
+    np.testing.assert_almost_equal(sm.to_rgba(x[..., :3], bytes=bytes), expected)
+    assert np.any(np.isnan(x))  # Input array should not be changed
+
+    # Out-of-range fail
+    x[1, 0, 0] = 42
+    with pytest.raises(ValueError, match='0..1 range'):
+        sm.to_rgba(x[..., :3], bytes=bytes)
+
+
 def test_failed_conversions():
     with pytest.raises(ValueError):
         mcolors.to_rgba('5')

From 879779b568ad7536a398da55664b9b29e8a35e21 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 11 Oct 2023 07:45:59 -0400
Subject: [PATCH 0812/1120] Convert path extension to pybind11

---
 src/_path_wrapper.cpp | 880 +++++++++++++++++-------------------------
 src/meson.build       |   3 +-
 2 files changed, 347 insertions(+), 536 deletions(-)

diff --git a/src/_path_wrapper.cpp b/src/_path_wrapper.cpp
index 72774576574a..bc2314952e56 100644
--- a/src/_path_wrapper.cpp
+++ b/src/_path_wrapper.cpp
@@ -1,138 +1,111 @@
+#include <pybind11/pybind11.h>
+#include <pybind11/stl.h>
+
+#include <array>
+#include <limits>
+#include <optional>
+#include <string>
+#include <vector>
+
 #include "numpy_cpp.h"
 
 #include "_path.h"
 
 #include "py_converters.h"
+#include "py_converters_11.h"
 #include "py_adaptors.h"
 
-PyObject *convert_polygon_vector(std::vector<Polygon> &polygons)
+namespace py = pybind11;
+using namespace pybind11::literals;
+
+py::list
+convert_polygon_vector(std::vector<Polygon> &polygons)
 {
-    PyObject *pyresult = PyList_New(polygons.size());
+    auto result = py::list(polygons.size());
 
     for (size_t i = 0; i < polygons.size(); ++i) {
         Polygon poly = polygons[i];
-        npy_intp dims[2];
-        dims[1] = 2;
-
-        dims[0] = (npy_intp)poly.size();
-
-        numpy::array_view<double, 2> subresult(dims);
-        memcpy(subresult.data(), &poly[0], sizeof(double) * poly.size() * 2);
-
-        if (PyList_SetItem(pyresult, i, subresult.pyobj())) {
-            Py_DECREF(pyresult);
-            return NULL;
-        }
+        py::ssize_t dims[] = { static_cast<py::ssize_t>(poly.size()), 2 };
+        result[i] = py::array(dims, reinterpret_cast<double *>(poly.data()));
     }
 
-    return pyresult;
+    return result;
 }
 
-const char *Py_point_in_path__doc__ =
-    "point_in_path(x, y, radius, path, trans)\n"
-    "--\n\n";
-
-static PyObject *Py_point_in_path(PyObject *self, PyObject *args)
+static bool
+Py_point_in_path(double x, double y, double r, py::object path_obj,
+                 py::object trans_obj)
 {
-    double x, y, r;
     mpl::PathIterator path;
     agg::trans_affine trans;
-    bool result;
 
-    if (!PyArg_ParseTuple(args,
-                          "dddO&O&:point_in_path",
-                          &x,
-                          &y,
-                          &r,
-                          &convert_path,
-                          &path,
-                          &convert_trans_affine,
-                          &trans)) {
-        return NULL;
+    if (!convert_path(path_obj.ptr(), &path)) {
+        throw py::error_already_set();
     }
+    convert_trans_affine(trans_obj, trans);
 
-    CALL_CPP("point_in_path", (result = point_in_path(x, y, r, path, trans)));
-
-    if (result) {
-        Py_RETURN_TRUE;
-    } else {
-        Py_RETURN_FALSE;
-    }
+    return point_in_path(x, y, r, path, trans);
 }
 
-const char *Py_points_in_path__doc__ =
-    "points_in_path(points, radius, path, trans)\n"
-    "--\n\n";
-
-static PyObject *Py_points_in_path(PyObject *self, PyObject *args)
+static py::array_t<double>
+Py_points_in_path(py::array_t<double> points_obj, double r, py::object path_obj,
+                  py::object trans_obj)
 {
-    numpy::array_view<const double, 2> points;
-    double r;
+    numpy::array_view<double, 2> points;
     mpl::PathIterator path;
     agg::trans_affine trans;
 
-    if (!PyArg_ParseTuple(args,
-                          "O&dO&O&:points_in_path",
-                          &convert_points,
-                          &points,
-                          &r,
-                          &convert_path,
-                          &path,
-                          &convert_trans_affine,
-                          &trans)) {
-        return NULL;
+    if (!convert_points(points_obj.ptr(), &points)) {
+        throw py::error_already_set();
+    }
+    if (!convert_path(path_obj.ptr(), &path)) {
+        throw py::error_already_set();
     }
+    convert_trans_affine(trans_obj, trans);
 
     if (!check_trailing_shape(points, "points", 2)) {
-        return NULL;
+        throw py::error_already_set();
     }
 
-    npy_intp dims[] = { (npy_intp)points.shape(0) };
-    numpy::array_view<uint8_t, 1> results(dims);
+    py::ssize_t dims[] = { static_cast<py::ssize_t>(points.size()) };
+    py::array_t<uint8_t> results(dims);
+    auto results_mutable = results.mutable_unchecked<1>();
 
-    CALL_CPP("points_in_path", (points_in_path(points, r, path, trans, results)));
+    points_in_path(points, r, path, trans, results_mutable);
 
-    return results.pyobj();
+    return results;
 }
 
-const char *Py_update_path_extents__doc__ =
-    "update_path_extents(path, trans, rect, minpos, ignore)\n"
-    "--\n\n";
-
-static PyObject *Py_update_path_extents(PyObject *self, PyObject *args)
+static py::tuple
+Py_update_path_extents(py::object path_obj, py::object trans_obj, py::object rect_obj,
+                       py::array_t<double> minpos, bool ignore)
 {
     mpl::PathIterator path;
     agg::trans_affine trans;
     agg::rect_d rect;
-    numpy::array_view<double, 1> minpos;
-    int ignore;
-    int changed;
-
-    if (!PyArg_ParseTuple(args,
-                          "O&O&O&O&i:update_path_extents",
-                          &convert_path,
-                          &path,
-                          &convert_trans_affine,
-                          &trans,
-                          &convert_rect,
-                          &rect,
-                          &minpos.converter,
-                          &minpos,
-                          &ignore)) {
-        return NULL;
+    bool changed;
+
+    if (!convert_path(path_obj.ptr(), &path)) {
+        throw py::error_already_set();
+    }
+    convert_trans_affine(trans_obj, trans);
+    if (!convert_rect(rect_obj.ptr(), &rect)) {
+        throw py::error_already_set();
     }
 
+    if (minpos.ndim() != 1) {
+        throw py::value_error(
+            "minpos must be 1D, got " + std::to_string(minpos.ndim()));
+    }
     if (minpos.shape(0) != 2) {
-        PyErr_Format(PyExc_ValueError,
-                     "minpos must be of length 2, got %" NPY_INTP_FMT,
-                     minpos.shape(0));
-        return NULL;
+        throw py::value_error(
+            "minpos must be of length 2, got " + std::to_string(minpos.shape(0)));
     }
 
     extent_limits e;
 
     if (ignore) {
-        CALL_CPP("update_path_extents", reset_limits(e));
+        reset_limits(e);
     } else {
         if (rect.x1 > rect.x2) {
             e.x0 = std::numeric_limits<double>::infinity();
@@ -148,37 +121,34 @@ static PyObject *Py_update_path_extents(PyObject *self, PyObject *args)
             e.y0 = rect.y1;
             e.y1 = rect.y2;
         }
-        e.xm = minpos(0);
-        e.ym = minpos(1);
+        e.xm = *minpos.data(0);
+        e.ym = *minpos.data(1);
     }
 
-    CALL_CPP("update_path_extents", (update_path_extents(path, trans, e)));
+    update_path_extents(path, trans, e);
 
     changed = (e.x0 != rect.x1 || e.y0 != rect.y1 || e.x1 != rect.x2 || e.y1 != rect.y2 ||
-               e.xm != minpos(0) || e.ym != minpos(1));
-
-    npy_intp extentsdims[] = { 2, 2 };
-    numpy::array_view<double, 2> outextents(extentsdims);
-    outextents(0, 0) = e.x0;
-    outextents(0, 1) = e.y0;
-    outextents(1, 0) = e.x1;
-    outextents(1, 1) = e.y1;
-
-    npy_intp minposdims[] = { 2 };
-    numpy::array_view<double, 1> outminpos(minposdims);
-    outminpos(0) = e.xm;
-    outminpos(1) = e.ym;
-
-    return Py_BuildValue(
-        "NNi", outextents.pyobj(), outminpos.pyobj(), changed);
-}
+               e.xm != *minpos.data(0) || e.ym != *minpos.data(1));
+
+    py::ssize_t extentsdims[] = { 2, 2 };
+    py::array_t<double> outextents(extentsdims);
+    *outextents.mutable_data(0, 0) = e.x0;
+    *outextents.mutable_data(0, 1) = e.y0;
+    *outextents.mutable_data(1, 0) = e.x1;
+    *outextents.mutable_data(1, 1) = e.y1;
+
+    py::ssize_t minposdims[] = { 2 };
+    py::array_t<double> outminpos(minposdims);
+    *outminpos.mutable_data(0) = e.xm;
+    *outminpos.mutable_data(1) = e.ym;
 
-const char *Py_get_path_collection_extents__doc__ =
-    "get_path_collection_extents("
-    "master_transform, paths, transforms, offsets, offset_transform)\n"
-    "--\n\n";
+    return py::make_tuple(outextents, outminpos, changed);
+}
 
-static PyObject *Py_get_path_collection_extents(PyObject *self, PyObject *args)
+static py::tuple
+Py_get_path_collection_extents(py::object master_transform_obj, py::object paths_obj,
+                               py::object transforms_obj, py::object offsets_obj,
+                               py::object offset_trans_obj)
 {
     agg::trans_affine master_transform;
     mpl::PathGenerator paths;
@@ -187,391 +157,248 @@ static PyObject *Py_get_path_collection_extents(PyObject *self, PyObject *args)
     agg::trans_affine offset_trans;
     extent_limits e;
 
-    if (!PyArg_ParseTuple(args,
-                          "O&O&O&O&O&:get_path_collection_extents",
-                          &convert_trans_affine,
-                          &master_transform,
-                          &convert_pathgen,
-                          &paths,
-                          &convert_transforms,
-                          &transforms,
-                          &convert_points,
-                          &offsets,
-                          &convert_trans_affine,
-                          &offset_trans)) {
-        return NULL;
-    }
-
-    CALL_CPP("get_path_collection_extents",
-             (get_path_collection_extents(
-                 master_transform, paths, transforms, offsets, offset_trans, e)));
-
-    npy_intp dims[] = { 2, 2 };
-    numpy::array_view<double, 2> extents(dims);
-    extents(0, 0) = e.x0;
-    extents(0, 1) = e.y0;
-    extents(1, 0) = e.x1;
-    extents(1, 1) = e.y1;
-
-    npy_intp minposdims[] = { 2 };
-    numpy::array_view<double, 1> minpos(minposdims);
-    minpos(0) = e.xm;
-    minpos(1) = e.ym;
-
-    return Py_BuildValue("NN", extents.pyobj(), minpos.pyobj());
-}
+    convert_trans_affine(master_transform_obj, master_transform);
+    if (!convert_pathgen(paths_obj.ptr(), &paths)) {
+        throw py::error_already_set();
+    }
+    if (!convert_transforms(transforms_obj.ptr(), &transforms)) {
+        throw py::error_already_set();
+    }
+    if (!convert_points(offsets_obj.ptr(), &offsets)) {
+        throw py::error_already_set();
+    }
+    convert_trans_affine(offset_trans_obj, offset_trans);
+
+    get_path_collection_extents(
+        master_transform, paths, transforms, offsets, offset_trans, e);
 
-const char *Py_point_in_path_collection__doc__ =
-    "point_in_path_collection("
-    "x, y, radius, master_transform, paths, transforms, offsets, "
-    "offset_trans, filled)\n"
-    "--\n\n";
+    py::ssize_t dims[] = { 2, 2 };
+    py::array_t<double> extents(dims);
+    *extents.mutable_data(0, 0) = e.x0;
+    *extents.mutable_data(0, 1) = e.y0;
+    *extents.mutable_data(1, 0) = e.x1;
+    *extents.mutable_data(1, 1) = e.y1;
 
-static PyObject *Py_point_in_path_collection(PyObject *self, PyObject *args)
+    py::ssize_t minposdims[] = { 2 };
+    py::array_t<double> minpos(minposdims);
+    *minpos.mutable_data(0) = e.xm;
+    *minpos.mutable_data(1) = e.ym;
+
+    return py::make_tuple(extents, minpos);
+}
+
+static py::object
+Py_point_in_path_collection(double x, double y, double radius,
+                            py::object master_transform_obj, py::object paths_obj,
+                            py::object transforms_obj, py::object offsets_obj,
+                            py::object offset_trans_obj, bool filled)
 {
-    double x, y, radius;
     agg::trans_affine master_transform;
     mpl::PathGenerator paths;
     numpy::array_view<const double, 3> transforms;
     numpy::array_view<const double, 2> offsets;
     agg::trans_affine offset_trans;
-    bool filled;
     std::vector<int> result;
 
-    if (!PyArg_ParseTuple(args,
-                          "dddO&O&O&O&O&O&:point_in_path_collection",
-                          &x,
-                          &y,
-                          &radius,
-                          &convert_trans_affine,
-                          &master_transform,
-                          &convert_pathgen,
-                          &paths,
-                          &convert_transforms,
-                          &transforms,
-                          &convert_points,
-                          &offsets,
-                          &convert_trans_affine,
-                          &offset_trans,
-                          &convert_bool,
-                          &filled)) {
-        return NULL;
-    }
-
-    CALL_CPP("point_in_path_collection",
-             (point_in_path_collection(x,
-                                       y,
-                                       radius,
-                                       master_transform,
-                                       paths,
-                                       transforms,
-                                       offsets,
-                                       offset_trans,
-                                       filled,
-                                       result)));
-
-    npy_intp dims[] = {(npy_intp)result.size() };
-    numpy::array_view<int, 1> pyresult(dims);
-    if (result.size() > 0) {
-        memcpy(pyresult.data(), &result[0], result.size() * sizeof(int));
-    }
-    return pyresult.pyobj();
-}
+    convert_trans_affine(master_transform_obj, master_transform);
+    if (!convert_pathgen(paths_obj.ptr(), &paths)) {
+        throw py::error_already_set();
+    }
+    if (!convert_transforms(transforms_obj.ptr(), &transforms)) {
+        throw py::error_already_set();
+    }
+    if (!convert_points(offsets_obj.ptr(), &offsets)) {
+        throw py::error_already_set();
+    }
+    convert_trans_affine(offset_trans_obj, offset_trans);
 
-const char *Py_path_in_path__doc__ =
-    "path_in_path(path_a, trans_a, path_b, trans_b)\n"
-    "--\n\n";
+    point_in_path_collection(x, y, radius, master_transform, paths, transforms, offsets,
+                             offset_trans, filled, result);
 
-static PyObject *Py_path_in_path(PyObject *self, PyObject *args)
+    py::ssize_t dims[] = { static_cast<py::ssize_t>(result.size()) };
+    return py::array(dims, result.data());
+}
+
+static bool
+Py_path_in_path(py::object a_obj, py::object atrans_obj,
+                py::object b_obj, py::object btrans_obj)
 {
     mpl::PathIterator a;
     agg::trans_affine atrans;
     mpl::PathIterator b;
     agg::trans_affine btrans;
-    bool result;
 
-    if (!PyArg_ParseTuple(args,
-                          "O&O&O&O&:path_in_path",
-                          &convert_path,
-                          &a,
-                          &convert_trans_affine,
-                          &atrans,
-                          &convert_path,
-                          &b,
-                          &convert_trans_affine,
-                          &btrans)) {
-        return NULL;
+    if (!convert_path(a_obj.ptr(), &a)) {
+        throw py::error_already_set();
     }
-
-    CALL_CPP("path_in_path", (result = path_in_path(a, atrans, b, btrans)));
-
-    if (result) {
-        Py_RETURN_TRUE;
-    } else {
-        Py_RETURN_FALSE;
+    convert_trans_affine(atrans_obj, atrans);
+    if (!convert_path(b_obj.ptr(), &b)) {
+        throw py::error_already_set();
     }
-}
+    convert_trans_affine(btrans_obj, btrans);
 
-const char *Py_clip_path_to_rect__doc__ =
-    "clip_path_to_rect(path, rect, inside)\n"
-    "--\n\n";
+    return path_in_path(a, atrans, b, btrans);
+}
 
-static PyObject *Py_clip_path_to_rect(PyObject *self, PyObject *args)
+static py::list
+Py_clip_path_to_rect(py::object path_obj, py::object rect_obj,
+                     bool inside)
 {
     mpl::PathIterator path;
     agg::rect_d rect;
-    bool inside;
     std::vector<Polygon> result;
 
-    if (!PyArg_ParseTuple(args,
-                          "O&O&O&:clip_path_to_rect",
-                          &convert_path,
-                          &path,
-                          &convert_rect,
-                          &rect,
-                          &convert_bool,
-                          &inside)) {
-        return NULL;
+    if (!convert_path(path_obj.ptr(), &path)) {
+        throw py::error_already_set();
+    }
+    if (!convert_rect(rect_obj.ptr(), &rect)) {
+        throw py::error_already_set();
     }
 
-    CALL_CPP("clip_path_to_rect", (clip_path_to_rect(path, rect, inside, result)));
+    clip_path_to_rect(path, rect, inside, result);
 
     return convert_polygon_vector(result);
 }
 
-const char *Py_affine_transform__doc__ =
-    "affine_transform(points, trans)\n"
-    "--\n\n";
-
-static PyObject *Py_affine_transform(PyObject *self, PyObject *args)
+static py::object
+Py_affine_transform(py::array_t<double, py::array::c_style | py::array::forcecast> vertices_arr,
+                    py::object trans_obj)
 {
-    PyObject *vertices_obj;
     agg::trans_affine trans;
 
-    if (!PyArg_ParseTuple(args,
-                          "OO&:affine_transform",
-                          &vertices_obj,
-                          &convert_trans_affine,
-                          &trans)) {
-        return NULL;
-    }
-
-    PyArrayObject* vertices_arr = (PyArrayObject *)PyArray_ContiguousFromAny(vertices_obj, NPY_DOUBLE, 1, 2);
-    if (vertices_arr == NULL) {
-        return NULL;
-    }
+    convert_trans_affine(trans_obj, trans);
 
-    if (PyArray_NDIM(vertices_arr) == 2) {
-        numpy::array_view<double, 2> vertices(vertices_arr);
-        Py_DECREF(vertices_arr);
+    if (vertices_arr.ndim() == 2) {
+        auto vertices = vertices_arr.unchecked<2>();
 
         if(!check_trailing_shape(vertices, "vertices", 2)) {
-            return NULL;
+            throw py::error_already_set();
         }
 
-        npy_intp dims[] = { (npy_intp)vertices.shape(0), 2 };
-        numpy::array_view<double, 2> result(dims);
-        CALL_CPP("affine_transform", (affine_transform_2d(vertices, trans, result)));
-        return result.pyobj();
-    } else { // PyArray_NDIM(vertices_arr) == 1
-        numpy::array_view<double, 1> vertices(vertices_arr);
-        Py_DECREF(vertices_arr);
+        py::ssize_t dims[] = { vertices.shape(0), 2 };
+        py::array_t<double> result(dims);
+        auto result_mutable = result.mutable_unchecked<2>();
+
+        affine_transform_2d(vertices, trans, result_mutable);
+        return result;
+    } else if (vertices_arr.ndim() == 1) {
+        auto vertices = vertices_arr.unchecked<1>();
 
-        npy_intp dims[] = { (npy_intp)vertices.shape(0) };
-        numpy::array_view<double, 1> result(dims);
-        CALL_CPP("affine_transform", (affine_transform_1d(vertices, trans, result)));
-        return result.pyobj();
+        py::ssize_t dims[] = { vertices.shape(0) };
+        py::array_t<double> result(dims);
+        auto result_mutable = result.mutable_unchecked<1>();
+
+        affine_transform_1d(vertices, trans, result_mutable);
+        return result;
+    } else {
+        throw py::value_error(
+            "vertices must be 1D or 2D, not" + std::to_string(vertices_arr.ndim()) + "D");
     }
 }
 
-const char *Py_count_bboxes_overlapping_bbox__doc__ =
-    "count_bboxes_overlapping_bbox(bbox, bboxes)\n"
-    "--\n\n";
-
-static PyObject *Py_count_bboxes_overlapping_bbox(PyObject *self, PyObject *args)
+static int
+Py_count_bboxes_overlapping_bbox(py::object bbox_obj, py::object bboxes_obj)
 {
     agg::rect_d bbox;
     numpy::array_view<const double, 3> bboxes;
-    int result;
 
-    if (!PyArg_ParseTuple(args,
-                          "O&O&:count_bboxes_overlapping_bbox",
-                          &convert_rect,
-                          &bbox,
-                          &convert_bboxes,
-                          &bboxes)) {
-        return NULL;
+    if (!convert_rect(bbox_obj.ptr(), &bbox)) {
+        throw py::error_already_set();
+    }
+    if (!convert_bboxes(bboxes_obj.ptr(), &bboxes)) {
+        throw py::error_already_set();
     }
 
-    CALL_CPP("count_bboxes_overlapping_bbox",
-             (result = count_bboxes_overlapping_bbox(bbox, bboxes)));
-
-    return PyLong_FromLong(result);
+    return count_bboxes_overlapping_bbox(bbox, bboxes);
 }
 
-const char *Py_path_intersects_path__doc__ =
-    "path_intersects_path(path1, path2, filled=False)\n"
-    "--\n\n";
-
-static PyObject *Py_path_intersects_path(PyObject *self, PyObject *args, PyObject *kwds)
+static bool
+Py_path_intersects_path(py::object p1_obj, py::object p2_obj, bool filled)
 {
     mpl::PathIterator p1;
     mpl::PathIterator p2;
     agg::trans_affine t1;
     agg::trans_affine t2;
-    int filled = 0;
-    const char *names[] = { "p1", "p2", "filled", NULL };
     bool result;
 
-    if (!PyArg_ParseTupleAndKeywords(args,
-                                     kwds,
-                                     "O&O&i:path_intersects_path",
-                                     (char **)names,
-                                     &convert_path,
-                                     &p1,
-                                     &convert_path,
-                                     &p2,
-                                     &filled)) {
-        return NULL;
+    if (!convert_path(p1_obj.ptr(), &p1)) {
+        throw py::error_already_set();
+    }
+    if (!convert_path(p2_obj.ptr(), &p2)) {
+        throw py::error_already_set();
     }
 
-    CALL_CPP("path_intersects_path", (result = path_intersects_path(p1, p2)));
+    result = path_intersects_path(p1, p2);
     if (filled) {
         if (!result) {
-            CALL_CPP("path_intersects_path",
-                     (result = path_in_path(p1, t1, p2, t2)));
+            result = path_in_path(p1, t1, p2, t2);
         }
         if (!result) {
-            CALL_CPP("path_intersects_path",
-                     (result = path_in_path(p2, t1, p1, t2)));
+            result = path_in_path(p2, t1, p1, t2);
         }
     }
 
-    if (result) {
-        Py_RETURN_TRUE;
-    } else {
-        Py_RETURN_FALSE;
-    }
+    return result;
 }
 
-const char *Py_path_intersects_rectangle__doc__ =
-    "path_intersects_rectangle("
-    "path, rect_x1, rect_y1, rect_x2, rect_y2, filled=False)\n"
-    "--\n\n";
-
-static PyObject *Py_path_intersects_rectangle(PyObject *self, PyObject *args, PyObject *kwds)
+static bool
+Py_path_intersects_rectangle(py::object path_obj, double rect_x1, double rect_y1,
+                             double rect_x2, double rect_y2, bool filled)
 {
     mpl::PathIterator path;
-    double rect_x1, rect_y1, rect_x2, rect_y2;
-    bool filled = false;
-    const char *names[] = { "path", "rect_x1", "rect_y1", "rect_x2", "rect_y2", "filled", NULL };
-    bool result;
 
-    if (!PyArg_ParseTupleAndKeywords(args,
-                                     kwds,
-                                     "O&dddd|O&:path_intersects_rectangle",
-                                     (char **)names,
-                                     &convert_path,
-                                     &path,
-                                     &rect_x1,
-                                     &rect_y1,
-                                     &rect_x2,
-                                     &rect_y2,
-                                     &convert_bool,
-                                     &filled)) {
-        return NULL;
-    }
-
-    CALL_CPP("path_intersects_rectangle", (result = path_intersects_rectangle(path, rect_x1, rect_y1, rect_x2, rect_y2, filled)));
-
-    if (result) {
-        Py_RETURN_TRUE;
-    } else {
-        Py_RETURN_FALSE;
+    if (!convert_path(path_obj.ptr(), &path)) {
+        throw py::error_already_set();
     }
-}
 
-const char *Py_convert_path_to_polygons__doc__ =
-    "convert_path_to_polygons(path, trans, width=0, height=0)\n"
-    "--\n\n";
+    return path_intersects_rectangle(path, rect_x1, rect_y1, rect_x2, rect_y2, filled);
+}
 
-static PyObject *Py_convert_path_to_polygons(PyObject *self, PyObject *args, PyObject *kwds)
+static py::list
+Py_convert_path_to_polygons(py::object path_obj, py::object trans_obj,
+                            double width, double height, bool closed_only)
 {
     mpl::PathIterator path;
     agg::trans_affine trans;
-    double width = 0.0, height = 0.0;
-    int closed_only = 1;
     std::vector<Polygon> result;
-    const char *names[] = { "path", "transform", "width", "height", "closed_only", NULL };
 
-    if (!PyArg_ParseTupleAndKeywords(args,
-                                     kwds,
-                                     "O&O&|ddi:convert_path_to_polygons",
-                                     (char **)names,
-                                     &convert_path,
-                                     &path,
-                                     &convert_trans_affine,
-                                     &trans,
-                                     &width,
-                                     &height,
-                                     &closed_only)) {
-        return NULL;
+    if (!convert_path(path_obj.ptr(), &path)) {
+        throw py::error_already_set();
     }
+    convert_trans_affine(trans_obj, trans);
 
-    CALL_CPP("convert_path_to_polygons",
-             (convert_path_to_polygons(path, trans, width, height, closed_only, result)));
+    convert_path_to_polygons(path, trans, width, height, closed_only, result);
 
     return convert_polygon_vector(result);
 }
 
-const char *Py_cleanup_path__doc__ =
-    "cleanup_path("
-    "path, trans, remove_nans, clip_rect, snap_mode, stroke_width, simplify, "
-    "return_curves, sketch)\n"
-    "--\n\n";
-
-static PyObject *Py_cleanup_path(PyObject *self, PyObject *args)
+static py::tuple
+Py_cleanup_path(py::object path_obj, py::object trans_obj, bool remove_nans,
+                py::object clip_rect_obj, py::object snap_mode_obj, double stroke_width,
+                std::optional<bool> simplify, bool return_curves, py::object sketch_obj)
 {
     mpl::PathIterator path;
     agg::trans_affine trans;
-    bool remove_nans;
     agg::rect_d clip_rect;
     e_snap_mode snap_mode;
-    double stroke_width;
-    PyObject *simplifyobj;
-    bool simplify = false;
-    bool return_curves;
     SketchParams sketch;
 
-    if (!PyArg_ParseTuple(args,
-                          "O&O&O&O&O&dOO&O&:cleanup_path",
-                          &convert_path,
-                          &path,
-                          &convert_trans_affine,
-                          &trans,
-                          &convert_bool,
-                          &remove_nans,
-                          &convert_rect,
-                          &clip_rect,
-                          &convert_snap,
-                          &snap_mode,
-                          &stroke_width,
-                          &simplifyobj,
-                          &convert_bool,
-                          &return_curves,
-                          &convert_sketch_params,
-                          &sketch)) {
-        return NULL;
-    }
-
-    if (simplifyobj == Py_None) {
+    if (!convert_path(path_obj.ptr(), &path)) {
+        throw py::error_already_set();
+    }
+    convert_trans_affine(trans_obj, trans);
+    if (!convert_rect(clip_rect_obj.ptr(), &clip_rect)) {
+        throw py::error_already_set();
+    }
+    if (!convert_snap(snap_mode_obj.ptr(), &snap_mode)) {
+        throw py::error_already_set();
+    }
+    if (!convert_sketch_params(sketch_obj.ptr(), &sketch)) {
+        throw py::error_already_set();
+    }
+
+    if (!simplify.has_value()) {
         simplify = path.should_simplify();
-    } else {
-        switch (PyObject_IsTrue(simplifyobj)) {
-            case 0: simplify = false; break;
-            case 1: simplify = true; break;
-            default: return NULL;  // errored.
-        }
     }
 
     bool do_clip = (clip_rect.x1 < clip_rect.x2 && clip_rect.y1 < clip_rect.y2);
@@ -579,139 +406,106 @@ static PyObject *Py_cleanup_path(PyObject *self, PyObject *args)
     std::vector<double> vertices;
     std::vector<npy_uint8> codes;
 
-    CALL_CPP("cleanup_path",
-             (cleanup_path(path,
-                           trans,
-                           remove_nans,
-                           do_clip,
-                           clip_rect,
-                           snap_mode,
-                           stroke_width,
-                           simplify,
-                           return_curves,
-                           sketch,
-                           vertices,
-                           codes)));
-
-    size_t length = codes.size();
+    cleanup_path(path, trans, remove_nans, do_clip, clip_rect, snap_mode, stroke_width,
+                 simplify.value(), return_curves, sketch, vertices, codes);
 
-    npy_intp vertices_dims[] = {(npy_intp)length, 2 };
-    numpy::array_view<double, 2> pyvertices(vertices_dims);
+    auto length = static_cast<py::ssize_t>(codes.size());
 
-    npy_intp codes_dims[] = {(npy_intp)length };
-    numpy::array_view<unsigned char, 1> pycodes(codes_dims);
+    py::ssize_t vertices_dims[] = { length, 2 };
+    py::array pyvertices(vertices_dims, vertices.data());
 
-    memcpy(pyvertices.data(), &vertices[0], sizeof(double) * 2 * length);
-    memcpy(pycodes.data(), &codes[0], sizeof(unsigned char) * length);
+    py::ssize_t codes_dims[] = { length };
+    py::array pycodes(codes_dims, codes.data());
 
-    return Py_BuildValue("NN", pyvertices.pyobj(), pycodes.pyobj());
+    return py::make_tuple(pyvertices, pycodes);
 }
 
 const char *Py_convert_to_string__doc__ =
-    "convert_to_string("
-    "path, trans, clip_rect, simplify, sketch, precision, codes, postfix)\n"
-    "--\n\n"
-    "Convert *path* to a bytestring.\n"
-    "\n"
-    "The first five parameters (up to *sketch*) are interpreted as in\n"
-    "`.cleanup_path`.  The following ones are detailed below.\n"
-    "\n"
-    "Parameters\n"
-    "----------\n"
-    "path : Path\n"
-    "trans : Transform or None\n"
-    "clip_rect : sequence of 4 floats, or None\n"
-    "simplify : bool\n"
-    "sketch : tuple of 3 floats, or None\n"
-    "precision : int\n"
-    "    The precision used to \"%.*f\"-format the values.  Trailing zeros\n"
-    "    and decimal points are always removed.  (precision=-1 is a special\n"
-    "    case used to implement ttconv-back-compatible conversion.)\n"
-    "codes : sequence of 5 bytestrings\n"
-    "    The bytes representation of each opcode (MOVETO, LINETO, CURVE3,\n"
-    "    CURVE4, CLOSEPOLY), in that order.  If the bytes for CURVE3 is\n"
-    "    empty, quad segments are automatically converted to cubic ones\n"
-    "    (this is used by backends such as pdf and ps, which do not support\n"
-    "    quads).\n"
-    "postfix : bool\n"
-    "    Whether the opcode comes after the values (True) or before (False).\n"
-    ;
-
-static PyObject *Py_convert_to_string(PyObject *self, PyObject *args)
+R"""(--
+
+Convert *path* to a bytestring.
+
+The first five parameters (up to *sketch*) are interpreted as in `.cleanup_path`. The
+following ones are detailed below.
+
+Parameters
+----------
+path : Path
+trans : Transform or None
+clip_rect : sequence of 4 floats, or None
+simplify : bool
+sketch : tuple of 3 floats, or None
+precision : int
+    The precision used to "%.*f"-format the values. Trailing zeros and decimal points
+    are always removed. (precision=-1 is a special case used to implement
+    ttconv-back-compatible conversion.)
+codes : sequence of 5 bytestrings
+    The bytes representation of each opcode (MOVETO, LINETO, CURVE3, CURVE4, CLOSEPOLY),
+    in that order. If the bytes for CURVE3 is empty, quad segments are automatically
+    converted to cubic ones (this is used by backends such as pdf and ps, which do not
+    support quads).
+postfix : bool
+    Whether the opcode comes after the values (True) or before (False).
+)""";
+
+static py::object
+Py_convert_to_string(py::object path_obj, py::object trans_obj, py::object cliprect_obj,
+                     std::optional<bool> simplify, py::object sketch_obj, int precision,
+                     std::array<std::string, 5> codes_obj, bool postfix)
 {
     mpl::PathIterator path;
     agg::trans_affine trans;
     agg::rect_d cliprect;
-    PyObject *simplifyobj;
-    bool simplify = false;
     SketchParams sketch;
-    int precision;
     char *codes[5];
-    bool postfix;
     std::string buffer;
     bool status;
 
-    if (!PyArg_ParseTuple(args,
-                          "O&O&O&OO&i(yyyyy)O&:convert_to_string",
-                          &convert_path,
-                          &path,
-                          &convert_trans_affine,
-                          &trans,
-                          &convert_rect,
-                          &cliprect,
-                          &simplifyobj,
-                          &convert_sketch_params,
-                          &sketch,
-                          &precision,
-                          &codes[0],
-                          &codes[1],
-                          &codes[2],
-                          &codes[3],
-                          &codes[4],
-                          &convert_bool,
-                          &postfix)) {
-        return NULL;
-    }
-
-    if (simplifyobj == Py_None) {
+    if (!convert_path(path_obj.ptr(), &path)) {
+        throw py::error_already_set();
+    }
+    convert_trans_affine(trans_obj, trans);
+    if (!convert_rect(cliprect_obj.ptr(), &cliprect)) {
+        throw py::error_already_set();
+    }
+    if (!convert_sketch_params(sketch_obj.ptr(), &sketch)) {
+        throw py::error_already_set();
+    }
+
+    for (auto i = 0; i < 5; ++i) {
+        codes[i] = const_cast<char *>(codes_obj[i].c_str());
+    }
+
+    if (!simplify.has_value()) {
         simplify = path.should_simplify();
-    } else {
-        switch (PyObject_IsTrue(simplifyobj)) {
-            case 0: simplify = false; break;
-            case 1: simplify = true; break;
-            default: return NULL;  // errored.
-        }
     }
 
-    CALL_CPP("convert_to_string",
-             (status = convert_to_string(
-                 path, trans, cliprect, simplify, sketch,
-                 precision, codes, postfix, buffer)));
+    status = convert_to_string(path, trans, cliprect, simplify.value(), sketch,
+                               precision, codes, postfix, buffer);
 
     if (!status) {
-        PyErr_SetString(PyExc_ValueError, "Malformed path codes");
-        return NULL;
+        throw py::value_error("Malformed path codes");
     }
 
-    return PyBytes_FromStringAndSize(buffer.c_str(), buffer.size());
+    return py::bytes(buffer);
 }
 
-
 const char *Py_is_sorted_and_has_non_nan__doc__ =
-    "is_sorted_and_has_non_nan(array, /)\n"
-    "--\n\n"
-    "Return whether the 1D *array* is monotonically increasing, ignoring NaNs,\n"
-    "and has at least one non-nan value.";
+R"""(--
+
+Return whether the 1D *array* is monotonically increasing, ignoring NaNs, and has at
+least one non-nan value.)""";
 
-static PyObject *Py_is_sorted_and_has_non_nan(PyObject *self, PyObject *obj)
+static bool
+Py_is_sorted_and_has_non_nan(py::object obj)
 {
     bool result;
 
     PyArrayObject *array = (PyArrayObject *)PyArray_CheckFromAny(
-        obj, NULL, 1, 1, NPY_ARRAY_NOTSWAPPED, NULL);
+        obj.ptr(), NULL, 1, 1, NPY_ARRAY_NOTSWAPPED, NULL);
 
     if (array == NULL) {
-        return NULL;
+        throw py::error_already_set();
     }
 
     /* Handle just the most common types here, otherwise coerce to double */
@@ -733,48 +527,64 @@ static PyObject *Py_is_sorted_and_has_non_nan(PyObject *self, PyObject *obj)
         break;
     default:
         Py_DECREF(array);
-        array = (PyArrayObject *)PyArray_FromObject(obj, NPY_DOUBLE, 1, 1);
+        array = (PyArrayObject *)PyArray_FromObject(obj.ptr(), NPY_DOUBLE, 1, 1);
         if (array == NULL) {
-            return NULL;
+            throw py::error_already_set();
         }
         result = is_sorted_and_has_non_nan<npy_double>(array);
     }
 
     Py_DECREF(array);
 
-    if (result) {
-        Py_RETURN_TRUE;
-    } else {
-        Py_RETURN_FALSE;
-    }
+    return result;
 }
 
-
-static PyMethodDef module_functions[] = {
-    {"point_in_path", (PyCFunction)Py_point_in_path, METH_VARARGS, Py_point_in_path__doc__},
-    {"points_in_path", (PyCFunction)Py_points_in_path, METH_VARARGS, Py_points_in_path__doc__},
-    {"update_path_extents", (PyCFunction)Py_update_path_extents, METH_VARARGS, Py_update_path_extents__doc__},
-    {"get_path_collection_extents", (PyCFunction)Py_get_path_collection_extents, METH_VARARGS, Py_get_path_collection_extents__doc__},
-    {"point_in_path_collection", (PyCFunction)Py_point_in_path_collection, METH_VARARGS, Py_point_in_path_collection__doc__},
-    {"path_in_path", (PyCFunction)Py_path_in_path, METH_VARARGS, Py_path_in_path__doc__},
-    {"clip_path_to_rect", (PyCFunction)Py_clip_path_to_rect, METH_VARARGS, Py_clip_path_to_rect__doc__},
-    {"affine_transform", (PyCFunction)Py_affine_transform, METH_VARARGS, Py_affine_transform__doc__},
-    {"count_bboxes_overlapping_bbox", (PyCFunction)Py_count_bboxes_overlapping_bbox, METH_VARARGS, Py_count_bboxes_overlapping_bbox__doc__},
-    {"path_intersects_path", (PyCFunction)Py_path_intersects_path, METH_VARARGS|METH_KEYWORDS, Py_path_intersects_path__doc__},
-    {"path_intersects_rectangle", (PyCFunction)Py_path_intersects_rectangle, METH_VARARGS|METH_KEYWORDS, Py_path_intersects_rectangle__doc__},
-    {"convert_path_to_polygons", (PyCFunction)Py_convert_path_to_polygons, METH_VARARGS|METH_KEYWORDS, Py_convert_path_to_polygons__doc__},
-    {"cleanup_path", (PyCFunction)Py_cleanup_path, METH_VARARGS, Py_cleanup_path__doc__},
-    {"convert_to_string", (PyCFunction)Py_convert_to_string, METH_VARARGS, Py_convert_to_string__doc__},
-    {"is_sorted_and_has_non_nan", (PyCFunction)Py_is_sorted_and_has_non_nan, METH_O, Py_is_sorted_and_has_non_nan__doc__},
-    {NULL}
-};
-
-static struct PyModuleDef moduledef = {
-    PyModuleDef_HEAD_INIT, "_path", NULL, 0, module_functions
-};
-
-PyMODINIT_FUNC PyInit__path(void)
+PYBIND11_MODULE(_path, m)
 {
-    import_array();
-    return PyModule_Create(&moduledef);
+    auto ia = [m]() -> const void* {
+        import_array();
+        return &m;
+    };
+    if (ia() == NULL) {
+        throw py::error_already_set();
+    }
+
+    m.def("point_in_path", &Py_point_in_path,
+          "x"_a, "y"_a, "radius"_a, "path"_a, "trans"_a);
+    m.def("points_in_path", &Py_points_in_path,
+          "points"_a, "radius"_a, "path"_a, "trans"_a);
+    m.def("update_path_extents", &Py_update_path_extents,
+          "path"_a, "trans"_a, "rect"_a, "minpos"_a, "ignore"_a);
+    m.def("get_path_collection_extents", &Py_get_path_collection_extents,
+          "master_transform"_a, "paths"_a, "transforms"_a, "offsets"_a,
+          "offset_transform"_a);
+    m.def("point_in_path_collection", &Py_point_in_path_collection,
+          "x"_a, "y"_a, "radius"_a, "master_transform"_a, "paths"_a, "transforms"_a,
+          "offsets"_a, "offset_trans"_a, "filled"_a);
+    m.def("path_in_path", &Py_path_in_path,
+          "path_a"_a, "trans_a"_a, "path_b"_a, "trans_b"_a);
+    m.def("clip_path_to_rect", &Py_clip_path_to_rect,
+          "path"_a, "rect"_a, "inside"_a);
+    m.def("affine_transform", &Py_affine_transform,
+          "points"_a, "trans"_a);
+    m.def("count_bboxes_overlapping_bbox", &Py_count_bboxes_overlapping_bbox,
+          "bbox"_a, "bboxes"_a);
+    m.def("path_intersects_path", &Py_path_intersects_path,
+          "path1"_a, "path2"_a, "filled"_a = false);
+    m.def("path_intersects_rectangle", &Py_path_intersects_rectangle,
+          "path"_a, "rect_x1"_a, "rect_y1"_a, "rect_x2"_a, "rect_y2"_a,
+          "filled"_a = false);
+    m.def("convert_path_to_polygons", &Py_convert_path_to_polygons,
+          "path"_a, "trans"_a, "width"_a = 0.0, "height"_a = 0.0,
+          "closed_only"_a = false);
+    m.def("cleanup_path", &Py_cleanup_path,
+          "path"_a, "trans"_a, "remove_nans"_a, "clip_rect"_a, "snap_mode"_a,
+          "stroke_width"_a, "simplify"_a, "return_curves"_a, "sketch"_a);
+    m.def("convert_to_string", &Py_convert_to_string,
+          "path"_a, "trans"_a, "clip_rect"_a, "simplify"_a, "sketch"_a, "precision"_a,
+          "codes"_a, "postfix"_a,
+          Py_convert_to_string__doc__);
+    m.def("is_sorted_and_has_non_nan", &Py_is_sorted_and_has_non_nan,
+          "array"_a,
+          Py_is_sorted_and_has_non_nan__doc__);
 }
diff --git a/src/meson.build b/src/meson.build
index d83dab0ffc28..bbef93c13d92 100644
--- a/src/meson.build
+++ b/src/meson.build
@@ -118,9 +118,10 @@ extension_data = {
     'subdir': 'matplotlib',
     'sources': files(
       'py_converters.cpp',
+      'py_converters_11.cpp',
       '_path_wrapper.cpp',
     ),
-    'dependencies': [numpy_dep, agg_dep],
+    'dependencies': [numpy_dep, agg_dep, pybind11_dep],
   },
   '_qhull': {
     'subdir': 'matplotlib',

From 25fbbd3527be8d65ea429246c27fee6f0db8606b Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 11 Oct 2023 07:54:02 -0400
Subject: [PATCH 0813/1120] Add a pybind11 type caster for agg::rect_d

---
 src/_path_wrapper.cpp  | 31 +++++----------------------
 src/py_converters_11.h | 48 +++++++++++++++++++++++++++++++++++++++++-
 2 files changed, 52 insertions(+), 27 deletions(-)

diff --git a/src/_path_wrapper.cpp b/src/_path_wrapper.cpp
index bc2314952e56..851b9129934e 100644
--- a/src/_path_wrapper.cpp
+++ b/src/_path_wrapper.cpp
@@ -77,21 +77,17 @@ Py_points_in_path(py::array_t<double> points_obj, double r, py::object path_obj,
 }
 
 static py::tuple
-Py_update_path_extents(py::object path_obj, py::object trans_obj, py::object rect_obj,
+Py_update_path_extents(py::object path_obj, py::object trans_obj, agg::rect_d rect,
                        py::array_t<double> minpos, bool ignore)
 {
     mpl::PathIterator path;
     agg::trans_affine trans;
-    agg::rect_d rect;
     bool changed;
 
     if (!convert_path(path_obj.ptr(), &path)) {
         throw py::error_already_set();
     }
     convert_trans_affine(trans_obj, trans);
-    if (!convert_rect(rect_obj.ptr(), &rect)) {
-        throw py::error_already_set();
-    }
 
     if (minpos.ndim() != 1) {
         throw py::value_error(
@@ -241,19 +237,14 @@ Py_path_in_path(py::object a_obj, py::object atrans_obj,
 }
 
 static py::list
-Py_clip_path_to_rect(py::object path_obj, py::object rect_obj,
-                     bool inside)
+Py_clip_path_to_rect(py::object path_obj, agg::rect_d rect, bool inside)
 {
     mpl::PathIterator path;
-    agg::rect_d rect;
     std::vector<Polygon> result;
 
     if (!convert_path(path_obj.ptr(), &path)) {
         throw py::error_already_set();
     }
-    if (!convert_rect(rect_obj.ptr(), &rect)) {
-        throw py::error_already_set();
-    }
 
     clip_path_to_rect(path, rect, inside, result);
 
@@ -297,14 +288,10 @@ Py_affine_transform(py::array_t<double, py::array::c_style | py::array::forcecas
 }
 
 static int
-Py_count_bboxes_overlapping_bbox(py::object bbox_obj, py::object bboxes_obj)
+Py_count_bboxes_overlapping_bbox(agg::rect_d bbox, py::object bboxes_obj)
 {
-    agg::rect_d bbox;
     numpy::array_view<const double, 3> bboxes;
 
-    if (!convert_rect(bbox_obj.ptr(), &bbox)) {
-        throw py::error_already_set();
-    }
     if (!convert_bboxes(bboxes_obj.ptr(), &bboxes)) {
         throw py::error_already_set();
     }
@@ -374,12 +361,11 @@ Py_convert_path_to_polygons(py::object path_obj, py::object trans_obj,
 
 static py::tuple
 Py_cleanup_path(py::object path_obj, py::object trans_obj, bool remove_nans,
-                py::object clip_rect_obj, py::object snap_mode_obj, double stroke_width,
+                agg::rect_d clip_rect, py::object snap_mode_obj, double stroke_width,
                 std::optional<bool> simplify, bool return_curves, py::object sketch_obj)
 {
     mpl::PathIterator path;
     agg::trans_affine trans;
-    agg::rect_d clip_rect;
     e_snap_mode snap_mode;
     SketchParams sketch;
 
@@ -387,9 +373,6 @@ Py_cleanup_path(py::object path_obj, py::object trans_obj, bool remove_nans,
         throw py::error_already_set();
     }
     convert_trans_affine(trans_obj, trans);
-    if (!convert_rect(clip_rect_obj.ptr(), &clip_rect)) {
-        throw py::error_already_set();
-    }
     if (!convert_snap(snap_mode_obj.ptr(), &snap_mode)) {
         throw py::error_already_set();
     }
@@ -449,13 +432,12 @@ postfix : bool
 )""";
 
 static py::object
-Py_convert_to_string(py::object path_obj, py::object trans_obj, py::object cliprect_obj,
+Py_convert_to_string(py::object path_obj, py::object trans_obj, agg::rect_d cliprect,
                      std::optional<bool> simplify, py::object sketch_obj, int precision,
                      std::array<std::string, 5> codes_obj, bool postfix)
 {
     mpl::PathIterator path;
     agg::trans_affine trans;
-    agg::rect_d cliprect;
     SketchParams sketch;
     char *codes[5];
     std::string buffer;
@@ -465,9 +447,6 @@ Py_convert_to_string(py::object path_obj, py::object trans_obj, py::object clipr
         throw py::error_already_set();
     }
     convert_trans_affine(trans_obj, trans);
-    if (!convert_rect(cliprect_obj.ptr(), &cliprect)) {
-        throw py::error_already_set();
-    }
     if (!convert_sketch_params(sketch_obj.ptr(), &sketch)) {
         throw py::error_already_set();
     }
diff --git a/src/py_converters_11.h b/src/py_converters_11.h
index 9af617d3ee8b..b86955d29055 100644
--- a/src/py_converters_11.h
+++ b/src/py_converters_11.h
@@ -8,8 +8,54 @@
 
 namespace py = pybind11;
 
+#include "agg_basics.h"
 #include "agg_trans_affine.h"
 
 void convert_trans_affine(const py::object& transform, agg::trans_affine& affine);
 
-#endif
+namespace PYBIND11_NAMESPACE { namespace detail {
+    template <> struct type_caster<agg::rect_d> {
+    public:
+        PYBIND11_TYPE_CASTER(agg::rect_d, const_name("rect_d"));
+
+        bool load(handle src, bool) {
+            if (src.is_none()) {
+                value.x1 = 0.0;
+                value.y1 = 0.0;
+                value.x2 = 0.0;
+                value.y2 = 0.0;
+                return true;
+            }
+
+            auto rect_arr = py::array_t<double>::ensure(src);
+
+            if (rect_arr.ndim() == 2) {
+                if (rect_arr.shape(0) != 2 || rect_arr.shape(1) != 2) {
+                    throw py::value_error("Invalid bounding box");
+                }
+
+                value.x1 = *rect_arr.data(0, 0);
+                value.y1 = *rect_arr.data(0, 1);
+                value.x2 = *rect_arr.data(1, 0);
+                value.y2 = *rect_arr.data(1, 1);
+
+            } else if (rect_arr.ndim() == 1) {
+                if (rect_arr.shape(0) != 4) {
+                    throw py::value_error("Invalid bounding box");
+                }
+
+                value.x1 = *rect_arr.data(0);
+                value.y1 = *rect_arr.data(1);
+                value.x2 = *rect_arr.data(2);
+                value.y2 = *rect_arr.data(3);
+
+            } else {
+                throw py::value_error("Invalid bounding box");
+            }
+
+            return true;
+        }
+    };
+}} // namespace PYBIND11_NAMESPACE::detail
+
+#endif /* MPL_PY_CONVERTERS_11_H */

From 4a56e5223d6c30ac9aabc7e931d7da13a4fd0a73 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 11 Oct 2023 17:34:55 -0400
Subject: [PATCH 0814/1120] Add a pybind11 type caster for agg::trans_affine

---
 src/_path_wrapper.cpp  | 56 +++++++++++-------------------------------
 src/py_converters_11.h | 28 +++++++++++++++++++++
 2 files changed, 42 insertions(+), 42 deletions(-)

diff --git a/src/_path_wrapper.cpp b/src/_path_wrapper.cpp
index 851b9129934e..1381cf34f016 100644
--- a/src/_path_wrapper.cpp
+++ b/src/_path_wrapper.cpp
@@ -34,26 +34,23 @@ convert_polygon_vector(std::vector<Polygon> &polygons)
 
 static bool
 Py_point_in_path(double x, double y, double r, py::object path_obj,
-                 py::object trans_obj)
+                 agg::trans_affine trans)
 {
     mpl::PathIterator path;
-    agg::trans_affine trans;
 
     if (!convert_path(path_obj.ptr(), &path)) {
         throw py::error_already_set();
     }
-    convert_trans_affine(trans_obj, trans);
 
     return point_in_path(x, y, r, path, trans);
 }
 
 static py::array_t<double>
 Py_points_in_path(py::array_t<double> points_obj, double r, py::object path_obj,
-                  py::object trans_obj)
+                  agg::trans_affine trans)
 {
     numpy::array_view<double, 2> points;
     mpl::PathIterator path;
-    agg::trans_affine trans;
 
     if (!convert_points(points_obj.ptr(), &points)) {
         throw py::error_already_set();
@@ -61,7 +58,6 @@ Py_points_in_path(py::array_t<double> points_obj, double r, py::object path_obj,
     if (!convert_path(path_obj.ptr(), &path)) {
         throw py::error_already_set();
     }
-    convert_trans_affine(trans_obj, trans);
 
     if (!check_trailing_shape(points, "points", 2)) {
         throw py::error_already_set();
@@ -77,17 +73,15 @@ Py_points_in_path(py::array_t<double> points_obj, double r, py::object path_obj,
 }
 
 static py::tuple
-Py_update_path_extents(py::object path_obj, py::object trans_obj, agg::rect_d rect,
+Py_update_path_extents(py::object path_obj, agg::trans_affine trans, agg::rect_d rect,
                        py::array_t<double> minpos, bool ignore)
 {
     mpl::PathIterator path;
-    agg::trans_affine trans;
     bool changed;
 
     if (!convert_path(path_obj.ptr(), &path)) {
         throw py::error_already_set();
     }
-    convert_trans_affine(trans_obj, trans);
 
     if (minpos.ndim() != 1) {
         throw py::value_error(
@@ -142,18 +136,15 @@ Py_update_path_extents(py::object path_obj, py::object trans_obj, agg::rect_d re
 }
 
 static py::tuple
-Py_get_path_collection_extents(py::object master_transform_obj, py::object paths_obj,
-                               py::object transforms_obj, py::object offsets_obj,
-                               py::object offset_trans_obj)
+Py_get_path_collection_extents(agg::trans_affine master_transform,
+                               py::object paths_obj, py::object transforms_obj,
+                               py::object offsets_obj, agg::trans_affine offset_trans)
 {
-    agg::trans_affine master_transform;
     mpl::PathGenerator paths;
     numpy::array_view<const double, 3> transforms;
     numpy::array_view<const double, 2> offsets;
-    agg::trans_affine offset_trans;
     extent_limits e;
 
-    convert_trans_affine(master_transform_obj, master_transform);
     if (!convert_pathgen(paths_obj.ptr(), &paths)) {
         throw py::error_already_set();
     }
@@ -163,7 +154,6 @@ Py_get_path_collection_extents(py::object master_transform_obj, py::object paths
     if (!convert_points(offsets_obj.ptr(), &offsets)) {
         throw py::error_already_set();
     }
-    convert_trans_affine(offset_trans_obj, offset_trans);
 
     get_path_collection_extents(
         master_transform, paths, transforms, offsets, offset_trans, e);
@@ -185,18 +175,15 @@ Py_get_path_collection_extents(py::object master_transform_obj, py::object paths
 
 static py::object
 Py_point_in_path_collection(double x, double y, double radius,
-                            py::object master_transform_obj, py::object paths_obj,
+                            agg::trans_affine master_transform, py::object paths_obj,
                             py::object transforms_obj, py::object offsets_obj,
-                            py::object offset_trans_obj, bool filled)
+                            agg::trans_affine offset_trans, bool filled)
 {
-    agg::trans_affine master_transform;
     mpl::PathGenerator paths;
     numpy::array_view<const double, 3> transforms;
     numpy::array_view<const double, 2> offsets;
-    agg::trans_affine offset_trans;
     std::vector<int> result;
 
-    convert_trans_affine(master_transform_obj, master_transform);
     if (!convert_pathgen(paths_obj.ptr(), &paths)) {
         throw py::error_already_set();
     }
@@ -206,7 +193,6 @@ Py_point_in_path_collection(double x, double y, double radius,
     if (!convert_points(offsets_obj.ptr(), &offsets)) {
         throw py::error_already_set();
     }
-    convert_trans_affine(offset_trans_obj, offset_trans);
 
     point_in_path_collection(x, y, radius, master_transform, paths, transforms, offsets,
                              offset_trans, filled, result);
@@ -216,22 +202,18 @@ Py_point_in_path_collection(double x, double y, double radius,
 }
 
 static bool
-Py_path_in_path(py::object a_obj, py::object atrans_obj,
-                py::object b_obj, py::object btrans_obj)
+Py_path_in_path(py::object a_obj, agg::trans_affine atrans,
+                py::object b_obj, agg::trans_affine btrans)
 {
     mpl::PathIterator a;
-    agg::trans_affine atrans;
     mpl::PathIterator b;
-    agg::trans_affine btrans;
 
     if (!convert_path(a_obj.ptr(), &a)) {
         throw py::error_already_set();
     }
-    convert_trans_affine(atrans_obj, atrans);
     if (!convert_path(b_obj.ptr(), &b)) {
         throw py::error_already_set();
     }
-    convert_trans_affine(btrans_obj, btrans);
 
     return path_in_path(a, atrans, b, btrans);
 }
@@ -253,12 +235,8 @@ Py_clip_path_to_rect(py::object path_obj, agg::rect_d rect, bool inside)
 
 static py::object
 Py_affine_transform(py::array_t<double, py::array::c_style | py::array::forcecast> vertices_arr,
-                    py::object trans_obj)
+                    agg::trans_affine trans)
 {
-    agg::trans_affine trans;
-
-    convert_trans_affine(trans_obj, trans);
-
     if (vertices_arr.ndim() == 2) {
         auto vertices = vertices_arr.unchecked<2>();
 
@@ -342,17 +320,15 @@ Py_path_intersects_rectangle(py::object path_obj, double rect_x1, double rect_y1
 }
 
 static py::list
-Py_convert_path_to_polygons(py::object path_obj, py::object trans_obj,
+Py_convert_path_to_polygons(py::object path_obj, agg::trans_affine trans,
                             double width, double height, bool closed_only)
 {
     mpl::PathIterator path;
-    agg::trans_affine trans;
     std::vector<Polygon> result;
 
     if (!convert_path(path_obj.ptr(), &path)) {
         throw py::error_already_set();
     }
-    convert_trans_affine(trans_obj, trans);
 
     convert_path_to_polygons(path, trans, width, height, closed_only, result);
 
@@ -360,19 +336,17 @@ Py_convert_path_to_polygons(py::object path_obj, py::object trans_obj,
 }
 
 static py::tuple
-Py_cleanup_path(py::object path_obj, py::object trans_obj, bool remove_nans,
+Py_cleanup_path(py::object path_obj, agg::trans_affine trans, bool remove_nans,
                 agg::rect_d clip_rect, py::object snap_mode_obj, double stroke_width,
                 std::optional<bool> simplify, bool return_curves, py::object sketch_obj)
 {
     mpl::PathIterator path;
-    agg::trans_affine trans;
     e_snap_mode snap_mode;
     SketchParams sketch;
 
     if (!convert_path(path_obj.ptr(), &path)) {
         throw py::error_already_set();
     }
-    convert_trans_affine(trans_obj, trans);
     if (!convert_snap(snap_mode_obj.ptr(), &snap_mode)) {
         throw py::error_already_set();
     }
@@ -432,12 +406,11 @@ postfix : bool
 )""";
 
 static py::object
-Py_convert_to_string(py::object path_obj, py::object trans_obj, agg::rect_d cliprect,
+Py_convert_to_string(py::object path_obj, agg::trans_affine trans, agg::rect_d cliprect,
                      std::optional<bool> simplify, py::object sketch_obj, int precision,
                      std::array<std::string, 5> codes_obj, bool postfix)
 {
     mpl::PathIterator path;
-    agg::trans_affine trans;
     SketchParams sketch;
     char *codes[5];
     std::string buffer;
@@ -446,7 +419,6 @@ Py_convert_to_string(py::object path_obj, py::object trans_obj, agg::rect_d clip
     if (!convert_path(path_obj.ptr(), &path)) {
         throw py::error_already_set();
     }
-    convert_trans_affine(trans_obj, trans);
     if (!convert_sketch_params(sketch_obj.ptr(), &sketch)) {
         throw py::error_already_set();
     }
diff --git a/src/py_converters_11.h b/src/py_converters_11.h
index b86955d29055..1ab354f2dc6a 100644
--- a/src/py_converters_11.h
+++ b/src/py_converters_11.h
@@ -56,6 +56,34 @@ namespace PYBIND11_NAMESPACE { namespace detail {
             return true;
         }
     };
+
+    template <> struct type_caster<agg::trans_affine> {
+    public:
+        PYBIND11_TYPE_CASTER(agg::trans_affine, const_name("trans_affine"));
+
+        bool load(handle src, bool) {
+            // If None assume identity transform so leave affine unchanged
+            if (src.is_none()) {
+                return true;
+            }
+
+            auto array = py::array_t<double, py::array::c_style>::ensure(src);
+            if (!array || array.ndim() != 2 ||
+                    array.shape(0) != 3 || array.shape(1) != 3) {
+                throw std::invalid_argument("Invalid affine transformation matrix");
+            }
+
+            auto buffer = array.data();
+            value.sx = buffer[0];
+            value.shx = buffer[1];
+            value.tx = buffer[2];
+            value.shy = buffer[3];
+            value.sy = buffer[4];
+            value.ty = buffer[5];
+
+            return true;
+        }
+    };
 }} // namespace PYBIND11_NAMESPACE::detail
 
 #endif /* MPL_PY_CONVERTERS_11_H */

From d32a372ea40cb31c7df259795695cf7ffbf38451 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 19 Oct 2023 21:46:24 -0400
Subject: [PATCH 0815/1120] Add a pybind11 type caster for mpl::PathIterator

---
 src/_path_wrapper.cpp  | 87 ++++++++----------------------------------
 src/py_converters_11.h | 26 +++++++++++++
 2 files changed, 41 insertions(+), 72 deletions(-)

diff --git a/src/_path_wrapper.cpp b/src/_path_wrapper.cpp
index 1381cf34f016..733b0d80f09c 100644
--- a/src/_path_wrapper.cpp
+++ b/src/_path_wrapper.cpp
@@ -11,9 +11,9 @@
 
 #include "_path.h"
 
+#include "py_adaptors.h"
 #include "py_converters.h"
 #include "py_converters_11.h"
-#include "py_adaptors.h"
 
 namespace py = pybind11;
 using namespace pybind11::literals;
@@ -33,31 +33,21 @@ convert_polygon_vector(std::vector<Polygon> &polygons)
 }
 
 static bool
-Py_point_in_path(double x, double y, double r, py::object path_obj,
+Py_point_in_path(double x, double y, double r, mpl::PathIterator path,
                  agg::trans_affine trans)
 {
-    mpl::PathIterator path;
-
-    if (!convert_path(path_obj.ptr(), &path)) {
-        throw py::error_already_set();
-    }
-
     return point_in_path(x, y, r, path, trans);
 }
 
 static py::array_t<double>
-Py_points_in_path(py::array_t<double> points_obj, double r, py::object path_obj,
+Py_points_in_path(py::array_t<double> points_obj, double r, mpl::PathIterator path,
                   agg::trans_affine trans)
 {
     numpy::array_view<double, 2> points;
-    mpl::PathIterator path;
 
     if (!convert_points(points_obj.ptr(), &points)) {
         throw py::error_already_set();
     }
-    if (!convert_path(path_obj.ptr(), &path)) {
-        throw py::error_already_set();
-    }
 
     if (!check_trailing_shape(points, "points", 2)) {
         throw py::error_already_set();
@@ -73,16 +63,11 @@ Py_points_in_path(py::array_t<double> points_obj, double r, py::object path_obj,
 }
 
 static py::tuple
-Py_update_path_extents(py::object path_obj, agg::trans_affine trans, agg::rect_d rect,
-                       py::array_t<double> minpos, bool ignore)
+Py_update_path_extents(mpl::PathIterator path, agg::trans_affine trans,
+                       agg::rect_d rect, py::array_t<double> minpos, bool ignore)
 {
-    mpl::PathIterator path;
     bool changed;
 
-    if (!convert_path(path_obj.ptr(), &path)) {
-        throw py::error_already_set();
-    }
-
     if (minpos.ndim() != 1) {
         throw py::value_error(
             "minpos must be 1D, got " + std::to_string(minpos.ndim()));
@@ -202,32 +187,17 @@ Py_point_in_path_collection(double x, double y, double radius,
 }
 
 static bool
-Py_path_in_path(py::object a_obj, agg::trans_affine atrans,
-                py::object b_obj, agg::trans_affine btrans)
+Py_path_in_path(mpl::PathIterator a, agg::trans_affine atrans,
+                mpl::PathIterator b, agg::trans_affine btrans)
 {
-    mpl::PathIterator a;
-    mpl::PathIterator b;
-
-    if (!convert_path(a_obj.ptr(), &a)) {
-        throw py::error_already_set();
-    }
-    if (!convert_path(b_obj.ptr(), &b)) {
-        throw py::error_already_set();
-    }
-
     return path_in_path(a, atrans, b, btrans);
 }
 
 static py::list
-Py_clip_path_to_rect(py::object path_obj, agg::rect_d rect, bool inside)
+Py_clip_path_to_rect(mpl::PathIterator path, agg::rect_d rect, bool inside)
 {
-    mpl::PathIterator path;
     std::vector<Polygon> result;
 
-    if (!convert_path(path_obj.ptr(), &path)) {
-        throw py::error_already_set();
-    }
-
     clip_path_to_rect(path, rect, inside, result);
 
     return convert_polygon_vector(result);
@@ -278,21 +248,12 @@ Py_count_bboxes_overlapping_bbox(agg::rect_d bbox, py::object bboxes_obj)
 }
 
 static bool
-Py_path_intersects_path(py::object p1_obj, py::object p2_obj, bool filled)
+Py_path_intersects_path(mpl::PathIterator p1, mpl::PathIterator p2, bool filled)
 {
-    mpl::PathIterator p1;
-    mpl::PathIterator p2;
     agg::trans_affine t1;
     agg::trans_affine t2;
     bool result;
 
-    if (!convert_path(p1_obj.ptr(), &p1)) {
-        throw py::error_already_set();
-    }
-    if (!convert_path(p2_obj.ptr(), &p2)) {
-        throw py::error_already_set();
-    }
-
     result = path_intersects_path(p1, p2);
     if (filled) {
         if (!result) {
@@ -307,46 +268,31 @@ Py_path_intersects_path(py::object p1_obj, py::object p2_obj, bool filled)
 }
 
 static bool
-Py_path_intersects_rectangle(py::object path_obj, double rect_x1, double rect_y1,
+Py_path_intersects_rectangle(mpl::PathIterator path, double rect_x1, double rect_y1,
                              double rect_x2, double rect_y2, bool filled)
 {
-    mpl::PathIterator path;
-
-    if (!convert_path(path_obj.ptr(), &path)) {
-        throw py::error_already_set();
-    }
-
     return path_intersects_rectangle(path, rect_x1, rect_y1, rect_x2, rect_y2, filled);
 }
 
 static py::list
-Py_convert_path_to_polygons(py::object path_obj, agg::trans_affine trans,
+Py_convert_path_to_polygons(mpl::PathIterator path, agg::trans_affine trans,
                             double width, double height, bool closed_only)
 {
-    mpl::PathIterator path;
     std::vector<Polygon> result;
 
-    if (!convert_path(path_obj.ptr(), &path)) {
-        throw py::error_already_set();
-    }
-
     convert_path_to_polygons(path, trans, width, height, closed_only, result);
 
     return convert_polygon_vector(result);
 }
 
 static py::tuple
-Py_cleanup_path(py::object path_obj, agg::trans_affine trans, bool remove_nans,
+Py_cleanup_path(mpl::PathIterator path, agg::trans_affine trans, bool remove_nans,
                 agg::rect_d clip_rect, py::object snap_mode_obj, double stroke_width,
                 std::optional<bool> simplify, bool return_curves, py::object sketch_obj)
 {
-    mpl::PathIterator path;
     e_snap_mode snap_mode;
     SketchParams sketch;
 
-    if (!convert_path(path_obj.ptr(), &path)) {
-        throw py::error_already_set();
-    }
     if (!convert_snap(snap_mode_obj.ptr(), &snap_mode)) {
         throw py::error_already_set();
     }
@@ -406,19 +352,16 @@ postfix : bool
 )""";
 
 static py::object
-Py_convert_to_string(py::object path_obj, agg::trans_affine trans, agg::rect_d cliprect,
-                     std::optional<bool> simplify, py::object sketch_obj, int precision,
+Py_convert_to_string(mpl::PathIterator path, agg::trans_affine trans,
+                     agg::rect_d cliprect, std::optional<bool> simplify,
+                     py::object sketch_obj, int precision,
                      std::array<std::string, 5> codes_obj, bool postfix)
 {
-    mpl::PathIterator path;
     SketchParams sketch;
     char *codes[5];
     std::string buffer;
     bool status;
 
-    if (!convert_path(path_obj.ptr(), &path)) {
-        throw py::error_already_set();
-    }
     if (!convert_sketch_params(sketch_obj.ptr(), &sketch)) {
         throw py::error_already_set();
     }
diff --git a/src/py_converters_11.h b/src/py_converters_11.h
index 1ab354f2dc6a..0b4244da1ad8 100644
--- a/src/py_converters_11.h
+++ b/src/py_converters_11.h
@@ -84,6 +84,32 @@ namespace PYBIND11_NAMESPACE { namespace detail {
             return true;
         }
     };
+
+/* Remove all this macro magic after dropping NumPy usage and just include `py_adaptors.h`. */
+#ifdef MPL_PY_ADAPTORS_H
+    template <> struct type_caster<mpl::PathIterator> {
+    public:
+        PYBIND11_TYPE_CASTER(mpl::PathIterator, const_name("PathIterator"));
+
+        bool load(handle src, bool) {
+            if (src.is_none()) {
+                return true;
+            }
+
+            auto vertices = src.attr("vertices");
+            auto codes = src.attr("codes");
+            auto should_simplify = src.attr("should_simplify").cast<bool>();
+            auto simplify_threshold = src.attr("simplify_threshold").cast<double>();
+
+            if (!value.set(vertices.ptr(), codes.ptr(),
+                           should_simplify, simplify_threshold)) {
+                return false;
+            }
+
+            return true;
+        }
+    };
+#endif
 }} // namespace PYBIND11_NAMESPACE::detail
 
 #endif /* MPL_PY_CONVERTERS_11_H */

From 925d619fe637d0564f280c0ccab2ee0bb2f88ffa Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Sat, 21 Oct 2023 04:08:07 -0400
Subject: [PATCH 0816/1120] Add a pybind11 type caster for e_snap_mode

---
 src/_path_wrapper.cpp  |  6 +-----
 src/py_converters_11.h | 17 +++++++++++++++++
 2 files changed, 18 insertions(+), 5 deletions(-)

diff --git a/src/_path_wrapper.cpp b/src/_path_wrapper.cpp
index 733b0d80f09c..c0cf8eee6c77 100644
--- a/src/_path_wrapper.cpp
+++ b/src/_path_wrapper.cpp
@@ -287,15 +287,11 @@ Py_convert_path_to_polygons(mpl::PathIterator path, agg::trans_affine trans,
 
 static py::tuple
 Py_cleanup_path(mpl::PathIterator path, agg::trans_affine trans, bool remove_nans,
-                agg::rect_d clip_rect, py::object snap_mode_obj, double stroke_width,
+                agg::rect_d clip_rect, e_snap_mode snap_mode, double stroke_width,
                 std::optional<bool> simplify, bool return_curves, py::object sketch_obj)
 {
-    e_snap_mode snap_mode;
     SketchParams sketch;
 
-    if (!convert_snap(snap_mode_obj.ptr(), &snap_mode)) {
-        throw py::error_already_set();
-    }
     if (!convert_sketch_params(sketch_obj.ptr(), &sketch)) {
         throw py::error_already_set();
     }
diff --git a/src/py_converters_11.h b/src/py_converters_11.h
index 0b4244da1ad8..c453982bfcde 100644
--- a/src/py_converters_11.h
+++ b/src/py_converters_11.h
@@ -10,6 +10,7 @@ namespace py = pybind11;
 
 #include "agg_basics.h"
 #include "agg_trans_affine.h"
+#include "path_converters.h"
 
 void convert_trans_affine(const py::object& transform, agg::trans_affine& affine);
 
@@ -85,6 +86,22 @@ namespace PYBIND11_NAMESPACE { namespace detail {
         }
     };
 
+    template <> struct type_caster<e_snap_mode> {
+    public:
+        PYBIND11_TYPE_CASTER(e_snap_mode, const_name("e_snap_mode"));
+
+        bool load(handle src, bool) {
+            if (src.is_none()) {
+                value = SNAP_AUTO;
+                return true;
+            }
+
+            value = src.cast<bool>() ? SNAP_TRUE : SNAP_FALSE;
+
+            return true;
+        }
+    };
+
 /* Remove all this macro magic after dropping NumPy usage and just include `py_adaptors.h`. */
 #ifdef MPL_PY_ADAPTORS_H
     template <> struct type_caster<mpl::PathIterator> {

From 22c26890ac2866c28753828881cf6f1ac6611bf4 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Sat, 21 Oct 2023 04:20:12 -0400
Subject: [PATCH 0817/1120] Add a pybind11 type caster for SketchParams

---
 src/_path_wrapper.cpp  | 16 +++-------------
 src/py_converters_11.h | 20 ++++++++++++++++++++
 2 files changed, 23 insertions(+), 13 deletions(-)

diff --git a/src/_path_wrapper.cpp b/src/_path_wrapper.cpp
index c0cf8eee6c77..b52ebf71f410 100644
--- a/src/_path_wrapper.cpp
+++ b/src/_path_wrapper.cpp
@@ -11,6 +11,7 @@
 
 #include "_path.h"
 
+#include "_backend_agg_basic_types.h"
 #include "py_adaptors.h"
 #include "py_converters.h"
 #include "py_converters_11.h"
@@ -288,14 +289,8 @@ Py_convert_path_to_polygons(mpl::PathIterator path, agg::trans_affine trans,
 static py::tuple
 Py_cleanup_path(mpl::PathIterator path, agg::trans_affine trans, bool remove_nans,
                 agg::rect_d clip_rect, e_snap_mode snap_mode, double stroke_width,
-                std::optional<bool> simplify, bool return_curves, py::object sketch_obj)
+                std::optional<bool> simplify, bool return_curves, SketchParams sketch)
 {
-    SketchParams sketch;
-
-    if (!convert_sketch_params(sketch_obj.ptr(), &sketch)) {
-        throw py::error_already_set();
-    }
-
     if (!simplify.has_value()) {
         simplify = path.should_simplify();
     }
@@ -350,18 +345,13 @@ postfix : bool
 static py::object
 Py_convert_to_string(mpl::PathIterator path, agg::trans_affine trans,
                      agg::rect_d cliprect, std::optional<bool> simplify,
-                     py::object sketch_obj, int precision,
+                     SketchParams sketch, int precision,
                      std::array<std::string, 5> codes_obj, bool postfix)
 {
-    SketchParams sketch;
     char *codes[5];
     std::string buffer;
     bool status;
 
-    if (!convert_sketch_params(sketch_obj.ptr(), &sketch)) {
-        throw py::error_already_set();
-    }
-
     for (auto i = 0; i < 5; ++i) {
         codes[i] = const_cast<char *>(codes_obj[i].c_str());
     }
diff --git a/src/py_converters_11.h b/src/py_converters_11.h
index c453982bfcde..911d5fe2b924 100644
--- a/src/py_converters_11.h
+++ b/src/py_converters_11.h
@@ -127,6 +127,26 @@ namespace PYBIND11_NAMESPACE { namespace detail {
         }
     };
 #endif
+
+/* Remove all this macro magic after dropping NumPy usage and just include `_backend_agg_basic_types.h`. */
+#ifdef MPL_BACKEND_AGG_BASIC_TYPES_H
+    template <> struct type_caster<SketchParams> {
+    public:
+        PYBIND11_TYPE_CASTER(SketchParams, const_name("SketchParams"));
+
+        bool load(handle src, bool) {
+            if (src.is_none()) {
+                value.scale = 0.0;
+                return true;
+            }
+
+            auto params = src.cast<std::tuple<double, double, double>>();
+            std::tie(value.scale, value.length, value.randomness) = params;
+
+            return true;
+        }
+    };
+#endif
 }} // namespace PYBIND11_NAMESPACE::detail
 
 #endif /* MPL_PY_CONVERTERS_11_H */

From a906be6d8bfefca1247f1dfa4c465179aa42ff4d Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Mon, 15 Jan 2024 20:22:07 -0500
Subject: [PATCH 0818/1120] Optimize convert_polygon_vector a bit

---
 src/_path_wrapper.cpp | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/_path_wrapper.cpp b/src/_path_wrapper.cpp
index b52ebf71f410..72ed2aef01f7 100644
--- a/src/_path_wrapper.cpp
+++ b/src/_path_wrapper.cpp
@@ -25,9 +25,9 @@ convert_polygon_vector(std::vector<Polygon> &polygons)
     auto result = py::list(polygons.size());
 
     for (size_t i = 0; i < polygons.size(); ++i) {
-        Polygon poly = polygons[i];
+        const auto& poly = polygons[i];
         py::ssize_t dims[] = { static_cast<py::ssize_t>(poly.size()), 2 };
-        result[i] = py::array(dims, reinterpret_cast<double *>(poly.data()));
+        result[i] = py::array(dims, reinterpret_cast<const double *>(poly.data()));
     }
 
     return result;

From 28e664e8a933ad7a9db13b5e7b2009b6dbe2bb31 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 7 Mar 2024 22:28:13 -0500
Subject: [PATCH 0819/1120] Fix build on older macOS deployment targets

Apparently, macOS incorrectly hides this `std::optional.value` method
behind the deployment target, even though it's a header-only
implementation, so it shouldn't have any runtime requirement.

Instead of fiddling with deployment targets, use an alternate method for
getting the `std::optional` value.
---
 src/_path_wrapper.cpp | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/_path_wrapper.cpp b/src/_path_wrapper.cpp
index 72ed2aef01f7..b4eb5d19177f 100644
--- a/src/_path_wrapper.cpp
+++ b/src/_path_wrapper.cpp
@@ -301,7 +301,7 @@ Py_cleanup_path(mpl::PathIterator path, agg::trans_affine trans, bool remove_nan
     std::vector<npy_uint8> codes;
 
     cleanup_path(path, trans, remove_nans, do_clip, clip_rect, snap_mode, stroke_width,
-                 simplify.value(), return_curves, sketch, vertices, codes);
+                 *simplify, return_curves, sketch, vertices, codes);
 
     auto length = static_cast<py::ssize_t>(codes.size());
 
@@ -360,8 +360,8 @@ Py_convert_to_string(mpl::PathIterator path, agg::trans_affine trans,
         simplify = path.should_simplify();
     }
 
-    status = convert_to_string(path, trans, cliprect, simplify.value(), sketch,
-                               precision, codes, postfix, buffer);
+    status = convert_to_string(path, trans, cliprect, *simplify, sketch, precision,
+                               codes, postfix, buffer);
 
     if (!status) {
         throw py::value_error("Malformed path codes");

From 9eda24f891966cdff80a22be331876deca94a7e6 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 7 Mar 2024 03:41:07 -0500
Subject: [PATCH 0820/1120] macosx: Clean up single-shot timers correctly

The `NSTimer` docs state that a non-repeating (aka single-shot in our
terms) timer is invalidated after it fires. This means that we should
not do it ourselves, and in fact it appears that the pointer itself is
no longer valid, so we would be passing an `invalidate` message to a
random object or segfault.
---
 lib/matplotlib/backends/backend_macosx.py | 4 ----
 src/_macosx.m                             | 5 +++++
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/lib/matplotlib/backends/backend_macosx.py b/lib/matplotlib/backends/backend_macosx.py
index 822cd22ba6c7..7f5589677d31 100644
--- a/lib/matplotlib/backends/backend_macosx.py
+++ b/lib/matplotlib/backends/backend_macosx.py
@@ -67,13 +67,9 @@ def draw_idle(self):
 
     def _single_shot_timer(self, callback):
         """Add a single shot timer with the given callback"""
-        # We need to explicitly stop and remove the timer after
-        # firing, otherwise segfaults will occur when trying to deallocate
-        # the singleshot timers.
         def callback_func(callback, timer):
             callback()
             self._timers.remove(timer)
-            timer.stop()
         timer = self.new_timer(interval=0)
         timer.single_shot = True
         timer.add_callback(callback_func, callback, timer)
diff --git a/src/_macosx.m b/src/_macosx.m
index 299fed1785a8..5f2b1ab8d195 100755
--- a/src/_macosx.m
+++ b/src/_macosx.m
@@ -1741,6 +1741,11 @@ - (void)flagsChanged:(NSEvent *)event
                                          repeats: !single
                                            block: ^(NSTimer *timer) {
         gil_call_method((PyObject*)self, "_on_timer");
+        if (single) {
+            // A single-shot timer will be automatically invalidated when it fires, so
+            // we shouldn't do it ourselves when the object is deleted.
+            self->timer = NULL;
+        }
     }];
     // Schedule the timer on the main run loop which is needed
     // when updating the UI from a background thread

From 8b98071871c7bbc5da692e51a74fabcfba3f0d72 Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Fri, 8 Mar 2024 04:22:25 +0000
Subject: [PATCH 0821/1120] FIX: don't copy twice on RGB input

---
 lib/matplotlib/cm.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/cm.py b/lib/matplotlib/cm.py
index e9a7aad6c456..c14973560ac3 100644
--- a/lib/matplotlib/cm.py
+++ b/lib/matplotlib/cm.py
@@ -362,7 +362,7 @@ def to_rgba(self, x, alpha=None, bytes=False, norm=True):
                 if xx.dtype.kind == 'f':
                     # If any of R, G, B, or A is nan, set to 0
                     if np.any(nans := np.isnan(x)):
-                        if xx.shape[2] == 4:
+                        if x.shape[2] == 4:
                             xx = xx.copy()
                         xx[np.any(nans, axis=2), :] = 0
 

From 730a9435ca5fbf958abe6bd9395612cdd037e106 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 23 Feb 2024 00:18:42 -0500
Subject: [PATCH 0822/1120] Clean up headers in extensions

Either remove unused, or switch to more specific ones.
---
 src/_backend_agg.cpp           | 1 -
 src/_backend_agg.h             | 5 ++---
 src/_backend_agg_basic_types.h | 1 +
 src/_image_resample.h          | 1 -
 src/_path.h                    | 1 -
 src/_tkagg.cpp                 | 4 ++--
 src/_ttconv.cpp                | 2 +-
 src/array.h                    | 3 +++
 src/ft2font.h                  | 6 +++---
 src/ft2font_wrapper.cpp        | 2 --
 src/mplutils.h                 | 1 -
 src/path_converters.h          | 4 ++--
 src/py_adaptors.h              | 1 +
 13 files changed, 15 insertions(+), 17 deletions(-)

diff --git a/src/_backend_agg.cpp b/src/_backend_agg.cpp
index c35f92eb8fc1..ce88f504dc1e 100644
--- a/src/_backend_agg.cpp
+++ b/src/_backend_agg.cpp
@@ -4,7 +4,6 @@
 
 #include <Python.h>
 #include "_backend_agg.h"
-#include "mplutils.h"
 
 RendererAgg::RendererAgg(unsigned int width, unsigned int height, double dpi)
     : width(width),
diff --git a/src/_backend_agg.h b/src/_backend_agg.h
index c191f3448144..470d459de341 100644
--- a/src/_backend_agg.h
+++ b/src/_backend_agg.h
@@ -7,14 +7,15 @@
 #define MPL_BACKEND_AGG_H
 
 #include <cmath>
-#include <vector>
 #include <algorithm>
 
 #include "agg_alpha_mask_u8.h"
 #include "agg_conv_curve.h"
 #include "agg_conv_dash.h"
 #include "agg_conv_stroke.h"
+#include "agg_conv_transform.h"
 #include "agg_image_accessors.h"
+#include "agg_path_storage.h"
 #include "agg_pixfmt_amask_adaptor.h"
 #include "agg_pixfmt_gray.h"
 #include "agg_pixfmt_rgba.h"
@@ -25,7 +26,6 @@
 #include "agg_scanline_bin.h"
 #include "agg_scanline_p.h"
 #include "agg_scanline_storage_aa.h"
-#include "agg_scanline_storage_bin.h"
 #include "agg_scanline_u.h"
 #include "agg_span_allocator.h"
 #include "agg_span_converter.h"
@@ -34,7 +34,6 @@
 #include "agg_span_image_filter_rgba.h"
 #include "agg_span_interpolator_linear.h"
 #include "agg_span_pattern_rgba.h"
-#include "util/agg_color_conv_rgb8.h"
 
 #include "_backend_agg_basic_types.h"
 #include "path_converters.h"
diff --git a/src/_backend_agg_basic_types.h b/src/_backend_agg_basic_types.h
index 95c7a3ca5a3c..4fbf846d8cb4 100644
--- a/src/_backend_agg_basic_types.h
+++ b/src/_backend_agg_basic_types.h
@@ -8,6 +8,7 @@
 
 #include "agg_color_rgba.h"
 #include "agg_math_stroke.h"
+#include "agg_trans_affine.h"
 #include "path_converters.h"
 
 #include "py_adaptors.h"
diff --git a/src/_image_resample.h b/src/_image_resample.h
index 60f5e66d4539..745fe9f10cd7 100644
--- a/src/_image_resample.h
+++ b/src/_image_resample.h
@@ -6,7 +6,6 @@
 #include "agg_image_accessors.h"
 #include "agg_path_storage.h"
 #include "agg_pixfmt_gray.h"
-#include "agg_pixfmt_rgb.h"
 #include "agg_pixfmt_rgba.h"
 #include "agg_renderer_base.h"
 #include "agg_renderer_scanline.h"
diff --git a/src/_path.h b/src/_path.h
index 239a3c760221..7f17d0bc2933 100644
--- a/src/_path.h
+++ b/src/_path.h
@@ -14,7 +14,6 @@
 #include "agg_conv_curve.h"
 #include "agg_conv_stroke.h"
 #include "agg_conv_transform.h"
-#include "agg_path_storage.h"
 #include "agg_trans_affine.h"
 
 #include "path_converters.h"
diff --git a/src/_tkagg.cpp b/src/_tkagg.cpp
index 513938173326..e35502fe23ff 100644
--- a/src/_tkagg.cpp
+++ b/src/_tkagg.cpp
@@ -10,12 +10,10 @@
 // you can get it at https://python-pillow.org/
 
 #include <Python.h>
-#include <memory>
 #include <new>
 #include <stdexcept>
 #include <string>
 #include <tuple>
-#include <vector>
 
 #ifdef _WIN32
 #define WIN32_LEAN_AND_MEAN
@@ -48,6 +46,8 @@ static inline PyObject *PyErr_SetFromWindowsErr(int ierr) {
 #endif
 
 #ifdef WIN32_DLL
+#include <vector>
+
 #include <windows.h>
 #include <commctrl.h>
 #define PSAPI_VERSION 1
diff --git a/src/_ttconv.cpp b/src/_ttconv.cpp
index 715d46d4cf7a..a99ea9d1c891 100644
--- a/src/_ttconv.cpp
+++ b/src/_ttconv.cpp
@@ -5,8 +5,8 @@
 
   Python wrapper for TrueType conversion library in ../ttconv.
  */
+
 #include <pybind11/pybind11.h>
-#include "mplutils.h"
 #include "pprdrv.h"
 #include <vector>
 
diff --git a/src/array.h b/src/array.h
index 6694412b8df5..97d66dd4a6d2 100644
--- a/src/array.h
+++ b/src/array.h
@@ -6,6 +6,9 @@
 #ifndef MPL_SCALAR_H
 #define MPL_SCALAR_H
 
+#include <cstddef>
+#include <stdexcept>
+
 namespace array
 {
 
diff --git a/src/ft2font.h b/src/ft2font.h
index 6b8f05466700..66b218316e90 100644
--- a/src/ft2font.h
+++ b/src/ft2font.h
@@ -9,10 +9,10 @@
 #define PY_SSIZE_T_CLEAN
 #include <Python.h>
 
-#include <vector>
-#include<set>
-#include <stdint.h>
+#include <cstdint>
+#include <set>
 #include <unordered_map>
+#include <vector>
 
 extern "C" {
 #include <ft2build.h>
diff --git a/src/ft2font_wrapper.cpp b/src/ft2font_wrapper.cpp
index 1b03e5406147..25b2d173f5e9 100644
--- a/src/ft2font_wrapper.cpp
+++ b/src/ft2font_wrapper.cpp
@@ -2,13 +2,11 @@
 #include "ft2font.h"
 #include "py_converters.h"
 #include "py_exceptions.h"
-#include "numpy_cpp.h"
 
 // From Python
 #include <structmember.h>
 
 #include <set>
-#include <algorithm>
 
 static PyObject *convert_xys_to_array(std::vector<double> &xys)
 {
diff --git a/src/mplutils.h b/src/mplutils.h
index 8c2921a1d2ff..58eb32d190ec 100644
--- a/src/mplutils.h
+++ b/src/mplutils.h
@@ -7,7 +7,6 @@
 #define PY_SSIZE_T_CLEAN
 
 #include <Python.h>
-#include <stdint.h>
 
 #ifdef _POSIX_C_SOURCE
 #    undef _POSIX_C_SOURCE
diff --git a/src/path_converters.h b/src/path_converters.h
index 8583d84855aa..db732e126c3f 100644
--- a/src/path_converters.h
+++ b/src/path_converters.h
@@ -4,8 +4,8 @@
 #define MPL_PATH_CONVERTERS_H
 
 #include <cmath>
-#include <stdint.h>
-#include "agg_path_storage.h"
+#include <cstdint>
+
 #include "agg_clip_liang_barsky.h"
 #include "mplutils.h"
 #include "agg_conv_segmentator.h"
diff --git a/src/py_adaptors.h b/src/py_adaptors.h
index 1863cd6efbb0..b0cec6c1d004 100644
--- a/src/py_adaptors.h
+++ b/src/py_adaptors.h
@@ -12,6 +12,7 @@
 
 #include "numpy/arrayobject.h"
 
+#include "agg_basics.h"
 #include "py_exceptions.h"
 
 extern "C" {

From 4c15ee1050498d407d7b7d0d66badbfc9ec7ac1a Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Fri, 8 Mar 2024 09:04:41 +0000
Subject: [PATCH 0823/1120] Fix devdocs version switcher

---
 doc/conf.py | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/doc/conf.py b/doc/conf.py
index 4241ada05cf4..e33687773b32 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -36,6 +36,14 @@
 
 # are we running circle CI?
 CIRCLECI = 'CIRCLECI' in os.environ
+# are we deploying this build to matplotlib.org/devdocs?
+# This is a copy of the logic in .circleci/deploy-docs.sh
+DEVDOCS = (
+    CIRCLECI and
+    (os.environ.get("CIRCLE_PROJECT_USERNAME") == "matplotlib") and
+    (os.environ.get("CIRCLE_BRANCH") == "main") and
+    (not os.environ.get("CIRCLE_PULL_REQUEST", "").startswith(
+        "https://github.com/matplotlib/matplotlib/pull")))
 
 
 def _parse_skip_subdirs_file():
@@ -489,7 +497,7 @@ def js_tag_with_cache_busting(js):
             "https://output.circle-artifacts.com/output/job/"
             f"{os.environ['CIRCLE_WORKFLOW_JOB_ID']}/artifacts/"
             f"{os.environ['CIRCLE_NODE_INDEX']}"
-            "/doc/build/html/_static/switcher.json" if CIRCLECI else
+            "/doc/build/html/_static/switcher.json" if CIRCLECI and not DEVDOCS else
             f"https://matplotlib.org/devdocs/_static/switcher.json?{SHA}"
         ),
         "version_match": (

From a131488e9397f847f13014799e30aed3ebc0ac36 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Wed, 6 Mar 2024 23:50:01 +0100
Subject: [PATCH 0824/1120] Simplify the LineCollection example

Superseeds #27871.

This example is much simpler, but conveys the same LineCollection
aspects - except for not using masked arrays. But I argue that this
the example should be simple and using masked arrays rather distracts
from the core aspects of LineCollection.

If there's concern of not showing masked array support, we should add
a third plot for that.
---
 .../shapes_and_collections/line_collection.py | 85 ++++++++-----------
 1 file changed, 37 insertions(+), 48 deletions(-)

diff --git a/galleries/examples/shapes_and_collections/line_collection.py b/galleries/examples/shapes_and_collections/line_collection.py
index d534913ad2b2..a27496f62e0e 100644
--- a/galleries/examples/shapes_and_collections/line_collection.py
+++ b/galleries/examples/shapes_and_collections/line_collection.py
@@ -3,8 +3,7 @@
 Plotting multiple lines with a LineCollection
 =============================================
 
-Matplotlib can efficiently draw multiple lines at once using a
-`~.LineCollection`, as showcased below.
+Matplotlib can efficiently draw multiple lines at once using a `~.LineCollection`.
 """
 
 import matplotlib.pyplot as plt
@@ -12,60 +11,52 @@
 
 from matplotlib.collections import LineCollection
 
-x = np.arange(100)
-# Here are many sets of y to plot vs. x
-ys = x[:50, np.newaxis] + x[np.newaxis, :]
+colors = ["indigo", "blue", "green", "yellow", "orange", "red"]
 
-segs = np.zeros((50, 100, 2))
-segs[:, :, 1] = ys
-segs[:, :, 0] = x
+# create a list of half-circles with varying radii
+theta = np.linspace(0, np.pi, 36)
+radii = np.linspace(4, 5, num=len(colors))
+arcs = [np.column_stack([r * np.cos(theta), r * np.sin(theta)]) for r in radii]
 
-# Mask some values to test masked array support:
-segs = np.ma.masked_where((segs > 50) & (segs < 60), segs)
+fig, ax = plt.subplots(figsize=(6.4, 3.2))
+# set axes limits manually because Collections do not take part in autoscaling
+ax.set_xlim(-6, 6)
+ax.set_ylim(0, 6)
+ax.set_aspect("equal")  # to make the arcs look circular
 
-# We need to set the plot limits, they will not autoscale
-fig, ax = plt.subplots()
-ax.set_xlim(x.min(), x.max())
-ax.set_ylim(ys.min(), ys.max())
+# create a LineCollection with the half-circles
+# its properties can be set per line by passing a sequence (here used for *colors*)
+# or they can be set for all lines by passing a scalar (here used for *linewidths*)
+line_collection = LineCollection(arcs, colors=colors, linewidths=4)
+ax.add_collection(line_collection)
 
-# *colors* is sequence of rgba tuples.
-# *linestyle* is a string or dash tuple. Legal string values are
-# solid|dashed|dashdot|dotted.  The dash tuple is (offset, onoffseq) where
-# onoffseq is an even length tuple of on and off ink in points.  If linestyle
-# is omitted, 'solid' is used.
-# See `matplotlib.collections.LineCollection` for more information.
-colors = plt.rcParams['axes.prop_cycle'].by_key()['color']
-
-line_segments = LineCollection(segs, linewidths=(0.5, 1, 1.5, 2),
-                               colors=colors, linestyle='solid')
-ax.add_collection(line_segments)
-ax.set_title('Line collection with masked arrays')
 plt.show()
 
 # %%
-# In the following example, instead of passing a list of colors
-# (``colors=colors``), we pass an array of values (``array=x``) that get
-# colormapped.
+# Instead of passing a list of colors (``colors=colors``), we can alternatively use
+# colormapping. The lines are then color-coded based on an additional array of values
+# passed to the *array* parameter. In the below example, we color the lines based on
+# their radius by passing ``array=radii``.
 
-N = 50
-x = np.arange(N)
-ys = [x + i for i in x]  # Many sets of y to plot vs. x
-segs = [np.column_stack([x, y]) for y in ys]
+num_arcs = 15
+theta = np.linspace(0, np.pi, 36)
+radii = np.linspace(4, 5.5, num=num_arcs)
+arcs = [np.column_stack([r * np.cos(theta), r * np.sin(theta)]) for r in radii]
 
-fig, ax = plt.subplots()
-ax.set_xlim(np.min(x), np.max(x))
-ax.set_ylim(np.min(ys), np.max(ys))
+fig, ax = plt.subplots(figsize=(6.4, 3))
+# set axes limits manually because Collections do not take part in autoscaling
+ax.set_xlim(-6, 6)
+ax.set_ylim(0, 6)
+ax.set_aspect("equal")  # to make the arcs look circular
 
-line_segments = LineCollection(segs, array=x,
-                               linewidths=(0.5, 1, 1.5, 2),
-                               linestyles='solid')
-ax.add_collection(line_segments)
-axcb = fig.colorbar(line_segments)
-axcb.set_label('Line Number')
-ax.set_title('Line Collection with mapped colors')
-plt.sci(line_segments)  # This allows interactive changing of the colormap.
-plt.show()
+# create a LineCollection with the half-circles and color mapping
+line_collection = LineCollection(arcs, array=radii, cmap="rainbow")
+ax.add_collection(line_collection)
 
+fig.colorbar(line_collection, label="Radius")
+ax.set_title("Line Collection with mapped colors")
+
+plt.show()
 # %%
 #
 # .. admonition:: References
@@ -73,9 +64,7 @@
 #    The use of the following functions, methods, classes and modules is shown
 #    in this example:
 #
-#    - `matplotlib.collections`
 #    - `matplotlib.collections.LineCollection`
-#    - `matplotlib.cm.ScalarMappable.set_array`
+#    - `matplotlib.collections.Collection.set_array`
 #    - `matplotlib.axes.Axes.add_collection`
 #    - `matplotlib.figure.Figure.colorbar` / `matplotlib.pyplot.colorbar`
-#    - `matplotlib.pyplot.sci`

From bffdc18cbf3052eb997c1bb9a775206aa6c4034a Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 7 Mar 2024 02:34:54 -0500
Subject: [PATCH 0825/1120] Modernize macosx backend a bit

Modify `PyTypeObject` definitions to match the 3.9 C-embedding tutorial.
Use `PyDoc_STR` for possible optimization purposes. Re-order fields in a
bit clearer manner (object information, new+init, dealloc, repr,
methods). And finally, use the new `PyModule_AddType`, which does what
our `prepare_and_add_type` inline function does.
---
 src/_macosx.m | 109 ++++++++++++++++++++++++++++----------------------
 1 file changed, 62 insertions(+), 47 deletions(-)

diff --git a/src/_macosx.m b/src/_macosx.m
index 299fed1785a8..9945ad30f999 100755
--- a/src/_macosx.m
+++ b/src/_macosx.m
@@ -2,7 +2,6 @@
 #include <Cocoa/Cocoa.h>
 #include <ApplicationServices/ApplicationServices.h>
 #include <Python.h>
-#include "mplutils.h"
 
 /* Proper way to check for the OS X version we are compiling for, from
  * https://developer.apple.com/library/archive/documentation/DeveloperTools/Conceptual/cross_development/Using/using.html
@@ -258,20 +257,21 @@ static CGFloat _get_device_scale(CGContextRef cr)
     return pixelSize.width;
 }
 
-int mpl_check_modifier(
+bool
+mpl_check_modifier(
         NSUInteger modifiers, NSEventModifierFlags flag,
         PyObject* list, char const* name)
 {
-    int status = 0;
+    bool failed = false;
     if (modifiers & flag) {
         PyObject* py_name = NULL;
         if (!(py_name = PyUnicode_FromString(name))
             || PyList_Append(list, py_name)) {
-            status = -1;  // failure
+            failed = true;
         }
         Py_XDECREF(py_name);
     }
-    return status;
+    return failed;
 }
 
 PyObject* mpl_modifiers(NSEvent* event)
@@ -498,14 +498,16 @@ int mpl_check_modifier(
 
 static PyTypeObject FigureCanvasType = {
     PyVarObject_HEAD_INIT(NULL, 0)
-    .tp_name = "_macosx.FigureCanvas",
+    .tp_name = "matplotlib.backends._macosx.FigureCanvas",
+    .tp_doc = PyDoc_STR("A FigureCanvas object wraps a Cocoa NSView object."),
     .tp_basicsize = sizeof(FigureCanvas),
-    .tp_dealloc = (destructor)FigureCanvas_dealloc,
-    .tp_repr = (reprfunc)FigureCanvas_repr,
     .tp_flags = Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE,
-    .tp_init = (initproc)FigureCanvas_init,
+
     .tp_new = (newfunc)FigureCanvas_new,
-    .tp_doc = "A FigureCanvas object wraps a Cocoa NSView object.",
+    .tp_init = (initproc)FigureCanvas_init,
+    .tp_dealloc = (destructor)FigureCanvas_dealloc,
+    .tp_repr = (reprfunc)FigureCanvas_repr,
+
     .tp_methods = (PyMethodDef[]){
         {"update",
          (PyCFunction)FigureCanvas_update,
@@ -518,15 +520,15 @@ int mpl_check_modifier(
         {"set_cursor",
          (PyCFunction)FigureCanvas_set_cursor,
          METH_VARARGS,
-         "Set the active cursor."},
+         PyDoc_STR("Set the active cursor.")},
         {"set_rubberband",
          (PyCFunction)FigureCanvas_set_rubberband,
          METH_VARARGS,
-         "Specify a new rubberband rectangle and invalidate it."},
+         PyDoc_STR("Specify a new rubberband rectangle and invalidate it.")},
         {"remove_rubberband",
          (PyCFunction)FigureCanvas_remove_rubberband,
          METH_NOARGS,
-         "Remove the current rubberband rectangle."},
+         PyDoc_STR("Remove the current rubberband rectangle.")},
         {"_start_event_loop",
          (PyCFunction)FigureCanvas__start_event_loop,
          METH_KEYWORDS | METH_VARARGS,
@@ -745,14 +747,16 @@ int mpl_check_modifier(
 
 static PyTypeObject FigureManagerType = {
     PyVarObject_HEAD_INIT(NULL, 0)
-    .tp_name = "_macosx.FigureManager",
+    .tp_name = "matplotlib.backends._macosx.FigureManager",
+    .tp_doc = PyDoc_STR("A FigureManager object wraps a Cocoa NSWindow object."),
     .tp_basicsize = sizeof(FigureManager),
-    .tp_dealloc = (destructor)FigureManager_dealloc,
-    .tp_repr = (reprfunc)FigureManager_repr,
     .tp_flags = Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE,
-    .tp_init = (initproc)FigureManager_init,
+
     .tp_new = (newfunc)FigureManager_new,
-    .tp_doc = "A FigureManager object wraps a Cocoa NSWindow object.",
+    .tp_init = (initproc)FigureManager_init,
+    .tp_dealloc = (destructor)FigureManager_dealloc,
+    .tp_repr = (reprfunc)FigureManager_repr,
+
     .tp_methods = (PyMethodDef[]){  // All docstrings are inherited.
         {"_show",
          (PyCFunction)FigureManager__show,
@@ -766,11 +770,11 @@ int mpl_check_modifier(
         {"_set_window_mode",
          (PyCFunction)FigureManager__set_window_mode,
          METH_VARARGS,
-         "Set the window open mode (system, tab, window)"},
+         PyDoc_STR("Set the window open mode (system, tab, window)")},
         {"set_icon",
          (PyCFunction)FigureManager_set_icon,
          METH_STATIC | METH_VARARGS,
-         "Set application icon"},
+         PyDoc_STR("Set application icon")},
         {"set_window_title",
          (PyCFunction)FigureManager_set_window_title,
          METH_VARARGS},
@@ -826,8 +830,7 @@ - (NavigationToolbar2Handler*)initWithToolbar:(PyObject*)theToolbar
 
 - (void)installCallbacks:(SEL[7])actions forButtons:(NSButton*[7])buttons
 {
-    int i;
-    for (i = 0; i < 7; i++) {
+    for (int i = 0; i < 7; i++) {
         SEL action = actions[i];
         NSButton* button = buttons[i];
         [button setTarget: self];
@@ -1036,14 +1039,16 @@ -(void)save_figure:(id)sender { gil_call_method(toolbar, "save_figure"); }
 
 static PyTypeObject NavigationToolbar2Type = {
     PyVarObject_HEAD_INIT(NULL, 0)
-    .tp_name = "_macosx.NavigationToolbar2",
+    .tp_name = "matplotlib.backends._macosx.NavigationToolbar2",
+    .tp_doc = PyDoc_STR("NavigationToolbar2"),
     .tp_basicsize = sizeof(NavigationToolbar2),
-    .tp_dealloc = (destructor)NavigationToolbar2_dealloc,
-    .tp_repr = (reprfunc)NavigationToolbar2_repr,
     .tp_flags = Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE,
-    .tp_init = (initproc)NavigationToolbar2_init,
+
     .tp_new = (newfunc)NavigationToolbar2_new,
-    .tp_doc = "NavigationToolbar2",
+    .tp_init = (initproc)NavigationToolbar2_init,
+    .tp_dealloc = (destructor)NavigationToolbar2_dealloc,
+    .tp_repr = (reprfunc)NavigationToolbar2_repr,
+
     .tp_methods = (PyMethodDef[]){  // All docstrings are inherited.
         {"set_message",
          (PyCFunction)NavigationToolbar2_set_message,
@@ -1782,13 +1787,16 @@ - (void)flagsChanged:(NSEvent *)event
 
 static PyTypeObject TimerType = {
     PyVarObject_HEAD_INIT(NULL, 0)
-    .tp_name = "_macosx.Timer",
+    .tp_name = "matplotlib.backends._macosx.Timer",
+    .tp_doc = PyDoc_STR("A Timer object that contains an NSTimer that gets added to "
+                        "the event loop when started."),
     .tp_basicsize = sizeof(Timer),
-    .tp_dealloc = (destructor)Timer_dealloc,
-    .tp_repr = (reprfunc)Timer_repr,
     .tp_flags = Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE,
+
     .tp_new = (newfunc)Timer_new,
-    .tp_doc = "A Timer object that contains an NSTimer that gets added to the event loop when started.",
+    .tp_dealloc = (destructor)Timer_dealloc,
+    .tp_repr = (reprfunc)Timer_repr,
+
     .tp_methods = (PyMethodDef[]){  // All docstrings are inherited.
         {"_timer_start",
          (PyCFunction)Timer__timer_start,
@@ -1801,46 +1809,53 @@ - (void)flagsChanged:(NSEvent *)event
 };
 
 static struct PyModuleDef moduledef = {
-    PyModuleDef_HEAD_INIT, "_macosx", "Mac OS X native backend", -1,
-    (PyMethodDef[]){
+    .m_base = PyModuleDef_HEAD_INIT,
+    .m_name = "_macosx",
+    .m_doc = PyDoc_STR("Mac OS X native backend"),
+    .m_size = -1,
+    .m_methods = (PyMethodDef[]){
         {"event_loop_is_running",
          (PyCFunction)event_loop_is_running,
          METH_NOARGS,
-         "Return whether the macosx backend has set up the NSApp main event loop."},
+         PyDoc_STR(
+            "Return whether the macosx backend has set up the NSApp main event loop.")},
         {"wake_on_fd_write",
          (PyCFunction)wake_on_fd_write,
          METH_VARARGS,
-         "Arrange for Python to invoke its signal handlers when (any) data is\n"
-         "written on the file descriptor given as argument."},
+         PyDoc_STR(
+            "Arrange for Python to invoke its signal handlers when (any) data is\n"
+            "written on the file descriptor given as argument.")},
         {"stop",
          (PyCFunction)stop,
          METH_NOARGS,
-         "Stop the NSApp."},
+         PyDoc_STR("Stop the NSApp.")},
         {"show",
          (PyCFunction)show,
          METH_NOARGS,
-         "Show all the figures and enter the main loop.\n"
-         "\n"
-         "This function does not return until all Matplotlib windows are closed,\n"
-         "and is normally not needed in interactive sessions."},
+         PyDoc_STR(
+            "Show all the figures and enter the main loop.\n"
+            "\n"
+            "This function does not return until all Matplotlib windows are closed,\n"
+            "and is normally not needed in interactive sessions.")},
         {"choose_save_file",
          (PyCFunction)choose_save_file,
          METH_VARARGS,
-         "Query the user for a location where to save a file."},
+         PyDoc_STR("Query the user for a location where to save a file.")},
         {}  /* Sentinel */
     },
 };
 
 #pragma GCC visibility push(default)
 
-PyObject* PyInit__macosx(void)
+PyMODINIT_FUNC
+PyInit__macosx(void)
 {
     PyObject *m;
     if (!(m = PyModule_Create(&moduledef))
-        || prepare_and_add_type(&FigureCanvasType, m)
-        || prepare_and_add_type(&FigureManagerType, m)
-        || prepare_and_add_type(&NavigationToolbar2Type, m)
-        || prepare_and_add_type(&TimerType, m)) {
+        || PyModule_AddType(m, &FigureCanvasType)
+        || PyModule_AddType(m, &FigureManagerType)
+        || PyModule_AddType(m, &NavigationToolbar2Type)
+        || PyModule_AddType(m, &TimerType)) {
         Py_XDECREF(m);
         return NULL;
     }

From 767a51ce6ce54fffdb9ea4ea5899dfe28e340ec8 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 8 Mar 2024 06:02:15 -0500
Subject: [PATCH 0826/1120] BLD: Add a fallback URL for FreeType

FreeType is available from both Savannah and SourceForge, and sometimes
AppVeyor seems to have trouble downloading from Savannah, so perhaps
this fallback will help. We used to try both these URLs in the pre-Meson
build system.
---
 subprojects/freetype-2.6.1.wrap | 1 +
 1 file changed, 1 insertion(+)

diff --git a/subprojects/freetype-2.6.1.wrap b/subprojects/freetype-2.6.1.wrap
index 9da2890cdac8..763362b84df0 100644
--- a/subprojects/freetype-2.6.1.wrap
+++ b/subprojects/freetype-2.6.1.wrap
@@ -1,5 +1,6 @@
 [wrap-file]
 source_url = https://download.savannah.gnu.org/releases/freetype/freetype-old/freetype-2.6.1.tar.gz
+source_fallback_url = https://downloads.sourceforge.net/project/freetype/freetype2/2.6.1/freetype-2.6.1.tar.gz
 source_filename = freetype-2.6.1.tar.gz
 source_hash = 0a3c7dfbda6da1e8fce29232e8e96d987ababbbf71ebc8c75659e4132c367014
 

From 64aa6d7fb67192f06542e36cd34d5ed13e218c64 Mon Sep 17 00:00:00 2001
From: Ian Thomas <ianthomas23@gmail.com>
Date: Fri, 8 Mar 2024 12:12:13 +0000
Subject: [PATCH 0827/1120] Remove unneeded type annotations

---
 lib/matplotlib/backends/registry.pyi | 1 -
 lib/matplotlib/rcsetup.pyi           | 2 --
 2 files changed, 3 deletions(-)

diff --git a/lib/matplotlib/backends/registry.pyi b/lib/matplotlib/backends/registry.pyi
index ef3579bcd271..e48531be471d 100644
--- a/lib/matplotlib/backends/registry.pyi
+++ b/lib/matplotlib/backends/registry.pyi
@@ -7,7 +7,6 @@ class BackendFilter(Enum):
 
 
 class BackendRegistry:
-    def __init__(self) -> None: ...
     def backend_for_gui_framework(self, interactive_framework: str) -> str | None: ...
     def list_builtin(self, filter_: BackendFilter | None) -> list[str]: ...
 
diff --git a/lib/matplotlib/rcsetup.pyi b/lib/matplotlib/rcsetup.pyi
index 1d393e2797b0..1538dac7510e 100644
--- a/lib/matplotlib/rcsetup.pyi
+++ b/lib/matplotlib/rcsetup.pyi
@@ -8,8 +8,6 @@ interactive_bk: list[str]
 non_interactive_bk: list[str]
 all_backends: list[str]
 
-def __dir__() -> list[str]: ...
-
 _T = TypeVar("_T")
 
 def _listify_validator(s: Callable[[Any], _T]) -> Callable[[Any], list[_T]]: ...

From cd3195419e23849466807ca3761760fa2e79f054 Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Fri, 8 Mar 2024 18:08:12 +0000
Subject: [PATCH 0828/1120] DOC: fix stray release note entry

---
 doc/api/prev_api_changes/api_changes_3.7.0/behaviour.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/doc/api/prev_api_changes/api_changes_3.7.0/behaviour.rst b/doc/api/prev_api_changes/api_changes_3.7.0/behaviour.rst
index 2425087c6175..2409eb2a5dd0 100644
--- a/doc/api/prev_api_changes/api_changes_3.7.0/behaviour.rst
+++ b/doc/api/prev_api_changes/api_changes_3.7.0/behaviour.rst
@@ -120,14 +120,13 @@ dtype and *levels* is not specified, *levels* now defaults to ``[0.5]`` for
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 This can occur if the user explicitly passes a ``levels`` array with no values
+between ``z.min()`` and ``z.max()``; or if ``z`` has the same value everywhere.
 
 ``AxesImage.set_extent`` now raises ``TypeError`` for unknown keyword arguments
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 It previously raised a `ValueError`.
 
-etween ``z.min()`` and ``z.max()``; or if ``z`` has the same value everywhere.
-
 Change of ``legend(loc="best")`` behavior
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 79fdb09d33bfb5471e3227dd93cfea89302499e8 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Fri, 8 Mar 2024 23:51:20 +0100
Subject: [PATCH 0829/1120] DOC: State approximate documentation build time

Since the doc build takes very long, an order-of-magnitude estimate
is helpful to manage expectations.

I'm not wedded to the actual numbers, if somebody has better
suggestions. A quick test on an old i7 6700 (from 2015) yielded

- `O=-j1`: 23min
- `O=-j4`: 15min

Doc build on CI is around 18min.
---
 doc/devel/document.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/doc/devel/document.rst b/doc/devel/document.rst
index 476a40c320b8..21761e9f24b4 100644
--- a/doc/devel/document.rst
+++ b/doc/devel/document.rst
@@ -64,6 +64,11 @@ used. To build the documentation in html format, cd into :file:`doc/` and run:
 
    make html
 
+.. note::
+
+   Since the documentation is very large, the first build may take 10-20 minutes,
+   depending on your machine.  Subsequent builds will be faster.
+
 Other useful invocations include
 
 .. code-block:: sh

From cc59fc405962cdb8b6a18188e976b6975cb9afaf Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Sat, 9 Mar 2024 02:07:28 -0500
Subject: [PATCH 0830/1120] Mark triangulation classes as final

Prior to their conversion to pybind11 classes in #24522, these types
had `tp_flags = Py_TPFLAGS_DEFAULT`, meaning they did not have the
`Py_TPFLAGS_BASETYPE` flag and could not be subtyped. As these are
internal classes, I don't believe this was intentionally changed, so
restore that flag.

Additionally, since we require C++17 now, mark the C++ classes
themselves as `final`. I believe this really only makes a difference if
we have `virtual` methods (which we don't here), but that doesn't mean
the compiler can't infer some other optimizations with this information.
---
 lib/matplotlib/_tri.pyi  |  5 ++++-
 src/tri/_tri.h           | 28 ++++++++++++++--------------
 src/tri/_tri_wrapper.cpp |  6 +++---
 3 files changed, 21 insertions(+), 18 deletions(-)

diff --git a/lib/matplotlib/_tri.pyi b/lib/matplotlib/_tri.pyi
index cab7fcf2bc70..b6e79d7140b3 100644
--- a/lib/matplotlib/_tri.pyi
+++ b/lib/matplotlib/_tri.pyi
@@ -1,8 +1,9 @@
 # This is a private module implemented in C++
 # As such these type stubs are overly generic, but here to allow these types
 # as return types for public methods
-from typing import Any
+from typing import Any, final
 
+@final
 class TrapezoidMapTriFinder:
     def __init__(self, *args, **kwargs) -> None: ...
     def find_many(self, *args, **kwargs) -> Any: ...
@@ -10,11 +11,13 @@ class TrapezoidMapTriFinder:
     def initialize(self, *args, **kwargs) -> Any: ...
     def print_tree(self, *args, **kwargs) -> Any: ...
 
+@final
 class TriContourGenerator:
     def __init__(self, *args, **kwargs) -> None: ...
     def create_contour(self, *args, **kwargs) -> Any: ...
     def create_filled_contour(self, *args, **kwargs) -> Any: ...
 
+@final
 class Triangulation:
     def __init__(self, *args, **kwargs) -> None: ...
     def calculate_plane_coefficients(self, *args, **kwargs) -> Any: ...
diff --git a/src/tri/_tri.h b/src/tri/_tri.h
index c176b4c0e8f5..cfdfd827124c 100644
--- a/src/tri/_tri.h
+++ b/src/tri/_tri.h
@@ -78,7 +78,7 @@ namespace py = pybind11;
 /* An edge of a triangle consisting of an triangle index in the range 0 to
  * ntri-1 and an edge index in the range 0 to 2.  Edge i goes from the
  * triangle's point i to point (i+1)%3. */
-struct TriEdge
+struct TriEdge final
 {
     TriEdge();
     TriEdge(int tri_, int edge_);
@@ -111,7 +111,7 @@ struct XY
 };
 
 // 3D point with x,y,z coordinates.
-struct XYZ
+struct XYZ final
 {
     XYZ(const double& x_, const double& y_, const double& z_);
     XYZ cross(const XYZ& other) const;
@@ -123,7 +123,7 @@ struct XYZ
 };
 
 // 2D bounding box, which may be empty.
-class BoundingBox
+class BoundingBox final
 {
 public:
     BoundingBox();
@@ -138,7 +138,7 @@ class BoundingBox
 /* A single line of a contour, which may be a closed line loop or an open line
  * strip.  Identical adjacent points are avoided using push_back(), and a closed
  * line loop should also not have identical first and last points. */
-class ContourLine : public std::vector<XY>
+class ContourLine final : public std::vector<XY>
 {
 public:
     ContourLine();
@@ -157,7 +157,7 @@ void write_contour(const Contour& contour);
 
 /* Triangulation with npoints points and ntri triangles.  Derived fields are
  * calculated when they are first needed. */
-class Triangulation
+class Triangulation final
 {
 public:
     typedef py::array_t<double, py::array::c_style | py::array::forcecast> CoordinateArray;
@@ -254,7 +254,7 @@ class Triangulation
 
 private:
     // An edge of a triangulation, composed of start and end point indices.
-    struct Edge
+    struct Edge final
     {
         Edge() : start(-1), end(-1) {}
         Edge(int start_, int end_) : start(start_), end(end_) {}
@@ -267,7 +267,7 @@ class Triangulation
     /* An edge of a boundary of a triangulation, composed of a boundary index
      * and an edge index within that boundary.  Used to index into the
      * boundaries collection to obtain the corresponding TriEdge. */
-    struct BoundaryEdge
+    struct BoundaryEdge final
     {
         BoundaryEdge() : boundary(-1), edge(-1) {}
         BoundaryEdge(int boundary_, int edge_)
@@ -328,7 +328,7 @@ class Triangulation
 
 
 // Contour generator for a triangulation.
-class TriContourGenerator
+class TriContourGenerator final
 {
 public:
     typedef Triangulation::CoordinateArray CoordinateArray;
@@ -508,7 +508,7 @@ class TriContourGenerator
  * colinear points but only in the simplest of cases.  No explicit testing of
  * the validity of the triangulation is performed as this is a computationally
  * more complex task than the trifinding itself. */
-class TrapezoidMapTriFinder
+class TrapezoidMapTriFinder final
 {
 public:
     typedef Triangulation::CoordinateArray CoordinateArray;
@@ -551,7 +551,7 @@ class TrapezoidMapTriFinder
     /* A Point consists of x,y coordinates as well as the index of a triangle
      * associated with the point, so that a search at this point's coordinates
      * can return a valid triangle index. */
-    struct Point : XY
+    struct Point final : XY
     {
         Point() : XY(), tri(-1) {}
         Point(const double& x, const double& y) : XY(x,y), tri(-1) {}
@@ -565,7 +565,7 @@ class TrapezoidMapTriFinder
      * the Edge which are used to map from trapezoid to triangle index.  Also
      * stores pointers to the 3rd points of the below and above triangles,
      * which are only used to disambiguate triangles with colinear points. */
-    struct Edge
+    struct Edge final
     {
         Edge(const Point* left_,
              const Point* right_,
@@ -608,7 +608,7 @@ class TrapezoidMapTriFinder
     class Node;  // Forward declaration.
 
     // Helper structure used by TrapezoidMapTriFinder::get_tree_stats.
-    struct NodeStats
+    struct NodeStats final
     {
         NodeStats()
             : node_count(0), trapezoid_count(0), max_parent_count(0),
@@ -632,7 +632,7 @@ class TrapezoidMapTriFinder
      * The parent collection acts as a reference count to the number of times
      * a Node occurs in the search tree.  When the parent count is reduced to
      * zero a Node can be safely deleted. */
-    class Node
+    class Node final
     {
     public:
         Node(const Point* point, Node* left, Node* right);// Type_XNode.
@@ -717,7 +717,7 @@ class TrapezoidMapTriFinder
      * To obtain the index of the triangle corresponding to a particular
      * Trapezoid, use the Edge member variables below.triangle_above or
      * above.triangle_below. */
-    struct Trapezoid
+    struct Trapezoid final
     {
         Trapezoid(const Point* left_,
                   const Point* right_,
diff --git a/src/tri/_tri_wrapper.cpp b/src/tri/_tri_wrapper.cpp
index d6c4fb10c5d0..54d1c32e9c57 100644
--- a/src/tri/_tri_wrapper.cpp
+++ b/src/tri/_tri_wrapper.cpp
@@ -3,7 +3,7 @@
 using namespace pybind11::literals;
 
 PYBIND11_MODULE(_tri, m) {
-    py::class_<Triangulation>(m, "Triangulation")
+    py::class_<Triangulation>(m, "Triangulation", py::is_final())
         .def(py::init<const Triangulation::CoordinateArray&,
                       const Triangulation::CoordinateArray&,
                       const Triangulation::TriangleArray&,
@@ -30,7 +30,7 @@ PYBIND11_MODULE(_tri, m) {
         .def("set_mask", &Triangulation::set_mask,
             "Set or clear the mask array.");
 
-    py::class_<TriContourGenerator>(m, "TriContourGenerator")
+    py::class_<TriContourGenerator>(m, "TriContourGenerator", py::is_final())
         .def(py::init<Triangulation&,
                       const TriContourGenerator::CoordinateArray&>(),
             "triangulation"_a,
@@ -43,7 +43,7 @@ PYBIND11_MODULE(_tri, m) {
         .def("create_filled_contour", &TriContourGenerator::create_filled_contour,
             "Create and return a filled contour.");
 
-    py::class_<TrapezoidMapTriFinder>(m, "TrapezoidMapTriFinder")
+    py::class_<TrapezoidMapTriFinder>(m, "TrapezoidMapTriFinder", py::is_final())
         .def(py::init<Triangulation&>(),
             "triangulation"_a,
             "Create a new C++ TrapezoidMapTriFinder object.\n"

From df968b5ca57397f2fd5da40d53f7fd15b6d2b208 Mon Sep 17 00:00:00 2001
From: chaoyihu <90495101+chaoyihu@users.noreply.github.com>
Date: Sat, 9 Mar 2024 03:26:01 -0800
Subject: [PATCH 0831/1120] Make sure custom alpha param does not change 'none'
 colors in a list of colors (#27845)

* fix issue 27839, make sure alpha param does not affect none colors
Apply review feedbacks

Co-authored-by: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>

* Update lib/matplotlib/colors.py

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>

---------

Co-authored-by: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>
---
 lib/matplotlib/colors.py            |  5 +++++
 lib/matplotlib/tests/test_colors.py | 11 +++++++++++
 2 files changed, 16 insertions(+)

diff --git a/lib/matplotlib/colors.py b/lib/matplotlib/colors.py
index 9a493c928fdb..c0f86ea75bc2 100644
--- a/lib/matplotlib/colors.py
+++ b/lib/matplotlib/colors.py
@@ -506,6 +506,11 @@ def to_rgba_array(c, alpha=None):
 
     if alpha is not None:
         rgba[:, 3] = alpha
+        if isinstance(c, Sequence):
+            # ensure that an explicit alpha does not overwrite full transparency
+            # for "none"
+            none_mask = [cbook._str_equal(cc, "none") for cc in c]
+            rgba[:, 3][none_mask] = 0
     return rgba
 
 
diff --git a/lib/matplotlib/tests/test_colors.py b/lib/matplotlib/tests/test_colors.py
index 5b5332100c2a..63f2d4f00399 100644
--- a/lib/matplotlib/tests/test_colors.py
+++ b/lib/matplotlib/tests/test_colors.py
@@ -19,6 +19,7 @@
 import matplotlib.scale as mscale
 from matplotlib.rcsetup import cycler
 from matplotlib.testing.decorators import image_comparison, check_figures_equal
+from matplotlib.colors import to_rgba_array
 
 
 @pytest.mark.parametrize('N, result', [
@@ -1686,3 +1687,13 @@ def test_set_cmap_mismatched_name():
     cmap_returned = plt.get_cmap("wrong-cmap")
     assert cmap_returned == cmap
     assert cmap_returned.name == "wrong-cmap"
+
+
+def test_to_rgba_array_none_color_with_alpha_param():
+    # effective alpha for color "none" must always be 0 to achieve a vanishing color
+    # even explicit alpha must be ignored
+    c = ["blue", "none"]
+    alpha = [1, 1]
+    assert_array_equal(
+        to_rgba_array(c, alpha), [[0., 0., 1., 1.], [0., 0., 0., 0.]]
+    )

From 3a7277d4f0da5cc02d018e4b14979227f8402289 Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Sun, 10 Mar 2024 10:12:46 +0000
Subject: [PATCH 0832/1120] Remove versions from sidebar in docs

---
 doc/conf.py                 | 1 -
 doc/devel/release_guide.rst | 1 -
 2 files changed, 2 deletions(-)

diff --git a/doc/conf.py b/doc/conf.py
index e33687773b32..4f9c0f732027 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -547,7 +547,6 @@ def js_tag_with_cache_busting(js):
 html_sidebars = {
     "index": [
         # 'sidebar_announcement.html',
-        "sidebar_versions.html",
         "cheatsheet_sidebar.html",
         "donate_sidebar.html",
     ],
diff --git a/doc/devel/release_guide.rst b/doc/devel/release_guide.rst
index fbb26ca37a26..5034bde1eefc 100644
--- a/doc/devel/release_guide.rst
+++ b/doc/devel/release_guide.rst
@@ -443,7 +443,6 @@ which will copy the built docs over.  If this is a final release, link the
   rm stable
   ln -s 3.7.0 stable
 
-You will need to manually edit :file:`versions.html` to show the released version.
 You will also need to edit :file:`sitemap.xml` to include
 the newly released version.  Now commit and push everything to GitHub ::
 

From 434f76690b8cf63f0a96c7bd9bfb42b11897827c Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Sun, 10 Mar 2024 11:30:40 +0000
Subject: [PATCH 0833/1120] Remove empty user guide tutorials page

---
 doc/conf.py                       | 5 ++++-
 doc/users/index.rst               | 1 -
 galleries/users_explain/index.rst | 4 +++-
 3 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/doc/conf.py b/doc/conf.py
index e33687773b32..b95603930393 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -130,7 +130,10 @@ def _parse_skip_subdirs_file():
 ]
 
 exclude_patterns = [
-    'api/prev_api_changes/api_changes_*/*', '**/*inc.rst']
+    'api/prev_api_changes/api_changes_*/*',
+    '**/*inc.rst',
+    'users/explain/index.rst'  # Page has no content, but required by sphinx gallery
+]
 
 exclude_patterns += skip_subdirs
 
diff --git a/doc/users/index.rst b/doc/users/index.rst
index 64317fd61607..eacb72749f81 100644
--- a/doc/users/index.rst
+++ b/doc/users/index.rst
@@ -101,6 +101,5 @@ Using Matplotlib
 .. toctree::
     :hidden:
 
-    explain/index
     getting_started/index
     installing/index
diff --git a/galleries/users_explain/index.rst b/galleries/users_explain/index.rst
index 46951ede91ab..aacf3bf18acf 100644
--- a/galleries/users_explain/index.rst
+++ b/galleries/users_explain/index.rst
@@ -1,4 +1,6 @@
-.. _users-guide-explain:
+..
+    This page is required by sphinx-gallery,
+    but is not rendered in the final doc build.
 
 ====================
 User guide tutorials

From 1819d374df7a3421b7a69944d5f95b9518e4b7f8 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Sun, 10 Mar 2024 21:19:07 +0100
Subject: [PATCH 0834/1120] FIX: Restore D213 in flake8

This got accidentally ignored in #25147.

We want D213 (#17125, #17193)
https://matplotlib.org/devdocs/devel/document.html#quote-positions
---
 .flake8                  | 4 +++-
 lib/matplotlib/pyplot.py | 3 ++-
 tools/gh_api.py          | 3 +--
 3 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/.flake8 b/.flake8
index 40c07e0e324b..b568af917f46 100644
--- a/.flake8
+++ b/.flake8
@@ -18,7 +18,9 @@ ignore =
     D301,
     D400, D401, D403, D404
     # ignored by pydocstyle numpy docstring convention
-    D107, D203, D212, D213, D402, D413, D415, D416, D417,
+    D107, D203, D212, D402, D413, D415, D416, D417,
+    # while D213 is ignored by the numpy docstring convention, it's left out above,
+    # because we want to enforce it.
 
 exclude =
     .git
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 6318b99539df..59fc02000983 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -1002,7 +1002,8 @@ def gcf() -> Figure:
 
 
 def fignum_exists(num: int | str) -> bool:
-    """Return whether the figure with the given id exists.
+    """
+    Return whether the figure with the given id exists.
 
     Parameters
     ----------
diff --git a/tools/gh_api.py b/tools/gh_api.py
index 2590fe712bd4..10119793ede9 100644
--- a/tools/gh_api.py
+++ b/tools/gh_api.py
@@ -97,8 +97,7 @@ def post_gist(content, description='', filename='file', auth=False):
     return response_data['html_url']
 
 def get_pull_request(project, num, auth=False):
-    """get pull request info  by number
-    """
+    """Return the pull request info for a given PR number."""
     url = f"https://api.github.com/repos/{project}/pulls/{num}"
     if auth:
         header = make_auth_header()

From 808365015029166c8195eec72a9187f61c5e4632 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Sun, 10 Mar 2024 22:48:01 +0100
Subject: [PATCH 0835/1120] Improved error message for malformed colors

Implements the suggestion https://github
.com/matplotlib/matplotlib/issues/27378#issuecomment-1830271599.

Closes #27378.
---
 lib/matplotlib/colors.py | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/colors.py b/lib/matplotlib/colors.py
index b2ec3733fe3c..2c8f48623b8c 100644
--- a/lib/matplotlib/colors.py
+++ b/lib/matplotlib/colors.py
@@ -243,7 +243,14 @@ def _check_color_like(**kwargs):
     """
     for k, v in kwargs.items():
         if not is_color_like(v):
-            raise ValueError(f"{v!r} is not a valid value for {k}")
+            raise ValueError(
+                f"{v!r} is not a valid value for {k}: supported inputs are "
+                f"(r, g, b) and (r, g, b, a) 0-1 float tuples; "
+                f"'#rrggbb', '#rrggbbaa', '#rgb', '#rgba' strings; "
+                f"named color strings; "
+                f"string reprs of 0-1 floats for grayscale values; "
+                f"'C0', 'C1', ... strings for colors of the color cycle; "
+                f"and pairs combining one of the above with an alpha value")
 
 
 def same_color(c1, c2):

From 00b6c3cb8668a6a5e437a0f8f8eaeee7b7be8dc7 Mon Sep 17 00:00:00 2001
From: Chaoyi Hu <chaoyihu.work@gmail.com>
Date: Sun, 10 Mar 2024 20:42:36 -0700
Subject: [PATCH 0836/1120] Override open_group, close_group methods in
 PathEffectRenderer

---
 lib/matplotlib/patheffects.py            |  6 ++++++
 lib/matplotlib/tests/test_patheffects.py | 19 +++++++++++++++++++
 2 files changed, 25 insertions(+)

diff --git a/lib/matplotlib/patheffects.py b/lib/matplotlib/patheffects.py
index 110868717936..cf159ddc4023 100644
--- a/lib/matplotlib/patheffects.py
+++ b/lib/matplotlib/patheffects.py
@@ -152,6 +152,12 @@ def __getattribute__(self, name):
         else:
             return object.__getattribute__(self, name)
 
+    def open_group(self, s, gid=None):
+        return self._renderer.open_group(s, gid)
+
+    def close_group(self, s):
+        return self._renderer.close_group(s)
+
 
 class Normal(AbstractPathEffect):
     """
diff --git a/lib/matplotlib/tests/test_patheffects.py b/lib/matplotlib/tests/test_patheffects.py
index 32cce14178a9..b86cca548854 100644
--- a/lib/matplotlib/tests/test_patheffects.py
+++ b/lib/matplotlib/tests/test_patheffects.py
@@ -5,6 +5,8 @@
 import matplotlib.patheffects as path_effects
 from matplotlib.path import Path
 import matplotlib.patches as patches
+from matplotlib.backend_bases import RendererBase
+from matplotlib.patheffects import PathEffectRenderer
 
 
 @image_comparison(['patheffect1'], remove_text=True)
@@ -192,3 +194,20 @@ def test_patheffects_spaces_and_newlines():
                     bbox={'color': 'thistle'})
     text1.set_path_effects([path_effects.Normal()])
     text2.set_path_effects([path_effects.Normal()])
+
+
+def test_patheffects_overridden_methods_open_close_group():
+    class CustomRenderer(RendererBase):
+        def __init__(self):
+            super().__init__()
+
+        def open_group(self, s, gid=None):
+            return "open_group overridden"
+
+        def close_group(self, s):
+            return "close_group overridden"
+
+    renderer = PathEffectRenderer([path_effects.Normal()], CustomRenderer())
+
+    assert renderer.open_group('s') == "open_group overridden"
+    assert renderer.close_group('s') == "close_group overridden"

From 27470763261740ff7f7f10137bf919b3e4e895cc Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Mon, 11 Mar 2024 12:57:00 +0000
Subject: [PATCH 0837/1120] Fix relative links to zenodo badges

---
 doc/project/citing.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/project/citing.rst b/doc/project/citing.rst
index c633cda42b61..9c99d7b0b389 100644
--- a/doc/project/citing.rst
+++ b/doc/project/citing.rst
@@ -31,10 +31,10 @@ By version
 
 
 v3.8.3
-   .. image:: ../../_static/zenodo_cache/10661079.svg
+   .. image:: ../_static/zenodo_cache/10661079.svg
       :target:  https://doi.org/10.5281/zenodo.10661079
 v3.8.2
-   .. image:: ../../_static/zenodo_cache/10150955.svg
+   .. image:: ../_static/zenodo_cache/10150955.svg
       :target:  https://doi.org/10.5281/zenodo.10150955
 v3.8.1
    .. image:: ../_static/zenodo_cache/10059757.svg

From 45accc82d105f189ed036bf55a2f9a8a8ab2068c Mon Sep 17 00:00:00 2001
From: Raphael <raphael.quast@geo.tuwien.ac.at>
Date: Thu, 19 Oct 2023 18:32:17 +0200
Subject: [PATCH 0838/1120] Correctly treat pan/zoom events of overlapping
 axes.

---
 doc/api/axes_api.rst                          |   3 +
 .../next_api_changes/behavior/22347-RQ.rst    |  13 ++
 .../examples/showcase/pan_zoom_overlap.py     |  70 +++++++++
 lib/matplotlib/axes/_base.py                  |  39 +++++
 lib/matplotlib/backend_bases.py               |  81 ++++++++--
 lib/matplotlib/tests/test_backend_bases.py    | 146 ++++++++++++++++++
 6 files changed, 340 insertions(+), 12 deletions(-)
 create mode 100644 doc/api/next_api_changes/behavior/22347-RQ.rst
 create mode 100644 galleries/examples/showcase/pan_zoom_overlap.py

diff --git a/doc/api/axes_api.rst b/doc/api/axes_api.rst
index 8b01a120da5b..ac4e5bc4f536 100644
--- a/doc/api/axes_api.rst
+++ b/doc/api/axes_api.rst
@@ -517,6 +517,9 @@ Interactive
    Axes.get_navigate_mode
    Axes.set_navigate_mode
 
+   Axes.get_forward_navigation_events
+   Axes.set_forward_navigation_events
+
    Axes.start_pan
    Axes.drag_pan
    Axes.end_pan
diff --git a/doc/api/next_api_changes/behavior/22347-RQ.rst b/doc/api/next_api_changes/behavior/22347-RQ.rst
new file mode 100644
index 000000000000..b99d183943a5
--- /dev/null
+++ b/doc/api/next_api_changes/behavior/22347-RQ.rst
@@ -0,0 +1,13 @@
+Correctly treat pan/zoom events of overlapping Axes
+---------------------------------------------------
+
+The forwarding of pan/zoom events is now determined by the visibility of the
+background-patch (e.g. ``ax.patch.get_visible()``) and by the ``zorder`` of the axes.
+
+- Axes with a visible patch capture the event and do not pass it on to axes below.
+  Only the Axes with the highest ``zorder`` that contains the event is triggered
+  (if there are multiple Axes with the same ``zorder``, the last added Axes counts)
+- Axes with an invisible patch are also invisible to events and they are passed on to the axes below.
+
+To override the default behavior and explicitly set whether an Axes
+should forward navigation events, use `.Axes.set_forward_navigation_events`.
diff --git a/galleries/examples/showcase/pan_zoom_overlap.py b/galleries/examples/showcase/pan_zoom_overlap.py
new file mode 100644
index 000000000000..7d6b5a993205
--- /dev/null
+++ b/galleries/examples/showcase/pan_zoom_overlap.py
@@ -0,0 +1,70 @@
+"""
+===================================
+Pan/zoom events of overlapping axes
+===================================
+
+Example to illustrate how pan/zoom events of overlapping axes are treated.
+
+
+The default is the following:
+
+- Axes with a visible patch capture pan/zoom events
+- Axes with an invisible patch forward pan/zoom events to axes below
+- Shared axes always trigger with their parent axes
+  (irrespective of the patch visibility)
+
+
+``ax.set_forward_navigation_events(val)`` can be used to override the
+default behaviour:
+
+- ``True``:  Forward navigation events to axes below.
+- ``False``: Execute navigation events only on this axes.
+- ``"auto"``: Use the default behaviour
+  (``True`` for axes with an invisible patch and ``False`` otherwise).
+
+To disable pan/zoom events completely, use ``ax.set_navigate(False)``
+"""
+
+
+import matplotlib.pyplot as plt
+
+f = plt.figure(figsize=(11, 6))
+f.suptitle("Showcase for pan/zoom events on overlapping axes.")
+
+ax = f.add_axes((.05, .05, .9, .9))
+ax.patch.set_color(".75")
+ax_twin = ax.twinx()
+
+ax1 = f.add_subplot(221)
+ax1_twin = ax1.twinx()
+ax1.text(.5, .5,
+         "Visible patch\n\n"
+         "Pan/zoom events are NOT\n"
+         "forwarded to axes below",
+         ha="center", va="center", transform=ax1.transAxes)
+
+ax11 = f.add_subplot(223, sharex=ax1, sharey=ax1)
+ax11.set_forward_navigation_events(True)
+ax11.text(.5, .5,
+          "Visible patch\n\n"
+          "Override capture behavior:\n\n"
+          "ax.set_forward_navigation_events(True)",
+          ha="center", va="center", transform=ax11.transAxes)
+
+ax2 = f.add_subplot(222)
+ax2_twin = ax2.twinx()
+ax2.patch.set_visible(False)
+ax2.text(.5, .5,
+         "Invisible patch\n\n"
+         "Pan/zoom events are\n"
+         "forwarded to axes below",
+         ha="center", va="center", transform=ax2.transAxes)
+
+ax22 = f.add_subplot(224, sharex=ax2, sharey=ax2)
+ax22.patch.set_visible(False)
+ax22.set_forward_navigation_events(False)
+ax22.text(.5, .5,
+          "Invisible patch\n\n"
+          "Override capture behavior:\n\n"
+          "ax.set_forward_navigation_events(False)",
+          ha="center", va="center", transform=ax22.transAxes)
diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index 5d612c581270..c5a5db97c710 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -577,6 +577,7 @@ def __init__(self, fig,
                  xscale=None,
                  yscale=None,
                  box_aspect=None,
+                 forward_navigation_events="auto",
                  **kwargs
                  ):
         """
@@ -611,6 +612,11 @@ def __init__(self, fig,
             Set a fixed aspect for the Axes box, i.e. the ratio of height to
             width. See `~.axes.Axes.set_box_aspect` for details.
 
+        forward_navigation_events : bool or "auto", default: "auto"
+            Control whether pan/zoom events are passed through to Axes below
+            this one. "auto" is *True* for axes with an invisible patch and
+            *False* otherwise.
+
         **kwargs
             Other optional keyword arguments:
 
@@ -646,6 +652,7 @@ def __init__(self, fig,
         self._adjustable = 'box'
         self._anchor = 'C'
         self._stale_viewlims = {name: False for name in self._axis_names}
+        self._forward_navigation_events = forward_navigation_events
         self._sharex = sharex
         self._sharey = sharey
         self.set_label(label)
@@ -4031,6 +4038,11 @@ def set_navigate(self, b):
         Parameters
         ----------
         b : bool
+
+        See Also
+        --------
+        matplotlib.axes.Axes.set_forward_navigation_events
+
         """
         self._navigate = b
 
@@ -4481,6 +4493,8 @@ def _make_twin_axes(self, *args, **kwargs):
                     [0, 0, 1, 1], self.transAxes))
         self.set_adjustable('datalim')
         twin.set_adjustable('datalim')
+        twin.set_zorder(self.zorder)
+
         self._twinned_axes.join(self, twin)
         return twin
 
@@ -4627,6 +4641,31 @@ def _label_outer_yaxis(self, *, skip_non_rectangular_axes,
             if self.yaxis.offsetText.get_position()[0] == 1:
                 self.yaxis.offsetText.set_visible(False)
 
+    def set_forward_navigation_events(self, forward):
+        """
+        Set how pan/zoom events are forwarded to Axes below this one.
+
+        Parameters
+        ----------
+        forward : bool or "auto"
+            Possible values:
+
+            - True: Forward events to other axes with lower or equal zorder.
+            - False: Events are only executed on this axes.
+            - "auto": Default behaviour (*True* for axes with an invisible
+              patch and *False* otherwise)
+
+        See Also
+        --------
+        matplotlib.axes.Axes.set_navigate
+
+        """
+        self._forward_navigation_events = forward
+
+    def get_forward_navigation_events(self):
+        """Get how pan/zoom events are forwarded to Axes below this one."""
+        return self._forward_navigation_events
+
 
 def _draw_rasterized(figure, artists, renderer):
     """
diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
index a045d3e0a8b9..a17f64d63edc 100644
--- a/lib/matplotlib/backend_bases.py
+++ b/lib/matplotlib/backend_bases.py
@@ -2995,6 +2995,63 @@ def _zoom_pan_handler(self, event):
             elif event.name == "button_release_event":
                 self.release_zoom(event)
 
+    def _start_event_axes_pan(self, event, method="zoom"):
+        # call "ax.start_pan(..)" on all relevant axes of an event
+
+        def _ax_filter(ax):
+            return (ax.in_axes(event) and
+                    ax.get_navigate() and
+                    getattr(ax, f"can_{method}")()
+                    )
+
+        def _capture_events(ax):
+            f = ax.get_forward_navigation_events()
+            if f == "auto":  # (capture = patch visibility)
+                f = not ax.patch.get_visible()
+            return not f
+
+        # get all relevant axes for the event
+        axes = list(filter(_ax_filter, self.canvas.figure.get_axes()))
+
+        if len(axes) == 0:
+            return
+
+        if self._nav_stack() is None:
+            self.push_current()   # Set the home button to this view.
+
+        # group axes by zorder (reverse to trigger later axes first)
+        grps = dict()
+        for ax in reversed(axes):
+            grps.setdefault(ax.get_zorder(), []).append(ax)
+
+        pan_axes = []
+        # go through zorders in reverse until we hit a capturing axes
+        for zorder in sorted(grps, reverse=True):
+            for ax in grps[zorder]:
+                pan_axes.append(ax)
+                # NOTE: shared axes are automatically triggered, but twin-axes not!
+                pan_axes.extend(ax._twinned_axes.get_siblings(ax))
+
+                if _capture_events(ax):
+                    break  # break if we hit a capturing axes
+            else:
+                # If the inner loop finished without an explicit break,
+                # (e.g. no capturing axes was found) continue the
+                # outer loop to the next zorder.
+                continue
+
+            # If the inner loop was terminated with an explicit break,
+            # terminate the outer loop as well.
+            break
+
+        # avoid duplicated triggers (but keep order of list)
+        pan_axes = list(dict.fromkeys(pan_axes))
+
+        for ax in pan_axes:
+            ax.start_pan(event.x, event.y, event.button)
+
+        return pan_axes
+
     def pan(self, *args):
         """
         Toggle the pan/zoom tool.
@@ -3020,16 +3077,14 @@ def press_pan(self, event):
         if (event.button not in [MouseButton.LEFT, MouseButton.RIGHT]
                 or event.x is None or event.y is None):
             return
-        axes = [a for a in self.canvas.figure.get_axes()
-                if a.in_axes(event) and a.get_navigate() and a.can_pan()]
+
+        axes = self._start_event_axes_pan(event, method="pan")
         if not axes:
             return
-        if self._nav_stack() is None:
-            self.push_current()  # set the home button to this view
-        for ax in axes:
-            ax.start_pan(event.x, event.y, event.button)
+
         self.canvas.mpl_disconnect(self._id_drag)
         id_drag = self.canvas.mpl_connect("motion_notify_event", self.drag_pan)
+
         self._pan_info = self._PanInfo(
             button=event.button, axes=axes, cid=id_drag)
 
@@ -3075,21 +3130,23 @@ def press_zoom(self, event):
         if (event.button not in [MouseButton.LEFT, MouseButton.RIGHT]
                 or event.x is None or event.y is None):
             return
-        axes = [a for a in self.canvas.figure.get_axes()
-                if a.in_axes(event) and a.get_navigate() and a.can_zoom()]
+
+        axes = self._start_event_axes_pan(event, method="zoom")
         if not axes:
             return
-        if self._nav_stack() is None:
-            self.push_current()  # set the home button to this view
+
         id_zoom = self.canvas.mpl_connect(
             "motion_notify_event", self.drag_zoom)
+
         # A colorbar is one-dimensional, so we extend the zoom rectangle out
         # to the edge of the Axes bbox in the other dimension. To do that we
         # store the orientation of the colorbar for later.
-        if hasattr(axes[0], "_colorbar"):
-            cbar = axes[0]._colorbar.orientation
+        parent_ax = axes[0]
+        if hasattr(parent_ax, "_colorbar"):
+            cbar = parent_ax._colorbar.orientation
         else:
             cbar = None
+
         self._zoom_info = self._ZoomInfo(
             direction="in" if event.button == 1 else "out",
             start_xy=(event.x, event.y), axes=axes, cid=id_zoom, cbar=cbar)
diff --git a/lib/matplotlib/tests/test_backend_bases.py b/lib/matplotlib/tests/test_backend_bases.py
index 471f46f0effe..299f89a85be1 100644
--- a/lib/matplotlib/tests/test_backend_bases.py
+++ b/lib/matplotlib/tests/test_backend_bases.py
@@ -439,3 +439,149 @@ def test_toolmanager_update_keymap():
     assert fig.canvas.manager.toolmanager.get_tool_keymap('forward') == ['c']
     with pytest.raises(KeyError, match="'foo' not in Tools"):
         fig.canvas.manager.toolmanager.update_keymap('foo', 'c')
+
+
+@pytest.mark.parametrize("tool", ["zoom", "pan"])
+@pytest.mark.parametrize("button", [MouseButton.LEFT, MouseButton.RIGHT])
+@pytest.mark.parametrize("patch_vis", [True, False])
+@pytest.mark.parametrize("forward_nav", [True, False, "auto"])
+@pytest.mark.parametrize("t_s", ["twin", "share"])
+def test_interactive_pan_zoom_events(tool, button, patch_vis,
+                                     forward_nav, t_s):
+    # Bottom axes: ax_b    Top axes: ax_t
+    fig, ax_b = plt.subplots()
+    ax_t = fig.add_subplot(221, zorder=99)
+    ax_t.set_forward_navigation_events(forward_nav)
+    ax_t.patch.set_visible(patch_vis)
+
+    # ----------------------------
+    if t_s == "share":
+        ax_t_twin = fig.add_subplot(222)
+        ax_t_twin.sharex(ax_t)
+        ax_t_twin.sharey(ax_t)
+
+        ax_b_twin = fig.add_subplot(223)
+        ax_b_twin.sharex(ax_b)
+        ax_b_twin.sharey(ax_b)
+    elif t_s == "twin":
+        ax_t_twin = ax_t.twinx()
+        ax_b_twin = ax_b.twinx()
+
+    # just some styling to simplify manual checks
+    ax_t.set_label("ax_t")
+    ax_t.patch.set_facecolor((1, 0, 0, 0.5))
+
+    ax_t_twin.set_label("ax_t_twin")
+    ax_t_twin.patch.set_facecolor("r")
+
+    ax_b.set_label("ax_b")
+    ax_b.patch.set_facecolor((0, 0, 1, 0.5))
+
+    ax_b_twin.set_label("ax_b_twin")
+    ax_b_twin.patch.set_facecolor("b")
+
+    # ----------------------------
+
+    # Set initial axis limits
+    init_xlim, init_ylim = (0, 10), (0, 10)
+    for ax in [ax_t, ax_b]:
+        ax.set_xlim(*init_xlim)
+        ax.set_ylim(*init_ylim)
+
+    # Mouse from 2 to 1 (in data-coordinates of ax_t).
+    xstart_t, xstop_t, ystart_t, ystop_t = 1, 2, 1, 2
+    # Convert to screen coordinates ("s").  Events are defined only with pixel
+    # precision, so round the pixel values, and below, check against the
+    # corresponding xdata/ydata, which are close but not equal to d0/d1.
+    s0 = ax_t.transData.transform((xstart_t, ystart_t)).astype(int)
+    s1 = ax_t.transData.transform((xstop_t, ystop_t)).astype(int)
+
+    # Calculate the mouse-distance in data-coordinates of the bottom-axes
+    xstart_b, ystart_b = ax_b.transData.inverted().transform(s0)
+    xstop_b, ystop_b = ax_b.transData.inverted().transform(s1)
+
+    # Set up the mouse movements
+    start_event = MouseEvent(
+        "button_press_event", fig.canvas, *s0, button)
+    stop_event = MouseEvent(
+        "button_release_event", fig.canvas, *s1, button)
+
+    tb = NavigationToolbar2(fig.canvas)
+
+    if tool == "zoom":
+        # Evaluate expected limits before executing the zoom-event
+        direction = ("in" if button == 1 else "out")
+
+        xlim_t, ylim_t = ax_t._prepare_view_from_bbox(
+            [*s0, *s1], direction)
+
+        if ax_t.get_forward_navigation_events() is True:
+            xlim_b, ylim_b = ax_b._prepare_view_from_bbox(
+                [*s0, *s1], direction)
+        elif ax_t.get_forward_navigation_events() is False:
+            xlim_b = init_xlim
+            ylim_b = init_ylim
+        else:
+            if ax_t.patch.get_visible() is False:
+                xlim_b, ylim_b = ax_b._prepare_view_from_bbox(
+                    [*s0, *s1], direction)
+            else:
+                xlim_b = init_xlim
+                ylim_b = init_ylim
+
+        tb.zoom()
+        tb.press_zoom(start_event)
+        tb.drag_zoom(stop_event)
+        tb.release_zoom(stop_event)
+
+        assert ax_t.get_xlim() == pytest.approx(xlim_t, abs=0.15)
+        assert ax_t.get_ylim() == pytest.approx(ylim_t, abs=0.15)
+        assert ax_b.get_xlim() == pytest.approx(xlim_b, abs=0.15)
+        assert ax_b.get_ylim() == pytest.approx(ylim_b, abs=0.15)
+
+        # Check if twin-axes are properly triggered
+        assert ax_t.get_xlim() == pytest.approx(ax_t_twin.get_xlim(),
+                                                abs=0.15)
+        assert ax_b.get_xlim() == pytest.approx(ax_b_twin.get_xlim(),
+                                                abs=0.15)
+    else:
+        # Evaluate expected limits
+        # (call start_pan to make sure ax._pan_start is set)
+        ax_t.start_pan(*s0, button)
+        xlim_t, ylim_t = ax_t._get_pan_points(
+            button, None, *s1).T.astype(float)
+        ax_t.end_pan()
+
+        if ax_t.get_forward_navigation_events() is True:
+            ax_b.start_pan(*s0, button)
+            xlim_b, ylim_b = ax_b._get_pan_points(
+                button, None, *s1).T.astype(float)
+            ax_b.end_pan()
+        elif ax_t.get_forward_navigation_events() is False:
+            xlim_b = init_xlim
+            ylim_b = init_ylim
+        else:
+            if ax_t.patch.get_visible() is False:
+                ax_b.start_pan(*s0, button)
+                xlim_b, ylim_b = ax_b._get_pan_points(
+                    button, None, *s1).T.astype(float)
+                ax_b.end_pan()
+            else:
+                xlim_b = init_xlim
+                ylim_b = init_ylim
+
+        tb.pan()
+        tb.press_pan(start_event)
+        tb.drag_pan(stop_event)
+        tb.release_pan(stop_event)
+
+        assert ax_t.get_xlim() == pytest.approx(xlim_t, abs=0.15)
+        assert ax_t.get_ylim() == pytest.approx(ylim_t, abs=0.15)
+        assert ax_b.get_xlim() == pytest.approx(xlim_b, abs=0.15)
+        assert ax_b.get_ylim() == pytest.approx(ylim_b, abs=0.15)
+
+        # Check if twin-axes are properly triggered
+        assert ax_t.get_xlim() == pytest.approx(ax_t_twin.get_xlim(),
+                                                abs=0.15)
+        assert ax_b.get_xlim() == pytest.approx(ax_b_twin.get_xlim(),
+                                                abs=0.15)

From 4b84cbc9f588ad92d397caf692e022bf26f396e1 Mon Sep 17 00:00:00 2001
From: Raphael Quast <raphael.quast@geo.tuwien.ac.at>
Date: Fri, 20 Oct 2023 20:25:42 +0200
Subject: [PATCH 0839/1120] update stub files

---
 lib/matplotlib/axes/_base.pyi | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/lib/matplotlib/axes/_base.pyi b/lib/matplotlib/axes/_base.pyi
index c63d81992389..751dcd248a5c 100644
--- a/lib/matplotlib/axes/_base.pyi
+++ b/lib/matplotlib/axes/_base.pyi
@@ -75,6 +75,7 @@ class _AxesBase(martist.Artist):
         xscale: str | ScaleBase | None = ...,
         yscale: str | ScaleBase | None = ...,
         box_aspect: float | None = ...,
+        forward_navigation_events: bool | Literal["auto"] = ...,
         **kwargs
     ) -> None: ...
     def get_subplotspec(self) -> SubplotSpec | None: ...
@@ -363,6 +364,8 @@ class _AxesBase(martist.Artist):
     def can_pan(self) -> bool: ...
     def get_navigate(self) -> bool: ...
     def set_navigate(self, b: bool) -> None: ...
+    def get_forward_navigation_events(self) -> bool | Literal["auto"]: ...
+    def set_forward_navigation_events(self, forward: bool | Literal["auto"]) -> None: ...
     def get_navigate_mode(self) -> Literal["PAN", "ZOOM"] | None: ...
     def set_navigate_mode(self, b: Literal["PAN", "ZOOM"] | None) -> None: ...
     def start_pan(self, x: float, y: float, button: MouseButton) -> None: ...

From 009b585630c8c1652c342c64c727ea0b8de0134b Mon Sep 17 00:00:00 2001
From: Raphael Quast <raphael.quast@geo.tuwien.ac.at>
Date: Sun, 19 Nov 2023 11:26:06 +0100
Subject: [PATCH 0840/1120] maintain type stability on return value

Co-authored-by: Thomas A Caswell <tcaswell@gmail.com>
---
 lib/matplotlib/backend_bases.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
index a17f64d63edc..d8c4081295c3 100644
--- a/lib/matplotlib/backend_bases.py
+++ b/lib/matplotlib/backend_bases.py
@@ -3014,7 +3014,7 @@ def _capture_events(ax):
         axes = list(filter(_ax_filter, self.canvas.figure.get_axes()))
 
         if len(axes) == 0:
-            return
+            return []
 
         if self._nav_stack() is None:
             self.push_current()   # Set the home button to this view.

From a7975a2296aa7b47af5da33ea7a28bed2c939da6 Mon Sep 17 00:00:00 2001
From: Raphael Quast <raphael.quast@geo.tuwien.ac.at>
Date: Sun, 19 Nov 2023 17:28:54 +0100
Subject: [PATCH 0841/1120] rename "_start_event_axes_pan" to
 "_start_event_axes_interaction"

---
 lib/matplotlib/backend_bases.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
index d8c4081295c3..47a4c904a911 100644
--- a/lib/matplotlib/backend_bases.py
+++ b/lib/matplotlib/backend_bases.py
@@ -2995,7 +2995,7 @@ def _zoom_pan_handler(self, event):
             elif event.name == "button_release_event":
                 self.release_zoom(event)
 
-    def _start_event_axes_pan(self, event, method="zoom"):
+    def _start_event_axes_interaction(self, event, method="zoom"):
         # call "ax.start_pan(..)" on all relevant axes of an event
 
         def _ax_filter(ax):
@@ -3078,7 +3078,7 @@ def press_pan(self, event):
                 or event.x is None or event.y is None):
             return
 
-        axes = self._start_event_axes_pan(event, method="pan")
+        axes = self._start_event_axes_interaction(event, method="pan")
         if not axes:
             return
 
@@ -3131,7 +3131,7 @@ def press_zoom(self, event):
                 or event.x is None or event.y is None):
             return
 
-        axes = self._start_event_axes_pan(event, method="zoom")
+        axes = self._start_event_axes_interaction(event, method="zoom")
         if not axes:
             return
 

From fa8e7e474f92a95db29050b5007a798a4842d8ca Mon Sep 17 00:00:00 2001
From: Raphael Quast <raphael.quast@geo.tuwien.ac.at>
Date: Sun, 19 Nov 2023 17:32:35 +0100
Subject: [PATCH 0842/1120] call start_pan only on pan-events and use more
 descriptive variable name

---
 lib/matplotlib/backend_bases.py | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
index 47a4c904a911..0d12b64e27de 100644
--- a/lib/matplotlib/backend_bases.py
+++ b/lib/matplotlib/backend_bases.py
@@ -2996,7 +2996,6 @@ def _zoom_pan_handler(self, event):
                 self.release_zoom(event)
 
     def _start_event_axes_interaction(self, event, method="zoom"):
-        # call "ax.start_pan(..)" on all relevant axes of an event
 
         def _ax_filter(ax):
             return (ax.in_axes(event) and
@@ -3024,13 +3023,13 @@ def _capture_events(ax):
         for ax in reversed(axes):
             grps.setdefault(ax.get_zorder(), []).append(ax)
 
-        pan_axes = []
+        axes_to_trigger = []
         # go through zorders in reverse until we hit a capturing axes
         for zorder in sorted(grps, reverse=True):
             for ax in grps[zorder]:
-                pan_axes.append(ax)
+                axes_to_trigger.append(ax)
                 # NOTE: shared axes are automatically triggered, but twin-axes not!
-                pan_axes.extend(ax._twinned_axes.get_siblings(ax))
+                axes_to_trigger.extend(ax._twinned_axes.get_siblings(ax))
 
                 if _capture_events(ax):
                     break  # break if we hit a capturing axes
@@ -3045,12 +3044,9 @@ def _capture_events(ax):
             break
 
         # avoid duplicated triggers (but keep order of list)
-        pan_axes = list(dict.fromkeys(pan_axes))
-
-        for ax in pan_axes:
-            ax.start_pan(event.x, event.y, event.button)
+        axes_to_trigger = list(dict.fromkeys(axes_to_trigger))
 
-        return pan_axes
+        return axes_to_trigger
 
     def pan(self, *args):
         """
@@ -3082,6 +3078,10 @@ def press_pan(self, event):
         if not axes:
             return
 
+        # call "ax.start_pan(..)" on all relevant axes of an event
+        for ax in axes:
+            ax.start_pan(event.x, event.y, event.button)
+
         self.canvas.mpl_disconnect(self._id_drag)
         id_drag = self.canvas.mpl_connect("motion_notify_event", self.drag_pan)
 

From af3a97ea896c43aeda79c179fad13f01aeeca6a2 Mon Sep 17 00:00:00 2001
From: Raphael Quast <raphael.quast@geo.tuwien.ac.at>
Date: Sun, 19 Nov 2023 17:48:31 +0100
Subject: [PATCH 0843/1120] add note on what's considered a "visible patch" to
 the example

---
 galleries/examples/showcase/pan_zoom_overlap.py | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/galleries/examples/showcase/pan_zoom_overlap.py b/galleries/examples/showcase/pan_zoom_overlap.py
index 7d6b5a993205..8c0677b651a6 100644
--- a/galleries/examples/showcase/pan_zoom_overlap.py
+++ b/galleries/examples/showcase/pan_zoom_overlap.py
@@ -13,16 +13,20 @@
 - Shared axes always trigger with their parent axes
   (irrespective of the patch visibility)
 
+Note: The visibility of the patch hereby refers to the value of
+``ax.patch.get_visible()``. The color and transparency of a
+patch have no effect on the treatment of pan/zoom events!
+
 
 ``ax.set_forward_navigation_events(val)`` can be used to override the
 default behaviour:
 
 - ``True``:  Forward navigation events to axes below.
 - ``False``: Execute navigation events only on this axes.
-- ``"auto"``: Use the default behaviour
-  (``True`` for axes with an invisible patch and ``False`` otherwise).
+- ``"auto"``: Use the default behaviour.
 
 To disable pan/zoom events completely, use ``ax.set_navigate(False)``
+
 """
 
 

From ff6f027c785075cf85d96d78199c3881cda000e3 Mon Sep 17 00:00:00 2001
From: "Albert Y. Shih" <ayshih@gmail.com>
Date: Mon, 21 Aug 2023 16:12:17 -0400
Subject: [PATCH 0844/1120] Revert "Revert using SVG inheritance diagrams"

This reverts commit def91868e77ecbc08ec8b82ef69f9f8f403d49a1.
---
 doc/conf.py | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/doc/conf.py b/doc/conf.py
index 4f9c0f732027..00300efe1ac6 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -738,16 +738,14 @@ def js_tag_with_cache_busting(js):
 numpydoc_show_class_members = False
 
 # We want to prevent any size limit, as we'll add scroll bars with CSS.
-inheritance_graph_attrs = dict(dpi=100, size='1000.0', splines='polyline')
+inheritance_graph_attrs = dict(size='1000.0', splines='polyline')
 # Also remove minimum node dimensions, and increase line size a bit.
 inheritance_node_attrs = dict(height=0.02, margin=0.055, penwidth=1,
                               width=0.01)
 inheritance_edge_attrs = dict(penwidth=1)
 
 graphviz_dot = shutil.which('dot')
-# Still use PNG until SVG linking is fixed
-# https://github.com/sphinx-doc/sphinx/issues/3176
-# graphviz_output_format = 'svg'
+graphviz_output_format = 'svg'
 
 # -----------------------------------------------------------------------------
 # Source code links

From fa230f2a99b7b32694b401cadfe147223af54a9a Mon Sep 17 00:00:00 2001
From: trananso <trananson@protonmail.com>
Date: Tue, 12 Mar 2024 12:07:36 -0400
Subject: [PATCH 0845/1120] Fix dead link in readme

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 4b91b0dd8aff..6751e9a56e35 100644
--- a/README.md
+++ b/README.md
@@ -43,7 +43,7 @@ You've worked out a way to fix it — even better!
 You want to tell us about it — best of all!
 
 Start at the [contributing
-guide](https://matplotlib.org/devdocs/devel/contributing.html)!
+guide](https://matplotlib.org/devdocs/devel/contribute.html)!
 
 ## Contact
 

From c6dc3a1174a2f89aac69f0d5fc549dfe9f51d5bf Mon Sep 17 00:00:00 2001
From: n-aswin <102724710+n-aswin@users.noreply.github.com>
Date: Fri, 1 Apr 2022 14:29:58 +0530
Subject: [PATCH 0846/1120] Add minor ticks on and off in Axis

---
 doc/api/axis_api.rst                          |  3 ++
 .../next_whats_new/axis_minorticks_toggle.rst |  6 +++
 lib/matplotlib/axes/_base.py                  | 17 ++------
 lib/matplotlib/axis.py                        | 38 ++++++++++++++++++
 lib/matplotlib/axis.pyi                       |  2 +
 lib/matplotlib/tests/test_ticker.py           | 40 +++++++++++++++++++
 6 files changed, 93 insertions(+), 13 deletions(-)
 create mode 100644 doc/users/next_whats_new/axis_minorticks_toggle.rst

diff --git a/doc/api/axis_api.rst b/doc/api/axis_api.rst
index a177f82a4a9a..17e892b99df8 100644
--- a/doc/api/axis_api.rst
+++ b/doc/api/axis_api.rst
@@ -112,6 +112,9 @@ Ticks, tick labels and Offset text
 
    Axis.axis_date
 
+   Axis.minorticks_off
+   Axis.minorticks_on
+
 
 Data and view intervals
 -----------------------
diff --git a/doc/users/next_whats_new/axis_minorticks_toggle.rst b/doc/users/next_whats_new/axis_minorticks_toggle.rst
new file mode 100644
index 000000000000..bb6545e5cb4c
--- /dev/null
+++ b/doc/users/next_whats_new/axis_minorticks_toggle.rst
@@ -0,0 +1,6 @@
+Toggle minorticks on Axis
+------------------------------
+
+Minor ticks on an `~matplotlib.axis.Axis` can be displayed or removed using
+`~matplotlib.axis.Axis.minorticks_on` and `~matplotlib.axis.Axis.minorticks_off`;
+e.g.: ``ax.xaxis.minorticks_on()``. See also `~matplotlib.axes.Axes.minorticks_on`.
diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index 5d612c581270..be0aacd81bb0 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -3987,22 +3987,13 @@ def minorticks_on(self):
         Displaying minor ticks may reduce performance; you may turn them off
         using `minorticks_off()` if drawing speed is a problem.
         """
-        for ax in (self.xaxis, self.yaxis):
-            scale = ax.get_scale()
-            if scale == 'log':
-                s = ax._scale
-                ax.set_minor_locator(mticker.LogLocator(s.base, s.subs))
-            elif scale == 'symlog':
-                s = ax._scale
-                ax.set_minor_locator(
-                    mticker.SymmetricalLogLocator(s._transform, s.subs))
-            else:
-                ax.set_minor_locator(mticker.AutoMinorLocator())
+        self.xaxis.minorticks_on()
+        self.yaxis.minorticks_on()
 
     def minorticks_off(self):
         """Remove minor ticks from the Axes."""
-        self.xaxis.set_minor_locator(mticker.NullLocator())
-        self.yaxis.set_minor_locator(mticker.NullLocator())
+        self.xaxis.minorticks_off()
+        self.yaxis.minorticks_off()
 
     # Interactive manipulation
 
diff --git a/lib/matplotlib/axis.py b/lib/matplotlib/axis.py
index dbd65aba4a17..d317f6ec0567 100644
--- a/lib/matplotlib/axis.py
+++ b/lib/matplotlib/axis.py
@@ -928,6 +928,44 @@ def reset_ticks(self):
         except AttributeError:
             pass
 
+    def minorticks_on(self):
+        """
+        Display default minor ticks on the Axis, depending on the scale
+        (`~.axis.Axis.get_scale`).
+
+        Scales use specific minor locators:
+
+        - log: `~.LogLocator`
+        - symlog: `~.SymmetricalLogLocator`
+        - asinh: `~.AsinhLocator`
+        - logit: `~.LogitLocator`
+        - default: `~.AutoMinorLocator`
+
+        Displaying minor ticks may reduce performance; you may turn them off
+        using `minorticks_off()` if drawing speed is a problem.
+        """
+        scale = self.get_scale()
+        if scale == 'log':
+            s = self._scale
+            self.set_minor_locator(mticker.LogLocator(s.base, s.subs))
+        elif scale == 'symlog':
+            s = self._scale
+            self.set_minor_locator(
+                mticker.SymmetricalLogLocator(s._transform, s.subs))
+        elif scale == 'asinh':
+            s = self._scale
+            self.set_minor_locator(
+                    mticker.AsinhLocator(s.linear_width, base=s._base,
+                                         subs=s._subs))
+        elif scale == 'logit':
+            self.set_minor_locator(mticker.LogitLocator(minor=True))
+        else:
+            self.set_minor_locator(mticker.AutoMinorLocator())
+
+    def minorticks_off(self):
+        """Remove minor ticks from the Axis."""
+        self.set_minor_locator(mticker.NullLocator())
+
     def set_tick_params(self, which='major', reset=False, **kwargs):
         """
         Set appearance parameters for ticks, ticklabels, and gridlines.
diff --git a/lib/matplotlib/axis.pyi b/lib/matplotlib/axis.pyi
index 5ca8fcb6fd6c..e23ae381c338 100644
--- a/lib/matplotlib/axis.pyi
+++ b/lib/matplotlib/axis.pyi
@@ -151,6 +151,8 @@ class Axis(martist.Artist):
     units: Any
     def clear(self) -> None: ...
     def reset_ticks(self) -> None: ...
+    def minorticks_on(self) -> None: ...
+    def minorticks_off(self) -> None: ...
     def set_tick_params(
         self,
         which: Literal["major", "minor", "both"] = ...,
diff --git a/lib/matplotlib/tests/test_ticker.py b/lib/matplotlib/tests/test_ticker.py
index 0cd9cfd9ad77..565f32105cea 100644
--- a/lib/matplotlib/tests/test_ticker.py
+++ b/lib/matplotlib/tests/test_ticker.py
@@ -1734,6 +1734,46 @@ def minorticksubplot(xminor, yminor, i):
     minorticksubplot(True, True, 4)
 
 
+def test_minorticks_toggle():
+    """
+    Test toggling minor ticks
+
+    Test `.Axis.minorticks_on()` and `.Axis.minorticks_off()`. Testing is
+    limited to a subset of built-in scales - `'linear'`, `'log'`, `'asinh'`
+    and `'logit'`. `symlog` scale does not seem to have a working minor
+    locator and is omitted. In future, this test should cover all scales in
+    `matplotlib.scale.get_scale_names()`.
+    """
+    fig = plt.figure()
+    def minortickstoggle(xminor, yminor, scale, i):
+        ax = fig.add_subplot(2, 2, i)
+        ax.set_xscale(scale)
+        ax.set_yscale(scale)
+        if not xminor and not yminor:
+            ax.minorticks_off()
+        if xminor and not yminor:
+            ax.xaxis.minorticks_on()
+            ax.yaxis.minorticks_off()
+        if not xminor and yminor:
+            ax.xaxis.minorticks_off()
+            ax.yaxis.minorticks_on()
+        if xminor and yminor:
+            ax.minorticks_on()
+
+        assert (len(ax.xaxis.get_minor_ticks()) > 0) == xminor
+        assert (len(ax.yaxis.get_minor_ticks()) > 0) == yminor
+
+    scales = ['linear', 'log', 'asinh', 'logit']
+    for scale in scales:
+        minortickstoggle(False, False, scale, 1)
+        minortickstoggle(True, False, scale, 2)
+        minortickstoggle(False, True, scale, 3)
+        minortickstoggle(True, True, scale, 4)
+        fig.clear()
+
+    plt.close(fig)
+
+
 @pytest.mark.parametrize('remove_overlapping_locs, expected_num',
                          ((True, 6),
                           (None, 6),  # this tests the default

From 4f56e1f80038dd7ae7cf1568841ed271e26c30d2 Mon Sep 17 00:00:00 2001
From: Tom Sarantis <tsarantis@proton.me>
Date: Thu, 14 Mar 2024 00:12:18 +1100
Subject: [PATCH 0847/1120] Rename boxplot's tick label parameter (#27901)

* rename tick label

* fix docs

* update label param on example docs

* fix failing tests

* move legend, fix doc and remove double line

* fix docstring

* fix docstring on axes.py
---
 .../deprecations/27901-TS.rst                 |  3 +++
 galleries/examples/statistics/boxplot.py      | 12 ++++++------
 .../examples/statistics/boxplot_color.py      |  2 +-
 galleries/examples/statistics/bxp.py          |  2 +-
 lib/matplotlib/axes/_axes.py                  | 17 ++++++++++++-----
 lib/matplotlib/axes/_axes.pyi                 |  2 +-
 lib/matplotlib/cbook.py                       | 19 ++++++++++++-------
 lib/matplotlib/cbook.pyi                      |  2 +-
 lib/matplotlib/pyplot.py                      |  4 ++--
 lib/matplotlib/tests/test_axes.py             | 18 ++++++++++++++++++
 lib/matplotlib/tests/test_cbook.py            |  4 ++--
 lib/matplotlib/tests/test_legend.py           | 15 ---------------
 12 files changed, 59 insertions(+), 41 deletions(-)
 create mode 100644 doc/api/next_api_changes/deprecations/27901-TS.rst

diff --git a/doc/api/next_api_changes/deprecations/27901-TS.rst b/doc/api/next_api_changes/deprecations/27901-TS.rst
new file mode 100644
index 000000000000..e31b77e2c6f8
--- /dev/null
+++ b/doc/api/next_api_changes/deprecations/27901-TS.rst
@@ -0,0 +1,3 @@
+``boxplot`` tick labels
+~~~~~~~~~~~~~~~~~~~~~~~
+The parameter *labels* has been renamed to *tick_labels* for clarity and consistency with `~.Axes.bar`.
diff --git a/galleries/examples/statistics/boxplot.py b/galleries/examples/statistics/boxplot.py
index 79b05386c5d9..ccdaab97d24a 100644
--- a/galleries/examples/statistics/boxplot.py
+++ b/galleries/examples/statistics/boxplot.py
@@ -28,23 +28,23 @@
 # Demonstrate how to toggle the display of different elements:
 
 fig, axs = plt.subplots(nrows=2, ncols=3, figsize=(6, 6), sharey=True)
-axs[0, 0].boxplot(data, labels=labels)
+axs[0, 0].boxplot(data, tick_labels=labels)
 axs[0, 0].set_title('Default', fontsize=fs)
 
-axs[0, 1].boxplot(data, labels=labels, showmeans=True)
+axs[0, 1].boxplot(data, tick_labels=labels, showmeans=True)
 axs[0, 1].set_title('showmeans=True', fontsize=fs)
 
-axs[0, 2].boxplot(data, labels=labels, showmeans=True, meanline=True)
+axs[0, 2].boxplot(data, tick_labels=labels, showmeans=True, meanline=True)
 axs[0, 2].set_title('showmeans=True,\nmeanline=True', fontsize=fs)
 
-axs[1, 0].boxplot(data, labels=labels, showbox=False, showcaps=False)
+axs[1, 0].boxplot(data, tick_labels=labels, showbox=False, showcaps=False)
 tufte_title = 'Tufte Style \n(showbox=False,\nshowcaps=False)'
 axs[1, 0].set_title(tufte_title, fontsize=fs)
 
-axs[1, 1].boxplot(data, labels=labels, notch=True, bootstrap=10000)
+axs[1, 1].boxplot(data, tick_labels=labels, notch=True, bootstrap=10000)
 axs[1, 1].set_title('notch=True,\nbootstrap=10000', fontsize=fs)
 
-axs[1, 2].boxplot(data, labels=labels, showfliers=False)
+axs[1, 2].boxplot(data, tick_labels=labels, showfliers=False)
 axs[1, 2].set_title('showfliers=False', fontsize=fs)
 
 for ax in axs.flat:
diff --git a/galleries/examples/statistics/boxplot_color.py b/galleries/examples/statistics/boxplot_color.py
index 496844236323..3491253aaf3e 100644
--- a/galleries/examples/statistics/boxplot_color.py
+++ b/galleries/examples/statistics/boxplot_color.py
@@ -26,7 +26,7 @@
 
 bplot = ax.boxplot(fruit_weights,
                    patch_artist=True,  # fill with color
-                   labels=labels)  # will be used to label x-ticks
+                   tick_labels=labels)  # will be used to label x-ticks
 
 # fill with colors
 for patch, color in zip(bplot['boxes'], colors):
diff --git a/galleries/examples/statistics/bxp.py b/galleries/examples/statistics/bxp.py
index d78747523325..f44193166ff1 100644
--- a/galleries/examples/statistics/bxp.py
+++ b/galleries/examples/statistics/bxp.py
@@ -25,7 +25,7 @@
 labels = list('ABCD')
 
 # compute the boxplot stats
-stats = cbook.boxplot_stats(data, labels=labels, bootstrap=10000)
+stats = cbook.boxplot_stats(data, tick_labels=labels, bootstrap=10000)
 
 # %%
 # After we've computed the stats, we can go through and change anything.
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index cc310b7da0d7..e2b8d13b52a2 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -3789,12 +3789,13 @@ def apply_mask(arrays, mask):
         return errorbar_container  # (l0, caplines, barcols)
 
     @_preprocess_data()
+    @_api.rename_parameter("3.9", "labels", "tick_labels")
     def boxplot(self, x, notch=None, sym=None, vert=None, whis=None,
                 positions=None, widths=None, patch_artist=None,
                 bootstrap=None, usermedians=None, conf_intervals=None,
                 meanline=None, showmeans=None, showcaps=None,
                 showbox=None, showfliers=None, boxprops=None,
-                labels=None, flierprops=None, medianprops=None,
+                tick_labels=None, flierprops=None, medianprops=None,
                 meanprops=None, capprops=None, whiskerprops=None,
                 manage_ticks=True, autorange=False, zorder=None,
                 capwidths=None):
@@ -3908,9 +3909,15 @@ def boxplot(self, x, notch=None, sym=None, vert=None, whis=None,
             If `False` produces boxes with the Line2D artist. Otherwise,
             boxes are drawn with Patch artists.
 
-        labels : sequence, optional
-            Labels for each dataset (one per dataset). These are used for
-            x-tick labels; *not* for legend entries.
+        tick_labels : list of str, optional
+            The tick labels of each boxplot.
+            Ticks are always placed at the box *positions*. If *tick_labels* is given,
+            the ticks are labelled accordingly. Otherwise, they keep their numeric
+            values.
+
+            .. versionchanged:: 3.9
+                Renamed from *labels*, which is deprecated since 3.9
+                and will be removed in 3.11.
 
         manage_ticks : bool, default: True
             If True, the tick locations and labels will be adjusted to match
@@ -3994,7 +4001,7 @@ def boxplot(self, x, notch=None, sym=None, vert=None, whis=None,
             bootstrap = mpl.rcParams['boxplot.bootstrap']
 
         bxpstats = cbook.boxplot_stats(x, whis=whis, bootstrap=bootstrap,
-                                       labels=labels, autorange=autorange)
+                                       tick_labels=tick_labels, autorange=autorange)
         if notch is None:
             notch = mpl.rcParams['boxplot.notch']
         if vert is None:
diff --git a/lib/matplotlib/axes/_axes.pyi b/lib/matplotlib/axes/_axes.pyi
index 97424419d234..18c10c1452ba 100644
--- a/lib/matplotlib/axes/_axes.pyi
+++ b/lib/matplotlib/axes/_axes.pyi
@@ -362,7 +362,7 @@ class Axes(_AxesBase):
         showbox: bool | None = ...,
         showfliers: bool | None = ...,
         boxprops: dict[str, Any] | None = ...,
-        labels: Sequence[str] | None = ...,
+        tick_labels: Sequence[str] | None = ...,
         flierprops: dict[str, Any] | None = ...,
         medianprops: dict[str, Any] | None = ...,
         meanprops: dict[str, Any] | None = ...,
diff --git a/lib/matplotlib/cbook.py b/lib/matplotlib/cbook.py
index ff6b2a15ec35..9e30d801f29b 100644
--- a/lib/matplotlib/cbook.py
+++ b/lib/matplotlib/cbook.py
@@ -1126,7 +1126,8 @@ def _broadcast_with_masks(*args, compress=False):
     return inputs
 
 
-def boxplot_stats(X, whis=1.5, bootstrap=None, labels=None,
+@_api.rename_parameter("3.9", "labels", "tick_labels")
+def boxplot_stats(X, whis=1.5, bootstrap=None, tick_labels=None,
                   autorange=False):
     r"""
     Return a list of dictionaries of statistics used to draw a series of box
@@ -1161,10 +1162,14 @@ def boxplot_stats(X, whis=1.5, bootstrap=None, labels=None,
         Number of times the confidence intervals around the median
         should be bootstrapped (percentile method).
 
-    labels : array-like, optional
+    tick_labels : array-like, optional
         Labels for each dataset. Length must be compatible with
         dimensions of *X*.
 
+        .. versionchanged:: 3.9
+            Renamed from *labels*, which is deprecated since 3.9
+            and will be removed in 3.11.
+
     autorange : bool, optional (False)
         When `True` and the data are distributed such that the 25th and 75th
         percentiles are equal, ``whis`` is set to (0, 100) such that the
@@ -1240,13 +1245,13 @@ def _compute_conf_interval(data, med, iqr, bootstrap):
     X = _reshape_2D(X, "X")
 
     ncols = len(X)
-    if labels is None:
-        labels = itertools.repeat(None)
-    elif len(labels) != ncols:
-        raise ValueError("Dimensions of labels and X must be compatible")
+    if tick_labels is None:
+        tick_labels = itertools.repeat(None)
+    elif len(tick_labels) != ncols:
+        raise ValueError("Dimensions of tick_labels and X must be compatible")
 
     input_whis = whis
-    for ii, (x, label) in enumerate(zip(X, labels)):
+    for ii, (x, label) in enumerate(zip(X, tick_labels)):
 
         # empty dict
         stats = {}
diff --git a/lib/matplotlib/cbook.pyi b/lib/matplotlib/cbook.pyi
index c60ae0781af1..832a8003bdcf 100644
--- a/lib/matplotlib/cbook.pyi
+++ b/lib/matplotlib/cbook.pyi
@@ -135,7 +135,7 @@ def boxplot_stats(
     X: ArrayLike,
     whis: float | tuple[float, float] = ...,
     bootstrap: int | None = ...,
-    labels: ArrayLike | None = ...,
+    tick_labels: ArrayLike | None = ...,
     autorange: bool = ...,
 ) -> list[dict[str, Any]]: ...
 
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 59fc02000983..88a0f1f85d0b 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -2853,7 +2853,7 @@ def boxplot(
     showbox: bool | None = None,
     showfliers: bool | None = None,
     boxprops: dict[str, Any] | None = None,
-    labels: Sequence[str] | None = None,
+    tick_labels: Sequence[str] | None = None,
     flierprops: dict[str, Any] | None = None,
     medianprops: dict[str, Any] | None = None,
     meanprops: dict[str, Any] | None = None,
@@ -2884,7 +2884,7 @@ def boxplot(
         showbox=showbox,
         showfliers=showfliers,
         boxprops=boxprops,
-        labels=labels,
+        tick_labels=tick_labels,
         flierprops=flierprops,
         medianprops=medianprops,
         meanprops=meanprops,
diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index 195b1986f028..4e659a4d841d 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -8966,3 +8966,21 @@ def test_axes_clear_behavior(fig_ref, fig_test, which):
 
     ax_ref.grid(True)
     ax_test.grid(True)
+
+
+def test_boxplot_tick_labels():
+    # Test the renamed `tick_labels` parameter.
+    # Test for deprecation of old name `labels`.
+    np.random.seed(19680801)
+    data = np.random.random((10, 3))
+
+    fig, axs = plt.subplots(nrows=1, ncols=2, sharey=True)
+    # Should get deprecation warning for `labels`
+    with pytest.warns(mpl.MatplotlibDeprecationWarning,
+                      match='has been renamed \'tick_labels\''):
+        axs[0].boxplot(data, labels=['A', 'B', 'C'])
+    assert [l.get_text() for l in axs[0].get_xticklabels()] == ['A', 'B', 'C']
+
+    # Test the new tick_labels parameter
+    axs[1].boxplot(data, tick_labels=['A', 'B', 'C'])
+    assert [l.get_text() for l in axs[1].get_xticklabels()] == ['A', 'B', 'C']
diff --git a/lib/matplotlib/tests/test_cbook.py b/lib/matplotlib/tests/test_cbook.py
index 1f4f96324e9e..45481578f58b 100644
--- a/lib/matplotlib/tests/test_cbook.py
+++ b/lib/matplotlib/tests/test_cbook.py
@@ -145,7 +145,7 @@ def test_results_whiskers_percentiles(self):
 
     def test_results_withlabels(self):
         labels = ['Test1', 2, 'Aardvark', 4]
-        results = cbook.boxplot_stats(self.data, labels=labels)
+        results = cbook.boxplot_stats(self.data, tick_labels=labels)
         for lab, res in zip(labels, results):
             assert res['label'] == lab
 
@@ -156,7 +156,7 @@ def test_results_withlabels(self):
     def test_label_error(self):
         labels = [1, 2]
         with pytest.raises(ValueError):
-            cbook.boxplot_stats(self.data, labels=labels)
+            cbook.boxplot_stats(self.data, tick_labels=labels)
 
     def test_bad_dims(self):
         data = np.random.normal(size=(34, 34, 34))
diff --git a/lib/matplotlib/tests/test_legend.py b/lib/matplotlib/tests/test_legend.py
index 73892698882c..3b3145006427 100644
--- a/lib/matplotlib/tests/test_legend.py
+++ b/lib/matplotlib/tests/test_legend.py
@@ -1435,18 +1435,3 @@ def test_legend_text():
         leg_bboxes.append(
             leg.get_window_extent().transformed(ax.transAxes.inverted()))
     assert_allclose(leg_bboxes[1].bounds, leg_bboxes[0].bounds)
-
-
-def test_boxplot_labels():
-    # Test that boxplot(..., labels=) sets the tick labels but not legend entries
-    # This is not consistent with other plot types but is the current behavior.
-    fig, ax = plt.subplots()
-    np.random.seed(19680801)
-    data = np.random.random((10, 3))
-    bp = ax.boxplot(data, labels=['A', 'B', 'C'])
-    # Check that labels set the tick labels ...
-    assert [l.get_text() for l in ax.get_xticklabels()] == ['A', 'B', 'C']
-    # ... but not legend entries
-    handles, labels = ax.get_legend_handles_labels()
-    assert len(handles) == 0
-    assert len(labels) == 0

From 6368cc55ed76c9e9d107b8f99dd6104e6bd8a34a Mon Sep 17 00:00:00 2001
From: Katherine Turk <35183618+kbturk@users.noreply.github.com>
Date: Wed, 13 Mar 2024 15:24:46 -0500
Subject: [PATCH 0848/1120] Added optional props argument to Lasso Widget
 __init__ to customize Lasso line (#26594)

* Added the ability for Lasso color, style, and lw to be set in the init function

* Added props option to Lasso widget

updated Lasso documentation with props

updated Lasso documentation with props

* wrote a test for the lasso tool

Lasso test passes

* fixed whitespace issues

* fixed whitespace on test, added some test code to make sure defaults worked as intended

* fixed whitespace in widget.py

* updated with suggestions from oscargus

* corrected over indented docstring

* ...fixed indentions

* docstrings

* doc-string corrections

* Update lib/matplotlib/widgets.py

---------

Co-authored-by: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
---
 lib/matplotlib/tests/test_widgets.py | 21 +++++++++++++++++++++
 lib/matplotlib/widgets.py            | 17 ++++++++++++++---
 lib/matplotlib/widgets.pyi           |  1 +
 3 files changed, 36 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_widgets.py b/lib/matplotlib/tests/test_widgets.py
index 16770321dee9..0f2cc411dbdf 100644
--- a/lib/matplotlib/tests/test_widgets.py
+++ b/lib/matplotlib/tests/test_widgets.py
@@ -1020,6 +1020,27 @@ def test_lasso_selector_set_props(ax):
     assert artist.get_alpha() == 0.3
 
 
+def test_lasso_set_props(ax):
+    onselect = mock.Mock(spec=noop, return_value=None)
+    tool = widgets.Lasso(ax, (100, 100), onselect)
+    line = tool.line
+    assert mcolors.same_color(line.get_color(), 'black')
+    assert line.get_linestyle() == '-'
+    assert line.get_lw() == 2
+    tool = widgets.Lasso(ax, (100, 100), onselect, props=dict(
+        linestyle='-', color='darkblue', alpha=0.2, lw=1))
+
+    line = tool.line
+    assert mcolors.same_color(line.get_color(), 'darkblue')
+    assert line.get_alpha() == 0.2
+    assert line.get_lw() == 1
+    assert line.get_linestyle() == '-'
+    line.set_color('r')
+    line.set_alpha(0.3)
+    assert mcolors.same_color(line.get_color(), 'r')
+    assert line.get_alpha() == 0.3
+
+
 def test_CheckButtons(ax):
     labels = ('a', 'b', 'c')
     check = widgets.CheckButtons(ax, labels, (True, False, True))
diff --git a/lib/matplotlib/widgets.py b/lib/matplotlib/widgets.py
index 88eafcd21a9e..eaa35e25440b 100644
--- a/lib/matplotlib/widgets.py
+++ b/lib/matplotlib/widgets.py
@@ -4142,18 +4142,29 @@ class Lasso(AxesWidget):
         Whether to use blitting for faster drawing (if supported by the
         backend). See the tutorial :ref:`blitting`
         for details.
-    """
+    props: dict, optional
+        Lasso line properties. See `.Line2D` for valid properties.
+        Default *props* are::
+
+            {'linestyle' : '-', 'color' : 'black', 'lw' : 2}
 
-    def __init__(self, ax, xy, callback, *, useblit=True):
+        .. versionadded:: 3.9
+    """
+    def __init__(self, ax, xy, callback, *, useblit=True, props=None):
         super().__init__(ax)
 
         self.useblit = useblit and self.canvas.supports_blit
         if self.useblit:
             self.background = self.canvas.copy_from_bbox(self.ax.bbox)
 
+        style = {'linestyle': '-', 'color': 'black', 'lw': 2}
+
+        if props is not None:
+            style.update(props)
+
         x, y = xy
         self.verts = [(x, y)]
-        self.line = Line2D([x], [y], linestyle='-', color='black', lw=2)
+        self.line = Line2D([x], [y], **style)
         self.ax.add_line(self.line)
         self.callback = callback
         self.connect_event('button_release_event', self.onrelease)
diff --git a/lib/matplotlib/widgets.pyi b/lib/matplotlib/widgets.pyi
index e27da7575b74..c85ad2158ee7 100644
--- a/lib/matplotlib/widgets.pyi
+++ b/lib/matplotlib/widgets.pyi
@@ -478,6 +478,7 @@ class Lasso(AxesWidget):
         callback: Callable[[list[tuple[float, float]]], Any],
         *,
         useblit: bool = ...,
+        props: dict[str, Any] | None = ...,
     ) -> None: ...
     def onrelease(self, event: Event) -> None: ...
     def onmove(self, event: Event) -> None: ...

From a5c95ccfbf64559f8d81a351d8c0a5ba94312851 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 13 Mar 2024 20:17:03 -0400
Subject: [PATCH 0849/1120] Fix new flake8 errors from old merge

Some flake8-docstring options were changed between a PR being written
and it gettig merge, so these errors were not evident.
---
 lib/matplotlib/tests/test_cbook.py | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/lib/matplotlib/tests/test_cbook.py b/lib/matplotlib/tests/test_cbook.py
index 38fa23acd4bf..938655507c2f 100644
--- a/lib/matplotlib/tests/test_cbook.py
+++ b/lib/matplotlib/tests/test_cbook.py
@@ -943,9 +943,8 @@ def test_auto_format_str(fmt, value, result):
 
 
 def test_unpack_to_numpy_from_torch():
-    """Test that torch tensors are converted to numpy arrays.
-    We don't want to create a dependency on torch in the test suite, so we mock it.
-    """
+    # Test that torch tensors are converted to NumPy arrays.
+    # We don't want to create a dependency on torch in the test suite, so we mock it.
     class Tensor:
         def __init__(self, data):
             self.data = data
@@ -963,9 +962,8 @@ def __array__(self):
 
 
 def test_unpack_to_numpy_from_jax():
-    """Test that jax arrays are converted to numpy arrays.
-    We don't want to create a dependency on jax in the test suite, so we mock it.
-    """
+    # Test that jax arrays are converted to NumPy arrays.
+    # We don't want to create a dependency on jax in the test suite, so we mock it.
     class Array:
         def __init__(self, data):
             self.data = data

From 0389fb187fc905af2e4ce6560b739c22813b71bc Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Thu, 14 Mar 2024 09:11:40 +0100
Subject: [PATCH 0850/1120] Fix cbook style

- add missing functions to cbook.pyi
- PEP8 format conform test
---
 lib/matplotlib/cbook.pyi           |  3 +++
 lib/matplotlib/tests/test_cbook.py | 17 +++++++++++++----
 2 files changed, 16 insertions(+), 4 deletions(-)

diff --git a/lib/matplotlib/cbook.pyi b/lib/matplotlib/cbook.pyi
index 832a8003bdcf..f72fc4f615ad 100644
--- a/lib/matplotlib/cbook.pyi
+++ b/lib/matplotlib/cbook.pyi
@@ -181,4 +181,7 @@ def _setup_new_guiapp() -> None: ...
 def _format_approx(number: float, precision: int) -> str: ...
 def _g_sig_digits(value: float, delta: float) -> int: ...
 def _unikey_or_keysym_to_mplkey(unikey: str, keysym: str) -> str: ...
+def _is_torch_array(x: Any) -> bool: ...
+def _is_jax_array(x: Any) -> bool: ...
+def _unpack_to_numpy(x: Any) -> Any: ...
 def _auto_format_str(fmt: str, value: Any) -> str: ...
diff --git a/lib/matplotlib/tests/test_cbook.py b/lib/matplotlib/tests/test_cbook.py
index 938655507c2f..ec9352d369c4 100644
--- a/lib/matplotlib/tests/test_cbook.py
+++ b/lib/matplotlib/tests/test_cbook.py
@@ -943,13 +943,18 @@ def test_auto_format_str(fmt, value, result):
 
 
 def test_unpack_to_numpy_from_torch():
-    # Test that torch tensors are converted to NumPy arrays.
-    # We don't want to create a dependency on torch in the test suite, so we mock it.
+    """
+    Test that torch tensors are converted to NumPy arrays.
+
+    We don't want to create a dependency on torch in the test suite, so we mock it.
+    """
     class Tensor:
         def __init__(self, data):
             self.data = data
+
         def __array__(self):
             return self.data
+
     torch = ModuleType('torch')
     torch.Tensor = Tensor
     sys.modules['torch'] = torch
@@ -962,11 +967,15 @@ def __array__(self):
 
 
 def test_unpack_to_numpy_from_jax():
-    # Test that jax arrays are converted to NumPy arrays.
-    # We don't want to create a dependency on jax in the test suite, so we mock it.
+    """
+    Test that jax arrays are converted to NumPy arrays.
+
+    We don't want to create a dependency on jax in the test suite, so we mock it.
+    """
     class Array:
         def __init__(self, data):
             self.data = data
+
         def __array__(self):
             return self.data
 

From 07f34aa9aceeadecc9a32bf9e8f15b9843b15dab Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 13 Mar 2024 20:20:07 -0400
Subject: [PATCH 0851/1120] Avoid modifying user input to Axes.bar

The `error_kw` parameter is a dictionary, on which `setdefault` and
`pop` are called, which would modify user input.
---
 lib/matplotlib/axes/_axes.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index e2b8d13b52a2..627dd2c36d40 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -2434,7 +2434,8 @@ def bar(self, x, height, width=0.8, bottom=None, *, align="center",
         # checking and processing will be left to the errorbar method.
         xerr = kwargs.pop('xerr', None)
         yerr = kwargs.pop('yerr', None)
-        error_kw = kwargs.pop('error_kw', {})
+        error_kw = kwargs.pop('error_kw', None)
+        error_kw = {} if error_kw is None else error_kw.copy()
         ezorder = error_kw.pop('zorder', None)
         if ezorder is None:
             ezorder = kwargs.get('zorder', None)
@@ -2590,9 +2591,8 @@ def bar(self, x, height, width=0.8, bottom=None, *, align="center",
 
             error_kw.setdefault("label", '_nolegend_')
 
-            errorbar = self.errorbar(ex, ey,
-                                     yerr=yerr, xerr=xerr,
-                                     fmt='none', **error_kw)
+            errorbar = self.errorbar(ex, ey, yerr=yerr, xerr=xerr, fmt='none',
+                                     **error_kw)
         else:
             errorbar = None
 

From 8fc0ba44e3788b3572628e1591848a849b00cb67 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Wed, 28 Feb 2024 11:30:26 +0100
Subject: [PATCH 0852/1120] Support hatching in cairo backends.

Direct transposition of the mplcairo implementation (except for the lack
of proper stacking, which was already present for the alpha state so
it's not really "worse"), itself translated from the agg implementation.
---
 lib/matplotlib/backends/backend_cairo.py | 55 ++++++++++++++++++------
 1 file changed, 42 insertions(+), 13 deletions(-)

diff --git a/lib/matplotlib/backends/backend_cairo.py b/lib/matplotlib/backends/backend_cairo.py
index 421d857b0a03..7409cd35b394 100644
--- a/lib/matplotlib/backends/backend_cairo.py
+++ b/lib/matplotlib/backends/backend_cairo.py
@@ -34,6 +34,13 @@
 from matplotlib.transforms import Affine2D
 
 
+def _set_rgba(ctx, color, alpha, forced_alpha):
+    if len(color) == 3 or forced_alpha:
+        ctx.set_source_rgba(*color[:3], alpha)
+    else:
+        ctx.set_source_rgba(*color)
+
+
 def _append_path(ctx, path, transform, clip=None):
     for points, code in path.iter_segments(
             transform, remove_nans=True, clip=clip):
@@ -100,13 +107,11 @@ def set_context(self, ctx):
         self.gc.ctx = ctx
         self.width, self.height = size
 
-    def _fill_and_stroke(self, ctx, fill_c, alpha, alpha_overrides):
+    @staticmethod
+    def _fill_and_stroke(ctx, fill_c, alpha, alpha_overrides):
         if fill_c is not None:
             ctx.save()
-            if len(fill_c) == 3 or alpha_overrides:
-                ctx.set_source_rgba(fill_c[0], fill_c[1], fill_c[2], alpha)
-            else:
-                ctx.set_source_rgba(fill_c[0], fill_c[1], fill_c[2], fill_c[3])
+            _set_rgba(ctx, fill_c, alpha, alpha_overrides)
             ctx.fill_preserve()
             ctx.restore()
         ctx.stroke()
@@ -122,8 +127,31 @@ def draw_path(self, gc, path, transform, rgbFace=None):
                      + Affine2D().scale(1, -1).translate(0, self.height))
         ctx.new_path()
         _append_path(ctx, path, transform, clip)
-        self._fill_and_stroke(
-            ctx, rgbFace, gc.get_alpha(), gc.get_forced_alpha())
+        if rgbFace is not None:
+            ctx.save()
+            _set_rgba(ctx, rgbFace, gc.get_alpha(), gc.get_forced_alpha())
+            ctx.fill_preserve()
+            ctx.restore()
+        hatch_path = gc.get_hatch_path()
+        if hatch_path:
+            dpi = int(self.dpi)
+            hatch_surface = ctx.get_target().create_similar(
+                cairo.Content.COLOR_ALPHA, dpi, dpi)
+            hatch_ctx = cairo.Context(hatch_surface)
+            _append_path(hatch_ctx, hatch_path,
+                         Affine2D().scale(dpi, -dpi).translate(0, dpi),
+                         None)
+            hatch_ctx.set_line_width(self.points_to_pixels(gc.get_hatch_linewidth()))
+            hatch_ctx.set_source_rgba(*gc.get_hatch_color())
+            hatch_ctx.fill_preserve()
+            hatch_ctx.stroke()
+            hatch_pattern = cairo.SurfacePattern(hatch_surface)
+            hatch_pattern.set_extend(cairo.Extend.REPEAT)
+            ctx.save()
+            ctx.set_source(hatch_pattern)
+            ctx.fill_preserve()
+            ctx.restore()
+        ctx.stroke()
 
     def draw_markers(self, gc, marker_path, marker_trans, path, transform,
                      rgbFace=None):
@@ -267,8 +295,13 @@ def get_text_width_height_descent(self, s, prop, ismath):
     def new_gc(self):
         # docstring inherited
         self.gc.ctx.save()
+        # FIXME: The following doesn't properly implement a stack-like behavior
+        # and relies instead on the (non-guaranteed) fact that artists never
+        # rely on nesting gc states, so directly resetting the attributes (IOW
+        # a single-level stack) is enough.
         self.gc._alpha = 1
         self.gc._forced_alpha = False  # if True, _alpha overrides A from RGBA
+        self.gc._hatch = None
         return self.gc
 
     def points_to_pixels(self, points):
@@ -298,12 +331,8 @@ def restore(self):
 
     def set_alpha(self, alpha):
         super().set_alpha(alpha)
-        _alpha = self.get_alpha()
-        rgb = self._rgb
-        if self.get_forced_alpha():
-            self.ctx.set_source_rgba(rgb[0], rgb[1], rgb[2], _alpha)
-        else:
-            self.ctx.set_source_rgba(rgb[0], rgb[1], rgb[2], rgb[3])
+        _set_rgba(
+            self.ctx, self._rgb, self.get_alpha(), self.get_forced_alpha())
 
     def set_antialiased(self, b):
         self.ctx.set_antialias(

From 4ecc2a4fe49235f7cf29be9a79f57985a8a9f57b Mon Sep 17 00:00:00 2001
From: Pranav Raghu <73378019+Impaler343@users.noreply.github.com>
Date: Mon, 4 Mar 2024 11:08:37 +0000
Subject: [PATCH 0853/1120] DOC: Improve pyplot.matshow

---
 lib/matplotlib/pyplot.py | 18 +++++++++++++-----
 1 file changed, 13 insertions(+), 5 deletions(-)

diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 88a0f1f85d0b..04d889ec0616 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -2433,12 +2433,20 @@ def imsave(
 
 def matshow(A: ArrayLike, fignum: None | int = None, **kwargs) -> AxesImage:
     """
-    Display an array as a matrix in a new figure window.
+    Display a 2D array as a matrix in a new figure window.
 
-    The origin is set at the upper left hand corner and rows (first
-    dimension of the array) are displayed horizontally.  The aspect
-    ratio of the figure window is that of the array, unless this would
-    make an excessively short or narrow figure.
+    The origin is set at the upper left hand corner.
+    The indexing is ``(row, column)`` so that the first index runs vertically
+    and the second index runs horizontally in the figure:
+
+    .. code-block:: none
+
+        A[0, 0]   ⋯ A[0, M-1]
+           ⋮             ⋮
+        A[N-1, 0] ⋯ A[N-1, M-1]
+
+    The aspect ratio of the figure window is that of the array,
+    unless this would make an excessively short or narrow figure.
 
     Tick labels for the xaxis are placed on top.
 

From 4c67a08344f7da074521d3ff074700a103665bb0 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 14 Mar 2024 16:01:50 -0400
Subject: [PATCH 0854/1120] DOC: Fix syntax for ToolBase.image docstring

---
 lib/matplotlib/backend_tools.py | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/lib/matplotlib/backend_tools.py b/lib/matplotlib/backend_tools.py
index 7ae943fc7795..5076ae563509 100644
--- a/lib/matplotlib/backend_tools.py
+++ b/lib/matplotlib/backend_tools.py
@@ -99,12 +99,12 @@ class ToolBase:
     """
     Icon filename.
 
-    ``str | None``: Filename of the Toolbar icon; either absolute, or
-    relative to the directory containing the Python source file where the
-    ``Tool.image``class attribute is defined (in the latter case, this cannot
-    be defined as an instance attribute).  In either case, the extension is
-    optional; leaving it off lets individual backends select the icon format
-    they prefer.  If None, the *name* is used as a label in the toolbar button.
+    ``str | None``: Filename of the Toolbar icon; either absolute, or relative to the
+    directory containing the Python source file where the ``Tool.image`` class attribute
+    is defined (in the latter case, this cannot be defined as an instance attribute).
+    In either case, the extension is optional; leaving it off lets individual backends
+    select the icon format they prefer.  If None, the *name* is used as a label in the
+    toolbar button.
     """
 
     def __init__(self, toolmanager, name):

From ad8140bafe046fb48552c32146f22d2d8318d53e Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Mon, 11 Mar 2024 22:43:22 +0100
Subject: [PATCH 0855/1120] Fix __qualname__ for Axes methods that are defined
 elsewhere

---
 lib/matplotlib/axes/_axes.py | 33 ++++++++++++++++++++++++++-------
 1 file changed, 26 insertions(+), 7 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 627dd2c36d40..ae0947024b8f 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -43,6 +43,24 @@
 # All the other methods should go in the _AxesBase class.
 
 
+def _make_axes_method(func):
+    """
+    Patch the qualname for functions that are directly added to Axes.
+
+    Some Axes functionality is defined in functions in other submodules.
+    These are simply added as attributes to Axes. As a result, their
+    ``__qualname__`` is e.g. only "table" and not "Axes.table". This
+    function fixes that.
+
+    Note that the function itself is patched, so that
+    ``matplotlib.table.table.__qualname__` will also show "Axes.table".
+    However, since these functions are not intended to be standalone,
+    this is bearable.
+    """
+    func.__qualname__ = f"Axes.{func.__name__}"
+    return func
+
+
 @_docstring.interpd
 class Axes(_AxesBase):
     """
@@ -8541,18 +8559,19 @@ def violin(self, vpstats, positions=None, vert=True, widths=0.5,
 
     # Methods that are entirely implemented in other modules.
 
-    table = mtable.table
+    table = _make_axes_method(mtable.table)
 
     # args can be either Y or y1, y2, ... and all should be replaced
-    stackplot = _preprocess_data()(mstack.stackplot)
+    stackplot = _preprocess_data()(_make_axes_method(mstack.stackplot))
 
     streamplot = _preprocess_data(
-        replace_names=["x", "y", "u", "v", "start_points"])(mstream.streamplot)
+            replace_names=["x", "y", "u", "v", "start_points"])(
+        _make_axes_method(mstream.streamplot))
 
-    tricontour = mtri.tricontour
-    tricontourf = mtri.tricontourf
-    tripcolor = mtri.tripcolor
-    triplot = mtri.triplot
+    tricontour = _make_axes_method(mtri.tricontour)
+    tricontourf = _make_axes_method(mtri.tricontourf)
+    tripcolor = _make_axes_method(mtri.tripcolor)
+    triplot = _make_axes_method(mtri.triplot)
 
     def _get_aspect_ratio(self):
         """

From 117d1dbbba8a47d6cab3b618fda62ac585e88b21 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Wed, 13 Mar 2024 22:36:00 +0100
Subject: [PATCH 0856/1120] Revert renaming labels to tick_labels in
 boxplot_stats()

This is up for debate: I'm only +0.2 here.

The renaming was done in #27901, which renamed the parameter `labels`
to `tick_labels` for `boxplot()` and `bxp()`.

One can take two views here:

- If `boxplot_stats()` is specifically for the input of `bxp()`, one
  can justify the renaming as being consistent with the `bxp()`
  signature. Note however, that the returned dict still
  contains the key "label" for back-compatibility. So that brings us
  an inconsistency between the parameter name and the returned dict key.

- One can alternatively view `boxplot_stats()` as a generic function to
  define box parameters. Here, we'd only have a general `label` for
  the boy and no information that this should be used as tick
  label.

If we could make a clean transition and also rename the dict key, I
would tend to go with the first view. But the inevitable inconsistency
of the fist view let's me sway towards the second view, so that with
the revert, we've effectively not touched `boxplot_stats()`.
---
 galleries/examples/statistics/bxp.py |  2 +-
 lib/matplotlib/axes/_axes.py         |  2 +-
 lib/matplotlib/cbook.py              | 20 +++++++-------------
 lib/matplotlib/cbook.pyi             |  2 +-
 lib/matplotlib/tests/test_cbook.py   |  4 ++--
 5 files changed, 12 insertions(+), 18 deletions(-)

diff --git a/galleries/examples/statistics/bxp.py b/galleries/examples/statistics/bxp.py
index f44193166ff1..d78747523325 100644
--- a/galleries/examples/statistics/bxp.py
+++ b/galleries/examples/statistics/bxp.py
@@ -25,7 +25,7 @@
 labels = list('ABCD')
 
 # compute the boxplot stats
-stats = cbook.boxplot_stats(data, tick_labels=labels, bootstrap=10000)
+stats = cbook.boxplot_stats(data, labels=labels, bootstrap=10000)
 
 # %%
 # After we've computed the stats, we can go through and change anything.
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 627dd2c36d40..469facce3101 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -4001,7 +4001,7 @@ def boxplot(self, x, notch=None, sym=None, vert=None, whis=None,
             bootstrap = mpl.rcParams['boxplot.bootstrap']
 
         bxpstats = cbook.boxplot_stats(x, whis=whis, bootstrap=bootstrap,
-                                       tick_labels=tick_labels, autorange=autorange)
+                                       labels=tick_labels, autorange=autorange)
         if notch is None:
             notch = mpl.rcParams['boxplot.notch']
         if vert is None:
diff --git a/lib/matplotlib/cbook.py b/lib/matplotlib/cbook.py
index 6143d07cb1cb..ee043f351dbb 100644
--- a/lib/matplotlib/cbook.py
+++ b/lib/matplotlib/cbook.py
@@ -1126,9 +1126,7 @@ def _broadcast_with_masks(*args, compress=False):
     return inputs
 
 
-@_api.rename_parameter("3.9", "labels", "tick_labels")
-def boxplot_stats(X, whis=1.5, bootstrap=None, tick_labels=None,
-                  autorange=False):
+def boxplot_stats(X, whis=1.5, bootstrap=None, labels=None, autorange=False):
     r"""
     Return a list of dictionaries of statistics used to draw a series of box
     and whisker plots using `~.Axes.bxp`.
@@ -1162,14 +1160,10 @@ def boxplot_stats(X, whis=1.5, bootstrap=None, tick_labels=None,
         Number of times the confidence intervals around the median
         should be bootstrapped (percentile method).
 
-    tick_labels : array-like, optional
+    labels : list of str, optional
         Labels for each dataset. Length must be compatible with
         dimensions of *X*.
 
-        .. versionchanged:: 3.9
-            Renamed from *labels*, which is deprecated since 3.9
-            and will be removed in 3.11.
-
     autorange : bool, optional (False)
         When `True` and the data are distributed such that the 25th and 75th
         percentiles are equal, ``whis`` is set to (0, 100) such that the
@@ -1245,13 +1239,13 @@ def _compute_conf_interval(data, med, iqr, bootstrap):
     X = _reshape_2D(X, "X")
 
     ncols = len(X)
-    if tick_labels is None:
-        tick_labels = itertools.repeat(None)
-    elif len(tick_labels) != ncols:
-        raise ValueError("Dimensions of tick_labels and X must be compatible")
+    if labels is None:
+        labels = itertools.repeat(None)
+    elif len(labels) != ncols:
+        raise ValueError("Dimensions of labels and X must be compatible")
 
     input_whis = whis
-    for ii, (x, label) in enumerate(zip(X, tick_labels)):
+    for ii, (x, label) in enumerate(zip(X, labels)):
 
         # empty dict
         stats = {}
diff --git a/lib/matplotlib/cbook.pyi b/lib/matplotlib/cbook.pyi
index 832a8003bdcf..c60ae0781af1 100644
--- a/lib/matplotlib/cbook.pyi
+++ b/lib/matplotlib/cbook.pyi
@@ -135,7 +135,7 @@ def boxplot_stats(
     X: ArrayLike,
     whis: float | tuple[float, float] = ...,
     bootstrap: int | None = ...,
-    tick_labels: ArrayLike | None = ...,
+    labels: ArrayLike | None = ...,
     autorange: bool = ...,
 ) -> list[dict[str, Any]]: ...
 
diff --git a/lib/matplotlib/tests/test_cbook.py b/lib/matplotlib/tests/test_cbook.py
index 938655507c2f..fbd9746a0e21 100644
--- a/lib/matplotlib/tests/test_cbook.py
+++ b/lib/matplotlib/tests/test_cbook.py
@@ -147,7 +147,7 @@ def test_results_whiskers_percentiles(self):
 
     def test_results_withlabels(self):
         labels = ['Test1', 2, 'Aardvark', 4]
-        results = cbook.boxplot_stats(self.data, tick_labels=labels)
+        results = cbook.boxplot_stats(self.data, labels=labels)
         for lab, res in zip(labels, results):
             assert res['label'] == lab
 
@@ -158,7 +158,7 @@ def test_results_withlabels(self):
     def test_label_error(self):
         labels = [1, 2]
         with pytest.raises(ValueError):
-            cbook.boxplot_stats(self.data, tick_labels=labels)
+            cbook.boxplot_stats(self.data, labels=labels)
 
     def test_bad_dims(self):
         data = np.random.normal(size=(34, 34, 34))

From 43fcc54a38267f9f919ee4e38cfbd8535769a1a5 Mon Sep 17 00:00:00 2001
From: Rafael Tsuha <rafael.tsuha@usp.br>
Date: Fri, 11 Aug 2023 19:06:15 -0300
Subject: [PATCH 0857/1120] add getter for image interpolation_stage

---
 lib/matplotlib/image.py  | 8 ++++++++
 lib/matplotlib/image.pyi | 1 +
 2 files changed, 9 insertions(+)

diff --git a/lib/matplotlib/image.py b/lib/matplotlib/image.py
index 73738fe3bdbe..3741c2cdecb3 100644
--- a/lib/matplotlib/image.py
+++ b/lib/matplotlib/image.py
@@ -773,6 +773,14 @@ def set_interpolation(self, s):
         self._interpolation = s
         self.stale = True
 
+    def get_interpolation_stage(self):
+        """
+        Return when interpolation happens during the transform to RGBA.
+
+        One of 'data', 'rgba'.
+        """
+        return self._interpolation_stage
+
     def set_interpolation_stage(self, s):
         """
         Set when interpolation happens during the transform to RGBA.
diff --git a/lib/matplotlib/image.pyi b/lib/matplotlib/image.pyi
index 20fdc3ff946a..4b684f693845 100644
--- a/lib/matplotlib/image.pyi
+++ b/lib/matplotlib/image.pyi
@@ -89,6 +89,7 @@ class _ImageBase(martist.Artist, cm.ScalarMappable):
     def get_shape(self) -> tuple[int, int, int]: ...
     def get_interpolation(self) -> str: ...
     def set_interpolation(self, s: str | None) -> None: ...
+    def get_interpolation_stage(self) -> Literal["data", "rgba"]: ...
     def set_interpolation_stage(self, s: Literal["data", "rgba"]) -> None: ...
     def can_composite(self) -> bool: ...
     def set_resample(self, v: bool | None) -> None: ...

From 518d70f3032f0366ca8178ab1c6ccce0cdf7fb56 Mon Sep 17 00:00:00 2001
From: Rafael Tsuha <rafael.tsuha@usp.br>
Date: Fri, 11 Aug 2023 19:19:59 -0300
Subject: [PATCH 0858/1120] ENH: add interpolation_stage in qt figureoptions

add interpolation_stage selector for images in qt figureoptions
---
 lib/matplotlib/backends/qt_editor/figureoptions.py | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/backends/qt_editor/figureoptions.py b/lib/matplotlib/backends/qt_editor/figureoptions.py
index c744ccc3ca59..c36bbeb62641 100644
--- a/lib/matplotlib/backends/qt_editor/figureoptions.py
+++ b/lib/matplotlib/backends/qt_editor/figureoptions.py
@@ -164,6 +164,12 @@ def prepare_data(d, init):
             mappabledata.append((
                 'Interpolation',
                 [mappable.get_interpolation(), *interpolations]))
+
+            interpolation_stages = ['data', 'rgba']
+            mappabledata.append((
+                'Interpolation stage',
+                [mappable.get_interpolation_stage(), *interpolation_stages]))
+
         mappables.append([mappabledata, label, ""])
     # Is there a scalarmappable displayed?
     has_sm = bool(mappables)
@@ -227,9 +233,11 @@ def apply_callback(data):
         # Set ScalarMappables.
         for index, mappable_settings in enumerate(mappables):
             mappable = labeled_mappables[index][1]
-            if len(mappable_settings) == 5:
-                label, cmap, low, high, interpolation = mappable_settings
+            if len(mappable_settings) == 6:
+                label, cmap, low, high, interpolation, interpolation_stage = \
+                  mappable_settings
                 mappable.set_interpolation(interpolation)
+                mappable.set_interpolation_stage(interpolation_stage)
             elif len(mappable_settings) == 4:
                 label, cmap, low, high = mappable_settings
             mappable.set_label(label)

From 8c61611a72336192fe10d8cd35ac6df860ea0e21 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Fri, 15 Mar 2024 11:07:58 +0100
Subject: [PATCH 0859/1120] Highlight development_setup code snippets as bash,
 not python.

This looks much better and is consistent with development_workflow.rst
and release_guide.rst, which rely on the same mechanism.
---
 doc/devel/development_setup.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/doc/devel/development_setup.rst b/doc/devel/development_setup.rst
index 15d2b2ae2e2f..5b68172c2fc9 100644
--- a/doc/devel/development_setup.rst
+++ b/doc/devel/development_setup.rst
@@ -1,3 +1,5 @@
+.. highlight:: bash
+
 .. redirect-from:: /devel/gitwash/configure_git
 .. redirect-from:: /devel/gitwash/dot2_dot3
 .. redirect-from:: /devel/gitwash/following_latest

From e694329fa6fa8015f62aae6d904e84e5d12bceb5 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Fri, 15 Mar 2024 12:56:07 +0100
Subject: [PATCH 0860/1120] Fix pickling of make_axes_area_auto_adjustable'd
 axes.

... by not storing a lambda in the _AxesDecorationsSize instance, just a
name (the dict lookup cost should be negligible compare to the rest).
---
 lib/matplotlib/tests/test_pickle.py      | 3 ++-
 lib/mpl_toolkits/axes_grid1/axes_size.py | 8 ++++----
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/lib/matplotlib/tests/test_pickle.py b/lib/matplotlib/tests/test_pickle.py
index cab412bff561..7e7ccc14bf8f 100644
--- a/lib/matplotlib/tests/test_pickle.py
+++ b/lib/matplotlib/tests/test_pickle.py
@@ -15,7 +15,7 @@
 import matplotlib.pyplot as plt
 import matplotlib.transforms as mtransforms
 import matplotlib.figure as mfigure
-from mpl_toolkits.axes_grid1 import parasite_axes  # type: ignore
+from mpl_toolkits.axes_grid1 import axes_divider, parasite_axes  # type: ignore
 
 
 def test_simple():
@@ -274,6 +274,7 @@ def test_unpickle_canvas():
 
 def test_mpl_toolkits():
     ax = parasite_axes.host_axes([0, 0, 1, 1])
+    axes_divider.make_axes_area_auto_adjustable(ax)
     assert type(pickle.loads(pickle.dumps(ax))) == parasite_axes.HostAxes
 
 
diff --git a/lib/mpl_toolkits/axes_grid1/axes_size.py b/lib/mpl_toolkits/axes_grid1/axes_size.py
index d25147207726..e417c1a899ac 100644
--- a/lib/mpl_toolkits/axes_grid1/axes_size.py
+++ b/lib/mpl_toolkits/axes_grid1/axes_size.py
@@ -233,14 +233,14 @@ class _AxesDecorationsSize(_Base):
     }
 
     def __init__(self, ax, direction):
-        self._get_size = _api.check_getitem(
-            self._get_size_map, direction=direction)
+        _api.check_in_list(self._get_size_map, direction=direction)
+        self._direction = direction
         self._ax_list = [ax] if isinstance(ax, Axes) else ax
 
     def get_size(self, renderer):
         sz = max([
-            self._get_size(ax.get_tightbbox(renderer, call_axes_locator=False),
-                           ax.bbox)
+            self._get_size_map[self._direction](
+                ax.get_tightbbox(renderer, call_axes_locator=False), ax.bbox)
             for ax in self._ax_list])
         dpi = renderer.points_to_pixels(72)
         abs_size = sz / dpi

From 4888ca28ed2332fd455fd9ca0de25f44afacb4c4 Mon Sep 17 00:00:00 2001
From: Alexander Volkov <avolkov@astralinux.ru>
Date: Fri, 15 Mar 2024 15:20:28 +0300
Subject: [PATCH 0861/1120] Update "Created with" url in hand.svg

Current url points to online sextoys store.
---
 lib/matplotlib/mpl-data/images/hand.svg | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/mpl-data/images/hand.svg b/lib/matplotlib/mpl-data/images/hand.svg
index f246f51e57d5..28b96a2a9c4a 100644
--- a/lib/matplotlib/mpl-data/images/hand.svg
+++ b/lib/matplotlib/mpl-data/images/hand.svg
@@ -5,7 +5,7 @@
  <!ATTLIST svg
   xmlns:xlink CDATA #FIXED "http://www.w3.org/1999/xlink">
 ]>
-<!-- Created with Sodipodi ("http://www.sodipodi.com/") -->
+<!-- Created with Sodipodi ("https://sourceforge.net/projects/sodipodi/") -->
 <svg
    xml:space="preserve"
    width="128pt"

From c4e1c731d4b65a1ac4707943c88713e93b8f1d71 Mon Sep 17 00:00:00 2001
From: Mostafa Noah <92794284+MostafaNouh0011@users.noreply.github.com>
Date: Fri, 15 Mar 2024 18:52:54 +0200
Subject: [PATCH 0862/1120] Update docs (#27927)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* Improved the sentence directing readers to the developer's guide for comprehensive guidance

* Changed the “developers guide” to “contributing guide”, consistent with the main README

* Update CONTRIBUTING.md

Removed blank lines
---
 .github/CONTRIBUTING.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md
index c4198cdcdf14..cb27bbf19d46 100644
--- a/.github/CONTRIBUTING.md
+++ b/.github/CONTRIBUTING.md
@@ -1 +1 @@
-Please refer to the [developers guide](https://matplotlib.org/devel/index.html).
+Please refer to the [contributing guide](https://matplotlib.org/devel/index.html).

From a8d8915de24ad2ac3706926bf790a85a03e426ae Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Fri, 15 Mar 2024 10:15:09 +0100
Subject: [PATCH 0863/1120] DOC: Add summary lines to plot types.

IMHO it's meaningful to give a one-sentence summary on the individual
pages, e.g. at
https://matplotlib.org/stable/plot_types/basic/plot.html#sphx-glr-plot-types-basic-plot-py

> Plot y versus x as lines and/or markers.
>
> See `plot`.

is more helpful than just

> See `plot`.

Users can already decide if that's the correct function for them and
whether it's worth following the link. Also, the first sentence is used
in the tooltip on the index page, where the current "See ..." is not
helpful.

I believe it's ok to just copy the text. Automatic insertion or check
for consistency are not worth the added effort. First, these summary
lines change rarely. Second, even if we improve the method summary and
forget to udpate here, nothing really bad happens; we've maybe a
slightly less optimal description here, but that's still way better than
no description at all.

Semi-OT: I changed the barbs summary from

> Plot a 2D field of barbs.

to

> Plot a 2D field of wind barbs.

because, AFAIK these are only used for wind, and that makes the context
more clear. People outside of metrology may not know what barbs are
so giving that extra context is reasonable.
---
 galleries/plot_types/arrays/barbs.py             | 1 +
 galleries/plot_types/arrays/contour.py           | 1 +
 galleries/plot_types/arrays/contourf.py          | 1 +
 galleries/plot_types/arrays/imshow.py            | 1 +
 galleries/plot_types/arrays/pcolormesh.py        | 1 +
 galleries/plot_types/arrays/quiver.py            | 1 +
 galleries/plot_types/arrays/streamplot.py        | 1 +
 galleries/plot_types/basic/fill_between.py       | 1 +
 galleries/plot_types/basic/plot.py               | 1 +
 galleries/plot_types/basic/scatter_plot.py       | 1 +
 galleries/plot_types/basic/stackplot.py          | 2 ++
 galleries/plot_types/basic/stairs.py             | 1 +
 galleries/plot_types/basic/stem.py               | 1 +
 galleries/plot_types/stats/boxplot_plot.py       | 1 +
 galleries/plot_types/stats/ecdf.py               | 1 +
 galleries/plot_types/stats/errorbar_plot.py      | 1 +
 galleries/plot_types/stats/eventplot.py          | 1 +
 galleries/plot_types/stats/hexbin.py             | 1 +
 galleries/plot_types/stats/hist2d.py             | 1 +
 galleries/plot_types/stats/hist_plot.py          | 1 +
 galleries/plot_types/stats/pie.py                | 1 +
 galleries/plot_types/stats/violin.py             | 1 +
 galleries/plot_types/unstructured/tricontour.py  | 1 +
 galleries/plot_types/unstructured/tricontourf.py | 1 +
 galleries/plot_types/unstructured/tripcolor.py   | 1 +
 galleries/plot_types/unstructured/triplot.py     | 1 +
 lib/matplotlib/quiver.py                         | 2 +-
 lib/matplotlib/stackplot.py                      | 2 +-
 28 files changed, 29 insertions(+), 2 deletions(-)

diff --git a/galleries/plot_types/arrays/barbs.py b/galleries/plot_types/arrays/barbs.py
index 63e492869039..b007d9b875b8 100644
--- a/galleries/plot_types/arrays/barbs.py
+++ b/galleries/plot_types/arrays/barbs.py
@@ -2,6 +2,7 @@
 =================
 barbs(X, Y, U, V)
 =================
+Plot a 2D field of wind barbs.
 
 See `~matplotlib.axes.Axes.barbs`.
 """
diff --git a/galleries/plot_types/arrays/contour.py b/galleries/plot_types/arrays/contour.py
index fe79c18d2b58..1bf8d71d482b 100644
--- a/galleries/plot_types/arrays/contour.py
+++ b/galleries/plot_types/arrays/contour.py
@@ -2,6 +2,7 @@
 ================
 contour(X, Y, Z)
 ================
+Plot contour lines.
 
 See `~matplotlib.axes.Axes.contour`.
 """
diff --git a/galleries/plot_types/arrays/contourf.py b/galleries/plot_types/arrays/contourf.py
index bde2f984fc0f..c25afe0bfa77 100644
--- a/galleries/plot_types/arrays/contourf.py
+++ b/galleries/plot_types/arrays/contourf.py
@@ -2,6 +2,7 @@
 =================
 contourf(X, Y, Z)
 =================
+Plot filled contours.
 
 See `~matplotlib.axes.Axes.contourf`.
 """
diff --git a/galleries/plot_types/arrays/imshow.py b/galleries/plot_types/arrays/imshow.py
index be647d1f2924..c28278c6c657 100644
--- a/galleries/plot_types/arrays/imshow.py
+++ b/galleries/plot_types/arrays/imshow.py
@@ -2,6 +2,7 @@
 =========
 imshow(Z)
 =========
+Display data as an image, i.e., on a 2D regular raster.
 
 See `~matplotlib.axes.Axes.imshow`.
 """
diff --git a/galleries/plot_types/arrays/pcolormesh.py b/galleries/plot_types/arrays/pcolormesh.py
index b490dcb99d3f..4f0913f62521 100644
--- a/galleries/plot_types/arrays/pcolormesh.py
+++ b/galleries/plot_types/arrays/pcolormesh.py
@@ -2,6 +2,7 @@
 ===================
 pcolormesh(X, Y, Z)
 ===================
+Create a pseudocolor plot with a non-regular rectangular grid.
 
 `~.axes.Axes.pcolormesh` is more flexible than `~.axes.Axes.imshow` in that
 the x and y vectors need not be equally spaced (indeed they can be skewed).
diff --git a/galleries/plot_types/arrays/quiver.py b/galleries/plot_types/arrays/quiver.py
index 5d6dc808c518..4b1cbd03759c 100644
--- a/galleries/plot_types/arrays/quiver.py
+++ b/galleries/plot_types/arrays/quiver.py
@@ -2,6 +2,7 @@
 ==================
 quiver(X, Y, U, V)
 ==================
+Plot a 2D field of arrows.
 
 See `~matplotlib.axes.Axes.quiver`.
 """
diff --git a/galleries/plot_types/arrays/streamplot.py b/galleries/plot_types/arrays/streamplot.py
index 3f1e2ef4e1cc..670773d2cfd3 100644
--- a/galleries/plot_types/arrays/streamplot.py
+++ b/galleries/plot_types/arrays/streamplot.py
@@ -2,6 +2,7 @@
 ======================
 streamplot(X, Y, U, V)
 ======================
+Draw streamlines of a vector flow.
 
 See `~matplotlib.axes.Axes.streamplot`.
 """
diff --git a/galleries/plot_types/basic/fill_between.py b/galleries/plot_types/basic/fill_between.py
index a454c3c30772..feca3c658d3e 100644
--- a/galleries/plot_types/basic/fill_between.py
+++ b/galleries/plot_types/basic/fill_between.py
@@ -2,6 +2,7 @@
 =======================
 fill_between(x, y1, y2)
 =======================
+Fill the area between two horizontal curves.
 
 See `~matplotlib.axes.Axes.fill_between`.
 """
diff --git a/galleries/plot_types/basic/plot.py b/galleries/plot_types/basic/plot.py
index e494fdf24918..34cf500599bb 100644
--- a/galleries/plot_types/basic/plot.py
+++ b/galleries/plot_types/basic/plot.py
@@ -2,6 +2,7 @@
 ==========
 plot(x, y)
 ==========
+Plot y versus x as lines and/or markers.
 
 See `~matplotlib.axes.Axes.plot`.
 """
diff --git a/galleries/plot_types/basic/scatter_plot.py b/galleries/plot_types/basic/scatter_plot.py
index 792016c0e79c..07fa943b724f 100644
--- a/galleries/plot_types/basic/scatter_plot.py
+++ b/galleries/plot_types/basic/scatter_plot.py
@@ -2,6 +2,7 @@
 =============
 scatter(x, y)
 =============
+A scatter plot of y vs. x with varying marker size and/or color.
 
 See `~matplotlib.axes.Axes.scatter`.
 """
diff --git a/galleries/plot_types/basic/stackplot.py b/galleries/plot_types/basic/stackplot.py
index 5b23b52775b3..275fa5cb67ba 100644
--- a/galleries/plot_types/basic/stackplot.py
+++ b/galleries/plot_types/basic/stackplot.py
@@ -2,6 +2,8 @@
 ===============
 stackplot(x, y)
 ===============
+Draw a stacked area plot or a streamgraph.
+
 See `~matplotlib.axes.Axes.stackplot`
 """
 import matplotlib.pyplot as plt
diff --git a/galleries/plot_types/basic/stairs.py b/galleries/plot_types/basic/stairs.py
index de5761e3a7a5..df0e91d1041b 100644
--- a/galleries/plot_types/basic/stairs.py
+++ b/galleries/plot_types/basic/stairs.py
@@ -2,6 +2,7 @@
 ==============
 stairs(values)
 ==============
+A stepwise constant function as a line with bounding edges or a filled plot.
 
 See `~matplotlib.axes.Axes.stairs` when plotting :math:`y` between
 :math:`(x_i, x_{i+1})`. For plotting :math:`y` at :math:`x`, see
diff --git a/galleries/plot_types/basic/stem.py b/galleries/plot_types/basic/stem.py
index a606482ecf9b..afd10ca1c9df 100644
--- a/galleries/plot_types/basic/stem.py
+++ b/galleries/plot_types/basic/stem.py
@@ -2,6 +2,7 @@
 ==========
 stem(x, y)
 ==========
+Create a stem plot.
 
 See `~matplotlib.axes.Axes.stem`.
 """
diff --git a/galleries/plot_types/stats/boxplot_plot.py b/galleries/plot_types/stats/boxplot_plot.py
index cdad3c52320f..996b97a2aef4 100644
--- a/galleries/plot_types/stats/boxplot_plot.py
+++ b/galleries/plot_types/stats/boxplot_plot.py
@@ -2,6 +2,7 @@
 ==========
 boxplot(X)
 ==========
+Draw a box and whisker plot.
 
 See `~matplotlib.axes.Axes.boxplot`.
 """
diff --git a/galleries/plot_types/stats/ecdf.py b/galleries/plot_types/stats/ecdf.py
index bd5f9fa9e5b2..1a8566b3d2eb 100644
--- a/galleries/plot_types/stats/ecdf.py
+++ b/galleries/plot_types/stats/ecdf.py
@@ -2,6 +2,7 @@
 =======
 ecdf(x)
 =======
+Compute and plot the empirical cumulative distribution function of x.
 
 See `~matplotlib.axes.Axes.ecdf`.
 """
diff --git a/galleries/plot_types/stats/errorbar_plot.py b/galleries/plot_types/stats/errorbar_plot.py
index 0e226e11b315..c96a08e111c1 100644
--- a/galleries/plot_types/stats/errorbar_plot.py
+++ b/galleries/plot_types/stats/errorbar_plot.py
@@ -2,6 +2,7 @@
 ==========================
 errorbar(x, y, yerr, xerr)
 ==========================
+Plot y versus x as lines and/or markers with attached errorbars.
 
 See `~matplotlib.axes.Axes.errorbar`.
 """
diff --git a/galleries/plot_types/stats/eventplot.py b/galleries/plot_types/stats/eventplot.py
index da8c33c28425..babdbe6d1ca1 100644
--- a/galleries/plot_types/stats/eventplot.py
+++ b/galleries/plot_types/stats/eventplot.py
@@ -2,6 +2,7 @@
 ============
 eventplot(D)
 ============
+Plot identical parallel lines at the given positions.
 
 See `~matplotlib.axes.Axes.eventplot`.
 """
diff --git a/galleries/plot_types/stats/hexbin.py b/galleries/plot_types/stats/hexbin.py
index 91e771308afd..9d3a2a071346 100644
--- a/galleries/plot_types/stats/hexbin.py
+++ b/galleries/plot_types/stats/hexbin.py
@@ -2,6 +2,7 @@
 ===============
 hexbin(x, y, C)
 ===============
+Make a 2D hexagonal binning plot of points x, y.
 
 See `~matplotlib.axes.Axes.hexbin`.
 """
diff --git a/galleries/plot_types/stats/hist2d.py b/galleries/plot_types/stats/hist2d.py
index 3e43f7ee8ace..d95b67539b33 100644
--- a/galleries/plot_types/stats/hist2d.py
+++ b/galleries/plot_types/stats/hist2d.py
@@ -2,6 +2,7 @@
 ============
 hist2d(x, y)
 ============
+Make a 2D histogram plot.
 
 See `~matplotlib.axes.Axes.hist2d`.
 """
diff --git a/galleries/plot_types/stats/hist_plot.py b/galleries/plot_types/stats/hist_plot.py
index 6c86a0aca216..6328fe9d07c6 100644
--- a/galleries/plot_types/stats/hist_plot.py
+++ b/galleries/plot_types/stats/hist_plot.py
@@ -2,6 +2,7 @@
 =======
 hist(x)
 =======
+Compute and plot a histogram.
 
 See `~matplotlib.axes.Axes.hist`.
 """
diff --git a/galleries/plot_types/stats/pie.py b/galleries/plot_types/stats/pie.py
index 80484a0eb932..bd8d555f0040 100644
--- a/galleries/plot_types/stats/pie.py
+++ b/galleries/plot_types/stats/pie.py
@@ -2,6 +2,7 @@
 ======
 pie(x)
 ======
+Plot a pie chart.
 
 See `~matplotlib.axes.Axes.pie`.
 """
diff --git a/galleries/plot_types/stats/violin.py b/galleries/plot_types/stats/violin.py
index c8a987a690dd..2ea2161ad91c 100644
--- a/galleries/plot_types/stats/violin.py
+++ b/galleries/plot_types/stats/violin.py
@@ -2,6 +2,7 @@
 =============
 violinplot(D)
 =============
+Make a violin plot.
 
 See `~matplotlib.axes.Axes.violinplot`.
 """
diff --git a/galleries/plot_types/unstructured/tricontour.py b/galleries/plot_types/unstructured/tricontour.py
index 83b0a212fd83..292ff551fe36 100644
--- a/galleries/plot_types/unstructured/tricontour.py
+++ b/galleries/plot_types/unstructured/tricontour.py
@@ -2,6 +2,7 @@
 ===================
 tricontour(x, y, z)
 ===================
+Draw contour lines on an unstructured triangular grid.
 
 See `~matplotlib.axes.Axes.tricontour`.
 """
diff --git a/galleries/plot_types/unstructured/tricontourf.py b/galleries/plot_types/unstructured/tricontourf.py
index da909c02f0b2..aab748e73024 100644
--- a/galleries/plot_types/unstructured/tricontourf.py
+++ b/galleries/plot_types/unstructured/tricontourf.py
@@ -2,6 +2,7 @@
 ====================
 tricontourf(x, y, z)
 ====================
+Draw contour regions on an unstructured triangular grid.
 
 See `~matplotlib.axes.Axes.tricontourf`.
 """
diff --git a/galleries/plot_types/unstructured/tripcolor.py b/galleries/plot_types/unstructured/tripcolor.py
index e2619a68444e..398877653db8 100644
--- a/galleries/plot_types/unstructured/tripcolor.py
+++ b/galleries/plot_types/unstructured/tripcolor.py
@@ -2,6 +2,7 @@
 ==================
 tripcolor(x, y, z)
 ==================
+Create a pseudocolor plot of an unstructured triangular grid.
 
 See `~matplotlib.axes.Axes.tripcolor`.
 """
diff --git a/galleries/plot_types/unstructured/triplot.py b/galleries/plot_types/unstructured/triplot.py
index 78cf8e32a318..d726c46e1e47 100644
--- a/galleries/plot_types/unstructured/triplot.py
+++ b/galleries/plot_types/unstructured/triplot.py
@@ -2,6 +2,7 @@
 =============
 triplot(x, y)
 =============
+Draw an unstructured triangular grid as lines and/or markers.
 
 See `~matplotlib.axes.Axes.triplot`.
 """
diff --git a/lib/matplotlib/quiver.py b/lib/matplotlib/quiver.py
index db4ef35f3034..8fa1962d6321 100644
--- a/lib/matplotlib/quiver.py
+++ b/lib/matplotlib/quiver.py
@@ -727,7 +727,7 @@ def _h_arrows(self, length):
 
 
 _barbs_doc = r"""
-Plot a 2D field of barbs.
+Plot a 2D field of wind barbs.
 
 Call signature::
 
diff --git a/lib/matplotlib/stackplot.py b/lib/matplotlib/stackplot.py
index 0d9b896f6f4c..dd579bcd5877 100644
--- a/lib/matplotlib/stackplot.py
+++ b/lib/matplotlib/stackplot.py
@@ -19,7 +19,7 @@ def stackplot(axes, x, *args,
               labels=(), colors=None, hatch=None, baseline='zero',
               **kwargs):
     """
-    Draw a stacked area plot.
+    Draw a stacked area plot or a streamgraph.
 
     Parameters
     ----------

From 95890c2f82db570220c797e865c5747ba1ae1f94 Mon Sep 17 00:00:00 2001
From: saranti <tsarantis@proton.me>
Date: Sat, 9 Mar 2024 21:28:53 +1100
Subject: [PATCH 0864/1120] add legend to boxplot

---
 .../next_whats_new/boxplot_legend_support.rst | 60 +++++++++++++++++++
 lib/matplotlib/axes/_axes.py                  | 45 ++++++++++++--
 lib/matplotlib/axes/_axes.pyi                 |  2 +
 lib/matplotlib/pyplot.py                      |  2 +
 lib/matplotlib/tests/test_legend.py           | 47 +++++++++++++++
 5 files changed, 152 insertions(+), 4 deletions(-)
 create mode 100644 doc/users/next_whats_new/boxplot_legend_support.rst

diff --git a/doc/users/next_whats_new/boxplot_legend_support.rst b/doc/users/next_whats_new/boxplot_legend_support.rst
new file mode 100644
index 000000000000..fa6069ebb958
--- /dev/null
+++ b/doc/users/next_whats_new/boxplot_legend_support.rst
@@ -0,0 +1,60 @@
+Legend support for Boxplot
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+Boxplots now support a *label* parameter to create legend entries.
+
+Legend labels can be passed as a list of strings to label multiple boxes in a single
+boxplot call:
+
+
+.. plot::
+    :include-source: true
+    :alt: Example of creating 3 boxplots and assigning legend labels as a sequence.
+
+    import matplotlib.pyplot as plt
+    import numpy as np
+
+    np.random.seed(19680801)
+    fruit_weights = [
+        np.random.normal(130, 10, size=100),
+        np.random.normal(125, 20, size=100),
+        np.random.normal(120, 30, size=100),
+    ]
+    labels = ['peaches', 'oranges', 'tomatoes']
+    colors = ['peachpuff', 'orange', 'tomato']
+
+    fig, ax = plt.subplots()
+    ax.set_ylabel('fruit weight (g)')
+
+    bplot = ax.boxplot(fruit_weights,
+                       patch_artist=True,  # fill with color
+                       label=labels)
+
+    # fill with colors
+    for patch, color in zip(bplot['boxes'], colors):
+        patch.set_facecolor(color)
+
+    ax.set_xticks([])
+    ax.legend()
+
+
+Or as a single string to each individual boxplot:
+
+.. plot::
+    :include-source: true
+    :alt: Example of creating 2 boxplots and assigning each legend label as a string.
+
+    import matplotlib.pyplot as plt
+    import numpy as np
+
+    fig, ax = plt.subplots()
+
+    data_A = np.random.random((100, 3))
+    data_B = np.random.random((100, 3)) + 0.2
+    pos = np.arange(3)
+
+    ax.boxplot(data_A, positions=pos - 0.2, patch_artist=True, label='Box A',
+               boxprops={'facecolor': 'steelblue'})
+    ax.boxplot(data_B, positions=pos + 0.2, patch_artist=True, label='Box B',
+               boxprops={'facecolor': 'lightblue'})
+
+    ax.legend()
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 627dd2c36d40..14f575a5b4db 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -3798,7 +3798,7 @@ def boxplot(self, x, notch=None, sym=None, vert=None, whis=None,
                 tick_labels=None, flierprops=None, medianprops=None,
                 meanprops=None, capprops=None, whiskerprops=None,
                 manage_ticks=True, autorange=False, zorder=None,
-                capwidths=None):
+                capwidths=None, label=None):
         """
         Draw a box and whisker plot.
 
@@ -3985,6 +3985,18 @@ def boxplot(self, x, notch=None, sym=None, vert=None, whis=None,
             The style of the median.
         meanprops : dict, default: None
             The style of the mean.
+        label : str or list of str, optional
+            Legend labels. Use a single string when all boxes have the same style and
+            you only want a single legend entry for them. Use a list of strings to
+            label all boxes individually. To be distinguishable, the boxes should be
+            styled individually, which is currently only possible by modifying the
+            returned artists, see e.g. :doc:`/gallery/statistics/boxplot_demo`.
+
+            In the case of a single string, the legend entry will technically be
+            associated with the first box only. By default, the legend will show the
+            median line (``result["medians"]``); if *patch_artist* is True, the legend
+            will show the box `Patch` artists (``result["boxes"]``) instead.
+
         data : indexable object, optional
             DATA_PARAMETER_PLACEHOLDER
 
@@ -4105,7 +4117,7 @@ def boxplot(self, x, notch=None, sym=None, vert=None, whis=None,
                            meanline=meanline, showfliers=showfliers,
                            capprops=capprops, whiskerprops=whiskerprops,
                            manage_ticks=manage_ticks, zorder=zorder,
-                           capwidths=capwidths)
+                           capwidths=capwidths, label=label)
         return artists
 
     def bxp(self, bxpstats, positions=None, widths=None, vert=True,
@@ -4114,7 +4126,7 @@ def bxp(self, bxpstats, positions=None, widths=None, vert=True,
             boxprops=None, whiskerprops=None, flierprops=None,
             medianprops=None, capprops=None, meanprops=None,
             meanline=False, manage_ticks=True, zorder=None,
-            capwidths=None):
+            capwidths=None, label=None):
         """
         Draw a box and whisker plot from pre-computed statistics.
 
@@ -4197,6 +4209,18 @@ def bxp(self, bxpstats, positions=None, widths=None, vert=True,
           If True, the tick locations and labels will be adjusted to match the
           boxplot positions.
 
+        label : str or list of str, optional
+            Legend labels. Use a single string when all boxes have the same style and
+            you only want a single legend entry for them. Use a list of strings to
+            label all boxes individually. To be distinguishable, the boxes should be
+            styled individually, which is currently only possible by modifying the
+            returned artists, see e.g. :doc:`/gallery/statistics/boxplot_demo`.
+
+            In the case of a single string, the legend entry will technically be
+            associated with the first box only. By default, the legend will show the
+            median line (``result["medians"]``); if *patch_artist* is True, the legend
+            will show the box `Patch` artists (``result["boxes"]``) instead.
+
         zorder : float, default: ``Line2D.zorder = 2``
           The zorder of the resulting boxplot.
 
@@ -4361,6 +4385,7 @@ def do_patch(xs, ys, **kwargs):
             if showbox:
                 do_box = do_patch if patch_artist else do_plot
                 boxes.append(do_box(box_x, box_y, **box_kw))
+                median_kw.setdefault('label', '_nolegend_')
             # draw the whiskers
             whisker_kw.setdefault('label', '_nolegend_')
             whiskers.append(do_plot(whis_x, whislo_y, **whisker_kw))
@@ -4371,7 +4396,6 @@ def do_patch(xs, ys, **kwargs):
                 caps.append(do_plot(cap_x, cap_lo, **cap_kw))
                 caps.append(do_plot(cap_x, cap_hi, **cap_kw))
             # draw the medians
-            median_kw.setdefault('label', '_nolegend_')
             medians.append(do_plot(med_x, med_y, **median_kw))
             # maybe draw the means
             if showmeans:
@@ -4389,6 +4413,19 @@ def do_patch(xs, ys, **kwargs):
                 flier_y = stats['fliers']
                 fliers.append(do_plot(flier_x, flier_y, **flier_kw))
 
+        # Set legend labels
+        if label:
+            box_or_med = boxes if showbox and patch_artist else medians
+            if cbook.is_scalar_or_string(label):
+                # assign the label only to the first box
+                box_or_med[0].set_label(label)
+            else:  # label is a sequence
+                if len(box_or_med) != len(label):
+                    raise ValueError("There must be an equal number of legend"
+                                     " labels and boxplots.")
+                for artist, lbl in zip(box_or_med, label):
+                    artist.set_label(lbl)
+
         if manage_ticks:
             axis_name = "x" if vert else "y"
             interval = getattr(self.dataLim, f"interval{axis_name}")
diff --git a/lib/matplotlib/axes/_axes.pyi b/lib/matplotlib/axes/_axes.pyi
index 18c10c1452ba..d00008623633 100644
--- a/lib/matplotlib/axes/_axes.pyi
+++ b/lib/matplotlib/axes/_axes.pyi
@@ -372,6 +372,7 @@ class Axes(_AxesBase):
         autorange: bool = ...,
         zorder: float | None = ...,
         capwidths: float | ArrayLike | None = ...,
+		label: Sequence[str] | None = ...,
         *,
         data=...,
     ) -> dict[str, Any]: ...
@@ -397,6 +398,7 @@ class Axes(_AxesBase):
         manage_ticks: bool = ...,
         zorder: float | None = ...,
         capwidths: float | ArrayLike | None = ...,
+		label: Sequence[str] | None = ...,
     ) -> dict[str, Any]: ...
     def scatter(
         self,
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 04d889ec0616..81a6622db77e 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -2871,6 +2871,7 @@ def boxplot(
     autorange: bool = False,
     zorder: float | None = None,
     capwidths: float | ArrayLike | None = None,
+    label: Sequence[str] | None = None,
     *,
     data=None,
 ) -> dict[str, Any]:
@@ -2902,6 +2903,7 @@ def boxplot(
         autorange=autorange,
         zorder=zorder,
         capwidths=capwidths,
+        label=label,
         **({"data": data} if data is not None else {}),
     )
 
diff --git a/lib/matplotlib/tests/test_legend.py b/lib/matplotlib/tests/test_legend.py
index 3b3145006427..4b8fc1b12f60 100644
--- a/lib/matplotlib/tests/test_legend.py
+++ b/lib/matplotlib/tests/test_legend.py
@@ -1435,3 +1435,50 @@ def test_legend_text():
         leg_bboxes.append(
             leg.get_window_extent().transformed(ax.transAxes.inverted()))
     assert_allclose(leg_bboxes[1].bounds, leg_bboxes[0].bounds)
+
+
+def test_boxplot_labels():
+    # Test that boxplot(..., labels=) sets the tick labels but not legend entries
+    # This is not consistent with other plot types but is the current behavior.
+    fig, ax = plt.subplots()
+    np.random.seed(19680801)
+    data = np.random.random((10, 3))
+    bp = ax.boxplot(data, labels=['A', 'B', 'C'])
+    # Check that labels set the tick labels ...
+    assert [l.get_text() for l in ax.get_xticklabels()] == ['A', 'B', 'C']
+    # ... but not legend entries
+    handles, labels = ax.get_legend_handles_labels()
+    assert len(handles) == 0
+    assert len(labels) == 0
+
+
+def test_boxplot_legend_labels():
+    # Test that legend entries are generated when passing `label`.
+    np.random.seed(19680801)
+    data = np.random.random((10, 4))
+    fig, axs = plt.subplots(nrows=1, ncols=4)
+    legend_labels = ['box A', 'box B', 'box C', 'box D']
+
+    # Testing legend labels and patch passed to legend.
+    bp1 = axs[0].boxplot(data, patch_artist=True, label=legend_labels)
+    assert [v.get_label() for v in bp1['boxes']] == legend_labels
+    handles, labels = axs[0].get_legend_handles_labels()
+    assert labels == legend_labels
+    assert all(isinstance(h, mpl.patches.PathPatch) for h in handles)
+
+    # Testing legend without `box`.
+    bp2 = axs[1].boxplot(data, label=legend_labels, showbox=False)
+    # Without a box, The legend entries should be passed from the medians.
+    assert [v.get_label() for v in bp2['medians']] == legend_labels
+    handles, labels = axs[1].get_legend_handles_labels()
+    assert labels == legend_labels
+    assert all(isinstance(h, mpl.lines.Line2D) for h in handles)
+
+    # Testing legend with number of labels different from number of boxes.
+    with pytest.raises(ValueError, match='There must be an equal number'):
+        bp3 = axs[2].boxplot(data, label=legend_labels[:-1])
+
+    # Test that for a string label, only the first box gets a label.
+    bp4 = axs[3].boxplot(data, label='box A')
+    assert bp4['medians'][0].get_label() == 'box A'
+    assert all(x.get_label().startswith("_") for x in bp4['medians'][1:])

From 7b397558eb43a90cca8a16dcfa32652a954271dc Mon Sep 17 00:00:00 2001
From: saranti <tsarantis@proton.me>
Date: Sat, 16 Mar 2024 15:38:42 +1100
Subject: [PATCH 0865/1120] delete old function

---
 lib/matplotlib/tests/test_legend.py | 15 ---------------
 1 file changed, 15 deletions(-)

diff --git a/lib/matplotlib/tests/test_legend.py b/lib/matplotlib/tests/test_legend.py
index 4b8fc1b12f60..195e65c883e1 100644
--- a/lib/matplotlib/tests/test_legend.py
+++ b/lib/matplotlib/tests/test_legend.py
@@ -1437,21 +1437,6 @@ def test_legend_text():
     assert_allclose(leg_bboxes[1].bounds, leg_bboxes[0].bounds)
 
 
-def test_boxplot_labels():
-    # Test that boxplot(..., labels=) sets the tick labels but not legend entries
-    # This is not consistent with other plot types but is the current behavior.
-    fig, ax = plt.subplots()
-    np.random.seed(19680801)
-    data = np.random.random((10, 3))
-    bp = ax.boxplot(data, labels=['A', 'B', 'C'])
-    # Check that labels set the tick labels ...
-    assert [l.get_text() for l in ax.get_xticklabels()] == ['A', 'B', 'C']
-    # ... but not legend entries
-    handles, labels = ax.get_legend_handles_labels()
-    assert len(handles) == 0
-    assert len(labels) == 0
-
-
 def test_boxplot_legend_labels():
     # Test that legend entries are generated when passing `label`.
     np.random.seed(19680801)

From 2cdd078ba0e8b9683b3c54d146c80804a069be6d Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Mon, 11 Mar 2024 22:46:34 +0100
Subject: [PATCH 0866/1120] Add a note to pyplot docstrings referencing the
 corresponding object methods

Partial fix for #17786: This adds notes for the pyplot functions
auto-generated by boilerplate.py.
---
 .../users_explain/figure/api_interfaces.rst   |  2 +
 lib/matplotlib/pyplot.py                      | 70 +++++++++++++++++++
 2 files changed, 72 insertions(+)

diff --git a/galleries/users_explain/figure/api_interfaces.rst b/galleries/users_explain/figure/api_interfaces.rst
index 5279fe24634a..177e516cdaa0 100644
--- a/galleries/users_explain/figure/api_interfaces.rst
+++ b/galleries/users_explain/figure/api_interfaces.rst
@@ -58,6 +58,8 @@ is very flexible, and allows us to customize the objects after they are created,
 but before they are displayed.
 
 
+.. _pyplot_interface:
+
 The implicit "pyplot" interface
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 88a0f1f85d0b..a19c3abd5c0c 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -179,9 +179,79 @@ def _copy_docstring_and_deprecators(
         method = method.__wrapped__
     for decorator in decorators[::-1]:
         func = decorator(func)
+    _add_pyplot_note(func, method)
     return func
 
 
+_NO_PYPLOT_NOTE = [
+    'FigureBase._gci',  # wrapped_func is private
+    '_AxesBase._sci',  # wrapped_func is private
+    'Artist.findobj',  # not a standard pyplot wrapper because it does not operate
+                       # on the current Figure / Axes. Explanation of relation would
+                       # be more complex and is not too important.
+]
+
+
+def _add_pyplot_note(func, wrapped_func):
+    """
+    Add a note to the docstring of *func* that it is a pyplot wrapper.
+
+    The note is added to the "Notes" section of the docstring. If that does
+    not exist, a "Notes" section is created. In numpydoc, the "Notes"
+    section is the third last possible section, only potentially followed by
+    "References" and "Examples".
+    """
+    if not func.__doc__:
+        return  # nothing to do
+
+    qualname = wrapped_func.__qualname__
+    if qualname in _NO_PYPLOT_NOTE:
+        return
+
+    wrapped_func_is_method = True
+    if "." not in qualname:
+        # method qualnames are prefixed by the class and ".", e.g. "Axes.plot"
+        wrapped_func_is_method = False
+        link = f"{wrapped_func.__module__}.{qualname}"
+    elif qualname.startswith("Axes."):  # e.g. "Axes.plot"
+        link = ".axes." + qualname
+    elif qualname.startswith("_AxesBase."):  # e.g. "_AxesBase.set_xlabel"
+        link = ".axes.Axes" + qualname[9:]
+    elif qualname.startswith("Figure."):  # e.g. "Figure.figimage"
+        link = "." + qualname
+    elif qualname.startswith("FigureBase."):  # e.g. "FigureBase.gca"
+        link = ".Figure" + qualname[10:]
+    elif qualname.startswith("FigureCanvasBase."):  # "FigureBaseCanvas.mpl_connect"
+        link = "." + qualname
+    else:
+        raise RuntimeError(f"Wrapped method from unexpected class: {qualname}")
+
+    if wrapped_func_is_method:
+        message = f"This is the :ref:`pyplot wrapper <pyplot_interface>` for `{link}`."
+    else:
+        message = f"This is equivalent to `{link}`."
+
+    # Find the correct insert position:
+    # - either we already have a "Notes" section into which we can insert
+    # - or we create one before the next present section. Note that in numpydoc, the
+    #   "Notes" section is the third last possible section, only potentially followed
+    #   by "References" and "Examples".
+    # - or we append a new "Notes" section at the end.
+    doc = inspect.cleandoc(func.__doc__)
+    if "\nNotes\n-----" in doc:
+        before, after = doc.split("\nNotes\n-----", 1)
+    elif (index := doc.find("\nReferences\n----------")) != -1:
+        before, after = doc[:index], doc[index:]
+    elif (index := doc.find("\nExamples\n--------")) != -1:
+        before, after = doc[:index], doc[index:]
+    else:
+        # No "Notes", "References", or "Examples" --> append to the end.
+        before = doc + "\n"
+        after = ""
+
+    func.__doc__ = f"{before}\nNotes\n-----\n\n.. note::\n\n    {message}\n{after}"
+
+
 ## Global ##
 
 

From 2db9f2de4b41e6551c18c3b685bd8121e043fc86 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 18 Mar 2024 19:25:57 +0000
Subject: [PATCH 0867/1120] Bump the actions group with 2 updates

Bumps the actions group with 2 updates: [pypa/cibuildwheel](https://github.com/pypa/cibuildwheel) and [pypa/gh-action-pypi-publish](https://github.com/pypa/gh-action-pypi-publish).


Updates `pypa/cibuildwheel` from 2.16.5 to 2.17.0
- [Release notes](https://github.com/pypa/cibuildwheel/releases)
- [Changelog](https://github.com/pypa/cibuildwheel/blob/main/docs/changelog.md)
- [Commits](https://github.com/pypa/cibuildwheel/compare/ce3fb7832089eb3e723a0a99cab7f3eaccf074fd...8d945475ac4b1aac4ae08b2fd27db9917158b6ce)

Updates `pypa/gh-action-pypi-publish` from 1.8.12 to 1.8.14
- [Release notes](https://github.com/pypa/gh-action-pypi-publish/releases)
- [Commits](https://github.com/pypa/gh-action-pypi-publish/compare/e53eb8b103ffcb59469888563dc324e3c8ba6f06...81e9d935c883d0b210363ab89cf05f3894778450)

---
updated-dependencies:
- dependency-name: pypa/cibuildwheel
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: actions
- dependency-name: pypa/gh-action-pypi-publish
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: actions
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 .github/workflows/cibuildwheel.yml | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 91c63cb04b89..9bdc12dc8f97 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -147,7 +147,7 @@ jobs:
           path: dist/
 
       - name: Build wheels for CPython 3.12
-        uses: pypa/cibuildwheel@ce3fb7832089eb3e723a0a99cab7f3eaccf074fd  # v2.16.5
+        uses: pypa/cibuildwheel@8d945475ac4b1aac4ae08b2fd27db9917158b6ce  # v2.17.0
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -155,7 +155,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.11
-        uses: pypa/cibuildwheel@ce3fb7832089eb3e723a0a99cab7f3eaccf074fd  # v2.16.5
+        uses: pypa/cibuildwheel@8d945475ac4b1aac4ae08b2fd27db9917158b6ce  # v2.17.0
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -163,7 +163,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.10
-        uses: pypa/cibuildwheel@ce3fb7832089eb3e723a0a99cab7f3eaccf074fd  # v2.16.5
+        uses: pypa/cibuildwheel@8d945475ac4b1aac4ae08b2fd27db9917158b6ce  # v2.17.0
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -171,7 +171,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.9
-        uses: pypa/cibuildwheel@ce3fb7832089eb3e723a0a99cab7f3eaccf074fd  # v2.16.5
+        uses: pypa/cibuildwheel@8d945475ac4b1aac4ae08b2fd27db9917158b6ce  # v2.17.0
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -179,7 +179,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for PyPy
-        uses: pypa/cibuildwheel@ce3fb7832089eb3e723a0a99cab7f3eaccf074fd  # v2.16.5
+        uses: pypa/cibuildwheel@8d945475ac4b1aac4ae08b2fd27db9917158b6ce  # v2.17.0
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -213,4 +213,4 @@ jobs:
         run: ls dist
 
       - name: Publish package distributions to PyPI
-        uses: pypa/gh-action-pypi-publish@e53eb8b103ffcb59469888563dc324e3c8ba6f06  # v1.8.12
+        uses: pypa/gh-action-pypi-publish@81e9d935c883d0b210363ab89cf05f3894778450  # v1.8.14

From cb2d3d16c6730e2aa8ca26f803a75d68009f80d9 Mon Sep 17 00:00:00 2001
From: saranti <tsarantis@proton.me>
Date: Tue, 19 Mar 2024 11:34:27 +1100
Subject: [PATCH 0868/1120] fix doc build

---
 lib/matplotlib/axes/_axes.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 14f575a5b4db..52804e38cfae 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -3995,7 +3995,7 @@ def boxplot(self, x, notch=None, sym=None, vert=None, whis=None,
             In the case of a single string, the legend entry will technically be
             associated with the first box only. By default, the legend will show the
             median line (``result["medians"]``); if *patch_artist* is True, the legend
-            will show the box `Patch` artists (``result["boxes"]``) instead.
+            will show the box `.Patch` artists (``result["boxes"]``) instead.
 
         data : indexable object, optional
             DATA_PARAMETER_PLACEHOLDER
@@ -4219,7 +4219,7 @@ def bxp(self, bxpstats, positions=None, widths=None, vert=True,
             In the case of a single string, the legend entry will technically be
             associated with the first box only. By default, the legend will show the
             median line (``result["medians"]``); if *patch_artist* is True, the legend
-            will show the box `Patch` artists (``result["boxes"]``) instead.
+            will show the box `.Patch` artists (``result["boxes"]``) instead.
 
         zorder : float, default: ``Line2D.zorder = 2``
           The zorder of the resulting boxplot.

From 281461a1bf496bbad52a508959cdf1b9f23a56b6 Mon Sep 17 00:00:00 2001
From: thehappycheese <the.nicholas.archer@gmail.com>
Date: Tue, 19 Mar 2024 15:54:51 +0800
Subject: [PATCH 0869/1120] FancyArrowPatch docs; emphasise ShrinkA/B in points
 unlike parts of the Annotate api that use fraction

---
 lib/matplotlib/patches.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
index b5be74af781a..65e3822e5d02 100644
--- a/lib/matplotlib/patches.py
+++ b/lib/matplotlib/patches.py
@@ -4189,7 +4189,7 @@ def __init__(self, posA=None, posB=None, *,
             Head and tail patches, respectively.
 
         shrinkA, shrinkB : float, default: 2
-            Shrinking factor of the tail and head of the arrow respectively.
+            Shrink amount, in points, of the tail and head of the arrow respectively.
 
         mutation_scale : float, default: 1
             Value with which attributes of *arrowstyle* (e.g., *head_length*)

From ab407deb39dc2b189ed0713a3930c6ff924706a4 Mon Sep 17 00:00:00 2001
From: thehappycheese <the.nicholas.archer@gmail.com>
Date: Tue, 19 Mar 2024 15:56:49 +0800
Subject: [PATCH 0870/1120] Annotate docs; emphasise that the FancyArrow
 shrinkA/B is in points unlike the simple arrow uses fraction

---
 lib/matplotlib/text.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/text.py b/lib/matplotlib/text.py
index e1f3a88809de..40cd8c8cd6f7 100644
--- a/lib/matplotlib/text.py
+++ b/lib/matplotlib/text.py
@@ -1767,8 +1767,8 @@ def transform(renderer) -> Transform
             relpos           See below; default is (0.5, 0.5)
             patchA           Default is bounding box of the text
             patchB           Default is None
-            shrinkA          Default is 2 points
-            shrinkB          Default is 2 points
+            shrinkA          In points. Default is 2 points
+            shrinkB          In points. Default is 2 points
             mutation_scale   Default is text size (in points)
             mutation_aspect  Default is 1
             ?                Any `.FancyArrowPatch` property

From 8ba38c379398c34e10aea3373e1ada4d5d4d7105 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Mon, 18 Mar 2024 15:04:26 +0100
Subject: [PATCH 0871/1120] Support Cn, n>9 in plot() shorthand format.

---
 doc/api/next_api_changes/behavior/27943-AL.rst | 10 ++++++++++
 lib/matplotlib/axes/_base.py                   | 14 ++++++++------
 lib/matplotlib/tests/test_axes.py              |  7 +++++++
 3 files changed, 25 insertions(+), 6 deletions(-)
 create mode 100644 doc/api/next_api_changes/behavior/27943-AL.rst

diff --git a/doc/api/next_api_changes/behavior/27943-AL.rst b/doc/api/next_api_changes/behavior/27943-AL.rst
new file mode 100644
index 000000000000..1314b763987e
--- /dev/null
+++ b/doc/api/next_api_changes/behavior/27943-AL.rst
@@ -0,0 +1,10 @@
+plot() shorthand format interprets "Cn" (n>9) as a color-cycle color
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Previously, ``plot(..., "-C11")`` would be interpreted as requesting a plot
+using linestyle "-", color "C1" (color #1 of the color cycle), and marker "1"
+("tri-down").  It is now interpreted as requesting linestyle "-" and color
+"C11" (color #11 of the color cycle).
+
+It is recommended to pass ambiguous markers (such as "1") explicitly using the
+*marker* keyword argument.  If the shorthand form is desired, such markers can
+also be unambiguously set by putting them *before* the color string.
diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index be0aacd81bb0..36e146f31af1 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -5,6 +5,7 @@
 import logging
 from numbers import Real
 from operator import attrgetter
+import re
 import types
 
 import numpy as np
@@ -189,13 +190,14 @@ def _process_plot_format(fmt, *, ambiguous_fmt_datakey=False):
                 raise ValueError(errfmt.format(fmt, "two color symbols"))
             color = c
             i += 1
-        elif c == 'C' and i < len(fmt) - 1:
-            color_cycle_number = int(fmt[i + 1])
-            color = mcolors.to_rgba(f"C{color_cycle_number}")
-            i += 2
+        elif c == "C":
+            cn_color = re.match(r"C\d+", fmt[i:])
+            if not cn_color:
+                raise ValueError(errfmt.format(fmt, "'C' must be followed by a number"))
+            color = mcolors.to_rgba(cn_color[0])
+            i += len(cn_color[0])
         else:
-            raise ValueError(
-                errfmt.format(fmt, f"unrecognized character {c!r}"))
+            raise ValueError(errfmt.format(fmt, f"unrecognized character {c!r}"))
 
     if linestyle is None and marker is None:
         linestyle = mpl.rcParams['lines.linestyle']
diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index 4e659a4d841d..5af508479592 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -8511,6 +8511,8 @@ def test_empty_line_plots():
     (":-", r"':-' is not a valid format string \(two linestyle symbols\)"),
     ("rk", r"'rk' is not a valid format string \(two color symbols\)"),
     (":o-r", r"':o-r' is not a valid format string \(two linestyle symbols\)"),
+    ("C", r"'C' is not a valid format string \('C' must be followed by a number\)"),
+    (".C", r"'.C' is not a valid format string \('C' must be followed by a number\)"),
 ))
 @pytest.mark.parametrize("data", [None, {"string": range(3)}])
 def test_plot_format_errors(fmt, match, data):
@@ -8543,6 +8545,11 @@ def test_plot_format():
     line = ax.plot([1, 2, 3], 'k3')
     assert line[0].get_marker() == '3'
     assert line[0].get_color() == 'k'
+    fig, ax = plt.subplots()
+    line = ax.plot([1, 2, 3], '.C12:')
+    assert line[0].get_marker() == '.'
+    assert line[0].get_color() == mcolors.to_rgba('C12')
+    assert line[0].get_linestyle() == ':'
 
 
 def test_automatic_legend():

From 2e41cb5e925e23b93b8b7108628d7818fb904b78 Mon Sep 17 00:00:00 2001
From: saranti <tsarantis@proton.me>
Date: Tue, 19 Mar 2024 23:28:58 +1100
Subject: [PATCH 0872/1120] update and fix docs

---
 doc/users/next_whats_new/boxplot_legend_support.rst | 4 ++--
 lib/matplotlib/axes/_axes.py                        | 7 +++++--
 lib/matplotlib/axes/_axes.pyi                       | 4 ++--
 3 files changed, 9 insertions(+), 6 deletions(-)

diff --git a/doc/users/next_whats_new/boxplot_legend_support.rst b/doc/users/next_whats_new/boxplot_legend_support.rst
index fa6069ebb958..32322440249a 100644
--- a/doc/users/next_whats_new/boxplot_legend_support.rst
+++ b/doc/users/next_whats_new/boxplot_legend_support.rst
@@ -3,7 +3,7 @@ Legend support for Boxplot
 Boxplots now support a *label* parameter to create legend entries.
 
 Legend labels can be passed as a list of strings to label multiple boxes in a single
-boxplot call:
+`.boxplot` call:
 
 
 .. plot::
@@ -37,7 +37,7 @@ boxplot call:
     ax.legend()
 
 
-Or as a single string to each individual boxplot:
+Or as a single string to each individual `.boxplot`:
 
 .. plot::
     :include-source: true
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 52804e38cfae..44d82184c3c8 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -3997,6 +3997,8 @@ def boxplot(self, x, notch=None, sym=None, vert=None, whis=None,
             median line (``result["medians"]``); if *patch_artist* is True, the legend
             will show the box `.Patch` artists (``result["boxes"]``) instead.
 
+            .. versionadded:: 3.9
+
         data : indexable object, optional
             DATA_PARAMETER_PLACEHOLDER
 
@@ -4221,6 +4223,8 @@ def bxp(self, bxpstats, positions=None, widths=None, vert=True,
             median line (``result["medians"]``); if *patch_artist* is True, the legend
             will show the box `.Patch` artists (``result["boxes"]``) instead.
 
+            .. versionadded:: 3.9
+
         zorder : float, default: ``Line2D.zorder = 2``
           The zorder of the resulting boxplot.
 
@@ -4421,8 +4425,7 @@ def do_patch(xs, ys, **kwargs):
                 box_or_med[0].set_label(label)
             else:  # label is a sequence
                 if len(box_or_med) != len(label):
-                    raise ValueError("There must be an equal number of legend"
-                                     " labels and boxplots.")
+                    raise ValueError(datashape_message.format("label"))
                 for artist, lbl in zip(box_or_med, label):
                     artist.set_label(lbl)
 
diff --git a/lib/matplotlib/axes/_axes.pyi b/lib/matplotlib/axes/_axes.pyi
index d00008623633..b70d330aa442 100644
--- a/lib/matplotlib/axes/_axes.pyi
+++ b/lib/matplotlib/axes/_axes.pyi
@@ -372,7 +372,7 @@ class Axes(_AxesBase):
         autorange: bool = ...,
         zorder: float | None = ...,
         capwidths: float | ArrayLike | None = ...,
-		label: Sequence[str] | None = ...,
+        label: Sequence[str] | None = ...,
         *,
         data=...,
     ) -> dict[str, Any]: ...
@@ -398,7 +398,7 @@ class Axes(_AxesBase):
         manage_ticks: bool = ...,
         zorder: float | None = ...,
         capwidths: float | ArrayLike | None = ...,
-		label: Sequence[str] | None = ...,
+        label: Sequence[str] | None = ...,
     ) -> dict[str, Any]: ...
     def scatter(
         self,

From c96334d163c53323986728625865b5552c9bc66d Mon Sep 17 00:00:00 2001
From: saranti <tsarantis@proton.me>
Date: Tue, 19 Mar 2024 23:55:01 +1100
Subject: [PATCH 0873/1120] fix failing test

---
 doc/users/next_whats_new/boxplot_legend_support.rst | 4 ++--
 lib/matplotlib/tests/test_legend.py                 | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/doc/users/next_whats_new/boxplot_legend_support.rst b/doc/users/next_whats_new/boxplot_legend_support.rst
index 32322440249a..44802960d9bb 100644
--- a/doc/users/next_whats_new/boxplot_legend_support.rst
+++ b/doc/users/next_whats_new/boxplot_legend_support.rst
@@ -3,7 +3,7 @@ Legend support for Boxplot
 Boxplots now support a *label* parameter to create legend entries.
 
 Legend labels can be passed as a list of strings to label multiple boxes in a single
-`.boxplot` call:
+`.Axes.boxplot` call:
 
 
 .. plot::
@@ -37,7 +37,7 @@ Legend labels can be passed as a list of strings to label multiple boxes in a si
     ax.legend()
 
 
-Or as a single string to each individual `.boxplot`:
+Or as a single string to each individual `.Axes.boxplot`:
 
 .. plot::
     :include-source: true
diff --git a/lib/matplotlib/tests/test_legend.py b/lib/matplotlib/tests/test_legend.py
index 195e65c883e1..9b7a6dfd10c9 100644
--- a/lib/matplotlib/tests/test_legend.py
+++ b/lib/matplotlib/tests/test_legend.py
@@ -1460,7 +1460,7 @@ def test_boxplot_legend_labels():
     assert all(isinstance(h, mpl.lines.Line2D) for h in handles)
 
     # Testing legend with number of labels different from number of boxes.
-    with pytest.raises(ValueError, match='There must be an equal number'):
+    with pytest.raises(ValueError, match='values must have same the length'):
         bp3 = axs[2].boxplot(data, label=legend_labels[:-1])
 
     # Test that for a string label, only the first box gets a label.

From 2b5bb79b1b8fc9160aec13040a6267481583d0ae Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Mon, 18 Mar 2024 22:08:39 +0100
Subject: [PATCH 0874/1120] DOC: Explain leading dot in object references

---
 doc/devel/document.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/doc/devel/document.rst b/doc/devel/document.rst
index 21761e9f24b4..d354ee5f238b 100644
--- a/doc/devel/document.rst
+++ b/doc/devel/document.rst
@@ -317,7 +317,10 @@ target is unambiguous you can simply leave them out:
 
   `.LineCollection`
 
-and the link still works: `.LineCollection`.
+and the link still works: `.LineCollection`. Note that you should typically include
+the leading dot. It tells Sphinx to look for the given name in the whole project.
+See also the explanation at `Sphinx: Cross-referencing Python objects
+<https://www.sphinx-doc.org/en/master/usage/domains/python.html#cross-referencing-python-objects>`_.
 
 If there are multiple code elements with the same name (e.g. ``plot()`` is a
 method in multiple classes), you'll have to extend the definition:

From 6e244180b336dc1337ea718cefd140b6f5b23ea7 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Tue, 19 Mar 2024 23:48:54 +0100
Subject: [PATCH 0875/1120] DOC: Improve stairs docstring

---
 galleries/plot_types/basic/stairs.py | 2 +-
 lib/matplotlib/axes/_axes.py         | 9 ++++++---
 2 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/galleries/plot_types/basic/stairs.py b/galleries/plot_types/basic/stairs.py
index df0e91d1041b..732ded998241 100644
--- a/galleries/plot_types/basic/stairs.py
+++ b/galleries/plot_types/basic/stairs.py
@@ -2,7 +2,7 @@
 ==============
 stairs(values)
 ==============
-A stepwise constant function as a line with bounding edges or a filled plot.
+Draw a stepwise constant function as a line or a filled plot.
 
 See `~matplotlib.axes.Axes.stairs` when plotting :math:`y` between
 :math:`(x_i, x_{i+1})`. For plotting :math:`y` at :math:`x`, see
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 627dd2c36d40..8fb8e878712b 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -7104,8 +7104,11 @@ def hist(self, x, bins=None, range=None, density=False, weights=None,
     def stairs(self, values, edges=None, *,
                orientation='vertical', baseline=0, fill=False, **kwargs):
         """
-        A stepwise constant function as a line with bounding edges
-        or a filled plot.
+        Draw a stepwise constant function as a line or a filled plot.
+
+        *edges* define the x-axis positions of the steps. *values* the function values
+        between these steps. Depending on *fill*, the function is drawn either as a
+        continuous line with vertical segments at the edges, or as a filled area.
 
         Parameters
         ----------
@@ -7113,7 +7116,7 @@ def stairs(self, values, edges=None, *,
             The step heights.
 
         edges : array-like
-            The edge positions, with ``len(edges) == len(vals) + 1``,
+            The step positions, with ``len(edges) == len(vals) + 1``,
             between which the curve takes on vals values.
 
         orientation : {'vertical', 'horizontal'}, default: 'vertical'

From 28fee01a9798c1535d4ad8cfc6c113fa45809ba1 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Tue, 19 Mar 2024 23:52:05 -0400
Subject: [PATCH 0876/1120] ci: Fix condition for publishing wheels

The wheel workflow is only triggered on pushes and pull requests. So the
condition to publish must be based on that, not on generating a GitHub
release.
---
 .github/workflows/cibuildwheel.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 9bdc12dc8f97..8a2f8b26a8d4 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -194,7 +194,7 @@ jobs:
           if-no-files-found: error
 
   publish:
-    if: github.event_name == 'release' && github.event.action == 'published'
+    if: github.event_name == 'push' && github.ref_type == 'tag'
     name: Upload release to PyPI
     needs: [build_sdist, build_wheels]
     runs-on: ubuntu-latest

From bb3f0dc9d53f0297d995879870a5078a912b6246 Mon Sep 17 00:00:00 2001
From: trananso <trananson@protonmail.com>
Date: Wed, 20 Mar 2024 01:58:27 -0400
Subject: [PATCH 0877/1120] [BUG] Fix redirect-from Sphinx extension (#27915)

* [BUG] Fix clear_doc for redirect-from domain

* [BUG] Implement merge_domaindata

Update merge_domaindata to match Sphinx example implementation
https://github.com/sphinx-doc/sphinx/blob/5523c9bbe4d1415777669330411d4f00ad802f18/sphinx/ext/todo.py#L90-L92

* [BUG] Remove check for redirects that already exist

Check causes build to fail when Sphinx uses a cached build environment. We can just rewrite the cached redirect.

* [LINT] Fix linting issue

* [ENH] Switch Directive to SphinxDirective, which has self.env

* [BUG] Re-introduce sanity check

* Added domain.redirects sanity check back in
* Clear cached redirects from the domain

* [BUG] Reintroduce merge_domaindata sanity check

* Refactor

* Revert changes to merge_domaindata

* Cleanup code

Implement suggested changes

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>

---------

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>
---
 doc/sphinxext/redirect_from.py | 24 +++++++++++++++---------
 1 file changed, 15 insertions(+), 9 deletions(-)

diff --git a/doc/sphinxext/redirect_from.py b/doc/sphinxext/redirect_from.py
index 7a7e6aa9cdc8..37b56373a3bf 100644
--- a/doc/sphinxext/redirect_from.py
+++ b/doc/sphinxext/redirect_from.py
@@ -33,7 +33,7 @@
 """
 
 from pathlib import Path
-from docutils.parsers.rst import Directive
+from sphinx.util.docutils import SphinxDirective
 from sphinx.domains import Domain
 from sphinx.util import logging
 
@@ -51,9 +51,9 @@
 
 
 def setup(app):
-    RedirectFrom.app = app
     app.add_directive("redirect-from", RedirectFrom)
     app.add_domain(RedirectFromDomain)
+    app.connect("builder-inited", _clear_redirects)
     app.connect("build-finished", _generate_redirects)
 
     metadata = {'parallel_read_safe': True}
@@ -73,8 +73,8 @@ def redirects(self):
         """The mapping of the redirects."""
         return self.data.setdefault('redirects', {})
 
-    def clear_doc(self, docnames):
-        self.redirects.clear()
+    def clear_doc(self, docname):
+        self.redirects.pop(docname, None)
 
     def merge_domaindata(self, docnames, otherdata):
         for src, dst in otherdata['redirects'].items():
@@ -86,15 +86,14 @@ def merge_domaindata(self, docnames, otherdata):
                     f"{self.redirects[src]} and {otherdata['redirects'][src]}")
 
 
-class RedirectFrom(Directive):
+class RedirectFrom(SphinxDirective):
     required_arguments = 1
 
     def run(self):
         redirected_doc, = self.arguments
-        env = self.app.env
-        domain = env.get_domain('redirect_from')
-        current_doc = env.path2doc(self.state.document.current_source)
-        redirected_reldoc, _ = env.relfn2path(redirected_doc, current_doc)
+        domain = self.env.get_domain('redirect_from')
+        current_doc = self.env.path2doc(self.state.document.current_source)
+        redirected_reldoc, _ = self.env.relfn2path(redirected_doc, current_doc)
         if redirected_reldoc in domain.redirects:
             raise ValueError(
                 f"{redirected_reldoc} is already noted as redirecting to "
@@ -119,3 +118,10 @@ def _generate_redirects(app, exception):
             logger.info('making refresh html file: %s redirect to %s', k, v)
             p.parent.mkdir(parents=True, exist_ok=True)
             p.write_text(html, encoding='utf-8')
+
+
+def _clear_redirects(app):
+    domain = app.env.get_domain('redirect_from')
+    if domain.redirects:
+        logger.info('clearing cached redirects')
+        domain.redirects.clear()

From 52d8bcbe2439a8265700985cf8b105c13a040ff7 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Wed, 20 Mar 2024 17:58:02 -0500
Subject: [PATCH 0878/1120] Add a draw during show for macos backend

Without this a stale figure is shown
---
 lib/matplotlib/backends/backend_macosx.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/lib/matplotlib/backends/backend_macosx.py b/lib/matplotlib/backends/backend_macosx.py
index 7f5589677d31..adb5b5691b23 100644
--- a/lib/matplotlib/backends/backend_macosx.py
+++ b/lib/matplotlib/backends/backend_macosx.py
@@ -179,6 +179,8 @@ def start_main_loop(cls):
             _macosx.show()
 
     def show(self):
+        if self.canvas.figure.stale:
+            self.canvas.draw_idle()
         if not self._shown:
             self._show()
             self._shown = True

From 9c85514eb3d61968d2d98fab3483db7e77431f1a Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 20 Mar 2024 20:26:15 -0400
Subject: [PATCH 0879/1120] Use PyOS_setsig in macos backend

The docs for this function say it wraps `sigaction` or `signal`, and not
to use those functions directly.
---
 src/_macosx.m | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/src/_macosx.m b/src/_macosx.m
index fe93193eb053..656d502fa17c 100755
--- a/src/_macosx.m
+++ b/src/_macosx.m
@@ -44,7 +44,7 @@
 static bool stdin_received = false;
 static bool stdin_sigint = false;
 // Global variable to store the original SIGINT handler
-static struct sigaction originalSigintAction = {0};
+static PyOS_sighandler_t originalSigintAction = NULL;
 
 // Signal handler for SIGINT, only sets a flag to exit the run loop
 static void handleSigint(int signal) {
@@ -57,10 +57,7 @@ static int wait_for_stdin() {
         stdin_sigint = false;
 
         // Set up a SIGINT handler to interrupt the event loop if ctrl+c comes in too
-        struct sigaction customAction = {0};
-        customAction.sa_handler = handleSigint;
-        // Set the new handler and store the old one
-        sigaction(SIGINT, &customAction, &originalSigintAction);
+        originalSigintAction = PyOS_setsig(SIGINT, handleSigint);
 
         // Create an NSFileHandle for standard input
         NSFileHandle *stdinHandle = [NSFileHandle fileHandleWithStandardInput];
@@ -93,7 +90,7 @@ static int wait_for_stdin() {
         [[NSNotificationCenter defaultCenter] removeObserver: stdinHandle];
 
         // Restore the original SIGINT handler upon exiting the function
-        sigaction(SIGINT, &originalSigintAction, NULL);
+        PyOS_setsig(SIGINT, originalSigintAction);
         return 1;
     }
 }

From 0b56e073cc5768f6a940f430b6bc18e5cc17b8bd Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Thu, 1 Feb 2024 09:07:17 +0100
Subject: [PATCH 0880/1120] Add an rcparam for image.interpolation_stage.

---
 doc/users/next_whats_new/interpolation_stage_rc.rst |  4 ++++
 lib/matplotlib/image.py                             |  5 ++---
 lib/matplotlib/mpl-data/matplotlibrc                |  1 +
 lib/matplotlib/rcsetup.py                           | 13 +++++++------
 lib/matplotlib/tests/test_image.py                  |  9 +++++++++
 5 files changed, 23 insertions(+), 9 deletions(-)
 create mode 100644 doc/users/next_whats_new/interpolation_stage_rc.rst

diff --git a/doc/users/next_whats_new/interpolation_stage_rc.rst b/doc/users/next_whats_new/interpolation_stage_rc.rst
new file mode 100644
index 000000000000..bd3ecc563e5d
--- /dev/null
+++ b/doc/users/next_whats_new/interpolation_stage_rc.rst
@@ -0,0 +1,4 @@
+``image.interpolation_stage`` rcParam
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+This new rcParam controls whether image interpolation occurs in "data" space or
+in "rgba" space.
diff --git a/lib/matplotlib/image.py b/lib/matplotlib/image.py
index 3741c2cdecb3..5b0152505397 100644
--- a/lib/matplotlib/image.py
+++ b/lib/matplotlib/image.py
@@ -789,10 +789,9 @@ def set_interpolation_stage(self, s):
         ----------
         s : {'data', 'rgba'} or None
             Whether to apply up/downsampling interpolation in data or RGBA
-            space.
+            space.  If None, use :rc:`image.interpolation_stage`.
         """
-        if s is None:
-            s = "data"  # placeholder for maybe having rcParam
+        s = mpl._val_or_rc(s, 'image.interpolation_stage')
         _api.check_in_list(['data', 'rgba'], s=s)
         self._interpolation_stage = s
         self.stale = True
diff --git a/lib/matplotlib/mpl-data/matplotlibrc b/lib/matplotlib/mpl-data/matplotlibrc
index 301afc38456b..29ffb20f4280 100644
--- a/lib/matplotlib/mpl-data/matplotlibrc
+++ b/lib/matplotlib/mpl-data/matplotlibrc
@@ -603,6 +603,7 @@
 ## ***************************************************************************
 #image.aspect:          equal        # {equal, auto} or a number
 #image.interpolation:   antialiased  # see help(imshow) for options
+#image.interpolation_stage: data     # see help(imshow) for options
 #image.cmap:            viridis      # A colormap name (plasma, magma, etc.)
 #image.lut:             256          # the size of the colormap lookup table
 #image.origin:          upper        # {lower, upper}
diff --git a/lib/matplotlib/rcsetup.py b/lib/matplotlib/rcsetup.py
index 6abc8372222d..a326d22f039a 100644
--- a/lib/matplotlib/rcsetup.py
+++ b/lib/matplotlib/rcsetup.py
@@ -1051,12 +1051,13 @@ def _convert_validator_spec(key, conv):
                                 "bb", "frak", "scr", "regular"],
     "mathtext.fallback":       _validate_mathtext_fallback,
 
-    "image.aspect":          validate_aspect,  # equal, auto, a number
-    "image.interpolation":   validate_string,
-    "image.cmap":            _validate_cmap,  # gray, jet, etc.
-    "image.lut":             validate_int,  # lookup table
-    "image.origin":          ["upper", "lower"],
-    "image.resample":        validate_bool,
+    "image.aspect":              validate_aspect,  # equal, auto, a number
+    "image.interpolation":       validate_string,
+    "image.interpolation_stage": ["data", "rgba"],
+    "image.cmap":                _validate_cmap,  # gray, jet, etc.
+    "image.lut":                 validate_int,  # lookup table
+    "image.origin":              ["upper", "lower"],
+    "image.resample":            validate_bool,
     # Specify whether vector graphics backends will combine all images on a
     # set of Axes into a single composite image
     "image.composite_image": validate_bool,
diff --git a/lib/matplotlib/tests/test_image.py b/lib/matplotlib/tests/test_image.py
index 17d0c011ba63..232790a68ebb 100644
--- a/lib/matplotlib/tests/test_image.py
+++ b/lib/matplotlib/tests/test_image.py
@@ -1462,6 +1462,15 @@ def test_rgba_antialias():
                   cmap=cmap, vmin=-1.2, vmax=1.2)
 
 
+def test_rc_interpolation_stage():
+    for val in ["data", "rgba"]:
+        with mpl.rc_context({"image.interpolation_stage": val}):
+            assert plt.imshow([[1, 2]]).get_interpolation_stage() == val
+    for val in ["DATA", "foo", None]:
+        with pytest.raises(ValueError):
+            mpl.rcParams["image.interpolation_stage"] = val
+
+
 # We check for the warning with a draw() in the test, but we also need to
 # filter the warning as it is emitted by the figure test decorator
 @pytest.mark.filterwarnings(r'ignore:Data with more than .* '

From 0e6e92e12ec4376e69e710c2fe0d07aa9ceff85f Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Thu, 15 Jun 2023 12:14:03 -0400
Subject: [PATCH 0881/1120] Revert "Revert " Merge pull request #4019 from
 myshen/annot_neg_coords""

This partially reverts commit 7b712579fbb6f9300bee18228ba4b567ab4f9045.

Too many tests were removed, restore the extra tests.
---
 lib/matplotlib/tests/test_text.py | 166 ++++++++++++++++++++++++++++++
 1 file changed, 166 insertions(+)

diff --git a/lib/matplotlib/tests/test_text.py b/lib/matplotlib/tests/test_text.py
index 3c14357e45f3..0f83140895e1 100644
--- a/lib/matplotlib/tests/test_text.py
+++ b/lib/matplotlib/tests/test_text.py
@@ -10,6 +10,8 @@
 
 import matplotlib as mpl
 from matplotlib.backend_bases import MouseEvent
+from matplotlib.backends.backend_agg import RendererAgg
+from matplotlib.figure import Figure
 from matplotlib.font_manager import FontProperties
 import matplotlib.patches as mpatches
 import matplotlib.pyplot as plt
@@ -965,3 +967,167 @@ def test_annotate_and_offsetfrom_copy_input(fig_test, fig_ref):
     an_xy = np.array([.5, .5])
     ax.annotate("foo", xy=an_xy, xycoords=l, xytext=(10, 0), textcoords="offset points")
     an_xy[:] = 2
+
+
+@check_figures_equal()
+def test_text_antialiased_off_default_vs_manual(fig_test, fig_ref):
+    fig_test.text(0.5, 0.5, '6 inches x 2 inches',
+                             antialiased=False)
+
+    mpl.rcParams['text.antialiased'] = False
+    fig_ref.text(0.5, 0.5, '6 inches x 2 inches')
+
+
+@check_figures_equal()
+def test_text_antialiased_on_default_vs_manual(fig_test, fig_ref):
+    fig_test.text(0.5, 0.5, '6 inches x 2 inches', antialiased=True)
+
+    mpl.rcParams['text.antialiased'] = True
+    fig_ref.text(0.5, 0.5, '6 inches x 2 inches')
+
+
+def test_text_annotation_get_window_extent():
+    figure = Figure(dpi=100)
+    renderer = RendererAgg(200, 200, 100)
+
+    # Only text annotation
+    annotation = Annotation('test', xy=(0, 0))
+    annotation.set_figure(figure)
+
+    text = Text(text='test', x=0, y=0)
+    text.set_figure(figure)
+
+    bbox = annotation.get_window_extent(renderer=renderer)
+
+    text_bbox = text.get_window_extent(renderer=renderer)
+    assert bbox.width == text_bbox.width
+    assert bbox.height == text_bbox.height
+
+    _, _, d = renderer.get_text_width_height_descent(
+        'text', annotation._fontproperties, ismath=False)
+    _, _, lp_d = renderer.get_text_width_height_descent(
+        'lp', annotation._fontproperties, ismath=False)
+    below_line = max(d, lp_d)
+
+    # These numbers are specific to the current implementation of Text
+    points = bbox.get_points()
+    assert points[0, 0] == 0.0
+    assert points[1, 0] == text_bbox.width
+    assert points[0, 1] == -below_line
+    assert points[1, 1] == text_bbox.height - below_line
+
+
+def test_text_with_arrow_annotation_get_window_extent():
+    headwidth = 21
+    fig, ax = plt.subplots(dpi=100)
+    txt = ax.text(s='test', x=0, y=0)
+    ann = ax.annotate(
+        'test',
+        xy=(0.0, 50.0),
+        xytext=(50.0, 50.0), xycoords='figure pixels',
+        arrowprops={
+            'facecolor': 'black', 'width': 2,
+            'headwidth': headwidth, 'shrink': 0.0})
+
+    plt.draw()
+    renderer = fig.canvas.renderer
+    # bounding box of text
+    text_bbox = txt.get_window_extent(renderer=renderer)
+    # bounding box of annotation (text + arrow)
+    bbox = ann.get_window_extent(renderer=renderer)
+    # bounding box of arrow
+    arrow_bbox = ann.arrow_patch.get_window_extent(renderer)
+    # bounding box of annotation text
+    ann_txt_bbox = Text.get_window_extent(ann)
+
+    # make sure annotation width is 50 px wider than
+    # just the text
+    assert bbox.width == text_bbox.width + 50.0
+    # make sure the annotation text bounding box is same size
+    # as the bounding box of the same string as a Text object
+    assert ann_txt_bbox.height == text_bbox.height
+    assert ann_txt_bbox.width == text_bbox.width
+    # compute the expected bounding box of arrow + text
+    expected_bbox = mtransforms.Bbox.union([ann_txt_bbox, arrow_bbox])
+    assert_almost_equal(bbox.height, expected_bbox.height)
+
+
+def test_arrow_annotation_get_window_extent():
+    dpi = 100
+    dots_per_point = dpi / 72
+    figure = Figure(dpi=dpi)
+    figure.set_figwidth(2.0)
+    figure.set_figheight(2.0)
+    renderer = RendererAgg(200, 200, 100)
+
+    # Text annotation with arrow; arrow dimensions are in points
+    annotation = Annotation(
+        '', xy=(0.0, 50.0), xytext=(50.0, 50.0), xycoords='figure pixels',
+        arrowprops={
+            'facecolor': 'black', 'width': 8, 'headwidth': 10, 'shrink': 0.0})
+    annotation.set_figure(figure)
+    annotation.draw(renderer)
+
+    bbox = annotation.get_window_extent()
+    points = bbox.get_points()
+
+    assert bbox.width == 50.0
+    assert_almost_equal(bbox.height, 10.0 * dots_per_point)
+    assert points[0, 0] == 0.0
+    assert points[0, 1] == 50.0 - 5 * dots_per_point
+
+
+def test_empty_annotation_get_window_extent():
+    figure = Figure(dpi=100)
+    figure.set_figwidth(2.0)
+    figure.set_figheight(2.0)
+    renderer = RendererAgg(200, 200, 100)
+
+    # Text annotation with arrow
+    annotation = Annotation(
+        '', xy=(0.0, 50.0), xytext=(0.0, 50.0), xycoords='figure pixels')
+    annotation.set_figure(figure)
+    annotation.draw(renderer)
+
+    bbox = annotation.get_window_extent()
+    points = bbox.get_points()
+
+    assert points[0, 0] == 0.0
+    assert points[1, 0] == 0.0
+    assert points[1, 1] == 50.0
+    assert points[0, 1] == 50.0
+
+
+@image_comparison(baseline_images=['basictext_wrap'],
+                  extensions=['png'])
+def test_basic_wrap():
+    fig = plt.figure()
+    plt.axis([0, 10, 0, 10])
+    t = "This is a really long string that I'd rather have wrapped so that" \
+        " it doesn't go outside of the figure, but if it's long enough it" \
+        " will go off the top or bottom!"
+    plt.text(4, 1, t, ha='left', rotation=15, wrap=True)
+    plt.text(6, 5, t, ha='left', rotation=15, wrap=True)
+    plt.text(5, 5, t, ha='right', rotation=-15, wrap=True)
+    plt.text(5, 10, t, fontsize=18, style='oblique', ha='center',
+             va='top', wrap=True)
+    plt.text(3, 4, t, family='serif', style='italic', ha='right', wrap=True)
+    plt.text(-1, 0, t, ha='left', rotation=-15, wrap=True)
+
+
+@image_comparison(baseline_images=['fonttext_wrap'],
+                  extensions=['png'])
+def test_font_wrap():
+    fig = plt.figure()
+    plt.axis([0, 10, 0, 10])
+    t = "This is a really long string that I'd rather have wrapped so that" \
+        " it doesn't go outside of the figure, but if it's long enough it" \
+        " will go off the top or bottom!"
+    plt.text(4, -1, t, fontsize=18, family='serif', ha='left', rotation=15,
+             wrap=True)
+    plt.text(6, 5, t, family='sans serif', ha='left', rotation=15, wrap=True)
+    plt.text(5, 5, t, weight='light', ha='right', rotation=-15, wrap=True)
+    plt.text(5, 10, t, weight='heavy', ha='center', va='top', wrap=True)
+    plt.text(3, 4, t, family='monospace', ha='right', wrap=True)
+    plt.text(-1, 0, t, fontsize=14, style='italic', ha='left', rotation=-15,
+             wrap=True)

From dff07ed84d422d8c974c70135ea38c88e2f2b1c3 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Thu, 15 Jun 2023 12:52:00 -0400
Subject: [PATCH 0882/1120] TST: fix up axes-less Annotation

---
 lib/matplotlib/tests/test_text.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/tests/test_text.py b/lib/matplotlib/tests/test_text.py
index 0f83140895e1..1a6fd5a86799 100644
--- a/lib/matplotlib/tests/test_text.py
+++ b/lib/matplotlib/tests/test_text.py
@@ -991,7 +991,7 @@ def test_text_annotation_get_window_extent():
     renderer = RendererAgg(200, 200, 100)
 
     # Only text annotation
-    annotation = Annotation('test', xy=(0, 0))
+    annotation = Annotation('test', xy=(0, 0), xycoords='figure pixels')
     annotation.set_figure(figure)
 
     text = Text(text='test', x=0, y=0)

From d96d68ced798d9af527a111331e60503f2367343 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Thu, 15 Jun 2023 12:52:18 -0400
Subject: [PATCH 0883/1120] TST: update test images for text baseline changes

Remove the light font because we don't have a good one on mac on CI
---
 .../test_text/basictext_wrap.png              | Bin 216768 -> 215614 bytes
 .../test_text/fonttext_wrap.png               | Bin 217444 -> 186004 bytes
 lib/matplotlib/tests/test_text.py             |   1 -
 3 files changed, 1 deletion(-)

diff --git a/lib/matplotlib/tests/baseline_images/test_text/basictext_wrap.png b/lib/matplotlib/tests/baseline_images/test_text/basictext_wrap.png
index 267e2af4c469c6684eae08aabc3cc603bc1404c7..b041afb8b7b8502aff44695a04b23ddbbe567635 100644
GIT binary patch
literal 215614
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

literal 216768
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
A{r~^~

diff --git a/lib/matplotlib/tests/baseline_images/test_text/fonttext_wrap.png b/lib/matplotlib/tests/baseline_images/test_text/fonttext_wrap.png
index 7ca96d57133132f2f5ea60ee1cdc329629313d6b..64c24344f334535e2fc6f80b4644353605347168 100644
GIT binary patch
literal 186004
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%0Ab1=s72PXV>5V!8EaHroGsI8_~sU9Or{pHwfrjk
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%0DSZwAv6}#
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
COv2m%

literal 217444
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
DMcn-@

diff --git a/lib/matplotlib/tests/test_text.py b/lib/matplotlib/tests/test_text.py
index 1a6fd5a86799..f8837d8a5f1b 100644
--- a/lib/matplotlib/tests/test_text.py
+++ b/lib/matplotlib/tests/test_text.py
@@ -1126,7 +1126,6 @@ def test_font_wrap():
     plt.text(4, -1, t, fontsize=18, family='serif', ha='left', rotation=15,
              wrap=True)
     plt.text(6, 5, t, family='sans serif', ha='left', rotation=15, wrap=True)
-    plt.text(5, 5, t, weight='light', ha='right', rotation=-15, wrap=True)
     plt.text(5, 10, t, weight='heavy', ha='center', va='top', wrap=True)
     plt.text(3, 4, t, family='monospace', ha='right', wrap=True)
     plt.text(-1, 0, t, fontsize=14, style='italic', ha='left', rotation=-15,

From 5a2e8096257ee4d167605ed5e7cfe128b2ce7fd5 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Fri, 22 Mar 2024 16:29:59 +0100
Subject: [PATCH 0884/1120] DOC: Document axes_grid1.Grid attributes

---
 lib/mpl_toolkits/axes_grid1/axes_grid.py | 23 ++++++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/lib/mpl_toolkits/axes_grid1/axes_grid.py b/lib/mpl_toolkits/axes_grid1/axes_grid.py
index 720d985414ff..7db85bedfb62 100644
--- a/lib/mpl_toolkits/axes_grid1/axes_grid.py
+++ b/lib/mpl_toolkits/axes_grid1/axes_grid.py
@@ -38,6 +38,26 @@ class Grid:
     displayed with a given aspect ratio; for example, it is difficult to
     display multiple images of a same size with some fixed padding between
     them.  AxesGrid can be used in such case.
+
+    Attributes
+    ----------
+    axes_all : list of Axes
+        A flat list of Axes. Note that you can also access this directly
+        from the grid. The following is equivalent ::
+
+            grid[i] == grid.axes_all[i]
+            len(grid) == len(grid.axes_all)
+
+    axes_column : list of list of Axes
+        A 2D list of Axes where the first index is the column. This results
+        in the usage pattern ``grid.axes_column[col][row]``.
+    axes_row : list of list of Axes
+        A 2D list of Axes where the first index is the row. This results
+        in the usage pattern ``grid.axes_row[row][col]``.
+    axes_llc : Axes
+        The Axes in the lower left corner.
+    ngrids : int
+        Number of Axes in the grid.
     """
 
     _defaultAxesClass = Axes
@@ -93,7 +113,8 @@ def __init__(self, fig,
             - "all": All axes are labelled.
             - "keep": Do not do anything.
 
-        axes_class : subclass of `matplotlib.axes.Axes`, default: None
+        axes_class : subclass of `matplotlib.axes.Axes`, default: `.mpl_axes.Axes`
+            The type of Axes to create.
         aspect : bool, default: False
             Whether the axes aspect ratio follows the aspect ratio of the data
             limits.

From a78a3d835a430bf788fbac3df09f2c13695cf6c7 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Sat, 23 Mar 2024 03:56:54 -0400
Subject: [PATCH 0885/1120] MNT: Remove remaining 3.7 deprecations

Not sure why I missed listing these in #26865.
---
 doc/api/next_api_changes/removals/27968-ES.rst     | 14 ++++++++++++++
 lib/matplotlib/legend.py                           |  3 ---
 lib/matplotlib/legend.pyi                          |  2 --
 lib/mpl_toolkits/axes_grid1/axes_grid.py           | 10 +---------
 .../axes_grid1/tests/test_axes_grid1.py            |  9 +++------
 5 files changed, 18 insertions(+), 20 deletions(-)
 create mode 100644 doc/api/next_api_changes/removals/27968-ES.rst

diff --git a/doc/api/next_api_changes/removals/27968-ES.rst b/doc/api/next_api_changes/removals/27968-ES.rst
new file mode 100644
index 000000000000..99b3b1527506
--- /dev/null
+++ b/doc/api/next_api_changes/removals/27968-ES.rst
@@ -0,0 +1,14 @@
+``legend.legendHandles``
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+... was undocumented and has been renamed to ``legend_handles``.
+
+Passing undefined *label_mode* to ``Grid``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+... is no longer allowed. This includes `mpl_toolkits.axes_grid1.axes_grid.Grid`,
+`mpl_toolkits.axes_grid1.axes_grid.AxesGrid`, and
+`mpl_toolkits.axes_grid1.axes_grid.ImageGrid` as well as the corresponding classes
+imported from `mpl_toolkits.axisartist.axes_grid`.
+
+Pass ``label_mode='keep'`` instead to get the previous behavior of not modifying labels.
diff --git a/lib/matplotlib/legend.py b/lib/matplotlib/legend.py
index 111e08e00869..9033fc23c1a1 100644
--- a/lib/matplotlib/legend.py
+++ b/lib/matplotlib/legend.py
@@ -633,9 +633,6 @@ def __init__(
         else:
             raise ValueError(f"Invalid labelcolor: {labelcolor!r}")
 
-    legendHandles = _api.deprecated('3.7', alternative="legend_handles")(
-        property(lambda self: self.legend_handles))
-
     def _set_artist_props(self, a):
         """
         Set the boilerplate props for artists added to Axes.
diff --git a/lib/matplotlib/legend.pyi b/lib/matplotlib/legend.pyi
index d559b06c5d5d..dde5882da69d 100644
--- a/lib/matplotlib/legend.pyi
+++ b/lib/matplotlib/legend.pyi
@@ -150,5 +150,3 @@ class Legend(Artist):
         update: Literal["loc", "bbox"] = ...,
     ) -> None: ...
     def get_draggable(self) -> bool: ...
-    @property
-    def legendHandles(self) -> list[Artist | None]: ...
diff --git a/lib/mpl_toolkits/axes_grid1/axes_grid.py b/lib/mpl_toolkits/axes_grid1/axes_grid.py
index 720d985414ff..1c4551092c24 100644
--- a/lib/mpl_toolkits/axes_grid1/axes_grid.py
+++ b/lib/mpl_toolkits/axes_grid1/axes_grid.py
@@ -234,6 +234,7 @@ def set_label_mode(self, mode):
             - "all": All axes are labelled.
             - "keep": Do not do anything.
         """
+        _api.check_in_list(["all", "L", "1", "keep"], mode=mode)
         is_last_row, is_first_col = (
             np.mgrid[:self._nrows, :self._ncols] == [[[self._nrows - 1]], [[0]]])
         if mode == "all":
@@ -244,15 +245,6 @@ def set_label_mode(self, mode):
         elif mode == "1":
             bottom = left = is_last_row & is_first_col
         else:
-            # Use _api.check_in_list at the top of the method when deprecation
-            # period expires
-            if mode != 'keep':
-                _api.warn_deprecated(
-                    '3.7', name="Grid label_mode",
-                    message='Passing an undefined label_mode is deprecated '
-                            'since %(since)s and will become an error '
-                            '%(removal)s. To silence this warning, pass '
-                            '"keep", which gives the same behaviour.')
             return
         for i in range(self._nrows):
             for j in range(self._ncols):
diff --git a/lib/mpl_toolkits/axes_grid1/tests/test_axes_grid1.py b/lib/mpl_toolkits/axes_grid1/tests/test_axes_grid1.py
index b1a18d77747e..56f07c026b97 100644
--- a/lib/mpl_toolkits/axes_grid1/tests/test_axes_grid1.py
+++ b/lib/mpl_toolkits/axes_grid1/tests/test_axes_grid1.py
@@ -432,13 +432,10 @@ def test_image_grid_single_bottom():
     grid.cbar_axes[0].colorbar(im)
 
 
-def test_image_grid_label_mode_deprecation_warning():
-    imdata = np.arange(9).reshape((3, 3))
-
+def test_image_grid_label_mode_invalid():
     fig = plt.figure()
-    with pytest.warns(mpl.MatplotlibDeprecationWarning,
-                      match="Passing an undefined label_mode"):
-        grid = ImageGrid(fig, (0, 0, 1, 1), (2, 1), label_mode="foo")
+    with pytest.raises(ValueError, match="'foo' is not a valid value for mode"):
+        ImageGrid(fig, (0, 0, 1, 1), (2, 1), label_mode="foo")
 
 
 @image_comparison(['image_grid.png'],

From b1169d0d08362c41cf6ff64415832a838e2771a0 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Sat, 23 Mar 2024 00:31:10 +0100
Subject: [PATCH 0886/1120] DOC: Rewrite the example illustrating bxp()

Previously, the example essentially replicated illustrations of a lot
of styling variants, which have already been shown for `boxplot()`.
Compare:
- https://matplotlib.org/3.8.3/gallery/statistics/bxp.html
- https://matplotlib.org/3.8.3/gallery/statistics/boxplot.html

I believe it's not necessary to iterate through all that again. Instead,
this rewrite focuses on the relation between `boxplot_stats()`, `bxp()`
and `boxplot`. And it shows how to use `bxp()` in isolation.
---
 galleries/examples/statistics/bxp.py | 127 +++++++++------------------
 1 file changed, 43 insertions(+), 84 deletions(-)

diff --git a/galleries/examples/statistics/bxp.py b/galleries/examples/statistics/bxp.py
index d78747523325..b12bfebd16cc 100644
--- a/galleries/examples/statistics/bxp.py
+++ b/galleries/examples/statistics/bxp.py
@@ -1,107 +1,65 @@
 """
-=======================
-Boxplot drawer function
-=======================
-
-This example demonstrates how to pass pre-computed box plot
-statistics to the box plot drawer. The first figure demonstrates
-how to remove and add individual components (note that the
-mean is the only value not shown by default). The second
-figure demonstrates how the styles of the artists can
-be customized.
-
-A good general reference on boxplots and their history can be found
-here: http://vita.had.co.nz/papers/boxplots.pdf
-"""
-
-import matplotlib.pyplot as plt
-import numpy as np
-
-import matplotlib.cbook as cbook
+=============================================
+Separate calculation and plotting of boxplots
+=============================================
 
-# fake data
-np.random.seed(19680801)
-data = np.random.lognormal(size=(37, 4), mean=1.5, sigma=1.75)
-labels = list('ABCD')
-
-# compute the boxplot stats
-stats = cbook.boxplot_stats(data, labels=labels, bootstrap=10000)
+Drawing a `~.axes.Axes.boxplot` for a given data set, consists of two main operations,
+that can also be used separately:
 
-# %%
-# After we've computed the stats, we can go through and change anything.
-# Just to prove it, I'll set the median of each set to the median of all
-# the data, and double the means
+1. Calculating the boxplot statistics: `matplotlib.cbook.boxplot_stats`
+2. Drawing the boxplot: `matplotlib.axes.Axes.bxp`
 
-for n in range(len(stats)):
-    stats[n]['med'] = np.median(data)
-    stats[n]['mean'] *= 2
+Thus, ``ax.boxplot(data)`` is equivalent to ::
 
-print(list(stats[0]))
+    stats = cbook.boxplot_stats(data)
+    ax.bxp(stats)
 
-fs = 10  # fontsize
-
-# %%
-# Demonstrate how to toggle the display of different elements:
+All styling keyword arguments are identical between `~.axes.Axes.boxplot` and
+`~.axes.Axes.bxp`, and they are passed through from `~.axes.Axes.boxplot` to
+`~.axes.Axes.bxp`. However, the *tick_labels* parameter of `~.axes.Axes.boxplot`
+translates to a generic *labels* parameter in `.boxplot_stats`, because the labels are
+data-related and attached to the returned per-dataset dictionaries.
 
-fig, axs = plt.subplots(nrows=2, ncols=3, figsize=(6, 6), sharey=True)
-axs[0, 0].bxp(stats)
-axs[0, 0].set_title('Default', fontsize=fs)
+The following code demonstrates the equivalence between the two methods.
 
-axs[0, 1].bxp(stats, showmeans=True)
-axs[0, 1].set_title('showmeans=True', fontsize=fs)
+"""
+# sphinx_gallery_thumbnail_number = 2
 
-axs[0, 2].bxp(stats, showmeans=True, meanline=True)
-axs[0, 2].set_title('showmeans=True,\nmeanline=True', fontsize=fs)
+import matplotlib.pyplot as plt
+import numpy as np
 
-axs[1, 0].bxp(stats, showbox=False, showcaps=False)
-tufte_title = 'Tufte Style\n(showbox=False,\nshowcaps=False)'
-axs[1, 0].set_title(tufte_title, fontsize=fs)
+from matplotlib import cbook
 
-axs[1, 1].bxp(stats, shownotches=True)
-axs[1, 1].set_title('notch=True', fontsize=fs)
+np.random.seed(19680801)
+data = np.random.randn(20, 3)
 
-axs[1, 2].bxp(stats, showfliers=False)
-axs[1, 2].set_title('showfliers=False', fontsize=fs)
+fig, (ax1, ax2) = plt.subplots(1, 2)
 
-for ax in axs.flat:
-    ax.set_yscale('log')
-    ax.set_yticklabels([])
+# single boxplot call
+ax1.boxplot(data, tick_labels=['A', 'B', 'C'],
+            patch_artist=True, boxprops={'facecolor': 'bisque'})
 
-fig.subplots_adjust(hspace=0.4)
-plt.show()
+# separate calculation of statistics and plotting
+stats = cbook.boxplot_stats(data, labels=['A', 'B', 'C'])
+ax2.bxp(stats, patch_artist=True, boxprops={'facecolor': 'bisque'})
 
 # %%
-# Demonstrate how to customize the display different elements:
-
-boxprops = dict(linestyle='--', linewidth=3, color='darkgoldenrod')
-flierprops = dict(marker='o', markerfacecolor='green', markersize=12,
-                  linestyle='none')
-medianprops = dict(linestyle='-.', linewidth=2.5, color='firebrick')
-meanpointprops = dict(marker='D', markeredgecolor='black',
-                      markerfacecolor='firebrick')
-meanlineprops = dict(linestyle='--', linewidth=2.5, color='purple')
-
-fig, axs = plt.subplots(nrows=2, ncols=2, figsize=(6, 6), sharey=True)
-axs[0, 0].bxp(stats, boxprops=boxprops)
-axs[0, 0].set_title('Custom boxprops', fontsize=fs)
-
-axs[0, 1].bxp(stats, flierprops=flierprops, medianprops=medianprops)
-axs[0, 1].set_title('Custom medianprops\nand flierprops', fontsize=fs)
+# Using the separate functions allows to pre-calculate statistics, in case you need
+# them explicitly for other purposes, or to reuse the statistics for multiple plots.
+#
+# Conversely, you can also use the `~.axes.Axes.bxp` function directly, if you already
+# have the statistical parameters:
 
-axs[1, 0].bxp(stats, meanprops=meanpointprops, meanline=False,
-              showmeans=True)
-axs[1, 0].set_title('Custom mean\nas point', fontsize=fs)
+fig, ax = plt.subplots()
 
-axs[1, 1].bxp(stats, meanprops=meanlineprops, meanline=True,
-              showmeans=True)
-axs[1, 1].set_title('Custom mean\nas line', fontsize=fs)
+stats = [
+    dict(med=0, q1=-1, q3=1, whislo=-2, whishi=2, fliers=[-4, -3, 3, 4], label='A'),
+    dict(med=0, q1=-2, q3=2, whislo=-3, whishi=3, fliers=[], label='B'),
+    dict(med=0, q1=-3, q3=3, whislo=-4, whishi=4, fliers=[], label='C'),
+]
 
-for ax in axs.flat:
-    ax.set_yscale('log')
-    ax.set_yticklabels([])
+ax.bxp(stats, patch_artist=True, boxprops={'facecolor': 'bisque'})
 
-fig.suptitle("I never said they'd be pretty")
-fig.subplots_adjust(hspace=0.4)
 plt.show()
 
 # %%
@@ -112,4 +70,5 @@
 #    in this example:
 #
 #    - `matplotlib.axes.Axes.bxp`
+#    - `matplotlib.axes.Axes.boxplot`
 #    - `matplotlib.cbook.boxplot_stats`

From 241410be14b5d1fce1bf42897be3a1dee77d841f Mon Sep 17 00:00:00 2001
From: trananso <trananson@protonmail.com>
Date: Mon, 25 Mar 2024 16:28:17 -0400
Subject: [PATCH 0887/1120] DOC: Fix typo in ```ax.transData.inversed()```

---
 galleries/users_explain/artists/transforms_tutorial.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/galleries/users_explain/artists/transforms_tutorial.py b/galleries/users_explain/artists/transforms_tutorial.py
index bf99dfd81d2a..8eed53c812b8 100644
--- a/galleries/users_explain/artists/transforms_tutorial.py
+++ b/galleries/users_explain/artists/transforms_tutorial.py
@@ -82,7 +82,7 @@
 `.Transform.inverted`) to generate a transform from output coordinate system
 back to the input coordinate system.  For example, ``ax.transData`` converts
 values in data coordinates to display coordinates and
-``ax.transData.inversed()`` is a :class:`matplotlib.transforms.Transform` that
+``ax.transData.inverted()`` is a :class:`matplotlib.transforms.Transform` that
 goes from display coordinates to data coordinates. This is particularly useful
 when processing events from the user interface, which typically occur in
 display space, and you want to know where the mouse click or key-press occurred

From 4134c8d0a9194667675970620e58dc50c6b6d4a0 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Tue, 26 Mar 2024 17:10:50 +0100
Subject: [PATCH 0888/1120] Clarify error message for bad-dimensionality in
 pcolorfast().

---
 lib/matplotlib/axes/_axes.py      | 5 ++++-
 lib/matplotlib/tests/test_axes.py | 7 +++++++
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 1623ecf1c2c1..ba312935ddb5 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -6591,7 +6591,10 @@ def pcolorfast(self, *args, alpha=None, norm=None, cmap=None, vmin=None,
             elif x.ndim == 2 and y.ndim == 2:
                 style = "quadmesh"
             else:
-                raise TypeError("arguments do not match valid signatures")
+                raise TypeError(
+                    f"When 3 positional parameters are passed to pcolorfast, the first "
+                    f"two (X and Y) must be both 1D or both 2D; the given X was "
+                    f"{x.ndim}D and the given Y was {y.ndim}D")
         else:
             raise _api.nargs_error('pcolorfast', '1 or 3', len(args))
 
diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index 5af508479592..3666b16e6dad 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -6450,6 +6450,13 @@ def test_pcolorfast(xy, data, cls):
     assert type(ax.pcolorfast(*xy, data)) == cls
 
 
+def test_pcolorfast_bad_dims():
+    fig, ax = plt.subplots()
+    with pytest.raises(
+            TypeError, match=("the given X was 1D and the given Y was 2D")):
+        ax.pcolorfast(np.empty(6), np.empty((4, 7)), np.empty((8, 8)))
+
+
 def test_shared_scale():
     fig, axs = plt.subplots(2, 2, sharex=True, sharey=True)
 

From 5394aff1e729155fd27c70bed07a4a58ad2d3bf1 Mon Sep 17 00:00:00 2001
From: Raphael Quast <raphael.quast@geo.tuwien.ac.at>
Date: Wed, 27 Mar 2024 09:22:26 +0100
Subject: [PATCH 0889/1120] minor re-formatting and standardization of variable
 names

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>
---
 .../examples/showcase/pan_zoom_overlap.py     | 14 +++---
 lib/matplotlib/backend_bases.py               |  2 +-
 lib/matplotlib/tests/test_backend_bases.py    | 45 +++++++------------
 3 files changed, 24 insertions(+), 37 deletions(-)

diff --git a/galleries/examples/showcase/pan_zoom_overlap.py b/galleries/examples/showcase/pan_zoom_overlap.py
index 8c0677b651a6..6650b90f01b2 100644
--- a/galleries/examples/showcase/pan_zoom_overlap.py
+++ b/galleries/examples/showcase/pan_zoom_overlap.py
@@ -32,14 +32,14 @@
 
 import matplotlib.pyplot as plt
 
-f = plt.figure(figsize=(11, 6))
-f.suptitle("Showcase for pan/zoom events on overlapping axes.")
+fig = plt.figure(figsize=(11, 6))
+fig.suptitle("Showcase for pan/zoom events on overlapping axes.")
 
-ax = f.add_axes((.05, .05, .9, .9))
+ax = fig.add_axes((.05, .05, .9, .9))
 ax.patch.set_color(".75")
 ax_twin = ax.twinx()
 
-ax1 = f.add_subplot(221)
+ax1 = fig.add_subplot(221)
 ax1_twin = ax1.twinx()
 ax1.text(.5, .5,
          "Visible patch\n\n"
@@ -47,7 +47,7 @@
          "forwarded to axes below",
          ha="center", va="center", transform=ax1.transAxes)
 
-ax11 = f.add_subplot(223, sharex=ax1, sharey=ax1)
+ax11 = fig.add_subplot(223, sharex=ax1, sharey=ax1)
 ax11.set_forward_navigation_events(True)
 ax11.text(.5, .5,
           "Visible patch\n\n"
@@ -55,7 +55,7 @@
           "ax.set_forward_navigation_events(True)",
           ha="center", va="center", transform=ax11.transAxes)
 
-ax2 = f.add_subplot(222)
+ax2 = fig.add_subplot(222)
 ax2_twin = ax2.twinx()
 ax2.patch.set_visible(False)
 ax2.text(.5, .5,
@@ -64,7 +64,7 @@
          "forwarded to axes below",
          ha="center", va="center", transform=ax2.transAxes)
 
-ax22 = f.add_subplot(224, sharex=ax2, sharey=ax2)
+ax22 = fig.add_subplot(224, sharex=ax2, sharey=ax2)
 ax22.patch.set_visible(False)
 ax22.set_forward_navigation_events(False)
 ax22.text(.5, .5,
diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
index 0d12b64e27de..1b4c0424ad12 100644
--- a/lib/matplotlib/backend_bases.py
+++ b/lib/matplotlib/backend_bases.py
@@ -2995,7 +2995,7 @@ def _zoom_pan_handler(self, event):
             elif event.name == "button_release_event":
                 self.release_zoom(event)
 
-    def _start_event_axes_interaction(self, event, method="zoom"):
+    def _start_event_axes_interaction(self, event, *, method):
 
         def _ax_filter(ax):
             return (ax.in_axes(event) and
diff --git a/lib/matplotlib/tests/test_backend_bases.py b/lib/matplotlib/tests/test_backend_bases.py
index 299f89a85be1..399949c93bef 100644
--- a/lib/matplotlib/tests/test_backend_bases.py
+++ b/lib/matplotlib/tests/test_backend_bases.py
@@ -446,8 +446,7 @@ def test_toolmanager_update_keymap():
 @pytest.mark.parametrize("patch_vis", [True, False])
 @pytest.mark.parametrize("forward_nav", [True, False, "auto"])
 @pytest.mark.parametrize("t_s", ["twin", "share"])
-def test_interactive_pan_zoom_events(tool, button, patch_vis,
-                                     forward_nav, t_s):
+def test_interactive_pan_zoom_events(tool, button, patch_vis, forward_nav, t_s):
     # Bottom axes: ax_b    Top axes: ax_t
     fig, ax_b = plt.subplots()
     ax_t = fig.add_subplot(221, zorder=99)
@@ -492,7 +491,7 @@ def test_interactive_pan_zoom_events(tool, button, patch_vis,
     xstart_t, xstop_t, ystart_t, ystop_t = 1, 2, 1, 2
     # Convert to screen coordinates ("s").  Events are defined only with pixel
     # precision, so round the pixel values, and below, check against the
-    # corresponding xdata/ydata, which are close but not equal to d0/d1.
+    # corresponding xdata/ydata, which are close but not equal to s0/s1.
     s0 = ax_t.transData.transform((xstart_t, ystart_t)).astype(int)
     s1 = ax_t.transData.transform((xstop_t, ystop_t)).astype(int)
 
@@ -501,10 +500,8 @@ def test_interactive_pan_zoom_events(tool, button, patch_vis,
     xstop_b, ystop_b = ax_b.transData.inverted().transform(s1)
 
     # Set up the mouse movements
-    start_event = MouseEvent(
-        "button_press_event", fig.canvas, *s0, button)
-    stop_event = MouseEvent(
-        "button_release_event", fig.canvas, *s1, button)
+    start_event = MouseEvent("button_press_event", fig.canvas, *s0, button)
+    stop_event = MouseEvent("button_release_event", fig.canvas, *s1, button)
 
     tb = NavigationToolbar2(fig.canvas)
 
@@ -512,19 +509,16 @@ def test_interactive_pan_zoom_events(tool, button, patch_vis,
         # Evaluate expected limits before executing the zoom-event
         direction = ("in" if button == 1 else "out")
 
-        xlim_t, ylim_t = ax_t._prepare_view_from_bbox(
-            [*s0, *s1], direction)
+        xlim_t, ylim_t = ax_t._prepare_view_from_bbox([*s0, *s1], direction)
 
         if ax_t.get_forward_navigation_events() is True:
-            xlim_b, ylim_b = ax_b._prepare_view_from_bbox(
-                [*s0, *s1], direction)
+            xlim_b, ylim_b = ax_b._prepare_view_from_bbox([*s0, *s1], direction)
         elif ax_t.get_forward_navigation_events() is False:
             xlim_b = init_xlim
             ylim_b = init_ylim
         else:
-            if ax_t.patch.get_visible() is False:
-                xlim_b, ylim_b = ax_b._prepare_view_from_bbox(
-                    [*s0, *s1], direction)
+            if not ax_t.patch.get_visible():
+                xlim_b, ylim_b = ax_b._prepare_view_from_bbox([*s0, *s1], direction)
             else:
                 xlim_b = init_xlim
                 ylim_b = init_ylim
@@ -540,31 +534,26 @@ def test_interactive_pan_zoom_events(tool, button, patch_vis,
         assert ax_b.get_ylim() == pytest.approx(ylim_b, abs=0.15)
 
         # Check if twin-axes are properly triggered
-        assert ax_t.get_xlim() == pytest.approx(ax_t_twin.get_xlim(),
-                                                abs=0.15)
-        assert ax_b.get_xlim() == pytest.approx(ax_b_twin.get_xlim(),
-                                                abs=0.15)
+        assert ax_t.get_xlim() == pytest.approx(ax_t_twin.get_xlim(), abs=0.15)
+        assert ax_b.get_xlim() == pytest.approx(ax_b_twin.get_xlim(), abs=0.15)
     else:
         # Evaluate expected limits
         # (call start_pan to make sure ax._pan_start is set)
         ax_t.start_pan(*s0, button)
-        xlim_t, ylim_t = ax_t._get_pan_points(
-            button, None, *s1).T.astype(float)
+        xlim_t, ylim_t = ax_t._get_pan_points(button, None, *s1).T.astype(float)
         ax_t.end_pan()
 
         if ax_t.get_forward_navigation_events() is True:
             ax_b.start_pan(*s0, button)
-            xlim_b, ylim_b = ax_b._get_pan_points(
-                button, None, *s1).T.astype(float)
+            xlim_b, ylim_b = ax_b._get_pan_points(button, None, *s1).T.astype(float)
             ax_b.end_pan()
         elif ax_t.get_forward_navigation_events() is False:
             xlim_b = init_xlim
             ylim_b = init_ylim
         else:
-            if ax_t.patch.get_visible() is False:
+            if not ax_t.patch.get_visible():
                 ax_b.start_pan(*s0, button)
-                xlim_b, ylim_b = ax_b._get_pan_points(
-                    button, None, *s1).T.astype(float)
+                xlim_b, ylim_b = ax_b._get_pan_points(button, None, *s1).T.astype(float)
                 ax_b.end_pan()
             else:
                 xlim_b = init_xlim
@@ -581,7 +570,5 @@ def test_interactive_pan_zoom_events(tool, button, patch_vis,
         assert ax_b.get_ylim() == pytest.approx(ylim_b, abs=0.15)
 
         # Check if twin-axes are properly triggered
-        assert ax_t.get_xlim() == pytest.approx(ax_t_twin.get_xlim(),
-                                                abs=0.15)
-        assert ax_b.get_xlim() == pytest.approx(ax_b_twin.get_xlim(),
-                                                abs=0.15)
+        assert ax_t.get_xlim() == pytest.approx(ax_t_twin.get_xlim(), abs=0.15)
+        assert ax_b.get_xlim() == pytest.approx(ax_b_twin.get_xlim(), abs=0.15)

From 0f0efed886135979d89a04cb829cb14f75d92fd3 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Wed, 27 Mar 2024 11:34:36 +0100
Subject: [PATCH 0890/1120] DOC: Fix label type specification in parameter
 descriptions

- add missing "or list of str" in hist() docstring
- Use "optional" instead of "default: None"

  See https://matplotlib.org/devdocs/devel/document.html

  > If None is only used as a sentinel value for "parameter not specified",
  > do not document it as the default. Depending on the context, give the
  > actual default, or mark the parameter as optional if not specifying has
  > no particular effect.
---
 lib/matplotlib/axes/_axes.py       | 4 ++--
 lib/mpl_toolkits/mplot3d/axes3d.py | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 1623ecf1c2c1..4225b762e890 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -3058,7 +3058,7 @@ def stem(self, *args, linefmt=None, markerfmt=None, basefmt=None, bottom=0,
         bottom : float, default: 0
             The y/x-position of the baseline (depending on *orientation*).
 
-        label : str, default: None
+        label : str, optional
             The label to use for the stems in legends.
 
         data : indexable object, optional
@@ -6831,7 +6831,7 @@ def hist(self, x, bins=None, range=None, density=False, weights=None,
             Color or sequence of colors, one per dataset.  Default (``None``)
             uses the standard line color sequence.
 
-        label : str or None, default: None
+        label : str or list of str, optional
             String, or sequence of strings to match multiple datasets.  Bar
             charts yield multiple patches per dataset, but only the first gets
             the label, so that `~.Axes.legend` will work as expected.
diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index 9a3c13daad6b..9ca5692c40ab 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -3610,7 +3610,7 @@ def stem(self, x, y, z, *, linefmt='C0-', markerfmt='C0o', basefmt='C3-',
         bottom : float, default: 0
             The position of the baseline, in *orientation*-coordinates.
 
-        label : str, default: None
+        label : str, optional
             The label to use for the stems in legends.
 
         orientation : {'x', 'y', 'z'}, default: 'z'

From 6c1991d88c215e261d1a539bbdd03d2c972a477b Mon Sep 17 00:00:00 2001
From: Jorge Moraleda <jorge.moraleda@gmail.com>
Date: Wed, 27 Mar 2024 08:19:59 -0400
Subject: [PATCH 0891/1120] Use wrapper to set max DPI awareness in MSW in wx
 backend

---
 lib/matplotlib/backends/backend_wx.py | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/lib/matplotlib/backends/backend_wx.py b/lib/matplotlib/backends/backend_wx.py
index 650694063f00..0ae70707ac0d 100644
--- a/lib/matplotlib/backends/backend_wx.py
+++ b/lib/matplotlib/backends/backend_wx.py
@@ -21,7 +21,7 @@
     TimerBase, ToolContainerBase, cursors,
     CloseEvent, KeyEvent, LocationEvent, MouseEvent, ResizeEvent)
 
-from matplotlib import _api, cbook, backend_tools
+from matplotlib import _api, cbook, backend_tools, _c_internal_utils
 from matplotlib._pylab_helpers import Gcf
 from matplotlib.path import Path
 from matplotlib.transforms import Affine2D
@@ -43,10 +43,8 @@ def _create_wxapp():
     wxapp = wx.App(False)
     wxapp.SetExitOnFrameDelete(True)
     cbook._setup_new_guiapp()
-    if wx.Platform == '__WXMSW__':
-        # Set per-process DPI awareness. See https://docs.microsoft.com/en-us/windows/win32/api/shellscalingapi/ne-shellscalingapi-process_dpi_awareness
-        import ctypes
-        ctypes.windll.shcore.SetProcessDpiAwareness(2)
+    # Set per-process DPI awareness. This is a NoOp except in MSW
+    _c_internal_utils.Win32_SetProcessDpiAwareness_max()
     return wxapp
 
 

From 3f729a14a95f1ae255aa9d5aa1ea48680e6b8716 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 27 Mar 2024 23:06:38 -0400
Subject: [PATCH 0892/1120] TST: Remove superfluous chdir from tests

These tests don't chdir back to the original directory on exit, so
anything using the current directory would be in the temporary directory
of this test.

Most notably, any image comparison results would be dumped in that
temporary directory instead of the usual `result_images` in the current
directory.
---
 lib/matplotlib/tests/test_backend_pdf.py | 32 +++++++++++++-----------
 lib/matplotlib/tests/test_backend_pgf.py | 32 +++++++++++++-----------
 2 files changed, 36 insertions(+), 28 deletions(-)

diff --git a/lib/matplotlib/tests/test_backend_pdf.py b/lib/matplotlib/tests/test_backend_pdf.py
index ae17c7a4a4e3..ad565ea9e81b 100644
--- a/lib/matplotlib/tests/test_backend_pdf.py
+++ b/lib/matplotlib/tests/test_backend_pdf.py
@@ -81,43 +81,47 @@ def test_multipage_properfinalize():
 
 
 def test_multipage_keep_empty(tmp_path):
-    os.chdir(tmp_path)
-
     # test empty pdf files
 
     # an empty pdf is left behind with keep_empty unset
-    with pytest.warns(mpl.MatplotlibDeprecationWarning), PdfPages("a.pdf") as pdf:
+    fn = tmp_path / "a.pdf"
+    with pytest.warns(mpl.MatplotlibDeprecationWarning), PdfPages(fn) as pdf:
         pass
-    assert os.path.exists("a.pdf")
+    assert fn.exists()
 
     # an empty pdf is left behind with keep_empty=True
+    fn = tmp_path / "b.pdf"
     with pytest.warns(mpl.MatplotlibDeprecationWarning), \
-            PdfPages("b.pdf", keep_empty=True) as pdf:
+            PdfPages(fn, keep_empty=True) as pdf:
         pass
-    assert os.path.exists("b.pdf")
+    assert fn.exists()
 
     # an empty pdf deletes itself afterwards with keep_empty=False
-    with PdfPages("c.pdf", keep_empty=False) as pdf:
+    fn = tmp_path / "c.pdf"
+    with PdfPages(fn, keep_empty=False) as pdf:
         pass
-    assert not os.path.exists("c.pdf")
+    assert not fn.exists()
 
     # test pdf files with content, they should never be deleted
 
     # a non-empty pdf is left behind with keep_empty unset
-    with PdfPages("d.pdf") as pdf:
+    fn = tmp_path / "d.pdf"
+    with PdfPages(fn) as pdf:
         pdf.savefig(plt.figure())
-    assert os.path.exists("d.pdf")
+    assert fn.exists()
 
     # a non-empty pdf is left behind with keep_empty=True
+    fn = tmp_path / "e.pdf"
     with pytest.warns(mpl.MatplotlibDeprecationWarning), \
-            PdfPages("e.pdf", keep_empty=True) as pdf:
+            PdfPages(fn, keep_empty=True) as pdf:
         pdf.savefig(plt.figure())
-    assert os.path.exists("e.pdf")
+    assert fn.exists()
 
     # a non-empty pdf is left behind with keep_empty=False
-    with PdfPages("f.pdf", keep_empty=False) as pdf:
+    fn = tmp_path / "f.pdf"
+    with PdfPages(fn, keep_empty=False) as pdf:
         pdf.savefig(plt.figure())
-    assert os.path.exists("f.pdf")
+    assert fn.exists()
 
 
 def test_composite_image():
diff --git a/lib/matplotlib/tests/test_backend_pgf.py b/lib/matplotlib/tests/test_backend_pgf.py
index a866916c58c6..8a83515f161c 100644
--- a/lib/matplotlib/tests/test_backend_pgf.py
+++ b/lib/matplotlib/tests/test_backend_pgf.py
@@ -288,43 +288,47 @@ def test_pdf_pages_metadata_check(monkeypatch, system):
 
 @needs_pgf_xelatex
 def test_multipage_keep_empty(tmp_path):
-    os.chdir(tmp_path)
-
     # test empty pdf files
 
     # an empty pdf is left behind with keep_empty unset
-    with pytest.warns(mpl.MatplotlibDeprecationWarning), PdfPages("a.pdf") as pdf:
+    fn = tmp_path / "a.pdf"
+    with pytest.warns(mpl.MatplotlibDeprecationWarning), PdfPages(fn) as pdf:
         pass
-    assert os.path.exists("a.pdf")
+    assert fn.exists()
 
     # an empty pdf is left behind with keep_empty=True
+    fn = tmp_path / "b.pdf"
     with pytest.warns(mpl.MatplotlibDeprecationWarning), \
-            PdfPages("b.pdf", keep_empty=True) as pdf:
+            PdfPages(fn, keep_empty=True) as pdf:
         pass
-    assert os.path.exists("b.pdf")
+    assert fn.exists()
 
     # an empty pdf deletes itself afterwards with keep_empty=False
-    with PdfPages("c.pdf", keep_empty=False) as pdf:
+    fn = tmp_path / "c.pdf"
+    with PdfPages(fn, keep_empty=False) as pdf:
         pass
-    assert not os.path.exists("c.pdf")
+    assert not fn.exists()
 
     # test pdf files with content, they should never be deleted
 
     # a non-empty pdf is left behind with keep_empty unset
-    with PdfPages("d.pdf") as pdf:
+    fn = tmp_path / "d.pdf"
+    with PdfPages(fn) as pdf:
         pdf.savefig(plt.figure())
-    assert os.path.exists("d.pdf")
+    assert fn.exists()
 
     # a non-empty pdf is left behind with keep_empty=True
+    fn = tmp_path / "e.pdf"
     with pytest.warns(mpl.MatplotlibDeprecationWarning), \
-            PdfPages("e.pdf", keep_empty=True) as pdf:
+            PdfPages(fn, keep_empty=True) as pdf:
         pdf.savefig(plt.figure())
-    assert os.path.exists("e.pdf")
+    assert fn.exists()
 
     # a non-empty pdf is left behind with keep_empty=False
-    with PdfPages("f.pdf", keep_empty=False) as pdf:
+    fn = tmp_path / "f.pdf"
+    with PdfPages(fn, keep_empty=False) as pdf:
         pdf.savefig(plt.figure())
-    assert os.path.exists("f.pdf")
+    assert fn.exists()
 
 
 @needs_pgf_xelatex

From 673fb6a2b9940740b014e09bd9e43a0798d417b0 Mon Sep 17 00:00:00 2001
From: Eric Prestat <eric.prestat@gmail.com>
Date: Sat, 22 Jul 2023 10:50:58 +0100
Subject: [PATCH 0893/1120] Add whats_new entry

---
 .../add_EllipseCollection_setters.rst         | 40 +++++++++++++++++++
 1 file changed, 40 insertions(+)
 create mode 100644 doc/users/next_whats_new/add_EllipseCollection_setters.rst

diff --git a/doc/users/next_whats_new/add_EllipseCollection_setters.rst b/doc/users/next_whats_new/add_EllipseCollection_setters.rst
new file mode 100644
index 000000000000..d3f7b3d85f15
--- /dev/null
+++ b/doc/users/next_whats_new/add_EllipseCollection_setters.rst
@@ -0,0 +1,40 @@
+Add ``widths``, ``heights`` and ``angles`` setter to ``EllipseCollection``
+--------------------------------------------------------------------------
+
+The ``widths``, ``heights`` and ``angles`` values of the `~matplotlib.collections.EllipseCollection`
+can now be changed after the collection has been created.
+
+.. plot::
+    :include-source: true
+
+    import matplotlib.pyplot as plt
+    from matplotlib.collections import EllipseCollection
+    import numpy as np
+
+    rng = np.random.default_rng(0)
+
+    widths = (2, )
+    heights = (3, )
+    angles = (45, )
+    offsets = rng.random((10, 2)) * 10
+
+    fig, ax = plt.subplots()
+
+    ec = EllipseCollection(
+        widths=widths,
+        heights=heights,
+        angles=angles,
+        offsets=offsets,
+        units='x',
+        offset_transform=ax.transData,
+        )
+
+    ax.add_collection(ec)
+    ax.set_xlim(-2, 12)
+    ax.set_ylim(-2, 12)
+
+    new_widths = rng.random((10, 2)) * 2
+    new_heights = rng.random((10, 2)) * 3
+    new_angles = rng.random((10, 2)) * 180
+
+    ec.set(widths=new_widths, heights=new_heights, angles=new_angles)

From f7be1b6e717c713af227c3f36fe61711a9ca0f56 Mon Sep 17 00:00:00 2001
From: Eric Prestat <eric.prestat@gmail.com>
Date: Sat, 22 Jul 2023 12:18:51 +0100
Subject: [PATCH 0894/1120] Fix typing

---
 lib/matplotlib/collections.pyi | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/lib/matplotlib/collections.pyi b/lib/matplotlib/collections.pyi
index 7162c4687dfa..1aaa7ca7fd1c 100644
--- a/lib/matplotlib/collections.pyi
+++ b/lib/matplotlib/collections.pyi
@@ -180,6 +180,9 @@ class EllipseCollection(Collection):
         ] = ...,
         **kwargs
     ) -> None: ...
+    def set_widths(self, widths: ArrayLike) -> None: ...
+    def set_heights(self, heights: ArrayLike) -> None: ...
+    def set_angles(self, angles: ArrayLike) -> None: ...
 
 class PatchCollection(Collection):
     def __init__(

From e4c5938989a0841f01e1688a7932d22d334e9e9c Mon Sep 17 00:00:00 2001
From: Eric Prestat <eric.prestat@gmail.com>
Date: Sun, 23 Jul 2023 10:34:33 +0100
Subject: [PATCH 0895/1120] Use setters in constructor, add docstring to
 setters and improve tests

---
 lib/matplotlib/collections.py            | 26 +++++++++++++++++-------
 lib/matplotlib/tests/test_collections.py |  8 ++++++++
 2 files changed, 27 insertions(+), 7 deletions(-)

diff --git a/lib/matplotlib/collections.py b/lib/matplotlib/collections.py
index c3380c278e37..92a3a522e9d2 100644
--- a/lib/matplotlib/collections.py
+++ b/lib/matplotlib/collections.py
@@ -1745,9 +1745,9 @@ def __init__(self, widths, heights, angles, *, units='points', **kwargs):
             Forwarded to `Collection`.
         """
         super().__init__(**kwargs)
-        self._widths = 0.5 * np.asarray(widths).ravel()
-        self._heights = 0.5 * np.asarray(heights).ravel()
-        self._angles = np.deg2rad(angles).ravel()
+        self._set_widths(widths)
+        self._set_heights(heights)
+        self._set_angles(angles)
         self._units = units
         self.set_transform(transforms.IdentityTransform())
         self._transforms = np.empty((0, 3, 3))
@@ -1795,16 +1795,28 @@ def _set_transforms(self):
             m[:2, 2:] = 0
             self.set_transform(_affine(m))
 
-    def set_widths(self, widths):
+    def _set_widths(self, widths):
         self._widths = 0.5 * np.asarray(widths).ravel()
-        self.stale = True
 
-    def set_angles(self, angles):
+    def _set_heights(self, heights):
+        self._heights = 0.5 * np.asarray(heights).ravel()
+
+    def _set_angles(self, angles):
         self._angles = np.deg2rad(angles).ravel()
+
+    def set_widths(self, widths):
+        """Set the lengths of the first axes (e.g., major axis lengths)."""
+        self._set_widths(widths)
         self.stale = True
 
     def set_heights(self, heights):
-        self._heights = 0.5 * np.asarray(heights).ravel()
+        """Set the lengths of second axes.."""
+        self._set_heights(heights)
+        self.stale = True
+
+    def set_angles(self, angles):
+        """Set the angles of the first axes, degrees CCW from the x-axis."""
+        self._set_angles(angles)
         self.stale = True
 
     @artist.allow_rasterization
diff --git a/lib/matplotlib/tests/test_collections.py b/lib/matplotlib/tests/test_collections.py
index 19ad4081715a..095ce76131a5 100644
--- a/lib/matplotlib/tests/test_collections.py
+++ b/lib/matplotlib/tests/test_collections.py
@@ -428,6 +428,10 @@ def test_EllipseCollection_setter():
         offset_transform=ax.transData,
         )
 
+    assert_array_almost_equal(ec._widths, np.array(widths).ravel() * 0.5)
+    assert_array_almost_equal(ec._heights, np.array(heights).ravel() * 0.5)
+    assert_array_almost_equal(ec._angles, np.deg2rad(angles).ravel())
+
     ax.add_collection(ec)
     ax.set_xlim(-2, 12)
     ax.set_ylim(-2, 12)
@@ -438,6 +442,10 @@ def test_EllipseCollection_setter():
 
     ec.set(widths=new_widths, heights=new_heights, angles=new_angles)
 
+    assert_array_almost_equal(ec._widths, np.array(new_widths).ravel() * 0.5)
+    assert_array_almost_equal(ec._heights, np.array(new_heights).ravel() * 0.5)
+    assert_array_almost_equal(ec._angles, np.deg2rad(new_angles).ravel())
+
 
 @image_comparison(['polycollection_close.png'], remove_text=True, style='mpl20')
 def test_polycollection_close():

From 45a6a6f2f0268207393d22b4431a5b78130f288c Mon Sep 17 00:00:00 2001
From: Eric Prestat <eric.prestat@gmail.com>
Date: Sun, 28 Jan 2024 09:36:50 +0000
Subject: [PATCH 0896/1120] Add getters to EllipseColletion

---
 lib/matplotlib/collections.py            | 16 ++++++++++++++--
 lib/matplotlib/collections.pyi           |  3 +++
 lib/matplotlib/tests/test_collections.py | 12 ++++++++----
 3 files changed, 25 insertions(+), 6 deletions(-)

diff --git a/lib/matplotlib/collections.py b/lib/matplotlib/collections.py
index 92a3a522e9d2..b44dd4999ede 100644
--- a/lib/matplotlib/collections.py
+++ b/lib/matplotlib/collections.py
@@ -1805,20 +1805,32 @@ def _set_angles(self, angles):
         self._angles = np.deg2rad(angles).ravel()
 
     def set_widths(self, widths):
-        """Set the lengths of the first axes (e.g., major axis lengths)."""
+        """Set the lengths of the first axes (e.g., major axis)."""
         self._set_widths(widths)
         self.stale = True
 
     def set_heights(self, heights):
-        """Set the lengths of second axes.."""
+        """Set the lengths of second axes (e.g., minor axes)."""
         self._set_heights(heights)
         self.stale = True
 
+    def get_widths(self):
+        """Get the lengths of the first axes (e.g., major axis)."""
+        return self._widths * 2
+
+    def get_heights(self):
+        """Set the lengths of second axes (e.g., minor axes)."""
+        return self._heights * 2
+
     def set_angles(self, angles):
         """Set the angles of the first axes, degrees CCW from the x-axis."""
         self._set_angles(angles)
         self.stale = True
 
+    def get_angles(self):
+        """Get the angles of the first axes, degrees CCW from the x-axis."""
+        return np.rad2deg(self._angles)
+
     @artist.allow_rasterization
     def draw(self, renderer):
         self._set_transforms()
diff --git a/lib/matplotlib/collections.pyi b/lib/matplotlib/collections.pyi
index 1aaa7ca7fd1c..65b50431b34b 100644
--- a/lib/matplotlib/collections.pyi
+++ b/lib/matplotlib/collections.pyi
@@ -181,8 +181,11 @@ class EllipseCollection(Collection):
         **kwargs
     ) -> None: ...
     def set_widths(self, widths: ArrayLike) -> None: ...
+    def get_widths(self) -> ArrayLike: ...
     def set_heights(self, heights: ArrayLike) -> None: ...
+    def get_heights(self) -> ArrayLike: ...
     def set_angles(self, angles: ArrayLike) -> None: ...
+    def get_angles(self) -> ArrayLike: ...
 
 class PatchCollection(Collection):
     def __init__(
diff --git a/lib/matplotlib/tests/test_collections.py b/lib/matplotlib/tests/test_collections.py
index 095ce76131a5..13eef30471f3 100644
--- a/lib/matplotlib/tests/test_collections.py
+++ b/lib/matplotlib/tests/test_collections.py
@@ -408,7 +408,7 @@ def test_EllipseCollection():
     ax.autoscale_view()
 
 
-def test_EllipseCollection_setter():
+def test_EllipseCollection_setter_getter():
     # Test widths, heights and angle setter
     rng = np.random.default_rng(0)
 
@@ -432,6 +432,10 @@ def test_EllipseCollection_setter():
     assert_array_almost_equal(ec._heights, np.array(heights).ravel() * 0.5)
     assert_array_almost_equal(ec._angles, np.deg2rad(angles).ravel())
 
+    assert_array_almost_equal(ec.get_widths(), widths)
+    assert_array_almost_equal(ec.get_heights(), heights)
+    assert_array_almost_equal(ec.get_angles(), angles)
+
     ax.add_collection(ec)
     ax.set_xlim(-2, 12)
     ax.set_ylim(-2, 12)
@@ -442,9 +446,9 @@ def test_EllipseCollection_setter():
 
     ec.set(widths=new_widths, heights=new_heights, angles=new_angles)
 
-    assert_array_almost_equal(ec._widths, np.array(new_widths).ravel() * 0.5)
-    assert_array_almost_equal(ec._heights, np.array(new_heights).ravel() * 0.5)
-    assert_array_almost_equal(ec._angles, np.deg2rad(new_angles).ravel())
+    assert_array_almost_equal(ec.get_widths(), new_widths.ravel())
+    assert_array_almost_equal(ec.get_heights(), new_heights.ravel())
+    assert_array_almost_equal(ec.get_angles(), new_angles.ravel())
 
 
 @image_comparison(['polycollection_close.png'], remove_text=True, style='mpl20')

From 729467c85a8661c50c5b845d2b9c5715208c68da Mon Sep 17 00:00:00 2001
From: Eric Prestat <eric.prestat@gmail.com>
Date: Thu, 28 Mar 2024 14:42:25 +0000
Subject: [PATCH 0897/1120] Simplify `EllipseCollection` setter and tidy up
 typing

---
 lib/matplotlib/collections.py  | 29 ++++++++++-------------------
 lib/matplotlib/collections.pyi |  4 ++--
 2 files changed, 12 insertions(+), 21 deletions(-)

diff --git a/lib/matplotlib/collections.py b/lib/matplotlib/collections.py
index b44dd4999ede..147ec634ca6f 100644
--- a/lib/matplotlib/collections.py
+++ b/lib/matplotlib/collections.py
@@ -1745,9 +1745,9 @@ def __init__(self, widths, heights, angles, *, units='points', **kwargs):
             Forwarded to `Collection`.
         """
         super().__init__(**kwargs)
-        self._set_widths(widths)
-        self._set_heights(heights)
-        self._set_angles(angles)
+        self.set_widths(widths)
+        self.set_heights(heights)
+        self.set_angles(angles)
         self._units = units
         self.set_transform(transforms.IdentityTransform())
         self._transforms = np.empty((0, 3, 3))
@@ -1795,23 +1795,19 @@ def _set_transforms(self):
             m[:2, 2:] = 0
             self.set_transform(_affine(m))
 
-    def _set_widths(self, widths):
-        self._widths = 0.5 * np.asarray(widths).ravel()
-
-    def _set_heights(self, heights):
-        self._heights = 0.5 * np.asarray(heights).ravel()
-
-    def _set_angles(self, angles):
-        self._angles = np.deg2rad(angles).ravel()
-
     def set_widths(self, widths):
         """Set the lengths of the first axes (e.g., major axis)."""
-        self._set_widths(widths)
+        self._widths = 0.5 * np.asarray(widths).ravel()
         self.stale = True
 
     def set_heights(self, heights):
         """Set the lengths of second axes (e.g., minor axes)."""
-        self._set_heights(heights)
+        self._heights = 0.5 * np.asarray(heights).ravel()
+        self.stale = True
+
+    def set_angles(self, angles):
+        """Set the angles of the first axes, degrees CCW from the x-axis."""
+        self._angles = np.deg2rad(angles).ravel()
         self.stale = True
 
     def get_widths(self):
@@ -1822,11 +1818,6 @@ def get_heights(self):
         """Set the lengths of second axes (e.g., minor axes)."""
         return self._heights * 2
 
-    def set_angles(self, angles):
-        """Set the angles of the first axes, degrees CCW from the x-axis."""
-        self._set_angles(angles)
-        self.stale = True
-
     def get_angles(self):
         """Get the angles of the first axes, degrees CCW from the x-axis."""
         return np.rad2deg(self._angles)
diff --git a/lib/matplotlib/collections.pyi b/lib/matplotlib/collections.pyi
index 65b50431b34b..e4c46229517f 100644
--- a/lib/matplotlib/collections.pyi
+++ b/lib/matplotlib/collections.pyi
@@ -181,10 +181,10 @@ class EllipseCollection(Collection):
         **kwargs
     ) -> None: ...
     def set_widths(self, widths: ArrayLike) -> None: ...
-    def get_widths(self) -> ArrayLike: ...
     def set_heights(self, heights: ArrayLike) -> None: ...
-    def get_heights(self) -> ArrayLike: ...
     def set_angles(self, angles: ArrayLike) -> None: ...
+    def get_widths(self) -> ArrayLike: ...
+    def get_heights(self) -> ArrayLike: ...
     def get_angles(self) -> ArrayLike: ...
 
 class PatchCollection(Collection):

From 2227d9f8fbe5a409586e1388cd8a44908b5ff75c Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 28 Mar 2024 19:12:22 -0400
Subject: [PATCH 0898/1120] gtk: Ensure pending draws are done before GTK draw

Originally, the resize event happens first, adds an idle draw callback,
and then the widget draws itself. Since the draw callback only happens
when _idle_, it happens after the draw, so the figure appears blank.
After the mouse is released, the idle draw callback fires, and the
figure appears again.

This is already done in the Qt backend [1], and doing so ensures the
figure remains visible during resizes with the mouse.

[1] https://github.com/matplotlib/matplotlib/blob/0afc5d6ca49cf6e8aa1da76b5bab0faca2f340f2/lib/matplotlib/backends/backend_qtagg.py#L25
---
 lib/matplotlib/backends/backend_gtk3agg.py   | 7 ++++++-
 lib/matplotlib/backends/backend_gtk3cairo.py | 7 ++++++-
 lib/matplotlib/backends/backend_gtk4agg.py   | 7 ++++++-
 lib/matplotlib/backends/backend_gtk4cairo.py | 7 ++++++-
 4 files changed, 24 insertions(+), 4 deletions(-)

diff --git a/lib/matplotlib/backends/backend_gtk3agg.py b/lib/matplotlib/backends/backend_gtk3agg.py
index a006a4c6f127..90b38ffa4ec3 100644
--- a/lib/matplotlib/backends/backend_gtk3agg.py
+++ b/lib/matplotlib/backends/backend_gtk3agg.py
@@ -2,7 +2,7 @@
 
 from .. import cbook, transforms
 from . import backend_agg, backend_gtk3
-from .backend_gtk3 import Gtk, _BackendGTK3
+from .backend_gtk3 import GLib, Gtk, _BackendGTK3
 
 import cairo  # Presence of cairo is already checked by _backend_gtk.
 
@@ -14,6 +14,11 @@ def __init__(self, figure):
         self._bbox_queue = []
 
     def on_draw_event(self, widget, ctx):
+        if self._idle_draw_id:
+            GLib.source_remove(self._idle_draw_id)
+            self._idle_draw_id = 0
+            self.draw()
+
         scale = self.device_pixel_ratio
         allocation = self.get_allocation()
         w = allocation.width * scale
diff --git a/lib/matplotlib/backends/backend_gtk3cairo.py b/lib/matplotlib/backends/backend_gtk3cairo.py
index 1da8419e5381..24a26111f062 100644
--- a/lib/matplotlib/backends/backend_gtk3cairo.py
+++ b/lib/matplotlib/backends/backend_gtk3cairo.py
@@ -1,11 +1,16 @@
 from contextlib import nullcontext
 
 from .backend_cairo import FigureCanvasCairo
-from .backend_gtk3 import Gtk, FigureCanvasGTK3, _BackendGTK3
+from .backend_gtk3 import GLib, Gtk, FigureCanvasGTK3, _BackendGTK3
 
 
 class FigureCanvasGTK3Cairo(FigureCanvasCairo, FigureCanvasGTK3):
     def on_draw_event(self, widget, ctx):
+        if self._idle_draw_id:
+            GLib.source_remove(self._idle_draw_id)
+            self._idle_draw_id = 0
+            self.draw()
+
         with (self.toolbar._wait_cursor_for_draw_cm() if self.toolbar
               else nullcontext()):
             self._renderer.set_context(ctx)
diff --git a/lib/matplotlib/backends/backend_gtk4agg.py b/lib/matplotlib/backends/backend_gtk4agg.py
index efddfec56075..0af07850a30a 100644
--- a/lib/matplotlib/backends/backend_gtk4agg.py
+++ b/lib/matplotlib/backends/backend_gtk4agg.py
@@ -2,7 +2,7 @@
 
 from .. import cbook
 from . import backend_agg, backend_gtk4
-from .backend_gtk4 import Gtk, _BackendGTK4
+from .backend_gtk4 import GLib, Gtk, _BackendGTK4
 
 import cairo  # Presence of cairo is already checked by _backend_gtk.
 
@@ -11,6 +11,11 @@ class FigureCanvasGTK4Agg(backend_agg.FigureCanvasAgg,
                           backend_gtk4.FigureCanvasGTK4):
 
     def on_draw_event(self, widget, ctx):
+        if self._idle_draw_id:
+            GLib.source_remove(self._idle_draw_id)
+            self._idle_draw_id = 0
+            self.draw()
+
         scale = self.device_pixel_ratio
         allocation = self.get_allocation()
 
diff --git a/lib/matplotlib/backends/backend_gtk4cairo.py b/lib/matplotlib/backends/backend_gtk4cairo.py
index d57f53fb28d6..b1d543704351 100644
--- a/lib/matplotlib/backends/backend_gtk4cairo.py
+++ b/lib/matplotlib/backends/backend_gtk4cairo.py
@@ -1,13 +1,18 @@
 from contextlib import nullcontext
 
 from .backend_cairo import FigureCanvasCairo
-from .backend_gtk4 import Gtk, FigureCanvasGTK4, _BackendGTK4
+from .backend_gtk4 import GLib, Gtk, FigureCanvasGTK4, _BackendGTK4
 
 
 class FigureCanvasGTK4Cairo(FigureCanvasCairo, FigureCanvasGTK4):
     _context_is_scaled = True
 
     def on_draw_event(self, widget, ctx):
+        if self._idle_draw_id:
+            GLib.source_remove(self._idle_draw_id)
+            self._idle_draw_id = 0
+            self.draw()
+
         with (self.toolbar._wait_cursor_for_draw_cm() if self.toolbar
               else nullcontext()):
             self._renderer.set_context(ctx)

From 65d7e080e7d6a77778de2c027d269e41483487bf Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Tue, 30 Jan 2024 20:49:21 -0500
Subject: [PATCH 0899/1120] ci: Enable testing on M1 macOS

---
 .github/workflows/tests.yml | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index a825b4cf263b..5d950c09a78f 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -87,10 +87,14 @@ jobs:
             pyqt6-ver: '!=6.6.0'
             # https://bugreports.qt.io/projects/PYSIDE/issues/PYSIDE-2346
             pyside6-ver: '!=6.5.1'
-          - os: macos-latest
+          - os: macos-12  # This runnre is on Intel chips.
             python-version: 3.9
             # https://bugreports.qt.io/projects/PYSIDE/issues/PYSIDE-2346
             pyside6-ver: '!=6.5.1'
+          - os: macos-14  # This runner is on M1 (arm64) chips.
+            python-version: '3.12'
+            # https://bugreports.qt.io/projects/PYSIDE/issues/PYSIDE-2346
+            pyside6-ver: '!=6.5.1'
 
     steps:
       - uses: actions/checkout@v4

From 4a3780bb2ad11467ffc2f326c8952382da62f4e4 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 20 Mar 2024 00:32:02 -0400
Subject: [PATCH 0900/1120] TST: Check cross Qt import results from parent
 process

We are only interested in whether we emitted the warning, and don't care
if the test segfaults or otherwise crashes. Thus it is better to check
the output from the parent process, instead of `pytest.warns` in the
subprocess and checking the return code.
---
 .../tests/test_backends_interactive.py        | 45 ++++++++++---------
 1 file changed, 25 insertions(+), 20 deletions(-)

diff --git a/lib/matplotlib/tests/test_backends_interactive.py b/lib/matplotlib/tests/test_backends_interactive.py
index 2464552d4b98..94fa4272714a 100644
--- a/lib/matplotlib/tests/test_backends_interactive.py
+++ b/lib/matplotlib/tests/test_backends_interactive.py
@@ -424,9 +424,9 @@ def test_qt_missing():
 
 
 def _impl_test_cross_Qt_imports():
-    import sys
     import importlib
-    import pytest
+    import sys
+    import warnings
 
     _, host_binding, mpl_binding = sys.argv
     # import the mpl binding.  This will force us to use that binding
@@ -436,11 +436,12 @@ def _impl_test_cross_Qt_imports():
     host_qwidgets = importlib.import_module(f'{host_binding}.QtWidgets')
 
     host_app = host_qwidgets.QApplication(["mpl testing"])
-    with pytest.warns(UserWarning, match="Mixing Qt major"):
-        matplotlib.backends.backend_qt._create_qApp()
+    warnings.filterwarnings("error", message=r".*Mixing Qt major.*",
+                            category=UserWarning)
+    matplotlib.backends.backend_qt._create_qApp()
 
 
-def test_cross_Qt_imports():
+def qt5_and_qt6_pairs():
     qt5_bindings = [
         dep for dep in ['PyQt5', 'PySide2']
         if importlib.util.find_spec(dep) is not None
@@ -450,25 +451,29 @@ def test_cross_Qt_imports():
         if importlib.util.find_spec(dep) is not None
     ]
     if len(qt5_bindings) == 0 or len(qt6_bindings) == 0:
-        pytest.skip('need both QT6 and QT5 bindings')
+        yield pytest.param(None, None,
+                           marks=[pytest.mark.skip('need both QT6 and QT5 bindings')])
+        return
 
     for qt5 in qt5_bindings:
         for qt6 in qt6_bindings:
             for pair in ([qt5, qt6], [qt6, qt5]):
-                try:
-                    _run_helper(_impl_test_cross_Qt_imports,
-                                *pair,
-                                timeout=_test_timeout)
-                except subprocess.CalledProcessError as ex:
-                    # if segfault, carry on.  We do try to warn the user they
-                    # are doing something that we do not expect to work
-                    if ex.returncode == -signal.SIGSEGV:
-                        continue
-                    # We got the abort signal which is likely because the Qt5 /
-                    # Qt6 cross import is unhappy, carry on.
-                    elif ex.returncode == -signal.SIGABRT:
-                        continue
-                    raise
+                yield pair
+
+
+@pytest.mark.parametrize('host, mpl', [*qt5_and_qt6_pairs()])
+def test_cross_Qt_imports(host, mpl):
+    try:
+        proc = _run_helper(_impl_test_cross_Qt_imports, host, mpl,
+                           timeout=_test_timeout)
+    except subprocess.CalledProcessError as ex:
+        # We do try to warn the user they are doing something that we do not
+        # expect to work, so we're going to ignore if the subprocess crashes or
+        # is killed, and just check that the warning is printed.
+        stderr = ex.stderr
+    else:
+        stderr = proc.stderr
+    assert "Mixing Qt major versions may not work as expected." in stderr
 
 
 @pytest.mark.skipif('TF_BUILD' in os.environ,

From fd336affa22fcf187457060a1c7ae0401992c0cf Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Tue, 30 Jan 2024 21:34:50 -0500
Subject: [PATCH 0901/1120] ci: Remove extra conditions for optional GUI
 dependencies

We aren't testing on macOS 10.12 any more, but macos-latest, which is
now macOS 12. Wheels for Python 3.12 should be available everywhere by
now as well.

Only PySide2 remains conditional, as it is deprecated, but provides
universal wheels that install but don't work on Python 3.12.
---
 .github/workflows/tests.yml                   | 45 ++++++++-----------
 .../tests/test_backends_interactive.py        |  7 +++
 2 files changed, 25 insertions(+), 27 deletions(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 5d950c09a78f..61355ae7dbdf 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -232,7 +232,6 @@ jobs:
           # (sometimes, the install appears to be successful but shared
           # libraries cannot be loaded at runtime, so an actual import is a
           # better check).
-          # PyGObject, pycairo, and cariocffi do not install on macOS 10.12.
           python -m pip install --upgrade pycairo 'cairocffi>=0.8' PyGObject &&
             (
               python -c 'import gi; gi.require_version("Gtk", "4.0"); from gi.repository import Gtk' &&
@@ -242,43 +241,35 @@ jobs:
               echo 'PyGObject 3 is available' || echo 'PyGObject 3 is not available'
             )
 
-          # There are no functioning wheels available for macOS 10.12 (as of
-          # Sept 2020) for either pyqt5 (there are only wheels for 10.13+) or
-          # pyside2 (the latest version (5.13.2) with 10.12 wheels has a
-          # fatal to us bug, it was fixed in 5.14.0 which has 10.13 wheels)
           python -mpip install --upgrade pyqt5${{ matrix.pyqt5-ver }} &&
             python -c 'import PyQt5.QtCore' &&
             echo 'PyQt5 is available' ||
             echo 'PyQt5 is not available'
-          if [[ "${{ runner.os }}" != 'macOS'
+          # Even though PySide2 wheels can be installed on Python 3.12, they are broken and since PySide2 is
+          # deprecated, they are unlikely to be fixed. For the same deprecation reason, there are no wheels
+          # on M1 macOS, so don't bother there either.
+          if [[ "${{ matrix.os }}" != 'macos-14'
                 && "${{ matrix.python-version }}" != '3.12' ]]; then
             python -mpip install --upgrade pyside2${{ matrix.pyside2-ver }} &&
               python -c 'import PySide2.QtCore' &&
               echo 'PySide2 is available' ||
               echo 'PySide2 is not available'
           fi
-          if [[ "${{ runner.os }}" != 'macOS' ]]; then
-            python -mpip install --upgrade pyqt6${{ matrix.pyqt6-ver }} &&
-              python -c 'import PyQt6.QtCore' &&
-              echo 'PyQt6 is available' ||
-              echo 'PyQt6 is not available'
-          fi
-          if [[ "${{ runner.os }}" != 'macOS'
-                && "${{ matrix.python-version }}" != '3.12' ]]; then
-            python -mpip install --upgrade pyside6${{ matrix.pyside6-ver }} &&
-              python -c 'import PySide6.QtCore' &&
-              echo 'PySide6 is available' ||
-              echo 'PySide6 is not available'
-          fi
+          python -mpip install --upgrade pyqt6${{ matrix.pyqt6-ver }} &&
+            python -c 'import PyQt6.QtCore' &&
+            echo 'PyQt6 is available' ||
+            echo 'PyQt6 is not available'
+          python -mpip install --upgrade pyside6${{ matrix.pyside6-ver }} &&
+            python -c 'import PySide6.QtCore' &&
+            echo 'PySide6 is available' ||
+            echo 'PySide6 is not available'
 
-          if [[ "${{ matrix.python-version }}" != '3.12' ]]; then
-            python -mpip install --upgrade \
-              -f "https://extras.wxpython.org/wxPython4/extras/linux/gtk3/${{ matrix.os }}" \
-              wxPython &&
-              python -c 'import wx' &&
-              echo 'wxPython is available' ||
-              echo 'wxPython is not available'
-          fi
+          python -mpip install --upgrade \
+            -f "https://extras.wxpython.org/wxPython4/extras/linux/gtk3/${{ matrix.os }}" \
+            wxPython &&
+            python -c 'import wx' &&
+            echo 'wxPython is available' ||
+            echo 'wxPython is not available'
 
       - name: Install the nightly dependencies
         # Only install the nightly dependencies during the scheduled event
diff --git a/lib/matplotlib/tests/test_backends_interactive.py b/lib/matplotlib/tests/test_backends_interactive.py
index 94fa4272714a..e021405c56b7 100644
--- a/lib/matplotlib/tests/test_backends_interactive.py
+++ b/lib/matplotlib/tests/test_backends_interactive.py
@@ -771,6 +771,13 @@ def test_other_signal_before_sigint(env, target, kwargs, request):
         pytest.skip("SIGINT currently only tested on qt and macosx")
     if backend == "macosx":
         request.node.add_marker(pytest.mark.xfail(reason="macosx backend is buggy"))
+    if sys.platform == "darwin" and target == "show":
+        # We've not previously had these toolkits installed on CI, and so were never
+        # aware that this was crashing. However, we've had little luck reproducing it
+        # locally, so mark it xfail for now. For more information, see
+        # https://github.com/matplotlib/matplotlib/issues/27984
+        request.node.add_marker(
+            pytest.mark.xfail(reason="Qt backend is buggy on macOS"))
     proc = _WaitForStringPopen(
         [sys.executable, "-c",
          inspect.getsource(_test_other_signal_before_sigint_impl) +

From 001ef1b99a5ea7d6bd6d09e751c4df29d47916ee Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 15 Mar 2024 02:19:27 -0400
Subject: [PATCH 0902/1120] TST: Increase tolerances for M1 machines

These are mostly just single bit changes in antialiasing portions of
diagonal lines.
---
 lib/matplotlib/tests/test_arrow_patches.py    |  8 ++--
 lib/matplotlib/tests/test_axes.py             | 40 ++++++++++++-------
 lib/matplotlib/tests/test_bbox_tight.py       |  4 +-
 lib/matplotlib/tests/test_collections.py      |  4 +-
 lib/matplotlib/tests/test_colorbar.py         |  5 +--
 .../tests/test_constrainedlayout.py           |  5 ++-
 lib/matplotlib/tests/test_contour.py          |  3 +-
 lib/matplotlib/tests/test_figure.py           |  3 +-
 lib/matplotlib/tests/test_image.py            |  2 +-
 lib/matplotlib/tests/test_legend.py           | 19 +++++----
 lib/matplotlib/tests/test_lines.py            |  5 ++-
 lib/matplotlib/tests/test_patches.py          | 12 +++---
 lib/matplotlib/tests/test_path.py             |  8 ++--
 lib/matplotlib/tests/test_patheffects.py      |  7 +++-
 lib/matplotlib/tests/test_polar.py            |  2 +-
 lib/matplotlib/tests/test_simplification.py   |  4 +-
 lib/matplotlib/tests/test_skew.py             |  4 +-
 lib/matplotlib/tests/test_streamplot.py       |  2 +-
 lib/matplotlib/tests/test_subplots.py         |  4 +-
 lib/matplotlib/tests/test_units.py            |  4 +-
 .../axes_grid1/tests/test_axes_grid1.py       |  3 +-
 .../tests/test_grid_helper_curvelinear.py     |  4 +-
 lib/mpl_toolkits/mplot3d/tests/test_axes3d.py |  7 ++--
 .../mplot3d/tests/test_legend3d.py            | 12 +++---
 24 files changed, 104 insertions(+), 67 deletions(-)

diff --git a/lib/matplotlib/tests/test_arrow_patches.py b/lib/matplotlib/tests/test_arrow_patches.py
index 8d573b4adb1b..254b86cb54d6 100644
--- a/lib/matplotlib/tests/test_arrow_patches.py
+++ b/lib/matplotlib/tests/test_arrow_patches.py
@@ -11,7 +11,8 @@ def draw_arrow(ax, t, r):
                                 fc="b", ec='k'))
 
 
-@image_comparison(['fancyarrow_test_image'])
+@image_comparison(['fancyarrow_test_image'],
+                  tol=0.012 if platform.machine() == 'arm64' else 0)
 def test_fancyarrow():
     # Added 0 to test division by zero error described in issue 3930
     r = [0.4, 0.3, 0.2, 0.1, 0]
@@ -115,7 +116,7 @@ def test_fancyarrow_dash():
 
 
 @image_comparison(['arrow_styles.png'], style='mpl20', remove_text=True,
-                  tol=0 if platform.machine() == 'x86_64' else 0.005)
+                  tol=0 if platform.machine() == 'x86_64' else 0.02)
 def test_arrow_styles():
     styles = mpatches.ArrowStyle.get_styles()
 
@@ -147,7 +148,8 @@ def test_arrow_styles():
             ax.add_patch(patch)
 
 
-@image_comparison(['connection_styles.png'], style='mpl20', remove_text=True)
+@image_comparison(['connection_styles.png'], style='mpl20', remove_text=True,
+                  tol=0.013 if platform.machine() == 'arm64' else 0)
 def test_connection_styles():
     styles = mpatches.ConnectionStyle.get_styles()
 
diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index 3666b16e6dad..deb83a26033c 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -237,7 +237,8 @@ def test_matshow(fig_test, fig_ref):
                    'formatter_ticker_003',
                    'formatter_ticker_004',
                    'formatter_ticker_005',
-                   ])
+                   ],
+                  tol=0.031 if platform.machine() == 'arm64' else 0)
 def test_formatter_ticker():
     import matplotlib.testing.jpl_units as units
     units.register()
@@ -437,7 +438,8 @@ def test_twin_logscale(fig_test, fig_ref, twin):
     remove_ticks_and_titles(fig_ref)
 
 
-@image_comparison(['twin_autoscale.png'])
+@image_comparison(['twin_autoscale.png'],
+                  tol=0.009 if platform.machine() == 'arm64' else 0)
 def test_twinx_axis_scales():
     x = np.array([0, 0.5, 1])
     y = 0.5 * x
@@ -1232,7 +1234,8 @@ def test_fill_betweenx_input(y, x1, x2):
         ax.fill_betweenx(y, x1, x2)
 
 
-@image_comparison(['fill_between_interpolate'], remove_text=True)
+@image_comparison(['fill_between_interpolate'], remove_text=True,
+                  tol=0.012 if platform.machine() == 'arm64' else 0)
 def test_fill_between_interpolate():
     x = np.arange(0.0, 2, 0.02)
     y1 = np.sin(2*np.pi*x)
@@ -1623,7 +1626,7 @@ def test_pcolorauto(fig_test, fig_ref, snap):
     ax.pcolormesh(x2, y2, Z, snap=snap)
 
 
-@image_comparison(['canonical'])
+@image_comparison(['canonical'], tol=0.02 if platform.machine() == 'arm64' else 0)
 def test_canonical():
     fig, ax = plt.subplots()
     ax.plot([1, 2, 3])
@@ -3065,7 +3068,8 @@ def test_log_scales_invalid():
         ax.set_ylim(-1, 10)
 
 
-@image_comparison(['stackplot_test_image', 'stackplot_test_image'])
+@image_comparison(['stackplot_test_image', 'stackplot_test_image'],
+                  tol=0.031 if platform.machine() == 'arm64' else 0)
 def test_stackplot():
     fig = plt.figure()
     x = np.linspace(0, 10, 10)
@@ -4873,7 +4877,8 @@ def test_marker_styles():
                 marker=marker, markersize=10+y/5, label=marker)
 
 
-@image_comparison(['rc_markerfill.png'])
+@image_comparison(['rc_markerfill.png'],
+                  tol=0.037 if platform.machine() == 'arm64' else 0)
 def test_markers_fillstyle_rcparams():
     fig, ax = plt.subplots()
     x = np.arange(7)
@@ -4896,7 +4901,7 @@ def test_vertex_markers():
 
 
 @image_comparison(['vline_hline_zorder', 'errorbar_zorder'],
-                  tol=0 if platform.machine() == 'x86_64' else 0.02)
+                  tol=0 if platform.machine() == 'x86_64' else 0.026)
 def test_eb_line_zorder():
     x = list(range(10))
 
@@ -5455,7 +5460,8 @@ def test_twin_remove(fig_test, fig_ref):
     ax_ref.yaxis.tick_left()
 
 
-@image_comparison(['twin_spines.png'], remove_text=True)
+@image_comparison(['twin_spines.png'], remove_text=True,
+                  tol=0.022 if platform.machine() == 'arm64' else 0)
 def test_twin_spines():
 
     def make_patch_spines_invisible(ax):
@@ -5822,7 +5828,7 @@ def test_pie_linewidth_0():
     plt.axis('equal')
 
 
-@image_comparison(['pie_center_radius.png'], style='mpl20', tol=0.005)
+@image_comparison(['pie_center_radius.png'], style='mpl20', tol=0.007)
 def test_pie_center_radius():
     # The slices will be ordered and plotted counter-clockwise.
     labels = 'Frogs', 'Hogs', 'Dogs', 'Logs'
@@ -6008,7 +6014,8 @@ def test_pie_hatch_multi(fig_test, fig_ref):
     [w.set_hatch(hp) for w, hp in zip(wedges, hatch)]
 
 
-@image_comparison(['set_get_ticklabels.png'])
+@image_comparison(['set_get_ticklabels.png'],
+                  tol=0.025 if platform.machine() == 'arm64' else 0)
 def test_set_get_ticklabels():
     # test issue 2246
     fig, ax = plt.subplots(2)
@@ -6579,7 +6586,8 @@ def test_loglog():
     ax.tick_params(length=15, width=2, which='minor')
 
 
-@image_comparison(["test_loglog_nonpos.png"], remove_text=True, style='mpl20')
+@image_comparison(["test_loglog_nonpos.png"], remove_text=True, style='mpl20',
+                  tol=0.029 if platform.machine() == 'arm64' else 0)
 def test_loglog_nonpos():
     fig, axs = plt.subplots(3, 3)
     x = np.arange(1, 11)
@@ -7505,8 +7513,8 @@ def test_scatter_empty_data():
     plt.scatter([], [], s=[], c=[])
 
 
-@image_comparison(['annotate_across_transforms.png'],
-                  style='mpl20', remove_text=True)
+@image_comparison(['annotate_across_transforms.png'], style='mpl20', remove_text=True,
+                  tol=0.025 if platform.machine() == 'arm64' else 0)
 def test_annotate_across_transforms():
     x = np.linspace(0, 10, 200)
     y = np.exp(-x) * np.sin(x)
@@ -7536,7 +7544,8 @@ def inverted(self):
         return _Translation(-self.dx)
 
 
-@image_comparison(['secondary_xy.png'], style='mpl20')
+@image_comparison(['secondary_xy.png'], style='mpl20',
+                  tol=0.027 if platform.machine() == 'arm64' else 0)
 def test_secondary_xy():
     fig, axs = plt.subplots(1, 2, figsize=(10, 5), constrained_layout=True)
 
@@ -8799,7 +8808,8 @@ def test_zorder_and_explicit_rasterization():
         fig.savefig(b, format='pdf')
 
 
-@image_comparison(["preset_clip_paths.png"], remove_text=True, style="mpl20")
+@image_comparison(["preset_clip_paths.png"], remove_text=True, style="mpl20",
+                  tol=0.027 if platform.machine() == "arm64" else 0)
 def test_preset_clip_paths():
     fig, ax = plt.subplots()
 
diff --git a/lib/matplotlib/tests/test_bbox_tight.py b/lib/matplotlib/tests/test_bbox_tight.py
index b191ee90a4f8..5f2b397b650d 100644
--- a/lib/matplotlib/tests/test_bbox_tight.py
+++ b/lib/matplotlib/tests/test_bbox_tight.py
@@ -1,4 +1,5 @@
 from io import BytesIO
+import platform
 
 import numpy as np
 
@@ -43,7 +44,8 @@ def test_bbox_inches_tight():
 
 
 @image_comparison(['bbox_inches_tight_suptile_legend'],
-                  savefig_kwarg={'bbox_inches': 'tight'})
+                  savefig_kwarg={'bbox_inches': 'tight'},
+                  tol=0.02 if platform.machine() == 'arm64' else 0)
 def test_bbox_inches_tight_suptile_legend():
     plt.plot(np.arange(10), label='a straight line')
     plt.legend(bbox_to_anchor=(0.9, 1), loc='upper left')
diff --git a/lib/matplotlib/tests/test_collections.py b/lib/matplotlib/tests/test_collections.py
index 5baaeaa5d388..0984403b3f13 100644
--- a/lib/matplotlib/tests/test_collections.py
+++ b/lib/matplotlib/tests/test_collections.py
@@ -1,6 +1,7 @@
 from datetime import datetime
 import io
 import itertools
+import platform
 import re
 from types import SimpleNamespace
 
@@ -388,7 +389,8 @@ def test_barb_limits():
                               decimal=1)
 
 
-@image_comparison(['EllipseCollection_test_image.png'], remove_text=True)
+@image_comparison(['EllipseCollection_test_image.png'], remove_text=True,
+                  tol=0.021 if platform.machine() == 'arm64' else 0)
 def test_EllipseCollection():
     # Test basic functionality
     fig, ax = plt.subplots()
diff --git a/lib/matplotlib/tests/test_colorbar.py b/lib/matplotlib/tests/test_colorbar.py
index 74742d8c2369..35911afc7952 100644
--- a/lib/matplotlib/tests/test_colorbar.py
+++ b/lib/matplotlib/tests/test_colorbar.py
@@ -234,9 +234,8 @@ def test_colorbar_single_ax_panchor_east(constrained):
     assert ax.get_anchor() == 'E'
 
 
-@image_comparison(
-    ['contour_colorbar.png'], remove_text=True,
-    tol=0.01 if platform.machine() in ('aarch64', 'ppc64le', 's390x') else 0)
+@image_comparison(['contour_colorbar.png'], remove_text=True,
+                  tol=0 if platform.machine() == 'x86_64' else 0.054)
 def test_contour_colorbar():
     fig, ax = plt.subplots(figsize=(4, 2))
     data = np.arange(1200).reshape(30, 40) - 500
diff --git a/lib/matplotlib/tests/test_constrainedlayout.py b/lib/matplotlib/tests/test_constrainedlayout.py
index 4bcc1bdf75c6..4dc4d9501ec1 100644
--- a/lib/matplotlib/tests/test_constrainedlayout.py
+++ b/lib/matplotlib/tests/test_constrainedlayout.py
@@ -1,4 +1,6 @@
 import gc
+import platform
+
 import numpy as np
 import pytest
 
@@ -195,7 +197,8 @@ def test_constrained_layout9():
     fig.suptitle('Test Suptitle', fontsize=28)
 
 
-@image_comparison(['constrained_layout10.png'])
+@image_comparison(['constrained_layout10.png'],
+                  tol=0.032 if platform.machine() == 'arm64' else 0)
 def test_constrained_layout10():
     """Test for handling legend outside axis"""
     fig, axs = plt.subplots(2, 2, layout="constrained")
diff --git a/lib/matplotlib/tests/test_contour.py b/lib/matplotlib/tests/test_contour.py
index f79584be4086..d4600a14fe1c 100644
--- a/lib/matplotlib/tests/test_contour.py
+++ b/lib/matplotlib/tests/test_contour.py
@@ -164,7 +164,8 @@ def test_contour_label_with_disconnected_segments(split_collections):
 
 
 @pytest.mark.parametrize("split_collections", [False, True])
-@image_comparison(['contour_manual_colors_and_levels.png'], remove_text=True)
+@image_comparison(['contour_manual_colors_and_levels.png'], remove_text=True,
+                  tol=0.018 if platform.machine() == 'arm64' else 0)
 def test_given_colors_levels_and_extends(split_collections):
     # Remove this line when this test image is regenerated.
     plt.rcParams['pcolormesh.snap'] = False
diff --git a/lib/matplotlib/tests/test_figure.py b/lib/matplotlib/tests/test_figure.py
index c3d177425723..8ee6aae99361 100644
--- a/lib/matplotlib/tests/test_figure.py
+++ b/lib/matplotlib/tests/test_figure.py
@@ -160,7 +160,8 @@ def test_clf_keyword():
     assert [t.get_text() for t in fig2.texts] == []
 
 
-@image_comparison(['figure_today'])
+@image_comparison(['figure_today'],
+                  tol=0.015 if platform.machine() == 'arm64' else 0)
 def test_figure():
     # named figure support
     fig = plt.figure('today')
diff --git a/lib/matplotlib/tests/test_image.py b/lib/matplotlib/tests/test_image.py
index 232790a68ebb..fdbba7299d2b 100644
--- a/lib/matplotlib/tests/test_image.py
+++ b/lib/matplotlib/tests/test_image.py
@@ -1408,7 +1408,7 @@ def test_nonuniform_and_pcolor():
 
 @image_comparison(
     ['rgba_antialias.png'], style='mpl20', remove_text=True,
-    tol=0.007 if platform.machine() in ('aarch64', 'ppc64le', 's390x') else 0)
+    tol=0 if platform.machine() == 'x86_64' else 0.007)
 def test_rgba_antialias():
     fig, axs = plt.subplots(2, 2, figsize=(3.5, 3.5), sharex=False,
                             sharey=False, constrained_layout=True)
diff --git a/lib/matplotlib/tests/test_legend.py b/lib/matplotlib/tests/test_legend.py
index 9b7a6dfd10c9..0353f1408b73 100644
--- a/lib/matplotlib/tests/test_legend.py
+++ b/lib/matplotlib/tests/test_legend.py
@@ -151,7 +151,8 @@ def test_legend_label_with_leading_underscore():
     assert len(legend.legend_handles) == 0
 
 
-@image_comparison(['legend_labels_first.png'], remove_text=True)
+@image_comparison(['legend_labels_first.png'], remove_text=True,
+                  tol=0.013 if platform.machine() == 'arm64' else 0)
 def test_labels_first():
     # test labels to left of markers
     fig, ax = plt.subplots()
@@ -161,7 +162,8 @@ def test_labels_first():
     ax.legend(loc='best', markerfirst=False)
 
 
-@image_comparison(['legend_multiple_keys.png'], remove_text=True)
+@image_comparison(['legend_multiple_keys.png'], remove_text=True,
+                  tol=0.013 if platform.machine() == 'arm64' else 0)
 def test_multiple_keys():
     # test legend entries with multiple keys
     fig, ax = plt.subplots()
@@ -175,7 +177,7 @@ def test_multiple_keys():
 
 
 @image_comparison(['rgba_alpha.png'], remove_text=True,
-                  tol=0 if platform.machine() == 'x86_64' else 0.01)
+                  tol=0 if platform.machine() == 'x86_64' else 0.03)
 def test_alpha_rgba():
     fig, ax = plt.subplots()
     ax.plot(range(10), lw=5)
@@ -184,7 +186,7 @@ def test_alpha_rgba():
 
 
 @image_comparison(['rcparam_alpha.png'], remove_text=True,
-                  tol=0 if platform.machine() == 'x86_64' else 0.01)
+                  tol=0 if platform.machine() == 'x86_64' else 0.03)
 def test_alpha_rcparam():
     fig, ax = plt.subplots()
     ax.plot(range(10), lw=5)
@@ -212,7 +214,7 @@ def test_fancy():
 
 
 @image_comparison(['framealpha'], remove_text=True,
-                  tol=0 if platform.machine() == 'x86_64' else 0.02)
+                  tol=0 if platform.machine() == 'x86_64' else 0.024)
 def test_framealpha():
     x = np.linspace(1, 100, 100)
     y = x
@@ -523,7 +525,8 @@ def test_figure_legend_outside():
                         legbb[nn])
 
 
-@image_comparison(['legend_stackplot.png'])
+@image_comparison(['legend_stackplot.png'],
+                  tol=0.031 if platform.machine() == 'arm64' else 0)
 def test_legend_stackplot():
     """Test legend for PolyCollection using stackplot."""
     # related to #1341, #1943, and PR #3303
@@ -658,8 +661,8 @@ def test_empty_bar_chart_with_legend():
     plt.legend()
 
 
-@image_comparison(['shadow_argument_types.png'], remove_text=True,
-                  style='mpl20')
+@image_comparison(['shadow_argument_types.png'], remove_text=True, style='mpl20',
+                  tol=0.028 if platform.machine() == 'arm64' else 0)
 def test_shadow_argument_types():
     # Test that different arguments for shadow work as expected
     fig, ax = plt.subplots()
diff --git a/lib/matplotlib/tests/test_lines.py b/lib/matplotlib/tests/test_lines.py
index 80261b0ddb19..c7b7353fa0db 100644
--- a/lib/matplotlib/tests/test_lines.py
+++ b/lib/matplotlib/tests/test_lines.py
@@ -98,7 +98,7 @@ def test_invalid_line_data():
         line.set_ydata(0)
 
 
-@image_comparison(['line_dashes'], remove_text=True, tol=0.002)
+@image_comparison(['line_dashes'], remove_text=True, tol=0.003)
 def test_line_dashes():
     # Tolerance introduced after reordering of floating-point operations
     # Remove when regenerating the images
@@ -139,7 +139,8 @@ def test_valid_linestyles():
         line.set_linestyle('aardvark')
 
 
-@image_comparison(['drawstyle_variants.png'], remove_text=True)
+@image_comparison(['drawstyle_variants.png'], remove_text=True,
+                  tol=0.03 if platform.machine() == 'arm64' else 0)
 def test_drawstyle_variants():
     fig, axs = plt.subplots(6)
     dss = ["default", "steps-mid", "steps-pre", "steps-post", "steps", None]
diff --git a/lib/matplotlib/tests/test_patches.py b/lib/matplotlib/tests/test_patches.py
index 9530bcd19130..3544ce8cb10c 100644
--- a/lib/matplotlib/tests/test_patches.py
+++ b/lib/matplotlib/tests/test_patches.py
@@ -1,6 +1,8 @@
 """
 Tests specific to the patches module.
 """
+import platform
+
 import numpy as np
 from numpy.testing import assert_almost_equal, assert_array_equal
 import pytest
@@ -15,9 +17,6 @@
     collections as mcollections, colors as mcolors, patches as mpatches,
     path as mpath, transforms as mtransforms, rcParams)
 
-import sys
-on_win = (sys.platform == 'win32')
-
 
 def test_Polygon_close():
     #: GitHub issue #1018 identified a bug in the Polygon handling
@@ -438,8 +437,8 @@ def test_wedge_movement():
         assert getattr(w, attr) == new_v
 
 
-# png needs tol>=0.06, pdf tol>=1.617
-@image_comparison(['wedge_range'], remove_text=True, tol=1.65 if on_win else 0)
+@image_comparison(['wedge_range'], remove_text=True,
+                  tol=0.009 if platform.machine() == 'arm64' else 0)
 def test_wedge_range():
     ax = plt.axes()
 
@@ -564,7 +563,8 @@ def test_units_rectangle():
     ax.set_ylim([5*U.km, 9*U.km])
 
 
-@image_comparison(['connection_patch.png'], style='mpl20', remove_text=True)
+@image_comparison(['connection_patch.png'], style='mpl20', remove_text=True,
+                  tol=0.024 if platform.machine() == 'arm64' else 0)
 def test_connection_patch():
     fig, (ax1, ax2) = plt.subplots(1, 2)
 
diff --git a/lib/matplotlib/tests/test_path.py b/lib/matplotlib/tests/test_path.py
index 8c0c32dc133b..2c4df6ea3b39 100644
--- a/lib/matplotlib/tests/test_path.py
+++ b/lib/matplotlib/tests/test_path.py
@@ -1,3 +1,4 @@
+import platform
 import re
 
 import numpy as np
@@ -149,8 +150,8 @@ def test_nonlinear_containment():
         ax.transData.transform((50, .5)), polygon.get_transform())
 
 
-@image_comparison(['arrow_contains_point.png'],
-                  remove_text=True, style='mpl20')
+@image_comparison(['arrow_contains_point.png'], remove_text=True, style='mpl20',
+                  tol=0.027 if platform.machine() == 'arm64' else 0)
 def test_arrow_contains_point():
     # fix bug (#8384)
     fig, ax = plt.subplots()
@@ -281,7 +282,8 @@ def test_marker_paths_pdf():
 
 
 @image_comparison(['nan_path'], style='default', remove_text=True,
-                  extensions=['pdf', 'svg', 'eps', 'png'])
+                  extensions=['pdf', 'svg', 'eps', 'png'],
+                  tol=0.009 if platform.machine() == 'arm64' else 0)
 def test_nan_isolated_points():
 
     y0 = [0, np.nan, 2, np.nan, 4, 5, 6]
diff --git a/lib/matplotlib/tests/test_patheffects.py b/lib/matplotlib/tests/test_patheffects.py
index b86cca548854..7c4c82751240 100644
--- a/lib/matplotlib/tests/test_patheffects.py
+++ b/lib/matplotlib/tests/test_patheffects.py
@@ -1,3 +1,5 @@
+import platform
+
 import numpy as np
 
 from matplotlib.testing.decorators import image_comparison
@@ -27,7 +29,8 @@ def test_patheffect1():
     ax1.grid(True, linestyle="-", path_effects=pe)
 
 
-@image_comparison(['patheffect2'], remove_text=True, style='mpl20')
+@image_comparison(['patheffect2'], remove_text=True, style='mpl20',
+                  tol=0.052 if platform.machine() == 'arm64' else 0)
 def test_patheffect2():
 
     ax2 = plt.subplot()
@@ -42,7 +45,7 @@ def test_patheffect2():
                                                    foreground="w")])
 
 
-@image_comparison(['patheffect3'])
+@image_comparison(['patheffect3'], tol=0.019 if platform.machine() == 'arm64' else 0)
 def test_patheffect3():
     p1, = plt.plot([1, 3, 5, 4, 3], 'o-b', lw=4)
     p1.set_path_effects([path_effects.SimpleLineShadow(),
diff --git a/lib/matplotlib/tests/test_polar.py b/lib/matplotlib/tests/test_polar.py
index ad1540a36621..6b3c08d2eb3f 100644
--- a/lib/matplotlib/tests/test_polar.py
+++ b/lib/matplotlib/tests/test_polar.py
@@ -42,7 +42,7 @@ def test_polar_annotations():
 
 
 @image_comparison(['polar_coords'], style='default', remove_text=True,
-                  tol=0.012)
+                  tol=0.014)
 def test_polar_coord_annotations():
     # You can also use polar notation on a cartesian axes.  Here the native
     # coordinate system ('data') is cartesian, so you need to specify the
diff --git a/lib/matplotlib/tests/test_simplification.py b/lib/matplotlib/tests/test_simplification.py
index 446fc92993e7..0a5c215eff30 100644
--- a/lib/matplotlib/tests/test_simplification.py
+++ b/lib/matplotlib/tests/test_simplification.py
@@ -1,5 +1,6 @@
 import base64
 import io
+import platform
 
 import numpy as np
 from numpy.testing import assert_array_almost_equal, assert_array_equal
@@ -27,7 +28,8 @@ def test_clipping():
     ax.set_ylim((-0.20, -0.28))
 
 
-@image_comparison(['overflow'], remove_text=True)
+@image_comparison(['overflow'], remove_text=True,
+                  tol=0.007 if platform.machine() == 'arm64' else 0)
 def test_overflow():
     x = np.array([1.0, 2.0, 3.0, 2.0e5])
     y = np.arange(len(x))
diff --git a/lib/matplotlib/tests/test_skew.py b/lib/matplotlib/tests/test_skew.py
index 5760d6654ad7..fd7e7cebfacb 100644
--- a/lib/matplotlib/tests/test_skew.py
+++ b/lib/matplotlib/tests/test_skew.py
@@ -4,6 +4,7 @@
 
 from contextlib import ExitStack
 import itertools
+import platform
 
 import matplotlib.pyplot as plt
 from matplotlib.testing.decorators import image_comparison
@@ -144,7 +145,8 @@ def test_set_line_coll_dash_image():
     ax.axvline(0, color='b')
 
 
-@image_comparison(['skew_rects'], remove_text=True)
+@image_comparison(['skew_rects'], remove_text=True,
+                  tol=0.009 if platform.machine() == 'arm64' else 0)
 def test_skew_rectangle():
 
     fix, axes = plt.subplots(5, 5, sharex=True, sharey=True, figsize=(8, 8))
diff --git a/lib/matplotlib/tests/test_streamplot.py b/lib/matplotlib/tests/test_streamplot.py
index 10a64f1d6968..ed8b77d7996d 100644
--- a/lib/matplotlib/tests/test_streamplot.py
+++ b/lib/matplotlib/tests/test_streamplot.py
@@ -44,7 +44,7 @@ def test_colormap():
 
 
 @image_comparison(['streamplot_linewidth'], remove_text=True, style='mpl20',
-                  tol=0.002)
+                  tol=0.004)
 def test_linewidth():
     X, Y, U, V = velocity_field()
     speed = np.hypot(U, V)
diff --git a/lib/matplotlib/tests/test_subplots.py b/lib/matplotlib/tests/test_subplots.py
index cf5f4b902e24..70215c9531ba 100644
--- a/lib/matplotlib/tests/test_subplots.py
+++ b/lib/matplotlib/tests/test_subplots.py
@@ -1,4 +1,5 @@
 import itertools
+import platform
 
 import numpy as np
 import pytest
@@ -173,7 +174,8 @@ def test_exceptions():
         plt.subplots(2, 2, sharey='blah')
 
 
-@image_comparison(['subplots_offset_text'])
+@image_comparison(['subplots_offset_text'],
+                  tol=0.028 if platform.machine() == 'arm64' else 0)
 def test_subplots_offsettext():
     x = np.arange(0, 1e10, 1e9)
     y = np.arange(0, 100, 10)+1e4
diff --git a/lib/matplotlib/tests/test_units.py b/lib/matplotlib/tests/test_units.py
index a5fd32dfb3e5..ae6372fea1e1 100644
--- a/lib/matplotlib/tests/test_units.py
+++ b/lib/matplotlib/tests/test_units.py
@@ -79,7 +79,7 @@ def default_units(value, axis):
 # Tests that the conversion machinery works properly for classes that
 # work as a facade over numpy arrays (like pint)
 @image_comparison(['plot_pint.png'], style='mpl20',
-                  tol=0 if platform.machine() == 'x86_64' else 0.01)
+                  tol=0 if platform.machine() == 'x86_64' else 0.03)
 def test_numpy_facade(quantity_converter):
     # use former defaults to match existing baseline image
     plt.rcParams['axes.formatter.limits'] = -7, 7
@@ -106,7 +106,7 @@ def test_numpy_facade(quantity_converter):
 
 # Tests gh-8908
 @image_comparison(['plot_masked_units.png'], remove_text=True, style='mpl20',
-                  tol=0 if platform.machine() == 'x86_64' else 0.01)
+                  tol=0 if platform.machine() == 'x86_64' else 0.02)
 def test_plot_masked_units():
     data = np.linspace(-5, 5)
     data_masked = np.ma.array(data, mask=(data > -2) & (data < 2))
diff --git a/lib/mpl_toolkits/axes_grid1/tests/test_axes_grid1.py b/lib/mpl_toolkits/axes_grid1/tests/test_axes_grid1.py
index 56f07c026b97..7c444f6ae178 100644
--- a/lib/mpl_toolkits/axes_grid1/tests/test_axes_grid1.py
+++ b/lib/mpl_toolkits/axes_grid1/tests/test_axes_grid1.py
@@ -346,7 +346,8 @@ def test_fill_facecolor():
 
 # Update style when regenerating the test image
 @image_comparison(['zoomed_axes.png', 'inverted_zoomed_axes.png'],
-                  style=('classic', '_classic_test_patch'))
+                  style=('classic', '_classic_test_patch'),
+                  tol=0.02 if platform.machine() == 'arm64' else 0)
 def test_zooming_with_inverted_axes():
     fig, ax = plt.subplots()
     ax.plot([1, 2, 3], [1, 2, 3])
diff --git a/lib/mpl_toolkits/axisartist/tests/test_grid_helper_curvelinear.py b/lib/mpl_toolkits/axisartist/tests/test_grid_helper_curvelinear.py
index 8e6aded047fe..1b266044bdd0 100644
--- a/lib/mpl_toolkits/axisartist/tests/test_grid_helper_curvelinear.py
+++ b/lib/mpl_toolkits/axisartist/tests/test_grid_helper_curvelinear.py
@@ -76,7 +76,7 @@ def inverted(self):
     ax1.grid(True)
 
 
-@image_comparison(['polar_box.png'], style='default', tol=0.02)
+@image_comparison(['polar_box.png'], style='default', tol=0.04)
 def test_polar_box():
     fig = plt.figure(figsize=(5, 5))
 
@@ -137,7 +137,7 @@ def test_polar_box():
 
 
 # Remove tol & kerning_factor when this test image is regenerated.
-@image_comparison(['axis_direction.png'], style='default', tol=0.12)
+@image_comparison(['axis_direction.png'], style='default', tol=0.13)
 def test_axis_direction():
     plt.rcParams['text.kerning_factor'] = 6
 
diff --git a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
index 2b7bfc117f88..7662509dd9cf 100644
--- a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
@@ -581,7 +581,7 @@ def test_marker_draw_order_view_rotated(fig_test, fig_ref):
     ax.view_init(elev=0, azim=azim - 180, roll=0)  # view rotated by 180 deg
 
 
-@mpl3d_image_comparison(['plot_3d_from_2d.png'], tol=0.015, style='mpl20')
+@mpl3d_image_comparison(['plot_3d_from_2d.png'], tol=0.019, style='mpl20')
 def test_plot_3d_from_2d():
     fig = plt.figure()
     ax = fig.add_subplot(projection='3d')
@@ -1588,7 +1588,8 @@ def test_errorbar3d_errorevery():
                 errorevery=estep)
 
 
-@mpl3d_image_comparison(['errorbar3d.png'], style='mpl20')
+@mpl3d_image_comparison(['errorbar3d.png'], style='mpl20',
+                        tol=0.014 if platform.machine() == 'arm64' else 0)
 def test_errorbar3d():
     """Tests limits, color styling, and legend for 3D errorbars."""
     fig = plt.figure()
@@ -1604,7 +1605,7 @@ def test_errorbar3d():
     ax.legend()
 
 
-@image_comparison(['stem3d.png'], style='mpl20', tol=0.003)
+@image_comparison(['stem3d.png'], style='mpl20', tol=0.008)
 def test_stem3d():
     plt.rcParams['axes3d.automargin'] = True  # Remove when image is regenerated
     fig, axs = plt.subplots(2, 3, figsize=(8, 6),
diff --git a/lib/mpl_toolkits/mplot3d/tests/test_legend3d.py b/lib/mpl_toolkits/mplot3d/tests/test_legend3d.py
index fe0e99b8ad8c..0935bbe7f6b0 100644
--- a/lib/mpl_toolkits/mplot3d/tests/test_legend3d.py
+++ b/lib/mpl_toolkits/mplot3d/tests/test_legend3d.py
@@ -1,3 +1,5 @@
+import platform
+
 import numpy as np
 
 import matplotlib as mpl
@@ -7,8 +9,7 @@
 from mpl_toolkits.mplot3d import art3d
 
 
-# Update style when regenerating the test image
-@image_comparison(['legend_plot.png'], remove_text=True, style=('mpl20'))
+@image_comparison(['legend_plot.png'], remove_text=True, style='mpl20')
 def test_legend_plot():
     fig, ax = plt.subplots(subplot_kw=dict(projection='3d'))
     x = np.arange(10)
@@ -17,8 +18,7 @@ def test_legend_plot():
     ax.legend()
 
 
-# Update style when regenerating the test image
-@image_comparison(['legend_bar.png'], remove_text=True, style=('mpl20'))
+@image_comparison(['legend_bar.png'], remove_text=True, style='mpl20')
 def test_legend_bar():
     fig, ax = plt.subplots(subplot_kw=dict(projection='3d'))
     x = np.arange(10)
@@ -27,8 +27,8 @@ def test_legend_bar():
     ax.legend([b1[0], b2[0]], ['up', 'down'])
 
 
-# Update style when regenerating the test image
-@image_comparison(['fancy.png'], remove_text=True, style=('mpl20'))
+@image_comparison(['fancy.png'], remove_text=True, style='mpl20',
+                  tol=0.011 if platform.machine() == 'arm64' else 0)
 def test_fancy():
     fig, ax = plt.subplots(subplot_kw=dict(projection='3d'))
     ax.plot(np.arange(10), np.full(10, 5), np.full(10, 5), 'o--', label='line')

From e793b22773ef3bd64d54bb9729cf5474d462f0d4 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 27 Mar 2024 16:59:46 -0400
Subject: [PATCH 0903/1120] ci: Add Ghostscript and Inkscape to macOS runs

---
 .github/workflows/tests.yml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 61355ae7dbdf..1cead94098a8 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -161,7 +161,8 @@ jobs:
           macOS)
             brew install ccache
             brew tap homebrew/cask-fonts
-            brew install font-noto-sans-cjk gobject-introspection gtk4 ninja
+            brew install font-noto-sans-cjk ghostscript gobject-introspection gtk4 ninja
+            brew install --cask inkscape
             ;;
           esac
 

From effefafcb95d9140ab1c692b938ba09fdab4719d Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 27 Mar 2024 18:49:31 -0400
Subject: [PATCH 0904/1120] TST: Re-generate SVG files that use fonttype='none'

We currently special-case the SVG converter depending on if it used
fonttype='none', and use one that has our base fonts available. However,
this is not based on the rcParam setting (because we don't have that at
conversion time), but on whether the SVG text contains the font styling
[1]. This check for styling uses the _current_ version, which was
changed way back in #19253.

These files were never re-generated though, and used the old version of
the style, meaning the expected images never triggered the special
converter. The result images are written with the current style, and
_do_ trigger the special conveter.

Evidentally, this never was a problem for most developers, because
everyone had DejaVu Sans installed globally, so the expected images
matched. However, on the clean macOS CI, it's not installed globally, so
the expected images get converted with the wrong font, and the test
fails.

[1] https://github.com/matplotlib/matplotlib/blob/de1102668dbc0694e98653bd17641e9d99394e57/lib/matplotlib/testing/compare.py#L303
---
 lib/matplotlib/backends/backend_svg.py        |   5 +
 lib/matplotlib/testing/compare.py             |   5 +
 .../bold_font_output_with_none_fonttype.svg   | 183 ++++++++++--------
 .../test_text/text_as_text_opacity.svg        |  29 ++-
 4 files changed, 127 insertions(+), 95 deletions(-)

diff --git a/lib/matplotlib/backends/backend_svg.py b/lib/matplotlib/backends/backend_svg.py
index d454a5b2fdb9..72354b81862b 100644
--- a/lib/matplotlib/backends/backend_svg.py
+++ b/lib/matplotlib/backends/backend_svg.py
@@ -1085,6 +1085,11 @@ def _draw_text_as_path(self, gc, x, y, s, prop, angle, ismath, mtext=None):
         writer.end('g')
 
     def _draw_text_as_text(self, gc, x, y, s, prop, angle, ismath, mtext=None):
+        # NOTE: If you change the font styling CSS, then be sure the check for
+        # svg.fonttype = none in `lib/matplotlib/testing/compare.py::convert` remains in
+        # sync. Also be sure to re-generate any SVG using this mode, or else such tests
+        # will fail to use the right converter for the expected images, and they will
+        # fail strangely.
         writer = self.writer
 
         color = rgb2hex(gc.get_rgb())
diff --git a/lib/matplotlib/testing/compare.py b/lib/matplotlib/testing/compare.py
index 655765b3aca3..ee93061480e7 100644
--- a/lib/matplotlib/testing/compare.py
+++ b/lib/matplotlib/testing/compare.py
@@ -300,6 +300,11 @@ def convert(filename, cache):
         convert = converter[path.suffix[1:]]
         if path.suffix == ".svg":
             contents = path.read_text()
+            # NOTE: This check should be kept in sync with font styling in
+            # `lib/matplotlib/backends/backend_svg.py`. If it changes, then be sure to
+            # re-generate any SVG test files using this mode, or else such tests will
+            # fail to use the converter for the expected images (but will for the
+            # results), and the tests will fail strangely.
             if 'style="font:' in contents:
                 # for svg.fonttype = none, we explicitly patch the font search
                 # path so that fonts shipped by Matplotlib are found.
diff --git a/lib/matplotlib/tests/baseline_images/test_backend_svg/bold_font_output_with_none_fonttype.svg b/lib/matplotlib/tests/baseline_images/test_backend_svg/bold_font_output_with_none_fonttype.svg
index af3d2e7a8f3c..9fe5ce39b941 100644
--- a/lib/matplotlib/tests/baseline_images/test_backend_svg/bold_font_output_with_none_fonttype.svg
+++ b/lib/matplotlib/tests/baseline_images/test_backend_svg/bold_font_output_with_none_fonttype.svg
@@ -1,12 +1,23 @@
 <?xml version="1.0" encoding="utf-8" standalone="no"?>
 <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN"
   "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
-<!-- Created with matplotlib (http://matplotlib.org/) -->
-<svg height="432pt" version="1.1" viewBox="0 0 576 432" width="576pt" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+<svg xmlns:xlink="http://www.w3.org/1999/xlink" width="576pt" height="432pt" viewBox="0 0 576 432" xmlns="http://www.w3.org/2000/svg" version="1.1">
+ <metadata>
+  <rdf:RDF xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:cc="http://creativecommons.org/ns#" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">
+   <cc:Work>
+    <dc:type rdf:resource="http://purl.org/dc/dcmitype/StillImage"/>
+    <dc:date>2024-03-27T18:41:46.786798</dc:date>
+    <dc:format>image/svg+xml</dc:format>
+    <dc:creator>
+     <cc:Agent>
+      <dc:title>Matplotlib v3.9.0.dev1430+g883dca40e7, https://matplotlib.org/</dc:title>
+     </cc:Agent>
+    </dc:creator>
+   </cc:Work>
+  </rdf:RDF>
+ </metadata>
  <defs>
-  <style type="text/css">
-*{stroke-linecap:butt;stroke-linejoin:round;}
-  </style>
+  <style type="text/css">*{stroke-linejoin: round; stroke-linecap: butt}</style>
  </defs>
  <g id="figure_1">
   <g id="patch_1">
@@ -15,7 +26,7 @@ L 576 432
 L 576 0
 L 0 0
 z
-" style="fill:#ffffff;"/>
+" style="fill: #ffffff"/>
   </g>
   <g id="axes_1">
    <g id="patch_2">
@@ -24,10 +35,10 @@ L 518.4 388.8
 L 518.4 43.2
 L 72 43.2
 z
-" style="fill:#ffffff;"/>
+" style="fill: #ffffff"/>
    </g>
    <g id="line2d_1">
-    <path clip-path="url(#pce7a3954ac)" d="M 72 388.8
+    <path d="M 72 388.8
 L 121.6 350.4
 L 171.2 312
 L 220.8 273.6
@@ -37,366 +48,366 @@ L 369.6 158.4
 L 419.2 120
 L 468.8 81.6
 L 518.4 43.2
-" style="fill:none;stroke:#0000ff;stroke-linecap:square;"/>
+" clip-path="url(#pcfdea541ed)" style="fill: none; stroke: #0000ff; stroke-linecap: square"/>
    </g>
    <g id="patch_3">
     <path d="M 72 388.8
 L 72 43.2
-" style="fill:none;stroke:#000000;stroke-linecap:square;stroke-linejoin:miter;"/>
+" style="fill: none; stroke: #000000; stroke-linejoin: miter; stroke-linecap: square"/>
    </g>
    <g id="patch_4">
     <path d="M 518.4 388.8
 L 518.4 43.2
-" style="fill:none;stroke:#000000;stroke-linecap:square;stroke-linejoin:miter;"/>
+" style="fill: none; stroke: #000000; stroke-linejoin: miter; stroke-linecap: square"/>
    </g>
    <g id="patch_5">
     <path d="M 72 388.8
 L 518.4 388.8
-" style="fill:none;stroke:#000000;stroke-linecap:square;stroke-linejoin:miter;"/>
+" style="fill: none; stroke: #000000; stroke-linejoin: miter; stroke-linecap: square"/>
    </g>
    <g id="patch_6">
     <path d="M 72 43.2
 L 518.4 43.2
-" style="fill:none;stroke:#000000;stroke-linecap:square;stroke-linejoin:miter;"/>
+" style="fill: none; stroke: #000000; stroke-linejoin: miter; stroke-linecap: square"/>
    </g>
    <g id="matplotlib.axis_1">
     <g id="xtick_1">
      <g id="line2d_2">
       <defs>
-       <path d="M 0 0
+       <path id="m441ccbbe42" d="M 0 0
 L 0 -4
-" id="md5e7837e7e" style="stroke:#000000;stroke-width:0.5;"/>
+" style="stroke: #000000; stroke-width: 0.5"/>
       </defs>
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="72" xlink:href="#md5e7837e7e" y="388.8"/>
+       <use xlink:href="#m441ccbbe42" x="72" y="388.8" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="line2d_3">
       <defs>
-       <path d="M 0 0
+       <path id="mad5646bafe" d="M 0 0
 L 0 4
-" id="m5bbd032ef7" style="stroke:#000000;stroke-width:0.5;"/>
+" style="stroke: #000000; stroke-width: 0.5"/>
       </defs>
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="72" xlink:href="#m5bbd032ef7" y="43.2"/>
+       <use xlink:href="#mad5646bafe" x="72" y="43.2" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="text_1">
-      <text style="font-family:'DejaVu Sans';font-size:12px;font-style:normal;font-weight:400;text-anchor:middle;" transform="rotate(-0, 72, 401.918125)" x="72" y="401.918125">0</text>
+      <text style="font: 12px 'DejaVu Sans'; text-anchor: middle" x="72" y="401.918125" transform="rotate(-0 72 401.918125)">0</text>
      </g>
     </g>
     <g id="xtick_2">
      <g id="line2d_4">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="121.6" xlink:href="#md5e7837e7e" y="388.8"/>
+       <use xlink:href="#m441ccbbe42" x="121.6" y="388.8" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="line2d_5">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="121.6" xlink:href="#m5bbd032ef7" y="43.2"/>
+       <use xlink:href="#mad5646bafe" x="121.6" y="43.2" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="text_2">
-      <text style="font-family:'DejaVu Sans';font-size:12px;font-style:normal;font-weight:400;text-anchor:middle;" transform="rotate(-0, 121.6, 401.918125)" x="121.6" y="401.918125">1</text>
+      <text style="font: 12px 'DejaVu Sans'; text-anchor: middle" x="121.6" y="401.918125" transform="rotate(-0 121.6 401.918125)">1</text>
      </g>
     </g>
     <g id="xtick_3">
      <g id="line2d_6">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="171.2" xlink:href="#md5e7837e7e" y="388.8"/>
+       <use xlink:href="#m441ccbbe42" x="171.2" y="388.8" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="line2d_7">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="171.2" xlink:href="#m5bbd032ef7" y="43.2"/>
+       <use xlink:href="#mad5646bafe" x="171.2" y="43.2" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="text_3">
-      <text style="font-family:'DejaVu Sans';font-size:12px;font-style:normal;font-weight:400;text-anchor:middle;" transform="rotate(-0, 171.2, 401.918125)" x="171.2" y="401.918125">2</text>
+      <text style="font: 12px 'DejaVu Sans'; text-anchor: middle" x="171.2" y="401.918125" transform="rotate(-0 171.2 401.918125)">2</text>
      </g>
     </g>
     <g id="xtick_4">
      <g id="line2d_8">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="220.8" xlink:href="#md5e7837e7e" y="388.8"/>
+       <use xlink:href="#m441ccbbe42" x="220.8" y="388.8" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="line2d_9">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="220.8" xlink:href="#m5bbd032ef7" y="43.2"/>
+       <use xlink:href="#mad5646bafe" x="220.8" y="43.2" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="text_4">
-      <text style="font-family:'DejaVu Sans';font-size:12px;font-style:normal;font-weight:400;text-anchor:middle;" transform="rotate(-0, 220.8, 401.918125)" x="220.8" y="401.918125">3</text>
+      <text style="font: 12px 'DejaVu Sans'; text-anchor: middle" x="220.8" y="401.918125" transform="rotate(-0 220.8 401.918125)">3</text>
      </g>
     </g>
     <g id="xtick_5">
      <g id="line2d_10">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="270.4" xlink:href="#md5e7837e7e" y="388.8"/>
+       <use xlink:href="#m441ccbbe42" x="270.4" y="388.8" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="line2d_11">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="270.4" xlink:href="#m5bbd032ef7" y="43.2"/>
+       <use xlink:href="#mad5646bafe" x="270.4" y="43.2" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="text_5">
-      <text style="font-family:'DejaVu Sans';font-size:12px;font-style:normal;font-weight:400;text-anchor:middle;" transform="rotate(-0, 270.4, 401.918125)" x="270.4" y="401.918125">4</text>
+      <text style="font: 12px 'DejaVu Sans'; text-anchor: middle" x="270.4" y="401.918125" transform="rotate(-0 270.4 401.918125)">4</text>
      </g>
     </g>
     <g id="xtick_6">
      <g id="line2d_12">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="320" xlink:href="#md5e7837e7e" y="388.8"/>
+       <use xlink:href="#m441ccbbe42" x="320" y="388.8" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="line2d_13">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="320" xlink:href="#m5bbd032ef7" y="43.2"/>
+       <use xlink:href="#mad5646bafe" x="320" y="43.2" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="text_6">
-      <text style="font-family:'DejaVu Sans';font-size:12px;font-style:normal;font-weight:400;text-anchor:middle;" transform="rotate(-0, 320, 401.918125)" x="320" y="401.918125">5</text>
+      <text style="font: 12px 'DejaVu Sans'; text-anchor: middle" x="320" y="401.918125" transform="rotate(-0 320 401.918125)">5</text>
      </g>
     </g>
     <g id="xtick_7">
      <g id="line2d_14">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="369.6" xlink:href="#md5e7837e7e" y="388.8"/>
+       <use xlink:href="#m441ccbbe42" x="369.6" y="388.8" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="line2d_15">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="369.6" xlink:href="#m5bbd032ef7" y="43.2"/>
+       <use xlink:href="#mad5646bafe" x="369.6" y="43.2" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="text_7">
-      <text style="font-family:'DejaVu Sans';font-size:12px;font-style:normal;font-weight:400;text-anchor:middle;" transform="rotate(-0, 369.6, 401.918125)" x="369.6" y="401.918125">6</text>
+      <text style="font: 12px 'DejaVu Sans'; text-anchor: middle" x="369.6" y="401.918125" transform="rotate(-0 369.6 401.918125)">6</text>
      </g>
     </g>
     <g id="xtick_8">
      <g id="line2d_16">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="419.2" xlink:href="#md5e7837e7e" y="388.8"/>
+       <use xlink:href="#m441ccbbe42" x="419.2" y="388.8" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="line2d_17">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="419.2" xlink:href="#m5bbd032ef7" y="43.2"/>
+       <use xlink:href="#mad5646bafe" x="419.2" y="43.2" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="text_8">
-      <text style="font-family:'DejaVu Sans';font-size:12px;font-style:normal;font-weight:400;text-anchor:middle;" transform="rotate(-0, 419.2, 401.918125)" x="419.2" y="401.918125">7</text>
+      <text style="font: 12px 'DejaVu Sans'; text-anchor: middle" x="419.2" y="401.918125" transform="rotate(-0 419.2 401.918125)">7</text>
      </g>
     </g>
     <g id="xtick_9">
      <g id="line2d_18">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="468.8" xlink:href="#md5e7837e7e" y="388.8"/>
+       <use xlink:href="#m441ccbbe42" x="468.8" y="388.8" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="line2d_19">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="468.8" xlink:href="#m5bbd032ef7" y="43.2"/>
+       <use xlink:href="#mad5646bafe" x="468.8" y="43.2" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="text_9">
-      <text style="font-family:'DejaVu Sans';font-size:12px;font-style:normal;font-weight:400;text-anchor:middle;" transform="rotate(-0, 468.8, 401.918125)" x="468.8" y="401.918125">8</text>
+      <text style="font: 12px 'DejaVu Sans'; text-anchor: middle" x="468.8" y="401.918125" transform="rotate(-0 468.8 401.918125)">8</text>
      </g>
     </g>
     <g id="xtick_10">
      <g id="line2d_20">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="518.4" xlink:href="#md5e7837e7e" y="388.8"/>
+       <use xlink:href="#m441ccbbe42" x="518.4" y="388.8" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="line2d_21">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="518.4" xlink:href="#m5bbd032ef7" y="43.2"/>
+       <use xlink:href="#mad5646bafe" x="518.4" y="43.2" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="text_10">
-      <text style="font-family:'DejaVu Sans';font-size:12px;font-style:normal;font-weight:400;text-anchor:middle;" transform="rotate(-0, 518.4, 401.918125)" x="518.4" y="401.918125">9</text>
+      <text style="font: 12px 'DejaVu Sans'; text-anchor: middle" x="518.4" y="401.918125" transform="rotate(-0 518.4 401.918125)">9</text>
      </g>
     </g>
     <g id="text_11">
-     <text style="font-family:'DejaVu Sans';font-size:12px;font-style:normal;font-weight:400;text-anchor:middle;" transform="rotate(-0, 295.2, 418.531875)" x="295.2" y="418.531875">nonbold-xlabel</text>
+     <text style="font: 12px 'DejaVu Sans'; text-anchor: middle" x="295.2" y="418.531875" transform="rotate(-0 295.2 418.531875)">nonbold-xlabel</text>
     </g>
    </g>
    <g id="matplotlib.axis_2">
     <g id="ytick_1">
      <g id="line2d_22">
       <defs>
-       <path d="M 0 0
+       <path id="mebf891ec74" d="M 0 0
 L 4 0
-" id="m4e6950a5ab" style="stroke:#000000;stroke-width:0.5;"/>
+" style="stroke: #000000; stroke-width: 0.5"/>
       </defs>
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="72" xlink:href="#m4e6950a5ab" y="388.8"/>
+       <use xlink:href="#mebf891ec74" x="72" y="388.8" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="line2d_23">
       <defs>
-       <path d="M 0 0
+       <path id="m0be78051dd" d="M 0 0
 L -4 0
-" id="m7c8df72a26" style="stroke:#000000;stroke-width:0.5;"/>
+" style="stroke: #000000; stroke-width: 0.5"/>
       </defs>
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="518.4" xlink:href="#m7c8df72a26" y="388.8"/>
+       <use xlink:href="#m0be78051dd" x="518.4" y="388.8" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="text_12">
-      <text style="font-family:'DejaVu Sans';font-size:12px;font-style:normal;font-weight:400;text-anchor:end;" transform="rotate(-0, 68, 393.359062)" x="68" y="393.359062">0</text>
+      <text style="font: 12px 'DejaVu Sans'; text-anchor: end" x="68" y="393.359062" transform="rotate(-0 68 393.359062)">0</text>
      </g>
     </g>
     <g id="ytick_2">
      <g id="line2d_24">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="72" xlink:href="#m4e6950a5ab" y="350.4"/>
+       <use xlink:href="#mebf891ec74" x="72" y="350.4" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="line2d_25">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="518.4" xlink:href="#m7c8df72a26" y="350.4"/>
+       <use xlink:href="#m0be78051dd" x="518.4" y="350.4" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="text_13">
-      <text style="font-family:'DejaVu Sans';font-size:12px;font-style:normal;font-weight:400;text-anchor:end;" transform="rotate(-0, 68, 354.959063)" x="68" y="354.959063">1</text>
+      <text style="font: 12px 'DejaVu Sans'; text-anchor: end" x="68" y="354.959063" transform="rotate(-0 68 354.959063)">1</text>
      </g>
     </g>
     <g id="ytick_3">
      <g id="line2d_26">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="72" xlink:href="#m4e6950a5ab" y="312"/>
+       <use xlink:href="#mebf891ec74" x="72" y="312" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="line2d_27">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="518.4" xlink:href="#m7c8df72a26" y="312"/>
+       <use xlink:href="#m0be78051dd" x="518.4" y="312" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="text_14">
-      <text style="font-family:'DejaVu Sans';font-size:12px;font-style:normal;font-weight:400;text-anchor:end;" transform="rotate(-0, 68, 316.559062)" x="68" y="316.559062">2</text>
+      <text style="font: 12px 'DejaVu Sans'; text-anchor: end" x="68" y="316.559062" transform="rotate(-0 68 316.559062)">2</text>
      </g>
     </g>
     <g id="ytick_4">
      <g id="line2d_28">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="72" xlink:href="#m4e6950a5ab" y="273.6"/>
+       <use xlink:href="#mebf891ec74" x="72" y="273.6" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="line2d_29">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="518.4" xlink:href="#m7c8df72a26" y="273.6"/>
+       <use xlink:href="#m0be78051dd" x="518.4" y="273.6" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="text_15">
-      <text style="font-family:'DejaVu Sans';font-size:12px;font-style:normal;font-weight:400;text-anchor:end;" transform="rotate(-0, 68, 278.159063)" x="68" y="278.159063">3</text>
+      <text style="font: 12px 'DejaVu Sans'; text-anchor: end" x="68" y="278.159063" transform="rotate(-0 68 278.159063)">3</text>
      </g>
     </g>
     <g id="ytick_5">
      <g id="line2d_30">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="72" xlink:href="#m4e6950a5ab" y="235.2"/>
+       <use xlink:href="#mebf891ec74" x="72" y="235.2" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="line2d_31">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="518.4" xlink:href="#m7c8df72a26" y="235.2"/>
+       <use xlink:href="#m0be78051dd" x="518.4" y="235.2" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="text_16">
-      <text style="font-family:'DejaVu Sans';font-size:12px;font-style:normal;font-weight:400;text-anchor:end;" transform="rotate(-0, 68, 239.759063)" x="68" y="239.759063">4</text>
+      <text style="font: 12px 'DejaVu Sans'; text-anchor: end" x="68" y="239.759063" transform="rotate(-0 68 239.759063)">4</text>
      </g>
     </g>
     <g id="ytick_6">
      <g id="line2d_32">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="72" xlink:href="#m4e6950a5ab" y="196.8"/>
+       <use xlink:href="#mebf891ec74" x="72" y="196.8" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="line2d_33">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="518.4" xlink:href="#m7c8df72a26" y="196.8"/>
+       <use xlink:href="#m0be78051dd" x="518.4" y="196.8" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="text_17">
-      <text style="font-family:'DejaVu Sans';font-size:12px;font-style:normal;font-weight:400;text-anchor:end;" transform="rotate(-0, 68, 201.359063)" x="68" y="201.359063">5</text>
+      <text style="font: 12px 'DejaVu Sans'; text-anchor: end" x="68" y="201.359063" transform="rotate(-0 68 201.359063)">5</text>
      </g>
     </g>
     <g id="ytick_7">
      <g id="line2d_34">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="72" xlink:href="#m4e6950a5ab" y="158.4"/>
+       <use xlink:href="#mebf891ec74" x="72" y="158.4" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="line2d_35">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="518.4" xlink:href="#m7c8df72a26" y="158.4"/>
+       <use xlink:href="#m0be78051dd" x="518.4" y="158.4" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="text_18">
-      <text style="font-family:'DejaVu Sans';font-size:12px;font-style:normal;font-weight:400;text-anchor:end;" transform="rotate(-0, 68, 162.959063)" x="68" y="162.959063">6</text>
+      <text style="font: 12px 'DejaVu Sans'; text-anchor: end" x="68" y="162.959063" transform="rotate(-0 68 162.959063)">6</text>
      </g>
     </g>
     <g id="ytick_8">
      <g id="line2d_36">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="72" xlink:href="#m4e6950a5ab" y="120"/>
+       <use xlink:href="#mebf891ec74" x="72" y="120" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="line2d_37">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="518.4" xlink:href="#m7c8df72a26" y="120"/>
+       <use xlink:href="#m0be78051dd" x="518.4" y="120" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="text_19">
-      <text style="font-family:'DejaVu Sans';font-size:12px;font-style:normal;font-weight:400;text-anchor:end;" transform="rotate(-0, 68, 124.559062)" x="68" y="124.559062">7</text>
+      <text style="font: 12px 'DejaVu Sans'; text-anchor: end" x="68" y="124.559062" transform="rotate(-0 68 124.559062)">7</text>
      </g>
     </g>
     <g id="ytick_9">
      <g id="line2d_38">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="72" xlink:href="#m4e6950a5ab" y="81.6"/>
+       <use xlink:href="#mebf891ec74" x="72" y="81.6" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="line2d_39">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="518.4" xlink:href="#m7c8df72a26" y="81.6"/>
+       <use xlink:href="#m0be78051dd" x="518.4" y="81.6" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="text_20">
-      <text style="font-family:'DejaVu Sans';font-size:12px;font-style:normal;font-weight:400;text-anchor:end;" transform="rotate(-0, 68, 86.159063)" x="68" y="86.159063">8</text>
+      <text style="font: 12px 'DejaVu Sans'; text-anchor: end" x="68" y="86.159063" transform="rotate(-0 68 86.159063)">8</text>
      </g>
     </g>
     <g id="ytick_10">
      <g id="line2d_40">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="72" xlink:href="#m4e6950a5ab" y="43.2"/>
+       <use xlink:href="#mebf891ec74" x="72" y="43.2" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="line2d_41">
       <g>
-       <use style="stroke:#000000;stroke-width:0.5;" x="518.4" xlink:href="#m7c8df72a26" y="43.2"/>
+       <use xlink:href="#m0be78051dd" x="518.4" y="43.2" style="stroke: #000000; stroke-width: 0.5"/>
       </g>
      </g>
      <g id="text_21">
-      <text style="font-family:'DejaVu Sans';font-size:12px;font-style:normal;font-weight:400;text-anchor:end;" transform="rotate(-0, 68, 47.759063)" x="68" y="47.759063">9</text>
+      <text style="font: 12px 'DejaVu Sans'; text-anchor: end" x="68" y="47.759063" transform="rotate(-0 68 47.759063)">9</text>
      </g>
     </g>
     <g id="text_22">
-     <text style="font-family:'DejaVu Sans';font-size:12px;font-style:normal;font-weight:700;text-anchor:middle;" transform="rotate(-90, 52.775625, 216)" x="52.775625" y="216">bold-ylabel</text>
+     <text style="font: 700 12px 'DejaVu Sans'; text-anchor: middle" x="52.775625" y="216" transform="rotate(-90 52.775625 216)">bold-ylabel</text>
     </g>
    </g>
    <g id="text_23">
-    <text style="font-family:'DejaVu Sans';font-size:14.4px;font-style:normal;font-weight:700;text-anchor:middle;" transform="rotate(-0, 295.2, 38.2)" x="295.2" y="38.2">bold-title</text>
+    <text style="font: 700 14.4px 'DejaVu Sans'; text-anchor: middle" x="295.2" y="38.2" transform="rotate(-0 295.2 38.2)">bold-title</text>
    </g>
   </g>
  </g>
  <defs>
-  <clipPath id="pce7a3954ac">
-   <rect height="345.6" width="446.4" x="72" y="43.2"/>
+  <clipPath id="pcfdea541ed">
+   <rect x="72" y="43.2" width="446.4" height="345.6"/>
   </clipPath>
  </defs>
 </svg>
diff --git a/lib/matplotlib/tests/baseline_images/test_text/text_as_text_opacity.svg b/lib/matplotlib/tests/baseline_images/test_text/text_as_text_opacity.svg
index 63cdeb8fbd47..cbc1fbb85717 100644
--- a/lib/matplotlib/tests/baseline_images/test_text/text_as_text_opacity.svg
+++ b/lib/matplotlib/tests/baseline_images/test_text/text_as_text_opacity.svg
@@ -1,12 +1,23 @@
 <?xml version="1.0" encoding="utf-8" standalone="no"?>
 <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN"
   "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
-<!-- Created with matplotlib (https://matplotlib.org/) -->
-<svg height="432pt" version="1.1" viewBox="0 0 576 432" width="576pt" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+<svg xmlns:xlink="http://www.w3.org/1999/xlink" width="576pt" height="432pt" viewBox="0 0 576 432" xmlns="http://www.w3.org/2000/svg" version="1.1">
+ <metadata>
+  <rdf:RDF xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:cc="http://creativecommons.org/ns#" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">
+   <cc:Work>
+    <dc:type rdf:resource="http://purl.org/dc/dcmitype/StillImage"/>
+    <dc:date>2024-03-27T18:41:24.756455</dc:date>
+    <dc:format>image/svg+xml</dc:format>
+    <dc:creator>
+     <cc:Agent>
+      <dc:title>Matplotlib v3.9.0.dev1430+g883dca40e7, https://matplotlib.org/</dc:title>
+     </cc:Agent>
+    </dc:creator>
+   </cc:Work>
+  </rdf:RDF>
+ </metadata>
  <defs>
-  <style type="text/css">
-*{stroke-linecap:butt;stroke-linejoin:round;}
-  </style>
+  <style type="text/css">*{stroke-linejoin: round; stroke-linecap: butt}</style>
  </defs>
  <g id="figure_1">
   <g id="patch_1">
@@ -15,17 +26,17 @@ L 576 432
 L 576 0
 L 0 0
 z
-" style="fill:#ffffff;"/>
+" style="fill: #ffffff"/>
   </g>
   <g id="axes_1">
    <g id="text_1">
-    <text style="font-family:'DejaVu Sans';font-size:12px;font-style:normal;font-weight:normal;opacity:0.5;text-anchor:start;" transform="rotate(-0, 183.6, 302.4)" x="183.6" y="302.4">50% using `color`</text>
+    <text style="opacity: 0.5; font: 12px 'DejaVu Sans'; text-anchor: start" x="183.6" y="302.4" transform="rotate(-0 183.6 302.4)">50% using `color`</text>
    </g>
    <g id="text_2">
-    <text style="font-family:'DejaVu Sans';font-size:12px;font-style:normal;font-weight:normal;opacity:0.5;text-anchor:start;" transform="rotate(-0, 183.6, 216)" x="183.6" y="216">50% using `alpha`</text>
+    <text style="opacity: 0.5; font: 12px 'DejaVu Sans'; text-anchor: start" x="183.6" y="216" transform="rotate(-0 183.6 216)">50% using `alpha`</text>
    </g>
    <g id="text_3">
-    <text style="font-family:'DejaVu Sans';font-size:12px;font-style:normal;font-weight:normal;opacity:0.5;text-anchor:start;" transform="rotate(-0, 183.6, 129.6)" x="183.6" y="129.6">50% using `alpha` and 100% `color`</text>
+    <text style="opacity: 0.5; font: 12px 'DejaVu Sans'; text-anchor: start" x="183.6" y="129.6" transform="rotate(-0 183.6 129.6)">50% using `alpha` and 100% `color`</text>
    </g>
   </g>
  </g>

From 48bc62d6088c262b1b5507981f2948d117e63601 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 27 Mar 2024 23:50:57 -0400
Subject: [PATCH 0905/1120] ci: Build Apple Silicon wheels natively

Now that we are running a (simple) test, we'll have to ensure the
deployment target is correct. This would have been needed for a release
anyway, but can be removed once meson-python 0.16.0 is out.
---
 .github/workflows/cibuildwheel.yml | 19 ++++++++++++++-----
 1 file changed, 14 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 8a2f8b26a8d4..1c3837f25b44 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -116,10 +116,6 @@ jobs:
       CIBW_SKIP: "*-musllinux_aarch64"
       CIBW_TEST_COMMAND: >-
         python {package}/ci/check_version_number.py
-      # Apple Silicon machines are not available for testing, so silence the
-      # warning from cibuildwheel. Remove the skip when they're available.
-      CIBW_TEST_SKIP: "*-macosx_arm64"
-      MACOSX_DEPLOYMENT_TARGET: "10.12"
       MPL_DISABLE_FH4: "yes"
     strategy:
       matrix:
@@ -131,7 +127,15 @@ jobs:
           - os: windows-latest
             cibw_archs: "auto64"
           - os: macos-11
-            cibw_archs: "x86_64 arm64"
+            cibw_archs: "x86_64"
+            # NOTE: macos_target can be moved back into global environment after
+            # meson-python 0.16.0 is released.
+            macos_target: "10.12"
+          - os: macos-14
+            cibw_archs: "arm64"
+            # NOTE: macos_target can be moved back into global environment after
+            # meson-python 0.16.0 is released.
+            macos_target: "11.0"
 
     steps:
       - name: Set up QEMU
@@ -153,6 +157,7 @@ jobs:
         env:
           CIBW_BUILD: "cp312-*"
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
+          MACOSX_DEPLOYMENT_TARGET: "${{ matrix.macos_target }}"
 
       - name: Build wheels for CPython 3.11
         uses: pypa/cibuildwheel@8d945475ac4b1aac4ae08b2fd27db9917158b6ce  # v2.17.0
@@ -161,6 +166,7 @@ jobs:
         env:
           CIBW_BUILD: "cp311-*"
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
+          MACOSX_DEPLOYMENT_TARGET: "${{ matrix.macos_target }}"
 
       - name: Build wheels for CPython 3.10
         uses: pypa/cibuildwheel@8d945475ac4b1aac4ae08b2fd27db9917158b6ce  # v2.17.0
@@ -169,6 +175,7 @@ jobs:
         env:
           CIBW_BUILD: "cp310-*"
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
+          MACOSX_DEPLOYMENT_TARGET: "${{ matrix.macos_target }}"
 
       - name: Build wheels for CPython 3.9
         uses: pypa/cibuildwheel@8d945475ac4b1aac4ae08b2fd27db9917158b6ce  # v2.17.0
@@ -177,6 +184,7 @@ jobs:
         env:
           CIBW_BUILD: "cp39-*"
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
+          MACOSX_DEPLOYMENT_TARGET: "${{ matrix.macos_target }}"
 
       - name: Build wheels for PyPy
         uses: pypa/cibuildwheel@8d945475ac4b1aac4ae08b2fd27db9917158b6ce  # v2.17.0
@@ -185,6 +193,7 @@ jobs:
         env:
           CIBW_BUILD: "pp39-*"
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
+          MACOSX_DEPLOYMENT_TARGET: "${{ matrix.macos_target }}"
         if: matrix.cibw_archs != 'aarch64'
 
       - uses: actions/upload-artifact@v4

From 89e5bd4466c50963cf0da9a661e4b68e37939a8c Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Mon, 1 Apr 2024 14:58:20 +0200
Subject: [PATCH 0906/1120] Remove documentation that some backends don't
 support hatching.

Even the builtin cairo backend supports it now.
---
 lib/matplotlib/collections.py     | 3 ---
 lib/matplotlib/contour.py         | 2 --
 lib/matplotlib/patches.py         | 3 ---
 lib/matplotlib/tri/_tricontour.py | 2 --
 4 files changed, 10 deletions(-)

diff --git a/lib/matplotlib/collections.py b/lib/matplotlib/collections.py
index fb137cc503e1..b29f69606d9d 100644
--- a/lib/matplotlib/collections.py
+++ b/lib/matplotlib/collections.py
@@ -524,9 +524,6 @@ def set_hatch(self, hatch):
         hatchings are done.  If same letter repeats, it increases the
         density of hatching of that pattern.
 
-        Hatching is supported in the PostScript, PDF, SVG and Agg
-        backends only.
-
         Unlike other properties such as linewidth and colors, hatching
         can only be specified for the collection as a whole, not separately
         for each member.
diff --git a/lib/matplotlib/contour.py b/lib/matplotlib/contour.py
index 90167bd320e8..0e6068c64b62 100644
--- a/lib/matplotlib/contour.py
+++ b/lib/matplotlib/contour.py
@@ -1808,8 +1808,6 @@ def _initialize_x_y(self, z):
 
     A list of cross hatch patterns to use on the filled areas.
     If None, no hatching will be added to the contour.
-    Hatching is supported in the PostScript, PDF, SVG and Agg
-    backends only.
 
 algorithm : {'mpl2005', 'mpl2014', 'serial', 'threaded'}, optional
     Which contouring algorithm to use to calculate the contour lines and
diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
index 65e3822e5d02..2899952634a9 100644
--- a/lib/matplotlib/patches.py
+++ b/lib/matplotlib/patches.py
@@ -558,9 +558,6 @@ def set_hatch(self, hatch):
         hatchings are done.  If same letter repeats, it increases the
         density of hatching of that pattern.
 
-        Hatching is supported in the PostScript, PDF, SVG and Agg
-        backends only.
-
         Parameters
         ----------
         hatch : {'/', '\\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
diff --git a/lib/matplotlib/tri/_tricontour.py b/lib/matplotlib/tri/_tricontour.py
index 5dc1eb81593c..1db3715d01af 100644
--- a/lib/matplotlib/tri/_tricontour.py
+++ b/lib/matplotlib/tri/_tricontour.py
@@ -255,8 +255,6 @@ def tricontourf(ax, *args, **kwargs):
     hatches : list[str], optional
         A list of crosshatch patterns to use on the filled areas.
         If None, no hatching will be added to the contour.
-        Hatching is supported in the PostScript, PDF, SVG and Agg
-        backends only.
 
     Notes
     -----

From e91241e26f374fa399517c75e2d9d0f343444c73 Mon Sep 17 00:00:00 2001
From: lkkmpn <git@lkkmpn.nl>
Date: Mon, 1 Apr 2024 15:35:52 +0200
Subject: [PATCH 0907/1120] Fix color sequence data for Set2 and Set3

---
 lib/matplotlib/colors.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/colors.py b/lib/matplotlib/colors.py
index 2c8f48623b8c..c4e5987fdf92 100644
--- a/lib/matplotlib/colors.py
+++ b/lib/matplotlib/colors.py
@@ -127,8 +127,8 @@ class ColorSequenceRegistry(Mapping):
         'Accent': _cm._Accent_data,
         'Dark2': _cm._Dark2_data,
         'Set1': _cm._Set1_data,
-        'Set2': _cm._Set1_data,
-        'Set3': _cm._Set1_data,
+        'Set2': _cm._Set2_data,
+        'Set3': _cm._Set3_data,
     }
 
     def __init__(self):

From e5eb0e5338f56a67774867716150d3e9fa095b4a Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 1 Apr 2024 17:39:29 +0000
Subject: [PATCH 0908/1120] [pre-commit.ci] pre-commit autoupdate
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

updates:
- [github.com/pre-commit/mirrors-mypy: v1.8.0 → v1.9.0](https://github.com/pre-commit/mirrors-mypy/compare/v1.8.0...v1.9.0)
- [github.com/pycqa/flake8: 6.1.0 → 7.0.0](https://github.com/pycqa/flake8/compare/6.1.0...7.0.0)
- [github.com/adrienverge/yamllint: v1.29.0 → v1.35.1](https://github.com/adrienverge/yamllint/compare/v1.29.0...v1.35.1)
- [github.com/python-jsonschema/check-jsonschema: 0.28.0 → 0.28.1](https://github.com/python-jsonschema/check-jsonschema/compare/0.28.0...0.28.1)
---
 .pre-commit-config.yaml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 38fbae18c920..2dc1ca5352c0 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -28,7 +28,7 @@ repos:
       - id: trailing-whitespace
         exclude_types: [svg]
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.8.0
+    rev: v1.9.0
     hooks:
       - id: mypy
         additional_dependencies:
@@ -42,7 +42,7 @@ repos:
         files: lib/matplotlib  # Only run when files in lib/matplotlib are changed.
         pass_filenames: false
   - repo: https://github.com/pycqa/flake8
-    rev: 6.1.0
+    rev: 7.0.0
     hooks:
       - id: flake8
         additional_dependencies:
@@ -74,12 +74,12 @@ repos:
           - sphinx>=1.8.1
           - tomli
   - repo: https://github.com/adrienverge/yamllint
-    rev: v1.29.0
+    rev: v1.35.1
     hooks:
       - id: yamllint
         args: ["--strict", "--config-file=.yamllint.yml"]
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.28.0
+    rev: 0.28.1
     hooks:
       # TODO: Re-enable this when https://github.com/microsoft/azure-pipelines-vscode/issues/567 is fixed.
       # - id: check-azure-pipelines

From 0ca3e594939916ee8c2f749c9b3e085cd13ef6b8 Mon Sep 17 00:00:00 2001
From: shriyakalakata <shriyakalakata123@gmail.com>
Date: Sun, 4 Feb 2024 20:18:28 -0500
Subject: [PATCH 0909/1120] Move doc/users/installing/ to doc/install/

---
 doc/{users/installing => install}/dependencies.rst              | 0
 doc/{users/installing => install}/environment_variables_faq.rst | 0
 doc/{users/installing => install}/index.rst                     | 0
 doc/{users/installing => install}/troubleshooting_faq.inc.rst   | 0
 4 files changed, 0 insertions(+), 0 deletions(-)
 rename doc/{users/installing => install}/dependencies.rst (100%)
 rename doc/{users/installing => install}/environment_variables_faq.rst (100%)
 rename doc/{users/installing => install}/index.rst (100%)
 rename doc/{users/installing => install}/troubleshooting_faq.inc.rst (100%)

diff --git a/doc/users/installing/dependencies.rst b/doc/install/dependencies.rst
similarity index 100%
rename from doc/users/installing/dependencies.rst
rename to doc/install/dependencies.rst
diff --git a/doc/users/installing/environment_variables_faq.rst b/doc/install/environment_variables_faq.rst
similarity index 100%
rename from doc/users/installing/environment_variables_faq.rst
rename to doc/install/environment_variables_faq.rst
diff --git a/doc/users/installing/index.rst b/doc/install/index.rst
similarity index 100%
rename from doc/users/installing/index.rst
rename to doc/install/index.rst
diff --git a/doc/users/installing/troubleshooting_faq.inc.rst b/doc/install/troubleshooting_faq.inc.rst
similarity index 100%
rename from doc/users/installing/troubleshooting_faq.inc.rst
rename to doc/install/troubleshooting_faq.inc.rst

From 5570d235ecea67b1122a86336e02c23c672e5644 Mon Sep 17 00:00:00 2001
From: shriyakalakata <shriyakalakata123@gmail.com>
Date: Sun, 4 Feb 2024 20:33:16 -0500
Subject: [PATCH 0910/1120] Add redirects

---
 doc/install/environment_variables_faq.rst | 1 +
 doc/install/index.rst                     | 1 +
 doc/install/troubleshooting_faq.inc.rst   | 2 ++
 3 files changed, 4 insertions(+)

diff --git a/doc/install/environment_variables_faq.rst b/doc/install/environment_variables_faq.rst
index efbcd9980fd0..ba384343cc5a 100644
--- a/doc/install/environment_variables_faq.rst
+++ b/doc/install/environment_variables_faq.rst
@@ -3,6 +3,7 @@
 
 .. redirect-from:: /faq/installing_faq
 .. redirect-from:: /users/faq/installing_faq
+.. redirect-from:: /users/installing/environment_variables_faq
 
 =====================
 Environment variables
diff --git a/doc/install/index.rst b/doc/install/index.rst
index fa5187081b2f..ea8e29d71565 100644
--- a/doc/install/index.rst
+++ b/doc/install/index.rst
@@ -1,4 +1,5 @@
 .. redirect-from:: /users/installing
+.. redirect-from:: /users/installing/index
 
 ************
 Installation
diff --git a/doc/install/troubleshooting_faq.inc.rst b/doc/install/troubleshooting_faq.inc.rst
index 2314187a9542..d130813a80c6 100644
--- a/doc/install/troubleshooting_faq.inc.rst
+++ b/doc/install/troubleshooting_faq.inc.rst
@@ -1,5 +1,7 @@
 .. _troubleshooting-install:
 
+.. redirect-from:: /users/installing/troubleshooting_faq
+
 Troubleshooting
 ===============
 

From 41964fe88bf0c35c2d586a3bb6e1ca98c3a1ad77 Mon Sep 17 00:00:00 2001
From: shriyakalakata <shriyakalakata123@gmail.com>
Date: Wed, 13 Mar 2024 18:09:25 -0400
Subject: [PATCH 0911/1120] Add redirect for dependencies.rst

---
 doc/install/dependencies.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/doc/install/dependencies.rst b/doc/install/dependencies.rst
index fa666d280732..34eda8112cb8 100644
--- a/doc/install/dependencies.rst
+++ b/doc/install/dependencies.rst
@@ -1,4 +1,5 @@
 .. redirect-from: /devel/dependencies
+.. redirect-from:: /users/installing/dependencies.rst
 
 .. _dependencies:
 

From 43c70c8b87d0843dbb3f186336269431e886d581 Mon Sep 17 00:00:00 2001
From: shriyakalakata <shriyakalakata123@gmail.com>
Date: Wed, 13 Mar 2024 18:14:36 -0400
Subject: [PATCH 0912/1120] Update relative path for doc-requirements.txt

---
 doc/install/dependencies.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/install/dependencies.rst b/doc/install/dependencies.rst
index 34eda8112cb8..4a5d8c8dd4c4 100644
--- a/doc/install/dependencies.rst
+++ b/doc/install/dependencies.rst
@@ -392,7 +392,7 @@ The additional Python packages required to build the
 
 The content of :file:`doc-requirements.txt` is also shown below:
 
-.. include:: ../../../requirements/doc/doc-requirements.txt
+.. include:: ../../requirements/doc/doc-requirements.txt
    :literal:
 
 

From 892a573ca6b2286abe6b5e0c0871bc49a4997474 Mon Sep 17 00:00:00 2001
From: shriyakalakata <shriyakalakata123@gmail.com>
Date: Wed, 13 Mar 2024 18:28:58 -0400
Subject: [PATCH 0913/1120] Change  to

---
 INSTALL.rst                                    | 2 +-
 README.md                                      | 4 ++--
 doc/api/prev_api_changes/api_changes_3.1.0.rst | 2 +-
 doc/devel/contribute.rst                       | 2 +-
 doc/devel/development_setup.rst                | 2 +-
 doc/devel/document.rst                         | 6 +++---
 doc/index.rst                                  | 4 ++--
 doc/users/getting_started/index.rst            | 2 +-
 pyproject.toml                                 | 2 +-
 9 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/INSTALL.rst b/INSTALL.rst
index ac24c70ac518..3fb01c58d259 100644
--- a/INSTALL.rst
+++ b/INSTALL.rst
@@ -1 +1 @@
-See doc/users/installing/index.rst
+See doc/install/index.rst
diff --git a/README.md b/README.md
index 6751e9a56e35..78d4862800e5 100644
--- a/README.md
+++ b/README.md
@@ -31,8 +31,8 @@ and various graphical user interface toolkits.
 ## Install
 
 See the [install
-documentation](https://matplotlib.org/stable/users/installing/index.html),
-which is generated from `/doc/users/installing/index.rst`
+documentation](https://matplotlib.org/stable/install/index.html),
+which is generated from `/doc/install/index.rst`
 
 ## Contribute
 
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
index 18f25d459200..5b06af781938 100644
--- a/doc/api/prev_api_changes/api_changes_3.1.0.rst
+++ b/doc/api/prev_api_changes/api_changes_3.1.0.rst
@@ -308,7 +308,7 @@ FreeType or libpng are not in the compiler or linker's default path, set the
 standard environment variables ``CFLAGS``/``LDFLAGS`` on Linux or OSX, or
 ``CL``/``LINK`` on Windows, to indicate the relevant paths.
 
-See details in :doc:`/users/installing/index`.
+See details in :doc:`/install/index`.
 
 Setting artist properties twice or more in the same call
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/doc/devel/contribute.rst b/doc/devel/contribute.rst
index 510b67eead91..8c297beaddc1 100644
--- a/doc/devel/contribute.rst
+++ b/doc/devel/contribute.rst
@@ -266,7 +266,7 @@ document's URL roughly corresponds to its location in our folder structure:
 
   .. grid-item:: information about the library
 
-      * :file:`doc/users/installing/`
+      * :file:`doc/install/`
       * :file:`doc/project/`
       * :file:`doc/users/resources/`
       * :file:`doc/users/faq.rst`
diff --git a/doc/devel/development_setup.rst b/doc/devel/development_setup.rst
index 5b68172c2fc9..be99bed2fe5f 100644
--- a/doc/devel/development_setup.rst
+++ b/doc/devel/development_setup.rst
@@ -165,7 +165,7 @@ must be installed separately.
 .. toctree::
   :maxdepth: 2
 
-  ../users/installing/dependencies
+  ../install/dependencies
 
 
 .. _development-install:
diff --git a/doc/devel/document.rst b/doc/devel/document.rst
index d354ee5f238b..620c12c8db1c 100644
--- a/doc/devel/document.rst
+++ b/doc/devel/document.rst
@@ -239,7 +239,7 @@ Examples:
 
 .. code-block:: rst
 
-   See the :doc:`/users/installing/index`
+   See the :doc:`/install/index`
 
    See the tutorial :ref:`quick_start`
 
@@ -247,14 +247,14 @@ Examples:
 
 will render as:
 
-  See the :doc:`/users/installing/index`
+  See the :doc:`/install/index`
 
   See the tutorial :ref:`quick_start`
 
   See the example :doc:`/gallery/lines_bars_and_markers/simple_plot`
 
 Sections can also be given reference labels.  For instance from the
-:doc:`/users/installing/index` link:
+:doc:`/install/index` link:
 
 .. code-block:: rst
 
diff --git a/doc/index.rst b/doc/index.rst
index 00814b5ccc71..1a385d2330af 100644
--- a/doc/index.rst
+++ b/doc/index.rst
@@ -34,10 +34,10 @@ Install
         .. toctree::
             :maxdepth: 2
 
-            users/installing/index
+            install/index
 
 For more detailed instructions, see the
-:doc:`installation guide <users/installing/index>`.
+:doc:`installation guide <install/index>`.
 
 Learn
 =====
diff --git a/doc/users/getting_started/index.rst b/doc/users/getting_started/index.rst
index 68d62232ddc9..ac896687979d 100644
--- a/doc/users/getting_started/index.rst
+++ b/doc/users/getting_started/index.rst
@@ -22,7 +22,7 @@ Installation quick-start
 
             conda install -c conda-forge matplotlib
 
-Further details are available in the :doc:`Installation Guide </users/installing/index>`.
+Further details are available in the :doc:`Installation Guide </install/index>`.
 
 
 Draw a first plot
diff --git a/pyproject.toml b/pyproject.toml
index 8d3ff39fc38e..0f21ac360e13 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -61,7 +61,7 @@ dev = [
 
 [project.urls]
 "Homepage" = "https://matplotlib.org"
-"Download" = "https://matplotlib.org/stable/users/installing/index.html"
+"Download" = "https://matplotlib.org/stable/install/index.html"
 "Documentation" = "https://matplotlib.org"
 "Source Code" = "https://github.com/matplotlib/matplotlib"
 "Bug Tracker" = "https://github.com/matplotlib/matplotlib/issues"

From 34b53336db303a391229552320df461629334227 Mon Sep 17 00:00:00 2001
From: shriyakalakata <shriyakalakata123@gmail.com>
Date: Wed, 13 Mar 2024 18:32:04 -0400
Subject: [PATCH 0914/1120] Retain link in README to stable version

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 78d4862800e5..7b9c99597c0d 100644
--- a/README.md
+++ b/README.md
@@ -31,7 +31,7 @@ and various graphical user interface toolkits.
 ## Install
 
 See the [install
-documentation](https://matplotlib.org/stable/install/index.html),
+documentation](https://matplotlib.org/stable/users/installing/index.html),
 which is generated from `/doc/install/index.rst`
 
 ## Contribute

From 064acbbdf78f114a442294136d2e8f54f5ed1775 Mon Sep 17 00:00:00 2001
From: shriyakalakata <shriyakalakata123@gmail.com>
Date: Thu, 14 Mar 2024 00:32:59 -0400
Subject: [PATCH 0915/1120] Empty commit to trigger tests


From 61a85555813f499ff8b2e744b787ee9eeff947ed Mon Sep 17 00:00:00 2001
From: shriyakalakata <shriyakalakata123@gmail.com>
Date: Thu, 14 Mar 2024 01:25:17 -0400
Subject: [PATCH 0916/1120] Update file path in users/index.rst

---
 doc/users/index.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/users/index.rst b/doc/users/index.rst
index eacb72749f81..2991e7d2b324 100644
--- a/doc/users/index.rst
+++ b/doc/users/index.rst
@@ -102,4 +102,4 @@ Using Matplotlib
     :hidden:
 
     getting_started/index
-    installing/index
+    ../install/index

From 07abbf24e162e7d3a0e205c629449aa80287e36e Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 22 Feb 2024 22:02:33 -0500
Subject: [PATCH 0917/1120] Fix deprecation warnings in ft2font extension

---
 src/ft2font_wrapper.cpp | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/ft2font_wrapper.cpp b/src/ft2font_wrapper.cpp
index 25b2d173f5e9..0fdb0165b462 100644
--- a/src/ft2font_wrapper.cpp
+++ b/src/ft2font_wrapper.cpp
@@ -73,8 +73,8 @@ static PyObject *PyFT2Image_draw_rect(PyFT2Image *self, PyObject *args)
 {
     char const* msg =
         "FT2Image.draw_rect is deprecated since Matplotlib 3.8 and will be removed "
-        "in Matplotlib 3.10 releases later as it is not used in the library. "
-        "If you rely on it, please let us know.";
+        "in Matplotlib 3.10 as it is not used in the library. If you rely on it, "
+        "please let us know.";
     if (PyErr_WarnEx(PyExc_DeprecationWarning, msg, 1)) {
         return NULL;
     }
@@ -838,8 +838,8 @@ const char *PyFT2Font_get_xys__doc__ =
 static PyObject *PyFT2Font_get_xys(PyFT2Font *self, PyObject *args, PyObject *kwds)
 {
     char const* msg =
-        "FT2Font.get_xys is deprecated since Matplotlib 3.8 and will be removed two "
-        "meso releases later as it is not used in the library. If you rely on it, "
+        "FT2Font.get_xys is deprecated since Matplotlib 3.8 and will be removed in "
+        "Matplotlib 3.10 as it is not used in the library. If you rely on it, "
         "please let us know.";
     if (PyErr_WarnEx(PyExc_DeprecationWarning, msg, 1)) {
         return NULL;

From bce36433f20a0539b5301b4244e913d9c28ffed4 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Tue, 2 Apr 2024 04:16:03 -0400
Subject: [PATCH 0918/1120] wx: Fix file extension for toolmanager-style
 toolbar

Fixes AppVeyor failure noted in
https://github.com/matplotlib/matplotlib/pull/26710#issuecomment-2031349546
---
 lib/matplotlib/backends/backend_wx.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/lib/matplotlib/backends/backend_wx.py b/lib/matplotlib/backends/backend_wx.py
index 0ae70707ac0d..7db9d686baae 100644
--- a/lib/matplotlib/backends/backend_wx.py
+++ b/lib/matplotlib/backends/backend_wx.py
@@ -1161,6 +1161,8 @@ def set_history_buttons(self):
 # tools for matplotlib.backend_managers.ToolManager:
 
 class ToolbarWx(ToolContainerBase, wx.ToolBar):
+    _icon_extension = '.svg'
+
     def __init__(self, toolmanager, parent=None, style=wx.TB_BOTTOM):
         if parent is None:
             parent = toolmanager.canvas.GetParent()

From ae7f7697b264d204850e08a06e36eb53dccfd637 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Tue, 2 Apr 2024 14:06:46 +0200
Subject: [PATCH 0919/1120] Make Grouper return siblings in the order in which
 they have been seen.

---
 lib/matplotlib/cbook.py | 31 +++++++++++++++++++++++--------
 1 file changed, 23 insertions(+), 8 deletions(-)

diff --git a/lib/matplotlib/cbook.py b/lib/matplotlib/cbook.py
index ee043f351dbb..a41bfe56744f 100644
--- a/lib/matplotlib/cbook.py
+++ b/lib/matplotlib/cbook.py
@@ -849,12 +849,18 @@ class Grouper:
     def __init__(self, init=()):
         self._mapping = weakref.WeakKeyDictionary(
             {x: weakref.WeakSet([x]) for x in init})
+        self._ordering = weakref.WeakKeyDictionary()
+        for x in init:
+            if x not in self._ordering:
+                self._ordering[x] = len(self._ordering)
+        self._next_order = len(self._ordering)  # Plain int to simplify pickling.
 
     def __getstate__(self):
         return {
             **vars(self),
             # Convert weak refs to strong ones.
             "_mapping": {k: set(v) for k, v in self._mapping.items()},
+            "_ordering": {**self._ordering},
         }
 
     def __setstate__(self, state):
@@ -862,6 +868,7 @@ def __setstate__(self, state):
         # Convert strong refs to weak ones.
         self._mapping = weakref.WeakKeyDictionary(
             {k: weakref.WeakSet(v) for k, v in self._mapping.items()})
+        self._ordering = weakref.WeakKeyDictionary(self._ordering)
 
     def __contains__(self, item):
         return item in self._mapping
@@ -875,10 +882,19 @@ def join(self, a, *args):
         Join given arguments into the same set.  Accepts one or more arguments.
         """
         mapping = self._mapping
-        set_a = mapping.setdefault(a, weakref.WeakSet([a]))
-
+        try:
+            set_a = mapping[a]
+        except KeyError:
+            set_a = mapping[a] = weakref.WeakSet([a])
+            self._ordering[a] = self._next_order
+            self._next_order += 1
         for arg in args:
-            set_b = mapping.get(arg, weakref.WeakSet([arg]))
+            try:
+                set_b = mapping[arg]
+            except KeyError:
+                set_b = mapping[arg] = weakref.WeakSet([arg])
+                self._ordering[arg] = self._next_order
+                self._next_order += 1
             if set_b is not set_a:
                 if len(set_b) > len(set_a):
                     set_a, set_b = set_b, set_a
@@ -892,9 +908,8 @@ def joined(self, a, b):
 
     def remove(self, a):
         """Remove *a* from the grouper, doing nothing if it is not there."""
-        set_a = self._mapping.pop(a, None)
-        if set_a:
-            set_a.remove(a)
+        self._mapping.pop(a, {a}).remove(a)
+        self._ordering.pop(a, None)
 
     def __iter__(self):
         """
@@ -904,12 +919,12 @@ def __iter__(self):
         """
         unique_groups = {id(group): group for group in self._mapping.values()}
         for group in unique_groups.values():
-            yield [x for x in group]
+            yield sorted(group, key=self._ordering.__getitem__)
 
     def get_siblings(self, a):
         """Return all of the items joined with *a*, including itself."""
         siblings = self._mapping.get(a, [a])
-        return [x for x in siblings]
+        return sorted(siblings, key=self._ordering.get)
 
 
 class GrouperView:

From c5b2158e0d354b632d9ec4158cf25153fb267811 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Sun, 26 Mar 2023 23:45:00 +0200
Subject: [PATCH 0920/1120] Display cursor coordinates for all axes twinned
 with the current one.

---
 lib/matplotlib/axes/_base.py               | 18 ++++++++++++++----
 lib/matplotlib/tests/test_backend_bases.py | 20 ++++++++++++++------
 2 files changed, 28 insertions(+), 10 deletions(-)

diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index 36baff85fa66..23cc1c869c07 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -3976,10 +3976,20 @@ def format_ydata(self, y):
 
     def format_coord(self, x, y):
         """Return a format string formatting the *x*, *y* coordinates."""
-        return "x={} y={}".format(
-            "???" if x is None else self.format_xdata(x),
-            "???" if y is None else self.format_ydata(y),
-        )
+        twins = self._twinned_axes.get_siblings(self)
+        if len(twins) == 1:
+            return "(x, y) = ({}, {})".format(
+                "???" if x is None else self.format_xdata(x),
+                "???" if y is None else self.format_ydata(y))
+        screen_xy = self.transData.transform((x, y))
+        xy_strs = []
+        # Retrieve twins in the order of self.figure.axes to sort tied zorders (which is
+        # the common case) by the order in which they are added to the figure.
+        for ax in sorted(twins, key=attrgetter("zorder")):
+            data_x, data_y = ax.transData.inverted().transform(screen_xy)
+            xy_strs.append(
+                "({}, {})".format(ax.format_xdata(data_x), ax.format_ydata(data_y)))
+        return "(x, y) = {}".format(" | ".join(xy_strs))
 
     def minorticks_on(self):
         """
diff --git a/lib/matplotlib/tests/test_backend_bases.py b/lib/matplotlib/tests/test_backend_bases.py
index 399949c93bef..c264f01acdb2 100644
--- a/lib/matplotlib/tests/test_backend_bases.py
+++ b/lib/matplotlib/tests/test_backend_bases.py
@@ -1,5 +1,3 @@
-import re
-
 from matplotlib import path, transforms
 from matplotlib.backend_bases import (
     FigureCanvasBase, KeyEvent, LocationEvent, MouseButton, MouseEvent,
@@ -123,11 +121,21 @@ def test_location_event_position(x, y):
         assert event.y == int(y)
         assert isinstance(event.y, int)
     if x is not None and y is not None:
-        assert re.match(
-            f"x={ax.format_xdata(x)} +y={ax.format_ydata(y)}",
-            ax.format_coord(x, y))
+        assert (ax.format_coord(x, y)
+                == f"(x, y) = ({ax.format_xdata(x)}, {ax.format_ydata(y)})")
         ax.fmt_xdata = ax.fmt_ydata = lambda x: "foo"
-        assert re.match("x=foo +y=foo", ax.format_coord(x, y))
+        assert ax.format_coord(x, y) == "(x, y) = (foo, foo)"
+
+
+def test_location_event_position_twin():
+    fig, ax = plt.subplots()
+    ax.set(xlim=(0, 10), ylim=(0, 20))
+    assert ax.format_coord(5., 5.) == "(x, y) = (5.00, 5.00)"
+    ax.twinx().set(ylim=(0, 40))
+    assert ax.format_coord(5., 5.) == "(x, y) = (5.00, 5.00) | (5.00, 10.0)"
+    ax.twiny().set(xlim=(0, 5))
+    assert (ax.format_coord(5., 5.)
+            == "(x, y) = (5.00, 5.00) | (5.00, 10.0) | (2.50, 5.00)")
 
 
 def test_pick():

From 39f28ccfb806e1dd63c4e8665803db98d36455a6 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 3 Apr 2024 01:52:31 -0400
Subject: [PATCH 0921/1120] wx: Continue supporting non-SVG for toolmanager's
 sake

This falls back to the previous dark-mode setup for any other formats.
It won't be HiDPI compatible, but that's probably not possible for
raster formats.
---
 lib/matplotlib/backends/backend_wx.py | 26 +++++++++++++++++++++-----
 1 file changed, 21 insertions(+), 5 deletions(-)

diff --git a/lib/matplotlib/backends/backend_wx.py b/lib/matplotlib/backends/backend_wx.py
index 7db9d686baae..cd2fe215464c 100644
--- a/lib/matplotlib/backends/backend_wx.py
+++ b/lib/matplotlib/backends/backend_wx.py
@@ -14,6 +14,9 @@
 import sys
 import weakref
 
+import numpy as np
+import PIL.Image
+
 import matplotlib as mpl
 from matplotlib.backend_bases import (
     _Backend, FigureCanvasBase, FigureManagerBase,
@@ -1071,7 +1074,6 @@ def _icon(name):
         *name*, including the extension and relative to Matplotlib's "images"
         data directory.
         """
-        svg = cbook._get_data_path("images", name).read_bytes()
         try:
             dark = wx.SystemSettings.GetAppearance().IsDark()
         except AttributeError:  # wxpython < 4.1
@@ -1082,10 +1084,24 @@ def _icon(name):
             bg_lum = (.299 * bg.red + .587 * bg.green + .114 * bg.blue) / 255
             fg_lum = (.299 * fg.red + .587 * fg.green + .114 * fg.blue) / 255
             dark = fg_lum - bg_lum > .2
-        if dark:
-            svg = svg.replace(b'fill:black;', b'fill:white;')
-        toolbarIconSize = wx.ArtProvider().GetDIPSizeHint(wx.ART_TOOLBAR)
-        return wx.BitmapBundle.FromSVG(svg, toolbarIconSize)
+
+        path = cbook._get_data_path('images', name)
+        if path.suffix == '.svg':
+            svg = path.read_bytes()
+            if dark:
+                svg = svg.replace(b'fill:black;', b'fill:white;')
+            toolbarIconSize = wx.ArtProvider().GetDIPSizeHint(wx.ART_TOOLBAR)
+            return wx.BitmapBundle.FromSVG(svg, toolbarIconSize)
+        else:
+            pilimg = PIL.Image.open(path)
+            # ensure RGBA as wx BitMap expects RGBA format
+            image = np.array(pilimg.convert("RGBA"))
+            if dark:
+                fg = wx.SystemSettings.GetColour(wx.SYS_COLOUR_WINDOWTEXT)
+                black_mask = (image[..., :3] == 0).all(axis=-1)
+                image[black_mask, :3] = (fg.Red(), fg.Green(), fg.Blue())
+            return wx.Bitmap.FromBufferRGBA(
+                image.shape[1], image.shape[0], image.tobytes())
 
     def _update_buttons_checked(self):
         if "Pan" in self.wx_ids:

From 92f89784094c89805008b4e715b20a8403141274 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Wed, 3 Apr 2024 11:27:28 +0200
Subject: [PATCH 0922/1120] Avoid plt.xticks/plt.yticks in gallery examples.

In particular, the ticklabels_rotation example is likely the one most
easily found by those looking for how to do this; let's not suggest that
plt.xticks is "the" way to rotate ticklabels.

Also remove the margins() call (which was really only needed with the
old round_numbers autolimits mode) and the subplots_adjust() call (the
ticklabels already fit in, and the modern approach would be to use
constrained_layout anyways).
---
 .../subplots_axes_and_figures/secondary_axis.py       |  2 +-
 galleries/examples/ticks/ticklabels_rotation.py       | 11 +++++------
 2 files changed, 6 insertions(+), 7 deletions(-)

diff --git a/galleries/examples/subplots_axes_and_figures/secondary_axis.py b/galleries/examples/subplots_axes_and_figures/secondary_axis.py
index 8ae40ce48c84..ab42d3a6c182 100644
--- a/galleries/examples/subplots_axes_and_figures/secondary_axis.py
+++ b/galleries/examples/subplots_axes_and_figures/secondary_axis.py
@@ -154,7 +154,7 @@ def inverse(x):
 
 ax.plot(dates, temperature)
 ax.set_ylabel(r'$T\ [^oC]$')
-plt.xticks(rotation=70)
+ax.xaxis.set_tick_params(rotation=70)
 
 
 def date2yday(x):
diff --git a/galleries/examples/ticks/ticklabels_rotation.py b/galleries/examples/ticks/ticklabels_rotation.py
index 216b15d2762c..94924d0440f5 100644
--- a/galleries/examples/ticks/ticklabels_rotation.py
+++ b/galleries/examples/ticks/ticklabels_rotation.py
@@ -5,17 +5,16 @@
 
 Demo of custom tick-labels with user-defined rotation.
 """
+
 import matplotlib.pyplot as plt
 
 x = [1, 2, 3, 4]
 y = [1, 4, 9, 6]
 labels = ['Frogs', 'Hogs', 'Bogs', 'Slogs']
 
-plt.plot(x, y)
+fig, ax = plt.subplots()
+ax.plot(x, y)
 # You can specify a rotation for the tick labels in degrees or with keywords.
-plt.xticks(x, labels, rotation='vertical')
-# Pad margins so that markers don't get clipped by the Axes
-plt.margins(0.2)
-# Tweak spacing to prevent clipping of tick-labels
-plt.subplots_adjust(bottom=0.15)
+ax.set_xticks(x, labels, rotation='vertical')
+
 plt.show()

From d8815fea31d272af198c691863d58ea73c45628a Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 3 Apr 2024 15:40:28 -0400
Subject: [PATCH 0923/1120] wx: Fix the zoom rubberband with toolmanager

---
 lib/matplotlib/backends/backend_wx.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/backends/backend_wx.py b/lib/matplotlib/backends/backend_wx.py
index cd2fe215464c..8064511ac28a 100644
--- a/lib/matplotlib/backends/backend_wx.py
+++ b/lib/matplotlib/backends/backend_wx.py
@@ -1152,7 +1152,7 @@ def save_figure(self, *args):
 
     def draw_rubberband(self, event, x0, y0, x1, y1):
         height = self.canvas.figure.bbox.height
-        sf = 1 if wx.Platform == '__WXMSW__' else self.GetDPIScaleFactor()
+        sf = 1 if wx.Platform == '__WXMSW__' else self.canvas.GetDPIScaleFactor()
         self.canvas._rubberband_rect = (x0/sf, (height - y0)/sf,
                                         x1/sf, (height - y1)/sf)
         self.canvas.Refresh()

From 62bac20d2309f88452105116cfaa035422c912b5 Mon Sep 17 00:00:00 2001
From: Vashesh08 <vashesh2001@gmail.com>
Date: Wed, 30 Aug 2023 18:16:15 +0530
Subject: [PATCH 0924/1120] Auto-escape % symbol in LaTeX in pie labels

Fixes Issue #26377 - Adding Support For % operator in Latex

Excaping The % Operator in LaTeX for the Pie method

Update _axes.py

Added usetex key in textprops dictionary in pie method

Removing Flake Issues and Prioritizing textprops parameter

Fixes % operator in Latex in Pie Method

Removed Trailing Whitespace

Removed Unnecessary Label Test in Pie

Update lib/matplotlib/tests/test_axes.py

Skip Test when latex is not available

Co-authored-by: Kyle Sunden <git@ksunden.space>

Update lib/matplotlib/tests/test_axes.py

Update test_name for % operator in Latex in Pie Method

Co-authored-by: Kyle Sunden <git@ksunden.space>

Added Dependency for needs_usetex testing for checking Latex dependency

Comment For Using Regex To Support % Symbol in Latex

Comments added to escape %  if not already escaped using regex

Co-authored-by: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
---
 doc/users/next_whats_new/pie_percent_latex.rst | 11 +++++++++++
 lib/matplotlib/axes/_axes.py                   |  4 ++++
 lib/matplotlib/tests/test_axes.py              | 14 ++++++++++++++
 3 files changed, 29 insertions(+)
 create mode 100644 doc/users/next_whats_new/pie_percent_latex.rst

diff --git a/doc/users/next_whats_new/pie_percent_latex.rst b/doc/users/next_whats_new/pie_percent_latex.rst
new file mode 100644
index 000000000000..7ed547302789
--- /dev/null
+++ b/doc/users/next_whats_new/pie_percent_latex.rst
@@ -0,0 +1,11 @@
+Percent sign in pie labels auto-escaped with ``usetex=True``
+------------------------------------------------------------
+
+It is common, with `.Axes.pie`, to specify labels that include a percent sign
+(``%``), which denotes a comment for LaTeX. When enabling LaTeX with
+:rc:`text.usetex` or passing ``textprops={"usetex": True}``, this would cause
+the percent sign to disappear.
+
+Now, the percent sign is automatically escaped (by adding a preceding
+backslash) so that it appears regardless of the ``usetex`` setting. If you have
+pre-escaped the percent sign, this will be detected, and remain as is.
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index dc7f0c433fb4..b65004b8c272 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -4,6 +4,7 @@
 import math
 from numbers import Integral, Number, Real
 
+import re
 import numpy as np
 from numpy import ma
 
@@ -3377,6 +3378,9 @@ def get_next_color():
                 else:
                     raise TypeError(
                         'autopct must be callable or a format string')
+                if mpl._val_or_rc(textprops.get("usetex"), "text.usetex"):
+                    # escape % (i.e. \%) if it is not already escaped
+                    s = re.sub(r"([^\\])%", r"\1\\%", s)
                 t = self.text(xt, yt, s,
                               clip_on=False,
                               horizontalalignment='center',
diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index deb83a26033c..819f4eb3b598 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -38,6 +38,7 @@
     assert_allclose, assert_array_equal, assert_array_almost_equal)
 from matplotlib.testing.decorators import (
     image_comparison, check_figures_equal, remove_ticks_and_titles)
+from matplotlib.testing._markers import needs_usetex
 
 # Note: Some test cases are run twice: once normally and once with labeled data
 #       These two must be defined in the same test function or need to have
@@ -9008,3 +9009,16 @@ def test_boxplot_tick_labels():
     # Test the new tick_labels parameter
     axs[1].boxplot(data, tick_labels=['A', 'B', 'C'])
     assert [l.get_text() for l in axs[1].get_xticklabels()] == ['A', 'B', 'C']
+
+
+@needs_usetex
+@check_figures_equal()
+def test_latex_pie_percent(fig_test, fig_ref):
+
+    data = [20, 10, 70]
+
+    ax = fig_test.subplots()
+    ax.pie(data, autopct="%1.0f%%", textprops={'usetex': True})
+
+    ax1 = fig_ref.subplots()
+    ax1.pie(data, autopct=r"%1.0f\%%", textprops={'usetex': True})

From daa1ca992ab46919ab88f06eb9c99210c58cc279 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Wed, 3 Apr 2024 17:38:38 -0500
Subject: [PATCH 0925/1120] Bump from v3.8.4 tag


From 4dcfcf8b7bffe9a92fdd5e42761208e4557a1add Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Wed, 3 Apr 2024 19:33:39 -0500
Subject: [PATCH 0926/1120] Zenodo for v3.8.4

---
 doc/_static/zenodo_cache/10916799.svg | 35 +++++++++++++++++++++++++++
 doc/users/project/citing.rst          |  3 +++
 tools/cache_zenodo_svg.py             |  1 +
 3 files changed, 39 insertions(+)
 create mode 100644 doc/_static/zenodo_cache/10916799.svg

diff --git a/doc/_static/zenodo_cache/10916799.svg b/doc/_static/zenodo_cache/10916799.svg
new file mode 100644
index 000000000000..ca9c0a454251
--- /dev/null
+++ b/doc/_static/zenodo_cache/10916799.svg
@@ -0,0 +1,35 @@
+<svg xmlns="http://www.w3.org/2000/svg"
+     width="190.859375" height="20">
+        <linearGradient id="b" x2="0" y2="100%">
+            <stop offset="0" stop-color="#bbb" stop-opacity=".1"/>
+            <stop offset="1" stop-opacity=".1"/>
+        </linearGradient>
+        <mask id="a" width="190.859375" height="20">
+            <rect width="190.859375" height="20" rx="3"
+            fill="#fff"/>
+        </mask>
+        <g mask="url(#a)">
+            <path fill="#555" d="M0 0h31.375v20H0z" />
+            <path fill="#007ec6"
+            d="M31.375 0h159.484375v20H31.375z"
+            />
+            <path fill="url(#b)" d="M0 0h190.859375v20H0z" />
+        </g>
+        <g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,
+        Verdana,Geneva,sans-serif" font-size="11">
+            <text x="16.1875" y="15" fill="#010101"
+            fill-opacity=".3">
+                DOI
+            </text>
+            <text x="16.1875" y="14">
+                DOI
+            </text>
+            <text x="110.6171875"
+            y="15" fill="#010101" fill-opacity=".3">
+                10.5281/zenodo.10916799
+            </text>
+            <text x="110.6171875" y="14">
+                10.5281/zenodo.10916799
+            </text>
+        </g>
+    </svg>
\ No newline at end of file
diff --git a/doc/users/project/citing.rst b/doc/users/project/citing.rst
index e162a427d8b4..87d30ee4cb67 100644
--- a/doc/users/project/citing.rst
+++ b/doc/users/project/citing.rst
@@ -29,6 +29,9 @@ By version
 .. START OF AUTOGENERATED
 
 
+v3.8.4
+   .. image:: ../../_static/zenodo_cache/10916799.svg
+      :target:  https://doi.org/10.5281/zenodo.10916799
 v3.8.3
    .. image:: ../../_static/zenodo_cache/10661079.svg
       :target:  https://doi.org/10.5281/zenodo.10661079
diff --git a/tools/cache_zenodo_svg.py b/tools/cache_zenodo_svg.py
index b838511fe3b0..6a5dd01ed3c5 100644
--- a/tools/cache_zenodo_svg.py
+++ b/tools/cache_zenodo_svg.py
@@ -63,6 +63,7 @@ def _get_xdg_cache_dir():
 
 if __name__ == "__main__":
     data = {
+        "v3.8.4": "10916799",
         "v3.8.3": "10661079",
         "v3.8.2": "10150955",
         "v3.8.1": "10059757",

From 9411d7fd4ace7d40e1b8382ba851951bf6481365 Mon Sep 17 00:00:00 2001
From: "Adam J. Stewart" <ajstewart426@gmail.com>
Date: Thu, 4 Apr 2024 13:57:47 +0200
Subject: [PATCH 0927/1120] DOC: correct path to mpl_toolkits reference images

---
 doc/devel/testing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/devel/testing.rst b/doc/devel/testing.rst
index 46bcec91ac19..a9f52f0e62b6 100644
--- a/doc/devel/testing.rst
+++ b/doc/devel/testing.rst
@@ -315,7 +315,7 @@ The correct target folder can be found using::
 
     python -c "import matplotlib.tests; print(matplotlib.tests.__file__.rsplit('/', 1)[0])"
 
-An analogous copying of :file:`lib/mpl_toolkits/tests/baseline_images`
+An analogous copying of :file:`lib/mpl_toolkits/*/tests/baseline_images`
 is necessary for testing ``mpl_toolkits``.
 
 Run the tests

From 0aa101e87f8412cb5be32d7b1138bca5912b8e35 Mon Sep 17 00:00:00 2001
From: Antony Lee <anntzer.lee@gmail.com>
Date: Wed, 3 Apr 2024 11:51:29 +0200
Subject: [PATCH 0928/1120] Improve timeline example.

- Make the timeline vertical, which avoids many overlaps between labels
  and lines.
- Sort releases by dates, so that the oldest release starts with a long
  stemline rather than some random length depending on how many releases
  there are.
- Make minor releases fainter, which improves the hierarchical
  impression.
- Switch to yearly date labels, which are enough for this timeline.
---
 .../lines_bars_and_markers/timeline.py        | 78 +++++++++++--------
 1 file changed, 44 insertions(+), 34 deletions(-)

diff --git a/galleries/examples/lines_bars_and_markers/timeline.py b/galleries/examples/lines_bars_and_markers/timeline.py
index f94f00799caa..93b98a403620 100644
--- a/galleries/examples/lines_bars_and_markers/timeline.py
+++ b/galleries/examples/lines_bars_and_markers/timeline.py
@@ -28,22 +28,19 @@
     data = json.loads(urllib.request.urlopen(url, timeout=1).read().decode())
 
     dates = []
-    names = []
+    releases = []
     for item in data:
         if 'rc' not in item['tag_name'] and 'b' not in item['tag_name']:
             dates.append(item['published_at'].split("T")[0])
-            names.append(item['tag_name'])
-    # Convert date strings (e.g. 2014-10-18) to datetime
-    dates = [datetime.strptime(d, "%Y-%m-%d") for d in dates]
+            releases.append(item['tag_name'].lstrip("v"))
 
 except Exception:
     # In case the above fails, e.g. because of missing internet connection
     # use the following lists as fallback.
-    names = ['v2.2.4', 'v3.0.3', 'v3.0.2', 'v3.0.1', 'v3.0.0', 'v2.2.3',
-             'v2.2.2', 'v2.2.1', 'v2.2.0', 'v2.1.2', 'v2.1.1', 'v2.1.0',
-             'v2.0.2', 'v2.0.1', 'v2.0.0', 'v1.5.3', 'v1.5.2', 'v1.5.1',
-             'v1.5.0', 'v1.4.3', 'v1.4.2', 'v1.4.1', 'v1.4.0']
-
+    releases = ['2.2.4', '3.0.3', '3.0.2', '3.0.1', '3.0.0', '2.2.3',
+                '2.2.2', '2.2.1', '2.2.0', '2.1.2', '2.1.1', '2.1.0',
+                '2.0.2', '2.0.1', '2.0.0', '1.5.3', '1.5.2', '1.5.1',
+                '1.5.0', '1.4.3', '1.4.2', '1.4.1', '1.4.0']
     dates = ['2019-02-26', '2019-02-26', '2018-11-10', '2018-11-10',
              '2018-09-18', '2018-08-10', '2018-03-17', '2018-03-16',
              '2018-03-06', '2018-01-18', '2017-12-10', '2017-10-07',
@@ -51,8 +48,8 @@
              '2016-07-03', '2016-01-10', '2015-10-29', '2015-02-16',
              '2014-10-26', '2014-10-18', '2014-08-26']
 
-    # Convert date strings (e.g. 2014-10-18) to datetime
-    dates = [datetime.strptime(d, "%Y-%m-%d") for d in dates]
+dates = [datetime.strptime(d, "%Y-%m-%d") for d in dates]  # Convert strs to dates.
+dates, releases = zip(*sorted(zip(dates, releases)))  # Sort by increasing date.
 
 # %%
 # Next, we'll create a stem plot with some variation in levels as to
@@ -64,32 +61,45 @@
 #
 # Note that Matplotlib will automatically plot datetime inputs.
 
-
-# Choose some nice levels
-levels = np.tile([-5, 5, -3, 3, -1, 1],
-                 int(np.ceil(len(dates)/6)))[:len(dates)]
-
-# Create figure and plot a stem plot with the date
+# Choose some nice levels: alternate minor releases between top and bottom, and
+# progressievly shorten the stems for bugfix releases.
+levels = []
+major_minor_releases = sorted({release[:3] for release in releases})
+for release in releases:
+    major_minor = release[:3]
+    bugfix = int(release[4])
+    h = 1 + 0.8 * (5 - bugfix)
+    level = h if major_minor_releases.index(major_minor) % 2 == 0 else -h
+    levels.append(level)
+
+# The figure and the axes.
 fig, ax = plt.subplots(figsize=(8.8, 4), layout="constrained")
 ax.set(title="Matplotlib release dates")
 
-ax.vlines(dates, 0, levels, color="tab:red")  # The vertical stems.
-ax.plot(dates, np.zeros_like(dates), "-o",
-        color="k", markerfacecolor="w")  # Baseline and markers on it.
-
-# annotate lines
-for d, l, r in zip(dates, levels, names):
-    ax.annotate(r, xy=(d, l),
-                xytext=(-3, np.sign(l)*3), textcoords="offset points",
-                horizontalalignment="right",
-                verticalalignment="bottom" if l > 0 else "top")
-
-# format x-axis with 4-month intervals
-ax.xaxis.set_major_locator(mdates.MonthLocator(interval=4))
-ax.xaxis.set_major_formatter(mdates.DateFormatter("%b %Y"))
-plt.setp(ax.get_xticklabels(), rotation=30, ha="right")
-
-# remove y-axis and spines
+# The vertical stems.
+ax.vlines(dates, 0, levels,
+          color=[("tab:red", 1 if release.endswith(".0") else .5)
+                 for release in releases])
+# The baseline.
+ax.axhline(0, c="black")
+# The markers on the baseline.
+minor_dates = [date for date, release in zip(dates, releases) if release[-1] == '0']
+bugfix_dates = [date for date, release in zip(dates, releases) if release[-1] != '0']
+ax.plot(bugfix_dates, np.zeros_like(bugfix_dates), "ko", mfc="white")
+ax.plot(minor_dates, np.zeros_like(minor_dates), "ko", mfc="tab:red")
+
+# Annotate the lines.
+for date, level, release in zip(dates, levels, releases):
+    ax.annotate(release, xy=(date, level),
+                xytext=(-3, np.sign(level)*3), textcoords="offset points",
+                verticalalignment="bottom" if level > 0 else "top",
+                weight="bold" if release.endswith(".0") else "normal",
+                bbox=dict(boxstyle='square', pad=0, lw=0, fc=(1, 1, 1, 0.7)))
+
+ax.yaxis.set(major_locator=mdates.YearLocator(),
+             major_formatter=mdates.DateFormatter("%Y"))
+
+# Remove the y-axis and some spines.
 ax.yaxis.set_visible(False)
 ax.spines[["left", "top", "right"]].set_visible(False)
 

From ecf1553b4a520cbea42bd44d429648130e5d9597 Mon Sep 17 00:00:00 2001
From: trananso <trananson@protonmail.com>
Date: Tue, 19 Mar 2024 16:11:22 -0400
Subject: [PATCH 0929/1120] Implement align_titles based on align_xlabels

---
 lib/matplotlib/axes/_base.py |  9 +++--
 lib/matplotlib/figure.py     | 66 ++++++++++++++++++++++++++++++++----
 lib/matplotlib/figure.pyi    |  1 +
 3 files changed, 68 insertions(+), 8 deletions(-)

diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index 23cc1c869c07..0164f4e11169 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -2985,8 +2985,13 @@ def _update_title_position(self, renderer):
 
         titles = (self.title, self._left_title, self._right_title)
 
-        # Need to check all our twins too, and all the children as well.
-        axs = self._twinned_axes.get_siblings(self) + self.child_axes
+        # Need to check all our twins too, aligned axes, and all the children
+        # as well.
+        axs = set()
+        axs.update(self.child_axes)
+        axs.update(self._twinned_axes.get_siblings(self))
+        axs.update(self.figure._align_label_groups['title'].get_siblings(self))
+
         for ax in self.child_axes:  # Child positions must be updated first.
             locator = ax.get_axes_locator()
             ax.apply_aspect(locator(self, renderer) if locator else None)
diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
index 087c193d48c3..fe16997e2131 100644
--- a/lib/matplotlib/figure.py
+++ b/lib/matplotlib/figure.py
@@ -132,10 +132,15 @@ def __init__(self, **kwargs):
         self._supxlabel = None
         self._supylabel = None
 
-        # groupers to keep track of x and y labels we want to align.
-        # see self.align_xlabels and self.align_ylabels and
-        # axis._get_tick_boxes_siblings
-        self._align_label_groups = {"x": cbook.Grouper(), "y": cbook.Grouper()}
+        # groupers to keep track of x, y labels and title we want to
+        # align.
+        # see self.align_xlabels, self.align_ylabels,
+        # self.align_titles, and axis._get_tick_boxes_siblings
+        self._align_label_groups = {
+            "x": cbook.Grouper(),
+            "y": cbook.Grouper(),
+            "title": cbook.Grouper()
+        }
 
         self._localaxes = []  # track all Axes
         self.artists = []
@@ -1293,7 +1298,7 @@ def subplots_adjust(self, left=None, bottom=None, right=None, top=None,
 
     def align_xlabels(self, axs=None):
         """
-        Align the xlabels of subplots in the same subplot column if label
+        Align the xlabels of subplots in the same subplot row if label
         alignment is being done automatically (i.e. the label position is
         not manually set).
 
@@ -1314,6 +1319,7 @@ def align_xlabels(self, axs=None):
         See Also
         --------
         matplotlib.figure.Figure.align_ylabels
+        matplotlib.figure.Figure.align_titles
         matplotlib.figure.Figure.align_labels
 
         Notes
@@ -1375,6 +1381,7 @@ def align_ylabels(self, axs=None):
         See Also
         --------
         matplotlib.figure.Figure.align_xlabels
+        matplotlib.figure.Figure.align_titles
         matplotlib.figure.Figure.align_labels
 
         Notes
@@ -1412,6 +1419,53 @@ def align_ylabels(self, axs=None):
                         # grouper for groups of ylabels to align
                         self._align_label_groups['y'].join(ax, axc)
 
+    def align_titles(self, axs=None):
+        """
+        Align the titles of subplots in the same subplot row if title
+        alignment is being done automatically (i.e. the title position is
+        not manually set).
+
+        Alignment persists for draw events after this is called.
+
+        Parameters
+        ----------
+        axs : list of `~matplotlib.axes.Axes`
+            Optional list of (or ndarray) `~matplotlib.axes.Axes`
+            to align the titles.
+            Default is to align all Axes on the figure.
+
+        See Also
+        --------
+        matplotlib.figure.Figure.align_xlabels
+        matplotlib.figure.Figure.align_ylabels
+        matplotlib.figure.Figure.align_labels
+
+        Notes
+        -----
+        This assumes that ``axs`` are from the same `.GridSpec`, so that
+        their `.SubplotSpec` positions correspond to figure positions.
+
+        Examples
+        --------
+        Example with titles::
+
+            fig, axs = plt.subplots(1, 2)
+            axs[0].set_aspect('equal')
+            axs[0].set_title('Title 0')
+            axs[1].set_title('Title 1')
+            fig.align_titles()
+        """
+        if axs is None:
+            axs = self.axes
+        axs = [ax for ax in np.ravel(axs) if ax.get_subplotspec() is not None]
+        for ax in axs:
+            _log.debug(' Working on: %s', ax.get_title())
+            rowspan = ax.get_subplotspec().rowspan
+            for axc in axs:
+                rowspanc = axc.get_subplotspec().rowspan
+                if (rowspan.start == rowspanc.start):
+                    self._align_label_groups['title'].join(ax, axc)
+
     def align_labels(self, axs=None):
         """
         Align the xlabels and ylabels of subplots with the same subplots
@@ -1430,8 +1484,8 @@ def align_labels(self, axs=None):
         See Also
         --------
         matplotlib.figure.Figure.align_xlabels
-
         matplotlib.figure.Figure.align_ylabels
+        matplotlib.figure.Figure.align_titles
         """
         self.align_xlabels(axs=axs)
         self.align_ylabels(axs=axs)
diff --git a/lib/matplotlib/figure.pyi b/lib/matplotlib/figure.pyi
index 687ae9e500d0..eae21c2614f0 100644
--- a/lib/matplotlib/figure.pyi
+++ b/lib/matplotlib/figure.pyi
@@ -161,6 +161,7 @@ class FigureBase(Artist):
     ) -> None: ...
     def align_xlabels(self, axs: Iterable[Axes] | None = ...) -> None: ...
     def align_ylabels(self, axs: Iterable[Axes] | None = ...) -> None: ...
+    def align_titles(self, axs: Iterable[Axes] | None = ...) -> None: ...
     def align_labels(self, axs: Iterable[Axes] | None = ...) -> None: ...
     def add_gridspec(self, nrows: int = ..., ncols: int = ..., **kwargs) -> GridSpec: ...
     @overload

From 2ff72be64c65750b4f42706136e66f590f33e097 Mon Sep 17 00:00:00 2001
From: trananso <trananson@protonmail.com>
Date: Wed, 20 Mar 2024 11:25:22 -0400
Subject: [PATCH 0930/1120] Add documentation for align_titles

-

Add align_titles to api doc
---
 doc/api/figure_api.rst                        |  2 +
 .../next_whats_new/figure_align_titles.rst    |  7 ++++
 .../align_labels_demo.py                      | 38 +++++++++++--------
 lib/matplotlib/figure.py                      |  3 +-
 4 files changed, 32 insertions(+), 18 deletions(-)
 create mode 100644 doc/users/next_whats_new/figure_align_titles.rst

diff --git a/doc/api/figure_api.rst b/doc/api/figure_api.rst
index 937020afd8fc..2371e5a9a863 100644
--- a/doc/api/figure_api.rst
+++ b/doc/api/figure_api.rst
@@ -71,6 +71,7 @@ Annotating
    Figure.align_labels
    Figure.align_xlabels
    Figure.align_ylabels
+   Figure.align_titles
    Figure.autofmt_xdate
 
 
@@ -264,6 +265,7 @@ Annotating
    SubFigure.align_labels
    SubFigure.align_xlabels
    SubFigure.align_ylabels
+   SubFigure.align_titles
 
 Adding and getting Artists
 --------------------------
diff --git a/doc/users/next_whats_new/figure_align_titles.rst b/doc/users/next_whats_new/figure_align_titles.rst
new file mode 100644
index 000000000000..230e5f0a8990
--- /dev/null
+++ b/doc/users/next_whats_new/figure_align_titles.rst
@@ -0,0 +1,7 @@
+subplot titles can now be automatically aligned
+-----------------------------------------------
+
+Subplot axes titles can be misaligned vertically if tick labels or
+xlabels are placed at the top of one subplot. The new method on the
+`.Figure` class: `.Figure.align_titles` will now align the titles
+vertically.
diff --git a/galleries/examples/subplots_axes_and_figures/align_labels_demo.py b/galleries/examples/subplots_axes_and_figures/align_labels_demo.py
index 88f443ca0076..ee7cac7be742 100644
--- a/galleries/examples/subplots_axes_and_figures/align_labels_demo.py
+++ b/galleries/examples/subplots_axes_and_figures/align_labels_demo.py
@@ -1,37 +1,43 @@
 """
-===============
-Aligning Labels
-===============
+==========================
+Aligning Labels and Titles
+==========================
 
-Aligning xlabel and ylabel using `.Figure.align_xlabels` and
-`.Figure.align_ylabels`
+Aligning xlabel, ylabel, and title using `.Figure.align_xlabels`,
+`.Figure.align_ylabels`, and `.Figure.align_titles`.
 
-`.Figure.align_labels` wraps these two functions.
+`.Figure.align_labels` wraps the x and y label functions.
 
 Note that the xlabel "XLabel1 1" would normally be much closer to the
-x-axis, and "YLabel1 0" would be much closer to the y-axis of their
-respective axes.
+x-axis, "YLabel0 0" would be much closer to the y-axis, and title
+"Title0 0" would be much closer to the top of their respective axes.
 """
 import matplotlib.pyplot as plt
 import numpy as np
 
-import matplotlib.gridspec as gridspec
+fig, axs = plt.subplots(2, 2, layout='tight')
 
-fig = plt.figure(tight_layout=True)
-gs = gridspec.GridSpec(2, 2)
-
-ax = fig.add_subplot(gs[0, :])
+ax = axs[0][0]
 ax.plot(np.arange(0, 1e6, 1000))
-ax.set_ylabel('YLabel0')
-ax.set_xlabel('XLabel0')
+ax.set_title('Title0 0')
+ax.set_ylabel('YLabel0 0')
+
+ax = axs[0][1]
+ax.plot(np.arange(1., 0., -0.1) * 2000., np.arange(1., 0., -0.1))
+ax.set_title('Title0 1')
+ax.xaxis.tick_top()
+ax.tick_params(axis='x', rotation=55)
+
 
 for i in range(2):
-    ax = fig.add_subplot(gs[1, i])
+    ax = axs[1][i]
     ax.plot(np.arange(1., 0., -0.1) * 2000., np.arange(1., 0., -0.1))
     ax.set_ylabel('YLabel1 %d' % i)
     ax.set_xlabel('XLabel1 %d' % i)
     if i == 0:
         ax.tick_params(axis='x', rotation=55)
+
 fig.align_labels()  # same as fig.align_xlabels(); fig.align_ylabels()
+fig.align_titles()
 
 plt.show()
diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
index fe16997e2131..0a0ff01a2571 100644
--- a/lib/matplotlib/figure.py
+++ b/lib/matplotlib/figure.py
@@ -132,8 +132,7 @@ def __init__(self, **kwargs):
         self._supxlabel = None
         self._supylabel = None
 
-        # groupers to keep track of x, y labels and title we want to
-        # align.
+        # groupers to keep track of x, y labels and title we want to align.
         # see self.align_xlabels, self.align_ylabels,
         # self.align_titles, and axis._get_tick_boxes_siblings
         self._align_label_groups = {

From 1dee172aefe6abd53a257fe3fc130baa5cfab37f Mon Sep 17 00:00:00 2001
From: trananso <trananson@protonmail.com>
Date: Wed, 20 Mar 2024 14:00:17 -0400
Subject: [PATCH 0931/1120] Add unit test for align_titles

---
 .../figure_align_titles_constrained.png       | Bin 0 -> 35117 bytes
 .../test_figure/figure_align_titles_tight.png | Bin 0 -> 33777 bytes
 lib/matplotlib/tests/test_figure.py           |  26 ++++++++++++++++++
 3 files changed, 26 insertions(+)
 create mode 100644 lib/matplotlib/tests/baseline_images/test_figure/figure_align_titles_constrained.png
 create mode 100644 lib/matplotlib/tests/baseline_images/test_figure/figure_align_titles_tight.png

diff --git a/lib/matplotlib/tests/baseline_images/test_figure/figure_align_titles_constrained.png b/lib/matplotlib/tests/baseline_images/test_figure/figure_align_titles_constrained.png
new file mode 100644
index 0000000000000000000000000000000000000000..78dffc18e20c987fd149ae3c6f8d17c25117e547
GIT binary patch
literal 35117
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

literal 0
HcmV?d00001

diff --git a/lib/matplotlib/tests/baseline_images/test_figure/figure_align_titles_tight.png b/lib/matplotlib/tests/baseline_images/test_figure/figure_align_titles_tight.png
new file mode 100644
index 0000000000000000000000000000000000000000..f719ae6931f0b0bf9b17cf6964e0fed8ef818c8c
GIT binary patch
literal 33777
zcmbq*cRZH;|MqEQmYuy5B75(dm4t+hkfg|-A(Wk!WQFV^6lG;^p_HAyQufN8&-<+V
zJD%6?dH#8xUibYfbzSFmo}bTq9LMoKK3ABwmg*S-S^@+?&Zw&?>mmrIKZ0OP;^DyG
zh;)zsfZq&UFB!UCbGYN`Vc~3rT(NL<yzk(8|K2TTcPnR?dk*$Oyb`?pytl2~1%!nJ
zxUB^(1qAO13f>kF<-IM)FDT3}%r9_}`L3(0ql+XTpWVOT&g<Z8&G!)ZYy^A+zN6X=
z7X%@;K>x?cm3w^;K?3B}l@;_nQ<la&3@HZpao1LPYj#*K$rn*QwFx_QMYB8kRz#S_
zEsV>buV@MnI=fuc6cXrXQ^{(6(n@`0{e>-Al}ZaiE+<zyg@U}YWYyBj-jTwn8HwKW
zpdqWev|mFUPCq|?_Kr_Y_4t}1p~@ae!psW4vRD!%5%do>rkY4tXlQ7}X>xh==W|Wi
zPvOT;pZGD@;738h|G$5JrHlKGo-2+ZU%${scjyeAXnjk|sR_T6BZf}dlf&QQzK7yb
z^b*cjo$d+K-XAW(KiF9f$;-PCe1<MKgvqx;eZ+lbl;*1RI=1ZYWI&ayy_=iJ@$a;g
z$?^$bB?}9dS69=b_J04G*z(Q(MtKtNx)U+);<!94;=0g>&*Zzya?8?k)yvz@&o6>W
zZrr@fN$~W(7ZDc)L5lPPvb?-J?L58E$jBf~_NvzpyUhYIxcT^~kQbYR0s^GOvb*W-
zBSO|)c(}N@>z#ac!rxaboMx2G%_n7AvUT&Cv!Z3WkkH&*PEvaMi%95v?`yGp-c(dn
z>y3nbqrJtyzNYbg{_>^eV6~2K;H@cl6q6jU?7@=I)Z`?yjg8I9y|ls{o@1UI?Q7T0
z(bLm6Tc<r_cjMe?PL##Hbm<bN|L#U7-|9VYIyyQ5+kpb9c;gRuA{`waNfP+XYG2Ph
zb?R<&S^Mx+mi*40J6lnv#>U=X-LfTd#xU>N+J+Ag4|{b66EQq-`PIcDCRRS~oTRD0
zI{4VAQ03me3(qxjv@DIv?$earAA0OicSIS>egzY$-us#Cd9YkAaH~0#(oSZ$%7YJw
zh(7ee@1OS)j@H|lIC*%2NHSZZ@(B-(7lKJJb8>QW^YUUOpL^fZOv5rTFz6c?Xl!m)
zPM8u+*XGnVG9rjn>CJ4*C{tkis^H<_@%e=a;ndWWVYxkn@BTbT>dJ&6jVmS|^6J%A
zzT-@j=kE<HT%!8VpHIic#8h}~acwV;;38;vT;$=wKx(|U6c4tS9Uc@cEZ7|GFTNA^
zSfRgv|Nh!HCE|?B3A|e!7fmZEOe<ZxZ*n4&6DP-FwY$@V7mdr7Uh+}y?d^T9bmQLm
z{d;P8IkJt(kDiy87xAB-zC|zTibutFGcY6sx6FQw0Ga!ifz{K~gCHYib^%FAG|1%f
z!Rp|^jkJ=Mx*Uz1Mp&)jYp=B$nwzoVvl@ylnigtK6!DgZO9|Ve7y?KzA0BMCq$>n0
zEdT1uyT-}MS%0)M5gmX_d~2fip`(*i!?|c_Oa})CyHwwUWidqF$mqqk3kfxK=v&h&
zn;p09r5pDrY8hZ@=lb%<8T}5O3=IwM4pLE2OwM&@QHwh=zr9)Wq|mrLv!sOLUET3M
z!(u+6-LgxO-H0eQHg^5sAeG$7p^%`UAivk<U2Ghj>75Bb)o4bU$<@_&Jny>iu0b3#
zi-??k`SPXbMmvWSWJ-#RH)XW+2Hua2ebaJV8=JM>t8!C4IhW@~KMFB=FA3P`CcS(a
z70YoI6M<CBJL*DjV`+KWfliEu@1YbfJa_)liQP!qn0HIA>^(YWH-~TO3XM%oSq&SI
z9Cp{Xj*kw4LPA0i=9JXbpz`wawe4+6+rhVI6@|z3QlC9z9WHm^`~3N{^59$3pycG_
zr=7F6rW%8W1z{O5{XLKOe$mnU?XFEVwzSMft&6!6dd_ylHTLxAejgeNW0dj2v$eII
z`tgHpdv$^@kYswYA)s+&#5gf23IFot%XSZ2qnY^Nc26P8g0S#0X=#3K;+u~$PI&lC
zDwr!>=UEXvGc&X9oXb=eP*2#kQgV4*U|9qlC*@gU+m+?z{UIm<5N4G~+Vgr`ab=^h
zvFPI@%6OOY3ki`wdi1FA^Jh(QDXH)uKW?)Gl1NBMpf`Y!Y;SK5?@Xt9jCZeC4;0)`
zWRJxc6BFw$G#0bCbBA5hZGr9mhYzJzXf|NTS0C>$Hja*(czSx`d3$?j=;yB*{)#uB
zOT!{0Bowe{#3rSnU@Isr3`$5yFs$=^m{snd|K^Rdt7{3u{P^)>C`;*U8yjR!PEMHq
zxo_VN#FrKqlah02QOJ02Q)p>vWkO_P`iDkE4ICFz@))tDq@-XYQ}gqA56yJ1U0bCV
z>pr9VGC(XmGIEy3oI#)iTN{r>D^>D55(;HBLt!XcF8BKN>y2N(UJVQk3@s?Q2v2HL
zYE-?ykPi<Q))Yca$P%cgrA3J}L*4#vp2k<b_84K-xO~}x?&J&pWXw6$z_73|sJ3U}
zI*Or{*;BO#E95tC-rU;XK81@L-p1%%Fn&yV(eT@3qXp;bJ%>EqJmqrxvB0XTs@>mT
z<w`r>nbq+UF-T?~?R<(k7nGHiCGI%s?>_YNOEMI2@-*N5Joh1VbKnQ1;M1fnEiH<8
zERYL<A3l8W-0W5@oqdy^e+nr!Z+MI&z++sdiIAi{+)ny-R~TN`l_tmM<Kxo|DP1ya
z&*pD$Z$Dh|Tw|7Jak%I7o(r?GDJExZd$ZJPb=H;7&o!*F@F$ZUYA+z6TZ@CX356yf
zbwAyHuR<=Lq{%M3_k(=-{kz(I4TOYF%)XD;xYp+*!tCtqY){A0U8weeXgmTxeZ`SF
zk^OtgJ@WVO-xu9(C$qa&X2RR{_!Qyf&!55l`36`>M`tHS-&RINQfjJcjo_87y<cff
z&^*ojjzkIy3J?T#b@xZ?)u#ywA#%sNGcOmdB8(Ot_MqX+d`=Sb{FUnQt<KMH*%|uR
z=6o+M@-!(ajLGki^j*z1?f%x{YaSuzA8HZQ0+|i5o{D%rzrTn%y1V0OdxW2~bEGv-
zHH9SW?L^BRQ!9lKwLsk{sLAOqwp9I`EJo~ixQ+|ebTQ6vHqM~LX>3mRn|{f*#8|!o
z-{CL0lkV}_n*M{2HvL?u86+tzTO+!8lld($_o1ZU-TU-O?Q@F6wS(1PX?~1lWo1{6
zHA&QS@_sRw(g&<!eWxWOCx^T%a`~mTH1q*C^X)8!A|6!1$-}+h$Z?%tpi!ZHQ8Znr
z{fbiebIXyDkr}90{j#4}0_6c3Aa|p$T<JCP>&#M(#zX)_xOWPQ@%B*hn$+Vm`J_i;
zAsQMQw1;-fOG_ja6nYLx(b2>NgoGL0cWF1z98}RA{NC8;VI<5wxR~?$H5U9<YCEV^
zbwy9Fk7vhv&gdW|Dk7rVGO43O<F=KR#b|}onE`0lQ&4lx#D@e24;+-6@Tyk1FVnL9
zR^EU0=b_mBuW0M*<B*e+FHO|dHB{P<Rc1g*M$(tfA1)7<;><n?4`)f}gbL<5*d{6@
z)bvuuo3_AvtpRsxcGk_{K*+sttGpmL7t!9y{<VAy!@sXj4?eu#*xJ&vcT$1G)^-u+
z0BR<Q;-~;dwNt_2;i0i_yuJNwWp~ea%2L>s=Q|s%u_NWScGW|LvgDEH3zYY>|8;8+
zY&dZmK`1Wk?p}|d#l*xkx3UWA>+8c=gt`Dl2iwKvca>~eKtRCuyq3+&fqi2yPfrAa
z(gl^Q+_)7J`Tg@t)7n(iY9^(}SBOvNkMzXSYe?<kMkl3AJj>IKl-jeZs;Y)YMxwg{
zNP4%Ga&W<)kI!1h@|+>v>gec@im!2^bNKQ?q@2gYGT0xYIqPO!dN>u|G_<`P*BB<z
z`_zD+#^+AuURZhcGFXG@Bpy1O95U*zeDnwlx3RHN@%2MffLpMVbk$T4R&yied{9|m
zSFMEDaBi-<IEra%YLYN8L|#c2?U&M5S6BbgDkBuUiu4fkI1%Y~3Jg=q156Yb7dM~p
z$tn8qA)vHWq|#%R$jod4$BM~kO<@#3Yoe3~FMzkTX7a1`U0p;;NlCl&uhYI&c{nVK
zUphJ7sas!sS2vwx{j#Akh*0O+wE(J{o)`lI1D<=c39FJ_Lm#XykM_5y1#V%>9`9Oi
zE{{+V1Yuf#ecAFt#1?j(sgF)+=}tpK1L8ku=Es1xWz8#BNEsMR9Y)2JUPt?NK7C3O
z!6-uub&KY{ot?m)&(z<)f1hj)Bd>6tC77O`o?KXX^3mnjt>eSJL`gR;fX769e0)EC
z{=5a<mGi=dhN{(CZ-dn!2vdLsQ0#Cv=en_oh=}m;@Z^7Wr9yGUJWV5r4d|D7-0$R}
z>*Bx}c&C!CE}5wP=-st|{DqlcllC=R1I87rwFms>^+@$*&t($DNhr}FuU~V(Zm!&0
z$fujYfPdyyiDo<_BqX%CI&l(T9v8N9{c>sm^vB(;K{E__sj}twR-Mcc`@ep@P6*hb
z3)Fx3v*N7qmXjOHLU7gGaA`h2U=^hK+4;+XB$3eudOA8R>{nl2gneGTqS{;I?NRK#
zv*Kk{cXI4KH9eilGcz-D&V6~fKYN#s4ws*Y=gMhX;oNbjD_5?xJY`X8hN@aROG}5N
zg2(dnbJ96!85vjyvD_)<(?<?BOig)S`W^3iU8BBXXxK-Wc`2(qG+K6F4I2AkcuQyJ
z<%>6~4UJb?#r?&+p|sMT4s%?aR3N3KWWRXvBDTL*Z;;(Yt*I-d^ms7<Q)LLZnjJEK
zH4P0LT^ZvS8Gc0Yy5<xK7ut(;{d$fg<qlLC85wBH-`(2_gF0(?crbB7$<EHc)iGwn
zRne6y75+NSw{rYFM7r7T?(W?>tj$@6%fSi@E{*_C%TuE40TorgD~frFpYh8ja2_p7
zDRO>{f=Q>x$H#|#O~kHo#fiK8JPk3_U21EPs=1?QXo&W1h?#W21Cj2OuV2{~)>%Dx
zAOZc4*u}*KP^9p_$F=-^wab^4prA@iOHa<s^k$N$npL{u2L%N=Iy<94d_*sNZS2`b
ziv1hE!x<(NjHg9pi{?RI&r_m2QpOojlh@3#9Z))`#jT?sUDg3gU#6xZEj^Di%FR$s
z_JFiBCMZ{E1KZqmg&<+7JKCl*J_=K_j@V`)VP$>z{Q2`hK(ypgWckI!R1FQO(V9Nu
z#26O3LTUUDZ}rn9BPAuJp<(w|hF>bd_{{KQOpFDl8vJ<sb|M1*Oe0Wg6gkrtot2xL
z+fW%1aT<laLqkKMVPOh@M`CvlI=J7NpBx{3d9s{f=Gy>$zSn%OApke#=~Mr6s!_tW
zC#@0ag=0vC1O(9RUjKA1TE0-<HUV8278Vu&BM6}QV7J8qg*-jc2X%5so8*8#UYs4t
zyY_kwy0Yy_p?>~4bnIKOZ-%8dXHkZRPtNX-^<q@!&&{jYuTQsp>gZ@xWqOE>kSH>X
zic&(oP%<$|Y3@F%i{mz!hCrzgBj+fxY$F2Nj7=wcza9Wk4$+s%KYU%#`R&`chSi<|
z<6etA=raO0YU$2WE%w>lQ0b(iq`b8<`Vml|3M}Qz2R~`Dv$KUcUu$#nJB&*Q1_w_+
z!ey+7r=Tr>Vz<-%&P;A|agf;M=Vt{gt682IlR96Smp&Wn5G4pw>Aw5~K*Bi|mJFIw
zF|9u`0p3-aEsEpyXg~AMi2{I-MNuqN;xJL${T|X@o0B3@z!Ha&*8~p;A$nyXvu_Pn
z3d_e8uU|h43?IvNzULIN%q9u+p3=p(2$}$>B1A%WKG#ECje<a$o(f^AwTj@l`chd<
zO|8ZX7Cw?a&DA@FAPPha1c5@00dSavkuj=0mSf_*2|OoshmsRUNmov-6!Ays^#Gc^
zaettuh6g|x8=;2g0-SHHTb0S8|IKw2YZkjL>YKo}0y;(feUJ7V+S+iT()?j|4A<};
z0efj^Z_gWd=HTF<prR71T50_obr^{3;hIuKMaATg_E<FaDj^*1O0Zz-7a9ej*b5#w
z7;vq<J@4ayfW^3~ljDQMBX7u+-Ic0U1ObE$9KRkdi-F%{KUvt>MWU@3KOK@qlihZ$
zK7{14i`4{HttEtZAcK^<IdGxxWp;Fo(4d-ITNSgqg^jjB7HC4(tJt#b*51Y}3NrUM
z=dpqmb>5}K#a*xQGd4E14S9Bfi|cVt&UxV17FJfLfJGS^8_&cU+*G)G_ik3(*4mo9
zf`USg)u~gb*4EZ425sng%KoI%$0tt+np;{dpoYSl*8^AVhEjads08m_^@c{khH=^b
zhUXWq@k4W3exH&;54Ee0+XG(hb)t3U%B2t@1_XgySH5wB=FaEDZf2e8xX@5MHg@&_
z<M_lxP@X=q+g&}0=0Ve0#eREfsHmi*8Q>oV0{gMM*?V<8?c@*_dheNzs>;gg`bSt0
zSkQrHqUBVKjEn-D@$vCd;Q&ENGpaWLsl!94WxRxeKM6e8xcxjX4g;~Vwf&>&+?}nm
z*!a<o3Iy(}<7W`GH$hvm*Gv-3*>iaOw~X9whT90R>WsH&d2$wRr;j&H+=&(EG_^nM
zHO|qB{b{P1l@%fghozBnVvwtp10G&|DNO^F1JxEXGc)<^N5!R&HhU2S*xe!MDQI*6
z37eds$LHqeMq#spot<4)aTK)xCQy4xMz1-R3V1vei-Tklfq{iHx5gkqB-k+Z0ra{#
z-u{6B)^q2u+}+)QP}f>X0F3+n>uXbcJ3jOv+Y(KPF#x-hv$LnDs1l?Y4*>FiYHxo8
zH5cgc>PMo#^$ZH-6p#7;i}061m<ZdiMhv>ot(}!IHFb3bCntd)&JxfwNN8xnY9Agf
zY#RPm58289&w~WV_~5|<ps9~zW61+aKpv5YcR(VngG!PGx{9O(qXPyxRBv@C(|D-r
zck9+IZEbCT=#nXtZUnEdrm5)YkV3DDPETi+2GS!b#s2#7Ik^32-&!N-)?u+G0g9Gi
z%+lkU0w{!5e9N||FS6`^n+4nLJ9mN?78XY0bvP+N{Noqtzq0zb_9~NALNe+=gS3A6
z00+=fkYdKSw;%|%LAP69Ya%|!#)gf7fgvfu{#Pi)hxRdr>MJTLIIzLyc6Mh#tb-hC
z>h4C>LuS}rR7{y)N?gK1TTwO#dgGv^OvC;RTbP4J(*4#{DwQ$hpN=&pj)r`;%g2u&
zzgIX}1}H>kWoEARUAqd1P+@^&OUt&_`u-nPHWiicZhFn17nhJ=5f`r*Pj3Z8%MYFD
z)s<vGxjb&UURk9RLVvnSwh-jX+(04S^vnz?IeD*n4XBqR4t0^J_6KEIl5U{+srvd$
zfxnmDgG#jaMQp<S>r0t(o?lB#5g^Q^L&+;7Ph^apmYLz_NAFSy=qI$Q$GUmdR!NZM
zdiwf}P!rFd>owD@{?~2h6&7A{bmRxRy7txY_=AF987PEkrGP!&g;JhPWWcBP?@#99
z;%clr-r~DIUQH7h7x%RNHiEEVo0yuC($R&Nk9!ePQc{wszL7IJkg-IYyDJ?~Ek*bh
zkRbu7fTlK}StVGhc#RxI6&015oi7s;X33-4N`+g0AFnb9x;qUpi&jwSNXW=~Cd*8m
zodx50jDw-8YB0RH3D^g%8M?Z<=AfkNWT|8TKGzMg(nh7XAVMlso01$dOIAl*oSo6w
zgh&*ZlpNpMwkf5>C8C$t*QW$z*<J2n_I-GGK~@_ybi4}}F3b(SV}eKuDJm*b=`1j-
zV}y9Wq@aKSHOW{)@yK<5^Iimv5YB6@R7`ELz;=HOtf$YOJzg2Bn(2t+=7g1jHV=*U
zP-*(^nKpp<-#|yo?YBu?`Z|d_aRcu7PFG48@F1lAs@zc^RE)#7+cBxBk)-ETm}O)b
zQl&gv0YC72u9^GnjCt^o2mmO0-23`!mRX%|x#lrqzVy8q?asV6t3%;a%Wt{vU(V2G
z=H|Y9unP5vc7A>yO>y7|z?S)~Iw-1v;AtW!x<*D%YP@&G%RbL`Cb)TN23$ps4iDEr
ztjIDhx5vZB|G2o^ZzF<=nVt_GOhL5<a)p(CAoe0O^z>zbk}>d@nVGB=A3us1{rp~R
z$;r(fkdR=&t!ga}T7ba49yV7P0U*E=)*&)MTBG~hk)Dbx&I3yq%Ujn-I6}_IVpKzK
zN075;&qltbQZyfWZ}q*%0t;e_gqHRRj0=np9vwiPaoYHyp8fi@ZLAyub<=)tGAvZh
z;S4oD0uKRnMFt9Wg~|b9|GfwUaL1&ld%2FO>6xonzj}4rn*_YOS<`_{a&qDez$qPs
zk;r%nz`js_T;0(pU;R-!c(Vz}9KYYO58xige1mr?dU_OHDH2%FV3)>g=%Dj8!^C2J
zA^)8sZ^8_K;x@nvd(X+B5|2O=0!$K!f)tQ>O5M|M!n>e@Si;j#i`l0%>nx<bdBcS=
zG{kYL@l*+<<@i2SN968PYFch4CZ>w2DpdU`_YrSxZN;hdxu11~!yl?HsuZE1@iaUs
z!tXk#jWRoUcMB+HF#y0}2Q;B!eYo=lg<{aG13)}PsW91~e`shnS~m^M9-am0#08a`
zk1xc8_m|S+a?mJ(fU24vtSSWHh*SjCqDnL_F6dM_rA@uYAj(|;Rn7k6I7rh#T6%}p
zhg~r}r<?I}^|&D5u%tXz0!c6x@jlHuXTN%7(|MMP$`W2T{HovIA3^g0ZG{e}peOiO
z9vgt7svDBA1LZSBY{KVvnbj-Jq{kPoy(-aF4z_^Hm76*MVgjW{+q%uR7vCIu1qjO^
zXk2&LbNMRs+V0lY=4N0}(50G#1uUG?{v??9?%n&-p>n_6gV%$WouSQ%R$LZ-{-SO{
z7)79XLkET#Afh4Ph%U@5EDYNeqkN;3@?#%{uz{7;c>s@&$A=FPx2E#!oSY2kTt^2x
zC|7~u6D%#f@2>E77^k2?fS^JoI)#9_ib9TV#+x?;=o11=Y!yg_cA9%da2MMVcnHdV
z-P61LVAutJ<VIoTr`v+}hu)w1`Sa)6`uZb)6;M|BK^cCYkbs4tB^HqD3<P>WO^pon
zo~Mxfpxt7;dSzGn=y_=9$|J>$dSi#0Q$dO>Zk#v)t3x&S+II@SXrA)m0Dkr9>(`K~
zD(|f5R9j(Mltu!uSlUrlRxXFijsuVXJU)IS<0<>Jx4VPU#zUbO?7T2pGLHH|)EB8a
zo^v@tKLYMQRE-wL?+-8tU5RQaLu`a;f6UG{bah1uxs#BN1<_&AdOvuez-uifZ)xul
zd4Zcdf5)s+sMdPtr~Ya(Z<j^DGFD=8G9gIvc}>i$f`-ta%2OZIC$7^f1*c2=DuQbc
z4-H}D=1WUK%7~Z(i1c~*uyi7;kK~;|_E%RYBD(vSo>}U^fM0TOkao+M?<5(|hy<Tj
zaOtveKW2th{lAVhsh5<Pp|kmcQv096K4AP>kE<Bq3vf|pE-nJl`_Gi|adS6CF-U0}
z8;8%$-G!VJ<BUy9i-r=?*wH}%bs?y*&@Mm_W`J!#zNSFYg_prdV!j|s*$xB6BDq5Y
zg~qtV#KdTofN=W$!TM^=77%Qxm<=WOdW&4=b<q?B{#Izfe*XL^v~JKjR6jx$S-6Mq
zwGX{(1OaL*Xls+eB-Q0}suUGk<e@bz#O*=UcEc4fn$^-57Z-;{L?{D32=7b&q>Xm@
z%san-|84>SHtNTZA1Z^;=;@%f0_AT4&_=?<6ip*^hgnL>*q9v%D0Kg3V6cvxb2^%7
zvJB+xn*NFz2m(=Yt0!B1cd+g_2%0)%FRQRH1vIt(l^J0BfBqiGj|E&DE*t=m11QOO
z<`##bu;dlAcRDV87XU(8qdt2zO*S$x5F4GM!AKz?gM?IvyAo<3Fo;AIhegoOZuP#p
z;yD#W1*v=r0nYvi03_&9c<C$g%j+|3Fd@CT{QVAEyl&oP{0rmJQh&7XR=v@|jUXRQ
zqLPHHZ>^5keERa`6ygKqc5Q2`C08d4K}1DG6GiQ42i}<xW2Nps$-OkkhEaX3*U$2%
z_p%6DdjaxOOSxan%*xWaemy7L5rRDW_U+s0@86RF{T#Ley#)XoG)D{s9V;Uw^z;Qh
zC>`MAd*@|!cyt6K-*g@q%QQc}-#as-oYw$byenP51Ja+BmDScwWxFITvU(|zqlt?!
zcV4YKku9?u2{x^ApMpYO;knKVggN)`#{${JLLj#ncs!h)d){*M@&?0{tSo3v-^zYG
zBrEIOZNVYC&e7eSNWsV(MdlbVST5n~!qT)$g-;j}ITE`AasnP9p^~esFj7A>L<6H=
zz)z2P8(BcJVNDn`wXv@~#U1$VZEWXk<alPyH5wM>*p5S)s8&?>htC=|(9-G}(~J2u
zskTA#sqn=dOdGXzbh_t6@4w_=eRECkZT&B)E~P?&2w6KuMn=RR*tl0GApt?jBJhI0
zlVPtBL9x{=07ByewA?N;6Jj00t$<vlR{4INoX@k9d>L+;@V0bLfK4577*zIKHkvtm
z=eIN|sbh^sn01{@#8(fK`o|}!agr(Q>pMFk`T5)c6iPcO2u?kF_6(>8K7vO~jO*`Z
z)zjOnV`5Uk1MTAxG|6QwCb5p>#6)IcVLf9MY5)V+>HvD04vWoWpw7y0q3}&ha$QPm
zZcd2fk6WGRA3bC9-|12Q`tt#+p!->Zv#sx>pOkRVI+m8!SIGM6hGbvAaU-mxL>R4?
zh~wUd)jtgYG;l~e!;-tCpp&x%)`Ogc1u+P<01K(EuIBgIb^M$r#{}E2%@vm@=D_H+
zy@V1bOa!6~ME5{w4;f`;l;_W%_XM;iVAID5L=!<;K@ougxDRN>h(AmnL6fW)*A`IT
zzrU4nIalvZcS|o3>9Ll__#~tHGi3Zt*iGJqrvCoYZoBW&SCv}}jPg{L-ejq@e<V`1
z6)Ff1SM<-1?6bJHJW<C4OK=H#7BZQ3a>#*dJH&E_B*@x;u>*t#CMW?g9BSQ|?Obmn
zmg}pcqhMkpj#R;d0*0y`03v{~WR+Re_w`XEi`q4Uat4a*V-RB-hKFeZZx5_A_4bmZ
zaupaIaICGZQKbjQbPb@08m*5pSBhQNIIGWCfrlhAGGsH5<(*d(JZl0Xhx^iNI@sQB
zm@UBwL4y=<(ztGJUt+u?eF)#pfWn{)1Da2it*=VuHNE+j5yDuxEbbj2AOF4jfzZar
zhPJNmV<^-hvsT}vxq9^~s0=7+2181!q??T+#%Us=Rsi*mE29!{byjBP^oC-U2<k`G
z)zT&vju;@Ot!-}hT{$0S^xZ?%SzGryp&XU1bWfI*T)E^ujB3+fxj)8<L=oHgvco`p
za>x0e^UK2WKvY`+wht*^RdywhGYX)YIB&VS$7=YZz4(?Qw%4Ax2E%|1%$gK|IMcED
z`B8xd00iHO_ghN530VNkBH8`KVCt0)JXG`elR2lJ&BciXd?ZnlpX3!gk9Vv-hj$&+
zC=Cq)n2WsSnSjAu!Oa@l57u9U!@~&`m6QZPZ$R0fUsgBX=W$oEx}2MjK8DeEzC5FP
z+y6tK1*s0<?tHVA$%Xt!AvLF7p8jpWJ~RJ=axL}6F{t3ba5`I~7{Y-?(9_V+z!C()
zV4hczh1CXlyXR3t@2<eSpym%jACWRK9QWxRHXY+^UE8AD4mgPUhCfjezsS9HON}1f
zH5|aNn@dC2I!Ho8H={@}3CnUU#-{Fnx?TS|D?p$?%E5}P^!ka^!&5g}t~<ULZA$#K
zUFfW-{t}a&HPiUumbGO3Q9sq(5r@}w@zeM^24&?Q5PBBJ<`IAVBTRG4Zb>_rKWeht
z;jyMqS=P#<%0X3E+tLAq^;zqROORTXE)kszdBp0Vm!-ELbiN+)MPlojF|)-xJBfSp
z9L?h%i?2<>KCR)i6nT1>PSiO)Je<7yaPjqwTO^S37{=WT7pUGH`4AxdZrZrj;%sWu
zfYEXoK6;*M`=DWN&#G#|eKLuXQMTd<EwhGvxs*VX`VS8e`FApSc_gtA()o}U?**fi
zmjpYHsva(C1vY@YN=?!GE7erXs+N2qsi$Bc?r)~$t{>5#@KQQ>T55k^;*aU%cQZH7
zXG%kFL7B*!(sE(gGWR;6bWblilk5<=vqY>Mt0k=VSZv+NTtCsWX@T+4F1ikEPoKFk
z6z4~0ywVSt>$2ZHoFC_r-6Ds(*lZ-Y56g`3%NV^lu01S+t+cZK-MKdU<Xo<H?zh(g
zLh;Rk4WrM^+LT*w&5xhP!#KV8^N|*#`?KbH2YS{_{pUCI9-+mzXTd0NSCZA&2m9g|
zBi~^T)*j-I=dbTd%nKs(MkfdwbA{}`jLx>UFtzp*oUbhV(6$g3Q)HK;a}uT|hemOn
zO1j@uLPZ~j^Wg#TggV@u7xNW9mxsid83o9T(G^5S1_qQSp&`m$X_QePoF#$yQ{h~e
z8sGroC6m&<P&dqJJtXG3$tg2y?t<_|ECXZ0ye7ECvgxnk+PT7b+iuDe@>J@U=mene
zafgk~`skCU3T;CSVsFBN=tZonAp;C+aiQ4;`q#osL*64uFD|Zz?D*fy>*nZLOm}37
zKm2%_SM;YL)gW$dSE1ZE6{)(za>m8y+<J3AEW&Xsz0??p(A$aEzLwwmL!`}7Iv;yG
z{*@s)T^O^6G29L-z8-hK;rg#jNd0Dmf|tOg6e=4r<X^X4`?|&9$Xr7`@RQw8<O11P
z4ShCIcqrS(QTKfc1FosX`$42N!|Dt~f7VhmX8^By<DsB?3Qu5A9{u`E6Y21{`a)5t
z8mmSePUp52Ci3bGL0>YB-{v_2)=W|PEYifC8TI=zNyI|rH1Vy08D{DEu$D1_zFM^r
z)jhNoBR3}7wVCpox^KbqWMe7fRo85t7G>-VGQqj%^-3(Ws^T&OC8@evA*o>{2Npsi
z#w`Et&Jntn*;r|ZPK^0PH!+cm^k*Yfy%tpEm{^~6t>zg#eNak9q<@E+ZkEGMd<z{#
z*t~kTlRcA<rm6?yVw8@>zDsgQXf`y%>AG5~)}7yjRri>ZKu{KGS_nueS}S)!{67+V
zG<<k?lye4(MdSGIOKM-Z1LBhK**AYDNT%SRgPgIf$TsJ-pYeJ~eYnzNemm{-W|+y;
z?t1-6UY+Hs`<A>;!e>yBTZwCY^{2(k&sfA?{RoTy_aiMbU^DyE-*armo#$ykU-=PA
z_f28Jk+ua=a*lUd+Sorqj7{mBzcs7R`hMu!XI~f9mG@^<Ch9nvs<+%%9MI7Am@?nL
zE?u{Rtw;MvHK1l~oLna9kTgc$=H><WH15YHI5jJjjc~o(uqf*|X8SJ!oY!fkzkR_<
ziy#UPWBfdiUU9Lm^@wh~lhBt}luXsd7R}oilbf@;nuZUsuWN|lxVp9^Sb8;SUVY`t
z%6jw^^6n(H0~gU`DyS>;L(rg;s?^qw`lU~=@F0=^+Wqd&A^sZL?zGU&CNXaz7Ht0P
za4E<;ShEpyk6r0*w8T+U`B4vY#m&tx`#W$b*AJW2;kce>ou4&**BY(<5fUsjfGz50
z*Pk_3^t~t2$}1Pq=zL1@!S`EVvemvDzfgyun9rC!5Yow~3?*<>Nlc6Fn;IoWZ%2h9
zj+@_p&%&hk<{3XKTefDE26bXw7r6Xc1J0r;H6p~k5~Ji81AS83ikmsjA0`-8e)em4
zN*J=T@Di+S?@Pp^`PJWWIrr`Ltk>mOIPR_}x<i9*Q|y1oU6t(*CueT+xEU&EzwWTL
zDPEX7kJJ-(Kf)2><wS3$4$>~v)Q#eT#NgCjyI?mb9X!YW38(5%H81?IA<lO?EZ@H1
zG*v#(V9<(1!vr&3J5PXTN}R~78poLMT0s&;Sl3H;-H=PlUInl8BOOkv@eog6N0J{n
z!u-<k0fJs!r8q*hms=q|i-cn>TLSSmH=LeJUS#cYk)!Wy=qET;%}}^z7@7dfa~5Le
zcAqfqqoHK2>GD2qez6$Kp$}7`ryb+}yrI<QO#I3hY($fxuVL~Ij$pyvuuxYuyhnq6
z5|K=?yiLlyO$L_UmgXE{Xhp$Vn|LmbF0z5KO9asltWZ@e#9G9&|It^grd%i4S?BKx
zW16kDBS`c3U<32(;M=gAD)Zr~^M+;bR<^$!T-|K8WEn@ZB6vDl=#&~?fq!bwg<Jb2
z5INpx6h~<NX{$5R$mAC37(aUte_ef8?iN1F+SW@~q<**dxJc;RJPTxTjLr=|ak|xG
zFG>W>w9pzpdFYg%p3<xFwYHDy0`L(iuB(F;K_%(i!oFIS5re+6r_xvQYN$e}TT@b%
zv*jpP-`XB|vuDbf+~<K<97lI2Yi(qnJ8?^iAP{-EJQMPf*i9huLUO2@9Q{|WhK$d*
z5<9FC1&aduri2M$Z)|>VzvOGYJaJy3kd&HcA#yL;-Fib+*~6~g?BR(@uvb%Ox5o6{
z7pUG|dM`vMT)=HvfU}=gdbEk0Fm1_7yH|uX#uqR{FoQKAODsk&&MAnJ4{#ruqTJ_y
zN!~JGQo2%z6ChP((JfSCVPl@PMIPg8xG`Aa7rl8mgvh>(Otses9MAH~ePlgvpHF=}
ztE!!$opBY{`eG!0z{d-*au0z475Sa`QczNYmyQ_NSiZ;Qn|XS-KvxBOh5~4Xm{@dW
zWiX<$05vKX^mCwUqhn)q&)dI#Z5yxghFM)uhEho5z`z>cFk587w8o*>d17Sk(7egv
z2n+I8hYoGkiM!`G3*TM}eRpoUO_lnG+L2v1igSVZDi!KyfiD=035w?C%;4$7hlv#2
z&#kq|hTMXJKo}6gz%2AqIHkpK$-Uu+pmdsplIrN<5)c=67Ca_vFla*u#oyvVl_W$d
z30Rg;M=H>n@1?d>k{&A;FO{~}^Nc0qM<O^L?n=ZCxX^F#Q;+B=70tm33!__k5Lsf&
z)HOAmVJ-#ZFu(LSZ!`=tNMcAkdGZuB4=qdzwbN~-ybE4Z;~Ntm5A;)^I+=-y3F=}4
zor9H!=L|S^o2krvFc5Uo4DO1j@$tc6YhaO;Wd!L~-rc>-oe5|dH5gXG$`}OW<6AHX
zO#~|%P(=jg??8Y5OdL>J09F$)WPoet4VxQ#lfJfoz?U``48R8EsTo<W&k(LS4e8Bq
zO4Jh0Z2E6a!eA_H0nc83(ah8|62#9bu<t1Q_(+36C8EAw9#(CRm7Y~lH^@o^t-TL&
zMCK;%1e6xXI2MV1*4ZC<1B6uh(xrycQF>%@WhIK&v~m*Y73_Em%y8DgL|)(VW(B`9
zF_9XEJQg#pk%&Lc_hxq2XHd4WUAA6u;{$4)7_0KYLVQn-JU~ogfC(%CBF~#(2?{Q%
zIXb(z7*}=No}AvXR?Hh<?wO#8!RXQr$r6%ON9w>Kog(gpiINo{AH@z6vcM-n>R7s4
zatJzNI84uGz&VKSDHs{Pq2|9NAyuj=*rZDRyylACrcYdNA4kWY9ca1K(C?3X&n_Pn
z^hmIUO@l!K@kjSULV^bM1i<^XfhvQ2$?idtX7J>sxgAymOz1HXkWPjLS5{VFEcnKt
zbz*{vi0H&Gf2CE{q5m5y7wGHjuU^sv`KYqVt?+Aa)(A9YI@pf4FhYSv2>{O#!YnOK
zAAoZP9R+30f{TTegaiQv5%GtU1Q1>!oe6x4=w=97iIjTUw^*2P7Wf0}8ED&5kiu<Z
z%*rqHn$JmC1JMkfLZaj5Zy8F(ce`0pp&fjr2*Sbf+G_;%;ocx9)J<SM9#Qnn2NeUI
z^$8|v8vndQNO{p8HOaZn>?^n0p{-2!O?P3c433*~tR#J^jXP#;_uZ#2UKp)X(P{74
zF6!5ny!4#LhfxHo*<vB!>6?NyXcqb^-8<?CQ*gZt*Aq)NIJL}p13pAbz!GQFgqQYN
zbo2OtbK9`SO9W08goCww8qyI0Q3y4Gf0}hmU}I6Pu?r*_c60t%-LU`aIjLeFx621q
zP$((UJLqU{zvph+UUZ#P&(Lj+44Dj?OBWUM^!ebe0?uNkJiYO4s*x|5nVCgk-;`c&
zCMQvp&(JpScz(fixpdI}0X>XGmnRARzx-AXd|@Q=sz4&j^2Yh1a^aTY?`qf|M*t>_
zJto0)sM(?%_dT#{Zf-^pprh#2rFv)F+wjAkGe~-RI-;O(GBH$}o-Qv%5dl&*BqUgc
z7ssY~I63{nU0tS$dJinYuwpYP0^$%RCFPQ!{K;xn(-2zLa1H3B`<kvTIJ&+a;_<(-
z*W&&Ge9ov{#-VnPorqC76l63;m_N0EZ@}RJz35l+?uq_4BD=r#$#;d0xC*{pDYDUJ
ztMo37oT3@#Dm6M2q==!a+UC{Cz`y`1-zl&H!tk9{KtQKT3#MQfF5tr~09mM{#>h2b
zhjAJN#jqgAwjd`K?$oQ^y2Xmx3u$SGb^EhKvjH~%P{Kg2;kx;&)1}Dd4&kR47V^NT
zkM3}I|KMG5GLK;qg3gG4cBO`Y`=*V0`atmHMJ;!naUCk<7NB>Hr4QhJ9!-1<&B(%n
zOZ9NqF|f>|@^>)Xg=^QYp>8QNpY>B<!^J?*xwxVtCTK_Ce?*6+P`p{Br04+K|L&3k
zb0}(lK<Ya?3Bjk`21}v?l75bE7#b8X-9){T2(zRlEvz{zMu9a#2XqsUiHB5KDv^)F
z!^3ZHaWob0Df1F^p1u3aJdDHZK#f5w{H{Cdi3YFD&DB9_G^ShO$-qq|vQJn9;#FyB
zX{5cSg$0JU_kkB5tDr1xWPP2VbkNDG9}S<CgL4Ed=BVbl+zk7aCwvdk#hIF!!GZ%c
zn+yGfkj;%SqCSIoE*6%PfP9BeS*4^b!OnutjThX6o<v87sAQpI5NHaH3w;;vk5=e-
z54Qi`1gQAzuG@xsHfL&wj0g9{tjt41r2?L63J)Z2^PXp8Ge<2T<qk|R9w_oX@{&GS
z`XKH!jg5K}ekMCWI$);xY~cG>K9a9H+_;QRuHY;SdQ1hKYk~t}8e9igB=5j90wh;B
z{L*pz=_fTj7XFhu>mop?pRDQ)ES1*Pz5=kca@?Fc_yAKP5c@%dwi6Bpu?dC?>0neC
z7Qk|dkBPwmF9&oikzob1tnNur)1f56NrZaSme<6qr0O#XKROeOS!lXMe~R;4;}v|~
za-d`}^^tWGl=jusJpC*-wi}G!-$zEWDl2JWP8R8&^6L3>3g{1}#>eP@vL&1f{Bro<
z%7vj0D-=&qocb?`EBC29+-Q5SeC+|D>M5Z;A#*UnJGxYD714t62I_O=vMg=#x!qOp
zcz{6Yb#*<)spl?s?RYA5;JyhnzF0ZaZgs-RGmspgIy;r*<>h19$9VbpRJF8-V3X{J
z%+~aG7b8AZ_|$MP5c)~sBA&mBS3Jw!)s<k-@ca6W(@dP3DLK-_V1FlpBSm=aP{IR`
zzF^aZouvk}wgx!=@mBIXOn)*Uu`5qM3LQ@G$K|^hTL-k!0$`pb2XIT2Zzk6IdL<vu
zYm6)nsVUpF694avapXl5*bkckJhJ^V2?0(WyFX!?rlZshfOm7?9mj70YnQRncd`4p
z=0CAg*}zve{D$t~$;+^{pk&h#CW;h5kMlXE_fEkU;M3~t1RVldw6o`82PFhZ$GY|Y
zbrh9Kqo}lm0N`%62hl6DmXbhn?R(gaXSN%?uWsIk+vWMWDC73<gpqJPI6Btp^Z73H
z^E=iH$eIf!aB?&Pa4R27#&$Q@In$z7rXuKA_qM^fEjYQ?(AvF^i&AVE=Y8i3>;=+~
zxpHW+BrB&o1!^qrG`_pQY9n!ZyKn2ryC|9C@#r#J)T^zv<hamHMK249m&Q)mvm#u|
zyHZoh)=lR32HbHiP#$QK-^h320pdU3-73<ElFVl&?oNM1oKlVRUS3j@Blx66qJ#7N
zIm*gsd_M4D*+ka+N4=e!o#Av7FMI-PqRv%ULTfoguA}`*o`cvJh!nneXPFGbO{)H`
zs2YbZdKRP#Vxni_F9zD+QQ2Hd6(6BGj<N2)NMn1e2?!gX@O%z_T>{<=)lNB$2+&IJ
z0>IiBwzmcsNXh-ElP<-rITtA_nox``^W=bX5+Q%@Iu99<6-KV@kx;9}D-;9g=WFNk
z`_AfQn_dXXFFZAHWyMn1(t$K)Q=h3aP$P%dRC<}eB)_U}O6@U92Hx1@&=%)Mu>#1a
zFZ@!(%S(XqRutucDw!I2jU8B2fCIB4KWq`31BEJ7%j=okb8B<jofi3Sl!)?U*KOgK
zPUS!`Cm7ll)UWd#niL3BTZ1GWgPy9iIg3(8Q8tUOAODen1G~>u$t(AOj%`@WM~<L6
zhR#<(Gy;uMRL=2x_o|~}-A{Jsi{7I2F&M2oeGH`Pi?7KOoN@|q7`G{b-0--GKSS9)
zj|Sc&v9c6k@d*~J2~+vSH3CJk$*AHJqhpI5zfzdIZTDA_T}cW?mnNK4(Y&Edn2qg@
z5<8YG14D$xn9QGL{C1)>JEQA#7FK|t{e2CrO%%E|iG1#_EQidF?8f~vIT#5AR*ZR-
z+0L+FQ?6=(D6vF^&=G2hw4=AK{NHSGH#|9%?Zbfy3lO2E)=})4gFSVIsGH~lN|qlx
zijE&`T}03fBk?x#M@5|CH?~Lliw9zFqnYRnCC1q5;gYUPzp^_$mw#OYC>J0(*}~E)
z)-FjpAAOGM-IS+3KC0o&MC<UNNhVa6TKo8hT(&&k<dCdy;(<0*7K0TkiA>A575ZHb
zI&iFAuR{d|$>JR!(wqCd_z=OLv>iVCl}Le{`m8T+RCh_r44eGp>1((+8gQ%Vi@&&w
zf1tiL$QYno*w7>+UA)$Q^C{gr-hpy9Q|<V*ogb@mUZqOjRJLJR-FzT#<lfMAetXV+
zOQ5gMhQHzi9i>b!-7EG(8y41kIaK<Spa3BLzi>bBZG73~xuU#taan@~O-N8U_FWxY
zdlLB*lQ(RGLbJ<V9dH7XmDPnuf3%1!kKHTqa<&h-m;&pn+D4|~Bxb73(b4`nNlsS_
zLDZVs*s?iHaiu}l6on6tMNl*9Sn239uI6S`ggx~y5q9>|KDf~0S33hW&V7^nbgE`V
z3f&Vlj68CR3UFqoiO;<&!C@G^UnD9@Ml^5-O#y7A0#sNJ)%TDCLp!VSXbi=g=Ih-u
zIkdQa)}W!SonUb~bJE6^1vD9DBktpBydaGLb2HUVLf05c`WjSTdy!r6it=lrcm!e4
z*|nnb`uz%7z!B&FydkH*)X<xg5Ls)Sl#jaPMF-0`7xm^jm!{DJir0Jz4MVN;aDDMt
zAU~xBHvdsz=j_7|sz8B_x`|5f<<~)ieJ;}Gbn&kQONUCZM0xVc`#DB=txx3mpzf&R
zI`i*Kp}|+Kmp?F>ws>{&>t=qDs93`r^_aPpS!VQB&iMEV)3wBD?26x*VydamCQ@BR
zxxY%D2&RzOEAzG?MZ?4nQaM@r40^3cp_@;2a~j@1OhWwc1z<|h>5#86ux8?b*5h~L
zNpNzdJs{5{_`E>IUyP%y9Jw#CC%B<uJ9)?Yk&cC|Zipobx{@+~_19Xtc&v}74L3C%
zPR}=X^(kkk_0c}c@fJdmSX^vJl}vVYkG6cEI~PcL;v+?ldi=pVHXL^H;Llk1UO0Q3
z@_J)K$7#!~!)&59bF?`W{#$-6XIktszMz~v7)WAxIOs93TkD(hY=akl5mNte?Nx%<
zt-<B5_BuxdGK!+jO&Wm7{KbC$eN)sFkYa&MQL~d@c=A9j48fk-Yj}hzN3Papt9g*M
z?C)h#?teZX)mjAC6?Cq9`ME9S3(!0Ag9FQd+UQ(Y)XmCZNL>{DwPQ)b{xv|3-EMZz
zIcwe;%yt)hO*4>hoVq*G#hNTeVR!#stzTB7&*Z%M1t;NP5N%>&Bolql_L6DI=a6~|
ze<xg(>5gq@BBcrJtJYnTHNgIOI#Keess73-sJZ7{L6CQ{jZ%PG{m7ni_qHp)rnmz;
zDNX2kKj@6v)>6Aw!)o-A7O=3lZv)9{35-+K&e5}!S2ggFcqR5(+>Q)h{5g~0(2I)+
z^2+sTb2l}w?;<%(%x0srbon%1hpk@dnn$D9*I=hUA67xmiKQ<v{Q1VaGB@0HbHVX6
zdJy7VjHyWwbU7y&TD%-5+I3gNF8CsGmy47p>afS=F!4DdlGrs+cL!Yu?2XI$0-~~{
zr>qEEH;P(bsK)@UiUpl8v+BLi#HGGBr!p~9NPqrfa}&pjlsgF<uE;-25D_jHG5XAA
zx61Gwi|7-qSI>Tc>9@%GD<k;E(?RB$11sP51y=z3Aev-mXJhN==-{2czx&)8u&Vpg
z_eaCSM#`$HO=Dv<3Q32DK1*X&R6x0@!7dL6jEt*q_BlV{rr2Fk6GgU<dQYXE_lM)o
zFfIo3E4Zt1fpM=?M1rvhlqvAeqDN`bvxeX%sU!&dG-vuwmzDjPUof0&YSug~u!6H<
z#HIS;vjLzMA>iAp9~htnlR$;z6ehSiLg6$4xB^Ik)2e{23QmUbJ5B#_i-P;3*FFt=
zf)-7|4PU;Tfg21B4{ri1Oeij+r@Zl<&UhYbp*yG1DLQa-R6K)2OK^hu1I2ZA29)Q%
zvF%5tZwv<09HO>0d<Jlg-vUt!&J<q)j<0M8+C&2QY0E~~&Y#DZlasS>aNzUWS>b^r
z%PoMvlYKtJbur`tE{lr!WQyihztWf9?@w!V=+Y<M?sAX0p~vE;md%lUcr5KS9f%%V
zLTBE*`2__Oa3|!7cmlqMo}^@CtZ&}D2_#Vj=|%-?PT_DC$8N8vh#wvBgRK(&<?~A!
zWAI6ay?8+jCv3sYh~6T4HXqKY_Suxe(Xl{k;k(+gGe1OB>YiWcz7#FyNABxV_T(h>
zGw2NM^V7fcVzJlY%L&L}c+Dy&XNJep48DUPI9h;uhO%ZmJ30cRqob+ie5+v<;IeS4
z`BSIuK2sbAoKC%dLGRXPPr#oClRoi?i8o`12UCRyqZhgp0aBWI)*^g?KoOiS232K{
zxA(3v_?VS^z}AMIqD__JKtjR)bgz?wf&ve@1ztY*Yf*>si@=YY;jC<_6?g*RR56%X
z*jw6dBYbbX=P=#<GQ<_^Q*E5vPYaMKg;zFB@&Vp$^rW1aJw2FdF%V!|@YrD3C8Oo3
zb6+;n)6<)TGpT_eADEi4!P!bMLTZ69MI!>h`PU#r+f?|Vxvj+$kyzI5p<XROl?YPh
zvDyj;HP=C>n~YIqM2{$-o+d;d{M%gI+>353&)RR}5fQ1tP#uBu8<h|8LC-0*0`V1G
zj@REs)YZwMei|$LrQa$^$rmUHAkO-|V|;V-uAlQg`8(%(>hjGi6?pMqt!Fs>tC^bG
zC!VV%Akt-l%?Uka!1!=eCxT9lNDeH0E=nwa=L!D}4*&WCD8cc#cnJ)`@fUAAmV+};
zaF#&X&W;Dwvq0-euc!d8#t*%dc`Z0~uv`gWW&j2TaGx!d{o4wZRQCA`9H>UXytmvr
zIB3A(_Uh-slp)buea^|{yFsc-(BfWyxx1~zJUcrJMwD_H3x{}66bY$#nK?Lc;RH7(
zuUTyb7&a)u1psFs?XyNWDG1=d<+{Dah+Nr774z*^vESYI2>^*1Zr>MY#YzDvnalXc
zwOwr0NeRAAI4Ux=(4UWfx5WCm_v*dQ(dtN(n}aveqnZT{8Z<hCv+AIqp{GbeUMxM~
z<>s~|%f+?nrv;h;*cb-yT}IhTU$hX16wPue3py9DbwQdofD;%ox3&%e`HT+rrD|TG
z3oeE8i{PxO`#42bst&EScvjd~v+^{6I<v^-$VaK8Flx<Z{Afai9za?iDIedmsQ1U%
zUHb5Ka%u_#L60P8e>)-mt)s1-&Op%G)Pw~tEwDXp*{@SlP~0uw`R7#3f0U`mS=w_M
zAZf6aXVbnd`$^5v6=;(1B2{B#c(`$RxU!*rdnb1N4t(JPoUr`H?k7J+B@YH$IP^_B
zc4xf$0er1Se=TU?FX$w7l9>bRaYuTdK21E6bb8m-l|R^R2L?--DwkALGT}tT_<L|k
zfh^SsDk&tlnx<yo+iRQ@sFHvCHk*H?>`!DNPW|dtRVSz7GEHS=Y*2q=l9Tg!ViObb
zAW7hWSDE3MS~*~pcRS#%XWu5CEQymGSi;t3k7bdTt{!j4>r1^arq!B^ej-E|ZKO)o
zQtLY*gTdCe?c$;$|C*YIHB_V+W-A(l<E#%(!d`k_Y(5||CQ<(dhVM4;t)U0Ek$U(t
zlw#*u4e71EYoI>Cq5qc5OW|Nh1==wF;1>f#1*&)<a5yChioPYBRz+RkAo5l}`27uh
zi|EN%1U;<_vJYxJ11agB!>gzxAC!Pg?<;%9_GUCOdI-7At?xatKG;`h&>HEj#*JAl
zFs;&uTzCQrgU1pGX8u&T2UZD*8&C<sLCFF}`8=Mqgai&arr8V!?gLe_NDbcIJPUFj
zI@Y+mA+Q%J8$;5$V}(~IVH`A(QpoD-_o{E|>7%Fn2fxAo1j7=_#)bw3FyxX_QN3m$
zE2ykAilCR!MZa_cM3t$Pm2q>mV(6x%XV0SNtH2Ffh;}1!@9q0Fg6-|?nNT7dySlW%
z;u8u7dqTk`E-ImtH*wDLb@$z7x!O^_!=LxhG9AUUyNP?LQl(u@B8l95RfCI$Ir_yW
z|7bhmlst+iCNMvM0ZJPb*J9}Vc6;z$92Sj%__=T1D8dO&@XX5=7?-~tx0@OPyDgM7
zEKpj9Xw_8i9ZlUoJa`S<Dv8*&@v@SX20bYa!Nc9-iy+y+DF$#Z(xqnd@bM9Y4Q=jw
zah7{UQL@$T+w$OB2AO>L-j8Fg|0z$!2#ok;;C=P=#*V+^OrI!(&0DsVw&zi~>$7kX
z1ABq7=IcMw&`%SP{93>Y56eX)R$jGO)D;^WG4xeEVZEdEHlEJT?a|SYN?|VyHk;FR
za;p)mF(s`RFE@j3qdE60x}0&D_n);%{c`Fw0^jK3(O(DO#BqA8>NoLaS25qKHUFW5
zn#bU*mUwynu~JeCe_SWOl{pNg?tKtXCyK!s@~Fk*dwcb<(K&v>KDxhNoY3Lt=e>I{
zkaJ2kQ?qy7LV8@^0a&LA1@LOoF>I;*M#Qrsgo9FcDEt~LsZR1U_ngyGU6hLKSm4EY
zE}0?<=Ajr2u-Qea=SO9N7pEb0tY|K2oPRcSSGlkC;-2kjovK%v5^lMa+-3QlC<78!
znFP4Ti~*xUkYbQ5LrSqQ`{|#rq}{@D?b^BCHv3)MK#;E=w%)a@b17!G0iGfu_ro5{
zw;`Qg4BcHPr9YDvI-CuBA%nC&UCVxMYT5DEncN$2&+~czlLnT4n-4fpR`$wBFThET
z9=tNPqv-mLK_eEW1U*Xsr-9WU6iP{2Cr7SPiUW>=KLc#~ETHIWUrqA$SbvWE_b4bX
zYm!`t?)smZ%@9aR0Ym$PM(Dl7ynkT?$eF*3O0T|Y9CLAIKRp$zt${VO%=W(qCLXm_
zHyY;9@ox_~m;%`grJwXBbWYy4jDlhQ-PK#@>|dGZm2O7kn}7r`?_^;~6g}hy9G{JA
zW7D7b{-=19Rb2ge4~4DeInp2Y9DiPJ1Ht}We~`7lABTA7E|^qQf?$uDq01b)JS02T
ztRt{>Auo7A5w>!Z9uuTR(IAb#8h$U1n?Js_sLgfYrEJ;%R^-k9t;jz^5jti0-mVoz
zJomS*2C}Q0+rWFX;Cr;xSpQ4%*5hq@mZ%M+IPT9IUV~rG)nTl}Ar{wla!G}3Qc8;r
z1Ipvx*6IHygVTRlb>Z~jwY^WZ`lqbvT%^h8x#9N1;P$a)$9x&NiB10cai(g%?<Ivs
z1gM-_+ghm{s8c^Wvasu-iOPm;%8lb0ihacAk%NVd`xZ#41Qo9mlF~$*-U|{p&?W-k
zgY?Lt*@9yPaF$H{lAqts`|KLiBIaF6rfc+dhoPTB@mSXSS1Ot61;8L@-g1FA2mArK
zafgl<aUBky5g?vUY9ue2=sBI>XjtK*_8oy|E^nI}^`gEXU;-h{g}t;n^?%}oxm#m%
z2Rp8Te4|U^Z6BXQkdzkvOIpQ{CZ7ryQ*oVfRaL(23KyIK%8r`j9>_!X3V6YW7=3Hl
z%m*tdCRb#AR>Mut)v%Y4>Yq3t9vMv3wJBClE`EN{l>;V;+#oOvD2%><)D^C%%g2?a
zVfdUE1+O&a<ZNTICSZnX|Io<|KF9zY3{V|zHFlhX0iKiDQ|?;Y5xP6<(qo~Y#Ce9U
z4eqQq*uTVcE{_$b#YAJ;<UgWn;DLn2kc&l;uuu$aF{}EI|A?yhk9w)#eqA}MDhNPj
znK8;Clc`}Sx^)X%^&<ys*7ld$)43v;AmU~wL}&F)eKSKZt%mw=S~)V)HNl8iW+-!k
zY&)L*$Met#1B(Y|z_E1-sU~4ya}wV4KrcOM6NHHhIDkWrc?Z-&BOiZ={0KTAsrtf*
z9G_xd4|7S)Ibe`EL?Oo@5a|fT>Gw|$IYcvm$R)c;6t5N<{<x|p=g%A7l)RzD2V-1c
z>9G^u#Upg9X}Bo3BFr9OgJ%$=o=0x62lZ`XGsdK(g%Ym#aT+3(p2HSuR33Rv8OgAQ
zm8v48HqC{yPky8<I+lnkDVnfhn%JQ>H#KL}=SvShUoh1$8=q{FK*V{c>)qoA4-T2o
zyM}>A3S0I|nc=T%&|8@gT8;XVp8bZ>mv?}A{6lKrl=eATnz8e!sg~|p(JvFyi(h^i
z3a~s@q9Y+ax|E@7xmT-+)R!nc;-6*S^$PPln^~3q*8)4DW%e%%EL+<BbF4l4|1rRV
zIpi_}(HJJ&3_F?PWF*h)b;};B#7|bcHuoJ)Fa2Ogi-?!f|LW|_<EdQ#?thbn5}Oby
znJZJ2NEt$u2n{GhL=%~Zii9#}ND`G$qGYa+DI`=HBvXo{QyD5!h7ixX=$tyk^Ll=-
zUw?i3=Ip)geedhOuJu{#y@)5Sz@fDO>P7k8GdCA^OF$RV`|oX=kWlGB+1Bs3x0%g^
z**Yxbpp3hs8&S8;chs79kG#)Tk?K=@#u*vVpU+5p_Ik>Jszh0;tNOH<IPvLv<ErhN
zi@AO0^G_e>sO-qD>Row|ky^a7*bf*#w6b<M&irE>ALeIY=EcwKGgRZl5BVrVPMET_
z@+>Cb#L=r+gV|YqyL1Iq6?eKW)Afe%-o^c=`37#{YcnkP?}j{rEz9+fPI-Jq{0h_J
zRnM?8;C;{<Pw<?1^VkNzzYMMX4-$gAxS@MufVS*Wkn5!dO!)N`{__Uf#Z5F7c%;Y|
z*4{D+9~>uEfzb>9x`oc3va?<`{qCs`KWikT7nyV4duFhe{P-rFC+@mC-RH^Y@y+@C
zF>w9UZ|~=6LGy~TF!8g$noUs&0*{(hHSVS_p!wdC*fYOufC(4sx9*NGj2D+Hyz5@4
z>9%Im@Ls6GP=R3G#LDl+b2vaaId<A4bK7G3Ut%inRT&|nqKmc7>0eyy_fX|-`4hbS
zV!k#FE}O37emmb-VjiTOMd{*Nch4p_bJE(L4S1i!P-k>zQPLqVaa{YwknqEdtah-%
z{i<bgfK}=C3rqWhBK#STr>^}z^Gt(|Vqx49c`mQkx-N)&mR2{G0$KRsjGVcS#%GYx
zLsmXF(OqrWjmD4ASYj9}?nFRD6v7K<i=$3ITbiC$<tj1v?a_5J*M5}BQORO!U2Q_#
zc~R?@;GbGGc2GT|6VCD5D#?q{iP;jcQ6jSQ+dDbMmvPqSX7g$?@k`FOW7~7d?2<YL
zHEZh{HF})77UdSK;SK+fk-lpSz0lHa#>T=BH82qD|N8a0wDGc-mO@u?NKKF^0?Nw+
z^<&TeKRA~1*Y{dWUXQWO82KvXTjV^cXmICE{f^m5?DWWiYG8tm(Pf|QOK{W>C+b-?
z?=s_m-Jj>;-LbhvCg;EgkO6n=p8w8G6`12FujKJDSfTy!3<P3j>1WKyg(<~z4<R4o
zXmJ!ycY^eRV<`+;S)NX5YZ3gV24-pgaJ5W4tKHP&bdC3a_5SF!4uN&1hEx%udh`h4
z^+L5hw_t0|+k<qHy6=Jo1R@OP?obmsM+kt>sF1u#FE~nw201xk|M8JL@W{wvurg*q
zPivL?|1c}rrZ?qEZMnX3WH0gF_av!3Ib+k|HqboQc~Zs+Im>tzZ$5-9?;%{0bNI_{
zOs?PNzl4W{fF3G>X~J$aM#CBZ+b$(J#b60L>;wdu(Qf|&QXxTf5?vr8qi4~>&|g6;
zO3`OxEush!J8tehAg~q=C2piIa==lb%3;Nb=xxp>&qzn%=m-24Cukb$aWUB$<vso`
z`j;+#_3qItbA!%r6ld;$%t0ayhdn*%DF{rm`|B2qh={!MC?@&srz&HT7|pxmwG;jP
zYcKCnAIVuRykw6(zdm5$*^nzM5x^xz0vH~$3)Uj?fj~K;b<d=u|0eQ8QwDwK$pPe7
zR;z!~eC?FPQw^bGO5%AoxfPSN@y1bwBWl#XO|~=6UnIdsT%%2E4)_&ue)bT53HXyL
zTx6Z$3hn#roe#Uzw~e}u9m!bh^f$3yOBzm+FJHcl;M3vDKzxglQe55GmjL?L6?0=V
zvpED=IQvcJ!&fD2I7s4vX@9O-5?&Dynp$JCv-{eNb6Cfe2U&0euyQ;QnrnFMP`mFp
zi<_L~0|PE_j=W5`r2w47bB}@2@0xeG65`zy&VGDQ9$SpVjH7DP!sNrn$2V+2{DnB*
zz@%Ygiwu<d;&P<z-3BH@$3k}X;?2^r3MQ}5$f*Z=?%`VjEDSVH+g*rZ9x|?2rOV`3
zRor_=U;G<ehub-OO+0UE{4IqG@ZSZ_;XMvt;;Qe8YgebGHSrhuv-xbAK|MNhZFWL$
zuM8#?{*yoYd`QTU@NhskefutUmzJle64E_i@Yl+!6o*wIBrf)n3sMWG7P3X;6F7So
z+49F@OC%*5vWmGtL&V{?*~{>vH&2$3eD)lpy<%}KPqBC1ppB0O<Ws0Fqxs^WUXv&>
z42lNnjjb|%ka~!;EK@cvhqx}E@?8DRwxML65x%P@aGvMX?)8<^99bb-?>l$yKpR~P
zM-oV1ptH_E%n9%y2(kb*RWvqoK}l`3{}nb%%JNzLudLZCPqw4D8~{XRfT=LkuyNG~
zt=`v2w>aI9jaB5UkJ(%B_Mwd&;)TMpvbpWnLwHcwa2!tzfae+~w}*vFN=;={Ys;h)
z^dFk-*JUy8DJS5%s@a_*vE{YE3V|*W+~3_au=Fel>yCx*5v$p!ftD5%0#_i0JA`7t
zJXzC6tbkx5P!uR&a|BfQ;ULt80n_Thfj`YZt-X41nBr|G2%rp;TzY8Ee`e0?C4}YM
zo^5J&!sa0E-2Lfev*5z|2jS!J?peb#6Q|;>^wTo~N$w3SJJ^&$t%h1vE}nRl9@Zbm
zUG$URpZeq+c%I5w8*<*(cqiT7gBy-(QBO5TI>TvgimIYfen(*QA%S*=nKLVpTSvxu
z%H}gD3#GaS2DiDm7~;;KC+UA^p*QnuqhRe@W#8%#t|S!lnK~&PFlYgMl)J4_ZvU=H
zd{>t}nw2p3EQhv6(UoY1<zixt&|SJ-m#Kn&f<%8fjAB}2*N)*10ViSBNe!C3)AAq7
zQbpr^b%gu(=kT<9T^7e&cm`%E37(Vr@B{+DK$7yOPjk3^Y@xk>Kj^sH)6)|kF?eZs
z5hVn(b?b?*%8H8f32zWNTuZ#mzP`R^vve+;Id2@=_91j}EZx>wH`eHx3Uh`lZ*h+V
z`;R;%euz8qP;N#B;%IZB2=4Jw6ZXLT3M$HcBm&4B7?Z^1Z@a!}7F6{;UGvt9Vchix
zGeRDbJ`7%O;QJt(dM)Tg7gcIMb#~rW;cl?~HPd=~XR$F!YT?%rT6p_#9>?UG7&gqE
zg1TEpETkSRPT@KGmROZ7lGSe~a-LP@sgCM~5B-k|rMz`amiu`Qx!LcFmrAl<$f+i$
z_@Zk2Z&?B^PGL*?Cw?38<ASh%T+nY|O<tjVKGVmZ3qQQ%drIT{1&P7O<)(rJgMS4H
z3@_wPPqZ-hMv~wrc89Yu0%LspuQSYwS)!ss_2=wjbdDYpS@3fXXRrx7C&o)Sr4XIz
zcSFc(F)mt^bmm$oT4SE=w{ITh-s`fq1ZhYGGcWEgWeH$`!cy^KT<&)3PRq7GRQjE7
z5Fh^KRVgK@-05t{wctQ?|I4<Qh|XPUhL{j+>OJqlbdbRR_6COAtsAh<GQ4o}v(u`F
zw%eH8ZdT+t01l!d1vXf>6lM<xm}{cqj<Du)r<$x-%3;2CH9s9KDyy;KI<0I{h_Y-=
zQoH}|;19cAY~(Dqq{$Ntk=GNhihA7$E>5Ak+8RTQDxl<$l?iV}dxX*9l7a%fI}#XO
zduk)wQ~F&b|Kc5bSI*UEl@~<Zr{=CFW^-(lB;mH6+R^XZCdV-@5p6-6KE}Kasl^t&
z|6NP_{FVoLQxBg3xtcfzZnvJdcDtQT9v*MLrv{TBTYie5pzH!U-u~_`%e5^R7e<8y
z?+hh^Lc$!X{K^=;VoEBF{OntDgxR~R%|3WIu`8rTy@f3x_?qYs=TxdYfGg+b%Jn#M
zU_WexE$BCOVhbtyfe?XeW$|uZ8?O)mdu(4~8ht~2A+`KYw(8Z!mB5T|bb))Oy0|Q1
zCiUoO5@#o)+bKmMXhVH!p0Zn9Hd!4ItGPEZfp<F-@Ak$XnBYc+^{-NJS$ZH0q&O@>
zGqf`)Db5;n#B<zk*|~wAHE)%eugJOATeB_SSI=XjyZ7xtB+O!O8Z@9%bZB}o&)vga
zNrurSy}O}3oE90nD0BB@Z#0aTVRHtnUq%jD!l>1tbEn-LR*$!W?fovdPAl@A#xc>>
zU0d3s@=RV$(l)z(CpLY_qc@-g<M$H9;f(D6Y~(CkJJixD1w)q8T`_W(8&(p_R0=)6
zlNE;e%FFvaE6*f9;iToA7xf7r8{QD<fr}{y56zNY(qQ|<d})oVL`0JMC3P5}O!zn%
zUAG=%z(=vk$XRsa!f6=i5;A?X!i{&?a`9vv5hsRO_Vu4;f2Vs#NEXh`QEVms{Dudt
z$|Vc2sS?2_vD3_9BUiPQ{=MHUA$iM*93_;z<xju6jHc^-DQg@QcW%QuX7@iFA^i3U
z!PoMz2KjHvT!+PCYTy$jg0t$*M=*-*zM~wrscJjES9gmr>~+a8#7i;$QwZcy>`?Jz
zUYvIdGGN#)XNC{6mvvY<`VBgJ*FEvG)`L=EMPkf9eba}CZ@PX4u8R+Ux<RC4?@qfx
z>e{Pzl1n*kONx5H_E|D?*Lufl)(tb`TcTtHH%LR?-`yZ^VuAaxlVm?Vw@X2a=r>@~
z$7iFAIHp^wQD%i|v$)k{z%N5cl@%kXCzlP<a*z6mQ61kQC%nnn^o<AW0w;V!8R1J?
zobxH}RF`{^Y})(D*$<Czdm(a{mQ^ABCw|E<haDZs<3l<*uZKL(F{J>hrAHt==ZJ{S
z`$3N>^vU4+*U}pBwKY}v^zsk7g^FJ}8Y}f@$e)CH+EMugtF|j{7AF(B!v)RPlEdTu
zt{*TWylB2ogizV2PgwE4!CYp0R=*&z=HUzop)hS)AI|ouXT-_Bj`%XoaZXPwQ_Xm^
zdQhwppXlcor<Hj}T#S{dj!!j3*4yGD;k%;IsE@i5_X>}@z{}S8;tu(Od1AS2i<S?P
zepC6no}yeA^&I~&GE+nI3J<=tCB>g>ju1t`#CcTDmi%O%UXAOQYMH+qLo^lmA4+Pu
zJaH$U8Cbk9KS{u<edt|t^!K>ZrAVUYmZ|PlsoRL0P;ghD!?zy`7Ji<su;xkG=5V-r
z^ztP#DR}1AP3Q5dgB{|x5b(m4Kg?<pyN#`u#ai_w;UuWxiN!$vK}FcVWx(KXkD9%3
z6jtW$WEBv9Qn9%Jm+9v&_{KVo1Wv%b^TS-Z|3R1KW^q72_DRn>^LDs_9?9gd(5tlz
z@P0W+$Y;;vG+MMSW=r_kakDRtE$z!!yr~Hc-tZa{ep94X+gf($%g!sW^c@zxYN{h6
zS>yV85eenJIkwqk$ZWpkW5u{7h$lWMGz!>t`YU!}nzJ_Yv+~l5`8Hhp*tv|DH#(>6
zm6lcam`pBQ(82A6Ccpc|9o^s6z*BU%u37(xHL`wH5VB;+)}-hlDI@(*|5DLe9Jo1Z
z2fULXnJ_`hZqzb=!tgoP8&8aQmrGA9cgfmb`MQdaIoHrBUpAI}(Tf5|q78Sdx}k`!
z=M_78obIbZu*<B!zH{x^CmQh))mCsYI~zI`6p&CG{sa7z2>(NRgXZDLN>@W7%TQ{V
zQhbq!>^OLg*UVlj$H7G)LU6t2l@Daw|I=N0<s{sdr|59AAoFpDK||uUP0r)x=oF%L
z*a{Op&27QowZN{d<#a1u5NmzT5g{!5mG7XGZth;V^bfa^L@KSV;#UNJPTz~oc<JT%
z4|f04T*(l`267C=62pfP9=u<3=lCz3)pfP_o?lzo8RD+|`geEbQO~g8olW3_IK6+w
zixHlnq~shG6_vpzi5Q)auL?Oa{R$2ZMOe!6g!eylSqp}|YyX+c%CG7X2}q2Veyg*C
z6$(wiO&spvr|9Z;&@b^XpZGCGs9fOI<2?IE{yVfegn_h#^b?D+=QlO*0NlA)+WfEx
z97F_A-z+f1ED#8~>hjGFL=>_IAYKtF2^bL!Fo}b^Rx<Xvn7~$MQaB;qgTcXY#}49P
z(T!K6VLo^lESXzlfRm820z!Mn>5xq1Nz`Np+u9_lo0!rQ&=Ncanka_=zc<IOSsKW#
z!p7cL98)f|-kp<TY+cmstxxJSht;}(e_^i-WaY%jZTJ0Cg76&Z5C(98<RnhDEC8T`
z_@oK!3$dIW27)<2C&hL^7AM=86i7<fPcEC!8m=YWJ~<fHf8pl#k*96Tj%|JzqlC!t
zo-N)!;E$OAb7D9717v0LXh4Amu&aj&s9F&6Jm^>O#h?)b8}Ro+ppzBrnV7`Qm$yAL
z&2iuRG(if44NX10aCUWkY%IV~2(=&msyEH62ku-QP~fht-HjjY9{FsQo{bUj`u_3P
z>(}dL;!|R9`|`bEBmD?qpv>sBKwSXo6oAu-R9m2%q4e26Z&M~GHvFwVlNfmu^gmiA
zG9J`4e2CtfDAnq0LCh><dW)M)+mRVUwyxjajork67%=!%2ibK}wzRag1cQ}k*9_1S
zd@X`1qg}#ybw~hmQulC#zO{#ig@u92MV<%$_XPz<0tN1bAkr!a-W>;}3G!aF_4C-_
zuDzJgul@F2<&DC=^pS&OtI2Moix_|`k|DU%pss}AC6ltw`Jj>kp*!TdKs|YONn_Th
zG8C;uT9kUe0eq~8Dab+an2#8lCQ<!~Z_H(3|0R}O*-e`_Gg5@qfnONez>H?^4R8wJ
zgae=*l~k$))R$c?@JE%kwdoeT)BNoHwXa$}gv$jUgxfj(vCN6^!s!4vznmpJ9P)gu
z_&^tY`#zhQ`M|&fBMS>4)#u<T-ksfpGc_*1p3-aGch;Q#P0eQQate|P4&J#L#);I;
z7ei4MK!`g_rsb2>jS?SzlTTpfY9o4qlbf5ruGsUl2f_r+tjTR_%|eR(c@0}cQ+#Ul
zXY=0`lS2czaPK0?^;CKIl~nC-dW+-D&Q)S%BD<=~e3WKlcb!A@@&|WAHYnl1N#LF#
zA<RbE7Od2%+FogGBAEpI7QAwAyLf94pEXl+9PulgO#79Qj3o<~{2IE04>x+PaV+`5
zI05i8kp}_BE8bK1ds54yL#uPRK_aeDcBVQd>)mSoxzb#5=UUoEt&}ZRIM?5Q@}wH_
zT2|@y-k<iBYsMs0Rs7^H=SqQ;>sJ*p?t2#|%LY1y?<hg0zkl0pwhsrc?zQtEbuqJn
zkcVzma0A{MA|DV4Gn{lsUfzJuA*Y}qd-(Fpmwy|QJF2#xfbnvpR;H0P6vYkTYs2~V
z=KauQrT+J^F%V~_M3Ox$0rbF5fj-4x&|Jo^Rw@UGAU?IGvjCW?flms5O5PsGKUTYU
zAFr#cGp$bTYmR#!yD7KtDD96MMSh7P=hG3L(iPJ{Ek-FP$F((Y9O6%f6S@_#61@R=
zZap?Tu9Zm__<`iu+VnS{b}dQfyP^LBKEaV0q&5M@hbU+z0QMkn18GDUfidEt@bFj#
ztO=;zfDFo_Ife3#jpYes6Cl+>$vBnc!-hRc18W+=I#O!C1QSGmh^dlfw@?rQ(kjo=
z^w*M8me}D)OPO1Ta?dLA*>avATXF-gzu%21J%LA}{%uPsLlXpyQB|E)C#yh<&&!6%
zPT_mp=xFdAl?@M;(%N2+=#d4cI$Ke4UY>252EjHp4qwGmOVxD@zSx(@40d_|?`oGT
zq?{xoBH}KbofS^I(SakhY?%&xF)X0}J}Y$H=L{X%a}Vw%gvjfE@!~~@((It(vBL{f
znr<@K&F6Y4$!z3l=7KvCQf0aj*x07lmUC)=vYv{M55ujjvb}v#V`Jk8GE%o9d#+x&
zLUh~K0W5UBTFDi&Wl9VjRrOWAi$JNla`IGIQ=!B=<S%L4mTbe`gLjklT}y|DtA#=~
zcrJ_S$?uhtlFB{ubuWN%m++nfcm{jl4{>v4W#uSvfw4>g8i-=2v~|sA5g;|Y?L>z)
z^8^sa^z?Ja{6b)VSj^C`roiSlRN}tt$mL=|&dX8S*FPHqG7B-9ot?d|^Q$!G6j(dx
z;OX*gHr7~%<5OoEXio^Ez*8@BZ+%76@#o5%hTh{7B`ds-L`v_<u1*RlzEsaNzOq!n
zvj71+t%mo+W%>Lgs;sJ##!TklfW;!rG$9yvTqq@xjhw=`@@Txb-;K%Pzr(~I=_I8p
zuM_ra|8b(4^4M!WCNH2b!e$0#5&V86^NOi1#ro>s2ddVcM1Y{lKSw0xlEDG?kG;Xi
z{7Q<oimDjud}A6Lc8`Y&EABG*2|799G1ur&`zgRQcJ9!VYT|!H4~PW+eOa@OAL1y!
zYs*qtqKy_+rPZcjb6A7(S_JEQM8GnX&jh#xuv}bw@QYgWOa1F=ZZi1kBr+MwQl1KX
z-dst{$xJRE>L^W3`*nF+!nu4b05K5Yzqf8YZ9Vp6%K<i+C{$q{lQ9d(D`Ym(3)7s+
zfI})=_<dsks!)j-az+fc_=KZr>k=_vM$JrGT%PPqxM<2>ZHpNBaF_PJ#)=MF2n+VA
zd&cAtK46@Ax4}R5fGzL14KI@*gT+|)y!<PFRKQnJPka?FQwQ1lOS?|XkPw4|2lsrg
z_rmUq4S}+BE2(Ll{VM*)e$$wfKsT$amJk>4ye2mkfI0EnMM*x^Mck`Z4lkzzL)YAa
za-b!G^oQ;`4Kah4<4P<=k1p!~h9Q(1nF!frK@Ee!)4v%j!1;-RXdzTDPXaPoV_AuH
zs=ix~Y&mI7f34=fL~+dqp&|3zp$#Q+Cg;wP;V<st!sQGG`UHcfaBL&wR7DY{r)+c2
zkcYKhs<3miS}QLIqy2l&PRUx*Ukf@074XG{E!6K;`{11qbAQRUQ+^3S;R?Lik2(_N
zVXPbLm^#ie?JAMIyx@Z`_Fa|JS(fNaD*bLbXB7G5xOJ()`~P{SYRw^LdmRaXGb4rm
z6^3?J^w-3vP$z=~b@J+U;}q(I`GXH0_W9Jz<Z>*}xVgPZL|_;*r<(F92%*dpkx4pf
z)sW`MbUn^_Q~(m(r_M&5@xE;;RR20vTlYtDB4;g3B0k(vK0d(5b@xYn&d0*#5fhs=
zZ5ZynxIh<91-dzFH+u}>00`iJlK+j9>EyhF>x$UCr&Y-c)sW!UBG~K?szlAE4huq+
zY#5EBbVMLjzP+QTx$Yc2F7jN@Eg~PKrslK3J1YjfdH&*?K$Sd2+fBd3@2AZ^-mbC#
zP_CBx!FjVLM1<rxs<>FDG|A=4N*g-&-#3w^JGduhd*0!pm%{fYulvWI5amEF#^I@R
zB7}-6c$Eyy)3x*+XU+MD)T^S+l{hN@^8Y4DLPvThpEs4zwj4z+W>Dv}6@81&za>eh
zN8(U#ZV*AzZW|#C%qsTMSvZ$hR?Ih3Ev?>i=Ur!!y?<fSc=S~U^fhgC$>Y5Cp;61d
z0XE_Pm<V+!Cje?h$+$PiP`t$Plym$NVwy?Bivkmdp~Tpm!_q%p!*JE$I~&H&S<Zch
z_$rP<O?LkkRXh4BG5CH<1ESV@iMeSjqesU<eUa72=uLxhrg7L<6)8T2HHrO&H4$Pa
z1dBq^MyEXan&-4T_)PI~MBzB9a6DjgA#Uch8FtMW0vStTIew5p%uT~Hor?79XX{d?
z<;KPJUmmx^_3<0gM03lFWBC*h3*4brp>c%Or@`RMob<#S*}|hY{vk#RrQyj2KLcq3
z`jFx~@orWzU!`wtQ3p$I4$helsVO9#AYw_>nYmYZghdPH!Q7}@M7DClx8kUt`!Ww=
zzw{+;ro(CTBjPbm$FzlntP4i6o67bHwN^GZsdw%Vo)F+vTR0*-$g<Z#*N<IIH*qL#
z%!y}npN6K*ADeArJK&nqeJ7{8=>8h@EAaoUdOk6GJp$_@kOJUC{4$iR9EaNqZCZ@v
zEG>QWX}_rRO3guBcO+F~H9*`=zl@1vh)pAVXI1lph#I#l{O}euP@LsnZvUZ03KxTs
zn6z-X@6DowX(jS<U|jC26RyS&0nhpi5mrqQVUD6S8Xb^ABaS+Yh~}WezF{<EN3D4g
zCJV&d1ceQ7FXW_-Cl_(jqM8(N8>E$YJR!Ek#qNrl;k)S%^T1NE+~J52E~>h`i^@j&
zVg8x80CBNJB>)Fjk!oE?wTx<yhBI4oa-D5lj1UR3Q*{-O8DZ*sWBHiY782YwSv7ft
z_PZhRvgvO676#E6oqI>U=EsJn0~8bh&mezYbZ~G_p+$<O`fhH@(sQNh<c2boC7qbI
zBQpKnj_3-_dDLiOi9b@cZLKe?od|qKum~Z;0>hMTf*y^A@kM4VFyaw@BBFmp`V&&#
zdda}*o!=%B@0;bKPStzqQjVaog{Rp?zU@lkXxVX|<V2?d39vO?>YKYS`Bo7(Vy1_Y
zMIuiiEan@24Ro;1LmOLs-b^D3c8dtS69-^vDdGPmLf>C?ZHBI*@H}3y!4weh+-t8}
zF|=ala)lV-i9#p;@2iOqgw~z*xJD*9$Ba(jYt!0iFST)zp7&?&c#Vs^RsU*^s3=>i
z3qgZj-gSzg!SI%26ftdVS~_EmlhG2n`Quk6)-(AX%1@{Qe(hAPFN`<Ur=%AV2}0BJ
z<3G)antIg?{W6L6s*zl?r0FRYXyJjwyTvV_9?6Gmf!BuwCg<4q%GUT58c}cRUR>SI
z<OfEwFc1Yq^gu*nVZmze(UsVY5}-6_Di!xM&#!im{rtF`=g-l#e!y2_ep=L};@IB$
zww4&9VAq-Na`Ki}x&9b;FLJzmHZ__X&g77wMV?GJncV|^k@T0qTLHsE$xy2un4mSG
zToTJYKAIr#lnmSq&zn~<c@Q~I*dL&Lf9Bszl^JpO&h#pjZkx)urr9Y5cfXxAOJXyt
zPT+bN69Am?gJ9D^z$mc55DN$5^vLcn3_q)nj0=Y9k;H+G*bk|AAUJh^cY1{4#a_Ct
z<;k9eS#o5b8!=0^T(7}rd)B$2Ii)xTL!*r^nhEFOqc@$>3volc`i=Crfg&JL5u^tw
z-~N6lC>QWBFc(M)aB~x)Fy(vm<_a;r^KP{RQg3{&4#;|KWuYv0`}jQKYf5X3(1T63
z*CBh;q2AsyAP6H6U|;wlP`vUv4FAc`&;yyb?sX`TEMV2FEP9NI?gFXAs3^bC(9rjR
zZra7qS-#XCB3p%Sr>U*N)lb+234eZ9<fed>t2N~EX)ATm-oD5UERT;dT`4Ky$5CnX
z=D}H;JkS$_GQ#AS&~k+Fjaqkvx{Y2mWXcvCOg2~ovdb-!^eDc1_$h`RxBTD2M>RqF
z7%;3oM8fe6fv;-ayB)G*vENz5`sH{e=Z7Hi%7%~JYK0{ZJUD3Al7n`*{d1G=Wqo~r
z!B^h(dO7O%c(@f*-8T@J+KfcZeSbz7yVOUeX0e~&^Q}lqUeLP6)LLmQJeuyW<F6gU
zN)4tK1_l&cWc92qL;d~xZ<Uxy2c_G+UE%mU_*S_}BDS`Ff>XJF@U}tRIj8xW*h0Ry
z$l7$sH9VyIZIE*IT&+{Z7dO8Zv(<b2#MefS7v2>dUQ8U101*Q6=z=yeycy31&}WM7
zl|9KXkpL)fZ@<%?zFO9`Xb~Q*n>?CVc+}U=G+xDvHtWzAQH|20si=~>{w|1-g3{7+
zseT-}cB56YbpSx-a^SZKFq(3op`LA4$U!K~z&YT)^4ZNC<XWY3%rGPTdjQUelMv<m
zCmP}oE@Hx!0e&d3*}{tzp&+E}rkWO%oUitBMCC?@T=06ZO5@jgsw=ug0X3B9T3|#>
z3!G~Y;~HeCeufM#xUWH-OUwM{!yno#VjY&J4hPSPB;l@$g{_#`LqF7$Cct*!qk7~R
zu!?3DmrB!kXR9!;!>Rsfa}$Q^Fd5>{e-}Ib`=6h6tJP(8S2KtKN5!G7u4!Z9aMZEK
zN$A?Dpyv7Y`-&8USXa>@;xLOE86DN(XQoA2Ed$RUuerghOVq;pKKsfK{7v0v<(V7t
zB|-WDAaqnw9LlptViLBBsOV_xm9A@VJjrl1-5WOOu=!%Z6c8Vh!5=O|47R$iS+bf^
zdOTCC@`vwSz!zR=CjfN4mTT^9KlfF0t4;QmEB1P4yYH=i{i(Z?Pov@Vd9S%&uL_X;
z#b32mVRCf0a&pR1GRX|jOPa<3`HY*+%d3@URPS)K&R9X~j;K&!P$zH9aP^X(Ram@8
zoZ^qLbxvjZ${@JvhWoUkZFqj`^266WO`~Yvz9;b&P`WLF^T%<Yv66eq|E+PinM#cB
zP0z~GvbA0I>eZ_bw6&SH8}*t45krD#@TnkLss$@bp7oi$DkX_|EF>UG=q6vkYLp%O
z(G&il$*3njI{L)%<MhPf@$6Y{yOMdMtg5O2d|&~filGS$vc$`?*XPoB>8)($u>_!%
zDbC5+nMRsC5%=s&iM2Sbl;OpJzBMEXHF5A?kIGY&g7F}&){rH$WC=S6#$53E@DL3H
z;_&VVr$q;cqT=Hvk>FboVSWAK!?$zt^0?4mscmQcE};~nH7ZfV!yBdT(g!VoA}9Zf
zwN^+`(F8p%Cjqiz5p3Oi@hQ4NNl9%<X({QE^N)^>#?6EW5`ubgzTpR;%i$oCrkJQs
z6t-P2urPKXhqcKcp(O~=94HE=fu90kS!PPQwx;K!E{<|iEQcUhC?Z0Tcmet4g2cNU
zCP)r#k6~^Z3rQG5@+K#sbCEVv6jdWcNs4R{x7FOfJqF6Qyj>F$NLNuYF)3|mpwkWG
zlh@h5l4M42?t99O=ewMmn#yJ8;y9OIaWRrSU^|<XGUP}#jiD^?E;=Mhon3LpjT>9c
ziaqq0o~`N~$FrS8jCXc`x}g8HO@Sb`kh)W0|NRTx+sk~)&^lX+f>(!?bPeklN-SIE
z4=&JQl!ii_M-K^VqnTjROXAKJpmob6Z=&$YN`c>Q==g$E?}1t-8loLLUBHUg!Askg
z1%!u(o1huhqZIioq<}j~W>uZZ87O8tH54;%FinM$NwFhBYBxC2rv*j7t3Kr<B9!Tf
zf}UDMcQAbroVTBu)K=SzxY}i~b~Sa~$T#``!3VWjSv|KQC_!EnA|@ZHo0x3SseyTa
z%jt3OhF!dk8jJbD8S(bAj*bWT`!5z1U4K5wZ3&oVR2>R|ZEOhS{f3449ywmv4fEWU
zj|_-Vi*a?BR=2e+#GC9nd5mzpv6|ln0H{~WF?|s4paLV?qA<{%C{o}^Dk?ypqu*cb
zj-k&=)J%usilr#Bae&d4MC9!ApZHu&S4sdpeqv%`Fg3g=S6}0>K=8Fa^YIF&vzh4K
zyI$}L<xbF?IM$~u0A`64Jd%cHi12Swt3o-wEaIMmlX2h+g9@ZbLPH14A9n+JlS9Iv
z^S3#MYmx7u<c=E*a7z)A9j*>iaAt)|4|?H@y8NCwluYS24pQ%#wpAP#4La_uQ3Enx
z&St}fiKDNR(x1BEzJ9_Roi`}{<-IqirYTi<jRW`PtctC#Ru1LCL->S!X^aj6aU8g+
z$sNTvwQ)PK75cdHdM9s5TaHeb5|k~WR&0OHoy;avCOXVoNVf&J>3DF$RU+^(0t{=F
zQ*gAt?><55OFRc{A)#`&6}eYJdz7`Vo`a<Hfy6WRcJ32v%)QSpkPz-Enw<ahB|SL?
zp%Y)@WZ=fy2Vij1ie}bG!m~r*wb{4tEvlQE+us)&CcbQJ{H2ylCOe|Wb5am^K~(YF
zMaDRcI8I6X4K{c9>l|pjlzn<TUMi?{#IsjAdkAekPLNYqeJ|iv??9d1-LlCaj`!}}
z18II9X|F>KR5*T_Y`v!MdyB3o2L)-L@J5QTX$>QdS0Gu3!Ugt^je=-sPkUOUZP>y!
z+_*l;P7_P-tzOb5(9^RsJ8N26Z!HQ83YzgtSbsTOiJ}#7`-0Rjsp;vl!oisIY=4qb
zI=V<_sH&E&+R=yp-FaMGjiyFO>l+(4<0TuVHzEkmT7A#e%?+!|_6r$bAG>X@fw>yJ
zp+X7@#-?KMxZ$H@Vr8`tzs??|Vw)1A_pKT=ECE;p6<z)a#)5>d2j)UEX>8#|BR+l(
zU!brVU8=!Q-ZkQty^O|+WLMq?>fJv(I~%Q092i`YJvoLhhQ$_4g3#KfQ4cHufgXH0
zc2LJSaBG=|Hi+xCZFyy?GbJ@&W(<P>iIA^e6@czY%A*iWM-i>t(CBBAReBcNB1y77
zT395oU(R}h4`(+Zh*K*x#(+?}cQ}uaIMb;e9c(o2M7QweoE!tDOBa+-FA)m&B$}~=
z5p2gM^*n6aoG4Mc1rDUp4@)=ZB*gO1%Wop-PJH+%<uiATo2da6{PIGzp}uUmk#(62
z6(k>#T542nVe&K&&(2!C=F!uqJm4)%m6f-)hGIr?605V0!3D2FuJkQNy+435!)RtU
z3L+NU$eqJ(>v=>}Gk0%%RFoiubn!o23PIiH24IjZ6QGc(W1;RT!SO=t=^Hq$nFZa9
zYp{rriJsNIed45H6qh0?IyKEqK$D4$`pWtfElgw&j*Sf3%j}QoV3+<UZVb0i$6LDC
zylq>?g+B6aj@P9$nz(z-F_Z(DU}S7eVYJZxq`UO8W$Nfg$KD56gx8kdrsM)K)W%{0
z(|kpJJqI3GYM~shdv&rN5Wi5nVhok1_a=zDkiQdDHrbdU6NkUvzYoU&{`$8fmeDeg
xUNs7T)J~NRF6LQJJz`o+m4{LE|L6bEU2OUy^2g0Sl#)=?#`T*uv(zn*{}1D<ZIS>0

literal 0
HcmV?d00001

diff --git a/lib/matplotlib/tests/test_figure.py b/lib/matplotlib/tests/test_figure.py
index 8ee6aae99361..ee9c54d18159 100644
--- a/lib/matplotlib/tests/test_figure.py
+++ b/lib/matplotlib/tests/test_figure.py
@@ -66,6 +66,32 @@ def test_align_labels():
     fig.align_labels()
 
 
+@image_comparison(['figure_align_titles_tight.png',
+                   'figure_align_titles_constrained.png'],
+                  tol=0 if platform.machine() == 'x86_64' else 0.01,
+                  style='mpl20')
+def test_align_titles():
+    for layout in ['tight', 'constrained']:
+        fig, axs = plt.subplots(1, 2, layout=layout, width_ratios=[2, 1])
+
+        ax = axs[0]
+        ax.plot(np.arange(0, 1e6, 1000))
+        ax.set_title('Title0 left', loc='left')
+        ax.set_title('Title0 center', loc='center')
+        ax.set_title('Title0 right', loc='right')
+
+        ax = axs[1]
+        ax.plot(np.arange(0, 1e4, 100))
+        ax.set_title('Title1')
+        ax.set_xlabel('Xlabel0')
+        ax.xaxis.set_label_position("top")
+        ax.xaxis.tick_top()
+        for tick in ax.get_xticklabels():
+            tick.set_rotation(90)
+
+        fig.align_titles()
+
+
 def test_align_labels_stray_axes():
     fig, axs = plt.subplots(2, 2)
     for nn, ax in enumerate(axs.flat):

From c947700796ed0351bde362c16771d78d82196ff0 Mon Sep 17 00:00:00 2001
From: trananso <trananson@protonmail.com>
Date: Wed, 3 Apr 2024 14:00:50 -0400
Subject: [PATCH 0932/1120] Switch gallery layout from tight to constrained

---
 .../examples/subplots_axes_and_figures/align_labels_demo.py     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/galleries/examples/subplots_axes_and_figures/align_labels_demo.py b/galleries/examples/subplots_axes_and_figures/align_labels_demo.py
index ee7cac7be742..4935878ee027 100644
--- a/galleries/examples/subplots_axes_and_figures/align_labels_demo.py
+++ b/galleries/examples/subplots_axes_and_figures/align_labels_demo.py
@@ -15,7 +15,7 @@
 import matplotlib.pyplot as plt
 import numpy as np
 
-fig, axs = plt.subplots(2, 2, layout='tight')
+fig, axs = plt.subplots(2, 2, layout='constrained')
 
 ax = axs[0][0]
 ax.plot(np.arange(0, 1e6, 1000))

From 0be9cca9683f7ca632f0ed35bf380d73b3d412c0 Mon Sep 17 00:00:00 2001
From: trananso <trananson@protonmail.com>
Date: Thu, 4 Apr 2024 11:11:50 -0400
Subject: [PATCH 0933/1120] Increase error tolerance on image test to 0.022

---
 lib/matplotlib/tests/test_figure.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/tests/test_figure.py b/lib/matplotlib/tests/test_figure.py
index ee9c54d18159..58aecd3dea8b 100644
--- a/lib/matplotlib/tests/test_figure.py
+++ b/lib/matplotlib/tests/test_figure.py
@@ -68,7 +68,7 @@ def test_align_labels():
 
 @image_comparison(['figure_align_titles_tight.png',
                    'figure_align_titles_constrained.png'],
-                  tol=0 if platform.machine() == 'x86_64' else 0.01,
+                  tol=0 if platform.machine() == 'x86_64' else 0.022,
                   style='mpl20')
 def test_align_titles():
     for layout in ['tight', 'constrained']:

From aa9e209eb278691d73b929a3386a35134f333823 Mon Sep 17 00:00:00 2001
From: shriyakalakata <87483933+shriyakalakata@users.noreply.github.com>
Date: Thu, 4 Apr 2024 15:49:11 -0400
Subject: [PATCH 0934/1120] Update doc/install/dependencies.rst

Co-authored-by: Elliott Sales de Andrade <quantum.analyst@gmail.com>
---
 doc/install/dependencies.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/install/dependencies.rst b/doc/install/dependencies.rst
index 4a5d8c8dd4c4..45dc249832ca 100644
--- a/doc/install/dependencies.rst
+++ b/doc/install/dependencies.rst
@@ -1,5 +1,5 @@
-.. redirect-from: /devel/dependencies
-.. redirect-from:: /users/installing/dependencies.rst
+.. redirect-from:: /devel/dependencies
+.. redirect-from:: /users/installing/dependencies
 
 .. _dependencies:
 

From 36965acc863a7303478a1a8a4e9461e4f26807c1 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Wed, 3 Apr 2024 00:43:57 +0200
Subject: [PATCH 0935/1120] DOC: Move bug reports and feature requests to top
 of contributing index

Partially adresses #28005.

The two sections "Report a bug" and "Request a feature" were burried
inside of contribute.rst. They were a bit foreign there because all
other content is on direct involvement with the project, which needs
much more information.

To keep things focussed and directly redirect the "simple" bug report
and feature request topics to GitHub, I've deleted the sections and
instead created two cards at the top of devel/index.rst with
essentially the content of the sections. Note that I've the list of
things to include in bug reports because that's covered by our issue
template on GitHub nowadays and does not need repetition here.

Co-authored-by: hannah <story645@gmail.com>
---
 doc/devel/contribute.rst | 49 -----------------------------
 doc/devel/index.rst      | 68 ++++++++++++++++++++++++++++++----------
 2 files changed, 52 insertions(+), 65 deletions(-)

diff --git a/doc/devel/contribute.rst b/doc/devel/contribute.rst
index 510b67eead91..4c6934b25fc4 100644
--- a/doc/devel/contribute.rst
+++ b/doc/devel/contribute.rst
@@ -163,55 +163,6 @@ a new PR; duplicate PRs are subject to being closed.  However, if the existing
 PR is an outline, unlikely to work, or stalled, and the original author is
 unresponsive, feel free to open a new PR referencing the old one.
 
-.. _submitting-a-bug-report:
-
-Submit a bug report
-===================
-
-If you find a bug in the code or documentation, do not hesitate to submit a
-ticket to the
-`Issue Tracker <https://github.com/matplotlib/matplotlib/issues>`_. You are
-also welcome to post feature requests or pull requests.
-
-If you are reporting a bug, please do your best to include the following:
-
-#. A short, top-level summary of the bug. In most cases, this should be 1-2
-   sentences.
-
-#. A short, self-contained code snippet to reproduce the bug, ideally allowing
-   a simple copy and paste to reproduce. Please do your best to reduce the code
-   snippet to the minimum required.
-
-#. The actual outcome of the code snippet.
-
-#. The expected outcome of the code snippet.
-
-#. The Matplotlib version, Python version and platform that you are using. You
-   can grab the version with the following commands::
-
-      >>> import matplotlib
-      >>> matplotlib.__version__
-      '3.4.1'
-      >>> import platform
-      >>> platform.python_version()
-      '3.9.2'
-
-We have preloaded the issue creation page with a Markdown form that you can
-use to organize this information.
-
-Thank you for your help in keeping bug reports complete, targeted and descriptive.
-
-.. _request-a-new-feature:
-
-Request a new feature
-=====================
-
-Please post feature requests to the
-`Issue Tracker <https://github.com/matplotlib/matplotlib/issues>`_.
-
-The Matplotlib developers will give feedback on the feature proposal. Since
-Matplotlib is an open source project with limited resources, we encourage
-users to then also :ref:`participate in the implementation <contribute_code>`.
 
 .. _contribute_code:
 
diff --git a/doc/devel/index.rst b/doc/devel/index.rst
index 3ddbcba198a0..3525510cad18 100644
--- a/doc/devel/index.rst
+++ b/doc/devel/index.rst
@@ -13,10 +13,52 @@ Contribute
       of this document as it will have the most up to date installation
       instructions, workflow process, and contributing guidelines.
 
-Thank you for your interest in helping to improve Matplotlib! There are various
-ways to contribute: optimizing and refactoring code, detailing unclear
-documentation and writing new examples, reporting and fixing bugs and requesting
-and implementing new features, helping the community...
+:octicon:`heart;1em;sd-text-info` Thank you for your interest in helping to improve
+Matplotlib! :octicon:`heart;1em;sd-text-info`
+
+.. _submitting-a-bug-report:
+.. _request-a-new-feature:
+
+.. grid:: 1 1 2 2
+
+   .. grid-item-card::
+      :class-header: sd-fs-5
+
+      :octicon:`bug;1em;sd-text-info` **Submit a bug report**
+      ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+      We have preloaded the issue creation page with a Markdown form that you can
+      use to provide relevant context. Thank you for your help in keeping bug reports
+      complete, targeted and descriptive.
+
+      .. button-link:: https://github.com/matplotlib/matplotlib/issues/new/choose
+            :expand:
+            :color: primary
+
+            Report a bug
+
+   .. grid-item-card::
+      :class-header: sd-fs-5
+
+      :octicon:`light-bulb;1em;sd-text-info` **Request a new feature**
+      ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+      We will give feedback on the feature proposal. Since
+      Matplotlib is an open source project with limited resources, we encourage
+      users to then also :ref:`participate in the implementation <contribute_code>`.
+
+      .. button-link:: https://github.com/matplotlib/matplotlib/issues/new/choose
+         :expand:
+         :color: primary
+
+         Request a feature
+
+
+We welcome you to get more involved with the Matplotlib project.
+There are various ways to contribute:
+optimizing and refactoring code, detailing unclear documentation and writing new
+examples, helping the community, reporting and fixing bugs and requesting and
+implementing new features...
 
 New contributors
 ================
@@ -48,32 +90,26 @@ New contributors
          :class-row: sd-fs-5
 
          .. grid-item-card::
-            :link: request-a-new-feature
+            :link: contribute_code
             :link-type: ref
             :shadow: none
 
-            :octicon:`light-bulb;1em;sd-text-info` Request new feature
+            :octicon:`code;1em;sd-text-info` Contribute code
 
          .. grid-item-card::
-            :link: submitting-a-bug-report
+            :link: contribute_documentation
             :link-type: ref
             :shadow: none
 
-            :octicon:`bug;1em;sd-text-info` Submit bug report
+            :octicon:`note;1em;sd-text-info` Write documentation
 
          .. grid-item-card::
-            :link: contribute_code
+            :link: other_ways_to_contribute
             :link-type: ref
             :shadow: none
 
-            :octicon:`code;1em;sd-text-info` Contribute code
+            :octicon:`paper-airplane;1em;sd-text-info` Other ways to contribute
 
-         .. grid-item-card::
-            :link: contribute_documentation
-            :link-type: ref
-            :shadow: none
-
-            :octicon:`note;1em;sd-text-info` Write documentation
 
 If you are new to contributing, we recommend that you first read our
 :ref:`contributing guide<contributing>`. If you are contributing code or

From 04c322de850ba74ff282fafa94d69d53b06ca18a Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Fri, 5 Apr 2024 00:04:55 +0200
Subject: [PATCH 0936/1120] DOC: Rewrite "Work on an issue" section

Make that section more understandable and actionable
for people unfamiliar with the GitHub interface and
the pull request process.
---
 doc/devel/contribute.rst | 23 +++++++++++++++--------
 doc/devel/index.rst      |  2 +-
 2 files changed, 16 insertions(+), 9 deletions(-)

diff --git a/doc/devel/contribute.rst b/doc/devel/contribute.rst
index 4230d68c26ce..e6263d317f73 100644
--- a/doc/devel/contribute.rst
+++ b/doc/devel/contribute.rst
@@ -154,12 +154,19 @@ Work on an issue
 ----------------
 
 In general, the Matplotlib project does not assign issues. Issues are
-"assigned" or "claimed" by opening a PR; there is no other assignment
-mechanism. If you have opened such a PR, please comment on the issue thread to
-avoid duplication of work. Please check if there is an existing PR for the
-issue you are addressing. If there is, try to work with the author by
+"assigned" or "claimed" by
+:ref:`proposing a solution via a pull request <how-to-pull-request>` (PR).
+We ask PR authors to
+`link the PR to the issue
+<https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue>`_.
+Such links are be displayed in the discussion thread as well as the sidebar
+on the issue page on GitHub.
+
+Before starting to work on an issue, please check if there is already
+a linked PR. If there is, try to work with the author by
 submitting reviews of their code or commenting on the PR rather than opening
-a new PR; duplicate PRs are subject to being closed.  However, if the existing
+a new PR; duplicate PRs are unnecessary concurrent work and thus are subject
+to being closed.  However, if the existing
 PR is an outline, unlikely to work, or stalled, and the original author is
 unresponsive, feel free to open a new PR referencing the old one.
 
@@ -183,7 +190,7 @@ our code consistent and mitigating the impact of changes.
 * :ref:`pr-guidelines`
 
 Code is contributed through pull requests, so we recommend that you start at
-:ref:`how-to-contribute` If you get stuck, please reach out on the
+:ref:`how-to-pull-request` If you get stuck, please reach out on the
 :ref:`contributor_incubator`
 
 .. _contribute_documentation:
@@ -236,7 +243,7 @@ Instructions and guidelines for contributing documentation are found in:
 * :doc:`tag_guidelines`
 
 Documentation is contributed through pull requests, so we recommend that you start
-at :ref:`how-to-contribute`. If that feels intimidating, we encourage you to
+at :ref:`how-to-pull-request`. If that feels intimidating, we encourage you to
 `open an issue`_ describing what improvements you would make. If you get stuck,
 please reach out on the :ref:`contributor_incubator`
 
@@ -260,7 +267,7 @@ please follow the :doc:`/project/citing` guidelines.
 If you have developed an extension to Matplotlib, please consider adding it to our
 `third party package <https://github.com/matplotlib/mpl-third-party>`_  list.
 
-.. _how-to-contribute:
+.. _how-to-pull-request:
 
 How to contribute via pull request
 ==================================
diff --git a/doc/devel/index.rst b/doc/devel/index.rst
index 3525510cad18..f6075384c11a 100644
--- a/doc/devel/index.rst
+++ b/doc/devel/index.rst
@@ -81,7 +81,7 @@ New contributors
 
       :octicon:`git-pull-request;1em;sd-text-info` :ref:`How do I claim an issue? <managing_issues_prs>`
 
-      :octicon:`codespaces;1em;sd-text-info` :ref:`How do I start a pull request? <how-to-contribute>`
+      :octicon:`codespaces;1em;sd-text-info` :ref:`How do I start a pull request? <how-to-pull-request>`
 
    .. grid-item::
 

From 22b4a52f9c2740bf1c4850c8938962aceddedc8f Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Fri, 5 Apr 2024 01:48:24 +0200
Subject: [PATCH 0937/1120] Apply suggestions from code review

Co-authored-by: hannah <story645@gmail.com>
---
 doc/devel/contribute.rst | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/doc/devel/contribute.rst b/doc/devel/contribute.rst
index e6263d317f73..9d476bfd81b4 100644
--- a/doc/devel/contribute.rst
+++ b/doc/devel/contribute.rst
@@ -155,12 +155,10 @@ Work on an issue
 
 In general, the Matplotlib project does not assign issues. Issues are
 "assigned" or "claimed" by
-:ref:`proposing a solution via a pull request <how-to-pull-request>` (PR).
-We ask PR authors to
-`link the PR to the issue
-<https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue>`_.
-Such links are be displayed in the discussion thread as well as the sidebar
-on the issue page on GitHub.
+:ref:`proposing a solution via a pull request <how-to-pull-request>`.
+We ask pull request (PR) authors to
+`link to the issue in the PR
+<https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue>`_ because then Github adds corresponding links to the PR to the discussion and the sidebar on the linked issue page on GitHub.
 
 Before starting to work on an issue, please check if there is already
 a linked PR. If there is, try to work with the author by

From e3062cb78a4d3c8298e57ef9611b9fec2265a274 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 5 Apr 2024 01:16:28 -0400
Subject: [PATCH 0938/1120] DOC: Prepare release notes for 3.9.0rc1

---
 doc/_static/switcher.json                     |  13 +-
 doc/users/github_stats.rst                    | 660 +++++++++++++++++-
 .../prev_whats_new/github_stats_3.8.4.rst     |  78 +++
 doc/users/release_notes.rst                   |   9 +
 4 files changed, 719 insertions(+), 41 deletions(-)
 create mode 100644 doc/users/prev_whats_new/github_stats_3.8.4.rst

diff --git a/doc/_static/switcher.json b/doc/_static/switcher.json
index 75301fbb142a..b49e478f28e4 100644
--- a/doc/_static/switcher.json
+++ b/doc/_static/switcher.json
@@ -1,14 +1,19 @@
 [
     {
-        "name": "3.8 (stable)",
-        "version": "stable",
-        "url": "https://matplotlib.org/stable/"
+        "name": "3.9 (rc)",
+        "version": "rc",
+        "url": "https://matplotlib.org/3.9.0/"
     },
     {
-        "name": "3.9 (dev)",
+        "name": "3.10 (dev)",
         "version": "dev",
         "url": "https://matplotlib.org/devdocs/"
     },
+    {
+        "name": "3.8",
+        "version": "3.8.4",
+        "url": "https://matplotlib.org/3.8.4/"
+    },
     {
         "name": "3.7",
         "version": "3.7.5",
diff --git a/doc/users/github_stats.rst b/doc/users/github_stats.rst
index 8dab8484d6fd..e52a85a3f840 100644
--- a/doc/users/github_stats.rst
+++ b/doc/users/github_stats.rst
@@ -1,81 +1,667 @@
 .. _github-stats:
 
-GitHub statistics for 3.8.4 (Apr 03, 2024)
+GitHub statistics for 3.9.0 (Apr 05, 2024)
 ==========================================
 
-GitHub statistics for 2023/09/15 (tag: v3.8.0) - 2024/04/03
+GitHub statistics for 2023/09/15 (tag: v3.8.0) - 2024/04/05
 
 These lists are automatically generated, and may be incomplete or contain duplicates.
 
-We closed 3 issues and merged 27 pull requests.
-The full list can be seen `on GitHub <https://github.com/matplotlib/matplotlib/milestone/89?closed=1>`__
+We closed 85 issues and merged 387 pull requests.
+The full list can be seen `on GitHub <https://github.com/matplotlib/matplotlib/milestone/78?closed=1>`__
 
-The following 26 authors contributed 351 commits.
+The following 170 authors contributed 2480 commits.
 
 * 0taj
+* Abdul Razak Taha
+* Adam J. Stewart
+* Adam Turner
+* Aditi Gautam
+* agautam478
+* Alan Lau
+* Albert Y. Shih
 * Alec Vercruysse
 * Alexander Volkov
+* Alice Descoeudres
+* Allan Haldane
+* Amirreza Aflakparast
+* Ananya Devarakonda
+* ananya314
+* Anja Beck
+* Anjini2004
+* Ant Lockyer
 * Antony Lee
 * Anvi Verma
+* Artyom Romanov
+* Augusto Borges
+* avramid9
+* Ben Root
+* bersbersbers
+* Binaya Sharma
+* Cameron
+* Chaoyi Hu
+* chaoyihu
 * Chiraag Balu
+* Christoph Hasse
+* ConstableCatnip
+* CozyFrog
+* Cyril Gadal
+* Dale Dai
+* Daniel Bergman
+* Daniel Hitchcock
+* danielcobej
 * David Gilbertson
 * David Stansby
+* ddale1128@gmail.com
 * dependabot[bot]
+* Devilsaint
+* dohyun
+* Drew Kinneer
+* DWesl
+* Elisa Heckelmann
+* ElisaHeck
 * Elliott Sales de Andrade
 * Eric Firing
+* Eric Prestat
+* esibinga
+* Eva Sibinga
+* Evgenii Radchenko
+* Faisal Fawad
+* Garrett Sward
+* Gaurav-Kumar-Soni
+* Gauri Chaudhari
+* Gautam Sagar
 * Greg Lucas
 * Gurudatta Shanbhag
 * hannah
+* Haoying Zhang
+* Hugues Hoppe
+* i-jey
+* iamfaham
+* Ian Hunt-Isaak
+* Ian Thomas
+* ifEricReturnTrue
+* Issam
+* Issam Arabi
+* Jacob Stevens-Haas
+* Jacob Tomlinson
+* Jake
+* Jake Stevens-Haas
 * James Salsman
+* Jaroza727
+* Jeremy Farrell
+* Jirka
 * Jody Klymak
+* Jorge Moraleda
+* Joshua Stevenson
+* jovianw
+* João Andrade
+* jpgianfaldoni
+* jsdodge
+* jsjeelshah
+* judfs
+* Juhan Oskar Hennoste
+* Junpei Ota
+* Katherine Turk
+* katotaisei
+* KheshavKumar
+* Koustav Ghosh
+* Kritika Verma
 * Kyle Sunden
+* Linyi Li
+* linyilily
 * lkkmpn
 * Lucia Korpas
+* madisonwong210
+* Maggie Liu
+* Marc Bresson
+* Matthew Feickert
 * Matthew Morrison
+* Matthias Bussonnier
+* Melissa Weber Mendonça
+* melissawm
+* mliu08
+* Mostafa Noah
+* MostafaNouh0011
+* n-aswin
+* nbarlowATI
+* Nidaa Rabah
+* Nivedita Chaudhari
 * Oscar Gustafsson
+* patel-zeel
+* Pavel Liavonau
+* Pedro
+* Pedro Peçanha
+* Pradeep Reddy Raamana
+* Prajwal Agrawal
+* Pranav Raghu
+* prateetishah
+* pre-commit-ci[bot]
+* QuadroTec
+* Rafael Tsuha
+* Raghuram Sirigiri
+* Raphael
+* Raphael Quast
+* Ratnabali Dutta
+* rawwash
+* rsp2210
+* Ruoyi
+* Ruoyi Xie
+* Rushikesh Pandya
 * Ruth Comer
+* samGreer
 * Samuel Diebolt
+* saranti
+* Scott Shambaugh
+* Sebastian Berg
+* Seohyeon Lee
+* Sheepfan0828
+* ShivamPathak99
+* Shriya Kalakata
+* shriyakalakata
+* Stefan
+* Steffen Rehberg
+* stevezhang1999
+* Sudhanshu Pandey
+* Talha Irfan
+* thehappycheese
 * Thomas A Caswell
 * Tim Hoffmann
+* tobias
+* Tom Sarantis
+* trananso
+* turnipseason
+* tusharkulkarni008
+* UFEddy
+* Vashesh08
+* vicky6
+* vigneshvetrivel8
 * wemi3
+* yangyangdotcom
+* YiLun Fan
+* Zach Champion
+* zachjweiner
+* zoehcycy
 
 GitHub issues and pull requests:
 
-Pull Requests (27):
+Pull Requests (387):
 
-* :ghpull:`28015`: Backport PR #27955 on branch v3.8.x (Add a draw during show for macos backend)
-* :ghpull:`27993`: Unpin numpy 2, build against prerelease numpy in CIBW
-* :ghpull:`27955`: Add a draw during show for macos backend
-* :ghpull:`28001`: Backport PR #28000 on branch v3.8.x (Fix color sequence data for Set2 and Set3)
-* :ghpull:`28000`: Fix color sequence data for Set2 and Set3
-* :ghpull:`27990`: Backport PR #27988 on branch v3.8.x (gtk: Ensure pending draws are done before GTK draw)
-* :ghpull:`27988`: gtk: Ensure pending draws are done before GTK draw
-* :ghpull:`27986`: Backport PR #27985 on branch v3.8.x (TST: Remove superfluous chdir from tests)
-* :ghpull:`27985`: TST: Remove superfluous chdir from tests
-* :ghpull:`27976`: Backport PR #27975 on branch v3.8.x (DOC: Fix typo in ``ax.transData.inversed()``)
-* :ghpull:`27934`: Backport PR #27933 on branch v3.8.x (Update "Created with" url in hand.svg)
-* :ghpull:`27933`: Update "Created with" url in hand.svg
-* :ghpull:`27926`: Backport PR #27875 on branch v3.8.x (macosx: Clean up single-shot timers correctly)
-* :ghpull:`27925`: Backport PR #27921 on branch v3.8.x (Avoid modifying user input to Axes.bar)
-* :ghpull:`27875`: macosx: Clean up single-shot timers correctly
-* :ghpull:`27921`: Avoid modifying user input to Axes.bar
-* :ghpull:`27903`: Merge 3.8.3-doc into 3.8.x
-* :ghpull:`27889`: Backport PR #27888 on branch v3.8.x (DOC: fix stray release note entry)
-* :ghpull:`27888`: DOC: fix stray release note entry
-* :ghpull:`27849`: Backport PR #27754 on branch v3.8.x (fix quiver3d incorrect arrow colors)
-* :ghpull:`27859`: Backport PR #27858 on branch v3.8.x (pin pytest)
-* :ghpull:`27858`: pin pytest
-* :ghpull:`27754`: fix quiver3d incorrect arrow colors
-* :ghpull:`27847`: Backport PR #27846 on branch v3.8.x (Make example in legend_elements doc more generalisable)
-* :ghpull:`27846`: Make example in legend_elements doc more generalisable
-* :ghpull:`27802`: Backport PR #27794 on branch v3.8.x (Remove old reference to 72 DPI in figure_size_units.py)
-* :ghpull:`27794`: Remove old reference to 72 DPI in figure_size_units.py
+* :ghpull:`28024`: DOC: Rewrite "Work on an issue" section
+* :ghpull:`28011`: DOC: Move bug reports and feature requests to top of contributing index
+* :ghpull:`27747`: Move doc/users/installing/ to doc/install/
+* :ghpull:`27952`: ENH: Align titles
+* :ghpull:`28017`: Merge up v3.8.4
+* :ghpull:`28014`: Improve timeline example.
+* :ghpull:`28019`: DOC: correct path to mpl_toolkits reference images
+* :ghpull:`26981`: Fixes Issue #26377 - Auto-escape % Symbol in Latex in pie labels
+* :ghpull:`28007`: wx: Fix file extension for toolmanager-style toolbar
+* :ghpull:`25556`: Display cursor coordinates for all axes twinned with the current one.
+* :ghpull:`23597`: Always use PyQT/PySide6 for GitHub CI
+* :ghpull:`28013`: Avoid plt.xticks/plt.yticks in gallery examples.
+* :ghpull:`28006`: Fix deprecation warnings in ft2font extension
+* :ghpull:`27723`: ci: Enable testing on M1 macOS
+* :ghpull:`26375`: Add ``widths``, ``heights`` and ``angles`` setter to ``EllipseCollection``
+* :ghpull:`27999`: Remove documentation that some backends don't support hatching.
+* :ghpull:`26710`: Add support for High DPI displays to wxAgg backend
+* :ghpull:`27148`: Correctly treat pan/zoom events of overlapping axes.
+* :ghpull:`27981`: DOC: Fix label type specification in parameter descriptions
+* :ghpull:`27979`: Clarify error message for bad-dimensionality in pcolorfast().
+* :ghpull:`27962`: DOC: Document axes_grid1.Grid attributes
+* :ghpull:`27968`: MNT: Remove remaining 3.7 deprecations
+* :ghpull:`27965`: DOC: Rewrite the example illustrating bxp()
+* :ghpull:`26453`: add documentation for reloading font cache
+* :ghpull:`26131`: Tst/restore old tests
+* :ghpull:`27730`: Add an rcparam for image.interpolation_stage.
+* :ghpull:`27956`: Use PyOS_setsig in macos backend
+* :ghpull:`27829`: Simplify color/marker disambiguation logic in _process_plot_format.
+* :ghpull:`27840`: Add legend support for boxplots
+* :ghpull:`27943`: Support Cn, n>9 in plot() shorthand format.
+* :ghpull:`27950`: ci: Fix condition for publishing wheels
+* :ghpull:`27909`: Add a note to pyplot docstrings referencing the corresponding object methods
+* :ghpull:`27929`: DOC: Add summary lines to plot types
+* :ghpull:`27915`: [BUG] Fix redirect-from Sphinx extension
+* :ghpull:`27945`: DOC: Explain leading dot in object references
+* :ghpull:`27947`: Update docs for ``FancyArrowPatch`` & ``Annotation`` to make it clear that ShrinkA/B parameters are in points and not fractional.
+* :ghpull:`27944`: Bump the actions group with 2 updates
+* :ghpull:`27932`: Fix pickling of make_axes_area_auto_adjustable'd axes.
+* :ghpull:`26500`: closes #26477 ENH: Add interpolation_stage in qt figureoptions
+* :ghpull:`27927`: Update docs
+* :ghpull:`27916`: Revert renaming labels to tick_labels in boxplot_stats()
+* :ghpull:`27931`: Highlight development_setup code snippets as bash, not python.
+* :ghpull:`27856`: Support hatching in cairo backends.
+* :ghpull:`27922`: Fix cbook style
+* :ghpull:`27668`: MNT: prevent merging using labels + branch protection rules
+* :ghpull:`27857`: Documentation edit for matshow function
+* :ghpull:`27928`: DOC: Fix syntax for ToolBase.image docstring
+* :ghpull:`27873`: Simplify the LineCollection example
+* :ghpull:`27492`: Fix semantics of MEP22 image names.
+* :ghpull:`27918`: Fix new flake8 errors from old merge
+* :ghpull:`27874`: Modernize macosx backend a bit
+* :ghpull:`25887`: Update ``_unpack_to_numpy`` function to convert JAX and PyTorch arrays to NumPy
+* :ghpull:`27685`: Work around pyparsing diagnostic warnings
+* :ghpull:`26594`: Added optional props argument to Lasso Widget __init__ to customize Lasso line
+* :ghpull:`22761`: Add minor ticks on and off in Axis
+* :ghpull:`22407`: Add ``set_XY`` and ``set_data`` to ``Quiver``
+* :ghpull:`27901`: Rename boxplot's tick label parameter
+* :ghpull:`27883`: Fix build on older macOS deployment targets
+* :ghpull:`27900`: Remove empty user guide tutorials page
+* :ghpull:`27885`: Clean up headers in extensions
+* :ghpull:`27910`: DOC: Fix dead link in README
+* :ghpull:`26567`: Use SVG inheritance diagrams now that linking has been fixed
+* :ghpull:`27899`: Merge up 3.8.x into main
+* :ghpull:`27905`: Improved error message for malformed colors
+* :ghpull:`27906`: Override open_group, close_group methods in PathEffectRenderer
+* :ghpull:`27904`: FIX: Restore D213 in flake8
+* :ghpull:`27895`: Remove versions from sidebar in docs
+* :ghpull:`27894`: Mark triangulation classes as final
+* :ghpull:`27557`: Use :mpltype:``color`` for color types
+* :ghpull:`27845`: Make sure custom alpha param does not change 'none' colors in a list of colors
+* :ghpull:`27719`: Add BackendRegistry singleton class
+* :ghpull:`27890`: DOC: State approximate documentation build time
+* :ghpull:`27887`: BLD: Add a fallback URL for FreeType
+* :ghpull:`25224`: Allow passing a transformation to secondary_xaxis/_yaxis
+* :ghpull:`27886`: Fix devdocs version switcher
+* :ghpull:`27884`: FIX: don't copy twice on RGB input
+* :ghpull:`27087`: Convert path extension to pybind11
+* :ghpull:`27867`: DOC: Update some animation related topics
+* :ghpull:`27848`: FIX: handle nans in RGBA input with ScalarMappables
+* :ghpull:`27821`: BLD,Cygwin: Include Python.h first in various C++ files
+* :ghpull:`27457`: TST: adding tests of current clear behavior on ticks
+* :ghpull:`27872`: doc: add description of ``**kwargs`` usage to collections
+* :ghpull:`27868`: Use pybind11 string formatter for exception messages
+* :ghpull:`27862`: Add dtype/copy args to internal testing class
+* :ghpull:`27658`: Bump pydata-sphinx-theme
+* :ghpull:`27303`: FIX: also exclude np.nan in RGB(A) in color mapping
+* :ghpull:`27860`: Bump the actions group with 2 updates
+* :ghpull:`27869`: Correctly set temporary pdf/pgf backends
+* :ghpull:`27850`: Deprecate ``plot_date``
+* :ghpull:`27815`: Add side option to violinplot
+* :ghpull:`27836`: DOC: use ... for continuation prompt in docstrings
+* :ghpull:`27819`: MNT: remove draw method args and kwargs
+* :ghpull:`27813`: DOC: Update violinplot() docs
+* :ghpull:`27698`: Add linting and validation of all YAML files
+* :ghpull:`27811`: Fix Annulus width check
+* :ghpull:`27667`: Change return type of ``ion`` and ``ioff`` to fix unbound variable errors with Pyright
+* :ghpull:`27807`: Expand CI pytest reporting config to ignore xfails
+* :ghpull:`27806`: Remove self._renderer from AnnotationBbox and ConnectionPatch
+* :ghpull:`27799`: Clarify that set_ticks() affects major/minor ticks independently
+* :ghpull:`27787`: Improve documentation on boxplot and violinplot
+* :ghpull:`27800`: Deactivate sidebar for release notes
+* :ghpull:`27798`: Fix sphinx-gallery CSS
+* :ghpull:`27462`: DOC: clarify the default value of *radius* in Patch.contains_point
+* :ghpull:`27565`: MNT: arghandling subplotspec
+* :ghpull:`27796`: Make mypy a bit stricter
+* :ghpull:`27767`: Update handling of sequence labels for plot
+* :ghpull:`27795`: Add EffVer badge
+* :ghpull:`27780`: Partly revert #27711
+* :ghpull:`27768`: MNT: deprecate draw method args and kwargs
+* :ghpull:`27783`: Update README.md to fix citation link
+* :ghpull:`27726`: TST: always set a (long) timeout for subprocess and always use our wrapper
+* :ghpull:`27781`: Simplify example: Box plots with custom fill colors
+* :ghpull:`27750`: Bump the actions group with 2 updates
+* :ghpull:`27771`: Add marker-only and line+marker visuals to the plot() plot types
+* :ghpull:`27764`: Increase size of legend in Legend guide example
+* :ghpull:`26800`: Bump minimum NumPy version to 1.23
+* :ghpull:`27752`: Update some Meson internals
+* :ghpull:`27702`: GOV: adopt EffVer
+* :ghpull:`26965`: Removal of deprecated API cm
+* :ghpull:`27758`: [Doc] Remove special casing for removed method
+* :ghpull:`25815`: [TST] Make jpl units instantiated with datetimes consistent with mpl converters
+* :ghpull:`27729`: DOC: Improve colormap normalization example
+* :ghpull:`27732`: TST: Remove memory leak test
+* :ghpull:`27733`: ci: Simplify CodeQL setup
+* :ghpull:`27692`: Add method to update position of arrow patch
+* :ghpull:`27736`: Fix incorrect API reference in docs
+* :ghpull:`27731`: DOC: Create explicit rename legend entry section in guide
+* :ghpull:`27560`: Moved /users/project to /doc/project
+* :ghpull:`27728`: Simplify Figure._suplabels.
+* :ghpull:`27715`: Bump the actions group with 3 updates
+* :ghpull:`27711`: Fix boxplot legend entries part 2
+* :ghpull:`27696`: DOC: clean up automated tests section of workflow docs
+* :ghpull:`27686`: Improve Locator docstrings
+* :ghpull:`27704`: ci: Remove prerelease conditions from Azure Pipelines
+* :ghpull:`27568`: Fix boxplot legend entries
+* :ghpull:`27694`: MNT: fix labeller
+* :ghpull:`26953`: MNT: test that table doesn't try to convert unitized data
+* :ghpull:`27690`: Remove "Past versions" section from release notes
+* :ghpull:`26926`: Closes #22011: Changes to SubFigures so it behaves like a regular artist
+* :ghpull:`27469`: Fixed legend with legend location "best" when legend overlaps shaded area and text
+* :ghpull:`27684`: Bump the actions group with 1 update
+* :ghpull:`27665`: Axes.inset_axes - warning message removed
+* :ghpull:`27688`: CI: skip code coverage upload on scheduled tests
+* :ghpull:`27689`: ci: Don't include API/what's new notes in general doc labels
+* :ghpull:`27640`: Add ``get_cursor_data`` to ``NonUniformImage``
+* :ghpull:`27676`: BLD: Downgrade FreeType to 2.6.1 on Windows ARM
+* :ghpull:`27619`: Use GH action to install reviewdog
+* :ghpull:`27552`: TST: Use importlib for importing in pytest
+* :ghpull:`27650`: DOC: Added call out to API guidelines to contribute + small API guidelines reorg
+* :ghpull:`27618`: Add option of running stubtest using tox
+* :ghpull:`27656`: Bump the actions group with 1 update
+* :ghpull:`27415`: Use class form of data classes
+* :ghpull:`27649`: Check for latex binary before building docs
+* :ghpull:`27641`: MNT: fix api changes link in PR template
+* :ghpull:`27644`: ci: Fix mpl_toolkits label
+* :ghpull:`27230`: Query macOS for available system fonts.
+* :ghpull:`27643`: ci: Update nightly upload for artifacts v4
+* :ghpull:`27642`: Fix auto-labeler configuration
+* :ghpull:`27639`: Doc: typo fix for #22699
+* :ghpull:`26978`: [pre-commit.ci] pre-commit autoupdate
+* :ghpull:`27563`: Enable PyPI publishing from GitHub Actions
+* :ghpull:`22699`: Proof of concept for adding kwdoc content to properties using a decorator
+* :ghpull:`27633`: Auto-label PRs based on changed files
+* :ghpull:`27607`: Error on bad input to hexbin extents
+* :ghpull:`27629`: Don't run CI twice on dependabot branches
+* :ghpull:`27562`: Avoid an extra copy/resample if imshow input has no alpha
+* :ghpull:`27628`: Bump the actions group with 2 updates
+* :ghpull:`27626`: CI: Group dependabot updates
+* :ghpull:`27589`: Don't clip PowerNorm inputs < vmin
+* :ghpull:`27613`: Fix marker validator with cycler (allow mix of classes)
+* :ghpull:`27615`: MNT: add spaces to PR template
+* :ghpull:`27614`: DOC: Updated link in annotation API docs to point to annotation user guide
+* :ghpull:`27605`: Ignore masked values in boxplot
+* :ghpull:`26884`: Remove deprecated code from _fontconfig_patterns
+* :ghpull:`27602`: Let FormatStrFormatter respect axes.unicode_minus.
+* :ghpull:`27601`: Clarify dollar_ticks example and FormatStrFormatter docs.
+* :ghpull:`24834`: Deprecate apply_theta_transforms=True to PolarTransform
+* :ghpull:`27591`: Use macOS instead of OSX in comments/docs
+* :ghpull:`27577`: MNT: add the running version to pickle warning message
+* :ghpull:`25191`: Deprecate 'prune' kwarg to MaxNLocator
+* :ghpull:`27566`: DOC: changed tag ``plot type`` to ``plot-type``
+* :ghpull:`27105`: Use Axes instead of axes core library code
+* :ghpull:`27575`: Add quotes round .[dev] in editable install command
+* :ghpull:`27104`: Use Axes instead of axes in galleries
+* :ghpull:`27373`: Transpose grid_finder tick representation.
+* :ghpull:`27363`: ci: Improve coverage for compiled code
+* :ghpull:`27200`: DOC: Add role for custom informal types like color
+* :ghpull:`27548`: DOC: typo fix in contribute doc
+* :ghpull:`27458`: Check if the mappable is in a different Figure than the one fig.color…
+* :ghpull:`27546`: MNT: Clean up some style exceptions
+* :ghpull:`27514`: Improve check for bbox
+* :ghpull:`27265`: DOC: reorganizing contributing docs to clean up toc, better separate topics
+* :ghpull:`27517`: Best-legend-location microoptimization
+* :ghpull:`27540`: Bump github/codeql-action from 2 to 3
+* :ghpull:`27520`: [Doc] Minor consistency changes and correction of Marker docs
+* :ghpull:`27505`: Download Qhull source from Github, not Qhull servers, in meson build
+* :ghpull:`27518`: Micro-optimizations related to list handling
+* :ghpull:`27495`: Bump actions/stale from 8 to 9
+* :ghpull:`27523`: Changes for stale GHA v9
+* :ghpull:`27519`: [Doc] Improve/correct docs for 3D
+* :ghpull:`27447`: TST: Compress some hist geometry tests
+* :ghpull:`27513`: Fix docs and add tests for transform and deprecate ``BboxTransformToMaxOnly``
+* :ghpull:`27511`: TST: Add tests for Affine2D
+* :ghpull:`27424`: Added Axes.stairs test in test_datetime.py
+* :ghpull:`27267`: Fix/restore secondary axis support for Transform-type functions
+* :ghpull:`27013`: Add test_contour under test_datetime.py
+* :ghpull:`27497`: Clarify that set_axisbelow doesn't move grids below images.
+* :ghpull:`27498`: Remove unnecessary del local variables at end of Gcf.destroy.
+* :ghpull:`27466`: Add test_eventplot to test_datetime.py
+* :ghpull:`25905`: Use annotate coordinate systems to simplify label_subplots.
+* :ghpull:`27471`: Doc: visualizing_tests and ``triage_tests`` tools
+* :ghpull:`27474`: Added smoke test for Axes.matshow to test_datetime.py
+* :ghpull:`27470`: Fix test visualization tool for non-PNG files
+* :ghpull:`27426`: DOC: normalizing histograms
+* :ghpull:`27452`: Cleanup unit_cube-methods
+* :ghpull:`27431`: Added test for Axes.bar_label
+* :ghpull:`26962`: Remove backend 3.7-deprecated API
+* :ghpull:`27410`: Add test_vlines to test_datetime.py
+* :ghpull:`27425`: Added test_fill_betweenx in test_datetime.py
+* :ghpull:`27449`: Remove test_quiverkey from test_datetime.py
+* :ghpull:`27427`: MNT/TST: remove xcorr and acorr from test_datetime
+* :ghpull:`27390`: Add test_bxp in test_datetime.py
+* :ghpull:`27428`: Added test for broken_barh to test_datetime.py
+* :ghpull:`27222`: [TST] Added test_annotate in test_datetime.py
+* :ghpull:`27135`: Added smoke test for Axes.stem
+* :ghpull:`27343`: Fix draggable annotations on subfigures.
+* :ghpull:`27033`: Add test_bar in test_datetime
+* :ghpull:`27423`: Add test for fill_between in test_datetime.py
+* :ghpull:`27409`: Fix setting ``_selection_completed`` in ``SpanSelector`` when spanselector is initialised using ``extents``
+* :ghpull:`27440`: Fix get_path for 3d artists
+* :ghpull:`27422`: TST: Cache available interactive backends
+* :ghpull:`27401`: Add test_fill in test_datetime.py
+* :ghpull:`27419`: DOC: Add AsinhScale to list of built-in scales
+* :ghpull:`27417`: Switch pytest fixture from tmpdir to tmp_path
+* :ghpull:`27172`: ENH: Change logging to warning when creating a legend with no labels
+* :ghpull:`27405`: Check that xerr/yerr values are not None in errorbar
+* :ghpull:`27392`: Remove test_spy from test_datetime.py
+* :ghpull:`27331`: Added smoke test for Axes.barbs in test_datetime.py
+* :ghpull:`27393`: MNT: Fix doc makefiles
+* :ghpull:`27387`: Revert "MNT: add _version.py to .gitignore"
+* :ghpull:`27347`: FIX: scale norm of collections when first array is set
+* :ghpull:`27374`: MNT: add _version.py to .gitignore
+* :ghpull:`19011`: Simplify tk tooltip setup.
+* :ghpull:`27367`: Fix _find_fonts_by_props docstring
+* :ghpull:`27359`: Fix build on PyPy
+* :ghpull:`27362`: Implement SubFigure.remove.
+* :ghpull:`27360`: Fix removal of colorbars on nested subgridspecs.
+* :ghpull:`27211`: Add test_hlines to test_datetimes.py
+* :ghpull:`27353`: Refactor AxisArtistHelpers
+* :ghpull:`27357`: [DOC]: Update 3d axis limits what's new
+* :ghpull:`26992`: Convert TkAgg utilities to pybind11
+* :ghpull:`27215`: Add ``@QtCore.Slot()`` decorations to ``NavigationToolbar2QT``
+* :ghpull:`26907`: Removal of deprecations for Contour
+* :ghpull:`27285`: Factor out common parts of qt and macos interrupt handling.
+* :ghpull:`27306`: Simplify GridSpec setup in make_axes_gridspec.
+* :ghpull:`27313`: FIX: allow re-shown Qt windows to be re-destroyed
+* :ghpull:`27184`: Use pybind11 for qhull wrapper
+* :ghpull:`26794`: Use pybind11 in _c_internal_utils module
+* :ghpull:`27300`: Remove idiosyncratic get_tick_iterator API.
+* :ghpull:`27275`: MAINT: fix .yml in tag issue template
+* :ghpull:`27288`: Use int.from_bytes instead of implementing the conversion ourselves.
+* :ghpull:`27286`: Various cleanups
+* :ghpull:`27279`: Tweak a few docstrings.
+* :ghpull:`27256`: merge up v3.8.1
+* :ghpull:`27254`: Remove redundant axes_grid colorbar examples.
+* :ghpull:`27251`: webagg: Don't resize canvas if WebSocket isn't connected
+* :ghpull:`27236`: Tagging Example - Tags for multiple figs demo
+* :ghpull:`27245`: MNT: be more careful in Qt backend that there is actually a Figure
+* :ghpull:`27158`: First attempt for individual hatching styles for stackplot
+* :ghpull:`26851`: Establish draft Tag glossary and Tagging guidelines
+* :ghpull:`27083`: DOC: Add tags infrastructure for gallery examples
+* :ghpull:`27204`: BLD: Use NumPy nightly wheels for non-release builds
+* :ghpull:`27208`: Add test_axvline to test_datetime.py
+* :ghpull:`26989`: MNT: print fontname in missing glyph warning
+* :ghpull:`27177`: Add test_axhline in test_datetime.py
+* :ghpull:`27164`: docs: adding explanation for color in ``set_facecolor``
+* :ghpull:`27175`: Deprecate mixing positional and keyword args for legend(handles, labels)
+* :ghpull:`27199`: DOC: clean up links under table formatting docs
+* :ghpull:`27185`: Added smoke tests for Axes.errorbar in test_datetime.py
+* :ghpull:`27091`: Add test_step to test_datetime.py
+* :ghpull:`27182`: Add example for plotting a bihistogram
+* :ghpull:`27130`: added test_axvspan in test.datetime.py
+* :ghpull:`27094`: MNT: move pytest.ini configs to .toml
+* :ghpull:`27139`: added test_axhspan in test_datetime.py
+* :ghpull:`27058`: DOC: concise dependency heading + small clarifications
+* :ghpull:`27053`: Added info for getting compilation output from meson on autorebuild
+* :ghpull:`26906`: Fix masking for Axes3D.plot()
+* :ghpull:`27142`: Added smoke test for Axes.text in test_datetime.py
+* :ghpull:`27024`: Add test_contourf in test_datetime.py
+* :ghpull:`22347`: correctly treat pan/zoom events of overlapping axes
+* :ghpull:`26900`: #26865 removing deprecations to axislines.py
+* :ghpull:`26696`: DOC: Fix colLoc default
+* :ghpull:`27064`: Close all plot windows of a blocking show() on Ctrl+C
+* :ghpull:`26882`: Add scatter test for datetime units
+* :ghpull:`27114`: add test_stackplot in test_datetime.py
+* :ghpull:`27084`: Add test_barh to test_datetime.py
+* :ghpull:`27110`: DOC: Move figure member sections one level down
+* :ghpull:`27127`: BLD: use python3 for shebang consistent with pep-394
+* :ghpull:`27111`: BLD: Fix setting FreeType build type in extension
+* :ghpull:`26921`: MNT: clarify path.sketch rcparam format + test validate_sketch
+* :ghpull:`27109`: TST: Use importlib for subprocess tests
+* :ghpull:`27119`: Update clabel comment.
+* :ghpull:`27117`: Remove datetime test for axes.pie
+* :ghpull:`27095`: Deprecate nth_coord parameter from FixedAxisArtistHelper.new_fixed_axis.
+* :ghpull:`27066`: Tweak array_view to be more like pybind11
+* :ghpull:`27090`: Restore figaspect() API documentation
+* :ghpull:`27074`: Issue #26990: Split the histogram image into two for each code block.
+* :ghpull:`27086`: Rename py namespace to mpl in extension code
+* :ghpull:`27082`: MAINT: Update environment.yml to match requirements files
+* :ghpull:`27072`: Remove datetime test stubs for spectral methods/table
+* :ghpull:`26830`: Update stix table with Unicode names
+* :ghpull:`26969`: DOC: add units to user/explain [ci doc]
+* :ghpull:`27028`: Added test_hist in test_datetime.py
+* :ghpull:`26876`: issue: 26871 - Remove SimplePath class from patches.py
+* :ghpull:`26875`: Fix Deprecation in patches.py
+* :ghpull:`26890`: Removing deprecated api from patches
+* :ghpull:`27037`: add test_plot_date in test_datetime.py
+* :ghpull:`27012`: Bump required C++ standard to c++17
+* :ghpull:`27021`: Add a section to Highlight past winners for JDH plotting contest in docs
+* :ghpull:`27004`: Warning if handles and labels have a len mismatch
+* :ghpull:`24061`: #24050 No error was thrown even number of handles mismatched labels
+* :ghpull:`26754`: DOC: separate and clarify axisartist default tables
+* :ghpull:`27020`: CI: Update scientific-python/upload-nightly-action to 0.2.0
+* :ghpull:`26951`: Clarify that explicit ticklabels are used without further formatting.
+* :ghpull:`26894`: Deprecate setting the timer interval while starting it.
+* :ghpull:`13401`: New clear() method for Radio and Check buttons
+* :ghpull:`23829`: Start transitioning to pyproject.toml
+* :ghpull:`26621`: Port build system to Meson
+* :ghpull:`26928`: [TYP] Add tool for running stubtest
+* :ghpull:`26917`: Deprecate ContourLabeler.add_label_clabeltext.
+* :ghpull:`26960`: Deprecate backend_ps.get_bbox_header, and split it for internal use.
+* :ghpull:`26967`: Minor cleanups.
+* :ghpull:`26909`: deprecated api tri
+* :ghpull:`26946`: Inline Cursor._update into its sole caller.
+* :ghpull:`26915`: DOC: Clarify description and add examples in colors.Normalize
+* :ghpull:`26874`: Cleaned up the span_where class method from Polycollections.
+* :ghpull:`26586`: Support standard formatters in axisartist.
+* :ghpull:`26788`: Fix axh{line,span} on polar axes.
+* :ghpull:`26935`: add tomli to rstcheck extras
+* :ghpull:`26275`: Use pybind11 in image module
+* :ghpull:`26887`: DOC: improve removal for julian dates [ci doc]
+* :ghpull:`26929`: DOC: Fix removal doc for Animation attributes
+* :ghpull:`26918`: 26865 Removed deprecations from quiver.py
+* :ghpull:`26902`: Fixed deprecated APIs in lines.py
+* :ghpull:`26903`: Simplify CheckButtons and RadioButtons click handler.
+* :ghpull:`26899`: MNT: only account for Artists once in fig.get_tightbbox
+* :ghpull:`26861`: QT/NavigationToolbar2: configure subplots dialog should be modal
+* :ghpull:`26885`: Removed deprecated code from gridspec.py
+* :ghpull:`26880`: Updated offsetbox.py
+* :ghpull:`26910`: Removed the deprecated code from offsetbox.py
+* :ghpull:`26905`: Add users/explain to default skip subdirs
+* :ghpull:`26853`: Widgets: Remove deprecations and make arguments keyword only
+* :ghpull:`26877`: Fixes deprecation in lines.py
+* :ghpull:`26871`: Removed the deprecated code from ``axis.py``
+* :ghpull:`26872`: Deprecated code removed in animation.py
+* :ghpull:`26859`: Add datetime testing skeleton
+* :ghpull:`26848`: ci: Don't install recommended packages on Circle
+* :ghpull:`26852`: Remove Julian date support
+* :ghpull:`26801`: [MNT]: Cleanup ticklabel_format (style=)
+* :ghpull:`26840`: Reduce redundant information in _process_plot_var_args.
+* :ghpull:`26731`: Explicitly set foreground color to black in svg icons
+* :ghpull:`26826`: [MNT] Move NUM_VERTICES from mplutils.h to the only file it is used in
+* :ghpull:`26742`: [TYP] Add typing for some private methods and modules
+* :ghpull:`26819`: Reorder safe_first_element() and _safe_first_finite() code
+* :ghpull:`26813`: Bump docker/setup-qemu-action from 2 to 3
+* :ghpull:`26797`: Remove deprecated draw_gouraud_triangle
+* :ghpull:`26815`: Remove plt.Axes from tests
+* :ghpull:`26818`: Fix doc build (alternative)
+* :ghpull:`26785`: merge up v3.8.0
+* :ghpull:`25272`: Do not add padding to 3D axis limits when limits are manually set
+* :ghpull:`26798`: Remove deprecated methods and attributed in Axes3D
+* :ghpull:`26744`: Use cbook methods for string checking
+* :ghpull:`26802`: specify input range in logs when image data must be clipped
+* :ghpull:`26787`: Remove unused Axis private init helpers.
+* :ghpull:`26629`: DOC: organize figure API
+* :ghpull:`26690`: Make generated pgf code more robust against later changes of tex engine.
+* :ghpull:`26577`: Bugfix: data sanitizing for barh
+* :ghpull:`26684`: Update PR template doc links
+* :ghpull:`26686`: PR template: shorten comment and pull up top
+* :ghpull:`26670`: Added sanitize_sequence to kwargs in _preprocess_data
+* :ghpull:`26634`: [MNT] Move SubplotParams from figure to gridspec
+* :ghpull:`26609`: Cleanup AutoMinorLocator implementation.
+* :ghpull:`26293`: Added get_xmargin(), get_ymargin() and get_zmargin() and tests.
+* :ghpull:`26516`: Replace reference to %pylab by %matplotlib.
+* :ghpull:`26483`: Improve legend(loc='best') warning and test
+* :ghpull:`26482`: [DOC]: print pydata sphinx/mpl theme versions
+* :ghpull:`23787`: Use pybind11 for C/C++ extensions
 
-Issues (3):
+Issues (85):
 
-* :ghissue:`27953`: [Bug]: Pyplot can no longer set axes properties
-* :ghissue:`11759`: The color of the 3D arrow head does not match that of the arrow body
-* :ghissue:`27826`: [Bug]: Unexpected behavior of scatter.legend_elements
+* :ghissue:`22376`: [ENH]: align_titles
+* :ghissue:`5506`: Confusing status bar values in presence of multiple axes
+* :ghissue:`4284`: Twin axis message coordinates
+* :ghissue:`18940`: WxAgg backend draws the wrong size when wxpython app is high DPI aware on Windows
+* :ghissue:`27792`: [ENH]: Legend entries for boxplot
+* :ghissue:`27828`: [Bug]: ".C10" does not work as plot shorthand format spec
+* :ghissue:`27911`: redirect not working for updated contribute page
+* :ghissue:`21876`: [Doc]: redirect-from directive appears broken?
+* :ghissue:`27941`: [Bug]: ShrinkA and ShrinkB are ignored in ax.annotate(arrowprops=...)
+* :ghissue:`26477`: [ENH]: Add interpolation_stage selector for images in qt figureoptions
+* :ghissue:`363`: Enable hatches for Cairo backend
+* :ghissue:`27852`: [Bug]: matplotlib.pyplot.matshow "(first dimension of the array) are displayed horizontally" but are displayed vertically
+* :ghissue:`27400`: [Bug]: tk backend confused by presence of file named "move" in current working directory
+* :ghissue:`25882`: [Bug]: plt.hist takes significantly more time with torch and jax arrays
+* :ghissue:`25204`: [Bug]: Pyparsing warnings emitted in mathtext
+* :ghissue:`17707`: getpwuid(): uid not found: 99
+* :ghissue:`27896`: [Doc]: Empty "User guide tutorials page" in docs
+* :ghissue:`27824`: [Bug]: polygon from axvspan not correct in polar plot after set_xy
+* :ghissue:`27378`: [ENH]: Suggest 'CN' if color is an integer
+* :ghissue:`27843`: [Bug]: close_group is not called when using patheffects
+* :ghissue:`27839`: [Bug]: PathCollection using alpha ignores 'none' facecolors
+* :ghissue:`25119`: [ENH]: secondary_x/yaxis accept transform argument
+* :ghissue:`27876`: [Doc]: Fix version switcher in devdocs
+* :ghissue:`27301`: [Bug]: ``imshow`` allows RGB(A) images with ``np.nan`` values to pass
+* :ghissue:`23839`: [MNT]: Add tests to codify ``ax.clear``
+* :ghissue:`27652`: [Doc]: Low contrast on clicked links in dark mode
+* :ghissue:`27865`: [Bug]: Zoom und pan not working after writing pdf pages.
+* :ghissue:`25871`: [Bug]: Colorbar cannot be added to another figure
+* :ghissue:`8072`: plot_date() ignores timezone in matplotlib version 2.0.0
+* :ghissue:`27812`: [ENH]: Add split feature for violin plots
+* :ghissue:`27659`: [MNT]: Improve return type of ``ioff`` and ``ion`` to improve Pyright analysis of bound variables
+* :ghissue:`27805`: [Bug]: Saving a figure with indicate_inset_zoom to pdf and then pickling it causes TypeError
+* :ghissue:`27701`: [Bug]: axis set_xscale('log') interferes with set_xticks
+* :ghissue:`19807`: radius modification in contains_point function when linewidth is specified
+* :ghissue:`27762`: [Bug]: Inconsistent treatment of list of labels in ``plot`` when the input is a dataframe
+* :ghissue:`27745`: [MNT]: ``_ImageBase.draw`` and ``Axis.draw`` args and kwargs
+* :ghissue:`27782`: [Doc]: Link to citation page in read me broken
+* :ghissue:`8789`: legend handle size does not automatically scale with linewidth
+* :ghissue:`27746`: [Doc]: Citation link in the readme.md points to 404
+* :ghissue:`20853`: Add deprecation for colormaps
+* :ghissue:`26865`: [MNT]: Remove 3.7-deprecated API
+* :ghissue:`24168`: [Bug]: ``subprocess-exited-with-error`` when trying to build on M1 mac
+* :ghissue:`27727`: [Doc]: Text in the colormap normalization gallery doesn't match the code
+* :ghissue:`27635`: [Bug]: test_figure_leak_20490 repeatedly failing on CI
+* :ghissue:`14217`: [Feature request] Add a way to update the position of the Arrow patch.
+* :ghissue:`20512`: Bad boxplot legend entries
+* :ghissue:`22011`: [Bug]: subfigures messes up with fig.legend zorder
+* :ghissue:`27414`: [Bug]: Legend overlaps shaded area in fill_between with legend location "best"
+* :ghissue:`23323`: Legend with "loc=best" does not try to avoid text
+* :ghissue:`27648`: [Doc]: ``Axes.inset_axes`` is still experimental
+* :ghissue:`27277`: [Doc]: Two license pages in docs
+* :ghissue:`24648`: [Doc]: make html fail early if latex not present
+* :ghissue:`27554`: [Bug]: Large image draw performance deterioration in recent releases
+* :ghissue:`25239`: [Bug]: colors.PowerNorm results in incorrect colorbar
+* :ghissue:`13533`: Boxplotting Masked Arrays
+* :ghissue:`25967`: [Doc]: dollar_ticks example refers to unused formatter classes
+* :ghissue:`24859`: [Doc]: Document color in a consistent way, including link
+* :ghissue:`27159`: [Bug]: Meson build fails due to qhull link issue.
+* :ghissue:`25691`: [Bug]: Secondary axis does not support Transform as functions
+* :ghissue:`25860`: [Bug]: canvas pick events not working when Axes belongs to a subfigure
+* :ghissue:`27361`: [Bug]: (Tight) layout engine breaks for 3D patches
+* :ghissue:`27145`: [ENH]: Make "No artists with labels found to put in legend" a warning
+* :ghissue:`27399`: [Bug]: None in y or yerr arrays leads to TypeError when using errorbar
+* :ghissue:`13887`: Accessing default ``norm`` of a Collection removes its colors.
+* :ghissue:`26593`: [ENH]: Support SubFigure.remove()
+* :ghissue:`27329`: [Bug]: Removing a colorbar for an axes positioned in a subgridspec restores the axes' position to the wrong place.
+* :ghissue:`27214`: [Bug]: ``NavigationToolbar2QT`` should use ``@Slot`` annotation
+* :ghissue:`27146`: [ENH]: Multi hatching in ``ax.stackplot()``
+* :ghissue:`27168`: [Doc]: Instructions for editable installation on Windows potentially missing a step
+* :ghissue:`27174`: [MNT]: Build nightly wheels with NumPy nightly wheels
+* :ghissue:`25043`: [ENH]: Plotting masked arrays correctly in 3D line plot
+* :ghissue:`26990`: [Doc]: Histogram path example renders poorly in HTML
+* :ghissue:`25738`: [MNT]: Improve readability of _mathtext_data.stix_virtual_fonts table
+* :ghissue:`11129`: Highlight past winners for JDH plotting contest in docs
+* :ghissue:`24050`: No error message in matplotlib.axes.Axes.legend() if there are more labels than handles
+* :ghissue:`10922`: ENH: clear() method for widgets.RadioButtons
+* :ghissue:`18295`: How to modify ticklabels in axisartist?
+* :ghissue:`24996`: [Bug]: for non-rectilinear axes, axvline/axhline should behave as "draw a gridline at that x/y"
+* :ghissue:`26841`: [Bug]: Global legend weird behaviors
+* :ghissue:`25974`: [MNT]: Cleanup ticklabel_format(..., style=)
+* :ghissue:`26786`: Please upload new dev wheel so we pick up 3.9.dev after 3.8 release
+* :ghissue:`18052`: the limits of axes are inexact with mplot3d
+* :ghissue:`25596`: [MNT]: Consistency on Interface
+* :ghissue:`26557`: [ENH]: Nightly Python 3.12 builds
+* :ghissue:`26281`: [ENH]: Add get_xmargin, get_ymargin, get_zmargin axes methods
 
 
 Previous GitHub statistics
diff --git a/doc/users/prev_whats_new/github_stats_3.8.4.rst b/doc/users/prev_whats_new/github_stats_3.8.4.rst
new file mode 100644
index 000000000000..324393b12f9d
--- /dev/null
+++ b/doc/users/prev_whats_new/github_stats_3.8.4.rst
@@ -0,0 +1,78 @@
+.. _github-stats-3-8-4:
+
+GitHub statistics for 3.8.4 (Apr 03, 2024)
+==========================================
+
+GitHub statistics for 2023/09/15 (tag: v3.8.0) - 2024/04/03
+
+These lists are automatically generated, and may be incomplete or contain duplicates.
+
+We closed 3 issues and merged 27 pull requests.
+The full list can be seen `on GitHub <https://github.com/matplotlib/matplotlib/milestone/89?closed=1>`__
+
+The following 26 authors contributed 351 commits.
+
+* 0taj
+* Alec Vercruysse
+* Alexander Volkov
+* Antony Lee
+* Anvi Verma
+* Chiraag Balu
+* David Gilbertson
+* David Stansby
+* dependabot[bot]
+* Elliott Sales de Andrade
+* Eric Firing
+* Greg Lucas
+* Gurudatta Shanbhag
+* hannah
+* James Salsman
+* Jody Klymak
+* Kyle Sunden
+* lkkmpn
+* Lucia Korpas
+* Matthew Morrison
+* Oscar Gustafsson
+* Ruth Comer
+* Samuel Diebolt
+* Thomas A Caswell
+* Tim Hoffmann
+* wemi3
+
+GitHub issues and pull requests:
+
+Pull Requests (27):
+
+* :ghpull:`28015`: Backport PR #27955 on branch v3.8.x (Add a draw during show for macos backend)
+* :ghpull:`27993`: Unpin numpy 2, build against prerelease numpy in CIBW
+* :ghpull:`27955`: Add a draw during show for macos backend
+* :ghpull:`28001`: Backport PR #28000 on branch v3.8.x (Fix color sequence data for Set2 and Set3)
+* :ghpull:`28000`: Fix color sequence data for Set2 and Set3
+* :ghpull:`27990`: Backport PR #27988 on branch v3.8.x (gtk: Ensure pending draws are done before GTK draw)
+* :ghpull:`27988`: gtk: Ensure pending draws are done before GTK draw
+* :ghpull:`27986`: Backport PR #27985 on branch v3.8.x (TST: Remove superfluous chdir from tests)
+* :ghpull:`27985`: TST: Remove superfluous chdir from tests
+* :ghpull:`27976`: Backport PR #27975 on branch v3.8.x (DOC: Fix typo in ``ax.transData.inversed()``)
+* :ghpull:`27934`: Backport PR #27933 on branch v3.8.x (Update "Created with" url in hand.svg)
+* :ghpull:`27933`: Update "Created with" url in hand.svg
+* :ghpull:`27926`: Backport PR #27875 on branch v3.8.x (macosx: Clean up single-shot timers correctly)
+* :ghpull:`27925`: Backport PR #27921 on branch v3.8.x (Avoid modifying user input to Axes.bar)
+* :ghpull:`27875`: macosx: Clean up single-shot timers correctly
+* :ghpull:`27921`: Avoid modifying user input to Axes.bar
+* :ghpull:`27903`: Merge 3.8.3-doc into 3.8.x
+* :ghpull:`27889`: Backport PR #27888 on branch v3.8.x (DOC: fix stray release note entry)
+* :ghpull:`27888`: DOC: fix stray release note entry
+* :ghpull:`27849`: Backport PR #27754 on branch v3.8.x (fix quiver3d incorrect arrow colors)
+* :ghpull:`27859`: Backport PR #27858 on branch v3.8.x (pin pytest)
+* :ghpull:`27858`: pin pytest
+* :ghpull:`27754`: fix quiver3d incorrect arrow colors
+* :ghpull:`27847`: Backport PR #27846 on branch v3.8.x (Make example in legend_elements doc more generalisable)
+* :ghpull:`27846`: Make example in legend_elements doc more generalisable
+* :ghpull:`27802`: Backport PR #27794 on branch v3.8.x (Remove old reference to 72 DPI in figure_size_units.py)
+* :ghpull:`27794`: Remove old reference to 72 DPI in figure_size_units.py
+
+Issues (3):
+
+* :ghissue:`27953`: [Bug]: Pyplot can no longer set axes properties
+* :ghissue:`11759`: The color of the 3D arrow head does not match that of the arrow body
+* :ghissue:`27826`: [Bug]: Unexpected behavior of scatter.legend_elements
diff --git a/doc/users/release_notes.rst b/doc/users/release_notes.rst
index 17d1f55316b3..63f417e6a26d 100644
--- a/doc/users/release_notes.rst
+++ b/doc/users/release_notes.rst
@@ -13,6 +13,15 @@ Release notes
    .. include:: release_notes_next.rst
 
 
+Version 3.9
+^^^^^^^^^^^
+.. toctree::
+    :maxdepth: 1
+
+    next_whats_new
+    ../api/next_api_changes
+    github_stats.rst
+
 Version 3.8
 ^^^^^^^^^^^
 .. toctree::

From 3a1bc7df1750716b7eac85eed57c4a41fb27d92d Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 5 Apr 2024 03:21:37 -0400
Subject: [PATCH 0939/1120] REL: v3.9.0rc1

This is the first release candidate for the meso release 3.9.0.

From 3b2522c134acff8b63d3950fef0f51010a15c11f Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 5 Apr 2024 03:24:40 -0400
Subject: [PATCH 0940/1120] BLD: bump branch away from tag

So the tarballs from GitHub are stable.

From 122a58a4edfbd29fe1b89df64ec857b6c2ab9468 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Sat, 6 Apr 2024 09:10:40 +0200
Subject: [PATCH 0941/1120] Backport PR #28026: [DOC] reshuffle of contributing

---
 doc/devel/contribute.rst | 353 ++++++++++++++++++++-------------------
 doc/devel/index.rst      |  29 ++--
 doc/project/citing.rst   |   2 +
 3 files changed, 194 insertions(+), 190 deletions(-)

diff --git a/doc/devel/contribute.rst b/doc/devel/contribute.rst
index 9d476bfd81b4..7b2b0e774ec7 100644
--- a/doc/devel/contribute.rst
+++ b/doc/devel/contribute.rst
@@ -30,151 +30,64 @@ existing issue and pull request discussions, and following the conversations
 during pull request reviews to get context. Or you can deep-dive into a subset
 of the code-base to understand what is going on.
 
-There are a few typical new contributor profiles:
-
-* **You are a Matplotlib user, and you see a bug, a potential improvement, or
-  something that annoys you, and you can fix it.**
-
-  You can search our issue tracker for an existing issue that describes your problem or
-  open a new issue to inform us of the problem you observed and discuss the best approach
-  to fix it. If your contributions would not be captured on GitHub (social media,
-  communication, educational content), you can also reach out to us on gitter_,
-  `Discourse <https://discourse.matplotlib.org/>`__ or attend any of our `community
-  meetings <https://scientific-python.org/calendars>`__.
-
-* **You are not a regular Matplotlib user but a domain expert: you know about
-  visualization, 3D plotting, design, technical writing, statistics, or some
-  other field where Matplotlib could be improved.**
-
-  Awesome -- you have a focus on a specific application and domain and can
-  start there. In this case, maintainers can help you figure out the best
-  implementation; open an issue or pull request with a starting point, and we'll
-  be happy to discuss technical approaches.
-
-  If you prefer, you can use the `GitHub functionality for "draft" pull requests
-  <https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/changing-the-stage-of-a-pull-request#converting-a-pull-request-to-a-draft>`__
-  and request early feedback on whatever you are working on, but you should be
-  aware that maintainers may not review your contribution unless it has the
-  "Ready to review" state on GitHub.
-
-* **You are new to Matplotlib, both as a user and contributor, and want to start
-  contributing but have yet to develop a particular interest.**
-
-  Having some previous experience or relationship with the library can be very
-  helpful when making open-source contributions. It helps you understand why
-  things are the way they are and how they *should* be. Having first-hand
-  experience and context is valuable both for what you can bring to the
-  conversation (and given the breadth of Matplotlib's usage, there is a good
-  chance it is a unique context in any given conversation) and make it easier to
-  understand where other people are coming from.
-
-  Understanding the entire codebase is a long-term project, and nobody expects
-  you to do this right away. If you are determined to get started with
-  Matplotlib and want to learn, going through the basic functionality,
-  choosing something to focus on (3d, testing, documentation, animations, etc.)
-  and gaining context on this area by reading the issues and pull requests
-  touching these subjects is a reasonable approach.
-
-.. _get_connected:
-
-Get connected
-=============
-
-Do I really have something to contribute to Matplotlib?
--------------------------------------------------------
-
-100% yes. There are so many ways to contribute to our community.
-
-When in doubt, we recommend going together! Get connected with our community of
-active contributors, many of whom felt just like you when they started out and
-are happy to welcome you and support you as you get to know how we work, and
-where things are. Take a look at the next sections to learn more.
-
-.. _contributor_incubator:
-
-Contributor incubator
----------------------
-
-The incubator is our non-public communication channel for new contributors. It
-is a private gitter_ (chat) room moderated by core Matplotlib developers where
-you can get guidance and support for your first few PRs. It's a place where you
-can ask questions about anything: how to use git, GitHub, how our PR review
-process works, technical questions about the code, what makes for good
-documentation or a blog post, how to get involved in community work, or get a
-"pre-review" on your PR.
-
-To join, please go to our public community_ channel, and ask to be added to
-``#incubator``. One of our core developers will see your message and will add you.
-
-.. _gitter: https://gitter.im/matplotlib/matplotlib
-.. _community: https://gitter.im/matplotlib/community
-
-New Contributors Meeting
-------------------------
-
-Once a month, we host a meeting to discuss topics that interest new
-contributors. Anyone can attend, present, or sit in and listen to the call.
-Among our attendees are fellow new contributors, as well as maintainers, and
-veteran contributors, who are keen to support onboarding of new folks and
-share their experience. You can find our community calendar link at the
-`Scientific Python website <https://scientific-python.org/calendars/>`_, and
-you can browse previous meeting notes on `GitHub
-<https://github.com/matplotlib/ProjectManagement/tree/master/new_contributor_meeting>`_.
-We recommend joining the meeting to clarify any doubts, or lingering
-questions you might have, and to get to know a few of the people behind the
-GitHub handles 😉. You can reach out to us on gitter_ for any clarifications or
-suggestions. We ❤ feedback!
-
-.. _new_contributors:
-
-Good first issues
------------------
-
-While any contributions are welcome, we have marked some issues as
-particularly suited for new contributors by the label `good first issue
-<https://github.com/matplotlib/matplotlib/labels/good%20first%20issue>`_. These
-are well documented issues, that do not require a deep understanding of the
-internals of Matplotlib. The issues may additionally be tagged with a
-difficulty. ``Difficulty: Easy`` is suited for people with little Python
-experience. ``Difficulty: Medium`` and ``Difficulty: Hard`` require more
-programming experience. This could be for a variety of reasons, among them,
-though not necessarily all at the same time:
-
-- The issue is in areas of the code base which have more interdependencies,
-  or legacy code.
-- It has less clearly defined tasks, which require some independent
-  exploration, making suggestions, or follow-up discussions to clarify a good
-  path to resolve the issue.
-- It involves Python features such as decorators and context managers, which
-  have subtleties due to our implementation decisions.
-
-.. _managing_issues_prs:
-
-Work on an issue
-----------------
-
-In general, the Matplotlib project does not assign issues. Issues are
-"assigned" or "claimed" by
-:ref:`proposing a solution via a pull request <how-to-pull-request>`.
-We ask pull request (PR) authors to
-`link to the issue in the PR
-<https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue>`_ because then Github adds corresponding links to the PR to the discussion and the sidebar on the linked issue page on GitHub.
-
-Before starting to work on an issue, please check if there is already
-a linked PR. If there is, try to work with the author by
-submitting reviews of their code or commenting on the PR rather than opening
-a new PR; duplicate PRs are unnecessary concurrent work and thus are subject
-to being closed.  However, if the existing
-PR is an outline, unlikely to work, or stalled, and the original author is
-unresponsive, feel free to open a new PR referencing the old one.
-
+.. dropdown:: Do I really have something to contribute to Matplotlib?
+    :open:
+    :icon: person-fill
+
+    100% yes! There are so many ways to contribute to our community. Take a look
+    at the following sections to learn more.
+
+    There are a few typical new contributor profiles:
+
+    * **You are a Matplotlib user, and you see a bug, a potential improvement, or
+      something that annoys you, and you can fix it.**
+
+      You can search our issue tracker for an existing issue that describes your problem or
+      open a new issue to inform us of the problem you observed and discuss the best approach
+      to fix it. If your contributions would not be captured on GitHub (social media,
+      communication, educational content), you can also reach out to us on gitter_,
+      `Discourse <https://discourse.matplotlib.org/>`__ or attend any of our `community
+      meetings <https://scientific-python.org/calendars>`__.
+
+    * **You are not a regular Matplotlib user but a domain expert: you know about
+      visualization, 3D plotting, design, technical writing, statistics, or some
+      other field where Matplotlib could be improved.**
+
+      Awesome -- you have a focus on a specific application and domain and can
+      start there. In this case, maintainers can help you figure out the best
+      implementation; open an issue or pull request with a starting point, and we'll
+      be happy to discuss technical approaches.
+
+      If you prefer, you can use the `GitHub functionality for "draft" pull requests
+      <https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/changing-the-stage-of-a-pull-request#converting-a-pull-request-to-a-draft>`__
+      and request early feedback on whatever you are working on, but you should be
+      aware that maintainers may not review your contribution unless it has the
+      "Ready to review" state on GitHub.
+
+    * **You are new to Matplotlib, both as a user and contributor, and want to start
+      contributing but have yet to develop a particular interest.**
+
+      Having some previous experience or relationship with the library can be very
+      helpful when making open-source contributions. It helps you understand why
+      things are the way they are and how they *should* be. Having first-hand
+      experience and context is valuable both for what you can bring to the
+      conversation (and given the breadth of Matplotlib's usage, there is a good
+      chance it is a unique context in any given conversation) and make it easier to
+      understand where other people are coming from.
+
+      Understanding the entire codebase is a long-term project, and nobody expects
+      you to do this right away. If you are determined to get started with
+      Matplotlib and want to learn, going through the basic functionality,
+      choosing something to focus on (3d, testing, documentation, animations, etc.)
+      and gaining context on this area by reading the issues and pull requests
+      touching these subjects is a reasonable approach.
 
 .. _contribute_code:
 
-Contribute code
-===============
+Code
+----
 You want to implement a feature or fix a bug or help with maintenance - much
-appreciated! Our library source code is found in
+appreciated! Our library source code is found in:
 
 * Python library code: :file:`lib/`
 * C-extension code: :file:`src/`
@@ -193,8 +106,8 @@ Code is contributed through pull requests, so we recommend that you start at
 
 .. _contribute_documentation:
 
-Contribute documentation
-========================
+Documentation
+-------------
 
 You as an end-user of Matplotlib can make a valuable contribution because you
 more clearly see the potential for improvement than a core developer. For example,
@@ -218,15 +131,16 @@ document's URL roughly corresponds to its location in our folder structure:
       * :file:`galleries/user_explain/`
       * :file:`galleries/tutorials/`
       * :file:`galleries/examples/`
-      * :file:`doc/api`
+      * :file:`doc/api/`
 
   .. grid-item:: information about the library
 
       * :file:`doc/install/`
       * :file:`doc/project/`
-      * :file:`doc/users/resources/`
-      * :file:`doc/users/faq.rst`
       * :file:`doc/devel/`
+      * :file:`doc/users/resources/index.rst`
+      * :file:`doc/users/faq.rst`
+
 
 Other documentation is generated from the following external sources:
 
@@ -250,25 +164,111 @@ please reach out on the :ref:`contributor_incubator`
 
 .. _other_ways_to_contribute:
 
-Other ways to contribute
-========================
-
-It also helps us if you spread the word: reference the project from your blog
-and articles or link to it from your website!
-
+Community
+---------
 Matplotlib's community is built by its members, if you would like to help out
 see our :ref:`communications-guidelines`.
 
+It helps us if you spread the word: reference the project from your blog
+and articles or link to it from your website!
+
 If Matplotlib contributes to a project that leads to a scientific publication,
-please follow the :doc:`/project/citing` guidelines.
+please cite us following the :doc:`/project/citing` guidelines.
 
 If you have developed an extension to Matplotlib, please consider adding it to our
 `third party package <https://github.com/matplotlib/mpl-third-party>`_  list.
 
+
+.. _get_connected:
+
+Get connected
+=============
+When in doubt, we recommend going together! Get connected with our community of
+active contributors, many of whom felt just like you when they started out and
+are happy to welcome you and support you as you get to know how we work, and
+where things are.
+
+.. _contributor_incubator:
+
+Contributor incubator
+---------------------
+
+The incubator is our non-public communication channel for new contributors. It
+is a private gitter_ (chat) room moderated by core Matplotlib developers where
+you can get guidance and support for your first few PRs. It's a place where you
+can ask questions about anything: how to use git, GitHub, how our PR review
+process works, technical questions about the code, what makes for good
+documentation or a blog post, how to get involved in community work, or get a
+"pre-review" on your PR.
+
+To join, please go to our public community_ channel, and ask to be added to
+``#incubator``. One of our core developers will see your message and will add you.
+
+.. _gitter: https://gitter.im/matplotlib/matplotlib
+.. _community: https://gitter.im/matplotlib/community
+
+
+.. _new_contributors:
+
+New Contributors Meeting
+------------------------
+
+Once a month, we host a meeting to discuss topics that interest new
+contributors. Anyone can attend, present, or sit in and listen to the call.
+Among our attendees are fellow new contributors, as well as maintainers, and
+veteran contributors, who are keen to support onboarding of new folks and
+share their experience. You can find our community calendar link at the
+`Scientific Python website <https://scientific-python.org/calendars/>`_, and
+you can browse previous meeting notes on `GitHub
+<https://github.com/matplotlib/ProjectManagement/tree/master/new_contributor_meeting>`_.
+We recommend joining the meeting to clarify any doubts, or lingering
+questions you might have, and to get to know a few of the people behind the
+GitHub handles 😉. You can reach out to us on gitter_ for any clarifications or
+suggestions. We ❤ feedback!
+
+.. _managing_issues_prs:
+
+Work on an issue
+================
+
+In general, the Matplotlib project does not assign issues. Issues are
+"assigned" or "claimed" by opening a PR; there is no other assignment
+mechanism. If you have opened such a PR, please comment on the issue thread to
+avoid duplication of work. Please check if there is an existing PR for the
+issue you are addressing. If there is, try to work with the author by
+submitting reviews of their code or commenting on the PR rather than opening
+a new PR; duplicate PRs are subject to being closed.  However, if the existing
+PR is an outline, unlikely to work, or stalled, and the original author is
+unresponsive, feel free to open a new PR referencing the old one.
+
+.. _good_first_issues:
+
+Good first issues
+-----------------
+
+While any contributions are welcome, we have marked some issues as
+particularly suited for new contributors by the label `good first issue
+<https://github.com/matplotlib/matplotlib/labels/good%20first%20issue>`_. These
+are well documented issues, that do not require a deep understanding of the
+internals of Matplotlib. The issues may additionally be tagged with a
+difficulty. ``Difficulty: Easy`` is suited for people with little Python
+experience. ``Difficulty: Medium`` and ``Difficulty: Hard`` require more
+programming experience. This could be for a variety of reasons, among them,
+though not necessarily all at the same time:
+
+- The issue is in areas of the code base which have more interdependencies,
+  or legacy code.
+- It has less clearly defined tasks, which require some independent
+  exploration, making suggestions, or follow-up discussions to clarify a good
+  path to resolve the issue.
+- It involves Python features such as decorators and context managers, which
+  have subtleties due to our implementation decisions.
+
+
 .. _how-to-pull-request:
 
-How to contribute via pull request
-==================================
+Start a pull request
+====================
 
 The preferred way to contribute to Matplotlib is to fork the `main
 repository <https://github.com/matplotlib/matplotlib/>`__ on GitHub,
@@ -346,26 +346,29 @@ A brief overview of the workflow is as follows.
 GitHub Codespaces workflows
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-* If you need to open a GUI window with Matplotlib output on Codespaces, our
-  configuration includes a `light-weight Fluxbox-based desktop
-  <https://github.com/devcontainers/features/tree/main/src/desktop-lite>`_.
-  You can use it by connecting to this desktop via your web browser. To do this:
-
-  #. Press ``F1`` or ``Ctrl/Cmd+Shift+P`` and select
-     ``Ports: Focus on Ports View`` in the VSCode session to bring it into
-     focus. Open the ports view in your tool, select the ``noVNC`` port, and
-     click the Globe icon.
-  #. In the browser that appears, click the Connect button and enter the desktop
-     password (``vscode`` by default).
-
-  Check the `GitHub instructions
-  <https://github.com/devcontainers/features/tree/main/src/desktop-lite#connecting-to-the-desktop>`_
-  for more details on connecting to the desktop.
-
-* If you also built the documentation pages, you can view them using Codespaces.
-  Use the "Extensions" icon in the activity bar to install the "Live Server"
-  extension. Locate the ``doc/build/html`` folder in the Explorer, right click
-  the file you want to open and select "Open with Live Server."
+If you need to open a GUI window with Matplotlib output on Codespaces, our
+configuration includes a `light-weight Fluxbox-based desktop
+<https://github.com/devcontainers/features/tree/main/src/desktop-lite>`_.
+You can use it by connecting to this desktop via your web browser. To do this:
+
+#. Press ``F1`` or ``Ctrl/Cmd+Shift+P`` and select
+    ``Ports: Focus on Ports View`` in the VSCode session to bring it into
+    focus. Open the ports view in your tool, select the ``noVNC`` port, and
+    click the Globe icon.
+#. In the browser that appears, click the Connect button and enter the desktop
+    password (``vscode`` by default).
+
+Check the `GitHub instructions
+<https://github.com/devcontainers/features/tree/main/src/desktop-lite#connecting-to-the-desktop>`_
+for more details on connecting to the desktop.
+
+View documentation
+""""""""""""""""""
+
+If you also built the documentation pages, you can view them using Codespaces.
+Use the "Extensions" icon in the activity bar to install the "Live Server"
+extension. Locate the ``doc/build/html`` folder in the Explorer, right click
+the file you want to open and select "Open with Live Server."
 
 
 Open a pull request on Matplotlib
diff --git a/doc/devel/index.rst b/doc/devel/index.rst
index f6075384c11a..9744d757c342 100644
--- a/doc/devel/index.rst
+++ b/doc/devel/index.rst
@@ -16,6 +16,10 @@ Contribute
 :octicon:`heart;1em;sd-text-info` Thank you for your interest in helping to improve
 Matplotlib! :octicon:`heart;1em;sd-text-info`
 
+There are various ways to contribute: optimizing and refactoring code, detailing
+unclear documentation and writing new examples, helping the community, reporting
+and fixing bugs and requesting and implementing new features...
+
 .. _submitting-a-bug-report:
 .. _request-a-new-feature:
 
@@ -54,14 +58,17 @@ Matplotlib! :octicon:`heart;1em;sd-text-info`
          Request a feature
 
 
-We welcome you to get more involved with the Matplotlib project.
-There are various ways to contribute:
-optimizing and refactoring code, detailing unclear documentation and writing new
-examples, helping the community, reporting and fixing bugs and requesting and
-implementing new features...
+We welcome you to get more involved with the Matplotlib project! If you are new
+to contributing, we recommend that you first read our
+:ref:`contributing guide<contributing>`. If you are contributing code or
+documentation, please follow our guides for setting up and managing a
+:ref:`development environment and workflow<development_environment>`.
+For code, documentation, or triage, please follow the corresponding
+:ref:`contribution guidelines <contribution_guideline>`.
 
 New contributors
 ================
+
 .. toctree::
    :hidden:
 
@@ -77,9 +84,7 @@ New contributors
 
       :octicon:`question;1em;sd-text-info` :ref:`Where should I ask questions? <get_connected>`
 
-      :octicon:`issue-opened;1em;sd-text-info` :ref:`What are "good-first-issues"? <new_contributors>`
-
-      :octicon:`git-pull-request;1em;sd-text-info` :ref:`How do I claim an issue? <managing_issues_prs>`
+      :octicon:`git-pull-request;1em;sd-text-info` :ref:`How do I work on an issue? <managing_issues_prs>`
 
       :octicon:`codespaces;1em;sd-text-info` :ref:`How do I start a pull request? <how-to-pull-request>`
 
@@ -108,15 +113,9 @@ New contributors
             :link-type: ref
             :shadow: none
 
-            :octicon:`paper-airplane;1em;sd-text-info` Other ways to contribute
+            :octicon:`globe;1em;sd-text-info` Build community
 
 
-If you are new to contributing, we recommend that you first read our
-:ref:`contributing guide<contributing>`. If you are contributing code or
-documentation, please follow our guides for setting up and managing a
-:ref:`development environment and workflow<development_environment>`.
-For code, documentation, or triage, please follow the corresponding
-:ref:`contribution guidelines <contribution_guideline>`.
 
 
 .. _development_environment:
diff --git a/doc/project/citing.rst b/doc/project/citing.rst
index 4a1021ea2701..008ee794a41b 100644
--- a/doc/project/citing.rst
+++ b/doc/project/citing.rst
@@ -1,6 +1,8 @@
 .. redirect-from:: /citing
 .. redirect-from:: /users/project/citing
 
+.. _citing_matplotlib:
+
 Citing Matplotlib
 =================
 

From a9e5ee3e8bb38928a65edca1445183a744295b21 Mon Sep 17 00:00:00 2001
From: David Stansby <dstansby@gmail.com>
Date: Sun, 7 Apr 2024 15:16:58 +0200
Subject: [PATCH 0942/1120] Backport PR #28023: ci: Update merge conflict
 labeler

---
 .github/workflows/conflictcheck.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/conflictcheck.yml b/.github/workflows/conflictcheck.yml
index 48be8ba510c5..3eb384fa6585 100644
--- a/.github/workflows/conflictcheck.yml
+++ b/.github/workflows/conflictcheck.yml
@@ -17,7 +17,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Check if PRs have merge conflicts
-        uses: eps1lon/actions-label-merge-conflict@releases/2.x
+        uses: eps1lon/actions-label-merge-conflict@e62d7a53ff8be8b97684bffb6cfbbf3fc1115e2e  # v3.0.0
         with:
           dirtyLabel: "status: needs rebase"
           repoToken: "${{ secrets.GITHUB_TOKEN }}"

From a47be775c99cdb0cbfac7ffbcd8aaf5a7e818daa Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Tue, 9 Apr 2024 05:28:44 -0400
Subject: [PATCH 0943/1120] Backport PR #28036: BLD: Fetch version from
 setuptools_scm at build time

---
 .circleci/config.yml | 2 +-
 azure-pipelines.yml  | 2 +-
 meson.build          | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/.circleci/config.yml b/.circleci/config.yml
index 468bec6eee7d..1ab22d302314 100644
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -103,7 +103,7 @@ commands:
       - run:
           name: Install Python dependencies
           command: |
-            python -m pip install --user meson-python pybind11
+            python -m pip install --user meson-python numpy pybind11 setuptools-scm
             python -m pip install --user \
                 numpy<< parameters.numpy_version >> \
                 -r requirements/doc/doc-requirements.txt
diff --git a/azure-pipelines.yml b/azure-pipelines.yml
index cb5be2379091..2ad9a7821b5c 100644
--- a/azure-pipelines.yml
+++ b/azure-pipelines.yml
@@ -135,7 +135,7 @@ stages:
 
           - bash: |
               python -m pip install --upgrade pip
-              python -m pip install --upgrade meson-python pybind11
+              python -m pip install --upgrade meson-python numpy pybind11 setuptools-scm
               python -m pip install -r requirements/testing/all.txt -r requirements/testing/extra.txt
             displayName: 'Install dependencies with pip'
 
diff --git a/meson.build b/meson.build
index 21bc0ae95580..c022becfd9d9 100644
--- a/meson.build
+++ b/meson.build
@@ -1,7 +1,7 @@
 project(
   'matplotlib',
   'c', 'cpp',
-  version: '3.9.0.dev0',
+  version: run_command(find_program('python3'), '-m', 'setuptools_scm', check: true).stdout().strip(),
   # qt_editor backend is MIT
   # ResizeObserver at end of lib/matplotlib/backends/web_backend/js/mpl.js is CC0
   # Carlogo, STIX and Computer Modern is OFL

From 29c15c32d54f4a6988c5c728fc0374d182668dd8 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Tue, 9 Apr 2024 13:42:11 -0400
Subject: [PATCH 0944/1120] DOC: Prepare release notes for 3.9.0rc2

---
 doc/users/github_stats.rst | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/doc/users/github_stats.rst b/doc/users/github_stats.rst
index e52a85a3f840..794798a3b59d 100644
--- a/doc/users/github_stats.rst
+++ b/doc/users/github_stats.rst
@@ -1,16 +1,16 @@
 .. _github-stats:
 
-GitHub statistics for 3.9.0 (Apr 05, 2024)
+GitHub statistics for 3.9.0 (Apr 09, 2024)
 ==========================================
 
-GitHub statistics for 2023/09/15 (tag: v3.8.0) - 2024/04/05
+GitHub statistics for 2023/09/15 (tag: v3.8.0) - 2024/04/09
 
 These lists are automatically generated, and may be incomplete or contain duplicates.
 
-We closed 85 issues and merged 387 pull requests.
+We closed 86 issues and merged 393 pull requests.
 The full list can be seen `on GitHub <https://github.com/matplotlib/matplotlib/milestone/78?closed=1>`__
 
-The following 170 authors contributed 2480 commits.
+The following 170 authors contributed 2496 commits.
 
 * 0taj
 * Abdul Razak Taha
@@ -185,8 +185,14 @@ The following 170 authors contributed 2480 commits.
 
 GitHub issues and pull requests:
 
-Pull Requests (387):
+Pull Requests (393):
 
+* :ghpull:`28049`: Backport PR #28036 on branch v3.9.x (BLD: Fetch version from setuptools_scm at build time)
+* :ghpull:`28036`: BLD: Fetch version from setuptools_scm at build time
+* :ghpull:`28038`: Backport PR #28023 on branch v3.9.x (ci: Update merge conflict labeler)
+* :ghpull:`28023`: ci: Update merge conflict labeler
+* :ghpull:`28035`: Backport PR #28026 on branch v3.9.x ([DOC] reshuffle of contributing)
+* :ghpull:`28026`: [DOC] reshuffle of contributing
 * :ghpull:`28024`: DOC: Rewrite "Work on an issue" section
 * :ghpull:`28011`: DOC: Move bug reports and feature requests to top of contributing index
 * :ghpull:`27747`: Move doc/users/installing/ to doc/install/
@@ -575,8 +581,9 @@ Pull Requests (387):
 * :ghpull:`26482`: [DOC]: print pydata sphinx/mpl theme versions
 * :ghpull:`23787`: Use pybind11 for C/C++ extensions
 
-Issues (85):
+Issues (86):
 
+* :ghissue:`28005`: [Doc]: Improve contribute instructions
 * :ghissue:`22376`: [ENH]: align_titles
 * :ghissue:`5506`: Confusing status bar values in presence of multiple axes
 * :ghissue:`4284`: Twin axis message coordinates

From eb1db59c77a6e74bed94e9197a7de323454749c9 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Tue, 9 Apr 2024 13:42:51 -0400
Subject: [PATCH 0945/1120] REL: v3.9.0rc2

This is the second release candidate for the meso release 3.9.0.

From ad64904c63fd1d11f1bda49f8801c0a4421f4e18 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Tue, 9 Apr 2024 13:44:54 -0400
Subject: [PATCH 0946/1120] BLD: bump branch away from tag

So the tarballs from GitHub are stable.

From 28ab92ef7915b14eb80be52c8254b02b1a5d9083 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Fri, 12 Apr 2024 10:35:39 +0200
Subject: [PATCH 0947/1120] Backport PR #28056: Strip trailing spaces from
 log-formatter cursor output.

---
 lib/matplotlib/tests/test_ticker.py | 10 +++++-----
 lib/matplotlib/ticker.py            |  2 +-
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/lib/matplotlib/tests/test_ticker.py b/lib/matplotlib/tests/test_ticker.py
index 565f32105cea..36b83c95b3d3 100644
--- a/lib/matplotlib/tests/test_ticker.py
+++ b/lib/matplotlib/tests/test_ticker.py
@@ -1177,11 +1177,11 @@ def test_pprint(self, value, domain, expected):
         assert label == expected
 
     @pytest.mark.parametrize('value, long, short', [
-        (0.0, "0", "0           "),
-        (0, "0", "0           "),
-        (-1.0, "-10^0", "-1          "),
-        (2e-10, "2x10^-10", "2e-10       "),
-        (1e10, "10^10", "1e+10       "),
+        (0.0, "0", "0"),
+        (0, "0", "0"),
+        (-1.0, "-10^0", "-1"),
+        (2e-10, "2x10^-10", "2e-10"),
+        (1e10, "10^10", "1e+10"),
     ])
     def test_format_data(self, value, long, short):
         fig, ax = plt.subplots()
diff --git a/lib/matplotlib/ticker.py b/lib/matplotlib/ticker.py
index 16949204a218..f042372a7be9 100644
--- a/lib/matplotlib/ticker.py
+++ b/lib/matplotlib/ticker.py
@@ -1024,7 +1024,7 @@ def format_data(self, value):
 
     def format_data_short(self, value):
         # docstring inherited
-        return '%-12g' % value
+        return ('%-12g' % value).rstrip()
 
     def _pprint_val(self, x, d):
         # If the number is not too big and it's an int, format it as an int.

From 8824ac6922724f3af56c21b0d774b9a7449b67a0 Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Fri, 12 Apr 2024 10:50:01 +0100
Subject: [PATCH 0948/1120] Backport PR #28055: DOC: Improve inverted axis
 example

---
 .../subplots_axes_and_figures/invert_axes.py  | 38 ++++++++++++-------
 1 file changed, 24 insertions(+), 14 deletions(-)

diff --git a/galleries/examples/subplots_axes_and_figures/invert_axes.py b/galleries/examples/subplots_axes_and_figures/invert_axes.py
index 15ec55d430bd..31f4d75680ce 100644
--- a/galleries/examples/subplots_axes_and_figures/invert_axes.py
+++ b/galleries/examples/subplots_axes_and_figures/invert_axes.py
@@ -1,25 +1,35 @@
 """
-===========
-Invert Axes
-===========
+=============
+Inverted axis
+=============
 
-You can use decreasing axes by flipping the normal order of the axis
-limits
+This example demonstrates two ways to invert the direction of an axis:
+
+- If you want to set *explicit axis limits* anyway, e.g. via `~.Axes.set_xlim`, you
+  can swap the limit values: ``set_xlim(4, 0)`` instead of ``set_xlim(0, 4)``.
+- Use `.Axis.set_inverted` if you only want to invert the axis *without modifying
+  the limits*, i.e. keep existing limits or existing autoscaling behavior.
 """
 
 import matplotlib.pyplot as plt
 import numpy as np
 
-t = np.arange(0.01, 5.0, 0.01)
-s = np.exp(-t)
+x = np.arange(0.01, 4.0, 0.01)
+y = np.exp(-x)
+
+fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(6.4,  4), layout="constrained")
+fig.suptitle('Inverted axis with ...')
 
-fig, ax = plt.subplots()
+ax1.plot(x, y)
+ax1.set_xlim(4, 0)   # inverted fixed limits
+ax1.set_title('fixed limits: set_xlim(4, 0)')
+ax1.set_xlabel('decreasing x ⟶')
+ax1.grid(True)
 
-ax.plot(t, s)
-ax.set_xlim(5, 0)  # decreasing time
-ax.set_xlabel('decreasing time (s)')
-ax.set_ylabel('voltage (mV)')
-ax.set_title('Should be growing...')
-ax.grid(True)
+ax2.plot(x, y)
+ax2.xaxis.set_inverted(True)  # inverted axis with autoscaling
+ax2.set_title('autoscaling: set_inverted(True)')
+ax2.set_xlabel('decreasing x ⟶')
+ax2.grid(True)
 
 plt.show()

From 4c140989cc446b62ad3f196a5363923b783642fd Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Mon, 15 Apr 2024 15:38:33 +0200
Subject: [PATCH 0949/1120] Backport PR #28077: Parent tk StringVar to the
 canvas widget, not to the toolbar.

---
 lib/matplotlib/backends/_backend_tk.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/backends/_backend_tk.py b/lib/matplotlib/backends/_backend_tk.py
index 5eca9229b61d..693499f4ca01 100644
--- a/lib/matplotlib/backends/_backend_tk.py
+++ b/lib/matplotlib/backends/_backend_tk.py
@@ -843,7 +843,7 @@ def save_figure(self, *args):
 
         default_extension = self.canvas.get_default_filetype()
         default_filetype = self.canvas.get_supported_filetypes()[default_extension]
-        filetype_variable = tk.StringVar(self, default_filetype)
+        filetype_variable = tk.StringVar(self.canvas.get_tk_widget(), default_filetype)
 
         # adding a default extension seems to break the
         # asksaveasfilename dialog when you choose various save types

From 37fbeb87299dd3b8cc25c2d530df6bec89bbd9e9 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Mon, 15 Apr 2024 09:46:43 -0400
Subject: [PATCH 0950/1120] Backport PR #28078: Clarify that findfont &
 _find_fonts_by_props return paths.

---
 lib/matplotlib/font_manager.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/font_manager.py b/lib/matplotlib/font_manager.py
index 73da3c418dd7..312e8ee97246 100644
--- a/lib/matplotlib/font_manager.py
+++ b/lib/matplotlib/font_manager.py
@@ -1235,7 +1235,7 @@ def score_size(self, size1, size2):
     def findfont(self, prop, fontext='ttf', directory=None,
                  fallback_to_default=True, rebuild_if_missing=True):
         """
-        Find a font that most closely matches the given font properties.
+        Find the path to the font file most closely matching the given font properties.
 
         Parameters
         ----------
@@ -1305,7 +1305,7 @@ def get_font_names(self):
     def _find_fonts_by_props(self, prop, fontext='ttf', directory=None,
                              fallback_to_default=True, rebuild_if_missing=True):
         """
-        Find font families that most closely match the given properties.
+        Find the paths to the font files most closely matching the given properties.
 
         Parameters
         ----------
@@ -1335,7 +1335,7 @@ def _find_fonts_by_props(self, prop, fontext='ttf', directory=None,
         Returns
         -------
         list[str]
-            The paths of the fonts found
+            The paths of the fonts found.
 
         Notes
         -----

From 9fadef9b30672e6ff9e8bdb65566d6cfa8688f2b Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Tue, 16 Apr 2024 19:40:04 +0200
Subject: [PATCH 0951/1120] Backport PR #28087: Document Qt5 minimal version.

---
 doc/install/dependencies.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/doc/install/dependencies.rst b/doc/install/dependencies.rst
index 45dc249832ca..93c1990b9472 100644
--- a/doc/install/dependencies.rst
+++ b/doc/install/dependencies.rst
@@ -54,7 +54,8 @@ and the capabilities they provide.
 * Tk_ (>= 8.5, != 8.6.0 or 8.6.1): for the Tk-based backends. Tk is part of
   most standard Python installations, but it's not part of Python itself and
   thus may not be present in rare cases.
-* PyQt6_ (>= 6.1), PySide6_, PyQt5_, or PySide2_: for the Qt-based backends.
+* PyQt6_ (>= 6.1), PySide6_, PyQt5_ (>= 5.12), or PySide2_: for the Qt-based
+  backends.
 * PyGObject_ and pycairo_ (>= 1.14.0): for the GTK-based backends. If using pip
   (but not conda or system package manager) PyGObject must be built from
   source; see `pygobject documentation

From 87ca28745340b25f05b91945f93888d08ba69d23 Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Wed, 17 Apr 2024 07:11:24 +0200
Subject: [PATCH 0952/1120] Backport PR #28032: FIX: ensure images are C order
 before passing to pillow

---
 lib/matplotlib/image.py            | 1 +
 lib/matplotlib/tests/test_image.py | 8 ++++++++
 2 files changed, 9 insertions(+)

diff --git a/lib/matplotlib/image.py b/lib/matplotlib/image.py
index 5b0152505397..2e13293028ca 100644
--- a/lib/matplotlib/image.py
+++ b/lib/matplotlib/image.py
@@ -1640,6 +1640,7 @@ def imsave(fname, arr, vmin=None, vmax=None, cmap=None, format=None,
             # we modify this below, so make a copy (don't modify caller's dict)
             pil_kwargs = pil_kwargs.copy()
         pil_shape = (rgba.shape[1], rgba.shape[0])
+        rgba = np.require(rgba, requirements='C')
         image = PIL.Image.frombuffer(
             "RGBA", pil_shape, rgba, "raw", "RGBA", 0, 1)
         if format == "png":
diff --git a/lib/matplotlib/tests/test_image.py b/lib/matplotlib/tests/test_image.py
index fdbba7299d2b..1602f86716cb 100644
--- a/lib/matplotlib/tests/test_image.py
+++ b/lib/matplotlib/tests/test_image.py
@@ -205,6 +205,14 @@ def test_imsave(fmt):
     assert_array_equal(arr_dpi1, arr_dpi100)
 
 
+@pytest.mark.parametrize("origin", ["upper", "lower"])
+def test_imsave_rgba_origin(origin):
+    # test that imsave always passes c-contiguous arrays down to pillow
+    buf = io.BytesIO()
+    result = np.zeros((10, 10, 4), dtype='uint8')
+    mimage.imsave(buf, arr=result, format="png", origin=origin)
+
+
 @pytest.mark.parametrize("fmt", ["png", "pdf", "ps", "eps", "svg"])
 def test_imsave_fspath(fmt):
     plt.imsave(Path(os.devnull), np.array([[0, 1]]), format=fmt)

From 2ea48d39da0a219ee17faaf8ce3ecf67f71e9e89 Mon Sep 17 00:00:00 2001
From: Jody Klymak <jklymak@gmail.com>
Date: Wed, 17 Apr 2024 09:56:07 -0700
Subject: [PATCH 0953/1120] Backport PR #28094: DOC: exclude sphinx 7.3.*

---
 requirements/doc/doc-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements/doc/doc-requirements.txt b/requirements/doc/doc-requirements.txt
index 173fa30eafbf..8f8e01a34e4d 100644
--- a/requirements/doc/doc-requirements.txt
+++ b/requirements/doc/doc-requirements.txt
@@ -7,7 +7,7 @@
 # Install the documentation requirements with:
 #     pip install -r requirements/doc/doc-requirements.txt
 #
-sphinx>=3.0.0,!=6.1.2
+sphinx>=3.0.0,!=6.1.2,!=7.3.*
 colorspacious
 ipython
 ipywidgets

From df5ccceca2cb5c6b8be21b5638d31e2017e9d133 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Fri, 19 Apr 2024 19:49:09 +0200
Subject: [PATCH 0954/1120] Backport PR #28107: [DOC] Fix description in
 CapStyle example

---
 galleries/examples/lines_bars_and_markers/capstyle.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/galleries/examples/lines_bars_and_markers/capstyle.py b/galleries/examples/lines_bars_and_markers/capstyle.py
index f573aaa871b8..d17f86c6be58 100644
--- a/galleries/examples/lines_bars_and_markers/capstyle.py
+++ b/galleries/examples/lines_bars_and_markers/capstyle.py
@@ -3,8 +3,8 @@
 CapStyle
 =========
 
-The `matplotlib._enums.CapStyle` controls how Matplotlib draws the corners
-where two different line segments meet. For more details, see the
+The `matplotlib._enums.CapStyle` controls how Matplotlib draws the two
+endpoints (caps) of an unclosed line. For more details, see the
 `~matplotlib._enums.CapStyle` docs.
 """
 

From 077e6436192f5aaae6c942b5bee834f06a5264b7 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Fri, 19 Apr 2024 21:43:16 +0200
Subject: [PATCH 0955/1120] Backport PR #28100: TST: wxcairo sometimes raises
 OSError on missing cairo libraries

---
 lib/matplotlib/tests/test_getattr.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/tests/test_getattr.py b/lib/matplotlib/tests/test_getattr.py
index a34e82ed81ba..f0f5823600ca 100644
--- a/lib/matplotlib/tests/test_getattr.py
+++ b/lib/matplotlib/tests/test_getattr.py
@@ -26,7 +26,7 @@ def test_getattr(module_name):
     """
     try:
         module = import_module(module_name)
-    except (ImportError, RuntimeError) as e:
+    except (ImportError, RuntimeError, OSError) as e:
         # Skip modules that cannot be imported due to missing dependencies
         pytest.skip(f'Cannot import {module_name} due to {e}')
 

From 92fc90db29960473589a57e33b0f16bf77c88ca9 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Thu, 18 Apr 2024 20:48:15 -0400
Subject: [PATCH 0956/1120] Backport PR #28102: Fix typo in color mapping
 documentation in quick_start.py

---
 galleries/users_explain/quick_start.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/galleries/users_explain/quick_start.py b/galleries/users_explain/quick_start.py
index cf5e73555e27..1970f71f737c 100644
--- a/galleries/users_explain/quick_start.py
+++ b/galleries/users_explain/quick_start.py
@@ -503,7 +503,7 @@ def my_plotter(ax, data1, data2, param_dict):
 # Color mapped data
 # =================
 #
-# Often we want to have a third dimension in a plot represented by a colors in
+# Often we want to have a third dimension in a plot represented by colors in
 # a colormap. Matplotlib has a number of plot types that do this:
 
 X, Y = np.meshgrid(np.linspace(-3, 3, 128), np.linspace(-3, 3, 128))

From 282e58a9452282cbb64fb2c8bfa5e55b1b316232 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Tue, 16 Apr 2024 17:29:24 +0200
Subject: [PATCH 0957/1120] Backport PR #28085: Clarify that the pgf backend is
 never actually used interactively.

---
 galleries/users_explain/text/pgf.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/galleries/users_explain/text/pgf.py b/galleries/users_explain/text/pgf.py
index 0c63ec368043..9bcfe34a24b7 100644
--- a/galleries/users_explain/text/pgf.py
+++ b/galleries/users_explain/text/pgf.py
@@ -30,7 +30,9 @@
 
 The last method allows you to keep using regular interactive backends and to
 save xelatex, lualatex or pdflatex compiled PDF files from the graphical user
-interface.
+interface.  Note that, in that case, the interactive display will still use the
+standard interactive backends (e.g., QtAgg), and in particular use latex to
+compile relevant text snippets.
 
 Matplotlib's pgf support requires a recent LaTeX_ installation that includes
 the TikZ/PGF packages (such as TeXLive_), preferably with XeLaTeX or LuaLaTeX

From 03b23838d2ad9475f96a3c73dca6182ffe3cac3e Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Thu, 25 Apr 2024 07:52:14 +0200
Subject: [PATCH 0958/1120] Backport PR #28134: DOC: Minor improvements on
 quickstart

---
 .flake8                                |  1 +
 galleries/users_explain/quick_start.py | 48 ++++++++++++++------------
 2 files changed, 26 insertions(+), 23 deletions(-)

diff --git a/.flake8 b/.flake8
index b568af917f46..36e8bcf5476f 100644
--- a/.flake8
+++ b/.flake8
@@ -47,6 +47,7 @@ per-file-ignores =
     lib/mpl_toolkits/axisartist/angle_helper.py: E221
 
     doc/conf.py: E402
+    galleries/users_explain/quick_start.py: E402
     galleries/users_explain/artists/paths.py: E402
     galleries/users_explain/artists/patheffects_guide.py: E402
     galleries/users_explain/artists/transforms_tutorial.py: E402, E501
diff --git a/galleries/users_explain/quick_start.py b/galleries/users_explain/quick_start.py
index 1970f71f737c..30740f74b898 100644
--- a/galleries/users_explain/quick_start.py
+++ b/galleries/users_explain/quick_start.py
@@ -17,7 +17,6 @@
 import numpy as np
 
 # sphinx_gallery_thumbnail_number = 3
-import matplotlib as mpl
 
 # %%
 #
@@ -29,16 +28,18 @@
 # area where points can be specified in terms of x-y coordinates (or theta-r
 # in a polar plot, x-y-z in a 3D plot, etc.).  The simplest way of
 # creating a Figure with an Axes is using `.pyplot.subplots`. We can then use
-# `.Axes.plot` to draw some data on the Axes:
+# `.Axes.plot` to draw some data on the Axes, and `~.pyplot.show` to display
+# the figure:
 
-fig, ax = plt.subplots()  # Create a figure containing a single Axes.
+fig, ax = plt.subplots()             # Create a figure containing a single Axes.
 ax.plot([1, 2, 3, 4], [1, 4, 2, 3])  # Plot some data on the Axes.
+plt.show()                           # Show the figure.
 
 # %%
 #
-# Note that to get this Figure to display, you may have to call ``plt.show()``,
-# depending on your backend.  For more details of Figures and backends, see
-# :ref:`figure-intro`.
+# Depending on the environment you are working in, ``plt.show()`` can be left
+# out. This is for example the case with Jupyter notebooks, which
+# automatically show all figures created in a code cell.
 #
 # .. _figure_parts:
 #
@@ -54,24 +55,24 @@
 #
 # The **whole** figure.  The Figure keeps
 # track of all the child :class:`~matplotlib.axes.Axes`, a group of
-# 'special' Artists (titles, figure legends, colorbars, etc), and
+# 'special' Artists (titles, figure legends, colorbars, etc.), and
 # even nested subfigures.
 #
-# The easiest way to create a new Figure is with pyplot::
+# Typically, you'll create a new Figure through one of the following
+# functions::
 #
-#    fig = plt.figure()  # an empty figure with no Axes
-#    fig, ax = plt.subplots()  # a figure with a single Axes
+#    fig = plt.figure()             # an empty figure with no Axes
+#    fig, ax = plt.subplots()       # a figure with a single Axes
 #    fig, axs = plt.subplots(2, 2)  # a figure with a 2x2 grid of Axes
 #    # a figure with one Axes on the left, and two on the right:
 #    fig, axs = plt.subplot_mosaic([['left', 'right_top'],
 #                                   ['left', 'right_bottom']])
 #
-# It is often convenient to create the Axes together with the Figure, but you
-# can also manually add Axes later on.  Note that many
-# :ref:`Matplotlib backends <backends>` support zooming and
-# panning on figure windows.
+# `~.pyplot.subplots()` and `~.pyplot.subplot_mosaic` are convenience functions
+# that additionally create Axes objects inside the Figure, but you can also
+# manually add Axes later on.
 #
-# For more on Figures, see :ref:`figure-intro`.
+# For more on Figures, including panning and zooming, see :ref:`figure-intro`.
 #
 # :class:`~matplotlib.axes.Axes`
 # ------------------------------
@@ -86,10 +87,9 @@
 # :meth:`~matplotlib.axes.Axes.set_xlabel`), and a y-label set via
 # :meth:`~matplotlib.axes.Axes.set_ylabel`).
 #
-# The :class:`~.axes.Axes` class and its member functions are the primary
-# entry point to working with the OOP interface, and have most of the
-# plotting methods defined on them (e.g. ``ax.plot()``, shown above, uses
-# the `~.Axes.plot` method)
+# The `~.axes.Axes` methods are the primary interface for configuring
+# most parts of your plot (adding data, controlling axis scales and
+# limits, adding labels etc.).
 #
 # :class:`~matplotlib.axis.Axis`
 # ------------------------------
@@ -446,13 +446,14 @@ def my_plotter(ax, data1, data2, param_dict):
 # well as floating point numbers.  These get special locators and formatters
 # as appropriate.  For dates:
 
+from matplotlib.dates import ConciseDateFormatter
+
 fig, ax = plt.subplots(figsize=(5, 2.7), layout='constrained')
 dates = np.arange(np.datetime64('2021-11-15'), np.datetime64('2021-12-25'),
                   np.timedelta64(1, 'h'))
 data = np.cumsum(np.random.randn(len(dates)))
 ax.plot(dates, data)
-cdf = mpl.dates.ConciseDateFormatter(ax.xaxis.get_major_locator())
-ax.xaxis.set_major_formatter(cdf)
+ax.xaxis.set_major_formatter(ConciseDateFormatter(ax.xaxis.get_major_locator()))
 
 # %%
 # For more information see the date examples
@@ -506,6 +507,8 @@ def my_plotter(ax, data1, data2, param_dict):
 # Often we want to have a third dimension in a plot represented by colors in
 # a colormap. Matplotlib has a number of plot types that do this:
 
+from matplotlib.colors import LogNorm
+
 X, Y = np.meshgrid(np.linspace(-3, 3, 128), np.linspace(-3, 3, 128))
 Z = (1 - X/2 + X**5 + Y**3) * np.exp(-X**2 - Y**2)
 
@@ -518,8 +521,7 @@ def my_plotter(ax, data1, data2, param_dict):
 fig.colorbar(co, ax=axs[0, 1])
 axs[0, 1].set_title('contourf()')
 
-pc = axs[1, 0].imshow(Z**2 * 100, cmap='plasma',
-                          norm=mpl.colors.LogNorm(vmin=0.01, vmax=100))
+pc = axs[1, 0].imshow(Z**2 * 100, cmap='plasma', norm=LogNorm(vmin=0.01, vmax=100))
 fig.colorbar(pc, ax=axs[1, 0], extend='both')
 axs[1, 0].set_title('imshow() with LogNorm()')
 

From db8abc20c22a375465abe301d421ec23ed6220df Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Thu, 25 Apr 2024 14:39:48 -0500
Subject: [PATCH 0959/1120] Backport PR #28068: [TYP] Add possible type hint to
 `colors` argument in `LinearSegmentedColormap.from_list`

---
 lib/matplotlib/colors.pyi | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/colors.pyi b/lib/matplotlib/colors.pyi
index 9bb1725f4f78..514801b714b8 100644
--- a/lib/matplotlib/colors.pyi
+++ b/lib/matplotlib/colors.pyi
@@ -124,7 +124,7 @@ class LinearSegmentedColormap(Colormap):
     def set_gamma(self, gamma: float) -> None: ...
     @staticmethod
     def from_list(
-        name: str, colors: ArrayLike, N: int = ..., gamma: float = ...
+        name: str, colors: ArrayLike | Sequence[tuple[float, ColorType]], N: int = ..., gamma: float = ...
     ) -> LinearSegmentedColormap: ...
     def resampled(self, lutsize: int) -> LinearSegmentedColormap: ...
     def reversed(self, name: str | None = ...) -> LinearSegmentedColormap: ...

From 191b3399e07069ef15bb399aea73b70ec4619340 Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Thu, 25 Apr 2024 11:53:38 +0200
Subject: [PATCH 0960/1120] Backport PR #28136: Appease pycodestyle.

---
 lib/matplotlib/backends/backend_ps.py | 3 +--
 lib/matplotlib/projections/polar.py   | 6 +-----
 2 files changed, 2 insertions(+), 7 deletions(-)

diff --git a/lib/matplotlib/backends/backend_ps.py b/lib/matplotlib/backends/backend_ps.py
index d760bef04d19..5f224f38af1e 100644
--- a/lib/matplotlib/backends/backend_ps.py
+++ b/lib/matplotlib/backends/backend_ps.py
@@ -362,8 +362,7 @@ def create_hatch(self, hatch):
      /PaintProc {{
         pop
         {linewidth:g} setlinewidth
-{self._convert_path(
-    Path.hatch(hatch), Affine2D().scale(sidelen), simplify=False)}
+{self._convert_path(Path.hatch(hatch), Affine2D().scale(sidelen), simplify=False)}
         gsave
         fill
         grestore
diff --git a/lib/matplotlib/projections/polar.py b/lib/matplotlib/projections/polar.py
index 6bd72d2e35e0..8d3e03f64e7c 100644
--- a/lib/matplotlib/projections/polar.py
+++ b/lib/matplotlib/projections/polar.py
@@ -270,11 +270,7 @@ def __call__(self, x, pos=None):
         vmin, vmax = self.axis.get_view_interval()
         d = np.rad2deg(abs(vmax - vmin))
         digits = max(-int(np.log10(d) - 1.5), 0)
-        # Use Unicode rather than mathtext with \circ, so that it will work
-        # correctly with any arbitrary font (assuming it has a degree sign),
-        # whereas $5\circ$ will only work correctly with one of the supported
-        # math fonts (Computer Modern and STIX).
-        return f"{np.rad2deg(x):0.{digits:d}f}\N{DEGREE SIGN}"
+        return f"{np.rad2deg(x):0.{digits}f}\N{DEGREE SIGN}"
 
 
 class _AxisWrapper:

From 3005cd53ab1e02e242df0da49397ea6869676056 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Thu, 25 Apr 2024 17:31:29 -0500
Subject: [PATCH 0961/1120] Backport PR #27960: Update AppVeyor config

---
 .appveyor.yml                            | 10 ++++------
 lib/matplotlib/tests/test_tightlayout.py |  2 +-
 2 files changed, 5 insertions(+), 7 deletions(-)

diff --git a/.appveyor.yml b/.appveyor.yml
index 01f2a2fb6e21..87f6cbde6384 100644
--- a/.appveyor.yml
+++ b/.appveyor.yml
@@ -29,12 +29,9 @@ environment:
                  --cov-report= --cov=lib --log-level=DEBUG
 
   matrix:
-    - PYTHON_VERSION: "3.9"
+    - PYTHON_VERSION: "3.11"
       CONDA_INSTALL_LOCN: "C:\\Miniconda3-x64"
-      TEST_ALL: "no"
-    - PYTHON_VERSION: "3.10"
-      CONDA_INSTALL_LOCN: "C:\\Miniconda3-x64"
-      TEST_ALL: "no"
+      TEST_ALL: "yes"
 
 # We always use a 64-bit machine, but can build x86 distributions
 # with the PYTHON_ARCH variable
@@ -77,7 +74,8 @@ test_script:
   - '"%DUMPBIN%" /DEPENDENTS lib\matplotlib\ft2font*.pyd | findstr freetype.*.dll && exit /b 1 || exit /b 0'
 
   # this are optional dependencies so that we don't skip so many tests...
-  - if x%TEST_ALL% == xyes conda install -q ffmpeg inkscape miktex
+  - if x%TEST_ALL% == xyes conda install -q ffmpeg inkscape
+  # miktex is available on conda, but seems to fail with permission errors.
   # missing packages on conda-forge for imagemagick
   # This install sometimes failed randomly :-(
   # - choco install imagemagick
diff --git a/lib/matplotlib/tests/test_tightlayout.py b/lib/matplotlib/tests/test_tightlayout.py
index 0f83cca6b642..9c654f4d1f48 100644
--- a/lib/matplotlib/tests/test_tightlayout.py
+++ b/lib/matplotlib/tests/test_tightlayout.py
@@ -130,7 +130,7 @@ def test_tight_layout7():
     plt.tight_layout()
 
 
-@image_comparison(['tight_layout8'])
+@image_comparison(['tight_layout8'], tol=0.005)
 def test_tight_layout8():
     """Test automatic use of tight_layout."""
     fig = plt.figure()

From 46b6f23f0d6f92068e959c058dea80b331c4e2af Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Wed, 1 May 2024 10:31:05 -0400
Subject: [PATCH 0962/1120] Backport PR #28157: Remove call to non-existent
 method _default_contains in Artist

---
 lib/matplotlib/artist.py | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/lib/matplotlib/artist.py b/lib/matplotlib/artist.py
index b79d3cc62338..d5b8631e95df 100644
--- a/lib/matplotlib/artist.py
+++ b/lib/matplotlib/artist.py
@@ -493,9 +493,6 @@ def contains(self, mouseevent):
             such as which points are contained in the pick radius. See the
             individual Artist subclasses for details.
         """
-        inside, info = self._default_contains(mouseevent)
-        if inside is not None:
-            return inside, info
         _log.warning("%r needs 'contains' method", self.__class__.__name__)
         return False, {}
 

From f7975549dac1727081acdf5f5560be3b61b56673 Mon Sep 17 00:00:00 2001
From: Illviljan <14371165+Illviljan@users.noreply.github.com>
Date: Wed, 1 May 2024 22:18:51 +0200
Subject: [PATCH 0963/1120] Backport PR #28039: Respect vertical_axis when
 rotating plot interactively

---
 lib/mpl_toolkits/mplot3d/axes3d.py            | 14 ++++++++---
 lib/mpl_toolkits/mplot3d/tests/test_axes3d.py | 25 +++++++++++++++++++
 2 files changed, 36 insertions(+), 3 deletions(-)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index 9ca5692c40ab..d0f5c8d2b23b 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -1147,7 +1147,8 @@ def view_init(self, elev=None, azim=None, roll=None, vertical_axis="z",
         if roll is None:
             roll = self.initial_roll
         vertical_axis = _api.check_getitem(
-            dict(x=0, y=1, z=2), vertical_axis=vertical_axis
+            {name: idx for idx, name in enumerate(self._axis_names)},
+            vertical_axis=vertical_axis,
         )
 
         if share:
@@ -1318,7 +1319,7 @@ def shareview(self, other):
             raise ValueError("view angles are already shared")
         self._shared_axes["view"].join(self, other)
         self._shareview = other
-        vertical_axis = {0: "x", 1: "y", 2: "z"}[other._vertical_axis]
+        vertical_axis = self._axis_names[other._vertical_axis]
         self.view_init(elev=other.elev, azim=other.azim, roll=other.roll,
                        vertical_axis=vertical_axis, share=True)
 
@@ -1523,7 +1524,14 @@ def _on_move(self, event):
             dazim = -(dy/h)*180*np.sin(roll) - (dx/w)*180*np.cos(roll)
             elev = self.elev + delev
             azim = self.azim + dazim
-            self.view_init(elev=elev, azim=azim, roll=roll, share=True)
+            vertical_axis = self._axis_names[self._vertical_axis]
+            self.view_init(
+                elev=elev,
+                azim=azim,
+                roll=roll,
+                vertical_axis=vertical_axis,
+                share=True,
+            )
             self.stale = True
 
         # Pan
diff --git a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
index 7662509dd9cf..731b0413bf65 100644
--- a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
@@ -2250,6 +2250,31 @@ def test_view_init_vertical_axis(
         np.testing.assert_array_equal(tickdir_expected, tickdir_actual)
 
 
+@pytest.mark.parametrize("vertical_axis", ["x", "y", "z"])
+def test_on_move_vertical_axis(vertical_axis: str) -> None:
+    """
+    Test vertical axis is respected when rotating the plot interactively.
+    """
+    ax = plt.subplot(1, 1, 1, projection="3d")
+    ax.view_init(elev=0, azim=0, roll=0, vertical_axis=vertical_axis)
+    ax.figure.canvas.draw()
+
+    proj_before = ax.get_proj()
+    event_click = mock_event(ax, button=MouseButton.LEFT, xdata=0, ydata=1)
+    ax._button_press(event_click)
+
+    event_move = mock_event(ax, button=MouseButton.LEFT, xdata=0.5, ydata=0.8)
+    ax._on_move(event_move)
+
+    assert ax._axis_names.index(vertical_axis) == ax._vertical_axis
+
+    # Make sure plot has actually moved:
+    proj_after = ax.get_proj()
+    np.testing.assert_raises(
+        AssertionError, np.testing.assert_allclose, proj_before, proj_after
+    )
+
+
 @image_comparison(baseline_images=['arc_pathpatch.png'],
                   remove_text=True,
                   style='mpl20')

From 2fec35ac6007eabd5d84244fe096297b723c98d4 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 2 May 2024 15:06:23 -0400
Subject: [PATCH 0964/1120] Backport PR #27948: Move IPython backend mapping to
 Matplotlib and support entry points

---
 .github/workflows/tests.yml                   |   3 +-
 doc/users/next_whats_new/backend_registry.rst |  13 +-
 galleries/users_explain/figure/backends.rst   |  14 +-
 .../users_explain/figure/figure_intro.rst     |  31 +-
 .../writing_a_backend_pyplot_interface.rst    |  44 ++
 lib/matplotlib/__init__.py                    |   4 +-
 lib/matplotlib/backend_bases.py               |  15 +-
 lib/matplotlib/backends/registry.py           | 376 ++++++++++++++++--
 lib/matplotlib/backends/registry.pyi          |  23 +-
 lib/matplotlib/cbook.py                       |   9 -
 lib/matplotlib/cbook.pyi                      |   1 -
 lib/matplotlib/pyplot.py                      |  31 +-
 lib/matplotlib/rcsetup.py                     |  12 +-
 lib/matplotlib/testing/__init__.py            |  38 ++
 lib/matplotlib/testing/__init__.pyi           |   5 +
 lib/matplotlib/tests/test_backend_inline.py   |  46 +++
 lib/matplotlib/tests/test_backend_macosx.py   |   5 +
 lib/matplotlib/tests/test_backend_nbagg.py    |  10 +
 lib/matplotlib/tests/test_backend_qt.py       |   6 +-
 lib/matplotlib/tests/test_backend_registry.py | 105 ++++-
 .../tests/test_backends_interactive.py        |   2 +-
 lib/matplotlib/tests/test_inline_01.ipynb     |  79 ++++
 lib/matplotlib/tests/test_matplotlib.py       |   2 +-
 lib/matplotlib/tests/test_nbagg_01.ipynb      |  27 +-
 24 files changed, 803 insertions(+), 98 deletions(-)
 create mode 100644 lib/matplotlib/tests/test_backend_inline.py
 create mode 100644 lib/matplotlib/tests/test_inline_01.ipynb

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 1cead94098a8..13f6e8352d73 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -59,7 +59,8 @@ jobs:
             delete-font-cache: true
           - os: ubuntu-20.04
             python-version: 3.9
-            extra-requirements: '-r requirements/testing/extra.txt'
+            # One CI run tests ipython/matplotlib-inline before backend mapping moved to mpl
+            extra-requirements: '-r requirements/testing/extra.txt "ipython<8.24" "matplotlib-inline<0.1.7"'
             CFLAGS: "-fno-lto"  # Ensure that disabling LTO works.
             # https://github.com/matplotlib/matplotlib/pull/26052#issuecomment-1574595954
             # https://www.riverbankcomputing.com/pipermail/pyqt/2023-November/045606.html
diff --git a/doc/users/next_whats_new/backend_registry.rst b/doc/users/next_whats_new/backend_registry.rst
index 61b65a9d6470..7632c978f9c5 100644
--- a/doc/users/next_whats_new/backend_registry.rst
+++ b/doc/users/next_whats_new/backend_registry.rst
@@ -3,4 +3,15 @@ BackendRegistry
 
 New :class:`~matplotlib.backends.registry.BackendRegistry` class is the single
 source of truth for available backends. The singleton instance is
-``matplotlib.backends.backend_registry``.
+``matplotlib.backends.backend_registry``. It is used internally by Matplotlib,
+and also IPython (and therefore Jupyter) starting with IPython 8.24.0.
+
+There are three sources of backends: built-in (source code is within the
+Matplotlib repository), explicit ``module://some.backend`` syntax (backend is
+obtained by loading the module), or via an entry point (self-registering
+backend in an external package).
+
+To obtain a list of all registered backends use:
+
+    >>> from matplotlib.backends import backend_registry
+    >>> backend_registry.list_all()
diff --git a/galleries/users_explain/figure/backends.rst b/galleries/users_explain/figure/backends.rst
index 0aa20fc58862..dc6d8a89457d 100644
--- a/galleries/users_explain/figure/backends.rst
+++ b/galleries/users_explain/figure/backends.rst
@@ -175,7 +175,8 @@ QtAgg     Agg rendering in a Qt_ canvas (requires PyQt_ or `Qt for Python`_,
           more details.
 ipympl    Agg rendering embedded in a Jupyter widget (requires ipympl_).
           This backend can be enabled in a Jupyter notebook with
-          ``%matplotlib ipympl``.
+          ``%matplotlib ipympl`` or ``%matplotlib widget``.  Works with
+          Jupyter ``lab`` and ``notebook>=7``.
 GTK3Agg   Agg rendering to a GTK_ 3.x canvas (requires PyGObject_ and
           pycairo_).  This backend can be activated in IPython with
           ``%matplotlib gtk3``.
@@ -188,7 +189,8 @@ TkAgg     Agg rendering to a Tk_ canvas (requires TkInter_). This
           backend can be activated in IPython with ``%matplotlib tk``.
 nbAgg     Embed an interactive figure in a Jupyter classic notebook.  This
           backend can be enabled in Jupyter notebooks via
-          ``%matplotlib notebook``.
+          ``%matplotlib notebook`` or ``%matplotlib nbagg``.  Works with
+          Jupyter ``notebook<7`` and ``nbclassic``.
 WebAgg    On ``show()`` will start a tornado server with an interactive
           figure.
 GTK3Cairo Cairo rendering to a GTK_ 3.x canvas (requires PyGObject_ and
@@ -200,7 +202,7 @@ wxAgg     Agg rendering to a wxWidgets_ canvas (requires wxPython_ 4).
 ========= ================================================================
 
 .. note::
-   The names of builtin backends case-insensitive; e.g., 'QtAgg' and
+   The names of builtin backends are case-insensitive; e.g., 'QtAgg' and
    'qtagg' are equivalent.
 
 .. _`Anti-Grain Geometry`: http://agg.sourceforge.net/antigrain.com/
@@ -222,11 +224,13 @@ wxAgg     Agg rendering to a wxWidgets_ canvas (requires wxPython_ 4).
 .. _wxWidgets: https://www.wxwidgets.org/
 .. _ipympl: https://www.matplotlib.org/ipympl
 
+.. _ipympl_install:
+
 ipympl
 ^^^^^^
 
-The Jupyter widget ecosystem is moving too fast to support directly in
-Matplotlib.  To install ipympl:
+The ipympl backend is in a separate package that must be explicitly installed
+if you wish to use it, for example:
 
 .. code-block:: bash
 
diff --git a/galleries/users_explain/figure/figure_intro.rst b/galleries/users_explain/figure/figure_intro.rst
index 462a3fc848dc..80cbb3aeeb45 100644
--- a/galleries/users_explain/figure/figure_intro.rst
+++ b/galleries/users_explain/figure/figure_intro.rst
@@ -52,14 +52,20 @@ Notebooks and IDEs
 
 If you are using a Notebook (e.g. `Jupyter <https://jupyter.org>`_) or an IDE
 that renders Notebooks (PyCharm, VSCode, etc), then they have a backend that
-will render the Matplotlib Figure when a code cell is executed.  One thing to
-be aware of is that the default Jupyter backend (``%matplotlib inline``) will
+will render the Matplotlib Figure when a code cell is executed.  The default
+Jupyter backend (``%matplotlib inline``) creates static plots that
 by default trim or expand the figure size to have a tight box around Artists
-added to the Figure (see :ref:`saving_figures`, below).  If you use a backend
-other than the default "inline" backend, you will likely need to use an ipython
-"magic" like ``%matplotlib notebook`` for the Matplotlib :ref:`notebook
-<jupyter_notebooks_jupyterlab>` or ``%matplotlib widget`` for the  `ipympl
-<https://matplotlib.org/ipympl/>`_ backend.
+added to the Figure (see :ref:`saving_figures`, below).  For interactive plots
+in Jupyter you will need to use an ipython "magic" like ``%matplotlib widget``
+for the  `ipympl <https://matplotlib.org/ipympl/>`_ backend in ``jupyter lab``
+or ``notebook>=7``, or ``%matplotlib notebook`` for the Matplotlib
+:ref:`notebook <jupyter_notebooks_jupyterlab>` in ``notebook<7`` or
+``nbclassic``.
+
+.. note::
+
+    The  `ipympl <https://matplotlib.org/ipympl/>`_ backend is in a separate
+    package, see :ref:`Installing ipympl <ipympl_install>`.
 
 .. figure:: /_static/FigureNotebook.png
     :alt: Image of figure generated in Jupyter Notebook with notebook
@@ -75,15 +81,6 @@ other than the default "inline" backend, you will likely need to use an ipython
 .. seealso::
     :ref:`interactive_figures`.
 
-.. note::
-
-   If you only need to use the classic notebook (i.e. ``notebook<7``),
-   you can use:
-
-   .. sourcecode:: ipython
-
-   %matplotlib notebook
-
 .. _standalone-scripts-and-interactive-use:
 
 Standalone scripts and interactive use
@@ -104,7 +101,7 @@ backend.  These are typically chosen either in the user's :ref:`matplotlibrc
     QtAgg backend.
 
 When run from a script, or interactively (e.g. from an
-`iPython shell <https://ipython.readthedocs.io/en/stable/>`_) the Figure
+`IPython shell <https://ipython.readthedocs.io/en/stable/>`_) the Figure
 will not be shown until we call ``plt.show()``. The Figure will appear in
 a new GUI window, and usually will have a toolbar with Zoom, Pan, and other tools
 for interacting with the Figure.  By default, ``plt.show()`` blocks
diff --git a/galleries/users_explain/figure/writing_a_backend_pyplot_interface.rst b/galleries/users_explain/figure/writing_a_backend_pyplot_interface.rst
index 452f4d7610bb..c8dccc24da43 100644
--- a/galleries/users_explain/figure/writing_a_backend_pyplot_interface.rst
+++ b/galleries/users_explain/figure/writing_a_backend_pyplot_interface.rst
@@ -84,3 +84,47 @@ Function-based API
 2. **Showing figures**: `.pyplot.show()` calls a module-level ``show()``
    function, which is typically generated via the ``ShowBase`` class and its
    ``mainloop`` method.
+
+Registering a backend
+---------------------
+
+For a new backend to be usable via ``matplotlib.use()`` or IPython
+``%matplotlib`` magic command, it must be compatible with one of the three ways
+supported by the :class:`~matplotlib.backends.registry.BackendRegistry`:
+
+Built-in
+^^^^^^^^
+
+A backend built into Matplotlib must have its name and
+``FigureCanvas.required_interactive_framework`` hard-coded in the
+:class:`~matplotlib.backends.registry.BackendRegistry`.  If the backend module
+is not ``f"matplotlib.backends.backend_{backend_name.lower()}"`` then there
+must also be an entry in the ``BackendRegistry._name_to_module``.
+
+module:// syntax
+^^^^^^^^^^^^^^^^
+
+Any backend in a separate module (not built into Matplotlib) can be used by
+specifying the path to the module in the form ``module://some.backend.module``.
+An example is ``module://mplcairo.qt`` for
+`mplcairo <https:////github.com/matplotlib/mplcairo>`_.  The backend's
+interactive framework will be taken from its
+``FigureCanvas.required_interactive_framework``.
+
+Entry point
+^^^^^^^^^^^
+
+An external backend module can self-register as a backend using an
+``entry point`` in its ``pyproject.toml`` such as the one used by
+``matplotlib-inline``:
+
+.. code-block:: toml
+
+    [project.entry-points."matplotlib.backend"]
+    inline = "matplotlib_inline.backend_inline"
+
+The backend's interactive framework will be taken from its
+``FigureCanvas.required_interactive_framework``.  All entry points are loaded
+together but only when first needed, such as when a backend name is not
+recognised as a built-in backend, or when
+:meth:`~matplotlib.backends.registry.BackendRegistry.list_all` is first called.
diff --git a/lib/matplotlib/__init__.py b/lib/matplotlib/__init__.py
index cc94e530133b..9e9325a27d73 100644
--- a/lib/matplotlib/__init__.py
+++ b/lib/matplotlib/__init__.py
@@ -1208,7 +1208,7 @@ def use(backend, *, force=True):
         backend names, which are case-insensitive:
 
         - interactive backends:
-          GTK3Agg, GTK3Cairo, GTK4Agg, GTK4Cairo, MacOSX, nbAgg, QtAgg,
+          GTK3Agg, GTK3Cairo, GTK4Agg, GTK4Cairo, MacOSX, nbAgg, notebook, QtAgg,
           QtCairo, TkAgg, TkCairo, WebAgg, WX, WXAgg, WXCairo, Qt5Agg, Qt5Cairo
 
         - non-interactive backends:
@@ -1216,6 +1216,8 @@ def use(backend, *, force=True):
 
         or a string of the form: ``module://my.module.name``.
 
+        notebook is a synonym for nbAgg.
+
         Switching to an interactive backend is not possible if an unrelated
         event loop has already been started (e.g., switching to GTK3Agg if a
         TkAgg window has already been opened).  Switching to a non-interactive
diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
index e90c110c193b..d7430a4494fd 100644
--- a/lib/matplotlib/backend_bases.py
+++ b/lib/matplotlib/backend_bases.py
@@ -1766,8 +1766,16 @@ def _fix_ipython_backend2gui(cls):
         # `ipython --auto`).  This cannot be done at import time due to
         # ordering issues, so we do it when creating a canvas, and should only
         # be done once per class (hence the `cache`).
-        if sys.modules.get("IPython") is None:
+
+        # This function will not be needed when Python 3.12, the latest version
+        # supported by IPython < 8.24, reaches end-of-life in late 2028.
+        # At that time this function can be made a no-op and deprecated.
+        mod_ipython = sys.modules.get("IPython")
+        if mod_ipython is None or mod_ipython.version_info[:2] >= (8, 24):
+            # Use of backend2gui is not needed for IPython >= 8.24 as the
+            # functionality has been moved to Matplotlib.
             return
+
         import IPython
         ip = IPython.get_ipython()
         if not ip:
@@ -2030,9 +2038,8 @@ def _switch_canvas_and_return_print_method(self, fmt, backend=None):
         canvas = None
         if backend is not None:
             # Return a specific canvas class, if requested.
-            canvas_class = (
-                importlib.import_module(cbook._backend_module_name(backend))
-                .FigureCanvas)
+            from .backends.registry import backend_registry
+            canvas_class = backend_registry.load_backend_module(backend).FigureCanvas
             if not hasattr(canvas_class, f"print_{fmt}"):
                 raise ValueError(
                     f"The {backend!r} backend does not support {fmt} output")
diff --git a/lib/matplotlib/backends/registry.py b/lib/matplotlib/backends/registry.py
index 484d6ed5f26d..19b4cba254ab 100644
--- a/lib/matplotlib/backends/registry.py
+++ b/lib/matplotlib/backends/registry.py
@@ -1,4 +1,5 @@
 from enum import Enum
+import importlib
 
 
 class BackendFilter(Enum):
@@ -20,36 +21,168 @@ class BackendRegistry:
     All use of ``BackendRegistry`` should be via the singleton instance
     ``backend_registry`` which can be imported from ``matplotlib.backends``.
 
+    Each backend has a name, a module name containing the backend code, and an
+    optional GUI framework that must be running if the backend is interactive.
+    There are three sources of backends: built-in (source code is within the
+    Matplotlib repository), explicit ``module://some.backend`` syntax (backend is
+    obtained by loading the module), or via an entry point (self-registering
+    backend in an external package).
+
     .. versionadded:: 3.9
     """
-    # Built-in backends are those which are included in the Matplotlib repo.
-    # A backend with name 'name' is located in the module
-    # f'matplotlib.backends.backend_{name.lower()}'
-
-    # The capitalized forms are needed for ipython at present; this may
-    # change for later versions.
-    _BUILTIN_INTERACTIVE = [
-        "GTK3Agg", "GTK3Cairo", "GTK4Agg", "GTK4Cairo",
-        "MacOSX",
-        "nbAgg",
-        "QtAgg", "QtCairo", "Qt5Agg", "Qt5Cairo",
-        "TkAgg", "TkCairo",
-        "WebAgg",
-        "WX", "WXAgg", "WXCairo",
-    ]
-    _BUILTIN_NOT_INTERACTIVE = [
-        "agg", "cairo", "pdf", "pgf", "ps", "svg", "template",
-    ]
-    _GUI_FRAMEWORK_TO_BACKEND_MAPPING = {
-        "qt": "qtagg",
+    # Mapping of built-in backend name to GUI framework, or "headless" for no
+    # GUI framework. Built-in backends are those which are included in the
+    # Matplotlib repo. A backend with name 'name' is located in the module
+    # f"matplotlib.backends.backend_{name.lower()}"
+    _BUILTIN_BACKEND_TO_GUI_FRAMEWORK = {
+        "gtk3agg": "gtk3",
+        "gtk3cairo": "gtk3",
+        "gtk4agg": "gtk4",
+        "gtk4cairo": "gtk4",
+        "macosx": "macosx",
+        "nbagg": "nbagg",
+        "notebook": "nbagg",
+        "qtagg": "qt",
+        "qtcairo": "qt",
+        "qt5agg": "qt5",
+        "qt5cairo": "qt5",
+        "tkagg": "tk",
+        "tkcairo": "tk",
+        "webagg": "webagg",
+        "wx": "wx",
+        "wxagg": "wx",
+        "wxcairo": "wx",
+        "agg": "headless",
+        "cairo": "headless",
+        "pdf": "headless",
+        "pgf": "headless",
+        "ps": "headless",
+        "svg": "headless",
+        "template": "headless",
+    }
+
+    # Reverse mapping of gui framework to preferred built-in backend.
+    _GUI_FRAMEWORK_TO_BACKEND = {
         "gtk3": "gtk3agg",
         "gtk4": "gtk4agg",
-        "wx": "wxagg",
-        "tk": "tkagg",
-        "macosx": "macosx",
         "headless": "agg",
+        "macosx": "macosx",
+        "qt": "qtagg",
+        "qt5": "qt5agg",
+        "qt6": "qtagg",
+        "tk": "tkagg",
+        "wx": "wxagg",
     }
 
+    def __init__(self):
+        # Only load entry points when first needed.
+        self._loaded_entry_points = False
+
+        # Mapping of non-built-in backend to GUI framework, added dynamically from
+        # entry points and from matplotlib.use("module://some.backend") format.
+        # New entries have an "unknown" GUI framework that is determined when first
+        # needed by calling _get_gui_framework_by_loading.
+        self._backend_to_gui_framework = {}
+
+        # Mapping of backend name to module name, where different from
+        # f"matplotlib.backends.backend_{backend_name.lower()}". These are either
+        # hardcoded for backward compatibility, or loaded from entry points or
+        # "module://some.backend" syntax.
+        self._name_to_module = {
+            "notebook": "nbagg",
+        }
+
+    def _backend_module_name(self, backend):
+        # Return name of module containing the specified backend.
+        # Does not check if the backend is valid, use is_valid_backend for that.
+        backend = backend.lower()
+
+        # Check if have specific name to module mapping.
+        backend = self._name_to_module.get(backend, backend)
+
+        return (backend[9:] if backend.startswith("module://")
+                else f"matplotlib.backends.backend_{backend}")
+
+    def _clear(self):
+        # Clear all dynamically-added data, used for testing only.
+        self.__init__()
+
+    def _ensure_entry_points_loaded(self):
+        # Load entry points, if they have not already been loaded.
+        if not self._loaded_entry_points:
+            entries = self._read_entry_points()
+            self._validate_and_store_entry_points(entries)
+            self._loaded_entry_points = True
+
+    def _get_gui_framework_by_loading(self, backend):
+        # Determine GUI framework for a backend by loading its module and reading the
+        # FigureCanvas.required_interactive_framework attribute.
+        # Returns "headless" if there is no GUI framework.
+        module = self.load_backend_module(backend)
+        canvas_class = module.FigureCanvas
+        return canvas_class.required_interactive_framework or "headless"
+
+    def _read_entry_points(self):
+        # Read entry points of modules that self-advertise as Matplotlib backends.
+        # Expects entry points like this one from matplotlib-inline (in pyproject.toml
+        # format):
+        #   [project.entry-points."matplotlib.backend"]
+        #   inline = "matplotlib_inline.backend_inline"
+        import importlib.metadata as im
+        import sys
+
+        # entry_points group keyword not available before Python 3.10
+        group = "matplotlib.backend"
+        if sys.version_info >= (3, 10):
+            entry_points = im.entry_points(group=group)
+        else:
+            entry_points = im.entry_points().get(group, ())
+        entries = [(entry.name, entry.value) for entry in entry_points]
+
+        # For backward compatibility, if matplotlib-inline and/or ipympl are installed
+        # but too old to include entry points, create them. Do not import ipympl
+        # directly as this calls matplotlib.use() whilst in this function.
+        def backward_compatible_entry_points(
+                entries, module_name, threshold_version, names, target):
+            from matplotlib import _parse_to_version_info
+            try:
+                module_version = im.version(module_name)
+                if _parse_to_version_info(module_version) < threshold_version:
+                    for name in names:
+                        entries.append((name, target))
+            except im.PackageNotFoundError:
+                pass
+
+        names = [entry[0] for entry in entries]
+        if "inline" not in names:
+            backward_compatible_entry_points(
+                entries, "matplotlib_inline", (0, 1, 7), ["inline"],
+                "matplotlib_inline.backend_inline")
+        if "ipympl" not in names:
+            backward_compatible_entry_points(
+                entries, "ipympl", (0, 9, 4), ["ipympl", "widget"],
+                "ipympl.backend_nbagg")
+
+        return entries
+
+    def _validate_and_store_entry_points(self, entries):
+        # Validate and store entry points so that they can be used via matplotlib.use()
+        # in the normal manner. Entry point names cannot be of module:// format, cannot
+        # shadow a built-in backend name, and cannot be duplicated.
+        for name, module in entries:
+            name = name.lower()
+            if name.startswith("module://"):
+                raise RuntimeError(
+                    f"Entry point name '{name}' cannot start with 'module://'")
+            if name in self._BUILTIN_BACKEND_TO_GUI_FRAMEWORK:
+                raise RuntimeError(f"Entry point name '{name}' is a built-in backend")
+            if name in self._backend_to_gui_framework:
+                raise RuntimeError(f"Entry point name '{name}' duplicated")
+
+            self._name_to_module[name] = "module://" + module
+            # Do not yet know backend GUI framework, determine it only when necessary.
+            self._backend_to_gui_framework[name] = "unknown"
+
     def backend_for_gui_framework(self, framework):
         """
         Return the name of the backend corresponding to the specified GUI framework.
@@ -61,10 +194,74 @@ def backend_for_gui_framework(self, framework):
 
         Returns
         -------
-        str
-            Backend name.
+        str or None
+            Backend name or None if GUI framework not recognised.
+        """
+        return self._GUI_FRAMEWORK_TO_BACKEND.get(framework.lower())
+
+    def is_valid_backend(self, backend):
+        """
+        Return True if the backend name is valid, False otherwise.
+
+        A backend name is valid if it is one of the built-in backends or has been
+        dynamically added via an entry point. Those beginning with ``module://`` are
+        always considered valid and are added to the current list of all backends
+        within this function.
+
+        Even if a name is valid, it may not be importable or usable. This can only be
+        determined by loading and using the backend module.
+
+        Parameters
+        ----------
+        backend : str
+            Name of backend.
+
+        Returns
+        -------
+        bool
+            True if backend is valid, False otherwise.
+        """
+        backend = backend.lower()
+
+        # For backward compatibility, convert ipympl and matplotlib-inline long
+        # module:// names to their shortened forms.
+        backwards_compat = {
+            "module://ipympl.backend_nbagg": "widget",
+            "module://matplotlib_inline.backend_inline": "inline",
+        }
+        backend = backwards_compat.get(backend, backend)
+
+        if (backend in self._BUILTIN_BACKEND_TO_GUI_FRAMEWORK or
+                backend in self._backend_to_gui_framework):
+            return True
+
+        if backend.startswith("module://"):
+            self._backend_to_gui_framework[backend] = "unknown"
+            return True
+
+        # Only load entry points if really need to and not already done so.
+        self._ensure_entry_points_loaded()
+        if backend in self._backend_to_gui_framework:
+            return True
+
+        return False
+
+    def list_all(self):
+        """
+        Return list of all known backends.
+
+        These include built-in backends and those obtained at runtime either from entry
+        points or explicit ``module://some.backend`` syntax.
+
+        Entry points will be loaded if they haven't been already.
+
+        Returns
+        -------
+        list of str
+            Backend names.
         """
-        return self._GUI_FRAMEWORK_TO_BACKEND_MAPPING.get(framework)
+        self._ensure_entry_points_loaded()
+        return [*self.list_builtin(), *self._backend_to_gui_framework]
 
     def list_builtin(self, filter_=None):
         """
@@ -82,11 +279,132 @@ def list_builtin(self, filter_=None):
             Backend names.
         """
         if filter_ == BackendFilter.INTERACTIVE:
-            return self._BUILTIN_INTERACTIVE
+            return [k for k, v in self._BUILTIN_BACKEND_TO_GUI_FRAMEWORK.items()
+                    if v != "headless"]
         elif filter_ == BackendFilter.NON_INTERACTIVE:
-            return self._BUILTIN_NOT_INTERACTIVE
+            return [k for k, v in self._BUILTIN_BACKEND_TO_GUI_FRAMEWORK.items()
+                    if v == "headless"]
+
+        return [*self._BUILTIN_BACKEND_TO_GUI_FRAMEWORK]
+
+    def list_gui_frameworks(self):
+        """
+        Return list of GUI frameworks used by Matplotlib backends.
+
+        Returns
+        -------
+        list of str
+            GUI framework names.
+        """
+        return [k for k in self._GUI_FRAMEWORK_TO_BACKEND if k != "headless"]
+
+    def load_backend_module(self, backend):
+        """
+        Load and return the module containing the specified backend.
+
+        Parameters
+        ----------
+        backend : str
+            Name of backend to load.
+
+        Returns
+        -------
+        Module
+            Module containing backend.
+        """
+        module_name = self._backend_module_name(backend)
+        return importlib.import_module(module_name)
+
+    def resolve_backend(self, backend):
+        """
+        Return the backend and GUI framework for the specified backend name.
+
+        If the GUI framework is not yet known then it will be determined by loading the
+        backend module and checking the ``FigureCanvas.required_interactive_framework``
+        attribute.
+
+        This function only loads entry points if they have not already been loaded and
+        the backend is not built-in and not of ``module://some.backend`` format.
+
+        Parameters
+        ----------
+        backend : str or None
+            Name of backend, or None to use the default backend.
+
+        Returns
+        -------
+        backend : str
+            The backend name.
+        framework : str or None
+            The GUI framework, which will be None for a backend that is non-interactive.
+        """
+        if isinstance(backend, str):
+            backend = backend.lower()
+        else:  # Might be _auto_backend_sentinel or None
+            # Use whatever is already running...
+            from matplotlib import get_backend
+            backend = get_backend()
+
+        # Is backend already known (built-in or dynamically loaded)?
+        gui = (self._BUILTIN_BACKEND_TO_GUI_FRAMEWORK.get(backend) or
+               self._backend_to_gui_framework.get(backend))
+
+        # Is backend "module://something"?
+        if gui is None and isinstance(backend, str) and backend.startswith("module://"):
+            gui = "unknown"
+
+        # Is backend a possible entry point?
+        if gui is None and not self._loaded_entry_points:
+            self._ensure_entry_points_loaded()
+            gui = self._backend_to_gui_framework.get(backend)
+
+        # Backend known but not its gui framework.
+        if gui == "unknown":
+            gui = self._get_gui_framework_by_loading(backend)
+            self._backend_to_gui_framework[backend] = gui
+
+        if gui is None:
+            raise RuntimeError(f"'{backend}' is not a recognised backend name")
+
+        return backend, gui if gui != "headless" else None
+
+    def resolve_gui_or_backend(self, gui_or_backend):
+        """
+        Return the backend and GUI framework for the specified string that may be
+        either a GUI framework or a backend name, tested in that order.
+
+        This is for use with the IPython %matplotlib magic command which may be a GUI
+        framework such as ``%matplotlib qt`` or a backend name such as
+        ``%matplotlib qtagg``.
+
+        This function only loads entry points if they have not already been loaded and
+        the backend is not built-in and not of ``module://some.backend`` format.
+
+        Parameters
+        ----------
+        gui_or_backend : str or None
+            Name of GUI framework or backend, or None to use the default backend.
+
+        Returns
+        -------
+        backend : str
+            The backend name.
+        framework : str or None
+            The GUI framework, which will be None for a backend that is non-interactive.
+        """
+        gui_or_backend = gui_or_backend.lower()
+
+        # First check if it is a gui loop name.
+        backend = self.backend_for_gui_framework(gui_or_backend)
+        if backend is not None:
+            return backend, gui_or_backend if gui_or_backend != "headless" else None
 
-        return self._BUILTIN_INTERACTIVE + self._BUILTIN_NOT_INTERACTIVE
+        # Then check if it is a backend name.
+        try:
+            return self.resolve_backend(gui_or_backend)
+        except Exception:  # KeyError ?
+            raise RuntimeError(
+                f"'{gui_or_backend} is not a recognised GUI loop or backend name")
 
 
 # Singleton
diff --git a/lib/matplotlib/backends/registry.pyi b/lib/matplotlib/backends/registry.pyi
index e48531be471d..e1ae5b3e7d3a 100644
--- a/lib/matplotlib/backends/registry.pyi
+++ b/lib/matplotlib/backends/registry.pyi
@@ -1,4 +1,5 @@
 from enum import Enum
+from types import ModuleType
 
 
 class BackendFilter(Enum):
@@ -7,8 +8,28 @@ class BackendFilter(Enum):
 
 
 class BackendRegistry:
-    def backend_for_gui_framework(self, interactive_framework: str) -> str | None: ...
+    _BUILTIN_BACKEND_TO_GUI_FRAMEWORK: dict[str, str]
+    _GUI_FRAMEWORK_TO_BACKEND: dict[str, str]
+
+    _loaded_entry_points: bool
+    _backend_to_gui_framework: dict[str, str]
+    _name_to_module: dict[str, str]
+
+    def _backend_module_name(self, backend: str) -> str: ...
+    def _clear(self) -> None: ...
+    def _ensure_entry_points_loaded(self) -> None: ...
+    def _get_gui_framework_by_loading(self, backend: str) -> str: ...
+    def _read_entry_points(self) -> list[tuple[str, str]]: ...
+    def _validate_and_store_entry_points(self, entries: list[tuple[str, str]]) -> None: ...
+
+    def backend_for_gui_framework(self, framework: str) -> str | None: ...
+    def is_valid_backend(self, backend: str) -> bool: ...
+    def list_all(self) -> list[str]: ...
     def list_builtin(self, filter_: BackendFilter | None) -> list[str]: ...
+    def list_gui_frameworks(self) -> list[str]: ...
+    def load_backend_module(self, backend: str) -> ModuleType: ...
+    def resolve_backend(self, backend: str | None) -> tuple[str, str | None]: ...
+    def resolve_gui_or_backend(self, gui_or_backend: str | None) -> tuple[str, str | None]: ...
 
 
 backend_registry: BackendRegistry
diff --git a/lib/matplotlib/cbook.py b/lib/matplotlib/cbook.py
index a41bfe56744f..a156ac200abf 100644
--- a/lib/matplotlib/cbook.py
+++ b/lib/matplotlib/cbook.py
@@ -2224,15 +2224,6 @@ def _check_and_log_subprocess(command, logger, **kwargs):
     return proc.stdout
 
 
-def _backend_module_name(name):
-    """
-    Convert a backend name (either a standard backend -- "Agg", "TkAgg", ... --
-    or a custom backend -- "module://...") to the corresponding module name).
-    """
-    return (name[9:] if name.startswith("module://")
-            else f"matplotlib.backends.backend_{name.lower()}")
-
-
 def _setup_new_guiapp():
     """
     Perform OS-dependent setup when Matplotlib creates a new GUI application.
diff --git a/lib/matplotlib/cbook.pyi b/lib/matplotlib/cbook.pyi
index 3216c4c92b9e..d727b8065b7a 100644
--- a/lib/matplotlib/cbook.pyi
+++ b/lib/matplotlib/cbook.pyi
@@ -176,7 +176,6 @@ class _OrderedSet(collections.abc.MutableSet):
     def add(self, key) -> None: ...
     def discard(self, key) -> None: ...
 
-def _backend_module_name(name: str) -> str: ...
 def _setup_new_guiapp() -> None: ...
 def _format_approx(number: float, precision: int) -> str: ...
 def _g_sig_digits(value: float, delta: float) -> int: ...
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 2376c6243929..b1354341617d 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -295,11 +295,16 @@ def install_repl_displayhook() -> None:
     ip.events.register("post_execute", _draw_all_if_interactive)
     _REPL_DISPLAYHOOK = _ReplDisplayHook.IPYTHON
 
-    from IPython.core.pylabtools import backend2gui
-    # trigger IPython's eventloop integration, if available
-    ipython_gui_name = backend2gui.get(get_backend())
-    if ipython_gui_name:
-        ip.enable_gui(ipython_gui_name)
+    if mod_ipython.version_info[:2] < (8, 24):
+        # Use of backend2gui is not needed for IPython >= 8.24 as that functionality
+        # has been moved to Matplotlib.
+        # This code can be removed when Python 3.12, the latest version supported by
+        # IPython < 8.24, reaches end-of-life in late 2028.
+        from IPython.core.pylabtools import backend2gui
+        # trigger IPython's eventloop integration, if available
+        ipython_gui_name = backend2gui.get(get_backend())
+        if ipython_gui_name:
+            ip.enable_gui(ipython_gui_name)
 
 
 def uninstall_repl_displayhook() -> None:
@@ -402,7 +407,7 @@ def switch_backend(newbackend: str) -> None:
     # have to escape the switch on access logic
     old_backend = dict.__getitem__(rcParams, 'backend')
 
-    module = importlib.import_module(cbook._backend_module_name(newbackend))
+    module = backend_registry.load_backend_module(newbackend)
     canvas_class = module.FigureCanvas
 
     required_framework = canvas_class.required_interactive_framework
@@ -477,6 +482,18 @@ def draw_if_interactive() -> None:
     _log.debug("Loaded backend %s version %s.",
                newbackend, backend_mod.backend_version)
 
+    if newbackend in ("ipympl", "widget"):
+        # ipympl < 0.9.4 expects rcParams["backend"] to be the fully-qualified backend
+        # name "module://ipympl.backend_nbagg" not short names "ipympl" or "widget".
+        import importlib.metadata as im
+        from matplotlib import _parse_to_version_info  # type: ignore[attr-defined]
+        try:
+            module_version = im.version("ipympl")
+            if _parse_to_version_info(module_version) < (0, 9, 4):
+                newbackend = "module://ipympl.backend_nbagg"
+        except im.PackageNotFoundError:
+            pass
+
     rcParams['backend'] = rcParamsDefault['backend'] = newbackend
     _backend_mod = backend_mod
     for func_name in ["new_figure_manager", "draw_if_interactive", "show"]:
@@ -2586,7 +2603,7 @@ def polar(*args, **kwargs) -> list[Line2D]:
 if (rcParams["backend_fallback"]
         and rcParams._get_backend_or_none() in (  # type: ignore[attr-defined]
             set(backend_registry.list_builtin(BackendFilter.INTERACTIVE)) -
-            {'WebAgg', 'nbAgg'})
+            {'webagg', 'nbagg'})
         and cbook._get_running_interactive_framework()):
     rcParams._set("backend", rcsetup._auto_backend_sentinel)
 
diff --git a/lib/matplotlib/rcsetup.py b/lib/matplotlib/rcsetup.py
index a326d22f039a..b0cd22098489 100644
--- a/lib/matplotlib/rcsetup.py
+++ b/lib/matplotlib/rcsetup.py
@@ -266,16 +266,16 @@ def validate_fonttype(s):
         return fonttype
 
 
-_validate_standard_backends = ValidateInStrings(
-    'backend', backend_registry.list_builtin(), ignorecase=True)
 _auto_backend_sentinel = object()
 
 
 def validate_backend(s):
-    backend = (
-        s if s is _auto_backend_sentinel or s.startswith("module://")
-        else _validate_standard_backends(s))
-    return backend
+    if s is _auto_backend_sentinel or backend_registry.is_valid_backend(s):
+        return s
+    else:
+        msg = (f"'{s}' is not a valid value for backend; supported values are "
+               f"{backend_registry.list_all()}")
+        raise ValueError(msg)
 
 
 def _validate_toolbar(s):
diff --git a/lib/matplotlib/testing/__init__.py b/lib/matplotlib/testing/__init__.py
index 685b98cd99ec..779149dec2dc 100644
--- a/lib/matplotlib/testing/__init__.py
+++ b/lib/matplotlib/testing/__init__.py
@@ -177,3 +177,41 @@ def _has_tex_package(package):
         return True
     except FileNotFoundError:
         return False
+
+
+def ipython_in_subprocess(
+    requested_backend_or_gui_framework,
+    expected_backend_old_ipython,  # IPython < 8.24
+    expected_backend_new_ipython,  # IPython >= 8.24
+):
+    import pytest
+    IPython = pytest.importorskip("IPython")
+
+    if sys.platform == "win32":
+        pytest.skip("Cannot change backend running IPython in subprocess on Windows")
+
+    if (IPython.version_info[:3] == (8, 24, 0) and
+            requested_backend_or_gui_framework == "osx"):
+        pytest.skip("Bug using macosx backend in IPython 8.24.0 fixed in 8.24.1")
+
+    if IPython.version_info[:2] >= (8, 24):
+        expected_backend = expected_backend_new_ipython
+    else:
+        # This code can be removed when Python 3.12, the latest version supported by
+        # IPython < 8.24, reaches end-of-life in late 2028.
+        expected_backend = expected_backend_old_ipython
+
+    code = ("import matplotlib as mpl, matplotlib.pyplot as plt;"
+            "fig, ax=plt.subplots(); ax.plot([1, 3, 2]); mpl.get_backend()")
+    proc = subprocess_run_for_testing(
+        [
+            "ipython",
+            "--no-simple-prompt",
+            f"--matplotlib={requested_backend_or_gui_framework}",
+            "-c", code,
+        ],
+        check=True,
+        capture_output=True,
+    )
+
+    assert proc.stdout.strip() == f"Out[1]: '{expected_backend}'"
diff --git a/lib/matplotlib/testing/__init__.pyi b/lib/matplotlib/testing/__init__.pyi
index 30cfd9a9ed2e..b0399476b6aa 100644
--- a/lib/matplotlib/testing/__init__.pyi
+++ b/lib/matplotlib/testing/__init__.pyi
@@ -47,3 +47,8 @@ def subprocess_run_helper(
 ) -> subprocess.CompletedProcess[str]: ...
 def _check_for_pgf(texsystem: str) -> bool: ...
 def _has_tex_package(package: str) -> bool: ...
+def ipython_in_subprocess(
+    requested_backend_or_gui_framework: str,
+    expected_backend_old_ipython: str,
+    expected_backend_new_ipython: str,
+) -> None: ...
diff --git a/lib/matplotlib/tests/test_backend_inline.py b/lib/matplotlib/tests/test_backend_inline.py
new file mode 100644
index 000000000000..6f0d67d51756
--- /dev/null
+++ b/lib/matplotlib/tests/test_backend_inline.py
@@ -0,0 +1,46 @@
+import os
+from pathlib import Path
+from tempfile import TemporaryDirectory
+
+import pytest
+
+from matplotlib.testing import subprocess_run_for_testing
+
+nbformat = pytest.importorskip('nbformat')
+pytest.importorskip('nbconvert')
+pytest.importorskip('ipykernel')
+pytest.importorskip('matplotlib_inline')
+
+
+def test_ipynb():
+    nb_path = Path(__file__).parent / 'test_inline_01.ipynb'
+
+    with TemporaryDirectory() as tmpdir:
+        out_path = Path(tmpdir, "out.ipynb")
+
+        subprocess_run_for_testing(
+            ["jupyter", "nbconvert", "--to", "notebook",
+             "--execute", "--ExecutePreprocessor.timeout=500",
+             "--output", str(out_path), str(nb_path)],
+            env={**os.environ, "IPYTHONDIR": tmpdir},
+            check=True)
+        with out_path.open() as out:
+            nb = nbformat.read(out, nbformat.current_nbformat)
+
+    errors = [output for cell in nb.cells for output in cell.get("outputs", [])
+              if output.output_type == "error"]
+    assert not errors
+
+    import IPython
+    if IPython.version_info[:2] >= (8, 24):
+        expected_backend = "inline"
+    else:
+        # This code can be removed when Python 3.12, the latest version supported by
+        # IPython < 8.24, reaches end-of-life in late 2028.
+        expected_backend = "module://matplotlib_inline.backend_inline"
+    backend_outputs = nb.cells[2]["outputs"]
+    assert backend_outputs[0]["data"]["text/plain"] == f"'{expected_backend}'"
+
+    image = nb.cells[1]["outputs"][1]["data"]
+    assert image["text/plain"] == "<Figure size 300x200 with 1 Axes>"
+    assert "image/png" in image
diff --git a/lib/matplotlib/tests/test_backend_macosx.py b/lib/matplotlib/tests/test_backend_macosx.py
index c460da374c8c..a4350fe3b6c6 100644
--- a/lib/matplotlib/tests/test_backend_macosx.py
+++ b/lib/matplotlib/tests/test_backend_macosx.py
@@ -44,3 +44,8 @@ def new_choose_save_file(title, directory, filename):
         # Check the savefig.directory rcParam got updated because
         # we added a subdirectory "test"
         assert mpl.rcParams["savefig.directory"] == f"{tmp_path}/test"
+
+
+def test_ipython():
+    from matplotlib.testing import ipython_in_subprocess
+    ipython_in_subprocess("osx", "MacOSX", "macosx")
diff --git a/lib/matplotlib/tests/test_backend_nbagg.py b/lib/matplotlib/tests/test_backend_nbagg.py
index 40bee8f85c43..23af88d95086 100644
--- a/lib/matplotlib/tests/test_backend_nbagg.py
+++ b/lib/matplotlib/tests/test_backend_nbagg.py
@@ -30,3 +30,13 @@ def test_ipynb():
     errors = [output for cell in nb.cells for output in cell.get("outputs", [])
               if output.output_type == "error"]
     assert not errors
+
+    import IPython
+    if IPython.version_info[:2] >= (8, 24):
+        expected_backend = "notebook"
+    else:
+        # This code can be removed when Python 3.12, the latest version supported by
+        # IPython < 8.24, reaches end-of-life in late 2028.
+        expected_backend = "nbAgg"
+    backend_outputs = nb.cells[2]["outputs"]
+    assert backend_outputs[0]["data"]["text/plain"] == f"'{expected_backend}'"
diff --git a/lib/matplotlib/tests/test_backend_qt.py b/lib/matplotlib/tests/test_backend_qt.py
index f4a7ef6755f2..026a49b1441e 100644
--- a/lib/matplotlib/tests/test_backend_qt.py
+++ b/lib/matplotlib/tests/test_backend_qt.py
@@ -14,7 +14,6 @@
 from matplotlib._pylab_helpers import Gcf
 from matplotlib import _c_internal_utils
 
-
 try:
     from matplotlib.backends.qt_compat import QtGui, QtWidgets  # type: ignore # noqa
     from matplotlib.backends.qt_editor import _formlayout
@@ -375,3 +374,8 @@ def custom_handler(signum, frame):
     finally:
         # Reset SIGINT handler to what it was before the test
         signal.signal(signal.SIGINT, original_handler)
+
+
+def test_ipython():
+    from matplotlib.testing import ipython_in_subprocess
+    ipython_in_subprocess("qt", "QtAgg", "qtagg")
diff --git a/lib/matplotlib/tests/test_backend_registry.py b/lib/matplotlib/tests/test_backend_registry.py
index aed258f36413..eaf8417e7a5f 100644
--- a/lib/matplotlib/tests/test_backend_registry.py
+++ b/lib/matplotlib/tests/test_backend_registry.py
@@ -7,6 +7,15 @@
 from matplotlib.backends import BackendFilter, backend_registry
 
 
+@pytest.fixture
+def clear_backend_registry():
+    # Fixture that clears the singleton backend_registry before and after use
+    # so that the test state remains isolated.
+    backend_registry._clear()
+    yield
+    backend_registry._clear()
+
+
 def has_duplicates(seq: Sequence[Any]) -> bool:
     return len(seq) > len(set(seq))
 
@@ -33,9 +42,10 @@ def test_list_builtin():
     assert not has_duplicates(backends)
     # Compare using sets as order is not important
     assert {*backends} == {
-        'GTK3Agg', 'GTK3Cairo', 'GTK4Agg', 'GTK4Cairo', 'MacOSX', 'nbAgg', 'QtAgg',
-        'QtCairo', 'Qt5Agg', 'Qt5Cairo', 'TkAgg', 'TkCairo', 'WebAgg', 'WX', 'WXAgg',
-        'WXCairo', 'agg', 'cairo', 'pdf', 'pgf', 'ps', 'svg', 'template',
+        'gtk3agg', 'gtk3cairo', 'gtk4agg', 'gtk4cairo', 'macosx', 'nbagg', 'notebook',
+        'qtagg', 'qtcairo', 'qt5agg', 'qt5cairo', 'tkagg',
+        'tkcairo', 'webagg', 'wx', 'wxagg', 'wxcairo', 'agg', 'cairo', 'pdf', 'pgf',
+        'ps', 'svg', 'template',
     }
 
 
@@ -43,9 +53,9 @@ def test_list_builtin():
     'filter,expected',
     [
         (BackendFilter.INTERACTIVE,
-         ['GTK3Agg', 'GTK3Cairo', 'GTK4Agg', 'GTK4Cairo', 'MacOSX', 'nbAgg', 'QtAgg',
-          'QtCairo', 'Qt5Agg', 'Qt5Cairo', 'TkAgg', 'TkCairo', 'WebAgg', 'WX', 'WXAgg',
-           'WXCairo']),
+         ['gtk3agg', 'gtk3cairo', 'gtk4agg', 'gtk4cairo', 'macosx', 'nbagg', 'notebook',
+          'qtagg', 'qtcairo', 'qt5agg', 'qt5cairo', 'tkagg',
+          'tkcairo', 'webagg', 'wx', 'wxagg', 'wxcairo']),
         (BackendFilter.NON_INTERACTIVE,
          ['agg', 'cairo', 'pdf', 'pgf', 'ps', 'svg', 'template']),
     ]
@@ -57,6 +67,25 @@ def test_list_builtin_with_filter(filter, expected):
     assert {*backends} == {*expected}
 
 
+def test_list_gui_frameworks():
+    frameworks = backend_registry.list_gui_frameworks()
+    assert not has_duplicates(frameworks)
+    # Compare using sets as order is not important
+    assert {*frameworks} == {
+        "gtk3", "gtk4", "macosx", "qt", "qt5", "qt6", "tk", "wx",
+    }
+
+
+@pytest.mark.parametrize("backend, is_valid", [
+    ("agg", True),
+    ("QtAgg", True),
+    ("module://anything", True),
+    ("made-up-name", False),
+])
+def test_is_valid_backend(backend, is_valid):
+    assert backend_registry.is_valid_backend(backend) == is_valid
+
+
 def test_deprecated_rcsetup_attributes():
     match = "was deprecated in Matplotlib 3.9"
     with pytest.warns(mpl.MatplotlibDeprecationWarning, match=match):
@@ -65,3 +94,67 @@ def test_deprecated_rcsetup_attributes():
         mpl.rcsetup.non_interactive_bk
     with pytest.warns(mpl.MatplotlibDeprecationWarning, match=match):
         mpl.rcsetup.all_backends
+
+
+def test_entry_points_inline():
+    pytest.importorskip('matplotlib_inline')
+    backends = backend_registry.list_all()
+    assert 'inline' in backends
+
+
+def test_entry_points_ipympl():
+    pytest.importorskip('ipympl')
+    backends = backend_registry.list_all()
+    assert 'ipympl' in backends
+    assert 'widget' in backends
+
+
+def test_entry_point_name_shadows_builtin(clear_backend_registry):
+    with pytest.raises(RuntimeError):
+        backend_registry._validate_and_store_entry_points(
+            [('qtagg', 'module1')])
+
+
+def test_entry_point_name_duplicate(clear_backend_registry):
+    with pytest.raises(RuntimeError):
+        backend_registry._validate_and_store_entry_points(
+            [('some_name', 'module1'), ('some_name', 'module2')])
+
+
+def test_entry_point_name_is_module(clear_backend_registry):
+    with pytest.raises(RuntimeError):
+        backend_registry._validate_and_store_entry_points(
+            [('module://backend.something', 'module1')])
+
+
+@pytest.mark.parametrize('backend', [
+    'agg',
+    'module://matplotlib.backends.backend_agg',
+])
+def test_load_entry_points_only_if_needed(clear_backend_registry, backend):
+    assert not backend_registry._loaded_entry_points
+    check = backend_registry.resolve_backend(backend)
+    assert check == (backend, None)
+    assert not backend_registry._loaded_entry_points
+    backend_registry.list_all()  # Force load of entry points
+    assert backend_registry._loaded_entry_points
+
+
+@pytest.mark.parametrize(
+    'gui_or_backend, expected_backend, expected_gui',
+    [
+        ('agg', 'agg', None),
+        ('qt', 'qtagg', 'qt'),
+        ('TkCairo', 'tkcairo', 'tk'),
+    ]
+)
+def test_resolve_gui_or_backend(gui_or_backend, expected_backend, expected_gui):
+    backend, gui = backend_registry.resolve_gui_or_backend(gui_or_backend)
+    assert backend == expected_backend
+    assert gui == expected_gui
+
+
+def test_resolve_gui_or_backend_invalid():
+    match = "is not a recognised GUI loop or backend name"
+    with pytest.raises(RuntimeError, match=match):
+        backend_registry.resolve_gui_or_backend('no-such-name')
diff --git a/lib/matplotlib/tests/test_backends_interactive.py b/lib/matplotlib/tests/test_backends_interactive.py
index e021405c56b7..6830e7d5c845 100644
--- a/lib/matplotlib/tests/test_backends_interactive.py
+++ b/lib/matplotlib/tests/test_backends_interactive.py
@@ -291,7 +291,7 @@ def _test_thread_impl():
     plt.pause(0.5)  # flush_events fails here on at least Tkagg (bpo-41176)
     future.result()  # Joins the thread; rethrows any exception.
     plt.close()  # backend is responsible for flushing any events here
-    if plt.rcParams["backend"].startswith("WX"):
+    if plt.rcParams["backend"].lower().startswith("wx"):
         # TODO: debug why WX needs this only on py >= 3.8
         fig.canvas.flush_events()
 
diff --git a/lib/matplotlib/tests/test_inline_01.ipynb b/lib/matplotlib/tests/test_inline_01.ipynb
new file mode 100644
index 000000000000..b87ae095bdbe
--- /dev/null
+++ b/lib/matplotlib/tests/test_inline_01.ipynb
@@ -0,0 +1,79 @@
+{
+ "cells": [
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "%matplotlib inline\n",
+    "import matplotlib.pyplot as plt"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {
+    "jupyter": {
+     "outputs_hidden": false
+    }
+   },
+   "outputs": [],
+   "source": [
+    "fig, ax = plt.subplots(figsize=(3, 2))\n",
+    "ax.plot([1, 3, 2])"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import matplotlib\n",
+    "matplotlib.get_backend()"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.12.2"
+  },
+  "toc": {
+   "colors": {
+    "hover_highlight": "#DAA520",
+    "running_highlight": "#FF0000",
+    "selected_highlight": "#FFD700"
+   },
+   "moveMenuLeft": true,
+   "nav_menu": {
+    "height": "12px",
+    "width": "252px"
+   },
+   "navigate_menu": true,
+   "number_sections": true,
+   "sideBar": true,
+   "threshold": 4,
+   "toc_cell": false,
+   "toc_section_display": "block",
+   "toc_window_display": false,
+   "widenNotebook": false
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}
diff --git a/lib/matplotlib/tests/test_matplotlib.py b/lib/matplotlib/tests/test_matplotlib.py
index a2f467ac48de..37b41fafdb78 100644
--- a/lib/matplotlib/tests/test_matplotlib.py
+++ b/lib/matplotlib/tests/test_matplotlib.py
@@ -54,7 +54,7 @@ def parse(key):
         for line in matplotlib.use.__doc__.split(key)[1].split('\n'):
             if not line.strip():
                 break
-            backends += [e.strip() for e in line.split(',') if e]
+            backends += [e.strip().lower() for e in line.split(',') if e]
         return backends
 
     from matplotlib.backends import BackendFilter, backend_registry
diff --git a/lib/matplotlib/tests/test_nbagg_01.ipynb b/lib/matplotlib/tests/test_nbagg_01.ipynb
index 8505e057fdc3..bd18aa4192b7 100644
--- a/lib/matplotlib/tests/test_nbagg_01.ipynb
+++ b/lib/matplotlib/tests/test_nbagg_01.ipynb
@@ -8,9 +8,8 @@
    },
    "outputs": [],
    "source": [
-    "import numpy as np\n",
-    "import matplotlib.pyplot as plt\n",
-    "%matplotlib notebook\n"
+    "%matplotlib notebook\n",
+    "import matplotlib.pyplot as plt"
    ]
   },
   {
@@ -826,17 +825,31 @@
    ],
    "source": [
     "fig, ax = plt.subplots()\n",
-    "ax.plot(range(10))\n"
+    "ax.plot(range(10))"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": null,
+   "execution_count": 3,
    "metadata": {
     "collapsed": true
    },
-   "outputs": [],
-   "source": []
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "'notebook'"
+      ]
+     },
+     "execution_count": 3,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "import matplotlib\n",
+    "matplotlib.get_backend()"
+   ]
   }
  ],
  "metadata": {

From 7130c9c7ecc49cb379e94fecbb51f8278d8c3145 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Thu, 2 May 2024 21:35:19 +0200
Subject: [PATCH 0965/1120] Backport PR #28144: DOC: Refactor code in the
 fishbone diagram example

---
 .../specialty_plots/ishikawa_diagram.py       | 157 +++++++++---------
 1 file changed, 75 insertions(+), 82 deletions(-)

diff --git a/galleries/examples/specialty_plots/ishikawa_diagram.py b/galleries/examples/specialty_plots/ishikawa_diagram.py
index 18761ca36043..072d7b463c00 100644
--- a/galleries/examples/specialty_plots/ishikawa_diagram.py
+++ b/galleries/examples/specialty_plots/ishikawa_diagram.py
@@ -9,11 +9,12 @@
 Source: https://en.wikipedia.org/wiki/Ishikawa_diagram
 
 """
+import math
+
 import matplotlib.pyplot as plt
 
 from matplotlib.patches import Polygon, Wedge
 
-# Create the fishbone diagram
 fig, ax = plt.subplots(figsize=(10, 6), layout='constrained')
 ax.set_xlim(-5, 5)
 ax.set_ylim(-5, 5)
@@ -22,18 +23,18 @@
 
 def problems(data: str,
              problem_x: float, problem_y: float,
-             prob_angle_x: float, prob_angle_y: float):
+             angle_x: float, angle_y: float):
     """
     Draw each problem section of the Ishikawa plot.
 
     Parameters
     ----------
     data : str
-        The category name.
+        The name of the problem category.
     problem_x, problem_y : float, optional
         The `X` and `Y` positions of the problem arrows (`Y` defaults to zero).
-    prob_angle_x, prob_angle_y : float, optional
-        The angle of the problem annotations. They are angled towards
+    angle_x, angle_y : float, optional
+        The angle of the problem annotations. They are always angled towards
         the tail of the plot.
 
     Returns
@@ -42,8 +43,8 @@ def problems(data: str,
 
     """
     ax.annotate(str.upper(data), xy=(problem_x, problem_y),
-                xytext=(prob_angle_x, prob_angle_y),
-                fontsize='10',
+                xytext=(angle_x, angle_y),
+                fontsize=10,
                 color='white',
                 weight='bold',
                 xycoords='data',
@@ -56,7 +57,8 @@ def problems(data: str,
                           pad=0.8))
 
 
-def causes(data: list, cause_x: float, cause_y: float,
+def causes(data: list,
+           cause_x: float, cause_y: float,
            cause_xytext=(-9, -0.3), top: bool = True):
     """
     Place each cause to a position relative to the problems
@@ -72,7 +74,9 @@ def causes(data: list, cause_x: float, cause_y: float,
     cause_xytext : tuple, optional
         Adjust to set the distance of the cause text from the problem
         arrow in fontsize units.
-    top : bool
+    top : bool, default: True
+        Determines whether the next cause annotation will be
+        plotted above or below the previous one.
 
     Returns
     -------
@@ -80,26 +84,23 @@ def causes(data: list, cause_x: float, cause_y: float,
 
     """
     for index, cause in enumerate(data):
-        # First cause annotation is placed in the middle of the problems arrow
+        # [<x pos>, <y pos>]
+        coords = [[0.02, 0],
+                  [0.23, 0.5],
+                  [-0.46, -1],
+                  [0.69, 1.5],
+                  [-0.92, -2],
+                  [1.15, 2.5]]
+
+        # First 'cause' annotation is placed in the middle of the 'problems' arrow
         # and each subsequent cause is plotted above or below it in succession.
-
-        # [<x pos>, [<y pos top>, <y pos bottom>]]
-        coords = [[0, [0, 0]],
-                  [0.23, [0.5, -0.5]],
-                  [-0.46, [-1, 1]],
-                  [0.69, [1.5, -1.5]],
-                  [-0.92, [-2, 2]],
-                  [1.15, [2.5, -2.5]]]
-        if top:
-            cause_y += coords[index][1][0]
-        else:
-            cause_y += coords[index][1][1]
         cause_x -= coords[index][0]
+        cause_y += coords[index][1] if top else -coords[index][1]
 
         ax.annotate(cause, xy=(cause_x, cause_y),
                     horizontalalignment='center',
                     xytext=cause_xytext,
-                    fontsize='9',
+                    fontsize=9,
                     xycoords='data',
                     textcoords='offset fontsize',
                     arrowprops=dict(arrowstyle="->",
@@ -108,82 +109,74 @@ def causes(data: list, cause_x: float, cause_y: float,
 
 def draw_body(data: dict):
     """
-    Place each section in its correct place by changing
+    Place each problem section in its correct place by changing
     the coordinates on each loop.
 
     Parameters
     ----------
     data : dict
-        The input data (can be list or tuple). ValueError is
-        raised if more than six arguments are passed.
+        The input data (can be a dict of lists or tuples). ValueError
+        is raised if more than six arguments are passed.
 
     Returns
     -------
     None.
 
     """
-    second_sections = []
-    third_sections = []
-    # Resize diagram to automatically scale in response to the number
-    # of problems in the input data.
-    if len(data) == 1 or len(data) == 2:
-        spine_length = (-2.1, 2)
-        head_pos = (2, 0)
-        tail_pos = ((-2.8, 0.8), (-2.8, -0.8), (-2.0, -0.01))
-        first_section = [1.6, 0.8]
-    elif len(data) == 3 or len(data) == 4:
-        spine_length = (-3.1, 3)
-        head_pos = (3, 0)
-        tail_pos = ((-3.8, 0.8), (-3.8, -0.8), (-3.0, -0.01))
-        first_section = [2.6, 1.8]
-        second_sections = [-0.4, -1.2]
-    else:  # len(data) == 5 or 6
-        spine_length = (-4.1, 4)
-        head_pos = (4, 0)
-        tail_pos = ((-4.8, 0.8), (-4.8, -0.8), (-4.0, -0.01))
-        first_section = [3.5, 2.7]
-        second_sections = [1, 0.2]
-        third_sections = [-1.5, -2.3]
-
-    # Change the coordinates of the annotations on each loop.
+    # Set the length of the spine according to the number of 'problem' categories.
+    length = (math.ceil(len(data) / 2)) - 1
+    draw_spine(-2 - length, 2 + length)
+
+    # Change the coordinates of the 'problem' annotations after each one is rendered.
+    offset = 0
+    prob_section = [1.55, 0.8]
     for index, problem in enumerate(data.values()):
-        top_row = True
-        cause_arrow_y = 1.7
-        if index % 2 != 0:  # Plot problems below the spine.
-            top_row = False
-            y_prob_angle = -16
-            cause_arrow_y = -1.7
-        else:  # Plot problems above the spine.
-            y_prob_angle = 16
-        # Plot the 3 sections in pairs along the main spine.
-        if index in (0, 1):
-            prob_arrow_x = first_section[0]
-            cause_arrow_x = first_section[1]
-        elif index in (2, 3):
-            prob_arrow_x = second_sections[0]
-            cause_arrow_x = second_sections[1]
-        else:
-            prob_arrow_x = third_sections[0]
-            cause_arrow_x = third_sections[1]
+        plot_above = index % 2 == 0
+        cause_arrow_y = 1.7 if plot_above else -1.7
+        y_prob_angle = 16 if plot_above else -16
+
+        # Plot each section in pairs along the main spine.
+        prob_arrow_x = prob_section[0] + length + offset
+        cause_arrow_x = prob_section[1] + length + offset
+        if not plot_above:
+            offset -= 2.5
         if index > 5:
             raise ValueError(f'Maximum number of problems is 6, you have entered '
                              f'{len(data)}')
 
-        # draw main spine
-        ax.plot(spine_length, [0, 0], color='tab:blue', linewidth=2)
-        # draw fish head
-        ax.text(head_pos[0] + 0.1, head_pos[1] - 0.05, 'PROBLEM', fontsize=10,
-                weight='bold', color='white')
-        semicircle = Wedge(head_pos, 1, 270, 90, fc='tab:blue')
-        ax.add_patch(semicircle)
-        # draw fishtail
-        triangle = Polygon(tail_pos, fc='tab:blue')
-        ax.add_patch(triangle)
-        # Pass each category name to the problems function as a string on each loop.
         problems(list(data.keys())[index], prob_arrow_x, 0, -12, y_prob_angle)
-        # Start the cause function with the first annotation being plotted at
-        # the cause_arrow_x, cause_arrow_y coordinates.
-        causes(problem, cause_arrow_x, cause_arrow_y, top=top_row)
+        causes(problem, cause_arrow_x, cause_arrow_y, top=plot_above)
+
+
+def draw_spine(xmin: int, xmax: int):
+    """
+    Draw main spine, head and tail.
+
+    Parameters
+    ----------
+    xmin : int
+        The default position of the head of the spine's
+        x-coordinate.
+    xmax : int
+        The default position of the tail of the spine's
+        x-coordinate.
+
+    Returns
+    -------
+    None.
+
+    """
+    # draw main spine
+    ax.plot([xmin - 0.1, xmax], [0, 0], color='tab:blue', linewidth=2)
+    # draw fish head
+    ax.text(xmax + 0.1, - 0.05, 'PROBLEM', fontsize=10,
+            weight='bold', color='white')
+    semicircle = Wedge((xmax, 0), 1, 270, 90, fc='tab:blue')
+    ax.add_patch(semicircle)
+    # draw fish tail
+    tail_pos = [[xmin - 0.8, 0.8], [xmin - 0.8, -0.8], [xmin, -0.01]]
+    triangle = Polygon(tail_pos, fc='tab:blue')
+    ax.add_patch(triangle)
 
 
 # Input data

From 8308d91c5c038719ad9e26c1b93b955a4d6357da Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Mon, 6 May 2024 00:07:26 +0200
Subject: [PATCH 0966/1120] Backport PR #28169: Clarify public-ness of some
 ToolContainerBase APIs.

---
 lib/matplotlib/backend_bases.py | 34 ++++++++++++++++++++++++++-------
 1 file changed, 27 insertions(+), 7 deletions(-)

diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
index d7430a4494fd..740c01226f7d 100644
--- a/lib/matplotlib/backend_bases.py
+++ b/lib/matplotlib/backend_bases.py
@@ -3395,11 +3395,17 @@ def trigger_tool(self, name):
 
     def add_toolitem(self, name, group, position, image, description, toggle):
         """
-        Add a toolitem to the container.
+        A hook to add a toolitem to the container.
 
-        This method must be implemented per backend.
+        This hook must be implemented in each backend and contains the
+        backend-specific code to add an element to the toolbar.
 
-        The callback associated with the button click event,
+        .. warning::
+            This is part of the backend implementation and should
+            not be called by end-users.  They should instead call
+            `.ToolContainerBase.add_tool`.
+
+        The callback associated with the button click event
         must be *exactly* ``self.trigger_tool(name)``.
 
         Parameters
@@ -3425,7 +3431,16 @@ def add_toolitem(self, name, group, position, image, description, toggle):
 
     def toggle_toolitem(self, name, toggled):
         """
-        Toggle the toolitem without firing event.
+        A hook to toggle a toolitem without firing an event.
+
+        This hook must be implemented in each backend and contains the
+        backend-specific code to silently toggle a toolbar element.
+
+        .. warning::
+            This is part of the backend implementation and should
+            not be called by end-users.  They should instead call
+            `.ToolManager.trigger_tool` or `.ToolContainerBase.trigger_tool`
+            (which are equivalent).
 
         Parameters
         ----------
@@ -3438,11 +3453,16 @@ def toggle_toolitem(self, name, toggled):
 
     def remove_toolitem(self, name):
         """
-        Remove a toolitem from the `ToolContainer`.
+        A hook to remove a toolitem from the container.
 
-        This method must get implemented per backend.
+        This hook must be implemented in each backend and contains the
+        backend-specific code to remove an element from the toolbar; it is
+        called when `.ToolManager` emits a `tool_removed_event`.
 
-        Called when `.ToolManager` emits a `tool_removed_event`.
+        .. warning::
+            This is part of the backend implementation and should
+            not be called by end-users.  They should instead call
+            `.ToolManager.remove_tool`.
 
         Parameters
         ----------

From 5da78fda125be8bc14e20bd59adb872c9530a8e9 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Mon, 6 May 2024 13:16:21 -0400
Subject: [PATCH 0967/1120] Backport PR #28171: Support removing absent tools
 from ToolContainerBase.

---
 lib/matplotlib/backend_bases.py         | 4 ++++
 lib/matplotlib/backends/_backend_tk.py  | 3 +--
 lib/matplotlib/backends/backend_gtk3.py | 9 ++-------
 lib/matplotlib/backends/backend_gtk4.py | 9 ++-------
 lib/matplotlib/backends/backend_qt.py   | 3 +--
 lib/matplotlib/backends/backend_wx.py   | 3 +--
 6 files changed, 11 insertions(+), 20 deletions(-)

diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
index 740c01226f7d..f4273bc03919 100644
--- a/lib/matplotlib/backend_bases.py
+++ b/lib/matplotlib/backend_bases.py
@@ -3459,6 +3459,10 @@ def remove_toolitem(self, name):
         backend-specific code to remove an element from the toolbar; it is
         called when `.ToolManager` emits a `tool_removed_event`.
 
+        Because some tools are present only on the `.ToolManager` but not on
+        the `ToolContainer`, this method must be a no-op when called on a tool
+        absent from the container.
+
         .. warning::
             This is part of the backend implementation and should
             not be called by end-users.  They should instead call
diff --git a/lib/matplotlib/backends/_backend_tk.py b/lib/matplotlib/backends/_backend_tk.py
index 693499f4ca01..295f6c41372d 100644
--- a/lib/matplotlib/backends/_backend_tk.py
+++ b/lib/matplotlib/backends/_backend_tk.py
@@ -1011,9 +1011,8 @@ def toggle_toolitem(self, name, toggled):
                 toolitem.deselect()
 
     def remove_toolitem(self, name):
-        for toolitem in self._toolitems[name]:
+        for toolitem in self._toolitems.pop(name, []):
             toolitem.pack_forget()
-        del self._toolitems[name]
 
     def set_message(self, s):
         self._message.set(s)
diff --git a/lib/matplotlib/backends/backend_gtk3.py b/lib/matplotlib/backends/backend_gtk3.py
index d6acd5547b85..49d34f5794e4 100644
--- a/lib/matplotlib/backends/backend_gtk3.py
+++ b/lib/matplotlib/backends/backend_gtk3.py
@@ -446,15 +446,10 @@ def toggle_toolitem(self, name, toggled):
             toolitem.handler_unblock(signal)
 
     def remove_toolitem(self, name):
-        if name not in self._toolitems:
-            self.toolmanager.message_event(f'{name} not in toolbar', self)
-            return
-
-        for group in self._groups:
-            for toolitem, _signal in self._toolitems[name]:
+        for toolitem, _signal in self._toolitems.pop(name, []):
+            for group in self._groups:
                 if toolitem in self._groups[group]:
                     self._groups[group].remove(toolitem)
-        del self._toolitems[name]
 
     def _add_separator(self):
         sep = Gtk.Separator()
diff --git a/lib/matplotlib/backends/backend_gtk4.py b/lib/matplotlib/backends/backend_gtk4.py
index 7e73a4863212..256a8ec9e864 100644
--- a/lib/matplotlib/backends/backend_gtk4.py
+++ b/lib/matplotlib/backends/backend_gtk4.py
@@ -475,15 +475,10 @@ def toggle_toolitem(self, name, toggled):
             toolitem.handler_unblock(signal)
 
     def remove_toolitem(self, name):
-        if name not in self._toolitems:
-            self.toolmanager.message_event(f'{name} not in toolbar', self)
-            return
-
-        for group in self._groups:
-            for toolitem, _signal in self._toolitems[name]:
+        for toolitem, _signal in self._toolitems.pop(name, []):
+            for group in self._groups:
                 if toolitem in self._groups[group]:
                     self._groups[group].remove(toolitem)
-        del self._toolitems[name]
 
     def _add_separator(self):
         sep = Gtk.Separator()
diff --git a/lib/matplotlib/backends/backend_qt.py b/lib/matplotlib/backends/backend_qt.py
index db593ae77ded..a93b37799971 100644
--- a/lib/matplotlib/backends/backend_qt.py
+++ b/lib/matplotlib/backends/backend_qt.py
@@ -1007,9 +1007,8 @@ def toggle_toolitem(self, name, toggled):
             button.toggled.connect(handler)
 
     def remove_toolitem(self, name):
-        for button, handler in self._toolitems[name]:
+        for button, handler in self._toolitems.pop(name, []):
             button.setParent(None)
-        del self._toolitems[name]
 
     def set_message(self, s):
         self.widgetForAction(self._message_action).setText(s)
diff --git a/lib/matplotlib/backends/backend_wx.py b/lib/matplotlib/backends/backend_wx.py
index 8064511ac28a..d39edf40f151 100644
--- a/lib/matplotlib/backends/backend_wx.py
+++ b/lib/matplotlib/backends/backend_wx.py
@@ -1257,9 +1257,8 @@ def toggle_toolitem(self, name, toggled):
         self.Refresh()
 
     def remove_toolitem(self, name):
-        for tool, handler in self._toolitems[name]:
+        for tool, handler in self._toolitems.pop(name, []):
             self.DeleteTool(tool.Id)
-        del self._toolitems[name]
 
     def set_message(self, s):
         self._label_text.SetLabel(s)

From 604961fb9d907a7a6b593c870694a477095947a1 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Wed, 8 May 2024 15:10:30 +0200
Subject: [PATCH 0968/1120] Backport PR #28182: Bump custom hatch deprecation
 expiration

---
 lib/matplotlib/hatch.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/hatch.py b/lib/matplotlib/hatch.py
index 9ec88776cfd3..7a4b283c1dbe 100644
--- a/lib/matplotlib/hatch.py
+++ b/lib/matplotlib/hatch.py
@@ -188,7 +188,7 @@ def _validate_hatch_pattern(hatch):
             invalids = ''.join(sorted(invalids))
             _api.warn_deprecated(
                 '3.4',
-                removal='3.9',  # one release after custom hatches (#20690)
+                removal='3.11',  # one release after custom hatches (#20690)
                 message=f'hatch must consist of a string of "{valid}" or '
                         'None, but found the following invalid values '
                         f'"{invalids}". Passing invalid values is deprecated '

From fe614effc77c3873c65caf321ad6d06260888f69 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Wed, 8 May 2024 17:03:42 -0400
Subject: [PATCH 0969/1120] Backport PR #28181: DOC: Prepare release notes for
 3.9

---
 .../next_api_changes/behavior/22347-RQ.rst    |  13 -
 .../next_api_changes/behavior/26634-TH.rst    |   5 -
 .../next_api_changes/behavior/26696-SR.rst    |   6 -
 .../next_api_changes/behavior/26788-AL.rst    |   6 -
 .../next_api_changes/behavior/26902-RP.rst    |   5 -
 .../next_api_changes/behavior/26917-AL.rst    |   3 -
 .../next_api_changes/behavior/27179-KS.rst    |   7 -
 .../next_api_changes/behavior/27347-GL.rst    |   7 -
 .../next_api_changes/behavior/27469-AL.rst    |  11 -
 .../next_api_changes/behavior/27492-AL.rst    |  12 -
 .../next_api_changes/behavior/27514-OG.rst    |   5 -
 .../next_api_changes/behavior/27589-DS.rst    |   5 -
 .../next_api_changes/behavior/27605-DS.rst    |   4 -
 .../next_api_changes/behavior/27767-REC.rst   |   7 -
 .../next_api_changes/behavior/27943-AL.rst    |  10 -
 .../deprecations/24834-DS.rst                 |  17 -
 .../deprecations/26894-AL.rst                 |   6 -
 .../deprecations/26917-AL.rst                 |   3 -
 .../deprecations/26960-AL.rst                 |   3 -
 .../deprecations/27088-JK.rst                 |   5 -
 .../deprecations/27095-AL.rst                 |  10 -
 .../deprecations/27175-AL.rst                 |   5 -
 .../deprecations/27300-AL.rst                 |   3 -
 .../deprecations/27513-OG.rst                 |   5 -
 .../deprecations/27514-OG.rst                 |   4 -
 .../deprecations/27719-IT.rst                 |  11 -
 .../deprecations/27767-REC.rst                |   9 -
 .../deprecations/27850-REC.rst                |  10 -
 .../deprecations/27901-TS.rst                 |   3 -
 .../next_api_changes/development/26800-OG.rst |  14 -
 .../next_api_changes/development/26849-KS.rst |   5 -
 .../next_api_changes/development/27012-ES.rst |   7 -
 .../next_api_changes/development/27676-ES.rst |   6 -
 .../next_api_changes/removals/26797-OG.rst    |  17 -
 .../next_api_changes/removals/26798-OG.rst    |   9 -
 .../next_api_changes/removals/26852-OG.rst    |  12 -
 .../next_api_changes/removals/26853-OG.rst    |  26 --
 .../next_api_changes/removals/26871-AG.rst    |   3 -
 .../next_api_changes/removals/26872-AD.rst    |   5 -
 .../next_api_changes/removals/26874-AG.rst    |   4 -
 .../next_api_changes/removals/26884-JS.rst    |   5 -
 .../next_api_changes/removals/26885-AD.rst    |   4 -
 .../next_api_changes/removals/26889-GC.rst    |   3 -
 .../next_api_changes/removals/26900-jf.rst    |   4 -
 .../next_api_changes/removals/26907-DCH.rst   |  14 -
 .../next_api_changes/removals/26909-VV.rst    |   4 -
 .../next_api_changes/removals/26910-JP.rst    |  13 -
 .../next_api_changes/removals/26918-EW.rst    |   3 -
 .../next_api_changes/removals/26962-IA.rst    |  19 -
 .../next_api_changes/removals/26965-ER.rst    |  22 -
 .../next_api_changes/removals/27095-AL.rst    |   5 -
 .../next_api_changes/removals/27968-ES.rst    |  14 -
 .../prev_api_changes/api_changes_3.9.0.rst    |  14 +
 .../api_changes_3.9.0/behaviour.rst           | 120 +++++
 .../api_changes_3.9.0/deprecations.rst        |  93 ++++
 .../api_changes_3.9.0/development.rst}        |  46 +-
 .../api_changes_3.9.0/removals.rst            | 159 +++++++
 doc/users/next_whats_new/3d_axis_limits.rst   |  20 -
 .../add_EllipseCollection_setters.rst         |  40 --
 .../next_whats_new/axis_minorticks_toggle.rst |   6 -
 doc/users/next_whats_new/backend_registry.rst |  17 -
 .../next_whats_new/boxplot_legend_support.rst |  60 ---
 .../next_whats_new/figure_align_titles.rst    |   7 -
 .../formatter_unicode_minus.rst               |   4 -
 doc/users/next_whats_new/inset_axes.rst       |   4 -
 .../next_whats_new/interpolation_stage_rc.rst |   4 -
 doc/users/next_whats_new/margin_getters.rst   |   4 -
 .../next_whats_new/mathtext_documentation.rst |   5 -
 doc/users/next_whats_new/mathtext_spacing.rst |   5 -
 .../nonuniformimage_mousover.rst              |   4 -
 .../next_whats_new/pie_percent_latex.rst      |  11 -
 doc/users/next_whats_new/polar-line-spans.rst |   5 -
 doc/users/next_whats_new/sides_violinplot.rst |   4 -
 doc/users/next_whats_new/stackplot_hatch.rst  |  27 --
 .../next_whats_new/stdfmt-axisartist.rst      |   3 -
 doc/users/next_whats_new/subfigure_zorder.rst |  22 -
 .../next_whats_new/update_arrow_patch.rst     |  30 --
 .../next_whats_new/widget_button_clear.rst    |   6 -
 doc/users/prev_whats_new/whats_new_3.9.0.rst  | 409 ++++++++++++++++++
 doc/users/release_notes.rst                   |   5 +-
 80 files changed, 839 insertions(+), 713 deletions(-)
 delete mode 100644 doc/api/next_api_changes/behavior/22347-RQ.rst
 delete mode 100644 doc/api/next_api_changes/behavior/26634-TH.rst
 delete mode 100644 doc/api/next_api_changes/behavior/26696-SR.rst
 delete mode 100644 doc/api/next_api_changes/behavior/26788-AL.rst
 delete mode 100644 doc/api/next_api_changes/behavior/26902-RP.rst
 delete mode 100644 doc/api/next_api_changes/behavior/26917-AL.rst
 delete mode 100644 doc/api/next_api_changes/behavior/27179-KS.rst
 delete mode 100644 doc/api/next_api_changes/behavior/27347-GL.rst
 delete mode 100644 doc/api/next_api_changes/behavior/27469-AL.rst
 delete mode 100644 doc/api/next_api_changes/behavior/27492-AL.rst
 delete mode 100644 doc/api/next_api_changes/behavior/27514-OG.rst
 delete mode 100644 doc/api/next_api_changes/behavior/27589-DS.rst
 delete mode 100644 doc/api/next_api_changes/behavior/27605-DS.rst
 delete mode 100644 doc/api/next_api_changes/behavior/27767-REC.rst
 delete mode 100644 doc/api/next_api_changes/behavior/27943-AL.rst
 delete mode 100644 doc/api/next_api_changes/deprecations/24834-DS.rst
 delete mode 100644 doc/api/next_api_changes/deprecations/26894-AL.rst
 delete mode 100644 doc/api/next_api_changes/deprecations/26917-AL.rst
 delete mode 100644 doc/api/next_api_changes/deprecations/26960-AL.rst
 delete mode 100644 doc/api/next_api_changes/deprecations/27088-JK.rst
 delete mode 100644 doc/api/next_api_changes/deprecations/27095-AL.rst
 delete mode 100644 doc/api/next_api_changes/deprecations/27175-AL.rst
 delete mode 100644 doc/api/next_api_changes/deprecations/27300-AL.rst
 delete mode 100644 doc/api/next_api_changes/deprecations/27513-OG.rst
 delete mode 100644 doc/api/next_api_changes/deprecations/27514-OG.rst
 delete mode 100644 doc/api/next_api_changes/deprecations/27719-IT.rst
 delete mode 100644 doc/api/next_api_changes/deprecations/27767-REC.rst
 delete mode 100644 doc/api/next_api_changes/deprecations/27850-REC.rst
 delete mode 100644 doc/api/next_api_changes/deprecations/27901-TS.rst
 delete mode 100644 doc/api/next_api_changes/development/26800-OG.rst
 delete mode 100644 doc/api/next_api_changes/development/26849-KS.rst
 delete mode 100644 doc/api/next_api_changes/development/27012-ES.rst
 delete mode 100644 doc/api/next_api_changes/development/27676-ES.rst
 delete mode 100644 doc/api/next_api_changes/removals/26797-OG.rst
 delete mode 100644 doc/api/next_api_changes/removals/26798-OG.rst
 delete mode 100644 doc/api/next_api_changes/removals/26852-OG.rst
 delete mode 100644 doc/api/next_api_changes/removals/26853-OG.rst
 delete mode 100644 doc/api/next_api_changes/removals/26871-AG.rst
 delete mode 100644 doc/api/next_api_changes/removals/26872-AD.rst
 delete mode 100644 doc/api/next_api_changes/removals/26874-AG.rst
 delete mode 100644 doc/api/next_api_changes/removals/26884-JS.rst
 delete mode 100644 doc/api/next_api_changes/removals/26885-AD.rst
 delete mode 100644 doc/api/next_api_changes/removals/26889-GC.rst
 delete mode 100644 doc/api/next_api_changes/removals/26900-jf.rst
 delete mode 100644 doc/api/next_api_changes/removals/26907-DCH.rst
 delete mode 100644 doc/api/next_api_changes/removals/26909-VV.rst
 delete mode 100644 doc/api/next_api_changes/removals/26910-JP.rst
 delete mode 100644 doc/api/next_api_changes/removals/26918-EW.rst
 delete mode 100644 doc/api/next_api_changes/removals/26962-IA.rst
 delete mode 100644 doc/api/next_api_changes/removals/26965-ER.rst
 delete mode 100644 doc/api/next_api_changes/removals/27095-AL.rst
 delete mode 100644 doc/api/next_api_changes/removals/27968-ES.rst
 create mode 100644 doc/api/prev_api_changes/api_changes_3.9.0.rst
 create mode 100644 doc/api/prev_api_changes/api_changes_3.9.0/behaviour.rst
 create mode 100644 doc/api/prev_api_changes/api_changes_3.9.0/deprecations.rst
 rename doc/api/{next_api_changes/development/26621-ES.rst => prev_api_changes/api_changes_3.9.0/development.rst} (60%)
 create mode 100644 doc/api/prev_api_changes/api_changes_3.9.0/removals.rst
 delete mode 100644 doc/users/next_whats_new/3d_axis_limits.rst
 delete mode 100644 doc/users/next_whats_new/add_EllipseCollection_setters.rst
 delete mode 100644 doc/users/next_whats_new/axis_minorticks_toggle.rst
 delete mode 100644 doc/users/next_whats_new/backend_registry.rst
 delete mode 100644 doc/users/next_whats_new/boxplot_legend_support.rst
 delete mode 100644 doc/users/next_whats_new/figure_align_titles.rst
 delete mode 100644 doc/users/next_whats_new/formatter_unicode_minus.rst
 delete mode 100644 doc/users/next_whats_new/inset_axes.rst
 delete mode 100644 doc/users/next_whats_new/interpolation_stage_rc.rst
 delete mode 100644 doc/users/next_whats_new/margin_getters.rst
 delete mode 100644 doc/users/next_whats_new/mathtext_documentation.rst
 delete mode 100644 doc/users/next_whats_new/mathtext_spacing.rst
 delete mode 100644 doc/users/next_whats_new/nonuniformimage_mousover.rst
 delete mode 100644 doc/users/next_whats_new/pie_percent_latex.rst
 delete mode 100644 doc/users/next_whats_new/polar-line-spans.rst
 delete mode 100644 doc/users/next_whats_new/sides_violinplot.rst
 delete mode 100644 doc/users/next_whats_new/stackplot_hatch.rst
 delete mode 100644 doc/users/next_whats_new/stdfmt-axisartist.rst
 delete mode 100644 doc/users/next_whats_new/subfigure_zorder.rst
 delete mode 100644 doc/users/next_whats_new/update_arrow_patch.rst
 delete mode 100644 doc/users/next_whats_new/widget_button_clear.rst
 create mode 100644 doc/users/prev_whats_new/whats_new_3.9.0.rst

diff --git a/doc/api/next_api_changes/behavior/22347-RQ.rst b/doc/api/next_api_changes/behavior/22347-RQ.rst
deleted file mode 100644
index b99d183943a5..000000000000
--- a/doc/api/next_api_changes/behavior/22347-RQ.rst
+++ /dev/null
@@ -1,13 +0,0 @@
-Correctly treat pan/zoom events of overlapping Axes
----------------------------------------------------
-
-The forwarding of pan/zoom events is now determined by the visibility of the
-background-patch (e.g. ``ax.patch.get_visible()``) and by the ``zorder`` of the axes.
-
-- Axes with a visible patch capture the event and do not pass it on to axes below.
-  Only the Axes with the highest ``zorder`` that contains the event is triggered
-  (if there are multiple Axes with the same ``zorder``, the last added Axes counts)
-- Axes with an invisible patch are also invisible to events and they are passed on to the axes below.
-
-To override the default behavior and explicitly set whether an Axes
-should forward navigation events, use `.Axes.set_forward_navigation_events`.
diff --git a/doc/api/next_api_changes/behavior/26634-TH.rst b/doc/api/next_api_changes/behavior/26634-TH.rst
deleted file mode 100644
index 4961722078d6..000000000000
--- a/doc/api/next_api_changes/behavior/26634-TH.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-``SubplotParams`` has been moved from ``matplotlib.figure`` to ``matplotlib.gridspec``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-It is still importable from ``matplotlib.figure``, so does not require any changes to
-existing code.
diff --git a/doc/api/next_api_changes/behavior/26696-SR.rst b/doc/api/next_api_changes/behavior/26696-SR.rst
deleted file mode 100644
index 231f412e426d..000000000000
--- a/doc/api/next_api_changes/behavior/26696-SR.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-*loc* parameter of ``Cell`` doesn't accept ``None`` anymore
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The default value of the *loc* parameter has been changed from ``None`` to ``right``,
-which already was the default location. The behavior of `.Cell` didn't change when
-called without an explicit *loc* parameter.
diff --git a/doc/api/next_api_changes/behavior/26788-AL.rst b/doc/api/next_api_changes/behavior/26788-AL.rst
deleted file mode 100644
index 14573e870843..000000000000
--- a/doc/api/next_api_changes/behavior/26788-AL.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-``axvspan`` and ``axhspan`` now return ``Rectangle``\s, not ``Polygons``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-This change allows using `~.Axes.axhspan` to draw an annulus on polar axes.
-
-This change also affects other elements built via `~.Axes.axvspan` and
-`~.Axes.axhspan`, such as ``Slider.poly``.
diff --git a/doc/api/next_api_changes/behavior/26902-RP.rst b/doc/api/next_api_changes/behavior/26902-RP.rst
deleted file mode 100644
index 3106de94fbd5..000000000000
--- a/doc/api/next_api_changes/behavior/26902-RP.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-``Line2D``
-~~~~~~~~~~
-
-When creating a Line2D or using `.Line2D.set_xdata` and `.Line2D.set_ydata`,
-passing x/y data as non sequence is now an error.
diff --git a/doc/api/next_api_changes/behavior/26917-AL.rst b/doc/api/next_api_changes/behavior/26917-AL.rst
deleted file mode 100644
index 7872caf3204d..000000000000
--- a/doc/api/next_api_changes/behavior/26917-AL.rst
+++ /dev/null
@@ -1,3 +0,0 @@
-``ContourLabeler.add_label`` now respects *use_clabeltext*
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-... and sets `.Text.set_transform_rotates_text` accordingly.
diff --git a/doc/api/next_api_changes/behavior/27179-KS.rst b/doc/api/next_api_changes/behavior/27179-KS.rst
deleted file mode 100644
index 873cd622bbd4..000000000000
--- a/doc/api/next_api_changes/behavior/27179-KS.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-Default behavior of ``hexbin`` with *C* provided requires at least 1 point
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The behavior changed in 3.8.0 to be inclusive of *mincnt*. However that resulted in
-errors or warnings with some reduction functions, so now the default is to require at
-least 1 point to call the reduction function. This effectively restores the default
-behavior to match that of Matplotlib 3.7 and before.
diff --git a/doc/api/next_api_changes/behavior/27347-GL.rst b/doc/api/next_api_changes/behavior/27347-GL.rst
deleted file mode 100644
index 2cf8f65cd745..000000000000
--- a/doc/api/next_api_changes/behavior/27347-GL.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-ScalarMappables auto-scale their norm when an array is set
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Collections previously deferred auto-scaling of the norm until draw time.
-This has been changed to scale the norm whenever the first array is set
-to align with the docstring and reduce unexpected behavior when
-accessing the norm before drawing.
diff --git a/doc/api/next_api_changes/behavior/27469-AL.rst b/doc/api/next_api_changes/behavior/27469-AL.rst
deleted file mode 100644
index c47397e873b7..000000000000
--- a/doc/api/next_api_changes/behavior/27469-AL.rst
+++ /dev/null
@@ -1,11 +0,0 @@
-``loc='best'`` for ``legend`` now considers ``Text`` and ``PolyCollections``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The location selection ``legend`` now considers the existence of ``Text``
-and ``PolyCollections`` in the ``badness`` calculation.
-
-Note: The ``best`` option can already be quite slow for plots with large
-amounts of data. For ``PolyCollections``, it only considers the ``Path``
-of ``PolyCollections`` and not the enclosed area when checking for overlap
-to reduce additional latency. However, it can still be quite slow when
-there are large amounts of ``PolyCollections`` in the plot to check for.
diff --git a/doc/api/next_api_changes/behavior/27492-AL.rst b/doc/api/next_api_changes/behavior/27492-AL.rst
deleted file mode 100644
index 98a4900fa67d..000000000000
--- a/doc/api/next_api_changes/behavior/27492-AL.rst
+++ /dev/null
@@ -1,12 +0,0 @@
-Image path semantics of toolmanager-based tools
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Previously, MEP22 ("toolmanager-based") Tools would try to load their icon
-(``tool.image``) relative to the current working directory, or, as a fallback,
-from Matplotlib's own image directory.  Because both approaches are problematic
-for third-party tools (the end-user may change the current working directory
-at any time, and third-parties cannot add new icons in Matplotlib's image
-directory), this behavior is deprecated; instead, ``tool.image`` is now
-interpreted relative to the directory containing the source file where the
-``Tool.image`` class attribute is defined.  (Defining ``tool.image`` as an
-absolute path also works and is compatible with both the old and the new
-semantics.)
diff --git a/doc/api/next_api_changes/behavior/27514-OG.rst b/doc/api/next_api_changes/behavior/27514-OG.rst
deleted file mode 100644
index 8b2a7ab9ef2e..000000000000
--- a/doc/api/next_api_changes/behavior/27514-OG.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-Exception when not passing a Bbox to BboxTransform*-classes
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The exception when not passing a Bbox to BboxTransform*-classes that expect one, e.g.,
-`~matplotlib.transforms.BboxTransform` has changed from ``ValueError`` to ``TypeError``.
diff --git a/doc/api/next_api_changes/behavior/27589-DS.rst b/doc/api/next_api_changes/behavior/27589-DS.rst
deleted file mode 100644
index 314df582600b..000000000000
--- a/doc/api/next_api_changes/behavior/27589-DS.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-PowerNorm no longer clips values below vmin
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-When ``clip=False`` is set (the default) on `~matplotlib.colors.PowerNorm`,
-values below ``vmin`` are now linearly normalised. Previously they were clipped
-to zero. This fixes issues with the display of colorbars associated with a power norm.
diff --git a/doc/api/next_api_changes/behavior/27605-DS.rst b/doc/api/next_api_changes/behavior/27605-DS.rst
deleted file mode 100644
index a4bc04ccfb04..000000000000
--- a/doc/api/next_api_changes/behavior/27605-DS.rst
+++ /dev/null
@@ -1,4 +0,0 @@
-Boxplots now ignore masked data points
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-`~matplotlib.axes.Axes.boxplot` and `~matplotlib.cbook.boxplot_stats` now ignore
-any masked points in the input data.
diff --git a/doc/api/next_api_changes/behavior/27767-REC.rst b/doc/api/next_api_changes/behavior/27767-REC.rst
deleted file mode 100644
index f6b4dc156732..000000000000
--- a/doc/api/next_api_changes/behavior/27767-REC.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-Legend labels for ``plot``
-~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Previously if a sequence was passed to the *label* parameter of `~.Axes.plot` when
-plotting a single dataset, the sequence was automatically cast to string for the legend
-label.  Now, if the sequence has only one element, that element will be the legend
-label.  To keep the old behavior, cast the sequence to string before passing.
diff --git a/doc/api/next_api_changes/behavior/27943-AL.rst b/doc/api/next_api_changes/behavior/27943-AL.rst
deleted file mode 100644
index 1314b763987e..000000000000
--- a/doc/api/next_api_changes/behavior/27943-AL.rst
+++ /dev/null
@@ -1,10 +0,0 @@
-plot() shorthand format interprets "Cn" (n>9) as a color-cycle color
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Previously, ``plot(..., "-C11")`` would be interpreted as requesting a plot
-using linestyle "-", color "C1" (color #1 of the color cycle), and marker "1"
-("tri-down").  It is now interpreted as requesting linestyle "-" and color
-"C11" (color #11 of the color cycle).
-
-It is recommended to pass ambiguous markers (such as "1") explicitly using the
-*marker* keyword argument.  If the shorthand form is desired, such markers can
-also be unambiguously set by putting them *before* the color string.
diff --git a/doc/api/next_api_changes/deprecations/24834-DS.rst b/doc/api/next_api_changes/deprecations/24834-DS.rst
deleted file mode 100644
index 3761daaf1275..000000000000
--- a/doc/api/next_api_changes/deprecations/24834-DS.rst
+++ /dev/null
@@ -1,17 +0,0 @@
-Applying theta transforms in ``PolarTransform``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Applying theta transforms in `~matplotlib.projections.polar.PolarTransform`
-and `~matplotlib.projections.polar.InvertedPolarTransform`
-is deprecated, and will be removed in a future version of Matplotlib. This
-is currently the default behaviour when these transforms are used externally,
-but only takes affect when:
-
-- An axis is associated with the transform.
-- The axis has a non-zero theta offset or has theta values increasing in
-  a clockwise direction.
-
-To silence this warning and adopt future behaviour,
-set ``apply_theta_transforms=False``. If you need to retain the behaviour
-where theta values are transformed, chain the ``PolarTransform`` with
-a `~matplotlib.transforms.Affine2D` transform that performs the theta shift
-and/or sign shift.
diff --git a/doc/api/next_api_changes/deprecations/26894-AL.rst b/doc/api/next_api_changes/deprecations/26894-AL.rst
deleted file mode 100644
index b156fa843917..000000000000
--- a/doc/api/next_api_changes/deprecations/26894-AL.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-*interval* parameter of ``TimerBase.start``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Setting the timer *interval* while starting it is deprecated.  The interval can
-be specified instead in the timer constructor, or by setting the
-``timer.interval`` attribute.
diff --git a/doc/api/next_api_changes/deprecations/26917-AL.rst b/doc/api/next_api_changes/deprecations/26917-AL.rst
deleted file mode 100644
index d3cf16f5c511..000000000000
--- a/doc/api/next_api_changes/deprecations/26917-AL.rst
+++ /dev/null
@@ -1,3 +0,0 @@
-``ContourLabeler.add_label_clabeltext``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-... is deprecated.
diff --git a/doc/api/next_api_changes/deprecations/26960-AL.rst b/doc/api/next_api_changes/deprecations/26960-AL.rst
deleted file mode 100644
index cbde4cbba424..000000000000
--- a/doc/api/next_api_changes/deprecations/26960-AL.rst
+++ /dev/null
@@ -1,3 +0,0 @@
-``backend_ps.get_bbox_header``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-... is deprecated, as it is considered an internal helper.
diff --git a/doc/api/next_api_changes/deprecations/27088-JK.rst b/doc/api/next_api_changes/deprecations/27088-JK.rst
deleted file mode 100644
index ea7fef5abf64..000000000000
--- a/doc/api/next_api_changes/deprecations/27088-JK.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-Deprecations removed in ``contour``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-``contour.allsegs``, ``contour.allkinds``, and ``contour.find_nearest_contour`` are no
-longer marked for deprecation.
diff --git a/doc/api/next_api_changes/deprecations/27095-AL.rst b/doc/api/next_api_changes/deprecations/27095-AL.rst
deleted file mode 100644
index 2e5b2e1ea5e5..000000000000
--- a/doc/api/next_api_changes/deprecations/27095-AL.rst
+++ /dev/null
@@ -1,10 +0,0 @@
-*nth_coord* parameter to axisartist helpers for fixed axis
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Helper APIs in `.axisartist` for generating a "fixed" axis on rectilinear axes
-(`.FixedAxisArtistHelperRectilinear`) no longer take a *nth_coord* parameter,
-as that parameter is entirely inferred from the (required) *loc* parameter and
-having inconsistent *nth_coord* and *loc* is an error.
-
-For curvilinear axes, the *nth_coord* parameter remains supported (it affects
-the *ticks*, not the axis position itself), but that parameter will become
-keyword-only, for consistency with the rectilinear case.
diff --git a/doc/api/next_api_changes/deprecations/27175-AL.rst b/doc/api/next_api_changes/deprecations/27175-AL.rst
deleted file mode 100644
index 3fce05765a59..000000000000
--- a/doc/api/next_api_changes/deprecations/27175-AL.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-Mixing positional and keyword arguments for ``legend`` handles and labels
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-This previously only raised a warning, but is now formally deprecated.  If
-passing *handles* and *labels*, they must be passed either both positionally or
-both as keyword.
diff --git a/doc/api/next_api_changes/deprecations/27300-AL.rst b/doc/api/next_api_changes/deprecations/27300-AL.rst
deleted file mode 100644
index 87f4bb259537..000000000000
--- a/doc/api/next_api_changes/deprecations/27300-AL.rst
+++ /dev/null
@@ -1,3 +0,0 @@
-``GridHelperCurveLinear.get_tick_iterator``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-... is deprecated with no replacement.
diff --git a/doc/api/next_api_changes/deprecations/27513-OG.rst b/doc/api/next_api_changes/deprecations/27513-OG.rst
deleted file mode 100644
index 46414744f59d..000000000000
--- a/doc/api/next_api_changes/deprecations/27513-OG.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-``BboxTransformToMaxOnly``
-~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-... is deprecated without replacement. If you rely on this, please make a copy of the
-code.
diff --git a/doc/api/next_api_changes/deprecations/27514-OG.rst b/doc/api/next_api_changes/deprecations/27514-OG.rst
deleted file mode 100644
index f318ec8aa4bb..000000000000
--- a/doc/api/next_api_changes/deprecations/27514-OG.rst
+++ /dev/null
@@ -1,4 +0,0 @@
-``TransformNode.is_bbox``
-~~~~~~~~~~~~~~~~~~~~~~~~~
-
-... is deprecated. Instead check the object using ``isinstance(..., BboxBase)``.
diff --git a/doc/api/next_api_changes/deprecations/27719-IT.rst b/doc/api/next_api_changes/deprecations/27719-IT.rst
deleted file mode 100644
index c41e9d2c396f..000000000000
--- a/doc/api/next_api_changes/deprecations/27719-IT.rst
+++ /dev/null
@@ -1,11 +0,0 @@
-``rcsetup.interactive_bk``, ``rcsetup.non_interactive_bk`` and ``rcsetup.all_backends``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-... are deprecated and replaced by ``matplotlib.backends.backend_registry.list_builtin``
-with the following arguments
-
-- ``matplotlib.backends.BackendFilter.INTERACTIVE``
-- ``matplotlib.backends.BackendFilter.NON_INTERACTIVE``
-- ``None``
-
-respectively.
diff --git a/doc/api/next_api_changes/deprecations/27767-REC.rst b/doc/api/next_api_changes/deprecations/27767-REC.rst
deleted file mode 100644
index 68781090df0a..000000000000
--- a/doc/api/next_api_changes/deprecations/27767-REC.rst
+++ /dev/null
@@ -1,9 +0,0 @@
-Legend labels for ``plot``
-~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Previously if a sequence was passed to the *label* parameter of `~.Axes.plot` when
-plotting a single dataset, the sequence was automatically cast to string for the legend
-label.  This behavior is now deprecated and in future will error if the sequence length
-is not one (consistent with multi-dataset behavior, where the number of elements must
-match the number of datasets).  To keep the old behavior, cast the sequence to string
-before passing.
diff --git a/doc/api/next_api_changes/deprecations/27850-REC.rst b/doc/api/next_api_changes/deprecations/27850-REC.rst
deleted file mode 100644
index 2021c2737ecd..000000000000
--- a/doc/api/next_api_changes/deprecations/27850-REC.rst
+++ /dev/null
@@ -1,10 +0,0 @@
-``plot_date``
-~~~~~~~~~~~~~
-
-Use of `~.Axes.plot_date` has been discouraged since Matplotlib 3.5 and the
-function is now formally deprecated.
-
-- ``datetime``-like data should directly be plotted using `~.Axes.plot`.
--  If you need to plot plain numeric data as :ref:`date-format` or need to set
-   a timezone, call ``ax.xaxis.axis_date`` / ``ax.yaxis.axis_date`` before
-   `~.Axes.plot`. See `.Axis.axis_date`.
diff --git a/doc/api/next_api_changes/deprecations/27901-TS.rst b/doc/api/next_api_changes/deprecations/27901-TS.rst
deleted file mode 100644
index e31b77e2c6f8..000000000000
--- a/doc/api/next_api_changes/deprecations/27901-TS.rst
+++ /dev/null
@@ -1,3 +0,0 @@
-``boxplot`` tick labels
-~~~~~~~~~~~~~~~~~~~~~~~
-The parameter *labels* has been renamed to *tick_labels* for clarity and consistency with `~.Axes.bar`.
diff --git a/doc/api/next_api_changes/development/26800-OG.rst b/doc/api/next_api_changes/development/26800-OG.rst
deleted file mode 100644
index d536f8240c76..000000000000
--- a/doc/api/next_api_changes/development/26800-OG.rst
+++ /dev/null
@@ -1,14 +0,0 @@
-Increase to minimum supported versions of dependencies
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-For Matplotlib 3.9, the :ref:`minimum supported versions <dependencies>` are
-being bumped:
-
-+------------+-----------------+---------------+
-| Dependency |  min in mpl3.8  | min in mpl3.9 |
-+============+=================+===============+
-|   NumPy    |       1.21.0    |      1.23.0   |
-+------------+-----------------+---------------+
-
-This is consistent with our :ref:`min_deps_policy` and `NEP29
-<https://numpy.org/neps/nep-0029-deprecation_policy.html>`__
diff --git a/doc/api/next_api_changes/development/26849-KS.rst b/doc/api/next_api_changes/development/26849-KS.rst
deleted file mode 100644
index 1a1deda40fca..000000000000
--- a/doc/api/next_api_changes/development/26849-KS.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-Minimum version of setuptools bumped to 64
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-To comply with requirements of ``setuptools_scm``, the minimum version of ``setuptools``
-has been increased from 42 to 64.
diff --git a/doc/api/next_api_changes/development/27012-ES.rst b/doc/api/next_api_changes/development/27012-ES.rst
deleted file mode 100644
index 1bec3e7d91df..000000000000
--- a/doc/api/next_api_changes/development/27012-ES.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-Extensions require C++17
-~~~~~~~~~~~~~~~~~~~~~~~~
-
-Matplotlib now requires a compiler that supports C++17 in order to build its extensions.
-According to `SciPy's analysis
-<https://docs.scipy.org/doc/scipy/dev/toolchain.html#c-language-standards>`_, this
-should be available on all supported platforms.
diff --git a/doc/api/next_api_changes/development/27676-ES.rst b/doc/api/next_api_changes/development/27676-ES.rst
deleted file mode 100644
index 5242c5cba943..000000000000
--- a/doc/api/next_api_changes/development/27676-ES.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-Windows on ARM64 support
-~~~~~~~~~~~~~~~~~~~~~~~~
-
-Windows on ARM64 bundles FreeType 2.6.1 instead of 2.11.1 when building from source.
-This may cause small changes to text rendering, but should become consistent with all
-other platforms.
diff --git a/doc/api/next_api_changes/removals/26797-OG.rst b/doc/api/next_api_changes/removals/26797-OG.rst
deleted file mode 100644
index 680f69e01a96..000000000000
--- a/doc/api/next_api_changes/removals/26797-OG.rst
+++ /dev/null
@@ -1,17 +0,0 @@
-``draw_gouraud_triangle``
-~~~~~~~~~~~~~~~~~~~~~~~~~
-
-... is removed. Use `~.RendererBase.draw_gouraud_triangles` instead.
-
-A ``draw_gouraud_triangle`` call in a custom `~matplotlib.artist.Artist` can readily be
-replaced as::
-
-    self.draw_gouraud_triangles(gc, points.reshape((1, 3, 2)),
-                                colors.reshape((1, 3, 4)), trans)
-
-A `~.RendererBase.draw_gouraud_triangles` method can be implemented from an
-existing ``draw_gouraud_triangle`` method as::
-
-    transform = transform.frozen()
-    for tri, col in zip(triangles_array, colors_array):
-        self.draw_gouraud_triangle(gc, tri, col, transform)
diff --git a/doc/api/next_api_changes/removals/26798-OG.rst b/doc/api/next_api_changes/removals/26798-OG.rst
deleted file mode 100644
index 0d7d0a11faf2..000000000000
--- a/doc/api/next_api_changes/removals/26798-OG.rst
+++ /dev/null
@@ -1,9 +0,0 @@
-``unit_cube``, ``tunit_cube``, and ``tunit_edges``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-... of `.Axes3D` are removed without replacements.
-
-``axes3d.vvec``, ``axes3d.eye``, ``axes3d.sx``, and ``axes3d.sy``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-... are removed without replacement.
diff --git a/doc/api/next_api_changes/removals/26852-OG.rst b/doc/api/next_api_changes/removals/26852-OG.rst
deleted file mode 100644
index 08ad0105b70a..000000000000
--- a/doc/api/next_api_changes/removals/26852-OG.rst
+++ /dev/null
@@ -1,12 +0,0 @@
-``num2julian``, ``julian2num`` and ``JULIAN_OFFSET``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-... of the `.dates` module are removed without replacements. These were
-undocumented and not exported.
-
-Julian dates in Matplotlib were calculated from a Julian date epoch: ``jdate =
-(date - np.datetime64(EPOCH)) / np.timedelta64(1, 'D')``.  Conversely, a Julian
-date was converted to datetime as ``date = np.timedelta64(int(jdate * 24 *
-3600), 's') + np.datetime64(EPOCH)``. Matplotlib was using
-``EPOCH='-4713-11-24T12:00'`` so that 2000-01-01 at 12:00 is 2_451_545.0 (see
-<https://en.wikipedia.org/wiki/Julian_day>`).
diff --git a/doc/api/next_api_changes/removals/26853-OG.rst b/doc/api/next_api_changes/removals/26853-OG.rst
deleted file mode 100644
index dc5c37e38db5..000000000000
--- a/doc/api/next_api_changes/removals/26853-OG.rst
+++ /dev/null
@@ -1,26 +0,0 @@
-Most arguments to widgets have been made keyword-only
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Passing all but the very few first arguments positionally in the constructors
-of Widgets is now keyword-only. In general, all optional arguments are keyword-only.
-
-``RadioButtons.circles``
-~~~~~~~~~~~~~~~~~~~~~~~~
-
-... is removed.  (``RadioButtons`` now draws itself using `~.Axes.scatter`.)
-
-``CheckButtons.rectangles`` and ``CheckButtons.lines``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-``CheckButtons.rectangles`` and ``CheckButtons.lines`` are removed.
-(``CheckButtons`` now draws itself using `~.Axes.scatter`.)
-
-Remove unused parameter *x* to ``TextBox.begin_typing``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-This parameter was unused in the method, but was a required argument.
-
-``MultiCursor.needclear``
-~~~~~~~~~~~~~~~~~~~~~~~~~
-
-... is removed.
diff --git a/doc/api/next_api_changes/removals/26871-AG.rst b/doc/api/next_api_changes/removals/26871-AG.rst
deleted file mode 100644
index 9c24ac3215a1..000000000000
--- a/doc/api/next_api_changes/removals/26871-AG.rst
+++ /dev/null
@@ -1,3 +0,0 @@
-``matplotlib.axis.Axis.set_ticklabels``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-... a param was renamed to labels from ticklabels.
diff --git a/doc/api/next_api_changes/removals/26872-AD.rst b/doc/api/next_api_changes/removals/26872-AD.rst
deleted file mode 100644
index 411359813e51..000000000000
--- a/doc/api/next_api_changes/removals/26872-AD.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-``Animation`` attributes
-~~~~~~~~~~~~~~~~~~~~~~~~
-
-The attributes ``repeat`` of `.TimedAnimation` and subclasses and
-``save_count`` of `.FuncAnimation` are considered private and removed.
diff --git a/doc/api/next_api_changes/removals/26874-AG.rst b/doc/api/next_api_changes/removals/26874-AG.rst
deleted file mode 100644
index ad305cf9d96c..000000000000
--- a/doc/api/next_api_changes/removals/26874-AG.rst
+++ /dev/null
@@ -1,4 +0,0 @@
-``collections.PolyCollection.span_where`` and ``collections.BrokenBarHCollection``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-... removed as it was deprecated during 3.7. Use ``fill_between`` instead
diff --git a/doc/api/next_api_changes/removals/26884-JS.rst b/doc/api/next_api_changes/removals/26884-JS.rst
deleted file mode 100644
index 71608b8d94be..000000000000
--- a/doc/api/next_api_changes/removals/26884-JS.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-``parse_fontconfig_pattern`` raises on unknown constant names
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Previously, in a fontconfig pattern like ``DejaVu Sans:foo``, the unknown
-``foo`` constant name would be silently ignored.  This now raises an error.
diff --git a/doc/api/next_api_changes/removals/26885-AD.rst b/doc/api/next_api_changes/removals/26885-AD.rst
deleted file mode 100644
index c617f10d07ed..000000000000
--- a/doc/api/next_api_changes/removals/26885-AD.rst
+++ /dev/null
@@ -1,4 +0,0 @@
-``raw`` parameter
-~~~~~~~~~~~~~~~~~
-
-... of `.GridSpecBase.get_grid_positions` is removed without replacements.
diff --git a/doc/api/next_api_changes/removals/26889-GC.rst b/doc/api/next_api_changes/removals/26889-GC.rst
deleted file mode 100644
index 2cccc9fee113..000000000000
--- a/doc/api/next_api_changes/removals/26889-GC.rst
+++ /dev/null
@@ -1,3 +0,0 @@
-Removing Deprecated API SimpleEvent
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-``matplotlib.patches.ConnectionStyle._Base.SimpleEvent``
diff --git a/doc/api/next_api_changes/removals/26900-jf.rst b/doc/api/next_api_changes/removals/26900-jf.rst
deleted file mode 100644
index 5f14c1543ad8..000000000000
--- a/doc/api/next_api_changes/removals/26900-jf.rst
+++ /dev/null
@@ -1,4 +0,0 @@
-``passthru_pt``
-~~~~~~~~~~~~~~~
-
-This attribute of ``AxisArtistHelper``\s has been removed.
diff --git a/doc/api/next_api_changes/removals/26907-DCH.rst b/doc/api/next_api_changes/removals/26907-DCH.rst
deleted file mode 100644
index 889743ba9cb0..000000000000
--- a/doc/api/next_api_changes/removals/26907-DCH.rst
+++ /dev/null
@@ -1,14 +0,0 @@
-``contour.ClabelText`` and ``ContourLabeler.set_label_props``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-... are removed.
-
-Use ``Text(..., transform_rotates_text=True)`` as a replacement for
-``contour.ClabelText(...)`` and ``text.set(text=text, color=color,
-fontproperties=labeler.labelFontProps, clip_box=labeler.axes.bbox)`` as a
-replacement for the ``ContourLabeler.set_label_props(label, text, color)``.
-
-``ContourLabeler`` attributes
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-The ``labelFontProps``, ``labelFontSizeList``, and ``labelTextsList``
-attributes of `.ContourLabeler` have been removed.  Use the ``labelTexts``
-attribute and the font properties of the corresponding text objects instead.
diff --git a/doc/api/next_api_changes/removals/26909-VV.rst b/doc/api/next_api_changes/removals/26909-VV.rst
deleted file mode 100644
index bdb815eed322..000000000000
--- a/doc/api/next_api_changes/removals/26909-VV.rst
+++ /dev/null
@@ -1,4 +0,0 @@
-``matplotlib.tri`` submodules are removed
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-The ``matplotlib.tri.*`` submodules are removed.  All functionality is
-available in ``matplotlib.tri`` directly and should be imported from there.
diff --git a/doc/api/next_api_changes/removals/26910-JP.rst b/doc/api/next_api_changes/removals/26910-JP.rst
deleted file mode 100644
index 0de12cd89ad5..000000000000
--- a/doc/api/next_api_changes/removals/26910-JP.rst
+++ /dev/null
@@ -1,13 +0,0 @@
-``offsetbox.bbox_artist``
-~~~~~~~~~~~~~~~~~~~~~~~~~
-
-... is removed. This was just a wrapper to call `.patches.bbox_artist` if a flag is set in the file, so use that directly if you need the behavior.
-
-``offsetBox.get_extent_offsets`` and ``offsetBox.get_extent``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-... are removed; these methods are also removed on all subclasses of `.OffsetBox`.
-
-... To get the offsetbox extents, instead of ``get_extent``, use `.OffsetBox.get_bbox`, which directly returns a `.Bbox` instance.
-
-... To also get the child offsets, instead of ``get_extent_offsets``, separately call `~.OffsetBox.get_offset` on each children after triggering a draw.
diff --git a/doc/api/next_api_changes/removals/26918-EW.rst b/doc/api/next_api_changes/removals/26918-EW.rst
deleted file mode 100644
index 454f35d5e200..000000000000
--- a/doc/api/next_api_changes/removals/26918-EW.rst
+++ /dev/null
@@ -1,3 +0,0 @@
-``Quiver.quiver_doc`` and ``Barbs.barbs_doc``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-... are removed. These are the doc-string and should not be accessible as a named class member.
diff --git a/doc/api/next_api_changes/removals/26962-IA.rst b/doc/api/next_api_changes/removals/26962-IA.rst
deleted file mode 100644
index ac1ab46944b6..000000000000
--- a/doc/api/next_api_changes/removals/26962-IA.rst
+++ /dev/null
@@ -1,19 +0,0 @@
-Deprecated Classes Removed
-~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The following deprecated classes from version 3.7 have been removed:
-
-- ``matplotlib.backends.backend_ps.PsBackendHelper``
-- ``matplotlib.backends.backend_webagg.ServerThread``
-
-These classes were previously marked as deprecated and have now been removed in accordance with the deprecation cycle.
-
-Deprecated C++ Methods Removed
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The following deprecated C++ methods from :file:`src/_backend_agg_wrapper.cpp`, deprecated since version 3.7, have also been removed:
-
-- ``PyBufferRegion_to_string``
-- ``PyBufferRegion_to_string_argb``
-
-These methods were previously marked as deprecated and have now been removed.
diff --git a/doc/api/next_api_changes/removals/26965-ER.rst b/doc/api/next_api_changes/removals/26965-ER.rst
deleted file mode 100644
index b4ae71be3bff..000000000000
--- a/doc/api/next_api_changes/removals/26965-ER.rst
+++ /dev/null
@@ -1,22 +0,0 @@
-Removal of top-level cmap registration and access functions in ``mpl.cm``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-As part of the `multi-step refactoring of colormap registration
-<https://github.com/matplotlib/matplotlib/issues/20853>`_, the following functions have
-been removed:
-
-- ``matplotlib.cm.get_cmap``; use ``matplotlib.colormaps[name]`` instead if you
-  have a `str`.
-
-  Use `matplotlib.cm.ColormapRegistry.get_cmap` if you have a `str`, `None` or a
-  `matplotlib.colors.Colormap` object that you want to convert to a `.Colormap`
-  object.
-- ``matplotlib.cm.register_cmap``; use `matplotlib.colormaps.register
-  <.ColormapRegistry.register>` instead.
-- ``matplotlib.cm.unregister_cmap``; use `matplotlib.colormaps.unregister
-  <.ColormapRegistry.unregister>` instead.
-- ``matplotlib.pyplot.register_cmap``; use `matplotlib.colormaps.register
-  <.ColormapRegistry.register>` instead.
-
-The `matplotlib.pyplot.get_cmap` function will stay available for backward
-compatibility.
diff --git a/doc/api/next_api_changes/removals/27095-AL.rst b/doc/api/next_api_changes/removals/27095-AL.rst
deleted file mode 100644
index 7b8e5981ca79..000000000000
--- a/doc/api/next_api_changes/removals/27095-AL.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-Inconsistent *nth_coord* and *loc* passed to ``_FixedAxisArtistHelperBase``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-The value of the *nth_coord* parameter of ``_FixedAxisArtistHelperBase`` and
-its subclasses is now inferred from the value of *loc*; passing inconsistent
-values (e.g., requesting a "top y axis" or a "left x axis") has no more effect.
diff --git a/doc/api/next_api_changes/removals/27968-ES.rst b/doc/api/next_api_changes/removals/27968-ES.rst
deleted file mode 100644
index 99b3b1527506..000000000000
--- a/doc/api/next_api_changes/removals/27968-ES.rst
+++ /dev/null
@@ -1,14 +0,0 @@
-``legend.legendHandles``
-~~~~~~~~~~~~~~~~~~~~~~~~
-
-... was undocumented and has been renamed to ``legend_handles``.
-
-Passing undefined *label_mode* to ``Grid``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-... is no longer allowed. This includes `mpl_toolkits.axes_grid1.axes_grid.Grid`,
-`mpl_toolkits.axes_grid1.axes_grid.AxesGrid`, and
-`mpl_toolkits.axes_grid1.axes_grid.ImageGrid` as well as the corresponding classes
-imported from `mpl_toolkits.axisartist.axes_grid`.
-
-Pass ``label_mode='keep'`` instead to get the previous behavior of not modifying labels.
diff --git a/doc/api/prev_api_changes/api_changes_3.9.0.rst b/doc/api/prev_api_changes/api_changes_3.9.0.rst
new file mode 100644
index 000000000000..8bd2628c90dc
--- /dev/null
+++ b/doc/api/prev_api_changes/api_changes_3.9.0.rst
@@ -0,0 +1,14 @@
+API Changes for 3.9.0
+=====================
+
+.. contents::
+   :local:
+   :depth: 1
+
+.. include:: /api/prev_api_changes/api_changes_3.9.0/behaviour.rst
+
+.. include:: /api/prev_api_changes/api_changes_3.9.0/deprecations.rst
+
+.. include:: /api/prev_api_changes/api_changes_3.9.0/removals.rst
+
+.. include:: /api/prev_api_changes/api_changes_3.9.0/development.rst
diff --git a/doc/api/prev_api_changes/api_changes_3.9.0/behaviour.rst b/doc/api/prev_api_changes/api_changes_3.9.0/behaviour.rst
new file mode 100644
index 000000000000..498dfb766922
--- /dev/null
+++ b/doc/api/prev_api_changes/api_changes_3.9.0/behaviour.rst
@@ -0,0 +1,120 @@
+Behaviour Changes
+-----------------
+
+plot() shorthand format interprets "Cn" (n>9) as a color-cycle color
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Previously, ``plot(..., "-C11")`` would be interpreted as requesting a plot using
+linestyle "-", color "C1" (color #1 of the color cycle), and marker "1" ("tri-down").
+It is now interpreted as requesting linestyle "-" and color "C11" (color #11 of the
+color cycle).
+
+It is recommended to pass ambiguous markers (such as "1") explicitly using the *marker*
+keyword argument. If the shorthand form is desired, such markers can also be
+unambiguously set by putting them *before* the color string.
+
+Legend labels for ``plot``
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Previously if a sequence was passed to the *label* parameter of `~.Axes.plot` when
+plotting a single dataset, the sequence was automatically cast to string for the legend
+label. Now, if the sequence has only one element, that element will be the legend label.
+To keep the old behavior, cast the sequence to string before passing.
+
+Boxplots now ignore masked data points
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+`~matplotlib.axes.Axes.boxplot` and `~matplotlib.cbook.boxplot_stats` now ignore any
+masked points in the input data.
+
+``axhspan`` and ``axvspan`` now return ``Rectangle``\s, not ``Polygon``\s
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+This change allows using `~.Axes.axhspan` to draw an annulus on polar axes.
+
+This change also affects other elements built via `~.Axes.axhspan` and `~.Axes.axvspan`,
+such as ``Slider.poly``.
+
+Improved handling of pan/zoom events of overlapping Axes
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The forwarding of pan/zoom events is now determined by the visibility of the
+background-patch (e.g. ``ax.patch.get_visible()``) and by the ``zorder`` of the axes.
+
+- Axes with a visible patch capture the event and do not pass it on to axes below. Only
+  the Axes with the highest ``zorder`` that contains the event is triggered (if there
+  are multiple Axes with the same ``zorder``, the last added Axes counts)
+- Axes with an invisible patch are also invisible to events and they are passed on to
+  the axes below.
+
+To override the default behavior and explicitly set whether an Axes should forward
+navigation events, use `.Axes.set_forward_navigation_events`.
+
+``loc='best'`` for ``legend`` now considers ``Text`` and ``PolyCollections``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The location selection ``legend`` now considers the existence of ``Text`` and
+``PolyCollections`` in the ``badness`` calculation.
+
+Note: The ``best`` option can already be quite slow for plots with large amounts of
+data. For ``PolyCollections``, it only considers the ``Path`` of ``PolyCollections`` and
+not the enclosed area when checking for overlap to reduce additional latency. However,
+it can still be quite slow when there are large amounts of ``PolyCollections`` in the
+plot to check for.
+
+Exception when not passing a Bbox to BboxTransform*-classes
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The exception when not passing a Bbox to BboxTransform*-classes that expect one, e.g.,
+`~matplotlib.transforms.BboxTransform` has changed from ``ValueError`` to ``TypeError``.
+
+*loc* parameter of ``Cell`` no longer accepts ``None``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The default value of the *loc* parameter has been changed from ``None`` to ``right``,
+which already was the default location. The behavior of `.Cell` didn't change when
+called without an explicit *loc* parameter.
+
+``ContourLabeler.add_label`` now respects *use_clabeltext*
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+... and sets `.Text.set_transform_rotates_text` accordingly.
+
+``Line2D``
+^^^^^^^^^^
+
+When creating a Line2D or using `.Line2D.set_xdata` and `.Line2D.set_ydata`,
+passing x/y data as non sequence is now an error.
+
+``ScalarMappable``\s auto-scale their norm when an array is set
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Collections previously deferred auto-scaling of the norm until draw time. This has been
+changed to scale the norm whenever the first array is set to align with the docstring
+and reduce unexpected behavior when accessing the norm before drawing.
+
+``SubplotParams`` moved from ``matplotlib.figure`` to ``matplotlib.gridspec``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+It is still importable from ``matplotlib.figure``, so does not require any changes to
+existing code.
+
+``PowerNorm`` no longer clips values below vmin
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+When ``clip=False`` is set (the default) on `~matplotlib.colors.PowerNorm`, values below
+``vmin`` are now linearly normalised. Previously they were clipped to zero. This fixes
+issues with the display of colorbars associated with a power norm.
+
+Image path semantics of toolmanager-based tools
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Previously, MEP22 ("toolmanager-based") Tools would try to load their icon
+(``tool.image``) relative to the current working directory, or, as a fallback, from
+Matplotlib's own image directory. Because both approaches are problematic for
+third-party tools (the end-user may change the current working directory at any time,
+and third-parties cannot add new icons in Matplotlib's image directory), this behavior
+is deprecated; instead, ``tool.image`` is now interpreted relative to the directory
+containing the source file where the ``Tool.image`` class attribute is defined.
+(Defining ``tool.image`` as an absolute path also works and is compatible with both the
+old and the new semantics.)
diff --git a/doc/api/prev_api_changes/api_changes_3.9.0/deprecations.rst b/doc/api/prev_api_changes/api_changes_3.9.0/deprecations.rst
new file mode 100644
index 000000000000..00469459d20a
--- /dev/null
+++ b/doc/api/prev_api_changes/api_changes_3.9.0/deprecations.rst
@@ -0,0 +1,93 @@
+Deprecations
+------------
+
+``plot_date``
+^^^^^^^^^^^^^
+
+Use of `~.Axes.plot_date` has been discouraged since Matplotlib 3.5 and the function is
+now formally deprecated.
+
+- ``datetime``-like data should directly be plotted using `~.Axes.plot`.
+- If you need to plot plain numeric data as :ref:`date-format` or need to set a
+  timezone, call ``ax.xaxis.axis_date`` / ``ax.yaxis.axis_date`` before `~.Axes.plot`.
+  See `.Axis.axis_date`.
+
+Legend labels for ``plot``
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Previously if a sequence was passed to the *label* parameter of `~.Axes.plot` when
+plotting a single dataset, the sequence was automatically cast to string for the legend
+label. This behavior is now deprecated and in future will error if the sequence length
+is not one (consistent with multi-dataset behavior, where the number of elements must
+match the number of datasets). To keep the old behavior, cast the sequence to string
+before passing.
+
+``boxplot`` tick labels
+^^^^^^^^^^^^^^^^^^^^^^^
+
+The parameter *labels* has been renamed to *tick_labels* for clarity and consistency
+with `~.Axes.bar`.
+
+Mixing positional and keyword arguments for ``legend`` handles and labels
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+This previously only raised a warning, but is now formally deprecated. If passing
+*handles* and *labels*, they must be passed either both positionally or both as keyword.
+
+Applying theta transforms in ``PolarTransform``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Applying theta transforms in `~matplotlib.projections.polar.PolarTransform` and
+`~matplotlib.projections.polar.InvertedPolarTransform` is deprecated, and will be
+removed in a future version of Matplotlib. This is currently the default behaviour when
+these transforms are used externally, but only takes affect when:
+
+- An axis is associated with the transform.
+- The axis has a non-zero theta offset or has theta values increasing in a clockwise
+  direction.
+
+To silence this warning and adopt future behaviour, set
+``apply_theta_transforms=False``. If you need to retain the behaviour where theta values
+are transformed, chain the ``PolarTransform`` with a `~matplotlib.transforms.Affine2D`
+transform that performs the theta shift and/or sign shift.
+
+*interval* parameter of ``TimerBase.start``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Setting the timer *interval* while starting it is deprecated. The interval can be
+specified instead in the timer constructor, or by setting the ``timer.interval``
+attribute.
+
+*nth_coord* parameter to axisartist helpers for fixed axis
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Helper APIs in `.axisartist` for generating a "fixed" axis on rectilinear axes
+(`.FixedAxisArtistHelperRectilinear`) no longer take a *nth_coord* parameter, as that
+parameter is entirely inferred from the (required) *loc* parameter and having
+inconsistent *nth_coord* and *loc* is an error.
+
+For curvilinear axes, the *nth_coord* parameter remains supported (it affects the
+*ticks*, not the axis position itself), but that parameter will become keyword-only, for
+consistency with the rectilinear case.
+
+``rcsetup.interactive_bk``, ``rcsetup.non_interactive_bk`` and ``rcsetup.all_backends``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+... are deprecated and replaced by ``matplotlib.backends.backend_registry.list_builtin``
+with the following arguments
+
+- ``matplotlib.backends.BackendFilter.INTERACTIVE``
+- ``matplotlib.backends.BackendFilter.NON_INTERACTIVE``
+- ``None``
+
+respectively.
+
+Miscellaneous deprecations
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+- ``backend_ps.get_bbox_header`` is considered an internal helper
+- ``BboxTransformToMaxOnly``; if you rely on this, please make a copy of the code
+- ``ContourLabeler.add_label_clabeltext``
+- ``TransformNode.is_bbox``; instead check the object using ``isinstance(...,
+  BboxBase)``
+- ``GridHelperCurveLinear.get_tick_iterator``
diff --git a/doc/api/next_api_changes/development/26621-ES.rst b/doc/api/prev_api_changes/api_changes_3.9.0/development.rst
similarity index 60%
rename from doc/api/next_api_changes/development/26621-ES.rst
rename to doc/api/prev_api_changes/api_changes_3.9.0/development.rst
index ff87f53b3573..c16e8e98ecc4 100644
--- a/doc/api/next_api_changes/development/26621-ES.rst
+++ b/doc/api/prev_api_changes/api_changes_3.9.0/development.rst
@@ -1,5 +1,8 @@
+Development changes
+-------------------
+
 Build system ported to Meson
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The build system of Matplotlib has been ported from setuptools to `meson-python
 <https://meson-python.readthedocs.io>`_ and `Meson <https://mesonbuild.com>`_.
@@ -26,7 +29,7 @@ Consequently, there have been a few changes for development and packaging purpos
 
    may be replaced by passing the following arguments to ``pip``::
 
-      --config-settings=setup-args="-DrcParams-backend=Agg" \
+      --config-settings=setup-args="-DrcParams-backend=Agg"
       --config-settings=setup-args="-Dsystem-qhull=true"
 
    Note that you must use ``pip`` >= 23.1 in order to pass more than one setting.
@@ -37,10 +40,45 @@ Consequently, there have been a few changes for development and packaging purpos
    <https://mesonbuild.com/Builtin-options.html#details-for-vsenv>`_ if you wish to
    change the priority of chosen compilers.
 5. Installation of test data was previously controlled by :file:`mplsetup.cfg`, but has
-   now been moved to Meson's install tags. To install test data, add the ``tests``
-   tag to the requested install (be sure to include the existing tags as below)::
+   now been moved to Meson's install tags. To install test data, add the ``tests`` tag
+   to the requested install (be sure to include the existing tags as below)::
 
       --config-settings=install-args="--tags=data,python-runtime,runtime,tests"
 6. Checking typing stubs with ``stubtest`` does not work easily with editable install.
    For the time being, we suggest using a normal (non-editable) install if you wish to
    run ``stubtest``.
+
+Increase to minimum supported versions of dependencies
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+For Matplotlib 3.9, the :ref:`minimum supported versions <dependencies>` are being
+bumped:
+
++------------+-----------------+---------------+
+| Dependency |  min in mpl3.8  | min in mpl3.9 |
++============+=================+===============+
+|   NumPy    |       1.21.0    |      1.23.0   |
++------------+-----------------+---------------+
+| setuptools |       42        |      64       |
++------------+-----------------+---------------+
+
+This is consistent with our :ref:`min_deps_policy` and `SPEC 0
+<https://scientific-python.org/specs/spec-0000/>`__.
+
+To comply with requirements of ``setuptools_scm``, the minimum version of ``setuptools``
+has been increased from 42 to 64.
+
+Extensions require C++17
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+Matplotlib now requires a compiler that supports C++17 in order to build its extensions.
+According to `SciPy's analysis
+<https://docs.scipy.org/doc/scipy/dev/toolchain.html#c-language-standards>`_, this
+should be available on all supported platforms.
+
+Windows on ARM64 support
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+Windows on ARM64 now bundles FreeType 2.6.1 instead of 2.11.1 when building from source.
+This may cause small changes to text rendering, but should become consistent with all
+other platforms.
diff --git a/doc/api/prev_api_changes/api_changes_3.9.0/removals.rst b/doc/api/prev_api_changes/api_changes_3.9.0/removals.rst
new file mode 100644
index 000000000000..b9aa03cfbf92
--- /dev/null
+++ b/doc/api/prev_api_changes/api_changes_3.9.0/removals.rst
@@ -0,0 +1,159 @@
+Removals
+--------
+
+Top-level cmap registration and access functions in ``mpl.cm``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+As part of the `multi-step refactoring of colormap registration
+<https://github.com/matplotlib/matplotlib/issues/20853>`_, the following functions have
+been removed:
+
+- ``matplotlib.cm.get_cmap``; use ``matplotlib.colormaps[name]`` instead if you have a
+  `str`.
+
+  Use `matplotlib.cm.ColormapRegistry.get_cmap` if you have a `str`, `None` or a
+  `matplotlib.colors.Colormap` object that you want to convert to a `.Colormap` object.
+- ``matplotlib.cm.register_cmap``; use `matplotlib.colormaps.register
+  <.ColormapRegistry.register>` instead.
+- ``matplotlib.cm.unregister_cmap``; use `matplotlib.colormaps.unregister
+  <.ColormapRegistry.unregister>` instead.
+- ``matplotlib.pyplot.register_cmap``; use `matplotlib.colormaps.register
+  <.ColormapRegistry.register>` instead.
+
+The `matplotlib.pyplot.get_cmap` function will stay available for backward
+compatibility.
+
+Contour labels
+^^^^^^^^^^^^^^
+
+``contour.ClabelText`` and ``ContourLabeler.set_label_props`` are removed. Use
+``Text(..., transform_rotates_text=True)`` as a replacement for
+``contour.ClabelText(...)`` and ``text.set(text=text, color=color,
+fontproperties=labeler.labelFontProps, clip_box=labeler.axes.bbox)`` as a replacement
+for the ``ContourLabeler.set_label_props(label, text, color)``.
+
+The ``labelFontProps``, ``labelFontSizeList``, and ``labelTextsList`` attributes of
+`.ContourLabeler` have been removed.  Use the ``labelTexts`` attribute and the font
+properties of the corresponding text objects instead.
+
+``num2julian``, ``julian2num`` and ``JULIAN_OFFSET``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+... of the `.dates` module are removed without replacements. These were undocumented and
+not exported.
+
+Julian dates in Matplotlib were calculated from a Julian date epoch: ``jdate = (date -
+np.datetime64(EPOCH)) / np.timedelta64(1, 'D')``.  Conversely, a Julian date was
+converted to datetime as ``date = np.timedelta64(int(jdate * 24 * 3600), 's') +
+np.datetime64(EPOCH)``. Matplotlib was using ``EPOCH='-4713-11-24T12:00'`` so that
+2000-01-01 at 12:00 is 2_451_545.0 (see https://en.wikipedia.org/wiki/Julian_day).
+
+``offsetbox`` methods
+^^^^^^^^^^^^^^^^^^^^^
+
+``offsetbox.bbox_artist`` is removed. This was just a wrapper to call
+`.patches.bbox_artist` if a flag is set in the file, so use that directly if you need
+the behavior.
+
+``OffsetBox.get_extent_offsets`` and ``OffsetBox.get_extent`` are removed; these methods
+are also removed on all subclasses of `.OffsetBox`. To get the offsetbox extents,
+instead of ``get_extent``, use `.OffsetBox.get_bbox`, which directly returns a `.Bbox`
+instance. To also get the child offsets, instead of ``get_extent_offsets``, separately
+call `~.OffsetBox.get_offset` on each children after triggering a draw.
+
+``parse_fontconfig_pattern`` raises on unknown constant names
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Previously, in a fontconfig pattern like ``DejaVu Sans:foo``, the unknown ``foo``
+constant name would be silently ignored.  This now raises an error.
+
+``tri`` submodules
+^^^^^^^^^^^^^^^^^^
+
+The ``matplotlib.tri.*`` submodules are removed.  All functionality is available in
+``matplotlib.tri`` directly and should be imported from there.
+
+Widget API
+^^^^^^^^^^
+
+- ``CheckButtons.rectangles`` and ``CheckButtons.lines`` are removed; `.CheckButtons`
+  now draws itself using `~.Axes.scatter`.
+- ``RadioButtons.circles`` is removed; `.RadioButtons` now draws itself using
+  `~.Axes.scatter`.
+- ``MultiCursor.needclear`` is removed with no replacement.
+- The unused parameter *x* to ``TextBox.begin_typing`` was a required argument, and is
+  now removed.
+
+Most arguments to widgets have been made keyword-only
+"""""""""""""""""""""""""""""""""""""""""""""""""""""
+
+Passing all but the very few first arguments positionally in the constructors of Widgets
+is now keyword-only. In general, all optional arguments are keyword-only.
+
+``Axes3D`` API
+^^^^^^^^^^^^^^
+
+- ``Axes3D.unit_cube``, ``Axes3D.tunit_cube``, and ``Axes3D.tunit_edges`` are removed
+  without replacement.
+- ``axes3d.vvec``, ``axes3d.eye``, ``axes3d.sx``, and ``axes3d.sy`` are removed without
+  replacement.
+
+Inconsistent *nth_coord* and *loc* passed to ``_FixedAxisArtistHelperBase``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The value of the *nth_coord* parameter of ``_FixedAxisArtistHelperBase`` and its
+subclasses is now inferred from the value of *loc*; passing inconsistent values (e.g.,
+requesting a "top y axis" or a "left x axis") has no more effect.
+
+Passing undefined *label_mode* to ``Grid``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+... is no longer allowed. This includes `mpl_toolkits.axes_grid1.axes_grid.Grid`,
+`mpl_toolkits.axes_grid1.axes_grid.AxesGrid`, and
+`mpl_toolkits.axes_grid1.axes_grid.ImageGrid` as well as the corresponding classes
+imported from `mpl_toolkits.axisartist.axes_grid`.
+
+Pass ``label_mode='keep'`` instead to get the previous behavior of not modifying labels.
+
+``draw_gouraud_triangle``
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+... is removed. Use `~.RendererBase.draw_gouraud_triangles` instead.
+
+A ``draw_gouraud_triangle`` call in a custom `~matplotlib.artist.Artist` can readily be
+replaced as::
+
+    self.draw_gouraud_triangles(gc, points.reshape((1, 3, 2)),
+                                colors.reshape((1, 3, 4)), trans)
+
+A `~.RendererBase.draw_gouraud_triangles` method can be implemented from an
+existing ``draw_gouraud_triangle`` method as::
+
+    transform = transform.frozen()
+    for tri, col in zip(triangles_array, colors_array):
+        self.draw_gouraud_triangle(gc, tri, col, transform)
+
+Miscellaneous removals
+^^^^^^^^^^^^^^^^^^^^^^
+
+The following items have previously been replaced, and are now removed:
+
+- *ticklabels* parameter of ``matplotlib.axis.Axis.set_ticklabels`` has been renamed to
+  *labels*.
+- ``Barbs.barbs_doc`` and ``Quiver.quiver_doc`` are removed. These are the doc-strings
+  and should not be accessible as a named class member, but as normal doc-strings would.
+- ``collections.PolyCollection.span_where`` and ``collections.BrokenBarHCollection``;
+  use ``fill_between`` instead.
+- ``Legend.legendHandles`` was undocumented and has been renamed to ``legend_handles``.
+
+The following items have been removed without replacements:
+
+- The attributes ``repeat`` of `.TimedAnimation` and subclasses and ``save_count`` of
+  `.FuncAnimation` are considered private and removed.
+- ``matplotlib.backend.backend_agg.BufferRegion.to_string``
+- ``matplotlib.backend.backend_agg.BufferRegion.to_string_argb``
+- ``matplotlib.backends.backend_ps.PsBackendHelper``
+- ``matplotlib.backends.backend_webagg.ServerThread``
+- *raw* parameter of `.GridSpecBase.get_grid_positions`
+- ``matplotlib.patches.ConnectionStyle._Base.SimpleEvent``
+- ``passthru_pt`` attribute of ``mpl_toolkits.axisartist.AxisArtistHelper``
diff --git a/doc/users/next_whats_new/3d_axis_limits.rst b/doc/users/next_whats_new/3d_axis_limits.rst
deleted file mode 100644
index b460cfdb4f73..000000000000
--- a/doc/users/next_whats_new/3d_axis_limits.rst
+++ /dev/null
@@ -1,20 +0,0 @@
-Setting 3D axis limits now set the limits exactly
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Previously, setting the limits of a 3D axis would always add a small margin to
-the limits. Limits are now set exactly by default. The newly introduced rcparam
-``axes3d.automargin`` can be used to revert to the old behavior where margin is
-automatically added.
-
-.. plot::
-    :include-source: true
-    :alt: Example of the new behavior of 3D axis limits, and how setting the rcparam reverts to the old behavior.
-
-    import matplotlib.pyplot as plt
-    fig, axs = plt.subplots(1, 2, subplot_kw={'projection': '3d'})
-
-    plt.rcParams['axes3d.automargin'] = True
-    axs[0].set(xlim=(0, 1), ylim=(0, 1), zlim=(0, 1), title='Old Behavior')
-
-    plt.rcParams['axes3d.automargin'] = False  # the default in 3.9.0
-    axs[1].set(xlim=(0, 1), ylim=(0, 1), zlim=(0, 1), title='New Behavior')
diff --git a/doc/users/next_whats_new/add_EllipseCollection_setters.rst b/doc/users/next_whats_new/add_EllipseCollection_setters.rst
deleted file mode 100644
index d3f7b3d85f15..000000000000
--- a/doc/users/next_whats_new/add_EllipseCollection_setters.rst
+++ /dev/null
@@ -1,40 +0,0 @@
-Add ``widths``, ``heights`` and ``angles`` setter to ``EllipseCollection``
---------------------------------------------------------------------------
-
-The ``widths``, ``heights`` and ``angles`` values of the `~matplotlib.collections.EllipseCollection`
-can now be changed after the collection has been created.
-
-.. plot::
-    :include-source: true
-
-    import matplotlib.pyplot as plt
-    from matplotlib.collections import EllipseCollection
-    import numpy as np
-
-    rng = np.random.default_rng(0)
-
-    widths = (2, )
-    heights = (3, )
-    angles = (45, )
-    offsets = rng.random((10, 2)) * 10
-
-    fig, ax = plt.subplots()
-
-    ec = EllipseCollection(
-        widths=widths,
-        heights=heights,
-        angles=angles,
-        offsets=offsets,
-        units='x',
-        offset_transform=ax.transData,
-        )
-
-    ax.add_collection(ec)
-    ax.set_xlim(-2, 12)
-    ax.set_ylim(-2, 12)
-
-    new_widths = rng.random((10, 2)) * 2
-    new_heights = rng.random((10, 2)) * 3
-    new_angles = rng.random((10, 2)) * 180
-
-    ec.set(widths=new_widths, heights=new_heights, angles=new_angles)
diff --git a/doc/users/next_whats_new/axis_minorticks_toggle.rst b/doc/users/next_whats_new/axis_minorticks_toggle.rst
deleted file mode 100644
index bb6545e5cb4c..000000000000
--- a/doc/users/next_whats_new/axis_minorticks_toggle.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-Toggle minorticks on Axis
-------------------------------
-
-Minor ticks on an `~matplotlib.axis.Axis` can be displayed or removed using
-`~matplotlib.axis.Axis.minorticks_on` and `~matplotlib.axis.Axis.minorticks_off`;
-e.g.: ``ax.xaxis.minorticks_on()``. See also `~matplotlib.axes.Axes.minorticks_on`.
diff --git a/doc/users/next_whats_new/backend_registry.rst b/doc/users/next_whats_new/backend_registry.rst
deleted file mode 100644
index 7632c978f9c5..000000000000
--- a/doc/users/next_whats_new/backend_registry.rst
+++ /dev/null
@@ -1,17 +0,0 @@
-BackendRegistry
-~~~~~~~~~~~~~~~
-
-New :class:`~matplotlib.backends.registry.BackendRegistry` class is the single
-source of truth for available backends. The singleton instance is
-``matplotlib.backends.backend_registry``. It is used internally by Matplotlib,
-and also IPython (and therefore Jupyter) starting with IPython 8.24.0.
-
-There are three sources of backends: built-in (source code is within the
-Matplotlib repository), explicit ``module://some.backend`` syntax (backend is
-obtained by loading the module), or via an entry point (self-registering
-backend in an external package).
-
-To obtain a list of all registered backends use:
-
-    >>> from matplotlib.backends import backend_registry
-    >>> backend_registry.list_all()
diff --git a/doc/users/next_whats_new/boxplot_legend_support.rst b/doc/users/next_whats_new/boxplot_legend_support.rst
deleted file mode 100644
index 44802960d9bb..000000000000
--- a/doc/users/next_whats_new/boxplot_legend_support.rst
+++ /dev/null
@@ -1,60 +0,0 @@
-Legend support for Boxplot
-~~~~~~~~~~~~~~~~~~~~~~~~~~
-Boxplots now support a *label* parameter to create legend entries.
-
-Legend labels can be passed as a list of strings to label multiple boxes in a single
-`.Axes.boxplot` call:
-
-
-.. plot::
-    :include-source: true
-    :alt: Example of creating 3 boxplots and assigning legend labels as a sequence.
-
-    import matplotlib.pyplot as plt
-    import numpy as np
-
-    np.random.seed(19680801)
-    fruit_weights = [
-        np.random.normal(130, 10, size=100),
-        np.random.normal(125, 20, size=100),
-        np.random.normal(120, 30, size=100),
-    ]
-    labels = ['peaches', 'oranges', 'tomatoes']
-    colors = ['peachpuff', 'orange', 'tomato']
-
-    fig, ax = plt.subplots()
-    ax.set_ylabel('fruit weight (g)')
-
-    bplot = ax.boxplot(fruit_weights,
-                       patch_artist=True,  # fill with color
-                       label=labels)
-
-    # fill with colors
-    for patch, color in zip(bplot['boxes'], colors):
-        patch.set_facecolor(color)
-
-    ax.set_xticks([])
-    ax.legend()
-
-
-Or as a single string to each individual `.Axes.boxplot`:
-
-.. plot::
-    :include-source: true
-    :alt: Example of creating 2 boxplots and assigning each legend label as a string.
-
-    import matplotlib.pyplot as plt
-    import numpy as np
-
-    fig, ax = plt.subplots()
-
-    data_A = np.random.random((100, 3))
-    data_B = np.random.random((100, 3)) + 0.2
-    pos = np.arange(3)
-
-    ax.boxplot(data_A, positions=pos - 0.2, patch_artist=True, label='Box A',
-               boxprops={'facecolor': 'steelblue'})
-    ax.boxplot(data_B, positions=pos + 0.2, patch_artist=True, label='Box B',
-               boxprops={'facecolor': 'lightblue'})
-
-    ax.legend()
diff --git a/doc/users/next_whats_new/figure_align_titles.rst b/doc/users/next_whats_new/figure_align_titles.rst
deleted file mode 100644
index 230e5f0a8990..000000000000
--- a/doc/users/next_whats_new/figure_align_titles.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-subplot titles can now be automatically aligned
------------------------------------------------
-
-Subplot axes titles can be misaligned vertically if tick labels or
-xlabels are placed at the top of one subplot. The new method on the
-`.Figure` class: `.Figure.align_titles` will now align the titles
-vertically.
diff --git a/doc/users/next_whats_new/formatter_unicode_minus.rst b/doc/users/next_whats_new/formatter_unicode_minus.rst
deleted file mode 100644
index 1b12b216240e..000000000000
--- a/doc/users/next_whats_new/formatter_unicode_minus.rst
+++ /dev/null
@@ -1,4 +0,0 @@
-``StrMethodFormatter`` now respects ``axes.unicode_minus``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-When formatting negative values, `.StrMethodFormatter` will now use unicode
-minus signs if :rc:`axes.unicode_minus` is set.
diff --git a/doc/users/next_whats_new/inset_axes.rst b/doc/users/next_whats_new/inset_axes.rst
deleted file mode 100644
index d283dfc91b30..000000000000
--- a/doc/users/next_whats_new/inset_axes.rst
+++ /dev/null
@@ -1,4 +0,0 @@
-``Axes.inset_axes`` is no longer experimental
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Axes.inset_axes is considered stable for use.
diff --git a/doc/users/next_whats_new/interpolation_stage_rc.rst b/doc/users/next_whats_new/interpolation_stage_rc.rst
deleted file mode 100644
index bd3ecc563e5d..000000000000
--- a/doc/users/next_whats_new/interpolation_stage_rc.rst
+++ /dev/null
@@ -1,4 +0,0 @@
-``image.interpolation_stage`` rcParam
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-This new rcParam controls whether image interpolation occurs in "data" space or
-in "rgba" space.
diff --git a/doc/users/next_whats_new/margin_getters.rst b/doc/users/next_whats_new/margin_getters.rst
deleted file mode 100644
index c43709a17d52..000000000000
--- a/doc/users/next_whats_new/margin_getters.rst
+++ /dev/null
@@ -1,4 +0,0 @@
-Getters for xmargin, ymargin and zmargin
-----------------------------------------
-``.Axes.get_xmargin()``, ``.Axes.get_ymargin()`` and ``.Axes3D.get_zmargin()`` methods have been added to return
-the margin values set by ``.Axes.set_xmargin()``, ``.Axes.set_ymargin()`` and ``.Axes3D.set_zmargin()``, respectively.
diff --git a/doc/users/next_whats_new/mathtext_documentation.rst b/doc/users/next_whats_new/mathtext_documentation.rst
deleted file mode 100644
index 2b7cd51b702c..000000000000
--- a/doc/users/next_whats_new/mathtext_documentation.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-``mathtext`` documentation improvements
----------------------------------------
-
-The documentation is updated to take information directly from the parser. This
-means that (almost) all supported symbols, operators etc are shown at :ref:`mathtext`.
diff --git a/doc/users/next_whats_new/mathtext_spacing.rst b/doc/users/next_whats_new/mathtext_spacing.rst
deleted file mode 100644
index 42da810c3a39..000000000000
--- a/doc/users/next_whats_new/mathtext_spacing.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-``mathtext`` spacing corrections
---------------------------------
-
-As consequence of the updated documentation, the spacing on a number of relational and
-operator symbols were classified like that and therefore will be spaced properly.
diff --git a/doc/users/next_whats_new/nonuniformimage_mousover.rst b/doc/users/next_whats_new/nonuniformimage_mousover.rst
deleted file mode 100644
index e5a7ab1bd155..000000000000
--- a/doc/users/next_whats_new/nonuniformimage_mousover.rst
+++ /dev/null
@@ -1,4 +0,0 @@
-NonUniformImage now has mouseover support
------------------------------------------
-When mousing over a `~matplotlib.image.NonUniformImage` the data values are now
-displayed.
diff --git a/doc/users/next_whats_new/pie_percent_latex.rst b/doc/users/next_whats_new/pie_percent_latex.rst
deleted file mode 100644
index 7ed547302789..000000000000
--- a/doc/users/next_whats_new/pie_percent_latex.rst
+++ /dev/null
@@ -1,11 +0,0 @@
-Percent sign in pie labels auto-escaped with ``usetex=True``
-------------------------------------------------------------
-
-It is common, with `.Axes.pie`, to specify labels that include a percent sign
-(``%``), which denotes a comment for LaTeX. When enabling LaTeX with
-:rc:`text.usetex` or passing ``textprops={"usetex": True}``, this would cause
-the percent sign to disappear.
-
-Now, the percent sign is automatically escaped (by adding a preceding
-backslash) so that it appears regardless of the ``usetex`` setting. If you have
-pre-escaped the percent sign, this will be detected, and remain as is.
diff --git a/doc/users/next_whats_new/polar-line-spans.rst b/doc/users/next_whats_new/polar-line-spans.rst
deleted file mode 100644
index 47bb382dbdbf..000000000000
--- a/doc/users/next_whats_new/polar-line-spans.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-``axhline`` and ``axhspan`` on polar axes
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-... now draw circles and circular arcs (`~.Axes.axhline`) or annuli and wedges
-(`~.Axes.axhspan`).
diff --git a/doc/users/next_whats_new/sides_violinplot.rst b/doc/users/next_whats_new/sides_violinplot.rst
deleted file mode 100644
index f1643de8e322..000000000000
--- a/doc/users/next_whats_new/sides_violinplot.rst
+++ /dev/null
@@ -1,4 +0,0 @@
-Add option to plot only one half of violin plot
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Setting the parameter *side* to 'low' or 'high' allows to only plot one half of the violin plot.
diff --git a/doc/users/next_whats_new/stackplot_hatch.rst b/doc/users/next_whats_new/stackplot_hatch.rst
deleted file mode 100644
index 8fd4ca0f81b0..000000000000
--- a/doc/users/next_whats_new/stackplot_hatch.rst
+++ /dev/null
@@ -1,27 +0,0 @@
-``hatch`` parameter for stackplot
--------------------------------------------
-
-The `~.Axes.stackplot` *hatch* parameter now accepts a list of strings describing hatching styles that will be applied sequentially to the layers in the stack:
-
-.. plot::
-    :include-source: true
-    :alt: Two charts, identified as ax1 and ax2, showing "stackplots", i.e. one-dimensional distributions of data stacked on top of one another. The first plot, ax1 has cross-hatching on all slices, having been given a single string as the "hatch" argument. The second plot, ax2 has different styles of hatching on each slice - diagonal hatching in opposite directions on the first two slices, cross-hatching on the third slice, and open circles on the fourth.
-
-    import matplotlib.pyplot as plt
-    fig, (ax1, ax2) = plt.subplots(ncols=2, figsize=(10,5))
-
-    cols = 10
-    rows = 4
-    data = (
-    np.reshape(np.arange(0, cols, 1), (1, -1)) ** 2
-    + np.reshape(np.arange(0, rows), (-1, 1))
-    + np.random.random((rows, cols))*5
-    )
-    x = range(data.shape[1])
-    ax1.stackplot(x, data, hatch="x")
-    ax2.stackplot(x, data, hatch=["//","\\","x","o"])
-
-    ax1.set_title("hatch='x'")
-    ax2.set_title("hatch=['//','\\\\','x','o']")
-
-    plt.show()
diff --git a/doc/users/next_whats_new/stdfmt-axisartist.rst b/doc/users/next_whats_new/stdfmt-axisartist.rst
deleted file mode 100644
index 9cb014413042..000000000000
--- a/doc/users/next_whats_new/stdfmt-axisartist.rst
+++ /dev/null
@@ -1,3 +0,0 @@
-``axisartist`` can now be used together with standard ``Formatters``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-... instead of being limited to axisartist-specific ones.
diff --git a/doc/users/next_whats_new/subfigure_zorder.rst b/doc/users/next_whats_new/subfigure_zorder.rst
deleted file mode 100644
index a740bbda8eb6..000000000000
--- a/doc/users/next_whats_new/subfigure_zorder.rst
+++ /dev/null
@@ -1,22 +0,0 @@
-Subfigures have now controllable zorders
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Previously, setting the zorder of a subfigure had no effect, and those were plotted on top of any figure-level artists (i.e for example on top of fig-level legends). Now, subfigures behave like any other artists, and their zorder can be controlled, with default a zorder of 0.
-
-.. plot::
-    :include-source: true
-    :alt: Example on controlling the zorder of a subfigure
-
-    import matplotlib.pyplot as plt
-    import numpy as np
-    x = np.linspace(1, 10, 10)
-    y1, y2 = x, -x
-    fig = plt.figure(constrained_layout=True)
-    subfigs = fig.subfigures(nrows=1, ncols=2)
-    for subfig in subfigs:
-        axarr = subfig.subplots(2, 1)
-        for ax in axarr.flatten():
-            (l1,) = ax.plot(x, y1, label="line1")
-            (l2,) = ax.plot(x, y2, label="line2")
-    subfigs[0].set_zorder(6)
-    l = fig.legend(handles=[l1, l2], loc="upper center", ncol=2)
diff --git a/doc/users/next_whats_new/update_arrow_patch.rst b/doc/users/next_whats_new/update_arrow_patch.rst
deleted file mode 100644
index 894090587b5d..000000000000
--- a/doc/users/next_whats_new/update_arrow_patch.rst
+++ /dev/null
@@ -1,30 +0,0 @@
-Update the position of arrow patch
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Adds a setter method that allows the user to update the position of the
-`.patches.Arrow` object without requiring a full re-draw.
-
-.. plot::
-    :include-source: true
-    :alt: Example of changing the position of the arrow with the new ``set_data`` method.
-
-    import matplotlib as mpl
-    import matplotlib.pyplot as plt
-    from matplotlib.patches import Arrow
-    import matplotlib.animation as animation
-
-    fig, ax = plt.subplots()
-    ax.set_xlim(0, 10)
-    ax.set_ylim(0, 10)
-
-    a = mpl.patches.Arrow(2, 0, 0, 10)
-    ax.add_patch(a)
-
-
-    # code for modifying the arrow
-    def update(i):
-        a.set_data(x=.5, dx=i, dy=6, width=2)
-
-
-    ani = animation.FuncAnimation(fig, update, frames=15, interval=90, blit=False)
-
-    plt.show()
diff --git a/doc/users/next_whats_new/widget_button_clear.rst b/doc/users/next_whats_new/widget_button_clear.rst
deleted file mode 100644
index 2d16cf281e7c..000000000000
--- a/doc/users/next_whats_new/widget_button_clear.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-Check and Radio Button widgets support clearing
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The `.CheckButtons` and `.RadioButtons` widgets now support clearing their
-state by calling their ``.clear`` method. Note that it is not possible to have
-no selected radio buttons, so the selected option at construction time is selected.
diff --git a/doc/users/prev_whats_new/whats_new_3.9.0.rst b/doc/users/prev_whats_new/whats_new_3.9.0.rst
new file mode 100644
index 000000000000..c111455f8ef8
--- /dev/null
+++ b/doc/users/prev_whats_new/whats_new_3.9.0.rst
@@ -0,0 +1,409 @@
+=============================================
+What's new in Matplotlib 3.9.0 (Apr 09, 2024)
+=============================================
+
+For a list of all of the issues and pull requests since the last revision, see the
+:ref:`github-stats`.
+
+.. contents:: Table of Contents
+   :depth: 4
+
+.. toctree::
+   :maxdepth: 4
+
+Plotting and Annotation improvements
+====================================
+
+``Axes.inset_axes`` is no longer experimental
+---------------------------------------------
+
+`.Axes.inset_axes` is considered stable for use.
+
+Legend support for Boxplot
+--------------------------
+
+Boxplots now support a *label* parameter to create legend entries. Legend labels can be
+passed as a list of strings to label multiple boxes in a single `.Axes.boxplot` call:
+
+.. plot::
+    :include-source:
+    :alt: Example of creating 3 boxplots and assigning legend labels as a sequence.
+
+    np.random.seed(19680801)
+    fruit_weights = [
+        np.random.normal(130, 10, size=100),
+        np.random.normal(125, 20, size=100),
+        np.random.normal(120, 30, size=100),
+    ]
+    labels = ['peaches', 'oranges', 'tomatoes']
+    colors = ['peachpuff', 'orange', 'tomato']
+
+    fig, ax = plt.subplots()
+    ax.set_ylabel('fruit weight (g)')
+
+    bplot = ax.boxplot(fruit_weights,
+                       patch_artist=True,  # fill with color
+                       label=labels)
+
+    # fill with colors
+    for patch, color in zip(bplot['boxes'], colors):
+        patch.set_facecolor(color)
+
+    ax.set_xticks([])
+    ax.legend()
+
+
+Or as a single string to each individual `.Axes.boxplot`:
+
+.. plot::
+    :include-source:
+    :alt: Example of creating 2 boxplots and assigning each legend label as a string.
+
+    fig, ax = plt.subplots()
+
+    data_A = np.random.random((100, 3))
+    data_B = np.random.random((100, 3)) + 0.2
+    pos = np.arange(3)
+
+    ax.boxplot(data_A, positions=pos - 0.2, patch_artist=True, label='Box A',
+               boxprops={'facecolor': 'steelblue'})
+    ax.boxplot(data_B, positions=pos + 0.2, patch_artist=True, label='Box B',
+               boxprops={'facecolor': 'lightblue'})
+
+    ax.legend()
+
+Percent sign in pie labels auto-escaped with ``usetex=True``
+------------------------------------------------------------
+
+It is common, with `.Axes.pie`, to specify labels that include a percent sign (``%``),
+which denotes a comment for LaTeX. When enabling LaTeX with :rc:`text.usetex` or passing
+``textprops={"usetex": True}``, this used to cause the percent sign to disappear.
+
+Now, the percent sign is automatically escaped (by adding a preceding backslash) so that
+it appears regardless of the ``usetex`` setting. If you have pre-escaped the percent
+sign, this will be detected, and remain as is.
+
+``hatch`` parameter for stackplot
+---------------------------------
+
+The `~.Axes.stackplot` *hatch* parameter now accepts a list of strings describing
+hatching styles that will be applied sequentially to the layers in the stack:
+
+.. plot::
+    :include-source:
+    :alt: Two charts, identified as ax1 and ax2, showing "stackplots", i.e. one-dimensional distributions of data stacked on top of one another. The first plot, ax1 has cross-hatching on all slices, having been given a single string as the "hatch" argument. The second plot, ax2 has different styles of hatching on each slice - diagonal hatching in opposite directions on the first two slices, cross-hatching on the third slice, and open circles on the fourth.
+
+    fig, (ax1, ax2) = plt.subplots(ncols=2, figsize=(10,5))
+
+    cols = 10
+    rows = 4
+    data = (
+    np.reshape(np.arange(0, cols, 1), (1, -1)) ** 2
+    + np.reshape(np.arange(0, rows), (-1, 1))
+    + np.random.random((rows, cols))*5
+    )
+    x = range(data.shape[1])
+    ax1.stackplot(x, data, hatch="x")
+    ax2.stackplot(x, data, hatch=["//","\\","x","o"])
+
+    ax1.set_title("hatch='x'")
+    ax2.set_title("hatch=['//','\\\\','x','o']")
+
+    plt.show()
+
+Add option to plot only one half of violin plot
+-----------------------------------------------
+
+Setting the parameter *side* to 'low' or 'high' allows to only plot one half of the
+`.Axes.violinplot`.
+
+.. plot::
+    :include-source:
+    :alt: Three copies of a vertical violin plot; first in blue showing the default of both sides, followed by an orange copy that only shows the "low" (or left, in this case) side, and finally a green copy that only shows the "high" (or right) side.
+
+    # Fake data with reproducible random state.
+    np.random.seed(19680801)
+    data = np.random.normal(0, 8, size=100)
+
+    fig, ax = plt.subplots()
+
+    ax.violinplot(data, [0], showmeans=True, showextrema=True)
+    ax.violinplot(data, [1], showmeans=True, showextrema=True, side='low')
+    ax.violinplot(data, [2], showmeans=True, showextrema=True, side='high')
+
+    ax.set_title('Violin Sides Example')
+    ax.set_xticks([0, 1, 2], ['Default', 'side="low"', 'side="high"'])
+    ax.set_yticklabels([])
+
+``axhline`` and ``axhspan`` on polar axes
+-----------------------------------------
+
+... now draw circles and circular arcs (`~.Axes.axhline`) or annuli and wedges
+(`~.Axes.axhspan`).
+
+.. plot::
+    :include-source:
+    :alt: A sample polar plot, that contains an axhline at radius 1, an axhspan annulus between radius 0.8 and 0.9, and an axhspan wedge between radius 0.6 and 0.7 and 288° and 324°.
+
+    fig = plt.figure()
+    ax = fig.add_subplot(projection="polar")
+    ax.set_rlim(0, 1.2)
+
+    ax.axhline(1, c="C0", alpha=.5)
+    ax.axhspan(.8, .9, fc="C1", alpha=.5)
+    ax.axhspan(.6, .7, .8, .9, fc="C2", alpha=.5)
+
+Subplot titles can now be automatically aligned
+-----------------------------------------------
+
+Subplot axes titles can be misaligned vertically if tick labels or xlabels are placed at
+the top of one subplot. The new `~.Figure.align_titles` method on the `.Figure` class
+will now align the titles vertically.
+
+.. plot::
+    :include-source:
+    :alt: A figure with two Axes side-by-side, the second of which with ticks on top. The Axes titles and x-labels appear unaligned with each other due to these ticks.
+
+    fig, axs = plt.subplots(1, 2, layout='constrained')
+
+    axs[0].plot(np.arange(0, 1e6, 1000))
+    axs[0].set_title('Title 0')
+    axs[0].set_xlabel('XLabel 0')
+
+    axs[1].plot(np.arange(1, 0, -0.1) * 2000, np.arange(1, 0, -0.1))
+    axs[1].set_title('Title 1')
+    axs[1].set_xlabel('XLabel 1')
+    axs[1].xaxis.tick_top()
+    axs[1].tick_params(axis='x', rotation=55)
+
+.. plot::
+    :include-source:
+    :alt: A figure with two Axes side-by-side, the second of which with ticks on top. Unlike the previous figure, the Axes titles and x-labels appear aligned.
+
+    fig, axs = plt.subplots(1, 2, layout='constrained')
+
+    axs[0].plot(np.arange(0, 1e6, 1000))
+    axs[0].set_title('Title 0')
+    axs[0].set_xlabel('XLabel 0')
+
+    axs[1].plot(np.arange(1, 0, -0.1) * 2000, np.arange(1, 0, -0.1))
+    axs[1].set_title('Title 1')
+    axs[1].set_xlabel('XLabel 1')
+    axs[1].xaxis.tick_top()
+    axs[1].tick_params(axis='x', rotation=55)
+
+    fig.align_labels()
+    fig.align_titles()
+
+``axisartist`` can now be used together with standard ``Formatters``
+--------------------------------------------------------------------
+
+... instead of being limited to axisartist-specific ones.
+
+Toggle minorticks on Axis
+-------------------------
+
+Minor ticks on an `~matplotlib.axis.Axis` can be displayed or removed using
+`~matplotlib.axis.Axis.minorticks_on` and `~matplotlib.axis.Axis.minorticks_off`; e.g.,
+``ax.xaxis.minorticks_on()``. See also `~matplotlib.axes.Axes.minorticks_on`.
+
+``StrMethodFormatter`` now respects ``axes.unicode_minus``
+----------------------------------------------------------
+
+When formatting negative values, `.StrMethodFormatter` will now use unicode minus signs
+if :rc:`axes.unicode_minus` is set.
+
+    >>> from matplotlib.ticker import StrMethodFormatter
+    >>> with plt.rc_context({'axes.unicode_minus': False}):
+    ...     formatter = StrMethodFormatter('{x}')
+    ...     print(formatter.format_data(-10))
+    -10
+
+    >>> with plt.rc_context({'axes.unicode_minus': True}):
+    ...     formatter = StrMethodFormatter('{x}')
+    ...     print(formatter.format_data(-10))
+    −10
+
+Figure, Axes, and Legend Layout
+===============================
+
+Subfigures now have controllable zorders
+----------------------------------------
+
+Previously, setting the zorder of a subfigure had no effect, and those were plotted on
+top of any figure-level artists (i.e for example on top of fig-level legends). Now,
+subfigures behave like any other artists, and their zorder can be controlled, with
+default a zorder of 0.
+
+.. plot::
+    :include-source:
+    :alt: Example on controlling the zorder of a subfigure
+
+    x = np.linspace(1, 10, 10)
+    y1, y2 = x, -x
+    fig = plt.figure(constrained_layout=True)
+    subfigs = fig.subfigures(nrows=1, ncols=2)
+    for subfig in subfigs:
+        axarr = subfig.subplots(2, 1)
+        for ax in axarr.flatten():
+            (l1,) = ax.plot(x, y1, label="line1")
+            (l2,) = ax.plot(x, y2, label="line2")
+    subfigs[0].set_zorder(6)
+    l = fig.legend(handles=[l1, l2], loc="upper center", ncol=2)
+
+Getters for xmargin, ymargin and zmargin
+----------------------------------------
+
+`.Axes.get_xmargin`, `.Axes.get_ymargin` and `.Axes3D.get_zmargin` methods have been
+added to return the margin values set by `.Axes.set_xmargin`, `.Axes.set_ymargin` and
+`.Axes3D.set_zmargin`, respectively.
+
+Mathtext improvements
+=====================
+
+``mathtext`` documentation improvements
+---------------------------------------
+
+The documentation is updated to take information directly from the parser. This means
+that (almost) all supported symbols, operators, etc. are shown at :ref:`mathtext`.
+
+``mathtext`` spacing corrections
+--------------------------------
+
+As consequence of the updated documentation, the spacing on a number of relational and
+operator symbols were correctly classified and therefore will be spaced properly.
+
+Widget Improvements
+===================
+
+Check and Radio Button widgets support clearing
+-----------------------------------------------
+
+The `.CheckButtons` and `.RadioButtons` widgets now support clearing their state by
+calling their ``.clear`` method. Note that it is not possible to have no selected radio
+buttons, so the selected option at construction time is selected.
+
+3D plotting improvements
+========================
+
+Setting 3D axis limits now set the limits exactly
+-------------------------------------------------
+
+Previously, setting the limits of a 3D axis would always add a small margin to the
+limits. Limits are now set exactly by default. The newly introduced rcparam
+``axes3d.automargin`` can be used to revert to the old behavior where margin is
+automatically added.
+
+.. plot::
+    :include-source:
+    :alt: Example of the new behavior of 3D axis limits, and how setting the rcParam reverts to the old behavior.
+
+    fig, axs = plt.subplots(1, 2, subplot_kw={'projection': '3d'})
+
+    plt.rcParams['axes3d.automargin'] = True
+    axs[0].set(xlim=(0, 1), ylim=(0, 1), zlim=(0, 1), title='Old Behavior')
+
+    plt.rcParams['axes3d.automargin'] = False  # the default in 3.9.0
+    axs[1].set(xlim=(0, 1), ylim=(0, 1), zlim=(0, 1), title='New Behavior')
+
+Other improvements
+==================
+
+BackendRegistry
+---------------
+
+New :class:`~matplotlib.backends.registry.BackendRegistry` class is the single source of
+truth for available backends. The singleton instance is
+``matplotlib.backends.backend_registry``. It is used internally by Matplotlib, and also
+IPython (and therefore Jupyter) starting with IPython 8.24.0.
+
+There are three sources of backends: built-in (source code is within the Matplotlib
+repository), explicit ``module://some.backend`` syntax (backend is obtained by loading
+the module), or via an entry point (self-registering backend in an external package).
+
+To obtain a list of all registered backends use:
+
+    >>> from matplotlib.backends import backend_registry
+    >>> backend_registry.list_all()
+
+Add ``widths``, ``heights`` and ``angles`` setter to ``EllipseCollection``
+--------------------------------------------------------------------------
+
+The ``widths``, ``heights`` and ``angles`` values of the
+`~matplotlib.collections.EllipseCollection` can now be changed after the collection has
+been created.
+
+.. plot::
+    :include-source:
+
+    from matplotlib.collections import EllipseCollection
+
+    rng = np.random.default_rng(0)
+
+    widths = (2, )
+    heights = (3, )
+    angles = (45, )
+    offsets = rng.random((10, 2)) * 10
+
+    fig, ax = plt.subplots()
+
+    ec = EllipseCollection(
+        widths=widths,
+        heights=heights,
+        angles=angles,
+        offsets=offsets,
+        units='x',
+        offset_transform=ax.transData,
+        )
+
+    ax.add_collection(ec)
+    ax.set_xlim(-2, 12)
+    ax.set_ylim(-2, 12)
+
+    new_widths = rng.random((10, 2)) * 2
+    new_heights = rng.random((10, 2)) * 3
+    new_angles = rng.random((10, 2)) * 180
+
+    ec.set(widths=new_widths, heights=new_heights, angles=new_angles)
+
+``image.interpolation_stage`` rcParam
+-------------------------------------
+
+This new rcParam controls whether image interpolation occurs in "data" space or in
+"rgba" space.
+
+Arrow patch position is now modifiable
+--------------------------------------
+
+A setter method has been added that allows updating the position of the `.patches.Arrow`
+object without requiring a full re-draw.
+
+.. plot::
+    :include-source:
+    :alt: Example of changing the position of the arrow with the new ``set_data`` method.
+
+    from matplotlib import animation
+    from matplotlib.patches import Arrow
+
+    fig, ax = plt.subplots()
+    ax.set_xlim(0, 10)
+    ax.set_ylim(0, 10)
+
+    a = Arrow(2, 0, 0, 10)
+    ax.add_patch(a)
+
+
+    # code for modifying the arrow
+    def update(i):
+        a.set_data(x=.5, dx=i, dy=6, width=2)
+
+
+    ani = animation.FuncAnimation(fig, update, frames=15, interval=90, blit=False)
+
+    plt.show()
+
+NonUniformImage now has mouseover support
+-----------------------------------------
+
+When mousing over a `~matplotlib.image.NonUniformImage`, the data values are now
+displayed.
diff --git a/doc/users/release_notes.rst b/doc/users/release_notes.rst
index 63f417e6a26d..3befbeee5b77 100644
--- a/doc/users/release_notes.rst
+++ b/doc/users/release_notes.rst
@@ -18,8 +18,8 @@ Version 3.9
 .. toctree::
     :maxdepth: 1
 
-    next_whats_new
-    ../api/next_api_changes
+    prev_whats_new/whats_new_3.9.0.rst
+    ../api/prev_api_changes/api_changes_3.9.0.rst
     github_stats.rst
 
 Version 3.8
@@ -30,7 +30,6 @@ Version 3.8
     prev_whats_new/whats_new_3.8.0.rst
     ../api/prev_api_changes/api_changes_3.8.1.rst
     ../api/prev_api_changes/api_changes_3.8.0.rst
-    github_stats.rst
     prev_whats_new/github_stats_3.8.3.rst
     prev_whats_new/github_stats_3.8.2.rst
     prev_whats_new/github_stats_3.8.1.rst

From 29e77e369d8b72f6161c1e4211256a48bd6bc19a Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Wed, 8 May 2024 16:08:47 -0500
Subject: [PATCH 0970/1120] Backport PR #28103: [DOC]: Fix compatibility with
 sphinx-gallery 0.16

---
 doc/conf.py                           | 51 +++++++++++----------------
 doc/sphinxext/gallery_order.py        |  2 +-
 doc/sphinxext/util.py                 | 21 +++++++++++
 lib/matplotlib/tests/test_doc.py      |  5 +--
 requirements/doc/doc-requirements.txt |  4 +--
 5 files changed, 48 insertions(+), 35 deletions(-)
 create mode 100644 doc/sphinxext/util.py

diff --git a/doc/conf.py b/doc/conf.py
index bc9b1ff7c1fa..c9a475aecf9c 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -22,6 +22,7 @@
 from urllib.parse import urlsplit, urlunsplit
 import warnings
 
+from packaging.version import parse as parse_version
 import sphinx
 import yaml
 
@@ -178,9 +179,20 @@ def _check_dependencies():
 
 
 # Import only after checking for dependencies.
-# gallery_order.py from the sphinxext folder provides the classes that
-# allow custom ordering of sections and subsections of the gallery
-import sphinxext.gallery_order as gallery_order
+import sphinx_gallery
+
+if parse_version(sphinx_gallery.__version__) >= parse_version('0.16.0'):
+    gallery_order_sectionorder = 'sphinxext.gallery_order.sectionorder'
+    gallery_order_subsectionorder = 'sphinxext.gallery_order.subsectionorder'
+    clear_basic_units = 'sphinxext.util.clear_basic_units'
+    matplotlib_reduced_latex_scraper = 'sphinxext.util.matplotlib_reduced_latex_scraper'
+else:
+    # gallery_order.py from the sphinxext folder provides the classes that
+    # allow custom ordering of sections and subsections of the gallery
+    from sphinxext.gallery_order import (
+        sectionorder as gallery_order_sectionorder,
+        subsectionorder as gallery_order_subsectionorder)
+    from sphinxext.util import clear_basic_units, matplotlib_reduced_latex_scraper
 
 # The following import is only necessary to monkey patch the signature later on
 from sphinx_gallery import gen_rst
@@ -228,22 +240,6 @@ def _check_dependencies():
 }
 
 
-# Sphinx gallery configuration
-
-def matplotlib_reduced_latex_scraper(block, block_vars, gallery_conf,
-                                     **kwargs):
-    """
-    Reduce srcset when creating a PDF.
-
-    Because sphinx-gallery runs *very* early, we cannot modify this even in the
-    earliest builder-inited signal. Thus we do it at scraping time.
-    """
-    from sphinx_gallery.scrapers import matplotlib_scraper
-
-    if gallery_conf['builder_name'] == 'latex':
-        gallery_conf['image_srcset'] = []
-    return matplotlib_scraper(block, block_vars, gallery_conf, **kwargs)
-
 gallery_dirs = [f'{ed}' for ed in
                 ['gallery', 'tutorials', 'plot_types', 'users/explain']
                 if f'{ed}/*' not in skip_subdirs]
@@ -254,7 +250,7 @@ def matplotlib_reduced_latex_scraper(block, block_vars, gallery_conf,
     example_dirs += [f'../galleries/{gd}']
 
 sphinx_gallery_conf = {
-    'backreferences_dir': Path('api') / Path('_as_gen'),
+    'backreferences_dir': Path('api', '_as_gen'),
     # Compression is a significant effort that we skip for local and CI builds.
     'compress_images': ('thumbnails', 'images') if is_release_build else (),
     'doc_module': ('matplotlib', 'mpl_toolkits'),
@@ -269,14 +265,10 @@ def matplotlib_reduced_latex_scraper(block, block_vars, gallery_conf,
     'plot_gallery': 'True',  # sphinx-gallery/913
     'reference_url': {'matplotlib': None},
     'remove_config_comments': True,
-    'reset_modules': (
-        'matplotlib',
-        # clear basic_units module to re-register with unit registry on import
-        lambda gallery_conf, fname: sys.modules.pop('basic_units', None)
-    ),
-    'subsection_order': gallery_order.sectionorder,
+    'reset_modules': ('matplotlib', clear_basic_units),
+    'subsection_order': gallery_order_sectionorder,
     'thumbnail_size': (320, 224),
-    'within_subsection_order': gallery_order.subsectionorder,
+    'within_subsection_order': gallery_order_subsectionorder,
     'capture_repr': (),
     'copyfile_regex': r'.*\.rst',
 }
@@ -333,7 +325,7 @@ def gallery_image_warning_filter(record):
         :class: sphx-glr-download-link-note
 
         :ref:`Go to the end <sphx_glr_download_{1}>`
-        to download the full example code{2}
+        to download the full example code.{2}
 
 .. rst-class:: sphx-glr-example-title
 
@@ -758,7 +750,6 @@ def js_tag_with_cache_busting(js):
 
 if link_github:
     import inspect
-    from packaging.version import parse
 
     extensions.append('sphinx.ext.linkcode')
 
@@ -814,7 +805,7 @@ def linkcode_resolve(domain, info):
         if not fn.startswith(('matplotlib/', 'mpl_toolkits/')):
             return None
 
-        version = parse(matplotlib.__version__)
+        version = parse_version(matplotlib.__version__)
         tag = 'main' if version.is_devrelease else f'v{version.public}'
         return ("https://github.com/matplotlib/matplotlib/blob"
                 f"/{tag}/lib/{fn}{linespec}")
diff --git a/doc/sphinxext/gallery_order.py b/doc/sphinxext/gallery_order.py
index 70a018750537..378cb394d37b 100644
--- a/doc/sphinxext/gallery_order.py
+++ b/doc/sphinxext/gallery_order.py
@@ -105,7 +105,7 @@ def __call__(self, item):
 explicit_subsection_order = [item + ".py" for item in list_all]
 
 
-class MplExplicitSubOrder:
+class MplExplicitSubOrder(ExplicitOrder):
     """For use within the 'within_subsection_order' key."""
     def __init__(self, src_dir):
         self.src_dir = src_dir  # src_dir is unused here
diff --git a/doc/sphinxext/util.py b/doc/sphinxext/util.py
new file mode 100644
index 000000000000..14097ba9396a
--- /dev/null
+++ b/doc/sphinxext/util.py
@@ -0,0 +1,21 @@
+import sys
+
+
+def matplotlib_reduced_latex_scraper(block, block_vars, gallery_conf,
+                                     **kwargs):
+    """
+    Reduce srcset when creating a PDF.
+
+    Because sphinx-gallery runs *very* early, we cannot modify this even in the
+    earliest builder-inited signal. Thus we do it at scraping time.
+    """
+    from sphinx_gallery.scrapers import matplotlib_scraper
+
+    if gallery_conf['builder_name'] == 'latex':
+        gallery_conf['image_srcset'] = []
+    return matplotlib_scraper(block, block_vars, gallery_conf, **kwargs)
+
+
+# Clear basic_units module to re-register with unit registry on import.
+def clear_basic_units(gallery_conf, fname):
+    return sys.modules.pop('basic_units', None)
diff --git a/lib/matplotlib/tests/test_doc.py b/lib/matplotlib/tests/test_doc.py
index 592a24198d1b..3e28fd1b8eb7 100644
--- a/lib/matplotlib/tests/test_doc.py
+++ b/lib/matplotlib/tests/test_doc.py
@@ -9,7 +9,8 @@ def test_sphinx_gallery_example_header():
     EXAMPLE_HEADER, this test will start to fail. In that case, please update
     the monkey-patching of EXAMPLE_HEADER in conf.py.
     """
-    gen_rst = pytest.importorskip('sphinx_gallery.gen_rst')
+    pytest.importorskip('sphinx_gallery', minversion='0.16.0')
+    from sphinx_gallery import gen_rst
 
     EXAMPLE_HEADER = """
 .. DO NOT EDIT.
@@ -24,7 +25,7 @@ def test_sphinx_gallery_example_header():
         :class: sphx-glr-download-link-note
 
         :ref:`Go to the end <sphx_glr_download_{1}>`
-        to download the full example code{2}
+        to download the full example code.{2}
 
 .. rst-class:: sphx-glr-example-title
 
diff --git a/requirements/doc/doc-requirements.txt b/requirements/doc/doc-requirements.txt
index 8f8e01a34e4d..e7fc207a739c 100644
--- a/requirements/doc/doc-requirements.txt
+++ b/requirements/doc/doc-requirements.txt
@@ -7,7 +7,7 @@
 # Install the documentation requirements with:
 #     pip install -r requirements/doc/doc-requirements.txt
 #
-sphinx>=3.0.0,!=6.1.2,!=7.3.*
+sphinx>=3.0.0,!=6.1.2
 colorspacious
 ipython
 ipywidgets
@@ -18,7 +18,7 @@ pydata-sphinx-theme~=0.15.0
 mpl-sphinx-theme~=3.8.0
 pyyaml
 sphinxcontrib-svg2pdfconverter>=1.1.0
-sphinx-gallery>=0.12.0
 sphinx-copybutton
 sphinx-design
+sphinx-gallery>=0.12.0
 sphinx-tags>=0.3.0

From 4d4c8e35c98daabb8276a32e88f1478ffab4b9af Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Thu, 9 May 2024 03:12:49 +0200
Subject: [PATCH 0971/1120] Backport PR #28185: DOC: Bump mpl-sphinx-theme to
 3.9

---
 requirements/doc/doc-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements/doc/doc-requirements.txt b/requirements/doc/doc-requirements.txt
index 8f8e01a34e4d..b3ab5e4858bf 100644
--- a/requirements/doc/doc-requirements.txt
+++ b/requirements/doc/doc-requirements.txt
@@ -15,7 +15,7 @@ ipykernel
 numpydoc>=1.0
 packaging>=20
 pydata-sphinx-theme~=0.15.0
-mpl-sphinx-theme~=3.8.0
+mpl-sphinx-theme~=3.9.0
 pyyaml
 sphinxcontrib-svg2pdfconverter>=1.1.0
 sphinx-gallery>=0.12.0

From ae5f9c16fe5cfeb9614822b9c8bfd8202ad3b193 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Thu, 9 May 2024 03:14:58 +0200
Subject: [PATCH 0972/1120] Backport PR #28188: [TST] Bump some tolerances for
 Macos ARM

---
 lib/matplotlib/tests/test_axes.py             | 2 +-
 lib/matplotlib/tests/test_lines.py            | 2 +-
 lib/matplotlib/tests/test_patheffects.py      | 2 +-
 lib/mpl_toolkits/mplot3d/tests/test_axes3d.py | 5 +++--
 4 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index 819f4eb3b598..0ed5a11c1398 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -5829,7 +5829,7 @@ def test_pie_linewidth_0():
     plt.axis('equal')
 
 
-@image_comparison(['pie_center_radius.png'], style='mpl20', tol=0.007)
+@image_comparison(['pie_center_radius.png'], style='mpl20', tol=0.01)
 def test_pie_center_radius():
     # The slices will be ordered and plotted counter-clockwise.
     labels = 'Frogs', 'Hogs', 'Dogs', 'Logs'
diff --git a/lib/matplotlib/tests/test_lines.py b/lib/matplotlib/tests/test_lines.py
index c7b7353fa0db..531237b2ba28 100644
--- a/lib/matplotlib/tests/test_lines.py
+++ b/lib/matplotlib/tests/test_lines.py
@@ -185,7 +185,7 @@ def test_set_drawstyle():
 
 @image_comparison(
     ['line_collection_dashes'], remove_text=True, style='mpl20',
-    tol=0.65 if platform.machine() in ('aarch64', 'ppc64le', 's390x') else 0)
+    tol=0 if platform.machine() == 'x86_64' else 0.65)
 def test_set_line_coll_dash_image():
     fig, ax = plt.subplots()
     np.random.seed(0)
diff --git a/lib/matplotlib/tests/test_patheffects.py b/lib/matplotlib/tests/test_patheffects.py
index 7c4c82751240..bf067b2abbfd 100644
--- a/lib/matplotlib/tests/test_patheffects.py
+++ b/lib/matplotlib/tests/test_patheffects.py
@@ -30,7 +30,7 @@ def test_patheffect1():
 
 
 @image_comparison(['patheffect2'], remove_text=True, style='mpl20',
-                  tol=0.052 if platform.machine() == 'arm64' else 0)
+                  tol=0.06 if platform.machine() == 'arm64' else 0)
 def test_patheffect2():
 
     ax2 = plt.subplot()
diff --git a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
index 731b0413bf65..ed56e5505d8e 100644
--- a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
@@ -113,7 +113,8 @@ def test_axes3d_repr():
         "title={'center': 'title'}, xlabel='x', ylabel='y', zlabel='z'>")
 
 
-@mpl3d_image_comparison(['axes3d_primary_views.png'], style='mpl20')
+@mpl3d_image_comparison(['axes3d_primary_views.png'], style='mpl20',
+                        tol=0.05 if platform.machine() == "arm64" else 0)
 def test_axes3d_primary_views():
     # (elev, azim, roll)
     views = [(90, -90, 0),  # XY
@@ -1589,7 +1590,7 @@ def test_errorbar3d_errorevery():
 
 
 @mpl3d_image_comparison(['errorbar3d.png'], style='mpl20',
-                        tol=0.014 if platform.machine() == 'arm64' else 0)
+                        tol=0.02 if platform.machine() == 'arm64' else 0)
 def test_errorbar3d():
     """Tests limits, color styling, and legend for 3D errorbars."""
     fig = plt.figure()

From 065a188aeb4702eee67b111cbe18d59bbb84de8b Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 8 May 2024 17:08:54 -0400
Subject: [PATCH 0973/1120] DOC: Use released mpl-sphinx-theme on v3.9.x

---
 .circleci/config.yml | 2 --
 1 file changed, 2 deletions(-)

diff --git a/.circleci/config.yml b/.circleci/config.yml
index 1ab22d302314..eef9ca87f30d 100644
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -107,8 +107,6 @@ commands:
             python -m pip install --user \
                 numpy<< parameters.numpy_version >> \
                 -r requirements/doc/doc-requirements.txt
-            python -m pip install --no-deps --user \
-                git+https://github.com/matplotlib/mpl-sphinx-theme.git
 
   mpl-install:
     steps:

From 1b526c3286becf1e7fdfe9291d437aa19c8f3bb5 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Thu, 9 May 2024 13:29:38 -0500
Subject: [PATCH 0974/1120] Backport PR #28164: CI: Ensure code coverage is
 always uploaded

---
 .github/workflows/cygwin.yml | 7 +------
 .github/workflows/tests.yml  | 3 ++-
 azure-pipelines.yml          | 2 ++
 3 files changed, 5 insertions(+), 7 deletions(-)

diff --git a/.github/workflows/cygwin.yml b/.github/workflows/cygwin.yml
index 3e2a6144dece..58c132315b6f 100644
--- a/.github/workflows/cygwin.yml
+++ b/.github/workflows/cygwin.yml
@@ -245,9 +245,4 @@ jobs:
         run: |
           xvfb-run pytest-3.${{ matrix.python-minor-version }} -rfEsXR -n auto \
             --maxfail=50 --timeout=300 --durations=25 \
-            --cov-report=xml --cov=lib --log-level=DEBUG --color=yes
-
-      - name: Upload code coverage
-        uses: codecov/codecov-action@v4
-        with:
-          token: ${{ secrets.CODECOV_TOKEN }}
+            --cov-report=term --cov=lib --log-level=DEBUG --color=yes
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 13f6e8352d73..a24f8cdc2f5b 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -316,6 +316,7 @@ jobs:
             --cov-report=xml --cov=lib --log-level=DEBUG --color=yes
 
       - name: Filter C coverage
+        if: ${{ !cancelled() && github.event_name != 'schedule' }}
         run: |
           if [[ "${{ runner.os }}" != 'macOS' ]]; then
             lcov --rc lcov_branch_coverage=1 --capture --directory . \
@@ -331,7 +332,7 @@ jobs:
               -instr-profile default.profdata > info.lcov
           fi
       - name: Upload code coverage
-        if: ${{ github.event_name != 'schedule' }}
+        if: ${{ !cancelled() && github.event_name != 'schedule' }}
         uses: codecov/codecov-action@v4
         with:
           name: "${{ matrix.python-version }} ${{ matrix.os }} ${{ matrix.name-suffix }}"
diff --git a/azure-pipelines.yml b/azure-pipelines.yml
index 2ad9a7821b5c..bf055d0eaa16 100644
--- a/azure-pipelines.yml
+++ b/azure-pipelines.yml
@@ -268,11 +268,13 @@ stages:
                 ;;
               esac
             displayName: 'Filter C coverage'
+            condition: succeededOrFailed()
           - bash: |
               bash <(curl -s https://codecov.io/bash) \
                 -n "$PYTHON_VERSION $AGENT_OS" \
                 -f 'coverage.xml' -f 'extensions.xml'
             displayName: 'Upload to codecov.io'
+            condition: succeededOrFailed()
 
           - task: PublishTestResults@2
             inputs:

From 3b65546e92166b9ed5b4e026f6bec08234a38eb5 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Thu, 9 May 2024 16:45:58 -0400
Subject: [PATCH 0975/1120] Backport PR #28195: TST: Prepare for pytest 9

---
 lib/matplotlib/tests/test_backend_bases.py | 6 +++---
 lib/matplotlib/tests/test_backend_gtk3.py  | 3 ---
 lib/matplotlib/tests/test_backend_qt.py    | 4 +---
 3 files changed, 4 insertions(+), 9 deletions(-)

diff --git a/lib/matplotlib/tests/test_backend_bases.py b/lib/matplotlib/tests/test_backend_bases.py
index c264f01acdb2..3a49f0ec08ec 100644
--- a/lib/matplotlib/tests/test_backend_bases.py
+++ b/lib/matplotlib/tests/test_backend_bases.py
@@ -1,3 +1,5 @@
+import importlib
+
 from matplotlib import path, transforms
 from matplotlib.backend_bases import (
     FigureCanvasBase, KeyEvent, LocationEvent, MouseButton, MouseEvent,
@@ -325,9 +327,7 @@ def test_toolbar_home_restores_autoscale():
 def test_draw(backend):
     from matplotlib.figure import Figure
     from matplotlib.backends.backend_agg import FigureCanvas
-    test_backend = pytest.importorskip(
-        f'matplotlib.backends.backend_{backend}'
-    )
+    test_backend = importlib.import_module(f'matplotlib.backends.backend_{backend}')
     TestCanvas = test_backend.FigureCanvas
     fig_test = Figure(constrained_layout=True)
     TestCanvas(fig_test)
diff --git a/lib/matplotlib/tests/test_backend_gtk3.py b/lib/matplotlib/tests/test_backend_gtk3.py
index 6a95f47e1ddd..d7fa4329cfc8 100644
--- a/lib/matplotlib/tests/test_backend_gtk3.py
+++ b/lib/matplotlib/tests/test_backend_gtk3.py
@@ -3,9 +3,6 @@
 import pytest
 
 
-pytest.importorskip("matplotlib.backends.backend_gtk3agg")
-
-
 @pytest.mark.backend("gtk3agg", skip_on_importerror=True)
 def test_correct_key():
     pytest.xfail("test_widget_send_event is not triggering key_press_event")
diff --git a/lib/matplotlib/tests/test_backend_qt.py b/lib/matplotlib/tests/test_backend_qt.py
index 026a49b1441e..a105b88c7449 100644
--- a/lib/matplotlib/tests/test_backend_qt.py
+++ b/lib/matplotlib/tests/test_backend_qt.py
@@ -26,9 +26,7 @@
 
 @pytest.fixture
 def qt_core(request):
-    qt_compat = pytest.importorskip('matplotlib.backends.qt_compat')
-    QtCore = qt_compat.QtCore
-
+    from matplotlib.backends.qt_compat import QtCore
     return QtCore
 
 

From d8f301644fa839c0f0ae2a438d42dbc55b4dc223 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Fri, 10 May 2024 14:04:38 -0400
Subject: [PATCH 0976/1120] Backport PR #28205: TST: Fix tests with older
 versions of ipython

---
 .github/workflows/tests.yml                 |  2 +-
 lib/matplotlib/testing/__init__.py          | 18 +++++++-----------
 lib/matplotlib/testing/__init__.pyi         |  3 +--
 lib/matplotlib/tests/test_backend_macosx.py |  2 +-
 lib/matplotlib/tests/test_backend_qt.py     |  2 +-
 5 files changed, 11 insertions(+), 16 deletions(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index a24f8cdc2f5b..126693beafa7 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -60,7 +60,7 @@ jobs:
           - os: ubuntu-20.04
             python-version: 3.9
             # One CI run tests ipython/matplotlib-inline before backend mapping moved to mpl
-            extra-requirements: '-r requirements/testing/extra.txt "ipython<8.24" "matplotlib-inline<0.1.7"'
+            extra-requirements: '-r requirements/testing/extra.txt "ipython==7.19" "matplotlib-inline<0.1.7"'
             CFLAGS: "-fno-lto"  # Ensure that disabling LTO works.
             # https://github.com/matplotlib/matplotlib/pull/26052#issuecomment-1574595954
             # https://www.riverbankcomputing.com/pipermail/pyqt/2023-November/045606.html
diff --git a/lib/matplotlib/testing/__init__.py b/lib/matplotlib/testing/__init__.py
index 779149dec2dc..c3af36230d4b 100644
--- a/lib/matplotlib/testing/__init__.py
+++ b/lib/matplotlib/testing/__init__.py
@@ -179,11 +179,7 @@ def _has_tex_package(package):
         return False
 
 
-def ipython_in_subprocess(
-    requested_backend_or_gui_framework,
-    expected_backend_old_ipython,  # IPython < 8.24
-    expected_backend_new_ipython,  # IPython >= 8.24
-):
+def ipython_in_subprocess(requested_backend_or_gui_framework, all_expected_backends):
     import pytest
     IPython = pytest.importorskip("IPython")
 
@@ -194,12 +190,12 @@ def ipython_in_subprocess(
             requested_backend_or_gui_framework == "osx"):
         pytest.skip("Bug using macosx backend in IPython 8.24.0 fixed in 8.24.1")
 
-    if IPython.version_info[:2] >= (8, 24):
-        expected_backend = expected_backend_new_ipython
-    else:
-        # This code can be removed when Python 3.12, the latest version supported by
-        # IPython < 8.24, reaches end-of-life in late 2028.
-        expected_backend = expected_backend_old_ipython
+    # This code can be removed when Python 3.12, the latest version supported
+    # by IPython < 8.24, reaches end-of-life in late 2028.
+    for min_version, backend in all_expected_backends.items():
+        if IPython.version_info[:2] >= min_version:
+            expected_backend = backend
+            break
 
     code = ("import matplotlib as mpl, matplotlib.pyplot as plt;"
             "fig, ax=plt.subplots(); ax.plot([1, 3, 2]); mpl.get_backend()")
diff --git a/lib/matplotlib/testing/__init__.pyi b/lib/matplotlib/testing/__init__.pyi
index b0399476b6aa..1f52a8ccb8ee 100644
--- a/lib/matplotlib/testing/__init__.pyi
+++ b/lib/matplotlib/testing/__init__.pyi
@@ -49,6 +49,5 @@ def _check_for_pgf(texsystem: str) -> bool: ...
 def _has_tex_package(package: str) -> bool: ...
 def ipython_in_subprocess(
     requested_backend_or_gui_framework: str,
-    expected_backend_old_ipython: str,
-    expected_backend_new_ipython: str,
+    all_expected_backends: dict[tuple[int, int], str],
 ) -> None: ...
diff --git a/lib/matplotlib/tests/test_backend_macosx.py b/lib/matplotlib/tests/test_backend_macosx.py
index a4350fe3b6c6..3041bda9f423 100644
--- a/lib/matplotlib/tests/test_backend_macosx.py
+++ b/lib/matplotlib/tests/test_backend_macosx.py
@@ -48,4 +48,4 @@ def new_choose_save_file(title, directory, filename):
 
 def test_ipython():
     from matplotlib.testing import ipython_in_subprocess
-    ipython_in_subprocess("osx", "MacOSX", "macosx")
+    ipython_in_subprocess("osx", {(8, 24): "macosx", (7, 0): "MacOSX"})
diff --git a/lib/matplotlib/tests/test_backend_qt.py b/lib/matplotlib/tests/test_backend_qt.py
index a105b88c7449..12d3238e0af4 100644
--- a/lib/matplotlib/tests/test_backend_qt.py
+++ b/lib/matplotlib/tests/test_backend_qt.py
@@ -376,4 +376,4 @@ def custom_handler(signum, frame):
 
 def test_ipython():
     from matplotlib.testing import ipython_in_subprocess
-    ipython_in_subprocess("qt", "QtAgg", "qtagg")
+    ipython_in_subprocess("qt", {(8, 24): "qtagg", (8, 15): "QtAgg", (7, 0): "Qt5Agg"})

From 196c8db2074c9a3d91a9e144c21f7ef204905988 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 10 May 2024 14:18:56 -0400
Subject: [PATCH 0977/1120] TST: Followup corrections to #28205

Make the changes suggested by @ianthomas23, and also mark the ipython
tests as using their backend. While the backend is already checked for
availability at the top of the respective files, that only checks
whether it can be imported, not whether it can be set as the Matplotlib
backend. Adding the marker causes our pytest configuration to actually
check and skip the test if unavailable (e.g., on Linux without
`(WAYLAND_)DISPLAY` set fails to set an interactive backend).
---
 lib/matplotlib/testing/__init__.py          | 2 +-
 lib/matplotlib/tests/test_backend_inline.py | 2 ++
 lib/matplotlib/tests/test_backend_macosx.py | 1 +
 lib/matplotlib/tests/test_backend_qt.py     | 1 +
 4 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/testing/__init__.py b/lib/matplotlib/testing/__init__.py
index c3af36230d4b..8e60267ed608 100644
--- a/lib/matplotlib/testing/__init__.py
+++ b/lib/matplotlib/testing/__init__.py
@@ -210,4 +210,4 @@ def ipython_in_subprocess(requested_backend_or_gui_framework, all_expected_backe
         capture_output=True,
     )
 
-    assert proc.stdout.strip() == f"Out[1]: '{expected_backend}'"
+    assert proc.stdout.strip().endswith(f"'{expected_backend}'")
diff --git a/lib/matplotlib/tests/test_backend_inline.py b/lib/matplotlib/tests/test_backend_inline.py
index 6f0d67d51756..4112eb213e2c 100644
--- a/lib/matplotlib/tests/test_backend_inline.py
+++ b/lib/matplotlib/tests/test_backend_inline.py
@@ -1,6 +1,7 @@
 import os
 from pathlib import Path
 from tempfile import TemporaryDirectory
+import sys
 
 import pytest
 
@@ -12,6 +13,7 @@
 pytest.importorskip('matplotlib_inline')
 
 
+@pytest.mark.skipif(sys.version_info[:2] <= (3, 9), reason="Requires Python 3.10+")
 def test_ipynb():
     nb_path = Path(__file__).parent / 'test_inline_01.ipynb'
 
diff --git a/lib/matplotlib/tests/test_backend_macosx.py b/lib/matplotlib/tests/test_backend_macosx.py
index 3041bda9f423..7431481de8ae 100644
--- a/lib/matplotlib/tests/test_backend_macosx.py
+++ b/lib/matplotlib/tests/test_backend_macosx.py
@@ -46,6 +46,7 @@ def new_choose_save_file(title, directory, filename):
         assert mpl.rcParams["savefig.directory"] == f"{tmp_path}/test"
 
 
+@pytest.mark.backend('macosx')
 def test_ipython():
     from matplotlib.testing import ipython_in_subprocess
     ipython_in_subprocess("osx", {(8, 24): "macosx", (7, 0): "MacOSX"})
diff --git a/lib/matplotlib/tests/test_backend_qt.py b/lib/matplotlib/tests/test_backend_qt.py
index 12d3238e0af4..5eb1ea77554d 100644
--- a/lib/matplotlib/tests/test_backend_qt.py
+++ b/lib/matplotlib/tests/test_backend_qt.py
@@ -374,6 +374,7 @@ def custom_handler(signum, frame):
         signal.signal(signal.SIGINT, original_handler)
 
 
+@pytest.mark.backend('QtAgg', skip_on_importerror=True)
 def test_ipython():
     from matplotlib.testing import ipython_in_subprocess
     ipython_in_subprocess("qt", {(8, 24): "qtagg", (8, 15): "QtAgg", (7, 0): "Qt5Agg"})

From 846ce8a4889b7cc4e755de5af0d041a742be7282 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 15 May 2024 15:06:02 -0400
Subject: [PATCH 0978/1120] DOC: Finish documentation for 3.9.0

---
 SECURITY.md                                  |  3 +-
 doc/_static/switcher.json                    |  6 +-
 doc/users/github_stats.rst                   | 85 ++++++++++++++++++--
 doc/users/prev_whats_new/whats_new_3.9.0.rst |  2 +-
 4 files changed, 85 insertions(+), 11 deletions(-)

diff --git a/SECURITY.md b/SECURITY.md
index 88d523bec637..ce022ca60a0f 100644
--- a/SECURITY.md
+++ b/SECURITY.md
@@ -8,8 +8,9 @@ versions.
 
 | Version | Supported          |
 | ------- | ------------------ |
+| 3.9.x   | :white_check_mark: |
 | 3.8.x   | :white_check_mark: |
-| 3.7.x   | :white_check_mark: |
+| 3.7.x   | :x:                |
 | 3.6.x   | :x:                |
 | 3.5.x   | :x:                |
 | 3.4.x   | :x:                |
diff --git a/doc/_static/switcher.json b/doc/_static/switcher.json
index b49e478f28e4..6996d79bc22a 100644
--- a/doc/_static/switcher.json
+++ b/doc/_static/switcher.json
@@ -1,8 +1,8 @@
 [
     {
-        "name": "3.9 (rc)",
-        "version": "rc",
-        "url": "https://matplotlib.org/3.9.0/"
+        "name": "3.9 (stable)",
+        "version": "stable",
+        "url": "https://matplotlib.org/stable/"
     },
     {
         "name": "3.10 (dev)",
diff --git a/doc/users/github_stats.rst b/doc/users/github_stats.rst
index 794798a3b59d..a7f909b30cf5 100644
--- a/doc/users/github_stats.rst
+++ b/doc/users/github_stats.rst
@@ -1,16 +1,16 @@
 .. _github-stats:
 
-GitHub statistics for 3.9.0 (Apr 09, 2024)
+GitHub statistics for 3.9.0 (May 15, 2024)
 ==========================================
 
-GitHub statistics for 2023/09/15 (tag: v3.8.0) - 2024/04/09
+GitHub statistics for 2023/09/15 (tag: v3.8.0) - 2024/05/15
 
 These lists are automatically generated, and may be incomplete or contain duplicates.
 
-We closed 86 issues and merged 393 pull requests.
+We closed 97 issues and merged 450 pull requests.
 The full list can be seen `on GitHub <https://github.com/matplotlib/matplotlib/milestone/78?closed=1>`__
 
-The following 170 authors contributed 2496 commits.
+The following 175 authors contributed 2584 commits.
 
 * 0taj
 * Abdul Razak Taha
@@ -67,6 +67,7 @@ The following 170 authors contributed 2496 commits.
 * Eva Sibinga
 * Evgenii Radchenko
 * Faisal Fawad
+* Felipe Cybis Pereira
 * Garrett Sward
 * Gaurav-Kumar-Soni
 * Gauri Chaudhari
@@ -81,6 +82,7 @@ The following 170 authors contributed 2496 commits.
 * Ian Hunt-Isaak
 * Ian Thomas
 * ifEricReturnTrue
+* Illviljan
 * Issam
 * Issam Arabi
 * Jacob Stevens-Haas
@@ -124,6 +126,7 @@ The following 170 authors contributed 2496 commits.
 * Mostafa Noah
 * MostafaNouh0011
 * n-aswin
+* Nabil
 * nbarlowATI
 * Nidaa Rabah
 * Nivedita Chaudhari
@@ -132,6 +135,7 @@ The following 170 authors contributed 2496 commits.
 * Pavel Liavonau
 * Pedro
 * Pedro Peçanha
+* Peter Talley
 * Pradeep Reddy Raamana
 * Prajwal Agrawal
 * Pranav Raghu
@@ -166,6 +170,7 @@ The following 170 authors contributed 2496 commits.
 * Talha Irfan
 * thehappycheese
 * Thomas A Caswell
+* Tiago Lubiana
 * Tim Hoffmann
 * tobias
 * Tom Sarantis
@@ -185,8 +190,65 @@ The following 170 authors contributed 2496 commits.
 
 GitHub issues and pull requests:
 
-Pull Requests (393):
+Pull Requests (450):
 
+* :ghpull:`28206`: Backport PR #28205 on branch v3.9.x (TST: Fix tests with older versions of ipython)
+* :ghpull:`28207`: TST: Followup corrections to #28205
+* :ghpull:`28205`: TST: Fix tests with older versions of ipython
+* :ghpull:`28203`: Backport PR #28164 on branch v3.9.x (CI: Ensure code coverage is always uploaded)
+* :ghpull:`28204`: Backport PR #28195 on branch v3.9.x (TST: Prepare for pytest 9)
+* :ghpull:`28191`: DOC: Use released mpl-sphinx-theme on v3.9.x
+* :ghpull:`28195`: TST: Prepare for pytest 9
+* :ghpull:`28193`: Backport PR #28185 on branch v3.9.x (DOC: Bump mpl-sphinx-theme to 3.9)
+* :ghpull:`28190`: Backport PR #28103 on branch v3.9.x ([DOC]: Fix compatibility with sphinx-gallery 0.16)
+* :ghpull:`28164`: CI: Ensure code coverage is always uploaded
+* :ghpull:`28194`: Backport PR #28188 on branch v3.9.x ([TST] Bump some tolerances for Macos ARM)
+* :ghpull:`28188`: [TST] Bump some tolerances for Macos ARM
+* :ghpull:`28185`: DOC: Bump mpl-sphinx-theme to 3.9
+* :ghpull:`28189`: Backport PR #28181 on branch v3.9.x (DOC: Prepare release notes for 3.9)
+* :ghpull:`28103`: [DOC]: Fix compatibility with sphinx-gallery 0.16
+* :ghpull:`28181`: DOC: Prepare release notes for 3.9
+* :ghpull:`28184`: Backport PR #28182 on branch v3.9.x (Bump custom hatch deprecation expiration)
+* :ghpull:`28182`: Bump custom hatch deprecation expiration
+* :ghpull:`28178`: Backport PR #28171 on branch v3.9.x (Support removing absent tools from ToolContainerBase.)
+* :ghpull:`28171`: Support removing absent tools from ToolContainerBase.
+* :ghpull:`28174`: Backport PR #28169 on branch v3.9.x (Clarify public-ness of some ToolContainerBase APIs.)
+* :ghpull:`28169`: Clarify public-ness of some ToolContainerBase APIs.
+* :ghpull:`28160`: Backport PR #28039 on branch v3.9.x (Respect vertical_axis when rotating plot interactively)
+* :ghpull:`28159`: Backport PR #28157 on branch v3.9.x (Remove call to non-existent method _default_contains in Artist)
+* :ghpull:`28162`: Backport PR #27948 on branch v3.9.x (Move IPython backend mapping to Matplotlib and support entry points)
+* :ghpull:`28163`: Backport PR #28144 on branch v3.9.x (DOC: Refactor code in the fishbone diagram example)
+* :ghpull:`28144`: DOC: Refactor code in the fishbone diagram example
+* :ghpull:`27948`: Move IPython backend mapping to Matplotlib and support entry points
+* :ghpull:`28039`: Respect vertical_axis when rotating plot interactively
+* :ghpull:`28157`: Remove call to non-existent method _default_contains in Artist
+* :ghpull:`28141`: Backport PR #27960 on branch v3.9.x (Update AppVeyor config)
+* :ghpull:`28138`: Backport PR #28068 on branch v3.9.x ([TYP] Add possible type hint to ``colors`` argument in ``LinearSegmentedColormap.from_list``)
+* :ghpull:`28140`: Backport PR #28136 on branch v3.9.x (Appease pycodestyle.)
+* :ghpull:`27960`: Update AppVeyor config
+* :ghpull:`28068`: [TYP] Add possible type hint to ``colors`` argument in ``LinearSegmentedColormap.from_list``
+* :ghpull:`28136`: Appease pycodestyle.
+* :ghpull:`28135`: Backport PR #28134 on branch v3.9.x (DOC: Minor improvements on quickstart)
+* :ghpull:`28134`: DOC: Minor improvements on quickstart
+* :ghpull:`28121`: Backport PR #28085 on branch v3.9.x (Clarify that the pgf backend is never actually used interactively.)
+* :ghpull:`28120`: Backport PR #28102 on branch v3.9.x (Fix typo in color mapping documentation in quick_start.py)
+* :ghpull:`28109`: Backport PR #28100 on branch v3.9.x (TST: wxcairo sometimes raises OSError on missing cairo libraries)
+* :ghpull:`28100`: TST: wxcairo sometimes raises OSError on missing cairo libraries
+* :ghpull:`28108`: Backport PR #28107 on branch v3.9.x ([DOC] Fix description in CapStyle example)
+* :ghpull:`28107`: [DOC] Fix description in CapStyle example
+* :ghpull:`28102`: Fix typo in color mapping documentation in quick_start.py
+* :ghpull:`28095`: Backport PR #28094 on branch v3.9.x (DOC: exclude sphinx 7.3.*)
+* :ghpull:`28081`: Backport PR #28078 on branch v3.9.x (Clarify that findfont & _find_fonts_by_props return paths.)
+* :ghpull:`28080`: Backport PR #28077 on branch v3.9.x (Parent tk StringVar to the canvas widget, not to the toolbar.)
+* :ghpull:`28092`: Backport PR #28032 on branch v3.9.x (FIX: ensure images are C order before passing to pillow)
+* :ghpull:`28032`: FIX: ensure images are C order before passing to pillow
+* :ghpull:`28088`: Backport PR #28087 on branch v3.9.x (Document Qt5 minimal version.)
+* :ghpull:`28085`: Clarify that the pgf backend is never actually used interactively.
+* :ghpull:`28078`: Clarify that findfont & _find_fonts_by_props return paths.
+* :ghpull:`28077`: Parent tk StringVar to the canvas widget, not to the toolbar.
+* :ghpull:`28062`: Backport PR #28056 on branch v3.9.x (Strip trailing spaces from log-formatter cursor output.)
+* :ghpull:`28063`: Backport PR #28055 on branch v3.9.x (DOC: Improve inverted axis example)
+* :ghpull:`28056`: Strip trailing spaces from log-formatter cursor output.
 * :ghpull:`28049`: Backport PR #28036 on branch v3.9.x (BLD: Fetch version from setuptools_scm at build time)
 * :ghpull:`28036`: BLD: Fetch version from setuptools_scm at build time
 * :ghpull:`28038`: Backport PR #28023 on branch v3.9.x (ci: Update merge conflict labeler)
@@ -581,8 +643,19 @@ Pull Requests (393):
 * :ghpull:`26482`: [DOC]: print pydata sphinx/mpl theme versions
 * :ghpull:`23787`: Use pybind11 for C/C++ extensions
 
-Issues (86):
+Issues (97):
 
+* :ghissue:`28202`: [Bug]: Qt test_ipython fails on older ipython
+* :ghissue:`28145`: [TST] Upcoming dependency test failures
+* :ghissue:`28034`: [TST] Upcoming dependency test failures
+* :ghissue:`28168`: [TST] Upcoming dependency test failures
+* :ghissue:`28040`: [Bug]: vertical_axis not respected when rotating plots interactively
+* :ghissue:`28146`: [Bug]: Useless recursive group in SVG output when using path_effects
+* :ghissue:`28067`: [Bug]: ``LinearSegmentedColormap.from_list`` does not have all type hints for argument ``colors``
+* :ghissue:`26778`: [MNT]: Numpy 2.0 support strategy
+* :ghissue:`28020`: [Bug]: imsave fails on RGBA data when origin is set to lower
+* :ghissue:`7720`: WXAgg backend not rendering nicely on retina
+* :ghissue:`28069`: [Bug]: Cant save with custom toolbar
 * :ghissue:`28005`: [Doc]: Improve contribute instructions
 * :ghissue:`22376`: [ENH]: align_titles
 * :ghissue:`5506`: Confusing status bar values in presence of multiple axes
diff --git a/doc/users/prev_whats_new/whats_new_3.9.0.rst b/doc/users/prev_whats_new/whats_new_3.9.0.rst
index c111455f8ef8..e0190cca3f27 100644
--- a/doc/users/prev_whats_new/whats_new_3.9.0.rst
+++ b/doc/users/prev_whats_new/whats_new_3.9.0.rst
@@ -1,5 +1,5 @@
 =============================================
-What's new in Matplotlib 3.9.0 (Apr 09, 2024)
+What's new in Matplotlib 3.9.0 (May 15, 2024)
 =============================================
 
 For a list of all of the issues and pull requests since the last revision, see the

From be56634d682bed257cb941369d8d3600635ddadf Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 15 May 2024 18:43:56 -0400
Subject: [PATCH 0979/1120] REL: v3.9.0

Highlights of this release include:

- Plotting and Annotation improvements
   - Axes.inset_axes is no longer experimental
   - Legend support for Boxplot
   - Percent sign in pie labels auto-escaped with usetex=True
   - hatch parameter for stackplot
   - Add option to plot only one half of violin plot
   - axhline and axhspan on polar axes
   - Subplot titles can now be automatically aligned
   - axisartist can now be used together with standard Formatters
   - Toggle minorticks on Axis
   - StrMethodFormatter now respects axes.unicode_minus
- Figure, Axes, and Legend Layout
   - Subfigures now have controllable zorders
   - Getters for xmargin, ymargin and zmargin
- Mathtext improvements
   - mathtext documentation improvements
   - mathtext spacing corrections
- Widget Improvements
   - Check and Radio Button widgets support clearing
- 3D plotting improvements
   - Setting 3D axis limits now set the limits exactly
- Other improvements
   - New BackendRegistry for plotting backends
   - Add widths, heights and angles setter to EllipseCollection
   - image.interpolation_stage rcParam
   - Arrow patch position is now modifiable
   - NonUniformImage now has mouseover support

From fe276395739773e2fa558bf98533f310a77fdb97 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 15 May 2024 18:48:18 -0400
Subject: [PATCH 0980/1120] BLD: bump branch away from tag

So the tarballs from GitHub are stable.

From 43c95480c6e9ff8787b5ead9fc9daec745b719a5 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 15 May 2024 19:54:13 -0400
Subject: [PATCH 0981/1120] DOC: Add Zenodo DOI for 3.9.0

---
 doc/_static/zenodo_cache/11201097.svg | 35 +++++++++++++++++++++++++++
 doc/project/citing.rst                |  3 +++
 tools/cache_zenodo_svg.py             |  1 +
 3 files changed, 39 insertions(+)
 create mode 100644 doc/_static/zenodo_cache/11201097.svg

diff --git a/doc/_static/zenodo_cache/11201097.svg b/doc/_static/zenodo_cache/11201097.svg
new file mode 100644
index 000000000000..70f35a7a659f
--- /dev/null
+++ b/doc/_static/zenodo_cache/11201097.svg
@@ -0,0 +1,35 @@
+<svg xmlns="http://www.w3.org/2000/svg"
+     width="190.859375" height="20">
+        <linearGradient id="b" x2="0" y2="100%">
+            <stop offset="0" stop-color="#bbb" stop-opacity=".1"/>
+            <stop offset="1" stop-opacity=".1"/>
+        </linearGradient>
+        <mask id="a" width="190.859375" height="20">
+            <rect width="190.859375" height="20" rx="3"
+            fill="#fff"/>
+        </mask>
+        <g mask="url(#a)">
+            <path fill="#555" d="M0 0h31.375v20H0z" />
+            <path fill="#007ec6"
+            d="M31.375 0h159.484375v20H31.375z"
+            />
+            <path fill="url(#b)" d="M0 0h190.859375v20H0z" />
+        </g>
+        <g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,
+        Verdana,Geneva,sans-serif" font-size="11">
+            <text x="16.1875" y="15" fill="#010101"
+            fill-opacity=".3">
+                DOI
+            </text>
+            <text x="16.1875" y="14">
+                DOI
+            </text>
+            <text x="110.6171875"
+            y="15" fill="#010101" fill-opacity=".3">
+                10.5281/zenodo.11201097
+            </text>
+            <text x="110.6171875" y="14">
+                10.5281/zenodo.11201097
+            </text>
+        </g>
+    </svg>
\ No newline at end of file
diff --git a/doc/project/citing.rst b/doc/project/citing.rst
index 008ee794a41b..fd013231b6c5 100644
--- a/doc/project/citing.rst
+++ b/doc/project/citing.rst
@@ -32,6 +32,9 @@ By version
 .. START OF AUTOGENERATED
 
 
+v3.9.0
+   .. image:: ../_static/zenodo_cache/11201097.svg
+      :target:  https://doi.org/10.5281/zenodo.11201097
 v3.8.4
    .. image:: ../_static/zenodo_cache/10916799.svg
       :target:  https://doi.org/10.5281/zenodo.10916799
diff --git a/tools/cache_zenodo_svg.py b/tools/cache_zenodo_svg.py
index fbdbceaf0fbb..600e87efc498 100644
--- a/tools/cache_zenodo_svg.py
+++ b/tools/cache_zenodo_svg.py
@@ -63,6 +63,7 @@ def _get_xdg_cache_dir():
 
 if __name__ == "__main__":
     data = {
+        "v3.9.0": "11201097",
         "v3.8.4": "10916799",
         "v3.8.3": "10661079",
         "v3.8.2": "10150955",

From ac17d9fa20166cd1363b9486e868d899a5b3a88e Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Thu, 16 May 2024 20:16:05 +0200
Subject: [PATCH 0982/1120] Backport PR #28231: DOC: we do not need the blit
 call in on_draw

---
 galleries/examples/event_handling/path_editor.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/galleries/examples/event_handling/path_editor.py b/galleries/examples/event_handling/path_editor.py
index d6e84b454008..2af54bad53ed 100644
--- a/galleries/examples/event_handling/path_editor.py
+++ b/galleries/examples/event_handling/path_editor.py
@@ -94,7 +94,6 @@ def on_draw(self, event):
         self.background = self.canvas.copy_from_bbox(self.ax.bbox)
         self.ax.draw_artist(self.pathpatch)
         self.ax.draw_artist(self.line)
-        self.canvas.blit(self.ax.bbox)
 
     def on_button_press(self, event):
         """Callback for mouse button presses."""

From 6558e560947bfcfcd2c1bebd0bec788aecbddc0c Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Thu, 16 May 2024 13:26:22 -0500
Subject: [PATCH 0983/1120] Backport PR #28233: CI: Fix font install on
 macOS/Homebrew

---
 .github/workflows/tests.yml | 7 +++----
 azure-pipelines.yml         | 4 ++--
 2 files changed, 5 insertions(+), 6 deletions(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 126693beafa7..daa07e62b2e5 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -160,10 +160,9 @@ jobs:
             fi
             ;;
           macOS)
-            brew install ccache
-            brew tap homebrew/cask-fonts
-            brew install font-noto-sans-cjk ghostscript gobject-introspection gtk4 ninja
-            brew install --cask inkscape
+            brew update
+            brew install ccache ghostscript gobject-introspection gtk4 ninja
+            brew install --cask font-noto-sans-cjk inkscape
             ;;
           esac
 
diff --git a/azure-pipelines.yml b/azure-pipelines.yml
index bf055d0eaa16..4c50c543846a 100644
--- a/azure-pipelines.yml
+++ b/azure-pipelines.yml
@@ -119,10 +119,10 @@ stages:
                   texlive-xetex
                 ;;
               Darwin)
+                brew update
                 brew install --cask xquartz
                 brew install ccache ffmpeg imagemagick mplayer ninja pkg-config
-                brew tap homebrew/cask-fonts
-                brew install font-noto-sans-cjk-sc
+                brew install --cask font-noto-sans-cjk-sc
                 ;;
               Windows_NT)
                 choco install ninja

From 492f4bd95c8d68e60e78523eee2c8c17f2a34bac Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 16 May 2024 16:02:28 -0400
Subject: [PATCH 0984/1120] DOC: Fix a typo in GitHub stats

---
 doc/users/github_stats.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/users/github_stats.rst b/doc/users/github_stats.rst
index a7f909b30cf5..629d9319fc57 100644
--- a/doc/users/github_stats.rst
+++ b/doc/users/github_stats.rst
@@ -655,7 +655,7 @@ Issues (97):
 * :ghissue:`26778`: [MNT]: Numpy 2.0 support strategy
 * :ghissue:`28020`: [Bug]: imsave fails on RGBA data when origin is set to lower
 * :ghissue:`7720`: WXAgg backend not rendering nicely on retina
-* :ghissue:`28069`: [Bug]: Cant save with custom toolbar
+* :ghissue:`28069`: [Bug]: Can't save with custom toolbar
 * :ghissue:`28005`: [Doc]: Improve contribute instructions
 * :ghissue:`22376`: [ENH]: align_titles
 * :ghissue:`5506`: Confusing status bar values in presence of multiple axes

From c35a0e576c172a3a89bfafd63c372e2b6afaa5a5 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 16 May 2024 21:49:04 -0400
Subject: [PATCH 0985/1120] Backport PR #28219: Bump the actions group with 2
 updates

---
 .github/workflows/cibuildwheel.yml  | 10 +++++-----
 .github/workflows/conflictcheck.yml |  2 +-
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 41d28d864dbe..9c327aba22c2 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -140,7 +140,7 @@ jobs:
           path: dist/
 
       - name: Build wheels for CPython 3.12
-        uses: pypa/cibuildwheel@8d945475ac4b1aac4ae08b2fd27db9917158b6ce  # v2.17.0
+        uses: pypa/cibuildwheel@711a3d017d0729f3edde18545fee967f03d65f65  # v2.18.0
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -149,7 +149,7 @@ jobs:
           MACOSX_DEPLOYMENT_TARGET: "${{ matrix.macos_target }}"
 
       - name: Build wheels for CPython 3.11
-        uses: pypa/cibuildwheel@8d945475ac4b1aac4ae08b2fd27db9917158b6ce  # v2.17.0
+        uses: pypa/cibuildwheel@711a3d017d0729f3edde18545fee967f03d65f65  # v2.18.0
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -158,7 +158,7 @@ jobs:
           MACOSX_DEPLOYMENT_TARGET: "${{ matrix.macos_target }}"
 
       - name: Build wheels for CPython 3.10
-        uses: pypa/cibuildwheel@8d945475ac4b1aac4ae08b2fd27db9917158b6ce  # v2.17.0
+        uses: pypa/cibuildwheel@711a3d017d0729f3edde18545fee967f03d65f65  # v2.18.0
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -167,7 +167,7 @@ jobs:
           MACOSX_DEPLOYMENT_TARGET: "${{ matrix.macos_target }}"
 
       - name: Build wheels for CPython 3.9
-        uses: pypa/cibuildwheel@8d945475ac4b1aac4ae08b2fd27db9917158b6ce  # v2.17.0
+        uses: pypa/cibuildwheel@711a3d017d0729f3edde18545fee967f03d65f65  # v2.18.0
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -176,7 +176,7 @@ jobs:
           MACOSX_DEPLOYMENT_TARGET: "${{ matrix.macos_target }}"
 
       - name: Build wheels for PyPy
-        uses: pypa/cibuildwheel@8d945475ac4b1aac4ae08b2fd27db9917158b6ce  # v2.17.0
+        uses: pypa/cibuildwheel@711a3d017d0729f3edde18545fee967f03d65f65  # v2.18.0
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
diff --git a/.github/workflows/conflictcheck.yml b/.github/workflows/conflictcheck.yml
index 3eb384fa6585..fc759f52a6b0 100644
--- a/.github/workflows/conflictcheck.yml
+++ b/.github/workflows/conflictcheck.yml
@@ -17,7 +17,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Check if PRs have merge conflicts
-        uses: eps1lon/actions-label-merge-conflict@e62d7a53ff8be8b97684bffb6cfbbf3fc1115e2e  # v3.0.0
+        uses: eps1lon/actions-label-merge-conflict@6d74047dcef155976a15e4a124dde2c7fe0c5522  # v3.0.1
         with:
           dirtyLabel: "status: needs rebase"
           repoToken: "${{ secrets.GITHUB_TOKEN }}"

From 9f70709254bb3229662c6e568d5fe0f3c016fd0a Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Fri, 17 May 2024 10:19:42 +0200
Subject: [PATCH 0986/1120] Backport PR #28243: DOC: Add more 3D plot types

---
 galleries/plot_types/3D/bar3d_simple.py    | 29 ++++++++++++++++++++
 galleries/plot_types/3D/plot3d_simple.py   | 27 ++++++++++++++++++
 galleries/plot_types/3D/quiver3d_simple.py | 32 ++++++++++++++++++++++
 galleries/plot_types/3D/stem3d.py          | 27 ++++++++++++++++++
 4 files changed, 115 insertions(+)
 create mode 100644 galleries/plot_types/3D/bar3d_simple.py
 create mode 100644 galleries/plot_types/3D/plot3d_simple.py
 create mode 100644 galleries/plot_types/3D/quiver3d_simple.py
 create mode 100644 galleries/plot_types/3D/stem3d.py

diff --git a/galleries/plot_types/3D/bar3d_simple.py b/galleries/plot_types/3D/bar3d_simple.py
new file mode 100644
index 000000000000..aa75560de8f2
--- /dev/null
+++ b/galleries/plot_types/3D/bar3d_simple.py
@@ -0,0 +1,29 @@
+"""
+==========================
+bar3d(x, y, z, dx, dy, dz)
+==========================
+
+See `~mpl_toolkits.mplot3d.axes3d.Axes3D.bar3d`.
+"""
+import matplotlib.pyplot as plt
+import numpy as np
+
+plt.style.use('_mpl-gallery')
+
+# Make data
+x = [1, 1, 2, 2]
+y = [1, 2, 1, 2]
+z = [0, 0, 0, 0]
+dx = np.ones_like(x)*0.5
+dy = np.ones_like(x)*0.5
+dz = [2, 3, 1, 4]
+
+# Plot
+fig, ax = plt.subplots(subplot_kw={"projection": "3d"})
+ax.bar3d(x, y, z, dx, dy, dz)
+
+ax.set(xticklabels=[],
+       yticklabels=[],
+       zticklabels=[])
+
+plt.show()
diff --git a/galleries/plot_types/3D/plot3d_simple.py b/galleries/plot_types/3D/plot3d_simple.py
new file mode 100644
index 000000000000..108dbecfbd87
--- /dev/null
+++ b/galleries/plot_types/3D/plot3d_simple.py
@@ -0,0 +1,27 @@
+"""
+================
+plot(xs, ys, zs)
+================
+
+See `~mpl_toolkits.mplot3d.axes3d.Axes3D.plot`.
+"""
+import matplotlib.pyplot as plt
+import numpy as np
+
+plt.style.use('_mpl-gallery')
+
+# Make data
+n = 100
+xs = np.linspace(0, 1, n)
+ys = np.sin(xs * 6 * np.pi)
+zs = np.cos(xs * 6 * np.pi)
+
+# Plot
+fig, ax = plt.subplots(subplot_kw={"projection": "3d"})
+ax.plot(xs, ys, zs)
+
+ax.set(xticklabels=[],
+       yticklabels=[],
+       zticklabels=[])
+
+plt.show()
diff --git a/galleries/plot_types/3D/quiver3d_simple.py b/galleries/plot_types/3D/quiver3d_simple.py
new file mode 100644
index 000000000000..6f4aaa9cad90
--- /dev/null
+++ b/galleries/plot_types/3D/quiver3d_simple.py
@@ -0,0 +1,32 @@
+"""
+========================
+quiver(X, Y, Z, U, V, W)
+========================
+
+See `~mpl_toolkits.mplot3d.axes3d.Axes3D.quiver`.
+"""
+import matplotlib.pyplot as plt
+import numpy as np
+
+plt.style.use('_mpl-gallery')
+
+# Make data
+n = 4
+x = np.linspace(-1, 1, n)
+y = np.linspace(-1, 1, n)
+z = np.linspace(-1, 1, n)
+X, Y, Z = np.meshgrid(x, y, z)
+U = (X + Y)/5
+V = (Y - X)/5
+W = Z*0
+
+
+# Plot
+fig, ax = plt.subplots(subplot_kw={"projection": "3d"})
+ax.quiver(X, Y, Z, U, V, W)
+
+ax.set(xticklabels=[],
+       yticklabels=[],
+       zticklabels=[])
+
+plt.show()
diff --git a/galleries/plot_types/3D/stem3d.py b/galleries/plot_types/3D/stem3d.py
new file mode 100644
index 000000000000..50aa80146bdc
--- /dev/null
+++ b/galleries/plot_types/3D/stem3d.py
@@ -0,0 +1,27 @@
+"""
+=============
+stem(x, y, z)
+=============
+
+See `~mpl_toolkits.mplot3d.axes3d.Axes3D.stem`.
+"""
+import matplotlib.pyplot as plt
+import numpy as np
+
+plt.style.use('_mpl-gallery')
+
+# Make data
+n = 20
+x = np.sin(np.linspace(0, 2*np.pi, n))
+y = np.cos(np.linspace(0, 2*np.pi, n))
+z = np.linspace(0, 1, n)
+
+# Plot
+fig, ax = plt.subplots(subplot_kw={"projection": "3d"})
+ax.stem(x, y, z)
+
+ax.set(xticklabels=[],
+       yticklabels=[],
+       zticklabels=[])
+
+plt.show()

From 63351f2f8d9c7566634b87dd94cd4ae730c701c0 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Fri, 17 May 2024 11:41:07 +0200
Subject: [PATCH 0987/1120] Backport PR #28230: Add extra imports to improve
 typing

---
 lib/matplotlib/pyplot.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index b1354341617d..925322cdd1e5 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -90,6 +90,9 @@
     import PIL.Image
     from numpy.typing import ArrayLike
 
+    import matplotlib.axes
+    import matplotlib.artist
+    import matplotlib.backend_bases
     from matplotlib.axis import Tick
     from matplotlib.axes._base import _AxesBase
     from matplotlib.backend_bases import RendererBase, Event

From fefe7d298f71bda84e2bcc707dc7c6004de14ad9 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Fri, 17 May 2024 15:16:37 -0400
Subject: [PATCH 0988/1120] Backport PR #28252: DOC: Flip the imshow plot types
 example to match the other examples

---
 galleries/plot_types/arrays/imshow.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/galleries/plot_types/arrays/imshow.py b/galleries/plot_types/arrays/imshow.py
index c28278c6c657..b2920e7fd80c 100644
--- a/galleries/plot_types/arrays/imshow.py
+++ b/galleries/plot_types/arrays/imshow.py
@@ -19,6 +19,6 @@
 # plot
 fig, ax = plt.subplots()
 
-ax.imshow(Z)
+ax.imshow(Z, origin='lower')
 
 plt.show()

From 82d14c8183f3c4831ee94a27f33aacf676871a53 Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Fri, 17 May 2024 15:50:09 -0400
Subject: [PATCH 0989/1120] Backport PR #28254: [DOC] plot type heading
 consistency

---
 galleries/plot_types/arrays/README.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/galleries/plot_types/arrays/README.rst b/galleries/plot_types/arrays/README.rst
index d9dbfd10ead7..aba457a69940 100644
--- a/galleries/plot_types/arrays/README.rst
+++ b/galleries/plot_types/arrays/README.rst
@@ -1,7 +1,7 @@
 .. _array_plots:
 
-Gridded data:
--------------
+Gridded data
+------------
 
 Plots of arrays and images :math:`Z_{i, j}` and fields :math:`U_{i, j}, V_{i, j}`
 on `regular grids <https://en.wikipedia.org/wiki/Regular_grid>`_ and

From f3b34c1137a12280c1619183f9c5cdc5b087d7f0 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Mon, 20 May 2024 16:19:11 -0500
Subject: [PATCH 0990/1120] Backport PR #28257: Clean up some Meson-related
 leftovers

---
 .../api_changes_3.5.0/development.rst          |  6 +++---
 doc/install/environment_variables_faq.rst      |  7 -------
 doc/install/index.rst                          | 18 ++++++++----------
 pyproject.toml                                 |  1 -
 src/checkdep_freetype2.c                       |  4 ++--
 5 files changed, 13 insertions(+), 23 deletions(-)

diff --git a/doc/api/prev_api_changes/api_changes_3.5.0/development.rst b/doc/api/prev_api_changes/api_changes_3.5.0/development.rst
index 2db21237a699..b42e6eff3423 100644
--- a/doc/api/prev_api_changes/api_changes_3.5.0/development.rst
+++ b/doc/api/prev_api_changes/api_changes_3.5.0/development.rst
@@ -77,6 +77,6 @@ In order to avoid conflicting with the use of :file:`setup.cfg` by
 ``setup.cfg`` to ``mplsetup.cfg``.  The :file:`setup.cfg.template` has been
 correspondingly been renamed to :file:`mplsetup.cfg.template`.
 
-Note that the path to this configuration file can still be set via the
-:envvar:`MPLSETUPCFG` environment variable, which allows one to keep using the
-same file before and after this change.
+Note that the path to this configuration file can still be set via the ``MPLSETUPCFG``
+environment variable, which allows one to keep using the same file before and after this
+change.
diff --git a/doc/install/environment_variables_faq.rst b/doc/install/environment_variables_faq.rst
index ba384343cc5a..38e0d0ef0c63 100644
--- a/doc/install/environment_variables_faq.rst
+++ b/doc/install/environment_variables_faq.rst
@@ -29,13 +29,6 @@ Environment variables
   used to find a base directory in which the :file:`matplotlib` subdirectory is
   created.
 
-.. envvar:: MPLSETUPCFG
-
-   This optional variable can be set to the full path of a :file:`mplsetup.cfg`
-   configuration file used to customize the Matplotlib build.  By default, a
-   :file:`mplsetup.cfg` file in the root of the Matplotlib source tree will be
-   read.  Supported build options are listed in :file:`mplsetup.cfg.template`.
-
 .. envvar:: PATH
 
   The list of directories searched to find executable programs.
diff --git a/doc/install/index.rst b/doc/install/index.rst
index ea8e29d71565..867e4600a77e 100644
--- a/doc/install/index.rst
+++ b/doc/install/index.rst
@@ -121,22 +121,20 @@ Before trying to install Matplotlib, please install the :ref:`dependencies`.
 To build from a tarball, download the latest *tar.gz* release
 file from `the PyPI files page <https://pypi.org/project/matplotlib/>`_.
 
-We provide a `mplsetup.cfg`_ file which you can use to customize the build
-process. For example, which default backend to use, whether some of the
-optional libraries that Matplotlib ships with are installed, and so on. This
-file will be particularly useful to those packaging Matplotlib.
-
-.. _mplsetup.cfg: https://raw.githubusercontent.com/matplotlib/matplotlib/main/mplsetup.cfg.template
-
 If you are building your own Matplotlib wheels (or sdists) on Windows, note
 that any DLLs that you copy into the source tree will be packaged too.
 
-
 Configure build and behavior defaults
 =====================================
 
-Aspects of the build and install process and some behaviorial defaults of the
-library can be configured via:
+We provide a `meson.options`_ file containing options with which you can use to
+customize the build process. For example, which default backend to use, whether some of
+the optional libraries that Matplotlib ships with are installed, and so on. These
+options will be particularly useful to those packaging Matplotlib.
+
+.. _meson.options: https://github.com/matplotlib/matplotlib/blob/main/meson.options
+
+Aspects of some behaviorial defaults of the library can be configured via:
 
 .. toctree::
   :maxdepth: 2
diff --git a/pyproject.toml b/pyproject.toml
index fe75b325dc89..a9fb7df68450 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -95,7 +95,6 @@ install = ['--tags=data,python-runtime,runtime']
 [tool.setuptools_scm]
 version_scheme = "release-branch-semver"
 local_scheme = "node-and-date"
-write_to = "lib/matplotlib/_version.py"
 parentdir_prefix_version = "matplotlib-"
 fallback_version = "0.0+UNKNOWN"
 
diff --git a/src/checkdep_freetype2.c b/src/checkdep_freetype2.c
index 8d9d8ca24a07..16e8ac23919e 100644
--- a/src/checkdep_freetype2.c
+++ b/src/checkdep_freetype2.c
@@ -1,7 +1,7 @@
 #ifdef __has_include
   #if !__has_include(<ft2build.h>)
     #error "FreeType version 2.3 or higher is required. \
-You may unset the system_freetype entry in mplsetup.cfg to let Matplotlib download it."
+You may set the system-freetype Meson build option to false to let Matplotlib download it."
   #endif
 #endif
 
@@ -15,5 +15,5 @@ You may unset the system_freetype entry in mplsetup.cfg to let Matplotlib downlo
   XSTR(FREETYPE_MAJOR) "." XSTR(FREETYPE_MINOR) "." XSTR(FREETYPE_PATCH) ".")
 #if FREETYPE_MAJOR << 16 + FREETYPE_MINOR << 8 + FREETYPE_PATCH < 0x020300
   #error "FreeType version 2.3 or higher is required. \
-You may unset the system_freetype entry in mplsetup.cfg to let Matplotlib download it."
+You may set the system-freetype Meson build option to false to let Matplotlib download it."
 #endif

From 8cb17f8b2ae55ab8374650d41cf93bfbf6a3e093 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Tue, 21 May 2024 14:15:04 -0400
Subject: [PATCH 0991/1120] Backport PR #28269: Handle GetForegroundWindow()
 returning NULL.

---
 lib/matplotlib/backends/_backend_tk.py | 2 +-
 src/_c_internal_utils.cpp              | 6 +++++-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/backends/_backend_tk.py b/lib/matplotlib/backends/_backend_tk.py
index 295f6c41372d..df06440a9826 100644
--- a/lib/matplotlib/backends/_backend_tk.py
+++ b/lib/matplotlib/backends/_backend_tk.py
@@ -44,7 +44,7 @@ def _restore_foreground_window_at_end():
     try:
         yield
     finally:
-        if mpl.rcParams['tk.window_focus']:
+        if foreground and mpl.rcParams['tk.window_focus']:
             _c_internal_utils.Win32_SetForegroundWindow(foreground)
 
 
diff --git a/src/_c_internal_utils.cpp b/src/_c_internal_utils.cpp
index 464aabcb2e3a..e118183ecc8b 100644
--- a/src/_c_internal_utils.cpp
+++ b/src/_c_internal_utils.cpp
@@ -111,7 +111,11 @@ static py::object
 mpl_GetForegroundWindow(void)
 {
 #ifdef _WIN32
-  return py::capsule(GetForegroundWindow(), "HWND");
+  if (HWND hwnd = GetForegroundWindow()) {
+    return py::capsule(hwnd, "HWND");
+  } else {
+    return py::none();
+  }
 #else
   return py::none();
 #endif

From 425b4d3de90f49c6dc84a4396e9ca4c901df1f52 Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Wed, 22 May 2024 07:37:36 +0200
Subject: [PATCH 0992/1120] Backport PR #28274: ci: Remove deprecated codeql
 option

---
 .github/workflows/codeql-analysis.yml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/.github/workflows/codeql-analysis.yml b/.github/workflows/codeql-analysis.yml
index 29d2859999bd..203b0eee9ca4 100644
--- a/.github/workflows/codeql-analysis.yml
+++ b/.github/workflows/codeql-analysis.yml
@@ -32,7 +32,6 @@ jobs:
         uses: github/codeql-action/init@v3
         with:
           languages: ${{ matrix.language }}
-          setup-python-dependencies: false
 
       - name: Build compiled code
         if: matrix.language == 'c-cpp'

From 7bd803f06f07d0156903c5fafe7f5735b844ed4d Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Wed, 22 May 2024 07:59:18 +0200
Subject: [PATCH 0993/1120] Backport PR #28272: BLD: Move macos builders from
 11 to 12

---
 .github/workflows/cibuildwheel.yml | 14 ++------------
 1 file changed, 2 insertions(+), 12 deletions(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 9c327aba22c2..2fa9569f3fb6 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -105,6 +105,7 @@ jobs:
       CIBW_SKIP: "*-musllinux_aarch64"
       CIBW_TEST_COMMAND: >-
         python {package}/ci/check_version_number.py
+      MACOSX_DEPLOYMENT_TARGET: "10.12"
       MPL_DISABLE_FH4: "yes"
     strategy:
       matrix:
@@ -115,16 +116,10 @@ jobs:
             cibw_archs: "aarch64"
           - os: windows-latest
             cibw_archs: "auto64"
-          - os: macos-11
+          - os: macos-12
             cibw_archs: "x86_64"
-            # NOTE: macos_target can be moved back into global environment after
-            # meson-python 0.16.0 is released.
-            macos_target: "10.12"
           - os: macos-14
             cibw_archs: "arm64"
-            # NOTE: macos_target can be moved back into global environment after
-            # meson-python 0.16.0 is released.
-            macos_target: "11.0"
 
     steps:
       - name: Set up QEMU
@@ -146,7 +141,6 @@ jobs:
         env:
           CIBW_BUILD: "cp312-*"
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
-          MACOSX_DEPLOYMENT_TARGET: "${{ matrix.macos_target }}"
 
       - name: Build wheels for CPython 3.11
         uses: pypa/cibuildwheel@711a3d017d0729f3edde18545fee967f03d65f65  # v2.18.0
@@ -155,7 +149,6 @@ jobs:
         env:
           CIBW_BUILD: "cp311-*"
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
-          MACOSX_DEPLOYMENT_TARGET: "${{ matrix.macos_target }}"
 
       - name: Build wheels for CPython 3.10
         uses: pypa/cibuildwheel@711a3d017d0729f3edde18545fee967f03d65f65  # v2.18.0
@@ -164,7 +157,6 @@ jobs:
         env:
           CIBW_BUILD: "cp310-*"
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
-          MACOSX_DEPLOYMENT_TARGET: "${{ matrix.macos_target }}"
 
       - name: Build wheels for CPython 3.9
         uses: pypa/cibuildwheel@711a3d017d0729f3edde18545fee967f03d65f65  # v2.18.0
@@ -173,7 +165,6 @@ jobs:
         env:
           CIBW_BUILD: "cp39-*"
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
-          MACOSX_DEPLOYMENT_TARGET: "${{ matrix.macos_target }}"
 
       - name: Build wheels for PyPy
         uses: pypa/cibuildwheel@711a3d017d0729f3edde18545fee967f03d65f65  # v2.18.0
@@ -182,7 +173,6 @@ jobs:
         env:
           CIBW_BUILD: "pp39-*"
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
-          MACOSX_DEPLOYMENT_TARGET: "${{ matrix.macos_target }}"
         if: matrix.cibw_archs != 'aarch64'
 
       - uses: actions/upload-artifact@v4

From bb1dcc372e5b507e5601ead97eb18c6e206307d8 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Thu, 23 May 2024 10:33:21 +0200
Subject: [PATCH 0994/1120] Backport PR #28280: DOC: Add an example for 2D
 images in 3D plots

---
 galleries/examples/mplot3d/imshow3d.py | 88 ++++++++++++++++++++++++++
 1 file changed, 88 insertions(+)
 create mode 100644 galleries/examples/mplot3d/imshow3d.py

diff --git a/galleries/examples/mplot3d/imshow3d.py b/galleries/examples/mplot3d/imshow3d.py
new file mode 100644
index 000000000000..557d96e1bce5
--- /dev/null
+++ b/galleries/examples/mplot3d/imshow3d.py
@@ -0,0 +1,88 @@
+"""
+===============
+2D images in 3D
+===============
+
+This example demonstrates how to plot 2D color coded images (similar to
+`.Axes.imshow`) as a plane in 3D.
+
+Matplotlib does not have a native function for this. Below we build one by relying
+on `.Axes3D.plot_surface`. For simplicity, there are some differences to
+`.Axes.imshow`: This function does not set the aspect of the Axes, hence pixels are
+not necessarily square. Also, pixel edges are on integer values rather than pixel
+centers. Furthermore, many optional parameters of `.Axes.imshow` are not implemented.
+
+Multiple calls of ``imshow3d`` use independent norms and thus different color scales
+by default. If you want to have a single common color scale, you need to construct
+a suitable norm beforehand and pass it to all ``imshow3d`` calls.
+
+A fundamental limitation of the 3D plotting engine is that intersecting objects cannot
+be drawn correctly. One object will always be drawn after the other. Therefore,
+multiple image planes can well be used in the background as shown in this example.
+But this approach is not suitable if the planes intersect.
+"""
+
+import matplotlib.pyplot as plt
+import numpy as np
+
+from matplotlib.colors import Normalize
+
+
+def imshow3d(ax, array, value_direction='z', pos=0, norm=None, cmap=None):
+    """
+    Display a 2D array as a  color-coded 2D image embedded in 3d.
+
+    The image will be in a plane perpendicular to the coordinate axis *value_direction*.
+
+    Parameters
+    ----------
+    ax : Axes3D
+        The 3D Axes to plot into.
+    array : 2D numpy array
+        The image values.
+    value_direction : {'x', 'y', 'z'}
+        The axis normal to the image plane.
+    pos : float
+        The numeric value on the *value_direction* axis at which the image plane is
+        located.
+    norm : `~matplotlib.colors.Normalize`, default: Normalize
+        The normalization method used to scale scalar data. See `imshow()`.
+    cmap : str or `~matplotlib.colors.Colormap`, default: :rc:`image.cmap`
+        The Colormap instance or registered colormap name used to map scalar data
+        to colors.
+    """
+    if norm is None:
+        norm = Normalize()
+    colors = plt.get_cmap(cmap)(norm(array))
+
+    if value_direction == 'x':
+        nz, ny = array.shape
+        zi, yi = np.mgrid[0:nz + 1, 0:ny + 1]
+        xi = np.full_like(yi, pos)
+    elif value_direction == 'y':
+        nx, nz = array.shape
+        xi, zi = np.mgrid[0:nx + 1, 0:nz + 1]
+        yi = np.full_like(zi, pos)
+    elif value_direction == 'z':
+        ny, nx = array.shape
+        yi, xi = np.mgrid[0:ny + 1, 0:nx + 1]
+        zi = np.full_like(xi, pos)
+    else:
+        raise ValueError(f"Invalid value_direction: {value_direction!r}")
+    ax.plot_surface(xi, yi, zi, rstride=1, cstride=1, facecolors=colors, shade=False)
+
+
+fig = plt.figure()
+ax = fig.add_subplot(projection='3d')
+ax.set(xlabel="x", ylabel="y", zlabel="z")
+
+nx, ny, nz = 8, 10, 5
+data_xy = np.arange(ny * nx).reshape(ny, nx) + 15 * np.random.random((ny, nx))
+data_yz = np.arange(nz * ny).reshape(nz, ny) + 10 * np.random.random((nz, ny))
+data_zx = np.arange(nx * nz).reshape(nx, nz) + 8 * np.random.random((nx, nz))
+
+imshow3d(ax, data_xy)
+imshow3d(ax, data_yz, value_direction='x', cmap='magma')
+imshow3d(ax, data_zx, value_direction='y', pos=ny, cmap='plasma')
+
+plt.show()

From 042e1bb7f9d5b4295448e7fcf3bbe3b9fbcd9e4f Mon Sep 17 00:00:00 2001
From: Oscar Gustafsson <oscar.gustafsson@gmail.com>
Date: Fri, 24 May 2024 23:49:19 +0200
Subject: [PATCH 0995/1120] Backport PR #28261: Correct roll angle units, issue
 #28256

---
 lib/mpl_toolkits/mplot3d/axes3d.py            |  1 +
 lib/mpl_toolkits/mplot3d/tests/test_axes3d.py | 25 +++++++++++++++++++
 2 files changed, 26 insertions(+)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index d0f5c8d2b23b..677c2668d4e9 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -1524,6 +1524,7 @@ def _on_move(self, event):
             dazim = -(dy/h)*180*np.sin(roll) - (dx/w)*180*np.cos(roll)
             elev = self.elev + delev
             azim = self.azim + dazim
+            roll = self.roll
             vertical_axis = self._axis_names[self._vertical_axis]
             self.view_init(
                 elev=elev,
diff --git a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
index ed56e5505d8e..c339e35e903c 100644
--- a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
@@ -1766,6 +1766,31 @@ def test_shared_axes_retick():
     assert ax2.get_zlim() == (-0.5, 2.5)
 
 
+def test_rotate():
+    """Test rotating using the left mouse button."""
+    for roll in [0, 30]:
+        fig = plt.figure()
+        ax = fig.add_subplot(1, 1, 1, projection='3d')
+        ax.view_init(0, 0, roll)
+        ax.figure.canvas.draw()
+
+        # drag mouse horizontally to change azimuth
+        dx = 0.1
+        dy = 0.2
+        ax._button_press(
+            mock_event(ax, button=MouseButton.LEFT, xdata=0, ydata=0))
+        ax._on_move(
+            mock_event(ax, button=MouseButton.LEFT,
+                           xdata=dx*ax._pseudo_w, ydata=dy*ax._pseudo_h))
+        ax.figure.canvas.draw()
+        roll_radians = np.deg2rad(ax.roll)
+        cs = np.cos(roll_radians)
+        sn = np.sin(roll_radians)
+        assert ax.elev == (-dy*180*cs + dx*180*sn)
+        assert ax.azim == (-dy*180*sn - dx*180*cs)
+        assert ax.roll == roll
+
+
 def test_pan():
     """Test mouse panning using the middle mouse button."""
 

From a4a0a9571f2a257b9bc8224e6b266253991be02e Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Sat, 25 May 2024 20:20:22 +0200
Subject: [PATCH 0996/1120] Backport PR #28297: Solved #28296 Added missing
 comma

---
 lib/matplotlib/axes/_axes.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index b65004b8c272..34c4023a256e 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -1586,7 +1586,7 @@ def plot(self, *args, scalex=True, scaley=True, data=None, **kwargs):
           >>> plot(x1, y1, 'bo')
           >>> plot(x2, y2, 'go')
 
-        - If *x* and/or *y* are 2D arrays a separate data set will be drawn
+        - If *x* and/or *y* are 2D arrays, a separate data set will be drawn
           for every column. If both *x* and *y* are 2D, they must have the
           same shape. If only one of them is 2D with shape (N, m) the other
           must have length N and will be used for every data set m.

From 3a55c47f4bf09a247cd420b2cf00f52f9a04629a Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Sun, 26 May 2024 18:41:05 +0100
Subject: [PATCH 0997/1120] Backport PR #28303: Removed drawedges repeated
 definition from function doc string

---
 lib/matplotlib/colorbar.py | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/lib/matplotlib/colorbar.py b/lib/matplotlib/colorbar.py
index af61e4671ff4..156ea2ff6497 100644
--- a/lib/matplotlib/colorbar.py
+++ b/lib/matplotlib/colorbar.py
@@ -257,10 +257,6 @@ class Colorbar:
         *location* is None, the ticks will be at the bottom for a horizontal
         colorbar and at the right for a vertical.
 
-    drawedges : bool
-        Whether to draw lines at color boundaries.
-
-
     %(_colormap_kw_doc)s
 
     location : None or {'left', 'right', 'top', 'bottom'}

From 7462f5e932a7bb99c804c9b19de5fcca48b046bd Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 29 May 2024 14:50:35 -0400
Subject: [PATCH 0998/1120] Backport PR #28273: CI: Add GitHub artifact
 attestations to package distribution

---
 .github/workflows/cibuildwheel.yml | 7 +++++++
 .pre-commit-config.yaml            | 2 +-
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 2fa9569f3fb6..04c70a767ce0 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -189,6 +189,8 @@ jobs:
     environment: release
     permissions:
       id-token: write
+      attestations: write
+      contents: read
     steps:
       - name: Download packages
         uses: actions/download-artifact@v4
@@ -200,5 +202,10 @@ jobs:
       - name: Print out packages
         run: ls dist
 
+      - name: Generate artifact attestation for sdist and wheel
+        uses: actions/attest-build-provenance@173725a1209d09b31f9d30a3890cf2757ebbff0d  # v1.1.2
+        with:
+          subject-path: dist/matplotlib-*
+
       - name: Publish package distributions to PyPI
         uses: pypa/gh-action-pypi-publish@81e9d935c883d0b210363ab89cf05f3894778450  # v1.8.14
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 2dc1ca5352c0..14817e95929f 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -79,7 +79,7 @@ repos:
       - id: yamllint
         args: ["--strict", "--config-file=.yamllint.yml"]
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.28.1
+    rev: 0.28.4
     hooks:
       # TODO: Re-enable this when https://github.com/microsoft/azure-pipelines-vscode/issues/567 is fixed.
       # - id: check-azure-pipelines

From ccc61cb2b818bbc2c9e9e2e83ebf11000760a7da Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Wed, 29 May 2024 20:08:27 -0500
Subject: [PATCH 0999/1120] Backport PR #27001: [TYP] Add overload of
 `pyplot.subplots`

---
 lib/matplotlib/figure.pyi   | 34 +++++++++++++++++--------
 lib/matplotlib/gridspec.pyi |  2 +-
 lib/matplotlib/pyplot.py    | 51 +++++++++++++++++++++++++++++++++++++
 3 files changed, 76 insertions(+), 11 deletions(-)

diff --git a/lib/matplotlib/figure.pyi b/lib/matplotlib/figure.pyi
index eae21c2614f0..21de9159d56c 100644
--- a/lib/matplotlib/figure.pyi
+++ b/lib/matplotlib/figure.pyi
@@ -1,12 +1,12 @@
 from collections.abc import Callable, Hashable, Iterable
 import os
-from typing import Any, IO, Literal, TypeVar, overload
+from typing import Any, IO, Literal, Sequence, TypeVar, overload
 
 import numpy as np
 from numpy.typing import ArrayLike
 
 from matplotlib.artist import Artist
-from matplotlib.axes import Axes, SubplotBase
+from matplotlib.axes import Axes
 from matplotlib.backend_bases import (
     FigureCanvasBase,
     MouseButton,
@@ -92,6 +92,20 @@ class FigureBase(Artist):
     @overload
     def add_subplot(self, **kwargs) -> Axes: ...
     @overload
+    def subplots(
+        self,
+        nrows: Literal[1] = ...,
+        ncols: Literal[1] = ...,
+        *,
+        sharex: bool | Literal["none", "all", "row", "col"] = ...,
+        sharey: bool | Literal["none", "all", "row", "col"] = ...,
+        squeeze: Literal[True] = ...,
+        width_ratios: Sequence[float] | None = ...,
+        height_ratios: Sequence[float] | None = ...,
+        subplot_kw: dict[str, Any] | None = ...,
+        gridspec_kw: dict[str, Any] | None = ...,
+    ) -> Axes: ...
+    @overload
     def subplots(
         self,
         nrows: int = ...,
@@ -100,11 +114,11 @@ class FigureBase(Artist):
         sharex: bool | Literal["none", "all", "row", "col"] = ...,
         sharey: bool | Literal["none", "all", "row", "col"] = ...,
         squeeze: Literal[False],
-        width_ratios: ArrayLike | None = ...,
-        height_ratios: ArrayLike | None = ...,
+        width_ratios: Sequence[float] | None = ...,
+        height_ratios: Sequence[float] | None = ...,
         subplot_kw: dict[str, Any] | None = ...,
-        gridspec_kw: dict[str, Any] | None = ...
-    ) -> np.ndarray: ...
+        gridspec_kw: dict[str, Any] | None = ...,
+    ) -> np.ndarray: ...  # TODO numpy/numpy#24738
     @overload
     def subplots(
         self,
@@ -114,11 +128,11 @@ class FigureBase(Artist):
         sharex: bool | Literal["none", "all", "row", "col"] = ...,
         sharey: bool | Literal["none", "all", "row", "col"] = ...,
         squeeze: bool = ...,
-        width_ratios: ArrayLike | None = ...,
-        height_ratios: ArrayLike | None = ...,
+        width_ratios: Sequence[float] | None = ...,
+        height_ratios: Sequence[float] | None = ...,
         subplot_kw: dict[str, Any] | None = ...,
-        gridspec_kw: dict[str, Any] | None = ...
-    ) -> np.ndarray | SubplotBase | Axes: ...
+        gridspec_kw: dict[str, Any] | None = ...,
+    ) -> Axes | np.ndarray: ...
     def delaxes(self, ax: Axes) -> None: ...
     def clear(self, keep_observers: bool = ...) -> None: ...
     def clf(self, keep_observers: bool = ...) -> None: ...
diff --git a/lib/matplotlib/gridspec.pyi b/lib/matplotlib/gridspec.pyi
index 1ac1bb0b40e7..b6732ad8fafa 100644
--- a/lib/matplotlib/gridspec.pyi
+++ b/lib/matplotlib/gridspec.pyi
@@ -54,7 +54,7 @@ class GridSpecBase:
         sharey: bool | Literal["all", "row", "col", "none"] = ...,
         squeeze: Literal[True] = ...,
         subplot_kw: dict[str, Any] | None = ...
-    ) -> np.ndarray | SubplotBase | Axes: ...
+    ) -> np.ndarray | Axes: ...
 
 class GridSpec(GridSpecBase):
     left: float | None
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 925322cdd1e5..a3ce60f01ef5 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -1548,6 +1548,57 @@ def subplot(*args, **kwargs) -> Axes:
     return ax
 
 
+@overload
+def subplots(
+    nrows: Literal[1] = ...,
+    ncols: Literal[1] = ...,
+    *,
+    sharex: bool | Literal["none", "all", "row", "col"] = ...,
+    sharey: bool | Literal["none", "all", "row", "col"] = ...,
+    squeeze: Literal[True] = ...,
+    width_ratios: Sequence[float] | None = ...,
+    height_ratios: Sequence[float] | None = ...,
+    subplot_kw: dict[str, Any] | None = ...,
+    gridspec_kw: dict[str, Any] | None = ...,
+    **fig_kw
+) -> tuple[Figure, Axes]:
+    ...
+
+
+@overload
+def subplots(
+    nrows: int = ...,
+    ncols: int = ...,
+    *,
+    sharex: bool | Literal["none", "all", "row", "col"] = ...,
+    sharey: bool | Literal["none", "all", "row", "col"] = ...,
+    squeeze: Literal[False],
+    width_ratios: Sequence[float] | None = ...,
+    height_ratios: Sequence[float] | None = ...,
+    subplot_kw: dict[str, Any] | None = ...,
+    gridspec_kw: dict[str, Any] | None = ...,
+    **fig_kw
+) -> tuple[Figure, np.ndarray]:  # TODO numpy/numpy#24738
+    ...
+
+
+@overload
+def subplots(
+    nrows: int = ...,
+    ncols: int = ...,
+    *,
+    sharex: bool | Literal["none", "all", "row", "col"] = ...,
+    sharey: bool | Literal["none", "all", "row", "col"] = ...,
+    squeeze: bool = ...,
+    width_ratios: Sequence[float] | None = ...,
+    height_ratios: Sequence[float] | None = ...,
+    subplot_kw: dict[str, Any] | None = ...,
+    gridspec_kw: dict[str, Any] | None = ...,
+    **fig_kw
+) -> tuple[Figure, Axes | np.ndarray]:
+    ...
+
+
 def subplots(
     nrows: int = 1, ncols: int = 1, *,
     sharex: bool | Literal["none", "all", "row", "col"] = False,

From ecdbc277d3577d1f57401a19151f1a39816472b5 Mon Sep 17 00:00:00 2001
From: Illviljan <14371165+Illviljan@users.noreply.github.com>
Date: Sun, 2 Jun 2024 11:55:43 +0200
Subject: [PATCH 1000/1120] Backport PR #28041: [BUG]: Shift box_aspect
 according to vertical_axis

---
 lib/mpl_toolkits/mplot3d/axes3d.py            | 22 +++++++++++++++----
 lib/mpl_toolkits/mplot3d/tests/test_axes3d.py | 18 +++++++++++++++
 2 files changed, 36 insertions(+), 4 deletions(-)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index 677c2668d4e9..18b823ccccb3 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -383,7 +383,7 @@ def set_box_aspect(self, aspect, *, zoom=1):
         # of the axes in mpl3.8.
         aspect *= 1.8294640721620434 * 25/24 * zoom / np.linalg.norm(aspect)
 
-        self._box_aspect = aspect
+        self._box_aspect = self._roll_to_vertical(aspect, reverse=True)
         self.stale = True
 
     def apply_aspect(self, position=None):
@@ -1191,9 +1191,23 @@ def set_proj_type(self, proj_type, focal_length=None):
                                  f"None for proj_type = {proj_type}")
             self._focal_length = np.inf
 
-    def _roll_to_vertical(self, arr):
-        """Roll arrays to match the different vertical axis."""
-        return np.roll(arr, self._vertical_axis - 2)
+    def _roll_to_vertical(
+        self, arr: "np.typing.ArrayLike", reverse: bool = False
+    ) -> np.ndarray:
+        """
+        Roll arrays to match the different vertical axis.
+
+        Parameters
+        ----------
+        arr : ArrayLike
+            Array to roll.
+        reverse : bool, default: False
+            Reverse the direction of the roll.
+        """
+        if reverse:
+            return np.roll(arr, (self._vertical_axis - 2) * -1)
+        else:
+            return np.roll(arr, (self._vertical_axis - 2))
 
     def get_proj(self):
         """Create the projection matrix from the current viewing position."""
diff --git a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
index c339e35e903c..34f10cb9fd63 100644
--- a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
@@ -2301,6 +2301,24 @@ def test_on_move_vertical_axis(vertical_axis: str) -> None:
     )
 
 
+@pytest.mark.parametrize(
+    "vertical_axis, aspect_expected",
+    [
+        ("x", [1.190476, 0.892857, 1.190476]),
+        ("y", [0.892857, 1.190476, 1.190476]),
+        ("z", [1.190476, 1.190476, 0.892857]),
+    ],
+)
+def test_set_box_aspect_vertical_axis(vertical_axis, aspect_expected):
+    ax = plt.subplot(1, 1, 1, projection="3d")
+    ax.view_init(elev=0, azim=0, roll=0, vertical_axis=vertical_axis)
+    ax.figure.canvas.draw()
+
+    ax.set_box_aspect(None)
+
+    np.testing.assert_allclose(aspect_expected, ax._box_aspect, rtol=1e-6)
+
+
 @image_comparison(baseline_images=['arc_pathpatch.png'],
                   remove_text=True,
                   style='mpl20')

From 623445641b3a9bbe92c01d8b454b812bdd9f6ccb Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Sun, 2 Jun 2024 10:47:35 -0400
Subject: [PATCH 1001/1120] Backport PR #28292: Resolve MaxNLocator IndexError
 when no large steps

---
 lib/matplotlib/tests/test_ticker.py | 8 ++++++++
 lib/matplotlib/ticker.py            | 5 ++++-
 2 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/tests/test_ticker.py b/lib/matplotlib/tests/test_ticker.py
index 36b83c95b3d3..ac68a5d90b14 100644
--- a/lib/matplotlib/tests/test_ticker.py
+++ b/lib/matplotlib/tests/test_ticker.py
@@ -130,6 +130,14 @@ def test_view_limits_round_numbers_with_offset(self):
             loc = mticker.MultipleLocator(base=3.147, offset=1.3)
             assert_almost_equal(loc.view_limits(-4, 4), (-4.994, 4.447))
 
+    def test_view_limits_single_bin(self):
+        """
+        Test that 'round_numbers' works properly with a single bin.
+        """
+        with mpl.rc_context({'axes.autolimit_mode': 'round_numbers'}):
+            loc = mticker.MaxNLocator(nbins=1)
+            assert_almost_equal(loc.view_limits(-2.3, 2.3), (-4, 4))
+
     def test_set_params(self):
         """
         Create multiple locator with 0.7 base, and change it to something else.
diff --git a/lib/matplotlib/ticker.py b/lib/matplotlib/ticker.py
index f042372a7be9..2b00937f9e29 100644
--- a/lib/matplotlib/ticker.py
+++ b/lib/matplotlib/ticker.py
@@ -2137,7 +2137,10 @@ def _raw_ticks(self, vmin, vmax):
             large_steps = large_steps & (floored_vmaxs >= _vmax)
 
         # Find index of smallest large step
-        istep = np.nonzero(large_steps)[0][0]
+        if any(large_steps):
+            istep = np.nonzero(large_steps)[0][0]
+        else:
+            istep = len(steps) - 1
 
         # Start at smallest of the steps greater than the raw step, and check
         # if it provides enough ticks. If not, work backwards through

From a251d42c1eedef63d5d14e731acc4c850e2aa08e Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Mon, 3 Jun 2024 13:03:21 +0200
Subject: [PATCH 1002/1120] Backport PR #28329: DOC: Add example for 3D
 intersecting planes

---
 .../examples/mplot3d/intersecting_planes.py   | 89 +++++++++++++++++++
 1 file changed, 89 insertions(+)
 create mode 100644 galleries/examples/mplot3d/intersecting_planes.py

diff --git a/galleries/examples/mplot3d/intersecting_planes.py b/galleries/examples/mplot3d/intersecting_planes.py
new file mode 100644
index 000000000000..b8aa08fd7e18
--- /dev/null
+++ b/galleries/examples/mplot3d/intersecting_planes.py
@@ -0,0 +1,89 @@
+"""
+===================
+Intersecting planes
+===================
+
+This examples demonstrates drawing intersecting planes in 3D. It is a generalization
+of :doc:`/gallery/mplot3d/imshow3d`.
+
+Drawing intersecting planes in `.mplot3d` is complicated, because `.mplot3d` is not a
+real 3D renderer, but only projects the Artists into 3D and draws them in the right
+order. This does not work correctly if Artists overlap each other mutually. In this
+example, we lift the problem of mutual overlap by segmenting the planes at their
+intersections, making four parts out of each plane.
+
+This examples only works correctly for planes that cut each other in haves. This
+limitation is intentional to keep the code more readable. Cutting at arbitrary
+positions would of course be possible but makes the code even more complex.
+Thus, this example is more a demonstration of the concept how to work around
+limitations of the 3D visualization, it's not a refined solution for drawing
+arbitrary intersecting planes, which you can copy-and-paste as is.
+"""
+import matplotlib.pyplot as plt
+import numpy as np
+
+
+def plot_quadrants(ax, array, fixed_coord, cmap):
+    """For a given 3d *array* plot a plane with *fixed_coord*, using four quadrants."""
+    nx, ny, nz = array.shape
+    index = {
+        'x': (nx // 2, slice(None), slice(None)),
+        'y': (slice(None), ny // 2, slice(None)),
+        'z': (slice(None), slice(None), nz // 2),
+    }[fixed_coord]
+    plane_data = array[index]
+
+    n0, n1 = plane_data.shape
+    quadrants = [
+        plane_data[:n0 // 2, :n1 // 2],
+        plane_data[:n0 // 2, n1 // 2:],
+        plane_data[n0 // 2:, :n1 // 2],
+        plane_data[n0 // 2:, n1 // 2:]
+    ]
+
+    min_val = array.min()
+    max_val = array.max()
+
+    cmap = plt.get_cmap(cmap)
+
+    for i, quadrant in enumerate(quadrants):
+        facecolors = cmap((quadrant - min_val) / (max_val - min_val))
+        if fixed_coord == 'x':
+            Y, Z = np.mgrid[0:ny // 2, 0:nz // 2]
+            X = nx // 2 * np.ones_like(Y)
+            Y_offset = (i // 2) * ny // 2
+            Z_offset = (i % 2) * nz // 2
+            ax.plot_surface(X, Y + Y_offset, Z + Z_offset, rstride=1, cstride=1,
+                            facecolors=facecolors, shade=False)
+        elif fixed_coord == 'y':
+            X, Z = np.mgrid[0:nx // 2, 0:nz // 2]
+            Y = ny // 2 * np.ones_like(X)
+            X_offset = (i // 2) * nx // 2
+            Z_offset = (i % 2) * nz // 2
+            ax.plot_surface(X + X_offset, Y, Z + Z_offset, rstride=1, cstride=1,
+                            facecolors=facecolors, shade=False)
+        elif fixed_coord == 'z':
+            X, Y = np.mgrid[0:nx // 2, 0:ny // 2]
+            Z = nz // 2 * np.ones_like(X)
+            X_offset = (i // 2) * nx // 2
+            Y_offset = (i % 2) * ny // 2
+            ax.plot_surface(X + X_offset, Y + Y_offset, Z, rstride=1, cstride=1,
+                            facecolors=facecolors, shade=False)
+
+
+def figure_3D_array_slices(array, cmap=None):
+    """Plot a 3d array using three intersecting centered planes."""
+    fig = plt.figure()
+    ax = fig.add_subplot(projection='3d')
+    ax.set_box_aspect(array.shape)
+    plot_quadrants(ax, array, 'x', cmap=cmap)
+    plot_quadrants(ax, array, 'y', cmap=cmap)
+    plot_quadrants(ax, array, 'z', cmap=cmap)
+    return fig, ax
+
+
+nx, ny, nz = 70, 100, 50
+r_square = (np.mgrid[-1:1:1j * nx, -1:1:1j * ny, -1:1:1j * nz] ** 2).sum(0)
+
+figure_3D_array_slices(r_square, cmap='viridis_r')
+plt.show()

From 75ac1bdaab50c617a151b7a1d76450a4b05b596f Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Mon, 3 Jun 2024 12:14:13 -0400
Subject: [PATCH 1003/1120] Backport PR #28332: Call IPython.enable_gui when
 install repl displayhook

---
 lib/matplotlib/pyplot.py | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index a3ce60f01ef5..1a8298212709 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -304,10 +304,12 @@ def install_repl_displayhook() -> None:
         # This code can be removed when Python 3.12, the latest version supported by
         # IPython < 8.24, reaches end-of-life in late 2028.
         from IPython.core.pylabtools import backend2gui
-        # trigger IPython's eventloop integration, if available
         ipython_gui_name = backend2gui.get(get_backend())
-        if ipython_gui_name:
-            ip.enable_gui(ipython_gui_name)
+    else:
+        _, ipython_gui_name = backend_registry.resolve_backend(get_backend())
+    # trigger IPython's eventloop integration, if available
+    if ipython_gui_name:
+        ip.enable_gui(ipython_gui_name)
 
 
 def uninstall_repl_displayhook() -> None:

From 0fae2283dfe2ba5653166c44fe8a03772254c85b Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Mon, 3 Jun 2024 19:51:19 -0400
Subject: [PATCH 1004/1120] Backport PR #28336: DOC: Add version warning banner
 for docs versions different from stable

---
 doc/_static/switcher.json | 3 ++-
 doc/conf.py               | 1 +
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/doc/_static/switcher.json b/doc/_static/switcher.json
index 6996d79bc22a..3d712e4ff8e9 100644
--- a/doc/_static/switcher.json
+++ b/doc/_static/switcher.json
@@ -2,7 +2,8 @@
     {
         "name": "3.9 (stable)",
         "version": "stable",
-        "url": "https://matplotlib.org/stable/"
+        "url": "https://matplotlib.org/stable/",
+        "preferred": true
     },
     {
         "name": "3.10 (dev)",
diff --git a/doc/conf.py b/doc/conf.py
index c9a475aecf9c..92d78f896ca2 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -508,6 +508,7 @@ def js_tag_with_cache_busting(js):
     # this special value indicates the use of the unreleased banner. If we need
     # an actual announcement, then just place the text here as usual.
     "announcement": "unreleased" if not is_release_build else "",
+    "show_version_warning_banner": True,
 }
 include_analytics = is_release_build
 if include_analytics:

From 7278380444dd50bfa41302ced547ea779b5d3418 Mon Sep 17 00:00:00 2001
From: Eytan Adler <63426601+eytanadler@users.noreply.github.com>
Date: Wed, 5 Jun 2024 17:34:21 -0400
Subject: [PATCH 1005/1120] Backport PR #28307: DOC: New color line by value
 example

---
 .../multicolored_line.py                      | 205 +++++++++++++++---
 1 file changed, 173 insertions(+), 32 deletions(-)

diff --git a/galleries/examples/lines_bars_and_markers/multicolored_line.py b/galleries/examples/lines_bars_and_markers/multicolored_line.py
index 5d0727e69181..3d14ecaf8567 100644
--- a/galleries/examples/lines_bars_and_markers/multicolored_line.py
+++ b/galleries/examples/lines_bars_and_markers/multicolored_line.py
@@ -3,47 +3,188 @@
 Multicolored lines
 ==================
 
-This example shows how to make a multicolored line. In this example, the line
-is colored based on its derivative.
+The example shows two ways to plot a line with the a varying color defined by
+a third value. The first example defines the color at each (x, y) point.
+The second example defines the color between pairs of points, so the length
+of the color value list is one less than the length of the x and y lists.
+
+Color values at points
+----------------------
+
 """
 
+import warnings
+
 import matplotlib.pyplot as plt
 import numpy as np
 
 from matplotlib.collections import LineCollection
-from matplotlib.colors import BoundaryNorm, ListedColormap
 
+
+def colored_line(x, y, c, ax, **lc_kwargs):
+    """
+    Plot a line with a color specified along the line by a third value.
+
+    It does this by creating a collection of line segments. Each line segment is
+    made up of two straight lines each connecting the current (x, y) point to the
+    midpoints of the lines connecting the current point with its two neighbors.
+    This creates a smooth line with no gaps between the line segments.
+
+    Parameters
+    ----------
+    x, y : array-like
+        The horizontal and vertical coordinates of the data points.
+    c : array-like
+        The color values, which should be the same size as x and y.
+    ax : Axes
+        Axis object on which to plot the colored line.
+    **lc_kwargs
+        Any additional arguments to pass to matplotlib.collections.LineCollection
+        constructor. This should not include the array keyword argument because
+        that is set to the color argument. If provided, it will be overridden.
+
+    Returns
+    -------
+    matplotlib.collections.LineCollection
+        The generated line collection representing the colored line.
+    """
+    if "array" in lc_kwargs:
+        warnings.warn('The provided "array" keyword argument will be overridden')
+
+    # Default the capstyle to butt so that the line segments smoothly line up
+    default_kwargs = {"capstyle": "butt"}
+    default_kwargs.update(lc_kwargs)
+
+    # Compute the midpoints of the line segments. Include the first and last points
+    # twice so we don't need any special syntax later to handle them.
+    x = np.asarray(x)
+    y = np.asarray(y)
+    x_midpts = np.hstack((x[0], 0.5 * (x[1:] + x[:-1]), x[-1]))
+    y_midpts = np.hstack((y[0], 0.5 * (y[1:] + y[:-1]), y[-1]))
+
+    # Determine the start, middle, and end coordinate pair of each line segment.
+    # Use the reshape to add an extra dimension so each pair of points is in its
+    # own list. Then concatenate them to create:
+    # [
+    #   [(x1_start, y1_start), (x1_mid, y1_mid), (x1_end, y1_end)],
+    #   [(x2_start, y2_start), (x2_mid, y2_mid), (x2_end, y2_end)],
+    #   ...
+    # ]
+    coord_start = np.column_stack((x_midpts[:-1], y_midpts[:-1]))[:, np.newaxis, :]
+    coord_mid = np.column_stack((x, y))[:, np.newaxis, :]
+    coord_end = np.column_stack((x_midpts[1:], y_midpts[1:]))[:, np.newaxis, :]
+    segments = np.concatenate((coord_start, coord_mid, coord_end), axis=1)
+
+    lc = LineCollection(segments, **default_kwargs)
+    lc.set_array(c)  # set the colors of each segment
+
+    return ax.add_collection(lc)
+
+
+# -------------- Create and show plot --------------
+# Some arbitrary function that gives x, y, and color values
+t = np.linspace(-7.4, -0.5, 200)
+x = 0.9 * np.sin(t)
+y = 0.9 * np.cos(1.6 * t)
+color = np.linspace(0, 2, t.size)
+
+# Create a figure and plot the line on it
+fig1, ax1 = plt.subplots()
+lines = colored_line(x, y, color, ax1, linewidth=10, cmap="plasma")
+fig1.colorbar(lines)  # add a color legend
+
+# Set the axis limits and tick positions
+ax1.set_xlim(-1, 1)
+ax1.set_ylim(-1, 1)
+ax1.set_xticks((-1, 0, 1))
+ax1.set_yticks((-1, 0, 1))
+ax1.set_title("Color at each point")
+
+plt.show()
+
+####################################################################
+# This method is designed to give a smooth impression when distances and color
+# differences between adjacent points are not too large. The following example
+# does not meet this criteria and by that serves to illustrate the segmentation
+# and coloring mechanism.
+x = [0, 1, 2, 3, 4]
+y = [0, 1, 2, 1, 1]
+c = [1, 2, 3, 4, 5]
+fig, ax = plt.subplots()
+ax.scatter(x, y, c=c, cmap='rainbow')
+colored_line(x, y, c=c, ax=ax, cmap='rainbow')
+
+plt.show()
+
+####################################################################
+# Color values between points
+# ---------------------------
+#
+
+
+def colored_line_between_pts(x, y, c, ax, **lc_kwargs):
+    """
+    Plot a line with a color specified between (x, y) points by a third value.
+
+    It does this by creating a collection of line segments between each pair of
+    neighboring points. The color of each segment is determined by the
+    made up of two straight lines each connecting the current (x, y) point to the
+    midpoints of the lines connecting the current point with its two neighbors.
+    This creates a smooth line with no gaps between the line segments.
+
+    Parameters
+    ----------
+    x, y : array-like
+        The horizontal and vertical coordinates of the data points.
+    c : array-like
+        The color values, which should have a size one less than that of x and y.
+    ax : Axes
+        Axis object on which to plot the colored line.
+    **lc_kwargs
+        Any additional arguments to pass to matplotlib.collections.LineCollection
+        constructor. This should not include the array keyword argument because
+        that is set to the color argument. If provided, it will be overridden.
+
+    Returns
+    -------
+    matplotlib.collections.LineCollection
+        The generated line collection representing the colored line.
+    """
+    if "array" in lc_kwargs:
+        warnings.warn('The provided "array" keyword argument will be overridden')
+
+    # Check color array size (LineCollection still works, but values are unused)
+    if len(c) != len(x) - 1:
+        warnings.warn(
+            "The c argument should have a length one less than the length of x and y. "
+            "If it has the same length, use the colored_line function instead."
+        )
+
+    # Create a set of line segments so that we can color them individually
+    # This creates the points as an N x 1 x 2 array so that we can stack points
+    # together easily to get the segments. The segments array for line collection
+    # needs to be (numlines) x (points per line) x 2 (for x and y)
+    points = np.array([x, y]).T.reshape(-1, 1, 2)
+    segments = np.concatenate([points[:-1], points[1:]], axis=1)
+    lc = LineCollection(segments, **lc_kwargs)
+
+    # Set the values used for colormapping
+    lc.set_array(c)
+
+    return ax.add_collection(lc)
+
+
+# -------------- Create and show plot --------------
 x = np.linspace(0, 3 * np.pi, 500)
 y = np.sin(x)
 dydx = np.cos(0.5 * (x[:-1] + x[1:]))  # first derivative
 
-# Create a set of line segments so that we can color them individually
-# This creates the points as an N x 1 x 2 array so that we can stack points
-# together easily to get the segments. The segments array for line collection
-# needs to be (numlines) x (points per line) x 2 (for x and y)
-points = np.array([x, y]).T.reshape(-1, 1, 2)
-segments = np.concatenate([points[:-1], points[1:]], axis=1)
-
-fig, axs = plt.subplots(2, 1, sharex=True, sharey=True)
-
-# Create a continuous norm to map from data points to colors
-norm = plt.Normalize(dydx.min(), dydx.max())
-lc = LineCollection(segments, cmap='viridis', norm=norm)
-# Set the values used for colormapping
-lc.set_array(dydx)
-lc.set_linewidth(2)
-line = axs[0].add_collection(lc)
-fig.colorbar(line, ax=axs[0])
-
-# Use a boundary norm instead
-cmap = ListedColormap(['r', 'g', 'b'])
-norm = BoundaryNorm([-1, -0.5, 0.5, 1], cmap.N)
-lc = LineCollection(segments, cmap=cmap, norm=norm)
-lc.set_array(dydx)
-lc.set_linewidth(2)
-line = axs[1].add_collection(lc)
-fig.colorbar(line, ax=axs[1])
-
-axs[0].set_xlim(x.min(), x.max())
-axs[0].set_ylim(-1.1, 1.1)
+fig2, ax2 = plt.subplots()
+line = colored_line_between_pts(x, y, dydx, ax2, linewidth=2, cmap="viridis")
+fig2.colorbar(line, ax=ax2, label="dy/dx")
+
+ax2.set_xlim(x.min(), x.max())
+ax2.set_ylim(-1.1, 1.1)
+ax2.set_title("Color between points")
+
 plt.show()

From 60197c50f948967e82d16023460d3fb3f13d4698 Mon Sep 17 00:00:00 2001
From: Greg Lucas <greg.m.lucas@gmail.com>
Date: Sat, 8 Jun 2024 15:14:30 -0600
Subject: [PATCH 1006/1120] Backport PR #28337: Bump the actions group across 1
 directory with 3 updates

---
 .github/workflows/cibuildwheel.yml  | 12 ++++++------
 .github/workflows/conflictcheck.yml |  2 +-
 2 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 04c70a767ce0..41f5bca65f18 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -135,7 +135,7 @@ jobs:
           path: dist/
 
       - name: Build wheels for CPython 3.12
-        uses: pypa/cibuildwheel@711a3d017d0729f3edde18545fee967f03d65f65  # v2.18.0
+        uses: pypa/cibuildwheel@ba8be0d98853f5744f24e7f902c8adef7ae2e7f3  # v2.18.1
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -143,7 +143,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.11
-        uses: pypa/cibuildwheel@711a3d017d0729f3edde18545fee967f03d65f65  # v2.18.0
+        uses: pypa/cibuildwheel@ba8be0d98853f5744f24e7f902c8adef7ae2e7f3  # v2.18.1
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -151,7 +151,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.10
-        uses: pypa/cibuildwheel@711a3d017d0729f3edde18545fee967f03d65f65  # v2.18.0
+        uses: pypa/cibuildwheel@ba8be0d98853f5744f24e7f902c8adef7ae2e7f3  # v2.18.1
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -159,7 +159,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.9
-        uses: pypa/cibuildwheel@711a3d017d0729f3edde18545fee967f03d65f65  # v2.18.0
+        uses: pypa/cibuildwheel@ba8be0d98853f5744f24e7f902c8adef7ae2e7f3  # v2.18.1
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -167,7 +167,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for PyPy
-        uses: pypa/cibuildwheel@711a3d017d0729f3edde18545fee967f03d65f65  # v2.18.0
+        uses: pypa/cibuildwheel@ba8be0d98853f5744f24e7f902c8adef7ae2e7f3  # v2.18.1
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -203,7 +203,7 @@ jobs:
         run: ls dist
 
       - name: Generate artifact attestation for sdist and wheel
-        uses: actions/attest-build-provenance@173725a1209d09b31f9d30a3890cf2757ebbff0d  # v1.1.2
+        uses: actions/attest-build-provenance@49df96e17e918a15956db358890b08e61c704919  # v1.2.0
         with:
           subject-path: dist/matplotlib-*
 
diff --git a/.github/workflows/conflictcheck.yml b/.github/workflows/conflictcheck.yml
index fc759f52a6b0..3110839e5150 100644
--- a/.github/workflows/conflictcheck.yml
+++ b/.github/workflows/conflictcheck.yml
@@ -17,7 +17,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Check if PRs have merge conflicts
-        uses: eps1lon/actions-label-merge-conflict@6d74047dcef155976a15e4a124dde2c7fe0c5522  # v3.0.1
+        uses: eps1lon/actions-label-merge-conflict@1b1b1fcde06a9b3d089f3464c96417961dde1168  # v3.0.2
         with:
           dirtyLabel: "status: needs rebase"
           repoToken: "${{ secrets.GITHUB_TOKEN }}"

From 394b5539dc337b54f8a730ec126cc7fcb4fdf73c Mon Sep 17 00:00:00 2001
From: Scott Shambaugh <14363975+scottshambaugh@users.noreply.github.com>
Date: Mon, 10 Jun 2024 10:39:28 -0600
Subject: [PATCH 1007/1120] Backport PR #28359: Document that axes unsharing is
 impossible.

---
 lib/matplotlib/axes/_base.py       |  7 ++++---
 lib/matplotlib/figure.py           |  2 ++
 lib/matplotlib/pyplot.py           |  5 +++--
 lib/mpl_toolkits/mplot3d/axes3d.py | 14 ++++++++------
 4 files changed, 17 insertions(+), 11 deletions(-)

diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index 0164f4e11169..30c4efe80c49 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -597,7 +597,8 @@ def __init__(self, fig,
 
         sharex, sharey : `~matplotlib.axes.Axes`, optional
             The x- or y-`~.matplotlib.axis` is shared with the x- or y-axis in
-            the input `~.axes.Axes`.
+            the input `~.axes.Axes`.  Note that it is not possible to unshare
+            axes.
 
         frameon : bool, default: True
             Whether the Axes frame is visible.
@@ -1221,7 +1222,7 @@ def sharex(self, other):
 
         This is equivalent to passing ``sharex=other`` when constructing the
         Axes, and cannot be used if the x-axis is already being shared with
-        another Axes.
+        another Axes.  Note that it is not possible to unshare axes.
         """
         _api.check_isinstance(_AxesBase, other=other)
         if self._sharex is not None and other is not self._sharex:
@@ -1240,7 +1241,7 @@ def sharey(self, other):
 
         This is equivalent to passing ``sharey=other`` when constructing the
         Axes, and cannot be used if the y-axis is already being shared with
-        another Axes.
+        another Axes.  Note that it is not possible to unshare axes.
         """
         _api.check_isinstance(_AxesBase, other=other)
         if self._sharey is not None and other is not self._sharey:
diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
index 0a0ff01a2571..e5f4bb9421cf 100644
--- a/lib/matplotlib/figure.py
+++ b/lib/matplotlib/figure.py
@@ -755,6 +755,8 @@ def subplots(self, nrows=1, ncols=1, *, sharex=False, sharey=False,
             When subplots have a shared axis that has units, calling
             `.Axis.set_units` will update each axis with the new units.
 
+            Note that it is not possible to unshare axes.
+
         squeeze : bool, default: True
             - If True, extra dimensions are squeezed out from the returned
               array of Axes:
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 1a8298212709..7f8d0bbc6e7f 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -1639,8 +1639,9 @@ def subplots(
         on, use `~matplotlib.axes.Axes.tick_params`.
 
         When subplots have a shared axis that has units, calling
-        `~matplotlib.axis.Axis.set_units` will update each axis with the
-        new units.
+        `.Axis.set_units` will update each axis with the new units.
+
+        Note that it is not possible to unshare axes.
 
     squeeze : bool, default: True
         - If True, extra dimensions are squeezed out from the returned
diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index 18b823ccccb3..91845748880b 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -83,7 +83,8 @@ def __init__(
             axis. A positive angle spins the camera clockwise, causing the
             scene to rotate counter-clockwise.
         sharez : Axes3D, optional
-            Other Axes to share z-limits with.
+            Other Axes to share z-limits with.  Note that it is not possible to
+            unshare axes.
         proj_type : {'persp', 'ortho'}
             The projection type, default 'persp'.
         box_aspect : 3-tuple of floats, default: None
@@ -107,7 +108,8 @@ def __init__(
             The focal length can be computed from a desired Field Of View via
             the equation: focal_length = 1/tan(FOV/2)
         shareview : Axes3D, optional
-            Other Axes to share view angles with.
+            Other Axes to share view angles with.  Note that it is not possible
+            to unshare axes.
 
         **kwargs
             Other optional keyword arguments:
@@ -1307,7 +1309,7 @@ def sharez(self, other):
 
         This is equivalent to passing ``sharez=other`` when constructing the
         Axes, and cannot be used if the z-axis is already being shared with
-        another Axes.
+        another Axes.  Note that it is not possible to unshare axes.
         """
         _api.check_isinstance(Axes3D, other=other)
         if self._sharez is not None and other is not self._sharez:
@@ -1324,9 +1326,9 @@ def shareview(self, other):
         """
         Share the view angles with *other*.
 
-        This is equivalent to passing ``shareview=other`` when
-        constructing the Axes, and cannot be used if the view angles are
-        already being shared with another Axes.
+        This is equivalent to passing ``shareview=other`` when constructing the
+        Axes, and cannot be used if the view angles are already being shared
+        with another Axes.  Note that it is not possible to unshare axes.
         """
         _api.check_isinstance(Axes3D, other=other)
         if self._shareview is not None and other is not self._shareview:

From 35f38de2359963bbb5bb193070547fc059ae15b3 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Wed, 12 Jun 2024 16:20:13 -0500
Subject: [PATCH 1008/1120] Backport PR #28377: DOC: Clarify scope of wrap.

---
 lib/matplotlib/text.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/lib/matplotlib/text.py b/lib/matplotlib/text.py
index 40cd8c8cd6f7..7fc19c042a1f 100644
--- a/lib/matplotlib/text.py
+++ b/lib/matplotlib/text.py
@@ -606,6 +606,10 @@ def set_wrap(self, wrap):
         """
         Set whether the text can be wrapped.
 
+        Wrapping makes sure the text is completely within the figure box, i.e.
+        it does not extend beyond the drawing area. It does not take into
+        account any other artists.
+
         Parameters
         ----------
         wrap : bool

From 1099476c3ae3b855607f3a6c6d454d0a2c44aaf8 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Thu, 13 Jun 2024 15:36:01 +0200
Subject: [PATCH 1009/1120] Backport PR #28380: Remove outdated docstring
 section in RendererBase.draw_text.

---
 lib/matplotlib/backend_bases.py | 14 --------------
 1 file changed, 14 deletions(-)

diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
index f4273bc03919..53e5f6b23213 100644
--- a/lib/matplotlib/backend_bases.py
+++ b/lib/matplotlib/backend_bases.py
@@ -513,21 +513,7 @@ def draw_text(self, gc, x, y, s, prop, angle, ismath=False, mtext=None):
             If True, use mathtext parser. If "TeX", use tex for rendering.
         mtext : `~matplotlib.text.Text`
             The original text object to be rendered.
-
-        Notes
-        -----
-        **Note for backend implementers:**
-
-        When you are trying to determine if you have gotten your bounding box
-        right (which is what enables the text layout/alignment to work
-        properly), it helps to change the line in text.py::
-
-            if 0: bbox_artist(self, renderer)
-
-        to if 1, and then the actual bounding box will be plotted along with
-        your text.
         """
-
         self._draw_text_as_path(gc, x, y, s, prop, angle, ismath)
 
     def _get_text_path_transform(self, x, y, s, prop, angle, ismath):

From 0ffc8c12352dd59cd08a36710888a945512a37a9 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 13 Jun 2024 17:36:34 -0400
Subject: [PATCH 1010/1120] Backport PR #28388: Allow duplicate (name, value)
 entry points for backends

---
 lib/matplotlib/backends/registry.py           |  7 +++++--
 lib/matplotlib/tests/test_backend_registry.py | 11 +++++++++++
 2 files changed, 16 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/backends/registry.py b/lib/matplotlib/backends/registry.py
index 19b4cba254ab..47d5f65e350e 100644
--- a/lib/matplotlib/backends/registry.py
+++ b/lib/matplotlib/backends/registry.py
@@ -168,8 +168,11 @@ def backward_compatible_entry_points(
     def _validate_and_store_entry_points(self, entries):
         # Validate and store entry points so that they can be used via matplotlib.use()
         # in the normal manner. Entry point names cannot be of module:// format, cannot
-        # shadow a built-in backend name, and cannot be duplicated.
-        for name, module in entries:
+        # shadow a built-in backend name, and there cannot be multiple entry points
+        # with the same name but different modules. Multiple entry points with the same
+        # name and value are permitted (it can sometimes happen outside of our control,
+        # see https://github.com/matplotlib/matplotlib/issues/28367).
+        for name, module in set(entries):
             name = name.lower()
             if name.startswith("module://"):
                 raise RuntimeError(
diff --git a/lib/matplotlib/tests/test_backend_registry.py b/lib/matplotlib/tests/test_backend_registry.py
index eaf8417e7a5f..141ffd69c266 100644
--- a/lib/matplotlib/tests/test_backend_registry.py
+++ b/lib/matplotlib/tests/test_backend_registry.py
@@ -121,6 +121,17 @@ def test_entry_point_name_duplicate(clear_backend_registry):
             [('some_name', 'module1'), ('some_name', 'module2')])
 
 
+def test_entry_point_identical(clear_backend_registry):
+    # Issue https://github.com/matplotlib/matplotlib/issues/28367
+    # Multiple entry points with the same name and value (value is the module)
+    # are acceptable.
+    n = len(backend_registry._name_to_module)
+    backend_registry._validate_and_store_entry_points(
+        [('some_name', 'some.module'), ('some_name', 'some.module')])
+    assert len(backend_registry._name_to_module) == n+1
+    assert backend_registry._name_to_module['some_name'] == 'module://some.module'
+
+
 def test_entry_point_name_is_module(clear_backend_registry):
     with pytest.raises(RuntimeError):
         backend_registry._validate_and_store_entry_points(

From da5c20f637b2c35b157b0da7f2d20bd5d689ddf2 Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Tue, 18 Jun 2024 11:17:53 +0100
Subject: [PATCH 1011/1120] Backport PR #28413: CI: update action that got
 moved org

---
 .github/workflows/circleci.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/circleci.yml b/.github/workflows/circleci.yml
index 8f9e3190c5e2..cfdf184b8666 100644
--- a/.github/workflows/circleci.yml
+++ b/.github/workflows/circleci.yml
@@ -10,7 +10,7 @@ jobs:
     name: Run CircleCI artifacts redirector
     steps:
       - name: GitHub Action step
-        uses: larsoner/circleci-artifacts-redirector-action@master
+        uses: scientific-python/circleci-artifacts-redirector-action@4e13a10d89177f4bfc8007a7064bdbeda848d8d1  # v1.0.0
         with:
           repo-token: ${{ secrets.GITHUB_TOKEN }}
           api-token: ${{ secrets.CIRCLECI_TOKEN }}

From 2c59ec6de4a13ac14343fc67aa57643bd9d674b9 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Tue, 18 Jun 2024 20:06:17 -0500
Subject: [PATCH 1012/1120] Backport PR #28414: Clean up obsolete widget code

---
 lib/matplotlib/widgets.py | 15 +--------------
 1 file changed, 1 insertion(+), 14 deletions(-)

diff --git a/lib/matplotlib/widgets.py b/lib/matplotlib/widgets.py
index eaa35e25440b..ed130e6854f2 100644
--- a/lib/matplotlib/widgets.py
+++ b/lib/matplotlib/widgets.py
@@ -1001,14 +1001,8 @@ class CheckButtons(AxesWidget):
     ----------
     ax : `~matplotlib.axes.Axes`
         The parent Axes for the widget.
-
     labels : list of `~matplotlib.text.Text`
-
-    rectangles : list of `~matplotlib.patches.Rectangle`
-
-    lines : list of (`.Line2D`, `.Line2D`) pairs
-        List of lines for the x's in the checkboxes.  These lines exist for
-        each box, but have ``set_visible(False)`` when its box is not checked.
+        The text label objects of the check buttons.
     """
 
     def __init__(self, ax, labels, actives=None, *, useblit=True,
@@ -1571,8 +1565,6 @@ class RadioButtons(AxesWidget):
         The color of the selected button.
     labels : list of `.Text`
         The button labels.
-    circles : list of `~.patches.Circle`
-        The buttons.
     value_selected : str
         The label text of the currently selected button.
     index_selected : int
@@ -1751,11 +1743,6 @@ def activecolor(self, activecolor):
         colors._check_color_like(activecolor=activecolor)
         self._activecolor = activecolor
         self.set_radio_props({'facecolor': activecolor})
-        # Make sure the deprecated version is updated.
-        # Remove once circles is removed.
-        labels = [label.get_text() for label in self.labels]
-        with cbook._setattr_cm(self, eventson=False):
-            self.set_active(labels.index(self.value_selected))
 
     def set_active(self, index):
         """

From f8f82060b0884645dc7b149ae22818160ca94b23 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Wed, 19 Jun 2024 11:57:02 +0200
Subject: [PATCH 1013/1120] Backport PR #28401: FIX: Fix text wrapping

---
 lib/matplotlib/tests/test_text.py |  9 +++++++--
 lib/matplotlib/text.py            | 13 ++++++-------
 2 files changed, 13 insertions(+), 9 deletions(-)

diff --git a/lib/matplotlib/tests/test_text.py b/lib/matplotlib/tests/test_text.py
index f8837d8a5f1b..8904337f68ba 100644
--- a/lib/matplotlib/tests/test_text.py
+++ b/lib/matplotlib/tests/test_text.py
@@ -15,6 +15,7 @@
 from matplotlib.font_manager import FontProperties
 import matplotlib.patches as mpatches
 import matplotlib.pyplot as plt
+from matplotlib.gridspec import GridSpec
 import matplotlib.transforms as mtransforms
 from matplotlib.testing.decorators import check_figures_equal, image_comparison
 from matplotlib.testing._markers import needs_usetex
@@ -707,9 +708,13 @@ def test_large_subscript_title():
      (0.3, 0, 'right'),
      (0.3, 185, 'left')])
 def test_wrap(x, rotation, halign):
-    fig = plt.figure(figsize=(6, 6))
+    fig = plt.figure(figsize=(18, 18))
+    gs = GridSpec(nrows=3, ncols=3, figure=fig)
+    subfig = fig.add_subfigure(gs[1, 1])
+    # we only use the central subfigure, which does not align with any
+    # figure boundary, to ensure only subfigure boundaries are relevant
     s = 'This is a very long text that should be wrapped multiple times.'
-    text = fig.text(x, 0.7, s, wrap=True, rotation=rotation, ha=halign)
+    text = subfig.text(x, 0.7, s, wrap=True, rotation=rotation, ha=halign)
     fig.canvas.draw()
     assert text._get_wrapped_text() == ('This is a very long\n'
                                         'text that should be\n'
diff --git a/lib/matplotlib/text.py b/lib/matplotlib/text.py
index 7fc19c042a1f..af990ec1bf9f 100644
--- a/lib/matplotlib/text.py
+++ b/lib/matplotlib/text.py
@@ -606,9 +606,8 @@ def set_wrap(self, wrap):
         """
         Set whether the text can be wrapped.
 
-        Wrapping makes sure the text is completely within the figure box, i.e.
-        it does not extend beyond the drawing area. It does not take into
-        account any other artists.
+        Wrapping makes sure the text is confined to the (sub)figure box. It
+        does not take into account any other artists.
 
         Parameters
         ----------
@@ -657,16 +656,16 @@ def _get_dist_to_box(self, rotation, x0, y0, figure_box):
         """
         if rotation > 270:
             quad = rotation - 270
-            h1 = y0 / math.cos(math.radians(quad))
+            h1 = (y0 - figure_box.y0) / math.cos(math.radians(quad))
             h2 = (figure_box.x1 - x0) / math.cos(math.radians(90 - quad))
         elif rotation > 180:
             quad = rotation - 180
-            h1 = x0 / math.cos(math.radians(quad))
-            h2 = y0 / math.cos(math.radians(90 - quad))
+            h1 = (x0 - figure_box.x0) / math.cos(math.radians(quad))
+            h2 = (y0 - figure_box.y0) / math.cos(math.radians(90 - quad))
         elif rotation > 90:
             quad = rotation - 90
             h1 = (figure_box.y1 - y0) / math.cos(math.radians(quad))
-            h2 = x0 / math.cos(math.radians(90 - quad))
+            h2 = (x0 - figure_box.x0) / math.cos(math.radians(90 - quad))
         else:
             h1 = (figure_box.x1 - x0) / math.cos(math.radians(rotation))
             h2 = (figure_box.y1 - y0) / math.cos(math.radians(90 - rotation))

From f8ff4e1a9efceccf4b3bf14ade86d76851dfc678 Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Wed, 19 Jun 2024 17:32:17 +0100
Subject: [PATCH 1014/1120] Backport PR #28423: Update return type for
 Axes.axhspan and Axes.axvspan

---
 lib/matplotlib/axes/_axes.py  | 12 ++++++------
 lib/matplotlib/axes/_axes.pyi |  4 ++--
 lib/matplotlib/pyplot.py      |  4 ++--
 3 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 34c4023a256e..fdafc2dcb0bc 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -1006,14 +1006,14 @@ def axhspan(self, ymin, ymax, xmin=0, xmax=1, **kwargs):
 
         Returns
         -------
-        `~matplotlib.patches.Polygon`
+        `~matplotlib.patches.Rectangle`
             Horizontal span (rectangle) from (xmin, ymin) to (xmax, ymax).
 
         Other Parameters
         ----------------
-        **kwargs : `~matplotlib.patches.Polygon` properties
+        **kwargs : `~matplotlib.patches.Rectangle` properties
 
-        %(Polygon:kwdoc)s
+        %(Rectangle:kwdoc)s
 
         See Also
         --------
@@ -1061,14 +1061,14 @@ def axvspan(self, xmin, xmax, ymin=0, ymax=1, **kwargs):
 
         Returns
         -------
-        `~matplotlib.patches.Polygon`
+        `~matplotlib.patches.Rectangle`
             Vertical span (rectangle) from (xmin, ymin) to (xmax, ymax).
 
         Other Parameters
         ----------------
-        **kwargs : `~matplotlib.patches.Polygon` properties
+        **kwargs : `~matplotlib.patches.Rectangle` properties
 
-        %(Polygon:kwdoc)s
+        %(Rectangle:kwdoc)s
 
         See Also
         --------
diff --git a/lib/matplotlib/axes/_axes.pyi b/lib/matplotlib/axes/_axes.pyi
index b70d330aa442..76aaee77aff8 100644
--- a/lib/matplotlib/axes/_axes.pyi
+++ b/lib/matplotlib/axes/_axes.pyi
@@ -155,10 +155,10 @@ class Axes(_AxesBase):
     ) -> AxLine: ...
     def axhspan(
         self, ymin: float, ymax: float, xmin: float = ..., xmax: float = ..., **kwargs
-    ) -> Polygon: ...
+    ) -> Rectangle: ...
     def axvspan(
         self, xmin: float, xmax: float, ymin: float = ..., ymax: float = ..., **kwargs
-    ) -> Polygon: ...
+    ) -> Rectangle: ...
     def hlines(
         self,
         y: float | ArrayLike,
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 7f8d0bbc6e7f..8fe8b000bf49 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -2870,7 +2870,7 @@ def axhline(y: float = 0, xmin: float = 0, xmax: float = 1, **kwargs) -> Line2D:
 @_copy_docstring_and_deprecators(Axes.axhspan)
 def axhspan(
     ymin: float, ymax: float, xmin: float = 0, xmax: float = 1, **kwargs
-) -> Polygon:
+) -> Rectangle:
     return gca().axhspan(ymin, ymax, xmin=xmin, xmax=xmax, **kwargs)
 
 
@@ -2908,7 +2908,7 @@ def axvline(x: float = 0, ymin: float = 0, ymax: float = 1, **kwargs) -> Line2D:
 @_copy_docstring_and_deprecators(Axes.axvspan)
 def axvspan(
     xmin: float, xmax: float, ymin: float = 0, ymax: float = 1, **kwargs
-) -> Polygon:
+) -> Rectangle:
     return gca().axvspan(xmin, xmax, ymin=ymin, ymax=ymax, **kwargs)
 
 

From 8bf8cf59dca11764f44d14a461879ca34fe2991d Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Wed, 19 Jun 2024 14:06:20 -0500
Subject: [PATCH 1015/1120] Backport PR #28425: Fix Circle yaml line length

---
 .github/workflows/circleci.yml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/circleci.yml b/.github/workflows/circleci.yml
index cfdf184b8666..4e5733e03466 100644
--- a/.github/workflows/circleci.yml
+++ b/.github/workflows/circleci.yml
@@ -10,7 +10,8 @@ jobs:
     name: Run CircleCI artifacts redirector
     steps:
       - name: GitHub Action step
-        uses: scientific-python/circleci-artifacts-redirector-action@4e13a10d89177f4bfc8007a7064bdbeda848d8d1  # v1.0.0
+        uses: | #v1.0.0
+          scientific-python/circleci-artifacts-redirector-action@4e13a10d89177f4bfc8007a7064bdbeda848d8d1
         with:
           repo-token: ${{ secrets.GITHUB_TOKEN }}
           api-token: ${{ secrets.CIRCLECI_TOKEN }}

From f8d15bdac2c85a55e976278392fbe7022ef521f7 Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Thu, 20 Jun 2024 10:14:59 +0100
Subject: [PATCH 1016/1120] Backport PR #28427: Fix circleci yaml

---
 .github/workflows/circleci.yml | 4 ++--
 .yamllint.yml                  | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/circleci.yml b/.github/workflows/circleci.yml
index 4e5733e03466..3aead720cf20 100644
--- a/.github/workflows/circleci.yml
+++ b/.github/workflows/circleci.yml
@@ -10,8 +10,8 @@ jobs:
     name: Run CircleCI artifacts redirector
     steps:
       - name: GitHub Action step
-        uses: | #v1.0.0
-          scientific-python/circleci-artifacts-redirector-action@4e13a10d89177f4bfc8007a7064bdbeda848d8d1
+        uses:
+          scientific-python/circleci-artifacts-redirector-action@4e13a10d89177f4bfc8007a7064bdbeda848d8d1  # v1.0.0
         with:
           repo-token: ${{ secrets.GITHUB_TOKEN }}
           api-token: ${{ secrets.CIRCLECI_TOKEN }}
diff --git a/.yamllint.yml b/.yamllint.yml
index 3b30533ececa..2be81b28c7fb 100644
--- a/.yamllint.yml
+++ b/.yamllint.yml
@@ -3,7 +3,7 @@ extends: default
 
 rules:
   line-length:
-    max: 111
+    max: 120
     allow-non-breakable-words: true
   truthy:
     check-keys: false

From c747ac444db273bdd93f894825b4d32671c998b4 Mon Sep 17 00:00:00 2001
From: Scott Shambaugh <14363975+scottshambaugh@users.noreply.github.com>
Date: Mon, 24 Jun 2024 07:29:12 -0600
Subject: [PATCH 1017/1120] Backport PR #28403: FIX: Autoscale support in
 add_collection3d for Line3DCollection and Poly3DCollection

---
 lib/mpl_toolkits/mplot3d/axes3d.py            |  29 +++++++++++++--
 .../test_axes3d/voxels-named-colors.png       | Bin 59278 -> 54173 bytes
 lib/mpl_toolkits/mplot3d/tests/test_axes3d.py |  34 +++++++++++++++---
 3 files changed, 57 insertions(+), 6 deletions(-)

diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
index 91845748880b..71cd8f062d40 100644
--- a/lib/mpl_toolkits/mplot3d/axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -2578,7 +2578,7 @@ def tricontourf(self, *args, zdir='z', offset=None, **kwargs):
         self._auto_scale_contourf(X, Y, Z, zdir, levels, had_data)
         return cset
 
-    def add_collection3d(self, col, zs=0, zdir='z'):
+    def add_collection3d(self, col, zs=0, zdir='z', autolim=True):
         """
         Add a 3D collection object to the plot.
 
@@ -2590,8 +2590,21 @@ def add_collection3d(self, col, zs=0, zdir='z'):
 
         - `.PolyCollection`
         - `.LineCollection`
-        - `.PatchCollection`
+        - `.PatchCollection` (currently not supporting *autolim*)
+
+        Parameters
+        ----------
+        col : `.Collection`
+            A 2D collection object.
+        zs : float or array-like, default: 0
+            The z-positions to be used for the 2D objects.
+        zdir : {'x', 'y', 'z'}, default: 'z'
+            The direction to use for the z-positions.
+        autolim : bool, default: True
+            Whether to update the data limits.
         """
+        had_data = self.has_data()
+
         zvals = np.atleast_1d(zs)
         zsortval = (np.min(zvals) if zvals.size
                     else 0)  # FIXME: arbitrary default
@@ -2609,6 +2622,18 @@ def add_collection3d(self, col, zs=0, zdir='z'):
             art3d.patch_collection_2d_to_3d(col, zs=zs, zdir=zdir)
             col.set_sort_zpos(zsortval)
 
+        if autolim:
+            if isinstance(col, art3d.Line3DCollection):
+                self.auto_scale_xyz(*np.array(col._segments3d).transpose(),
+                                    had_data=had_data)
+            elif isinstance(col, art3d.Poly3DCollection):
+                self.auto_scale_xyz(*col._vec[:-1], had_data=had_data)
+            elif isinstance(col, art3d.Patch3DCollection):
+                pass
+                # FIXME: Implement auto-scaling function for Patch3DCollection
+                # Currently unable to do so due to issues with Patch3DCollection
+                # See https://github.com/matplotlib/matplotlib/issues/14298 for details
+
         collection = super().add_collection(col)
         return collection
 
diff --git a/lib/mpl_toolkits/mplot3d/tests/baseline_images/test_axes3d/voxels-named-colors.png b/lib/mpl_toolkits/mplot3d/tests/baseline_images/test_axes3d/voxels-named-colors.png
index b71ad19c1608b06b33e51a5ae3ada23fbbc06278..33dfc2f2313ad100797b89136555b8fc9e593a2f 100644
GIT binary patch
literal 54173
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
Jzf-jg|3BzpibMba

literal 59278
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
ZG`Ib9x_e|QYtjNgQ4!n18$^4){0jl~Hn0Ey

diff --git a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
index 34f10cb9fd63..ecb51b724c27 100644
--- a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
@@ -961,8 +961,8 @@ def test_poly3dcollection_closed():
                                 facecolor=(0.5, 0.5, 1, 0.5), closed=True)
     c2 = art3d.Poly3DCollection([poly2], linewidths=3, edgecolor='k',
                                 facecolor=(1, 0.5, 0.5, 0.5), closed=False)
-    ax.add_collection3d(c1)
-    ax.add_collection3d(c2)
+    ax.add_collection3d(c1, autolim=False)
+    ax.add_collection3d(c2, autolim=False)
 
 
 def test_poly_collection_2d_to_3d_empty():
@@ -995,8 +995,8 @@ def test_poly3dcollection_alpha():
     c2.set_facecolor((1, 0.5, 0.5))
     c2.set_edgecolor('k')
     c2.set_alpha(0.5)
-    ax.add_collection3d(c1)
-    ax.add_collection3d(c2)
+    ax.add_collection3d(c1, autolim=False)
+    ax.add_collection3d(c2, autolim=False)
 
 
 @mpl3d_image_comparison(['add_collection3d_zs_array.png'], style='mpl20')
@@ -1055,6 +1055,32 @@ def test_add_collection3d_zs_scalar():
     ax.set_zlim(0, 2)
 
 
+def test_line3dCollection_autoscaling():
+    fig = plt.figure()
+    ax = fig.add_subplot(projection='3d')
+
+    lines = [[(0, 0, 0), (1, 4, 2)],
+             [(1, 1, 3), (2, 0, 2)],
+             [(1, 0, 4), (1, 4, 5)]]
+
+    lc = art3d.Line3DCollection(lines)
+    ax.add_collection3d(lc)
+    assert np.allclose(ax.get_xlim3d(), (-0.041666666666666664, 2.0416666666666665))
+    assert np.allclose(ax.get_ylim3d(), (-0.08333333333333333, 4.083333333333333))
+    assert np.allclose(ax.get_zlim3d(), (-0.10416666666666666, 5.104166666666667))
+
+
+def test_poly3dCollection_autoscaling():
+    fig = plt.figure()
+    ax = fig.add_subplot(projection='3d')
+    poly = np.array([[0, 0, 0], [1, 1, 3], [1, 0, 4]])
+    col = art3d.Poly3DCollection([poly])
+    ax.add_collection3d(col)
+    assert np.allclose(ax.get_xlim3d(), (-0.020833333333333332, 1.0208333333333333))
+    assert np.allclose(ax.get_ylim3d(), (-0.020833333333333332, 1.0208333333333333))
+    assert np.allclose(ax.get_zlim3d(), (-0.0833333333333333, 4.083333333333333))
+
+
 @mpl3d_image_comparison(['axes3d_labelpad.png'],
                         remove_text=False, style='mpl20')
 def test_axes3d_labelpad():

From e46044db0fc6f159b461974b8e57c3e3a7f4e366 Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Mon, 24 Jun 2024 10:03:22 +0100
Subject: [PATCH 1018/1120] Backport PR #28441: MNT: Update basic units example
 to work with numpy 2.0

---
 galleries/examples/units/basic_units.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/galleries/examples/units/basic_units.py b/galleries/examples/units/basic_units.py
index 0b493ab7216c..f9a94bcf6e37 100644
--- a/galleries/examples/units/basic_units.py
+++ b/galleries/examples/units/basic_units.py
@@ -146,10 +146,10 @@ def __getattribute__(self, name):
             return getattr(variable, name)
         return object.__getattribute__(self, name)
 
-    def __array__(self, dtype=object):
+    def __array__(self, dtype=object, copy=False):
         return np.asarray(self.value, dtype)
 
-    def __array_wrap__(self, array, context):
+    def __array_wrap__(self, array, context=None, return_scalar=False):
         return TaggedValue(array, self.unit)
 
     def __repr__(self):
@@ -222,10 +222,10 @@ def __mul__(self, rhs):
     def __rmul__(self, lhs):
         return self*lhs
 
-    def __array_wrap__(self, array, context):
+    def __array_wrap__(self, array, context=None, return_scalar=False):
         return TaggedValue(array, self)
 
-    def __array__(self, t=None, context=None):
+    def __array__(self, t=None, context=None, copy=False):
         ret = np.array(1)
         if t is not None:
             return ret.astype(t)

From b0dba39b9082cf70f5c481775a03000d9b83dea4 Mon Sep 17 00:00:00 2001
From: "Lumberbot (aka Jack)"
 <39504233+meeseeksmachine@users.noreply.github.com>
Date: Mon, 24 Jun 2024 06:31:13 -0700
Subject: [PATCH 1019/1120] Backport PR #28436: Fix `is_color_like` for 2-tuple
 of strings and fix `to_rgba` for `(nth_color, alpha)` (#28438)

Co-authored-by: hannah <story645@gmail.com>
---
 lib/matplotlib/colors.py            | 12 ++++++------
 lib/matplotlib/tests/test_colors.py | 15 ++++++++++++++-
 2 files changed, 20 insertions(+), 7 deletions(-)

diff --git a/lib/matplotlib/colors.py b/lib/matplotlib/colors.py
index c4e5987fdf92..177557b371a6 100644
--- a/lib/matplotlib/colors.py
+++ b/lib/matplotlib/colors.py
@@ -225,7 +225,7 @@ def is_color_like(c):
         return True
     try:
         to_rgba(c)
-    except ValueError:
+    except (TypeError, ValueError):
         return False
     else:
         return True
@@ -296,6 +296,11 @@ def to_rgba(c, alpha=None):
         Tuple of floats ``(r, g, b, a)``, where each channel (red, green, blue,
         alpha) can assume values between 0 and 1.
     """
+    if isinstance(c, tuple) and len(c) == 2:
+        if alpha is None:
+            c, alpha = c
+        else:
+            c = c[0]
     # Special-case nth color syntax because it should not be cached.
     if _is_nth_color(c):
         prop_cycler = mpl.rcParams['axes.prop_cycle']
@@ -325,11 +330,6 @@ def _to_rgba_no_colorcycle(c, alpha=None):
     *alpha* is ignored for the color value ``"none"`` (case-insensitive),
     which always maps to ``(0, 0, 0, 0)``.
     """
-    if isinstance(c, tuple) and len(c) == 2:
-        if alpha is None:
-            c, alpha = c
-        else:
-            c = c[0]
     if alpha is not None and not 0 <= alpha <= 1:
         raise ValueError("'alpha' must be between 0 and 1, inclusive")
     orig_c = c
diff --git a/lib/matplotlib/tests/test_colors.py b/lib/matplotlib/tests/test_colors.py
index 63f2d4f00399..4fd9f86c06e3 100644
--- a/lib/matplotlib/tests/test_colors.py
+++ b/lib/matplotlib/tests/test_colors.py
@@ -19,7 +19,7 @@
 import matplotlib.scale as mscale
 from matplotlib.rcsetup import cycler
 from matplotlib.testing.decorators import image_comparison, check_figures_equal
-from matplotlib.colors import to_rgba_array
+from matplotlib.colors import is_color_like, to_rgba_array
 
 
 @pytest.mark.parametrize('N, result', [
@@ -1697,3 +1697,16 @@ def test_to_rgba_array_none_color_with_alpha_param():
     assert_array_equal(
         to_rgba_array(c, alpha), [[0., 0., 1., 1.], [0., 0., 0., 0.]]
     )
+
+
+@pytest.mark.parametrize('input, expected',
+                         [('red', True),
+                          (('red', 0.5), True),
+                          (('red', 2), False),
+                          (['red', 0.5], False),
+                          (('red', 'blue'), False),
+                          (['red', 'blue'], False),
+                          ('C3', True),
+                          (('C3', 0.5), True)])
+def test_is_color_like(input, expected):
+    assert is_color_like(input) is expected

From 9fd68931b5b7d07aa8c74c23cf65e10b6e5e5ef7 Mon Sep 17 00:00:00 2001
From: Greg Lucas <greg.m.lucas@gmail.com>
Date: Sun, 16 Jun 2024 06:50:16 -0600
Subject: [PATCH 1020/1120] Merge pull request #28371 from
 matplotlib/dependabot/github_actions/actions-795b56d292

Bump pypa/cibuildwheel from 2.18.1 to 2.19.0 in the actions group

(cherry picked from commit b3d29fb036b0d9de2fb66ee7bcad6887654b3706)
---
 .github/workflows/cibuildwheel.yml | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 41f5bca65f18..165f496c0b6e 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -135,7 +135,7 @@ jobs:
           path: dist/
 
       - name: Build wheels for CPython 3.12
-        uses: pypa/cibuildwheel@ba8be0d98853f5744f24e7f902c8adef7ae2e7f3  # v2.18.1
+        uses: pypa/cibuildwheel@a8d190a111314a07eb5116036c4b3fb26a4e3162  # v2.19.0
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -143,7 +143,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.11
-        uses: pypa/cibuildwheel@ba8be0d98853f5744f24e7f902c8adef7ae2e7f3  # v2.18.1
+        uses: pypa/cibuildwheel@a8d190a111314a07eb5116036c4b3fb26a4e3162  # v2.19.0
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -151,7 +151,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.10
-        uses: pypa/cibuildwheel@ba8be0d98853f5744f24e7f902c8adef7ae2e7f3  # v2.18.1
+        uses: pypa/cibuildwheel@a8d190a111314a07eb5116036c4b3fb26a4e3162  # v2.19.0
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -159,7 +159,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.9
-        uses: pypa/cibuildwheel@ba8be0d98853f5744f24e7f902c8adef7ae2e7f3  # v2.18.1
+        uses: pypa/cibuildwheel@a8d190a111314a07eb5116036c4b3fb26a4e3162  # v2.19.0
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -167,7 +167,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for PyPy
-        uses: pypa/cibuildwheel@ba8be0d98853f5744f24e7f902c8adef7ae2e7f3  # v2.18.1
+        uses: pypa/cibuildwheel@a8d190a111314a07eb5116036c4b3fb26a4e3162  # v2.19.0
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:

From 8f996742b0afd6aaa1eeedf28ba87376acd1da80 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Tue, 18 Jun 2024 20:08:00 -0500
Subject: [PATCH 1021/1120] Merge pull request #28411 from
 matplotlib/dependabot/github_actions/actions-39ddd2ba80

Bump the actions group with 3 updates

(cherry picked from commit 3bd23db8690707ecfb8cfa0ab12ff7258f031ad5)
---
 .github/workflows/cibuildwheel.yml | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 165f496c0b6e..a4c0c0781813 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -135,7 +135,7 @@ jobs:
           path: dist/
 
       - name: Build wheels for CPython 3.12
-        uses: pypa/cibuildwheel@a8d190a111314a07eb5116036c4b3fb26a4e3162  # v2.19.0
+        uses: pypa/cibuildwheel@932529cab190fafca8c735a551657247fa8f8eaf  # v2.19.1
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -143,7 +143,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.11
-        uses: pypa/cibuildwheel@a8d190a111314a07eb5116036c4b3fb26a4e3162  # v2.19.0
+        uses: pypa/cibuildwheel@932529cab190fafca8c735a551657247fa8f8eaf  # v2.19.1
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -151,7 +151,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.10
-        uses: pypa/cibuildwheel@a8d190a111314a07eb5116036c4b3fb26a4e3162  # v2.19.0
+        uses: pypa/cibuildwheel@932529cab190fafca8c735a551657247fa8f8eaf  # v2.19.1
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -159,7 +159,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.9
-        uses: pypa/cibuildwheel@a8d190a111314a07eb5116036c4b3fb26a4e3162  # v2.19.0
+        uses: pypa/cibuildwheel@932529cab190fafca8c735a551657247fa8f8eaf  # v2.19.1
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -167,7 +167,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for PyPy
-        uses: pypa/cibuildwheel@a8d190a111314a07eb5116036c4b3fb26a4e3162  # v2.19.0
+        uses: pypa/cibuildwheel@932529cab190fafca8c735a551657247fa8f8eaf  # v2.19.1
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -203,9 +203,9 @@ jobs:
         run: ls dist
 
       - name: Generate artifact attestation for sdist and wheel
-        uses: actions/attest-build-provenance@49df96e17e918a15956db358890b08e61c704919  # v1.2.0
+        uses: actions/attest-build-provenance@bdd51370e0416ac948727f861e03c2f05d32d78e  # v1.3.2
         with:
           subject-path: dist/matplotlib-*
 
       - name: Publish package distributions to PyPI
-        uses: pypa/gh-action-pypi-publish@81e9d935c883d0b210363ab89cf05f3894778450  # v1.8.14
+        uses: pypa/gh-action-pypi-publish@ec4db0b4ddc65acdf4bff5fa45ac92d78b56bdf0  # v1.9.0

From b14dc233fa189811b7092e1f478cdd7ae3db08a1 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Tue, 25 Jun 2024 17:41:27 -0400
Subject: [PATCH 1022/1120] Backport PR #28459: DOC: Document kwargs scope for
 tick setter functions

---
 lib/matplotlib/axis.py   |  4 +++-
 lib/matplotlib/pyplot.py | 29 +++++++++++++++++++++++++++++
 2 files changed, 32 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/axis.py b/lib/matplotlib/axis.py
index d317f6ec0567..3afc98fac60b 100644
--- a/lib/matplotlib/axis.py
+++ b/lib/matplotlib/axis.py
@@ -2028,7 +2028,9 @@ def set_ticklabels(self, labels, *, minor=False, fontdict=None, **kwargs):
 
             .. warning::
 
-                This only sets the properties of the current ticks.
+                This only sets the properties of the current ticks, which is
+                only sufficient for static plots.
+
                 Ticks are not guaranteed to be persistent. Various operations
                 can create, delete and modify the Tick instances. There is an
                 imminent risk that these settings can get lost if you work on
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 8fe8b000bf49..8b4769342c7d 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -2170,6 +2170,21 @@ def xticks(
     **kwargs
         `.Text` properties can be used to control the appearance of the labels.
 
+        .. warning::
+
+            This only sets the properties of the current ticks, which is
+            only sufficient if you either pass *ticks*, resulting in a
+            fixed list of ticks, or if the plot is static.
+
+            Ticks are not guaranteed to be persistent. Various operations
+            can create, delete and modify the Tick instances. There is an
+            imminent risk that these settings can get lost if you work on
+            the figure further (including also panning/zooming on a
+            displayed figure).
+
+            Use `~.pyplot.tick_params` instead if possible.
+
+
     Returns
     -------
     locs
@@ -2241,6 +2256,20 @@ def yticks(
     **kwargs
         `.Text` properties can be used to control the appearance of the labels.
 
+        .. warning::
+
+            This only sets the properties of the current ticks, which is
+            only sufficient if you either pass *ticks*, resulting in a
+            fixed list of ticks, or if the plot is static.
+
+            Ticks are not guaranteed to be persistent. Various operations
+            can create, delete and modify the Tick instances. There is an
+            imminent risk that these settings can get lost if you work on
+            the figure further (including also panning/zooming on a
+            displayed figure).
+
+            Use `~.pyplot.tick_params` instead if possible.
+
     Returns
     -------
     locs

From b8042eed7a106fb1a5bec645f6a830d9f4615c4b Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Tue, 25 Jun 2024 17:48:32 -0400
Subject: [PATCH 1023/1120] Backport PR #28458: Correct numpy dtype comparisons
 in image_resample

---
 lib/matplotlib/tests/test_image.py | 17 +++++++++++++++++
 src/_image_wrapper.cpp             | 24 ++++++++++++------------
 2 files changed, 29 insertions(+), 12 deletions(-)

diff --git a/lib/matplotlib/tests/test_image.py b/lib/matplotlib/tests/test_image.py
index 1602f86716cb..a043d3aec983 100644
--- a/lib/matplotlib/tests/test_image.py
+++ b/lib/matplotlib/tests/test_image.py
@@ -1585,3 +1585,20 @@ def test_non_transdata_image_does_not_touch_aspect():
     assert ax.get_aspect() == 1
     ax.imshow(im, transform=ax.transAxes, aspect=2)
     assert ax.get_aspect() == 2
+
+
+@pytest.mark.parametrize(
+    'dtype',
+    ('float64', 'float32', 'int16', 'uint16', 'int8', 'uint8'),
+)
+@pytest.mark.parametrize('ndim', (2, 3))
+def test_resample_dtypes(dtype, ndim):
+    # Issue 28448, incorrect dtype comparisons in C++ image_resample can raise
+    # ValueError: arrays must be of dtype byte, short, float32 or float64
+    rng = np.random.default_rng(4181)
+    shape = (2, 2) if ndim == 2 else (2, 2, 3)
+    data = rng.uniform(size=shape).astype(np.dtype(dtype, copy=True))
+    fig, ax = plt.subplots()
+    axes_image = ax.imshow(data)
+    # Before fix the following raises ValueError for some dtypes.
+    axes_image.make_image(None)[0]
diff --git a/src/_image_wrapper.cpp b/src/_image_wrapper.cpp
index 65c8c8324ebc..856dcf4ea3ce 100644
--- a/src/_image_wrapper.cpp
+++ b/src/_image_wrapper.cpp
@@ -173,20 +173,20 @@ image_resample(py::array input_array,
 
     if (auto resampler =
             (ndim == 2) ? (
-                (dtype.is(py::dtype::of<std::uint8_t>())) ? resample<agg::gray8> :
-                (dtype.is(py::dtype::of<std::int8_t>())) ? resample<agg::gray8> :
-                (dtype.is(py::dtype::of<std::uint16_t>())) ? resample<agg::gray16> :
-                (dtype.is(py::dtype::of<std::int16_t>())) ? resample<agg::gray16> :
-                (dtype.is(py::dtype::of<float>())) ? resample<agg::gray32> :
-                (dtype.is(py::dtype::of<double>())) ? resample<agg::gray64> :
+                (dtype.equal(py::dtype::of<std::uint8_t>())) ? resample<agg::gray8> :
+                (dtype.equal(py::dtype::of<std::int8_t>())) ? resample<agg::gray8> :
+                (dtype.equal(py::dtype::of<std::uint16_t>())) ? resample<agg::gray16> :
+                (dtype.equal(py::dtype::of<std::int16_t>())) ? resample<agg::gray16> :
+                (dtype.equal(py::dtype::of<float>())) ? resample<agg::gray32> :
+                (dtype.equal(py::dtype::of<double>())) ? resample<agg::gray64> :
                 nullptr) : (
             // ndim == 3
-                (dtype.is(py::dtype::of<std::uint8_t>())) ? resample<agg::rgba8> :
-                (dtype.is(py::dtype::of<std::int8_t>())) ? resample<agg::rgba8> :
-                (dtype.is(py::dtype::of<std::uint16_t>())) ? resample<agg::rgba16> :
-                (dtype.is(py::dtype::of<std::int16_t>())) ? resample<agg::rgba16> :
-                (dtype.is(py::dtype::of<float>())) ? resample<agg::rgba32> :
-                (dtype.is(py::dtype::of<double>())) ? resample<agg::rgba64> :
+                (dtype.equal(py::dtype::of<std::uint8_t>())) ? resample<agg::rgba8> :
+                (dtype.equal(py::dtype::of<std::int8_t>())) ? resample<agg::rgba8> :
+                (dtype.equal(py::dtype::of<std::uint16_t>())) ? resample<agg::rgba16> :
+                (dtype.equal(py::dtype::of<std::int16_t>())) ? resample<agg::rgba16> :
+                (dtype.equal(py::dtype::of<float>())) ? resample<agg::rgba32> :
+                (dtype.equal(py::dtype::of<double>())) ? resample<agg::rgba64> :
                 nullptr)) {
         Py_BEGIN_ALLOW_THREADS
         resampler(

From 0caf58a617d2c9c022bb98acd67e730814193a75 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Tue, 25 Jun 2024 18:31:41 -0400
Subject: [PATCH 1024/1120] Backport PR #28440: DOC: Add note about
 simplification of to_polygons

---
 lib/matplotlib/path.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/lib/matplotlib/path.py b/lib/matplotlib/path.py
index e72eb1a9ca73..94fd97d7b599 100644
--- a/lib/matplotlib/path.py
+++ b/lib/matplotlib/path.py
@@ -697,6 +697,9 @@ def to_polygons(self, transform=None, width=0, height=0, closed_only=True):
         be simplified so that vertices outside of (0, 0), (width,
         height) will be clipped.
 
+        The resulting polygons will be simplified if the
+        :attr:`Path.should_simplify` attribute of the path is `True`.
+
         If *closed_only* is `True` (default), only closed polygons,
         with the last point being the same as the first point, will be
         returned.  Any unclosed polylines in the path will be

From 14711fac10f959162a054b2b3eb43fa3ef742d49 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Wed, 26 Jun 2024 11:43:43 -0400
Subject: [PATCH 1025/1120] Backport PR #28465: Fix pickling of SubFigures

---
 lib/matplotlib/figure.py            | 5 ++++-
 lib/matplotlib/figure.pyi           | 3 ++-
 lib/matplotlib/tests/test_pickle.py | 5 +++++
 3 files changed, 11 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
index e5f4bb9421cf..d75ff527a008 100644
--- a/lib/matplotlib/figure.py
+++ b/lib/matplotlib/figure.py
@@ -2224,7 +2224,6 @@ def __init__(self, parent, subplotspec, *,
         self.subplotpars = parent.subplotpars
         self.dpi_scale_trans = parent.dpi_scale_trans
         self._axobservers = parent._axobservers
-        self.canvas = parent.canvas
         self.transFigure = parent.transFigure
         self.bbox_relative = Bbox.null()
         self._redo_transform_rel_fig()
@@ -2241,6 +2240,10 @@ def __init__(self, parent, subplotspec, *,
         self._set_artist_props(self.patch)
         self.patch.set_antialiased(False)
 
+    @property
+    def canvas(self):
+        return self._parent.canvas
+
     @property
     def dpi(self):
         return self._parent.dpi
diff --git a/lib/matplotlib/figure.pyi b/lib/matplotlib/figure.pyi
index 21de9159d56c..b079312695c1 100644
--- a/lib/matplotlib/figure.pyi
+++ b/lib/matplotlib/figure.pyi
@@ -263,7 +263,6 @@ class SubFigure(FigureBase):
     figure: Figure
     subplotpars: SubplotParams
     dpi_scale_trans: Affine2D
-    canvas: FigureCanvasBase
     transFigure: Transform
     bbox_relative: Bbox
     figbbox: BboxBase
@@ -282,6 +281,8 @@ class SubFigure(FigureBase):
         **kwargs
     ) -> None: ...
     @property
+    def canvas(self) -> FigureCanvasBase: ...
+    @property
     def dpi(self) -> float: ...
     @dpi.setter
     def dpi(self, value: float) -> None: ...
diff --git a/lib/matplotlib/tests/test_pickle.py b/lib/matplotlib/tests/test_pickle.py
index 7e7ccc14bf8f..0cba4f392035 100644
--- a/lib/matplotlib/tests/test_pickle.py
+++ b/lib/matplotlib/tests/test_pickle.py
@@ -93,6 +93,11 @@ def _generate_complete_test_figure(fig_ref):
     plt.errorbar(x, x * -0.5, xerr=0.2, yerr=0.4, label='$-.5 x$')
     plt.legend(draggable=True)
 
+    # Ensure subfigure parenting works.
+    subfigs = fig_ref.subfigures(2)
+    subfigs[0].subplots(1, 2)
+    subfigs[1].subplots(1, 2)
+
     fig_ref.align_ylabels()  # Test handling of _align_label_groups Groupers.
 
 

From 5ad70281f58b6cdda2359359369759e2158b38e5 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Wed, 26 Jun 2024 14:18:55 -0500
Subject: [PATCH 1026/1120] Backport PR #28355: MNT: Re-add
 matplotlib.cm.get_cmap

---
 lib/matplotlib/cm.py  | 38 ++++++++++++++++++++++++++++++++++++++
 lib/matplotlib/cm.pyi |  2 ++
 2 files changed, 40 insertions(+)

diff --git a/lib/matplotlib/cm.py b/lib/matplotlib/cm.py
index c14973560ac3..b0cb3e9a7ec1 100644
--- a/lib/matplotlib/cm.py
+++ b/lib/matplotlib/cm.py
@@ -232,6 +232,44 @@ def get_cmap(self, cmap):
 globals().update(_colormaps)
 
 
+# This is an exact copy of pyplot.get_cmap(). It was removed in 3.9, but apparently
+# caused more user trouble than expected. Re-added for 3.9.1 and extended the
+# deprecation period for two additional minor releases.
+@_api.deprecated(
+    '3.7',
+    removal='3.11',
+    alternative="``matplotlib.colormaps[name]`` or ``matplotlib.colormaps.get_cmap()``"
+                " or ``pyplot.get_cmap()``"
+    )
+def get_cmap(name=None, lut=None):
+    """
+    Get a colormap instance, defaulting to rc values if *name* is None.
+
+    Parameters
+    ----------
+    name : `~matplotlib.colors.Colormap` or str or None, default: None
+        If a `.Colormap` instance, it will be returned. Otherwise, the name of
+        a colormap known to Matplotlib, which will be resampled by *lut*. The
+        default, None, means :rc:`image.cmap`.
+    lut : int or None, default: None
+        If *name* is not already a Colormap instance and *lut* is not None, the
+        colormap will be resampled to have *lut* entries in the lookup table.
+
+    Returns
+    -------
+    Colormap
+    """
+    if name is None:
+        name = mpl.rcParams['image.cmap']
+    if isinstance(name, colors.Colormap):
+        return name
+    _api.check_in_list(sorted(_colormaps), name=name)
+    if lut is None:
+        return _colormaps[name]
+    else:
+        return _colormaps[name].resampled(lut)
+
+
 def _auto_norm_from_scale(scale_cls):
     """
     Automatically generate a norm class from *scale_cls*.
diff --git a/lib/matplotlib/cm.pyi b/lib/matplotlib/cm.pyi
index da78d940ba4a..be8f10b39cb6 100644
--- a/lib/matplotlib/cm.pyi
+++ b/lib/matplotlib/cm.pyi
@@ -19,6 +19,8 @@ class ColormapRegistry(Mapping[str, colors.Colormap]):
 
 _colormaps: ColormapRegistry = ...
 
+def get_cmap(name: str | colors.Colormap | None = ..., lut: int | None = ...) -> colors.Colormap: ...
+
 class ScalarMappable:
     cmap: colors.Colormap | None
     colorbar: Colorbar | None

From 29637c5b45b345bf443035f1bc47a8194e92b3cb Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 26 Jun 2024 15:24:00 -0400
Subject: [PATCH 1027/1120] Backport PR #28398: Add GIL Release to flush_events
 in macosx backend

---
 src/_macosx.m | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/src/_macosx.m b/src/_macosx.m
index 656d502fa17c..fda928536ab5 100755
--- a/src/_macosx.m
+++ b/src/_macosx.m
@@ -77,6 +77,9 @@ static int wait_for_stdin() {
 
         // continuously run an event loop until the stdin_received flag is set to exit
         while (!stdin_received && !stdin_sigint) {
+            // This loop is similar to the main event loop and flush_events which have
+            // Py_[BEGIN|END]_ALLOW_THREADS surrounding the loop.
+            // This should not be necessary here because PyOS_InputHook releases the GIL for us.
             while (true) {
                 NSEvent *event = [NSApp nextEventMatchingMask: NSEventMaskAny
                                                     untilDate: [NSDate distantPast]
@@ -380,6 +383,9 @@ static CGFloat _get_device_scale(CGContextRef cr)
     // to process, breaking out of the loop when no events remain and
     // displaying the canvas if needed.
     NSEvent *event;
+
+    Py_BEGIN_ALLOW_THREADS
+
     while (true) {
         event = [NSApp nextEventMatchingMask: NSEventMaskAny
                                    untilDate: [NSDate distantPast]
@@ -390,6 +396,9 @@ static CGFloat _get_device_scale(CGContextRef cr)
         }
         [NSApp sendEvent:event];
     }
+
+    Py_END_ALLOW_THREADS
+
     [self->view displayIfNeeded];
     Py_RETURN_NONE;
 }

From bdad968ae24188ab1300b1b387a5f0c69ca1a714 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Wed, 26 Jun 2024 15:57:31 -0400
Subject: [PATCH 1028/1120] Backport PR #28342: DOC: Document the parameter
 *position* of apply_aspect() as internal

---
 lib/matplotlib/axes/_base.py | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index 30c4efe80c49..96e497a3316b 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -1882,6 +1882,11 @@ def apply_aspect(self, position=None):
         Parameters
         ----------
         position : None or .Bbox
+
+            .. note::
+                This parameter exists for historic reasons and is considered
+                internal. End users should not use it.
+
             If not ``None``, this defines the position of the
             Axes within the figure as a Bbox. See `~.Axes.get_position`
             for further details.
@@ -1892,6 +1897,10 @@ def apply_aspect(self, position=None):
         to call it yourself if you need to update the Axes position and/or
         view limits before the Figure is drawn.
 
+        An alternative with a broader scope is `.Figure.draw_without_rendering`,
+        which updates all stale components of a figure, not only the positioning /
+        view limits of a single Axes.
+
         See Also
         --------
         matplotlib.axes.Axes.set_aspect
@@ -1900,6 +1909,24 @@ def apply_aspect(self, position=None):
             Set how the Axes adjusts to achieve the required aspect ratio.
         matplotlib.axes.Axes.set_anchor
             Set the position in case of extra space.
+        matplotlib.figure.Figure.draw_without_rendering
+            Update all stale components of a figure.
+
+        Examples
+        --------
+        A typical usage example would be the following. `~.Axes.imshow` sets the
+        aspect to 1, but adapting the Axes position and extent to reflect this is
+        deferred until rendering for performance reasons. If you want to know the
+        Axes size before, you need to call `.apply_aspect` to get the correct
+        values.
+
+        >>> fig, ax = plt.subplots()
+        >>> ax.imshow(np.zeros((3, 3)))
+        >>> ax.bbox.width, ax.bbox.height
+        (496.0, 369.59999999999997)
+        >>> ax.apply_aspect()
+        >>> ax.bbox.width, ax.bbox.height
+        (369.59999999999997, 369.59999999999997)
         """
         if position is None:
             position = self.get_position(original=True)

From 8709791007cf4c8cbc745e314ac6d3d5f6d24ccf Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Wed, 26 Jun 2024 14:57:38 -0500
Subject: [PATCH 1029/1120] Backport PR #28289: Promote mpltype Sphinx role to
 a public extension

---
 doc/api/index.rst                             |   1 +
 .../next_api_changes/development/28289-ES.rst |   7 +
 doc/api/sphinxext_roles.rst                   |   7 +
 doc/conf.py                                   |   2 +-
 doc/sphinxext/custom_roles.py                 |  89 -----------
 lib/matplotlib/sphinxext/meson.build          |   1 +
 lib/matplotlib/sphinxext/roles.py             | 147 ++++++++++++++++++
 pyproject.toml                                |   4 +-
 8 files changed, 166 insertions(+), 92 deletions(-)
 create mode 100644 doc/api/next_api_changes/development/28289-ES.rst
 create mode 100644 doc/api/sphinxext_roles.rst
 delete mode 100644 doc/sphinxext/custom_roles.py
 create mode 100644 lib/matplotlib/sphinxext/roles.py

diff --git a/doc/api/index.rst b/doc/api/index.rst
index e55a0ed3c5b2..70c3b5343e7a 100644
--- a/doc/api/index.rst
+++ b/doc/api/index.rst
@@ -126,6 +126,7 @@ Alphabetical list of modules:
    sphinxext_mathmpl_api.rst
    sphinxext_plot_directive_api.rst
    sphinxext_figmpl_directive_api.rst
+   sphinxext_roles.rst
    spines_api.rst
    style_api.rst
    table_api.rst
diff --git a/doc/api/next_api_changes/development/28289-ES.rst b/doc/api/next_api_changes/development/28289-ES.rst
new file mode 100644
index 000000000000..f891c63a64bf
--- /dev/null
+++ b/doc/api/next_api_changes/development/28289-ES.rst
@@ -0,0 +1,7 @@
+Documentation-specific custom Sphinx roles are now semi-public
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+For third-party packages that derive types from Matplotlib, our use of custom roles may
+prevent Sphinx from building their docs. These custom Sphinx roles are now public solely
+for the purposes of use within projects that derive from Matplotlib types. See
+:mod:`matplotlib.sphinxext.roles` for details.
diff --git a/doc/api/sphinxext_roles.rst b/doc/api/sphinxext_roles.rst
new file mode 100644
index 000000000000..99959ff05d14
--- /dev/null
+++ b/doc/api/sphinxext_roles.rst
@@ -0,0 +1,7 @@
+==============================
+``matplotlib.sphinxext.roles``
+==============================
+
+.. automodule:: matplotlib.sphinxext.roles
+   :no-undoc-members:
+   :private-members: _rcparam_role, _mpltype_role
diff --git a/doc/conf.py b/doc/conf.py
index 92d78f896ca2..f43806a8b4c0 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -116,9 +116,9 @@ def _parse_skip_subdirs_file():
     'sphinx_gallery.gen_gallery',
     'matplotlib.sphinxext.mathmpl',
     'matplotlib.sphinxext.plot_directive',
+    'matplotlib.sphinxext.roles',
     'matplotlib.sphinxext.figmpl_directive',
     'sphinxcontrib.inkscapeconverter',
-    'sphinxext.custom_roles',
     'sphinxext.github',
     'sphinxext.math_symbol_table',
     'sphinxext.missing_references',
diff --git a/doc/sphinxext/custom_roles.py b/doc/sphinxext/custom_roles.py
deleted file mode 100644
index d76c92709865..000000000000
--- a/doc/sphinxext/custom_roles.py
+++ /dev/null
@@ -1,89 +0,0 @@
-from urllib.parse import urlsplit, urlunsplit
-
-from docutils import nodes
-
-from matplotlib import rcParamsDefault
-
-
-class QueryReference(nodes.Inline, nodes.TextElement):
-    """
-    Wraps a reference or pending reference to add a query string.
-
-    The query string is generated from the attributes added to this node.
-
-    Also equivalent to a `~docutils.nodes.literal` node.
-    """
-
-    def to_query_string(self):
-        """Generate query string from node attributes."""
-        return '&'.join(f'{name}={value}' for name, value in self.attlist())
-
-
-def visit_query_reference_node(self, node):
-    """
-    Resolve *node* into query strings on its ``reference`` children.
-
-    Then act as if this is a `~docutils.nodes.literal`.
-    """
-    query = node.to_query_string()
-    for refnode in node.findall(nodes.reference):
-        uri = urlsplit(refnode['refuri'])._replace(query=query)
-        refnode['refuri'] = urlunsplit(uri)
-
-    self.visit_literal(node)
-
-
-def depart_query_reference_node(self, node):
-    """
-    Act as if this is a `~docutils.nodes.literal`.
-    """
-    self.depart_literal(node)
-
-
-def rcparam_role(name, rawtext, text, lineno, inliner, options={}, content=[]):
-    # Generate a pending cross-reference so that Sphinx will ensure this link
-    # isn't broken at some point in the future.
-    title = f'rcParams["{text}"]'
-    target = 'matplotlibrc-sample'
-    ref_nodes, messages = inliner.interpreted(title, f'{title} <{target}>',
-                                              'ref', lineno)
-
-    qr = QueryReference(rawtext, highlight=text)
-    qr += ref_nodes
-    node_list = [qr]
-
-    # The default backend would be printed as "agg", but that's not correct (as
-    # the default is actually determined by fallback).
-    if text in rcParamsDefault and text != "backend":
-        node_list.extend([
-            nodes.Text(' (default: '),
-            nodes.literal('', repr(rcParamsDefault[text])),
-            nodes.Text(')'),
-            ])
-
-    return node_list, messages
-
-
-def mpltype_role(name, rawtext, text, lineno, inliner, options={}, content=[]):
-    mpltype = text
-    type_to_link_target = {
-        'color': 'colors_def',
-    }
-    if mpltype not in type_to_link_target:
-        raise ValueError(f"Unknown mpltype: {mpltype!r}")
-
-    node_list, messages = inliner.interpreted(
-        mpltype, f'{mpltype} <{type_to_link_target[mpltype]}>', 'ref', lineno)
-    return node_list, messages
-
-
-def setup(app):
-    app.add_role("rc", rcparam_role)
-    app.add_role("mpltype", mpltype_role)
-    app.add_node(
-        QueryReference,
-        html=(visit_query_reference_node, depart_query_reference_node),
-        latex=(visit_query_reference_node, depart_query_reference_node),
-        text=(visit_query_reference_node, depart_query_reference_node),
-    )
-    return {"parallel_read_safe": True, "parallel_write_safe": True}
diff --git a/lib/matplotlib/sphinxext/meson.build b/lib/matplotlib/sphinxext/meson.build
index 5dc7388384eb..35bb96fecbe1 100644
--- a/lib/matplotlib/sphinxext/meson.build
+++ b/lib/matplotlib/sphinxext/meson.build
@@ -3,6 +3,7 @@ python_sources = [
   'figmpl_directive.py',
   'mathmpl.py',
   'plot_directive.py',
+  'roles.py',
 ]
 
 typing_sources = [
diff --git a/lib/matplotlib/sphinxext/roles.py b/lib/matplotlib/sphinxext/roles.py
new file mode 100644
index 000000000000..301adcd8a5f5
--- /dev/null
+++ b/lib/matplotlib/sphinxext/roles.py
@@ -0,0 +1,147 @@
+"""
+Custom roles for the Matplotlib documentation.
+
+.. warning::
+
+    These roles are considered semi-public. They are only intended to be used in
+    the Matplotlib documentation.
+
+However, it can happen that downstream packages end up pulling these roles into
+their documentation, which will result in documentation build errors. The following
+describes the exact mechanism and how to fix the errors.
+
+There are two ways, Matplotlib docstrings can end up in downstream documentation.
+You have to subclass a Matplotlib class and either use the ``:inherited-members:``
+option in your autodoc configuration, or you have to override a method without
+specifying a new docstring; the new method will inherit the original docstring and
+still render in your autodoc. If the docstring contains one of the custom sphinx
+roles, you'll see one of the following error messages:
+
+.. code-block:: none
+
+    Unknown interpreted text role "mpltype".
+    Unknown interpreted text role "rc".
+
+To fix this, you can add this module as extension to your sphinx :file:`conf.py`::
+
+    extensions = [
+        'matplotlib.sphinxext.roles',
+        # Other extensions.
+    ]
+
+.. warning::
+
+    Direct use of these roles in other packages is not officially supported. We
+    reserve the right to modify or remove these roles without prior notification.
+"""
+
+from urllib.parse import urlsplit, urlunsplit
+
+from docutils import nodes
+
+import matplotlib
+from matplotlib import rcParamsDefault
+
+
+class _QueryReference(nodes.Inline, nodes.TextElement):
+    """
+    Wraps a reference or pending reference to add a query string.
+
+    The query string is generated from the attributes added to this node.
+
+    Also equivalent to a `~docutils.nodes.literal` node.
+    """
+
+    def to_query_string(self):
+        """Generate query string from node attributes."""
+        return '&'.join(f'{name}={value}' for name, value in self.attlist())
+
+
+def _visit_query_reference_node(self, node):
+    """
+    Resolve *node* into query strings on its ``reference`` children.
+
+    Then act as if this is a `~docutils.nodes.literal`.
+    """
+    query = node.to_query_string()
+    for refnode in node.findall(nodes.reference):
+        uri = urlsplit(refnode['refuri'])._replace(query=query)
+        refnode['refuri'] = urlunsplit(uri)
+
+    self.visit_literal(node)
+
+
+def _depart_query_reference_node(self, node):
+    """
+    Act as if this is a `~docutils.nodes.literal`.
+    """
+    self.depart_literal(node)
+
+
+def _rcparam_role(name, rawtext, text, lineno, inliner, options=None, content=None):
+    """
+    Sphinx role ``:rc:`` to highlight and link ``rcParams`` entries.
+
+    Usage: Give the desired ``rcParams`` key as parameter.
+
+    :code:`:rc:`figure.dpi`` will render as: :rc:`figure.dpi`
+    """
+    # Generate a pending cross-reference so that Sphinx will ensure this link
+    # isn't broken at some point in the future.
+    title = f'rcParams["{text}"]'
+    target = 'matplotlibrc-sample'
+    ref_nodes, messages = inliner.interpreted(title, f'{title} <{target}>',
+                                              'ref', lineno)
+
+    qr = _QueryReference(rawtext, highlight=text)
+    qr += ref_nodes
+    node_list = [qr]
+
+    # The default backend would be printed as "agg", but that's not correct (as
+    # the default is actually determined by fallback).
+    if text in rcParamsDefault and text != "backend":
+        node_list.extend([
+            nodes.Text(' (default: '),
+            nodes.literal('', repr(rcParamsDefault[text])),
+            nodes.Text(')'),
+            ])
+
+    return node_list, messages
+
+
+def _mpltype_role(name, rawtext, text, lineno, inliner, options=None, content=None):
+    """
+    Sphinx role ``:mpltype:`` for custom matplotlib types.
+
+    In Matplotlib, there are a number of type-like concepts that do not have a
+    direct type representation; example: color. This role allows to properly
+    highlight them in the docs and link to their definition.
+
+    Currently supported values:
+
+    - :code:`:mpltype:`color`` will render as: :mpltype:`color`
+
+    """
+    mpltype = text
+    type_to_link_target = {
+        'color': 'colors_def',
+    }
+    if mpltype not in type_to_link_target:
+        raise ValueError(f"Unknown mpltype: {mpltype!r}")
+
+    node_list, messages = inliner.interpreted(
+        mpltype, f'{mpltype} <{type_to_link_target[mpltype]}>', 'ref', lineno)
+    return node_list, messages
+
+
+def setup(app):
+    app.add_role("rc", _rcparam_role)
+    app.add_role("mpltype", _mpltype_role)
+    app.add_node(
+        _QueryReference,
+        html=(_visit_query_reference_node, _depart_query_reference_node),
+        latex=(_visit_query_reference_node, _depart_query_reference_node),
+        text=(_visit_query_reference_node, _depart_query_reference_node),
+    )
+    return {"version": matplotlib.__version__,
+            "parallel_read_safe": True, "parallel_write_safe": True}
diff --git a/pyproject.toml b/pyproject.toml
index a9fb7df68450..52bbe308c0f9 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -283,11 +283,11 @@ ignore_directives = [
     "include"
 ]
 ignore_roles = [
-    # sphinxext.custom_roles
-    "rc",
     # matplotlib.sphinxext.mathmpl
     "mathmpl",
     "math-stix",
+    # matplotlib.sphinxext.roles
+    "rc",
     # sphinxext.github
     "ghissue",
     "ghpull",

From bbb0d01bfa333746c77c4490164e9e3682fd56b2 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Wed, 26 Jun 2024 17:03:20 -0400
Subject: [PATCH 1030/1120] Merge pull request #28397 from
 rcomer/subfigure-stale

Backport PR #28397: FIX: stale root Figure when adding/updating subfigures
(cherry picked from commit d347c3227f8de8a99aa327390fee619310452a96)
---
 lib/matplotlib/figure.py            |  2 ++
 lib/matplotlib/tests/test_figure.py | 24 ++++++++++++++++++++++++
 2 files changed, 26 insertions(+)

diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
index d75ff527a008..0d939190a0a9 100644
--- a/lib/matplotlib/figure.py
+++ b/lib/matplotlib/figure.py
@@ -1633,6 +1633,8 @@ def add_subfigure(self, subplotspec, **kwargs):
         sf = SubFigure(self, subplotspec, **kwargs)
         self.subfigs += [sf]
         sf._remove_method = self.subfigs.remove
+        sf.stale_callback = _stale_figure_callback
+        self.stale = True
         return sf
 
     def sca(self, a):
diff --git a/lib/matplotlib/tests/test_figure.py b/lib/matplotlib/tests/test_figure.py
index 58aecd3dea8b..6e6daa77062d 100644
--- a/lib/matplotlib/tests/test_figure.py
+++ b/lib/matplotlib/tests/test_figure.py
@@ -1733,3 +1733,27 @@ def test_warn_colorbar_mismatch():
     subfig3_1.colorbar(im3_2)   # should not warn
     with pytest.warns(UserWarning, match="different Figure"):
         subfig3_1.colorbar(im4_1)
+
+
+def test_subfigure_stale_propagation():
+    fig = plt.figure()
+
+    fig.draw_without_rendering()
+    assert not fig.stale
+
+    sfig1 = fig.subfigures()
+    assert fig.stale
+
+    fig.draw_without_rendering()
+    assert not fig.stale
+    assert not sfig1.stale
+
+    sfig2 = sfig1.subfigures()
+    assert fig.stale
+
+    fig.draw_without_rendering()
+    assert not fig.stale
+    assert not sfig2.stale
+
+    sfig2.stale = True
+    assert fig.stale

From a92824c6ee5dee1132df32b970a42d31846ce596 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Thu, 27 Jun 2024 12:04:36 -0500
Subject: [PATCH 1031/1120] Backport PR #28474: Fix typing and docs for
 containers

---
 lib/matplotlib/axes/_axes.py |  6 +++---
 lib/matplotlib/container.py  | 20 ++++++++++----------
 lib/matplotlib/container.pyi |  4 ++--
 3 files changed, 15 insertions(+), 15 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index fdafc2dcb0bc..ffeecdcbd029 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -3527,11 +3527,11 @@ def errorbar(self, x, y, yerr=None, xerr=None,
         `.ErrorbarContainer`
             The container contains:
 
-            - plotline: `~matplotlib.lines.Line2D` instance of x, y plot markers
+            - data_line : A `~matplotlib.lines.Line2D` instance of x, y plot markers
               and/or line.
-            - caplines: A tuple of `~matplotlib.lines.Line2D` instances of the error
+            - caplines : A tuple of `~matplotlib.lines.Line2D` instances of the error
               bar caps.
-            - barlinecols: A tuple of `.LineCollection` with the horizontal and
+            - barlinecols : A tuple of `.LineCollection` with the horizontal and
               vertical error ranges.
 
         Other Parameters
diff --git a/lib/matplotlib/container.py b/lib/matplotlib/container.py
index 0f082e298afc..b6dd43724f34 100644
--- a/lib/matplotlib/container.py
+++ b/lib/matplotlib/container.py
@@ -87,12 +87,12 @@ class ErrorbarContainer(Container):
     lines : tuple
         Tuple of ``(data_line, caplines, barlinecols)``.
 
-        - data_line : :class:`~matplotlib.lines.Line2D` instance of
-          x, y plot markers and/or line.
-        - caplines : tuple of :class:`~matplotlib.lines.Line2D` instances of
-          the error bar caps.
-        - barlinecols : list of :class:`~matplotlib.collections.LineCollection`
-          with the horizontal and vertical error ranges.
+        - data_line : A `~matplotlib.lines.Line2D` instance of x, y plot markers
+          and/or line.
+        - caplines : A tuple of `~matplotlib.lines.Line2D` instances of the error
+          bar caps.
+        - barlinecols : A tuple of `~matplotlib.collections.LineCollection` with the
+          horizontal and vertical error ranges.
 
     has_xerr, has_yerr : bool
         ``True`` if the errorbar has x/y errors.
@@ -115,13 +115,13 @@ class StemContainer(Container):
 
     Attributes
     ----------
-    markerline :  :class:`~matplotlib.lines.Line2D`
+    markerline : `~matplotlib.lines.Line2D`
         The artist of the markers at the stem heads.
 
-    stemlines : list of :class:`~matplotlib.lines.Line2D`
+    stemlines : `~matplotlib.collections.LineCollection`
         The artists of the vertical lines for all stems.
 
-    baseline : :class:`~matplotlib.lines.Line2D`
+    baseline : `~matplotlib.lines.Line2D`
         The artist of the horizontal baseline.
     """
     def __init__(self, markerline_stemlines_baseline, **kwargs):
@@ -130,7 +130,7 @@ def __init__(self, markerline_stemlines_baseline, **kwargs):
         ----------
         markerline_stemlines_baseline : tuple
             Tuple of ``(markerline, stemlines, baseline)``.
-            ``markerline`` contains the `.LineCollection` of the markers,
+            ``markerline`` contains the `.Line2D` of the markers,
             ``stemlines`` is a `.LineCollection` of the main lines,
             ``baseline`` is the `.Line2D` of the baseline.
         """
diff --git a/lib/matplotlib/container.pyi b/lib/matplotlib/container.pyi
index 9cc2e1ac2acc..c66e7ba4b4c3 100644
--- a/lib/matplotlib/container.pyi
+++ b/lib/matplotlib/container.pyi
@@ -34,12 +34,12 @@ class BarContainer(Container):
     ) -> None: ...
 
 class ErrorbarContainer(Container):
-    lines: tuple[Line2D, Line2D, LineCollection]
+    lines: tuple[Line2D, tuple[Line2D, ...], tuple[LineCollection, ...]]
     has_xerr: bool
     has_yerr: bool
     def __init__(
         self,
-        lines: tuple[Line2D, Line2D, LineCollection],
+        lines: tuple[Line2D, tuple[Line2D, ...], tuple[LineCollection, ...]],
         has_xerr: bool = ...,
         has_yerr: bool = ...,
         **kwargs

From b7423af305df3dd0ad55e56d38e751dbed02db60 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 27 Jun 2024 18:13:23 -0400
Subject: [PATCH 1032/1120] Backport PR #28473: Do not lowercase module://
 backends

---
 lib/matplotlib/backends/registry.py           | 12 +++++++++---
 lib/matplotlib/tests/test_backend_registry.py |  9 +++++++++
 lib/matplotlib/tests/test_backend_template.py | 11 +++++++++++
 3 files changed, 29 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/backends/registry.py b/lib/matplotlib/backends/registry.py
index 47d5f65e350e..e08817bb089b 100644
--- a/lib/matplotlib/backends/registry.py
+++ b/lib/matplotlib/backends/registry.py
@@ -93,6 +93,9 @@ def __init__(self):
         }
 
     def _backend_module_name(self, backend):
+        if backend.startswith("module://"):
+            return backend[9:]
+
         # Return name of module containing the specified backend.
         # Does not check if the backend is valid, use is_valid_backend for that.
         backend = backend.lower()
@@ -224,7 +227,8 @@ def is_valid_backend(self, backend):
         bool
             True if backend is valid, False otherwise.
         """
-        backend = backend.lower()
+        if not backend.startswith("module://"):
+            backend = backend.lower()
 
         # For backward compatibility, convert ipympl and matplotlib-inline long
         # module:// names to their shortened forms.
@@ -342,7 +346,8 @@ def resolve_backend(self, backend):
             The GUI framework, which will be None for a backend that is non-interactive.
         """
         if isinstance(backend, str):
-            backend = backend.lower()
+            if not backend.startswith("module://"):
+                backend = backend.lower()
         else:  # Might be _auto_backend_sentinel or None
             # Use whatever is already running...
             from matplotlib import get_backend
@@ -395,7 +400,8 @@ def resolve_gui_or_backend(self, gui_or_backend):
         framework : str or None
             The GUI framework, which will be None for a backend that is non-interactive.
         """
-        gui_or_backend = gui_or_backend.lower()
+        if not gui_or_backend.startswith("module://"):
+            gui_or_backend = gui_or_backend.lower()
 
         # First check if it is a gui loop name.
         backend = self.backend_for_gui_framework(gui_or_backend)
diff --git a/lib/matplotlib/tests/test_backend_registry.py b/lib/matplotlib/tests/test_backend_registry.py
index 141ffd69c266..80c2ce4fc51a 100644
--- a/lib/matplotlib/tests/test_backend_registry.py
+++ b/lib/matplotlib/tests/test_backend_registry.py
@@ -86,6 +86,15 @@ def test_is_valid_backend(backend, is_valid):
     assert backend_registry.is_valid_backend(backend) == is_valid
 
 
+@pytest.mark.parametrize("backend, normalized", [
+    ("agg", "matplotlib.backends.backend_agg"),
+    ("QtAgg", "matplotlib.backends.backend_qtagg"),
+    ("module://Anything", "Anything"),
+])
+def test_backend_normalization(backend, normalized):
+    assert backend_registry._backend_module_name(backend) == normalized
+
+
 def test_deprecated_rcsetup_attributes():
     match = "was deprecated in Matplotlib 3.9"
     with pytest.warns(mpl.MatplotlibDeprecationWarning, match=match):
diff --git a/lib/matplotlib/tests/test_backend_template.py b/lib/matplotlib/tests/test_backend_template.py
index d7e2a5cd1266..964d15c1559a 100644
--- a/lib/matplotlib/tests/test_backend_template.py
+++ b/lib/matplotlib/tests/test_backend_template.py
@@ -49,3 +49,14 @@ def test_show_old_global_api(monkeypatch):
     mpl.use("module://mpl_test_backend")
     plt.show()
     mock_show.assert_called_with()
+
+
+def test_load_case_sensitive(monkeypatch):
+    mpl_test_backend = SimpleNamespace(**vars(backend_template))
+    mock_show = MagicMock()
+    monkeypatch.setattr(
+        mpl_test_backend.FigureManagerTemplate, "pyplot_show", mock_show)
+    monkeypatch.setitem(sys.modules, "mpl_Test_Backend", mpl_test_backend)
+    mpl.use("module://mpl_Test_Backend")
+    plt.show()
+    mock_show.assert_called_with()

From c7997bed82e43e04cc9d67a97e78bc70646004e7 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 27 Jun 2024 18:58:16 -0400
Subject: [PATCH 1033/1120] Backport PR #28393: Make sticky edges only apply if
 the sticky edge is the most extreme limit point

---
 lib/matplotlib/axes/_base.py                  |   6 ++++++
 .../test_axes/sticky_tolerance.png            | Bin 0 -> 3941 bytes
 lib/matplotlib/tests/test_axes.py             |  19 ++++++++++++++++++
 3 files changed, 25 insertions(+)
 create mode 100644 lib/matplotlib/tests/baseline_images/test_axes/sticky_tolerance.png

diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index 96e497a3316b..f83999436cbb 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -2969,9 +2969,15 @@ def handle_single_axis(
             # Index of largest element < x0 + tol, if any.
             i0 = stickies.searchsorted(x0 + tol) - 1
             x0bound = stickies[i0] if i0 != -1 else None
+            # Ensure the boundary acts only if the sticky is the extreme value
+            if x0bound is not None and x0bound > x0:
+                x0bound = None
             # Index of smallest element > x1 - tol, if any.
             i1 = stickies.searchsorted(x1 - tol)
             x1bound = stickies[i1] if i1 != len(stickies) else None
+            # Ensure the boundary acts only if the sticky is the extreme value
+            if x1bound is not None and x1bound < x1:
+                x1bound = None
 
             # Add the margin in figure space and then transform back, to handle
             # non-linear scales.
diff --git a/lib/matplotlib/tests/baseline_images/test_axes/sticky_tolerance.png b/lib/matplotlib/tests/baseline_images/test_axes/sticky_tolerance.png
new file mode 100644
index 0000000000000000000000000000000000000000..a3fb13d0716aed8de5596a838828e103d7b23d5d
GIT binary patch
literal 3941
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

literal 0
HcmV?d00001

diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index 0ed5a11c1398..ff4d698fbb6e 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -682,6 +682,25 @@ def test_sticky_shared_axes(fig_test, fig_ref):
     ax0.pcolormesh(Z)
 
 
+@image_comparison(['sticky_tolerance.png'], remove_text=True, style="mpl20")
+def test_sticky_tolerance():
+    fig, axs = plt.subplots(2, 2)
+
+    width = .1
+
+    axs.flat[0].bar(x=0, height=width, bottom=20000.6)
+    axs.flat[0].bar(x=1, height=width, bottom=20000.1)
+
+    axs.flat[1].bar(x=0, height=-width, bottom=20000.6)
+    axs.flat[1].bar(x=1, height=-width, bottom=20000.1)
+
+    axs.flat[2].barh(y=0, width=-width, left=-20000.6)
+    axs.flat[2].barh(y=1, width=-width, left=-20000.1)
+
+    axs.flat[3].barh(y=0, width=width, left=-20000.6)
+    axs.flat[3].barh(y=1, width=width, left=-20000.1)
+
+
 def test_nargs_stem():
     with pytest.raises(TypeError, match='0 were given'):
         # stem() takes 1-3 arguments.

From b7d25c4778e6e87874b8d8cc3a0c1af52992c124 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Sat, 29 Jun 2024 14:50:57 -0400
Subject: [PATCH 1034/1120] Backport PR #28486: Fix
 CompositeGenericTransform.contains_branch_seperately

---
 lib/matplotlib/tests/test_transforms.py |  7 +++++++
 lib/matplotlib/transforms.py            | 11 ++++++++++-
 2 files changed, 17 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/tests/test_transforms.py b/lib/matplotlib/tests/test_transforms.py
index 959814de82db..3d12b90d5210 100644
--- a/lib/matplotlib/tests/test_transforms.py
+++ b/lib/matplotlib/tests/test_transforms.py
@@ -667,6 +667,13 @@ def test_contains_branch(self):
 
         assert not self.stack1.contains_branch(self.tn1 + self.ta2)
 
+        blend = mtransforms.BlendedGenericTransform(self.tn2, self.stack2)
+        x, y = blend.contains_branch_seperately(self.stack2_subset)
+        stack_blend = self.tn3 + blend
+        sx, sy = stack_blend.contains_branch_seperately(self.stack2_subset)
+        assert x is sx is False
+        assert y is sy is True
+
     def test_affine_simplification(self):
         # tests that a transform stack only calls as much is absolutely
         # necessary "non-affine" allowing the best possible optimization with
diff --git a/lib/matplotlib/transforms.py b/lib/matplotlib/transforms.py
index 5003e2113930..3575bd1fc14d 100644
--- a/lib/matplotlib/transforms.py
+++ b/lib/matplotlib/transforms.py
@@ -1423,7 +1423,7 @@ def contains_branch_seperately(self, other_transform):
                              'transforms with 2 output dimensions')
         # for a non-blended transform each separate dimension is the same, so
         # just return the appropriate shape.
-        return [self.contains_branch(other_transform)] * 2
+        return (self.contains_branch(other_transform), ) * 2
 
     def __sub__(self, other):
         """
@@ -2404,6 +2404,15 @@ def _iter_break_from_left_to_right(self):
         for left, right in self._b._iter_break_from_left_to_right():
             yield self._a + left, right
 
+    def contains_branch_seperately(self, other_transform):
+        # docstring inherited
+        if self.output_dims != 2:
+            raise ValueError('contains_branch_seperately only supports '
+                             'transforms with 2 output dimensions')
+        if self == other_transform:
+            return (True, True)
+        return self._b.contains_branch_seperately(other_transform)
+
     depth = property(lambda self: self._a.depth + self._b.depth)
     is_affine = property(lambda self: self._a.is_affine and self._b.is_affine)
     is_separable = property(

From 475d5b70daa5f1b0e66dc89c9cba857d6930ea61 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Sat, 29 Jun 2024 14:52:32 -0400
Subject: [PATCH 1035/1120] Backport PR #28487: Fix autoscaling with axhspan

---
 lib/matplotlib/axes/_axes.py      | 2 +-
 lib/matplotlib/tests/test_axes.py | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index ffeecdcbd029..040c5a4ba4e9 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -1028,7 +1028,7 @@ def axhspan(self, ymin, ymax, xmin=0, xmax=1, **kwargs):
         # For Rectangles and non-separable transforms, add_patch can be buggy
         # and update the x limits even though it shouldn't do so for an
         # yaxis_transformed patch, so undo that update.
-        ix = self.dataLim.intervalx
+        ix = self.dataLim.intervalx.copy()
         mx = self.dataLim.minposx
         self.add_patch(p)
         self.dataLim.intervalx = ix
diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index ff4d698fbb6e..3c0407ee4098 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -8195,10 +8195,10 @@ def test_relative_ticklabel_sizes(size):
 def test_multiplot_autoscale():
     fig = plt.figure()
     ax1, ax2 = fig.subplots(2, 1, sharex='all')
-    ax1.scatter([1, 2, 3, 4], [2, 3, 2, 3])
+    ax1.plot([18000, 18250, 18500, 18750], [2, 3, 2, 3])
     ax2.axhspan(-5, 5)
     xlim = ax1.get_xlim()
-    assert np.allclose(xlim, [0.5, 4.5])
+    assert np.allclose(xlim, [18000, 18800])
 
 
 def test_sharing_does_not_link_positions():

From 5552302c3fef08f8e29b7f4d1340a723df63962a Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Tue, 2 Jul 2024 13:14:34 -0400
Subject: [PATCH 1036/1120] Backport PR #28498: Don't fail if we can't query
 system fonts on macOS

---
 lib/matplotlib/font_manager.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/font_manager.py b/lib/matplotlib/font_manager.py
index 312e8ee97246..813bee6eb623 100644
--- a/lib/matplotlib/font_manager.py
+++ b/lib/matplotlib/font_manager.py
@@ -266,8 +266,11 @@ def _get_fontconfig_fonts():
 @lru_cache
 def _get_macos_fonts():
     """Cache and list the font paths known to ``system_profiler SPFontsDataType``."""
-    d, = plistlib.loads(
-        subprocess.check_output(["system_profiler", "-xml", "SPFontsDataType"]))
+    try:
+        d, = plistlib.loads(
+            subprocess.check_output(["system_profiler", "-xml", "SPFontsDataType"]))
+    except (OSError, subprocess.CalledProcessError, plistlib.InvalidFileException):
+        return []
     return [Path(entry["path"]) for entry in d["_items"]]
 
 

From c43313a77ccb165b7b26de7e9b3cd9b9c1b50700 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Wed, 3 Jul 2024 15:08:51 -0500
Subject: [PATCH 1037/1120] Backport PR #28451: Fix GTK cairo backends

---
 lib/matplotlib/backends/backend_gtk3cairo.py | 16 ++++++++++------
 lib/matplotlib/backends/backend_gtk4.py      | 10 ++--------
 lib/matplotlib/backends/backend_gtk4cairo.py |  9 ++++-----
 3 files changed, 16 insertions(+), 19 deletions(-)

diff --git a/lib/matplotlib/backends/backend_gtk3cairo.py b/lib/matplotlib/backends/backend_gtk3cairo.py
index 24a26111f062..371b8dc1b31f 100644
--- a/lib/matplotlib/backends/backend_gtk3cairo.py
+++ b/lib/matplotlib/backends/backend_gtk3cairo.py
@@ -13,15 +13,19 @@ def on_draw_event(self, widget, ctx):
 
         with (self.toolbar._wait_cursor_for_draw_cm() if self.toolbar
               else nullcontext()):
-            self._renderer.set_context(ctx)
-            scale = self.device_pixel_ratio
-            # Scale physical drawing to logical size.
-            ctx.scale(1 / scale, 1 / scale)
             allocation = self.get_allocation()
+            # Render the background before scaling, as the allocated size here is in
+            # logical pixels.
             Gtk.render_background(
                 self.get_style_context(), ctx,
-                allocation.x, allocation.y,
-                allocation.width, allocation.height)
+                0, 0, allocation.width, allocation.height)
+            scale = self.device_pixel_ratio
+            # Scale physical drawing to logical size.
+            ctx.scale(1 / scale, 1 / scale)
+            self._renderer.set_context(ctx)
+            # Set renderer to physical size so it renders in full resolution.
+            self._renderer.width = allocation.width * scale
+            self._renderer.height = allocation.height * scale
             self._renderer.dpi = self.figure.dpi
             self.figure.draw(self._renderer)
 
diff --git a/lib/matplotlib/backends/backend_gtk4.py b/lib/matplotlib/backends/backend_gtk4.py
index 256a8ec9e864..dd86ab628ce7 100644
--- a/lib/matplotlib/backends/backend_gtk4.py
+++ b/lib/matplotlib/backends/backend_gtk4.py
@@ -34,7 +34,6 @@ class FigureCanvasGTK4(_FigureCanvasGTK, Gtk.DrawingArea):
     required_interactive_framework = "gtk4"
     supports_blit = False
     manager_class = _api.classproperty(lambda cls: FigureManagerGTK4)
-    _context_is_scaled = False
 
     def __init__(self, figure=None):
         super().__init__(figure=figure)
@@ -228,13 +227,8 @@ def _post_draw(self, widget, ctx):
 
         lw = 1
         dash = 3
-        if not self._context_is_scaled:
-            x0, y0, w, h = (dim / self.device_pixel_ratio
-                            for dim in self._rubberband_rect)
-        else:
-            x0, y0, w, h = self._rubberband_rect
-            lw *= self.device_pixel_ratio
-            dash *= self.device_pixel_ratio
+        x0, y0, w, h = (dim / self.device_pixel_ratio
+                        for dim in self._rubberband_rect)
         x1 = x0 + w
         y1 = y0 + h
 
diff --git a/lib/matplotlib/backends/backend_gtk4cairo.py b/lib/matplotlib/backends/backend_gtk4cairo.py
index b1d543704351..838ea03fcce6 100644
--- a/lib/matplotlib/backends/backend_gtk4cairo.py
+++ b/lib/matplotlib/backends/backend_gtk4cairo.py
@@ -5,7 +5,10 @@
 
 
 class FigureCanvasGTK4Cairo(FigureCanvasCairo, FigureCanvasGTK4):
-    _context_is_scaled = True
+    def _set_device_pixel_ratio(self, ratio):
+        # Cairo in GTK4 always uses logical pixels, so we don't need to do anything for
+        # changes to the device pixel ratio.
+        return False
 
     def on_draw_event(self, widget, ctx):
         if self._idle_draw_id:
@@ -16,15 +19,11 @@ def on_draw_event(self, widget, ctx):
         with (self.toolbar._wait_cursor_for_draw_cm() if self.toolbar
               else nullcontext()):
             self._renderer.set_context(ctx)
-            scale = self.device_pixel_ratio
-            # Scale physical drawing to logical size.
-            ctx.scale(1 / scale, 1 / scale)
             allocation = self.get_allocation()
             Gtk.render_background(
                 self.get_style_context(), ctx,
                 allocation.x, allocation.y,
                 allocation.width, allocation.height)
-            self._renderer.dpi = self.figure.dpi
             self.figure.draw(self._renderer)
 
 

From 06189c2b237e9dc4e0de456b80e8ae098cdde4ae Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 3 Jul 2024 20:15:51 -0400
Subject: [PATCH 1038/1120] Backport PR #28430: Fix pickling of AxesWidgets.

---
 lib/matplotlib/testing/__init__.py            | 21 ++++++++++
 lib/matplotlib/testing/__init__.pyi           |  1 +
 .../tests/test_backends_interactive.py        | 23 +----------
 lib/matplotlib/tests/test_pickle.py           | 24 ++++++++++-
 lib/matplotlib/widgets.py                     | 40 ++++++-------------
 lib/matplotlib/widgets.pyi                    | 12 ++++--
 6 files changed, 67 insertions(+), 54 deletions(-)

diff --git a/lib/matplotlib/testing/__init__.py b/lib/matplotlib/testing/__init__.py
index 8e60267ed608..19113d399626 100644
--- a/lib/matplotlib/testing/__init__.py
+++ b/lib/matplotlib/testing/__init__.py
@@ -211,3 +211,24 @@ def ipython_in_subprocess(requested_backend_or_gui_framework, all_expected_backe
     )
 
     assert proc.stdout.strip().endswith(f"'{expected_backend}'")
+
+
+def is_ci_environment():
+    # Common CI variables
+    ci_environment_variables = [
+        'CI',        # Generic CI environment variable
+        'CONTINUOUS_INTEGRATION',  # Generic CI environment variable
+        'TRAVIS',    # Travis CI
+        'CIRCLECI',  # CircleCI
+        'JENKINS',   # Jenkins
+        'GITLAB_CI',  # GitLab CI
+        'GITHUB_ACTIONS',  # GitHub Actions
+        'TEAMCITY_VERSION'  # TeamCity
+        # Add other CI environment variables as needed
+    ]
+
+    for env_var in ci_environment_variables:
+        if os.getenv(env_var):
+            return True
+
+    return False
diff --git a/lib/matplotlib/testing/__init__.pyi b/lib/matplotlib/testing/__init__.pyi
index 1f52a8ccb8ee..6917b6a5a380 100644
--- a/lib/matplotlib/testing/__init__.pyi
+++ b/lib/matplotlib/testing/__init__.pyi
@@ -51,3 +51,4 @@ def ipython_in_subprocess(
     requested_backend_or_gui_framework: str,
     all_expected_backends: dict[tuple[int, int], str],
 ) -> None: ...
+def is_ci_environment() -> bool: ...
diff --git a/lib/matplotlib/tests/test_backends_interactive.py b/lib/matplotlib/tests/test_backends_interactive.py
index 6830e7d5c845..d624b5db0ac2 100644
--- a/lib/matplotlib/tests/test_backends_interactive.py
+++ b/lib/matplotlib/tests/test_backends_interactive.py
@@ -19,7 +19,7 @@
 import matplotlib as mpl
 from matplotlib import _c_internal_utils
 from matplotlib.backend_tools import ToolToggleBase
-from matplotlib.testing import subprocess_run_helper as _run_helper
+from matplotlib.testing import subprocess_run_helper as _run_helper, is_ci_environment
 
 
 class _WaitForStringPopen(subprocess.Popen):
@@ -110,27 +110,6 @@ def _get_testable_interactive_backends():
             for env, marks in _get_available_interactive_backends()]
 
 
-def is_ci_environment():
-    # Common CI variables
-    ci_environment_variables = [
-        'CI',        # Generic CI environment variable
-        'CONTINUOUS_INTEGRATION',  # Generic CI environment variable
-        'TRAVIS',    # Travis CI
-        'CIRCLECI',  # CircleCI
-        'JENKINS',   # Jenkins
-        'GITLAB_CI',  # GitLab CI
-        'GITHUB_ACTIONS',  # GitHub Actions
-        'TEAMCITY_VERSION'  # TeamCity
-        # Add other CI environment variables as needed
-    ]
-
-    for env_var in ci_environment_variables:
-        if os.getenv(env_var):
-            return True
-
-    return False
-
-
 # Reasonable safe values for slower CI/Remote and local architectures.
 _test_timeout = 120 if is_ci_environment() else 20
 
diff --git a/lib/matplotlib/tests/test_pickle.py b/lib/matplotlib/tests/test_pickle.py
index 0cba4f392035..1474a67d28aa 100644
--- a/lib/matplotlib/tests/test_pickle.py
+++ b/lib/matplotlib/tests/test_pickle.py
@@ -1,5 +1,7 @@
 from io import BytesIO
 import ast
+import os
+import sys
 import pickle
 import pickletools
 
@@ -8,7 +10,7 @@
 
 import matplotlib as mpl
 from matplotlib import cm
-from matplotlib.testing import subprocess_run_helper
+from matplotlib.testing import subprocess_run_helper, is_ci_environment
 from matplotlib.testing.decorators import check_figures_equal
 from matplotlib.dates import rrulewrapper
 from matplotlib.lines import VertexSelector
@@ -307,3 +309,23 @@ def test_cycler():
     ax = pickle.loads(pickle.dumps(ax))
     l, = ax.plot([3, 4])
     assert l.get_color() == "m"
+
+
+# Run under an interactive backend to test that we don't try to pickle the
+# (interactive and non-picklable) canvas.
+def _test_axeswidget_interactive():
+    ax = plt.figure().add_subplot()
+    pickle.dumps(mpl.widgets.Button(ax, "button"))
+
+
+@pytest.mark.xfail(  # https://github.com/actions/setup-python/issues/649
+        ('TF_BUILD' in os.environ or 'GITHUB_ACTION' in os.environ) and
+        sys.platform == 'darwin' and sys.version_info[:2] < (3, 11),
+        reason='Tk version mismatch on Azure macOS CI'
+    )
+def test_axeswidget_interactive():
+    subprocess_run_helper(
+        _test_axeswidget_interactive,
+        timeout=120 if is_ci_environment() else 20,
+        extra_env={'MPLBACKEND': 'tkagg'}
+    )
diff --git a/lib/matplotlib/widgets.py b/lib/matplotlib/widgets.py
index ed130e6854f2..a298f3ae3d6a 100644
--- a/lib/matplotlib/widgets.py
+++ b/lib/matplotlib/widgets.py
@@ -90,22 +90,6 @@ def ignore(self, event):
         """
         return not self.active
 
-    def _changed_canvas(self):
-        """
-        Someone has switched the canvas on us!
-
-        This happens if `savefig` needs to save to a format the previous
-        backend did not support (e.g. saving a figure using an Agg based
-        backend saved to a vector format).
-
-        Returns
-        -------
-        bool
-           True if the canvas has been changed.
-
-        """
-        return self.canvas is not self.ax.figure.canvas
-
 
 class AxesWidget(Widget):
     """
@@ -131,9 +115,10 @@ class AxesWidget(Widget):
 
     def __init__(self, ax):
         self.ax = ax
-        self.canvas = ax.figure.canvas
         self._cids = []
 
+    canvas = property(lambda self: self.ax.figure.canvas)
+
     def connect_event(self, event, callback):
         """
         Connect a callback function with an event.
@@ -1100,7 +1085,7 @@ def __init__(self, ax, labels, actives=None, *, useblit=True,
 
     def _clear(self, event):
         """Internal event handler to clear the buttons."""
-        if self.ignore(event) or self._changed_canvas():
+        if self.ignore(event) or self.canvas.is_saving():
             return
         self._background = self.canvas.copy_from_bbox(self.ax.bbox)
         self.ax.draw_artist(self._checks)
@@ -1677,7 +1662,7 @@ def __init__(self, ax, labels, active=0, activecolor=None, *,
 
     def _clear(self, event):
         """Internal event handler to clear the buttons."""
-        if self.ignore(event) or self._changed_canvas():
+        if self.ignore(event) or self.canvas.is_saving():
             return
         self._background = self.canvas.copy_from_bbox(self.ax.bbox)
         self.ax.draw_artist(self._buttons)
@@ -1933,7 +1918,7 @@ def __init__(self, ax, *, horizOn=True, vertOn=True, useblit=False,
 
     def clear(self, event):
         """Internal event handler to clear the cursor."""
-        if self.ignore(event) or self._changed_canvas():
+        if self.ignore(event) or self.canvas.is_saving():
             return
         if self.useblit:
             self.background = self.canvas.copy_from_bbox(self.ax.bbox)
@@ -2573,9 +2558,7 @@ def __init__(self, ax, onselect, direction, *, minspan=0, useblit=False,
         self.drag_from_anywhere = drag_from_anywhere
         self.ignore_event_outside = ignore_event_outside
 
-        # Reset canvas so that `new_axes` connects events.
-        self.canvas = None
-        self.new_axes(ax, _props=props)
+        self.new_axes(ax, _props=props, _init=True)
 
         # Setup handles
         self._handle_props = {
@@ -2588,14 +2571,15 @@ def __init__(self, ax, onselect, direction, *, minspan=0, useblit=False,
 
         self._active_handle = None
 
-    def new_axes(self, ax, *, _props=None):
+    def new_axes(self, ax, *, _props=None, _init=False):
         """Set SpanSelector to operate on a new Axes."""
-        self.ax = ax
-        if self.canvas is not ax.figure.canvas:
+        reconnect = False
+        if _init or self.canvas is not ax.figure.canvas:
             if self.canvas is not None:
                 self.disconnect_events()
-
-            self.canvas = ax.figure.canvas
+            reconnect = True
+        self.ax = ax
+        if reconnect:
             self.connect_default_events()
 
         # Reset
diff --git a/lib/matplotlib/widgets.pyi b/lib/matplotlib/widgets.pyi
index c85ad2158ee7..58adf85aae60 100644
--- a/lib/matplotlib/widgets.pyi
+++ b/lib/matplotlib/widgets.pyi
@@ -33,8 +33,9 @@ class Widget:
 
 class AxesWidget(Widget):
     ax: Axes
-    canvas: FigureCanvasBase | None
     def __init__(self, ax: Axes) -> None: ...
+    @property
+    def canvas(self) -> FigureCanvasBase | None: ...
     def connect_event(self, event: Event, callback: Callable) -> None: ...
     def disconnect_events(self) -> None: ...
 
@@ -310,7 +311,6 @@ class SpanSelector(_SelectorWidget):
     grab_range: float
     drag_from_anywhere: bool
     ignore_event_outside: bool
-    canvas: FigureCanvasBase | None
     def __init__(
         self,
         ax: Axes,
@@ -330,7 +330,13 @@ class SpanSelector(_SelectorWidget):
         ignore_event_outside: bool = ...,
         snap_values: ArrayLike | None = ...,
     ) -> None: ...
-    def new_axes(self, ax: Axes, *, _props: dict[str, Any] | None = ...) -> None: ...
+    def new_axes(
+        self,
+        ax: Axes,
+        *,
+        _props: dict[str, Any] | None = ...,
+        _init: bool = ...,
+    ) -> None: ...
     def connect_default_events(self) -> None: ...
     @property
     def direction(self) -> Literal["horizontal", "vertical"]: ...

From 53254253095b40b76336afe583820245bfb8a9db Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 4 Jul 2024 01:43:44 -0400
Subject: [PATCH 1039/1120] DOC: Create release notes for 3.9.1

---
 .../api_changes_3.9.1.rst}                    |   6 +
 doc/users/github_stats.rst                    | 876 ++++--------------
 .../prev_whats_new/github_stats_3.9.0.rst     | 744 +++++++++++++++
 doc/users/release_notes.rst                   |   2 +
 4 files changed, 914 insertions(+), 714 deletions(-)
 rename doc/api/{next_api_changes/development/28289-ES.rst => prev_api_changes/api_changes_3.9.1.rst} (86%)
 create mode 100644 doc/users/prev_whats_new/github_stats_3.9.0.rst

diff --git a/doc/api/next_api_changes/development/28289-ES.rst b/doc/api/prev_api_changes/api_changes_3.9.1.rst
similarity index 86%
rename from doc/api/next_api_changes/development/28289-ES.rst
rename to doc/api/prev_api_changes/api_changes_3.9.1.rst
index f891c63a64bf..4a9a1fc6669c 100644
--- a/doc/api/next_api_changes/development/28289-ES.rst
+++ b/doc/api/prev_api_changes/api_changes_3.9.1.rst
@@ -1,3 +1,9 @@
+API Changes for 3.9.1
+=====================
+
+Development
+-----------
+
 Documentation-specific custom Sphinx roles are now semi-public
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/doc/users/github_stats.rst b/doc/users/github_stats.rst
index 629d9319fc57..0c8f29687afb 100644
--- a/doc/users/github_stats.rst
+++ b/doc/users/github_stats.rst
@@ -1,747 +1,195 @@
 .. _github-stats:
 
-GitHub statistics for 3.9.0 (May 15, 2024)
+GitHub statistics for 3.9.1 (Jul 04, 2024)
 ==========================================
 
-GitHub statistics for 2023/09/15 (tag: v3.8.0) - 2024/05/15
+GitHub statistics for 2024/05/15 (tag: v3.9.0) - 2024/07/04
 
 These lists are automatically generated, and may be incomplete or contain duplicates.
 
-We closed 97 issues and merged 450 pull requests.
-The full list can be seen `on GitHub <https://github.com/matplotlib/matplotlib/milestone/78?closed=1>`__
+We closed 30 issues and merged 111 pull requests.
+The full list can be seen `on GitHub <https://github.com/matplotlib/matplotlib/milestone/91?closed=1>`__
 
-The following 175 authors contributed 2584 commits.
+The following 29 authors contributed 184 commits.
 
-* 0taj
-* Abdul Razak Taha
-* Adam J. Stewart
-* Adam Turner
-* Aditi Gautam
-* agautam478
-* Alan Lau
-* Albert Y. Shih
-* Alec Vercruysse
-* Alexander Volkov
-* Alice Descoeudres
-* Allan Haldane
-* Amirreza Aflakparast
-* Ananya Devarakonda
-* ananya314
-* Anja Beck
-* Anjini2004
-* Ant Lockyer
 * Antony Lee
-* Anvi Verma
-* Artyom Romanov
-* Augusto Borges
-* avramid9
-* Ben Root
-* bersbersbers
-* Binaya Sharma
-* Cameron
-* Chaoyi Hu
-* chaoyihu
-* Chiraag Balu
-* Christoph Hasse
-* ConstableCatnip
-* CozyFrog
-* Cyril Gadal
-* Dale Dai
-* Daniel Bergman
-* Daniel Hitchcock
-* danielcobej
-* David Gilbertson
-* David Stansby
-* ddale1128@gmail.com
+* Brigitta Sipőcz
+* Christian Mattsson
+* dale
 * dependabot[bot]
-* Devilsaint
-* dohyun
-* Drew Kinneer
-* DWesl
-* Elisa Heckelmann
-* ElisaHeck
 * Elliott Sales de Andrade
-* Eric Firing
-* Eric Prestat
-* esibinga
-* Eva Sibinga
-* Evgenii Radchenko
-* Faisal Fawad
-* Felipe Cybis Pereira
-* Garrett Sward
-* Gaurav-Kumar-Soni
-* Gauri Chaudhari
-* Gautam Sagar
+* Eytan Adler
 * Greg Lucas
-* Gurudatta Shanbhag
+* haaris
 * hannah
-* Haoying Zhang
-* Hugues Hoppe
-* i-jey
-* iamfaham
-* Ian Hunt-Isaak
 * Ian Thomas
-* ifEricReturnTrue
 * Illviljan
-* Issam
-* Issam Arabi
-* Jacob Stevens-Haas
-* Jacob Tomlinson
-* Jake
-* Jake Stevens-Haas
-* James Salsman
-* Jaroza727
-* Jeremy Farrell
-* Jirka
-* Jody Klymak
-* Jorge Moraleda
-* Joshua Stevenson
-* jovianw
-* João Andrade
-* jpgianfaldoni
-* jsdodge
-* jsjeelshah
-* judfs
-* Juhan Oskar Hennoste
-* Junpei Ota
-* Katherine Turk
-* katotaisei
-* KheshavKumar
-* Koustav Ghosh
-* Kritika Verma
+* K900
 * Kyle Sunden
-* Linyi Li
-* linyilily
-* lkkmpn
-* Lucia Korpas
-* madisonwong210
-* Maggie Liu
-* Marc Bresson
+* Lumberbot (aka Jack)
+* malhar2460
 * Matthew Feickert
-* Matthew Morrison
-* Matthias Bussonnier
 * Melissa Weber Mendonça
-* melissawm
-* mliu08
-* Mostafa Noah
-* MostafaNouh0011
-* n-aswin
-* Nabil
-* nbarlowATI
-* Nidaa Rabah
-* Nivedita Chaudhari
+* MischaMegens2
 * Oscar Gustafsson
-* patel-zeel
-* Pavel Liavonau
-* Pedro
-* Pedro Peçanha
-* Peter Talley
-* Pradeep Reddy Raamana
-* Prajwal Agrawal
-* Pranav Raghu
-* prateetishah
-* pre-commit-ci[bot]
-* QuadroTec
-* Rafael Tsuha
-* Raghuram Sirigiri
-* Raphael
-* Raphael Quast
-* Ratnabali Dutta
-* rawwash
-* rsp2210
-* Ruoyi
-* Ruoyi Xie
-* Rushikesh Pandya
 * Ruth Comer
-* samGreer
-* Samuel Diebolt
-* saranti
 * Scott Shambaugh
-* Sebastian Berg
-* Seohyeon Lee
-* Sheepfan0828
-* ShivamPathak99
-* Shriya Kalakata
-* shriyakalakata
-* Stefan
-* Steffen Rehberg
-* stevezhang1999
-* Sudhanshu Pandey
-* Talha Irfan
-* thehappycheese
+* simond07
+* SjoerdB93
+* Takumasa N
+* Takumasa N.
+* Takumasa Nakamura
 * Thomas A Caswell
-* Tiago Lubiana
 * Tim Hoffmann
-* tobias
-* Tom Sarantis
-* trananso
-* turnipseason
-* tusharkulkarni008
-* UFEddy
-* Vashesh08
-* vicky6
-* vigneshvetrivel8
-* wemi3
-* yangyangdotcom
-* YiLun Fan
-* Zach Champion
-* zachjweiner
-* zoehcycy
 
 GitHub issues and pull requests:
 
-Pull Requests (450):
+Pull Requests (111):
 
-* :ghpull:`28206`: Backport PR #28205 on branch v3.9.x (TST: Fix tests with older versions of ipython)
-* :ghpull:`28207`: TST: Followup corrections to #28205
-* :ghpull:`28205`: TST: Fix tests with older versions of ipython
-* :ghpull:`28203`: Backport PR #28164 on branch v3.9.x (CI: Ensure code coverage is always uploaded)
-* :ghpull:`28204`: Backport PR #28195 on branch v3.9.x (TST: Prepare for pytest 9)
-* :ghpull:`28191`: DOC: Use released mpl-sphinx-theme on v3.9.x
-* :ghpull:`28195`: TST: Prepare for pytest 9
-* :ghpull:`28193`: Backport PR #28185 on branch v3.9.x (DOC: Bump mpl-sphinx-theme to 3.9)
-* :ghpull:`28190`: Backport PR #28103 on branch v3.9.x ([DOC]: Fix compatibility with sphinx-gallery 0.16)
-* :ghpull:`28164`: CI: Ensure code coverage is always uploaded
-* :ghpull:`28194`: Backport PR #28188 on branch v3.9.x ([TST] Bump some tolerances for Macos ARM)
-* :ghpull:`28188`: [TST] Bump some tolerances for Macos ARM
-* :ghpull:`28185`: DOC: Bump mpl-sphinx-theme to 3.9
-* :ghpull:`28189`: Backport PR #28181 on branch v3.9.x (DOC: Prepare release notes for 3.9)
-* :ghpull:`28103`: [DOC]: Fix compatibility with sphinx-gallery 0.16
-* :ghpull:`28181`: DOC: Prepare release notes for 3.9
-* :ghpull:`28184`: Backport PR #28182 on branch v3.9.x (Bump custom hatch deprecation expiration)
-* :ghpull:`28182`: Bump custom hatch deprecation expiration
-* :ghpull:`28178`: Backport PR #28171 on branch v3.9.x (Support removing absent tools from ToolContainerBase.)
-* :ghpull:`28171`: Support removing absent tools from ToolContainerBase.
-* :ghpull:`28174`: Backport PR #28169 on branch v3.9.x (Clarify public-ness of some ToolContainerBase APIs.)
-* :ghpull:`28169`: Clarify public-ness of some ToolContainerBase APIs.
-* :ghpull:`28160`: Backport PR #28039 on branch v3.9.x (Respect vertical_axis when rotating plot interactively)
-* :ghpull:`28159`: Backport PR #28157 on branch v3.9.x (Remove call to non-existent method _default_contains in Artist)
-* :ghpull:`28162`: Backport PR #27948 on branch v3.9.x (Move IPython backend mapping to Matplotlib and support entry points)
-* :ghpull:`28163`: Backport PR #28144 on branch v3.9.x (DOC: Refactor code in the fishbone diagram example)
-* :ghpull:`28144`: DOC: Refactor code in the fishbone diagram example
-* :ghpull:`27948`: Move IPython backend mapping to Matplotlib and support entry points
-* :ghpull:`28039`: Respect vertical_axis when rotating plot interactively
-* :ghpull:`28157`: Remove call to non-existent method _default_contains in Artist
-* :ghpull:`28141`: Backport PR #27960 on branch v3.9.x (Update AppVeyor config)
-* :ghpull:`28138`: Backport PR #28068 on branch v3.9.x ([TYP] Add possible type hint to ``colors`` argument in ``LinearSegmentedColormap.from_list``)
-* :ghpull:`28140`: Backport PR #28136 on branch v3.9.x (Appease pycodestyle.)
-* :ghpull:`27960`: Update AppVeyor config
-* :ghpull:`28068`: [TYP] Add possible type hint to ``colors`` argument in ``LinearSegmentedColormap.from_list``
-* :ghpull:`28136`: Appease pycodestyle.
-* :ghpull:`28135`: Backport PR #28134 on branch v3.9.x (DOC: Minor improvements on quickstart)
-* :ghpull:`28134`: DOC: Minor improvements on quickstart
-* :ghpull:`28121`: Backport PR #28085 on branch v3.9.x (Clarify that the pgf backend is never actually used interactively.)
-* :ghpull:`28120`: Backport PR #28102 on branch v3.9.x (Fix typo in color mapping documentation in quick_start.py)
-* :ghpull:`28109`: Backport PR #28100 on branch v3.9.x (TST: wxcairo sometimes raises OSError on missing cairo libraries)
-* :ghpull:`28100`: TST: wxcairo sometimes raises OSError on missing cairo libraries
-* :ghpull:`28108`: Backport PR #28107 on branch v3.9.x ([DOC] Fix description in CapStyle example)
-* :ghpull:`28107`: [DOC] Fix description in CapStyle example
-* :ghpull:`28102`: Fix typo in color mapping documentation in quick_start.py
-* :ghpull:`28095`: Backport PR #28094 on branch v3.9.x (DOC: exclude sphinx 7.3.*)
-* :ghpull:`28081`: Backport PR #28078 on branch v3.9.x (Clarify that findfont & _find_fonts_by_props return paths.)
-* :ghpull:`28080`: Backport PR #28077 on branch v3.9.x (Parent tk StringVar to the canvas widget, not to the toolbar.)
-* :ghpull:`28092`: Backport PR #28032 on branch v3.9.x (FIX: ensure images are C order before passing to pillow)
-* :ghpull:`28032`: FIX: ensure images are C order before passing to pillow
-* :ghpull:`28088`: Backport PR #28087 on branch v3.9.x (Document Qt5 minimal version.)
-* :ghpull:`28085`: Clarify that the pgf backend is never actually used interactively.
-* :ghpull:`28078`: Clarify that findfont & _find_fonts_by_props return paths.
-* :ghpull:`28077`: Parent tk StringVar to the canvas widget, not to the toolbar.
-* :ghpull:`28062`: Backport PR #28056 on branch v3.9.x (Strip trailing spaces from log-formatter cursor output.)
-* :ghpull:`28063`: Backport PR #28055 on branch v3.9.x (DOC: Improve inverted axis example)
-* :ghpull:`28056`: Strip trailing spaces from log-formatter cursor output.
-* :ghpull:`28049`: Backport PR #28036 on branch v3.9.x (BLD: Fetch version from setuptools_scm at build time)
-* :ghpull:`28036`: BLD: Fetch version from setuptools_scm at build time
-* :ghpull:`28038`: Backport PR #28023 on branch v3.9.x (ci: Update merge conflict labeler)
-* :ghpull:`28023`: ci: Update merge conflict labeler
-* :ghpull:`28035`: Backport PR #28026 on branch v3.9.x ([DOC] reshuffle of contributing)
-* :ghpull:`28026`: [DOC] reshuffle of contributing
-* :ghpull:`28024`: DOC: Rewrite "Work on an issue" section
-* :ghpull:`28011`: DOC: Move bug reports and feature requests to top of contributing index
-* :ghpull:`27747`: Move doc/users/installing/ to doc/install/
-* :ghpull:`27952`: ENH: Align titles
-* :ghpull:`28017`: Merge up v3.8.4
-* :ghpull:`28014`: Improve timeline example.
-* :ghpull:`28019`: DOC: correct path to mpl_toolkits reference images
-* :ghpull:`26981`: Fixes Issue #26377 - Auto-escape % Symbol in Latex in pie labels
-* :ghpull:`28007`: wx: Fix file extension for toolmanager-style toolbar
-* :ghpull:`25556`: Display cursor coordinates for all axes twinned with the current one.
-* :ghpull:`23597`: Always use PyQT/PySide6 for GitHub CI
-* :ghpull:`28013`: Avoid plt.xticks/plt.yticks in gallery examples.
-* :ghpull:`28006`: Fix deprecation warnings in ft2font extension
-* :ghpull:`27723`: ci: Enable testing on M1 macOS
-* :ghpull:`26375`: Add ``widths``, ``heights`` and ``angles`` setter to ``EllipseCollection``
-* :ghpull:`27999`: Remove documentation that some backends don't support hatching.
-* :ghpull:`26710`: Add support for High DPI displays to wxAgg backend
-* :ghpull:`27148`: Correctly treat pan/zoom events of overlapping axes.
-* :ghpull:`27981`: DOC: Fix label type specification in parameter descriptions
-* :ghpull:`27979`: Clarify error message for bad-dimensionality in pcolorfast().
-* :ghpull:`27962`: DOC: Document axes_grid1.Grid attributes
-* :ghpull:`27968`: MNT: Remove remaining 3.7 deprecations
-* :ghpull:`27965`: DOC: Rewrite the example illustrating bxp()
-* :ghpull:`26453`: add documentation for reloading font cache
-* :ghpull:`26131`: Tst/restore old tests
-* :ghpull:`27730`: Add an rcparam for image.interpolation_stage.
-* :ghpull:`27956`: Use PyOS_setsig in macos backend
-* :ghpull:`27829`: Simplify color/marker disambiguation logic in _process_plot_format.
-* :ghpull:`27840`: Add legend support for boxplots
-* :ghpull:`27943`: Support Cn, n>9 in plot() shorthand format.
-* :ghpull:`27950`: ci: Fix condition for publishing wheels
-* :ghpull:`27909`: Add a note to pyplot docstrings referencing the corresponding object methods
-* :ghpull:`27929`: DOC: Add summary lines to plot types
-* :ghpull:`27915`: [BUG] Fix redirect-from Sphinx extension
-* :ghpull:`27945`: DOC: Explain leading dot in object references
-* :ghpull:`27947`: Update docs for ``FancyArrowPatch`` & ``Annotation`` to make it clear that ShrinkA/B parameters are in points and not fractional.
-* :ghpull:`27944`: Bump the actions group with 2 updates
-* :ghpull:`27932`: Fix pickling of make_axes_area_auto_adjustable'd axes.
-* :ghpull:`26500`: closes #26477 ENH: Add interpolation_stage in qt figureoptions
-* :ghpull:`27927`: Update docs
-* :ghpull:`27916`: Revert renaming labels to tick_labels in boxplot_stats()
-* :ghpull:`27931`: Highlight development_setup code snippets as bash, not python.
-* :ghpull:`27856`: Support hatching in cairo backends.
-* :ghpull:`27922`: Fix cbook style
-* :ghpull:`27668`: MNT: prevent merging using labels + branch protection rules
-* :ghpull:`27857`: Documentation edit for matshow function
-* :ghpull:`27928`: DOC: Fix syntax for ToolBase.image docstring
-* :ghpull:`27873`: Simplify the LineCollection example
-* :ghpull:`27492`: Fix semantics of MEP22 image names.
-* :ghpull:`27918`: Fix new flake8 errors from old merge
-* :ghpull:`27874`: Modernize macosx backend a bit
-* :ghpull:`25887`: Update ``_unpack_to_numpy`` function to convert JAX and PyTorch arrays to NumPy
-* :ghpull:`27685`: Work around pyparsing diagnostic warnings
-* :ghpull:`26594`: Added optional props argument to Lasso Widget __init__ to customize Lasso line
-* :ghpull:`22761`: Add minor ticks on and off in Axis
-* :ghpull:`22407`: Add ``set_XY`` and ``set_data`` to ``Quiver``
-* :ghpull:`27901`: Rename boxplot's tick label parameter
-* :ghpull:`27883`: Fix build on older macOS deployment targets
-* :ghpull:`27900`: Remove empty user guide tutorials page
-* :ghpull:`27885`: Clean up headers in extensions
-* :ghpull:`27910`: DOC: Fix dead link in README
-* :ghpull:`26567`: Use SVG inheritance diagrams now that linking has been fixed
-* :ghpull:`27899`: Merge up 3.8.x into main
-* :ghpull:`27905`: Improved error message for malformed colors
-* :ghpull:`27906`: Override open_group, close_group methods in PathEffectRenderer
-* :ghpull:`27904`: FIX: Restore D213 in flake8
-* :ghpull:`27895`: Remove versions from sidebar in docs
-* :ghpull:`27894`: Mark triangulation classes as final
-* :ghpull:`27557`: Use :mpltype:``color`` for color types
-* :ghpull:`27845`: Make sure custom alpha param does not change 'none' colors in a list of colors
-* :ghpull:`27719`: Add BackendRegistry singleton class
-* :ghpull:`27890`: DOC: State approximate documentation build time
-* :ghpull:`27887`: BLD: Add a fallback URL for FreeType
-* :ghpull:`25224`: Allow passing a transformation to secondary_xaxis/_yaxis
-* :ghpull:`27886`: Fix devdocs version switcher
-* :ghpull:`27884`: FIX: don't copy twice on RGB input
-* :ghpull:`27087`: Convert path extension to pybind11
-* :ghpull:`27867`: DOC: Update some animation related topics
-* :ghpull:`27848`: FIX: handle nans in RGBA input with ScalarMappables
-* :ghpull:`27821`: BLD,Cygwin: Include Python.h first in various C++ files
-* :ghpull:`27457`: TST: adding tests of current clear behavior on ticks
-* :ghpull:`27872`: doc: add description of ``**kwargs`` usage to collections
-* :ghpull:`27868`: Use pybind11 string formatter for exception messages
-* :ghpull:`27862`: Add dtype/copy args to internal testing class
-* :ghpull:`27658`: Bump pydata-sphinx-theme
-* :ghpull:`27303`: FIX: also exclude np.nan in RGB(A) in color mapping
-* :ghpull:`27860`: Bump the actions group with 2 updates
-* :ghpull:`27869`: Correctly set temporary pdf/pgf backends
-* :ghpull:`27850`: Deprecate ``plot_date``
-* :ghpull:`27815`: Add side option to violinplot
-* :ghpull:`27836`: DOC: use ... for continuation prompt in docstrings
-* :ghpull:`27819`: MNT: remove draw method args and kwargs
-* :ghpull:`27813`: DOC: Update violinplot() docs
-* :ghpull:`27698`: Add linting and validation of all YAML files
-* :ghpull:`27811`: Fix Annulus width check
-* :ghpull:`27667`: Change return type of ``ion`` and ``ioff`` to fix unbound variable errors with Pyright
-* :ghpull:`27807`: Expand CI pytest reporting config to ignore xfails
-* :ghpull:`27806`: Remove self._renderer from AnnotationBbox and ConnectionPatch
-* :ghpull:`27799`: Clarify that set_ticks() affects major/minor ticks independently
-* :ghpull:`27787`: Improve documentation on boxplot and violinplot
-* :ghpull:`27800`: Deactivate sidebar for release notes
-* :ghpull:`27798`: Fix sphinx-gallery CSS
-* :ghpull:`27462`: DOC: clarify the default value of *radius* in Patch.contains_point
-* :ghpull:`27565`: MNT: arghandling subplotspec
-* :ghpull:`27796`: Make mypy a bit stricter
-* :ghpull:`27767`: Update handling of sequence labels for plot
-* :ghpull:`27795`: Add EffVer badge
-* :ghpull:`27780`: Partly revert #27711
-* :ghpull:`27768`: MNT: deprecate draw method args and kwargs
-* :ghpull:`27783`: Update README.md to fix citation link
-* :ghpull:`27726`: TST: always set a (long) timeout for subprocess and always use our wrapper
-* :ghpull:`27781`: Simplify example: Box plots with custom fill colors
-* :ghpull:`27750`: Bump the actions group with 2 updates
-* :ghpull:`27771`: Add marker-only and line+marker visuals to the plot() plot types
-* :ghpull:`27764`: Increase size of legend in Legend guide example
-* :ghpull:`26800`: Bump minimum NumPy version to 1.23
-* :ghpull:`27752`: Update some Meson internals
-* :ghpull:`27702`: GOV: adopt EffVer
-* :ghpull:`26965`: Removal of deprecated API cm
-* :ghpull:`27758`: [Doc] Remove special casing for removed method
-* :ghpull:`25815`: [TST] Make jpl units instantiated with datetimes consistent with mpl converters
-* :ghpull:`27729`: DOC: Improve colormap normalization example
-* :ghpull:`27732`: TST: Remove memory leak test
-* :ghpull:`27733`: ci: Simplify CodeQL setup
-* :ghpull:`27692`: Add method to update position of arrow patch
-* :ghpull:`27736`: Fix incorrect API reference in docs
-* :ghpull:`27731`: DOC: Create explicit rename legend entry section in guide
-* :ghpull:`27560`: Moved /users/project to /doc/project
-* :ghpull:`27728`: Simplify Figure._suplabels.
-* :ghpull:`27715`: Bump the actions group with 3 updates
-* :ghpull:`27711`: Fix boxplot legend entries part 2
-* :ghpull:`27696`: DOC: clean up automated tests section of workflow docs
-* :ghpull:`27686`: Improve Locator docstrings
-* :ghpull:`27704`: ci: Remove prerelease conditions from Azure Pipelines
-* :ghpull:`27568`: Fix boxplot legend entries
-* :ghpull:`27694`: MNT: fix labeller
-* :ghpull:`26953`: MNT: test that table doesn't try to convert unitized data
-* :ghpull:`27690`: Remove "Past versions" section from release notes
-* :ghpull:`26926`: Closes #22011: Changes to SubFigures so it behaves like a regular artist
-* :ghpull:`27469`: Fixed legend with legend location "best" when legend overlaps shaded area and text
-* :ghpull:`27684`: Bump the actions group with 1 update
-* :ghpull:`27665`: Axes.inset_axes - warning message removed
-* :ghpull:`27688`: CI: skip code coverage upload on scheduled tests
-* :ghpull:`27689`: ci: Don't include API/what's new notes in general doc labels
-* :ghpull:`27640`: Add ``get_cursor_data`` to ``NonUniformImage``
-* :ghpull:`27676`: BLD: Downgrade FreeType to 2.6.1 on Windows ARM
-* :ghpull:`27619`: Use GH action to install reviewdog
-* :ghpull:`27552`: TST: Use importlib for importing in pytest
-* :ghpull:`27650`: DOC: Added call out to API guidelines to contribute + small API guidelines reorg
-* :ghpull:`27618`: Add option of running stubtest using tox
-* :ghpull:`27656`: Bump the actions group with 1 update
-* :ghpull:`27415`: Use class form of data classes
-* :ghpull:`27649`: Check for latex binary before building docs
-* :ghpull:`27641`: MNT: fix api changes link in PR template
-* :ghpull:`27644`: ci: Fix mpl_toolkits label
-* :ghpull:`27230`: Query macOS for available system fonts.
-* :ghpull:`27643`: ci: Update nightly upload for artifacts v4
-* :ghpull:`27642`: Fix auto-labeler configuration
-* :ghpull:`27639`: Doc: typo fix for #22699
-* :ghpull:`26978`: [pre-commit.ci] pre-commit autoupdate
-* :ghpull:`27563`: Enable PyPI publishing from GitHub Actions
-* :ghpull:`22699`: Proof of concept for adding kwdoc content to properties using a decorator
-* :ghpull:`27633`: Auto-label PRs based on changed files
-* :ghpull:`27607`: Error on bad input to hexbin extents
-* :ghpull:`27629`: Don't run CI twice on dependabot branches
-* :ghpull:`27562`: Avoid an extra copy/resample if imshow input has no alpha
-* :ghpull:`27628`: Bump the actions group with 2 updates
-* :ghpull:`27626`: CI: Group dependabot updates
-* :ghpull:`27589`: Don't clip PowerNorm inputs < vmin
-* :ghpull:`27613`: Fix marker validator with cycler (allow mix of classes)
-* :ghpull:`27615`: MNT: add spaces to PR template
-* :ghpull:`27614`: DOC: Updated link in annotation API docs to point to annotation user guide
-* :ghpull:`27605`: Ignore masked values in boxplot
-* :ghpull:`26884`: Remove deprecated code from _fontconfig_patterns
-* :ghpull:`27602`: Let FormatStrFormatter respect axes.unicode_minus.
-* :ghpull:`27601`: Clarify dollar_ticks example and FormatStrFormatter docs.
-* :ghpull:`24834`: Deprecate apply_theta_transforms=True to PolarTransform
-* :ghpull:`27591`: Use macOS instead of OSX in comments/docs
-* :ghpull:`27577`: MNT: add the running version to pickle warning message
-* :ghpull:`25191`: Deprecate 'prune' kwarg to MaxNLocator
-* :ghpull:`27566`: DOC: changed tag ``plot type`` to ``plot-type``
-* :ghpull:`27105`: Use Axes instead of axes core library code
-* :ghpull:`27575`: Add quotes round .[dev] in editable install command
-* :ghpull:`27104`: Use Axes instead of axes in galleries
-* :ghpull:`27373`: Transpose grid_finder tick representation.
-* :ghpull:`27363`: ci: Improve coverage for compiled code
-* :ghpull:`27200`: DOC: Add role for custom informal types like color
-* :ghpull:`27548`: DOC: typo fix in contribute doc
-* :ghpull:`27458`: Check if the mappable is in a different Figure than the one fig.color…
-* :ghpull:`27546`: MNT: Clean up some style exceptions
-* :ghpull:`27514`: Improve check for bbox
-* :ghpull:`27265`: DOC: reorganizing contributing docs to clean up toc, better separate topics
-* :ghpull:`27517`: Best-legend-location microoptimization
-* :ghpull:`27540`: Bump github/codeql-action from 2 to 3
-* :ghpull:`27520`: [Doc] Minor consistency changes and correction of Marker docs
-* :ghpull:`27505`: Download Qhull source from Github, not Qhull servers, in meson build
-* :ghpull:`27518`: Micro-optimizations related to list handling
-* :ghpull:`27495`: Bump actions/stale from 8 to 9
-* :ghpull:`27523`: Changes for stale GHA v9
-* :ghpull:`27519`: [Doc] Improve/correct docs for 3D
-* :ghpull:`27447`: TST: Compress some hist geometry tests
-* :ghpull:`27513`: Fix docs and add tests for transform and deprecate ``BboxTransformToMaxOnly``
-* :ghpull:`27511`: TST: Add tests for Affine2D
-* :ghpull:`27424`: Added Axes.stairs test in test_datetime.py
-* :ghpull:`27267`: Fix/restore secondary axis support for Transform-type functions
-* :ghpull:`27013`: Add test_contour under test_datetime.py
-* :ghpull:`27497`: Clarify that set_axisbelow doesn't move grids below images.
-* :ghpull:`27498`: Remove unnecessary del local variables at end of Gcf.destroy.
-* :ghpull:`27466`: Add test_eventplot to test_datetime.py
-* :ghpull:`25905`: Use annotate coordinate systems to simplify label_subplots.
-* :ghpull:`27471`: Doc: visualizing_tests and ``triage_tests`` tools
-* :ghpull:`27474`: Added smoke test for Axes.matshow to test_datetime.py
-* :ghpull:`27470`: Fix test visualization tool for non-PNG files
-* :ghpull:`27426`: DOC: normalizing histograms
-* :ghpull:`27452`: Cleanup unit_cube-methods
-* :ghpull:`27431`: Added test for Axes.bar_label
-* :ghpull:`26962`: Remove backend 3.7-deprecated API
-* :ghpull:`27410`: Add test_vlines to test_datetime.py
-* :ghpull:`27425`: Added test_fill_betweenx in test_datetime.py
-* :ghpull:`27449`: Remove test_quiverkey from test_datetime.py
-* :ghpull:`27427`: MNT/TST: remove xcorr and acorr from test_datetime
-* :ghpull:`27390`: Add test_bxp in test_datetime.py
-* :ghpull:`27428`: Added test for broken_barh to test_datetime.py
-* :ghpull:`27222`: [TST] Added test_annotate in test_datetime.py
-* :ghpull:`27135`: Added smoke test for Axes.stem
-* :ghpull:`27343`: Fix draggable annotations on subfigures.
-* :ghpull:`27033`: Add test_bar in test_datetime
-* :ghpull:`27423`: Add test for fill_between in test_datetime.py
-* :ghpull:`27409`: Fix setting ``_selection_completed`` in ``SpanSelector`` when spanselector is initialised using ``extents``
-* :ghpull:`27440`: Fix get_path for 3d artists
-* :ghpull:`27422`: TST: Cache available interactive backends
-* :ghpull:`27401`: Add test_fill in test_datetime.py
-* :ghpull:`27419`: DOC: Add AsinhScale to list of built-in scales
-* :ghpull:`27417`: Switch pytest fixture from tmpdir to tmp_path
-* :ghpull:`27172`: ENH: Change logging to warning when creating a legend with no labels
-* :ghpull:`27405`: Check that xerr/yerr values are not None in errorbar
-* :ghpull:`27392`: Remove test_spy from test_datetime.py
-* :ghpull:`27331`: Added smoke test for Axes.barbs in test_datetime.py
-* :ghpull:`27393`: MNT: Fix doc makefiles
-* :ghpull:`27387`: Revert "MNT: add _version.py to .gitignore"
-* :ghpull:`27347`: FIX: scale norm of collections when first array is set
-* :ghpull:`27374`: MNT: add _version.py to .gitignore
-* :ghpull:`19011`: Simplify tk tooltip setup.
-* :ghpull:`27367`: Fix _find_fonts_by_props docstring
-* :ghpull:`27359`: Fix build on PyPy
-* :ghpull:`27362`: Implement SubFigure.remove.
-* :ghpull:`27360`: Fix removal of colorbars on nested subgridspecs.
-* :ghpull:`27211`: Add test_hlines to test_datetimes.py
-* :ghpull:`27353`: Refactor AxisArtistHelpers
-* :ghpull:`27357`: [DOC]: Update 3d axis limits what's new
-* :ghpull:`26992`: Convert TkAgg utilities to pybind11
-* :ghpull:`27215`: Add ``@QtCore.Slot()`` decorations to ``NavigationToolbar2QT``
-* :ghpull:`26907`: Removal of deprecations for Contour
-* :ghpull:`27285`: Factor out common parts of qt and macos interrupt handling.
-* :ghpull:`27306`: Simplify GridSpec setup in make_axes_gridspec.
-* :ghpull:`27313`: FIX: allow re-shown Qt windows to be re-destroyed
-* :ghpull:`27184`: Use pybind11 for qhull wrapper
-* :ghpull:`26794`: Use pybind11 in _c_internal_utils module
-* :ghpull:`27300`: Remove idiosyncratic get_tick_iterator API.
-* :ghpull:`27275`: MAINT: fix .yml in tag issue template
-* :ghpull:`27288`: Use int.from_bytes instead of implementing the conversion ourselves.
-* :ghpull:`27286`: Various cleanups
-* :ghpull:`27279`: Tweak a few docstrings.
-* :ghpull:`27256`: merge up v3.8.1
-* :ghpull:`27254`: Remove redundant axes_grid colorbar examples.
-* :ghpull:`27251`: webagg: Don't resize canvas if WebSocket isn't connected
-* :ghpull:`27236`: Tagging Example - Tags for multiple figs demo
-* :ghpull:`27245`: MNT: be more careful in Qt backend that there is actually a Figure
-* :ghpull:`27158`: First attempt for individual hatching styles for stackplot
-* :ghpull:`26851`: Establish draft Tag glossary and Tagging guidelines
-* :ghpull:`27083`: DOC: Add tags infrastructure for gallery examples
-* :ghpull:`27204`: BLD: Use NumPy nightly wheels for non-release builds
-* :ghpull:`27208`: Add test_axvline to test_datetime.py
-* :ghpull:`26989`: MNT: print fontname in missing glyph warning
-* :ghpull:`27177`: Add test_axhline in test_datetime.py
-* :ghpull:`27164`: docs: adding explanation for color in ``set_facecolor``
-* :ghpull:`27175`: Deprecate mixing positional and keyword args for legend(handles, labels)
-* :ghpull:`27199`: DOC: clean up links under table formatting docs
-* :ghpull:`27185`: Added smoke tests for Axes.errorbar in test_datetime.py
-* :ghpull:`27091`: Add test_step to test_datetime.py
-* :ghpull:`27182`: Add example for plotting a bihistogram
-* :ghpull:`27130`: added test_axvspan in test.datetime.py
-* :ghpull:`27094`: MNT: move pytest.ini configs to .toml
-* :ghpull:`27139`: added test_axhspan in test_datetime.py
-* :ghpull:`27058`: DOC: concise dependency heading + small clarifications
-* :ghpull:`27053`: Added info for getting compilation output from meson on autorebuild
-* :ghpull:`26906`: Fix masking for Axes3D.plot()
-* :ghpull:`27142`: Added smoke test for Axes.text in test_datetime.py
-* :ghpull:`27024`: Add test_contourf in test_datetime.py
-* :ghpull:`22347`: correctly treat pan/zoom events of overlapping axes
-* :ghpull:`26900`: #26865 removing deprecations to axislines.py
-* :ghpull:`26696`: DOC: Fix colLoc default
-* :ghpull:`27064`: Close all plot windows of a blocking show() on Ctrl+C
-* :ghpull:`26882`: Add scatter test for datetime units
-* :ghpull:`27114`: add test_stackplot in test_datetime.py
-* :ghpull:`27084`: Add test_barh to test_datetime.py
-* :ghpull:`27110`: DOC: Move figure member sections one level down
-* :ghpull:`27127`: BLD: use python3 for shebang consistent with pep-394
-* :ghpull:`27111`: BLD: Fix setting FreeType build type in extension
-* :ghpull:`26921`: MNT: clarify path.sketch rcparam format + test validate_sketch
-* :ghpull:`27109`: TST: Use importlib for subprocess tests
-* :ghpull:`27119`: Update clabel comment.
-* :ghpull:`27117`: Remove datetime test for axes.pie
-* :ghpull:`27095`: Deprecate nth_coord parameter from FixedAxisArtistHelper.new_fixed_axis.
-* :ghpull:`27066`: Tweak array_view to be more like pybind11
-* :ghpull:`27090`: Restore figaspect() API documentation
-* :ghpull:`27074`: Issue #26990: Split the histogram image into two for each code block.
-* :ghpull:`27086`: Rename py namespace to mpl in extension code
-* :ghpull:`27082`: MAINT: Update environment.yml to match requirements files
-* :ghpull:`27072`: Remove datetime test stubs for spectral methods/table
-* :ghpull:`26830`: Update stix table with Unicode names
-* :ghpull:`26969`: DOC: add units to user/explain [ci doc]
-* :ghpull:`27028`: Added test_hist in test_datetime.py
-* :ghpull:`26876`: issue: 26871 - Remove SimplePath class from patches.py
-* :ghpull:`26875`: Fix Deprecation in patches.py
-* :ghpull:`26890`: Removing deprecated api from patches
-* :ghpull:`27037`: add test_plot_date in test_datetime.py
-* :ghpull:`27012`: Bump required C++ standard to c++17
-* :ghpull:`27021`: Add a section to Highlight past winners for JDH plotting contest in docs
-* :ghpull:`27004`: Warning if handles and labels have a len mismatch
-* :ghpull:`24061`: #24050 No error was thrown even number of handles mismatched labels
-* :ghpull:`26754`: DOC: separate and clarify axisartist default tables
-* :ghpull:`27020`: CI: Update scientific-python/upload-nightly-action to 0.2.0
-* :ghpull:`26951`: Clarify that explicit ticklabels are used without further formatting.
-* :ghpull:`26894`: Deprecate setting the timer interval while starting it.
-* :ghpull:`13401`: New clear() method for Radio and Check buttons
-* :ghpull:`23829`: Start transitioning to pyproject.toml
-* :ghpull:`26621`: Port build system to Meson
-* :ghpull:`26928`: [TYP] Add tool for running stubtest
-* :ghpull:`26917`: Deprecate ContourLabeler.add_label_clabeltext.
-* :ghpull:`26960`: Deprecate backend_ps.get_bbox_header, and split it for internal use.
-* :ghpull:`26967`: Minor cleanups.
-* :ghpull:`26909`: deprecated api tri
-* :ghpull:`26946`: Inline Cursor._update into its sole caller.
-* :ghpull:`26915`: DOC: Clarify description and add examples in colors.Normalize
-* :ghpull:`26874`: Cleaned up the span_where class method from Polycollections.
-* :ghpull:`26586`: Support standard formatters in axisartist.
-* :ghpull:`26788`: Fix axh{line,span} on polar axes.
-* :ghpull:`26935`: add tomli to rstcheck extras
-* :ghpull:`26275`: Use pybind11 in image module
-* :ghpull:`26887`: DOC: improve removal for julian dates [ci doc]
-* :ghpull:`26929`: DOC: Fix removal doc for Animation attributes
-* :ghpull:`26918`: 26865 Removed deprecations from quiver.py
-* :ghpull:`26902`: Fixed deprecated APIs in lines.py
-* :ghpull:`26903`: Simplify CheckButtons and RadioButtons click handler.
-* :ghpull:`26899`: MNT: only account for Artists once in fig.get_tightbbox
-* :ghpull:`26861`: QT/NavigationToolbar2: configure subplots dialog should be modal
-* :ghpull:`26885`: Removed deprecated code from gridspec.py
-* :ghpull:`26880`: Updated offsetbox.py
-* :ghpull:`26910`: Removed the deprecated code from offsetbox.py
-* :ghpull:`26905`: Add users/explain to default skip subdirs
-* :ghpull:`26853`: Widgets: Remove deprecations and make arguments keyword only
-* :ghpull:`26877`: Fixes deprecation in lines.py
-* :ghpull:`26871`: Removed the deprecated code from ``axis.py``
-* :ghpull:`26872`: Deprecated code removed in animation.py
-* :ghpull:`26859`: Add datetime testing skeleton
-* :ghpull:`26848`: ci: Don't install recommended packages on Circle
-* :ghpull:`26852`: Remove Julian date support
-* :ghpull:`26801`: [MNT]: Cleanup ticklabel_format (style=)
-* :ghpull:`26840`: Reduce redundant information in _process_plot_var_args.
-* :ghpull:`26731`: Explicitly set foreground color to black in svg icons
-* :ghpull:`26826`: [MNT] Move NUM_VERTICES from mplutils.h to the only file it is used in
-* :ghpull:`26742`: [TYP] Add typing for some private methods and modules
-* :ghpull:`26819`: Reorder safe_first_element() and _safe_first_finite() code
-* :ghpull:`26813`: Bump docker/setup-qemu-action from 2 to 3
-* :ghpull:`26797`: Remove deprecated draw_gouraud_triangle
-* :ghpull:`26815`: Remove plt.Axes from tests
-* :ghpull:`26818`: Fix doc build (alternative)
-* :ghpull:`26785`: merge up v3.8.0
-* :ghpull:`25272`: Do not add padding to 3D axis limits when limits are manually set
-* :ghpull:`26798`: Remove deprecated methods and attributed in Axes3D
-* :ghpull:`26744`: Use cbook methods for string checking
-* :ghpull:`26802`: specify input range in logs when image data must be clipped
-* :ghpull:`26787`: Remove unused Axis private init helpers.
-* :ghpull:`26629`: DOC: organize figure API
-* :ghpull:`26690`: Make generated pgf code more robust against later changes of tex engine.
-* :ghpull:`26577`: Bugfix: data sanitizing for barh
-* :ghpull:`26684`: Update PR template doc links
-* :ghpull:`26686`: PR template: shorten comment and pull up top
-* :ghpull:`26670`: Added sanitize_sequence to kwargs in _preprocess_data
-* :ghpull:`26634`: [MNT] Move SubplotParams from figure to gridspec
-* :ghpull:`26609`: Cleanup AutoMinorLocator implementation.
-* :ghpull:`26293`: Added get_xmargin(), get_ymargin() and get_zmargin() and tests.
-* :ghpull:`26516`: Replace reference to %pylab by %matplotlib.
-* :ghpull:`26483`: Improve legend(loc='best') warning and test
-* :ghpull:`26482`: [DOC]: print pydata sphinx/mpl theme versions
-* :ghpull:`23787`: Use pybind11 for C/C++ extensions
+* :ghpull:`28507`: Backport PR #28430 on branch v3.9.x (Fix pickling of AxesWidgets.)
+* :ghpull:`28506`: Backport PR #28451 on branch v3.9.x (Fix GTK cairo backends)
+* :ghpull:`28430`: Fix pickling of AxesWidgets.
+* :ghpull:`25861`: Fix Hidpi scaling for GTK4Cairo
+* :ghpull:`28451`: Fix GTK cairo backends
+* :ghpull:`28499`: Backport PR #28498 on branch v3.9.x (Don't fail if we can't query system fonts on macOS)
+* :ghpull:`28498`: Don't fail if we can't query system fonts on macOS
+* :ghpull:`28491`: Backport PR #28487 on branch v3.9.x (Fix autoscaling with axhspan)
+* :ghpull:`28490`: Backport PR #28486 on branch v3.9.x (Fix CompositeGenericTransform.contains_branch_seperately)
+* :ghpull:`28487`: Fix autoscaling with axhspan
+* :ghpull:`28486`: Fix CompositeGenericTransform.contains_branch_seperately
+* :ghpull:`28483`: Backport PR #28393 on branch v3.9.x (Make sticky edges only apply if the sticky edge is the most extreme limit point)
+* :ghpull:`28482`: Backport PR #28473 on branch v3.9.x (Do not lowercase module:// backends)
+* :ghpull:`28393`: Make sticky edges only apply if the sticky edge is the most extreme limit point
+* :ghpull:`28473`: Do not lowercase module:// backends
+* :ghpull:`28480`: Backport PR #28474 on branch v3.9.x (Fix typing and docs for containers)
+* :ghpull:`28479`: Backport PR #28397 (FIX: stale root Figure when adding/updating subfigures)
+* :ghpull:`28474`: Fix typing and docs for containers
+* :ghpull:`28472`: Backport PR #28289 on branch v3.9.x (Promote mpltype Sphinx role to a public extension)
+* :ghpull:`28471`: Backport PR #28342 on branch v3.9.x (DOC: Document the parameter *position* of apply_aspect() as internal)
+* :ghpull:`28470`: Backport PR #28398 on branch v3.9.x (Add GIL Release to flush_events in macosx backend)
+* :ghpull:`28469`: Backport PR #28355 on branch v3.9.x (MNT: Re-add matplotlib.cm.get_cmap)
+* :ghpull:`28397`: FIX: stale root Figure when adding/updating subfigures
+* :ghpull:`28289`: Promote mpltype Sphinx role to a public extension
+* :ghpull:`28342`: DOC: Document the parameter *position* of apply_aspect() as internal
+* :ghpull:`28398`: Add GIL Release to flush_events in macosx backend
+* :ghpull:`28355`: MNT: Re-add matplotlib.cm.get_cmap
+* :ghpull:`28468`: Backport PR #28465 on branch v3.9.x (Fix pickling of SubFigures)
+* :ghpull:`28465`: Fix pickling of SubFigures
+* :ghpull:`28462`: Backport PR #28440 on branch v3.9.x (DOC: Add note about simplification of to_polygons)
+* :ghpull:`28460`: Backport PR #28459 on branch v3.9.x (DOC: Document kwargs scope for tick setter functions)
+* :ghpull:`28461`: Backport PR #28458 on branch v3.9.x (Correct numpy dtype comparisons in image_resample)
+* :ghpull:`28440`: DOC: Add note about simplification of to_polygons
+* :ghpull:`28458`: Correct numpy dtype comparisons in image_resample
+* :ghpull:`28459`: DOC: Document kwargs scope for tick setter functions
+* :ghpull:`28450`: Backport of 28371 and 28411
+* :ghpull:`28446`: Backport PR #28403 on branch v3.9.x (FIX: Autoscale support in add_collection3d for Line3DCollection and Poly3DCollection
+* :ghpull:`28445`: Backport PR #28403 on branch v3.9.x (FIX: Autoscale support in add_collection3d for Line3DCollection and Poly3DCollection)
+* :ghpull:`28438`: Backport PR #28436 on branch v3.9.x (Fix ``is_color_like`` for 2-tuple of strings and fix ``to_rgba`` for ``(nth_color, alpha)``)
+* :ghpull:`28403`: FIX: Autoscale support in add_collection3d for Line3DCollection and Poly3DCollection
+* :ghpull:`28443`: Backport PR #28441 on branch v3.9.x (MNT: Update basic units example to work with numpy 2.0)
+* :ghpull:`28441`: MNT: Update basic units example to work with numpy 2.0
+* :ghpull:`28436`: Fix ``is_color_like`` for 2-tuple of strings and fix ``to_rgba`` for ``(nth_color, alpha)``
+* :ghpull:`28426`: Backport PR #28425 on branch v3.9.x (Fix Circle yaml line length)
+* :ghpull:`28427`: Fix circleci yaml
+* :ghpull:`28425`: Fix Circle yaml line length
+* :ghpull:`28422`: Backport PR #28401 on branch v3.9.x (FIX: Fix text wrapping)
+* :ghpull:`28424`: Backport PR #28423 on branch v3.9.x (Update return type for Axes.axhspan and Axes.axvspan)
+* :ghpull:`28423`: Update return type for Axes.axhspan and Axes.axvspan
+* :ghpull:`28401`: FIX: Fix text wrapping
+* :ghpull:`28419`: Backport PR #28414 on branch v3.9.x (Clean up obsolete widget code)
+* :ghpull:`28411`: Bump the actions group with 3 updates
+* :ghpull:`28414`: Clean up obsolete widget code
+* :ghpull:`28415`: Backport PR #28413 on branch v3.9.x (CI: update action that got moved org)
+* :ghpull:`28413`: CI: update action that got moved org
+* :ghpull:`28392`: Backport PR #28388 on branch v3.9.x (Allow duplicate (name, value) entry points for backends)
+* :ghpull:`28362`: Backport PR #28337 on branch v3.9.x (Bump the actions group across 1 directory with 3 updates)
+* :ghpull:`28388`: Allow duplicate (name, value) entry points for backends
+* :ghpull:`28389`: Backport PR #28380 on branch v3.9.x (Remove outdated docstring section in RendererBase.draw_text.)
+* :ghpull:`28380`: Remove outdated docstring section in RendererBase.draw_text.
+* :ghpull:`28385`: Backport PR #28377 on branch v3.9.x (DOC: Clarify scope of wrap.)
+* :ghpull:`28377`: DOC: Clarify scope of wrap.
+* :ghpull:`28368`: Backport PR #28359 on branch v3.9.x (Document that axes unsharing is impossible.)
+* :ghpull:`28359`: Document that axes unsharing is impossible.
+* :ghpull:`28337`: Bump the actions group across 1 directory with 3 updates
+* :ghpull:`28351`: Backport PR #28307 on branch v3.9.x (DOC: New color line by value example)
+* :ghpull:`28307`: DOC: New color line by value example
+* :ghpull:`28339`: Backport PR #28336 on branch v3.9.x (DOC: Add version warning banner for docs versions different from stable)
+* :ghpull:`28336`: DOC: Add version warning banner for docs versions different from stable
+* :ghpull:`28334`: Backport PR #28332 on branch v3.9.x (Call IPython.enable_gui when install repl displayhook)
+* :ghpull:`28332`: Call IPython.enable_gui when install repl displayhook
+* :ghpull:`28331`: Backport PR #28329 on branch v3.9.x (DOC: Add example for 3D intersecting planes)
+* :ghpull:`28329`: DOC: Add example for 3D intersecting planes
+* :ghpull:`28327`: Backport PR #28292 on branch v3.9.x (Resolve MaxNLocator IndexError when no large steps)
+* :ghpull:`28292`: Resolve MaxNLocator IndexError when no large steps
+* :ghpull:`28326`: Backport PR #28041 on branch v3.9.x ([BUG]: Shift box_aspect according to vertical_axis)
+* :ghpull:`28041`: [BUG]: Shift box_aspect according to vertical_axis
+* :ghpull:`28320`: Backport PR #27001 on branch v3.9.x ([TYP] Add overload of ``pyplot.subplots``)
+* :ghpull:`27001`: [TYP] Add overload of ``pyplot.subplots``
+* :ghpull:`28318`: Backport PR #28273 on branch v3.9.x (CI: Add GitHub artifact attestations to package distribution)
+* :ghpull:`28273`: CI: Add GitHub artifact attestations to package distribution
+* :ghpull:`28305`: Backport PR #28303 on branch v3.9.x (Removed drawedges repeated definition from function doc string)
+* :ghpull:`28303`: Removed drawedges repeated definition from function doc string
+* :ghpull:`28299`: Backport PR #28297 on branch v3.9.x (Solved #28296 Added missing comma)
+* :ghpull:`28297`: Solved #28296 Added missing comma
+* :ghpull:`28294`: Backport PR #28261 on branch v3.9.x (Correct roll angle units, issue #28256)
+* :ghpull:`28261`: Correct roll angle units, issue #28256
+* :ghpull:`28283`: Backport PR #28280 on branch v3.9.x (DOC: Add an example for 2D images in 3D plots)
+* :ghpull:`28280`: DOC: Add an example for 2D images in 3D plots
+* :ghpull:`28278`: Backport PR #28272 on branch v3.9.x (BLD: Move macos builders from 11 to 12)
+* :ghpull:`28277`: Backport PR #28274 on branch v3.9.x (ci: Remove deprecated codeql option)
+* :ghpull:`28272`: BLD: Move macos builders from 11 to 12
+* :ghpull:`28274`: ci: Remove deprecated codeql option
+* :ghpull:`28270`: Backport PR #28269 on branch v3.9.x (Handle GetForegroundWindow() returning NULL.)
+* :ghpull:`28269`: Handle GetForegroundWindow() returning NULL.
+* :ghpull:`28266`: Backport PR #28257 on branch v3.9.x (Clean up some Meson-related leftovers)
+* :ghpull:`28257`: Clean up some Meson-related leftovers
+* :ghpull:`28255`: Backport PR #28254 on branch v3.9.x ([DOC] plot type heading consistency)
+* :ghpull:`28254`: [DOC] plot type heading consistency
+* :ghpull:`28253`: Backport PR #28252 on branch v3.9.x (DOC: Flip the imshow plot types example to match the other examples)
+* :ghpull:`28252`: DOC: Flip the imshow plot types example to match the other examples
+* :ghpull:`28247`: Backport PR #28230 on branch v3.9.x (Add extra imports to improve typing)
+* :ghpull:`28230`: Add extra imports to improve typing
+* :ghpull:`28246`: Backport PR #28243 on branch v3.9.x (DOC: Add more 3D plot types)
+* :ghpull:`28243`: DOC: Add more 3D plot types
+* :ghpull:`28241`: Backport PR #28219 on branch v3.9.x (Bump the actions group with 2 updates)
+* :ghpull:`28219`: Bump the actions group with 2 updates
+* :ghpull:`28237`: Backport PR #28233 on branch v3.9.x (CI: Fix font install on macOS/Homebrew)
+* :ghpull:`28236`: Backport PR #28231 on branch v3.9.x (DOC: we do not need the blit call in on_draw)
+* :ghpull:`28233`: CI: Fix font install on macOS/Homebrew
+* :ghpull:`28231`: DOC: we do not need the blit call in on_draw
 
-Issues (97):
+Issues (30):
 
-* :ghissue:`28202`: [Bug]: Qt test_ipython fails on older ipython
-* :ghissue:`28145`: [TST] Upcoming dependency test failures
-* :ghissue:`28034`: [TST] Upcoming dependency test failures
-* :ghissue:`28168`: [TST] Upcoming dependency test failures
-* :ghissue:`28040`: [Bug]: vertical_axis not respected when rotating plots interactively
-* :ghissue:`28146`: [Bug]: Useless recursive group in SVG output when using path_effects
-* :ghissue:`28067`: [Bug]: ``LinearSegmentedColormap.from_list`` does not have all type hints for argument ``colors``
-* :ghissue:`26778`: [MNT]: Numpy 2.0 support strategy
-* :ghissue:`28020`: [Bug]: imsave fails on RGBA data when origin is set to lower
-* :ghissue:`7720`: WXAgg backend not rendering nicely on retina
-* :ghissue:`28069`: [Bug]: Can't save with custom toolbar
-* :ghissue:`28005`: [Doc]: Improve contribute instructions
-* :ghissue:`22376`: [ENH]: align_titles
-* :ghissue:`5506`: Confusing status bar values in presence of multiple axes
-* :ghissue:`4284`: Twin axis message coordinates
-* :ghissue:`18940`: WxAgg backend draws the wrong size when wxpython app is high DPI aware on Windows
-* :ghissue:`27792`: [ENH]: Legend entries for boxplot
-* :ghissue:`27828`: [Bug]: ".C10" does not work as plot shorthand format spec
-* :ghissue:`27911`: redirect not working for updated contribute page
-* :ghissue:`21876`: [Doc]: redirect-from directive appears broken?
-* :ghissue:`27941`: [Bug]: ShrinkA and ShrinkB are ignored in ax.annotate(arrowprops=...)
-* :ghissue:`26477`: [ENH]: Add interpolation_stage selector for images in qt figureoptions
-* :ghissue:`363`: Enable hatches for Cairo backend
-* :ghissue:`27852`: [Bug]: matplotlib.pyplot.matshow "(first dimension of the array) are displayed horizontally" but are displayed vertically
-* :ghissue:`27400`: [Bug]: tk backend confused by presence of file named "move" in current working directory
-* :ghissue:`25882`: [Bug]: plt.hist takes significantly more time with torch and jax arrays
-* :ghissue:`25204`: [Bug]: Pyparsing warnings emitted in mathtext
-* :ghissue:`17707`: getpwuid(): uid not found: 99
-* :ghissue:`27896`: [Doc]: Empty "User guide tutorials page" in docs
-* :ghissue:`27824`: [Bug]: polygon from axvspan not correct in polar plot after set_xy
-* :ghissue:`27378`: [ENH]: Suggest 'CN' if color is an integer
-* :ghissue:`27843`: [Bug]: close_group is not called when using patheffects
-* :ghissue:`27839`: [Bug]: PathCollection using alpha ignores 'none' facecolors
-* :ghissue:`25119`: [ENH]: secondary_x/yaxis accept transform argument
-* :ghissue:`27876`: [Doc]: Fix version switcher in devdocs
-* :ghissue:`27301`: [Bug]: ``imshow`` allows RGB(A) images with ``np.nan`` values to pass
-* :ghissue:`23839`: [MNT]: Add tests to codify ``ax.clear``
-* :ghissue:`27652`: [Doc]: Low contrast on clicked links in dark mode
-* :ghissue:`27865`: [Bug]: Zoom und pan not working after writing pdf pages.
-* :ghissue:`25871`: [Bug]: Colorbar cannot be added to another figure
-* :ghissue:`8072`: plot_date() ignores timezone in matplotlib version 2.0.0
-* :ghissue:`27812`: [ENH]: Add split feature for violin plots
-* :ghissue:`27659`: [MNT]: Improve return type of ``ioff`` and ``ion`` to improve Pyright analysis of bound variables
-* :ghissue:`27805`: [Bug]: Saving a figure with indicate_inset_zoom to pdf and then pickling it causes TypeError
-* :ghissue:`27701`: [Bug]: axis set_xscale('log') interferes with set_xticks
-* :ghissue:`19807`: radius modification in contains_point function when linewidth is specified
-* :ghissue:`27762`: [Bug]: Inconsistent treatment of list of labels in ``plot`` when the input is a dataframe
-* :ghissue:`27745`: [MNT]: ``_ImageBase.draw`` and ``Axis.draw`` args and kwargs
-* :ghissue:`27782`: [Doc]: Link to citation page in read me broken
-* :ghissue:`8789`: legend handle size does not automatically scale with linewidth
-* :ghissue:`27746`: [Doc]: Citation link in the readme.md points to 404
-* :ghissue:`20853`: Add deprecation for colormaps
-* :ghissue:`26865`: [MNT]: Remove 3.7-deprecated API
-* :ghissue:`24168`: [Bug]: ``subprocess-exited-with-error`` when trying to build on M1 mac
-* :ghissue:`27727`: [Doc]: Text in the colormap normalization gallery doesn't match the code
-* :ghissue:`27635`: [Bug]: test_figure_leak_20490 repeatedly failing on CI
-* :ghissue:`14217`: [Feature request] Add a way to update the position of the Arrow patch.
-* :ghissue:`20512`: Bad boxplot legend entries
-* :ghissue:`22011`: [Bug]: subfigures messes up with fig.legend zorder
-* :ghissue:`27414`: [Bug]: Legend overlaps shaded area in fill_between with legend location "best"
-* :ghissue:`23323`: Legend with "loc=best" does not try to avoid text
-* :ghissue:`27648`: [Doc]: ``Axes.inset_axes`` is still experimental
-* :ghissue:`27277`: [Doc]: Two license pages in docs
-* :ghissue:`24648`: [Doc]: make html fail early if latex not present
-* :ghissue:`27554`: [Bug]: Large image draw performance deterioration in recent releases
-* :ghissue:`25239`: [Bug]: colors.PowerNorm results in incorrect colorbar
-* :ghissue:`13533`: Boxplotting Masked Arrays
-* :ghissue:`25967`: [Doc]: dollar_ticks example refers to unused formatter classes
-* :ghissue:`24859`: [Doc]: Document color in a consistent way, including link
-* :ghissue:`27159`: [Bug]: Meson build fails due to qhull link issue.
-* :ghissue:`25691`: [Bug]: Secondary axis does not support Transform as functions
-* :ghissue:`25860`: [Bug]: canvas pick events not working when Axes belongs to a subfigure
-* :ghissue:`27361`: [Bug]: (Tight) layout engine breaks for 3D patches
-* :ghissue:`27145`: [ENH]: Make "No artists with labels found to put in legend" a warning
-* :ghissue:`27399`: [Bug]: None in y or yerr arrays leads to TypeError when using errorbar
-* :ghissue:`13887`: Accessing default ``norm`` of a Collection removes its colors.
-* :ghissue:`26593`: [ENH]: Support SubFigure.remove()
-* :ghissue:`27329`: [Bug]: Removing a colorbar for an axes positioned in a subgridspec restores the axes' position to the wrong place.
-* :ghissue:`27214`: [Bug]: ``NavigationToolbar2QT`` should use ``@Slot`` annotation
-* :ghissue:`27146`: [ENH]: Multi hatching in ``ax.stackplot()``
-* :ghissue:`27168`: [Doc]: Instructions for editable installation on Windows potentially missing a step
-* :ghissue:`27174`: [MNT]: Build nightly wheels with NumPy nightly wheels
-* :ghissue:`25043`: [ENH]: Plotting masked arrays correctly in 3D line plot
-* :ghissue:`26990`: [Doc]: Histogram path example renders poorly in HTML
-* :ghissue:`25738`: [MNT]: Improve readability of _mathtext_data.stix_virtual_fonts table
-* :ghissue:`11129`: Highlight past winners for JDH plotting contest in docs
-* :ghissue:`24050`: No error message in matplotlib.axes.Axes.legend() if there are more labels than handles
-* :ghissue:`10922`: ENH: clear() method for widgets.RadioButtons
-* :ghissue:`18295`: How to modify ticklabels in axisartist?
-* :ghissue:`24996`: [Bug]: for non-rectilinear axes, axvline/axhline should behave as "draw a gridline at that x/y"
-* :ghissue:`26841`: [Bug]: Global legend weird behaviors
-* :ghissue:`25974`: [MNT]: Cleanup ticklabel_format(..., style=)
-* :ghissue:`26786`: Please upload new dev wheel so we pick up 3.9.dev after 3.8 release
-* :ghissue:`18052`: the limits of axes are inexact with mplot3d
-* :ghissue:`25596`: [MNT]: Consistency on Interface
-* :ghissue:`26557`: [ENH]: Nightly Python 3.12 builds
-* :ghissue:`26281`: [ENH]: Add get_xmargin, get_ymargin, get_zmargin axes methods
+* :ghissue:`22482`: [ENH]:  pickle (or save) matplotlib figure with insteractive slider
+* :ghissue:`25847`: [Bug]: Graph gets cut off with scaled resolution using gtk4cairo backend
+* :ghissue:`28341`: [Bug]: Incorrect X-axis scaling with date values
+* :ghissue:`28383`: [Bug]: axvspan no longer participating in limit calculations
+* :ghissue:`28223`: [Bug]: Inconsistent Visualization of Intervals in ax.barh for Different Duration Widths
+* :ghissue:`28432`: [Bug]: Backend name specified as module gets lowercased since 3.9
+* :ghissue:`28467`: [Bug]: Incorrect type stub for ``ErrorbarContainer``'s ``lines`` attribute.
+* :ghissue:`28384`: [Bug]: subfigure artists not drawn interactively
+* :ghissue:`28234`: [Bug]: mpltype custom role breaks sphinx build for third-party projects that have intersphinx links to matplotlib
+* :ghissue:`28464`: [Bug]: figure with subfigures cannot be pickled
+* :ghissue:`28448`: [Bug]: Making an RGB image from pickled data throws error
+* :ghissue:`23317`: [Bug]: ``add_collection3d`` does not update view limits
+* :ghissue:`17130`: autoscale_view is not working with Line3DCollection
+* :ghissue:`28434`: [Bug]: Setting exactly 2 colors with tuple in ``plot`` method gives confusing error
+* :ghissue:`28417`: [Doc]: axhspan and axvspan now return Rectangles, not Polygons.
+* :ghissue:`28378`: [ENH]: Switch text wrapping boundary to subfigure
+* :ghissue:`28404`: [Doc]: matplotlib.widgets.CheckButtons no longer has .rectangles attribute, needs removed.
+* :ghissue:`28367`: [Bug]: Backend entry points can be erroneously duplicated
+* :ghissue:`28358`: [Bug]: Labels don't get wrapped when set_yticks() is used in subplots
+* :ghissue:`28374`: [Bug]: rcParam ``tk.window_focus: True`` is causes crash on Linux in version 3.9.0.
+* :ghissue:`28324`: [Bug]: show(block=False) freezes
+* :ghissue:`28239`: [Doc]: Gallery example showing 3D slice planes
+* :ghissue:`27603`: [Bug]: _raw_ticker() istep
+* :ghissue:`24328`: [Bug]: class Axes3D.set_box_aspect() sets wrong aspect ratios when Axes3D.view_init( vertical_axis='y') is enabled.
+* :ghissue:`28221`: [Doc]: drawedges attribute described twice in matplotlib.colorbar documentation
+* :ghissue:`28296`: [Doc]: Missing comma
+* :ghissue:`28256`: [Bug]: axes3d.py's _on_move() converts the roll angle to radians, but then passes it to view_init() as if it were still in degrees
+* :ghissue:`28267`: [Bug]: for Python 3.11.9 gor error  ValueError: PyCapsule_New called with null pointer
+* :ghissue:`28022`: [Bug]: Type of Axes is unknown pyright
+* :ghissue:`28002`: Segfault from path editor example with QtAgg
 
 
 Previous GitHub statistics
diff --git a/doc/users/prev_whats_new/github_stats_3.9.0.rst b/doc/users/prev_whats_new/github_stats_3.9.0.rst
new file mode 100644
index 000000000000..b1d229ffbfa1
--- /dev/null
+++ b/doc/users/prev_whats_new/github_stats_3.9.0.rst
@@ -0,0 +1,744 @@
+.. _github-stats-3-9.0:
+
+GitHub statistics for 3.9.0 (May 15, 2024)
+==========================================
+
+GitHub statistics for 2023/09/15 (tag: v3.8.0) - 2024/05/15
+
+These lists are automatically generated, and may be incomplete or contain duplicates.
+
+We closed 97 issues and merged 450 pull requests.
+The full list can be seen `on GitHub <https://github.com/matplotlib/matplotlib/milestone/78?closed=1>`__
+
+The following 175 authors contributed 2584 commits.
+
+* 0taj
+* Abdul Razak Taha
+* Adam J. Stewart
+* Adam Turner
+* Aditi Gautam
+* agautam478
+* Alan Lau
+* Albert Y. Shih
+* Alec Vercruysse
+* Alexander Volkov
+* Alice Descoeudres
+* Allan Haldane
+* Amirreza Aflakparast
+* Ananya Devarakonda
+* ananya314
+* Anja Beck
+* Anjini2004
+* Ant Lockyer
+* Antony Lee
+* Anvi Verma
+* Artyom Romanov
+* Augusto Borges
+* avramid9
+* Ben Root
+* bersbersbers
+* Binaya Sharma
+* Cameron
+* Chaoyi Hu
+* chaoyihu
+* Chiraag Balu
+* Christoph Hasse
+* ConstableCatnip
+* CozyFrog
+* Cyril Gadal
+* Dale Dai
+* Daniel Bergman
+* Daniel Hitchcock
+* danielcobej
+* David Gilbertson
+* David Stansby
+* ddale1128@gmail.com
+* dependabot[bot]
+* Devilsaint
+* dohyun
+* Drew Kinneer
+* DWesl
+* Elisa Heckelmann
+* ElisaHeck
+* Elliott Sales de Andrade
+* Eric Firing
+* Eric Prestat
+* esibinga
+* Eva Sibinga
+* Evgenii Radchenko
+* Faisal Fawad
+* Felipe Cybis Pereira
+* Garrett Sward
+* Gaurav-Kumar-Soni
+* Gauri Chaudhari
+* Gautam Sagar
+* Greg Lucas
+* Gurudatta Shanbhag
+* hannah
+* Haoying Zhang
+* Hugues Hoppe
+* i-jey
+* iamfaham
+* Ian Hunt-Isaak
+* Ian Thomas
+* ifEricReturnTrue
+* Illviljan
+* Issam
+* Issam Arabi
+* Jacob Stevens-Haas
+* Jacob Tomlinson
+* Jake
+* Jake Stevens-Haas
+* James Salsman
+* Jaroza727
+* Jeremy Farrell
+* Jirka
+* Jody Klymak
+* Jorge Moraleda
+* Joshua Stevenson
+* jovianw
+* João Andrade
+* jpgianfaldoni
+* jsdodge
+* jsjeelshah
+* judfs
+* Juhan Oskar Hennoste
+* Junpei Ota
+* Katherine Turk
+* katotaisei
+* KheshavKumar
+* Koustav Ghosh
+* Kritika Verma
+* Kyle Sunden
+* Linyi Li
+* linyilily
+* lkkmpn
+* Lucia Korpas
+* madisonwong210
+* Maggie Liu
+* Marc Bresson
+* Matthew Feickert
+* Matthew Morrison
+* Matthias Bussonnier
+* Melissa Weber Mendonça
+* melissawm
+* mliu08
+* Mostafa Noah
+* MostafaNouh0011
+* n-aswin
+* Nabil
+* nbarlowATI
+* Nidaa Rabah
+* Nivedita Chaudhari
+* Oscar Gustafsson
+* patel-zeel
+* Pavel Liavonau
+* Pedro
+* Pedro Peçanha
+* Peter Talley
+* Pradeep Reddy Raamana
+* Prajwal Agrawal
+* Pranav Raghu
+* prateetishah
+* pre-commit-ci[bot]
+* QuadroTec
+* Rafael Tsuha
+* Raghuram Sirigiri
+* Raphael
+* Raphael Quast
+* Ratnabali Dutta
+* rawwash
+* rsp2210
+* Ruoyi
+* Ruoyi Xie
+* Rushikesh Pandya
+* Ruth Comer
+* samGreer
+* Samuel Diebolt
+* saranti
+* Scott Shambaugh
+* Sebastian Berg
+* Seohyeon Lee
+* Sheepfan0828
+* ShivamPathak99
+* Shriya Kalakata
+* shriyakalakata
+* Stefan
+* Steffen Rehberg
+* stevezhang1999
+* Sudhanshu Pandey
+* Talha Irfan
+* thehappycheese
+* Thomas A Caswell
+* Tiago Lubiana
+* Tim Hoffmann
+* tobias
+* Tom Sarantis
+* trananso
+* turnipseason
+* tusharkulkarni008
+* UFEddy
+* Vashesh08
+* vicky6
+* vigneshvetrivel8
+* wemi3
+* yangyangdotcom
+* YiLun Fan
+* Zach Champion
+* zachjweiner
+* zoehcycy
+
+GitHub issues and pull requests:
+
+Pull Requests (450):
+
+* :ghpull:`28206`: Backport PR #28205 on branch v3.9.x (TST: Fix tests with older versions of ipython)
+* :ghpull:`28207`: TST: Followup corrections to #28205
+* :ghpull:`28205`: TST: Fix tests with older versions of ipython
+* :ghpull:`28203`: Backport PR #28164 on branch v3.9.x (CI: Ensure code coverage is always uploaded)
+* :ghpull:`28204`: Backport PR #28195 on branch v3.9.x (TST: Prepare for pytest 9)
+* :ghpull:`28191`: DOC: Use released mpl-sphinx-theme on v3.9.x
+* :ghpull:`28195`: TST: Prepare for pytest 9
+* :ghpull:`28193`: Backport PR #28185 on branch v3.9.x (DOC: Bump mpl-sphinx-theme to 3.9)
+* :ghpull:`28190`: Backport PR #28103 on branch v3.9.x ([DOC]: Fix compatibility with sphinx-gallery 0.16)
+* :ghpull:`28164`: CI: Ensure code coverage is always uploaded
+* :ghpull:`28194`: Backport PR #28188 on branch v3.9.x ([TST] Bump some tolerances for Macos ARM)
+* :ghpull:`28188`: [TST] Bump some tolerances for Macos ARM
+* :ghpull:`28185`: DOC: Bump mpl-sphinx-theme to 3.9
+* :ghpull:`28189`: Backport PR #28181 on branch v3.9.x (DOC: Prepare release notes for 3.9)
+* :ghpull:`28103`: [DOC]: Fix compatibility with sphinx-gallery 0.16
+* :ghpull:`28181`: DOC: Prepare release notes for 3.9
+* :ghpull:`28184`: Backport PR #28182 on branch v3.9.x (Bump custom hatch deprecation expiration)
+* :ghpull:`28182`: Bump custom hatch deprecation expiration
+* :ghpull:`28178`: Backport PR #28171 on branch v3.9.x (Support removing absent tools from ToolContainerBase.)
+* :ghpull:`28171`: Support removing absent tools from ToolContainerBase.
+* :ghpull:`28174`: Backport PR #28169 on branch v3.9.x (Clarify public-ness of some ToolContainerBase APIs.)
+* :ghpull:`28169`: Clarify public-ness of some ToolContainerBase APIs.
+* :ghpull:`28160`: Backport PR #28039 on branch v3.9.x (Respect vertical_axis when rotating plot interactively)
+* :ghpull:`28159`: Backport PR #28157 on branch v3.9.x (Remove call to non-existent method _default_contains in Artist)
+* :ghpull:`28162`: Backport PR #27948 on branch v3.9.x (Move IPython backend mapping to Matplotlib and support entry points)
+* :ghpull:`28163`: Backport PR #28144 on branch v3.9.x (DOC: Refactor code in the fishbone diagram example)
+* :ghpull:`28144`: DOC: Refactor code in the fishbone diagram example
+* :ghpull:`27948`: Move IPython backend mapping to Matplotlib and support entry points
+* :ghpull:`28039`: Respect vertical_axis when rotating plot interactively
+* :ghpull:`28157`: Remove call to non-existent method _default_contains in Artist
+* :ghpull:`28141`: Backport PR #27960 on branch v3.9.x (Update AppVeyor config)
+* :ghpull:`28138`: Backport PR #28068 on branch v3.9.x ([TYP] Add possible type hint to ``colors`` argument in ``LinearSegmentedColormap.from_list``)
+* :ghpull:`28140`: Backport PR #28136 on branch v3.9.x (Appease pycodestyle.)
+* :ghpull:`27960`: Update AppVeyor config
+* :ghpull:`28068`: [TYP] Add possible type hint to ``colors`` argument in ``LinearSegmentedColormap.from_list``
+* :ghpull:`28136`: Appease pycodestyle.
+* :ghpull:`28135`: Backport PR #28134 on branch v3.9.x (DOC: Minor improvements on quickstart)
+* :ghpull:`28134`: DOC: Minor improvements on quickstart
+* :ghpull:`28121`: Backport PR #28085 on branch v3.9.x (Clarify that the pgf backend is never actually used interactively.)
+* :ghpull:`28120`: Backport PR #28102 on branch v3.9.x (Fix typo in color mapping documentation in quick_start.py)
+* :ghpull:`28109`: Backport PR #28100 on branch v3.9.x (TST: wxcairo sometimes raises OSError on missing cairo libraries)
+* :ghpull:`28100`: TST: wxcairo sometimes raises OSError on missing cairo libraries
+* :ghpull:`28108`: Backport PR #28107 on branch v3.9.x ([DOC] Fix description in CapStyle example)
+* :ghpull:`28107`: [DOC] Fix description in CapStyle example
+* :ghpull:`28102`: Fix typo in color mapping documentation in quick_start.py
+* :ghpull:`28095`: Backport PR #28094 on branch v3.9.x (DOC: exclude sphinx 7.3.*)
+* :ghpull:`28081`: Backport PR #28078 on branch v3.9.x (Clarify that findfont & _find_fonts_by_props return paths.)
+* :ghpull:`28080`: Backport PR #28077 on branch v3.9.x (Parent tk StringVar to the canvas widget, not to the toolbar.)
+* :ghpull:`28092`: Backport PR #28032 on branch v3.9.x (FIX: ensure images are C order before passing to pillow)
+* :ghpull:`28032`: FIX: ensure images are C order before passing to pillow
+* :ghpull:`28088`: Backport PR #28087 on branch v3.9.x (Document Qt5 minimal version.)
+* :ghpull:`28085`: Clarify that the pgf backend is never actually used interactively.
+* :ghpull:`28078`: Clarify that findfont & _find_fonts_by_props return paths.
+* :ghpull:`28077`: Parent tk StringVar to the canvas widget, not to the toolbar.
+* :ghpull:`28062`: Backport PR #28056 on branch v3.9.x (Strip trailing spaces from log-formatter cursor output.)
+* :ghpull:`28063`: Backport PR #28055 on branch v3.9.x (DOC: Improve inverted axis example)
+* :ghpull:`28056`: Strip trailing spaces from log-formatter cursor output.
+* :ghpull:`28049`: Backport PR #28036 on branch v3.9.x (BLD: Fetch version from setuptools_scm at build time)
+* :ghpull:`28036`: BLD: Fetch version from setuptools_scm at build time
+* :ghpull:`28038`: Backport PR #28023 on branch v3.9.x (ci: Update merge conflict labeler)
+* :ghpull:`28023`: ci: Update merge conflict labeler
+* :ghpull:`28035`: Backport PR #28026 on branch v3.9.x ([DOC] reshuffle of contributing)
+* :ghpull:`28026`: [DOC] reshuffle of contributing
+* :ghpull:`28024`: DOC: Rewrite "Work on an issue" section
+* :ghpull:`28011`: DOC: Move bug reports and feature requests to top of contributing index
+* :ghpull:`27747`: Move doc/users/installing/ to doc/install/
+* :ghpull:`27952`: ENH: Align titles
+* :ghpull:`28017`: Merge up v3.8.4
+* :ghpull:`28014`: Improve timeline example.
+* :ghpull:`28019`: DOC: correct path to mpl_toolkits reference images
+* :ghpull:`26981`: Fixes Issue #26377 - Auto-escape % Symbol in Latex in pie labels
+* :ghpull:`28007`: wx: Fix file extension for toolmanager-style toolbar
+* :ghpull:`25556`: Display cursor coordinates for all axes twinned with the current one.
+* :ghpull:`23597`: Always use PyQT/PySide6 for GitHub CI
+* :ghpull:`28013`: Avoid plt.xticks/plt.yticks in gallery examples.
+* :ghpull:`28006`: Fix deprecation warnings in ft2font extension
+* :ghpull:`27723`: ci: Enable testing on M1 macOS
+* :ghpull:`26375`: Add ``widths``, ``heights`` and ``angles`` setter to ``EllipseCollection``
+* :ghpull:`27999`: Remove documentation that some backends don't support hatching.
+* :ghpull:`26710`: Add support for High DPI displays to wxAgg backend
+* :ghpull:`27148`: Correctly treat pan/zoom events of overlapping axes.
+* :ghpull:`27981`: DOC: Fix label type specification in parameter descriptions
+* :ghpull:`27979`: Clarify error message for bad-dimensionality in pcolorfast().
+* :ghpull:`27962`: DOC: Document axes_grid1.Grid attributes
+* :ghpull:`27968`: MNT: Remove remaining 3.7 deprecations
+* :ghpull:`27965`: DOC: Rewrite the example illustrating bxp()
+* :ghpull:`26453`: add documentation for reloading font cache
+* :ghpull:`26131`: Tst/restore old tests
+* :ghpull:`27730`: Add an rcparam for image.interpolation_stage.
+* :ghpull:`27956`: Use PyOS_setsig in macos backend
+* :ghpull:`27829`: Simplify color/marker disambiguation logic in _process_plot_format.
+* :ghpull:`27840`: Add legend support for boxplots
+* :ghpull:`27943`: Support Cn, n>9 in plot() shorthand format.
+* :ghpull:`27950`: ci: Fix condition for publishing wheels
+* :ghpull:`27909`: Add a note to pyplot docstrings referencing the corresponding object methods
+* :ghpull:`27929`: DOC: Add summary lines to plot types
+* :ghpull:`27915`: [BUG] Fix redirect-from Sphinx extension
+* :ghpull:`27945`: DOC: Explain leading dot in object references
+* :ghpull:`27947`: Update docs for ``FancyArrowPatch`` & ``Annotation`` to make it clear that ShrinkA/B parameters are in points and not fractional.
+* :ghpull:`27944`: Bump the actions group with 2 updates
+* :ghpull:`27932`: Fix pickling of make_axes_area_auto_adjustable'd axes.
+* :ghpull:`26500`: closes #26477 ENH: Add interpolation_stage in qt figureoptions
+* :ghpull:`27927`: Update docs
+* :ghpull:`27916`: Revert renaming labels to tick_labels in boxplot_stats()
+* :ghpull:`27931`: Highlight development_setup code snippets as bash, not python.
+* :ghpull:`27856`: Support hatching in cairo backends.
+* :ghpull:`27922`: Fix cbook style
+* :ghpull:`27668`: MNT: prevent merging using labels + branch protection rules
+* :ghpull:`27857`: Documentation edit for matshow function
+* :ghpull:`27928`: DOC: Fix syntax for ToolBase.image docstring
+* :ghpull:`27873`: Simplify the LineCollection example
+* :ghpull:`27492`: Fix semantics of MEP22 image names.
+* :ghpull:`27918`: Fix new flake8 errors from old merge
+* :ghpull:`27874`: Modernize macosx backend a bit
+* :ghpull:`25887`: Update ``_unpack_to_numpy`` function to convert JAX and PyTorch arrays to NumPy
+* :ghpull:`27685`: Work around pyparsing diagnostic warnings
+* :ghpull:`26594`: Added optional props argument to Lasso Widget __init__ to customize Lasso line
+* :ghpull:`22761`: Add minor ticks on and off in Axis
+* :ghpull:`22407`: Add ``set_XY`` and ``set_data`` to ``Quiver``
+* :ghpull:`27901`: Rename boxplot's tick label parameter
+* :ghpull:`27883`: Fix build on older macOS deployment targets
+* :ghpull:`27900`: Remove empty user guide tutorials page
+* :ghpull:`27885`: Clean up headers in extensions
+* :ghpull:`27910`: DOC: Fix dead link in README
+* :ghpull:`26567`: Use SVG inheritance diagrams now that linking has been fixed
+* :ghpull:`27899`: Merge up 3.8.x into main
+* :ghpull:`27905`: Improved error message for malformed colors
+* :ghpull:`27906`: Override open_group, close_group methods in PathEffectRenderer
+* :ghpull:`27904`: FIX: Restore D213 in flake8
+* :ghpull:`27895`: Remove versions from sidebar in docs
+* :ghpull:`27894`: Mark triangulation classes as final
+* :ghpull:`27557`: Use :mpltype:``color`` for color types
+* :ghpull:`27845`: Make sure custom alpha param does not change 'none' colors in a list of colors
+* :ghpull:`27719`: Add BackendRegistry singleton class
+* :ghpull:`27890`: DOC: State approximate documentation build time
+* :ghpull:`27887`: BLD: Add a fallback URL for FreeType
+* :ghpull:`25224`: Allow passing a transformation to secondary_xaxis/_yaxis
+* :ghpull:`27886`: Fix devdocs version switcher
+* :ghpull:`27884`: FIX: don't copy twice on RGB input
+* :ghpull:`27087`: Convert path extension to pybind11
+* :ghpull:`27867`: DOC: Update some animation related topics
+* :ghpull:`27848`: FIX: handle nans in RGBA input with ScalarMappables
+* :ghpull:`27821`: BLD,Cygwin: Include Python.h first in various C++ files
+* :ghpull:`27457`: TST: adding tests of current clear behavior on ticks
+* :ghpull:`27872`: doc: add description of ``**kwargs`` usage to collections
+* :ghpull:`27868`: Use pybind11 string formatter for exception messages
+* :ghpull:`27862`: Add dtype/copy args to internal testing class
+* :ghpull:`27658`: Bump pydata-sphinx-theme
+* :ghpull:`27303`: FIX: also exclude np.nan in RGB(A) in color mapping
+* :ghpull:`27860`: Bump the actions group with 2 updates
+* :ghpull:`27869`: Correctly set temporary pdf/pgf backends
+* :ghpull:`27850`: Deprecate ``plot_date``
+* :ghpull:`27815`: Add side option to violinplot
+* :ghpull:`27836`: DOC: use ... for continuation prompt in docstrings
+* :ghpull:`27819`: MNT: remove draw method args and kwargs
+* :ghpull:`27813`: DOC: Update violinplot() docs
+* :ghpull:`27698`: Add linting and validation of all YAML files
+* :ghpull:`27811`: Fix Annulus width check
+* :ghpull:`27667`: Change return type of ``ion`` and ``ioff`` to fix unbound variable errors with Pyright
+* :ghpull:`27807`: Expand CI pytest reporting config to ignore xfails
+* :ghpull:`27806`: Remove self._renderer from AnnotationBbox and ConnectionPatch
+* :ghpull:`27799`: Clarify that set_ticks() affects major/minor ticks independently
+* :ghpull:`27787`: Improve documentation on boxplot and violinplot
+* :ghpull:`27800`: Deactivate sidebar for release notes
+* :ghpull:`27798`: Fix sphinx-gallery CSS
+* :ghpull:`27462`: DOC: clarify the default value of *radius* in Patch.contains_point
+* :ghpull:`27565`: MNT: arghandling subplotspec
+* :ghpull:`27796`: Make mypy a bit stricter
+* :ghpull:`27767`: Update handling of sequence labels for plot
+* :ghpull:`27795`: Add EffVer badge
+* :ghpull:`27780`: Partly revert #27711
+* :ghpull:`27768`: MNT: deprecate draw method args and kwargs
+* :ghpull:`27783`: Update README.md to fix citation link
+* :ghpull:`27726`: TST: always set a (long) timeout for subprocess and always use our wrapper
+* :ghpull:`27781`: Simplify example: Box plots with custom fill colors
+* :ghpull:`27750`: Bump the actions group with 2 updates
+* :ghpull:`27771`: Add marker-only and line+marker visuals to the plot() plot types
+* :ghpull:`27764`: Increase size of legend in Legend guide example
+* :ghpull:`26800`: Bump minimum NumPy version to 1.23
+* :ghpull:`27752`: Update some Meson internals
+* :ghpull:`27702`: GOV: adopt EffVer
+* :ghpull:`26965`: Removal of deprecated API cm
+* :ghpull:`27758`: [Doc] Remove special casing for removed method
+* :ghpull:`25815`: [TST] Make jpl units instantiated with datetimes consistent with mpl converters
+* :ghpull:`27729`: DOC: Improve colormap normalization example
+* :ghpull:`27732`: TST: Remove memory leak test
+* :ghpull:`27733`: ci: Simplify CodeQL setup
+* :ghpull:`27692`: Add method to update position of arrow patch
+* :ghpull:`27736`: Fix incorrect API reference in docs
+* :ghpull:`27731`: DOC: Create explicit rename legend entry section in guide
+* :ghpull:`27560`: Moved /users/project to /doc/project
+* :ghpull:`27728`: Simplify Figure._suplabels.
+* :ghpull:`27715`: Bump the actions group with 3 updates
+* :ghpull:`27711`: Fix boxplot legend entries part 2
+* :ghpull:`27696`: DOC: clean up automated tests section of workflow docs
+* :ghpull:`27686`: Improve Locator docstrings
+* :ghpull:`27704`: ci: Remove prerelease conditions from Azure Pipelines
+* :ghpull:`27568`: Fix boxplot legend entries
+* :ghpull:`27694`: MNT: fix labeller
+* :ghpull:`26953`: MNT: test that table doesn't try to convert unitized data
+* :ghpull:`27690`: Remove "Past versions" section from release notes
+* :ghpull:`26926`: Closes #22011: Changes to SubFigures so it behaves like a regular artist
+* :ghpull:`27469`: Fixed legend with legend location "best" when legend overlaps shaded area and text
+* :ghpull:`27684`: Bump the actions group with 1 update
+* :ghpull:`27665`: Axes.inset_axes - warning message removed
+* :ghpull:`27688`: CI: skip code coverage upload on scheduled tests
+* :ghpull:`27689`: ci: Don't include API/what's new notes in general doc labels
+* :ghpull:`27640`: Add ``get_cursor_data`` to ``NonUniformImage``
+* :ghpull:`27676`: BLD: Downgrade FreeType to 2.6.1 on Windows ARM
+* :ghpull:`27619`: Use GH action to install reviewdog
+* :ghpull:`27552`: TST: Use importlib for importing in pytest
+* :ghpull:`27650`: DOC: Added call out to API guidelines to contribute + small API guidelines reorg
+* :ghpull:`27618`: Add option of running stubtest using tox
+* :ghpull:`27656`: Bump the actions group with 1 update
+* :ghpull:`27415`: Use class form of data classes
+* :ghpull:`27649`: Check for latex binary before building docs
+* :ghpull:`27641`: MNT: fix api changes link in PR template
+* :ghpull:`27644`: ci: Fix mpl_toolkits label
+* :ghpull:`27230`: Query macOS for available system fonts.
+* :ghpull:`27643`: ci: Update nightly upload for artifacts v4
+* :ghpull:`27642`: Fix auto-labeler configuration
+* :ghpull:`27639`: Doc: typo fix for #22699
+* :ghpull:`26978`: [pre-commit.ci] pre-commit autoupdate
+* :ghpull:`27563`: Enable PyPI publishing from GitHub Actions
+* :ghpull:`22699`: Proof of concept for adding kwdoc content to properties using a decorator
+* :ghpull:`27633`: Auto-label PRs based on changed files
+* :ghpull:`27607`: Error on bad input to hexbin extents
+* :ghpull:`27629`: Don't run CI twice on dependabot branches
+* :ghpull:`27562`: Avoid an extra copy/resample if imshow input has no alpha
+* :ghpull:`27628`: Bump the actions group with 2 updates
+* :ghpull:`27626`: CI: Group dependabot updates
+* :ghpull:`27589`: Don't clip PowerNorm inputs < vmin
+* :ghpull:`27613`: Fix marker validator with cycler (allow mix of classes)
+* :ghpull:`27615`: MNT: add spaces to PR template
+* :ghpull:`27614`: DOC: Updated link in annotation API docs to point to annotation user guide
+* :ghpull:`27605`: Ignore masked values in boxplot
+* :ghpull:`26884`: Remove deprecated code from _fontconfig_patterns
+* :ghpull:`27602`: Let FormatStrFormatter respect axes.unicode_minus.
+* :ghpull:`27601`: Clarify dollar_ticks example and FormatStrFormatter docs.
+* :ghpull:`24834`: Deprecate apply_theta_transforms=True to PolarTransform
+* :ghpull:`27591`: Use macOS instead of OSX in comments/docs
+* :ghpull:`27577`: MNT: add the running version to pickle warning message
+* :ghpull:`25191`: Deprecate 'prune' kwarg to MaxNLocator
+* :ghpull:`27566`: DOC: changed tag ``plot type`` to ``plot-type``
+* :ghpull:`27105`: Use Axes instead of axes core library code
+* :ghpull:`27575`: Add quotes round .[dev] in editable install command
+* :ghpull:`27104`: Use Axes instead of axes in galleries
+* :ghpull:`27373`: Transpose grid_finder tick representation.
+* :ghpull:`27363`: ci: Improve coverage for compiled code
+* :ghpull:`27200`: DOC: Add role for custom informal types like color
+* :ghpull:`27548`: DOC: typo fix in contribute doc
+* :ghpull:`27458`: Check if the mappable is in a different Figure than the one fig.color…
+* :ghpull:`27546`: MNT: Clean up some style exceptions
+* :ghpull:`27514`: Improve check for bbox
+* :ghpull:`27265`: DOC: reorganizing contributing docs to clean up toc, better separate topics
+* :ghpull:`27517`: Best-legend-location microoptimization
+* :ghpull:`27540`: Bump github/codeql-action from 2 to 3
+* :ghpull:`27520`: [Doc] Minor consistency changes and correction of Marker docs
+* :ghpull:`27505`: Download Qhull source from Github, not Qhull servers, in meson build
+* :ghpull:`27518`: Micro-optimizations related to list handling
+* :ghpull:`27495`: Bump actions/stale from 8 to 9
+* :ghpull:`27523`: Changes for stale GHA v9
+* :ghpull:`27519`: [Doc] Improve/correct docs for 3D
+* :ghpull:`27447`: TST: Compress some hist geometry tests
+* :ghpull:`27513`: Fix docs and add tests for transform and deprecate ``BboxTransformToMaxOnly``
+* :ghpull:`27511`: TST: Add tests for Affine2D
+* :ghpull:`27424`: Added Axes.stairs test in test_datetime.py
+* :ghpull:`27267`: Fix/restore secondary axis support for Transform-type functions
+* :ghpull:`27013`: Add test_contour under test_datetime.py
+* :ghpull:`27497`: Clarify that set_axisbelow doesn't move grids below images.
+* :ghpull:`27498`: Remove unnecessary del local variables at end of Gcf.destroy.
+* :ghpull:`27466`: Add test_eventplot to test_datetime.py
+* :ghpull:`25905`: Use annotate coordinate systems to simplify label_subplots.
+* :ghpull:`27471`: Doc: visualizing_tests and ``triage_tests`` tools
+* :ghpull:`27474`: Added smoke test for Axes.matshow to test_datetime.py
+* :ghpull:`27470`: Fix test visualization tool for non-PNG files
+* :ghpull:`27426`: DOC: normalizing histograms
+* :ghpull:`27452`: Cleanup unit_cube-methods
+* :ghpull:`27431`: Added test for Axes.bar_label
+* :ghpull:`26962`: Remove backend 3.7-deprecated API
+* :ghpull:`27410`: Add test_vlines to test_datetime.py
+* :ghpull:`27425`: Added test_fill_betweenx in test_datetime.py
+* :ghpull:`27449`: Remove test_quiverkey from test_datetime.py
+* :ghpull:`27427`: MNT/TST: remove xcorr and acorr from test_datetime
+* :ghpull:`27390`: Add test_bxp in test_datetime.py
+* :ghpull:`27428`: Added test for broken_barh to test_datetime.py
+* :ghpull:`27222`: [TST] Added test_annotate in test_datetime.py
+* :ghpull:`27135`: Added smoke test for Axes.stem
+* :ghpull:`27343`: Fix draggable annotations on subfigures.
+* :ghpull:`27033`: Add test_bar in test_datetime
+* :ghpull:`27423`: Add test for fill_between in test_datetime.py
+* :ghpull:`27409`: Fix setting ``_selection_completed`` in ``SpanSelector`` when spanselector is initialised using ``extents``
+* :ghpull:`27440`: Fix get_path for 3d artists
+* :ghpull:`27422`: TST: Cache available interactive backends
+* :ghpull:`27401`: Add test_fill in test_datetime.py
+* :ghpull:`27419`: DOC: Add AsinhScale to list of built-in scales
+* :ghpull:`27417`: Switch pytest fixture from tmpdir to tmp_path
+* :ghpull:`27172`: ENH: Change logging to warning when creating a legend with no labels
+* :ghpull:`27405`: Check that xerr/yerr values are not None in errorbar
+* :ghpull:`27392`: Remove test_spy from test_datetime.py
+* :ghpull:`27331`: Added smoke test for Axes.barbs in test_datetime.py
+* :ghpull:`27393`: MNT: Fix doc makefiles
+* :ghpull:`27387`: Revert "MNT: add _version.py to .gitignore"
+* :ghpull:`27347`: FIX: scale norm of collections when first array is set
+* :ghpull:`27374`: MNT: add _version.py to .gitignore
+* :ghpull:`19011`: Simplify tk tooltip setup.
+* :ghpull:`27367`: Fix _find_fonts_by_props docstring
+* :ghpull:`27359`: Fix build on PyPy
+* :ghpull:`27362`: Implement SubFigure.remove.
+* :ghpull:`27360`: Fix removal of colorbars on nested subgridspecs.
+* :ghpull:`27211`: Add test_hlines to test_datetimes.py
+* :ghpull:`27353`: Refactor AxisArtistHelpers
+* :ghpull:`27357`: [DOC]: Update 3d axis limits what's new
+* :ghpull:`26992`: Convert TkAgg utilities to pybind11
+* :ghpull:`27215`: Add ``@QtCore.Slot()`` decorations to ``NavigationToolbar2QT``
+* :ghpull:`26907`: Removal of deprecations for Contour
+* :ghpull:`27285`: Factor out common parts of qt and macos interrupt handling.
+* :ghpull:`27306`: Simplify GridSpec setup in make_axes_gridspec.
+* :ghpull:`27313`: FIX: allow re-shown Qt windows to be re-destroyed
+* :ghpull:`27184`: Use pybind11 for qhull wrapper
+* :ghpull:`26794`: Use pybind11 in _c_internal_utils module
+* :ghpull:`27300`: Remove idiosyncratic get_tick_iterator API.
+* :ghpull:`27275`: MAINT: fix .yml in tag issue template
+* :ghpull:`27288`: Use int.from_bytes instead of implementing the conversion ourselves.
+* :ghpull:`27286`: Various cleanups
+* :ghpull:`27279`: Tweak a few docstrings.
+* :ghpull:`27256`: merge up v3.8.1
+* :ghpull:`27254`: Remove redundant axes_grid colorbar examples.
+* :ghpull:`27251`: webagg: Don't resize canvas if WebSocket isn't connected
+* :ghpull:`27236`: Tagging Example - Tags for multiple figs demo
+* :ghpull:`27245`: MNT: be more careful in Qt backend that there is actually a Figure
+* :ghpull:`27158`: First attempt for individual hatching styles for stackplot
+* :ghpull:`26851`: Establish draft Tag glossary and Tagging guidelines
+* :ghpull:`27083`: DOC: Add tags infrastructure for gallery examples
+* :ghpull:`27204`: BLD: Use NumPy nightly wheels for non-release builds
+* :ghpull:`27208`: Add test_axvline to test_datetime.py
+* :ghpull:`26989`: MNT: print fontname in missing glyph warning
+* :ghpull:`27177`: Add test_axhline in test_datetime.py
+* :ghpull:`27164`: docs: adding explanation for color in ``set_facecolor``
+* :ghpull:`27175`: Deprecate mixing positional and keyword args for legend(handles, labels)
+* :ghpull:`27199`: DOC: clean up links under table formatting docs
+* :ghpull:`27185`: Added smoke tests for Axes.errorbar in test_datetime.py
+* :ghpull:`27091`: Add test_step to test_datetime.py
+* :ghpull:`27182`: Add example for plotting a bihistogram
+* :ghpull:`27130`: added test_axvspan in test.datetime.py
+* :ghpull:`27094`: MNT: move pytest.ini configs to .toml
+* :ghpull:`27139`: added test_axhspan in test_datetime.py
+* :ghpull:`27058`: DOC: concise dependency heading + small clarifications
+* :ghpull:`27053`: Added info for getting compilation output from meson on autorebuild
+* :ghpull:`26906`: Fix masking for Axes3D.plot()
+* :ghpull:`27142`: Added smoke test for Axes.text in test_datetime.py
+* :ghpull:`27024`: Add test_contourf in test_datetime.py
+* :ghpull:`22347`: correctly treat pan/zoom events of overlapping axes
+* :ghpull:`26900`: #26865 removing deprecations to axislines.py
+* :ghpull:`26696`: DOC: Fix colLoc default
+* :ghpull:`27064`: Close all plot windows of a blocking show() on Ctrl+C
+* :ghpull:`26882`: Add scatter test for datetime units
+* :ghpull:`27114`: add test_stackplot in test_datetime.py
+* :ghpull:`27084`: Add test_barh to test_datetime.py
+* :ghpull:`27110`: DOC: Move figure member sections one level down
+* :ghpull:`27127`: BLD: use python3 for shebang consistent with pep-394
+* :ghpull:`27111`: BLD: Fix setting FreeType build type in extension
+* :ghpull:`26921`: MNT: clarify path.sketch rcparam format + test validate_sketch
+* :ghpull:`27109`: TST: Use importlib for subprocess tests
+* :ghpull:`27119`: Update clabel comment.
+* :ghpull:`27117`: Remove datetime test for axes.pie
+* :ghpull:`27095`: Deprecate nth_coord parameter from FixedAxisArtistHelper.new_fixed_axis.
+* :ghpull:`27066`: Tweak array_view to be more like pybind11
+* :ghpull:`27090`: Restore figaspect() API documentation
+* :ghpull:`27074`: Issue #26990: Split the histogram image into two for each code block.
+* :ghpull:`27086`: Rename py namespace to mpl in extension code
+* :ghpull:`27082`: MAINT: Update environment.yml to match requirements files
+* :ghpull:`27072`: Remove datetime test stubs for spectral methods/table
+* :ghpull:`26830`: Update stix table with Unicode names
+* :ghpull:`26969`: DOC: add units to user/explain [ci doc]
+* :ghpull:`27028`: Added test_hist in test_datetime.py
+* :ghpull:`26876`: issue: 26871 - Remove SimplePath class from patches.py
+* :ghpull:`26875`: Fix Deprecation in patches.py
+* :ghpull:`26890`: Removing deprecated api from patches
+* :ghpull:`27037`: add test_plot_date in test_datetime.py
+* :ghpull:`27012`: Bump required C++ standard to c++17
+* :ghpull:`27021`: Add a section to Highlight past winners for JDH plotting contest in docs
+* :ghpull:`27004`: Warning if handles and labels have a len mismatch
+* :ghpull:`24061`: #24050 No error was thrown even number of handles mismatched labels
+* :ghpull:`26754`: DOC: separate and clarify axisartist default tables
+* :ghpull:`27020`: CI: Update scientific-python/upload-nightly-action to 0.2.0
+* :ghpull:`26951`: Clarify that explicit ticklabels are used without further formatting.
+* :ghpull:`26894`: Deprecate setting the timer interval while starting it.
+* :ghpull:`13401`: New clear() method for Radio and Check buttons
+* :ghpull:`23829`: Start transitioning to pyproject.toml
+* :ghpull:`26621`: Port build system to Meson
+* :ghpull:`26928`: [TYP] Add tool for running stubtest
+* :ghpull:`26917`: Deprecate ContourLabeler.add_label_clabeltext.
+* :ghpull:`26960`: Deprecate backend_ps.get_bbox_header, and split it for internal use.
+* :ghpull:`26967`: Minor cleanups.
+* :ghpull:`26909`: deprecated api tri
+* :ghpull:`26946`: Inline Cursor._update into its sole caller.
+* :ghpull:`26915`: DOC: Clarify description and add examples in colors.Normalize
+* :ghpull:`26874`: Cleaned up the span_where class method from Polycollections.
+* :ghpull:`26586`: Support standard formatters in axisartist.
+* :ghpull:`26788`: Fix axh{line,span} on polar axes.
+* :ghpull:`26935`: add tomli to rstcheck extras
+* :ghpull:`26275`: Use pybind11 in image module
+* :ghpull:`26887`: DOC: improve removal for julian dates [ci doc]
+* :ghpull:`26929`: DOC: Fix removal doc for Animation attributes
+* :ghpull:`26918`: 26865 Removed deprecations from quiver.py
+* :ghpull:`26902`: Fixed deprecated APIs in lines.py
+* :ghpull:`26903`: Simplify CheckButtons and RadioButtons click handler.
+* :ghpull:`26899`: MNT: only account for Artists once in fig.get_tightbbox
+* :ghpull:`26861`: QT/NavigationToolbar2: configure subplots dialog should be modal
+* :ghpull:`26885`: Removed deprecated code from gridspec.py
+* :ghpull:`26880`: Updated offsetbox.py
+* :ghpull:`26910`: Removed the deprecated code from offsetbox.py
+* :ghpull:`26905`: Add users/explain to default skip subdirs
+* :ghpull:`26853`: Widgets: Remove deprecations and make arguments keyword only
+* :ghpull:`26877`: Fixes deprecation in lines.py
+* :ghpull:`26871`: Removed the deprecated code from ``axis.py``
+* :ghpull:`26872`: Deprecated code removed in animation.py
+* :ghpull:`26859`: Add datetime testing skeleton
+* :ghpull:`26848`: ci: Don't install recommended packages on Circle
+* :ghpull:`26852`: Remove Julian date support
+* :ghpull:`26801`: [MNT]: Cleanup ticklabel_format (style=)
+* :ghpull:`26840`: Reduce redundant information in _process_plot_var_args.
+* :ghpull:`26731`: Explicitly set foreground color to black in svg icons
+* :ghpull:`26826`: [MNT] Move NUM_VERTICES from mplutils.h to the only file it is used in
+* :ghpull:`26742`: [TYP] Add typing for some private methods and modules
+* :ghpull:`26819`: Reorder safe_first_element() and _safe_first_finite() code
+* :ghpull:`26813`: Bump docker/setup-qemu-action from 2 to 3
+* :ghpull:`26797`: Remove deprecated draw_gouraud_triangle
+* :ghpull:`26815`: Remove plt.Axes from tests
+* :ghpull:`26818`: Fix doc build (alternative)
+* :ghpull:`26785`: merge up v3.8.0
+* :ghpull:`25272`: Do not add padding to 3D axis limits when limits are manually set
+* :ghpull:`26798`: Remove deprecated methods and attributed in Axes3D
+* :ghpull:`26744`: Use cbook methods for string checking
+* :ghpull:`26802`: specify input range in logs when image data must be clipped
+* :ghpull:`26787`: Remove unused Axis private init helpers.
+* :ghpull:`26629`: DOC: organize figure API
+* :ghpull:`26690`: Make generated pgf code more robust against later changes of tex engine.
+* :ghpull:`26577`: Bugfix: data sanitizing for barh
+* :ghpull:`26684`: Update PR template doc links
+* :ghpull:`26686`: PR template: shorten comment and pull up top
+* :ghpull:`26670`: Added sanitize_sequence to kwargs in _preprocess_data
+* :ghpull:`26634`: [MNT] Move SubplotParams from figure to gridspec
+* :ghpull:`26609`: Cleanup AutoMinorLocator implementation.
+* :ghpull:`26293`: Added get_xmargin(), get_ymargin() and get_zmargin() and tests.
+* :ghpull:`26516`: Replace reference to %pylab by %matplotlib.
+* :ghpull:`26483`: Improve legend(loc='best') warning and test
+* :ghpull:`26482`: [DOC]: print pydata sphinx/mpl theme versions
+* :ghpull:`23787`: Use pybind11 for C/C++ extensions
+
+Issues (97):
+
+* :ghissue:`28202`: [Bug]: Qt test_ipython fails on older ipython
+* :ghissue:`28145`: [TST] Upcoming dependency test failures
+* :ghissue:`28034`: [TST] Upcoming dependency test failures
+* :ghissue:`28168`: [TST] Upcoming dependency test failures
+* :ghissue:`28040`: [Bug]: vertical_axis not respected when rotating plots interactively
+* :ghissue:`28146`: [Bug]: Useless recursive group in SVG output when using path_effects
+* :ghissue:`28067`: [Bug]: ``LinearSegmentedColormap.from_list`` does not have all type hints for argument ``colors``
+* :ghissue:`26778`: [MNT]: Numpy 2.0 support strategy
+* :ghissue:`28020`: [Bug]: imsave fails on RGBA data when origin is set to lower
+* :ghissue:`7720`: WXAgg backend not rendering nicely on retina
+* :ghissue:`28069`: [Bug]: Can't save with custom toolbar
+* :ghissue:`28005`: [Doc]: Improve contribute instructions
+* :ghissue:`22376`: [ENH]: align_titles
+* :ghissue:`5506`: Confusing status bar values in presence of multiple axes
+* :ghissue:`4284`: Twin axis message coordinates
+* :ghissue:`18940`: WxAgg backend draws the wrong size when wxpython app is high DPI aware on Windows
+* :ghissue:`27792`: [ENH]: Legend entries for boxplot
+* :ghissue:`27828`: [Bug]: ".C10" does not work as plot shorthand format spec
+* :ghissue:`27911`: redirect not working for updated contribute page
+* :ghissue:`21876`: [Doc]: redirect-from directive appears broken?
+* :ghissue:`27941`: [Bug]: ShrinkA and ShrinkB are ignored in ax.annotate(arrowprops=...)
+* :ghissue:`26477`: [ENH]: Add interpolation_stage selector for images in qt figureoptions
+* :ghissue:`363`: Enable hatches for Cairo backend
+* :ghissue:`27852`: [Bug]: matplotlib.pyplot.matshow "(first dimension of the array) are displayed horizontally" but are displayed vertically
+* :ghissue:`27400`: [Bug]: tk backend confused by presence of file named "move" in current working directory
+* :ghissue:`25882`: [Bug]: plt.hist takes significantly more time with torch and jax arrays
+* :ghissue:`25204`: [Bug]: Pyparsing warnings emitted in mathtext
+* :ghissue:`17707`: getpwuid(): uid not found: 99
+* :ghissue:`27896`: [Doc]: Empty "User guide tutorials page" in docs
+* :ghissue:`27824`: [Bug]: polygon from axvspan not correct in polar plot after set_xy
+* :ghissue:`27378`: [ENH]: Suggest 'CN' if color is an integer
+* :ghissue:`27843`: [Bug]: close_group is not called when using patheffects
+* :ghissue:`27839`: [Bug]: PathCollection using alpha ignores 'none' facecolors
+* :ghissue:`25119`: [ENH]: secondary_x/yaxis accept transform argument
+* :ghissue:`27876`: [Doc]: Fix version switcher in devdocs
+* :ghissue:`27301`: [Bug]: ``imshow`` allows RGB(A) images with ``np.nan`` values to pass
+* :ghissue:`23839`: [MNT]: Add tests to codify ``ax.clear``
+* :ghissue:`27652`: [Doc]: Low contrast on clicked links in dark mode
+* :ghissue:`27865`: [Bug]: Zoom und pan not working after writing pdf pages.
+* :ghissue:`25871`: [Bug]: Colorbar cannot be added to another figure
+* :ghissue:`8072`: plot_date() ignores timezone in matplotlib version 2.0.0
+* :ghissue:`27812`: [ENH]: Add split feature for violin plots
+* :ghissue:`27659`: [MNT]: Improve return type of ``ioff`` and ``ion`` to improve Pyright analysis of bound variables
+* :ghissue:`27805`: [Bug]: Saving a figure with indicate_inset_zoom to pdf and then pickling it causes TypeError
+* :ghissue:`27701`: [Bug]: axis set_xscale('log') interferes with set_xticks
+* :ghissue:`19807`: radius modification in contains_point function when linewidth is specified
+* :ghissue:`27762`: [Bug]: Inconsistent treatment of list of labels in ``plot`` when the input is a dataframe
+* :ghissue:`27745`: [MNT]: ``_ImageBase.draw`` and ``Axis.draw`` args and kwargs
+* :ghissue:`27782`: [Doc]: Link to citation page in read me broken
+* :ghissue:`8789`: legend handle size does not automatically scale with linewidth
+* :ghissue:`27746`: [Doc]: Citation link in the readme.md points to 404
+* :ghissue:`20853`: Add deprecation for colormaps
+* :ghissue:`26865`: [MNT]: Remove 3.7-deprecated API
+* :ghissue:`24168`: [Bug]: ``subprocess-exited-with-error`` when trying to build on M1 mac
+* :ghissue:`27727`: [Doc]: Text in the colormap normalization gallery doesn't match the code
+* :ghissue:`27635`: [Bug]: test_figure_leak_20490 repeatedly failing on CI
+* :ghissue:`14217`: [Feature request] Add a way to update the position of the Arrow patch.
+* :ghissue:`20512`: Bad boxplot legend entries
+* :ghissue:`22011`: [Bug]: subfigures messes up with fig.legend zorder
+* :ghissue:`27414`: [Bug]: Legend overlaps shaded area in fill_between with legend location "best"
+* :ghissue:`23323`: Legend with "loc=best" does not try to avoid text
+* :ghissue:`27648`: [Doc]: ``Axes.inset_axes`` is still experimental
+* :ghissue:`27277`: [Doc]: Two license pages in docs
+* :ghissue:`24648`: [Doc]: make html fail early if latex not present
+* :ghissue:`27554`: [Bug]: Large image draw performance deterioration in recent releases
+* :ghissue:`25239`: [Bug]: colors.PowerNorm results in incorrect colorbar
+* :ghissue:`13533`: Boxplotting Masked Arrays
+* :ghissue:`25967`: [Doc]: dollar_ticks example refers to unused formatter classes
+* :ghissue:`24859`: [Doc]: Document color in a consistent way, including link
+* :ghissue:`27159`: [Bug]: Meson build fails due to qhull link issue.
+* :ghissue:`25691`: [Bug]: Secondary axis does not support Transform as functions
+* :ghissue:`25860`: [Bug]: canvas pick events not working when Axes belongs to a subfigure
+* :ghissue:`27361`: [Bug]: (Tight) layout engine breaks for 3D patches
+* :ghissue:`27145`: [ENH]: Make "No artists with labels found to put in legend" a warning
+* :ghissue:`27399`: [Bug]: None in y or yerr arrays leads to TypeError when using errorbar
+* :ghissue:`13887`: Accessing default ``norm`` of a Collection removes its colors.
+* :ghissue:`26593`: [ENH]: Support SubFigure.remove()
+* :ghissue:`27329`: [Bug]: Removing a colorbar for an axes positioned in a subgridspec restores the axes' position to the wrong place.
+* :ghissue:`27214`: [Bug]: ``NavigationToolbar2QT`` should use ``@Slot`` annotation
+* :ghissue:`27146`: [ENH]: Multi hatching in ``ax.stackplot()``
+* :ghissue:`27168`: [Doc]: Instructions for editable installation on Windows potentially missing a step
+* :ghissue:`27174`: [MNT]: Build nightly wheels with NumPy nightly wheels
+* :ghissue:`25043`: [ENH]: Plotting masked arrays correctly in 3D line plot
+* :ghissue:`26990`: [Doc]: Histogram path example renders poorly in HTML
+* :ghissue:`25738`: [MNT]: Improve readability of _mathtext_data.stix_virtual_fonts table
+* :ghissue:`11129`: Highlight past winners for JDH plotting contest in docs
+* :ghissue:`24050`: No error message in matplotlib.axes.Axes.legend() if there are more labels than handles
+* :ghissue:`10922`: ENH: clear() method for widgets.RadioButtons
+* :ghissue:`18295`: How to modify ticklabels in axisartist?
+* :ghissue:`24996`: [Bug]: for non-rectilinear axes, axvline/axhline should behave as "draw a gridline at that x/y"
+* :ghissue:`26841`: [Bug]: Global legend weird behaviors
+* :ghissue:`25974`: [MNT]: Cleanup ticklabel_format(..., style=)
+* :ghissue:`26786`: Please upload new dev wheel so we pick up 3.9.dev after 3.8 release
+* :ghissue:`18052`: the limits of axes are inexact with mplot3d
+* :ghissue:`25596`: [MNT]: Consistency on Interface
+* :ghissue:`26557`: [ENH]: Nightly Python 3.12 builds
+* :ghissue:`26281`: [ENH]: Add get_xmargin, get_ymargin, get_zmargin axes methods
diff --git a/doc/users/release_notes.rst b/doc/users/release_notes.rst
index 3befbeee5b77..1204450f6c05 100644
--- a/doc/users/release_notes.rst
+++ b/doc/users/release_notes.rst
@@ -19,8 +19,10 @@ Version 3.9
     :maxdepth: 1
 
     prev_whats_new/whats_new_3.9.0.rst
+    ../api/prev_api_changes/api_changes_3.9.1.rst
     ../api/prev_api_changes/api_changes_3.9.0.rst
     github_stats.rst
+    prev_whats_new/github_stats_3.9.0.rst
 
 Version 3.8
 ^^^^^^^^^^^

From 44be14cc3a866e28a9ad22f36abfe8c0623cc6ac Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 4 Jul 2024 01:45:22 -0400
Subject: [PATCH 1040/1120] REL: 3.9.1

This is the first bugfix release of the 3.9.x series.

This release contains several bug-fixes and adjustments:

- Add GitHub artifact attestations for sdist and wheels
- Re-add `matplotlib.cm.get_cmap`; note this function will still be
  removed at a later date
- Allow duplicate backend entry points
- Fix `Axes` autoscaling of thin bars at large locations
- Fix `Axes` autoscaling with `axhspan` / `axvspan`
- Fix `Axes3D` autoscaling of `Line3DCollection` / `Poly3DCollection`
- Fix `Axes3D` mouse interactivity with non-default roll angle
- Fix box aspect ratios in `Axes3D` with alternate vertical axis
- Fix case handling of backends specified as `module://...`
- Fix crash with TkAgg on Windows with `tk.window_focus: True`
- Fix interactive update of SubFigures
- Fix interactivity when using the IPython console
- Fix pickling of AxesWidgets and SubFigures
- Fix scaling on GTK3Cairo / GTK4Cairo backends
- Fix text wrapping within SubFigures
- Promote `mpltype` Sphinx role to a public extension; note this is only
  intended for development reasons

From 60bfa22f28a4bd20c8911451614d47ac175b58d4 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 4 Jul 2024 02:26:59 -0400
Subject: [PATCH 1041/1120] BLD: bump branch away from tag

So e tarballs from GitHub are stable.

From 9c9792a66900de7740fa6428f7fe59edb5083c60 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 4 Jul 2024 20:09:23 -0400
Subject: [PATCH 1042/1120] DOC: Add Zenodo DOI for 3.9.1

---
 doc/_static/zenodo_cache/12652732.svg | 35 +++++++++++++++++++++++++++
 doc/project/citing.rst                |  3 +++
 tools/cache_zenodo_svg.py             |  1 +
 3 files changed, 39 insertions(+)
 create mode 100644 doc/_static/zenodo_cache/12652732.svg

diff --git a/doc/_static/zenodo_cache/12652732.svg b/doc/_static/zenodo_cache/12652732.svg
new file mode 100644
index 000000000000..cde5c5f37839
--- /dev/null
+++ b/doc/_static/zenodo_cache/12652732.svg
@@ -0,0 +1,35 @@
+<svg xmlns="http://www.w3.org/2000/svg"
+     width="190.84375" height="20">
+        <linearGradient id="b" x2="0" y2="100%">
+            <stop offset="0" stop-color="#bbb" stop-opacity=".1"/>
+            <stop offset="1" stop-opacity=".1"/>
+        </linearGradient>
+        <mask id="a" width="190.84375" height="20">
+            <rect width="190.84375" height="20" rx="3"
+            fill="#fff"/>
+        </mask>
+        <g mask="url(#a)">
+            <path fill="#555" d="M0 0h31.375v20H0z" />
+            <path fill="#007ec6"
+            d="M31.375 0h159.46875v20H31.375z"
+            />
+            <path fill="url(#b)" d="M0 0h190.84375v20H0z" />
+        </g>
+        <g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,
+        Verdana,Geneva,sans-serif" font-size="11">
+            <text x="16.1875" y="15" fill="#010101"
+            fill-opacity=".3">
+                DOI
+            </text>
+            <text x="16.1875" y="14">
+                DOI
+            </text>
+            <text x="110.609375"
+            y="15" fill="#010101" fill-opacity=".3">
+                10.5281/zenodo.12652732
+            </text>
+            <text x="110.609375" y="14">
+                10.5281/zenodo.12652732
+            </text>
+        </g>
+    </svg>
\ No newline at end of file
diff --git a/doc/project/citing.rst b/doc/project/citing.rst
index fd013231b6c5..e0b99995ad11 100644
--- a/doc/project/citing.rst
+++ b/doc/project/citing.rst
@@ -32,6 +32,9 @@ By version
 .. START OF AUTOGENERATED
 
 
+v3.9.1
+   .. image:: ../_static/zenodo_cache/12652732.svg
+      :target:  https://doi.org/10.5281/zenodo.12652732
 v3.9.0
    .. image:: ../_static/zenodo_cache/11201097.svg
       :target:  https://doi.org/10.5281/zenodo.11201097
diff --git a/tools/cache_zenodo_svg.py b/tools/cache_zenodo_svg.py
index 600e87efc498..1dc2fbba020b 100644
--- a/tools/cache_zenodo_svg.py
+++ b/tools/cache_zenodo_svg.py
@@ -63,6 +63,7 @@ def _get_xdg_cache_dir():
 
 if __name__ == "__main__":
     data = {
+        "v3.9.1": "12652732",
         "v3.9.0": "11201097",
         "v3.8.4": "10916799",
         "v3.8.3": "10661079",

From 5ea9a7f6b23ffa7a0f9a37e8422feddefa75d0db Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Sun, 7 Jul 2024 06:10:23 -0400
Subject: [PATCH 1043/1120] Backport PR #28517: DOC: better cross referencing
 for animations

---
 doc/api/animation_api.rst                        | 3 +++
 galleries/users_explain/animations/animations.py | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/doc/api/animation_api.rst b/doc/api/animation_api.rst
index df39b5942199..1233b482165d 100644
--- a/doc/api/animation_api.rst
+++ b/doc/api/animation_api.rst
@@ -18,6 +18,9 @@ Animation
 The easiest way to make a live animation in Matplotlib is to use one of the
 `Animation` classes.
 
+.. seealso::
+   - :ref:`animations`
+
 .. inheritance-diagram:: matplotlib.animation.FuncAnimation matplotlib.animation.ArtistAnimation
    :parts: 1
 
diff --git a/galleries/users_explain/animations/animations.py b/galleries/users_explain/animations/animations.py
index 0391d9bc030a..2711663196f2 100644
--- a/galleries/users_explain/animations/animations.py
+++ b/galleries/users_explain/animations/animations.py
@@ -11,7 +11,7 @@
 generate animations using the `~matplotlib.animation` module. An
 animation is a sequence of frames where each frame corresponds to a plot on a
 `~matplotlib.figure.Figure`. This tutorial covers a general guideline on
-how to create such animations and the different options available.
+how to create such animations and the different options available.  More information is available in the API description: `~matplotlib.animation`
 """
 
 import matplotlib.pyplot as plt

From af6cc664bcdff66b1f1c3d4afdc93832681253ef Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Sun, 7 Jul 2024 06:10:23 -0400
Subject: [PATCH 1044/1120] Backport PR #28517: DOC: better cross referencing
 for animations

---
 doc/api/animation_api.rst                        | 3 +++
 galleries/users_explain/animations/animations.py | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/doc/api/animation_api.rst b/doc/api/animation_api.rst
index df39b5942199..1233b482165d 100644
--- a/doc/api/animation_api.rst
+++ b/doc/api/animation_api.rst
@@ -18,6 +18,9 @@ Animation
 The easiest way to make a live animation in Matplotlib is to use one of the
 `Animation` classes.
 
+.. seealso::
+   - :ref:`animations`
+
 .. inheritance-diagram:: matplotlib.animation.FuncAnimation matplotlib.animation.ArtistAnimation
    :parts: 1
 
diff --git a/galleries/users_explain/animations/animations.py b/galleries/users_explain/animations/animations.py
index 0391d9bc030a..2711663196f2 100644
--- a/galleries/users_explain/animations/animations.py
+++ b/galleries/users_explain/animations/animations.py
@@ -11,7 +11,7 @@
 generate animations using the `~matplotlib.animation` module. An
 animation is a sequence of frames where each frame corresponds to a plot on a
 `~matplotlib.figure.Figure`. This tutorial covers a general guideline on
-how to create such animations and the different options available.
+how to create such animations and the different options available.  More information is available in the API description: `~matplotlib.animation`
 """
 
 import matplotlib.pyplot as plt

From b7afb01dab684ddb8d6631ca2a0698f7f54bbfe0 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Mon, 8 Jul 2024 08:44:59 -0500
Subject: [PATCH 1045/1120] Backport PR #28523: Fix value error when set widget
 size to zero while using FiCureCanvasQT

---
 lib/matplotlib/backends/backend_qt.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/backends/backend_qt.py b/lib/matplotlib/backends/backend_qt.py
index a93b37799971..6603883075d4 100644
--- a/lib/matplotlib/backends/backend_qt.py
+++ b/lib/matplotlib/backends/backend_qt.py
@@ -492,7 +492,7 @@ def _draw_idle(self):
             if not self._draw_pending:
                 return
             self._draw_pending = False
-            if self.height() < 0 or self.width() < 0:
+            if self.height() <= 0 or self.width() <= 0:
                 return
             try:
                 self.draw()

From 3d1b29b738f5ffb2b83f87ca03f30acd308e30c1 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Fri, 12 Jul 2024 14:14:47 -0400
Subject: [PATCH 1046/1120] Backport PR #28541: MNT: be more careful about disk
 I/O failures when writing font cache

---
 lib/matplotlib/font_manager.py            |  8 ++++----
 lib/matplotlib/tests/test_font_manager.py | 24 ++++++++++++++++++++++-
 2 files changed, 27 insertions(+), 5 deletions(-)

diff --git a/lib/matplotlib/font_manager.py b/lib/matplotlib/font_manager.py
index 813bee6eb623..d9560ec0cc0f 100644
--- a/lib/matplotlib/font_manager.py
+++ b/lib/matplotlib/font_manager.py
@@ -965,11 +965,11 @@ def json_dump(data, filename):
     This function temporarily locks the output file to prevent multiple
     processes from overwriting one another's output.
     """
-    with cbook._lock_path(filename), open(filename, 'w') as fh:
-        try:
+    try:
+        with cbook._lock_path(filename), open(filename, 'w') as fh:
             json.dump(data, fh, cls=_JSONEncoder, indent=2)
-        except OSError as e:
-            _log.warning('Could not save font_manager cache %s', e)
+    except OSError as e:
+        _log.warning('Could not save font_manager cache %s', e)
 
 
 def json_load(filename):
diff --git a/lib/matplotlib/tests/test_font_manager.py b/lib/matplotlib/tests/test_font_manager.py
index 9563e4bf0869..776af16eeaaf 100644
--- a/lib/matplotlib/tests/test_font_manager.py
+++ b/lib/matplotlib/tests/test_font_manager.py
@@ -16,7 +16,7 @@
     json_dump, json_load, get_font, is_opentype_cff_font,
     MSUserFontDirectories, _get_fontconfig_fonts, ttfFontProperty)
 from matplotlib import cbook, ft2font, pyplot as plt, rc_context, figure as mfigure
-from matplotlib.testing import subprocess_run_helper
+from matplotlib.testing import subprocess_run_helper, subprocess_run_for_testing
 
 
 has_fclist = shutil.which('fc-list') is not None
@@ -280,6 +280,28 @@ def test_fontcache_thread_safe():
     subprocess_run_helper(_test_threading, timeout=10)
 
 
+def test_lockfilefailure(tmp_path):
+    # The logic here:
+    # 1. get a temp directory from pytest
+    # 2. import matplotlib which makes sure it exists
+    # 3. get the cache dir (where we check it is writable)
+    # 4. make it not writable
+    # 5. try to write into it via font manager
+    proc = subprocess_run_for_testing(
+        [
+            sys.executable,
+            "-c",
+            "import matplotlib;"
+            "import os;"
+            "p = matplotlib.get_cachedir();"
+            "os.chmod(p, 0o555);"
+            "import matplotlib.font_manager;"
+        ],
+        env={**os.environ, 'MPLCONFIGDIR': str(tmp_path)},
+        check=True
+    )
+
+
 def test_fontentry_dataclass():
     fontent = FontEntry(name='font-name')
 

From 8ede65d3a5a0b9f8047f175b632201cb113a151a Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Sat, 13 Jul 2024 12:06:20 -0500
Subject: [PATCH 1047/1120] Backport PR #28526: Bump pypa/cibuildwheel from
 2.19.1 to 2.19.2 in the actions group

---
 .github/workflows/cibuildwheel.yml | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index a4c0c0781813..050ff16cfbbd 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -135,7 +135,7 @@ jobs:
           path: dist/
 
       - name: Build wheels for CPython 3.12
-        uses: pypa/cibuildwheel@932529cab190fafca8c735a551657247fa8f8eaf  # v2.19.1
+        uses: pypa/cibuildwheel@7e5a838a63ac8128d71ab2dfd99e4634dd1bca09  # v2.19.2
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -143,7 +143,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.11
-        uses: pypa/cibuildwheel@932529cab190fafca8c735a551657247fa8f8eaf  # v2.19.1
+        uses: pypa/cibuildwheel@7e5a838a63ac8128d71ab2dfd99e4634dd1bca09  # v2.19.2
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -151,7 +151,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.10
-        uses: pypa/cibuildwheel@932529cab190fafca8c735a551657247fa8f8eaf  # v2.19.1
+        uses: pypa/cibuildwheel@7e5a838a63ac8128d71ab2dfd99e4634dd1bca09  # v2.19.2
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -159,7 +159,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.9
-        uses: pypa/cibuildwheel@932529cab190fafca8c735a551657247fa8f8eaf  # v2.19.1
+        uses: pypa/cibuildwheel@7e5a838a63ac8128d71ab2dfd99e4634dd1bca09  # v2.19.2
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -167,7 +167,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for PyPy
-        uses: pypa/cibuildwheel@932529cab190fafca8c735a551657247fa8f8eaf  # v2.19.1
+        uses: pypa/cibuildwheel@7e5a838a63ac8128d71ab2dfd99e4634dd1bca09  # v2.19.2
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:

From fadfe844470759dfb77f3589c9b2e9d57c0587b8 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Sat, 13 Jul 2024 11:20:24 -0700
Subject: [PATCH 1048/1120] Backport PR #28534: [BLD] Fix WSL build warning

---
 src/_image_resample.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/_image_resample.h b/src/_image_resample.h
index 745fe9f10cd7..a6404092ea2d 100644
--- a/src/_image_resample.h
+++ b/src/_image_resample.h
@@ -500,7 +500,7 @@ typedef enum {
 
 // T is rgba if and only if it has an T::r field.
 template<typename T, typename = void> struct is_grayscale : std::true_type {};
-template<typename T> struct is_grayscale<T, decltype(T::r, void())> : std::false_type {};
+template<typename T> struct is_grayscale<T, std::void_t<decltype(T::r)>> : std::false_type {};
 
 
 template<typename color_type>

From 73df1322432503d6c4e9f6a6d70ec9d936f91a46 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Sun, 14 Jul 2024 08:52:46 +0200
Subject: [PATCH 1049/1120] Backport PR #28571: DOC: Add version directive to
 hatch parameter in stackplot

---
 lib/matplotlib/stackplot.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/lib/matplotlib/stackplot.py b/lib/matplotlib/stackplot.py
index dd579bcd5877..43da57c25da5 100644
--- a/lib/matplotlib/stackplot.py
+++ b/lib/matplotlib/stackplot.py
@@ -64,6 +64,9 @@ def stackplot(axes, x, *args,
         of provided *y*, in which case the styles will repeat from the
         beginning.
 
+        .. versionadded:: 3.9
+           Support for list input
+
     data : indexable object, optional
         DATA_PARAMETER_PLACEHOLDER
 

From 26ca2f6013b706cc0d54f02c2d580255c1880c6d Mon Sep 17 00:00:00 2001
From: Jody Klymak <jklymak@gmail.com>
Date: Wed, 17 Jul 2024 07:15:46 -0700
Subject: [PATCH 1050/1120] Backport PR #28582: FIX: make sticky edge tolerance
 relative to data range

---
 lib/matplotlib/axes/_base.py                     |  10 ++--------
 .../test_axes/sticky_tolerance_cf.png            | Bin 0 -> 6222 bytes
 lib/matplotlib/tests/test_axes.py                |  10 ++++++++++
 3 files changed, 12 insertions(+), 8 deletions(-)
 create mode 100644 lib/matplotlib/tests/baseline_images/test_axes/sticky_tolerance_cf.png

diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index f83999436cbb..17feef5b2105 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -2962,22 +2962,16 @@ def handle_single_axis(
 
             # Prevent margin addition from crossing a sticky value.  A small
             # tolerance must be added due to floating point issues with
-            # streamplot; it is defined relative to x0, x1, x1-x0 but has
+            # streamplot; it is defined relative to x1-x0 but has
             # no absolute term (e.g. "+1e-8") to avoid issues when working with
             # datasets where all values are tiny (less than 1e-8).
-            tol = 1e-5 * max(abs(x0), abs(x1), abs(x1 - x0))
+            tol = 1e-5 * abs(x1 - x0)
             # Index of largest element < x0 + tol, if any.
             i0 = stickies.searchsorted(x0 + tol) - 1
             x0bound = stickies[i0] if i0 != -1 else None
-            # Ensure the boundary acts only if the sticky is the extreme value
-            if x0bound is not None and x0bound > x0:
-                x0bound = None
             # Index of smallest element > x1 - tol, if any.
             i1 = stickies.searchsorted(x1 - tol)
             x1bound = stickies[i1] if i1 != len(stickies) else None
-            # Ensure the boundary acts only if the sticky is the extreme value
-            if x1bound is not None and x1bound < x1:
-                x1bound = None
 
             # Add the margin in figure space and then transform back, to handle
             # non-linear scales.
diff --git a/lib/matplotlib/tests/baseline_images/test_axes/sticky_tolerance_cf.png b/lib/matplotlib/tests/baseline_images/test_axes/sticky_tolerance_cf.png
new file mode 100644
index 0000000000000000000000000000000000000000..a2e185c2769d6de5ae19ee2154fc6097a9173a32
GIT binary patch
literal 6222
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

literal 0
HcmV?d00001

diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index 3c0407ee4098..f18e05dc2f1e 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -701,6 +701,16 @@ def test_sticky_tolerance():
     axs.flat[3].barh(y=1, width=width, left=-20000.1)
 
 
+@image_comparison(['sticky_tolerance_cf.png'], remove_text=True, style="mpl20")
+def test_sticky_tolerance_contourf():
+    fig, ax = plt.subplots()
+
+    x = y = [14496.71, 14496.75]
+    data = [[0, 1], [2, 3]]
+
+    ax.contourf(x, y, data)
+
+
 def test_nargs_stem():
     with pytest.raises(TypeError, match='0 were given'):
         # stem() takes 1-3 arguments.

From 2f12c03ab9d32b24c65ea186396d02e71d37b802 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Thu, 18 Jul 2024 14:04:45 -0500
Subject: [PATCH 1051/1120] Backport PR #28580: Bump
 actions/attest-build-provenance from 1.3.2 to 1.3.3 in the actions group

---
 .github/workflows/cibuildwheel.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 050ff16cfbbd..ef819ea5a438 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -203,7 +203,7 @@ jobs:
         run: ls dist
 
       - name: Generate artifact attestation for sdist and wheel
-        uses: actions/attest-build-provenance@bdd51370e0416ac948727f861e03c2f05d32d78e  # v1.3.2
+        uses: actions/attest-build-provenance@5e9cb68e95676991667494a6a4e59b8a2f13e1d0  # v1.3.3
         with:
           subject-path: dist/matplotlib-*
 

From c37449cf46d2da62c42cf3657c8913d176e6d076 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Fri, 19 Jul 2024 22:50:31 +0200
Subject: [PATCH 1052/1120] Backport PR #28518: [TYP] Fix overload of
 `pyplot.subplots`

---
 lib/matplotlib/figure.pyi | 2 +-
 lib/matplotlib/pyplot.py  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/figure.pyi b/lib/matplotlib/figure.pyi
index b079312695c1..c31f90b4b2a8 100644
--- a/lib/matplotlib/figure.pyi
+++ b/lib/matplotlib/figure.pyi
@@ -132,7 +132,7 @@ class FigureBase(Artist):
         height_ratios: Sequence[float] | None = ...,
         subplot_kw: dict[str, Any] | None = ...,
         gridspec_kw: dict[str, Any] | None = ...,
-    ) -> Axes | np.ndarray: ...
+    ) -> Any: ...
     def delaxes(self, ax: Axes) -> None: ...
     def clear(self, keep_observers: bool = ...) -> None: ...
     def clf(self, keep_observers: bool = ...) -> None: ...
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index 8b4769342c7d..442013f7d21a 100644
--- a/lib/matplotlib/pyplot.py
+++ b/lib/matplotlib/pyplot.py
@@ -1597,7 +1597,7 @@ def subplots(
     subplot_kw: dict[str, Any] | None = ...,
     gridspec_kw: dict[str, Any] | None = ...,
     **fig_kw
-) -> tuple[Figure, Axes | np.ndarray]:
+) -> tuple[Figure, Any]:
     ...
 
 

From 99eaf725ec585ebe3d950492ce141c87b1d3d5c5 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 19 Jul 2024 19:18:51 -0400
Subject: [PATCH 1053/1120] Pin PyQt6 back on Ubuntu 20.04

The 6.7.1 wheels on PyPI do not conform to manylinux 2.28 due to
requiring glibc 2.35 symbols, and cannot be loaded on Ubuntu 20.04,
which has glibc 2.31. So we need to pin that back to avoid test
failures.
---
 .github/workflows/tests.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index daa07e62b2e5..634c83fa57fd 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -64,7 +64,7 @@ jobs:
             CFLAGS: "-fno-lto"  # Ensure that disabling LTO works.
             # https://github.com/matplotlib/matplotlib/pull/26052#issuecomment-1574595954
             # https://www.riverbankcomputing.com/pipermail/pyqt/2023-November/045606.html
-            pyqt6-ver: '!=6.5.1,!=6.6.0'
+            pyqt6-ver: '!=6.5.1,!=6.6.0,!=6.7.1'
             # https://bugreports.qt.io/projects/PYSIDE/issues/PYSIDE-2346
             pyside6-ver: '!=6.5.1'
           - os: ubuntu-20.04
@@ -72,7 +72,7 @@ jobs:
             extra-requirements: '-r requirements/testing/extra.txt'
             # https://github.com/matplotlib/matplotlib/pull/26052#issuecomment-1574595954
             # https://www.riverbankcomputing.com/pipermail/pyqt/2023-November/045606.html
-            pyqt6-ver: '!=6.5.1,!=6.6.0'
+            pyqt6-ver: '!=6.5.1,!=6.6.0,!=6.7.1'
             # https://bugreports.qt.io/projects/PYSIDE/issues/PYSIDE-2346
             pyside6-ver: '!=6.5.1'
           - os: ubuntu-22.04

From b8be220c6937b10a36700d5aa6b02dae8cc8c458 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Tue, 23 Jul 2024 07:17:28 +0200
Subject: [PATCH 1054/1120] Backport PR #28604: cycler signature update.

---
 lib/matplotlib/axes/_base.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
index 17feef5b2105..6b3f2750575c 100644
--- a/lib/matplotlib/axes/_base.py
+++ b/lib/matplotlib/axes/_base.py
@@ -1548,7 +1548,7 @@ def set_prop_cycle(self, *args, **kwargs):
         Axes. If multiple properties are given, their value lists must have
         the same length. This is just a shortcut for explicitly creating a
         cycler and passing it to the function, i.e. it's short for
-        ``set_prop_cycle(cycler(label=values label2=values2, ...))``.
+        ``set_prop_cycle(cycler(label=values, label2=values2, ...))``.
 
         Form 3 creates a `~cycler.Cycler` for a single property and set it
         as the property cycle of the Axes. This form exists for compatibility

From 4bedccf11b683b7b9ada06261818ab01ae56c659 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Mon, 29 Jul 2024 13:04:18 +0200
Subject: [PATCH 1055/1120] Backport PR #28621: TYP: Fix a typo in
 animation.pyi

---
 lib/matplotlib/animation.pyi | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/animation.pyi b/lib/matplotlib/animation.pyi
index 56c27a465b7f..345e3c6dbe61 100644
--- a/lib/matplotlib/animation.pyi
+++ b/lib/matplotlib/animation.pyi
@@ -207,7 +207,7 @@ class FuncAnimation(TimedAnimation):
         self,
         fig: Figure,
         func: Callable[..., Iterable[Artist]],
-        frames: Iterable[Artist] | int | Callable[[], Generator] | None = ...,
+        frames: Iterable | int | Callable[[], Generator] | None = ...,
         init_func: Callable[[], Iterable[Artist]] | None = ...,
         fargs: tuple[Any, ...] | None = ...,
         save_count: int | None = ...,

From 7457ba43b8362bb43de954fc46897e9da7738e02 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Thu, 1 Aug 2024 13:57:56 -0500
Subject: [PATCH 1056/1120] Backport PR #28625: added typing_extensions.Self to
 _AxesBase.twinx

---
 lib/matplotlib/axes/_base.pyi | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/axes/_base.pyi b/lib/matplotlib/axes/_base.pyi
index 751dcd248a5c..8cd88a92cc09 100644
--- a/lib/matplotlib/axes/_base.pyi
+++ b/lib/matplotlib/axes/_base.pyi
@@ -4,6 +4,7 @@ import datetime
 from collections.abc import Callable, Iterable, Iterator, Sequence
 from matplotlib import cbook
 from matplotlib.artist import Artist
+from matplotlib.axes import Axes
 from matplotlib.axis import XAxis, YAxis, Tick
 from matplotlib.backend_bases import RendererBase, MouseButton, MouseEvent
 from matplotlib.cbook import CallbackRegistry
@@ -384,8 +385,8 @@ class _AxesBase(martist.Artist):
         bbox_extra_artists: Sequence[Artist] | None = ...,
         for_layout_only: bool = ...
     ) -> Bbox | None: ...
-    def twinx(self) -> _AxesBase: ...
-    def twiny(self) -> _AxesBase: ...
+    def twinx(self) -> Axes: ...
+    def twiny(self) -> Axes: ...
     def get_shared_x_axes(self) -> cbook.GrouperView: ...
     def get_shared_y_axes(self) -> cbook.GrouperView: ...
     def label_outer(self, remove_inner_ticks: bool = ...) -> None: ...

From 6ed77f6b6965408b6a07524e8fbcf77675593de2 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 1 Aug 2024 17:31:20 -0400
Subject: [PATCH 1057/1120] Backport PR #28634: Closed open div tag in
 color.ColorMap._repr_html_

---
 lib/matplotlib/colors.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/lib/matplotlib/colors.py b/lib/matplotlib/colors.py
index 177557b371a6..5f40e7b0fb9a 100644
--- a/lib/matplotlib/colors.py
+++ b/lib/matplotlib/colors.py
@@ -960,6 +960,7 @@ def color_block(color):
                 '</div>'
                 '<div style="float: right;">'
                 f'over {color_block(self.get_over())}'
+                '</div>'
                 '</div>')
 
     def copy(self):

From 105533f20837e152625269a32e9e11cfe9d93ef9 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 2 Aug 2024 01:28:29 -0400
Subject: [PATCH 1058/1120] Backport PR #28644: DOC: Fix matching for version
 switcher

---
 doc/conf.py | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/doc/conf.py b/doc/conf.py
index f43806a8b4c0..56e09a24b53a 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -496,10 +496,9 @@ def js_tag_with_cache_busting(js):
             f"https://matplotlib.org/devdocs/_static/switcher.json?{SHA}"
         ),
         "version_match": (
-            # The start version to show. This must be in switcher.json.
-            # We either go to 'stable' or to 'devdocs'
-            'stable' if matplotlib.__version_info__.releaselevel == 'final'
-            else 'devdocs')
+            matplotlib.__version__
+            if matplotlib.__version_info__.releaselevel == 'final'
+            else 'dev')
     },
     "navbar_end": ["theme-switcher", "version-switcher", "mpl_icon_links"],
     "navbar_persistent": ["search-button"],

From ab258b73605635a0c6bc28d3e5e391232abd3292 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 2 Aug 2024 01:28:29 -0400
Subject: [PATCH 1059/1120] Backport PR #28644: DOC: Fix matching for version
 switcher

---
 doc/conf.py | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/doc/conf.py b/doc/conf.py
index f43806a8b4c0..56e09a24b53a 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -496,10 +496,9 @@ def js_tag_with_cache_busting(js):
             f"https://matplotlib.org/devdocs/_static/switcher.json?{SHA}"
         ),
         "version_match": (
-            # The start version to show. This must be in switcher.json.
-            # We either go to 'stable' or to 'devdocs'
-            'stable' if matplotlib.__version_info__.releaselevel == 'final'
-            else 'devdocs')
+            matplotlib.__version__
+            if matplotlib.__version_info__.releaselevel == 'final'
+            else 'dev')
     },
     "navbar_end": ["theme-switcher", "version-switcher", "mpl_icon_links"],
     "navbar_persistent": ["search-button"],

From e7aba708ec6c8d834bc250bafa4e405d2736af38 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Sat, 3 Aug 2024 05:42:17 -0400
Subject: [PATCH 1060/1120] Backport PR #28649: FIX: improve formatting of
 image values in cases of singular norms

---
 lib/matplotlib/artist.py           | 4 +++-
 lib/matplotlib/cbook.py            | 4 ++++
 lib/matplotlib/tests/test_image.py | 3 ++-
 3 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/artist.py b/lib/matplotlib/artist.py
index d5b8631e95df..735c2eb59cf5 100644
--- a/lib/matplotlib/artist.py
+++ b/lib/matplotlib/artist.py
@@ -1346,7 +1346,9 @@ def format_cursor_data(self, data):
                     delta = np.diff(
                         self.norm.boundaries[neigh_idx:cur_idx + 2]
                     ).max()
-
+                elif self.norm.vmin == self.norm.vmax:
+                    # singular norms, use delta of 10% of only value
+                    delta = np.abs(self.norm.vmin * .1)
                 else:
                     # Midpoints of neighboring color intervals.
                     neighbors = self.norm.inverse(
diff --git a/lib/matplotlib/cbook.py b/lib/matplotlib/cbook.py
index a156ac200abf..f5a4199cf9ad 100644
--- a/lib/matplotlib/cbook.py
+++ b/lib/matplotlib/cbook.py
@@ -2252,6 +2252,10 @@ def _g_sig_digits(value, delta):
     it is known with an error of *delta*.
     """
     if delta == 0:
+        if value == 0:
+            # if both value and delta are 0, np.spacing below returns 5e-324
+            # which results in rather silly results
+            return 3
         # delta = 0 may occur when trying to format values over a tiny range;
         # in that case, replace it by the distance to the closest float.
         delta = abs(np.spacing(value))
diff --git a/lib/matplotlib/tests/test_image.py b/lib/matplotlib/tests/test_image.py
index a043d3aec983..0c032fa5367a 100644
--- a/lib/matplotlib/tests/test_image.py
+++ b/lib/matplotlib/tests/test_image.py
@@ -411,7 +411,8 @@ def test_cursor_data_nonuniform(xy, data):
         ([[.123, .987]], "[0.123]"),
         ([[np.nan, 1, 2]], "[]"),
         ([[1, 1+1e-15]], "[1.0000000000000000]"),
-        ([[-1, -1]], "[-1.0000000000000000]"),
+        ([[-1, -1]], "[-1.0]"),
+        ([[0, 0]], "[0.00]"),
     ])
 def test_format_cursor_data(data, text):
     from matplotlib.backend_bases import MouseEvent

From e68bfdbea55b60c566de04d41a2b1d95544ea833 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Wed, 31 Jul 2024 06:34:27 +0200
Subject: [PATCH 1061/1120] Backport PR #28546: DOC: Clarify/simplify example
 of multiple images with one colorbar

---
 .../images_contours_and_fields/multi_image.py | 88 +++++++++++--------
 1 file changed, 51 insertions(+), 37 deletions(-)

diff --git a/galleries/examples/images_contours_and_fields/multi_image.py b/galleries/examples/images_contours_and_fields/multi_image.py
index 5634a32abeb9..8be048055dec 100644
--- a/galleries/examples/images_contours_and_fields/multi_image.py
+++ b/galleries/examples/images_contours_and_fields/multi_image.py
@@ -1,9 +1,19 @@
 """
-===============
-Multiple images
-===============
+=================================
+Multiple images with one colorbar
+=================================
 
-Make a set of images with a single colormap, norm, and colorbar.
+Use a single colorbar for multiple images.
+
+Currently, a colorbar can only be connected to one image. The connection
+guarantees that the data coloring is consistent with the colormap scale
+(i.e. the color of value *x* in the colormap is used for coloring a data
+value *x* in the image).
+
+If we want one colorbar to be representative for multiple images, we have
+to explicitly ensure consistent data coloring by using the same data
+normalization for all the images. We ensure this by explicitly creating a
+``norm`` object that we pass to all the image plotting methods.
 """
 
 import matplotlib.pyplot as plt
@@ -12,47 +22,53 @@
 from matplotlib import colors
 
 np.random.seed(19680801)
-Nr = 3
-Nc = 2
 
-fig, axs = plt.subplots(Nr, Nc)
+datasets = [
+    (i+1)/10 * np.random.rand(10, 20)
+    for i in range(4)
+]
+
+fig, axs = plt.subplots(2, 2)
 fig.suptitle('Multiple images')
 
-images = []
-for i in range(Nr):
-    for j in range(Nc):
-        # Generate data with a range that varies from one plot to the next.
-        data = ((1 + i + j) / 10) * np.random.rand(10, 20)
-        images.append(axs[i, j].imshow(data))
-        axs[i, j].label_outer()
+# create a single norm to be shared across all images
+norm = colors.Normalize(vmin=np.min(datasets), vmax=np.max(datasets))
 
-# Find the min and max of all colors for use in setting the color scale.
-vmin = min(image.get_array().min() for image in images)
-vmax = max(image.get_array().max() for image in images)
-norm = colors.Normalize(vmin=vmin, vmax=vmax)
-for im in images:
-    im.set_norm(norm)
+images = []
+for ax, data in zip(axs.flat, datasets):
+    images.append(ax.imshow(data, norm=norm))
 
 fig.colorbar(images[0], ax=axs, orientation='horizontal', fraction=.1)
 
-
-# Make images respond to changes in the norm of other images (e.g. via the
-# "edit axis, curves and images parameters" GUI on Qt), but be careful not to
-# recurse infinitely!
-def update(changed_image):
-    for im in images:
-        if (changed_image.get_cmap() != im.get_cmap()
-                or changed_image.get_clim() != im.get_clim()):
-            im.set_cmap(changed_image.get_cmap())
-            im.set_clim(changed_image.get_clim())
-
-
-for im in images:
-    im.callbacks.connect('changed', update)
-
 plt.show()
 
 # %%
+# The colors are now kept consistent across all images when changing the
+# scaling, e.g. through zooming in the colorbar or via the "edit axis,
+# curves and images parameters" GUI of the Qt backend. This is sufficient
+# for most practical use cases.
+#
+# Advanced: Additionally sync the colormap
+# ----------------------------------------
+#
+# Sharing a common norm object guarantees synchronized scaling because scale
+# changes modify the norm object in-place and thus propagate to all images
+# that use this norm. This approach does not help with synchronizing colormaps
+# because changing the colormap of an image (e.g. through the "edit axis,
+# curves and images parameters" GUI of the Qt backend) results in the image
+# referencing the new colormap object. Thus, the other images are not updated.
+#
+# To update the other images, sync the
+# colormaps using the following code::
+#
+#     def sync_cmaps(changed_image):
+#         for im in images:
+#         if changed_image.get_cmap() != im.get_cmap():
+#             im.set_cmap(changed_image.get_cmap())
+#
+#     for im in images:
+#         im.callbacks.connect('changed', sync_cmaps)
+#
 #
 # .. admonition:: References
 #
@@ -63,6 +79,4 @@ def update(changed_image):
 #    - `matplotlib.figure.Figure.colorbar` / `matplotlib.pyplot.colorbar`
 #    - `matplotlib.colors.Normalize`
 #    - `matplotlib.cm.ScalarMappable.set_cmap`
-#    - `matplotlib.cm.ScalarMappable.set_norm`
-#    - `matplotlib.cm.ScalarMappable.set_clim`
 #    - `matplotlib.cbook.CallbackRegistry.connect`

From 6c7dbc06ebc50d4833189605b4fdc6a30ea8f283 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Wed, 31 Jul 2024 06:34:27 +0200
Subject: [PATCH 1062/1120] Backport PR #28546: DOC: Clarify/simplify example
 of multiple images with one colorbar

---
 .../images_contours_and_fields/multi_image.py | 88 +++++++++++--------
 1 file changed, 51 insertions(+), 37 deletions(-)

diff --git a/galleries/examples/images_contours_and_fields/multi_image.py b/galleries/examples/images_contours_and_fields/multi_image.py
index 5634a32abeb9..8be048055dec 100644
--- a/galleries/examples/images_contours_and_fields/multi_image.py
+++ b/galleries/examples/images_contours_and_fields/multi_image.py
@@ -1,9 +1,19 @@
 """
-===============
-Multiple images
-===============
+=================================
+Multiple images with one colorbar
+=================================
 
-Make a set of images with a single colormap, norm, and colorbar.
+Use a single colorbar for multiple images.
+
+Currently, a colorbar can only be connected to one image. The connection
+guarantees that the data coloring is consistent with the colormap scale
+(i.e. the color of value *x* in the colormap is used for coloring a data
+value *x* in the image).
+
+If we want one colorbar to be representative for multiple images, we have
+to explicitly ensure consistent data coloring by using the same data
+normalization for all the images. We ensure this by explicitly creating a
+``norm`` object that we pass to all the image plotting methods.
 """
 
 import matplotlib.pyplot as plt
@@ -12,47 +22,53 @@
 from matplotlib import colors
 
 np.random.seed(19680801)
-Nr = 3
-Nc = 2
 
-fig, axs = plt.subplots(Nr, Nc)
+datasets = [
+    (i+1)/10 * np.random.rand(10, 20)
+    for i in range(4)
+]
+
+fig, axs = plt.subplots(2, 2)
 fig.suptitle('Multiple images')
 
-images = []
-for i in range(Nr):
-    for j in range(Nc):
-        # Generate data with a range that varies from one plot to the next.
-        data = ((1 + i + j) / 10) * np.random.rand(10, 20)
-        images.append(axs[i, j].imshow(data))
-        axs[i, j].label_outer()
+# create a single norm to be shared across all images
+norm = colors.Normalize(vmin=np.min(datasets), vmax=np.max(datasets))
 
-# Find the min and max of all colors for use in setting the color scale.
-vmin = min(image.get_array().min() for image in images)
-vmax = max(image.get_array().max() for image in images)
-norm = colors.Normalize(vmin=vmin, vmax=vmax)
-for im in images:
-    im.set_norm(norm)
+images = []
+for ax, data in zip(axs.flat, datasets):
+    images.append(ax.imshow(data, norm=norm))
 
 fig.colorbar(images[0], ax=axs, orientation='horizontal', fraction=.1)
 
-
-# Make images respond to changes in the norm of other images (e.g. via the
-# "edit axis, curves and images parameters" GUI on Qt), but be careful not to
-# recurse infinitely!
-def update(changed_image):
-    for im in images:
-        if (changed_image.get_cmap() != im.get_cmap()
-                or changed_image.get_clim() != im.get_clim()):
-            im.set_cmap(changed_image.get_cmap())
-            im.set_clim(changed_image.get_clim())
-
-
-for im in images:
-    im.callbacks.connect('changed', update)
-
 plt.show()
 
 # %%
+# The colors are now kept consistent across all images when changing the
+# scaling, e.g. through zooming in the colorbar or via the "edit axis,
+# curves and images parameters" GUI of the Qt backend. This is sufficient
+# for most practical use cases.
+#
+# Advanced: Additionally sync the colormap
+# ----------------------------------------
+#
+# Sharing a common norm object guarantees synchronized scaling because scale
+# changes modify the norm object in-place and thus propagate to all images
+# that use this norm. This approach does not help with synchronizing colormaps
+# because changing the colormap of an image (e.g. through the "edit axis,
+# curves and images parameters" GUI of the Qt backend) results in the image
+# referencing the new colormap object. Thus, the other images are not updated.
+#
+# To update the other images, sync the
+# colormaps using the following code::
+#
+#     def sync_cmaps(changed_image):
+#         for im in images:
+#         if changed_image.get_cmap() != im.get_cmap():
+#             im.set_cmap(changed_image.get_cmap())
+#
+#     for im in images:
+#         im.callbacks.connect('changed', sync_cmaps)
+#
 #
 # .. admonition:: References
 #
@@ -63,6 +79,4 @@ def update(changed_image):
 #    - `matplotlib.figure.Figure.colorbar` / `matplotlib.pyplot.colorbar`
 #    - `matplotlib.colors.Normalize`
 #    - `matplotlib.cm.ScalarMappable.set_cmap`
-#    - `matplotlib.cm.ScalarMappable.set_norm`
-#    - `matplotlib.cm.ScalarMappable.set_clim`
 #    - `matplotlib.cbook.CallbackRegistry.connect`

From 2a8d1fc7a4a0303c534b6452c752c79122ecf926 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Wed, 7 Aug 2024 16:05:43 +0200
Subject: [PATCH 1063/1120] Backport PR #28650: remove out of date todos on
 animation.py

---
 lib/matplotlib/animation.py | 20 --------------------
 1 file changed, 20 deletions(-)

diff --git a/lib/matplotlib/animation.py b/lib/matplotlib/animation.py
index 1efb72cb52e6..5a4764f1a79f 100644
--- a/lib/matplotlib/animation.py
+++ b/lib/matplotlib/animation.py
@@ -1,23 +1,3 @@
-# TODO:
-# * Documentation -- this will need a new section of the User's Guide.
-#      Both for Animations and just timers.
-#   - Also need to update
-#     https://scipy-cookbook.readthedocs.io/items/Matplotlib_Animations.html
-# * Blit
-#   * Currently broken with Qt4 for widgets that don't start on screen
-#   * Still a few edge cases that aren't working correctly
-#   * Can this integrate better with existing matplotlib animation artist flag?
-#     - If animated removes from default draw(), perhaps we could use this to
-#       simplify initial draw.
-# * Example
-#   * Frameless animation - pure procedural with no loop
-#   * Need example that uses something like inotify or subprocess
-#   * Complex syncing examples
-# * Movies
-#   * Can blit be enabled for movies?
-# * Need to consider event sources to allow clicking through multiple figures
-
-
 import abc
 import base64
 import contextlib

From 1bb9c02173f86efee085c9e771a61a449be6e02d Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Wed, 7 Aug 2024 15:48:15 -0500
Subject: [PATCH 1064/1120] Backport PR #28577: Copy all internals from initial
 Tick to lazy ones

---
 lib/matplotlib/axis.py            | 33 ++++++++++++++++++++-----------
 lib/matplotlib/tests/test_axes.py | 22 +++++++++++++++++++++
 2 files changed, 43 insertions(+), 12 deletions(-)

diff --git a/lib/matplotlib/axis.py b/lib/matplotlib/axis.py
index 3afc98fac60b..98f7db89b09f 100644
--- a/lib/matplotlib/axis.py
+++ b/lib/matplotlib/axis.py
@@ -33,12 +33,6 @@
 _gridline_param_names = ['grid_' + name
                          for name in _line_param_names + _line_param_aliases]
 
-_MARKER_DICT = {
-    'out': (mlines.TICKDOWN, mlines.TICKUP),
-    'in': (mlines.TICKUP, mlines.TICKDOWN),
-    'inout': ('|', '|'),
-}
-
 
 class Tick(martist.Artist):
     """
@@ -204,18 +198,21 @@ def _set_labelrotation(self, labelrotation):
         _api.check_in_list(['auto', 'default'], labelrotation=mode)
         self._labelrotation = (mode, angle)
 
+    @property
+    def _pad(self):
+        return self._base_pad + self.get_tick_padding()
+
     def _apply_tickdir(self, tickdir):
         """Set tick direction.  Valid values are 'out', 'in', 'inout'."""
-        # This method is responsible for updating `_pad`, and, in subclasses,
-        # for setting the tick{1,2}line markers as well.  From the user
-        # perspective this should always be called through _apply_params, which
-        # further updates ticklabel positions using the new pads.
+        # This method is responsible for verifying input and, in subclasses, for setting
+        # the tick{1,2}line markers.  From the user perspective this should always be
+        # called through _apply_params, which further updates ticklabel positions using
+        # the new pads.
         if tickdir is None:
             tickdir = mpl.rcParams[f'{self.__name__}.direction']
         else:
             _api.check_in_list(['in', 'out', 'inout'], tickdir=tickdir)
         self._tickdir = tickdir
-        self._pad = self._base_pad + self.get_tick_padding()
 
     def get_tickdir(self):
         return self._tickdir
@@ -425,7 +422,11 @@ def _get_text2_transform(self):
     def _apply_tickdir(self, tickdir):
         # docstring inherited
         super()._apply_tickdir(tickdir)
-        mark1, mark2 = _MARKER_DICT[self._tickdir]
+        mark1, mark2 = {
+            'out': (mlines.TICKDOWN, mlines.TICKUP),
+            'in': (mlines.TICKUP, mlines.TICKDOWN),
+            'inout': ('|', '|'),
+        }[self._tickdir]
         self.tick1line.set_marker(mark1)
         self.tick2line.set_marker(mark2)
 
@@ -1617,6 +1618,14 @@ def _copy_tick_props(self, src, dest):
         dest.tick1line.update_from(src.tick1line)
         dest.tick2line.update_from(src.tick2line)
         dest.gridline.update_from(src.gridline)
+        dest.update_from(src)
+        dest._loc = src._loc
+        dest._size = src._size
+        dest._width = src._width
+        dest._base_pad = src._base_pad
+        dest._labelrotation = src._labelrotation
+        dest._zorder = src._zorder
+        dest._tickdir = src._tickdir
 
     def get_label_text(self):
         """Get the text of the label."""
diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index f18e05dc2f1e..3ec9923c0840 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -5631,6 +5631,28 @@ def test_reset_ticks(fig_test, fig_ref):
         ax.yaxis.reset_ticks()
 
 
+@mpl.style.context('mpl20')
+def test_context_ticks():
+    with plt.rc_context({
+            'xtick.direction': 'in', 'xtick.major.size': 30, 'xtick.major.width': 5,
+            'xtick.color': 'C0', 'xtick.major.pad': 12,
+            'xtick.bottom': True, 'xtick.top': True,
+            'xtick.labelsize': 14, 'xtick.labelcolor': 'C1'}):
+        fig, ax = plt.subplots()
+    # Draw outside the context so that all-but-first tick are generated with the normal
+    # mpl20 style in place.
+    fig.draw_without_rendering()
+
+    first_tick = ax.xaxis.majorTicks[0]
+    for tick in ax.xaxis.majorTicks[1:]:
+        assert tick._size == first_tick._size
+        assert tick._width == first_tick._width
+        assert tick._base_pad == first_tick._base_pad
+        assert tick._labelrotation == first_tick._labelrotation
+        assert tick._zorder == first_tick._zorder
+        assert tick._tickdir == first_tick._tickdir
+
+
 def test_vline_limit():
     fig = plt.figure()
     ax = fig.gca()

From c57960c89497163dd80f13244c00a429a5469c62 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Thu, 8 Aug 2024 11:31:47 -0500
Subject: [PATCH 1065/1120] Backport PR #28682: Fix warnings from mingw
 compilers

---
 src/_c_internal_utils.cpp | 13 ++++++++++---
 src/_tkagg.cpp            |  9 ++++++++-
 2 files changed, 18 insertions(+), 4 deletions(-)

diff --git a/src/_c_internal_utils.cpp b/src/_c_internal_utils.cpp
index e118183ecc8b..74bb97904f89 100644
--- a/src/_c_internal_utils.cpp
+++ b/src/_c_internal_utils.cpp
@@ -7,7 +7,14 @@
 #define WIN32_LEAN_AND_MEAN
 // Windows 10, for latest HiDPI API support.
 #define WINVER 0x0A00
-#define _WIN32_WINNT 0x0A00
+#if defined(_WIN32_WINNT)
+#if _WIN32_WINNT < WINVER
+#undef _WIN32_WINNT
+#define _WIN32_WINNT WINVER
+#endif
+#else
+#define _WIN32_WINNT WINVER
+#endif
 #endif
 #include <pybind11/pybind11.h>
 #ifdef __linux__
@@ -125,7 +132,7 @@ static void
 mpl_SetForegroundWindow(py::capsule UNUSED_ON_NON_WINDOWS(handle_p))
 {
 #ifdef _WIN32
-    if (handle_p.name() != "HWND") {
+    if (strcmp(handle_p.name(), "HWND") != 0) {
         throw std::runtime_error("Handle must be a value returned from Win32_GetForegroundWindow");
     }
     HWND handle = static_cast<HWND>(handle_p.get_pointer());
@@ -158,7 +165,7 @@ mpl_SetProcessDpiAwareness_max(void)
         DPI_AWARENESS_CONTEXT_SYSTEM_AWARE};         // Win10
     if (IsValidDpiAwarenessContextPtr != NULL
             && SetProcessDpiAwarenessContextPtr != NULL) {
-        for (int i = 0; i < sizeof(ctxs) / sizeof(DPI_AWARENESS_CONTEXT); ++i) {
+        for (size_t i = 0; i < sizeof(ctxs) / sizeof(DPI_AWARENESS_CONTEXT); ++i) {
             if (IsValidDpiAwarenessContextPtr(ctxs[i])) {
                 SetProcessDpiAwarenessContextPtr(ctxs[i]);
                 break;
diff --git a/src/_tkagg.cpp b/src/_tkagg.cpp
index e35502fe23ff..bfc2253188fd 100644
--- a/src/_tkagg.cpp
+++ b/src/_tkagg.cpp
@@ -19,7 +19,14 @@
 #define WIN32_LEAN_AND_MEAN
 // Windows 8.1
 #define WINVER 0x0603
-#define _WIN32_WINNT 0x0603
+#if defined(_WIN32_WINNT)
+#if _WIN32_WINNT < WINVER
+#undef _WIN32_WINNT
+#define _WIN32_WINNT WINVER
+#endif
+#else
+#define _WIN32_WINNT WINVER
+#endif
 #endif
 
 #include <pybind11/pybind11.h>

From e40125ac7f17de880ebc8177e82a16c194779f2a Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Thu, 25 Jul 2024 15:39:40 -0400
Subject: [PATCH 1066/1120] Backport PR #28293 and #28668: Enable 3.13 wheels
 and bump cibuildwheel

This is the commit message #1:

> Merge pull request #28293 from QuLogic/py313
>
> BLD: Enable building Python 3.13 wheels for nightlies

(cherry picked from commit 725ee995000985b2ee24d1b21cd777e0811272c8)

This is the commit message #2:

> Merge pull request #28668 from matplotlib/dependabot/github_actions/actions-167bd8b160
>
> Bump the actions group with 2 updates

(cherry picked from commit fd42e7d63577ef88694913268fe5a5ffd8539431)
---
 .github/workflows/cibuildwheel.yml | 30 +++++++++++++++++++++++++-----
 1 file changed, 25 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index ef819ea5a438..4e8ea0ab5bf6 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -134,8 +134,28 @@ jobs:
           name: cibw-sdist
           path: dist/
 
+      - name: Build wheels for CPython 3.13
+        uses: pypa/cibuildwheel@bd033a44476646b606efccdd5eed92d5ea1d77ad  # v2.20.0
+        with:
+          package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
+        env:
+          CIBW_BUILD: "cp313-* cp313t-*"
+          # No free-threading wheels for NumPy; musllinux skipped for main builds also.
+          CIBW_SKIP: "cp313t-win_amd64 *-musllinux_aarch64"
+          CIBW_BUILD_FRONTEND:
+            "pip; args: --pre --extra-index-url https://pypi.anaconda.org/scientific-python-nightly-wheels/simple"
+          CIBW_FREE_THREADED_SUPPORT: true
+          # No free-threading wheels available for aarch64 on Pillow.
+          CIBW_TEST_SKIP: "cp313t-manylinux_aarch64"
+          # We need pre-releases to get the nightly wheels.
+          CIBW_BEFORE_TEST: >-
+            pip install --pre
+            --extra-index-url https://pypi.anaconda.org/scientific-python-nightly-wheels/simple
+            contourpy numpy pillow
+          CIBW_ARCHS: ${{ matrix.cibw_archs }}
+
       - name: Build wheels for CPython 3.12
-        uses: pypa/cibuildwheel@7e5a838a63ac8128d71ab2dfd99e4634dd1bca09  # v2.19.2
+        uses: pypa/cibuildwheel@bd033a44476646b606efccdd5eed92d5ea1d77ad  # v2.20.0
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -143,7 +163,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.11
-        uses: pypa/cibuildwheel@7e5a838a63ac8128d71ab2dfd99e4634dd1bca09  # v2.19.2
+        uses: pypa/cibuildwheel@bd033a44476646b606efccdd5eed92d5ea1d77ad  # v2.20.0
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -151,7 +171,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.10
-        uses: pypa/cibuildwheel@7e5a838a63ac8128d71ab2dfd99e4634dd1bca09  # v2.19.2
+        uses: pypa/cibuildwheel@bd033a44476646b606efccdd5eed92d5ea1d77ad  # v2.20.0
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -167,7 +187,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for PyPy
-        uses: pypa/cibuildwheel@7e5a838a63ac8128d71ab2dfd99e4634dd1bca09  # v2.19.2
+        uses: pypa/cibuildwheel@bd033a44476646b606efccdd5eed92d5ea1d77ad  # v2.20.0
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -203,7 +223,7 @@ jobs:
         run: ls dist
 
       - name: Generate artifact attestation for sdist and wheel
-        uses: actions/attest-build-provenance@5e9cb68e95676991667494a6a4e59b8a2f13e1d0  # v1.3.3
+        uses: actions/attest-build-provenance@210c1913531870065f03ce1f9440dd87bc0938cd  # v1.4.0
         with:
           subject-path: dist/matplotlib-*
 

From 465401ed3000baff801e8f14592754cf80ce25d9 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Fri, 9 Aug 2024 14:15:32 +0200
Subject: [PATCH 1067/1120] Backport PR #28632: DOC: Tell sphinx-gallery to
 link mpl_toolkits from our build

---
 doc/conf.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/doc/conf.py b/doc/conf.py
index 56e09a24b53a..843766a804ea 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -263,7 +263,8 @@ def _check_dependencies():
     'matplotlib_animations': True,
     'min_reported_time': 1,
     'plot_gallery': 'True',  # sphinx-gallery/913
-    'reference_url': {'matplotlib': None},
+    'reference_url': {'matplotlib': None, 'mpl_toolkits': None},
+    'prefer_full_module': {r'mpl_toolkits\.'},
     'remove_config_comments': True,
     'reset_modules': ('matplotlib', clear_basic_units),
     'subsection_order': gallery_order_sectionorder,

From d88a582fb14accd95e80a25a567b1d1bb08561d0 Mon Sep 17 00:00:00 2001
From: Kyle Sunden <git@ksunden.space>
Date: Fri, 9 Aug 2024 12:17:28 -0500
Subject: [PATCH 1068/1120] Backport PR #27797: DOC: Use video files for saving
 animations

---
 doc/conf.py                           | 7 ++++++-
 requirements/doc/doc-requirements.txt | 1 +
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/doc/conf.py b/doc/conf.py
index 843766a804ea..8036edec9989 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -194,6 +194,11 @@ def _check_dependencies():
         subsectionorder as gallery_order_subsectionorder)
     from sphinxext.util import clear_basic_units, matplotlib_reduced_latex_scraper
 
+if parse_version(sphinx_gallery.__version__) >= parse_version('0.17.0'):
+    sg_matplotlib_animations = (True, 'mp4')
+else:
+    sg_matplotlib_animations = True
+
 # The following import is only necessary to monkey patch the signature later on
 from sphinx_gallery import gen_rst
 
@@ -260,7 +265,7 @@ def _check_dependencies():
     'image_scrapers': (matplotlib_reduced_latex_scraper, ),
     'image_srcset': ["2x"],
     'junit': '../test-results/sphinx-gallery/junit.xml' if CIRCLECI else '',
-    'matplotlib_animations': True,
+    'matplotlib_animations': sg_matplotlib_animations,
     'min_reported_time': 1,
     'plot_gallery': 'True',  # sphinx-gallery/913
     'reference_url': {'matplotlib': None, 'mpl_toolkits': None},
diff --git a/requirements/doc/doc-requirements.txt b/requirements/doc/doc-requirements.txt
index 87bc483b15c0..ee74d02f7146 100644
--- a/requirements/doc/doc-requirements.txt
+++ b/requirements/doc/doc-requirements.txt
@@ -18,6 +18,7 @@ pydata-sphinx-theme~=0.15.0
 mpl-sphinx-theme~=3.9.0
 pyyaml
 sphinxcontrib-svg2pdfconverter>=1.1.0
+sphinxcontrib-video>=0.2.1
 sphinx-copybutton
 sphinx-design
 sphinx-gallery>=0.12.0

From 8a62afa5dd0fd8e9fa4d30f8960f38d882728212 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 8 Aug 2024 15:34:39 -0400
Subject: [PATCH 1069/1120] BLD: Include MSVCP140 runtime statically

This should prevent conflicts with other wheels that use the runtime at
a different version.
---
 .github/workflows/cibuildwheel.yml                | 10 +++++++++-
 doc/api/next_api_changes/development/28687-ES.rst | 10 ++++++++++
 2 files changed, 19 insertions(+), 1 deletion(-)
 create mode 100644 doc/api/next_api_changes/development/28687-ES.rst

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 4e8ea0ab5bf6..9de63b14c4fd 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -100,7 +100,15 @@ jobs:
       CIBW_AFTER_BUILD: >-
         twine check {wheel} &&
         python {package}/ci/check_wheel_licenses.py {wheel}
-      CIBW_CONFIG_SETTINGS: setup-args="--vsenv"
+      # On Windows, we explicitly request MSVC compilers (as GitHub Action runners have
+      # MinGW on PATH that would be picked otherwise), switch to a static build for
+      # runtimes, but use dynamic linking for `VCRUNTIME140.dll`, `VCRUNTIME140_1.dll`,
+      # and the UCRT. This avoids requiring specific versions of `MSVCP140.dll`, while
+      # keeping shared state with the rest of the Python process/extensions.
+      CIBW_CONFIG_SETTINGS_WINDOWS: >-
+        setup-args="--vsenv"
+        setup-args="-Db_vscrt=mt"
+        setup-args="-Dcpp_link_args=['ucrt.lib','vcruntime.lib','/nodefaultlib:libucrt.lib','/nodefaultlib:libvcruntime.lib']"
       CIBW_MANYLINUX_X86_64_IMAGE: manylinux2014
       CIBW_SKIP: "*-musllinux_aarch64"
       CIBW_TEST_COMMAND: >-
diff --git a/doc/api/next_api_changes/development/28687-ES.rst b/doc/api/next_api_changes/development/28687-ES.rst
new file mode 100644
index 000000000000..339dafdd05d0
--- /dev/null
+++ b/doc/api/next_api_changes/development/28687-ES.rst
@@ -0,0 +1,10 @@
+Windows wheel runtime bundling made static
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+In 3.7.0, the MSVC runtime DLL was bundled in wheels to enable importing Matplotlib on
+systems that do not have it installed. However, this could cause inconsistencies with
+other wheels that did the same, and trigger random crashes depending on import order. See
+`this issue <https://github.com/matplotlib/matplotlib/issues/28551>`_ for further
+details.
+
+Since 3.9.2, wheels now bundle the MSVC runtime DLL statically to avoid such issues.

From 056f307c1eaceb7615594e02b03336ec047ef02d Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Mon, 12 Aug 2024 19:25:14 -0400
Subject: [PATCH 1070/1120] DOC: Create release notes for 3.9.2

---
 .../api_changes_3.9.2.rst}                    |   6 +
 doc/users/github_stats.rst                    | 236 ++++++------------
 .../prev_whats_new/github_stats_3.9.1.rst     | 192 ++++++++++++++
 doc/users/release_notes.rst                   |   2 +
 4 files changed, 270 insertions(+), 166 deletions(-)
 rename doc/api/{next_api_changes/development/28687-ES.rst => prev_api_changes/api_changes_3.9.2.rst} (88%)
 create mode 100644 doc/users/prev_whats_new/github_stats_3.9.1.rst

diff --git a/doc/api/next_api_changes/development/28687-ES.rst b/doc/api/prev_api_changes/api_changes_3.9.2.rst
similarity index 88%
rename from doc/api/next_api_changes/development/28687-ES.rst
rename to doc/api/prev_api_changes/api_changes_3.9.2.rst
index 339dafdd05d0..4c2a69634502 100644
--- a/doc/api/next_api_changes/development/28687-ES.rst
+++ b/doc/api/prev_api_changes/api_changes_3.9.2.rst
@@ -1,3 +1,9 @@
+API Changes for 3.9.2
+=====================
+
+Development
+-----------
+
 Windows wheel runtime bundling made static
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/doc/users/github_stats.rst b/doc/users/github_stats.rst
index 0c8f29687afb..00c3e5d656a1 100644
--- a/doc/users/github_stats.rst
+++ b/doc/users/github_stats.rst
@@ -1,195 +1,99 @@
 .. _github-stats:
 
-GitHub statistics for 3.9.1 (Jul 04, 2024)
+GitHub statistics for 3.9.2 (Aug 12, 2024)
 ==========================================
 
-GitHub statistics for 2024/05/15 (tag: v3.9.0) - 2024/07/04
+GitHub statistics for 2024/07/04 (tag: v3.9.1) - 2024/08/12
 
 These lists are automatically generated, and may be incomplete or contain duplicates.
 
-We closed 30 issues and merged 111 pull requests.
-The full list can be seen `on GitHub <https://github.com/matplotlib/matplotlib/milestone/91?closed=1>`__
+We closed 9 issues and merged 45 pull requests.
+The full list can be seen `on GitHub <https://github.com/matplotlib/matplotlib/milestone/93?closed=1>`__
 
-The following 29 authors contributed 184 commits.
+The following 20 authors contributed 67 commits.
 
-* Antony Lee
-* Brigitta Sipőcz
-* Christian Mattsson
-* dale
+* Adam J. Stewart
+* Anthony Lee
+* Caitlin Hathaway
+* ClarkeAC
 * dependabot[bot]
 * Elliott Sales de Andrade
-* Eytan Adler
+* Filippo Balzaretti
 * Greg Lucas
-* haaris
 * hannah
 * Ian Thomas
-* Illviljan
-* K900
+* Jody Klymak
 * Kyle Sunden
-* Lumberbot (aka Jack)
-* malhar2460
-* Matthew Feickert
-* Melissa Weber Mendonça
-* MischaMegens2
 * Oscar Gustafsson
+* Randolf Scholz
+* Refael Ackermann
 * Ruth Comer
 * Scott Shambaugh
-* simond07
-* SjoerdB93
-* Takumasa N
-* Takumasa N.
-* Takumasa Nakamura
+* Sean Smith
 * Thomas A Caswell
 * Tim Hoffmann
 
 GitHub issues and pull requests:
 
-Pull Requests (111):
+Pull Requests (45):
 
-* :ghpull:`28507`: Backport PR #28430 on branch v3.9.x (Fix pickling of AxesWidgets.)
-* :ghpull:`28506`: Backport PR #28451 on branch v3.9.x (Fix GTK cairo backends)
-* :ghpull:`28430`: Fix pickling of AxesWidgets.
-* :ghpull:`25861`: Fix Hidpi scaling for GTK4Cairo
-* :ghpull:`28451`: Fix GTK cairo backends
-* :ghpull:`28499`: Backport PR #28498 on branch v3.9.x (Don't fail if we can't query system fonts on macOS)
-* :ghpull:`28498`: Don't fail if we can't query system fonts on macOS
-* :ghpull:`28491`: Backport PR #28487 on branch v3.9.x (Fix autoscaling with axhspan)
-* :ghpull:`28490`: Backport PR #28486 on branch v3.9.x (Fix CompositeGenericTransform.contains_branch_seperately)
-* :ghpull:`28487`: Fix autoscaling with axhspan
-* :ghpull:`28486`: Fix CompositeGenericTransform.contains_branch_seperately
-* :ghpull:`28483`: Backport PR #28393 on branch v3.9.x (Make sticky edges only apply if the sticky edge is the most extreme limit point)
-* :ghpull:`28482`: Backport PR #28473 on branch v3.9.x (Do not lowercase module:// backends)
-* :ghpull:`28393`: Make sticky edges only apply if the sticky edge is the most extreme limit point
-* :ghpull:`28473`: Do not lowercase module:// backends
-* :ghpull:`28480`: Backport PR #28474 on branch v3.9.x (Fix typing and docs for containers)
-* :ghpull:`28479`: Backport PR #28397 (FIX: stale root Figure when adding/updating subfigures)
-* :ghpull:`28474`: Fix typing and docs for containers
-* :ghpull:`28472`: Backport PR #28289 on branch v3.9.x (Promote mpltype Sphinx role to a public extension)
-* :ghpull:`28471`: Backport PR #28342 on branch v3.9.x (DOC: Document the parameter *position* of apply_aspect() as internal)
-* :ghpull:`28470`: Backport PR #28398 on branch v3.9.x (Add GIL Release to flush_events in macosx backend)
-* :ghpull:`28469`: Backport PR #28355 on branch v3.9.x (MNT: Re-add matplotlib.cm.get_cmap)
-* :ghpull:`28397`: FIX: stale root Figure when adding/updating subfigures
-* :ghpull:`28289`: Promote mpltype Sphinx role to a public extension
-* :ghpull:`28342`: DOC: Document the parameter *position* of apply_aspect() as internal
-* :ghpull:`28398`: Add GIL Release to flush_events in macosx backend
-* :ghpull:`28355`: MNT: Re-add matplotlib.cm.get_cmap
-* :ghpull:`28468`: Backport PR #28465 on branch v3.9.x (Fix pickling of SubFigures)
-* :ghpull:`28465`: Fix pickling of SubFigures
-* :ghpull:`28462`: Backport PR #28440 on branch v3.9.x (DOC: Add note about simplification of to_polygons)
-* :ghpull:`28460`: Backport PR #28459 on branch v3.9.x (DOC: Document kwargs scope for tick setter functions)
-* :ghpull:`28461`: Backport PR #28458 on branch v3.9.x (Correct numpy dtype comparisons in image_resample)
-* :ghpull:`28440`: DOC: Add note about simplification of to_polygons
-* :ghpull:`28458`: Correct numpy dtype comparisons in image_resample
-* :ghpull:`28459`: DOC: Document kwargs scope for tick setter functions
-* :ghpull:`28450`: Backport of 28371 and 28411
-* :ghpull:`28446`: Backport PR #28403 on branch v3.9.x (FIX: Autoscale support in add_collection3d for Line3DCollection and Poly3DCollection
-* :ghpull:`28445`: Backport PR #28403 on branch v3.9.x (FIX: Autoscale support in add_collection3d for Line3DCollection and Poly3DCollection)
-* :ghpull:`28438`: Backport PR #28436 on branch v3.9.x (Fix ``is_color_like`` for 2-tuple of strings and fix ``to_rgba`` for ``(nth_color, alpha)``)
-* :ghpull:`28403`: FIX: Autoscale support in add_collection3d for Line3DCollection and Poly3DCollection
-* :ghpull:`28443`: Backport PR #28441 on branch v3.9.x (MNT: Update basic units example to work with numpy 2.0)
-* :ghpull:`28441`: MNT: Update basic units example to work with numpy 2.0
-* :ghpull:`28436`: Fix ``is_color_like`` for 2-tuple of strings and fix ``to_rgba`` for ``(nth_color, alpha)``
-* :ghpull:`28426`: Backport PR #28425 on branch v3.9.x (Fix Circle yaml line length)
-* :ghpull:`28427`: Fix circleci yaml
-* :ghpull:`28425`: Fix Circle yaml line length
-* :ghpull:`28422`: Backport PR #28401 on branch v3.9.x (FIX: Fix text wrapping)
-* :ghpull:`28424`: Backport PR #28423 on branch v3.9.x (Update return type for Axes.axhspan and Axes.axvspan)
-* :ghpull:`28423`: Update return type for Axes.axhspan and Axes.axvspan
-* :ghpull:`28401`: FIX: Fix text wrapping
-* :ghpull:`28419`: Backport PR #28414 on branch v3.9.x (Clean up obsolete widget code)
-* :ghpull:`28411`: Bump the actions group with 3 updates
-* :ghpull:`28414`: Clean up obsolete widget code
-* :ghpull:`28415`: Backport PR #28413 on branch v3.9.x (CI: update action that got moved org)
-* :ghpull:`28413`: CI: update action that got moved org
-* :ghpull:`28392`: Backport PR #28388 on branch v3.9.x (Allow duplicate (name, value) entry points for backends)
-* :ghpull:`28362`: Backport PR #28337 on branch v3.9.x (Bump the actions group across 1 directory with 3 updates)
-* :ghpull:`28388`: Allow duplicate (name, value) entry points for backends
-* :ghpull:`28389`: Backport PR #28380 on branch v3.9.x (Remove outdated docstring section in RendererBase.draw_text.)
-* :ghpull:`28380`: Remove outdated docstring section in RendererBase.draw_text.
-* :ghpull:`28385`: Backport PR #28377 on branch v3.9.x (DOC: Clarify scope of wrap.)
-* :ghpull:`28377`: DOC: Clarify scope of wrap.
-* :ghpull:`28368`: Backport PR #28359 on branch v3.9.x (Document that axes unsharing is impossible.)
-* :ghpull:`28359`: Document that axes unsharing is impossible.
-* :ghpull:`28337`: Bump the actions group across 1 directory with 3 updates
-* :ghpull:`28351`: Backport PR #28307 on branch v3.9.x (DOC: New color line by value example)
-* :ghpull:`28307`: DOC: New color line by value example
-* :ghpull:`28339`: Backport PR #28336 on branch v3.9.x (DOC: Add version warning banner for docs versions different from stable)
-* :ghpull:`28336`: DOC: Add version warning banner for docs versions different from stable
-* :ghpull:`28334`: Backport PR #28332 on branch v3.9.x (Call IPython.enable_gui when install repl displayhook)
-* :ghpull:`28332`: Call IPython.enable_gui when install repl displayhook
-* :ghpull:`28331`: Backport PR #28329 on branch v3.9.x (DOC: Add example for 3D intersecting planes)
-* :ghpull:`28329`: DOC: Add example for 3D intersecting planes
-* :ghpull:`28327`: Backport PR #28292 on branch v3.9.x (Resolve MaxNLocator IndexError when no large steps)
-* :ghpull:`28292`: Resolve MaxNLocator IndexError when no large steps
-* :ghpull:`28326`: Backport PR #28041 on branch v3.9.x ([BUG]: Shift box_aspect according to vertical_axis)
-* :ghpull:`28041`: [BUG]: Shift box_aspect according to vertical_axis
-* :ghpull:`28320`: Backport PR #27001 on branch v3.9.x ([TYP] Add overload of ``pyplot.subplots``)
-* :ghpull:`27001`: [TYP] Add overload of ``pyplot.subplots``
-* :ghpull:`28318`: Backport PR #28273 on branch v3.9.x (CI: Add GitHub artifact attestations to package distribution)
-* :ghpull:`28273`: CI: Add GitHub artifact attestations to package distribution
-* :ghpull:`28305`: Backport PR #28303 on branch v3.9.x (Removed drawedges repeated definition from function doc string)
-* :ghpull:`28303`: Removed drawedges repeated definition from function doc string
-* :ghpull:`28299`: Backport PR #28297 on branch v3.9.x (Solved #28296 Added missing comma)
-* :ghpull:`28297`: Solved #28296 Added missing comma
-* :ghpull:`28294`: Backport PR #28261 on branch v3.9.x (Correct roll angle units, issue #28256)
-* :ghpull:`28261`: Correct roll angle units, issue #28256
-* :ghpull:`28283`: Backport PR #28280 on branch v3.9.x (DOC: Add an example for 2D images in 3D plots)
-* :ghpull:`28280`: DOC: Add an example for 2D images in 3D plots
-* :ghpull:`28278`: Backport PR #28272 on branch v3.9.x (BLD: Move macos builders from 11 to 12)
-* :ghpull:`28277`: Backport PR #28274 on branch v3.9.x (ci: Remove deprecated codeql option)
-* :ghpull:`28272`: BLD: Move macos builders from 11 to 12
-* :ghpull:`28274`: ci: Remove deprecated codeql option
-* :ghpull:`28270`: Backport PR #28269 on branch v3.9.x (Handle GetForegroundWindow() returning NULL.)
-* :ghpull:`28269`: Handle GetForegroundWindow() returning NULL.
-* :ghpull:`28266`: Backport PR #28257 on branch v3.9.x (Clean up some Meson-related leftovers)
-* :ghpull:`28257`: Clean up some Meson-related leftovers
-* :ghpull:`28255`: Backport PR #28254 on branch v3.9.x ([DOC] plot type heading consistency)
-* :ghpull:`28254`: [DOC] plot type heading consistency
-* :ghpull:`28253`: Backport PR #28252 on branch v3.9.x (DOC: Flip the imshow plot types example to match the other examples)
-* :ghpull:`28252`: DOC: Flip the imshow plot types example to match the other examples
-* :ghpull:`28247`: Backport PR #28230 on branch v3.9.x (Add extra imports to improve typing)
-* :ghpull:`28230`: Add extra imports to improve typing
-* :ghpull:`28246`: Backport PR #28243 on branch v3.9.x (DOC: Add more 3D plot types)
-* :ghpull:`28243`: DOC: Add more 3D plot types
-* :ghpull:`28241`: Backport PR #28219 on branch v3.9.x (Bump the actions group with 2 updates)
-* :ghpull:`28219`: Bump the actions group with 2 updates
-* :ghpull:`28237`: Backport PR #28233 on branch v3.9.x (CI: Fix font install on macOS/Homebrew)
-* :ghpull:`28236`: Backport PR #28231 on branch v3.9.x (DOC: we do not need the blit call in on_draw)
-* :ghpull:`28233`: CI: Fix font install on macOS/Homebrew
-* :ghpull:`28231`: DOC: we do not need the blit call in on_draw
+* :ghpull:`28687`: BLD: Include MSVCP140 runtime statically
+* :ghpull:`28679`: Run delvewheel with path to required msvcp140.dll
+* :ghpull:`28695`: Backport PR #27797 on branch v3.9.x (DOC: Use video files for saving animations)
+* :ghpull:`28688`: Backport PR #28293 and #28668: Enable 3.13 wheels and bump cibuildwheel
+* :ghpull:`27797`: DOC: Use video files for saving animations
+* :ghpull:`28692`: Backport PR #28632 on branch v3.9.x (DOC: Tell sphinx-gallery to link mpl_toolkits from our build)
+* :ghpull:`28632`: DOC: Tell sphinx-gallery to link mpl_toolkits from our build
+* :ghpull:`28668`: Bump the actions group with 2 updates
+* :ghpull:`28686`: Backport PR #28682 on branch v3.9.x (Fix warnings from mingw compilers)
+* :ghpull:`28682`: Fix warnings from mingw compilers
+* :ghpull:`28676`: Backport PR #28577 on branch v3.9.x (Copy all internals from initial Tick to lazy ones)
+* :ghpull:`28577`: Copy all internals from initial Tick to lazy ones
+* :ghpull:`28674`: Backport PR #28650 on branch v3.9.x (remove out of date todos on animation.py)
+* :ghpull:`28650`: remove out of date todos on animation.py
+* :ghpull:`28656`: Backport PR #28649 on branch v3.9.x (FIX: improve formatting of image values in cases of singular norms)
+* :ghpull:`28665`: Backport PR #28546 on branch v3.9.x (DOC: Clarify/simplify example of multiple images with one colorbar)
+* :ghpull:`28649`: FIX: improve formatting of image values in cases of singular norms
+* :ghpull:`28635`: BLD: windows wheels
+* :ghpull:`28645`: Backport PR #28644 on branch v3.9.x (DOC: Fix matching for version switcher)
+* :ghpull:`28640`: Backport PR #28634 on branch v3.9.x (Closed open div tag in color.ColorMap._repr_html_)
+* :ghpull:`28634`: Closed open div tag in color.ColorMap._repr_html_
+* :ghpull:`28636`: Backport PR #28625 on branch v3.9.x (added typing_extensions.Self to _AxesBase.twinx)
+* :ghpull:`28625`: added typing_extensions.Self to _AxesBase.twinx
+* :ghpull:`28622`: Backport PR #28621 on branch v3.9.x (TYP: Fix a typo in animation.pyi)
+* :ghpull:`28621`: TYP: Fix a typo in animation.pyi
+* :ghpull:`28605`: Backport PR #28604 on branch v3.9.x (cycler signature update.)
+* :ghpull:`28604`: cycler signature update.
+* :ghpull:`28598`: Pin PyQt6 back on Ubuntu 20.04
+* :ghpull:`28596`: Backport PR #28518 on branch v3.9.x ([TYP] Fix overload of ``pyplot.subplots``)
+* :ghpull:`28518`: [TYP] Fix overload of ``pyplot.subplots``
+* :ghpull:`28591`: Backport PR #28580 on branch v3.9.x (Bump actions/attest-build-provenance from 1.3.2 to 1.3.3 in the actions group)
+* :ghpull:`28580`: Bump actions/attest-build-provenance from 1.3.2 to 1.3.3 in the actions group
+* :ghpull:`28586`: Backport PR #28582 on branch v3.9.x (FIX: make sticky edge tolerance relative to data range)
+* :ghpull:`28582`: FIX: make sticky edge tolerance relative to data range
+* :ghpull:`28572`: Backport PR #28571 on branch v3.9.x (DOC: Add version directive to hatch parameter in stackplot)
+* :ghpull:`28571`: DOC: Add version directive to hatch parameter in stackplot
+* :ghpull:`28564`: Backport PR #28534 on branch v3.9.x ([BLD] Fix WSL build warning)
+* :ghpull:`28563`: Backport PR #28526 on branch v3.9.x (Bump pypa/cibuildwheel from 2.19.1 to 2.19.2 in the actions group)
+* :ghpull:`28534`: [BLD] Fix WSL build warning
+* :ghpull:`28526`: Bump pypa/cibuildwheel from 2.19.1 to 2.19.2 in the actions group
+* :ghpull:`28552`: Backport PR #28541 on branch v3.9.x (MNT: be more careful about disk I/O failures when writing font cache)
+* :ghpull:`28541`: MNT: be more careful about disk I/O failures when writing font cache
+* :ghpull:`28524`: Backport PR #28523 on branch v3.9.x (Fix value error when set widget size to zero while using FigureCanvasQT )
+* :ghpull:`28523`: Fix value error when set widget size to zero while using FigureCanvasQT
+* :ghpull:`28519`: Backport PR #28517 on branch v3.9.x (DOC: better cross referencing for animations)
 
-Issues (30):
+Issues (9):
 
-* :ghissue:`22482`: [ENH]:  pickle (or save) matplotlib figure with insteractive slider
-* :ghissue:`25847`: [Bug]: Graph gets cut off with scaled resolution using gtk4cairo backend
-* :ghissue:`28341`: [Bug]: Incorrect X-axis scaling with date values
-* :ghissue:`28383`: [Bug]: axvspan no longer participating in limit calculations
-* :ghissue:`28223`: [Bug]: Inconsistent Visualization of Intervals in ax.barh for Different Duration Widths
-* :ghissue:`28432`: [Bug]: Backend name specified as module gets lowercased since 3.9
-* :ghissue:`28467`: [Bug]: Incorrect type stub for ``ErrorbarContainer``'s ``lines`` attribute.
-* :ghissue:`28384`: [Bug]: subfigure artists not drawn interactively
-* :ghissue:`28234`: [Bug]: mpltype custom role breaks sphinx build for third-party projects that have intersphinx links to matplotlib
-* :ghissue:`28464`: [Bug]: figure with subfigures cannot be pickled
-* :ghissue:`28448`: [Bug]: Making an RGB image from pickled data throws error
-* :ghissue:`23317`: [Bug]: ``add_collection3d`` does not update view limits
-* :ghissue:`17130`: autoscale_view is not working with Line3DCollection
-* :ghissue:`28434`: [Bug]: Setting exactly 2 colors with tuple in ``plot`` method gives confusing error
-* :ghissue:`28417`: [Doc]: axhspan and axvspan now return Rectangles, not Polygons.
-* :ghissue:`28378`: [ENH]: Switch text wrapping boundary to subfigure
-* :ghissue:`28404`: [Doc]: matplotlib.widgets.CheckButtons no longer has .rectangles attribute, needs removed.
-* :ghissue:`28367`: [Bug]: Backend entry points can be erroneously duplicated
-* :ghissue:`28358`: [Bug]: Labels don't get wrapped when set_yticks() is used in subplots
-* :ghissue:`28374`: [Bug]: rcParam ``tk.window_focus: True`` is causes crash on Linux in version 3.9.0.
-* :ghissue:`28324`: [Bug]: show(block=False) freezes
-* :ghissue:`28239`: [Doc]: Gallery example showing 3D slice planes
-* :ghissue:`27603`: [Bug]: _raw_ticker() istep
-* :ghissue:`24328`: [Bug]: class Axes3D.set_box_aspect() sets wrong aspect ratios when Axes3D.view_init( vertical_axis='y') is enabled.
-* :ghissue:`28221`: [Doc]: drawedges attribute described twice in matplotlib.colorbar documentation
-* :ghissue:`28296`: [Doc]: Missing comma
-* :ghissue:`28256`: [Bug]: axes3d.py's _on_move() converts the roll angle to radians, but then passes it to view_init() as if it were still in degrees
-* :ghissue:`28267`: [Bug]: for Python 3.11.9 gor error  ValueError: PyCapsule_New called with null pointer
-* :ghissue:`28022`: [Bug]: Type of Axes is unknown pyright
-* :ghissue:`28002`: Segfault from path editor example with QtAgg
+* :ghissue:`28551`: [Bug]: Possible issue with Matplotlib 3.9.1 wheel on Windows only
+* :ghissue:`28250`: [Doc]: Sphinx gallery links mispointed for Axes3D methods
+* :ghissue:`28574`: [Bug]: Nondeterministic behavior with subplot spacing and constrained layout
+* :ghissue:`28626`: [Doc]: Remove old TODO's from animation.py
+* :ghissue:`28648`: [Bug]: format_image_data on an image of only zeros produses a large number of zeros
+* :ghissue:`28624`: [Bug]: Bad type hint in ``_AxesBase.twinx()``
+* :ghissue:`28567`: [Bug]: sticky edge related changes for datetime plots
+* :ghissue:`28533`: [Doc]: Stackplot hatch functionality has version dependencies
+* :ghissue:`28538`: [Bug]: Permission denied when importing matplotlib.pyplot
 
 
 Previous GitHub statistics
diff --git a/doc/users/prev_whats_new/github_stats_3.9.1.rst b/doc/users/prev_whats_new/github_stats_3.9.1.rst
new file mode 100644
index 000000000000..1bd7860546cb
--- /dev/null
+++ b/doc/users/prev_whats_new/github_stats_3.9.1.rst
@@ -0,0 +1,192 @@
+.. _github-stats-3-9-1:
+
+GitHub statistics for 3.9.1 (Jul 04, 2024)
+==========================================
+
+GitHub statistics for 2024/05/15 (tag: v3.9.0) - 2024/07/04
+
+These lists are automatically generated, and may be incomplete or contain duplicates.
+
+We closed 30 issues and merged 111 pull requests.
+The full list can be seen `on GitHub <https://github.com/matplotlib/matplotlib/milestone/91?closed=1>`__
+
+The following 29 authors contributed 184 commits.
+
+* Antony Lee
+* Brigitta Sipőcz
+* Christian Mattsson
+* dale
+* dependabot[bot]
+* Elliott Sales de Andrade
+* Eytan Adler
+* Greg Lucas
+* haaris
+* hannah
+* Ian Thomas
+* Illviljan
+* K900
+* Kyle Sunden
+* Lumberbot (aka Jack)
+* malhar2460
+* Matthew Feickert
+* Melissa Weber Mendonça
+* MischaMegens2
+* Oscar Gustafsson
+* Ruth Comer
+* Scott Shambaugh
+* simond07
+* SjoerdB93
+* Takumasa N
+* Takumasa N.
+* Takumasa Nakamura
+* Thomas A Caswell
+* Tim Hoffmann
+
+GitHub issues and pull requests:
+
+Pull Requests (111):
+
+* :ghpull:`28507`: Backport PR #28430 on branch v3.9.x (Fix pickling of AxesWidgets.)
+* :ghpull:`28506`: Backport PR #28451 on branch v3.9.x (Fix GTK cairo backends)
+* :ghpull:`28430`: Fix pickling of AxesWidgets.
+* :ghpull:`25861`: Fix Hidpi scaling for GTK4Cairo
+* :ghpull:`28451`: Fix GTK cairo backends
+* :ghpull:`28499`: Backport PR #28498 on branch v3.9.x (Don't fail if we can't query system fonts on macOS)
+* :ghpull:`28498`: Don't fail if we can't query system fonts on macOS
+* :ghpull:`28491`: Backport PR #28487 on branch v3.9.x (Fix autoscaling with axhspan)
+* :ghpull:`28490`: Backport PR #28486 on branch v3.9.x (Fix CompositeGenericTransform.contains_branch_seperately)
+* :ghpull:`28487`: Fix autoscaling with axhspan
+* :ghpull:`28486`: Fix CompositeGenericTransform.contains_branch_seperately
+* :ghpull:`28483`: Backport PR #28393 on branch v3.9.x (Make sticky edges only apply if the sticky edge is the most extreme limit point)
+* :ghpull:`28482`: Backport PR #28473 on branch v3.9.x (Do not lowercase module:// backends)
+* :ghpull:`28393`: Make sticky edges only apply if the sticky edge is the most extreme limit point
+* :ghpull:`28473`: Do not lowercase module:// backends
+* :ghpull:`28480`: Backport PR #28474 on branch v3.9.x (Fix typing and docs for containers)
+* :ghpull:`28479`: Backport PR #28397 (FIX: stale root Figure when adding/updating subfigures)
+* :ghpull:`28474`: Fix typing and docs for containers
+* :ghpull:`28472`: Backport PR #28289 on branch v3.9.x (Promote mpltype Sphinx role to a public extension)
+* :ghpull:`28471`: Backport PR #28342 on branch v3.9.x (DOC: Document the parameter *position* of apply_aspect() as internal)
+* :ghpull:`28470`: Backport PR #28398 on branch v3.9.x (Add GIL Release to flush_events in macosx backend)
+* :ghpull:`28469`: Backport PR #28355 on branch v3.9.x (MNT: Re-add matplotlib.cm.get_cmap)
+* :ghpull:`28397`: FIX: stale root Figure when adding/updating subfigures
+* :ghpull:`28289`: Promote mpltype Sphinx role to a public extension
+* :ghpull:`28342`: DOC: Document the parameter *position* of apply_aspect() as internal
+* :ghpull:`28398`: Add GIL Release to flush_events in macosx backend
+* :ghpull:`28355`: MNT: Re-add matplotlib.cm.get_cmap
+* :ghpull:`28468`: Backport PR #28465 on branch v3.9.x (Fix pickling of SubFigures)
+* :ghpull:`28465`: Fix pickling of SubFigures
+* :ghpull:`28462`: Backport PR #28440 on branch v3.9.x (DOC: Add note about simplification of to_polygons)
+* :ghpull:`28460`: Backport PR #28459 on branch v3.9.x (DOC: Document kwargs scope for tick setter functions)
+* :ghpull:`28461`: Backport PR #28458 on branch v3.9.x (Correct numpy dtype comparisons in image_resample)
+* :ghpull:`28440`: DOC: Add note about simplification of to_polygons
+* :ghpull:`28458`: Correct numpy dtype comparisons in image_resample
+* :ghpull:`28459`: DOC: Document kwargs scope for tick setter functions
+* :ghpull:`28450`: Backport of 28371 and 28411
+* :ghpull:`28446`: Backport PR #28403 on branch v3.9.x (FIX: Autoscale support in add_collection3d for Line3DCollection and Poly3DCollection
+* :ghpull:`28445`: Backport PR #28403 on branch v3.9.x (FIX: Autoscale support in add_collection3d for Line3DCollection and Poly3DCollection)
+* :ghpull:`28438`: Backport PR #28436 on branch v3.9.x (Fix ``is_color_like`` for 2-tuple of strings and fix ``to_rgba`` for ``(nth_color, alpha)``)
+* :ghpull:`28403`: FIX: Autoscale support in add_collection3d for Line3DCollection and Poly3DCollection
+* :ghpull:`28443`: Backport PR #28441 on branch v3.9.x (MNT: Update basic units example to work with numpy 2.0)
+* :ghpull:`28441`: MNT: Update basic units example to work with numpy 2.0
+* :ghpull:`28436`: Fix ``is_color_like`` for 2-tuple of strings and fix ``to_rgba`` for ``(nth_color, alpha)``
+* :ghpull:`28426`: Backport PR #28425 on branch v3.9.x (Fix Circle yaml line length)
+* :ghpull:`28427`: Fix circleci yaml
+* :ghpull:`28425`: Fix Circle yaml line length
+* :ghpull:`28422`: Backport PR #28401 on branch v3.9.x (FIX: Fix text wrapping)
+* :ghpull:`28424`: Backport PR #28423 on branch v3.9.x (Update return type for Axes.axhspan and Axes.axvspan)
+* :ghpull:`28423`: Update return type for Axes.axhspan and Axes.axvspan
+* :ghpull:`28401`: FIX: Fix text wrapping
+* :ghpull:`28419`: Backport PR #28414 on branch v3.9.x (Clean up obsolete widget code)
+* :ghpull:`28411`: Bump the actions group with 3 updates
+* :ghpull:`28414`: Clean up obsolete widget code
+* :ghpull:`28415`: Backport PR #28413 on branch v3.9.x (CI: update action that got moved org)
+* :ghpull:`28413`: CI: update action that got moved org
+* :ghpull:`28392`: Backport PR #28388 on branch v3.9.x (Allow duplicate (name, value) entry points for backends)
+* :ghpull:`28362`: Backport PR #28337 on branch v3.9.x (Bump the actions group across 1 directory with 3 updates)
+* :ghpull:`28388`: Allow duplicate (name, value) entry points for backends
+* :ghpull:`28389`: Backport PR #28380 on branch v3.9.x (Remove outdated docstring section in RendererBase.draw_text.)
+* :ghpull:`28380`: Remove outdated docstring section in RendererBase.draw_text.
+* :ghpull:`28385`: Backport PR #28377 on branch v3.9.x (DOC: Clarify scope of wrap.)
+* :ghpull:`28377`: DOC: Clarify scope of wrap.
+* :ghpull:`28368`: Backport PR #28359 on branch v3.9.x (Document that axes unsharing is impossible.)
+* :ghpull:`28359`: Document that axes unsharing is impossible.
+* :ghpull:`28337`: Bump the actions group across 1 directory with 3 updates
+* :ghpull:`28351`: Backport PR #28307 on branch v3.9.x (DOC: New color line by value example)
+* :ghpull:`28307`: DOC: New color line by value example
+* :ghpull:`28339`: Backport PR #28336 on branch v3.9.x (DOC: Add version warning banner for docs versions different from stable)
+* :ghpull:`28336`: DOC: Add version warning banner for docs versions different from stable
+* :ghpull:`28334`: Backport PR #28332 on branch v3.9.x (Call IPython.enable_gui when install repl displayhook)
+* :ghpull:`28332`: Call IPython.enable_gui when install repl displayhook
+* :ghpull:`28331`: Backport PR #28329 on branch v3.9.x (DOC: Add example for 3D intersecting planes)
+* :ghpull:`28329`: DOC: Add example for 3D intersecting planes
+* :ghpull:`28327`: Backport PR #28292 on branch v3.9.x (Resolve MaxNLocator IndexError when no large steps)
+* :ghpull:`28292`: Resolve MaxNLocator IndexError when no large steps
+* :ghpull:`28326`: Backport PR #28041 on branch v3.9.x ([BUG]: Shift box_aspect according to vertical_axis)
+* :ghpull:`28041`: [BUG]: Shift box_aspect according to vertical_axis
+* :ghpull:`28320`: Backport PR #27001 on branch v3.9.x ([TYP] Add overload of ``pyplot.subplots``)
+* :ghpull:`27001`: [TYP] Add overload of ``pyplot.subplots``
+* :ghpull:`28318`: Backport PR #28273 on branch v3.9.x (CI: Add GitHub artifact attestations to package distribution)
+* :ghpull:`28273`: CI: Add GitHub artifact attestations to package distribution
+* :ghpull:`28305`: Backport PR #28303 on branch v3.9.x (Removed drawedges repeated definition from function doc string)
+* :ghpull:`28303`: Removed drawedges repeated definition from function doc string
+* :ghpull:`28299`: Backport PR #28297 on branch v3.9.x (Solved #28296 Added missing comma)
+* :ghpull:`28297`: Solved #28296 Added missing comma
+* :ghpull:`28294`: Backport PR #28261 on branch v3.9.x (Correct roll angle units, issue #28256)
+* :ghpull:`28261`: Correct roll angle units, issue #28256
+* :ghpull:`28283`: Backport PR #28280 on branch v3.9.x (DOC: Add an example for 2D images in 3D plots)
+* :ghpull:`28280`: DOC: Add an example for 2D images in 3D plots
+* :ghpull:`28278`: Backport PR #28272 on branch v3.9.x (BLD: Move macos builders from 11 to 12)
+* :ghpull:`28277`: Backport PR #28274 on branch v3.9.x (ci: Remove deprecated codeql option)
+* :ghpull:`28272`: BLD: Move macos builders from 11 to 12
+* :ghpull:`28274`: ci: Remove deprecated codeql option
+* :ghpull:`28270`: Backport PR #28269 on branch v3.9.x (Handle GetForegroundWindow() returning NULL.)
+* :ghpull:`28269`: Handle GetForegroundWindow() returning NULL.
+* :ghpull:`28266`: Backport PR #28257 on branch v3.9.x (Clean up some Meson-related leftovers)
+* :ghpull:`28257`: Clean up some Meson-related leftovers
+* :ghpull:`28255`: Backport PR #28254 on branch v3.9.x ([DOC] plot type heading consistency)
+* :ghpull:`28254`: [DOC] plot type heading consistency
+* :ghpull:`28253`: Backport PR #28252 on branch v3.9.x (DOC: Flip the imshow plot types example to match the other examples)
+* :ghpull:`28252`: DOC: Flip the imshow plot types example to match the other examples
+* :ghpull:`28247`: Backport PR #28230 on branch v3.9.x (Add extra imports to improve typing)
+* :ghpull:`28230`: Add extra imports to improve typing
+* :ghpull:`28246`: Backport PR #28243 on branch v3.9.x (DOC: Add more 3D plot types)
+* :ghpull:`28243`: DOC: Add more 3D plot types
+* :ghpull:`28241`: Backport PR #28219 on branch v3.9.x (Bump the actions group with 2 updates)
+* :ghpull:`28219`: Bump the actions group with 2 updates
+* :ghpull:`28237`: Backport PR #28233 on branch v3.9.x (CI: Fix font install on macOS/Homebrew)
+* :ghpull:`28236`: Backport PR #28231 on branch v3.9.x (DOC: we do not need the blit call in on_draw)
+* :ghpull:`28233`: CI: Fix font install on macOS/Homebrew
+* :ghpull:`28231`: DOC: we do not need the blit call in on_draw
+
+Issues (30):
+
+* :ghissue:`22482`: [ENH]: pickle (or save) matplotlib figure with insteractive slider
+* :ghissue:`25847`: [Bug]: Graph gets cut off with scaled resolution using gtk4cairo backend
+* :ghissue:`28341`: [Bug]: Incorrect X-axis scaling with date values
+* :ghissue:`28383`: [Bug]: axvspan no longer participating in limit calculations
+* :ghissue:`28223`: [Bug]: Inconsistent Visualization of Intervals in ax.barh for Different Duration Widths
+* :ghissue:`28432`: [Bug]: Backend name specified as module gets lowercased since 3.9
+* :ghissue:`28467`: [Bug]: Incorrect type stub for ``ErrorbarContainer``'s ``lines`` attribute.
+* :ghissue:`28384`: [Bug]: subfigure artists not drawn interactively
+* :ghissue:`28234`: [Bug]: mpltype custom role breaks sphinx build for third-party projects that have intersphinx links to matplotlib
+* :ghissue:`28464`: [Bug]: figure with subfigures cannot be pickled
+* :ghissue:`28448`: [Bug]: Making an RGB image from pickled data throws error
+* :ghissue:`23317`: [Bug]: ``add_collection3d`` does not update view limits
+* :ghissue:`17130`: autoscale_view is not working with Line3DCollection
+* :ghissue:`28434`: [Bug]: Setting exactly 2 colors with tuple in ``plot`` method gives confusing error
+* :ghissue:`28417`: [Doc]: axhspan and axvspan now return Rectangles, not Polygons.
+* :ghissue:`28378`: [ENH]: Switch text wrapping boundary to subfigure
+* :ghissue:`28404`: [Doc]: matplotlib.widgets.CheckButtons no longer has .rectangles attribute, needs removed.
+* :ghissue:`28367`: [Bug]: Backend entry points can be erroneously duplicated
+* :ghissue:`28358`: [Bug]: Labels don't get wrapped when set_yticks() is used in subplots
+* :ghissue:`28374`: [Bug]: rcParam ``tk.window_focus: True`` is causes crash on Linux in version 3.9.0.
+* :ghissue:`28324`: [Bug]: show(block=False) freezes
+* :ghissue:`28239`: [Doc]: Gallery example showing 3D slice planes
+* :ghissue:`27603`: [Bug]: _raw_ticker() istep
+* :ghissue:`24328`: [Bug]: class Axes3D.set_box_aspect() sets wrong aspect ratios when Axes3D.view_init( vertical_axis='y') is enabled.
+* :ghissue:`28221`: [Doc]: drawedges attribute described twice in matplotlib.colorbar documentation
+* :ghissue:`28296`: [Doc]: Missing comma
+* :ghissue:`28256`: [Bug]: axes3d.py's _on_move() converts the roll angle to radians, but then passes it to view_init() as if it were still in degrees
+* :ghissue:`28267`: [Bug]: for Python 3.11.9 gor ValueError: PyCapsule_New called with null pointer
+* :ghissue:`28022`: [Bug]: Type of Axes is unknown pyright
+* :ghissue:`28002`: Segfault from path editor example with QtAgg
diff --git a/doc/users/release_notes.rst b/doc/users/release_notes.rst
index 1204450f6c05..74bc0f13bf1f 100644
--- a/doc/users/release_notes.rst
+++ b/doc/users/release_notes.rst
@@ -19,9 +19,11 @@ Version 3.9
     :maxdepth: 1
 
     prev_whats_new/whats_new_3.9.0.rst
+    ../api/prev_api_changes/api_changes_3.9.2.rst
     ../api/prev_api_changes/api_changes_3.9.1.rst
     ../api/prev_api_changes/api_changes_3.9.0.rst
     github_stats.rst
+    prev_whats_new/github_stats_3.9.1.rst
     prev_whats_new/github_stats_3.9.0.rst
 
 Version 3.8

From a254b687df97cda8c6affa37a1dfcf213f8e6c3a Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Mon, 12 Aug 2024 19:35:24 -0400
Subject: [PATCH 1071/1120] REL: 3.9.2

This is the second bugfix release of the 3.9.x series.

This release contains several bug-fixes and adjustments:

- Be more resilient to I/O failures when writing font cache
- Fix nondeterministic behavior with subplot spacing and constrained layout
- Fix sticky edge tolerance relative to data range
- Improve formatting of image values in cases of singular norms

Windows wheels now bundle the MSVC runtime DLL statically to avoid
inconsistencies with other wheels and random crashes depending on import
order.

From 4b30b1d938b1ccad1e96b35ec11292e9fb8f05fd Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Mon, 12 Aug 2024 19:52:20 -0400
Subject: [PATCH 1072/1120] BLD: bump branch away from tag

So the tarballs from GitHub are stable.

From 3aea791026cabe9b9bdaba6d9a23c122bbf04115 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Mon, 12 Aug 2024 20:13:22 -0400
Subject: [PATCH 1073/1120] DOC: Add Zenodo DOI for 3.9.2

---
 doc/_static/zenodo_cache/13308876.svg | 35 +++++++++++++++++++++++++++
 doc/project/citing.rst                |  3 +++
 tools/cache_zenodo_svg.py             |  1 +
 3 files changed, 39 insertions(+)
 create mode 100644 doc/_static/zenodo_cache/13308876.svg

diff --git a/doc/_static/zenodo_cache/13308876.svg b/doc/_static/zenodo_cache/13308876.svg
new file mode 100644
index 000000000000..749bc3c19026
--- /dev/null
+++ b/doc/_static/zenodo_cache/13308876.svg
@@ -0,0 +1,35 @@
+<svg xmlns="http://www.w3.org/2000/svg"
+     width="190.84375" height="20">
+        <linearGradient id="b" x2="0" y2="100%">
+            <stop offset="0" stop-color="#bbb" stop-opacity=".1"/>
+            <stop offset="1" stop-opacity=".1"/>
+        </linearGradient>
+        <mask id="a" width="190.84375" height="20">
+            <rect width="190.84375" height="20" rx="3"
+            fill="#fff"/>
+        </mask>
+        <g mask="url(#a)">
+            <path fill="#555" d="M0 0h31.375v20H0z" />
+            <path fill="#007ec6"
+            d="M31.375 0h159.46875v20H31.375z"
+            />
+            <path fill="url(#b)" d="M0 0h190.84375v20H0z" />
+        </g>
+        <g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,
+        Verdana,Geneva,sans-serif" font-size="11">
+            <text x="16.1875" y="15" fill="#010101"
+            fill-opacity=".3">
+                DOI
+            </text>
+            <text x="16.1875" y="14">
+                DOI
+            </text>
+            <text x="110.609375"
+            y="15" fill="#010101" fill-opacity=".3">
+                10.5281/zenodo.13308876
+            </text>
+            <text x="110.609375" y="14">
+                10.5281/zenodo.13308876
+            </text>
+        </g>
+    </svg>
\ No newline at end of file
diff --git a/doc/project/citing.rst b/doc/project/citing.rst
index e0b99995ad11..38c989fca195 100644
--- a/doc/project/citing.rst
+++ b/doc/project/citing.rst
@@ -32,6 +32,9 @@ By version
 .. START OF AUTOGENERATED
 
 
+v3.9.2
+   .. image:: ../_static/zenodo_cache/13308876.svg
+      :target:  https://doi.org/10.5281/zenodo.13308876
 v3.9.1
    .. image:: ../_static/zenodo_cache/12652732.svg
       :target:  https://doi.org/10.5281/zenodo.12652732
diff --git a/tools/cache_zenodo_svg.py b/tools/cache_zenodo_svg.py
index 1dc2fbba020b..40814d21573c 100644
--- a/tools/cache_zenodo_svg.py
+++ b/tools/cache_zenodo_svg.py
@@ -63,6 +63,7 @@ def _get_xdg_cache_dir():
 
 if __name__ == "__main__":
     data = {
+        "v3.9.2": "13308876",
         "v3.9.1": "12652732",
         "v3.9.0": "11201097",
         "v3.8.4": "10916799",

From d04b2f64fe2fdc3f83707229d64d1516bb56405d Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Mon, 12 Aug 2024 21:55:17 -0400
Subject: [PATCH 1074/1120] DOC: Fix a typo in GitHub stats

---
 doc/users/github_stats.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/users/github_stats.rst b/doc/users/github_stats.rst
index 00c3e5d656a1..d357a6759d30 100644
--- a/doc/users/github_stats.rst
+++ b/doc/users/github_stats.rst
@@ -89,7 +89,7 @@ Issues (9):
 * :ghissue:`28250`: [Doc]: Sphinx gallery links mispointed for Axes3D methods
 * :ghissue:`28574`: [Bug]: Nondeterministic behavior with subplot spacing and constrained layout
 * :ghissue:`28626`: [Doc]: Remove old TODO's from animation.py
-* :ghissue:`28648`: [Bug]: format_image_data on an image of only zeros produses a large number of zeros
+* :ghissue:`28648`: [Bug]: format_image_data on an image of only zeros produces a large number of zeros
 * :ghissue:`28624`: [Bug]: Bad type hint in ``_AxesBase.twinx()``
 * :ghissue:`28567`: [Bug]: sticky edge related changes for datetime plots
 * :ghissue:`28533`: [Doc]: Stackplot hatch functionality has version dependencies

From 8e2d7914a2c8943187405661be3e876537c32e54 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 14 Aug 2024 16:44:38 -0400
Subject: [PATCH 1075/1120] TST: Guard against PyGObject existing, but not
 gobject-introspection

---
 lib/matplotlib/tests/test_backends_interactive.py | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_backends_interactive.py b/lib/matplotlib/tests/test_backends_interactive.py
index d624b5db0ac2..2c6b61a48438 100644
--- a/lib/matplotlib/tests/test_backends_interactive.py
+++ b/lib/matplotlib/tests/test_backends_interactive.py
@@ -81,10 +81,18 @@ def _get_available_interactive_backends():
         elif env["MPLBACKEND"] == 'macosx' and os.environ.get('TF_BUILD'):
             reason = "macosx backend fails on Azure"
         elif env["MPLBACKEND"].startswith('gtk'):
-            import gi  # type: ignore
+            try:
+                import gi  # type: ignore
+            except ImportError:
+                # Though we check that `gi` exists above, it is possible that its
+                # C-level dependencies are not available, and then it still raises an
+                # `ImportError`, so guard against that.
+                available_gtk_versions = []
+            else:
+                gi_repo = gi.Repository.get_default()
+                available_gtk_versions = gi_repo.enumerate_versions('Gtk')
             version = env["MPLBACKEND"][3]
-            repo = gi.Repository.get_default()
-            if f'{version}.0' not in repo.enumerate_versions('Gtk'):
+            if f'{version}.0' not in available_gtk_versions:
                 reason = "no usable GTK bindings"
         marks = []
         if reason:

From f6b32660a348aa027b25709cc3d8218b017e8db5 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 14 Aug 2024 17:02:23 -0400
Subject: [PATCH 1076/1120] BLD: Avoid pybind11 2.13.3 due to Windows quoting
 bug

See https://github.com/pybind/pybind11/issues/5300#issuecomment-2287698500
---
 pyproject.toml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pyproject.toml b/pyproject.toml
index 52bbe308c0f9..891ef87e4342 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -49,7 +49,7 @@ requires-python = ">=3.9"
 dev = [
     "meson-python>=0.13.1",
     "numpy>=1.25",
-    "pybind11>=2.6",
+    "pybind11>=2.6,!=2.13.3",
     "setuptools_scm>=7",
     # Not required by us but setuptools_scm without a version, cso _if_
     # installed, then setuptools_scm 8 requires at least this version.
@@ -73,7 +73,7 @@ build-backend = "mesonpy"
 # Also keep in sync with optional dependencies above.
 requires = [
     "meson-python>=0.13.1",
-    "pybind11>=2.6",
+    "pybind11>=2.6,!=2.13.3",
     "setuptools_scm>=7",
 
     # Comments on numpy build requirement range:

From cb124887a10c2e69e70974847a47f320353e791c Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Thu, 15 Aug 2024 18:21:14 -0400
Subject: [PATCH 1077/1120] Backport PR #28732: Renames the minumumSizeHint
 method to minimumSizeHint

---
 lib/matplotlib/backends/backend_qt.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/backends/backend_qt.py b/lib/matplotlib/backends/backend_qt.py
index 6603883075d4..242c6fdbf9f9 100644
--- a/lib/matplotlib/backends/backend_qt.py
+++ b/lib/matplotlib/backends/backend_qt.py
@@ -393,7 +393,7 @@ def sizeHint(self):
         w, h = self.get_width_height()
         return QtCore.QSize(w, h)
 
-    def minumumSizeHint(self):
+    def minimumSizeHint(self):
         return QtCore.QSize(10, 10)
 
     @staticmethod

From 3900fa24aa082c1727ca274b98747933f1578671 Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Wed, 21 Aug 2024 08:22:23 +0100
Subject: [PATCH 1078/1120] Backport PR #28737: TST: Fix image comparison
 directory for test_striped_lines

---
 lib/matplotlib/tests/test_collections.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/lib/matplotlib/tests/test_collections.py b/lib/matplotlib/tests/test_collections.py
index 23e951b17a2f..c4f98d4eeb45 100644
--- a/lib/matplotlib/tests/test_collections.py
+++ b/lib/matplotlib/tests/test_collections.py
@@ -1316,7 +1316,6 @@ def test_check_offsets_dtype():
 
 @pytest.mark.parametrize('gapcolor', ['orange', ['r', 'k']])
 @check_figures_equal(extensions=['png'])
-@mpl.rc_context({'lines.linewidth': 20})
 def test_striped_lines(fig_test, fig_ref, gapcolor):
     ax_test = fig_test.add_subplot(111)
     ax_ref = fig_ref.add_subplot(111)
@@ -1328,11 +1327,12 @@ def test_striped_lines(fig_test, fig_ref, gapcolor):
     x = range(1, 6)
     linestyles = [':', '-', '--']
 
-    ax_test.vlines(x, 0, 1, linestyle=linestyles, gapcolor=gapcolor, alpha=0.5)
+    ax_test.vlines(x, 0, 1, linewidth=20, linestyle=linestyles, gapcolor=gapcolor,
+                   alpha=0.5)
 
     if isinstance(gapcolor, str):
         gapcolor = [gapcolor]
 
     for x, gcol, ls in zip(x, itertools.cycle(gapcolor),
                            itertools.cycle(linestyles)):
-        ax_ref.axvline(x, 0, 1, linestyle=ls, gapcolor=gcol, alpha=0.5)
+        ax_ref.axvline(x, 0, 1, linewidth=20, linestyle=ls, gapcolor=gcol, alpha=0.5)

From fc5bc4a50b6c16cde5e21e122fb370862b56148c Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Wed, 21 Aug 2024 10:17:02 +0100
Subject: [PATCH 1079/1120] Backport PR #28739: Tweak interactivity docs
 wording (and fix capitalization).

---
 galleries/users_explain/figure/event_handling.rst | 15 +++++++++------
 galleries/users_explain/figure/interactive.rst    |  2 +-
 .../users_explain/figure/interactive_guide.rst    |  2 +-
 3 files changed, 11 insertions(+), 8 deletions(-)

diff --git a/galleries/users_explain/figure/event_handling.rst b/galleries/users_explain/figure/event_handling.rst
index 49d73afeb366..32da038634ae 100644
--- a/galleries/users_explain/figure/event_handling.rst
+++ b/galleries/users_explain/figure/event_handling.rst
@@ -251,7 +251,8 @@ is created every time a mouse is pressed::
 
         def __call__(self, event):
             print('click', event)
-            if event.inaxes!=self.line.axes: return
+            if event.inaxes != self.line.axes:
+                return
             self.xs.append(event.xdata)
             self.ys.append(event.ydata)
             self.line.set_data(self.xs, self.ys)
@@ -277,17 +278,19 @@ event.ydata)``.  In addition to the ``LocationEvent`` attributes, it also has:
 Draggable rectangle exercise
 ----------------------------
 
-Write draggable rectangle class that is initialized with a
+Write a draggable rectangle class that is initialized with a
 `.Rectangle` instance but will move its ``xy``
-location when dragged.  Hint: you will need to store the original
-``xy`` location of the rectangle which is stored as rect.xy and
+location when dragged.
+
+Hint: You will need to store the original
+``xy`` location of the rectangle which is stored as ``rect.xy`` and
 connect to the press, motion and release mouse events.  When the mouse
 is pressed, check to see if the click occurs over your rectangle (see
 `.Rectangle.contains`) and if it does, store
-the rectangle xy and the location of the mouse click in data coords.
+the rectangle xy and the location of the mouse click in data coordinates.
 In the motion event callback, compute the deltax and deltay of the
 mouse movement, and add those deltas to the origin of the rectangle
-you stored.  The redraw the figure.  On the button release event, just
+you stored, then redraw the figure.  On the button release event, just
 reset all the button press data you stored as None.
 
 Here is the solution::
diff --git a/galleries/users_explain/figure/interactive.rst b/galleries/users_explain/figure/interactive.rst
index 6fd908fcac7a..b06283152e50 100644
--- a/galleries/users_explain/figure/interactive.rst
+++ b/galleries/users_explain/figure/interactive.rst
@@ -10,7 +10,7 @@
 Interactive figures
 ===================
 
-When working with data, interactivity can be invaluable. The pan/zoom and
+Interactivity can be invaluable when exploring plots. The pan/zoom and
 mouse-location tools built into the Matplotlib GUI windows are often sufficient, but
 you can also use the event system to build customized data exploration tools.
 
diff --git a/galleries/users_explain/figure/interactive_guide.rst b/galleries/users_explain/figure/interactive_guide.rst
index 3b6f527f6d42..b08231e84f7e 100644
--- a/galleries/users_explain/figure/interactive_guide.rst
+++ b/galleries/users_explain/figure/interactive_guide.rst
@@ -236,7 +236,7 @@ which would poll for new data and update the figure at 1Hz.
 
 .. _spin_event_loop:
 
-Explicitly spinning the event Loop
+Explicitly spinning the event loop
 ----------------------------------
 
 .. autosummary::

From cbc42296dce9d199ef6f33ee6a893ebb11fbfac5 Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Wed, 21 Aug 2024 10:17:02 +0100
Subject: [PATCH 1080/1120] Backport PR #28739: Tweak interactivity docs
 wording (and fix capitalization).

---
 galleries/users_explain/figure/event_handling.rst | 15 +++++++++------
 galleries/users_explain/figure/interactive.rst    |  2 +-
 .../users_explain/figure/interactive_guide.rst    |  2 +-
 3 files changed, 11 insertions(+), 8 deletions(-)

diff --git a/galleries/users_explain/figure/event_handling.rst b/galleries/users_explain/figure/event_handling.rst
index 49d73afeb366..32da038634ae 100644
--- a/galleries/users_explain/figure/event_handling.rst
+++ b/galleries/users_explain/figure/event_handling.rst
@@ -251,7 +251,8 @@ is created every time a mouse is pressed::
 
         def __call__(self, event):
             print('click', event)
-            if event.inaxes!=self.line.axes: return
+            if event.inaxes != self.line.axes:
+                return
             self.xs.append(event.xdata)
             self.ys.append(event.ydata)
             self.line.set_data(self.xs, self.ys)
@@ -277,17 +278,19 @@ event.ydata)``.  In addition to the ``LocationEvent`` attributes, it also has:
 Draggable rectangle exercise
 ----------------------------
 
-Write draggable rectangle class that is initialized with a
+Write a draggable rectangle class that is initialized with a
 `.Rectangle` instance but will move its ``xy``
-location when dragged.  Hint: you will need to store the original
-``xy`` location of the rectangle which is stored as rect.xy and
+location when dragged.
+
+Hint: You will need to store the original
+``xy`` location of the rectangle which is stored as ``rect.xy`` and
 connect to the press, motion and release mouse events.  When the mouse
 is pressed, check to see if the click occurs over your rectangle (see
 `.Rectangle.contains`) and if it does, store
-the rectangle xy and the location of the mouse click in data coords.
+the rectangle xy and the location of the mouse click in data coordinates.
 In the motion event callback, compute the deltax and deltay of the
 mouse movement, and add those deltas to the origin of the rectangle
-you stored.  The redraw the figure.  On the button release event, just
+you stored, then redraw the figure.  On the button release event, just
 reset all the button press data you stored as None.
 
 Here is the solution::
diff --git a/galleries/users_explain/figure/interactive.rst b/galleries/users_explain/figure/interactive.rst
index 6fd908fcac7a..b06283152e50 100644
--- a/galleries/users_explain/figure/interactive.rst
+++ b/galleries/users_explain/figure/interactive.rst
@@ -10,7 +10,7 @@
 Interactive figures
 ===================
 
-When working with data, interactivity can be invaluable. The pan/zoom and
+Interactivity can be invaluable when exploring plots. The pan/zoom and
 mouse-location tools built into the Matplotlib GUI windows are often sufficient, but
 you can also use the event system to build customized data exploration tools.
 
diff --git a/galleries/users_explain/figure/interactive_guide.rst b/galleries/users_explain/figure/interactive_guide.rst
index 3b6f527f6d42..b08231e84f7e 100644
--- a/galleries/users_explain/figure/interactive_guide.rst
+++ b/galleries/users_explain/figure/interactive_guide.rst
@@ -236,7 +236,7 @@ which would poll for new data and update the figure at 1Hz.
 
 .. _spin_event_loop:
 
-Explicitly spinning the event Loop
+Explicitly spinning the event loop
 ----------------------------------
 
 .. autosummary::

From d9d1a4d3f6612e9349f1607f46f359bdce8934f6 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Thu, 22 Aug 2024 10:20:39 +0200
Subject: [PATCH 1081/1120] Backport PR #28743: Minor fixes in ticker docs

---
 lib/matplotlib/ticker.py | 36 ++++++++++++++++++------------------
 1 file changed, 18 insertions(+), 18 deletions(-)

diff --git a/lib/matplotlib/ticker.py b/lib/matplotlib/ticker.py
index 2b00937f9e29..d824bbe3b6e2 100644
--- a/lib/matplotlib/ticker.py
+++ b/lib/matplotlib/ticker.py
@@ -435,10 +435,10 @@ class ScalarFormatter(Formatter):
         lim = (1_000_000, 1_000_010)
 
         fig, (ax1, ax2, ax3) = plt.subplots(3, 1, gridspec_kw={'hspace': 2})
-        ax1.set(title='offset_notation', xlim=lim)
+        ax1.set(title='offset notation', xlim=lim)
         ax2.set(title='scientific notation', xlim=lim)
         ax2.xaxis.get_major_formatter().set_useOffset(False)
-        ax3.set(title='floating point notation', xlim=lim)
+        ax3.set(title='floating-point notation', xlim=lim)
         ax3.xaxis.get_major_formatter().set_useOffset(False)
         ax3.xaxis.get_major_formatter().set_scientific(False)
 
@@ -1146,10 +1146,10 @@ def __init__(
         Parameters
         ----------
         use_overline : bool, default: False
-            If x > 1/2, with x = 1-v, indicate if x should be displayed as
-            $\overline{v}$. The default is to display $1-v$.
+            If x > 1/2, with x = 1 - v, indicate if x should be displayed as
+            $\overline{v}$. The default is to display $1 - v$.
 
-        one_half : str, default: r"\frac{1}{2}"
+        one_half : str, default: r"\\frac{1}{2}"
             The string used to represent 1/2.
 
         minor : bool, default: False
@@ -1179,9 +1179,9 @@ def use_overline(self, use_overline):
 
         Parameters
         ----------
-        use_overline : bool, default: False
-            If x > 1/2, with x = 1-v, indicate if x should be displayed as
-            $\overline{v}$. The default is to display $1-v$.
+        use_overline : bool
+            If x > 1/2, with x = 1 - v, indicate if x should be displayed as
+            $\overline{v}$. The default is to display $1 - v$.
         """
         self._use_overline = use_overline
 
@@ -1189,7 +1189,7 @@ def set_one_half(self, one_half):
         r"""
         Set the way one half is displayed.
 
-        one_half : str, default: r"\frac{1}{2}"
+        one_half : str
             The string used to represent 1/2.
         """
         self._one_half = one_half
@@ -1707,14 +1707,14 @@ def tick_values(self, vmin, vmax):
 
 
 class FixedLocator(Locator):
-    """
+    r"""
     Place ticks at a set of fixed values.
 
     If *nbins* is None ticks are placed at all values. Otherwise, the *locs* array of
-    possible positions will be subsampled to keep the number of ticks <=
-    :math:`nbins* +1`. The subsampling will be done to include the smallest absolute
-    value; for example, if zero is included in the array of possibilities, then it of
-    the chosen ticks.
+    possible positions will be subsampled to keep the number of ticks
+    :math:`\leq nbins + 1`. The subsampling will be done to include the smallest
+    absolute value; for example, if zero is included in the array of possibilities, then
+    it will be included in the chosen ticks.
     """
 
     def __init__(self, locs, nbins=None):
@@ -1861,9 +1861,9 @@ def __init__(self, base=1.0, offset=0.0):
         """
         Parameters
         ----------
-        base : float > 0
+        base : float > 0, default: 1.0
             Interval between ticks.
-        offset : float
+        offset : float, default: 0.0
             Value added to each multiple of *base*.
 
             .. versionadded:: 3.8
@@ -1877,9 +1877,9 @@ def set_params(self, base=None, offset=None):
 
         Parameters
         ----------
-        base : float > 0
+        base : float > 0, optional
             Interval between ticks.
-        offset : float
+        offset : float, optional
             Value added to each multiple of *base*.
 
             .. versionadded:: 3.8

From 83251ac2a1d780dc4af2bacab07b43552c5b7a70 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Thu, 22 Aug 2024 14:50:03 -0400
Subject: [PATCH 1082/1120] Backport PR #28271: Fix draggable legend
 disappearing when picking while use_blit=True

---
 lib/matplotlib/offsetbox.py | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/lib/matplotlib/offsetbox.py b/lib/matplotlib/offsetbox.py
index 32c5bafcde1d..194b950a8a30 100644
--- a/lib/matplotlib/offsetbox.py
+++ b/lib/matplotlib/offsetbox.py
@@ -1486,11 +1486,13 @@ def on_motion(self, evt):
                 self.canvas.draw()
 
     def on_pick(self, evt):
-        if self._check_still_parented() and evt.artist == self.ref_artist:
-            self.mouse_x = evt.mouseevent.x
-            self.mouse_y = evt.mouseevent.y
-            self.got_artist = True
-            if self._use_blit:
+        if self._check_still_parented():
+            if evt.artist == self.ref_artist:
+                self.mouse_x = evt.mouseevent.x
+                self.mouse_y = evt.mouseevent.y
+                self.save_offset()
+                self.got_artist = True
+            if self.got_artist and self._use_blit:
                 self.ref_artist.set_animated(True)
                 self.canvas.draw()
                 self.background = \
@@ -1498,13 +1500,15 @@ def on_pick(self, evt):
                 self.ref_artist.draw(
                     self.ref_artist.figure._get_renderer())
                 self.canvas.blit()
-            self.save_offset()
 
     def on_release(self, event):
         if self._check_still_parented() and self.got_artist:
             self.finalize_offset()
             self.got_artist = False
             if self._use_blit:
+                self.canvas.restore_region(self.background)
+                self.ref_artist.draw(self.ref_artist.figure._get_renderer())
+                self.canvas.blit()
                 self.ref_artist.set_animated(False)
 
     def _check_still_parented(self):

From 4439116246b1f74e6dda7a11d96602c3912c01b9 Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Sat, 7 Sep 2024 14:33:56 +0100
Subject: [PATCH 1083/1120] Backport PR #28706: Add Returns info to to_jshtml
 docstring

---
 lib/matplotlib/animation.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/lib/matplotlib/animation.py b/lib/matplotlib/animation.py
index 5a4764f1a79f..b402c5fdb4da 100644
--- a/lib/matplotlib/animation.py
+++ b/lib/matplotlib/animation.py
@@ -1311,6 +1311,12 @@ def to_jshtml(self, fps=None, embed_frames=True, default_mode=None):
             What to do when the animation ends. Must be one of ``{'loop',
             'once', 'reflect'}``. Defaults to ``'loop'`` if the *repeat*
             parameter is True, otherwise ``'once'``.
+
+        Returns
+        -------
+        str
+            An HTML representation of the animation embedded as a js object as
+            produced with the `.HTMLWriter`.
         """
         if fps is None and hasattr(self, '_interval'):
             # Convert interval in ms to frames per second

From 7c370eac988c51dea9d6fca285636ebfcdeba55c Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Sun, 8 Sep 2024 08:44:57 +0100
Subject: [PATCH 1084/1120] Backport PR #28790: DOC: Fix duplicate
 Figure.set_dpi entry

---
 doc/api/figure_api.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/api/figure_api.rst b/doc/api/figure_api.rst
index 2371e5a9a863..5dd3adbfec9f 100644
--- a/doc/api/figure_api.rst
+++ b/doc/api/figure_api.rst
@@ -91,7 +91,7 @@ Figure geometry
    Figure.get_figwidth
    Figure.dpi
    Figure.set_dpi
-   Figure.set_dpi
+   Figure.get_dpi
 
 Subplot layout
 --------------

From cf7e7ae718ced0a8b2bbf7aa2d30b141fa5eeb8c Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Sun, 8 Sep 2024 08:44:57 +0100
Subject: [PATCH 1085/1120] Backport PR #28790: DOC: Fix duplicate
 Figure.set_dpi entry

---
 doc/api/figure_api.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/api/figure_api.rst b/doc/api/figure_api.rst
index 2371e5a9a863..5dd3adbfec9f 100644
--- a/doc/api/figure_api.rst
+++ b/doc/api/figure_api.rst
@@ -91,7 +91,7 @@ Figure geometry
    Figure.get_figwidth
    Figure.dpi
    Figure.set_dpi
-   Figure.set_dpi
+   Figure.get_dpi
 
 Subplot layout
 --------------

From 88309f528843195ec1e25d75ea5cf148a40bcd8d Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Wed, 11 Sep 2024 16:54:17 -0400
Subject: [PATCH 1086/1120] Backport PR #28798: DOC: Correctly list modules
 that have been internalized

---
 doc/api/_afm_api.rst          |  8 ++++++++
 doc/api/_docstring_api.rst    |  8 ++++++++
 doc/api/_tight_bbox_api.rst   |  8 ++++++++
 doc/api/_tight_layout_api.rst |  8 ++++++++
 doc/api/_type1font.rst        |  8 ++++++++
 doc/api/afm_api.rst           | 13 -------------
 doc/api/docstring_api.rst     | 13 -------------
 doc/api/index.rst             | 10 +++++-----
 doc/api/tight_bbox_api.rst    | 13 -------------
 doc/api/tight_layout_api.rst  | 13 -------------
 doc/api/type1font.rst         | 13 -------------
 11 files changed, 45 insertions(+), 70 deletions(-)
 create mode 100644 doc/api/_afm_api.rst
 create mode 100644 doc/api/_docstring_api.rst
 create mode 100644 doc/api/_tight_bbox_api.rst
 create mode 100644 doc/api/_tight_layout_api.rst
 create mode 100644 doc/api/_type1font.rst
 delete mode 100644 doc/api/afm_api.rst
 delete mode 100644 doc/api/docstring_api.rst
 delete mode 100644 doc/api/tight_bbox_api.rst
 delete mode 100644 doc/api/tight_layout_api.rst
 delete mode 100644 doc/api/type1font.rst

diff --git a/doc/api/_afm_api.rst b/doc/api/_afm_api.rst
new file mode 100644
index 000000000000..4e2ac4997272
--- /dev/null
+++ b/doc/api/_afm_api.rst
@@ -0,0 +1,8 @@
+*******************
+``matplotlib._afm``
+*******************
+
+.. automodule:: matplotlib._afm
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/doc/api/_docstring_api.rst b/doc/api/_docstring_api.rst
new file mode 100644
index 000000000000..040a3653a87b
--- /dev/null
+++ b/doc/api/_docstring_api.rst
@@ -0,0 +1,8 @@
+*************************
+``matplotlib._docstring``
+*************************
+
+.. automodule:: matplotlib._docstring
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/doc/api/_tight_bbox_api.rst b/doc/api/_tight_bbox_api.rst
new file mode 100644
index 000000000000..826e051fcf6d
--- /dev/null
+++ b/doc/api/_tight_bbox_api.rst
@@ -0,0 +1,8 @@
+**************************
+``matplotlib._tight_bbox``
+**************************
+
+.. automodule:: matplotlib._tight_bbox
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/doc/api/_tight_layout_api.rst b/doc/api/_tight_layout_api.rst
new file mode 100644
index 000000000000..ac4f66f280e1
--- /dev/null
+++ b/doc/api/_tight_layout_api.rst
@@ -0,0 +1,8 @@
+****************************
+``matplotlib._tight_layout``
+****************************
+
+.. automodule:: matplotlib._tight_layout
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/doc/api/_type1font.rst b/doc/api/_type1font.rst
new file mode 100644
index 000000000000..1a9ff2292887
--- /dev/null
+++ b/doc/api/_type1font.rst
@@ -0,0 +1,8 @@
+*************************
+``matplotlib._type1font``
+*************************
+
+.. automodule:: matplotlib._type1font
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/doc/api/afm_api.rst b/doc/api/afm_api.rst
deleted file mode 100644
index bcae04150909..000000000000
--- a/doc/api/afm_api.rst
+++ /dev/null
@@ -1,13 +0,0 @@
-******************
-``matplotlib.afm``
-******************
-
-.. attention::
-    This module is considered internal.
-
-    Its use is deprecated and it will be removed in a future version.
-
-.. automodule:: matplotlib._afm
-   :members:
-   :undoc-members:
-   :show-inheritance:
diff --git a/doc/api/docstring_api.rst b/doc/api/docstring_api.rst
deleted file mode 100644
index 38a73a2e83d1..000000000000
--- a/doc/api/docstring_api.rst
+++ /dev/null
@@ -1,13 +0,0 @@
-************************
-``matplotlib.docstring``
-************************
-
-.. attention::
-    This module is considered internal.
-
-    Its use is deprecated and it will be removed in a future version.
-
-.. automodule:: matplotlib._docstring
-   :members:
-   :undoc-members:
-   :show-inheritance:
diff --git a/doc/api/index.rst b/doc/api/index.rst
index 70c3b5343e7a..53f397a6817a 100644
--- a/doc/api/index.rst
+++ b/doc/api/index.rst
@@ -79,7 +79,6 @@ Alphabetical list of modules:
    :maxdepth: 1
 
    matplotlib_configuration_api.rst
-   afm_api.rst
    animation_api.rst
    artist_api.rst
    axes_api.rst
@@ -98,7 +97,6 @@ Alphabetical list of modules:
    container_api.rst
    contour_api.rst
    dates_api.rst
-   docstring_api.rst
    dviread.rst
    figure_api.rst
    font_manager_api.rst
@@ -134,16 +132,18 @@ Alphabetical list of modules:
    text_api.rst
    texmanager_api.rst
    ticker_api.rst
-   tight_bbox_api.rst
-   tight_layout_api.rst
    transformations.rst
    tri_api.rst
-   type1font.rst
    typing_api.rst
    units_api.rst
    widgets_api.rst
+   _afm_api.rst
    _api_api.rst
+   _docstring_api.rst
    _enums_api.rst
+   _type1font.rst
+   _tight_bbox_api.rst
+   _tight_layout_api.rst
    toolkits/mplot3d.rst
    toolkits/axes_grid1.rst
    toolkits/axisartist.rst
diff --git a/doc/api/tight_bbox_api.rst b/doc/api/tight_bbox_api.rst
deleted file mode 100644
index 9e8dd2fa66f9..000000000000
--- a/doc/api/tight_bbox_api.rst
+++ /dev/null
@@ -1,13 +0,0 @@
-*************************
-``matplotlib.tight_bbox``
-*************************
-
-.. attention::
-    This module is considered internal.
-
-    Its use is deprecated and it will be removed in a future version.
-
-.. automodule:: matplotlib._tight_bbox
-   :members:
-   :undoc-members:
-   :show-inheritance:
diff --git a/doc/api/tight_layout_api.rst b/doc/api/tight_layout_api.rst
deleted file mode 100644
index 35f92e3ddced..000000000000
--- a/doc/api/tight_layout_api.rst
+++ /dev/null
@@ -1,13 +0,0 @@
-***************************
-``matplotlib.tight_layout``
-***************************
-
-.. attention::
-    This module is considered internal.
-
-    Its use is deprecated and it will be removed in a future version.
-
-.. automodule:: matplotlib._tight_layout
-   :members:
-   :undoc-members:
-   :show-inheritance:
diff --git a/doc/api/type1font.rst b/doc/api/type1font.rst
deleted file mode 100644
index 00ef38f4d447..000000000000
--- a/doc/api/type1font.rst
+++ /dev/null
@@ -1,13 +0,0 @@
-************************
-``matplotlib.type1font``
-************************
-
-.. attention::
-    This module is considered internal.
-
-    Its use is deprecated and it will be removed in a future version.
-
-.. automodule:: matplotlib._type1font
-   :members:
-   :undoc-members:
-   :show-inheritance:

From 259b3ee84784341b50696206d559f67c74ba9c89 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Wed, 11 Sep 2024 16:54:17 -0400
Subject: [PATCH 1087/1120] Backport PR #28798: DOC: Correctly list modules
 that have been internalized

---
 doc/api/_afm_api.rst          |  8 ++++++++
 doc/api/_docstring_api.rst    |  8 ++++++++
 doc/api/_tight_bbox_api.rst   |  8 ++++++++
 doc/api/_tight_layout_api.rst |  8 ++++++++
 doc/api/_type1font.rst        |  8 ++++++++
 doc/api/afm_api.rst           | 13 -------------
 doc/api/docstring_api.rst     | 13 -------------
 doc/api/index.rst             | 10 +++++-----
 doc/api/tight_bbox_api.rst    | 13 -------------
 doc/api/tight_layout_api.rst  | 13 -------------
 doc/api/type1font.rst         | 13 -------------
 11 files changed, 45 insertions(+), 70 deletions(-)
 create mode 100644 doc/api/_afm_api.rst
 create mode 100644 doc/api/_docstring_api.rst
 create mode 100644 doc/api/_tight_bbox_api.rst
 create mode 100644 doc/api/_tight_layout_api.rst
 create mode 100644 doc/api/_type1font.rst
 delete mode 100644 doc/api/afm_api.rst
 delete mode 100644 doc/api/docstring_api.rst
 delete mode 100644 doc/api/tight_bbox_api.rst
 delete mode 100644 doc/api/tight_layout_api.rst
 delete mode 100644 doc/api/type1font.rst

diff --git a/doc/api/_afm_api.rst b/doc/api/_afm_api.rst
new file mode 100644
index 000000000000..4e2ac4997272
--- /dev/null
+++ b/doc/api/_afm_api.rst
@@ -0,0 +1,8 @@
+*******************
+``matplotlib._afm``
+*******************
+
+.. automodule:: matplotlib._afm
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/doc/api/_docstring_api.rst b/doc/api/_docstring_api.rst
new file mode 100644
index 000000000000..040a3653a87b
--- /dev/null
+++ b/doc/api/_docstring_api.rst
@@ -0,0 +1,8 @@
+*************************
+``matplotlib._docstring``
+*************************
+
+.. automodule:: matplotlib._docstring
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/doc/api/_tight_bbox_api.rst b/doc/api/_tight_bbox_api.rst
new file mode 100644
index 000000000000..826e051fcf6d
--- /dev/null
+++ b/doc/api/_tight_bbox_api.rst
@@ -0,0 +1,8 @@
+**************************
+``matplotlib._tight_bbox``
+**************************
+
+.. automodule:: matplotlib._tight_bbox
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/doc/api/_tight_layout_api.rst b/doc/api/_tight_layout_api.rst
new file mode 100644
index 000000000000..ac4f66f280e1
--- /dev/null
+++ b/doc/api/_tight_layout_api.rst
@@ -0,0 +1,8 @@
+****************************
+``matplotlib._tight_layout``
+****************************
+
+.. automodule:: matplotlib._tight_layout
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/doc/api/_type1font.rst b/doc/api/_type1font.rst
new file mode 100644
index 000000000000..1a9ff2292887
--- /dev/null
+++ b/doc/api/_type1font.rst
@@ -0,0 +1,8 @@
+*************************
+``matplotlib._type1font``
+*************************
+
+.. automodule:: matplotlib._type1font
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/doc/api/afm_api.rst b/doc/api/afm_api.rst
deleted file mode 100644
index bcae04150909..000000000000
--- a/doc/api/afm_api.rst
+++ /dev/null
@@ -1,13 +0,0 @@
-******************
-``matplotlib.afm``
-******************
-
-.. attention::
-    This module is considered internal.
-
-    Its use is deprecated and it will be removed in a future version.
-
-.. automodule:: matplotlib._afm
-   :members:
-   :undoc-members:
-   :show-inheritance:
diff --git a/doc/api/docstring_api.rst b/doc/api/docstring_api.rst
deleted file mode 100644
index 38a73a2e83d1..000000000000
--- a/doc/api/docstring_api.rst
+++ /dev/null
@@ -1,13 +0,0 @@
-************************
-``matplotlib.docstring``
-************************
-
-.. attention::
-    This module is considered internal.
-
-    Its use is deprecated and it will be removed in a future version.
-
-.. automodule:: matplotlib._docstring
-   :members:
-   :undoc-members:
-   :show-inheritance:
diff --git a/doc/api/index.rst b/doc/api/index.rst
index 70c3b5343e7a..53f397a6817a 100644
--- a/doc/api/index.rst
+++ b/doc/api/index.rst
@@ -79,7 +79,6 @@ Alphabetical list of modules:
    :maxdepth: 1
 
    matplotlib_configuration_api.rst
-   afm_api.rst
    animation_api.rst
    artist_api.rst
    axes_api.rst
@@ -98,7 +97,6 @@ Alphabetical list of modules:
    container_api.rst
    contour_api.rst
    dates_api.rst
-   docstring_api.rst
    dviread.rst
    figure_api.rst
    font_manager_api.rst
@@ -134,16 +132,18 @@ Alphabetical list of modules:
    text_api.rst
    texmanager_api.rst
    ticker_api.rst
-   tight_bbox_api.rst
-   tight_layout_api.rst
    transformations.rst
    tri_api.rst
-   type1font.rst
    typing_api.rst
    units_api.rst
    widgets_api.rst
+   _afm_api.rst
    _api_api.rst
+   _docstring_api.rst
    _enums_api.rst
+   _type1font.rst
+   _tight_bbox_api.rst
+   _tight_layout_api.rst
    toolkits/mplot3d.rst
    toolkits/axes_grid1.rst
    toolkits/axisartist.rst
diff --git a/doc/api/tight_bbox_api.rst b/doc/api/tight_bbox_api.rst
deleted file mode 100644
index 9e8dd2fa66f9..000000000000
--- a/doc/api/tight_bbox_api.rst
+++ /dev/null
@@ -1,13 +0,0 @@
-*************************
-``matplotlib.tight_bbox``
-*************************
-
-.. attention::
-    This module is considered internal.
-
-    Its use is deprecated and it will be removed in a future version.
-
-.. automodule:: matplotlib._tight_bbox
-   :members:
-   :undoc-members:
-   :show-inheritance:
diff --git a/doc/api/tight_layout_api.rst b/doc/api/tight_layout_api.rst
deleted file mode 100644
index 35f92e3ddced..000000000000
--- a/doc/api/tight_layout_api.rst
+++ /dev/null
@@ -1,13 +0,0 @@
-***************************
-``matplotlib.tight_layout``
-***************************
-
-.. attention::
-    This module is considered internal.
-
-    Its use is deprecated and it will be removed in a future version.
-
-.. automodule:: matplotlib._tight_layout
-   :members:
-   :undoc-members:
-   :show-inheritance:
diff --git a/doc/api/type1font.rst b/doc/api/type1font.rst
deleted file mode 100644
index 00ef38f4d447..000000000000
--- a/doc/api/type1font.rst
+++ /dev/null
@@ -1,13 +0,0 @@
-************************
-``matplotlib.type1font``
-************************
-
-.. attention::
-    This module is considered internal.
-
-    Its use is deprecated and it will be removed in a future version.
-
-.. automodule:: matplotlib._type1font
-   :members:
-   :undoc-members:
-   :show-inheritance:

From 7b941c8a924c07215984810649ddee2a4ed51a7a Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 12 Sep 2024 05:28:44 -0400
Subject: [PATCH 1088/1120] Backport PR #28805: add brackets to satisfy the new
 sequence requirement

---
 galleries/examples/animation/frame_grabbing_sgskip.py | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/galleries/examples/animation/frame_grabbing_sgskip.py b/galleries/examples/animation/frame_grabbing_sgskip.py
index 08155d2c61a7..dcc2ca01afd9 100644
--- a/galleries/examples/animation/frame_grabbing_sgskip.py
+++ b/galleries/examples/animation/frame_grabbing_sgskip.py
@@ -6,8 +6,6 @@
 Use a MovieWriter directly to grab individual frames and write them to a
 file.  This avoids any event loop integration, and thus works even with the Agg
 backend.  This is not recommended for use in an interactive setting.
-
-Output generated via `matplotlib.animation.Animation.to_jshtml`.
 """
 
 import numpy as np
@@ -39,5 +37,5 @@
     for i in range(100):
         x0 += 0.1 * np.random.randn()
         y0 += 0.1 * np.random.randn()
-        l.set_data(x0, y0)
+        l.set_data([x0], [y0])
         writer.grab_frame()

From 96654d64dfea78901c9d912aca62c47fd4fb287c Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 12 Sep 2024 05:28:44 -0400
Subject: [PATCH 1089/1120] Backport PR #28805: add brackets to satisfy the new
 sequence requirement

---
 galleries/examples/animation/frame_grabbing_sgskip.py | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/galleries/examples/animation/frame_grabbing_sgskip.py b/galleries/examples/animation/frame_grabbing_sgskip.py
index 08155d2c61a7..dcc2ca01afd9 100644
--- a/galleries/examples/animation/frame_grabbing_sgskip.py
+++ b/galleries/examples/animation/frame_grabbing_sgskip.py
@@ -6,8 +6,6 @@
 Use a MovieWriter directly to grab individual frames and write them to a
 file.  This avoids any event loop integration, and thus works even with the Agg
 backend.  This is not recommended for use in an interactive setting.
-
-Output generated via `matplotlib.animation.Animation.to_jshtml`.
 """
 
 import numpy as np
@@ -39,5 +37,5 @@
     for i in range(100):
         x0 += 0.1 * np.random.randn()
         y0 += 0.1 * np.random.randn()
-        l.set_data(x0, y0)
+        l.set_data([x0], [y0])
         writer.grab_frame()

From 5fa2a000e4700294a059212dc3e0847e0db5ea01 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 12 Sep 2024 19:05:23 -0400
Subject: [PATCH 1090/1120] Backport PR #28810: Document how to obtain
 sans-serif usetex math.

---
 galleries/users_explain/text/usetex.py | 19 +++++++++----------
 1 file changed, 9 insertions(+), 10 deletions(-)

diff --git a/galleries/users_explain/text/usetex.py b/galleries/users_explain/text/usetex.py
index 0194a0030d48..f0c266819897 100644
--- a/galleries/users_explain/text/usetex.py
+++ b/galleries/users_explain/text/usetex.py
@@ -102,6 +102,12 @@
    :rc:`text.usetex`.  As noted above, underscores (``_``) do not require
    escaping outside of math mode.
 
+.. note::
+   LaTeX always defaults to using a serif font for math (even when
+   ``rcParams["font.family"] = "sans-serif"``).  If desired, adding
+   ``\usepackage{sfmath}`` to ``rcParams["text.latex.preamble"]`` lets LaTeX
+   output sans-serif math.
+
 PostScript options
 ==================
 
@@ -129,19 +135,13 @@
   :ref:`setting-windows-environment-variables` for details.
 
 * Using MiKTeX with Computer Modern fonts, if you get odd \*Agg and PNG
-  results, go to MiKTeX/Options and update your format files
+  results, go to MiKTeX/Options and update your format files.
 
 * On Ubuntu and Gentoo, the base texlive install does not ship with
   the type1cm package. You may need to install some of the extra
   packages to get all the goodies that come bundled with other LaTeX
   distributions.
 
-* Some progress has been made so Matplotlib uses the dvi files
-  directly for text layout. This allows LaTeX to be used for text
-  layout with the pdf and svg backends, as well as the \*Agg and PS
-  backends. In the future, a LaTeX installation may be the only
-  external dependency.
-
 .. _usetex-troubleshooting:
 
 Troubleshooting
@@ -150,7 +150,7 @@
 * Try deleting your :file:`.matplotlib/tex.cache` directory. If you don't know
   where to find :file:`.matplotlib`, see :ref:`locating-matplotlib-config-dir`.
 
-* Make sure LaTeX, dvipng and ghostscript are each working and on your
+* Make sure LaTeX, dvipng and Ghostscript are each working and on your
   :envvar:`PATH`.
 
 * Make sure what you are trying to do is possible in a LaTeX document,
@@ -159,8 +159,7 @@
 
 * :rc:`text.latex.preamble` is not officially supported. This
   option provides lots of flexibility, and lots of ways to cause
-  problems. Please disable this option before reporting problems to
-  the mailing list.
+  problems. Please disable this option before reporting problems.
 
 * If you still need help, please see :ref:`reporting-problems`.
 

From a058fae22f55154bd4080b41a5d9b096e8e96d1d Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 12 Sep 2024 19:05:23 -0400
Subject: [PATCH 1091/1120] Backport PR #28810: Document how to obtain
 sans-serif usetex math.

---
 galleries/users_explain/text/usetex.py | 19 +++++++++----------
 1 file changed, 9 insertions(+), 10 deletions(-)

diff --git a/galleries/users_explain/text/usetex.py b/galleries/users_explain/text/usetex.py
index 0194a0030d48..f0c266819897 100644
--- a/galleries/users_explain/text/usetex.py
+++ b/galleries/users_explain/text/usetex.py
@@ -102,6 +102,12 @@
    :rc:`text.usetex`.  As noted above, underscores (``_``) do not require
    escaping outside of math mode.
 
+.. note::
+   LaTeX always defaults to using a serif font for math (even when
+   ``rcParams["font.family"] = "sans-serif"``).  If desired, adding
+   ``\usepackage{sfmath}`` to ``rcParams["text.latex.preamble"]`` lets LaTeX
+   output sans-serif math.
+
 PostScript options
 ==================
 
@@ -129,19 +135,13 @@
   :ref:`setting-windows-environment-variables` for details.
 
 * Using MiKTeX with Computer Modern fonts, if you get odd \*Agg and PNG
-  results, go to MiKTeX/Options and update your format files
+  results, go to MiKTeX/Options and update your format files.
 
 * On Ubuntu and Gentoo, the base texlive install does not ship with
   the type1cm package. You may need to install some of the extra
   packages to get all the goodies that come bundled with other LaTeX
   distributions.
 
-* Some progress has been made so Matplotlib uses the dvi files
-  directly for text layout. This allows LaTeX to be used for text
-  layout with the pdf and svg backends, as well as the \*Agg and PS
-  backends. In the future, a LaTeX installation may be the only
-  external dependency.
-
 .. _usetex-troubleshooting:
 
 Troubleshooting
@@ -150,7 +150,7 @@
 * Try deleting your :file:`.matplotlib/tex.cache` directory. If you don't know
   where to find :file:`.matplotlib`, see :ref:`locating-matplotlib-config-dir`.
 
-* Make sure LaTeX, dvipng and ghostscript are each working and on your
+* Make sure LaTeX, dvipng and Ghostscript are each working and on your
   :envvar:`PATH`.
 
 * Make sure what you are trying to do is possible in a LaTeX document,
@@ -159,8 +159,7 @@
 
 * :rc:`text.latex.preamble` is not officially supported. This
   option provides lots of flexibility, and lots of ways to cause
-  problems. Please disable this option before reporting problems to
-  the mailing list.
+  problems. Please disable this option before reporting problems.
 
 * If you still need help, please see :ref:`reporting-problems`.
 

From 791d6c02c6a43b91ea2953910e6d20b9adffa612 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Mon, 16 Sep 2024 14:39:29 -0400
Subject: [PATCH 1092/1120] Backport PR #28818: Resolve configdir so that it's
 not a symlink when is_dir() is called

---
 lib/matplotlib/__init__.py | 17 ++++++++++-------
 1 file changed, 10 insertions(+), 7 deletions(-)

diff --git a/lib/matplotlib/__init__.py b/lib/matplotlib/__init__.py
index 9e9325a27d73..ad4676b11ae0 100644
--- a/lib/matplotlib/__init__.py
+++ b/lib/matplotlib/__init__.py
@@ -518,35 +518,38 @@ def _get_xdg_cache_dir():
 def _get_config_or_cache_dir(xdg_base_getter):
     configdir = os.environ.get('MPLCONFIGDIR')
     if configdir:
-        configdir = Path(configdir).resolve()
+        configdir = Path(configdir)
     elif sys.platform.startswith(('linux', 'freebsd')):
         # Only call _xdg_base_getter here so that MPLCONFIGDIR is tried first,
         # as _xdg_base_getter can throw.
         configdir = Path(xdg_base_getter(), "matplotlib")
     else:
         configdir = Path.home() / ".matplotlib"
+    # Resolve the path to handle potential issues with inaccessible symlinks.
+    configdir = configdir.resolve()
     try:
         configdir.mkdir(parents=True, exist_ok=True)
-    except OSError:
-        pass
+    except OSError as exc:
+        _log.warning("mkdir -p failed for path %s: %s", configdir, exc)
     else:
         if os.access(str(configdir), os.W_OK) and configdir.is_dir():
             return str(configdir)
+        _log.warning("%s is not a writable directory", configdir)
     # If the config or cache directory cannot be created or is not a writable
     # directory, create a temporary one.
     try:
         tmpdir = tempfile.mkdtemp(prefix="matplotlib-")
     except OSError as exc:
         raise OSError(
-            f"Matplotlib requires access to a writable cache directory, but the "
-            f"default path ({configdir}) is not a writable directory, and a temporary "
+            f"Matplotlib requires access to a writable cache directory, but there "
+            f"was an issue with the default path ({configdir}), and a temporary "
             f"directory could not be created; set the MPLCONFIGDIR environment "
             f"variable to a writable directory") from exc
     os.environ["MPLCONFIGDIR"] = tmpdir
     atexit.register(shutil.rmtree, tmpdir)
     _log.warning(
-        "Matplotlib created a temporary cache directory at %s because the default path "
-        "(%s) is not a writable directory; it is highly recommended to set the "
+        "Matplotlib created a temporary cache directory at %s because there was "
+        "an issue with the default path (%s); it is highly recommended to set the "
         "MPLCONFIGDIR environment variable to a writable directory, in particular to "
         "speed up the import of Matplotlib and to better support multiprocessing.",
         tmpdir, configdir)

From ae85b62e623baffa6679f9f3a58384ba0e1e5947 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 18 Sep 2024 22:36:21 -0400
Subject: [PATCH 1093/1120] Backport PR #28836: MNT: Use __init__ parameters of
 font properties

---
 .../text_labels_and_annotations/fonts_demo.py   | 17 +++++------------
 galleries/users_explain/text/text_intro.py      |  5 +----
 2 files changed, 6 insertions(+), 16 deletions(-)

diff --git a/galleries/examples/text_labels_and_annotations/fonts_demo.py b/galleries/examples/text_labels_and_annotations/fonts_demo.py
index bc36c10bce8b..821ee278c4ba 100644
--- a/galleries/examples/text_labels_and_annotations/fonts_demo.py
+++ b/galleries/examples/text_labels_and_annotations/fonts_demo.py
@@ -21,34 +21,28 @@
 fig.text(0.1, 0.9, 'family', fontproperties=heading_font, **alignment)
 families = ['serif', 'sans-serif', 'cursive', 'fantasy', 'monospace']
 for k, family in enumerate(families):
-    font = FontProperties()
-    font.set_family(family)
+    font = FontProperties(family=[family])
     fig.text(0.1, yp[k], family, fontproperties=font, **alignment)
 
 # Show style options
 styles = ['normal', 'italic', 'oblique']
 fig.text(0.3, 0.9, 'style', fontproperties=heading_font, **alignment)
 for k, style in enumerate(styles):
-    font = FontProperties()
-    font.set_family('sans-serif')
-    font.set_style(style)
+    font = FontProperties(family='sans-serif', style=style)
     fig.text(0.3, yp[k], style, fontproperties=font, **alignment)
 
 # Show variant options
 variants = ['normal', 'small-caps']
 fig.text(0.5, 0.9, 'variant', fontproperties=heading_font, **alignment)
 for k, variant in enumerate(variants):
-    font = FontProperties()
-    font.set_family('serif')
-    font.set_variant(variant)
+    font = FontProperties(family='serif', variant=variant)
     fig.text(0.5, yp[k], variant, fontproperties=font, **alignment)
 
 # Show weight options
 weights = ['light', 'normal', 'medium', 'semibold', 'bold', 'heavy', 'black']
 fig.text(0.7, 0.9, 'weight', fontproperties=heading_font, **alignment)
 for k, weight in enumerate(weights):
-    font = FontProperties()
-    font.set_weight(weight)
+    font = FontProperties(weight=weight)
     fig.text(0.7, yp[k], weight, fontproperties=font, **alignment)
 
 # Show size options
@@ -56,8 +50,7 @@
     'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large']
 fig.text(0.9, 0.9, 'size', fontproperties=heading_font, **alignment)
 for k, size in enumerate(sizes):
-    font = FontProperties()
-    font.set_size(size)
+    font = FontProperties(size=size)
     fig.text(0.9, yp[k], size, fontproperties=font, **alignment)
 
 # Show bold italic
diff --git a/galleries/users_explain/text/text_intro.py b/galleries/users_explain/text/text_intro.py
index 948545667fa9..3b8a66f1c98e 100644
--- a/galleries/users_explain/text/text_intro.py
+++ b/galleries/users_explain/text/text_intro.py
@@ -177,10 +177,7 @@
 
 from matplotlib.font_manager import FontProperties
 
-font = FontProperties()
-font.set_family('serif')
-font.set_name('Times New Roman')
-font.set_style('italic')
+font = FontProperties(family='Times New Roman', style='italic')
 
 fig, ax = plt.subplots(figsize=(5, 3))
 fig.subplots_adjust(bottom=0.15, left=0.2)

From 172624ebcbdccb08b27fb137910a2253871801e1 Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Sat, 21 Sep 2024 08:31:41 +0100
Subject: [PATCH 1094/1120] Backport PR #28858: Fix flaky labelcolor tests

---
 lib/matplotlib/tests/test_legend.py | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/lib/matplotlib/tests/test_legend.py b/lib/matplotlib/tests/test_legend.py
index 0353f1408b73..3c2af275649f 100644
--- a/lib/matplotlib/tests/test_legend.py
+++ b/lib/matplotlib/tests/test_legend.py
@@ -868,8 +868,8 @@ def test_legend_pathcollection_labelcolor_linecolor_iterable():
     # test the labelcolor for labelcolor='linecolor' on PathCollection
     # with iterable colors
     fig, ax = plt.subplots()
-    colors = np.random.default_rng().choice(['r', 'g', 'b'], 10)
-    ax.scatter(np.arange(10), np.arange(10)*1, label='#1', c=colors)
+    colors = np.array(['r', 'g', 'b', 'c', 'm'] * 2)
+    ax.scatter(np.arange(10), np.arange(10), label='#1', c=colors)
 
     leg = ax.legend(labelcolor='linecolor')
     text, = leg.get_texts()
@@ -915,8 +915,8 @@ def test_legend_pathcollection_labelcolor_markeredgecolor_iterable():
     # test the labelcolor for labelcolor='markeredgecolor' on PathCollection
     # with iterable colors
     fig, ax = plt.subplots()
-    colors = np.random.default_rng().choice(['r', 'g', 'b'], 10)
-    ax.scatter(np.arange(10), np.arange(10)*1, label='#1', edgecolor=colors)
+    colors = np.array(['r', 'g', 'b', 'c', 'm'] * 2)
+    ax.scatter(np.arange(10), np.arange(10), label='#1', edgecolor=colors)
 
     leg = ax.legend(labelcolor='markeredgecolor')
     for text, color in zip(leg.get_texts(), ['k']):
@@ -970,8 +970,8 @@ def test_legend_pathcollection_labelcolor_markerfacecolor_iterable():
     # test the labelcolor for labelcolor='markerfacecolor' on PathCollection
     # with iterable colors
     fig, ax = plt.subplots()
-    colors = np.random.default_rng().choice(['r', 'g', 'b'], 10)
-    ax.scatter(np.arange(10), np.arange(10)*1, label='#1', facecolor=colors)
+    colors = np.array(['r', 'g', 'b', 'c', 'm'] * 2)
+    ax.scatter(np.arange(10), np.arange(10), label='#1', facecolor=colors)
 
     leg = ax.legend(labelcolor='markerfacecolor')
     for text, color in zip(leg.get_texts(), ['k']):

From ff3e448f0d7183d04c4e353fcb19948e88e5d31f Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Wed, 25 Sep 2024 21:44:15 +0200
Subject: [PATCH 1095/1120] Backport PR #28883: Only check X11 when running
 Tkinter tests

---
 lib/matplotlib/_c_internal_utils.pyi          |  1 +
 lib/matplotlib/cbook.py                       |  2 +-
 lib/matplotlib/tests/test_backend_tk.py       |  4 +--
 .../tests/test_backends_interactive.py        | 10 +++++---
 lib/matplotlib/tests/test_rcparams.py         |  2 +-
 src/_c_internal_utils.cpp                     | 25 ++++++++++++++++++-
 6 files changed, 36 insertions(+), 8 deletions(-)

diff --git a/lib/matplotlib/_c_internal_utils.pyi b/lib/matplotlib/_c_internal_utils.pyi
index 3efc81bc8332..ccc172cde27a 100644
--- a/lib/matplotlib/_c_internal_utils.pyi
+++ b/lib/matplotlib/_c_internal_utils.pyi
@@ -1,4 +1,5 @@
 def display_is_valid() -> bool: ...
+def xdisplay_is_valid() -> bool: ...
 
 def Win32_GetForegroundWindow() -> int | None: ...
 def Win32_SetForegroundWindow(hwnd: int) -> None: ...
diff --git a/lib/matplotlib/cbook.py b/lib/matplotlib/cbook.py
index f5a4199cf9ad..c5b851ff6c9b 100644
--- a/lib/matplotlib/cbook.py
+++ b/lib/matplotlib/cbook.py
@@ -72,7 +72,7 @@ def _get_running_interactive_framework():
                 if frame.f_code in codes:
                     return "tk"
                 frame = frame.f_back
-        # premetively break reference cycle between locals and the frame
+        # Preemptively break reference cycle between locals and the frame.
         del frame
     macosx = sys.modules.get("matplotlib.backends._macosx")
     if macosx and macosx.event_loop_is_running():
diff --git a/lib/matplotlib/tests/test_backend_tk.py b/lib/matplotlib/tests/test_backend_tk.py
index ee20a94042f7..89782e8a66f3 100644
--- a/lib/matplotlib/tests/test_backend_tk.py
+++ b/lib/matplotlib/tests/test_backend_tk.py
@@ -35,8 +35,8 @@ def _isolated_tk_test(success_count, func=None):
         reason="missing tkinter"
     )
     @pytest.mark.skipif(
-        sys.platform == "linux" and not _c_internal_utils.display_is_valid(),
-        reason="$DISPLAY and $WAYLAND_DISPLAY are unset"
+        sys.platform == "linux" and not _c_internal_utils.xdisplay_is_valid(),
+        reason="$DISPLAY is unset"
     )
     @pytest.mark.xfail(  # https://github.com/actions/setup-python/issues/649
         ('TF_BUILD' in os.environ or 'GITHUB_ACTION' in os.environ) and
diff --git a/lib/matplotlib/tests/test_backends_interactive.py b/lib/matplotlib/tests/test_backends_interactive.py
index 2c6b61a48438..ca702bc1d99c 100644
--- a/lib/matplotlib/tests/test_backends_interactive.py
+++ b/lib/matplotlib/tests/test_backends_interactive.py
@@ -57,6 +57,8 @@ def wait_for(self, terminator):
 def _get_available_interactive_backends():
     _is_linux_and_display_invalid = (sys.platform == "linux" and
                                      not _c_internal_utils.display_is_valid())
+    _is_linux_and_xdisplay_invalid = (sys.platform == "linux" and
+                                      not _c_internal_utils.xdisplay_is_valid())
     envs = []
     for deps, env in [
             *[([qt_api],
@@ -74,10 +76,12 @@ def _get_available_interactive_backends():
     ]:
         reason = None
         missing = [dep for dep in deps if not importlib.util.find_spec(dep)]
-        if _is_linux_and_display_invalid:
-            reason = "$DISPLAY and $WAYLAND_DISPLAY are unset"
-        elif missing:
+        if missing:
             reason = "{} cannot be imported".format(", ".join(missing))
+        elif env["MPLBACKEND"] == "tkagg" and _is_linux_and_xdisplay_invalid:
+            reason = "$DISPLAY is unset"
+        elif _is_linux_and_display_invalid:
+            reason = "$DISPLAY and $WAYLAND_DISPLAY are unset"
         elif env["MPLBACKEND"] == 'macosx' and os.environ.get('TF_BUILD'):
             reason = "macosx backend fails on Azure"
         elif env["MPLBACKEND"].startswith('gtk'):
diff --git a/lib/matplotlib/tests/test_rcparams.py b/lib/matplotlib/tests/test_rcparams.py
index 4823df0ce250..25ae258ffcbb 100644
--- a/lib/matplotlib/tests/test_rcparams.py
+++ b/lib/matplotlib/tests/test_rcparams.py
@@ -536,7 +536,7 @@ def test_backend_fallback_headless(tmp_path):
 
 
 @pytest.mark.skipif(
-    sys.platform == "linux" and not _c_internal_utils.display_is_valid(),
+    sys.platform == "linux" and not _c_internal_utils.xdisplay_is_valid(),
     reason="headless")
 def test_backend_fallback_headful(tmp_path):
     pytest.importorskip("tkinter")
diff --git a/src/_c_internal_utils.cpp b/src/_c_internal_utils.cpp
index 74bb97904f89..561cb303639c 100644
--- a/src/_c_internal_utils.cpp
+++ b/src/_c_internal_utils.cpp
@@ -33,7 +33,7 @@ namespace py = pybind11;
 using namespace pybind11::literals;
 
 static bool
-mpl_display_is_valid(void)
+mpl_xdisplay_is_valid(void)
 {
 #ifdef __linux__
     void* libX11;
@@ -57,6 +57,19 @@ mpl_display_is_valid(void)
             return true;
         }
     }
+    return false;
+#else
+    return true;
+#endif
+}
+
+static bool
+mpl_display_is_valid(void)
+{
+#ifdef __linux__
+    if (mpl_xdisplay_is_valid()) {
+        return true;
+    }
     void* libwayland_client;
     if (getenv("WAYLAND_DISPLAY")
         && (libwayland_client = dlopen("libwayland-client.so.0", RTLD_LAZY))) {
@@ -194,6 +207,16 @@ PYBIND11_MODULE(_c_internal_utils, m)
         succeeds, or $WAYLAND_DISPLAY is set and wl_display_connect(NULL)
         succeeds.
 
+        On other platforms, always returns True.)""");
+    m.def(
+        "xdisplay_is_valid", &mpl_xdisplay_is_valid,
+        R"""(        --
+        Check whether the current X11 display is valid.
+
+        On Linux, returns True if either $DISPLAY is set and XOpenDisplay(NULL)
+        succeeds. Use this function if you need to specifically check for X11
+        only (e.g., for Tkinter).
+
         On other platforms, always returns True.)""");
     m.def(
         "Win32_GetCurrentProcessExplicitAppUserModelID",

From 00f63b745f453f5e736b62d978df95ac9ee68f6b Mon Sep 17 00:00:00 2001
From: Kyra Cho <wsc2119@columbia.edu>
Date: Fri, 27 Sep 2024 16:55:12 -0700
Subject: [PATCH 1096/1120] Backport PR #28881: Fix `axline` for slopes <=
 1E-8. Closes #28386

---
 lib/matplotlib/lines.py            |  2 +-
 lib/matplotlib/tests/test_lines.py | 11 +++++++++++
 2 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/lines.py b/lib/matplotlib/lines.py
index 72e74f4eb9c5..569669f76e8d 100644
--- a/lib/matplotlib/lines.py
+++ b/lib/matplotlib/lines.py
@@ -1520,7 +1520,7 @@ def get_transform(self):
         (vxlo, vylo), (vxhi, vyhi) = ax.transScale.transform(ax.viewLim)
         # General case: find intersections with view limits in either
         # direction, and draw between the middle two points.
-        if np.isclose(slope, 0):
+        if slope == 0:
             start = vxlo, y1
             stop = vxhi, y1
         elif np.isinf(slope):
diff --git a/lib/matplotlib/tests/test_lines.py b/lib/matplotlib/tests/test_lines.py
index 531237b2ba28..902b7aa2c02d 100644
--- a/lib/matplotlib/tests/test_lines.py
+++ b/lib/matplotlib/tests/test_lines.py
@@ -436,3 +436,14 @@ def test_axline_setters():
     with pytest.raises(ValueError,
                        match="Cannot set a 'slope' value while 'xy2' is set"):
         line2.set_slope(3)
+
+
+def test_axline_small_slope():
+    """Test that small slopes are not coerced to zero in the transform."""
+    line = plt.axline((0, 0), slope=1e-14)
+    p1 = line.get_transform().transform_point((0, 0))
+    p2 = line.get_transform().transform_point((1, 1))
+    # y-values must be slightly different
+    dy = p2[1] - p1[1]
+    assert dy > 0
+    assert dy < 4e-12

From ab09fcc97c9ad791ba41dcfdd4276f634585263a Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Thu, 15 Aug 2024 13:36:36 +0200
Subject: [PATCH 1097/1120] Backport PR #28689: ci: Enable testing on Python
 3.13

---
 .github/workflows/tests.yml                   | 54 +++++++++++++++++--
 lib/matplotlib/tests/test_axes.py             |  4 +-
 lib/matplotlib/tests/test_contour.py          |  2 +-
 lib/mpl_toolkits/mplot3d/tests/test_axes3d.py |  2 +-
 4 files changed, 54 insertions(+), 8 deletions(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 634c83fa57fd..cd4c08e29fb9 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -88,14 +88,31 @@ jobs:
             pyqt6-ver: '!=6.6.0'
             # https://bugreports.qt.io/projects/PYSIDE/issues/PYSIDE-2346
             pyside6-ver: '!=6.5.1'
-          - os: macos-12  # This runnre is on Intel chips.
-            python-version: 3.9
+          - os: ubuntu-22.04
+            python-version: '3.13'
+            # https://www.riverbankcomputing.com/pipermail/pyqt/2023-November/045606.html
+            pyqt6-ver: '!=6.6.0'
+            # https://bugreports.qt.io/projects/PYSIDE/issues/PYSIDE-2346
+            pyside6-ver: '!=6.5.1'
+          - name-suffix: "Free-threaded"
+            os: ubuntu-22.04
+            python-version: '3.13t'
+            # https://www.riverbankcomputing.com/pipermail/pyqt/2023-November/045606.html
+            pyqt6-ver: '!=6.6.0'
+            # https://bugreports.qt.io/projects/PYSIDE/issues/PYSIDE-2346
+            pyside6-ver: '!=6.5.1'
+          - os: macos-12  # This runner is on Intel chips.
+            python-version: '3.9'
             # https://bugreports.qt.io/projects/PYSIDE/issues/PYSIDE-2346
             pyside6-ver: '!=6.5.1'
           - os: macos-14  # This runner is on M1 (arm64) chips.
             python-version: '3.12'
             # https://bugreports.qt.io/projects/PYSIDE/issues/PYSIDE-2346
             pyside6-ver: '!=6.5.1'
+          - os: macos-14  # This runner is on M1 (arm64) chips.
+            python-version: '3.13'
+            # https://bugreports.qt.io/projects/PYSIDE/issues/PYSIDE-2346
+            pyside6-ver: '!=6.5.1'
 
     steps:
       - uses: actions/checkout@v4
@@ -104,8 +121,17 @@ jobs:
 
       - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v5
+        if: matrix.python-version != '3.13t'
         with:
           python-version: ${{ matrix.python-version }}
+          allow-prereleases: true
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: deadsnakes/action@6c8b9b82fe0b4344f4b98f2775fcc395df45e494  # v3.1.0
+        if: matrix.python-version == '3.13t'
+        with:
+          python-version: '3.13'
+          nogil: true
 
       - name: Install OS dependencies
         run: |
@@ -152,6 +178,11 @@ jobs:
               texlive-luatex \
               texlive-pictures \
               texlive-xetex
+            if [[ "${{ matrix.python-version }}" = '3.13t' ]]; then
+              # TODO: Remove this once setup-python supports nogil distributions.
+              sudo apt-get install -yy --no-install-recommends \
+                python3.13-tk-nogil
+            fi
             if [[ "${{ matrix.os }}" = ubuntu-20.04 ]]; then
               sudo apt-get install -yy --no-install-recommends libopengl0
             else  # ubuntu-22.04
@@ -202,6 +233,15 @@ jobs:
             4-${{ runner.os }}-py${{ matrix.python-version }}-mpl-${{ github.ref }}-
             4-${{ runner.os }}-py${{ matrix.python-version }}-mpl-
 
+      - name: Install the nightly dependencies
+        if: matrix.python-version == '3.13t'
+        run: |
+          python -m pip install pytz tzdata python-dateutil  # Must be installed for Pandas.
+          python -m pip install \
+              --pre \
+              --index-url https://pypi.anaconda.org/scientific-python-nightly-wheels/simple \
+              --upgrade --only-binary=:all: numpy pandas pillow contourpy
+
       - name: Install Python dependencies
         run: |
           # Upgrade pip and setuptools and wheel to get as clean an install as
@@ -227,6 +267,7 @@ jobs:
           # Sphinx is needed to run sphinxext tests
           python -m pip install --upgrade sphinx!=6.1.2
 
+          if [[ "${{ matrix.python-version }}" != '3.13t' ]]; then
           # GUI toolkits are pip-installable only for some versions of Python
           # so don't fail if we can't install them.  Make it easier to check
           # whether the install was successful by trying to import the toolkit
@@ -246,11 +287,11 @@ jobs:
             python -c 'import PyQt5.QtCore' &&
             echo 'PyQt5 is available' ||
             echo 'PyQt5 is not available'
-          # Even though PySide2 wheels can be installed on Python 3.12, they are broken and since PySide2 is
+          # Even though PySide2 wheels can be installed on Python 3.12+, they are broken and since PySide2 is
           # deprecated, they are unlikely to be fixed. For the same deprecation reason, there are no wheels
           # on M1 macOS, so don't bother there either.
           if [[ "${{ matrix.os }}" != 'macos-14'
-                && "${{ matrix.python-version }}" != '3.12' ]]; then
+                && "${{ matrix.python-version }}" != '3.12' && "${{ matrix.python-version }}" != '3.13' ]]; then
             python -mpip install --upgrade pyside2${{ matrix.pyside2-ver }} &&
               python -c 'import PySide2.QtCore' &&
               echo 'PySide2 is available' ||
@@ -272,6 +313,8 @@ jobs:
             echo 'wxPython is available' ||
             echo 'wxPython is not available'
 
+          fi  # Skip backends on Python 3.13t.
+
       - name: Install the nightly dependencies
         # Only install the nightly dependencies during the scheduled event
         if: github.event_name == 'schedule' && matrix.name-suffix != '(Minimum Versions)'
@@ -310,6 +353,9 @@ jobs:
 
       - name: Run pytest
         run: |
+          if [[ "${{ matrix.python-version }}" == '3.13t' ]]; then
+            export PYTHON_GIL=0
+          fi
           pytest -rfEsXR -n auto \
             --maxfail=50 --timeout=300 --durations=25 \
             --cov-report=xml --cov=lib --log-level=DEBUG --color=yes
diff --git a/lib/matplotlib/tests/test_axes.py b/lib/matplotlib/tests/test_axes.py
index 3ec9923c0840..e99ef129eb9a 100644
--- a/lib/matplotlib/tests/test_axes.py
+++ b/lib/matplotlib/tests/test_axes.py
@@ -1186,7 +1186,7 @@ def test_imshow():
 
 @image_comparison(
     ['imshow_clip'], style='mpl20',
-    tol=1.24 if platform.machine() in ('aarch64', 'ppc64le', 's390x') else 0)
+    tol=1.24 if platform.machine() in ('aarch64', 'arm64', 'ppc64le', 's390x') else 0)
 def test_imshow_clip():
     # As originally reported by Gellule Xg <gellule.xg@free.fr>
     # use former defaults to match existing baseline image
@@ -2570,7 +2570,7 @@ def test_contour_hatching():
 
 @image_comparison(
     ['contour_colorbar'], style='mpl20',
-    tol=0.54 if platform.machine() in ('aarch64', 'ppc64le', 's390x') else 0)
+    tol=0.54 if platform.machine() in ('aarch64', 'arm64', 'ppc64le', 's390x') else 0)
 def test_contour_colorbar():
     x, y, z = contour_dat()
 
diff --git a/lib/matplotlib/tests/test_contour.py b/lib/matplotlib/tests/test_contour.py
index d4600a14fe1c..0622c099a20c 100644
--- a/lib/matplotlib/tests/test_contour.py
+++ b/lib/matplotlib/tests/test_contour.py
@@ -442,7 +442,7 @@ def test_contourf_log_extension(split_collections):
 @pytest.mark.parametrize("split_collections", [False, True])
 @image_comparison(
     ['contour_addlines.png'], remove_text=True, style='mpl20',
-    tol=0.15 if platform.machine() in ('aarch64', 'ppc64le', 's390x')
+    tol=0.15 if platform.machine() in ('aarch64', 'arm64', 'ppc64le', 's390x')
         else 0.03)
 # tolerance is because image changed minutely when tick finding on
 # colorbars was cleaned up...
diff --git a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
index ecb51b724c27..ff5ab230ef06 100644
--- a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
@@ -221,7 +221,7 @@ def test_bar3d_lightsource():
 
 @mpl3d_image_comparison(
     ['contour3d.png'], style='mpl20',
-    tol=0.002 if platform.machine() in ('aarch64', 'ppc64le', 's390x') else 0)
+    tol=0.002 if platform.machine() in ('aarch64', 'arm64', 'ppc64le', 's390x') else 0)
 def test_contour3d():
     plt.rcParams['axes3d.automargin'] = True  # Remove when image is regenerated
     fig = plt.figure()

From fad3579287324c16daeb8719af68ccb58fe1b94b Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 4 Oct 2024 05:02:26 -0400
Subject: [PATCH 1098/1120] Backport PR #28900: DOC: Improve fancybox demo

---
 .../shapes_and_collections/fancybox_demo.py   | 84 ++++++++++++++-----
 1 file changed, 63 insertions(+), 21 deletions(-)

diff --git a/galleries/examples/shapes_and_collections/fancybox_demo.py b/galleries/examples/shapes_and_collections/fancybox_demo.py
index 91cc1d1749ea..8d36a5a14d9d 100644
--- a/galleries/examples/shapes_and_collections/fancybox_demo.py
+++ b/galleries/examples/shapes_and_collections/fancybox_demo.py
@@ -3,7 +3,8 @@
 Drawing fancy boxes
 ===================
 
-The following examples show how to plot boxes with different visual properties.
+The following examples show how to plot boxes (`.FancyBboxPatch`) with different
+visual properties.
 """
 
 import inspect
@@ -15,7 +16,12 @@
 import matplotlib.transforms as mtransforms
 
 # %%
-# First we'll show some sample boxes with fancybox.
+# Box styles
+# ----------
+# `.FancyBboxPatch` supports different `.BoxStyle`\s. Note that `~.Axes.text`
+# allows to draw a box around the text by adding the ``bbox`` parameter. Therefore,
+# you don't see explicit `.FancyBboxPatch` and `.BoxStyle` calls in the following
+# example.
 
 styles = mpatch.BoxStyle.get_styles()
 ncol = 2
@@ -41,13 +47,21 @@
 
 
 # %%
-# Next we'll show off multiple fancy boxes at once.
-
+# Parameters for modifying the box
+# --------------------------------
+# `.BoxStyle`\s have additional parameters to configure their appearance.
+# For example, "round" boxes can have ``pad`` and ``rounding``.
+#
+# Additionally, the `.FancyBboxPatch` parameters ``mutation_scale`` and
+# ``mutation_aspect`` scale the box appearance.
 
 def add_fancy_patch_around(ax, bb, **kwargs):
-    fancy = FancyBboxPatch(bb.p0, bb.width, bb.height,
-                           fc=(1, 0.8, 1, 0.5), ec=(1, 0.5, 1, 0.5),
-                           **kwargs)
+    kwargs = {
+        'facecolor': (1, 0.8, 1, 0.5),
+        'edgecolor': (1, 0.5, 1, 0.5),
+        **kwargs
+    }
+    fancy = FancyBboxPatch(bb.p0, bb.width, bb.height, **kwargs)
     ax.add_patch(fancy)
     return fancy
 
@@ -65,7 +79,7 @@ def draw_control_points_for_patches(ax):
 
 ax = axs[0, 0]
 # a fancy box with round corners. pad=0.1
-fancy = add_fancy_patch_around(ax, bb, boxstyle="round,pad=0.1")
+add_fancy_patch_around(ax, bb, boxstyle="round,pad=0.1")
 ax.set(xlim=(0, 1), ylim=(0, 1), aspect=1,
        title='boxstyle="round,pad=0.1"')
 
@@ -84,33 +98,61 @@ def draw_control_points_for_patches(ax):
 ax = axs[1, 0]
 # mutation_scale determines the overall scale of the mutation, i.e. both pad
 # and rounding_size is scaled according to this value.
-fancy = add_fancy_patch_around(
-    ax, bb, boxstyle="round,pad=0.1", mutation_scale=2)
+add_fancy_patch_around(ax, bb, boxstyle="round,pad=0.1", mutation_scale=2)
 ax.set(xlim=(0, 1), ylim=(0, 1), aspect=1,
        title='boxstyle="round,pad=0.1"\n mutation_scale=2')
 
 ax = axs[1, 1]
-# When the aspect ratio of the Axes is not 1, the fancy box may not be what you
-# expected (green).
-fancy = add_fancy_patch_around(ax, bb, boxstyle="round,pad=0.2")
-fancy.set(facecolor="none", edgecolor="green")
-# You can compensate this by setting the mutation_aspect (pink).
-fancy = add_fancy_patch_around(
-    ax, bb, boxstyle="round,pad=0.3", mutation_aspect=0.5)
-ax.set(xlim=(-.5, 1.5), ylim=(0, 1), aspect=2,
-       title='boxstyle="round,pad=0.3"\nmutation_aspect=.5')
+# mutation_aspect scales the vertical influence of the parameters (technically,
+# it scales the height of the box down by mutation_aspect, applies the box parameters
+# and scales the result back up). In effect, the vertical pad is scaled to
+# pad * mutation_aspect, e.g. mutation_aspect=0.5 halves the vertical pad.
+add_fancy_patch_around(ax, bb, boxstyle="round,pad=0.1", mutation_aspect=0.5)
+ax.set(xlim=(0, 1), ylim=(0, 1),
+       title='boxstyle="round,pad=0.1"\nmutation_aspect=0.5')
 
 for ax in axs.flat:
     draw_control_points_for_patches(ax)
     # Draw the original bbox (using boxstyle=square with pad=0).
-    fancy = add_fancy_patch_around(ax, bb, boxstyle="square,pad=0")
-    fancy.set(edgecolor="black", facecolor="none", zorder=10)
+    add_fancy_patch_around(ax, bb, boxstyle="square,pad=0",
+                           edgecolor="black", facecolor="none", zorder=10)
 
 fig.tight_layout()
 
 
 plt.show()
 
+# %%
+# Creating visually constant padding on non-equal aspect Axes
+# -----------------------------------------------------------
+# Since padding is in box coordinates, i.e. usually data coordinates,
+# a given padding is rendered to different visual sizes if the
+# Axes aspect is not 1.
+# To get visually equal vertical and horizontal padding, set the
+# mutation_aspect to the inverse of the Axes aspect. This scales
+# the vertical padding appropriately.
+
+fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(6.5, 5))
+
+# original boxes
+bb = mtransforms.Bbox([[-0.5, -0.5], [0.5, 0.5]])
+add_fancy_patch_around(ax1, bb, boxstyle="square,pad=0",
+                       edgecolor="black", facecolor="none", zorder=10)
+add_fancy_patch_around(ax2, bb, boxstyle="square,pad=0",
+                       edgecolor="black", facecolor="none", zorder=10)
+ax1.set(xlim=(-1.5, 1.5), ylim=(-1.5, 1.5), aspect=2)
+ax2.set(xlim=(-1.5, 1.5), ylim=(-1.5, 1.5), aspect=2)
+
+
+fancy = add_fancy_patch_around(
+    ax1, bb, boxstyle="round,pad=0.5")
+ax1.set_title("aspect=2\nmutation_aspect=1")
+
+fancy = add_fancy_patch_around(
+    ax2, bb, boxstyle="round,pad=0.5", mutation_aspect=0.5)
+ax2.set_title("aspect=2\nmutation_aspect=0.5")
+
+
 # %%
 #
 # .. admonition:: References

From 97ea6ef94d0e67271fda0853b55aaf8c077ae4df Mon Sep 17 00:00:00 2001
From: "Lumberbot (aka Jack)"
 <39504233+meeseeksmachine@users.noreply.github.com>
Date: Wed, 9 Oct 2024 12:07:04 -0700
Subject: [PATCH 1099/1120] Backport PR #28952: BLD: update trove metadata to
 support py3.13 (#28954)

Co-authored-by: Greg Lucas <greg.m.lucas@gmail.com>
---
 pyproject.toml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/pyproject.toml b/pyproject.toml
index 891ef87e4342..c0237c7df5c5 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -20,6 +20,7 @@ classifiers=[
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
     "Topic :: Scientific/Engineering :: Visualization",
 ]
 

From 7fd3b7ba4aae22d6defd14d1cbb69e562d7f4522 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Thu, 17 Oct 2024 21:04:14 +0200
Subject: [PATCH 1100/1120] Backport PR #28987: Fix: Do not use numeric
 tolerances for axline special cases

---
 lib/matplotlib/lines.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/lines.py b/lib/matplotlib/lines.py
index 569669f76e8d..d24e528e4c0a 100644
--- a/lib/matplotlib/lines.py
+++ b/lib/matplotlib/lines.py
@@ -1505,8 +1505,8 @@ def get_transform(self):
                 points_transform.transform([self._xy1, self._xy2])
             dx = x2 - x1
             dy = y2 - y1
-            if np.allclose(x1, x2):
-                if np.allclose(y1, y2):
+            if dx == 0:
+                if dy == 0:
                     raise ValueError(
                         f"Cannot draw a line through two identical points "
                         f"(x={(x1, x2)}, y={(y1, y2)})")

From c2116dea25226d756b55e55489a53f73b89cdf97 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Thu, 17 Oct 2024 15:07:00 -0400
Subject: [PATCH 1101/1120] Backport PR #28972: Switch macOS 12 runner images
 to macOS 13

---
 .github/workflows/cibuildwheel.yml |  2 +-
 .github/workflows/tests.yml        | 13 ++++++++++++-
 azure-pipelines.yml                | 11 +++++++++++
 3 files changed, 24 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index 9de63b14c4fd..a145b5bbcc08 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -124,7 +124,7 @@ jobs:
             cibw_archs: "aarch64"
           - os: windows-latest
             cibw_archs: "auto64"
-          - os: macos-12
+          - os: macos-13
             cibw_archs: "x86_64"
           - os: macos-14
             cibw_archs: "arm64"
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index cd4c08e29fb9..4100fda43a36 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -101,7 +101,7 @@ jobs:
             pyqt6-ver: '!=6.6.0'
             # https://bugreports.qt.io/projects/PYSIDE/issues/PYSIDE-2346
             pyside6-ver: '!=6.5.1'
-          - os: macos-12  # This runner is on Intel chips.
+          - os: macos-13  # This runner is on Intel chips.
             python-version: '3.9'
             # https://bugreports.qt.io/projects/PYSIDE/issues/PYSIDE-2346
             pyside6-ver: '!=6.5.1'
@@ -192,6 +192,17 @@ jobs:
             ;;
           macOS)
             brew update
+            # Periodically, Homebrew updates Python and fails to overwrite the
+            # existing not-managed-by-Homebrew copy without explicitly being told
+            # to do so. GitHub/Azure continues to avoid fixing their runner images:
+            # https://github.com/actions/runner-images/issues/9966
+            # so force an overwrite even if there are no Python updates.
+            # We don't even care about Homebrew's Python because we use the one
+            # from actions/setup-python.
+            for python_package in $(brew list | grep python@); do
+              brew unlink ${python_package}
+              brew link --overwrite ${python_package}
+            done
             brew install ccache ghostscript gobject-introspection gtk4 ninja
             brew install --cask font-noto-sans-cjk inkscape
             ;;
diff --git a/azure-pipelines.yml b/azure-pipelines.yml
index 4c50c543846a..e2829ce81e9f 100644
--- a/azure-pipelines.yml
+++ b/azure-pipelines.yml
@@ -120,6 +120,17 @@ stages:
                 ;;
               Darwin)
                 brew update
+                # Periodically, Homebrew updates Python and fails to overwrite the
+                # existing not-managed-by-Homebrew copy without explicitly being told
+                # to do so. GitHub/Azure continues to avoid fixing their runner images:
+                # https://github.com/actions/runner-images/issues/9966
+                # so force an overwrite even if there are no Python updates.
+                # We don't even care about Homebrew's Python because we use the one
+                # from UsePythonVersion.
+                for python_package in $(brew list | grep python@); do
+                  brew unlink ${python_package}
+                  brew link --overwrite ${python_package}
+                done
                 brew install --cask xquartz
                 brew install ccache ffmpeg imagemagick mplayer ninja pkg-config
                 brew install --cask font-noto-sans-cjk-sc

From 1f1901baa5ce5788eba5feb63ae12df2eac84975 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Mon, 7 Oct 2024 16:08:48 +0200
Subject: [PATCH 1102/1120] Backport PR #28925: TST: handle change in
 pytest.importorskip behavior

---
 lib/matplotlib/tests/test_rcparams.py         | 8 +++++++-
 lib/mpl_toolkits/mplot3d/tests/test_axes3d.py | 3 ++-
 2 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/lib/matplotlib/tests/test_rcparams.py b/lib/matplotlib/tests/test_rcparams.py
index 25ae258ffcbb..0aa3ec0ba603 100644
--- a/lib/matplotlib/tests/test_rcparams.py
+++ b/lib/matplotlib/tests/test_rcparams.py
@@ -5,6 +5,7 @@
 from unittest import mock
 
 from cycler import cycler, Cycler
+from packaging.version import parse as parse_version
 import pytest
 
 import matplotlib as mpl
@@ -539,7 +540,12 @@ def test_backend_fallback_headless(tmp_path):
     sys.platform == "linux" and not _c_internal_utils.xdisplay_is_valid(),
     reason="headless")
 def test_backend_fallback_headful(tmp_path):
-    pytest.importorskip("tkinter")
+    if parse_version(pytest.__version__) >= parse_version('8.2.0'):
+        pytest_kwargs = dict(exc_type=ImportError)
+    else:
+        pytest_kwargs = {}
+
+    pytest.importorskip("tkinter", **pytest_kwargs)
     env = {**os.environ, "MPLBACKEND": "", "MPLCONFIGDIR": str(tmp_path)}
     backend = subprocess_run_for_testing(
         [sys.executable, "-c",
diff --git a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
index ff5ab230ef06..20b8dcd432db 100644
--- a/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
+++ b/lib/mpl_toolkits/mplot3d/tests/test_axes3d.py
@@ -1,6 +1,7 @@
 import functools
 import itertools
 import platform
+import sys
 
 import pytest
 
@@ -114,7 +115,7 @@ def test_axes3d_repr():
 
 
 @mpl3d_image_comparison(['axes3d_primary_views.png'], style='mpl20',
-                        tol=0.05 if platform.machine() == "arm64" else 0)
+                        tol=0.05 if sys.platform == "darwin" else 0)
 def test_axes3d_primary_views():
     # (elev, azim, roll)
     views = [(90, -90, 0),  # XY

From 7b547eacebb0d854152e0e5d1afb3edc5da5ee4d Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Mon, 21 Oct 2024 22:09:44 +0100
Subject: [PATCH 1103/1120] Backport PR #28993: FIX: contourf hatches use
 multiple edgecolors

---
 lib/matplotlib/contour.py                       |   4 ++++
 .../test_contour/contourf_hatch_colors.png      | Bin 0 -> 19765 bytes
 lib/matplotlib/tests/test_contour.py            |   8 ++++++++
 3 files changed, 12 insertions(+)
 create mode 100644 lib/matplotlib/tests/baseline_images/test_contour/contourf_hatch_colors.png

diff --git a/lib/matplotlib/contour.py b/lib/matplotlib/contour.py
index 0e6068c64b62..3b2bf3843f4d 100644
--- a/lib/matplotlib/contour.py
+++ b/lib/matplotlib/contour.py
@@ -1415,12 +1415,16 @@ def draw(self, renderer):
             super().draw(renderer)
             return
         # In presence of hatching, draw contours one at a time.
+        edgecolors = self.get_edgecolors()
+        if edgecolors.size == 0:
+            edgecolors = ("none",)
         for idx in range(n_paths):
             with cbook._setattr_cm(self, _paths=[paths[idx]]), self._cm_set(
                 hatch=self.hatches[idx % len(self.hatches)],
                 array=[self.get_array()[idx]],
                 linewidths=[self.get_linewidths()[idx % len(self.get_linewidths())]],
                 linestyles=[self.get_linestyles()[idx % len(self.get_linestyles())]],
+                edgecolors=edgecolors[idx % len(edgecolors)],
             ):
                 super().draw(renderer)
 
diff --git a/lib/matplotlib/tests/baseline_images/test_contour/contourf_hatch_colors.png b/lib/matplotlib/tests/baseline_images/test_contour/contourf_hatch_colors.png
new file mode 100644
index 0000000000000000000000000000000000000000..18d949773ded79b5e931e035032c7f0ee590cd6b
GIT binary patch
literal 19765
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
I>2%@$0rsu9f&c&j

literal 0
HcmV?d00001

diff --git a/lib/matplotlib/tests/test_contour.py b/lib/matplotlib/tests/test_contour.py
index 0622c099a20c..a3e00c30ce97 100644
--- a/lib/matplotlib/tests/test_contour.py
+++ b/lib/matplotlib/tests/test_contour.py
@@ -198,6 +198,14 @@ def test_given_colors_levels_and_extends(split_collections):
     _maybe_split_collections(split_collections)
 
 
+@image_comparison(['contourf_hatch_colors'],
+                  remove_text=True, style='mpl20', extensions=['png'])
+def test_hatch_colors():
+    fig, ax = plt.subplots()
+    cf = ax.contourf([[0, 1], [1, 2]], hatches=['-', '/', '\\', '//'], cmap='gray')
+    cf.set_edgecolors(["blue", "grey", "yellow", "red"])
+
+
 @pytest.mark.parametrize("split_collections", [False, True])
 @image_comparison(['contour_log_locator.svg'], style='mpl20', remove_text=False)
 def test_log_locator_levels(split_collections):

From 3cf5e95e1c98e5ab3ba955606b2bfd1aa324b911 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Tue, 22 Oct 2024 11:24:26 +0200
Subject: [PATCH 1104/1120] Backport PR #29005: DOC: Update meson-python
 intersphinx link

---
 doc/conf.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/conf.py b/doc/conf.py
index 8036edec9989..04f48204eb77 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -241,7 +241,7 @@ def _check_dependencies():
     'scipy': ('https://docs.scipy.org/doc/scipy/', None),
     'tornado': ('https://www.tornadoweb.org/en/stable/', None),
     'xarray': ('https://docs.xarray.dev/en/stable/', None),
-    'meson-python': ('https://meson-python.readthedocs.io/en/stable/', None)
+    'meson-python': ('https://mesonbuild.com/meson-python/', None),
 }
 
 

From f3df3a16d1dce3770555d94a386b3f8587f8feba Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Thu, 24 Oct 2024 07:02:26 +0200
Subject: [PATCH 1105/1120] Backport PR #29014: FIX: fake out setuptools scm in
 tox on ci

---
 tox.ini | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/tox.ini b/tox.ini
index cb2fcc979076..a4fbbd1793ff 100644
--- a/tox.ini
+++ b/tox.ini
@@ -12,6 +12,8 @@ setenv =
     MPLCONFIGDIR={envtmpdir}/.matplotlib
     PIP_USER = 0
     PIP_ISOLATED = 1
+    SETUPTOOLS_SCM_PRETEND_VERSION_FOR_MATPLOTLIB = 0.0.0
+
 usedevelop = True
 commands =
     pytest --pyargs matplotlib {posargs}

From 5882c882d67ef134a6ad758f3f54cb43c25cb05b Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Mon, 28 Oct 2024 18:49:26 -0400
Subject: [PATCH 1106/1120] Backport PR #27569: DOC: initial tags for
 statistics section of gallery

---
 galleries/examples/statistics/boxplot.py                 | 2 ++
 galleries/examples/statistics/boxplot_color.py           | 2 ++
 galleries/examples/statistics/boxplot_demo.py            | 2 ++
 galleries/examples/statistics/boxplot_vs_violin.py       | 2 ++
 galleries/examples/statistics/bxp.py                     | 2 ++
 galleries/examples/statistics/confidence_ellipse.py      | 8 ++++++++
 galleries/examples/statistics/customized_violin.py       | 2 ++
 galleries/examples/statistics/errorbar.py                | 3 +++
 galleries/examples/statistics/errorbar_features.py       | 2 ++
 galleries/examples/statistics/errorbar_limits.py         | 2 ++
 galleries/examples/statistics/errorbars_and_boxes.py     | 8 ++++++++
 galleries/examples/statistics/hexbin_demo.py             | 2 ++
 galleries/examples/statistics/hist.py                    | 9 +++++++++
 galleries/examples/statistics/histogram_bihistogram.py   | 4 ++++
 galleries/examples/statistics/histogram_cumulative.py    | 2 ++
 galleries/examples/statistics/histogram_histtypes.py     | 2 ++
 galleries/examples/statistics/histogram_multihist.py     | 2 ++
 galleries/examples/statistics/histogram_normalization.py | 2 ++
 .../statistics/multiple_histograms_side_by_side.py       | 7 +++++++
 galleries/examples/statistics/time_series_histogram.py   | 8 ++++++++
 galleries/examples/statistics/violinplot.py              | 2 ++
 21 files changed, 75 insertions(+)

diff --git a/galleries/examples/statistics/boxplot.py b/galleries/examples/statistics/boxplot.py
index ccdaab97d24a..6d30cbd4b5f0 100644
--- a/galleries/examples/statistics/boxplot.py
+++ b/galleries/examples/statistics/boxplot.py
@@ -97,6 +97,8 @@
 
 # %%
 #
+# .. tags:: plot-type: boxplot, domain: statistics
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/boxplot_color.py b/galleries/examples/statistics/boxplot_color.py
index 3491253aaf3e..acdb37d7d520 100644
--- a/galleries/examples/statistics/boxplot_color.py
+++ b/galleries/examples/statistics/boxplot_color.py
@@ -36,6 +36,8 @@
 
 # %%
 #
+# .. tags:: styling: color, domain: statistics, plot-type: boxplot
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/boxplot_demo.py b/galleries/examples/statistics/boxplot_demo.py
index eca0e152078e..ec23408c0bfc 100644
--- a/galleries/examples/statistics/boxplot_demo.py
+++ b/galleries/examples/statistics/boxplot_demo.py
@@ -247,6 +247,8 @@ def fake_bootstrapper(n):
 
 # %%
 #
+# .. tags:: domain: statistics, plot-type: boxplot
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/boxplot_vs_violin.py b/galleries/examples/statistics/boxplot_vs_violin.py
index dce8912013b0..f277e737e65c 100644
--- a/galleries/examples/statistics/boxplot_vs_violin.py
+++ b/galleries/examples/statistics/boxplot_vs_violin.py
@@ -54,6 +54,8 @@
 
 # %%
 #
+# .. tags:: plot-type: violin, plot-type: boxplot, domain: statistics
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/bxp.py b/galleries/examples/statistics/bxp.py
index b12bfebd16cc..3ddd164df742 100644
--- a/galleries/examples/statistics/bxp.py
+++ b/galleries/examples/statistics/bxp.py
@@ -64,6 +64,8 @@
 
 # %%
 #
+# .. tags:: plot-type: speciality, domain: statistics
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/confidence_ellipse.py b/galleries/examples/statistics/confidence_ellipse.py
index 27b06146a44e..4ac0917f4bda 100644
--- a/galleries/examples/statistics/confidence_ellipse.py
+++ b/galleries/examples/statistics/confidence_ellipse.py
@@ -217,6 +217,14 @@ def get_correlated_dataset(n, dependency, mu, scale):
 
 # %%
 #
+# .. tags::
+#
+#    plot-type: speciality
+#    plot-type: scatter
+#    component: ellipse
+#    component: patch
+#    domain: statistics
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/customized_violin.py b/galleries/examples/statistics/customized_violin.py
index c1d2e432ca2e..29ddcda92fbe 100644
--- a/galleries/examples/statistics/customized_violin.py
+++ b/galleries/examples/statistics/customized_violin.py
@@ -73,6 +73,8 @@ def set_axis_style(ax, labels):
 
 # %%
 #
+# .. tags:: plot-type: violin, domain: statistics
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/errorbar.py b/galleries/examples/statistics/errorbar.py
index a25cadf88211..019590dc3f32 100644
--- a/galleries/examples/statistics/errorbar.py
+++ b/galleries/examples/statistics/errorbar.py
@@ -21,6 +21,9 @@
 
 # %%
 #
+#
+# .. tags:: plot-type: errorbar, domain: statistics,
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/errorbar_features.py b/galleries/examples/statistics/errorbar_features.py
index 349cc89ff2e0..8abaffcda537 100644
--- a/galleries/examples/statistics/errorbar_features.py
+++ b/galleries/examples/statistics/errorbar_features.py
@@ -48,6 +48,8 @@
 
 # %%
 #
+# .. tags:: plot-type: errorbar, domain: statistics
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/errorbar_limits.py b/galleries/examples/statistics/errorbar_limits.py
index d5b0e476d894..f1d26460d947 100644
--- a/galleries/examples/statistics/errorbar_limits.py
+++ b/galleries/examples/statistics/errorbar_limits.py
@@ -77,6 +77,8 @@
 
 # %%
 #
+# .. tags:: plot-type: errorbar, domain: statistics
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/errorbars_and_boxes.py b/galleries/examples/statistics/errorbars_and_boxes.py
index 54c8786096c7..b45eee751137 100644
--- a/galleries/examples/statistics/errorbars_and_boxes.py
+++ b/galleries/examples/statistics/errorbars_and_boxes.py
@@ -71,6 +71,14 @@ def make_error_boxes(ax, xdata, ydata, xerror, yerror, facecolor='r',
 
 # %%
 #
+#
+# .. tags::
+#
+#    plot-type: errorbar
+#    component: rectangle
+#    component: patchcollection
+#    domain: statistics
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/hexbin_demo.py b/galleries/examples/statistics/hexbin_demo.py
index b9a6206a934f..bd1522772aae 100644
--- a/galleries/examples/statistics/hexbin_demo.py
+++ b/galleries/examples/statistics/hexbin_demo.py
@@ -35,6 +35,8 @@
 
 # %%
 #
+# .. tags:: plot-type: histogram, plot-type: hexbin, domain: statistics
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/hist.py b/galleries/examples/statistics/hist.py
index 8b06093913df..e31aca0228c2 100644
--- a/galleries/examples/statistics/hist.py
+++ b/galleries/examples/statistics/hist.py
@@ -103,6 +103,15 @@
 
 # %%
 #
+# .. tags::
+#
+#    plot-type: histogram,
+#    plot-type: histogram2d
+#    domain: statistics
+#    styling: color,
+#    component: normalization
+#    component: patch
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/histogram_bihistogram.py b/galleries/examples/statistics/histogram_bihistogram.py
index 7bfae14e9285..73f549493438 100644
--- a/galleries/examples/statistics/histogram_bihistogram.py
+++ b/galleries/examples/statistics/histogram_bihistogram.py
@@ -43,3 +43,7 @@
 ax.legend()
 
 plt.show()
+
+# %%
+#
+# .. tags:: plot-type: histogram, domain: statistics, purpose: showcase
diff --git a/galleries/examples/statistics/histogram_cumulative.py b/galleries/examples/statistics/histogram_cumulative.py
index 9ce16568d126..d87305629f8d 100644
--- a/galleries/examples/statistics/histogram_cumulative.py
+++ b/galleries/examples/statistics/histogram_cumulative.py
@@ -67,6 +67,8 @@
 
 # %%
 #
+# .. tags:: plot-type: ecdf, plot-type: histogram, domain: statistics
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/histogram_histtypes.py b/galleries/examples/statistics/histogram_histtypes.py
index 0188d7bf5d0f..53d6425cf4dc 100644
--- a/galleries/examples/statistics/histogram_histtypes.py
+++ b/galleries/examples/statistics/histogram_histtypes.py
@@ -51,6 +51,8 @@
 
 # %%
 #
+# .. tags:: plot-type: histogram, domain: statistics, purpose: reference
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/histogram_multihist.py b/galleries/examples/statistics/histogram_multihist.py
index f1957dc38939..78ff03719057 100644
--- a/galleries/examples/statistics/histogram_multihist.py
+++ b/galleries/examples/statistics/histogram_multihist.py
@@ -47,6 +47,8 @@
 
 # %%
 #
+# .. tags:: plot-type: histogram, domain: statistics, purpose: reference
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/histogram_normalization.py b/galleries/examples/statistics/histogram_normalization.py
index 9418b7af002b..2c423edad208 100644
--- a/galleries/examples/statistics/histogram_normalization.py
+++ b/galleries/examples/statistics/histogram_normalization.py
@@ -243,6 +243,8 @@
 
 # %%
 #
+# .. tags:: plot-type: histogram, domain: statistics
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/multiple_histograms_side_by_side.py b/galleries/examples/statistics/multiple_histograms_side_by_side.py
index 3c5766f8e546..733aed51f253 100644
--- a/galleries/examples/statistics/multiple_histograms_side_by_side.py
+++ b/galleries/examples/statistics/multiple_histograms_side_by_side.py
@@ -63,6 +63,13 @@
 
 # %%
 #
+# .. tags::
+#
+#    domain: statistics
+#    plot-type: barh
+#    plot-type: histogram
+#    styling: position
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/time_series_histogram.py b/galleries/examples/statistics/time_series_histogram.py
index 371d182915b8..6f9a543fb4e5 100644
--- a/galleries/examples/statistics/time_series_histogram.py
+++ b/galleries/examples/statistics/time_series_histogram.py
@@ -94,6 +94,14 @@
 
 # %%
 #
+# .. tags::
+#
+#    plot-type: histogram2d
+#    plot-type: pcolormesh
+#    purpose: storytelling
+#    styling: color
+#    component: colormap
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/violinplot.py b/galleries/examples/statistics/violinplot.py
index afcc1c977034..3d0d44538032 100644
--- a/galleries/examples/statistics/violinplot.py
+++ b/galleries/examples/statistics/violinplot.py
@@ -106,6 +106,8 @@
 
 # %%
 #
+# .. tags:: plot-type: violin, domain: statistics
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown

From af21823d513c6c01d9b8037fa6c2e68ab90fedfe Mon Sep 17 00:00:00 2001
From: hannah <story645@gmail.com>
Date: Mon, 28 Oct 2024 18:49:26 -0400
Subject: [PATCH 1107/1120] Backport PR #27569: DOC: initial tags for
 statistics section of gallery

---
 galleries/examples/statistics/boxplot.py                 | 2 ++
 galleries/examples/statistics/boxplot_color.py           | 2 ++
 galleries/examples/statistics/boxplot_demo.py            | 2 ++
 galleries/examples/statistics/boxplot_vs_violin.py       | 2 ++
 galleries/examples/statistics/bxp.py                     | 2 ++
 galleries/examples/statistics/confidence_ellipse.py      | 8 ++++++++
 galleries/examples/statistics/customized_violin.py       | 2 ++
 galleries/examples/statistics/errorbar.py                | 3 +++
 galleries/examples/statistics/errorbar_features.py       | 2 ++
 galleries/examples/statistics/errorbar_limits.py         | 2 ++
 galleries/examples/statistics/errorbars_and_boxes.py     | 8 ++++++++
 galleries/examples/statistics/hexbin_demo.py             | 2 ++
 galleries/examples/statistics/hist.py                    | 9 +++++++++
 galleries/examples/statistics/histogram_bihistogram.py   | 4 ++++
 galleries/examples/statistics/histogram_cumulative.py    | 2 ++
 galleries/examples/statistics/histogram_histtypes.py     | 2 ++
 galleries/examples/statistics/histogram_multihist.py     | 2 ++
 galleries/examples/statistics/histogram_normalization.py | 2 ++
 .../statistics/multiple_histograms_side_by_side.py       | 7 +++++++
 galleries/examples/statistics/time_series_histogram.py   | 8 ++++++++
 galleries/examples/statistics/violinplot.py              | 2 ++
 21 files changed, 75 insertions(+)

diff --git a/galleries/examples/statistics/boxplot.py b/galleries/examples/statistics/boxplot.py
index ccdaab97d24a..6d30cbd4b5f0 100644
--- a/galleries/examples/statistics/boxplot.py
+++ b/galleries/examples/statistics/boxplot.py
@@ -97,6 +97,8 @@
 
 # %%
 #
+# .. tags:: plot-type: boxplot, domain: statistics
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/boxplot_color.py b/galleries/examples/statistics/boxplot_color.py
index 3491253aaf3e..acdb37d7d520 100644
--- a/galleries/examples/statistics/boxplot_color.py
+++ b/galleries/examples/statistics/boxplot_color.py
@@ -36,6 +36,8 @@
 
 # %%
 #
+# .. tags:: styling: color, domain: statistics, plot-type: boxplot
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/boxplot_demo.py b/galleries/examples/statistics/boxplot_demo.py
index eca0e152078e..ec23408c0bfc 100644
--- a/galleries/examples/statistics/boxplot_demo.py
+++ b/galleries/examples/statistics/boxplot_demo.py
@@ -247,6 +247,8 @@ def fake_bootstrapper(n):
 
 # %%
 #
+# .. tags:: domain: statistics, plot-type: boxplot
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/boxplot_vs_violin.py b/galleries/examples/statistics/boxplot_vs_violin.py
index dce8912013b0..f277e737e65c 100644
--- a/galleries/examples/statistics/boxplot_vs_violin.py
+++ b/galleries/examples/statistics/boxplot_vs_violin.py
@@ -54,6 +54,8 @@
 
 # %%
 #
+# .. tags:: plot-type: violin, plot-type: boxplot, domain: statistics
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/bxp.py b/galleries/examples/statistics/bxp.py
index b12bfebd16cc..3ddd164df742 100644
--- a/galleries/examples/statistics/bxp.py
+++ b/galleries/examples/statistics/bxp.py
@@ -64,6 +64,8 @@
 
 # %%
 #
+# .. tags:: plot-type: speciality, domain: statistics
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/confidence_ellipse.py b/galleries/examples/statistics/confidence_ellipse.py
index 27b06146a44e..4ac0917f4bda 100644
--- a/galleries/examples/statistics/confidence_ellipse.py
+++ b/galleries/examples/statistics/confidence_ellipse.py
@@ -217,6 +217,14 @@ def get_correlated_dataset(n, dependency, mu, scale):
 
 # %%
 #
+# .. tags::
+#
+#    plot-type: speciality
+#    plot-type: scatter
+#    component: ellipse
+#    component: patch
+#    domain: statistics
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/customized_violin.py b/galleries/examples/statistics/customized_violin.py
index c1d2e432ca2e..29ddcda92fbe 100644
--- a/galleries/examples/statistics/customized_violin.py
+++ b/galleries/examples/statistics/customized_violin.py
@@ -73,6 +73,8 @@ def set_axis_style(ax, labels):
 
 # %%
 #
+# .. tags:: plot-type: violin, domain: statistics
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/errorbar.py b/galleries/examples/statistics/errorbar.py
index a25cadf88211..019590dc3f32 100644
--- a/galleries/examples/statistics/errorbar.py
+++ b/galleries/examples/statistics/errorbar.py
@@ -21,6 +21,9 @@
 
 # %%
 #
+#
+# .. tags:: plot-type: errorbar, domain: statistics,
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/errorbar_features.py b/galleries/examples/statistics/errorbar_features.py
index 349cc89ff2e0..8abaffcda537 100644
--- a/galleries/examples/statistics/errorbar_features.py
+++ b/galleries/examples/statistics/errorbar_features.py
@@ -48,6 +48,8 @@
 
 # %%
 #
+# .. tags:: plot-type: errorbar, domain: statistics
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/errorbar_limits.py b/galleries/examples/statistics/errorbar_limits.py
index d5b0e476d894..f1d26460d947 100644
--- a/galleries/examples/statistics/errorbar_limits.py
+++ b/galleries/examples/statistics/errorbar_limits.py
@@ -77,6 +77,8 @@
 
 # %%
 #
+# .. tags:: plot-type: errorbar, domain: statistics
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/errorbars_and_boxes.py b/galleries/examples/statistics/errorbars_and_boxes.py
index 54c8786096c7..b45eee751137 100644
--- a/galleries/examples/statistics/errorbars_and_boxes.py
+++ b/galleries/examples/statistics/errorbars_and_boxes.py
@@ -71,6 +71,14 @@ def make_error_boxes(ax, xdata, ydata, xerror, yerror, facecolor='r',
 
 # %%
 #
+#
+# .. tags::
+#
+#    plot-type: errorbar
+#    component: rectangle
+#    component: patchcollection
+#    domain: statistics
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/hexbin_demo.py b/galleries/examples/statistics/hexbin_demo.py
index b9a6206a934f..bd1522772aae 100644
--- a/galleries/examples/statistics/hexbin_demo.py
+++ b/galleries/examples/statistics/hexbin_demo.py
@@ -35,6 +35,8 @@
 
 # %%
 #
+# .. tags:: plot-type: histogram, plot-type: hexbin, domain: statistics
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/hist.py b/galleries/examples/statistics/hist.py
index 8b06093913df..e31aca0228c2 100644
--- a/galleries/examples/statistics/hist.py
+++ b/galleries/examples/statistics/hist.py
@@ -103,6 +103,15 @@
 
 # %%
 #
+# .. tags::
+#
+#    plot-type: histogram,
+#    plot-type: histogram2d
+#    domain: statistics
+#    styling: color,
+#    component: normalization
+#    component: patch
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/histogram_bihistogram.py b/galleries/examples/statistics/histogram_bihistogram.py
index 7bfae14e9285..73f549493438 100644
--- a/galleries/examples/statistics/histogram_bihistogram.py
+++ b/galleries/examples/statistics/histogram_bihistogram.py
@@ -43,3 +43,7 @@
 ax.legend()
 
 plt.show()
+
+# %%
+#
+# .. tags:: plot-type: histogram, domain: statistics, purpose: showcase
diff --git a/galleries/examples/statistics/histogram_cumulative.py b/galleries/examples/statistics/histogram_cumulative.py
index 9ce16568d126..d87305629f8d 100644
--- a/galleries/examples/statistics/histogram_cumulative.py
+++ b/galleries/examples/statistics/histogram_cumulative.py
@@ -67,6 +67,8 @@
 
 # %%
 #
+# .. tags:: plot-type: ecdf, plot-type: histogram, domain: statistics
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/histogram_histtypes.py b/galleries/examples/statistics/histogram_histtypes.py
index 0188d7bf5d0f..53d6425cf4dc 100644
--- a/galleries/examples/statistics/histogram_histtypes.py
+++ b/galleries/examples/statistics/histogram_histtypes.py
@@ -51,6 +51,8 @@
 
 # %%
 #
+# .. tags:: plot-type: histogram, domain: statistics, purpose: reference
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/histogram_multihist.py b/galleries/examples/statistics/histogram_multihist.py
index f1957dc38939..78ff03719057 100644
--- a/galleries/examples/statistics/histogram_multihist.py
+++ b/galleries/examples/statistics/histogram_multihist.py
@@ -47,6 +47,8 @@
 
 # %%
 #
+# .. tags:: plot-type: histogram, domain: statistics, purpose: reference
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/histogram_normalization.py b/galleries/examples/statistics/histogram_normalization.py
index 9418b7af002b..2c423edad208 100644
--- a/galleries/examples/statistics/histogram_normalization.py
+++ b/galleries/examples/statistics/histogram_normalization.py
@@ -243,6 +243,8 @@
 
 # %%
 #
+# .. tags:: plot-type: histogram, domain: statistics
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/multiple_histograms_side_by_side.py b/galleries/examples/statistics/multiple_histograms_side_by_side.py
index 3c5766f8e546..733aed51f253 100644
--- a/galleries/examples/statistics/multiple_histograms_side_by_side.py
+++ b/galleries/examples/statistics/multiple_histograms_side_by_side.py
@@ -63,6 +63,13 @@
 
 # %%
 #
+# .. tags::
+#
+#    domain: statistics
+#    plot-type: barh
+#    plot-type: histogram
+#    styling: position
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/time_series_histogram.py b/galleries/examples/statistics/time_series_histogram.py
index 371d182915b8..6f9a543fb4e5 100644
--- a/galleries/examples/statistics/time_series_histogram.py
+++ b/galleries/examples/statistics/time_series_histogram.py
@@ -94,6 +94,14 @@
 
 # %%
 #
+# .. tags::
+#
+#    plot-type: histogram2d
+#    plot-type: pcolormesh
+#    purpose: storytelling
+#    styling: color
+#    component: colormap
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown
diff --git a/galleries/examples/statistics/violinplot.py b/galleries/examples/statistics/violinplot.py
index afcc1c977034..3d0d44538032 100644
--- a/galleries/examples/statistics/violinplot.py
+++ b/galleries/examples/statistics/violinplot.py
@@ -106,6 +106,8 @@
 
 # %%
 #
+# .. tags:: plot-type: violin, domain: statistics
+#
 # .. admonition:: References
 #
 #    The use of the following functions, methods, classes and modules is shown

From d6270b1ec462118f8181f98442a985d5e0a99a24 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Mon, 28 Oct 2024 23:05:33 -0400
Subject: [PATCH 1108/1120] Backport PR #29031: DOC: Fix copy-paste typo in
 ColorSequenceRegistry

---
 lib/matplotlib/colors.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/colors.py b/lib/matplotlib/colors.py
index 5f40e7b0fb9a..2c0d1b5d9a4f 100644
--- a/lib/matplotlib/colors.py
+++ b/lib/matplotlib/colors.py
@@ -105,7 +105,7 @@ class ColorSequenceRegistry(Mapping):
     Read access uses a dict-like interface mapping names to lists of colors::
 
         import matplotlib as mpl
-        cmap = mpl.color_sequences['tab10']
+        colors = mpl.color_sequences['tab10']
 
     The returned lists are copies, so that their modification does not change
     the global definition of the color sequence.

From f9e680177baf36ffa237a49af5fa993b677d7b38 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Tue, 29 Oct 2024 10:56:09 +0100
Subject: [PATCH 1109/1120] Backport PR #29036: Don't pass redundant
 inline=True to example clabel() calls.

---
 .../images_contours_and_fields/contour_demo.py       | 12 ++++++------
 .../images_contours_and_fields/contour_label_demo.py |  4 ++--
 galleries/examples/misc/demo_agg_filter.py           |  1 -
 3 files changed, 8 insertions(+), 9 deletions(-)

diff --git a/galleries/examples/images_contours_and_fields/contour_demo.py b/galleries/examples/images_contours_and_fields/contour_demo.py
index 1d64986850f5..885a8a3c2005 100644
--- a/galleries/examples/images_contours_and_fields/contour_demo.py
+++ b/galleries/examples/images_contours_and_fields/contour_demo.py
@@ -30,7 +30,7 @@
 
 fig, ax = plt.subplots()
 CS = ax.contour(X, Y, Z)
-ax.clabel(CS, inline=True, fontsize=10)
+ax.clabel(CS, fontsize=10)
 ax.set_title('Simplest default with labels')
 
 # %%
@@ -42,7 +42,7 @@
 CS = ax.contour(X, Y, Z)
 manual_locations = [
     (-1, -1.4), (-0.62, -0.7), (-2, 0.5), (1.7, 1.2), (2.0, 1.4), (2.4, 1.7)]
-ax.clabel(CS, inline=True, fontsize=10, manual=manual_locations)
+ax.clabel(CS, fontsize=10, manual=manual_locations)
 ax.set_title('labels at selected locations')
 
 # %%
@@ -50,7 +50,7 @@
 
 fig, ax = plt.subplots()
 CS = ax.contour(X, Y, Z, 6, colors='k')  # Negative contours default to dashed.
-ax.clabel(CS, fontsize=9, inline=True)
+ax.clabel(CS, fontsize=9)
 ax.set_title('Single color - negative contours dashed')
 
 # %%
@@ -59,7 +59,7 @@
 plt.rcParams['contour.negative_linestyle'] = 'solid'
 fig, ax = plt.subplots()
 CS = ax.contour(X, Y, Z, 6, colors='k')  # Negative contours default to dashed.
-ax.clabel(CS, fontsize=9, inline=True)
+ax.clabel(CS, fontsize=9)
 ax.set_title('Single color - negative contours solid')
 
 # %%
@@ -70,7 +70,7 @@
                 linewidths=np.arange(.5, 4, .5),
                 colors=('r', 'green', 'blue', (1, 1, 0), '#afeeee', '0.5'),
                 )
-ax.clabel(CS, fontsize=9, inline=True)
+ax.clabel(CS, fontsize=9)
 ax.set_title('Crazy lines')
 
 # %%
@@ -90,7 +90,7 @@
 CS.set_linewidth(lws)
 
 ax.clabel(CS, levels[1::2],  # label every second level
-          inline=True, fmt='%1.1f', fontsize=14)
+          fmt='%1.1f', fontsize=14)
 
 # make a colorbar for the contour lines
 CB = fig.colorbar(CS, shrink=0.8)
diff --git a/galleries/examples/images_contours_and_fields/contour_label_demo.py b/galleries/examples/images_contours_and_fields/contour_label_demo.py
index 57f29c827757..0b24b57f6afd 100644
--- a/galleries/examples/images_contours_and_fields/contour_label_demo.py
+++ b/galleries/examples/images_contours_and_fields/contour_label_demo.py
@@ -43,7 +43,7 @@ def fmt(x):
 fig, ax = plt.subplots()
 CS = ax.contour(X, Y, Z)
 
-ax.clabel(CS, CS.levels, inline=True, fmt=fmt, fontsize=10)
+ax.clabel(CS, CS.levels, fmt=fmt, fontsize=10)
 
 # %%
 # Label contours with arbitrary strings using a dictionary
@@ -59,7 +59,7 @@ def fmt(x):
     fmt[l] = s
 
 # Label every other level using strings
-ax1.clabel(CS1, CS1.levels[::2], inline=True, fmt=fmt, fontsize=10)
+ax1.clabel(CS1, CS1.levels[::2], fmt=fmt, fontsize=10)
 
 # %%
 # Use a Formatter
diff --git a/galleries/examples/misc/demo_agg_filter.py b/galleries/examples/misc/demo_agg_filter.py
index 5c2ad71a6673..302250ced9f0 100644
--- a/galleries/examples/misc/demo_agg_filter.py
+++ b/galleries/examples/misc/demo_agg_filter.py
@@ -188,7 +188,6 @@ def filtered_text(ax):
 
     # contour label
     cl = ax.clabel(CS, levels[1::2],  # label every second level
-                   inline=True,
                    fmt='%1.1f',
                    fontsize=11)
 

From 9b1b45bf8bb30609f7155305000b4aebbc61ec39 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Tue, 29 Oct 2024 10:56:09 +0100
Subject: [PATCH 1110/1120] Backport PR #29036: Don't pass redundant
 inline=True to example clabel() calls.

---
 .../images_contours_and_fields/contour_demo.py       | 12 ++++++------
 .../images_contours_and_fields/contour_label_demo.py |  4 ++--
 galleries/examples/misc/demo_agg_filter.py           |  1 -
 3 files changed, 8 insertions(+), 9 deletions(-)

diff --git a/galleries/examples/images_contours_and_fields/contour_demo.py b/galleries/examples/images_contours_and_fields/contour_demo.py
index 1d64986850f5..885a8a3c2005 100644
--- a/galleries/examples/images_contours_and_fields/contour_demo.py
+++ b/galleries/examples/images_contours_and_fields/contour_demo.py
@@ -30,7 +30,7 @@
 
 fig, ax = plt.subplots()
 CS = ax.contour(X, Y, Z)
-ax.clabel(CS, inline=True, fontsize=10)
+ax.clabel(CS, fontsize=10)
 ax.set_title('Simplest default with labels')
 
 # %%
@@ -42,7 +42,7 @@
 CS = ax.contour(X, Y, Z)
 manual_locations = [
     (-1, -1.4), (-0.62, -0.7), (-2, 0.5), (1.7, 1.2), (2.0, 1.4), (2.4, 1.7)]
-ax.clabel(CS, inline=True, fontsize=10, manual=manual_locations)
+ax.clabel(CS, fontsize=10, manual=manual_locations)
 ax.set_title('labels at selected locations')
 
 # %%
@@ -50,7 +50,7 @@
 
 fig, ax = plt.subplots()
 CS = ax.contour(X, Y, Z, 6, colors='k')  # Negative contours default to dashed.
-ax.clabel(CS, fontsize=9, inline=True)
+ax.clabel(CS, fontsize=9)
 ax.set_title('Single color - negative contours dashed')
 
 # %%
@@ -59,7 +59,7 @@
 plt.rcParams['contour.negative_linestyle'] = 'solid'
 fig, ax = plt.subplots()
 CS = ax.contour(X, Y, Z, 6, colors='k')  # Negative contours default to dashed.
-ax.clabel(CS, fontsize=9, inline=True)
+ax.clabel(CS, fontsize=9)
 ax.set_title('Single color - negative contours solid')
 
 # %%
@@ -70,7 +70,7 @@
                 linewidths=np.arange(.5, 4, .5),
                 colors=('r', 'green', 'blue', (1, 1, 0), '#afeeee', '0.5'),
                 )
-ax.clabel(CS, fontsize=9, inline=True)
+ax.clabel(CS, fontsize=9)
 ax.set_title('Crazy lines')
 
 # %%
@@ -90,7 +90,7 @@
 CS.set_linewidth(lws)
 
 ax.clabel(CS, levels[1::2],  # label every second level
-          inline=True, fmt='%1.1f', fontsize=14)
+          fmt='%1.1f', fontsize=14)
 
 # make a colorbar for the contour lines
 CB = fig.colorbar(CS, shrink=0.8)
diff --git a/galleries/examples/images_contours_and_fields/contour_label_demo.py b/galleries/examples/images_contours_and_fields/contour_label_demo.py
index 57f29c827757..0b24b57f6afd 100644
--- a/galleries/examples/images_contours_and_fields/contour_label_demo.py
+++ b/galleries/examples/images_contours_and_fields/contour_label_demo.py
@@ -43,7 +43,7 @@ def fmt(x):
 fig, ax = plt.subplots()
 CS = ax.contour(X, Y, Z)
 
-ax.clabel(CS, CS.levels, inline=True, fmt=fmt, fontsize=10)
+ax.clabel(CS, CS.levels, fmt=fmt, fontsize=10)
 
 # %%
 # Label contours with arbitrary strings using a dictionary
@@ -59,7 +59,7 @@ def fmt(x):
     fmt[l] = s
 
 # Label every other level using strings
-ax1.clabel(CS1, CS1.levels[::2], inline=True, fmt=fmt, fontsize=10)
+ax1.clabel(CS1, CS1.levels[::2], fmt=fmt, fontsize=10)
 
 # %%
 # Use a Formatter
diff --git a/galleries/examples/misc/demo_agg_filter.py b/galleries/examples/misc/demo_agg_filter.py
index 5c2ad71a6673..302250ced9f0 100644
--- a/galleries/examples/misc/demo_agg_filter.py
+++ b/galleries/examples/misc/demo_agg_filter.py
@@ -188,7 +188,6 @@ def filtered_text(ax):
 
     # contour label
     cl = ax.clabel(CS, levels[1::2],  # label every second level
-                   inline=True,
                    fmt='%1.1f',
                    fontsize=11)
 

From befcf72e1610f28e634c9b2d6479294992d0d918 Mon Sep 17 00:00:00 2001
From: Greg Lucas <greg.m.lucas@gmail.com>
Date: Tue, 29 Oct 2024 14:56:23 -0600
Subject: [PATCH 1111/1120] Backport PR #29035: FIX: Don't set_wmclass on GTK3

---
 lib/matplotlib/backends/_backend_gtk.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/lib/matplotlib/backends/_backend_gtk.py b/lib/matplotlib/backends/_backend_gtk.py
index 565d92932023..ac443730e28a 100644
--- a/lib/matplotlib/backends/_backend_gtk.py
+++ b/lib/matplotlib/backends/_backend_gtk.py
@@ -143,7 +143,6 @@ def __init__(self, canvas, num):
         super().__init__(canvas, num)
 
         if gtk_ver == 3:
-            self.window.set_wmclass("matplotlib", "Matplotlib")
             icon_ext = "png" if sys.platform == "win32" else "svg"
             self.window.set_icon_from_file(
                 str(cbook._get_data_path(f"images/matplotlib.{icon_ext}")))

From 985e8f4f92c35518fd452e95c127425411e36fd8 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Wed, 30 Oct 2024 16:05:32 -0400
Subject: [PATCH 1112/1120] Backport PR #28981: FIX: macos: Use standard NSApp
 run loop in our input hook

---
 src/_macosx.m | 110 +++++++++++++++++++++++++-------------------------
 1 file changed, 56 insertions(+), 54 deletions(-)

diff --git a/src/_macosx.m b/src/_macosx.m
index fda928536ab5..1f291b52f6ba 100755
--- a/src/_macosx.m
+++ b/src/_macosx.m
@@ -40,60 +40,84 @@
 static bool keyChangeCapsLock = false;
 /* Keep track of the current mouse up/down state for open/closed cursor hand */
 static bool leftMouseGrabbing = false;
-/* Keep track of whether stdin has been received */
-static bool stdin_received = false;
-static bool stdin_sigint = false;
 // Global variable to store the original SIGINT handler
 static PyOS_sighandler_t originalSigintAction = NULL;
 
-// Signal handler for SIGINT, only sets a flag to exit the run loop
+// Stop the current app's run loop, sending an event to ensure it actually stops
+static void stopWithEvent() {
+    [NSApp stop: nil];
+    // Post an event to trigger the actual stopping.
+    [NSApp postEvent: [NSEvent otherEventWithType: NSEventTypeApplicationDefined
+                                         location: NSZeroPoint
+                                    modifierFlags: 0
+                                        timestamp: 0
+                                     windowNumber: 0
+                                          context: nil
+                                          subtype: 0
+                                            data1: 0
+                                            data2: 0]
+             atStart: YES];
+}
+
+// Signal handler for SIGINT, only argument matching for stopWithEvent
 static void handleSigint(int signal) {
-    stdin_sigint = true;
+    stopWithEvent();
+}
+
+// Helper function to flush all events.
+// This is needed in some instances to ensure e.g. that windows are properly closed.
+// It is used in the input hook as well as wrapped in a version callable from Python.
+static void flushEvents() {
+    while (true) {
+        NSEvent* event = [NSApp nextEventMatchingMask: NSEventMaskAny
+                                            untilDate: [NSDate distantPast]
+                                               inMode: NSDefaultRunLoopMode
+                                              dequeue: YES];
+        if (!event) {
+            break;
+        }
+        [NSApp sendEvent:event];
+    }
 }
 
 static int wait_for_stdin() {
-    @autoreleasepool {
-        stdin_received = false;
-        stdin_sigint = false;
+    // Short circuit if no windows are active
+    // Rely on Python's input handling to manage CPU usage
+    // This queries the NSApp, rather than using our FigureWindowCount because that is decremented when events still
+    // need to be processed to properly close the windows.
+    if (![[NSApp windows] count]) {
+      flushEvents();
+      return 1;
+    }
 
+    @autoreleasepool {
         // Set up a SIGINT handler to interrupt the event loop if ctrl+c comes in too
         originalSigintAction = PyOS_setsig(SIGINT, handleSigint);
 
         // Create an NSFileHandle for standard input
         NSFileHandle *stdinHandle = [NSFileHandle fileHandleWithStandardInput];
 
+
         // Register for data available notifications on standard input
-        [[NSNotificationCenter defaultCenter] addObserverForName: NSFileHandleDataAvailableNotification
-                                                          object: stdinHandle
-                                                           queue: [NSOperationQueue mainQueue] // Use the main queue
-                                                      usingBlock: ^(NSNotification *notification) {
-                                                                    // Mark that input has been received
-                                                                    stdin_received = true;
-                                                                    }
+        id notificationID = [[NSNotificationCenter defaultCenter] addObserverForName: NSFileHandleDataAvailableNotification
+                                                                              object: stdinHandle
+                                                                               queue: [NSOperationQueue mainQueue] // Use the main queue
+                                                                          usingBlock: ^(NSNotification *notification) {stopWithEvent();}
         ];
 
         // Wait in the background for anything that happens to stdin
         [stdinHandle waitForDataInBackgroundAndNotify];
 
-        // continuously run an event loop until the stdin_received flag is set to exit
-        while (!stdin_received && !stdin_sigint) {
-            // This loop is similar to the main event loop and flush_events which have
-            // Py_[BEGIN|END]_ALLOW_THREADS surrounding the loop.
-            // This should not be necessary here because PyOS_InputHook releases the GIL for us.
-            while (true) {
-                NSEvent *event = [NSApp nextEventMatchingMask: NSEventMaskAny
-                                                    untilDate: [NSDate distantPast]
-                                                       inMode: NSDefaultRunLoopMode
-                                                      dequeue: YES];
-                if (!event) { break; }
-                [NSApp sendEvent: event];
-            }
-        }
+        // Run the application's event loop, which will be interrupted on stdin or SIGINT
+        [NSApp run];
+
         // Remove the input handler as an observer
-        [[NSNotificationCenter defaultCenter] removeObserver: stdinHandle];
+        [[NSNotificationCenter defaultCenter] removeObserver: notificationID];
+
 
         // Restore the original SIGINT handler upon exiting the function
         PyOS_setsig(SIGINT, originalSigintAction);
+
         return 1;
     }
 }
@@ -236,18 +260,7 @@ static void lazy_init(void) {
 static PyObject*
 stop(PyObject* self)
 {
-    [NSApp stop: nil];
-    // Post an event to trigger the actual stopping.
-    [NSApp postEvent: [NSEvent otherEventWithType: NSEventTypeApplicationDefined
-                                         location: NSZeroPoint
-                                    modifierFlags: 0
-                                        timestamp: 0
-                                     windowNumber: 0
-                                          context: nil
-                                          subtype: 0
-                                            data1: 0
-                                            data2: 0]
-             atStart: YES];
+    stopWithEvent();
     Py_RETURN_NONE;
 }
 
@@ -382,20 +395,9 @@ static CGFloat _get_device_scale(CGContextRef cr)
     // We run the app, matching any events that are waiting in the queue
     // to process, breaking out of the loop when no events remain and
     // displaying the canvas if needed.
-    NSEvent *event;
-
     Py_BEGIN_ALLOW_THREADS
 
-    while (true) {
-        event = [NSApp nextEventMatchingMask: NSEventMaskAny
-                                   untilDate: [NSDate distantPast]
-                                      inMode: NSDefaultRunLoopMode
-                                     dequeue: YES];
-        if (!event) {
-            break;
-        }
-        [NSApp sendEvent:event];
-    }
+    flushEvents();
 
     Py_END_ALLOW_THREADS
 

From c87f8078114310ac93c548686764ef5e5aaa8861 Mon Sep 17 00:00:00 2001
From: Ruth Comer <10599679+rcomer@users.noreply.github.com>
Date: Mon, 11 Nov 2024 19:02:56 +0000
Subject: [PATCH 1113/1120] Backport PR #29120: DOC: Switch nested pie example
 from cmaps to color_sequences

---
 galleries/examples/pie_and_polar_charts/nested_pie.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/galleries/examples/pie_and_polar_charts/nested_pie.py b/galleries/examples/pie_and_polar_charts/nested_pie.py
index c83b4f6f84ee..61cb5e6ee429 100644
--- a/galleries/examples/pie_and_polar_charts/nested_pie.py
+++ b/galleries/examples/pie_and_polar_charts/nested_pie.py
@@ -31,9 +31,9 @@
 size = 0.3
 vals = np.array([[60., 32.], [37., 40.], [29., 10.]])
 
-cmap = plt.colormaps["tab20c"]
-outer_colors = cmap(np.arange(3)*4)
-inner_colors = cmap([1, 2, 5, 6, 9, 10])
+tab20c = plt.color_sequences["tab20c"]
+outer_colors = [tab20c[i] for i in [0, 4, 8]]
+inner_colors = [tab20c[i] for i in [1, 2, 5, 6, 9, 10]]
 
 ax.pie(vals.sum(axis=1), radius=1, colors=outer_colors,
        wedgeprops=dict(width=size, edgecolor='w'))

From 8d8d1d6a7ad9ff03d86ec2d30c65002eb5a93ba4 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 20 Nov 2024 14:46:04 -0500
Subject: [PATCH 1114/1120] Backport CI config updates to v3.9.x (#29149)

This includes updates to `actions/attest-build-provenance`,
`pypa/cibuildwheel`, `pypa/gh-action-pypi-publish`, `deadsnakes/action`,
and cleanup of `workflow_dispatch` and outdated skips.
---
 .github/workflows/cibuildwheel.yml | 18 ++++++++----------
 .github/workflows/cygwin.yml       |  1 -
 .github/workflows/tests.yml        |  3 +--
 3 files changed, 9 insertions(+), 13 deletions(-)

diff --git a/.github/workflows/cibuildwheel.yml b/.github/workflows/cibuildwheel.yml
index a145b5bbcc08..aa0366ad16ff 100644
--- a/.github/workflows/cibuildwheel.yml
+++ b/.github/workflows/cibuildwheel.yml
@@ -143,13 +143,11 @@ jobs:
           path: dist/
 
       - name: Build wheels for CPython 3.13
-        uses: pypa/cibuildwheel@bd033a44476646b606efccdd5eed92d5ea1d77ad  # v2.20.0
+        uses: pypa/cibuildwheel@7940a4c0e76eb2030e473a5f864f291f63ee879b  # v2.21.3
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
           CIBW_BUILD: "cp313-* cp313t-*"
-          # No free-threading wheels for NumPy; musllinux skipped for main builds also.
-          CIBW_SKIP: "cp313t-win_amd64 *-musllinux_aarch64"
           CIBW_BUILD_FRONTEND:
             "pip; args: --pre --extra-index-url https://pypi.anaconda.org/scientific-python-nightly-wheels/simple"
           CIBW_FREE_THREADED_SUPPORT: true
@@ -163,7 +161,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.12
-        uses: pypa/cibuildwheel@bd033a44476646b606efccdd5eed92d5ea1d77ad  # v2.20.0
+        uses: pypa/cibuildwheel@7940a4c0e76eb2030e473a5f864f291f63ee879b  # v2.21.3
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -171,7 +169,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.11
-        uses: pypa/cibuildwheel@bd033a44476646b606efccdd5eed92d5ea1d77ad  # v2.20.0
+        uses: pypa/cibuildwheel@7940a4c0e76eb2030e473a5f864f291f63ee879b  # v2.21.3
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -179,7 +177,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.10
-        uses: pypa/cibuildwheel@bd033a44476646b606efccdd5eed92d5ea1d77ad  # v2.20.0
+        uses: pypa/cibuildwheel@7940a4c0e76eb2030e473a5f864f291f63ee879b  # v2.21.3
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -187,7 +185,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.9
-        uses: pypa/cibuildwheel@7e5a838a63ac8128d71ab2dfd99e4634dd1bca09  # v2.19.2
+        uses: pypa/cibuildwheel@7940a4c0e76eb2030e473a5f864f291f63ee879b  # v2.21.3
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -195,7 +193,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for PyPy
-        uses: pypa/cibuildwheel@bd033a44476646b606efccdd5eed92d5ea1d77ad  # v2.20.0
+        uses: pypa/cibuildwheel@7940a4c0e76eb2030e473a5f864f291f63ee879b  # v2.21.3
         with:
           package-dir: dist/${{ needs.build_sdist.outputs.SDIST_NAME }}
         env:
@@ -231,9 +229,9 @@ jobs:
         run: ls dist
 
       - name: Generate artifact attestation for sdist and wheel
-        uses: actions/attest-build-provenance@210c1913531870065f03ce1f9440dd87bc0938cd  # v1.4.0
+        uses: actions/attest-build-provenance@ef244123eb79f2f7a7e75d99086184180e6d0018  # v1.4.4
         with:
           subject-path: dist/matplotlib-*
 
       - name: Publish package distributions to PyPI
-        uses: pypa/gh-action-pypi-publish@ec4db0b4ddc65acdf4bff5fa45ac92d78b56bdf0  # v1.9.0
+        uses: pypa/gh-action-pypi-publish@15c56dba361d8335944d31a2ecd17d700fc7bcbc  # v1.12.2
diff --git a/.github/workflows/cygwin.yml b/.github/workflows/cygwin.yml
index 58c132315b6f..a3f93ba195a8 100644
--- a/.github/workflows/cygwin.yml
+++ b/.github/workflows/cygwin.yml
@@ -29,7 +29,6 @@ on:
     # 5:47 UTC on Saturdays
     - cron: "47 5 * * 6"
   workflow_dispatch:
-    workflow: "*"
 
 permissions:
   contents: read
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 4100fda43a36..853311366ee3 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -21,7 +21,6 @@ on:
     # 5:47 UTC on Saturdays
     - cron: "47 5 * * 6"
   workflow_dispatch:
-    workflow: "*"
 
 env:
   NO_AT_BRIDGE: 1  # Necessary for GTK3 interactive test.
@@ -127,7 +126,7 @@ jobs:
           allow-prereleases: true
 
       - name: Set up Python ${{ matrix.python-version }}
-        uses: deadsnakes/action@6c8b9b82fe0b4344f4b98f2775fcc395df45e494  # v3.1.0
+        uses: deadsnakes/action@e640ac8743173a67cca4d7d77cd837e514bf98e8  # v3.2.0
         if: matrix.python-version == '3.13t'
         with:
           python-version: '3.13'

From d71ff494bbf808f029cd6a3f3c0de061ea480010 Mon Sep 17 00:00:00 2001
From: "Lumberbot (aka Jack)"
 <39504233+meeseeksmachine@users.noreply.github.com>
Date: Thu, 21 Nov 2024 11:54:15 -0800
Subject: [PATCH 1115/1120] Backport PR #29153: Bump codecov/codecov-action
 from 4 to 5 in the actions group (#29165)

Co-authored-by: Greg Lucas <greg.m.lucas@gmail.com>
---
 .github/workflows/tests.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 853311366ee3..6d2fe41546f1 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -388,7 +388,7 @@ jobs:
           fi
       - name: Upload code coverage
         if: ${{ !cancelled() && github.event_name != 'schedule' }}
-        uses: codecov/codecov-action@v4
+        uses: codecov/codecov-action@v5
         with:
           name: "${{ matrix.python-version }} ${{ matrix.os }} ${{ matrix.name-suffix }}"
           token: ${{ secrets.CODECOV_TOKEN }}

From c4bfd54a058f9124bfb75beccafdfd03432b3778 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Fri, 22 Nov 2024 21:50:55 -0500
Subject: [PATCH 1116/1120] Backport PR #29148: Don't fail on
 equal-but-differently-named cmaps in qt figureoptions.

---
 lib/matplotlib/backends/qt_editor/figureoptions.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/matplotlib/backends/qt_editor/figureoptions.py b/lib/matplotlib/backends/qt_editor/figureoptions.py
index c36bbeb62641..3c2eaf1bacd3 100644
--- a/lib/matplotlib/backends/qt_editor/figureoptions.py
+++ b/lib/matplotlib/backends/qt_editor/figureoptions.py
@@ -149,7 +149,7 @@ def prepare_data(d, init):
     cmaps = [(cmap, name) for name, cmap in sorted(cm._colormaps.items())]
     for label, mappable in labeled_mappables:
         cmap = mappable.get_cmap()
-        if cmap not in cm._colormaps.values():
+        if cmap.name not in cm._colormaps:
             cmaps = [(cmap, cmap.name), *cmaps]
         low, high = mappable.get_clim()
         mappabledata = [

From dd5777232d288970697f4effafd38946d541784c Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Wed, 20 Nov 2024 23:48:23 -0500
Subject: [PATCH 1117/1120] Backport PR #29163: ci: Remove outdated pkg-config
 package on macOS

---
 .github/workflows/tests.yml | 2 ++
 azure-pipelines.yml         | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 6d2fe41546f1..6f604db8cd0b 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -202,6 +202,8 @@ jobs:
               brew unlink ${python_package}
               brew link --overwrite ${python_package}
             done
+            # Workaround for https://github.com/actions/runner-images/issues/10984
+            brew uninstall --ignore-dependencies --force pkg-config@0.29.2
             brew install ccache ghostscript gobject-introspection gtk4 ninja
             brew install --cask font-noto-sans-cjk inkscape
             ;;
diff --git a/azure-pipelines.yml b/azure-pipelines.yml
index e2829ce81e9f..00edc8e9a412 100644
--- a/azure-pipelines.yml
+++ b/azure-pipelines.yml
@@ -131,6 +131,8 @@ stages:
                   brew unlink ${python_package}
                   brew link --overwrite ${python_package}
                 done
+                # Workaround for https://github.com/actions/runner-images/issues/10984
+                brew uninstall --ignore-dependencies --force pkg-config@0.29.2
                 brew install --cask xquartz
                 brew install ccache ffmpeg imagemagick mplayer ninja pkg-config
                 brew install --cask font-noto-sans-cjk-sc

From 562d45862d411925f98b489270ea7a206a9a3bb1 Mon Sep 17 00:00:00 2001
From: Thomas A Caswell <tcaswell@gmail.com>
Date: Tue, 26 Nov 2024 10:14:08 -0500
Subject: [PATCH 1118/1120] Backport PR #29191: ci: Simplify 3.13t test setup

---
 .github/workflows/tests.yml | 20 +++-----------------
 1 file changed, 3 insertions(+), 17 deletions(-)

diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 6f604db8cd0b..dc216c6959f0 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -126,11 +126,11 @@ jobs:
           allow-prereleases: true
 
       - name: Set up Python ${{ matrix.python-version }}
-        uses: deadsnakes/action@e640ac8743173a67cca4d7d77cd837e514bf98e8  # v3.2.0
+        uses: Quansight-Labs/setup-python@b9ab292c751a42bcd2bb465b7fa202ea2c3f5796  # v5.3.1
         if: matrix.python-version == '3.13t'
         with:
-          python-version: '3.13'
-          nogil: true
+          python-version: ${{ matrix.python-version }}
+          allow-prereleases: true
 
       - name: Install OS dependencies
         run: |
@@ -177,11 +177,6 @@ jobs:
               texlive-luatex \
               texlive-pictures \
               texlive-xetex
-            if [[ "${{ matrix.python-version }}" = '3.13t' ]]; then
-              # TODO: Remove this once setup-python supports nogil distributions.
-              sudo apt-get install -yy --no-install-recommends \
-                python3.13-tk-nogil
-            fi
             if [[ "${{ matrix.os }}" = ubuntu-20.04 ]]; then
               sudo apt-get install -yy --no-install-recommends libopengl0
             else  # ubuntu-22.04
@@ -245,15 +240,6 @@ jobs:
             4-${{ runner.os }}-py${{ matrix.python-version }}-mpl-${{ github.ref }}-
             4-${{ runner.os }}-py${{ matrix.python-version }}-mpl-
 
-      - name: Install the nightly dependencies
-        if: matrix.python-version == '3.13t'
-        run: |
-          python -m pip install pytz tzdata python-dateutil  # Must be installed for Pandas.
-          python -m pip install \
-              --pre \
-              --index-url https://pypi.anaconda.org/scientific-python-nightly-wheels/simple \
-              --upgrade --only-binary=:all: numpy pandas pillow contourpy
-
       - name: Install Python dependencies
         run: |
           # Upgrade pip and setuptools and wheel to get as clean an install as

From 4ca8d68b6b161b41492fb27c2431c3adc4d26051 Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Sat, 30 Nov 2024 03:28:23 -0500
Subject: [PATCH 1119/1120] DOC: Create release notes for 3.9.3

---
 doc/users/github_stats.rst                    | 156 ++++++++++--------
 .../prev_whats_new/github_stats_3.9.2.rst     |  96 +++++++++++
 doc/users/release_notes.rst                   |   1 +
 3 files changed, 181 insertions(+), 72 deletions(-)
 create mode 100644 doc/users/prev_whats_new/github_stats_3.9.2.rst

diff --git a/doc/users/github_stats.rst b/doc/users/github_stats.rst
index d357a6759d30..bec073081a68 100644
--- a/doc/users/github_stats.rst
+++ b/doc/users/github_stats.rst
@@ -1,99 +1,111 @@
 .. _github-stats:
 
-GitHub statistics for 3.9.2 (Aug 12, 2024)
+GitHub statistics for 3.9.3 (Nov 30, 2024)
 ==========================================
 
-GitHub statistics for 2024/07/04 (tag: v3.9.1) - 2024/08/12
+GitHub statistics for 2024/08/12 (tag: v3.9.2) - 2024/11/30
 
 These lists are automatically generated, and may be incomplete or contain duplicates.
 
-We closed 9 issues and merged 45 pull requests.
-The full list can be seen `on GitHub <https://github.com/matplotlib/matplotlib/milestone/93?closed=1>`__
+We closed 6 issues and merged 62 pull requests.
+The full list can be seen `on GitHub <https://github.com/matplotlib/matplotlib/milestone/95?closed=1>`__
 
-The following 20 authors contributed 67 commits.
+The following 18 authors contributed 90 commits.
 
-* Adam J. Stewart
-* Anthony Lee
-* Caitlin Hathaway
-* ClarkeAC
+* Andresporcruz
+* Antony Lee
+* Charlie LeWarne
 * dependabot[bot]
 * Elliott Sales de Andrade
-* Filippo Balzaretti
+* Gavin S
 * Greg Lucas
 * hannah
-* Ian Thomas
-* Jody Klymak
 * Kyle Sunden
+* Kyra Cho
+* kyracho
+* Lumberbot (aka Jack)
+* Michael Hinton
 * Oscar Gustafsson
-* Randolf Scholz
-* Refael Ackermann
 * Ruth Comer
-* Scott Shambaugh
-* Sean Smith
 * Thomas A Caswell
 * Tim Hoffmann
+* vittoboa
 
 GitHub issues and pull requests:
 
-Pull Requests (45):
+Pull Requests (62):
 
-* :ghpull:`28687`: BLD: Include MSVCP140 runtime statically
-* :ghpull:`28679`: Run delvewheel with path to required msvcp140.dll
-* :ghpull:`28695`: Backport PR #27797 on branch v3.9.x (DOC: Use video files for saving animations)
-* :ghpull:`28688`: Backport PR #28293 and #28668: Enable 3.13 wheels and bump cibuildwheel
-* :ghpull:`27797`: DOC: Use video files for saving animations
-* :ghpull:`28692`: Backport PR #28632 on branch v3.9.x (DOC: Tell sphinx-gallery to link mpl_toolkits from our build)
-* :ghpull:`28632`: DOC: Tell sphinx-gallery to link mpl_toolkits from our build
-* :ghpull:`28668`: Bump the actions group with 2 updates
-* :ghpull:`28686`: Backport PR #28682 on branch v3.9.x (Fix warnings from mingw compilers)
-* :ghpull:`28682`: Fix warnings from mingw compilers
-* :ghpull:`28676`: Backport PR #28577 on branch v3.9.x (Copy all internals from initial Tick to lazy ones)
-* :ghpull:`28577`: Copy all internals from initial Tick to lazy ones
-* :ghpull:`28674`: Backport PR #28650 on branch v3.9.x (remove out of date todos on animation.py)
-* :ghpull:`28650`: remove out of date todos on animation.py
-* :ghpull:`28656`: Backport PR #28649 on branch v3.9.x (FIX: improve formatting of image values in cases of singular norms)
-* :ghpull:`28665`: Backport PR #28546 on branch v3.9.x (DOC: Clarify/simplify example of multiple images with one colorbar)
-* :ghpull:`28649`: FIX: improve formatting of image values in cases of singular norms
-* :ghpull:`28635`: BLD: windows wheels
-* :ghpull:`28645`: Backport PR #28644 on branch v3.9.x (DOC: Fix matching for version switcher)
-* :ghpull:`28640`: Backport PR #28634 on branch v3.9.x (Closed open div tag in color.ColorMap._repr_html_)
-* :ghpull:`28634`: Closed open div tag in color.ColorMap._repr_html_
-* :ghpull:`28636`: Backport PR #28625 on branch v3.9.x (added typing_extensions.Self to _AxesBase.twinx)
-* :ghpull:`28625`: added typing_extensions.Self to _AxesBase.twinx
-* :ghpull:`28622`: Backport PR #28621 on branch v3.9.x (TYP: Fix a typo in animation.pyi)
-* :ghpull:`28621`: TYP: Fix a typo in animation.pyi
-* :ghpull:`28605`: Backport PR #28604 on branch v3.9.x (cycler signature update.)
-* :ghpull:`28604`: cycler signature update.
-* :ghpull:`28598`: Pin PyQt6 back on Ubuntu 20.04
-* :ghpull:`28596`: Backport PR #28518 on branch v3.9.x ([TYP] Fix overload of ``pyplot.subplots``)
-* :ghpull:`28518`: [TYP] Fix overload of ``pyplot.subplots``
-* :ghpull:`28591`: Backport PR #28580 on branch v3.9.x (Bump actions/attest-build-provenance from 1.3.2 to 1.3.3 in the actions group)
-* :ghpull:`28580`: Bump actions/attest-build-provenance from 1.3.2 to 1.3.3 in the actions group
-* :ghpull:`28586`: Backport PR #28582 on branch v3.9.x (FIX: make sticky edge tolerance relative to data range)
-* :ghpull:`28582`: FIX: make sticky edge tolerance relative to data range
-* :ghpull:`28572`: Backport PR #28571 on branch v3.9.x (DOC: Add version directive to hatch parameter in stackplot)
-* :ghpull:`28571`: DOC: Add version directive to hatch parameter in stackplot
-* :ghpull:`28564`: Backport PR #28534 on branch v3.9.x ([BLD] Fix WSL build warning)
-* :ghpull:`28563`: Backport PR #28526 on branch v3.9.x (Bump pypa/cibuildwheel from 2.19.1 to 2.19.2 in the actions group)
-* :ghpull:`28534`: [BLD] Fix WSL build warning
-* :ghpull:`28526`: Bump pypa/cibuildwheel from 2.19.1 to 2.19.2 in the actions group
-* :ghpull:`28552`: Backport PR #28541 on branch v3.9.x (MNT: be more careful about disk I/O failures when writing font cache)
-* :ghpull:`28541`: MNT: be more careful about disk I/O failures when writing font cache
-* :ghpull:`28524`: Backport PR #28523 on branch v3.9.x (Fix value error when set widget size to zero while using FigureCanvasQT )
-* :ghpull:`28523`: Fix value error when set widget size to zero while using FigureCanvasQT
-* :ghpull:`28519`: Backport PR #28517 on branch v3.9.x (DOC: better cross referencing for animations)
+* :ghpull:`29195`: Backport PR #29191 on branch v3.9.x (ci: Simplify 3.13t test setup)
+* :ghpull:`29191`: ci: Simplify 3.13t test setup
+* :ghpull:`29176`: Backport PR #29148 on branch v3.9.x (Don't fail on equal-but-differently-named cmaps in qt figureoptions.)
+* :ghpull:`29148`: Don't fail on equal-but-differently-named cmaps in qt figureoptions.
+* :ghpull:`29165`: Backport PR #29153 on branch v3.9.x (Bump codecov/codecov-action from 4 to 5 in the actions group)
+* :ghpull:`29153`: Bump codecov/codecov-action from 4 to 5 in the actions group
+* :ghpull:`29149`: Backport CI config updates to v3.9.x
+* :ghpull:`29121`: Backport PR #29120 on branch v3.9.x (DOC: Switch nested pie example from cmaps to color_sequences)
+* :ghpull:`29071`: Bump pypa/gh-action-pypi-publish from 1.10.3 to 1.11.0 in the actions group
+* :ghpull:`29046`: Backport PR #28981 on branch v3.9.x (FIX: macos: Use standard NSApp run loop in our input hook)
+* :ghpull:`28981`: FIX: macos: Use standard NSApp run loop in our input hook
+* :ghpull:`29041`: Backport PR #29035 on branch v3.9.x (FIX: Don't set_wmclass on GTK3)
+* :ghpull:`29035`: FIX: Don't set_wmclass on GTK3
+* :ghpull:`29037`: Backport PR #29036 on branch v3.9.x (Don't pass redundant inline=True to example clabel() calls.)
+* :ghpull:`29032`: Backport PR #27569 on branch v3.9.x (DOC: initial tags for statistics section of gallery)
+* :ghpull:`29034`: Backport PR #29031 on branch v3.9.x (DOC: Fix copy-paste typo in ColorSequenceRegistry)
+* :ghpull:`29031`: DOC: Fix copy-paste typo in ColorSequenceRegistry
+* :ghpull:`29015`: Backport PR #29014 on branch v3.9.x (FIX: fake out setuptools scm in tox on ci)
+* :ghpull:`29014`: FIX: fake out setuptools scm in tox on ci
+* :ghpull:`29010`: Backport PR #29005 on branch v3.9.x (DOC: Update meson-python intersphinx link)
+* :ghpull:`29006`: Backport PR #28993 on branch v3.9.x (FIX: contourf hatches use multiple edgecolors)
+* :ghpull:`28993`: FIX: contourf hatches use multiple edgecolors
+* :ghpull:`28988`: Backport PR #28987 on branch v3.9.x (Fix: Do not use numeric tolerances for axline special cases)
+* :ghpull:`28947`: Backport PR #28925 on branch v3.9.x (TST: handle change in pytest.importorskip behavior)
+* :ghpull:`28989`: Backport PR #28972 on branch v3.9.x (Switch macOS 12 runner images to macOS 13)
+* :ghpull:`28972`: Switch macOS 12 runner images to macOS 13
+* :ghpull:`28987`: Fix: Do not use numeric tolerances for axline special cases
+* :ghpull:`28954`: Backport PR #28952 on branch v3.9.x (BLD: update trove metadata to support py3.13)
+* :ghpull:`28952`: BLD: update trove metadata to support py3.13
+* :ghpull:`28887`: Backport PR #28883 on branch v3.9.x (Only check X11 when running Tkinter tests)
+* :ghpull:`28926`: Backport PR #28689 on branch v3.9.x (ci: Enable testing on Python 3.13)
+* :ghpull:`28925`: TST: handle change in pytest.importorskip behavior
+* :ghpull:`28945`: Backport PR #28943 on branch v3.9.x (DOC: Clarify the returned line of axhline()/axvline())
+* :ghpull:`28939`: Backport PR #28900 on branch v3.9.x (DOC: Improve fancybox demo)
+* :ghpull:`28900`: DOC: Improve fancybox demo
+* :ghpull:`28902`: Backport PR #28881 on branch v3.9.x (Fix ``axline`` for slopes <= 1E-8. Closes #28386)
+* :ghpull:`28431`: Fix ``axline`` for slopes < 1E-8
+* :ghpull:`28881`: Fix ``axline`` for slopes <= 1E-8. Closes #28386
+* :ghpull:`28883`: Only check X11 when running Tkinter tests
+* :ghpull:`28859`: Backport PR #28858 on branch v3.9.x (Fix flaky labelcolor tests)
+* :ghpull:`28858`: Fix flaky labelcolor tests
+* :ghpull:`28839`: Backport PR #28836 on branch v3.9.x (MNT: Use __init__ parameters of font properties)
+* :ghpull:`28836`: MNT: Use __init__ parameters of font properties
+* :ghpull:`28828`: Backport PR #28818 on branch v3.9.x (Resolve configdir so that it's not a symlink when is_dir() is called)
+* :ghpull:`28818`: Resolve configdir so that it's not a symlink when is_dir() is called
+* :ghpull:`28811`: Backport PR #28810 on branch v3.9.x (Document how to obtain sans-serif usetex math.)
+* :ghpull:`28806`: Backport PR #28805 on branch v3.9.x (add brackets to satisfy the new sequence requirement)
+* :ghpull:`28802`: Backport PR #28798 on branch v3.9.x (DOC: Correctly list modules that have been internalized)
+* :ghpull:`28791`: Backport PR #28790 on branch v3.9.x (DOC: Fix duplicate Figure.set_dpi entry)
+* :ghpull:`28787`: Backport PR #28706 on branch v3.9.x (Add Returns info to to_jshtml docstring)
+* :ghpull:`28706`: Add Returns info to to_jshtml docstring
+* :ghpull:`28751`: Backport PR #28271 on branch v3.9.x (Fix draggable legend disappearing when picking while use_blit=True)
+* :ghpull:`28271`: Fix draggable legend disappearing when picking while use_blit=True
+* :ghpull:`28747`: Backport PR #28743 on branch v3.9.x (Minor fixes in ticker docs)
+* :ghpull:`28743`: Minor fixes in ticker docs
+* :ghpull:`28738`: Backport PR #28737 on branch v3.9.x (TST: Fix image comparison directory for test_striped_lines)
+* :ghpull:`28740`: Backport PR #28739 on branch v3.9.x (Tweak interactivity docs wording (and fix capitalization).)
+* :ghpull:`28737`: TST: Fix image comparison directory for test_striped_lines
+* :ghpull:`28733`: Backport PR #28732 on branch v3.9.x (Renames the minumumSizeHint method to minimumSizeHint)
+* :ghpull:`28732`: Renames the minumumSizeHint method to minimumSizeHint
+* :ghpull:`28689`: ci: Enable testing on Python 3.13
+* :ghpull:`28724`: Backport fixes from #28711
 
-Issues (9):
+Issues (6):
 
-* :ghissue:`28551`: [Bug]: Possible issue with Matplotlib 3.9.1 wheel on Windows only
-* :ghissue:`28250`: [Doc]: Sphinx gallery links mispointed for Axes3D methods
-* :ghissue:`28574`: [Bug]: Nondeterministic behavior with subplot spacing and constrained layout
-* :ghissue:`28626`: [Doc]: Remove old TODO's from animation.py
-* :ghissue:`28648`: [Bug]: format_image_data on an image of only zeros produces a large number of zeros
-* :ghissue:`28624`: [Bug]: Bad type hint in ``_AxesBase.twinx()``
-* :ghissue:`28567`: [Bug]: sticky edge related changes for datetime plots
-* :ghissue:`28533`: [Doc]: Stackplot hatch functionality has version dependencies
-* :ghissue:`28538`: [Bug]: Permission denied when importing matplotlib.pyplot
+* :ghissue:`28960`: [Bug]: High CPU utilization of the macosx backend
+* :ghissue:`28990`: [Bug]: no longer able to set multiple hatch colors
+* :ghissue:`28870`: [Bug]: axline doesn't work with some axes scales
+* :ghissue:`28386`: [Bug]: Minor issue - Drawing an axline sets slopes less than 1E-8 to 0
+* :ghissue:`28817`: [Bug]: ``~/.config/matplotlib`` is never used because ``~/.config`` is a symlink
+* :ghissue:`28716`: Size hint method in Qt backend should be named ``minimumSizeHint``, not ``minumumSizeHint``
 
 
 Previous GitHub statistics
diff --git a/doc/users/prev_whats_new/github_stats_3.9.2.rst b/doc/users/prev_whats_new/github_stats_3.9.2.rst
new file mode 100644
index 000000000000..542e0d81ce32
--- /dev/null
+++ b/doc/users/prev_whats_new/github_stats_3.9.2.rst
@@ -0,0 +1,96 @@
+.. _github-stats-3-9-2:
+
+GitHub statistics for 3.9.2 (Aug 12, 2024)
+==========================================
+
+GitHub statistics for 2024/07/04 (tag: v3.9.1) - 2024/08/12
+
+These lists are automatically generated, and may be incomplete or contain duplicates.
+
+We closed 9 issues and merged 45 pull requests.
+The full list can be seen `on GitHub <https://github.com/matplotlib/matplotlib/milestone/93?closed=1>`__
+
+The following 20 authors contributed 67 commits.
+
+* Adam J. Stewart
+* Anthony Lee
+* Caitlin Hathaway
+* ClarkeAC
+* dependabot[bot]
+* Elliott Sales de Andrade
+* Filippo Balzaretti
+* Greg Lucas
+* hannah
+* Ian Thomas
+* Jody Klymak
+* Kyle Sunden
+* Oscar Gustafsson
+* Randolf Scholz
+* Refael Ackermann
+* Ruth Comer
+* Scott Shambaugh
+* Sean Smith
+* Thomas A Caswell
+* Tim Hoffmann
+
+GitHub issues and pull requests:
+
+Pull Requests (45):
+
+* :ghpull:`28687`: BLD: Include MSVCP140 runtime statically
+* :ghpull:`28679`: Run delvewheel with path to required msvcp140.dll
+* :ghpull:`28695`: Backport PR #27797 on branch v3.9.x (DOC: Use video files for saving animations)
+* :ghpull:`28688`: Backport PR #28293 and #28668: Enable 3.13 wheels and bump cibuildwheel
+* :ghpull:`27797`: DOC: Use video files for saving animations
+* :ghpull:`28692`: Backport PR #28632 on branch v3.9.x (DOC: Tell sphinx-gallery to link mpl_toolkits from our build)
+* :ghpull:`28632`: DOC: Tell sphinx-gallery to link mpl_toolkits from our build
+* :ghpull:`28668`: Bump the actions group with 2 updates
+* :ghpull:`28686`: Backport PR #28682 on branch v3.9.x (Fix warnings from mingw compilers)
+* :ghpull:`28682`: Fix warnings from mingw compilers
+* :ghpull:`28676`: Backport PR #28577 on branch v3.9.x (Copy all internals from initial Tick to lazy ones)
+* :ghpull:`28577`: Copy all internals from initial Tick to lazy ones
+* :ghpull:`28674`: Backport PR #28650 on branch v3.9.x (remove out of date todos on animation.py)
+* :ghpull:`28650`: remove out of date todos on animation.py
+* :ghpull:`28656`: Backport PR #28649 on branch v3.9.x (FIX: improve formatting of image values in cases of singular norms)
+* :ghpull:`28665`: Backport PR #28546 on branch v3.9.x (DOC: Clarify/simplify example of multiple images with one colorbar)
+* :ghpull:`28649`: FIX: improve formatting of image values in cases of singular norms
+* :ghpull:`28635`: BLD: windows wheels
+* :ghpull:`28645`: Backport PR #28644 on branch v3.9.x (DOC: Fix matching for version switcher)
+* :ghpull:`28640`: Backport PR #28634 on branch v3.9.x (Closed open div tag in color.ColorMap._repr_html_)
+* :ghpull:`28634`: Closed open div tag in color.ColorMap._repr_html_
+* :ghpull:`28636`: Backport PR #28625 on branch v3.9.x (added typing_extensions.Self to _AxesBase.twinx)
+* :ghpull:`28625`: added typing_extensions.Self to _AxesBase.twinx
+* :ghpull:`28622`: Backport PR #28621 on branch v3.9.x (TYP: Fix a typo in animation.pyi)
+* :ghpull:`28621`: TYP: Fix a typo in animation.pyi
+* :ghpull:`28605`: Backport PR #28604 on branch v3.9.x (cycler signature update.)
+* :ghpull:`28604`: cycler signature update.
+* :ghpull:`28598`: Pin PyQt6 back on Ubuntu 20.04
+* :ghpull:`28596`: Backport PR #28518 on branch v3.9.x ([TYP] Fix overload of ``pyplot.subplots``)
+* :ghpull:`28518`: [TYP] Fix overload of ``pyplot.subplots``
+* :ghpull:`28591`: Backport PR #28580 on branch v3.9.x (Bump actions/attest-build-provenance from 1.3.2 to 1.3.3 in the actions group)
+* :ghpull:`28580`: Bump actions/attest-build-provenance from 1.3.2 to 1.3.3 in the actions group
+* :ghpull:`28586`: Backport PR #28582 on branch v3.9.x (FIX: make sticky edge tolerance relative to data range)
+* :ghpull:`28582`: FIX: make sticky edge tolerance relative to data range
+* :ghpull:`28572`: Backport PR #28571 on branch v3.9.x (DOC: Add version directive to hatch parameter in stackplot)
+* :ghpull:`28571`: DOC: Add version directive to hatch parameter in stackplot
+* :ghpull:`28564`: Backport PR #28534 on branch v3.9.x ([BLD] Fix WSL build warning)
+* :ghpull:`28563`: Backport PR #28526 on branch v3.9.x (Bump pypa/cibuildwheel from 2.19.1 to 2.19.2 in the actions group)
+* :ghpull:`28534`: [BLD] Fix WSL build warning
+* :ghpull:`28526`: Bump pypa/cibuildwheel from 2.19.1 to 2.19.2 in the actions group
+* :ghpull:`28552`: Backport PR #28541 on branch v3.9.x (MNT: be more careful about disk I/O failures when writing font cache)
+* :ghpull:`28541`: MNT: be more careful about disk I/O failures when writing font cache
+* :ghpull:`28524`: Backport PR #28523 on branch v3.9.x (Fix value error when set widget size to zero while using FigureCanvasQT )
+* :ghpull:`28523`: Fix value error when set widget size to zero while using FigureCanvasQT
+* :ghpull:`28519`: Backport PR #28517 on branch v3.9.x (DOC: better cross referencing for animations)
+
+Issues (9):
+
+* :ghissue:`28551`: [Bug]: Possible issue with Matplotlib 3.9.1 wheel on Windows only
+* :ghissue:`28250`: [Doc]: Sphinx gallery links mispointed for Axes3D methods
+* :ghissue:`28574`: [Bug]: Nondeterministic behavior with subplot spacing and constrained layout
+* :ghissue:`28626`: [Doc]: Remove old TODO's from animation.py
+* :ghissue:`28648`: [Bug]: format_image_data on an image of only zeros produces a large number of zeros
+* :ghissue:`28624`: [Bug]: Bad type hint in ``_AxesBase.twinx()``
+* :ghissue:`28567`: [Bug]: sticky edge related changes for datetime plots
+* :ghissue:`28533`: [Doc]: Stackplot hatch functionality has version dependencies
+* :ghissue:`28538`: [Bug]: Permission denied when importing matplotlib.pyplot
diff --git a/doc/users/release_notes.rst b/doc/users/release_notes.rst
index 74bc0f13bf1f..010f9b7534bc 100644
--- a/doc/users/release_notes.rst
+++ b/doc/users/release_notes.rst
@@ -23,6 +23,7 @@ Version 3.9
     ../api/prev_api_changes/api_changes_3.9.1.rst
     ../api/prev_api_changes/api_changes_3.9.0.rst
     github_stats.rst
+    prev_whats_new/github_stats_3.9.2.rst
     prev_whats_new/github_stats_3.9.1.rst
     prev_whats_new/github_stats_3.9.0.rst
 

From 3ac0aea8be540028cb2510dabb43b290d15b503d Mon Sep 17 00:00:00 2001
From: Elliott Sales de Andrade <quantum.analyst@gmail.com>
Date: Sat, 30 Nov 2024 03:33:58 -0500
Subject: [PATCH 1120/1120] REL: 3.9.3

This is the third bugfix release of the 3.9.x series.

This release contains several bug-fixes and adjustments:

- Fix `axline` with extremely small slopes
- Fix `axline` with non-linear axis scales
- Fix `minimumSizeHint` with Qt backend
- Fix config directory usage when it's behind a symlink
- Fix draggable legend when blitting is enabled
- Fix high CPU utilization in the `macosx` backend
- Fix multiple hatch `edgecolors` passed to `contourf`
- Improve compatibility with `pytest` 8.2.0