From: simonpj <unknown>
Date: Fri, 18 Mar 2005 09:38:12 +0000 (+0000)
Subject: [project @ 2005-03-18 09:38:12 by simonpj]
X-Git-Tag: Initial_conversion_from_CVS_complete~888
X-Git-Url: http://git.megacz.com/?a=commitdiff_plain;h=a983db17f78650e0e032a08283d89c7c04de276c;p=ghc-hetmet.git

[project @ 2005-03-18 09:38:12 by simonpj]
Clarify -main-is documentation
---

diff --git a/ghc/docs/users_guide/phases.xml b/ghc/docs/users_guide/phases.xml
index af80577..a1c8b70 100644
--- a/ghc/docs/users_guide/phases.xml
+++ b/ghc/docs/users_guide/phases.xml
@@ -775,7 +775,15 @@ $ cat foo.hspp</screen>
       	</itemizedlist>
             Strictly speaking, <option>-main-is</option> is not a link-phase flag at all; it has no effect on the link step.
             The flag must be specified when compiling the module containing the specified main function (e.g. module <literal>A</literal>
-            in the latter two items above.  It has no effect for other modules (and hence can safely be given to <literal>ghc --make</literal>).
+            in the latter two items above).  It has no effect for other modules,
+            and hence can safely be given to <literal>ghc --make</literal>.
+	    However, if all the modules are otherwise up to date, you may need to force
+	    recompilation both of the module where the new "main" is, and of the
+	    module where the "main" function used to be;
+	    <literal>ghc</literal> is not clever 
+	    enough to figure out that they both need recompiling.  You can
+	    force recompilation by removing the object file, or by using the
+	    <option>-no-recomp</option> flag.
             </para> 
         </listitem>
       </varlistentry>