Added info for getting compilation output from meson on autorebuild

story645 · ksunden · story645 · commit 41d9849cce11 · 2023-10-11T21:37:48.000-04:00
and added meson-python to intersphinx

Co-authored-by: Kyle Sunden &lt;git@ksunden.space&gt;
diff --git 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
@@ -164,12 +164,22 @@ 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.
+
+If you are working heavily with files that need to be compiled, you may want to
+inspect the compilation log. This can be enabled temporarily by setting the environment
+variable :envvar:`MESONPY_EDITABLE_VERBOSE` or permanently by setting the
+``editable-verbose`` config when installing ::
+
+    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>`.
+Meson was enabled in :ghpull:`26621`; therefore you will have to reinstall
+each time you change any compiled extension code when working on a branch that
+does not have the commits from that pull request in its history (log).
+
 
 Verify the Installation
 =======================
diff --git a/pyproject.toml b/pyproject.toml
@@ -277,4 +277,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+.*\"."
 ]

Original file line number	Diff line number	Diff line change
`@@ -207,6 +207,7 @@ def _check_dependencies():`
`207`	`207`	`'scipy': ('https://docs.scipy.org/doc/scipy/', None),`
`208`	`208`	`'tornado': ('https://www.tornadoweb.org/en/stable/', None),`
`209`	`209`	`'xarray': ('https://docs.xarray.dev/en/stable/', None),`
	`210`	`+ 'meson-python': ('https://meson-python.readthedocs.io/en/stable/', None)`
`210`	`211`	`}`
`211`	`212`
`212`	`213`
Original file line number	Diff line number	Diff line change
`@@ -277,4 +277,7 @@ ignore_messages = [`
`277`	`277`	`"Hyperlink target \".*\" is not referenced.",`
`278`	`278`	`"Duplicate implicit target name: \".*\".",`
`279`	`279`	`"Duplicate explicit target name: \".*\".",`
	`280`	`+ # sphinx.ext.intersphinx directives`
	`281`	`+ "No role entry for \"external+.*\".",`
	`282`	`+ "Unknown interpreted text role \"external+.*\"."`
`280`	`283`	`]`