summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorPhuong Trinh <lolotp@fb.com>2019-03-30 19:00:12 +0000
committerMarge Bot <ben+marge-bot@smart-cactus.org>2019-04-08 14:35:43 -0400
commit2b3f4718502465e2b4dfa4a7868ed7a3ad5e4ff1 (patch)
treeefa049b8a63f6fee669379b6a09e301ea7da7ec9 /docs
parent63b7d5fb9d695dafc243cbf6f9f70b06030c0dea (diff)
downloadhaskell-2b3f4718502465e2b4dfa4a7868ed7a3ad5e4ff1.tar.gz
Fix #16500: look for interface files in -hidir flag in OneShot mode
We are currently ignoring options set in the hiDir field of hsc_dflags when looking for interface files while compiling in OneShot mode. This is inconsistent with the behaviour of other directory redirecting fields (such as objectDir or hieDir). It is also inconsistent with the behaviour of compilation in CompManager mode (a.k.a `ghc --make`) which looks for interface files in the directory set in hidir flag. This changes Finder.hs so that we use the value of hiDir while looking for interface in OneShot mode.
Diffstat (limited to 'docs')
-rw-r--r--docs/users_guide/separate_compilation.rst11
1 files changed, 11 insertions, 0 deletions
diff --git a/docs/users_guide/separate_compilation.rst b/docs/users_guide/separate_compilation.rst
index 1c5e34a479..d591736ed4 100644
--- a/docs/users_guide/separate_compilation.rst
+++ b/docs/users_guide/separate_compilation.rst
@@ -260,6 +260,9 @@ Redirecting the compilation output(s)
example, they would still be put in ``parse/Foo.hi``,
``parse/Bar.hi``, and ``gurgle/Bumble.hi``.
+ Please also note that when doing incremental compilation, this directory is
+ where GHC looks into to find object files from previous builds.
+
.. ghc-flag:: -ohi ⟨file⟩
:shortdesc: set the filename in which to put the interface
:type: dynamic
@@ -288,6 +291,10 @@ Redirecting the compilation output(s)
Redirects all generated interface files into ⟨dir⟩, instead of the
default.
+ Please also note that when doing incremental compilation (by ``ghc --make``
+ or ``ghc -c``), this directory is where GHC looks into to find interface
+ files.
+
.. ghc-flag:: -hiedir ⟨dir⟩
:shortdesc: set directory for extended interface files
:type: dynamic
@@ -296,6 +303,10 @@ Redirecting the compilation output(s)
Redirects all generated extended interface files into ⟨dir⟩, instead of
the default.
+ Please also note that when doing incremental compilation (by ``ghc --make``
+ or ``ghc -c``), this directory is where GHC looks into to find extended
+ interface files.
+
.. ghc-flag:: -stubdir ⟨dir⟩
:shortdesc: redirect FFI stub files
:type: dynamic