[project @ 1999-07-16 09:36:07 by simonpj]
[ghc-hetmet.git] / ghc / compiler / typecheck / TcEnv.lhs
index c2b831d..49da0db 100644 (file)
 \begin{code}
-#include "HsVersions.h"
-
 module TcEnv(
-       TcEnv, 
+       TcId, TcIdSet, tcInstId,
+       tcLookupDataCon,
+
+       TcEnv, ValueEnv, TcTyThing(..),
 
-       initEnv, getEnv_LocalIds, getEnv_TyCons, getEnv_Classes,
+       initEnv, getEnvTyCons, getEnvClasses, getAllEnvTyCons,
        
-       tcExtendKindEnv, tcExtendTyVarEnv, tcExtendTyConEnv, tcExtendClassEnv,
-       tcLookupTyVar, tcLookupTyCon, tcLookupClass, tcLookupClassByKey,
+        tcExtendUVarEnv, tcLookupUVar,
+
+       tcExtendTyVarEnv, tcExtendTyVarEnvForMeths, tcExtendTypeEnv, tcGetInScopeTyVars,
+
+       tcLookupTy,
+       tcLookupTyCon, tcLookupTyConByKey, 
+       tcLookupClass, tcLookupClassByKey,
 
        tcExtendGlobalValEnv, tcExtendLocalValEnv,
-       tcLookupLocalValue, tcLookupLocalValueOK,
-       tcLookupGlobalValue, tcLookupGlobalValueByKey,
+       tcGetValueEnv,        tcSetValueEnv, 
+       tcAddImportedIdInfo,
 
-       tcTyVarScope, newMonoIds, newLocalIds,
-       tcGetGlobalTyVars
-  ) where
+       tcLookupValue,      tcLookupValueMaybe, 
+       tcLookupValueByKey, tcLookupValueByKeyMaybe,
+       explicitLookupValueByKey, explicitLookupValue,
+       valueEnvIds,
 
+       newLocalId, newSpecPragmaId,
+       tcGetGlobalTyVars, tcExtendGlobalTyVars,
 
-import Ubiq
-import TcMLoop  -- for paranoia checking
+       badCon, badPrimOp
+  ) where
+
+#include "HsVersions.h"
 
-import Id      ( Id(..), GenId, idType, mkUserLocal )
-import TcHsSyn ( TcIdBndr(..) )
-import TcKind  ( TcKind, newKindVars, tcKindToKind, kindToTcKind )
-import TcType  ( TcType(..), TcMaybe, TcTyVar(..), TcTyVarSet(..), newTyVarTys, zonkTcTyVars )
-import TyVar   ( mkTyVar, getTyVarKind, unionTyVarSets, emptyTyVarSet )
-import Type    ( tyVarsOfTypes )
-import TyCon   ( TyCon, getTyConKind )
-import Class   ( Class(..), GenClass, getClassSig )
+import HsTypes ( HsTyVar, getTyVarName )
+import Id      ( mkUserLocal, isDataConId_maybe )
+import MkId    ( mkSpecPragmaId )
+import Var     ( TyVar, Id, setVarName,
+                 idType, lazySetIdInfo, idInfo, tyVarKind, UVar,
+               )
+import TcType  ( TcType, TcTyVar, TcTyVarSet, TcThetaType,
+                 tcInstTyVars, zonkTcTyVars,
+                 TcKind, kindToTcKind
+               )
+import VarEnv
+import VarSet
+import Type    ( Kind, superKind,
+                 tyVarsOfType, tyVarsOfTypes, mkTyVarTy,
+                 splitForAllTys, splitRhoTy, splitFunTys,
+                 splitAlgTyConApp_maybe, getTyVar
+               )
+import Subst   ( substTy )
+import UsageSPUtils ( unannotTy )
+import DataCon ( DataCon )
+import TyCon   ( TyCon, tyConKind, tyConArity, isSynTyCon )
+import Class   ( Class, classTyCon )
 
 import TcMonad
 
-import Name    ( Name(..), getNameShortName )
-import PprStyle
-import Pretty
-import Unique  ( Unique )
+import BasicTypes      ( Arity )
+import IdInfo          ( vanillaIdInfo )
+import Name            ( Name, OccName, nameOccName, getSrcLoc,
+                         maybeWiredInTyConName, maybeWiredInIdName, isLocallyDefined,
+                         NamedThing(..)
+                       )
+import Unique          ( pprUnique10, Unique, Uniquable(..) )
+import FiniteMap       ( lookupFM, addToFM )
 import UniqFM
-import Util    ( zipWithEqual, zipWith3Equal, zipLazy, panic )
+import Unique          ( Uniquable(..) )
+import Util            ( zipEqual, zipWith3Equal, mapAccumL )
+import Bag             ( bagToList )
+import Maybes          ( maybeToBool, catMaybes )
+import SrcLoc          ( SrcLoc )
+import FastString      ( FastString )
+import Outputable
 \end{code}
 
+%************************************************************************
+%*                                                                     *
+\subsection{TcId}
+%*                                                                     *
+%************************************************************************
+
+
+\begin{code}
+type TcId    = Id                      -- Type may be a TcType
+type TcIdSet = IdSet
+
+tcLookupDataCon :: Name -> TcM s (DataCon, [TcType], TcType)
+tcLookupDataCon con_name
+  = tcLookupValue con_name             `thenNF_Tc` \ con_id ->
+    case isDataConId_maybe con_id of {
+       Nothing -> failWithTc (badCon con_id);
+       Just data_con ->
+
+    tcInstId con_id                    `thenNF_Tc` \ (_, _, con_tau) ->
+            -- Ignore the con_theta; overloaded constructors only
+            -- behave differently when called, not when used for
+            -- matching.
+    let
+       (arg_tys, result_ty) = splitFunTys con_tau
+    in
+    ASSERT( maybeToBool (splitAlgTyConApp_maybe result_ty) )
+    returnTc (data_con, arg_tys, result_ty) }
+
+-- A useful function that takes an occurrence of a global thing
+-- and instantiates its type with fresh type variables
+tcInstId :: Id
+        -> NF_TcM s ([TcTyVar],        -- It's instantiated type
+                     TcThetaType,      --
+                     TcType)           --
+tcInstId id
+  = let
+      (tyvars, rho) = splitForAllTys (unannotTy (idType id))
+    in
+    tcInstTyVars tyvars                `thenNF_Tc` \ (tyvars', arg_tys, tenv) ->
+    let
+       rho'           = substTy tenv rho
+       (theta', tau') = splitRhoTy rho' 
+    in
+    returnNF_Tc (tyvars', theta', tau')
+\end{code}
+
+Between the renamer and the first invocation of the UsageSP inference,
+identifiers read from interface files will have usage information in
+their types, whereas other identifiers will not.  The unannotTy here
+in @tcInstId@ prevents this information from pointlessly propagating
+further prior to the first usage inference.
+
+
+%************************************************************************
+%*                                                                     *
+\subsection{TcEnv}
+%*                                                                     *
+%************************************************************************
+
 Data type declarations
 ~~~~~~~~~~~~~~~~~~~~~
 
 \begin{code}
-data TcEnv s = TcEnv
-                 (TyVarEnv s)
-                 (ValueEnv Id)                 -- Globals
-                 (ValueEnv (TcIdBndr s))       -- Locals
-                 (MutableVar s (TcTyVarSet s)) -- Free type variables of locals
-                                               -- ...why mutable? see notes with tcGetGlobalTyVars
-                 (KindEnv s)                   -- Gives TcKinds of TyCons and Classes
-                 TyConEnv
-                 ClassEnv
-
-type TyVarEnv s  = UniqFM (TcKind s, TyVar)
-type TyConEnv    = UniqFM TyCon
-type KindEnv s   = UniqFM (TcKind s)
-type ClassEnv    = UniqFM Class
-type ValueEnv id = UniqFM id
-
-initEnv :: MutableVar s (TcTyVarSet s) -> TcEnv s
-initEnv mut = TcEnv emptyUFM emptyUFM emptyUFM mut emptyUFM emptyUFM emptyUFM 
-
-getEnv_LocalIds (TcEnv _ _ ls _ _ _ _) = ls
-getEnv_TyCons   (TcEnv _ _ _ _ _ ts _) = ts
-getEnv_Classes  (TcEnv _ _ _ _ _ _ cs) = cs
+data TcEnv = TcEnv
+                  UsageEnv
+                 TypeEnv
+                 ValueEnv 
+                 (TcTyVarSet,          -- The in-scope TyVars
+                  TcRef TcTyVarSet)    -- Free type variables of the value env
+                                       -- ...why mutable? see notes with tcGetGlobalTyVars
+                                       -- Includes the in-scope tyvars
+
+type NameEnv val = UniqFM val          -- Keyed by Names
+
+type UsageEnv   = NameEnv UVar
+type TypeEnv   = NameEnv (TcKind, Maybe Arity, TcTyThing)
+type ValueEnv  = NameEnv Id    
+
+valueEnvIds :: ValueEnv -> [Id]
+valueEnvIds ve = eltsUFM ve
+
+data TcTyThing = ATyVar TcTyVar                -- Mutable only so that the kind can be mutable
+                                       -- if the kind is mutable, the tyvar must be so that
+                                       -- zonking works
+              | ATyCon TyCon
+              | AClass Class
+
+
+initEnv :: TcRef TcTyVarSet -> TcEnv
+initEnv mut = TcEnv emptyUFM emptyUFM emptyUFM (emptyVarSet, mut)
+
+getEnvTyCons  (TcEnv _ te _ _) = [tc | (_, _, ATyCon tc) <- eltsUFM te]
+getEnvClasses (TcEnv _ te _ _) = [cl | (_, _, AClass cl) <- eltsUFM te]
+getAllEnvTyCons (TcEnv _ te _ _) = catMaybes (map gettc (eltsUFM te))
+    where                          
+      gettc (_,_, ATyCon tc) = Just tc
+      gettc (_,_, AClass cl) = Just (classTyCon cl)
+      gettc _                = Nothing
 \end{code}
 
-Making new TcTyVars, with knot tying!
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+The UsageEnv
+~~~~~~~~~~~~
+
+Extending the usage environment.
+
 \begin{code}
-tcTyVarScope :: [Name]                 -- Names of some type variables
-            -> ([TyVar] -> TcM s a)    -- Thing to type check in their scope
-            -> TcM s a                 -- Result
-
-tcTyVarScope tyvar_names thing_inside
-  = newKindVars (length tyvar_names)   `thenNF_Tc` \ tyvar_kinds ->
-
-    fixTc (\ ~(tyvars, _) ->
-               -- Ok to look at kinds, but not tyvars!
-      tcExtendTyVarEnv tyvar_names (tyvar_kinds `zipLazy` tyvars) (
-
-               -- Do the thing inside
-       thing_inside tyvars                     `thenTc` \ result ->
-               -- Get the tyvar's Kinds from their TcKinds
-       mapNF_Tc tcKindToKind tyvar_kinds       `thenNF_Tc` \ tyvar_kinds' ->
-
-               -- Construct the real TyVars
-       let
-         tyvars             = zipWithEqual mk_tyvar tyvar_names tyvar_kinds'
-         mk_tyvar name kind = mkTyVar (getNameShortName name) (getItsUnique name) kind
-       in
-       returnTc (tyvars, result)
-    ))                                 `thenTc` \ (_,result) ->
-    returnTc result
+tcExtendUVarEnv :: Name -> UVar -> TcM s r -> TcM s r
+tcExtendUVarEnv uv_name uv scope
+  = tcGetEnv                                                 `thenNF_Tc` \ (TcEnv ue te ve gtvs) ->
+    tcSetEnv (TcEnv (addToUFM ue uv_name uv) te ve gtvs) scope
 \end{code}
 
+Looking up in the environments.
+
+\begin{code}
+tcLookupUVar :: Name -> NF_TcM s UVar
+tcLookupUVar uv_name
+  = tcGetEnv   `thenNF_Tc` \ (TcEnv ue te ve gtvs) ->
+    case lookupUFM ue uv_name of
+      Just uv -> returnNF_Tc uv
+      Nothing -> failWithTc (uvNameOutOfScope uv_name)
+\end{code}     
+
 
-The Kind, TyVar, Class and TyCon envs
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+The TypeEnv
+~~~~~~~~~~~~
 
-Extending the environments
+Extending the type environment. 
 
 \begin{code}
-tcExtendKindEnv :: [Name] -> [TcKind s] -> TcM s r -> TcM s r
-tcExtendKindEnv names kinds scope
-  = tcGetEnv           `thenNF_Tc` \ (TcEnv tve gve lve gtvs ke tce ce) ->
+tcExtendTyVarEnv :: [TyVar] -> TcM s r -> TcM s r
+tcExtendTyVarEnv tyvars scope
+  = tcGetEnv                           `thenNF_Tc` \ (TcEnv ue te ve (in_scope_tvs, gtvs)) ->
     let
-       ke' = addListToUFM ke (names `zip` kinds)
+       extend_list = [ (getName tv, (kindToTcKind (tyVarKind tv), Nothing, ATyVar tv))
+                     | tv <- tyvars
+                     ]
+       te'           = addListToUFM te extend_list
+       new_tv_set    = mkVarSet tyvars
+       in_scope_tvs' = in_scope_tvs `unionVarSet` new_tv_set
     in
-    tcSetEnv (TcEnv tve gve lve gtvs ke' tce ce) scope
-
-tcExtendTyVarEnv :: [Name] -> [(TcKind s, TyVar)] -> TcM s r -> TcM s r
-tcExtendTyVarEnv tyvar_names kinds_w_tyvars scope
-  = tcGetEnv           `thenNF_Tc` \ (TcEnv tve gve lve gtvs ke tce ce) ->
+       -- It's important to add the in-scope tyvars to the global tyvar set
+       -- as well.  Consider
+       --      f (x::r) = let g y = y::r in ...
+       -- Here, g mustn't be generalised.  This is also important during
+       -- class and instance decls, when we mustn't generalise the class tyvars
+       -- when typechecking the methods.
+    tc_extend_gtvs gtvs new_tv_set             `thenNF_Tc` \ gtvs' ->
+    tcSetEnv (TcEnv ue te' ve (in_scope_tvs', gtvs')) scope
+
+-- This variant, tcExtendTyVarEnvForMeths, takes *two* bunches of tyvars:
+--     the signature tyvars contain the original names
+--     the instance  tyvars are what those names should be mapped to
+-- It's needed when typechecking the method bindings of class and instance decls
+-- It does *not* extend the global tyvars; tcMethodBind does that for itself
+
+tcExtendTyVarEnvForMeths :: [TyVar] -> [TcTyVar] -> TcM s r -> TcM s r
+tcExtendTyVarEnvForMeths sig_tyvars inst_tyvars thing_inside
+  = tcGetEnv                                   `thenNF_Tc` \ (TcEnv ue te ve gtvs) ->
     let
-       tve' = addListToUFM tve (tyvar_names `zip` kinds_w_tyvars)
+       te' = addListToUFM te stuff
     in
-    tcSetEnv (TcEnv tve' gve lve gtvs ke tce ce) scope
+    tcSetEnv (TcEnv ue te' ve gtvs) thing_inside
+  where
+    stuff = [ (getName sig_tv, (kindToTcKind (tyVarKind inst_tv), Nothing, ATyVar inst_tv))
+           | (sig_tv, inst_tv) <- zipEqual "tcMeth" sig_tyvars inst_tyvars
+           ]
 
-tcExtendTyConEnv tycons scope
-  = tcGetEnv           `thenNF_Tc` \ (TcEnv tve gve lve gtvs ke tce ce) ->
-    let
-       tce' = addListToUFM_Directly tce [(getItsUnique tycon, tycon) | tycon <- tycons]
-    in
-    tcSetEnv (TcEnv tve gve lve gtvs ke tce' ce) scope
+tcExtendGlobalTyVars extra_global_tvs scope
+  = tcGetEnv                                   `thenNF_Tc` \ (TcEnv ue te ve (in_scope,gtvs)) ->
+    tc_extend_gtvs gtvs        extra_global_tvs        `thenNF_Tc` \ gtvs' ->
+    tcSetEnv (TcEnv ue te ve (in_scope,gtvs')) scope
 
-tcExtendClassEnv classes scope
-  = tcGetEnv           `thenNF_Tc` \ (TcEnv tve gve lve gtvs ke tce ce) ->
+tc_extend_gtvs gtvs extra_global_tvs
+  = tcReadMutVar gtvs                  `thenNF_Tc` \ global_tvs ->
     let
-       ce' = addListToUFM_Directly ce [(getItsUnique clas, clas) | clas <- classes]
+       new_global_tyvars = global_tvs `unionVarSet` extra_global_tvs
     in
-    tcSetEnv (TcEnv tve gve lve gtvs ke tce ce') scope
+    tcNewMutVar new_global_tyvars
 \end{code}
 
-
-Looking up in the environments
+@tcGetGlobalTyVars@ returns a fully-zonked set of tyvars free in the environment.
+To improve subsequent calls to the same function it writes the zonked set back into
+the environment.
 
 \begin{code}
-tcLookupTyVar name
-  = tcGetEnv           `thenNF_Tc` \ (TcEnv tve gve lve gtvs ke tce ce) ->
-    returnNF_Tc (lookupWithDefaultUFM tve (panic "tcLookupTyVar") name)
+tcGetGlobalTyVars :: NF_TcM s TcTyVarSet
+tcGetGlobalTyVars
+  = tcGetEnv                                           `thenNF_Tc` \ (TcEnv ue te ve (_,gtvs)) ->
+    tcReadMutVar gtvs                                  `thenNF_Tc` \ global_tvs ->
+    zonkTcTyVars (varSetElems global_tvs)              `thenNF_Tc` \ global_tys' ->
+    let
+       global_tvs' = (tyVarsOfTypes global_tys')
+    in
+    tcWriteMutVar gtvs global_tvs'                     `thenNF_Tc_` 
+    returnNF_Tc global_tvs'
 
+tcGetInScopeTyVars :: NF_TcM s [TcTyVar]
+tcGetInScopeTyVars
+  = tcGetEnv           `thenNF_Tc` \ (TcEnv ue te ve (in_scope_tvs, gtvs)) ->
+    returnNF_Tc (varSetElems in_scope_tvs)
+\end{code}
 
-tcLookupTyCon (WiredInTyCon tc)                -- wired in tycons
-  = returnNF_Tc (kindToTcKind (getTyConKind tc), tc)
 
-tcLookupTyCon name
-  = tcGetEnv           `thenNF_Tc` \ (TcEnv tve gve lve gtvs ke tce ce) ->
+Type constructors and classes
+
+\begin{code}
+tcExtendTypeEnv :: [(Name, (TcKind, Maybe Arity, TcTyThing))] -> TcM s r -> TcM s r
+tcExtendTypeEnv bindings scope
+  = ASSERT( null [tv | (_, (_,_,ATyVar tv)) <- bindings] )
+       -- Not for tyvars; use tcExtendTyVarEnv
+    tcGetEnv                                   `thenNF_Tc` \ (TcEnv ue te ve gtvs) ->
     let
-       tycon = lookupWithDefaultUFM tce (panic "tcLookupTyCon")             name
-       kind  = lookupWithDefaultUFM ke  (kindToTcKind (getTyConKind tycon)) name
-               -- The KE will bind tycon in the current mutually-recursive set.
-               -- If the KE doesn't, then the tycon is already defined, and we
-               -- can safely grab the kind from the TyCon itself
+       te' = addListToUFM te bindings
     in
-    returnNF_Tc (kind,tycon)
+    tcSetEnv (TcEnv ue te' ve gtvs) scope
+\end{code}
 
 
+Looking up in the environments.
+
+\begin{code}
+tcLookupTy :: Name ->  NF_TcM s (TcKind, Maybe Arity, TcTyThing)
+tcLookupTy name
+  = tcGetEnv   `thenNF_Tc` \ (TcEnv ue te ve gtvs) ->
+    case lookupUFM te name of {
+       Just thing -> returnNF_Tc thing ;
+       Nothing    -> 
+
+    case maybeWiredInTyConName name of
+       Just tc -> returnNF_Tc (kindToTcKind (tyConKind tc), maybe_arity, ATyCon tc)
+               where
+                  maybe_arity | isSynTyCon tc = Just (tyConArity tc)
+                              | otherwise     = Nothing 
+
+       Nothing ->      -- This can happen if an interface-file
+                       -- unfolding is screwed up
+                  failWithTc (tyNameOutOfScope name)
+    }
+       
+tcLookupClass :: Name -> NF_TcM s Class
 tcLookupClass name
-  = tcGetEnv           `thenNF_Tc` \ (TcEnv tve gve lve gtvs ke tce ce) ->
-    let
-       clas = lookupWithDefaultUFM ce (panic "tcLookupClass")             name
-       (tyvar, _, _) = getClassSig clas
-       kind = lookupWithDefaultUFM ke (kindToTcKind (getTyVarKind tyvar)) name
-    in
-    returnNF_Tc (kind,clas)
+  = tcLookupTy name    `thenNF_Tc` \ (_, _, AClass clas) ->
+    returnNF_Tc clas
 
-tcLookupClassByKey uniq
-  = tcGetEnv           `thenNF_Tc` \ (TcEnv tve gve lve gtvs ke tce ce) ->
-    let
-       clas = lookupWithDefaultUFM_Directly ce (panic "tcLookupClas") uniq
-    in
-    returnNF_Tc (clas)
+tcLookupTyCon :: Name -> NF_TcM s TyCon
+tcLookupTyCon name
+  = tcLookupTy name    `thenNF_Tc` \ (_, _, ATyCon tycon) ->
+    returnNF_Tc tycon
+
+tcLookupClassByKey :: Unique -> NF_TcM s Class
+tcLookupClassByKey key
+  = tcGetEnv           `thenNF_Tc` \ (TcEnv ue te ve gtvs) ->
+    case lookupUFM_Directly te key of
+       Just (_, _, AClass cl) -> returnNF_Tc cl
+       other                  -> pprPanic "tcLookupClassByKey:" (pprUnique10 key)
+
+tcLookupTyConByKey :: Unique -> NF_TcM s TyCon
+tcLookupTyConByKey key
+  = tcGetEnv           `thenNF_Tc` \ (TcEnv ue te ve gtvs) ->
+    case lookupUFM_Directly te key of
+       Just (_, _, ATyCon tc) -> returnNF_Tc tc
+       other                  -> pprPanic "tcLookupTyConByKey:" (pprUnique10 key)
 \end{code}
 
 
 
-Extending and consulting the value environment
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+%************************************************************************
+%*                                                                     *
+\subsection{The value environment}
+%*                                                                     *
+%************************************************************************
+
 \begin{code}
+tcExtendGlobalValEnv :: [Id] -> TcM s a -> TcM s a
 tcExtendGlobalValEnv ids scope
-  = tcGetEnv           `thenNF_Tc` \ (TcEnv tve gve lve gtvs ke tce ce) ->
+  = tcGetEnv           `thenNF_Tc` \ (TcEnv ue te ve gtvs) ->
     let
-       gve' = addListToUFM_Directly gve [(getItsUnique id, id) | id <- ids]
+       ve' = addListToUFM_Directly ve [(getUnique id, id) | id <- ids]
     in
-    tcSetEnv (TcEnv tve gve' lve gtvs ke tce ce) scope
+    tcSetEnv (TcEnv ue te ve' gtvs) scope
 
-tcExtendLocalValEnv names ids scope
-  = tcGetEnv           `thenNF_Tc` \ (TcEnv tve gve lve gtvs ke tce ce) ->
+tcExtendLocalValEnv :: [(Name,TcId)] -> TcM s a -> TcM s a
+tcExtendLocalValEnv names_w_ids scope
+  = tcGetEnv           `thenNF_Tc` \ (TcEnv ue te ve (in_scope_tvs,gtvs)) ->
     tcReadMutVar gtvs  `thenNF_Tc` \ global_tvs ->
     let
-       lve' = addListToUFM lve (names `zip` ids)
-       extra_global_tyvars = tyVarsOfTypes (map idType ids)
-       new_global_tyvars   = global_tvs `unionTyVarSets` extra_global_tyvars
+       ve'                 = addListToUFM ve names_w_ids
+       extra_global_tyvars = tyVarsOfTypes (map (idType . snd) names_w_ids)
     in
-    tcNewMutVar new_global_tyvars      `thenNF_Tc` \ gtvs' ->
-
-    tcSetEnv (TcEnv tve gve lve' gtvs' ke tce ce) scope
+    tc_extend_gtvs gtvs extra_global_tyvars    `thenNF_Tc` \ gtvs' ->
+    tcSetEnv (TcEnv ue te ve' (in_scope_tvs,gtvs')) scope
 \end{code}
 
-@tcGetGlobalTyVars@ returns a fully-zonked set of tyvars free in the environment.
-To improve subsequent calls to the same function it writes the zonked set back into
-the environment.
-
-\begin{code}
-tcGetGlobalTyVars :: NF_TcM s (TcTyVarSet s)
-tcGetGlobalTyVars
-  = tcGetEnv                           `thenNF_Tc` \ (TcEnv tve gve lve gtvs ke tce ce) ->
-    tcReadMutVar gtvs                  `thenNF_Tc` \ global_tvs ->
-    zonkTcTyVars global_tvs            `thenNF_Tc` \ global_tvs' ->
-    tcWriteMutVar gtvs global_tvs'     `thenNF_Tc_`
-    returnNF_Tc global_tvs'
-\end{code}
 
 \begin{code}
-tcLookupLocalValue :: Name -> NF_TcM s (Maybe (TcIdBndr s))
-tcLookupLocalValue name
-  = tcGetEnv           `thenNF_Tc` \ (TcEnv tve gve lve gtvs ke tce ce) ->
-    returnNF_Tc (lookupUFM lve name)
-
-tcLookupLocalValueOK :: String -> Name -> NF_TcM s (TcIdBndr s)
-tcLookupLocalValueOK err name
-  = tcGetEnv           `thenNF_Tc` \ (TcEnv tve gve lve gtvs ke tce ce) ->
-    returnNF_Tc (lookupWithDefaultUFM lve (panic err) name)
-
-
-tcLookupGlobalValue :: Name -> NF_TcM s Id
-
-tcLookupGlobalValue (WiredInVal id)    -- wired in ids
-  = returnNF_Tc id
-
-tcLookupGlobalValue name
-  = tcGetEnv           `thenNF_Tc` \ (TcEnv tve gve lve gtvs ke tce ce) ->
-    returnNF_Tc (lookupWithDefaultUFM gve def name)
+tcLookupValue :: Name -> NF_TcM s Id   -- Panics if not found
+tcLookupValue name
+  = case maybeWiredInIdName name of
+       Just id -> returnNF_Tc id
+       Nothing -> tcGetEnv             `thenNF_Tc` \ (TcEnv ue te ve gtvs) ->
+                  returnNF_Tc (lookupWithDefaultUFM ve def name)
+  where
+    def = pprPanic "tcLookupValue:" (ppr name)
+
+tcLookupValueMaybe :: Name -> NF_TcM s (Maybe Id)
+tcLookupValueMaybe name
+  = case maybeWiredInIdName name of
+       Just id -> returnNF_Tc (Just id)
+       Nothing -> tcGetEnv             `thenNF_Tc` \ (TcEnv ue te ve gtvs) ->
+                  returnNF_Tc (lookupUFM ve name)
+
+tcLookupValueByKey :: Unique -> NF_TcM s Id    -- Panics if not found
+tcLookupValueByKey key
+  = tcGetEnv           `thenNF_Tc` \ (TcEnv ue te ve gtvs) ->
+    returnNF_Tc (explicitLookupValueByKey ve key)
+
+tcLookupValueByKeyMaybe :: Unique -> NF_TcM s (Maybe Id)
+tcLookupValueByKeyMaybe key
+  = tcGetEnv           `thenNF_Tc` \ (TcEnv ue te ve gtvs) ->
+    returnNF_Tc (lookupUFM_Directly ve key)
+
+tcGetValueEnv :: NF_TcM s ValueEnv
+tcGetValueEnv
+  = tcGetEnv           `thenNF_Tc` \ (TcEnv ue te ve gtvs) ->
+    returnNF_Tc ve
+
+tcSetValueEnv :: ValueEnv -> TcM s a -> TcM s a
+tcSetValueEnv ve scope
+  = tcGetEnv           `thenNF_Tc` \ (TcEnv ue te _ gtvs) ->
+    tcSetEnv (TcEnv ue te ve gtvs) scope
+
+-- Non-monadic version, environment given explicitly
+explicitLookupValueByKey :: ValueEnv -> Unique -> Id
+explicitLookupValueByKey ve key
+  = lookupWithDefaultUFM_Directly ve def key
   where
-#ifdef DEBUG
-    def = panic ("tcLookupGlobalValue:" ++ ppShow 1000 (ppr PprDebug name))
-#else
-    def = panic "tcLookupGlobalValue"
-#endif
+    def = pprPanic "lookupValueByKey:" (pprUnique10 key)
+
+explicitLookupValue :: ValueEnv -> Name -> Maybe Id
+explicitLookupValue ve name
+  = case maybeWiredInIdName name of
+       Just id -> Just id
+       Nothing -> lookupUFM ve name
+
+       -- Extract the IdInfo from an IfaceSig imported from an interface file
+tcAddImportedIdInfo :: ValueEnv -> Id -> Id
+tcAddImportedIdInfo unf_env id
+  | isLocallyDefined id                -- Don't look up locally defined Ids, because they
+                               -- have explicit local definitions, so we get a black hole!
+  = id
+  | otherwise
+  = id `lazySetIdInfo` new_info
+       -- The Id must be returned without a data dependency on maybe_id
+  where
+    new_info = -- pprTrace "tcAdd" (ppr id) $
+              case explicitLookupValue unf_env (getName id) of
+                    Nothing          -> vanillaIdInfo
+                    Just imported_id -> idInfo imported_id
+               -- ToDo: could check that types are the same
+\end{code}
 
 
-tcLookupGlobalValueByKey :: Unique -> NF_TcM s Id
-tcLookupGlobalValueByKey uniq
-  = tcGetEnv           `thenNF_Tc` \ (TcEnv tve gve lve gtvs ke tce ce) ->
-    returnNF_Tc (lookupWithDefaultUFM_Directly gve def uniq)
-  where
-#ifdef DEBUG
-    def = panic ("tcLookupGlobalValueByKey:" ++ ppShow 1000 (ppr PprDebug uniq))
-#else
-    def = panic "tcLookupGlobalValueByKey"
-#endif
+%************************************************************************
+%*                                                                     *
+\subsection{Constructing new Ids}
+%*                                                                     *
+%************************************************************************
 
+\begin{code}
+newLocalId :: OccName -> TcType -> SrcLoc -> NF_TcM s TcId
+newLocalId name ty loc
+  = tcGetUnique                `thenNF_Tc` \ uniq ->
+    returnNF_Tc (mkUserLocal name uniq ty loc)
+
+newSpecPragmaId :: Name -> TcType -> NF_TcM s TcId
+newSpecPragmaId name ty 
+  = tcGetUnique                `thenNF_Tc` \ uniq ->
+    returnNF_Tc (mkSpecPragmaId (nameOccName name) uniq ty (getSrcLoc name))
 \end{code}
 
 
-Constructing new Ids
-~~~~~~~~~~~~~~~~~~~~
+%************************************************************************
+%*                                                                     *
+\subsection{Errors}
+%*                                                                     *
+%************************************************************************
 
 \begin{code}
-newMonoIds :: [Name] -> Kind -> ([TcIdBndr s] -> TcM s a) -> TcM s a
-newMonoIds names kind m
-  = newTyVarTys no_of_names kind       `thenNF_Tc` \ tys ->
-    tcGetUniques no_of_names           `thenNF_Tc` \ uniqs ->
-    let
-       new_ids            = zipWith3Equal mk_id names uniqs tys
-       mk_id name uniq ty = mkUserLocal (getOccurrenceName name) uniq ty
-                                        (getSrcLoc name)
-    in
-    tcExtendLocalValEnv names new_ids (m new_ids)
-  where
-    no_of_names = length names
-
-newLocalIds :: [FAST_STRING] -> [TcType s] -> NF_TcM s [TcIdBndr s]
-newLocalIds names tys
-  = tcGetSrcLoc                        `thenNF_Tc` \ loc ->
-    tcGetUniques (length names) `thenNF_Tc` \ uniqs ->
-    let
-       new_ids            = zipWith3Equal mk_id names uniqs tys
-       mk_id name uniq ty = mkUserLocal name uniq ty loc
-    in
-    returnNF_Tc new_ids
-\end{code}
+badCon con_id
+  = quotes (ppr con_id) <+> ptext SLIT("is not a data constructor")
+badPrimOp op
+  = quotes (ppr op) <+> ptext SLIT("is not a primop")
 
+uvNameOutOfScope name
+  = ptext SLIT("UVar") <+> quotes (ppr name) <+> ptext SLIT("is not in scope")
 
+tyNameOutOfScope name
+  = quotes (ppr name) <+> ptext SLIT("is not in scope")
+\end{code}