diff options
| author | Ben Gamari <ben@smart-cactus.org> | 2019-03-31 16:22:04 -0400 |
|---|---|---|
| committer | Marge Bot <ben+marge-bot@smart-cactus.org> | 2019-04-09 10:23:47 -0400 |
| commit | 36d380475d9056fdf93305985be3def00aaf6cf7 (patch) | |
| tree | fcf04a722410f8010e5239e43fc46c5a62a787fd /docs/users_guide/packages.rst | |
| parent | cf9e1837adc647c90cfa176669d14e0d413c043d (diff) | |
| download | haskell-36d380475d9056fdf93305985be3def00aaf6cf7.tar.gz | |
users-guide: Document how to disable package environments
As noted in #16309 this somehow went undocumented.
Diffstat (limited to 'docs/users_guide/packages.rst')
| -rw-r--r-- | docs/users_guide/packages.rst | 10 |
1 files changed, 8 insertions, 2 deletions
diff --git a/docs/users_guide/packages.rst b/docs/users_guide/packages.rst index 9383b8ad68..2d6253bf92 100644 --- a/docs/users_guide/packages.rst +++ b/docs/users_guide/packages.rst @@ -579,6 +579,12 @@ must be relative to the location of the package environment file. Use the package environment in ⟨file⟩, or in ``$HOME/.ghc/arch-os-version/environments/⟨name⟩`` + If set to ``-`` no package environment is read. + +.. envvar:: GHC_ENVIRONMENT + + Specifies the path to the package environment file to be used by GHC. + Overridden by the :ghc-flag:`-package-env ⟨file⟩|⟨name⟩` flag if set. In order, ``ghc`` will look for the package environment in the following locations: @@ -588,11 +594,11 @@ locations: - File ``$HOME/.ghc/arch-os-version/environments/name`` if you pass the option ``-package-env ⟨name⟩``. -- File ⟨file⟩ if the environment variable ``GHC_ENVIRONMENT`` is set to +- File ⟨file⟩ if the environment variable :envvar:`GHC_ENVIRONMENT` is set to ⟨file⟩. - File ``$HOME/.ghc/arch-os-version/environments/name`` if the - environment variable ``GHC_ENVIRONMENT`` is set to ⟨name⟩. + environment variable :envvar:`GHC_ENVIRONMENT` is set to ⟨name⟩. Additionally, unless ``-hide-all-packages`` is specified ``ghc`` will also look for the package environment in the following locations: |