clarified no-build-isolation

story645 · story645 · commit bf3560ffbacc · 2024-06-14T16:26:47.000-04:00
diff --git a/doc/conf.py b/doc/conf.py
@@ -236,7 +236,8 @@ 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://meson-python.readthedocs.io/en/stable/', None),
+    'pip': ('https://pip.pypa.io/en/stable/', None),
 }
 
 
diff --git a/doc/install/dependencies.rst b/doc/install/dependencies.rst
@@ -222,14 +222,13 @@ Build 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.
-
-If you are developing Matplotlib and unable to use our environment configurations,
-then you must manually install the following packages into your development environment:
+``pip`` normally builds packages using :external+pip:doc:`build isolation <reference/build-system/pyproject-toml>`,
+which means that ``pip`` installs the dependencies listed here for the
+duration of the build process. However, build isolation is disabled via the the
+:external+pip:ref:`--no-build-isolation <install_--no-build-isolation>` flag
+when :ref:`installing Matplotlib for development <development-install>`, which
+means that the dependencies must be explicitly installed, either by :ref:`creating a virtual environment <dev-environment>`
+(recommended) or by manually installing the following packages:
 
 - `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

Original file line number	Diff line number	Diff line change
`@@ -236,7 +236,8 @@ def _check_dependencies():`
`236`	`236`	`'scipy': ('https://docs.scipy.org/doc/scipy/', None),`
`237`	`237`	`'tornado': ('https://www.tornadoweb.org/en/stable/', None),`
`238`	`238`	`'xarray': ('https://docs.xarray.dev/en/stable/', None),`
`239`		`- 'meson-python': ('https://meson-python.readthedocs.io/en/stable/', None)`
	`239`	`+ 'meson-python': ('https://meson-python.readthedocs.io/en/stable/', None),`
	`240`	`+ 'pip': ('https://pip.pypa.io/en/stable/', None),`
`240`	`241`	`}`
`241`	`242`
`242`	`243`