Added info for getting compilation output from meson on autorebuild

story645 · ksunden · story645 · commit 87faf312edef · 2023-10-10T23:16:38.000-04:00
Co-authored-by: Kyle Sunden &lt;git@ksunden.space&gt;
diff --git a/doc/devel/development_setup.rst b/doc/devel/development_setup.rst
@@ -164,12 +164,21 @@ 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 on each rebuild. To do so, set the ``editable-verbose``
+config setting for the package on install ::
+
+    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 <https://meson-python.readthedocs.io/en/latest/index.html>`_
+docs. Meson was enabled fairly recently (:ghpull:`26621`); therefore when working
+on a branch that does not yet have the commit, you will have to reinstall each
+time you change any compiled extension code.
+
 
 Verify the Installation
 =======================
