[project @ 2002-10-01 09:55:38 by simonpj]
[ghc-hetmet.git] / ghc / compiler / main / HscMain.lhs
index 013ea6a..ebf7fb5 100644 (file)
@@ -1,75 +1,91 @@
 %
 % (c) The GRASP/AQUA Project, Glasgow University, 1993-2000
 %
+
 \section[GHC_Main]{Main driver for Glasgow Haskell compiler}
 
 \begin{code}
-module HscMain ( hscMain ) where
+module HscMain ( 
+       HscResult(..), hscMain, initPersistentCompilerState
+#ifdef GHCI
+       , hscStmt, hscTcExpr, hscThing, 
+       , compileExpr
+#endif
+       ) where
 
 #include "HsVersions.h"
 
-import Maybe           ( isJust )
-import Monad           ( when )
-import IO              ( hPutStr, hPutStrLn, hClose, stderr, 
-                         openFile, IOMode(..) )
+#ifdef GHCI
+import TcHsSyn         ( TypecheckedHsExpr )
+import CodeOutput      ( outputForeignStubs )
+import ByteCodeGen     ( byteCodeGen, coreExprToBCOs )
+import Linker          ( HValue, linkExpr )
+import TidyPgm         ( tidyCoreExpr )
+import CorePrep                ( corePrepExpr )
+import Flattening      ( flattenExpr )
+import TcRnDriver      ( tcRnStmt, tcRnExpr, tcRnThing ) 
+import RdrHsSyn                ( RdrNameStmt )
+import Type            ( Type )
+import PrelNames       ( iNTERACTIVE )
+import StringBuffer    ( stringToStringBuffer )
+#endif
+
 import HsSyn
 
-import RdrHsSyn                ( RdrNameHsModule )
-import FastString      ( unpackFS )
-import StringBuffer    ( hGetStringBuffer )
-import Parser          ( parse )
-import Lex             ( PState(..), ParseResult(..) )
+import RdrName         ( nameRdrName )
+import Id              ( idName )
+import IdInfo          ( CafInfo(..), CgInfoEnv, CgInfo(..) )
+import StringBuffer    ( hGetStringBuffer, freeStringBuffer )
+import Parser
+import Lex             ( ParseResult(..), ExtFlags(..), mkPState )
 import SrcLoc          ( mkSrcLoc )
-
-import Rename          ( renameModule, checkOldIface, closeIfaceDecls )
-
+import TcRnDriver      ( checkOldIface, tcRnModule, tcRnExtCore, tcRnIface )
 import Rules           ( emptyRuleBase )
-import PrelInfo                ( wiredInThings )
-import PrelNames       ( knownKeyNames )
+import PrelInfo                ( wiredInThingEnv, wiredInThings )
 import PrelRules       ( builtinRules )
-import MkIface         ( completeIface, mkModDetailsFromIface, mkModDetails,
-                         writeIface )
-import TcModule                ( TcResults(..), typecheckModule )
-import TcEnv           ( tcEnvTyCons, tcEnvClasses )
+import PrelNames       ( knownKeyNames )
+import MkIface         ( mkIface )
 import InstEnv         ( emptyInstEnv )
-import Desugar         ( deSugar )
-import SimplCore       ( core2core )
-import OccurAnal       ( occurAnalyseBinds )
+import Desugar
+import Flattening       ( flatten )
+import SimplCore
 import CoreUtils       ( coreBindsSize )
-import CoreTidy                ( tidyCorePgm )
-import CoreToStg       ( topCoreBindsToStg )
-import StgSyn          ( collectFinalStgBinders )
+import TidyPgm         ( tidyCorePgm )
+import CorePrep                ( corePrepPgm )
+import StgSyn
+import CoreToStg       ( coreToStg )
 import SimplStg                ( stg2stg )
 import CodeGen         ( codeGen )
 import CodeOutput      ( codeOutput )
 
-import Module          ( ModuleName, moduleNameUserString, 
-                         moduleUserString, moduleName, emptyModuleEnv )
+import Module          ( ModuleName, moduleName )
 import CmdLineOpts
-import ErrUtils                ( ghcExit, doIfSet, dumpIfSet_dyn )
+import DriverPhases     ( isExtCore_file )
+import ErrUtils                ( dumpIfSet_dyn, showPass, printError )
 import UniqSupply      ( mkSplitUniqSupply )
 
-import Bag             ( emptyBag )
+import Bag             ( consBag, emptyBag )
 import Outputable
-import Char            ( isSpace )
-import StgInterp       ( stgToInterpSyn )
 import HscStats                ( ppSourceStats )
-import HscTypes                ( ModDetails, ModIface, PersistentCompilerState(..),
-                         PersistentRenamerState(..), WhatsImported(..),
-                         HomeSymbolTable, PackageSymbolTable, ImportVersion, 
-                         GenAvailInfo(..), RdrAvailInfo, OrigNameEnv(..),
-                         PackageRuleBase, HomeIfaceTable, PackageIfaceTable,
-                         extendTypeEnv )
-import RnMonad         ( ExportItem, ParsedIface(..) )
-import CmSummarise     ( ModSummary(..), name_of_summary, ms_get_imports )
-import Finder          ( Finder )
-import InterpSyn       ( UnlinkedIBind )
-import StgInterp       ( ItblEnv )
+import HscTypes
+import MkExternalCore  ( emitExternalCore )
+import ParserCore
+import ParserCoreUtils
 import FiniteMap       ( FiniteMap, plusFM, emptyFM, addToFM )
-import OccName         ( OccName, pprOccName )
-import Name            ( Name, nameModule, emptyNameEnv, nameOccName, 
-                         getName, extendNameEnv_C )
-import VarEnv          ( emptyVarEnv )
+import OccName         ( OccName )
+import Name            ( Name, nameModule, nameOccName, getName )
+import NameEnv         ( emptyNameEnv, mkNameEnv )
+import NameSet         ( emptyNameSet )
+import Module          ( Module, ModLocation(..), showModMsg )
+import FastString
+import Maybes          ( expectJust )
+
+import DATA_IOREF      ( newIORef, readIORef, writeIORef )
+import UNSAFE_IO       ( unsafePerformIO )
+
+import Monad           ( when )
+import Maybe           ( isJust, fromJust )
+import IO
 \end{code}
 
 
@@ -81,184 +97,327 @@ import VarEnv             ( emptyVarEnv )
 
 \begin{code}
 data HscResult
-   = HscOK   ModDetails             -- new details (HomeSymbolTable additions)
-            (Maybe ModIface)        -- new iface (if any compilation was done)
-            (Maybe String)          -- generated stub_h filename (in /tmp)
-            (Maybe String)          -- generated stub_c filename (in /tmp)
-            (Maybe ([UnlinkedIBind],ItblEnv)) -- interpreted code, if any
-             PersistentCompilerState -- updated PCS
-
-   | HscFail PersistentCompilerState -- updated PCS
+   -- compilation failed
+   = HscFail     PersistentCompilerState -- updated PCS
+   -- concluded that it wasn't necessary
+   | HscNoRecomp PersistentCompilerState -- updated PCS
+                 ModDetails             -- new details (HomeSymbolTable additions)
+                ModIface                -- new iface (if any compilation was done)
+   -- did recompilation
+   | HscRecomp   PersistentCompilerState -- updated PCS
+                 ModDetails             -- new details (HomeSymbolTable additions)
+                 ModIface               -- new iface (if any compilation was done)
+                Bool                   -- stub_h exists
+                Bool                   -- stub_c exists
+                (Maybe CompiledByteCode)
+
        -- no errors or warnings; the individual passes
        -- (parse/rename/typecheck) print messages themselves
 
 hscMain
-  :: DynFlags
-  -> Finder
-  -> ModSummary       -- summary, including source filename
-  -> Maybe ModIface   -- old interface, if available
-  -> String          -- file in which to put the output (.s, .hc, .java etc.)
-  -> [CoreToDo]
-  -> [StgToDo]
-  -> HomeSymbolTable           -- for home module ModDetails
-  -> HomeIfaceTable
-  -> PackageIfaceTable
+  :: HscEnv
   -> PersistentCompilerState    -- IN: persistent compiler state
+  -> Module
+  -> ModLocation               -- location info
+  -> Bool                      -- True <=> source unchanged
+  -> Bool                      -- True <=> have an object file (for msgs only)
+  -> Maybe ModIface            -- old interface, if available
   -> IO HscResult
 
-hscMain dflags finder summary maybe_old_iface output_filename
-        core_cmds stg_cmds hst hit pit pcs
+hscMain hsc_env pcs mod location 
+       source_unchanged have_object maybe_old_iface
  = do {
-      -- ????? source_unchanged :: Bool -- extracted from summary?
-      let source_unchanged = trace "WARNING: source_unchanged?!" False
-      ;
-      (pcs_ch, check_errs, (recomp_reqd, maybe_checked_iface))
-         <- checkOldIface dflags finder hit hst pcs (ms_mod summary)
-                         source_unchanged maybe_old_iface;
-      if check_errs then
-         return (HscFail pcs_ch)
-      else do {
+      (pcs_ch, maybe_chk_result) <- _scc_ "checkOldIface" 
+                                   checkOldIface hsc_env pcs mod 
+                                                 (ml_hi_file location)
+                                                 source_unchanged maybe_old_iface;
+      case maybe_chk_result of {
+       Nothing -> return (HscFail pcs_ch) ;
+       Just (recomp_reqd, maybe_checked_iface) -> do {
 
       let no_old_iface = not (isJust maybe_checked_iface)
           what_next | recomp_reqd || no_old_iface = hscRecomp 
                     | otherwise                   = hscNoRecomp
-      ;
-      what_next dflags finder summary maybe_checked_iface output_filename
-                core_cmds stg_cmds hst hit pit pcs_ch
-      }}
+
+      ; what_next hsc_env pcs_ch have_object 
+                 mod location maybe_checked_iface
+      }}}
 
 
-hscNoRecomp dflags finder summary maybe_checked_iface output_filename
-            core_cmds stg_cmds hst hit pit pcs_ch
+-- hscNoRecomp definitely expects to have the old interface available
+hscNoRecomp hsc_env pcs_ch have_object 
+           mod location (Just old_iface)
+ | hsc_mode hsc_env == OneShot
  = do {
-      -- we definitely expect to have the old interface available
-      let old_iface = case maybe_checked_iface of 
-                         Just old_if -> old_if
-                         Nothing -> panic "hscNoRecomp:old_iface"
-      ;
-      -- CLOSURE
-      (pcs_cl, closure_errs, cl_hs_decls) 
-         <- closeIfaceDecls dflags finder hit hst pcs_ch old_iface ;
-      if closure_errs then 
-         return (HscFail pcs_cl) 
-      else do {
-
-      -- TYPECHECK
-      maybe_tc_result
-         <- typecheckModule dflags (ms_mod summary) pcs_cl hst hit cl_hs_decls;
-      case maybe_tc_result of {
-         Nothing -> return (HscFail pcs_cl);
-         Just tc_result -> do {
-
-      let pcs_tc        = tc_pcs tc_result
-          env_tc        = tc_env tc_result
-          binds_tc      = tc_binds tc_result
-          local_insts   = tc_insts tc_result
-          local_rules   = tc_rules tc_result
-      ;
-      -- create a new details from the closed, typechecked, old iface
-      let new_details = mkModDetailsFromIface env_tc local_insts local_rules
-      ;
-      return (HscOK new_details
-                   Nothing -- tells CM to use old iface and linkables
-                   Nothing Nothing -- foreign export stuff
-                    Nothing -- ibinds
-                   pcs_tc)
-      }}}}
-
-
-hscRecomp dflags finder summary maybe_checked_iface output_filename
-          core_cmds stg_cmds hst hit pit pcs_ch
+      when (verbosity (hsc_dflags hsc_env) > 0) $
+         hPutStrLn stderr "compilation IS NOT required";
+      let { bomb = panic "hscNoRecomp:OneShot" };
+      return (HscNoRecomp pcs_ch bomb bomb)
+      }
+ | otherwise
  = do {
-      -- what target are we shooting for?
-      let toInterp = dopt_HscLang dflags == HscInterpreted
-          this_mod = ms_mod summary
-      ;
-      -- PARSE
-      maybe_parsed <- myParseModule dflags summary;
-      case maybe_parsed of {
-         Nothing -> return (HscFail pcs_ch);
-         Just rdr_module -> do {
-
-      -- RENAME
-      show_pass dflags "Renamer";
-      (pcs_rn, maybe_rn_result) 
-         <- renameModule dflags finder hit hst pcs_ch this_mod rdr_module;
-      case maybe_rn_result of {
-         Nothing -> return (HscFail pcs_rn);
-         Just (new_iface, rn_hs_decls) -> do {
-
-      -- TYPECHECK
-      show_pass dflags "Typechecker";
-      maybe_tc_result
-         <- typecheckModule dflags this_mod pcs_rn hst hit rn_hs_decls;
+      when (verbosity (hsc_dflags hsc_env) >= 1) $
+               hPutStrLn stderr ("Skipping  " ++ 
+                       showModMsg have_object mod location);
+
+      -- Typecheck 
+      (pcs_tc, maybe_tc_result) <- tcRnIface hsc_env pcs_ch old_iface ;
+
       case maybe_tc_result of {
-         Nothing -> return (HscFail pcs_rn);
-         Just tc_result -> do {
-
-      let pcs_tc        = tc_pcs tc_result
-          env_tc        = tc_env tc_result
-          binds_tc      = tc_binds tc_result
-          local_insts   = tc_insts tc_result
-      ;
-      -- DESUGAR, SIMPLIFY, TIDY-CORE
-      -- We grab the the unfoldings at this point.
-      (tidy_binds, orphan_rules, foreign_stuff)
-         <- dsThenSimplThenTidy dflags this_mod tc_result core_cmds
-      ;
-      -- CONVERT TO STG
-      (stg_binds, oa_tidy_binds, cost_centre_info, top_level_ids) 
-         <- myCoreToStg dflags this_mod tidy_binds stg_cmds
-      ;
-      -- cook up a new ModDetails now we (finally) have all the bits
-      let new_details = mkModDetails env_tc local_insts tidy_binds 
-                                    top_level_ids orphan_rules
-      ;
-      -- and possibly create a new ModIface
-      let maybe_final_iface 
-             = completeIface maybe_checked_iface new_iface new_details 
-      ;
-
-      -- Write the interface file
-      writeIface finder maybe_final_iface
-      ;
-
-      -- do the rest of code generation/emission
-      (maybe_ibinds, maybe_stub_h_filename, maybe_stub_c_filename) 
-         <- restOfCodeGeneration dflags toInterp summary
-               cost_centre_info foreign_stuff tc_env stg_binds oa_tidy_binds
-      ;
-      -- and the answer is ...
-      return (HscOK new_details maybe_final_iface 
-                   maybe_stub_h_filename maybe_stub_c_filename
-                    maybe_ibinds pcs_tc)
-      }}}}}}}
-
-
-myParseModule dflags summary
- = do --------------------------  Parser  ----------------
-      show_pass dflags "Parser"
-      -- _scc_     "Parser"
+         Nothing -> return (HscFail pcs_tc);
+         Just new_details ->
 
-      let src_filename -- name of the preprocessed source file
-            = case ms_ppsource summary of
-                 Just (filename, fingerprint) -> filename
-                 Nothing -> pprPanic 
-                               "myParseModule:summary is not of a source module"
-                               (ppr summary)
+      return (HscNoRecomp pcs_tc new_details old_iface)
+      }}
 
-      buf <- hGetStringBuffer True{-expand tabs-} src_filename
+hscRecomp hsc_env pcs_ch have_object 
+         mod location maybe_checked_iface
+ = do  {
+         -- what target are we shooting for?
+       ; let one_shot  = hsc_mode hsc_env == OneShot
+       ; let dflags    = hsc_dflags hsc_env
+       ; let toInterp  = dopt_HscLang dflags == HscInterpreted
+       ; let toCore    = isJust (ml_hs_file location) &&
+                         isExtCore_file (fromJust (ml_hs_file location))
+
+       ; when (not one_shot && verbosity dflags >= 1) $
+               hPutStrLn stderr ("Compiling " ++ 
+                       showModMsg (not toInterp) mod location);
+                       
+       ; front_res <- if toCore then 
+                         hscCoreFrontEnd hsc_env pcs_ch location
+                      else 
+                         hscFrontEnd hsc_env pcs_ch location
+
+       ; case front_res of
+           Left flure -> return flure;
+           Right (pcs_tc, ds_result) -> do {
+
+
+       -- OMITTED: 
+       -- ; seqList imported_modules (return ())
+
+           -------------------
+           -- FLATTENING
+           -------------------
+       ; flat_result <- _scc_ "Flattening"
+                        flatten hsc_env pcs_tc ds_result
+
+       ; let pcs_middle = pcs_tc
+
+{-     Again, omit this because it loses the usage info
+       which is needed in mkIface.  Maybe we should compute
+       usage info earlier.
+
+       ; pcs_middle
+           <- _scc_ "pcs_middle"
+               if one_shot then
+                      do init_pcs <- initPersistentCompilerState
+                         init_prs <- initPersistentRenamerState
+                         let 
+                             rules   = pcs_rules pcs_tc        
+                             orig_tc = prsOrig (pcs_PRS pcs_tc)
+                             new_prs = init_prs{ prsOrig=orig_tc }
+
+                         orig_tc `seq` rules `seq` new_prs `seq`
+                           return init_pcs{ pcs_PRS = new_prs,
+                                            pcs_rules = rules }
+               else return pcs_tc
+-}
+
+-- Should we remove bits of flat_result at this point?
+--        ; flat_result <- case flat_result of
+--                            ModResult { md_binds = binds } ->
+--                                return ModDetails { md_binds = binds,
+--                                                    md_rules = [],
+--                                                    md_types = emptyTypeEnv,
+--                                                    md_insts = [] }
+
+       -- alive at this point:  
+       --      pcs_middle
+       --      flat_result
+
+           -------------------
+           -- SIMPLIFY
+           -------------------
+       ; simpl_result <- _scc_     "Core2Core"
+                         core2core hsc_env pcs_middle flat_result
+
+           -------------------
+           -- TIDY
+           -------------------
+       ; cg_info_ref <- newIORef Nothing ;
+       ; let cg_info :: CgInfoEnv
+             cg_info = unsafePerformIO $ do {
+                          maybe_cg_env <- readIORef cg_info_ref ;
+                          case maybe_cg_env of
+                            Just env -> return env
+                            Nothing  -> do { printError "Urk! Looked at CgInfo too early!";
+                                             return emptyNameEnv } }
+               -- cg_info_ref will be filled in just after restOfCodeGeneration
+               -- Meanwhile, tidyCorePgm is careful not to look at cg_info!
+
+       ; (pcs_simpl, tidy_result) 
+            <- _scc_ "CoreTidy"
+               tidyCorePgm dflags pcs_middle cg_info simpl_result
+
+--             Space-saving ploy doesn't work so well now
+--             because mkIface needs the populated PIT to 
+--             generate usage info.  Maybe we should re-visit this.
+--     ; pcs_final <- if one_shot then initPersistentCompilerState
+--                                else return pcs_simpl
+       ; let pcs_final = pcs_simpl
+
+       -- Alive at this point:  
+       --      tidy_result, pcs_final
+
+           -------------------
+           -- PREPARE FOR CODE GENERATION
+           -- Do saturation and convert to A-normal form
+       ; prepd_result <- _scc_ "CorePrep" 
+                          corePrepPgm dflags tidy_result
+
+           -------------------
+           -- CONVERT TO STG and COMPLETE CODE GENERATION
+       ; (stub_h_exists, stub_c_exists, maybe_bcos)
+               <- hscBackEnd dflags cg_info_ref prepd_result
+
+           -------------------
+           -- BUILD THE NEW ModIface and ModDetails
+           --  and emit external core if necessary
+           -- This has to happen *after* code gen so that the back-end
+           -- info has been set.  Not yet clear if it matters waiting
+           -- until after code output
+       ; final_iface <- _scc_ "MkFinalIface" 
+                       mkIface hsc_env location 
+                               maybe_checked_iface tidy_result
+       ; let final_details = ModDetails { md_types = mg_types tidy_result,
+                                          md_insts = mg_insts tidy_result,
+                                          md_rules = mg_rules tidy_result }
+       ; emitExternalCore dflags tidy_result
+
+         -- and the answer is ...
+       ; return (HscRecomp pcs_final
+                           final_details
+                           final_iface
+                            stub_h_exists stub_c_exists
+                           maybe_bcos)
+        }}
+
+hscCoreFrontEnd hsc_env pcs_ch location = do {
+           -------------------
+           -- PARSE
+           -------------------
+       ; inp <- readFile (expectJust "hscCoreFrontEnd:hspp" (ml_hspp_file location))
+       ; case parseCore inp 1 of
+           FailP s        -> hPutStrLn stderr s >> return (Left (HscFail pcs_ch));
+           OkP rdr_module -> do {
+    
+           -------------------
+           -- RENAME and TYPECHECK
+           -------------------
+       ; (pcs_tc, maybe_tc_result) <- _scc_ "TypeCheck" 
+                                      tcRnExtCore hsc_env pcs_ch rdr_module
+       ; case maybe_tc_result of {
+            Nothing       -> return (Left  (HscFail pcs_tc));
+            Just mod_guts -> return (Right (pcs_tc, mod_guts))
+                                       -- No desugaring to do!
+       }}}
+        
+
+hscFrontEnd hsc_env pcs_ch location = do {
+           -------------------
+           -- PARSE
+           -------------------
+       ; maybe_parsed <- myParseModule (hsc_dflags hsc_env) 
+                             (expectJust "hscRecomp:hspp" (ml_hspp_file location))
+
+       ; case maybe_parsed of {
+            Nothing -> return (Left (HscFail pcs_ch));
+            Just rdr_module -> do {
+    
+           -------------------
+           -- RENAME and TYPECHECK
+           -------------------
+       ; (pcs_tc, maybe_tc_result) <- _scc_ "Typecheck and Rename" 
+                                       tcRnModule hsc_env pcs_ch rdr_module
+       ; case maybe_tc_result of {
+            Nothing -> return (Left (HscFail pcs_ch));
+            Just tc_result -> do {
+    
+           -------------------
+           -- DESUGAR
+           -------------------
+       ; ds_result <- _scc_ "DeSugar" 
+                      deSugar hsc_env pcs_tc tc_result
+       ; return (Right (pcs_tc, ds_result))
+       }}}}}
+
+
+hscBackEnd dflags cg_info_ref prepd_result
+  = case dopt_HscLang dflags of
+      HscNothing -> return (False, False, Nothing)
+
+      HscInterpreted ->
+#ifdef GHCI
+       do  -----------------  Generate byte code ------------------
+           comp_bc <- byteCodeGen dflags prepd_result
+       
+           -- Fill in the code-gen info
+           writeIORef cg_info_ref (Just emptyNameEnv)
+           
+           ------------------ Create f-x-dynamic C-side stuff ---
+           (istub_h_exists, istub_c_exists) 
+              <- outputForeignStubs dflags (mg_foreign prepd_result)
+           
+           return ( istub_h_exists, istub_c_exists, 
+                    Just comp_bc )
+#else
+       panic "GHC not compiled with interpreter"
+#endif
+
+      other ->
+       do
+           -----------------  Convert to STG ------------------
+           (stg_binds, cost_centre_info, stg_back_end_info) 
+                     <- _scc_ "CoreToStg"
+                        myCoreToStg dflags prepd_result
+                   
+           -- Fill in the code-gen info for the earlier tidyCorePgm
+           writeIORef cg_info_ref (Just stg_back_end_info)
+
+            ------------------  Code generation ------------------
+           abstractC <- _scc_ "CodeGen"
+                        codeGen dflags prepd_result
+                                cost_centre_info stg_binds
+                         
+           ------------------  Code output -----------------------
+           (stub_h_exists, stub_c_exists)
+                    <- codeOutput dflags prepd_result
+                                  stg_binds abstractC
+                             
+           return (stub_h_exists, stub_c_exists, Nothing)
+
+
+myParseModule dflags src_filename
+ = do --------------------------  Parser  ----------------
+      showPass dflags "Parser"
+      _scc_  "Parser" do
+      buf <- hGetStringBuffer src_filename
 
-      let glaexts | dopt Opt_GlasgowExts dflags = 1#
-                 | otherwise                 = 0#
+      let exts = ExtFlags {glasgowExtsEF = dopt Opt_GlasgowExts dflags,
+                          ffiEF         = dopt Opt_FFI         dflags,
+                          withEF        = dopt Opt_With        dflags,
+                          parrEF        = dopt Opt_PArr        dflags}
+         loc  = mkSrcLoc (mkFastString src_filename) 1
 
-      case parse buf PState{ bol = 0#, atbol = 1#,
-                            context = [], glasgow_exts = glaexts,
-                            loc = mkSrcLoc (_PK_ src_filename) 1 } of {
+      case parseModule buf (mkPState loc exts) of {
 
        PFailed err -> do { hPutStrLn stderr (showSDoc err);
+                            freeStringBuffer buf;
                             return Nothing };
-       POk _ rdr_module@(HsModule mod_name _ _ _ _ _ _) -> do {
+
+       POk _ rdr_module -> do {
 
       dumpIfSet_dyn dflags Opt_D_dump_parsed "Parser" (ppr rdr_module) ;
       
@@ -266,86 +425,244 @@ myParseModule dflags summary
                           (ppSourceStats False rdr_module) ;
       
       return (Just rdr_module)
+       -- ToDo: free the string buffer later.
       }}
 
 
-restOfCodeGeneration dflags toInterp summary cost_centre_info 
-                     foreign_stuff tc_env stg_binds oa_tidy_binds
- | toInterp
- = return (Nothing, Nothing, 
-          Just (stgToInterpSyn stg_binds local_tycons local_classes))
- | otherwise
- = do --------------------------  Code generation -------------------------------
-      show_pass dflags "CodeGen"
-      -- _scc_     "CodeGen"
-      abstractC <- codeGen this_mod imported_modules
-                           cost_centre_info fe_binders
-                           local_tycons local_classes stg_binds
-
-      --------------------------  Code output -------------------------------
-      show_pass dflags "CodeOutput"
-      -- _scc_     "CodeOutput"
-      ncg_uniqs <- mkSplitUniqSupply 'n'
-      (maybe_stub_h_name, maybe_stub_c_name)
-         <- codeOutput this_mod local_tycons local_classes
-                       oa_tidy_binds stg_binds
-                       c_code h_code abstractC ncg_uniqs
-
-      return (maybe_stub_h_name, maybe_stub_c_name, Nothing)
- where
-    local_tycons     = tcEnvTyCons tc_env
-    local_classes    = tcEnvClasses tc_env
-    this_mod         = ms_mod summary
-    imported_modules = ms_get_imports summary
-    (fe_binders,h_code,c_code) = foreign_stuff
-
-
-dsThenSimplThenTidy dflags this_mod tc_result core_cmds
--- make up ds_uniqs here
- = do --------------------------  Desugaring ----------------
-      -- _scc_     "DeSugar"
-      ds_uniqs <- mkSplitUniqSupply 'd'
-      (desugared, rules, h_code, c_code, fe_binders) 
-         <- deSugar this_mod ds_uniqs tc_result
-
-      --------------------------  Main Core-language transformations ----------------
-      -- _scc_     "Core2Core"
-      (simplified, orphan_rules)  <- core2core core_cmds desugared rules
-
-      -- Do the final tidy-up
-      (tidy_binds, tidy_orphan_rules) 
-         <- tidyCorePgm this_mod simplified orphan_rules
-      
-      return (tidy_binds, tidy_orphan_rules, (fe_binders,h_code,c_code))
-
-
-myCoreToStg dflags this_mod tidy_binds stg_cmds
+myCoreToStg dflags (ModGuts {mg_module = this_mod, mg_binds = tidy_binds})
  = do 
-      c2s_uniqs <- mkSplitUniqSupply 'c'
-      st_uniqs  <- mkSplitUniqSupply 'g'
-      let occ_anal_tidy_binds = occurAnalyseBinds tidy_binds
-
-      () <- coreBindsSize occ_anal_tidy_binds `seq` return ()
+      () <- coreBindsSize tidy_binds `seq` return ()
       -- TEMP: the above call zaps some space usage allocated by the
       -- simplifier, which for reasons I don't understand, persists
-      -- thoroughout code generation
+      -- thoroughout code generation -- JRS
+      --
+      -- This is still necessary. -- SDM (10 Dec 2001)
+
+      stg_binds <- _scc_ "Core2Stg" 
+            coreToStg dflags tidy_binds
+
+      (stg_binds2, cost_centre_info) <- _scc_ "Core2Stg" 
+            stg2stg dflags this_mod stg_binds
+
+      let env_rhs :: CgInfoEnv
+         env_rhs = mkNameEnv [ caf_info `seq` (idName bndr, CgInfo caf_info)
+                             | (bind,_) <- stg_binds2, 
+                               let caf_info 
+                                    | stgBindHasCafRefs bind = MayHaveCafRefs
+                                    | otherwise              = NoCafRefs,
+                               bndr <- stgBinders bind ]
+
+      return (stg_binds2, cost_centre_info, env_rhs)
+\end{code}
+
+
+%************************************************************************
+%*                                                                     *
+\subsection{Compiling a do-statement}
+%*                                                                     *
+%************************************************************************
+
+When the UnlinkedBCOExpr is linked you get an HValue of type
+       IO [HValue]
+When you run it you get a list of HValues that should be 
+the same length as the list of names; add them to the ClosureEnv.
+
+A naked expression returns a singleton Name [it].
+
+       What you type                   The IO [HValue] that hscStmt returns
+       -------------                   ------------------------------------
+       let pat = expr          ==>     let pat = expr in return [coerce HVal x, coerce HVal y, ...]
+                                       bindings: [x,y,...]
+
+       pat <- expr             ==>     expr >>= \ pat -> return [coerce HVal x, coerce HVal y, ...]
+                                       bindings: [x,y,...]
 
-      show_pass dflags "Core2Stg"
-      -- _scc_     "Core2Stg"
-      let stg_binds   = topCoreBindsToStg c2s_uniqs occ_anal_tidy_binds
+       expr (of IO type)       ==>     expr >>= \ v -> return [v]
+         [NB: result not printed]      bindings: [it]
+         
 
-      show_pass dflags "Stg2Stg"
-      -- _scc_     "Stg2Stg"
-      (stg_binds2, cost_centre_info) <- stg2stg stg_cmds this_mod st_uniqs stg_binds
-      let final_ids = collectFinalStgBinders (map fst stg_binds2)
+       expr (of non-IO type, 
+         result showable)      ==>     let v = expr in print v >> return [v]
+                                       bindings: [it]
 
-      return (stg_binds2, occ_anal_tidy_binds, cost_centre_info, final_ids)
+       expr (of non-IO type, 
+         result not showable)  ==>     error
 
+\begin{code}
+#ifdef GHCI
+hscStmt                -- Compile a stmt all the way to an HValue, but don't run it
+  :: HscEnv
+  -> PersistentCompilerState    -- IN: persistent compiler state
+  -> InteractiveContext                -- Context for compiling
+  -> String                    -- The statement
+  -> IO ( PersistentCompilerState, 
+         Maybe (InteractiveContext, [Name], HValue) )
+
+hscStmt hsc_env pcs icontext stmt
+  = do { maybe_stmt <- hscParseStmt (hsc_dflags hsc_env) stmt
+       ; case maybe_stmt of {
+            Nothing -> return (pcs, Nothing) ;
+            Just parsed_stmt -> do {
+
+               -- Rename and typecheck it
+         (pcs1, maybe_tc_result)
+                <- tcRnStmt hsc_env pcs icontext parsed_stmt
+
+       ; case maybe_tc_result of {
+               Nothing -> return (pcs1, Nothing) ;
+               Just (new_ic, bound_names, tc_expr) -> do {
+
+               -- Then desugar, code gen, and link it
+       ; hval <- compileExpr hsc_env pcs1 iNTERACTIVE 
+                             (icPrintUnqual new_ic) tc_expr
+
+       ; return (pcs1, Just (new_ic, bound_names, hval))
+       }}}}}
+
+hscTcExpr      -- Typecheck an expression (but don't run it)
+  :: HscEnv
+  -> PersistentCompilerState    -- IN: persistent compiler state
+  -> InteractiveContext                -- Context for compiling
+  -> String                    -- The expression
+  -> IO (PersistentCompilerState, Maybe Type)
+
+hscTcExpr hsc_env pcs icontext expr
+  = do { maybe_stmt <- hscParseStmt (hsc_dflags hsc_env) expr
+       ; case maybe_stmt of {
+            Just (ExprStmt expr _ _) 
+                       -> tcRnExpr hsc_env pcs icontext expr ;
+            Just other -> do { hPutStrLn stderr ("not an expression: `" ++ expr ++ "'") ;
+                               return (pcs, Nothing) } ;
+            Nothing    -> return (pcs, Nothing) } }
+\end{code}
+
+\begin{code}
+hscParseStmt :: DynFlags -> String -> IO (Maybe RdrNameStmt)
+hscParseStmt dflags str
+ = do showPass dflags "Parser"
+      _scc_ "Parser"  do
 
-show_pass dflags what
-  = if   dopt Opt_D_show_passes dflags
-    then hPutStr stderr ("*** "++what++":\n")
-    else return ()
+      buf <- stringToStringBuffer str
+
+      let exts = ExtFlags {glasgowExtsEF = dopt Opt_GlasgowExts dflags,
+                          ffiEF         = dopt Opt_FFI         dflags,
+                          withEF        = dopt Opt_With        dflags,
+                          parrEF        = dopt Opt_PArr        dflags}
+         loc  = mkSrcLoc FSLIT("<interactive>") 1
+
+      case parseStmt buf (mkPState loc exts) of {
+
+       PFailed err -> do { hPutStrLn stderr (showSDoc err);
+--     Not yet implemented in <4.11    freeStringBuffer buf;
+                            return Nothing };
+
+       -- no stmt: the line consisted of just space or comments
+       POk _ Nothing -> return Nothing;
+
+       POk _ (Just rdr_stmt) -> do {
+
+      --ToDo: can't free the string buffer until we've finished this
+      -- compilation sweep and all the identifiers have gone away.
+      --freeStringBuffer buf;
+      dumpIfSet_dyn dflags Opt_D_dump_parsed "Parser" (ppr rdr_stmt);
+      return (Just rdr_stmt)
+      }}
+#endif
+\end{code}
+
+%************************************************************************
+%*                                                                     *
+\subsection{Getting information about an identifer}
+%*                                                                     *
+%************************************************************************
+
+\begin{code}
+#ifdef GHCI
+hscThing -- like hscStmt, but deals with a single identifier
+  :: HscEnv
+  -> PersistentCompilerState    -- IN: persistent compiler state
+  -> InteractiveContext                -- Context for compiling
+  -> String                    -- The identifier
+  -> IO ( PersistentCompilerState,
+         [TyThing] )
+
+hscThing hsc_env pcs0 ic str
+   = do let dflags        = hsc_dflags hsc_env
+
+       maybe_rdr_name <- myParseIdentifier dflags str
+       case maybe_rdr_name of {
+         Nothing -> return (pcs0, []);
+         Just rdr_name -> do
+
+       (pcs1, maybe_tc_result) <- 
+          tcRnThing hsc_env pcs0 ic rdr_name
+
+       case maybe_tc_result of {
+            Nothing     -> return (pcs1, []) ;
+            Just things -> return (pcs1, things)
+       }}
+
+myParseIdentifier dflags str
+  = do buf <- stringToStringBuffer str
+       let exts = ExtFlags {glasgowExtsEF = dopt Opt_GlasgowExts dflags,
+                           ffiEF         = dopt Opt_FFI         dflags,
+                           withEF        = dopt Opt_With        dflags,
+                           parrEF        = dopt Opt_PArr        dflags}
+          loc  = mkSrcLoc FSLIT("<interactive>") 1
+
+       case parseIdentifier buf (mkPState loc exts) of
+
+         PFailed err -> do { hPutStrLn stderr (showSDoc err);
+                             freeStringBuffer buf;
+                              return Nothing }
+
+         POk _ rdr_name -> do { --should, but can't: freeStringBuffer buf;
+                                return (Just rdr_name) }
+#endif
+\end{code}
+
+%************************************************************************
+%*                                                                     *
+       Desugar, simplify, convert to bytecode, and link an expression
+%*                                                                     *
+%************************************************************************
+
+\begin{code}
+#ifdef GHCI
+compileExpr :: HscEnv 
+           -> PersistentCompilerState
+           -> Module -> PrintUnqualified
+           -> TypecheckedHsExpr
+           -> IO HValue
+
+compileExpr hsc_env pcs this_mod print_unqual tc_expr
+  = do { let dflags = hsc_dflags hsc_env
+
+               -- Desugar it
+       ; ds_expr <- deSugarExpr hsc_env pcs this_mod print_unqual tc_expr
+       
+               -- Flatten it
+       ; flat_expr <- flattenExpr hsc_env pcs ds_expr
+
+               -- Simplify it
+       ; simpl_expr <- simplifyExpr dflags flat_expr
+
+               -- Tidy it (temporary, until coreSat does cloning)
+       ; tidy_expr <- tidyCoreExpr simpl_expr
+
+               -- Prepare for codegen
+       ; prepd_expr <- corePrepExpr dflags tidy_expr
+
+               -- Convert to BCOs
+       ; bcos <- coreExprToBCOs dflags prepd_expr
+
+               -- link it
+       ; hval <- linkExpr hsc_env pcs bcos
+
+       ; return hval
+     }
+#endif
 \end{code}
 
 
@@ -358,41 +675,45 @@ show_pass dflags what
 \begin{code}
 initPersistentCompilerState :: IO PersistentCompilerState
 initPersistentCompilerState 
-  = do prs <- initPersistentRenamerState
-       return (
-        PCS { pcs_PST   = initPackageDetails,
-             pcs_insts = emptyInstEnv,
-             pcs_rules = emptyRuleBase,
-             pcs_PRS   = prs
-            }
-        )
-
-initPackageDetails :: PackageSymbolTable
-initPackageDetails = extendTypeEnv emptyModuleEnv wiredInThings
-
-initPersistentRenamerState :: IO PersistentRenamerState
-  = do ns <- mkSplitUniqSupply 'r'
+  = do nc <- initNameCache
        return (
-        PRS { prsOrig  = Orig { origNames  = initOrigNames,
-                               origIParam = emptyFM },
-             prsDecls = emptyNameEnv,
-             prsInsts = emptyBag,
-             prsRules = emptyBag,
-             prsNS    = ns
-            }
-        )
+        PCS { pcs_EPS = initExternalPackageState,
+             pcs_nc  = nc })
+
+initNameCache :: IO NameCache
+  = do us <- mkSplitUniqSupply 'r'
+       return (NameCache { nsUniqs = us,
+                          nsNames = initOrigNames,
+                          nsIPs   = emptyFM })
+
+initExternalPackageState :: ExternalPackageState
+initExternalPackageState
+  = EPS { 
+      eps_decls      = (emptyNameEnv, 0),
+      eps_insts      = (emptyBag, 0),
+      eps_inst_gates = emptyNameSet,
+      eps_rules      = foldr add_rule (emptyBag, 0) builtinRules,
+      eps_imp_mods   = emptyFM,
+
+      eps_PIT       = emptyPackageIfaceTable,
+      eps_PTE       = wiredInThingEnv,
+      eps_inst_env  = emptyInstEnv,
+      eps_rule_base = emptyRuleBase }
+             
+  where
+    add_rule (name,rule) (rules, n_slurped)
+        = (gated_decl `consBag` rules, n_slurped)
+       where
+          gated_decl = (gate_fn, (mod, IfaceRuleOut rdr_name rule))
+          mod        = nameModule name
+          rdr_name   = nameRdrName name
+          gate_fn vis_fn = vis_fn name -- Load the rule whenever name is visible
 
 initOrigNames :: FiniteMap (ModuleName,OccName) Name
-initOrigNames = grab knownKeyNames `plusFM` grab (map getName wiredInThings)
-             where
-               grab names   = foldl add emptyFM names
-               add env name = addToFM env (moduleName (nameModule name), nameOccName name) name
-
-
-initRules :: PackageRuleBase
-initRules = foldl add emptyVarEnv builtinRules
-         where
-           add env (name,rule) 
-               = extendNameEnv_C (\rules _ -> rule:rules) 
-                                 env name [rule]
+initOrigNames 
+   = grab knownKeyNames `plusFM` grab (map getName wiredInThings)
+     where
+        grab names = foldl add emptyFM names
+        add env name 
+           = addToFM env (moduleName (nameModule name), nameOccName name) name
 \end{code}