Skip to content

Commit b258617

Browse files
story645ksunden
andcommitted
Added info for getting compilation output from meson on autorebuild
Co-authored-by: Kyle Sunden <git@ksunden.space>
1 parent a99673c commit b258617

File tree

1 file changed

+14
-6
lines changed

1 file changed

+14
-6
lines changed

doc/devel/development_setup.rst

Lines changed: 14 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -164,12 +164,20 @@ command ::
164164

165165
The 'editable/develop mode' builds everything and places links in your Python environment
166166
so that Python will be able to import Matplotlib from your development source directory.
167-
This allows you to import your modified version of Matplotlib without re-installing after
168-
every change. Note that before the merging of the `Meson port
169-
<https://github.com/matplotlib/matplotlib/pull/26621>`_, this is only true for ``*.py``
170-
files. If you change the C-extension source based on a commit before the change to the
171-
Meson build system (which might also happen if you change branches), you will have to
172-
re-run the above command.
167+
This allows you to import your modified version of Matplotlib without having to
168+
re-install after changing a ``.py`` or C-extension file.
169+
170+
If you are working heavily with C-extension files, you may want to inspect the
171+
compilation log on build. One method for doing so is to set the
172+
``editable-verbose`` config setting for the package on install ::
173+
174+
python -m pip install --no-build-isolation --config-settings=editable-verbose=true --editable .
175+
176+
For more information on installation, see the `meson-python <https://meson-python.readthedocs.io/en/latest/index.html>`_
177+
docs. Meson was enabled fairly recently (:ghpull:`26621`); therefore, if you are
178+
working in a branch that does not yet have the commit then you will have to
179+
reinstall each time you change any C-extension code.
180+
173181

174182
Verify the Installation
175183
=======================

0 commit comments

Comments
 (0)