From: simonmar <unknown>
Date: Mon, 30 Apr 2001 09:46:07 +0000 (+0000)
Subject: [project @ 2001-04-30 09:46:07 by simonmar]
X-Git-Tag: Approximately_9120_patches~2068
X-Git-Url: http://git.megacz.com/?a=commitdiff_plain;h=9480e790c9d8a17ee50c8ef82150f6148dfe92fa;p=ghc-hetmet.git

[project @ 2001-04-30 09:46:07 by simonmar]
Fix the documentation about the -i<dirs> option.  These are scanned
left to right, but before the package directories.  Also add a
suitably severe warning about having a module with the same name as a
package module.
---

diff --git a/ghc/docs/users_guide/separate_compilation.sgml b/ghc/docs/users_guide/separate_compilation.sgml
index 1433a3e..691701b 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>