From: claus.reinke@talk21.com <unknown>
Date: Thu, 1 May 2008 20:52:52 +0000 (+0000)
Subject: document :source command for GHCi, point to Haskell wiki
X-Git-Tag: 2008-05-28~3
X-Git-Url: http://git.megacz.com/?p=ghc-hetmet.git;a=commitdiff_plain;h=92049cd60bd98e7803ea5c46150d80376d296557

document :source command for GHCi, point to Haskell wiki

	as discussed in this thread:
	http://www.haskell.org/pipermail/glasgow-haskell-users/2008-April/014614.html
---

diff --git a/docs/users_guide/ghci.xml b/docs/users_guide/ghci.xml
index 35aa7cd..e0ea3af 100644
--- a/docs/users_guide/ghci.xml
+++ b/docs/users_guide/ghci.xml
@@ -2667,6 +2667,22 @@ Prelude> :set -fno-glasgow-exts
     <literal>:set</literal> like this.  The changes won't take effect
     until the next <literal>:load</literal>, though.)</para>
 
+    <para>Once you have a library of GHCi macros, you may want
+    to source them from separate files, or you may want to source
+    your <filename>.ghci</filename> file into your running GHCi
+    session while debugging it</para>
+
+<screen>
+:def source readFile
+</screen>
+
+    <para>With this macro defined in your <filename>.ghci</filename> 
+    file, you can use <literal>:source file</literal> to read GHCi
+    commands from <literal>file</literal>. You can find (and contribute!-)
+    other suggestions for <filename>.ghci</filename> files on this Haskell
+    wiki page: <ulink
+      url="http://haskell.org/haskellwiki/GHC/GHCi">GHC/GHCi</ulink></para>
+
     <para>Two command-line options control whether the
     startup files files are read:</para>