More doc output fixes
[ghc-hetmet.git] / docs / users_guide / ghci.xml
index 1736757..929e9dd 100644 (file)
 $ ghci
    ___         ___ _
   / _ \ /\  /\/ __(_)
- / /_\// /_/ / /  | |      GHC Interactive, version 5.04, for Haskell 98.
+ / /_\// /_/ / /  | |      GHC Interactive, version 6.6, for Haskell 98.
 / /_\\/ __  / /___| |      http://www.haskell.org/ghc/
 \____/\/ /_/\____/|_|      Type :? for help.
 
 Loading package base ... linking ... done.
-Loading package haskell98 ... linking ... done.
 Prelude> 
 </screen>
 
@@ -45,40 +44,41 @@ Prelude>
 <screen>
  Commands available from the prompt:
 
-   &lt;stmt&gt;                     evaluate/run &lt;stmt&gt;
-   :add &lt;filename&gt; ...        add module(s) to the current target set
-   :browse [*]&lt;module&gt;        display the names defined by &lt;module&gt;
-   :cd &lt;dir&gt;                  change directory to &lt;dir&gt;
-   :def &lt;cmd&gt; &lt;expr&gt;          define a command :&lt;cmd&gt;
-   :help, :?                  display this list of commands
-   :info [&lt;name&gt; ...]         display information about the given names
-   :load &lt;filename&gt; ...       load module(s) and their dependents
-   :module [+/-] [*]&lt;mod&gt; ... set the context for expression evaluation
-   :reload                    reload the current module set
-
-   :set &lt;option&gt; ...          set options
-   :set args &lt;arg&gt; ...        set the arguments returned by System.getArgs
-   :set prog &lt;progname&gt;       set the value returned by System.getProgName
-   :set prompt &lt;prompt&gt;       set the prompt used in GHCi
-   :show modules              show the currently loaded modules
-   :show bindings             show the current bindings made at the prompt
-
-   :ctags [&lt;file&gt;]            create tags file for Vi (default: "tags")
-   :etags [&lt;file&gt;]            create tags file for Emacs (defauilt: "TAGS")
-   :type &lt;expr&gt;               show the type of &lt;expr&gt;
-   :kind &lt;type&gt;               show the kind of &lt;type&gt;
-   :undef &lt;cmd&gt;               undefine user-defined command :&lt;cmd&gt;
-   :unset &lt;option&gt; ...        unset options
-   :quit                      exit GHCi
-   :!&lt;command&gt;                run the shell command &lt;command&gt;
-
- Options for `:set' and `:unset':
-
-    +r                 revert top-level expressions after each evaluation
-    +s                 print timing/memory stats after each evaluation
-    +t                 print type after evaluation
-    -&lt;flags&gt;           most GHC command line flags can also be set here
+   &lt;stmt&gt;                      evaluate/run &lt;stmt&gt;
+   :add &lt;filename&gt; ...         add module(s) to the current target set
+   :browse [*]&lt;module&gt;         display the names defined by &lt;module&gt;
+   :cd &lt;dir&gt;                   change directory to &lt;dir&gt;
+   :def &lt;cmd&gt; &lt;expr&gt;           define a command :&lt;cmd&gt;
+   :help, :?                   display this list of commands
+   :info [&lt;name&gt; ...]          display information about the given names
+   :load &lt;filename&gt; ...        load module(s) and their dependents
+   :module [+/-] [*]&lt;mod&gt; ...  set the context for expression evaluation
+   :main [&lt;arguments&gt; ...]     run the main function with the given arguments
+   :reload                     reload the current module set
+
+   :set &lt;option&gt; ...           set options
+   :set args &lt;arg&gt; ...         set the arguments returned by System.getArgs
+   :set prog &lt;progname&gt;        set the value returned by System.getProgName
+   :set prompt &lt;prompt&gt;        set the prompt used in GHCi
+
+   :show modules               show the currently loaded modules
+   :show bindings              show the current bindings made at the prompt
+
+   :ctags [&lt;file&gt;]             create tags file for Vi (default: "tags")
+   :etags [&lt;file&gt;]             create tags file for Emacs (defauilt: "TAGS")
+   :type &lt;expr&gt;                show the type of &lt;expr&gt;
+   :kind &lt;type&gt;                show the kind of &lt;type&gt;
+   :undef &lt;cmd&gt;                undefine user-defined command :&lt;cmd&gt;
+   :unset &lt;option&gt; ...         unset options
+   :quit                       exit GHCi
+   :!&lt;command&gt;                 run the shell command &lt;command&gt;
+
+ Options for ':set' and ':unset':
+
+    +r            revert top-level expressions after each evaluation
+    +s            print timing/memory stats after each evaluation
+    +t            print type after evaluation
+    -&lt;flags&gt;      most GHC command line flags can also be set here
                          (eg. -v2, -fglasgow-exts, etc.)
 </screen>
 
@@ -350,7 +350,7 @@ Ok, modules loaded: A, B, C, D.
 </screen>
 
     <para>HINT: since GHCi will only use a compiled object file if it
-    can sure that the compiled version is up-to-date, a good technique
+    can be sure that the compiled version is up-to-date, a good technique
     when working on a large program is to occasionally run
     <literal>ghc &ndash;&ndash;make</literal> to compile the whole project (say
     before you go for lunch :-), then continue working in the
@@ -561,9 +561,9 @@ Compiling Main             ( Main.hs, interpreted )
 
 <screen>
 Prelude> :module +IO
-Prelude,IO> hPutStrLn stdout "hello\n"
+Prelude IO> hPutStrLn stdout "hello\n"
 hello
-Prelude,IO>
+Prelude IO>
 </screen>
 
       <para>(Note: <literal>:module</literal> can be shortened to
@@ -593,7 +593,7 @@ Prelude,IO>
       <literal>Bar</literal>, then the scope will be set to
       <literal>*Bar</literal> if <literal>Bar</literal> is
       interpreted, or if <literal>Bar</literal> is compiled it will be
-      set to <literal>Prelude,Bar</literal> (GHCi automatically adds
+      set to <literal>Prelude Bar</literal> (GHCi automatically adds
       <literal>Prelude</literal> if it isn't present and there aren't
       any <literal>*</literal>-form modules).</para>
 
@@ -633,9 +633,9 @@ Prelude> it * 2
     expression, and if it doesn't have an <literal>IO</literal> type,
     then it transforms it as follows: an expression
     <replaceable>e</replaceable> turns into 
-<screen>     
-             let it = <replaceable>e</replaceable>;
-             print it
+<screen>
+let it = <replaceable>e</replaceable>;
+print it
 </screen>
     which is then run as an IO-action.</para>
 
@@ -644,10 +644,14 @@ Prelude> it * 2
     complain:</para>
 
 <screen>
-Prelude> id
-No instance for `Show (a -> a)'
-arising from use of `print'
-in a `do' expression pattern binding: print it
+Prelude&gt; id
+
+&lt;interactive&gt;:1:0:
+    No instance for (Show (a -&gt; a))
+      arising from use of `print' at &lt;interactive&gt;:1:0-1
+    Possible fix: add an instance declaration for (Show (a -> a))
+    In the expression: print it
+    In a 'do' expression: print it
 </screen>
 
     <para>The error message contains some clues as to the
@@ -659,14 +663,15 @@ in a `do' expression pattern binding: print it
       which is of type <literal>a</literal>.  eg.:</para>
 <screen>
 Prelude> Time.getClockTime
+Wed Mar 14 12:23:13 GMT 2001
 Prelude> print it
 Wed Mar 14 12:23:13 GMT 2001
 </screen>
 
       <para>The corresponding translation for an IO-typed
       <replaceable>e</replaceable> is
-<screen>     
-             it &lt;- <replaceable>e</replaceable>
+<screen>
+it &lt;- <replaceable>e</replaceable>
 </screen>
       </para>