X-Git-Url: http://git.megacz.com/?a=blobdiff_plain;f=ghc%2Fdocs%2Fusers_guide%2Fseparate_compilation.sgml;h=45e6c9c251656a3f25101d8da56c98d7fcddf51f;hb=c732b368a1799e8dce0ad88c22a39202b3f35662;hp=1433a3e07f2408c9855111593f74c93967c512d9;hpb=8d54472ec1022cedf40f28730c0891a49fc082fc;p=ghc-hetmet.git

diff --git a/ghc/docs/users_guide/separate_compilation.sgml b/ghc/docs/users_guide/separate_compilation.sgml
index 1433a3e..45e6c9c 100644
--- a/ghc/docs/users_guide/separate_compilation.sgml
+++ b/ghc/docs/users_guide/separate_compilation.sgml
@@ -83,11 +83,21 @@
 	  <term><option>-i&lt;dirs&gt;</option></term>
 	  <listitem>
 	    <para><indexterm><primary><option>-i&lt;dirs&gt;</option>
-            </primary></indexterm>This flag prepends a colon-separated
+            </primary></indexterm>This flag appends a colon-separated
             list of <filename>dirs</filename> to the &ldquo;import
-            directories&rdquo; list.  See also <XRef LinkEnd="recomp">
-            for the significance of using relative and absolute
-            pathnames in the <option>-i</option> list.</para>
+            directories&rdquo; list, which initially contains a single
+            entry: <quote>.</quote>.</para>
+
+	    <para>This list is scanned before any package directories
+            (see <xref linkend="packages">) when looking for imports,
+            but note that if you have a home module with the same name
+            as a package module then this is likely to cause trouble
+            in other ways, with link errors being the least nasty
+            thing that can go wrong...</para>
+
+	    <para>See also <XRef LinkEnd="recomp"> for the
+            significance of using relative and absolute pathnames in
+            the <option>-i</option> list.</para>
 	  </listitem>
 	</varlistentry>
 
@@ -113,19 +123,6 @@
 
       <variablelist>
 	<varlistentry>
-	  <term><option>-ohi</option>  <replaceable>file</replaceable></term>
-	  <indexterm><primary><option>-ohi</option></primary>
-	  </indexterm>
-	  <listitem>
-	    <para>The interface output may be directed to another file
-            <filename>bar2/Wurble.iface</filename> with the option
-            <option>-ohi bar2/Wurble.iface</option> (not recommended).
-            To avoid generating an interface at all, you can say
-            <literal>-ohi /dev/null</literal>, for example.</para>
-	  </listitem>
-	</varlistentry>
-
-	<varlistentry>
 	  <term><option>-ddump-hi</option></term>
 	  <indexterm><primary><option>-ddump-hi</option></primary>
 	  </indexterm>
@@ -367,6 +364,14 @@ A.o : B.hi-boot
         <filename>makefile</filename>, then the old dependencies are
         deleted first.</para>
 
+	<para>Don't forget to use the same <option>-package</option>
+	options on the <literal>ghc -M</literal> command line as you
+	would when compiling; this enables the dependency generator to
+	locate any imported modules that come from packages.  The
+	package modules won't be included in the dependencies
+	generated, though (but see the
+	<option>&ndash;&ndash;include-prelude</option> option below).</para>
+
 	<para>The dependency generation phase of GHC can take some
         additional options, which you may find useful.  For historical
         reasons, each option passed to the dependency generator from
@@ -439,7 +444,7 @@ ghc -M -optdep-f -optdep.depend ...
 	  </varlistentry>
 
 	  <varlistentry>
-	    <term><option>--exclude-module=&lt;file&gt;</option></term>
+	    <term><option>&ndash;&ndash;exclude-module=&lt;file&gt;</option></term>
 	    <listitem>
 	      <para>Regard <filename>&lt;file&gt;</filename> as
               "stable"; i.e., exclude it from having dependencies on
@@ -450,12 +455,12 @@ ghc -M -optdep-f -optdep.depend ...
 	  <varlistentry>
 	    <term><option>-x</option></term>
 	    <listitem>
-	      <para>same as <option>--exclude-module</option></para>
+	      <para>same as <option>&ndash;&ndash;exclude-module</option></para>
 	    </listitem>
 	  </varlistentry>
 
 	  <varlistentry>
-	    <term><option>--exclude-directory=&lt;dirs&gt;</option></term>
+	    <term><option>&ndash;&ndash;exclude-directory=&lt;dirs&gt;</option></term>
 	    <listitem>
 	      <para>Regard the colon-separated list of directories
               <filename>&lt;dirs&gt;</filename> as containing stable,
@@ -465,25 +470,23 @@ ghc -M -optdep-f -optdep.depend ...
 	  </varlistentry>
 
 	  <varlistentry>
-	    <term><option>--include-module=&lt;file&gt;</option></term>
+	    <term><option>&ndash;&ndash;include-module=&lt;file&gt;</option></term>
 	    <listitem>
 	      <para>Regard <filename>&lt;file&gt;</filename> as not
               "stable"; i.e., generate dependencies on it (if
               any). This option is normally used in conjunction with
-              the <option>--exclude-directory</option> option.</para>
+              the <option>&ndash;&ndash;exclude-directory</option> option.</para>
 	    </listitem>
 	  </varlistentry>
 
 	  <varlistentry>
-	    <term><option>--include-prelude</option></term>
+	    <term><option>&ndash;&ndash;include-prelude</option></term>
 	    <listitem>
-	      <para>Regard prelude libraries as unstable, i.e.,
-              generate dependencies on the prelude modules used
-              (including <literal>Prelude</literal>).  This option is
-              normally only used by the various system libraries. If a
-              <option>-package</option> option is used, dependencies
-              will also be generated on the library's
-              interfaces.</para>
+	      <para>Regard modules imported from packages as unstable,
+              i.e., generate dependencies on the package modules used
+              (including <literal>Prelude</literal>, and all other
+              standard Haskell libraries).  This option is normally
+              only used by the various system libraries.</para>
 	    </listitem>
 	  </varlistentry>
 	</variablelist>