[project @ 1997-03-17 20:34:25 by simonpj]
[ghc-hetmet.git] / ghc / compiler / rename / Rename.lhs
index 3b7cdf2..81059c2 100644 (file)
 
 module Rename ( renameModule ) where
 
-import Ubiq{-uitous-}
+import PreludeGlaST    ( thenPrimIO )
+
+IMP_Ubiq()
+IMPORT_1_3(List(partition))
 
 import HsSyn
-import RdrHsSyn                ( ProtoNameHsModule(..) )
-import RnHsSyn         ( RenamedHsModule(..) )
-
-import Bag             ( isEmptyBag, unionBags )
-import CmdLineOpts     ( opt_UseGetMentionedVars )
-import ErrUtils                ( Error(..) )
-import Pretty          ( Pretty(..){-ToDo:rm?-} )
-import RnMonad12       ( initRn12 )
-import RnMonad4                ( initRn4 )
-import RnPass1
-import RnPass2
-import RnPass3
-import RnPass4
-import RnUtils         ( PreludeNameMappers(..), GlobalNameMappers(..) )
-import UniqSupply      ( splitUniqSupply )
-import Util            ( panic )
+import RdrHsSyn                ( RdrName, SYN_IE(RdrNameHsModule), SYN_IE(RdrNameImportDecl) )
+import RnHsSyn         ( SYN_IE(RenamedHsModule), SYN_IE(RenamedHsDecl), extractHsTyNames )
+
+import CmdLineOpts     ( opt_HiMap )
+import RnMonad
+import RnNames         ( getGlobalNames )
+import RnSource                ( rnDecl )
+import RnIfaces                ( getImportedInstDecls, importDecl, getImportVersions, getSpecialInstModules,
+                         mkSearchPath
+                       )
+import RnEnv           ( availsToNameSet, addAvailToNameSet, 
+                         addImplicitOccsRn, lookupImplicitOccRn )
+import Id              ( GenId {- instance NamedThing -} )
+import Name            ( Name, Provenance, ExportFlag(..), isLocallyDefined,
+                         NameSet(..), elemNameSet, mkNameSet, unionNameSets, nameSetToList,
+                         isWiredInName, modAndOcc
+                       )
+import TysWiredIn      ( unitTyCon, intTyCon, doubleTyCon )
+import PrelInfo                ( ioTyCon_NAME, primIoTyCon_NAME )
+import TyCon           ( TyCon )
+import PrelMods                ( mAIN, gHC_MAIN )
+import ErrUtils                ( SYN_IE(Error), SYN_IE(Warning) )
+import FiniteMap       ( emptyFM, eltsFM, fmToList, addToFM, FiniteMap )
+import Pretty
+import PprStyle                ( PprStyle(..) )
+import Util            ( panic, assertPanic, pprTrace )
 \end{code}
 
-Here's what the renamer does, basically:
-\begin{description}
-\item[@RnPass1@:]
-Flattens out the declarations from the interfaces which this module
-imports.  The result is a new module with no imports, but with more
-declarations.  (Obviously, the imported declarations have ``funny
-names'' [@ProtoNames@] to indicate their origin.)  Handles selective
-import, renaming, \& such.
-
-%--------------------------------------------------------------------
-\item[@RnPass2@:]
-Removes duplicate declarations.  Duplicates can arise when two
-imported interface have a signature (or whatever) for the same
-thing. We check that the two are consistent and then drop one.
-Considerable huff and puff to pick the one with the ``better''
-pragmatic information.
-
-%--------------------------------------------------------------------
-\item[@RnPass3@:]
-Find all the top-level-ish (i.e., global) entities, assign them
-@Uniques@, and make a \tr{ProtoName -> Name} mapping for them,
-in preparation for...
-
-%--------------------------------------------------------------------
-\item[@RnPass4@:]
-Actually prepare the ``renamed'' module.  In sticking @Names@ on
-everything, it will catch out-of-scope errors (and a couple of similar
-type-variable-use errors).  We also our initial dependency analysis of
-the program (required before typechecking).
-\end{description}
+
 
 \begin{code}
-renameModule :: PreludeNameMappers     -- lookup funs for deeply wired-in names
-            -> ProtoNameHsModule       -- input
-            -> UniqSupply
-            -> (RenamedHsModule,       -- output, after renaming
-                Bag FAST_STRING,       -- Names of the imported modules
-                                       -- (profiling needs to know this)
-                GlobalNameMappers,     -- final name funs; used later
-                                       -- to rename generated `deriving'
-                                       -- bindings.
-                Bag Error              -- Errors, from passes 1-4
-               )
-
--- Very space-leak sensitive
-
-renameModule gnfs@(val_pnf, tc_pnf)
-            input@(HsModule mod_name _ _ _ _ _ _ _ _ _ _ _ _)
-            uniqs
-  = let
-       use_mentioned_vars = opt_UseGetMentionedVars
-    in
-    case (initRn12 mod_name (rnModule1 gnfs use_mentioned_vars input))
-      of { ((mod1, imported_module_names), errs1) ->
+renameModule :: UniqSupply
+            -> RdrNameHsModule
+            -> IO (Maybe                       -- Nothing <=> everything up to date;
+                                               -- no ned to recompile any further
+                         (RenamedHsModule,     -- Output, after renaming
+                          InterfaceDetails,    -- Interface; for interface file generatino
+                          RnNameSupply,        -- Final env; for renaming derivings
+                          [Module]),           -- Imported modules; for profiling
+                   Bag Error, 
+                   Bag Warning
+                  )
+\end{code} 
+
+
+\begin{code}
+renameModule us this_mod@(HsModule mod_name vers exports imports fixities local_decls loc)
+  =    -- INITIALISE THE RENAMER MONAD
+    initRn mod_name us (mkSearchPath opt_HiMap) loc $
+
+       -- FIND THE GLOBAL NAME ENVIRONMENT
+    getGlobalNames this_mod                    `thenRn` \ global_name_info ->
+
+    case global_name_info of {
+       Nothing ->      -- Everything is up to date; no need to recompile further
+                       returnRn Nothing ;
+
+                       -- Otherwise, just carry on
+       Just (export_env, rn_env, local_avails) ->
+
+       -- RENAME THE SOURCE
+    initRnMS rn_env mod_name SourceMode (
+       addImplicits mod_name                           `thenRn_`
+       mapRn rnDecl local_decls
+    )                                                  `thenRn` \ rn_local_decls ->
+
+       -- SLURP IN ALL THE NEEDED DECLARATIONS
+    closeDecls rn_local_decls                          `thenRn` \ rn_all_decls ->
+
 
-    case (initRn12 mod_name (rnModule2 mod1)) of { (mod2, errs2) ->
+       -- GENERATE THE VERSION/USAGE INFO
+    getImportVersions mod_name exports                 `thenRn` \ import_versions ->
+    getNameSupplyRn                                    `thenRn` \ name_supply ->
 
-    case (splitUniqSupply uniqs) of { (us1, us2) ->
 
-    case (initRn3 (rnModule3 gnfs imported_module_names mod2) us1)
-      of { (val_space, tc_space, v_gnf, tc_gnf, errs3) ->
+       -- GENERATE THE SPECIAL-INSTANCE MODULE LIST
+       -- The "special instance" modules are those modules that contain instance
+       -- declarations that contain no type constructor or class that was declared
+       -- in that module.
+    getSpecialInstModules                              `thenRn` \ imported_special_inst_mods ->
+    let
+       special_inst_decls = [d | InstD d@(InstDecl inst_ty _ _ _ _) <- rn_local_decls,
+                                 all (not.isLocallyDefined) (nameSetToList (extractHsTyNames inst_ty))
+                            ]
+       special_inst_mods | null special_inst_decls = imported_special_inst_mods
+                         | otherwise               = mod_name : imported_special_inst_mods
+    in
+                 
+    
 
+       -- RETURN THE RENAMED MODULE
     let
-       final_name_funs = (v_gnf, tc_gnf)
+       import_mods = [mod | ImportDecl mod _ _ _ _ <- imports]
 
-       errs_so_far = errs1 `unionBags` errs2 `unionBags` errs3
-               -- see note below about why we consult errs at this pt
+       renamed_module = HsModule mod_name vers 
+                                 trashed_exports trashed_imports trashed_fixities
+                                 rn_all_decls
+                                 loc
     in
-    if not (isEmptyBag errs_so_far) then -- give up now
-       ( panic "rename", imported_module_names, final_name_funs, errs_so_far )
-    else
-       case (initRn4 final_name_funs (rnModule mod2) us2)
-         of { (mod4, errs4) ->
-
-       ( mod4, imported_module_names, final_name_funs, errs4 ) }
-    }}}}
+    returnRn (Just (renamed_module, 
+                   (import_versions, export_env, special_inst_mods),
+                    name_supply,
+                    import_mods))
+    }
+  where
+    trashed_exports  = {-trace "rnSource:trashed_exports"-} Nothing
+    trashed_imports  = {-trace "rnSource:trashed_imports"-} []
+    trashed_fixities = []
+\end{code}
+
+@addImplicits@ forces the renamer to slurp in some things which aren't
+mentioned explicitly, but which might be needed by the type checker.
+
+\begin{code}
+addImplicits mod_name
+  = addImplicitOccsRn (implicit_main ++ default_tys)
+  where
+       -- Add occurrences for Int, Double, and (), because they
+       -- are the types to which ambigious type variables may be defaulted by
+       -- the type checker; so they won't every appear explicitly.
+       -- [The () one is a GHC extension for defaulting CCall results.]
+    default_tys = [getName intTyCon, getName doubleTyCon, getName unitTyCon]
+
+       -- Add occurrences for IO or PrimIO
+    implicit_main | mod_name == mAIN     = [ioTyCon_NAME]
+                 | mod_name == gHC_MAIN = [primIoTyCon_NAME]
+                 | otherwise            = []
 \end{code}
 
-Why stop if errors in the first three passes: Suppose you're compiling
-a module with a top-level definition named \tr{scaleFloat}.  Sadly,
-this is also a Prelude class-method name.  \tr{rnModule3} will have
-detected this error, but: it will also have picked (arbitrarily) one
-of the two definitions for its final ``value'' name-function.  If, by
-chance, it should have picked the class-method... when it comes to pin
-a Unique on the top-level (bogus) \tr{scaleFloat}, it will ask for the
-class-method's Unique (!); it doesn't have one, and you will get a
-panic.
-
-Another way to handle this would be for the duplicate detector to
-clobber duplicates with some ``safe'' value.  Then things would be
-fine in \tr{rnModule}.  Maybe some other time...
+
+\begin{code}
+closeDecls :: [RenamedHsDecl]                  -- Declarations got so far
+          -> RnMG [RenamedHsDecl]              -- input + extra decls slurped
+       -- The monad includes a list of possibly-unresolved Names
+       -- This list is empty when closeDecls returns
+
+closeDecls decls 
+  = popOccurrenceName          `thenRn` \ maybe_unresolved ->
+    case maybe_unresolved of
+
+       -- No more unresolved names
+       Nothing ->      -- Slurp instance declarations
+                  getImportedInstDecls                 `thenRn` \ inst_decls ->
+                  traceRn (ppSep [ppPStr SLIT("Slurped"), ppInt (length inst_decls), ppPStr SLIT("instance decls")])
+                                                       `thenRn_`
+
+                       -- None?  then at last we are done
+                  if null inst_decls then
+                       returnRn decls
+                  else 
+                  mapRn rn_inst_decl inst_decls        `thenRn` \ new_inst_decls ->
+
+                       -- We *must* loop again here.  Why?  Two reasons:
+                       -- (a) an instance decl will give rise to an unresolved dfun, whose
+                       --      decl we must slurp to get its version number; that's the version
+                       --      number for the whole instance decl.
+                       -- (b) an instance decl might give rise to a new unresolved class,
+                       --      whose decl we must slurp, which might let in some new instance decls,
+                       --      and so on.  Example:  instance Foo a => Baz [a] where ...
+       
+                  closeDecls (new_inst_decls ++ decls)
+                       
+       -- An unresolved name
+       Just (name,necessity)
+         ->    -- Slurp its declaration, if any
+--          traceRn (ppSep [ppPStr SLIT("Considering"), ppr PprDebug name])    `thenRn_`
+            importDecl name necessity          `thenRn` \ maybe_decl ->
+            case maybe_decl of
+
+               -- No declaration... (wired in thing or optional)
+               Nothing   -> closeDecls decls
+
+               -- Found a declaration... rename it
+               Just decl -> rn_iface_decl mod_name decl        `thenRn` \ new_decl ->
+                            closeDecls (new_decl : decls)
+                    where
+                        (mod_name,_) = modAndOcc name
+  where
+                                       -- Notice that the rnEnv starts empty
+    rn_iface_decl mod_name decl  = initRnMS emptyRnEnv mod_name InterfaceMode (rnDecl decl)
+    rn_inst_decl (mod_name,decl) = rn_iface_decl mod_name (InstD decl)
+
+\end{code}
+
+