doc/manual/developing: Clarify Nix PYTHONPATH usage

PYTHONPATH should still contain all the other directories
(obvious once you've made that mistake once, of course).
This commit is contained in:
David Nadlinger 2019-12-23 00:50:03 +00:00 committed by GitHub
parent af31c6ea21
commit e8b9fcf0bb
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -22,4 +22,4 @@ ARTIQ itself does not depend on Nix, and it is also possible to compile everythi
* If you are modifying a dependency of ARTIQ, in addition to updating the relevant part of ``nix-scripts``, rebuild and upload the corresponding Conda packages manually, and update their version numbers in ``conda-artiq.nix``. For Conda, only the main ARTIQ package and the board packages are handled automatically on Hydra.
.. warning::
Nix will make a read-only copy of the ARTIQ source to use in the shell environment. Therefore, any modifications that you make to the source after the shell is started will not be taken into account. A solution applicable to ARTIQ (and several other Python packages such as Migen and MiSoC) is to set the ``PYTHONPATH`` environment variable in the shell to the root of the ARTIQ source. If you want this to be done by default, edit ``profile`` in ``artiq-dev.nix``.
Nix will make a read-only copy of the ARTIQ source to use in the shell environment. Therefore, any modifications that you make to the source after the shell is started will not be taken into account. A solution applicable to ARTIQ (and several other Python packages such as Migen and MiSoC) is to prepend the ARTIQ source directory to the ``PYTHONPATH`` environment variable after entering the shell. If you want this to be done by default, edit ``profile`` in ``artiq-dev.nix``.