Merge branch 'matplotlib:main' into axes-bar-unit-test-for-issue-26864

Author: kots14

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::
 

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.

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.

doc/api/next_api_changes/removals/26900-jf.rst

@@ -0,0 +1,4 @@
+``passthru_pt``
+~~~~~~~~~~~~~~~
+
+This attribute of ``AxisArtistHelper``\s has been removed.

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.

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)
 }
 
 

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: