-%\r
-% (c) The GRASP/AQUA Project, Glasgow University, 1992-1998\r
-%\r
-\section[RnMonad]{The monad used by the renamer}\r
-\r
-\begin{code}\r
-module RnMonad(\r
- module RnMonad,\r
- Module,\r
- FiniteMap,\r
- Bag,\r
- Name,\r
- RdrNameHsDecl,\r
- RdrNameInstDecl,\r
- Version,\r
- NameSet,\r
- OccName,\r
- Fixity\r
- ) where\r
-\r
-#include "HsVersions.h"\r
-\r
-import PrelIOBase ( fixIO ) -- Should be in GlaExts\r
-import IOExts ( IORef, newIORef, readIORef, writeIORef, unsafePerformIO )\r
- \r
-import HsSyn \r
-import RdrHsSyn\r
-import RnHsSyn ( RenamedFixitySig )\r
-import BasicTypes ( Version )\r
-import SrcLoc ( noSrcLoc )\r
-import ErrUtils ( addShortErrLocLine, addShortWarnLocLine,\r
- pprBagOfErrors, ErrMsg, WarnMsg, Message\r
- )\r
-import Name ( Name, OccName, NamedThing(..),\r
- isLocallyDefinedName, nameModule, nameOccName,\r
- decode, mkLocalName\r
- )\r
-import Module ( Module, ModuleName, ModuleHiMap, SearchPath, WhereFrom,\r
- mkModuleHiMaps, moduleName\r
- )\r
-import NameSet \r
-import RdrName ( RdrName, dummyRdrVarName, rdrNameOcc )\r
-import CmdLineOpts ( opt_D_dump_rn_trace, opt_IgnoreIfacePragmas )\r
-import PrelInfo ( builtinNames )\r
-import TysWiredIn ( boolTyCon )\r
-import SrcLoc ( SrcLoc, mkGeneratedSrcLoc )\r
-import Unique ( Unique, getUnique, unboundKey )\r
-import UniqFM ( UniqFM )\r
-import FiniteMap ( FiniteMap, emptyFM, bagToFM, lookupFM, addToFM, addListToFM, \r
- addListToFM_C, addToFM_C, eltsFM, fmToList\r
- )\r
-import Bag ( Bag, mapBag, emptyBag, isEmptyBag, snocBag )\r
-import Maybes ( mapMaybe )\r
-import UniqSet\r
-import UniqFM\r
-import UniqSupply\r
-import Util\r
-import Outputable\r
-\r
-infixr 9 `thenRn`, `thenRn_`\r
-\end{code}\r
-\r
-\r
-%************************************************************************\r
-%* *\r
-\subsection{Somewhat magical interface to other monads}\r
-%* *\r
-%************************************************************************\r
-\r
-\begin{code}\r
-ioToRnM :: IO r -> RnM d (Either IOError r)\r
-ioToRnM io rn_down g_down = (io >>= \ ok -> return (Right ok)) \r
- `catch` \r
- (\ err -> return (Left err))\r
- \r
-traceRn :: SDoc -> RnM d ()\r
-traceRn msg | opt_D_dump_rn_trace = putDocRn msg\r
- | otherwise = returnRn ()\r
-\r
-putDocRn :: SDoc -> RnM d ()\r
-putDocRn msg = ioToRnM (printErrs msg) `thenRn_`\r
- returnRn ()\r
-\end{code}\r
-\r
-\r
-%************************************************************************\r
-%* *\r
-\subsection{Data types}\r
-%* *\r
-%************************************************************************\r
-\r
-===================================================\r
- MONAD TYPES\r
-===================================================\r
-\r
-\begin{code}\r
-type RnM d r = RnDown -> d -> IO r\r
-type RnMS r = RnM SDown r -- Renaming source\r
-type RnMG r = RnM () r -- Getting global names etc\r
-\r
- -- Common part\r
-data RnDown = RnDown {\r
- rn_mod :: ModuleName,\r
- rn_loc :: SrcLoc,\r
- rn_ns :: IORef RnNameSupply,\r
- rn_errs :: IORef (Bag WarnMsg, Bag ErrMsg),\r
- rn_ifaces :: IORef Ifaces,\r
- rn_hi_maps :: (ModuleHiMap, -- for .hi files\r
- ModuleHiMap) -- for .hi-boot files\r
- }\r
-\r
- -- For renaming source code\r
-data SDown = SDown {\r
- rn_mode :: RnMode,\r
-\r
- rn_genv :: GlobalRdrEnv, -- Global envt; the fixity component gets extended\r
- -- with local fixity decls\r
-\r
- rn_lenv :: LocalRdrEnv, -- Local name envt\r
- -- Does *not* includes global name envt; may shadow it\r
- -- Includes both ordinary variables and type variables;\r
- -- they are kept distinct because tyvar have a different\r
- -- occurrence contructor (Name.TvOcc)\r
- -- We still need the unsullied global name env so that\r
- -- we can look up record field names\r
-\r
- rn_fixenv :: FixityEnv -- Local fixities\r
- -- The global ones are held in the\r
- -- rn_ifaces field\r
- }\r
-\r
-data RnMode = SourceMode -- Renaming source code\r
- | InterfaceMode -- Renaming interface declarations. \r
-\end{code}\r
-\r
-===================================================\r
- ENVIRONMENTS\r
-===================================================\r
-\r
-\begin{code}\r
---------------------------------\r
-type RdrNameEnv a = FiniteMap RdrName a\r
-type GlobalRdrEnv = RdrNameEnv [Name] -- The list is because there may be name clashes\r
- -- These only get reported on lookup,\r
- -- not on construction\r
-type LocalRdrEnv = RdrNameEnv Name\r
-\r
-emptyRdrEnv :: RdrNameEnv a\r
-lookupRdrEnv :: RdrNameEnv a -> RdrName -> Maybe a\r
-addListToRdrEnv :: RdrNameEnv a -> [(RdrName,a)] -> RdrNameEnv a\r
-extendRdrEnv :: RdrNameEnv a -> RdrName -> a -> RdrNameEnv a\r
-\r
-emptyRdrEnv = emptyFM\r
-lookupRdrEnv = lookupFM\r
-addListToRdrEnv = addListToFM\r
-rdrEnvElts = eltsFM\r
-extendRdrEnv = addToFM\r
-rdrEnvToList = fmToList\r
-\r
---------------------------------\r
-type NameEnv a = UniqFM a -- Domain is Name\r
-\r
-emptyNameEnv :: NameEnv a\r
-nameEnvElts :: NameEnv a -> [a]\r
-addToNameEnv_C :: (a->a->a) -> NameEnv a -> Name -> a -> NameEnv a\r
-addToNameEnv :: NameEnv a -> Name -> a -> NameEnv a\r
-plusNameEnv :: NameEnv a -> NameEnv a -> NameEnv a\r
-extendNameEnv :: NameEnv a -> [(Name,a)] -> NameEnv a\r
-lookupNameEnv :: NameEnv a -> Name -> Maybe a\r
-delFromNameEnv :: NameEnv a -> Name -> NameEnv a\r
-elemNameEnv :: Name -> NameEnv a -> Bool\r
-\r
-emptyNameEnv = emptyUFM\r
-nameEnvElts = eltsUFM\r
-addToNameEnv_C = addToUFM_C\r
-addToNameEnv = addToUFM\r
-plusNameEnv = plusUFM\r
-extendNameEnv = addListToUFM\r
-lookupNameEnv = lookupUFM\r
-delFromNameEnv = delFromUFM\r
-elemNameEnv = elemUFM\r
-\r
---------------------------------\r
-type FixityEnv = NameEnv RenamedFixitySig\r
- -- We keep the whole fixity sig so that we\r
- -- can report line-number info when there is a duplicate\r
- -- fixity declaration\r
-\end{code}\r
-\r
-\begin{code}\r
---------------------------------\r
-type RnNameSupply\r
- = ( UniqSupply\r
-\r
- , FiniteMap (OccName, OccName) Int\r
- -- This is used as a name supply for dictionary functions\r
- -- From the inst decl we derive a (class, tycon) pair;\r
- -- this map then gives a unique int for each inst decl with that\r
- -- (class, tycon) pair. (In Haskell 98 there can only be one,\r
- -- but not so in more extended versions.)\r
- -- \r
- -- We could just use one Int for all the instance decls, but this\r
- -- way the uniques change less when you add an instance decl, \r
- -- hence less recompilation\r
-\r
- , FiniteMap (ModuleName, OccName) Name\r
- -- Ensures that one (module,occname) pair gets one unique\r
- )\r
-\r
-\r
---------------------------------\r
-data ExportEnv = ExportEnv Avails Fixities\r
-type Avails = [AvailInfo]\r
-type Fixities = [(Name, Fixity)]\r
-\r
-type ExportAvails = (FiniteMap ModuleName Avails, -- Used to figure out "module M" export specifiers\r
- -- Includes avails only from *unqualified* imports\r
- -- (see 1.4 Report Section 5.1.1)\r
-\r
- NameEnv AvailInfo) -- Used to figure out all other export specifiers.\r
- -- Maps a Name to the AvailInfo that contains it\r
-\r
-\r
-data GenAvailInfo name = Avail name -- An ordinary identifier\r
- | AvailTC name -- The name of the type or class\r
- [name] -- The available pieces of type/class. NB: If the type or\r
- -- class is itself to be in scope, it must be in this list.\r
- -- Thus, typically: AvailTC Eq [Eq, ==, /=]\r
-type AvailInfo = GenAvailInfo Name\r
-type RdrAvailInfo = GenAvailInfo OccName\r
-\end{code}\r
-\r
-===================================================\r
- INTERFACE FILE STUFF\r
-===================================================\r
-\r
-\begin{code}\r
-type ExportItem = (ModuleName, [RdrAvailInfo])\r
-type VersionInfo name = [ImportVersion name]\r
-\r
-type ImportVersion name = (ModuleName, Version, WhetherHasOrphans, WhatsImported name)\r
-\r
-type WhetherHasOrphans = Bool\r
- -- An "orphan" is \r
- -- * an instance decl in a module other than the defn module for \r
- -- one of the tycons or classes in the instance head\r
- -- * a transformation rule in a module other than the one defining\r
- -- the function in the head of the rule.\r
-\r
-data WhatsImported name = Everything \r
- | Specifically [LocalVersion name] -- List guaranteed non-empty\r
-\r
- -- ("M", hif, ver, Everything) means there was a "module M" in \r
- -- this module's export list, so we just have to go by M's version, "ver",\r
- -- not the list of LocalVersions.\r
-\r
-\r
-type LocalVersion name = (name, Version)\r
-\r
-data ParsedIface\r
- = ParsedIface {\r
- pi_mod :: Version, -- Module version number\r
- pi_orphan :: WhetherHasOrphans, -- Whether this module has orphans\r
- pi_usages :: [ImportVersion OccName], -- Usages\r
- pi_exports :: [ExportItem], -- Exports\r
- pi_decls :: [(Version, RdrNameHsDecl)], -- Local definitions\r
- pi_insts :: [RdrNameInstDecl], -- Local instance declarations\r
- pi_rules :: [RdrNameRuleDecl] -- Rules\r
- }\r
-\r
-type InterfaceDetails = (WhetherHasOrphans,\r
- VersionInfo Name, -- Version information for what this module imports\r
- ExportEnv) -- What modules this one depends on\r
-\r
-\r
--- needed by Main to fish out the fixities assoc list.\r
-getIfaceFixities :: InterfaceDetails -> Fixities\r
-getIfaceFixities (_, _, ExportEnv _ fs) = fs\r
-\r
-\r
-type RdrNamePragma = () -- Fudge for now\r
--------------------\r
-\r
-data Ifaces = Ifaces {\r
- iImpModInfo :: ImportedModuleInfo,\r
- -- Modules this one depends on: that is, the union \r
- -- of the modules its direct imports depend on.\r
-\r
- iDecls :: DeclsMap, -- A single, global map of Names to decls\r
-\r
- iFixes :: FixityEnv, -- A single, global map of Names to fixities\r
-\r
- iSlurp :: NameSet, -- All the names (whether "big" or "small", whether wired-in or not,\r
- -- whether locally defined or not) that have been slurped in so far.\r
-\r
- iVSlurp :: [(Name,Version)], -- All the (a) non-wired-in (b) "big" (c) non-locally-defined \r
- -- names that have been slurped in so far, with their versions. \r
- -- This is used to generate the "usage" information for this module.\r
- -- Subset of the previous field.\r
-\r
- iInsts :: Bag GatedDecl,\r
- -- The as-yet un-slurped instance decls; this bag is depleted when we\r
- -- slurp an instance decl so that we don't slurp the same one twice.\r
- -- Each is 'gated' by the names that must be available before\r
- -- this instance decl is needed.\r
-\r
- iRules :: Bag GatedDecl\r
- -- Ditto transformation rules\r
- }\r
-\r
-type GatedDecl = (NameSet, (Module, RdrNameHsDecl))\r
-\r
-type ImportedModuleInfo \r
- = FiniteMap ModuleName (Version, Bool, Maybe (Module, Bool, Avails))\r
- -- Suppose the domain element is module 'A'\r
- --\r
- -- The first Bool is True if A contains \r
- -- 'orphan' rules or instance decls\r
-\r
- -- The second Bool is true if the interface file actually\r
- -- read was an .hi-boot file\r
-\r
- -- Nothing => A's interface not yet read, but this module has\r
- -- imported a module, B, that itself depends on A\r
- --\r
- -- Just xx => A's interface has been read. The Module in \r
- -- the Just has the correct Dll flag\r
-\r
- -- This set is used to decide whether to look for\r
- -- A.hi or A.hi-boot when importing A.f.\r
- -- Basically, we look for A.hi if A is in the map, and A.hi-boot\r
- -- otherwise\r
-\r
-type DeclsMap = NameEnv (Version, AvailInfo, Bool, (Module, RdrNameHsDecl))\r
- -- A DeclsMap contains a binding for each Name in the declaration\r
- -- including the constructors of a type decl etc.\r
- -- The Bool is True just for the 'main' Name.\r
-\end{code}\r
-\r
-\r
-%************************************************************************\r
-%* *\r
-\subsection{Main monad code}\r
-%* *\r
-%************************************************************************\r
-\r
-\begin{code}\r
-initRn :: ModuleName -> UniqSupply -> SearchPath -> SrcLoc\r
- -> RnMG r\r
- -> IO (r, Bag ErrMsg, Bag WarnMsg)\r
-\r
-initRn mod us dirs loc do_rn = do\r
- himaps <- mkModuleHiMaps dirs\r
- names_var <- newIORef (us, emptyFM, builtins)\r
- errs_var <- newIORef (emptyBag,emptyBag)\r
- iface_var <- newIORef emptyIfaces \r
- let\r
- rn_down = RnDown { rn_loc = loc, rn_ns = names_var, \r
- rn_errs = errs_var, \r
- rn_hi_maps = himaps, \r
- rn_ifaces = iface_var,\r
- rn_mod = mod }\r
-\r
- -- do the business\r
- res <- do_rn rn_down ()\r
-\r
- -- grab errors and return\r
- (warns, errs) <- readIORef errs_var\r
-\r
- return (res, errs, warns)\r
-\r
-\r
-initRnMS :: GlobalRdrEnv -> FixityEnv -> RnMode -> RnMS r -> RnM d r\r
-initRnMS rn_env fixity_env mode thing_inside rn_down g_down\r
- = let\r
- s_down = SDown { rn_genv = rn_env, rn_lenv = emptyRdrEnv, \r
- rn_fixenv = fixity_env, rn_mode = mode }\r
- in\r
- thing_inside rn_down s_down\r
-\r
-initIfaceRnMS :: Module -> RnMS r -> RnM d r\r
-initIfaceRnMS mod thing_inside \r
- = initRnMS emptyRdrEnv emptyNameEnv InterfaceMode $\r
- setModuleRn (moduleName mod) thing_inside\r
-\r
-emptyIfaces :: Ifaces\r
-emptyIfaces = Ifaces { iImpModInfo = emptyFM,\r
- iDecls = emptyNameEnv,\r
- iFixes = emptyNameEnv,\r
- iSlurp = unitNameSet (mkUnboundName dummyRdrVarName),\r
- -- Pretend that the dummy unbound name has already been\r
- -- slurped. This is what's returned for an out-of-scope name,\r
- -- and we don't want thereby to try to suck it in!\r
- iVSlurp = [],\r
- iInsts = emptyBag,\r
- iRules = emptyBag\r
- }\r
-\r
--- mkUnboundName makes a place-holder Name; it shouldn't be looked at except possibly\r
--- during compiler debugging.\r
-mkUnboundName :: RdrName -> Name\r
-mkUnboundName rdr_name = mkLocalName unboundKey (rdrNameOcc rdr_name) noSrcLoc\r
-\r
-isUnboundName :: Name -> Bool\r
-isUnboundName name = getUnique name == unboundKey\r
-\r
-builtins :: FiniteMap (ModuleName,OccName) Name\r
-builtins = \r
- bagToFM (\r
- mapBag (\ name -> ((moduleName (nameModule name), nameOccName name), name))\r
- builtinNames)\r
-\end{code}\r
-\r
-@renameSourceCode@ is used to rename stuff "out-of-line"; that is, not as part of\r
-the main renamer. Sole examples: derived definitions, which are only generated\r
-in the type checker.\r
-\r
-The @RnNameSupply@ includes a @UniqueSupply@, so if you call it more than\r
-once you must either split it, or install a fresh unique supply.\r
-\r
-\begin{code}\r
-renameSourceCode :: ModuleName\r
- -> RnNameSupply\r
- -> RnMS r\r
- -> r\r
-\r
-renameSourceCode mod_name name_supply m\r
- = unsafePerformIO (\r
- -- It's not really unsafe! When renaming source code we\r
- -- only do any I/O if we need to read in a fixity declaration;\r
- -- and that doesn't happen in pragmas etc\r
-\r
- newIORef name_supply >>= \ names_var ->\r
- newIORef (emptyBag,emptyBag) >>= \ errs_var ->\r
- let\r
- rn_down = RnDown { rn_loc = mkGeneratedSrcLoc, rn_ns = names_var,\r
- rn_errs = errs_var,\r
- rn_mod = mod_name }\r
- s_down = SDown { rn_mode = InterfaceMode, -- So that we can refer to PrelBase.True etc\r
- rn_genv = emptyRdrEnv, rn_lenv = emptyRdrEnv,\r
- rn_fixenv = emptyNameEnv }\r
- in\r
- m rn_down s_down >>= \ result ->\r
- \r
- readIORef errs_var >>= \ (warns,errs) ->\r
-\r
- (if not (isEmptyBag errs) then\r
- pprTrace "Urk! renameSourceCode found errors" (display errs) \r
-#ifdef DEBUG\r
- else if not (isEmptyBag warns) then\r
- pprTrace "Note: renameSourceCode found warnings" (display warns)\r
-#endif\r
- else\r
- id) $\r
-\r
- return result\r
- )\r
- where\r
- display errs = pprBagOfErrors errs\r
-\r
-{-# INLINE thenRn #-}\r
-{-# INLINE thenRn_ #-}\r
-{-# INLINE returnRn #-}\r
-{-# INLINE andRn #-}\r
-\r
-returnRn :: a -> RnM d a\r
-thenRn :: RnM d a -> (a -> RnM d b) -> RnM d b\r
-thenRn_ :: RnM d a -> RnM d b -> RnM d b\r
-andRn :: (a -> a -> a) -> RnM d a -> RnM d a -> RnM d a\r
-mapRn :: (a -> RnM d b) -> [a] -> RnM d [b]\r
-mapRn_ :: (a -> RnM d b) -> [a] -> RnM d ()\r
-mapMaybeRn :: (a -> RnM d (Maybe b)) -> [a] -> RnM d [b]\r
-sequenceRn :: [RnM d a] -> RnM d [a]\r
-foldlRn :: (b -> a -> RnM d b) -> b -> [a] -> RnM d b\r
-mapAndUnzipRn :: (a -> RnM d (b,c)) -> [a] -> RnM d ([b],[c])\r
-fixRn :: (a -> RnM d a) -> RnM d a\r
-\r
-returnRn v gdown ldown = return v\r
-thenRn m k gdown ldown = m gdown ldown >>= \ r -> k r gdown ldown\r
-thenRn_ m k gdown ldown = m gdown ldown >> k gdown ldown\r
-fixRn m gdown ldown = fixIO (\r -> m r gdown ldown)\r
-andRn combiner m1 m2 gdown ldown\r
- = m1 gdown ldown >>= \ res1 ->\r
- m2 gdown ldown >>= \ res2 ->\r
- return (combiner res1 res2)\r
-\r
-sequenceRn [] = returnRn []\r
-sequenceRn (m:ms) = m `thenRn` \ r ->\r
- sequenceRn ms `thenRn` \ rs ->\r
- returnRn (r:rs)\r
-\r
-mapRn f [] = returnRn []\r
-mapRn f (x:xs)\r
- = f x `thenRn` \ r ->\r
- mapRn f xs `thenRn` \ rs ->\r
- returnRn (r:rs)\r
-\r
-mapRn_ f [] = returnRn ()\r
-mapRn_ f (x:xs) = \r
- f x `thenRn_`\r
- mapRn_ f xs\r
-\r
-foldlRn k z [] = returnRn z\r
-foldlRn k z (x:xs) = k z x `thenRn` \ z' ->\r
- foldlRn k z' xs\r
-\r
-mapAndUnzipRn f [] = returnRn ([],[])\r
-mapAndUnzipRn f (x:xs)\r
- = f x `thenRn` \ (r1, r2) ->\r
- mapAndUnzipRn f xs `thenRn` \ (rs1, rs2) ->\r
- returnRn (r1:rs1, r2:rs2)\r
-\r
-mapAndUnzip3Rn f [] = returnRn ([],[],[])\r
-mapAndUnzip3Rn f (x:xs)\r
- = f x `thenRn` \ (r1, r2, r3) ->\r
- mapAndUnzip3Rn f xs `thenRn` \ (rs1, rs2, rs3) ->\r
- returnRn (r1:rs1, r2:rs2, r3:rs3)\r
-\r
-mapMaybeRn f [] = returnRn []\r
-mapMaybeRn f (x:xs) = f x `thenRn` \ maybe_r ->\r
- mapMaybeRn f xs `thenRn` \ rs ->\r
- case maybe_r of\r
- Nothing -> returnRn rs\r
- Just r -> returnRn (r:rs)\r
-\end{code}\r
-\r
-\r
-\r
-%************************************************************************\r
-%* *\r
-\subsection{Boring plumbing for common part}\r
-%* *\r
-%************************************************************************\r
-\r
-\r
-================ Errors and warnings =====================\r
-\r
-\begin{code}\r
-failWithRn :: a -> Message -> RnM d a\r
-failWithRn res msg (RnDown {rn_errs = errs_var, rn_loc = loc}) l_down\r
- = readIORef errs_var >>= \ (warns,errs) ->\r
- writeIORef errs_var (warns, errs `snocBag` err) >> \r
- return res\r
- where\r
- err = addShortErrLocLine loc msg\r
-\r
-warnWithRn :: a -> Message -> RnM d a\r
-warnWithRn res msg (RnDown {rn_errs = errs_var, rn_loc = loc}) l_down\r
- = readIORef errs_var >>= \ (warns,errs) ->\r
- writeIORef errs_var (warns `snocBag` warn, errs) >> \r
- return res\r
- where\r
- warn = addShortWarnLocLine loc msg\r
-\r
-addErrRn :: Message -> RnM d ()\r
-addErrRn err = failWithRn () err\r
-\r
-checkRn :: Bool -> Message -> RnM d () -- Check that a condition is true\r
-checkRn False err = addErrRn err\r
-checkRn True err = returnRn ()\r
-\r
-warnCheckRn :: Bool -> Message -> RnM d () -- Check that a condition is true\r
-warnCheckRn False err = addWarnRn err\r
-warnCheckRn True err = returnRn ()\r
-\r
-addWarnRn :: Message -> RnM d ()\r
-addWarnRn warn = warnWithRn () warn\r
-\r
-checkErrsRn :: RnM d Bool -- True <=> no errors so far\r
-checkErrsRn (RnDown {rn_errs = errs_var}) l_down\r
- = readIORef errs_var >>= \ (warns,errs) ->\r
- return (isEmptyBag errs)\r
-\end{code}\r
-\r
-\r
-================ Source location =====================\r
-\r
-\begin{code}\r
-pushSrcLocRn :: SrcLoc -> RnM d a -> RnM d a\r
-pushSrcLocRn loc' m down l_down\r
- = m (down {rn_loc = loc'}) l_down\r
-\r
-getSrcLocRn :: RnM d SrcLoc\r
-getSrcLocRn down l_down\r
- = return (rn_loc down)\r
-\end{code}\r
-\r
-================ Name supply =====================\r
-\r
-\begin{code}\r
-getNameSupplyRn :: RnM d RnNameSupply\r
-getNameSupplyRn rn_down l_down\r
- = readIORef (rn_ns rn_down)\r
-\r
-setNameSupplyRn :: RnNameSupply -> RnM d ()\r
-setNameSupplyRn names' (RnDown {rn_ns = names_var}) l_down\r
- = writeIORef names_var names'\r
-\r
--- See comments with RnNameSupply above.\r
-newInstUniq :: (OccName, OccName) -> RnM d Int\r
-newInstUniq key (RnDown {rn_ns = names_var}) l_down\r
- = readIORef names_var >>= \ (us, mapInst, cache) ->\r
- let\r
- uniq = case lookupFM mapInst key of\r
- Just x -> x+1\r
- Nothing -> 0\r
- mapInst' = addToFM mapInst key uniq\r
- in\r
- writeIORef names_var (us, mapInst', cache) >>\r
- return uniq\r
-\r
-getUniqRn :: RnM d Unique\r
-getUniqRn (RnDown {rn_ns = names_var}) l_down\r
- = readIORef names_var >>= \ (us, mapInst, cache) ->\r
- let\r
- (us1,us') = splitUniqSupply us\r
- in\r
- writeIORef names_var (us', mapInst, cache) >>\r
- return (uniqFromSupply us1)\r
-\end{code}\r
-\r
-================ Module =====================\r
-\r
-\begin{code}\r
-getModuleRn :: RnM d ModuleName\r
-getModuleRn (RnDown {rn_mod = mod_name}) l_down\r
- = return mod_name\r
-\r
-setModuleRn :: ModuleName -> RnM d a -> RnM d a\r
-setModuleRn new_mod enclosed_thing rn_down l_down\r
- = enclosed_thing (rn_down {rn_mod = new_mod}) l_down\r
-\end{code}\r
-\r
-\r
-%************************************************************************\r
-%* *\r
-\subsection{Plumbing for rename-source part}\r
-%* *\r
-%************************************************************************\r
-\r
-================ RnEnv =====================\r
-\r
-\begin{code}\r
-getNameEnvs :: RnMS (GlobalRdrEnv, LocalRdrEnv)\r
-getNameEnvs rn_down (SDown {rn_genv = global_env, rn_lenv = local_env})\r
- = return (global_env, local_env)\r
-\r
-getLocalNameEnv :: RnMS LocalRdrEnv\r
-getLocalNameEnv rn_down (SDown {rn_lenv = local_env})\r
- = return local_env\r
-\r
-setLocalNameEnv :: LocalRdrEnv -> RnMS a -> RnMS a\r
-setLocalNameEnv local_env' m rn_down l_down\r
- = m rn_down (l_down {rn_lenv = local_env'})\r
-\r
-getFixityEnv :: RnMS FixityEnv\r
-getFixityEnv rn_down (SDown {rn_fixenv = fixity_env})\r
- = return fixity_env\r
-\r
-extendFixityEnv :: [(Name, RenamedFixitySig)] -> RnMS a -> RnMS a\r
-extendFixityEnv fixes enclosed_scope\r
- rn_down l_down@(SDown {rn_fixenv = fixity_env})\r
- = let\r
- new_fixity_env = extendNameEnv fixity_env fixes\r
- in\r
- enclosed_scope rn_down (l_down {rn_fixenv = new_fixity_env})\r
-\end{code}\r
-\r
-================ Mode =====================\r
-\r
-\begin{code}\r
-getModeRn :: RnMS RnMode\r
-getModeRn rn_down (SDown {rn_mode = mode})\r
- = return mode\r
-\r
-setModeRn :: RnMode -> RnMS a -> RnMS a\r
-setModeRn new_mode thing_inside rn_down l_down\r
- = thing_inside rn_down (l_down {rn_mode = new_mode})\r
-\end{code}\r
-\r
-\r
-%************************************************************************\r
-%* *\r
-\subsection{Plumbing for rename-globals part}\r
-%* *\r
-%************************************************************************\r
-\r
-\begin{code}\r
-getIfacesRn :: RnM d Ifaces\r
-getIfacesRn (RnDown {rn_ifaces = iface_var}) _\r
- = readIORef iface_var\r
-\r
-setIfacesRn :: Ifaces -> RnM d ()\r
-setIfacesRn ifaces (RnDown {rn_ifaces = iface_var}) _\r
- = writeIORef iface_var ifaces\r
-\r
-getHiMaps :: RnM d (ModuleHiMap, ModuleHiMap)\r
-getHiMaps (RnDown {rn_hi_maps = himaps}) _ \r
- = return himaps\r
-\end{code}\r
+%
+% (c) The GRASP/AQUA Project, Glasgow University, 1992-1998
+%
+\section[RnMonad]{The monad used by the renamer}
+
+\begin{code}
+module RnMonad(
+ module RnMonad,
+ Module,
+ FiniteMap,
+ Bag,
+ Name,
+ RdrNameHsDecl,
+ RdrNameInstDecl,
+ Version,
+ NameSet,
+ OccName,
+ Fixity
+ ) where
+
+#include "HsVersions.h"
+
+import PrelIOBase ( fixIO ) -- Should be in GlaExts
+import IOExts ( IORef, newIORef, readIORef, writeIORef, unsafePerformIO )
+
+import HsSyn
+import RdrHsSyn
+import RnHsSyn ( RenamedFixitySig )
+import BasicTypes ( Version )
+import SrcLoc ( noSrcLoc )
+import ErrUtils ( addShortErrLocLine, addShortWarnLocLine,
+ pprBagOfErrors, ErrMsg, WarnMsg, Message
+ )
+import Name ( Name, OccName, NamedThing(..),
+ isLocallyDefinedName, nameModule, nameOccName,
+ decode, mkLocalName
+ )
+import Module ( Module, ModuleName, ModuleHiMap, SearchPath, WhereFrom,
+ mkModuleHiMaps, moduleName
+ )
+import NameSet
+import RdrName ( RdrName, dummyRdrVarName, rdrNameOcc )
+import CmdLineOpts ( opt_D_dump_rn_trace, opt_IgnoreIfacePragmas )
+import PrelInfo ( builtinNames )
+import TysWiredIn ( boolTyCon )
+import SrcLoc ( SrcLoc, mkGeneratedSrcLoc )
+import Unique ( Unique, getUnique, unboundKey )
+import UniqFM ( UniqFM )
+import FiniteMap ( FiniteMap, emptyFM, bagToFM, lookupFM, addToFM, addListToFM,
+ addListToFM_C, addToFM_C, eltsFM, fmToList
+ )
+import Bag ( Bag, mapBag, emptyBag, isEmptyBag, snocBag )
+import Maybes ( mapMaybe )
+import UniqSet
+import UniqFM
+import UniqSupply
+import Util
+import Outputable
+
+infixr 9 `thenRn`, `thenRn_`
+\end{code}
+
+
+%************************************************************************
+%* *
+\subsection{Somewhat magical interface to other monads}
+%* *
+%************************************************************************
+
+\begin{code}
+ioToRnM :: IO r -> RnM d (Either IOError r)
+ioToRnM io rn_down g_down = (io >>= \ ok -> return (Right ok))
+ `catch`
+ (\ err -> return (Left err))
+
+traceRn :: SDoc -> RnM d ()
+traceRn msg | opt_D_dump_rn_trace = putDocRn msg
+ | otherwise = returnRn ()
+
+putDocRn :: SDoc -> RnM d ()
+putDocRn msg = ioToRnM (printErrs msg) `thenRn_`
+ returnRn ()
+\end{code}
+
+
+%************************************************************************
+%* *
+\subsection{Data types}
+%* *
+%************************************************************************
+
+%===================================================
+\subsubsection{ MONAD TYPES}
+%===================================================
+
+\begin{code}
+type RnM d r = RnDown -> d -> IO r
+type RnMS r = RnM SDown r -- Renaming source
+type RnMG r = RnM () r -- Getting global names etc
+
+ -- Common part
+data RnDown = RnDown {
+ rn_mod :: ModuleName,
+ rn_loc :: SrcLoc,
+ rn_ns :: IORef RnNameSupply,
+ rn_errs :: IORef (Bag WarnMsg, Bag ErrMsg),
+ rn_ifaces :: IORef Ifaces,
+ rn_hi_maps :: (ModuleHiMap, -- for .hi files
+ ModuleHiMap) -- for .hi-boot files
+ }
+
+ -- For renaming source code
+data SDown = SDown {
+ rn_mode :: RnMode,
+
+ rn_genv :: GlobalRdrEnv,
+ -- Global envt; the fixity component gets extended
+ -- with local fixity decls
+
+ rn_lenv :: LocalRdrEnv, -- Local name envt
+ -- Does *not* include global name envt; may shadow it
+ -- Includes both ordinary variables and type variables;
+ -- they are kept distinct because tyvar have a different
+ -- occurrence contructor (Name.TvOcc)
+ -- We still need the unsullied global name env so that
+ -- we can look up record field names
+
+ rn_fixenv :: FixityEnv -- Local fixities
+ -- The global ones are held in the
+ -- rn_ifaces field
+ }
+
+data RnMode = SourceMode -- Renaming source code
+ | InterfaceMode -- Renaming interface declarations.
+\end{code}
+
+%===================================================
+\subsubsection{ ENVIRONMENTS}
+%===================================================
+
+\begin{code}
+--------------------------------
+type RdrNameEnv a = FiniteMap RdrName a
+type GlobalRdrEnv = RdrNameEnv [Name] -- The list is because there may be name clashes
+ -- These only get reported on lookup,
+ -- not on construction
+type LocalRdrEnv = RdrNameEnv Name
+
+emptyRdrEnv :: RdrNameEnv a
+lookupRdrEnv :: RdrNameEnv a -> RdrName -> Maybe a
+addListToRdrEnv :: RdrNameEnv a -> [(RdrName,a)] -> RdrNameEnv a
+extendRdrEnv :: RdrNameEnv a -> RdrName -> a -> RdrNameEnv a
+
+emptyRdrEnv = emptyFM
+lookupRdrEnv = lookupFM
+addListToRdrEnv = addListToFM
+rdrEnvElts = eltsFM
+extendRdrEnv = addToFM
+rdrEnvToList = fmToList
+
+--------------------------------
+type NameEnv a = UniqFM a -- Domain is Name
+
+emptyNameEnv :: NameEnv a
+nameEnvElts :: NameEnv a -> [a]
+addToNameEnv_C :: (a->a->a) -> NameEnv a -> Name -> a -> NameEnv a
+addToNameEnv :: NameEnv a -> Name -> a -> NameEnv a
+plusNameEnv :: NameEnv a -> NameEnv a -> NameEnv a
+extendNameEnv :: NameEnv a -> [(Name,a)] -> NameEnv a
+lookupNameEnv :: NameEnv a -> Name -> Maybe a
+delFromNameEnv :: NameEnv a -> Name -> NameEnv a
+elemNameEnv :: Name -> NameEnv a -> Bool
+
+emptyNameEnv = emptyUFM
+nameEnvElts = eltsUFM
+addToNameEnv_C = addToUFM_C
+addToNameEnv = addToUFM
+plusNameEnv = plusUFM
+extendNameEnv = addListToUFM
+lookupNameEnv = lookupUFM
+delFromNameEnv = delFromUFM
+elemNameEnv = elemUFM
+
+--------------------------------
+type FixityEnv = NameEnv RenamedFixitySig
+ -- We keep the whole fixity sig so that we
+ -- can report line-number info when there is a duplicate
+ -- fixity declaration
+\end{code}
+
+\begin{code}
+--------------------------------
+type RnNameSupply
+ = ( UniqSupply
+
+ , FiniteMap (OccName, OccName) Int
+ -- This is used as a name supply for dictionary functions
+ -- From the inst decl we derive a (class, tycon) pair;
+ -- this map then gives a unique int for each inst decl with that
+ -- (class, tycon) pair. (In Haskell 98 there can only be one,
+ -- but not so in more extended versions.)
+ --
+ -- We could just use one Int for all the instance decls, but this
+ -- way the uniques change less when you add an instance decl,
+ -- hence less recompilation
+
+ , FiniteMap (ModuleName, OccName) Name
+ -- Ensures that one (module,occname) pair gets one unique
+ )
+
+
+--------------------------------
+data ExportEnv = ExportEnv Avails Fixities
+type Avails = [AvailInfo]
+type Fixities = [(Name, Fixity)]
+
+type ExportAvails = (FiniteMap ModuleName Avails,
+ -- Used to figure out "module M" export specifiers
+ -- Includes avails only from *unqualified* imports
+ -- (see 1.4 Report Section 5.1.1)
+
+ NameEnv AvailInfo) -- Used to figure out all other export specifiers.
+ -- Maps a Name to the AvailInfo that contains it
+
+
+data GenAvailInfo name = Avail name -- An ordinary identifier
+ | AvailTC name -- The name of the type or class
+ [name] -- The available pieces of type/class.
+ -- NB: If the type or class is itself
+ -- to be in scope, it must be in this list.
+ -- Thus, typically: AvailTC Eq [Eq, ==, /=]
+
+type AvailInfo = GenAvailInfo Name
+type RdrAvailInfo = GenAvailInfo OccName
+\end{code}
+
+%===================================================
+\subsubsection{ INTERFACE FILE STUFF}
+%===================================================
+
+\begin{code}
+type ExportItem = (ModuleName, [RdrAvailInfo])
+type VersionInfo name = [ImportVersion name]
+
+type ImportVersion name = (ModuleName, Version, WhetherHasOrphans, WhatsImported name)
+
+type WhetherHasOrphans = Bool
+ -- An "orphan" is
+ -- * an instance decl in a module other than the defn module for
+ -- one of the tycons or classes in the instance head
+ -- * a transformation rule in a module other than the one defining
+ -- the function in the head of the rule.
+
+data WhatsImported name = Everything
+ | Specifically [LocalVersion name] -- List guaranteed non-empty
+
+ -- ("M", hif, ver, Everything) means there was a "module M" in
+ -- this module's export list, so we just have to go by M's version, "ver",
+ -- not the list of LocalVersions.
+
+
+type LocalVersion name = (name, Version)
+
+data ParsedIface
+ = ParsedIface {
+ pi_mod :: Version, -- Module version number
+ pi_orphan :: WhetherHasOrphans, -- Whether this module has orphans
+ pi_usages :: [ImportVersion OccName], -- Usages
+ pi_exports :: [ExportItem], -- Exports
+ pi_decls :: [(Version, RdrNameHsDecl)], -- Local definitions
+ pi_insts :: [RdrNameInstDecl], -- Local instance declarations
+ pi_rules :: [RdrNameRuleDecl] -- Rules
+ }
+
+type InterfaceDetails = (WhetherHasOrphans,
+ VersionInfo Name, -- Version information for what this module imports
+ ExportEnv) -- What modules this one depends on
+
+
+-- needed by Main to fish out the fixities assoc list.
+getIfaceFixities :: InterfaceDetails -> Fixities
+getIfaceFixities (_, _, ExportEnv _ fs) = fs
+
+
+type RdrNamePragma = () -- Fudge for now
+-------------------
+
+data Ifaces = Ifaces {
+ iImpModInfo :: ImportedModuleInfo,
+ -- Modules this one depends on: that is, the union
+ -- of the modules its direct imports depend on.
+
+ iDecls :: DeclsMap, -- A single, global map of Names to decls
+
+ iFixes :: FixityEnv, -- A single, global map of Names to fixities
+
+ iSlurp :: NameSet,
+ -- All the names (whether "big" or "small", whether wired-in or not,
+ -- whether locally defined or not) that have been slurped in so far.
+
+ iVSlurp :: [(Name,Version)],
+ -- All the (a) non-wired-in (b) "big" (c) non-locally-defined
+ -- names that have been slurped in so far, with their versions.
+ -- This is used to generate the "usage" information for this module.
+ -- Subset of the previous field.
+
+ iInsts :: Bag GatedDecl,
+ -- The as-yet un-slurped instance decls; this bag is depleted when we
+ -- slurp an instance decl so that we don't slurp the same one twice.
+ -- Each is 'gated' by the names that must be available before
+ -- this instance decl is needed.
+
+ iRules :: Bag GatedDecl
+ -- Ditto transformation rules
+ }
+
+type GatedDecl = (NameSet, (Module, RdrNameHsDecl))
+
+type ImportedModuleInfo
+ = FiniteMap ModuleName (Version, Bool, Maybe (Module, Bool, Avails))
+ -- Suppose the domain element is module 'A'
+ --
+ -- The first Bool is True if A contains
+ -- 'orphan' rules or instance decls
+
+ -- The second Bool is true if the interface file actually
+ -- read was an .hi-boot file
+
+ -- Nothing => A's interface not yet read, but this module has
+ -- imported a module, B, that itself depends on A
+ --
+ -- Just xx => A's interface has been read. The Module in
+ -- the Just has the correct Dll flag
+
+ -- This set is used to decide whether to look for
+ -- A.hi or A.hi-boot when importing A.f.
+ -- Basically, we look for A.hi if A is in the map, and A.hi-boot
+ -- otherwise
+
+type DeclsMap = NameEnv (Version, AvailInfo, Bool, (Module, RdrNameHsDecl))
+ -- A DeclsMap contains a binding for each Name in the declaration
+ -- including the constructors of a type decl etc.
+ -- The Bool is True just for the 'main' Name.
+\end{code}
+
+
+%************************************************************************
+%* *
+\subsection{Main monad code}
+%* *
+%************************************************************************
+
+\begin{code}
+initRn :: ModuleName -> UniqSupply -> SearchPath -> SrcLoc
+ -> RnMG r
+ -> IO (r, Bag ErrMsg, Bag WarnMsg)
+
+initRn mod us dirs loc do_rn = do
+ himaps <- mkModuleHiMaps dirs
+ names_var <- newIORef (us, emptyFM, builtins)
+ errs_var <- newIORef (emptyBag,emptyBag)
+ iface_var <- newIORef emptyIfaces
+ let
+ rn_down = RnDown { rn_loc = loc, rn_ns = names_var,
+ rn_errs = errs_var,
+ rn_hi_maps = himaps,
+ rn_ifaces = iface_var,
+ rn_mod = mod }
+
+ -- do the business
+ res <- do_rn rn_down ()
+
+ -- grab errors and return
+ (warns, errs) <- readIORef errs_var
+
+ return (res, errs, warns)
+
+
+initRnMS :: GlobalRdrEnv -> FixityEnv -> RnMode -> RnMS r -> RnM d r
+initRnMS rn_env fixity_env mode thing_inside rn_down g_down
+ = let
+ s_down = SDown { rn_genv = rn_env, rn_lenv = emptyRdrEnv,
+ rn_fixenv = fixity_env, rn_mode = mode }
+ in
+ thing_inside rn_down s_down
+
+initIfaceRnMS :: Module -> RnMS r -> RnM d r
+initIfaceRnMS mod thing_inside
+ = initRnMS emptyRdrEnv emptyNameEnv InterfaceMode $
+ setModuleRn (moduleName mod) thing_inside
+
+emptyIfaces :: Ifaces
+emptyIfaces = Ifaces { iImpModInfo = emptyFM,
+ iDecls = emptyNameEnv,
+ iFixes = emptyNameEnv,
+ iSlurp = unitNameSet (mkUnboundName dummyRdrVarName),
+ -- Pretend that the dummy unbound name has already been
+ -- slurped. This is what's returned for an out-of-scope name,
+ -- and we don't want thereby to try to suck it in!
+ iVSlurp = [],
+ iInsts = emptyBag,
+ iRules = emptyBag
+ }
+
+-- mkUnboundName makes a place-holder Name; it shouldn't be looked at except possibly
+-- during compiler debugging.
+mkUnboundName :: RdrName -> Name
+mkUnboundName rdr_name = mkLocalName unboundKey (rdrNameOcc rdr_name) noSrcLoc
+
+isUnboundName :: Name -> Bool
+isUnboundName name = getUnique name == unboundKey
+
+builtins :: FiniteMap (ModuleName,OccName) Name
+builtins =
+ bagToFM (
+ mapBag (\ name -> ((moduleName (nameModule name), nameOccName name), name))
+ builtinNames)
+\end{code}
+
+@renameSourceCode@ is used to rename stuff ``out-of-line'';
+that is, not as part of the main renamer.
+Sole examples: derived definitions,
+which are only generated in the type checker.
+
+The @RnNameSupply@ includes a @UniqueSupply@, so if you call it more than
+once you must either split it, or install a fresh unique supply.
+
+\begin{code}
+renameSourceCode :: ModuleName
+ -> RnNameSupply
+ -> RnMS r
+ -> r
+
+renameSourceCode mod_name name_supply m
+ = unsafePerformIO (
+ -- It's not really unsafe! When renaming source code we
+ -- only do any I/O if we need to read in a fixity declaration;
+ -- and that doesn't happen in pragmas etc
+
+ newIORef name_supply >>= \ names_var ->
+ newIORef (emptyBag,emptyBag) >>= \ errs_var ->
+ let
+ rn_down = RnDown { rn_loc = mkGeneratedSrcLoc, rn_ns = names_var,
+ rn_errs = errs_var,
+ rn_mod = mod_name }
+ s_down = SDown { rn_mode = InterfaceMode,
+ -- So that we can refer to PrelBase.True etc
+ rn_genv = emptyRdrEnv, rn_lenv = emptyRdrEnv,
+ rn_fixenv = emptyNameEnv }
+ in
+ m rn_down s_down >>= \ result ->
+
+ readIORef errs_var >>= \ (warns,errs) ->
+
+ (if not (isEmptyBag errs) then
+ pprTrace "Urk! renameSourceCode found errors" (display errs)
+#ifdef DEBUG
+ else if not (isEmptyBag warns) then
+ pprTrace "Note: renameSourceCode found warnings" (display warns)
+#endif
+ else
+ id) $
+
+ return result
+ )
+ where
+ display errs = pprBagOfErrors errs
+
+{-# INLINE thenRn #-}
+{-# INLINE thenRn_ #-}
+{-# INLINE returnRn #-}
+{-# INLINE andRn #-}
+
+returnRn :: a -> RnM d a
+thenRn :: RnM d a -> (a -> RnM d b) -> RnM d b
+thenRn_ :: RnM d a -> RnM d b -> RnM d b
+andRn :: (a -> a -> a) -> RnM d a -> RnM d a -> RnM d a
+mapRn :: (a -> RnM d b) -> [a] -> RnM d [b]
+mapRn_ :: (a -> RnM d b) -> [a] -> RnM d ()
+mapMaybeRn :: (a -> RnM d (Maybe b)) -> [a] -> RnM d [b]
+sequenceRn :: [RnM d a] -> RnM d [a]
+foldlRn :: (b -> a -> RnM d b) -> b -> [a] -> RnM d b
+mapAndUnzipRn :: (a -> RnM d (b,c)) -> [a] -> RnM d ([b],[c])
+fixRn :: (a -> RnM d a) -> RnM d a
+
+returnRn v gdown ldown = return v
+thenRn m k gdown ldown = m gdown ldown >>= \ r -> k r gdown ldown
+thenRn_ m k gdown ldown = m gdown ldown >> k gdown ldown
+fixRn m gdown ldown = fixIO (\r -> m r gdown ldown)
+andRn combiner m1 m2 gdown ldown
+ = m1 gdown ldown >>= \ res1 ->
+ m2 gdown ldown >>= \ res2 ->
+ return (combiner res1 res2)
+
+sequenceRn [] = returnRn []
+sequenceRn (m:ms) = m `thenRn` \ r ->
+ sequenceRn ms `thenRn` \ rs ->
+ returnRn (r:rs)
+
+mapRn f [] = returnRn []
+mapRn f (x:xs)
+ = f x `thenRn` \ r ->
+ mapRn f xs `thenRn` \ rs ->
+ returnRn (r:rs)
+
+mapRn_ f [] = returnRn ()
+mapRn_ f (x:xs) =
+ f x `thenRn_`
+ mapRn_ f xs
+
+foldlRn k z [] = returnRn z
+foldlRn k z (x:xs) = k z x `thenRn` \ z' ->
+ foldlRn k z' xs
+
+mapAndUnzipRn f [] = returnRn ([],[])
+mapAndUnzipRn f (x:xs)
+ = f x `thenRn` \ (r1, r2) ->
+ mapAndUnzipRn f xs `thenRn` \ (rs1, rs2) ->
+ returnRn (r1:rs1, r2:rs2)
+
+mapAndUnzip3Rn f [] = returnRn ([],[],[])
+mapAndUnzip3Rn f (x:xs)
+ = f x `thenRn` \ (r1, r2, r3) ->
+ mapAndUnzip3Rn f xs `thenRn` \ (rs1, rs2, rs3) ->
+ returnRn (r1:rs1, r2:rs2, r3:rs3)
+
+mapMaybeRn f [] = returnRn []
+mapMaybeRn f (x:xs) = f x `thenRn` \ maybe_r ->
+ mapMaybeRn f xs `thenRn` \ rs ->
+ case maybe_r of
+ Nothing -> returnRn rs
+ Just r -> returnRn (r:rs)
+\end{code}
+
+
+
+%************************************************************************
+%* *
+\subsection{Boring plumbing for common part}
+%* *
+%************************************************************************
+
+
+%================
+\subsubsection{ Errors and warnings}
+%=====================
+
+\begin{code}
+failWithRn :: a -> Message -> RnM d a
+failWithRn res msg (RnDown {rn_errs = errs_var, rn_loc = loc}) l_down
+ = readIORef errs_var >>= \ (warns,errs) ->
+ writeIORef errs_var (warns, errs `snocBag` err) >>
+ return res
+ where
+ err = addShortErrLocLine loc msg
+
+warnWithRn :: a -> Message -> RnM d a
+warnWithRn res msg (RnDown {rn_errs = errs_var, rn_loc = loc}) l_down
+ = readIORef errs_var >>= \ (warns,errs) ->
+ writeIORef errs_var (warns `snocBag` warn, errs) >>
+ return res
+ where
+ warn = addShortWarnLocLine loc msg
+
+addErrRn :: Message -> RnM d ()
+addErrRn err = failWithRn () err
+
+checkRn :: Bool -> Message -> RnM d () -- Check that a condition is true
+checkRn False err = addErrRn err
+checkRn True err = returnRn ()
+
+warnCheckRn :: Bool -> Message -> RnM d () -- Check that a condition is true
+warnCheckRn False err = addWarnRn err
+warnCheckRn True err = returnRn ()
+
+addWarnRn :: Message -> RnM d ()
+addWarnRn warn = warnWithRn () warn
+
+checkErrsRn :: RnM d Bool -- True <=> no errors so far
+checkErrsRn (RnDown {rn_errs = errs_var}) l_down
+ = readIORef errs_var >>= \ (warns,errs) ->
+ return (isEmptyBag errs)
+\end{code}
+
+
+%================
+\subsubsection{ Source location}
+%=====================
+
+\begin{code}
+pushSrcLocRn :: SrcLoc -> RnM d a -> RnM d a
+pushSrcLocRn loc' m down l_down
+ = m (down {rn_loc = loc'}) l_down
+
+getSrcLocRn :: RnM d SrcLoc
+getSrcLocRn down l_down
+ = return (rn_loc down)
+\end{code}
+
+%================
+\subsubsection{ Name supply}
+%=====================
+
+\begin{code}
+getNameSupplyRn :: RnM d RnNameSupply
+getNameSupplyRn rn_down l_down
+ = readIORef (rn_ns rn_down)
+
+setNameSupplyRn :: RnNameSupply -> RnM d ()
+setNameSupplyRn names' (RnDown {rn_ns = names_var}) l_down
+ = writeIORef names_var names'
+
+-- See comments with RnNameSupply above.
+newInstUniq :: (OccName, OccName) -> RnM d Int
+newInstUniq key (RnDown {rn_ns = names_var}) l_down
+ = readIORef names_var >>= \ (us, mapInst, cache) ->
+ let
+ uniq = case lookupFM mapInst key of
+ Just x -> x+1
+ Nothing -> 0
+ mapInst' = addToFM mapInst key uniq
+ in
+ writeIORef names_var (us, mapInst', cache) >>
+ return uniq
+
+getUniqRn :: RnM d Unique
+getUniqRn (RnDown {rn_ns = names_var}) l_down
+ = readIORef names_var >>= \ (us, mapInst, cache) ->
+ let
+ (us1,us') = splitUniqSupply us
+ in
+ writeIORef names_var (us', mapInst, cache) >>
+ return (uniqFromSupply us1)
+\end{code}
+
+%================
+\subsubsection{ Module}
+%=====================
+
+\begin{code}
+getModuleRn :: RnM d ModuleName
+getModuleRn (RnDown {rn_mod = mod_name}) l_down
+ = return mod_name
+
+setModuleRn :: ModuleName -> RnM d a -> RnM d a
+setModuleRn new_mod enclosed_thing rn_down l_down
+ = enclosed_thing (rn_down {rn_mod = new_mod}) l_down
+\end{code}
+
+
+%************************************************************************
+%* *
+\subsection{Plumbing for rename-source part}
+%* *
+%************************************************************************
+
+%================
+\subsubsection{ RnEnv}
+%=====================
+
+\begin{code}
+getNameEnvs :: RnMS (GlobalRdrEnv, LocalRdrEnv)
+getNameEnvs rn_down (SDown {rn_genv = global_env, rn_lenv = local_env})
+ = return (global_env, local_env)
+
+getLocalNameEnv :: RnMS LocalRdrEnv
+getLocalNameEnv rn_down (SDown {rn_lenv = local_env})
+ = return local_env
+
+setLocalNameEnv :: LocalRdrEnv -> RnMS a -> RnMS a
+setLocalNameEnv local_env' m rn_down l_down
+ = m rn_down (l_down {rn_lenv = local_env'})
+
+getFixityEnv :: RnMS FixityEnv
+getFixityEnv rn_down (SDown {rn_fixenv = fixity_env})
+ = return fixity_env
+
+extendFixityEnv :: [(Name, RenamedFixitySig)] -> RnMS a -> RnMS a
+extendFixityEnv fixes enclosed_scope
+ rn_down l_down@(SDown {rn_fixenv = fixity_env})
+ = let
+ new_fixity_env = extendNameEnv fixity_env fixes
+ in
+ enclosed_scope rn_down (l_down {rn_fixenv = new_fixity_env})
+\end{code}
+
+%================
+\subsubsection{ Mode}
+%=====================
+
+\begin{code}
+getModeRn :: RnMS RnMode
+getModeRn rn_down (SDown {rn_mode = mode})
+ = return mode
+
+setModeRn :: RnMode -> RnMS a -> RnMS a
+setModeRn new_mode thing_inside rn_down l_down
+ = thing_inside rn_down (l_down {rn_mode = new_mode})
+\end{code}
+
+
+%************************************************************************
+%* *
+\subsection{Plumbing for rename-globals part}
+%* *
+%************************************************************************
+
+\begin{code}
+getIfacesRn :: RnM d Ifaces
+getIfacesRn (RnDown {rn_ifaces = iface_var}) _
+ = readIORef iface_var
+
+setIfacesRn :: Ifaces -> RnM d ()
+setIfacesRn ifaces (RnDown {rn_ifaces = iface_var}) _
+ = writeIORef iface_var ifaces
+
+getHiMaps :: RnM d (ModuleHiMap, ModuleHiMap)
+getHiMaps (RnDown {rn_hi_maps = himaps}) _
+ = return himaps
+\end{code}