X-Git-Url: http://git.megacz.com/?a=blobdiff_plain;f=docs%2Fusers_guide%2Fghci.xml;h=e0ea3aff7d6d32abfa5bccc1e7b6db0da93b3204;hb=bae441b99a087de4998dfa88f7649de0338f3e79;hp=528a6522894263ca5089928396e85ee46415b70b;hpb=d2b3daa3cc474e6ab010fb6af5c21ddb852b8b5b;p=ghc-hetmet.git
diff --git a/docs/users_guide/ghci.xml b/docs/users_guide/ghci.xml
index 528a652..e0ea3af 100644
--- a/docs/users_guide/ghci.xml
+++ b/docs/users_guide/ghci.xml
@@ -611,7 +611,7 @@ Prelude IO>
- The :main command
+ The :main and :run commands
When a program is compiled and executed, it can use the
@@ -636,6 +636,37 @@ Prelude> :main foo bar
["foo","bar"]
+
+ We can also quote arguments which contains characters like
+ spaces, and they are treated like Haskell strings, or we can
+ just use Haskell list syntax:
+
+
+
+Prelude> :main foo "bar baz"
+["foo","bar baz"]
+Prelude> :main ["foo", "bar baz"]
+["foo","bar baz"]
+
+
+
+ Finally, other functions can be called, either with the
+ -main-is flag or the :run
+ command:
+
+
+
+Prelude> let foo = putStrLn "foo" >> System.Environment.getArgs >>= print
+Prelude> let bar = putStrLn "bar" >> System.Environment.getArgs >>= print
+Prelude> :set -main-is foo
+Prelude> :main foo "bar baz"
+foo
+["foo","bar baz"]
+Prelude> :run bar ["foo", "bar baz"]
+bar
+["foo","bar baz"]
+
+
@@ -814,10 +845,12 @@ def = toEnum 0
GHCi contains a simple imperative-style debugger in which you can
stop a running computation in order to examine the values of
variables. The debugger is integrated into GHCi, and is turned on by
- default: no flags are required to enable the debugging facilities. There
- is one major restriction: breakpoints and single-stepping are only
- available in interpreted modules; compiled code is
- invisible to the debugger.
+ default: no flags are required to enable the debugging
+ facilities. There is one major restriction: breakpoints and
+ single-stepping are only available in interpreted modules;
+ compiled code is invisible to the debuggerNote that packages
+ only contain compiled code, so debugging a package requires
+ finding its source and loading that directly..
The debugger provides the following:
@@ -852,9 +885,12 @@ def = toEnum 0
There is currently no support for obtaining a “stack
- trace”, but the tracing and history features provide a useful
- second-best, which will often be enough to establish the context of an
- error.
+ trace”, but the tracing and history features provide a
+ useful second-best, which will often be enough to establish the
+ context of an error. For instance, it is possible to break
+ automatically when an exception is thrown, even if it is thrown
+ from within compiled code (see ).
Breakpoints and inspecting variables
@@ -2119,6 +2155,37 @@ Prelude> :main foo bar
["foo","bar"]
+
+ We can also quote arguments which contains characters like
+ spaces, and they are treated like Haskell strings, or we can
+ just use Haskell list syntax:
+
+
+
+Prelude> :main foo "bar baz"
+["foo","bar baz"]
+Prelude> :main ["foo", "bar baz"]
+["foo","bar baz"]
+
+
+
+ Finally, other functions can be called, either with the
+ -main-is flag or the :run
+ command:
+
+
+
+Prelude> let foo = putStrLn "foo" >> System.Environment.getArgs >>= print
+Prelude> let bar = putStrLn "bar" >> System.Environment.getArgs >>= print
+Prelude> :set -main-is foo
+Prelude> :main foo "bar baz"
+foo
+["foo","bar baz"]
+Prelude> :run bar ["foo", "bar baz"]
+bar
+["foo","bar baz"]
+
+
@@ -2560,18 +2627,34 @@ Prelude> :set -fno-glasgow-exts
When it starts, unless the -ignore-dot-ghci
- flag is given, GHCi reads and executes commands from
- ./.ghci, followed by
- $HOME/.ghci.
-
- The .ghci in your home directory is
- most useful for turning on favourite options (eg. :set
- +s), and defining useful macros. Placing a
- .ghci file in a directory with a Haskell
- project is a useful way to set certain project-wide options so you
- don't have to type them everytime you start GHCi: eg. if your
- project uses GHC extensions and CPP, and has source files in three
- subdirectories A, B and C, you might put the following lines in
+ flag is given, GHCi reads and executes commands from the following
+ files, in this order, if they exist:
+
+
+
+ ./.ghci
+
+
+ appdata/ghc/ghci.conf,
+ where appdata depends on your system,
+ but is usually something like C:/Documents and Settings/user/Application Data
+
+
+ On Unix: $HOME/.ghc/ghci.conf
+
+
+ $HOME/.ghci
+
+
+
+ The ghci.conf file is most useful for
+ turning on favourite options (eg. :set +s), and
+ defining useful macros. Placing a .ghci file
+ in a directory with a Haskell project is a useful way to set
+ certain project-wide options so you don't have to type them
+ everytime you start GHCi: eg. if your project uses GHC extensions
+ and CPP, and has source files in three subdirectories A, B and C,
+ you might put the following lines in
.ghci:
@@ -2584,8 +2667,24 @@ Prelude> :set -fno-glasgow-exts
:set like this. The changes won't take effect
until the next :load, though.)
+ Once you have a library of GHCi macros, you may want
+ to source them from separate files, or you may want to source
+ your .ghci file into your running GHCi
+ session while debugging it
+
+
+:def source readFile
+
+
+ With this macro defined in your .ghci
+ file, you can use :source file to read GHCi
+ commands from file. You can find (and contribute!-)
+ other suggestions for .ghci files on this Haskell
+ wiki page: GHC/GHCi
+
Two command-line options control whether the
- .ghci files are read:
+ startup files files are read:
@@ -2594,8 +2693,8 @@ Prelude> :set -fno-glasgow-exts
- Don't read either ./.ghci or
- $HOME/.ghci when starting up.
+ Don't read either ./.ghci or the
+ other startup files when starting up.
@@ -2604,8 +2703,8 @@ Prelude> :set -fno-glasgow-exts
- Read .ghci and
- $HOME/.ghci. This is normally the
+ Read ./.ghci and the other
+ startup files (see above). This is normally the
default, but the option may
be used to override a previous
option.