[project @ 1999-07-27 12:07:36 by sof]
authorsof <unknown>
Tue, 27 Jul 1999 12:07:36 +0000 (12:07 +0000)
committersof <unknown>
Tue, 27 Jul 1999 12:07:36 +0000 (12:07 +0000)
remove spurious ^M's

ghc/compiler/basicTypes/Module.lhs

index 913add3..0846c99 100644 (file)
-%\r
-% (c) The GRASP/AQUA Project, Glasgow University, 1992-1998\r
-%\r
-\section[Module]{The @Module@ module.}\r
-\r
-Representing modules and their flavours.\r
-\r
-\begin{code}\r
-module Module \r
-    (\r
-      Module               -- abstract, instance of Eq, Ord, Outputable\r
-    , ModuleName\r
-\r
-    , moduleNameString         -- :: ModuleName -> EncodedString\r
-    , moduleNameUserString     -- :: ModuleName -> UserString\r
-\r
-    , moduleString          -- :: Module -> EncodedString\r
-    , moduleUserString      -- :: Module -> UserString\r
-    , moduleName           -- :: Module -> ModuleName\r
-\r
-    , mkVanillaModule      -- :: ModuleName -> Module\r
-    , mkThisModule         -- :: ModuleName -> Module\r
-    , mkPrelModule          -- :: UserString -> Module\r
-\r
-    , isDynamicModule       -- :: Module -> Bool\r
-    , isLibModule\r
-\r
-    , mkSrcModule\r
-\r
-    , mkSrcModuleFS         -- :: UserFS    -> ModuleName\r
-    , mkSysModuleFS         -- :: EncodedFS -> ModuleName\r
-\r
-    , pprModule, pprModuleName\r
\r
-       -- DllFlavour\r
-    , DllFlavour, dll, notDll\r
-\r
-       -- ModFlavour\r
-    , ModFlavour, libMod, userMod\r
-\r
-       -- Where to find a .hi file\r
-    , WhereFrom(..), SearchPath, mkSearchPath\r
-    , ModuleHiMap, mkModuleHiMaps\r
-\r
-    ) where\r
-\r
-#include "HsVersions.h"\r
-import OccName\r
-import Outputable\r
-import FiniteMap\r
-import CmdLineOpts     ( opt_Static, opt_CompilingPrelude, opt_WarnHiShadows )\r
-import Constants       ( interfaceFileFormatVersion )\r
-import Maybes          ( seqMaybe )\r
-import Maybe           ( fromMaybe )\r
-import Directory       ( doesFileExist )\r
-import DirUtils                ( getDirectoryContents )\r
-import List            ( intersperse )\r
-import Monad           ( foldM )\r
-import IO              ( hPutStrLn, stderr, isDoesNotExistError )\r
-\end{code}\r
-\r
-\r
-%************************************************************************\r
-%*                                                                     *\r
-\subsection{Interface file flavour}\r
-%*                                                                     *\r
-%************************************************************************\r
-\r
-A further twist to the tale is the support for dynamically linked libraries under\r
-Win32. Here, dealing with the use of global variables that's residing in a DLL\r
-requires special handling at the point of use (there's an extra level of indirection,\r
-i.e., (**v) to get at v's value, rather than just (*v) .) When slurping in an\r
-interface file we then record whether it's coming from a .hi corresponding to a\r
-module that's packaged up in a DLL or not, so that we later can emit the\r
-appropriate code.\r
-\r
-The logic for how an interface file is marked as corresponding to a module that's\r
-hiding in a DLL is explained elsewhere (ToDo: give renamer href here.)\r
-\r
-\begin{code}\r
-data DllFlavour = NotDll       -- Ordinary module\r
-               | Dll           -- The module's object code lives in a DLL.\r
-               deriving( Eq )\r
-\r
-dll    = Dll\r
-notDll = NotDll\r
-\r
-instance Text DllFlavour where -- Just used in debug prints of lex tokens\r
-  showsPrec n NotDll s = s\r
-  showsPrec n Dll    s = "dll " ++ s\r
-\end{code}\r
-\r
-\r
-%************************************************************************\r
-%*                                                                     *\r
-\subsection{System/user module}\r
-%*                                                                     *\r
-%************************************************************************\r
-\r
-We also track whether an imported module is from a 'system-ish' place.  In this case\r
-we don't record the fact that this module depends on it, nor usages of things\r
-inside it.  \r
-\r
-\begin{code}\r
-data ModFlavour = LibMod       -- A library-ish module\r
-               | UserMod       -- Not library-ish\r
-\r
-libMod  = LibMod\r
-userMod = UserMod\r
-\end{code}\r
-\r
-\r
-%************************************************************************\r
-%*                                                                     *\r
-\subsection{Where from}\r
-%*                                                                     *\r
-%************************************************************************\r
-\r
-The @WhereFrom@ type controls where the renamer looks for an interface file\r
-\r
-\begin{code}\r
-data WhereFrom = ImportByUser          -- Ordinary user import: look for M.hi\r
-              | ImportByUserSource     -- User {- SOURCE -}: look for M.hi-boot\r
-              | ImportBySystem         -- Non user import.  Look for M.hi if M is in\r
-                                       -- the module this module depends on, or is a system-ish module; \r
-                                       -- M.hi-boot otherwise\r
-\r
-instance Outputable WhereFrom where\r
-  ppr ImportByUser       = empty\r
-  ppr ImportByUserSource = ptext SLIT("{- SOURCE -}")\r
-  ppr ImportBySystem     = ptext SLIT("{- SYSTEM IMPORT -}")\r
-\end{code}\r
-\r
-\r
-%************************************************************************\r
-%*                                                                     *\r
-\subsection{The name of a module}\r
-%*                                                                     *\r
-%************************************************************************\r
-\r
-\begin{code}\r
-type ModuleName = EncodedFS\r
-       -- Haskell module names can include the quote character ',\r
-       -- so the module names have the z-encoding applied to them\r
-\r
-\r
-pprModuleName :: ModuleName -> SDoc\r
-pprModuleName nm = pprEncodedFS nm\r
-\r
-moduleNameString :: ModuleName -> EncodedString\r
-moduleNameString mod = _UNPK_ mod\r
-\r
-moduleNameUserString :: ModuleName -> UserString\r
-moduleNameUserString mod = decode (_UNPK_ mod)\r
-\r
-mkSrcModule :: UserString -> ModuleName\r
-mkSrcModule s = _PK_ (encode s)\r
-\r
-mkSrcModuleFS :: UserFS -> ModuleName\r
-mkSrcModuleFS s = encodeFS s\r
-\r
-mkSysModuleFS :: EncodedFS -> ModuleName\r
-mkSysModuleFS s = s \r
-\end{code}\r
-\r
-\begin{code}\r
-data Module = Module\r
-               ModuleName\r
-               ModFlavour\r
-               DllFlavour\r
-\end{code}\r
-\r
-\begin{code}\r
-instance Outputable Module where\r
-  ppr = pprModule\r
-\r
-instance Eq Module where\r
-  (Module m1 _  _) == (Module m2 _ _) = m1 == m2\r
-\r
-instance Ord Module where\r
-  (Module m1 _ _) `compare` (Module m2 _ _) = m1 `compare` m2\r
-\end{code}\r
-\r
-\r
-\begin{code}\r
-pprModule :: Module -> SDoc\r
-pprModule (Module mod _ _) = pprEncodedFS mod\r
-\end{code}\r
-\r
-\r
-\begin{code}\r
-mkModule = Module\r
-\r
-mkVanillaModule :: ModuleName -> Module\r
-mkVanillaModule name = Module name UserMod NotDll\r
-\r
-mkThisModule :: ModuleName -> Module   -- The module being comiled\r
-mkThisModule name = Module name UserMod NotDll -- ToDo: correct Dll flag?\r
-\r
-mkPrelModule :: ModuleName -> Module\r
-mkPrelModule name = Module name sys dll\r
- where \r
-  sys | opt_CompilingPrelude = UserMod\r
-      | otherwise           = LibMod\r
-\r
-  dll | opt_Static || opt_CompilingPrelude = NotDll\r
-      | otherwise                         = Dll\r
-\r
-moduleString :: Module -> EncodedString\r
-moduleString (Module mod _ _) = _UNPK_ mod\r
-\r
-moduleName :: Module -> ModuleName\r
-moduleName (Module mod _ _) = mod\r
-\r
-moduleUserString :: Module -> UserString\r
-moduleUserString (Module mod _ _) = moduleNameUserString mod\r
-\end{code}\r
-\r
-\begin{code}\r
-isDynamicModule :: Module -> Bool\r
-isDynamicModule (Module _ _ Dll)  = True\r
-isDynamicModule _                = False\r
-\r
-isLibModule :: Module -> Bool\r
-isLibModule (Module _ LibMod _) = True\r
-isLibModule _                  = False\r
-\end{code}\r
-\r
-\r
-%************************************************************************\r
-%*                                                                     *\r
-\subsection{Finding modules in the file system\r
-%*                                                                     *\r
-%************************************************************************\r
-\r
-\begin{code}\r
-type ModuleHiMap = FiniteMap ModuleName (String, Module)\r
-  -- Mapping from module name to \r
-  --   * the file path of its corresponding interface file, \r
-  --   * the Module, decorated with it's properties\r
-\end{code}\r
-\r
-(We allege that) it is quicker to build up a mapping from module names\r
-to the paths to their corresponding interface files once, than to search\r
-along the import part every time we slurp in a new module (which we \r
-do quite a lot of.)\r
-\r
-\begin{code}\r
-type SearchPath = [(String,String)]    -- List of (directory,suffix) pairs to search \r
-                                        -- for interface files.\r
-\r
-mkModuleHiMaps :: SearchPath -> IO (ModuleHiMap, ModuleHiMap)\r
-mkModuleHiMaps dirs = foldM (getAllFilesMatching dirs) (env,env) dirs\r
- where\r
-  env = emptyFM\r
-\r
-{- A pseudo file, currently "dLL_ifs.hi",\r
-   signals that the interface files\r
-   contained in a particular directory have got their\r
-   corresponding object codes stashed away in a DLL\r
-   \r
-   This stuff is only needed to deal with Win32 DLLs,\r
-   and conceivably we conditionally compile in support\r
-   for handling it. (ToDo?)\r
--}\r
-dir_contain_dll_his = "dLL_ifs.hi"\r
-\r
-getAllFilesMatching :: SearchPath\r
-                   -> (ModuleHiMap, ModuleHiMap)\r
-                   -> (FilePath, String) \r
-                   -> IO (ModuleHiMap, ModuleHiMap)\r
-getAllFilesMatching dirs hims (dir_path, suffix) = ( do\r
-    -- fpaths entries do not have dir_path prepended\r
-  fpaths  <- getDirectoryContents dir_path\r
-  is_dll <- catch\r
-               (if opt_Static || dir_path == "." then\r
-                    return NotDll\r
-                else\r
-                    do  exists <- doesFileExist (dir_path ++ '/': dir_contain_dll_his)\r
-                        return (if exists then Dll else NotDll)\r
-               )\r
-               (\ _ {-don't care-} -> return NotDll)\r
-  return (foldl (addModules is_dll) hims fpaths)\r
-  )  -- soft failure\r
-      `catch` \r
-        (\ err -> do\r
-             hPutStrLn stderr\r
-                    ("Import path element `" ++ dir_path ++ \r
-                     if (isDoesNotExistError err) then\r
-                        "' does not exist, ignoring."\r
-                     else\r
-                       "' couldn't read, ignoring.")\r
-              \r
-              return hims\r
-       )\r
- where\r
-  \r
-       -- Dreadfully crude.  We want a better way to distinguish\r
-       -- "library-ish" modules.\r
-   is_sys | head dir_path == '/' = LibMod\r
-         | otherwise            = UserMod\r
-\r
-   xiffus       = reverse dotted_suffix \r
-   dotted_suffix = case suffix of\r
-                     []       -> []\r
-                     ('.':xs) -> suffix\r
-                     ls       -> '.':ls\r
-\r
-   hi_boot_version_xiffus = \r
-      reverse (show interfaceFileFormatVersion) ++ '-':hi_boot_xiffus\r
-   hi_boot_xiffus = "toob-ih." -- .hi-boot reversed!\r
-\r
-   addModules is_dll his@(hi_env, hib_env) filename = fromMaybe his $ \r
-        FMAP add_hi   (go xiffus                rev_fname)     `seqMaybe`\r
-\r
-        FMAP add_vhib (go hi_boot_version_xiffus rev_fname)    `seqMaybe`\r
-               -- If there's a Foo.hi-boot-N file then override any Foo.hi-boot\r
-\r
-       FMAP add_hib  (go hi_boot_xiffus         rev_fname)\r
-     where\r
-       rev_fname = reverse filename\r
-       path      = dir_path ++ '/':filename\r
-\r
-         -- In these functions file_nm is the base of the filename,\r
-         -- with the path and suffix both stripped off.  The filename\r
-         -- is the *unencoded* module name (else 'make' gets confused).\r
-         -- But the domain of the HiMaps is ModuleName which is encoded.\r
-       add_hi    file_nm = (add_to_map addNewOne hi_env file_nm,   hib_env)\r
-       add_vhib  file_nm = (hi_env, add_to_map overrideNew hib_env file_nm)\r
-       add_hib   file_nm = (hi_env, add_to_map addNewOne   hib_env file_nm)\r
-\r
-       add_to_map combiner env file_nm \r
-         = addToFM_C combiner env mod_nm (path, mkModule mod_nm is_sys is_dll)\r
-         where\r
-           mod_nm = mkSrcModuleFS file_nm\r
-\r
-   -- go prefix (prefix ++ stuff) == Just (reverse stuff)\r
-   go [] xs                    = Just (_PK_ (reverse xs))\r
-   go _  []                    = Nothing\r
-   go (x:xs) (y:ys) | x == y    = go xs ys \r
-                   | otherwise = Nothing\r
-\r
-   addNewOne | opt_WarnHiShadows = conflict\r
-            | otherwise         = stickWithOld\r
-\r
-   stickWithOld old new = old\r
-   overrideNew  old new = new\r
-\r
-   conflict (old_path,mod) (new_path,_)\r
-    | old_path /= new_path = \r
-        pprTrace "Warning: " (text "Identically named interface files present on the import path, " $$\r
-                             text (show old_path) <+> text "shadows" $$\r
-                             text (show new_path) $$\r
-                             text "on the import path: " <+> \r
-                             text (concat (intersperse ":" (map fst dirs))))\r
-        (old_path,mod)\r
-    | otherwise = (old_path,mod)  -- don't warn about innocous shadowings.\r
-\end{code}\r
-\r
-\r
-%*********************************************************\r
-%*                                                      *\r
-\subsection{Making a search path}\r
-%*                                                      *\r
-%*********************************************************\r
-\r
-@mkSearchPath@ takes a string consisting of a colon-separated list\r
-of directories and corresponding suffixes, and turns it into a list\r
-of (directory, suffix) pairs.  For example:\r
-\r
-\begin{verbatim}\r
- mkSearchPath "foo%.hi:.%.p_hi:baz%.mc_hi"\r
-   = [("foo",".hi"),( ".", ".p_hi"), ("baz",".mc_hi")]\r
-\begin{verbatim}\r
-\r
-\begin{code}\r
-mkSearchPath :: Maybe String -> SearchPath\r
-mkSearchPath Nothing = [(".",".hi")]  -- ToDo: default should be to look in\r
-                                     -- the directory the module we're compiling\r
-                                     -- lives.\r
-mkSearchPath (Just s) = go s\r
-  where\r
-    go "" = []\r
-    go s  = \r
-      case span (/= '%') s of\r
-       (dir,'%':rs) ->\r
-         case span (/= ':') rs of\r
-          (hisuf,_:rest) -> (dir,hisuf):go rest\r
-          (hisuf,[])     -> [(dir,hisuf)]\r
-\end{code}\r
-\r
+%
+% (c) The GRASP/AQUA Project, Glasgow University, 1992-1998
+%
+\section[Module]{The @Module@ module.}
+
+Representing modules and their flavours.
+
+\begin{code}
+module Module 
+    (
+      Module               -- abstract, instance of Eq, Ord, Outputable
+    , ModuleName
+
+    , moduleNameString         -- :: ModuleName -> EncodedString
+    , moduleNameUserString     -- :: ModuleName -> UserString
+
+    , moduleString          -- :: Module -> EncodedString
+    , moduleUserString      -- :: Module -> UserString
+    , moduleName           -- :: Module -> ModuleName
+
+    , mkVanillaModule      -- :: ModuleName -> Module
+    , mkThisModule         -- :: ModuleName -> Module
+    , mkPrelModule          -- :: UserString -> Module
+
+    , isDynamicModule       -- :: Module -> Bool
+    , isLibModule
+
+    , mkSrcModule
+
+    , mkSrcModuleFS         -- :: UserFS    -> ModuleName
+    , mkSysModuleFS         -- :: EncodedFS -> ModuleName
+
+    , pprModule, pprModuleName
+       -- DllFlavour
+    , DllFlavour, dll, notDll
+
+       -- ModFlavour
+    , ModFlavour, libMod, userMod
+
+       -- Where to find a .hi file
+    , WhereFrom(..), SearchPath, mkSearchPath
+    , ModuleHiMap, mkModuleHiMaps
+
+    ) where
+
+#include "HsVersions.h"
+import OccName
+import Outputable
+import FiniteMap
+import CmdLineOpts     ( opt_Static, opt_CompilingPrelude, opt_WarnHiShadows )
+import Constants       ( interfaceFileFormatVersion )
+import Maybes          ( seqMaybe )
+import Maybe           ( fromMaybe )
+import Directory       ( doesFileExist )
+import DirUtils                ( getDirectoryContents )
+import List            ( intersperse )
+import Monad           ( foldM )
+import IO              ( hPutStrLn, stderr, isDoesNotExistError )
+\end{code}
+
+
+%************************************************************************
+%*                                                                     *
+\subsection{Interface file flavour}
+%*                                                                     *
+%************************************************************************
+
+A further twist to the tale is the support for dynamically linked libraries under
+Win32. Here, dealing with the use of global variables that's residing in a DLL
+requires special handling at the point of use (there's an extra level of indirection,
+i.e., (**v) to get at v's value, rather than just (*v) .) When slurping in an
+interface file we then record whether it's coming from a .hi corresponding to a
+module that's packaged up in a DLL or not, so that we later can emit the
+appropriate code.
+
+The logic for how an interface file is marked as corresponding to a module that's
+hiding in a DLL is explained elsewhere (ToDo: give renamer href here.)
+
+\begin{code}
+data DllFlavour = NotDll       -- Ordinary module
+               | Dll           -- The module's object code lives in a DLL.
+               deriving( Eq )
+
+dll    = Dll
+notDll = NotDll
+
+instance Text DllFlavour where -- Just used in debug prints of lex tokens
+  showsPrec n NotDll s = s
+  showsPrec n Dll    s = "dll " ++ s
+\end{code}
+
+
+%************************************************************************
+%*                                                                     *
+\subsection{System/user module}
+%*                                                                     *
+%************************************************************************
+
+We also track whether an imported module is from a 'system-ish' place.  In this case
+we don't record the fact that this module depends on it, nor usages of things
+inside it.  
+
+\begin{code}
+data ModFlavour = LibMod       -- A library-ish module
+               | UserMod       -- Not library-ish
+
+libMod  = LibMod
+userMod = UserMod
+\end{code}
+
+
+%************************************************************************
+%*                                                                     *
+\subsection{Where from}
+%*                                                                     *
+%************************************************************************
+
+The @WhereFrom@ type controls where the renamer looks for an interface file
+
+\begin{code}
+data WhereFrom = ImportByUser          -- Ordinary user import: look for M.hi
+              | ImportByUserSource     -- User {- SOURCE -}: look for M.hi-boot
+              | ImportBySystem         -- Non user import.  Look for M.hi if M is in
+                                       -- the module this module depends on, or is a system-ish module; 
+                                       -- M.hi-boot otherwise
+
+instance Outputable WhereFrom where
+  ppr ImportByUser       = empty
+  ppr ImportByUserSource = ptext SLIT("{- SOURCE -}")
+  ppr ImportBySystem     = ptext SLIT("{- SYSTEM IMPORT -}")
+\end{code}
+
+
+%************************************************************************
+%*                                                                     *
+\subsection{The name of a module}
+%*                                                                     *
+%************************************************************************
+
+\begin{code}
+type ModuleName = EncodedFS
+       -- Haskell module names can include the quote character ',
+       -- so the module names have the z-encoding applied to them
+
+
+pprModuleName :: ModuleName -> SDoc
+pprModuleName nm = pprEncodedFS nm
+
+moduleNameString :: ModuleName -> EncodedString
+moduleNameString mod = _UNPK_ mod
+
+moduleNameUserString :: ModuleName -> UserString
+moduleNameUserString mod = decode (_UNPK_ mod)
+
+mkSrcModule :: UserString -> ModuleName
+mkSrcModule s = _PK_ (encode s)
+
+mkSrcModuleFS :: UserFS -> ModuleName
+mkSrcModuleFS s = encodeFS s
+
+mkSysModuleFS :: EncodedFS -> ModuleName
+mkSysModuleFS s = s 
+\end{code}
+
+\begin{code}
+data Module = Module
+               ModuleName
+               ModFlavour
+               DllFlavour
+\end{code}
+
+\begin{code}
+instance Outputable Module where
+  ppr = pprModule
+
+instance Eq Module where
+  (Module m1 _  _) == (Module m2 _ _) = m1 == m2
+
+instance Ord Module where
+  (Module m1 _ _) `compare` (Module m2 _ _) = m1 `compare` m2
+\end{code}
+
+
+\begin{code}
+pprModule :: Module -> SDoc
+pprModule (Module mod _ _) = pprEncodedFS mod
+\end{code}
+
+
+\begin{code}
+mkModule = Module
+
+mkVanillaModule :: ModuleName -> Module
+mkVanillaModule name = Module name UserMod NotDll
+
+mkThisModule :: ModuleName -> Module   -- The module being comiled
+mkThisModule name = Module name UserMod NotDll -- ToDo: correct Dll flag?
+
+mkPrelModule :: ModuleName -> Module
+mkPrelModule name = Module name sys dll
+ where 
+  sys | opt_CompilingPrelude = UserMod
+      | otherwise           = LibMod
+
+  dll | opt_Static || opt_CompilingPrelude = NotDll
+      | otherwise                         = Dll
+
+moduleString :: Module -> EncodedString
+moduleString (Module mod _ _) = _UNPK_ mod
+
+moduleName :: Module -> ModuleName
+moduleName (Module mod _ _) = mod
+
+moduleUserString :: Module -> UserString
+moduleUserString (Module mod _ _) = moduleNameUserString mod
+\end{code}
+
+\begin{code}
+isDynamicModule :: Module -> Bool
+isDynamicModule (Module _ _ Dll)  = True
+isDynamicModule _                = False
+
+isLibModule :: Module -> Bool
+isLibModule (Module _ LibMod _) = True
+isLibModule _                  = False
+\end{code}
+
+
+%************************************************************************
+%*                                                                     *
+\subsection{Finding modules in the file system
+%*                                                                     *
+%************************************************************************
+
+\begin{code}
+type ModuleHiMap = FiniteMap ModuleName (String, Module)
+  -- Mapping from module name to 
+  --   * the file path of its corresponding interface file, 
+  --   * the Module, decorated with it's properties
+\end{code}
+
+(We allege that) it is quicker to build up a mapping from module names
+to the paths to their corresponding interface files once, than to search
+along the import part every time we slurp in a new module (which we 
+do quite a lot of.)
+
+\begin{code}
+type SearchPath = [(String,String)]    -- List of (directory,suffix) pairs to search 
+                                        -- for interface files.
+
+mkModuleHiMaps :: SearchPath -> IO (ModuleHiMap, ModuleHiMap)
+mkModuleHiMaps dirs = foldM (getAllFilesMatching dirs) (env,env) dirs
+ where
+  env = emptyFM
+
+{- A pseudo file, currently "dLL_ifs.hi",
+   signals that the interface files
+   contained in a particular directory have got their
+   corresponding object codes stashed away in a DLL
+   
+   This stuff is only needed to deal with Win32 DLLs,
+   and conceivably we conditionally compile in support
+   for handling it. (ToDo?)
+-}
+dir_contain_dll_his = "dLL_ifs.hi"
+
+getAllFilesMatching :: SearchPath
+                   -> (ModuleHiMap, ModuleHiMap)
+                   -> (FilePath, String) 
+                   -> IO (ModuleHiMap, ModuleHiMap)
+getAllFilesMatching dirs hims (dir_path, suffix) = ( do
+    -- fpaths entries do not have dir_path prepended
+  fpaths  <- getDirectoryContents dir_path
+  is_dll <- catch
+               (if opt_Static || dir_path == "." then
+                    return NotDll
+                else
+                    do  exists <- doesFileExist (dir_path ++ '/': dir_contain_dll_his)
+                        return (if exists then Dll else NotDll)
+               )
+               (\ _ {-don't care-} -> return NotDll)
+  return (foldl (addModules is_dll) hims fpaths)
+  )  -- soft failure
+      `catch` 
+        (\ err -> do
+             hPutStrLn stderr
+                    ("Import path element `" ++ dir_path ++ 
+                     if (isDoesNotExistError err) then
+                        "' does not exist, ignoring."
+                     else
+                       "' couldn't read, ignoring.")
+              
+              return hims
+       )
+ where
+  
+       -- Dreadfully crude.  We want a better way to distinguish
+       -- "library-ish" modules.
+   is_sys | head dir_path == '/' = LibMod
+         | otherwise            = UserMod
+
+   xiffus       = reverse dotted_suffix 
+   dotted_suffix = case suffix of
+                     []       -> []
+                     ('.':xs) -> suffix
+                     ls       -> '.':ls
+
+   hi_boot_version_xiffus = 
+      reverse (show interfaceFileFormatVersion) ++ '-':hi_boot_xiffus
+   hi_boot_xiffus = "toob-ih." -- .hi-boot reversed!
+
+   addModules is_dll his@(hi_env, hib_env) filename = fromMaybe his $ 
+        FMAP add_hi   (go xiffus                rev_fname)     `seqMaybe`
+
+        FMAP add_vhib (go hi_boot_version_xiffus rev_fname)    `seqMaybe`
+               -- If there's a Foo.hi-boot-N file then override any Foo.hi-boot
+
+       FMAP add_hib  (go hi_boot_xiffus         rev_fname)
+     where
+       rev_fname = reverse filename
+       path      = dir_path ++ '/':filename
+
+         -- In these functions file_nm is the base of the filename,
+         -- with the path and suffix both stripped off.  The filename
+         -- is the *unencoded* module name (else 'make' gets confused).
+         -- But the domain of the HiMaps is ModuleName which is encoded.
+       add_hi    file_nm = (add_to_map addNewOne hi_env file_nm,   hib_env)
+       add_vhib  file_nm = (hi_env, add_to_map overrideNew hib_env file_nm)
+       add_hib   file_nm = (hi_env, add_to_map addNewOne   hib_env file_nm)
+
+       add_to_map combiner env file_nm 
+         = addToFM_C combiner env mod_nm (path, mkModule mod_nm is_sys is_dll)
+         where
+           mod_nm = mkSrcModuleFS file_nm
+
+   -- go prefix (prefix ++ stuff) == Just (reverse stuff)
+   go [] xs                    = Just (_PK_ (reverse xs))
+   go _  []                    = Nothing
+   go (x:xs) (y:ys) | x == y    = go xs ys 
+                   | otherwise = Nothing
+
+   addNewOne | opt_WarnHiShadows = conflict
+            | otherwise         = stickWithOld
+
+   stickWithOld old new = old
+   overrideNew  old new = new
+
+   conflict (old_path,mod) (new_path,_)
+    | old_path /= new_path = 
+        pprTrace "Warning: " (text "Identically named interface files present on the import path, " $$
+                             text (show old_path) <+> text "shadows" $$
+                             text (show new_path) $$
+                             text "on the import path: " <+> 
+                             text (concat (intersperse ":" (map fst dirs))))
+        (old_path,mod)
+    | otherwise = (old_path,mod)  -- don't warn about innocous shadowings.
+\end{code}
+
+
+%*********************************************************
+%*                                                      *
+\subsection{Making a search path}
+%*                                                      *
+%*********************************************************
+
+@mkSearchPath@ takes a string consisting of a colon-separated list
+of directories and corresponding suffixes, and turns it into a list
+of (directory, suffix) pairs.  For example:
+
+\begin{verbatim}
+ mkSearchPath "foo%.hi:.%.p_hi:baz%.mc_hi"
+   = [("foo",".hi"),( ".", ".p_hi"), ("baz",".mc_hi")]
+\begin{verbatim}
+
+\begin{code}
+mkSearchPath :: Maybe String -> SearchPath
+mkSearchPath Nothing = [(".",".hi")]  -- ToDo: default should be to look in
+                                     -- the directory the module we're compiling
+                                     -- lives.
+mkSearchPath (Just s) = go s
+  where
+    go "" = []
+    go s  = 
+      case span (/= '%') s of
+       (dir,'%':rs) ->
+         case span (/= ':') rs of
+          (hisuf,_:rest) -> (dir,hisuf):go rest
+          (hisuf,[])     -> [(dir,hisuf)]
+\end{code}
+