[project @ 2000-11-24 09:51:38 by simonpj]
[ghc-hetmet.git] / ghc / compiler / typecheck / TcModule.lhs
index 15213ff..9a747c1 100644 (file)
 %
-% (c) The GRASP/AQUA Project, Glasgow University, 1992-1995
+% (c) The GRASP/AQUA Project, Glasgow University, 1992-1998
 %
 \section[TcModule]{Typechecking a whole module}
 
 \begin{code}
-#include "HsVersions.h"
-
 module TcModule (
-       tcModule,
-
-       -- to make the interface self-sufficient...
-       Module, Bag, CE(..), E, Binds, FixityDecl, Expr, InPat,
-       RenamedPat(..), TypecheckedPat, Id, Inst, Maybe, TcResult,
-       Name, ProtoName, SrcLoc, Subst, TCE(..), UniqFM,
-       Error(..), Pretty(..), PprStyle, PrettyRep, InstInfo
+       typecheckModule, typecheckExpr, TcResults(..)
     ) where
 
-import TcMonad         -- typechecking monad machinery
-import AbsSyn          -- the stuff being typechecked
-
--- OLD:
---import AbsPrel       ( stringTy,
---                       eqStringId, neStringId, ltStringId,
---                       leStringId, geStringId, gtStringId,
---                       maxStringId, minStringId, tagCmpStringId,
---                       dfunEqStringId, dfunOrdStringId,
---                       pRELUDE_CORE
---                       IF_ATTACK_PRAGMAS(COMMA mkListTy COMMA charTy)
---                     )
---#if USE_ATTACK_PRAGMAS
---import PrelVals      ( string_cmp_id ) -- shouldn't even be visible, really
---#endif
-import BackSubst       ( applyTcSubstToBinds )
-import Bag             ( unionBags, bagToList, emptyBag, listToBag )
-import CE              ( nullCE, checkClassCycles, lookupCE, CE(..) )
-import CmdLineOpts     ( GlobalSwitch(..) )
-import E
-import HsCore          -- ****** NEED TO SEE CONSTRUCTORS ******
-import HsPragmas       -- ****** NEED TO SEE CONSTRUCTORS ******
-import InstEnv
-import LIE             ( unMkLIE, plusLIE, LIE )
-import Name            ( Name(..) )
-import RenameAuxFuns   ( GlobalNameFuns(..), GlobalNameFun(..), ProtoName, Maybe )
-import SrcLoc          ( mkBuiltinSrcLoc, SrcLoc )
-import TCE             ( checkTypeCycles, TCE(..), UniqFM )
-import TcBinds         ( tcTopBindsAndThen )
-import TcClassDcl      ( tcClassDecls1, tcClassDecls2, ClassInfo )
-import TcDefaults      ( tcDefaults )
-import TcDeriv         ( tcDeriving )
+#include "HsVersions.h"
+
+import CmdLineOpts     ( DynFlag(..), DynFlags, opt_PprStyle_Debug )
+import HsSyn           ( HsBinds(..), MonoBinds(..), HsDecl(..), 
+                         isIfaceRuleDecl, nullBinds, andMonoBindList
+                       )
+import HsTypes         ( toHsType )
+import RnHsSyn         ( RenamedHsBinds, RenamedHsDecl, RenamedHsExpr )
+import TcHsSyn         ( TypecheckedMonoBinds, TypecheckedHsExpr,
+                         TypecheckedForeignDecl, TypecheckedRuleDecl,
+                         zonkTopBinds, zonkForeignExports, zonkRules, mkHsLet,
+                         zonkExpr
+                       )
+
+
+import TcMonad
+import TcType          ( newTyVarTy, zonkTcType )
+import Inst            ( plusLIE )
+import TcBinds         ( tcTopBinds )
+import TcClassDcl      ( tcClassDecls2 )
+import TcDefaults      ( tcDefaults, defaultDefaultTys )
+import TcExpr          ( tcMonoExpr )
+import TcEnv           ( TcEnv, InstInfo(iDFunId), tcExtendGlobalValEnv, 
+                         isLocalThing, tcSetEnv, tcSetInstEnv, initTcEnv, getTcGEnv
+                       )
+import TcRules         ( tcIfaceRules, tcSourceRules )
+import TcForeign       ( tcForeignImports, tcForeignExports )
 import TcIfaceSig      ( tcInterfaceSigs )
-import TcInstDcls      ( tcInstDecls1, tcInstDecls2, tcSpecInstSigs, buildInstanceEnvs, InstInfo(..) )
+import TcInstDcls      ( tcInstDecls1, tcInstDecls2 )
 import TcSimplify      ( tcSimplifyTop )
-import TcTyDecls       ( tcTyDecls )
-import Unique          -- some ClassKey stuff
-import UniqFM          ( emptyUFM ) -- profiling, pragmas only
+import TcTyClsDecls    ( tcTyAndClassDecls )
+
+import CoreUnfold      ( unfoldingTemplate, hasUnfolding )
+import Type            ( funResultTy, splitForAllTys, openTypeKind )
+import Bag             ( isEmptyBag )
+import ErrUtils                ( printErrorsAndWarnings, dumpIfSet_dyn, showPass )
+import Id              ( idType, idUnfolding )
+import Module           ( Module )
+import Name            ( Name, toRdrName )
+import Name            ( nameEnvElts, lookupNameEnv )
+import TyCon           ( tyConGenInfo )
 import Util
+import BasicTypes       ( EP(..), Fixity )
+import Bag             ( isEmptyBag )
+import Outputable
+import HscTypes                ( PersistentCompilerState(..), HomeSymbolTable, 
+                         PackageTypeEnv, DFunId, ModIface(..),
+                         TypeEnv, extendTypeEnvList, 
+                         TyThing(..), implicitTyThingIds, 
+                         mkTypeEnv
+                       )
+\end{code}
+
+Outside-world interface:
+\begin{code}
 
-import Pretty          -- Debugging
+-- Convenient type synonyms first:
+data TcResults
+  = TcResults {
+       -- All these fields have info *just for this module*
+       tc_env     :: TypeEnv,                  -- The top level TypeEnv
+       tc_insts   :: [DFunId],                 -- Instances
+       tc_binds   :: TypecheckedMonoBinds,     -- Bindings
+       tc_fords   :: [TypecheckedForeignDecl], -- Foreign import & exports.
+       tc_rules   :: [TypecheckedRuleDecl]     -- Transformation rules
+    }
+
+---------------
+typecheckModule
+       :: DynFlags
+       -> PersistentCompilerState
+       -> HomeSymbolTable
+       -> ModIface             -- Iface for this module
+       -> PrintUnqualified     -- For error printing
+       -> [RenamedHsDecl]
+       -> IO (Maybe (PersistentCompilerState, TcResults))
+                       -- The new PCS is Augmented with imported information,
+                                               -- (but not stuff from this module)
+
+
+typecheckModule dflags pcs hst mod_iface unqual decls
+  = do { maybe_tc_result <- typecheck dflags pcs hst unqual $
+                            tcModule pcs hst get_fixity this_mod decls
+       ; printTcDump dflags maybe_tc_result
+       ; return maybe_tc_result }
+  where
+    this_mod   = mi_module   mod_iface
+    fixity_env = mi_fixities mod_iface
+
+    get_fixity :: Name -> Maybe Fixity
+    get_fixity nm = lookupNameEnv fixity_env nm
+
+---------------
+typecheckExpr :: DynFlags
+             -> PersistentCompilerState
+             -> HomeSymbolTable
+             -> PrintUnqualified       -- For error printing
+             -> Module
+             -> (RenamedHsExpr,        -- The expression itself
+                 [RenamedHsDecl])      -- Plus extra decls it sucked in from interface files
+             -> IO (Maybe (PersistentCompilerState, TypecheckedHsExpr, TcType))
+
+typecheckExpr dflags pcs hst unqual this_mod (expr, decls)
+  = typecheck dflags pcs hst unqual $
+
+        -- use the default default settings, i.e. [Integer, Double]
+    tcSetDefaultTys defaultDefaultTys $
+    tcImports pcs hst get_fixity this_mod decls        `thenTc` \ (env, new_pcs, local_inst_info, deriv_binds, local_rules) ->
+    ASSERT( null local_inst_info && nullBinds deriv_binds && null local_rules )
+
+    tcSetEnv env                               $
+    newTyVarTy openTypeKind    `thenTc` \ ty ->
+    tcMonoExpr expr ty         `thenTc` \ (expr', lie) ->
+    tcSimplifyTop lie          `thenTc` \ binds ->
+    let all_expr = mkHsLet binds expr' in
+    zonkExpr all_expr          `thenNF_Tc` \ zonked_expr ->
+    zonkTcType ty              `thenNF_Tc` \ zonked_ty ->
+    returnTc (new_pcs, zonked_expr, zonked_ty) 
+  where
+    get_fixity :: Name -> Maybe Fixity
+    get_fixity n = pprPanic "typecheckExpr" (ppr n)
+
+---------------
+typecheck :: DynFlags
+         -> PersistentCompilerState
+         -> HomeSymbolTable
+         -> PrintUnqualified   -- For error printing
+         -> TcM r
+         -> IO (Maybe r)
+
+typecheck dflags pcs hst unqual thing_inside 
+ = do  { showPass dflags "Typechecker";
+       ; env <- initTcEnv hst (pcs_PTE pcs)
+
+       ; (maybe_tc_result, (warns,errs)) <- initTc dflags env thing_inside
+
+       ; printErrorsAndWarnings unqual (errs,warns)
+
+       ; if isEmptyBag errs then 
+             return maybe_tc_result
+           else 
+             return Nothing 
+       }
 \end{code}
 
+The internal monster:
 \begin{code}
-tcModule :: E                          -- initial typechecker environment
-        -> GlobalNameFuns              -- final renamer info (to do derivings)
-        -> RenamedModule               -- input
-        -> TcM ((TypecheckedBinds,     -- binds from class decls; does NOT
-                                       -- include default-methods bindings
-                 TypecheckedBinds,     -- binds from instance decls; INCLUDES
-                                       -- class default-methods binds
-                 TypecheckedBinds,     -- binds from value decls
-                 [(Inst, TypecheckedExpr)]),
-
-                ([RenamedFixityDecl],  -- things for the interface generator
-                 [Id],                 -- to look at...
-                 CE,
-                 TCE,
-                 Bag InstInfo),
-
-                FiniteMap TyCon [[Maybe UniType]],
-                                       -- source tycon specialisation requests
-
---UNUSED:       E,                     -- environment of total accumulated info
-                E,                     -- environment of info due to this module only
-                PprStyle -> Pretty)    -- -ddump-deriving info (passed upwards)
-
-tcModule e1 renamer_name_funs
-       (Module mod_name exports imports_should_be_empty fixities
-            tydecls ty_sigs classdecls instdecls specinst_sigs
-            default_decls valdecls sigs src_loc)
-
-  = addSrcLocTc src_loc (      -- record where we're starting
-
-       -- Tie the knot for inteface-file value declaration signatures
-       -- This info is only used inside the knot for type-checking the
-       -- pragmas, which is done lazily [ie failure just drops the pragma
-       -- without having any global-failure effect].
-
-    fixTc (\ ~(rec_gve_sigs, _, _, _, _, _, _, _, _, _) ->
+tcModule :: PersistentCompilerState
+        -> HomeSymbolTable
+        -> (Name -> Maybe Fixity)
+        -> Module
+        -> [RenamedHsDecl]
+        -> TcM (PersistentCompilerState, TcResults)
+
+tcModule pcs hst get_fixity this_mod decls
+  =    -- Type-check the type and class decls, and all imported decls
+    tcImports pcs hst get_fixity this_mod decls        `thenTc` \ (env, new_pcs, local_inst_info, deriv_binds, local_rules) ->
+
+    tcSetEnv env                               $
+
+        -- Foreign import declarations next
+--  traceTc (text "Tc4")                       `thenNF_Tc_`
+    tcForeignImports decls                     `thenTc`    \ (fo_ids, foi_decls) ->
+    tcExtendGlobalValEnv fo_ids                        $
+    
+       -- Default declarations
+    tcDefaults decls                           `thenTc` \ defaulting_tys ->
+    tcSetDefaultTys defaulting_tys             $
+       
+       -- Value declarations next.
+       -- We also typecheck any extra binds that came out of the "deriving" process
+--  traceTc (text "Tc5")                               `thenNF_Tc_`
+    tcTopBinds (val_binds `ThenBinds` deriv_binds)     `thenTc` \ ((val_binds, env), lie_valdecls) ->
+    tcSetEnv env $
+    
+       -- Foreign export declarations next
+--  traceTc (text "Tc6")               `thenNF_Tc_`
+    tcForeignExports decls             `thenTc`    \ (lie_fodecls, foe_binds, foe_decls) ->
+    
+       -- Second pass over class and instance declarations,
+       -- to compile the bindings themselves.
+    tcInstDecls2  local_inst_info              `thenNF_Tc` \ (lie_instdecls, inst_binds) ->
+    tcClassDecls2 this_mod tycl_decls          `thenNF_Tc` \ (lie_clasdecls, cls_dm_binds) ->
+    tcSourceRules source_rules                 `thenNF_Tc` \ (lie_rules,     more_local_rules) ->
+    
+         -- Deal with constant or ambiguous InstIds.  How could
+         -- there be ambiguous ones?  They can only arise if a
+         -- top-level decl falls under the monomorphism
+         -- restriction, and no subsequent decl instantiates its
+         -- type.  (Usually, ambiguous type variables are resolved
+         -- during the generalisation step.)
+    let
+        lie_alldecls = lie_valdecls    `plusLIE`
+                      lie_instdecls    `plusLIE`
+                      lie_clasdecls    `plusLIE`
+                      lie_fodecls      `plusLIE`
+                      lie_rules
+    in
+    tcSimplifyTop lie_alldecls                 `thenTc` \ const_inst_binds ->
+    
+        -- Backsubstitution.    This must be done last.
+        -- Even tcSimplifyTop may do some unification.
     let
-       e2 = plusE_GVE e1 rec_gve_sigs
+        all_binds = val_binds          `AndMonoBinds`
+                   inst_binds          `AndMonoBinds`
+                   cls_dm_binds        `AndMonoBinds`
+                   const_inst_binds    `AndMonoBinds`
+                   foe_binds
     in
+--  traceTc (text "Tc9")               `thenNF_Tc_`
+    zonkTopBinds all_binds             `thenNF_Tc` \ (all_binds', final_env)  ->
+    tcSetEnv final_env                 $
+       -- zonkTopBinds puts all the top-level Ids into the tcGEnv
+    zonkForeignExports foe_decls       `thenNF_Tc` \ foe_decls' ->
+    zonkRules more_local_rules         `thenNF_Tc` \ more_local_rules' ->
+    
+    
+    let        local_things = filter (isLocalThing this_mod) (nameEnvElts (getTcGEnv final_env))
+
+       -- Create any necessary "implicit" bindings (data constructors etc)
+       -- Should we create bindings for dictionary constructors?
+       -- They are always fully applied, and the bindings are just there
+       -- to support partial applications. But it's easier to let them through.
+       implicit_binds = andMonoBindList [ CoreMonoBind id (unfoldingTemplate unf)
+                                        | id <- implicitTyThingIds local_things
+                                        , let unf = idUnfolding id
+                                        , hasUnfolding unf
+                                        ]
+
+       local_type_env :: TypeEnv
+       local_type_env = mkTypeEnv local_things
+           
+       all_local_rules = local_rules ++ more_local_rules'
+    in  
+--  traceTc (text "Tc10")              `thenNF_Tc_`
+    returnTc (new_pcs,
+             TcResults { tc_env     = local_type_env,
+                         tc_binds   = implicit_binds `AndMonoBinds` all_binds', 
+                         tc_insts   = map iDFunId local_inst_info,
+                         tc_fords   = foi_decls ++ foe_decls',
+                         tc_rules   = all_local_rules
+                        }
+    )
+  where
+    tycl_decls   = [d | TyClD d <- decls]
+    val_binds    = foldr ThenBinds EmptyBinds [binds | ValD binds <- decls]
+    source_rules = [d | RuleD d <- decls, not (isIfaceRuleDecl d)]
+\end{code}
 
-       -- The knot for instance information.  This isn't used at all
-       -- till we type-check value declarations.
-       fixTc ( \ ~(rec_inst_mapper, _, _, _, _, _, _, _, _) ->
-
-            -- The knot for TyCons and Classes
-           fixTc ( \ ~(_, rec_tce, rec_ce, rec_datacons_gve, rec_ops_gve, _, _) ->
-               let
-                   e3 = e2
-                        `plusE_GVE` rec_datacons_gve
-                        `plusE_GVE` rec_ops_gve
-                        `plusE_TCE` rec_tce
-                        `plusE_CE`  rec_ce
-               in
-                   -- DO THE TYPE DECLS
-                   -- Including the pragmas: {-# ABSTRACT TypeSyn #-}
-                   --                        {-# SPECIALIZE data DataType ... #-}
-               let
-                   (absty_sigs, specdata_sigs) = partition is_absty_sig ty_sigs
-                   is_absty_sig (AbstractTypeSig _ _) = True
-                   is_absty_sig (SpecDataSig _ _ _)   = False
-
-                   is_abs_syn :: Name -> Bool  -- a lookup fn for abs synonyms
-                   is_abs_syn n
-                     = n `is_elem` [ tc | (AbstractTypeSig tc _) <- absty_sigs ]
-                     where
-                       is_elem = isIn "tcModule"
-
-                   get_spec_sigs :: Name -> [RenamedDataTypeSig]
-                   get_spec_sigs n
-                     = [ sig | sig@(SpecDataSig tc _ _) <- specdata_sigs, n == tc]
-               in
-               babyTcMtoTcM (tcTyDecls e3 is_abs_syn get_spec_sigs tydecls)
-                       `thenTc` \ (tce, datacons_gve, tycon_specs) ->
-
-                   -- DO THE CLASS DECLS
-               tcClassDecls1 e3 rec_inst_mapper classdecls
-                       `thenTc` \ (class_info, ce, ops_gve) ->
-
-                   -- End of TyCon/Class knot
-                   -- Augment whatever TCE/GVE/CE stuff was in orig_e
-               returnTc (e3, tce, ce, datacons_gve, ops_gve, class_info, tycon_specs)
-
-                  -- End of inner fixTc
-           )   `thenTc` ( \ (e3, tce_here, ce_here, _, _, class_info, tycon_specs) ->
-                            -- The "here" things are the extra decls defined in this
-                            -- module or its imports; but not including whatever was
-                            -- in the incoming e.
-
-                   -- Grab completed tce/ce and check for type/class cycles
-                   -- The tce/ce are now stable and lookable-at, with the
-                   -- exception of the instance information inside classes
-           let
-               ce3  = getE_CE e3
-               tce3 = getE_TCE e3
-           in
-           checkMaybeErrTc (checkTypeCycles tce3) id    `thenTc_`
-           checkMaybeErrTc (checkClassCycles ce3) id    `thenTc_`
-
-                   -- Now instance declarations
-           tcInstDecls1 e3 ce3 tce3 instdecls          `thenNF_Tc` \ decl_inst_info ->
-
-                   -- Handle "derived" instances; note that we only do derivings
-                   -- for things in this module; we ignore deriving decls from
-                   -- interfaces! We pass fixities, because they may be used in
-                   -- doing Text.
-
-           tcDeriving mod_name renamer_name_funs decl_inst_info tce3 fixities
-                   `thenTc` \ (deriv_inst_info, extra_deriv_binds, ddump_deriv) ->
-
-           let
-               inst_info = deriv_inst_info `unionBags` decl_inst_info 
-           in
-                   -- Handle specialise instance pragmas
---         getSwitchCheckerTc                  `thenNF_Tc` \ sw_chkr ->
---         (if sw_chkr GlasgowExts then
-                tcSpecInstSigs e3 ce3 tce3 inst_info specinst_sigs
---          else
---              returnTc emptyBag)
-                                               `thenTc` \ spec_inst_info ->
-           let
-               full_inst_info = inst_info `unionBags` spec_inst_info 
-           in
-                   -- OK, now do the inst-mapper stuff
-           buildInstanceEnvs full_inst_info    `thenTc` \ all_insts_mapper ->
-
-           returnTc (all_insts_mapper, e3, ce_here, tce_here, class_info, tycon_specs,
-                     full_inst_info, extra_deriv_binds, ddump_deriv)
-
-                   -- End of outer fixTc
-       )) `thenTc` ( \ (_, e3, ce_here, tce_here, class_info, tycon_specs,
-                       full_inst_info, extra_deriv_binds, ddump_deriv) ->
-
-    -- Default declarations
-    tcDefaults e3 default_decls        `thenTc` \ defaulting_tys ->
-    setDefaultingTys defaulting_tys ( -- for the iface sigs...
-
-    -- Interface type signatures
-
-    -- We tie a knot so that the Ids read out of interfaces are in scope
-    --   when we read their pragmas.
-    -- What we rely on is that pragmas are typechecked lazily; if
-    --   any type errors are found (ie there's an inconsistency) 
-    --   we silently discard the pragma
-
-    babyTcMtoTcM (tcInterfaceSigs e3 sigs)     `thenTc` \ gve_sigs ->
-
-    returnTc (gve_sigs, e3, ce_here, tce_here, class_info, tycon_specs, defaulting_tys,
-             full_inst_info, extra_deriv_binds, ddump_deriv)
-
-    -- End of extremely outer fixTc
-    )))        `thenTc` \ (_, e3, ce_here, tce_here, class_info, tycon_specs, defaulting_tys,
-                   full_inst_info, extra_deriv_binds, ddump_deriv) ->
-
-    setDefaultingTys defaulting_tys ( -- to the end...
 
-       -- Value declarations next.
-       -- We also typecheck any extra binds that came out of the "deriving" process
-       -- Nota bene
-    tcTopBindsAndThen
-       e3
-       (\ binds1 (binds2, thing) -> (binds1 `ThenBinds` binds2, thing))
-       (valdecls `ThenBinds` extra_deriv_binds)
-       (\ e4 ->
-               -- Second pass over instance declarations,
-               -- to compile the bindings themselves.
-           tcInstDecls2  e4 full_inst_info `thenNF_Tc` \ (lie_instdecls, inst_binds) ->
-           tcClassDecls2 e4 class_info     `thenNF_Tc` \ (lie_clasdecls, class_binds) ->
-           returnTc ( (EmptyBinds, (inst_binds, class_binds, e4)),
-                      lie_instdecls `plusLIE` lie_clasdecls,
-                      () )
-       )
-
-       `thenTc` \ ((val_binds, (inst_binds, class_binds, e4)), lie_alldecls, _) ->
-
-       -- Deal with constant or ambiguous InstIds.  How could
-       -- there be ambiguous ones?  They can only arise if a
-       -- top-level decl falls under the monomorphism
-       -- restriction, and no subsequent decl instantiates its
-       -- type.  (Usually, ambiguous type variables are resolved
-       -- during the generalisation step.)
-
-    tcSimplifyTop (unMkLIE lie_alldecls)    `thenTc` \ const_inst_binds ->
-
-       -- Backsubstitution.  Monomorphic top-level decls may have
-       -- been instantiated by subsequent decls, and the final
-       -- simplification step may have instantiated some
-       -- ambiguous types.  So, sadly, we need to back-substitute
-       -- over the whole bunch of bindings.
-
-    applyTcSubstToBinds val_binds          `thenNF_Tc` \ val_binds' ->
-    applyTcSubstToBinds inst_binds         `thenNF_Tc` \ inst_binds' ->
-    applyTcSubstToBinds class_binds        `thenNF_Tc` \ class_binds' ->
-
-       -- ToDo: probably need to back-substitute over all
-       -- stuff in 'e4'; we do so here over the Ids,
-       -- which is probably enough.  WDP 95/06
-    mapNF_Tc applyTcSubstToId (getE_GlobalVals e4)
-                                           `thenNF_Tc` \ if_global_ids ->
-
-       -- FINISHED AT LAST
-    returnTc (
-       (class_binds', inst_binds', val_binds', const_inst_binds),
-
-            -- the next collection is just for mkInterface
-       (fixities, if_global_ids, ce_here, tce_here, full_inst_info),
-
-       tycon_specs,
-
---UNUSED: e4,
-
-         -- and... TCE needed for code generation; rest needed for interpreter.
-         -- ToDo: still wrong: needs isLocallyDeclared run over everything
-       mkE tce_here {-gve_here lve-} ce_here,
-            -- NB: interpreter would probably need the gve_here stuff
-       ddump_deriv
-    )))
+\begin{code}
+tcImports :: PersistentCompilerState
+         -> HomeSymbolTable
+         -> (Name -> Maybe Fixity)
+         -> Module
+         -> [RenamedHsDecl]
+         -> TcM (TcEnv, PersistentCompilerState, 
+                 [InstInfo], RenamedHsBinds, [TypecheckedRuleDecl])
+
+-- tcImports is a slight mis-nomer.  
+-- It deals with everythign that could be an import:
+--     type and class decls
+--     interface signatures
+--     instance decls
+--     rule decls
+-- These can occur in source code too, of course
+
+tcImports pcs hst get_fixity this_mod decls
+  = fixTc (\ ~(unf_env, _, _, _, _) -> 
+         -- (unf_env :: RecTcEnv) is used for type-checking interface pragmas
+         -- which is done lazily [ie failure just drops the pragma
+         -- without having any global-failure effect].
+         -- 
+         -- unf_env is also used to get the pragama info
+         -- for imported dfuns and default methods
+               
+--     traceTc (text "Tc1")                    `thenNF_Tc_`
+       tcTyAndClassDecls unf_env tycl_decls    `thenTc` \ env ->
+       tcSetEnv env                            $
+       
+               -- Typecheck the instance decls, includes deriving
+--     traceTc (text "Tc2")    `thenNF_Tc_`
+       tcInstDecls1 (pcs_insts pcs) (pcs_PRS pcs) 
+                    hst unf_env get_fixity this_mod 
+                    decls                      `thenTc` \ (new_pcs_insts, inst_env, local_inst_info, deriv_binds) ->
+       tcSetInstEnv inst_env                   $
+       
+       -- Interface type signatures
+       -- We tie a knot so that the Ids read out of interfaces are in scope
+       --   when we read their pragmas.
+       -- What we rely on is that pragmas are typechecked lazily; if
+       --   any type errors are found (ie there's an inconsistency)
+       --   we silently discard the pragma
+--     traceTc (text "Tc3")                    `thenNF_Tc_`
+       tcInterfaceSigs unf_env tycl_decls      `thenTc` \ sig_ids ->
+       tcExtendGlobalValEnv sig_ids            $
+       
+       
+        tcIfaceRules (pcs_rules pcs) this_mod iface_rules      `thenNF_Tc` \ (new_pcs_rules, local_rules) ->
+
+       tcGetEnv                                                `thenTc` \ unf_env ->
+       let
+           imported_things = filter (not . isLocalThing this_mod) (nameEnvElts (getTcGEnv unf_env))
+
+           new_pte :: PackageTypeEnv
+           new_pte = extendTypeEnvList (pcs_PTE pcs) imported_things
+           
+           new_pcs :: PersistentCompilerState
+           new_pcs = pcs { pcs_PTE   = new_pte,
+                           pcs_insts = new_pcs_insts,
+                           pcs_rules = new_pcs_rules
+                     }
+       in
+       returnTc (unf_env, new_pcs, local_inst_info, deriv_binds, local_rules)
+    )
+  where
+    tycl_decls  = [d | TyClD d <- decls]
+    iface_rules = [d | RuleD d <- decls, isIfaceRuleDecl d]
+\end{code}    
+
+%************************************************************************
+%*                                                                     *
+\subsection{Dumping output}
+%*                                                                     *
+%************************************************************************
+
+\begin{code}
+printTcDump dflags Nothing = return ()
+printTcDump dflags (Just (_, results))
+  = do dumpIfSet_dyn dflags Opt_D_dump_types 
+                     "Type signatures" (dump_sigs results)
+       dumpIfSet_dyn dflags Opt_D_dump_tc    
+                     "Typechecked" (dump_tc results) 
+
+dump_tc results
+  = vcat [ppr (tc_binds results),
+         pp_rules (tc_rules results),
+         ppr_gen_tycons [tc | ATyCon tc <- nameEnvElts (tc_env results)]
+    ]
+
+dump_sigs results      -- Print type signatures
+  =    -- Convert to HsType so that we get source-language style printing
+       -- And sort by RdrName
+    vcat $ map ppr_sig $ sortLt lt_sig $
+    [ (toRdrName id, toHsType (idType id))
+    | AnId id <- nameEnvElts (tc_env results),
+      want_sig id
+    ]
+  where
+    lt_sig (n1,_) (n2,_) = n1 < n2
+    ppr_sig (n,t)        = ppr n <+> dcolon <+> ppr t
+
+    want_sig id | opt_PprStyle_Debug = True
+               | otherwise          = True     -- For now
+
+ppr_gen_tycons tcs = vcat [ptext SLIT("{-# Generic type constructor details"),
+                          vcat (map ppr_gen_tycon tcs),
+                          ptext SLIT("#-}")
+                    ]
+
+-- x&y are now Id's, not CoreExpr's 
+ppr_gen_tycon tycon 
+  | Just ep <- tyConGenInfo tycon
+  = (ppr tycon <> colon) $$ nest 4 (ppr_ep ep)
+
+  | otherwise = ppr tycon <> colon <+> ptext SLIT("Not derivable")
+
+ppr_ep (EP from to)
+  = vcat [ ptext SLIT("Rep type:") <+> ppr (funResultTy from_tau),
+          ptext SLIT("From:") <+> ppr (unfoldingTemplate (idUnfolding from)),
+          ptext SLIT("To:")   <+> ppr (unfoldingTemplate (idUnfolding to))
+    ]
+  where
+    (_,from_tau) = splitForAllTys (idType from)
+
+pp_rules [] = empty
+pp_rules rs = vcat [ptext SLIT("{-# RULES"),
+                   nest 4 (vcat (map ppr rs)),
+                   ptext SLIT("#-}")]
 \end{code}