X-Git-Url: http://git.megacz.com/?a=blobdiff_plain;f=docs%2Fusers_guide%2Fghci.xml;h=1f20df4aab682abf69bc5151e09f53700abfb003;hb=d1984e439154e95b2804ee83897e740b1713c53d;hp=e0ea3aff7d6d32abfa5bccc1e7b6db0da93b3204;hpb=92049cd60bd98e7803ea5c46150d80376d296557;p=ghc-hetmet.git
diff --git a/docs/users_guide/ghci.xml b/docs/users_guide/ghci.xml
index e0ea3af..1f20df4 100644
--- a/docs/users_guide/ghci.xml
+++ b/docs/users_guide/ghci.xml
@@ -202,12 +202,12 @@ Ok, modules loaded: Main.
very often, and use the interpreter for the code being actively
developed.
- When loading up source files with :load,
- GHCi looks for any corresponding compiled object files, and will
- use one in preference to interpreting the source if possible. For
- example, suppose we have a 4-module program consisting of modules
- A, B, C, and D. Modules B and C both import D only,
- and A imports both B & C:
+ When loading up source modules with :load,
+ GHCi normally looks for any corresponding compiled object files,
+ and will use one in preference to interpreting the source if
+ possible. For example, suppose we have a 4-module program
+ consisting of modules A, B, C, and D. Modules B and C both import
+ D only, and A imports both B & C:
A
/ \
@@ -298,6 +298,17 @@ Compiling A ( A.hs, interpreted )
Ok, modules loaded: A, B, C, D.
+ The automatic loading of object files can sometimes lead to
+ confusion, because non-exported top-level definitions of a module
+ are only available for use in expressions at the prompt when the
+ module is interpreted (see ). For
+ this reason, if you ask GHCi to load a filename rather than a
+ module name (e.g. :load Main.hs rather than
+ :load Main) then any existing object file will
+ be ignored and the module will be interpreted rather than
+ compiled. Using -fobject-code disables this
+ behaviour (see ).
+
HINT: since GHCi will only use a compiled object file if it
can be sure that the compiled version is up-to-date, a good technique
when working on a large program is to occasionally run
@@ -306,7 +317,6 @@ Ok, modules loaded: A, B, C, D.
interpreter. As you modify code, the changed modules will be
interpreted, but the rest of the project will remain
compiled.
-
@@ -537,10 +547,14 @@ Compiling Main ( Main.hs, interpreted )
scopes from multiple modules, in any mixture of
* and non-* forms. GHCi
combines the scopes from all of these modules to form the scope
- that is in effect at the prompt. For technical reasons, GHCi
- can only support the *-form for modules which
- are interpreted, so compiled modules and package modules can
- only contribute their exports to the current scope.
+ that is in effect at the prompt.
+
+ NOTE: for technical reasons, GHCi can only support the
+ *-form for modules that are interpreted.
+ Compiled modules and package modules can only contribute their
+ exports to the current scope. This is why GHCi will always
+ interpret, not compile, a module if you specify its filename
+ rather than its module name to :load.The scope is manipulated using the
:module command. For example, if the current
@@ -602,12 +616,48 @@ Prelude IO>
+ :module and
+ :load
+
+ It might seem that :module and
+ :load do similar things: you can use both
+ to bring a module into scope. However, there is a clear
+ difference. GHCi is concerned with two sets of modules:
+
+
+
+ The set of modules that are
+ currently loaded. This set is
+ modified
+ by :load, :add
+ and :reload.
+
+
+
+ The set of modules that are currently in
+ scope at the prompt. This set is modified
+ by :module, and it is also set
+ automatically
+ after :load, :add,
+ and :reload.
+
+
+
+ You cannot add a module to the scope if it is not
+ loaded. This is why trying to
+ use :module to load a new module results
+ in the message “module M is not
+ loaded”.
+
+
+ Qualified namesTo make life slightly easier, the GHCi prompt also
behaves as if there is an implicit import
qualified declaration for every module in every
- package, and every module currently loaded into GHCi.
+ package, and every module currently loaded into GHCi. This
+ behaviour can be disabled with the flag .