[project @ 2001-02-26 15:42:24 by simonpj]
[ghc-hetmet.git] / ghc / compiler / stgSyn / CoreToStg.lhs
index ad960de..e4752c5 100644 (file)
 %
-% (c) The GRASP/AQUA Project, Glasgow University, 1992-1998
+% (c) The GRASP/AQUA Project, Glasgow University, 1993-1998
 %
-%************************************************************************
-%*                                                                     *
-\section[CoreToStg]{Converting core syntax to STG syntax}
-%*                                                                     *
-%************************************************************************
+\section[CoreToStg]{Converts Core to STG Syntax}
 
-Convert a @CoreSyntax@ program to a @StgSyntax@ program.
+And, as we have the info in hand, we may convert some lets to
+let-no-escapes.
 
 \begin{code}
-module CoreToStg ( topCoreBindsToStg ) where
+module CoreToStg ( coreToStg, coreExprToStg ) where
 
 #include "HsVersions.h"
 
-import CoreSyn         -- input
-import StgSyn          -- output
-
-import CoreUtils       ( coreExprType )
-import SimplUtils      ( findDefault )
+import CoreSyn
+import CoreFVs
+import CoreUtils
+import SimplUtils
+import StgSyn
+
+import Type
+import TyCon           ( isAlgTyCon )
+import Id
+import Var             ( Var )
+import IdInfo
+import DataCon
 import CostCentre      ( noCCS )
-import Id              ( Id, mkSysLocal, idType,
-                         externallyVisibleId, setIdUnique, idName, getIdDemandInfo
-                       )
-import Var             ( modifyIdInfo )
-import IdInfo          ( setDemandInfo )
-import DataCon         ( DataCon, dataConName, dataConId )
-import Name            ( Name, nameModule, isLocallyDefinedName )
-import Module          ( isDynamicModule )
-import Const           ( Con(..), Literal, isLitLitLit )
+import VarSet
 import VarEnv
-import Const           ( Con(..), isWHNFCon, Literal(..) )
-import PrimOp          ( PrimOp(..) )
-import Type            ( isUnLiftedType, isUnboxedTupleType, Type )
-import TysPrim         ( intPrimTy )
-import Demand
-import Unique          ( Unique, Uniquable(..) )
-import UniqSupply      -- all of it, really
+import DataCon         ( dataConWrapId )
+import IdInfo          ( OccInfo(..) )
+import PrimOp          ( PrimOp(..), ccallMayGC )
+import TysPrim         ( foreignObjPrimTyCon )
+import Maybes          ( maybeToBool, orElse )
+import Name            ( getOccName, isExternallyVisibleName )
+import Module          ( Module )
+import OccName         ( occNameUserString )
+import BasicTypes       ( TopLevelFlag(..), isNotTopLevel )
+import CmdLineOpts     ( DynFlags, opt_KeepStgTypes )
 import Outputable
-\end{code}
-
-
-       ***************  OVERVIEW   *********************
-
 
-The business of this pass is to convert Core to Stg.  On the way:
-
-* We discard type lambdas and applications. In so doing we discard
-  "trivial" bindings such as
-       x = y t1 t2
-  where t1, t2 are types
-
-* We don't pin on correct arities any more, because they can be mucked up
-  by the lambda lifter.  In particular, the lambda lifter can take a local
-  letrec-bound variable and make it a lambda argument, which shouldn't have
-  an arity.  So SetStgVarInfo sets arities now.
-
-* We do *not* pin on the correct free/live var info; that's done later.
-  Instead we use bOGUS_LVS and _FVS as a placeholder.
+infixr 9 `thenLne`
+\end{code}
 
-[Quite a bit of stuff that used to be here has moved 
- to tidyCorePgm (SimplCore.lhs) SLPJ Nov 96]
+%************************************************************************
+%*                                                                     *
+\subsection[live-vs-free-doc]{Documentation}
+%*                                                                     *
+%************************************************************************
 
+(There is other relevant documentation in codeGen/CgLetNoEscape.)
+
+The actual Stg datatype is decorated with {\em live variable}
+information, as well as {\em free variable} information.  The two are
+{\em not} the same.  Liveness is an operational property rather than a
+semantic one.  A variable is live at a particular execution point if
+it can be referred to {\em directly} again.  In particular, a dead
+variable's stack slot (if it has one):
+\begin{enumerate}
+\item
+should be stubbed to avoid space leaks, and
+\item
+may be reused for something else.
+\end{enumerate}
+
+There ought to be a better way to say this.  Here are some examples:
+\begin{verbatim}
+       let v = [q] \[x] -> e
+       in
+       ...v...  (but no q's)
+\end{verbatim}
+
+Just after the `in', v is live, but q is dead. If the whole of that
+let expression was enclosed in a case expression, thus:
+\begin{verbatim}
+       case (let v = [q] \[x] -> e in ...v...) of
+               alts[...q...]
+\end{verbatim}
+(ie @alts@ mention @q@), then @q@ is live even after the `in'; because
+we'll return later to the @alts@ and need it.
+
+Let-no-escapes make this a bit more interesting:
+\begin{verbatim}
+       let-no-escape v = [q] \ [x] -> e
+       in
+       ...v...
+\end{verbatim}
+Here, @q@ is still live at the `in', because @v@ is represented not by
+a closure but by the current stack state.  In other words, if @v@ is
+live then so is @q@.  Furthermore, if @e@ mentions an enclosing
+let-no-escaped variable, then {\em its} free variables are also live
+if @v@ is.
 
 %************************************************************************
 %*                                                                     *
-\subsection[coreToStg-programs]{Converting a core program and core bindings}
+\subsection[binds-StgVarInfo]{Setting variable info: top-level, binds, RHSs}
 %*                                                                     *
 %************************************************************************
 
-March 98: We keep a small environment to give all locally bound
-Names new unique ids, since the code generator assumes that binders
-are unique across a module. (Simplifier doesn't maintain this
-invariant any longer.)
-
 \begin{code}
-type StgEnv = IdEnv Id
-
-data StgFloatBind
-   = LetBind Id StgExpr
-   | CaseBind Id StgExpr
+coreToStg :: DynFlags -> Module -> [CoreBind] -> IO [StgBinding]
+coreToStg dflags this_mod pgm
+  = return (fst (initLne (coreTopBindsToStg pgm)))
+
+coreExprToStg :: CoreExpr -> StgExpr
+coreExprToStg expr 
+  = new_expr where (new_expr,_,_) = initLne (coreToStgExpr expr)
+
+-- For top-level guys, we basically aren't worried about this
+-- live-variable stuff; we do need to keep adding to the environment
+-- as we step through the bindings (using @extendVarEnv@).
+
+coreTopBindsToStg :: [CoreBind] -> LneM ([StgBinding], FreeVarsInfo)
+
+coreTopBindsToStg [] = returnLne ([], emptyFVInfo)
+coreTopBindsToStg (bind:binds)
+  =  let 
+         binders = bindersOf bind
+        env_extension = binders `zip` repeat how_bound
+        how_bound = LetrecBound True {- top level -}
+                                emptyVarSet
+     in
+
+     extendVarEnvLne env_extension (
+       coreTopBindsToStg binds                `thenLne` \ (binds', fv_binds) ->
+       coreTopBindToStg binders fv_binds bind  `thenLne` \ (bind',  fv_bind) ->
+       returnLne (
+                 (bind' : binds'),
+                 (fv_binds `unionFVInfo` fv_bind) `minusFVBinders` binders
+                )
+      )
+
+
+coreTopBindToStg
+       :: [Id]                 -- New binders (with correct arity)
+       -> FreeVarsInfo         -- Info about the body
+       -> CoreBind
+       -> LneM (StgBinding, FreeVarsInfo)
+
+coreTopBindToStg [binder] body_fvs (NonRec _ rhs)
+  = coreToStgRhs body_fvs TopLevel (binder,rhs)        `thenLne` \ (rhs2, fvs, _) ->
+    returnLne (StgNonRec binder rhs2, fvs)
+
+coreTopBindToStg binders body_fvs (Rec pairs)
+  = fixLne (\ ~(_, rec_rhs_fvs) ->
+       let scope_fvs = unionFVInfo body_fvs rec_rhs_fvs
+       in
+       mapAndUnzip3Lne (coreToStgRhs scope_fvs TopLevel) pairs 
+                                               `thenLne` \ (rhss2, fvss, _) ->
+       let fvs = unionFVInfos fvss
+       in
+       returnLne (StgRec (binders `zip` rhss2), fvs)
+    )
 \end{code}
 
-No free/live variable information is pinned on in this pass; it's added
-later.  For this pass
-we use @bOGUS_LVs@ and @bOGUS_FVs@ as placeholders.
-
 \begin{code}
-bOGUS_LVs :: StgLiveVars
-bOGUS_LVs = panic "bOGUS_LVs" -- emptyUniqSet (used when pprTracing)
-
-bOGUS_FVs :: [Id]
-bOGUS_FVs = panic "bOGUS_FVs" -- [] (ditto)
+coreToStgRhs
+       :: FreeVarsInfo         -- Free var info for the scope of the binding
+       -> TopLevelFlag
+       -> (Id,CoreExpr)
+       -> LneM (StgRhs, FreeVarsInfo, EscVarsSet)
+
+coreToStgRhs scope_fv_info top (binder, rhs)
+  = coreToStgExpr rhs  `thenLne` \ (new_rhs, rhs_fvs, rhs_escs) ->
+    returnLne (mkStgRhs top rhs_fvs binder_info new_rhs, 
+              rhs_fvs, rhs_escs)
+  where
+    binder_info = lookupFVInfo scope_fv_info binder
+
+mkStgRhs :: TopLevelFlag -> FreeVarsInfo -> StgBinderInfo
+        -> StgExpr -> StgRhs
+
+mkStgRhs top rhs_fvs binder_info (StgLam _ bndrs body)
+  = StgRhsClosure noCCS binder_info noSRT
+                 (getFVs rhs_fvs)               
+                 ReEntrant
+                 bndrs body
+       
+mkStgRhs top rhs_fvs binder_info (StgConApp con args)
+  | isNotTopLevel top || not (isDllConApp con args)
+  = StgRhsCon noCCS con args
+
+mkStgRhs top rhs_fvs binder_info rhs
+  = StgRhsClosure noCCS binder_info noSRT
+                 (getFVs rhs_fvs)               
+                 (updatable [] rhs)
+                 [] rhs
+  where
+    updatable args body | null args && isPAP body  = ReEntrant
+                       | otherwise                = Updatable
+{- ToDo:
+          upd = if isOnceDem dem
+                   then (if isNotTop toplev 
+                           then SingleEntry    -- HA!  Paydirt for "dem"
+                           else 
+#ifdef DEBUG
+                     trace "WARNING: SE CAFs unsupported, forcing UPD instead" $
+#endif
+                     Updatable)
+               else Updatable
+        -- For now we forbid SingleEntry CAFs; they tickle the
+        -- ASSERT in rts/Storage.c line 215 at newCAF() re mut_link,
+        -- and I don't understand why.  There's only one SE_CAF (well,
+        -- only one that tickled a great gaping bug in an earlier attempt
+        -- at ClosureInfo.getEntryConvention) in the whole of nofib, 
+        -- specifically Main.lvl6 in spectral/cryptarithm2.
+        -- So no great loss.  KSW 2000-07.
+-}
 \end{code}
 
-\begin{code}
-topCoreBindsToStg :: UniqSupply        -- name supply
-                 -> [CoreBind] -- input
-                 -> [StgBinding]       -- output
+Detect thunks which will reduce immediately to PAPs, and make them
+non-updatable.  This has several advantages:
 
-topCoreBindsToStg us core_binds
-  = initUs us (coreBindsToStg emptyVarEnv core_binds)
-  where
-    coreBindsToStg :: StgEnv -> [CoreBind] -> UniqSM [StgBinding]
+        - the non-updatable thunk behaves exactly like the PAP,
 
-    coreBindsToStg env [] = returnUs []
-    coreBindsToStg env (b:bs)
-      = coreBindToStg  env b           `thenUs` \ (new_b, new_env) ->
-       coreBindsToStg new_env bs       `thenUs` \ new_bs ->
-       returnUs (new_b ++ new_bs)
-\end{code}
+       - the thunk is more efficient to enter, because it is
+         specialised to the task.
 
-%************************************************************************
-%*                                                                     *
-\subsection[coreToStg-binds]{Converting bindings}
-%*                                                                     *
-%************************************************************************
+        - we save one update frame, one stg_update_PAP, one update
+         and lots of PAP_enters.
+
+       - in the case where the thunk is top-level, we save building
+         a black hole and futhermore the thunk isn't considered to
+         be a CAF any more, so it doesn't appear in any SRTs.
+
+We do it here, because the arity information is accurate, and we need
+to do it before the SRT pass to save the SRT entries associated with
+any top-level PAPs.
 
 \begin{code}
-coreBindToStg :: StgEnv
-             -> CoreBind
-             -> UniqSM ([StgBinding],  -- Empty or singleton
-                        StgEnv)        -- Floats
-
-coreBindToStg env (NonRec binder rhs)
-  = coreRhsToStg env rhs       `thenUs` \ stg_rhs ->
-    newLocalId env binder      `thenUs` \ (new_env, new_binder) ->
-    returnUs ([StgNonRec new_binder stg_rhs], new_env)
-
-coreBindToStg env (Rec pairs)
-  = newLocalIds env binders            `thenUs` \ (env', binders') ->
-    mapUs (coreRhsToStg env') rhss      `thenUs` \ stg_rhss ->
-    returnUs ([StgRec (binders' `zip` stg_rhss)], env')
-  where
-    (binders, rhss) = unzip pairs
+isPAP (StgApp f args) = idArity f > length args
+isPAP _              = False
 \end{code}
 
 
-%************************************************************************
-%*                                                                     *
-\subsection[coreToStg-rhss]{Converting right hand sides}
-%*                                                                     *
-%************************************************************************
+-- ---------------------------------------------------------------------------
+-- Expressions
+-- ---------------------------------------------------------------------------
 
 \begin{code}
-coreRhsToStg :: StgEnv -> CoreExpr -> UniqSM StgRhs
-
-coreRhsToStg env core_rhs
-  = coreExprToStg env core_rhs         `thenUs` \ stg_expr ->
-    returnUs (exprToRhs stg_expr)
-
-exprToRhs (StgLet (StgNonRec var1 rhs) (StgApp var2 []))
-  | var1 == var2 
-  = rhs
-       -- This curious stuff is to unravel what a lambda turns into
-       -- We have to do it this way, rather than spot a lambda in the
-       -- incoming rhs.  Why?  Because trivial bindings might conceal
-       -- what the rhs is actually like.
-
-{-
-  We reject the following candidates for 'static constructor'dom:
-  
-    - any dcon that takes a lit-lit as an arg.
-    - [Win32 DLLs only]: any dcon that is (or takes as arg)
-      that's living in a DLL.
-
-  These constraints are necessary to ensure that the code
-  generated in the end for the static constructors, which
-  live in the data segment, remain valid - i.e., it has to
-  be constant. For obvious reasons, that's hard to guarantee
-  with lit-lits. The second case of a constructor referring
-  to static closures hiding out in some DLL is an artifact
-  of the way Win32 DLLs handle global DLL variables. A (data)
-  symbol exported from a DLL  has to be accessed through a
-  level of indirection at the site of use, so whereas
-
-     extern StgClosure y_closure;
-     extern StgClosure z_closure;
-     x = { ..., &y_closure, &z_closure };
-
-  is legal when the symbols are in scope at link-time, it is
-  not when y_closure is in a DLL. So, any potential static
-  closures that refers to stuff that's residing in a DLL
-  will be put in an (updateable) thunk instead.
-
-  An alternative strategy is to support the generation of
-  constructors (ala C++ static class constructors) which will
-  then be run at load time to fix up static closures.
--}
-exprToRhs (StgCon (DataCon con) args _)
-  | not is_dynamic  &&
-    all  (not.is_lit_lit) args  = StgRhsCon noCCS con args
- where
-  is_dynamic = isDynCon con || any (isDynArg) args
-
-  is_lit_lit (StgVarArg _) = False
-  is_lit_lit (StgConArg x) =
-     case x of
-       Literal l -> isLitLitLit l
-       _         -> False
-
-exprToRhs expr 
-       = StgRhsClosure noCCS           -- No cost centre (ToDo?)
-                       stgArgOcc       -- safe
-                       noSRT           -- figure out later
-                       bOGUS_FVs
-
-                       Updatable       -- Be pessimistic
-                       []
-                       expr
-
-isDynCon :: DataCon -> Bool
-isDynCon con = isDynName (dataConName con)
-
-isDynArg :: StgArg -> Bool
-isDynArg (StgVarArg v)   = isDynName (idName v)
-isDynArg (StgConArg con) =
-  case con of
-    DataCon dc -> isDynCon dc
-    Literal l  -> isLitLitLit l
-    _          -> False
-
-isDynName :: Name -> Bool
-isDynName nm = 
-      not (isLocallyDefinedName nm) && 
-      isDynamicModule (nameModule nm)
-
-
+coreToStgExpr
+       :: CoreExpr
+       -> LneM (StgExpr,       -- Decorated STG expr
+                FreeVarsInfo,  -- Its free vars (NB free, not live)
+                EscVarsSet)    -- Its escapees, a subset of its free vars;
+                               -- also a subset of the domain of the envt
+                               -- because we are only interested in the escapees
+                               -- for vars which might be turned into
+                               -- let-no-escaped ones.
 \end{code}
 
-
-%************************************************************************
-%*                                                                     *
-\subsection[coreToStg-atoms{Converting atoms}
-%*                                                                     *
-%************************************************************************
+The second and third components can be derived in a simple bottom up pass, not
+dependent on any decisions about which variables will be let-no-escaped or
+not.  The first component, that is, the decorated expression, may then depend
+on these components, but it in turn is not scrutinised as the basis for any
+decisions.  Hence no black holes.
 
 \begin{code}
-coreArgsToStg :: StgEnv -> [CoreArg] -> UniqSM ([StgFloatBind], [StgArg])
+coreToStgExpr (Lit l) = returnLne (StgLit l, emptyFVInfo, emptyVarSet)
+coreToStgExpr (Var v) = coreToStgApp Nothing v []
 
-coreArgsToStg env []
-  = returnUs ([], [])
-
-coreArgsToStg env (Type ty : as)       -- Discard type arguments
-  = coreArgsToStg env as
+coreToStgExpr expr@(App _ _)
+  = coreToStgApp Nothing f args
+  where
+    (f, args) = myCollectArgs expr
 
-coreArgsToStg env (a:as)
-  = coreArgToStg env a         `thenUs` \ (bs1, a') ->
-    coreArgsToStg env as       `thenUs` \ (bs2, as') ->
-    returnUs (bs1 ++ bs2, a' : as')
+coreToStgExpr expr@(Lam _ _)
+  = let (args, body) = myCollectBinders expr 
+       args'        = filterStgBinders args
+    in
+    extendVarEnvLne [ (a, LambdaBound) | a <- args' ] $
+    coreToStgExpr body  `thenLne` \ (body, body_fvs, body_escs) ->
+    let
+       set_of_args     = mkVarSet args'
+       fvs             = body_fvs  `minusFVBinders` args'
+       escs            = body_escs `minusVarSet`    set_of_args
+    in
+    if null args'
+       then returnLne (body, fvs, escs)
+       else returnLne (StgLam (exprType expr) args' body, fvs, escs)
 
--- This is where we arrange that a non-trivial argument is let-bound
+coreToStgExpr (Note (SCC cc) expr)
+  = coreToStgExpr expr         `thenLne` ( \ (expr2, fvs, escs) ->
+    returnLne (StgSCC cc expr2, fvs, escs) )
 
-coreArgToStg :: StgEnv -> CoreArg -> UniqSM ([StgFloatBind], StgArg)
+coreToStgExpr (Note other_note expr)
+  = coreToStgExpr expr
 
-coreArgToStg env arg
-  = coreExprToStgFloat env arg `thenUs` \ (binds, arg') ->
-    case (binds, arg') of
-       ([], StgCon con [] _) | isWHNFCon con -> returnUs ([], StgConArg con)
-       ([], StgApp v [])                     -> returnUs ([], StgVarArg v)
 
-       -- A non-trivial argument: we must let (or case-bind)
-       -- We don't do the case part here... we leave that to mkStgBinds
+-- Cases require a little more real work.
 
-       -- Further complication: if we're converting this binding into
-       -- a case,  then try to avoid generating any case-of-case
-       -- expressions by pulling out the floats.
-       (_, other) ->
-                newStgVar ty   `thenUs` \ v ->
-                if isUnLiftedType ty
-                  then returnUs (binds ++ [CaseBind v arg'], StgVarArg v)
-                  else returnUs ([LetBind v (mkStgBinds binds arg')], StgVarArg v)
-         where 
-               ty = coreExprType arg
+coreToStgExpr (Case scrut bndr alts)
+  = getVarsLiveInCont                          `thenLne` \ live_in_cont ->
+    extendVarEnvLne [(bndr, CaseBound)]        $
+    vars_alts (findDefault alts)               `thenLne` \ (alts2, alts_fvs, alts_escs) ->
+    lookupLiveVarsForSet alts_fvs              `thenLne` \ alts_lvs ->
+    let
+       -- determine whether the default binder is dead or not
+       bndr' = bndr `setIdOccInfo` occ_info
+       occ_info | bndr `elementOfFVInfo` alts_fvs = NoOccInfo
+                | otherwise                       = IAmDead
+
+        -- for a _ccall_GC_, some of the *arguments* need to live across the
+        -- call (see findLiveArgs comments.), so we annotate them as being live
+        -- in the alts to achieve the desired effect.
+       mb_live_across_case =
+         case scrut of
+           -- ToDo: Notes?
+           e@(App _ _) | (v, args) <- myCollectArgs e,
+                         PrimOpId (CCallOp ccall) <- idFlavour v,
+                         ccallMayGC ccall
+                         -> Just (filterVarSet isForeignObjArg (exprFreeVars e))
+           _   -> Nothing
+
+       -- Don't consider the default binder as being 'live in alts',
+       -- since this is from the point of view of the case expr, where
+       -- the default binder is not free.
+       live_in_alts = orElse (FMAP unionVarSet mb_live_across_case) id $
+                      live_in_cont `unionVarSet` 
+                      (alts_lvs `minusVarSet` unitVarSet bndr)
+    in
+       -- we tell the scrutinee that everything live in the alts
+       -- is live in it, too.
+    setVarsLiveInCont live_in_alts (
+       coreToStgExpr scrut
+    )                     `thenLne` \ (scrut2, scrut_fvs, scrut_escs) ->
 
+    lookupLiveVarsForSet scrut_fvs `thenLne` \ scrut_lvs ->
+    let
+       live_in_whole_case = live_in_alts `unionVarSet` scrut_lvs
+    in
+    returnLne (
+      StgCase scrut2 live_in_whole_case live_in_alts bndr' noSRT alts2,
+      (scrut_fvs `unionFVInfo` alts_fvs) `minusFVBinders` [bndr],
+      (alts_escs `minusVarSet` unitVarSet bndr) `unionVarSet` getFVSet scrut_fvs
+               -- You might think we should have scrut_escs, not (getFVSet scrut_fvs),
+               -- but actually we can't call, and then return from, a let-no-escape thing.
+      )
+  where
+    scrut_ty   = idType bndr
+    prim_case  = isUnLiftedType scrut_ty && not (isUnboxedTupleType scrut_ty)
+
+    vars_alts (alts,deflt)
+       | prim_case
+        = mapAndUnzip3Lne vars_prim_alt alts
+                       `thenLne` \ (alts2,  alts_fvs_list,  alts_escs_list) ->
+         let
+             alts_fvs  = unionFVInfos alts_fvs_list
+             alts_escs = unionVarSets alts_escs_list
+         in
+         vars_deflt deflt `thenLne` \ (deflt2, deflt_fvs, deflt_escs) ->
+         returnLne (
+             mkStgPrimAlts scrut_ty alts2 deflt2,
+             alts_fvs  `unionFVInfo`   deflt_fvs,
+             alts_escs `unionVarSet` deflt_escs
+         )
+
+       | otherwise
+        = mapAndUnzip3Lne vars_alg_alt alts
+                       `thenLne` \ (alts2,  alts_fvs_list,  alts_escs_list) ->
+         let
+             alts_fvs  = unionFVInfos alts_fvs_list
+             alts_escs = unionVarSets alts_escs_list
+         in
+         vars_deflt deflt `thenLne` \ (deflt2, deflt_fvs, deflt_escs) ->
+         returnLne (
+             mkStgAlgAlts scrut_ty alts2 deflt2,
+             alts_fvs  `unionFVInfo`   deflt_fvs,
+             alts_escs `unionVarSet` deflt_escs
+         )
+
+      where
+       vars_prim_alt (LitAlt lit, _, rhs)
+         = coreToStgExpr rhs   `thenLne` \ (rhs2, rhs_fvs, rhs_escs) ->
+           returnLne ((lit, rhs2), rhs_fvs, rhs_escs)
+
+       vars_alg_alt (DataAlt con, binders, rhs)
+         = let
+               -- remove type variables
+               binders' = filterStgBinders binders
+           in  
+           extendVarEnvLne [(b, CaseBound) | b <- binders']    $
+           coreToStgExpr rhs   `thenLne` \ (rhs2, rhs_fvs, rhs_escs) ->
+           let
+               good_use_mask = [ b `elementOfFVInfo` rhs_fvs | b <- binders' ]
+               -- records whether each param is used in the RHS
+           in
+           returnLne (
+               (con, binders', good_use_mask, rhs2),
+               rhs_fvs  `minusFVBinders` binders',
+               rhs_escs `minusVarSet`   mkVarSet binders'
+                       -- ToDo: remove the minusVarSet;
+                       -- since escs won't include any of these binders
+           )
+
+       vars_deflt Nothing
+          = returnLne (StgNoDefault, emptyFVInfo, emptyVarSet)
+     
+       vars_deflt (Just rhs)
+          = coreToStgExpr rhs  `thenLne` \ (rhs2, rhs_fvs, rhs_escs) ->
+            returnLne (StgBindDefault rhs2, rhs_fvs, rhs_escs)
 \end{code}
 
+Lets not only take quite a bit of work, but this is where we convert
+then to let-no-escapes, if we wish.
 
-%************************************************************************
-%*                                                                     *
-\subsection[coreToStg-exprs]{Converting core expressions}
-%*                                                                     *
-%************************************************************************
-
+(Meanwhile, we don't expect to see let-no-escapes...)
 \begin{code}
-coreExprToStg :: StgEnv -> CoreExpr -> UniqSM StgExpr
-
-coreExprToStg env (Var var)
-  = returnUs (StgApp (stgLookup env var) [])
+coreToStgExpr (Let bind body)
+  = fixLne (\ ~(_, _, _, no_binder_escapes) ->
+       coreToStgLet no_binder_escapes bind body
+    )                          `thenLne` \ (new_let, fvs, escs, _) ->
 
+    returnLne (new_let, fvs, escs)
 \end{code}
 
-%************************************************************************
-%*                                                                     *
-\subsubsection[coreToStg-lambdas]{Lambda abstractions}
-%*                                                                     *
-%************************************************************************
+If we've got a case containing a _ccall_GC_ primop, we need to
+ensure that the arguments are kept live for the duration of the
+call. This only an issue
 
 \begin{code}
-coreExprToStg env expr@(Lam _ _)
-  = let
-       (binders, body) = collectBinders expr
-       id_binders      = filter isId binders
-    in
-    newLocalIds env id_binders         `thenUs` \ (env', binders') ->
-    coreExprToStg env' body             `thenUs` \ stg_body ->
+isForeignObjArg :: Id -> Bool
+isForeignObjArg x = isId x && isForeignObjPrimTy (idType x)
 
-    if null id_binders then -- it was all type/usage binders; tossed
-       returnUs stg_body
-    else
-    case stg_body of
-
-      -- if the body reduced to a lambda too...
-      (StgLet (StgNonRec var (StgRhsClosure cc bi srt fvs uf args body))
-             (StgApp var' []))
-       | var == var' ->
-       returnUs (StgLet (StgNonRec var 
-                           (StgRhsClosure noCCS
-                               stgArgOcc
-                               noSRT
-                               bOGUS_FVs
-                               ReEntrant
-                               (binders' ++ args)
-                               body))
-               (StgApp var []))
-                                   
-      other ->
-
-       -- We must let-bind the lambda
-       newStgVar (coreExprType expr)   `thenUs` \ var ->
-       returnUs
-         (StgLet (StgNonRec var (StgRhsClosure noCCS
-                                 stgArgOcc
-                                 noSRT
-                                 bOGUS_FVs
-                                 ReEntrant     -- binders is non-empty
-                                 binders'
-                                 stg_body))
-          (StgApp var []))
+isForeignObjPrimTy ty
+   = case splitTyConApp_maybe ty of
+       Just (tycon, _) -> tycon == foreignObjPrimTyCon
+       Nothing         -> False
 \end{code}
 
-%************************************************************************
-%*                                                                     *
-\subsubsection[coreToStg-let(rec)]{Let and letrec expressions}
-%*                                                                     *
-%************************************************************************
-
 \begin{code}
-coreExprToStg env (Let bind body)
-  = coreBindToStg env     bind   `thenUs` \ (stg_binds, new_env) ->
-    coreExprToStg new_env body   `thenUs` \ stg_body ->
-    returnUs (foldr StgLet stg_body stg_binds)
+mkStgAlgAlts ty alts deflt
+ =  case alts of
+               -- Get the tycon from the data con
+       (dc, _, _, _) : _rest
+           -> StgAlgAlts (Just (dataConTyCon dc)) alts deflt
+
+               -- Otherwise just do your best
+       [] -> case splitTyConApp_maybe (repType ty) of
+               Just (tc,_) | isAlgTyCon tc 
+                       -> StgAlgAlts (Just tc) alts deflt
+               other
+                       -> StgAlgAlts Nothing alts deflt
+
+mkStgPrimAlts ty alts deflt 
+  = StgPrimAlts (tyConAppTyCon ty) alts deflt
 \end{code}
 
 
-%************************************************************************
-%*                                                                     *
-\subsubsection[coreToStg-scc]{SCC expressions}
-%*                                                                     *
-%************************************************************************
+-- ---------------------------------------------------------------------------
+-- Applications
+-- ---------------------------------------------------------------------------
 
-Covert core @scc@ expression directly to STG @scc@ expression.
 \begin{code}
-coreExprToStg env (Note (SCC cc) expr)
-  = coreExprToStg env expr   `thenUs` \ stg_expr ->
-    returnUs (StgSCC cc stg_expr)
-\end{code}
+coreToStgApp
+        :: Maybe UpdateFlag            -- Just upd <=> this application is
+                                       -- the rhs of a thunk binding
+                                       --      x = [...] \upd [] -> the_app
+                                       -- with specified update flag
+       -> Id                           -- Function
+       -> [CoreArg]                    -- Arguments
+       -> LneM (StgExpr, FreeVarsInfo, EscVarsSet)
+
+coreToStgApp maybe_thunk_body f args
+  = getVarsLiveInCont          `thenLne` \ live_in_cont ->
+    coreToStgArgs args         `thenLne` \ (args', args_fvs) ->
+    lookupVarLne f             `thenLne` \ how_bound ->
 
-\begin{code}
-coreExprToStg env (Note other_note expr) = coreExprToStg env expr
-\end{code}
+    let
+       n_args           = length args
+       not_letrec_bound = not (isLetrecBound how_bound)
+       fun_fvs          = singletonFVInfo f how_bound fun_occ
+
+       -- Mostly, the arity info of a function is in the fn's IdInfo
+       -- But new bindings introduced by CoreSat may not have no
+       -- arity info; it would do us no good anyway.  For example:
+       --      let f = \ab -> e in f
+       -- No point in having correct arity info for f!
+       -- Hence the hasArity stuff below.
+       f_arity_info     = idArityInfo f
+       f_arity          = arityLowerBound f_arity_info         -- Zero if no info
+
+       fun_occ 
+        | not_letrec_bound                 = noBinderInfo      -- Uninteresting variable
+        | f_arity > 0 && f_arity <= n_args = stgSatOcc         -- Saturated or over-saturated function call
+        | otherwise                        = stgUnsatOcc       -- Unsaturated function or thunk
+
+       fun_escs
+        | not_letrec_bound  = emptyVarSet      -- Only letrec-bound escapees are interesting
+        | hasArity f_arity_info &&
+          f_arity == n_args = emptyVarSet      -- A function *or thunk* with an exactly
+                                               -- saturated call doesn't escape
+                                               -- (let-no-escape applies to 'thunks' too)
+
+        | otherwise         = unitVarSet f     -- Inexact application; it does escape
+
+       -- At the moment of the call:
+
+       --  either the function is *not* let-no-escaped, in which case
+       --         nothing is live except live_in_cont
+       --      or the function *is* let-no-escaped in which case the
+       --         variables it uses are live, but still the function
+       --         itself is not.  PS.  In this case, the function's
+       --         live vars should already include those of the
+       --         continuation, but it does no harm to just union the
+       --         two regardless.
+
+       app = case idFlavour f of
+               DataConId dc -> StgConApp dc args'
+               PrimOpId op  -> StgPrimApp op args' (exprType (mkApps (Var f) args))
+               _other       -> StgApp f args'
 
-The rest are handled by coreExprStgFloat.
+    in
+    returnLne (
+       app,
+       fun_fvs  `unionFVInfo` args_fvs,
+       fun_escs `unionVarSet` (getFVSet args_fvs)
+                               -- All the free vars of the args are disqualified
+                               -- from being let-no-escaped.
+    )
 
-\begin{code}
-coreExprToStg env expr
-  = coreExprToStgFloat env expr  `thenUs` \ (binds,stg_expr) ->
-    returnUs (mkStgBinds binds stg_expr)
-\end{code}
 
-%************************************************************************
-%*                                                                     *
-\subsubsection[coreToStg-applications]{Applications}
-%*                                                                     *
-%************************************************************************
 
-\begin{code}
-coreExprToStgFloat env expr@(App _ _)
-  = let
-       (fun,args)    = collect_args expr []
+-- ---------------------------------------------------------------------------
+-- Argument lists
+-- This is the guy that turns applications into A-normal form
+-- ---------------------------------------------------------------------------
+
+coreToStgArgs :: [CoreArg] -> LneM ([StgArg], FreeVarsInfo)
+coreToStgArgs []
+  = returnLne ([], emptyFVInfo)
+
+coreToStgArgs (Type ty : args) -- Type argument
+  = coreToStgArgs args `thenLne` \ (args', fvs) ->
+    if opt_KeepStgTypes then
+       returnLne (StgTypeArg ty : args', fvs `unionFVInfo` tyvarFVInfo (tyVarsOfType ty))
+    else
+    returnLne (args', fvs)
+
+coreToStgArgs (arg : args)     -- Non-type argument
+  = coreToStgArgs args `thenLne` \ (stg_args, args_fvs) ->
+    coreToStgExpr arg  `thenLne` \ (arg', arg_fvs, escs) ->
+    let
+       fvs = args_fvs `unionFVInfo` arg_fvs
+       stg_arg = case arg' of
+                      StgApp v []      -> StgVarArg v
+                      StgConApp con [] -> StgVarArg (dataConWrapId con)
+                      StgLit lit       -> StgLitArg lit
+                      _                -> pprPanic "coreToStgArgs" (ppr arg)
+    in
+    returnLne (stg_arg : stg_args, fvs)
+
+
+-- ---------------------------------------------------------------------------
+-- The magic for lets:
+-- ---------------------------------------------------------------------------
+
+coreToStgLet
+        :: Bool        -- True <=> yes, we are let-no-escaping this let
+        -> CoreBind    -- bindings
+        -> CoreExpr    -- body
+        -> LneM (StgExpr,      -- new let
+                 FreeVarsInfo, -- variables free in the whole let
+                 EscVarsSet,   -- variables that escape from the whole let
+                 Bool)         -- True <=> none of the binders in the bindings
+                               -- is among the escaping vars
+
+coreToStgLet let_no_escape bind body
+  = fixLne (\ ~(_, _, _, rec_bind_lvs, _, rec_body_fvs, _, _) ->
+
+       -- Do the bindings, setting live_in_cont to empty if
+       -- we ain't in a let-no-escape world
+       getVarsLiveInCont               `thenLne` \ live_in_cont ->
+       setVarsLiveInCont
+               (if let_no_escape then live_in_cont else emptyVarSet)
+               (vars_bind rec_bind_lvs rec_body_fvs bind)
+                           `thenLne` \ (bind2, bind_fvs, bind_escs, env_ext) ->
+
+       -- The live variables of this binding are the ones which are live
+       -- by virtue of being accessible via the free vars of the binding (lvs_from_fvs)
+       -- together with the live_in_cont ones
+       lookupLiveVarsForSet (bind_fvs `minusFVBinders` binders)
+                               `thenLne` \ lvs_from_fvs ->
+       let
+               bind_lvs = lvs_from_fvs `unionVarSet` live_in_cont
+       in
+
+       -- bind_fvs and bind_escs still include the binders of the let(rec)
+       -- but bind_lvs does not
+
+       -- Do the body
+       extendVarEnvLne env_ext (
+               coreToStgExpr body                      `thenLne` \ (body2, body_fvs, body_escs) ->
+               lookupLiveVarsForSet body_fvs   `thenLne` \ body_lvs ->
+
+               returnLne (bind2, bind_fvs, bind_escs, bind_lvs,
+                          body2, body_fvs, body_escs, body_lvs)
+
+    )) `thenLne` (\ (bind2, bind_fvs, bind_escs, bind_lvs,
+                    body2, body_fvs, body_escs, body_lvs) ->
+
+
+       -- Compute the new let-expression
+    let
+       new_let | let_no_escape = StgLetNoEscape live_in_whole_let bind_lvs bind2 body2
+               | otherwise     = StgLet bind2 body2
+
+       free_in_whole_let
+         = (bind_fvs `unionFVInfo` body_fvs) `minusFVBinders` binders
+
+       live_in_whole_let
+         = bind_lvs `unionVarSet` (body_lvs `minusVarSet` set_of_binders)
+
+       real_bind_escs = if let_no_escape then
+                           bind_escs
+                        else
+                           getFVSet bind_fvs
+                           -- Everything escapes which is free in the bindings
+
+       let_escs = (real_bind_escs `unionVarSet` body_escs) `minusVarSet` set_of_binders
+
+       all_escs = bind_escs `unionVarSet` body_escs    -- Still includes binders of
+                                                       -- this let(rec)
+
+       no_binder_escapes = isEmptyVarSet (set_of_binders `intersectVarSet` all_escs)
+
+#ifdef DEBUG
+       -- Debugging code as requested by Andrew Kennedy
+       checked_no_binder_escapes
+               | not no_binder_escapes && any is_join_var binders
+               = pprTrace "Interesting!  A join var that isn't let-no-escaped" (ppr binders)
+                 False
+               | otherwise = no_binder_escapes
+#else
+       checked_no_binder_escapes = no_binder_escapes
+#endif
+                           
+               -- Mustn't depend on the passed-in let_no_escape flag, since
+               -- no_binder_escapes is used by the caller to derive the flag!
     in
-    coreArgsToStg env args             `thenUs` \ (binds, stg_args) ->
-
-       -- Now deal with the function
-    case (fun, stg_args) of
-      (Var fun_id, _) ->       -- A function Id, so do an StgApp; it's ok if
-                               -- there are no arguments.
-                           returnUs (binds, 
-                                  StgApp (stgLookup env fun_id) stg_args)
-
-      (non_var_fun, []) ->     -- No value args, so recurse into the function
-                           ASSERT( null binds )
-                           coreExprToStg env non_var_fun `thenUs` \e ->
-                           returnUs ([], e)
-
-      other -> -- A non-variable applied to things; better let-bind it.
-               newStgVar (coreExprType fun)    `thenUs` \ fun_id ->
-               coreExprToStg env fun           `thenUs` \ (stg_fun) ->
+    returnLne (
+       new_let,
+       free_in_whole_let,
+       let_escs,
+       checked_no_binder_escapes
+    ))
+  where
+    set_of_binders = mkVarSet binders
+    binders       = case bind of
+                       NonRec binder rhs -> [binder]
+                       Rec pairs         -> map fst pairs
+
+    mk_binding bind_lvs binder
+       = (binder,  LetrecBound  False          -- Not top level
+                       live_vars
+          )
+       where
+          live_vars = if let_no_escape then
+                           extendVarSet bind_lvs binder
+                      else
+                           unitVarSet binder
+
+    vars_bind :: StgLiveVars
+             -> FreeVarsInfo                   -- Free var info for body of binding
+             -> CoreBind
+             -> LneM (StgBinding,
+                      FreeVarsInfo, EscVarsSet,        -- free vars; escapee vars
+                      [(Id, HowBound)])
+                                        -- extension to environment
+
+    vars_bind rec_bind_lvs rec_body_fvs (NonRec binder rhs)
+      = coreToStgRhs rec_body_fvs NotTopLevel (binder,rhs)
+                                       `thenLne` \ (rhs2, fvs, escs) ->
+       let
+           env_ext_item@(binder', _) = mk_binding rec_bind_lvs binder
+       in
+       returnLne (StgNonRec binder' rhs2, fvs, escs, [env_ext_item])
+
+    vars_bind rec_bind_lvs rec_body_fvs (Rec pairs)
+      = let
+           binders = map fst pairs
+           env_ext = map (mk_binding rec_bind_lvs) binders
+       in
+       extendVarEnvLne env_ext           (
+       fixLne (\ ~(_, rec_rhs_fvs, _, _) ->
                let
-                  fun_rhs = StgRhsClosure noCCS    -- No cost centre (ToDo?)
-                                          stgArgOcc
-                                          noSRT
-                                          bOGUS_FVs
-                                          SingleEntry  -- Only entered once
-                                          []
-                                          stg_fun
+                       rec_scope_fvs = unionFVInfo rec_body_fvs rec_rhs_fvs
                in
-               returnUs (binds,
-                         StgLet (StgNonRec fun_id fun_rhs) $
-                         StgApp fun_id stg_args)
-  where
-       -- Collect arguments
-    collect_args (App fun arg)            args = collect_args fun (arg:args)
-    collect_args (Note (Coerce _ _) expr) args = collect_args expr args
-    collect_args (Note InlineCall   expr) args = collect_args expr args
-    collect_args fun                      args = (fun, args)
+               mapAndUnzip3Lne (coreToStgRhs rec_scope_fvs NotTopLevel) pairs 
+                                       `thenLne` \ (rhss2, fvss, escss) ->
+               let
+                       fvs  = unionFVInfos      fvss
+                       escs = unionVarSets escss
+               in
+               returnLne (StgRec (binders `zip` rhss2), fvs, escs, env_ext)
+       ))
+
+is_join_var :: Id -> Bool
+-- A hack (used only for compiler debuggging) to tell if
+-- a variable started life as a join point ($j)
+is_join_var j = occNameUserString (getOccName j) == "$j"
 \end{code}
 
 %************************************************************************
 %*                                                                     *
-\subsubsection[coreToStg-con]{Constructors}
+\subsection[LNE-monad]{A little monad for this let-no-escaping pass}
 %*                                                                     *
 %************************************************************************
 
+There's a lot of stuff to pass around, so we use this @LneM@ monad to
+help.  All the stuff here is only passed {\em down}.
+
 \begin{code}
-coreExprToStgFloat env expr@(Con (PrimOp (CCallOp (Right _) a b c)) args)
-  = getUniqueUs                        `thenUs` \ u ->
-    coreArgsToStg env args      `thenUs` \ (binds, stg_atoms) ->
-    let con' = PrimOp (CCallOp (Right u) a b c) in
-    returnUs (binds, StgCon con' stg_atoms (coreExprType expr))
-
-coreExprToStgFloat env expr@(Con con args)
-  = coreArgsToStg env args     `thenUs` \ (binds, stg_atoms) ->
-    returnUs (binds, StgCon con stg_atoms (coreExprType expr))
+type LneM a =  IdEnv HowBound
+           -> StgLiveVars              -- vars live in continuation
+           -> a
+
+data HowBound
+  = ImportBound
+  | CaseBound
+  | LambdaBound
+  | LetrecBound
+       Bool            -- True <=> bound at top level
+       StgLiveVars     -- Live vars... see notes below
+
+isLetrecBound (LetrecBound _ _) = True
+isLetrecBound other            = False
 \end{code}
 
-%************************************************************************
-%*                                                                     *
-\subsubsection[coreToStg-cases]{Case expressions}
-%*                                                                     *
-%************************************************************************
+For a let(rec)-bound variable, x, we record StgLiveVars, the set of
+variables that are live if x is live.  For "normal" variables that is
+just x alone.  If x is a let-no-escaped variable then x is represented
+by a code pointer and a stack pointer (well, one for each stack).  So
+all of the variables needed in the execution of x are live if x is,
+and are therefore recorded in the LetrecBound constructor; x itself
+*is* included.
 
+The set of live variables is guaranteed ot have no further let-no-escaped
+variables in it.
+
+The std monad functions:
 \begin{code}
-coreExprToStgFloat env expr@(Case scrut bndr alts)
-  = coreExprToStgFloat env scrut               `thenUs` \ (binds, scrut') ->
-    newEvaldLocalId env bndr                   `thenUs` \ (env', bndr') ->
-    alts_to_stg env' (findDefault alts)                `thenUs` \ alts' ->
-    returnUs (binds, mkStgCase scrut' bndr' alts')
+initLne :: LneM a -> a
+initLne m = m emptyVarEnv emptyVarSet
+
+{-# INLINE thenLne #-}
+{-# INLINE returnLne #-}
+
+returnLne :: a -> LneM a
+returnLne e env lvs_cont = e
+
+thenLne :: LneM a -> (a -> LneM b) -> LneM b
+thenLne m k env lvs_cont
+  = k (m env lvs_cont) env lvs_cont
+
+mapLne  :: (a -> LneM b)   -> [a] -> LneM [b]
+mapLne f [] = returnLne []
+mapLne f (x:xs)
+  = f x                `thenLne` \ r  ->
+    mapLne f xs        `thenLne` \ rs ->
+    returnLne (r:rs)
+
+mapAndUnzipLne  :: (a -> LneM (b,c))   -> [a] -> LneM ([b],[c])
+
+mapAndUnzipLne f [] = returnLne ([],[])
+mapAndUnzipLne f (x:xs)
+  = f x                        `thenLne` \ (r1,  r2)  ->
+    mapAndUnzipLne f xs        `thenLne` \ (rs1, rs2) ->
+    returnLne (r1:rs1, r2:rs2)
+
+mapAndUnzip3Lne :: (a -> LneM (b,c,d)) -> [a] -> LneM ([b],[c],[d])
+
+mapAndUnzip3Lne f []   = returnLne ([],[],[])
+mapAndUnzip3Lne f (x:xs)
+  = f x                         `thenLne` \ (r1,  r2,  r3)  ->
+    mapAndUnzip3Lne f xs `thenLne` \ (rs1, rs2, rs3) ->
+    returnLne (r1:rs1, r2:rs2, r3:rs3)
+
+fixLne :: (a -> LneM a) -> LneM a
+fixLne expr env lvs_cont
+  = result
   where
-    scrut_ty  = idType bndr
-    prim_case = isUnLiftedType scrut_ty && not (isUnboxedTupleType scrut_ty)
-
-    alts_to_stg env (alts, deflt)
-      | prim_case
-      = default_to_stg env deflt               `thenUs` \ deflt' ->
-       mapUs (prim_alt_to_stg env) alts        `thenUs` \ alts' ->
-       returnUs (StgPrimAlts scrut_ty alts' deflt')
-
-      | otherwise
-      = default_to_stg env deflt               `thenUs` \ deflt' ->
-       mapUs (alg_alt_to_stg env) alts         `thenUs` \ alts' ->
-       returnUs (StgAlgAlts scrut_ty alts' deflt')
-
-    alg_alt_to_stg env (DataCon con, bs, rhs)
-         = coreExprToStg env rhs    `thenUs` \ stg_rhs ->
-           returnUs (con, filter isId bs, [ True | b <- bs ]{-bogus use mask-}, stg_rhs)
-               -- NB the filter isId.  Some of the binders may be
-               -- existential type variables, which STG doesn't care about
-
-    prim_alt_to_stg env (Literal lit, args, rhs)
-         = ASSERT( null args )
-           coreExprToStg env rhs    `thenUs` \ stg_rhs ->
-           returnUs (lit, stg_rhs)
-
-    default_to_stg env Nothing
-      = returnUs StgNoDefault
-
-    default_to_stg env (Just rhs)
-      = coreExprToStg env rhs    `thenUs` \ stg_rhs ->
-       returnUs (StgBindDefault stg_rhs)
-               -- The binder is used for prim cases and not otherwise
-               -- (hack for old code gen)
+    result = expr result env lvs_cont
 \end{code}
 
+Functions specific to this monad:
+
 \begin{code}
-coreExprToStgFloat env expr
-  = coreExprToStg env expr `thenUs` \stg_expr ->
-    returnUs ([], stg_expr)
+getVarsLiveInCont :: LneM StgLiveVars
+getVarsLiveInCont env lvs_cont = lvs_cont
+
+setVarsLiveInCont :: StgLiveVars -> LneM a -> LneM a
+setVarsLiveInCont new_lvs_cont expr env lvs_cont
+  = expr env new_lvs_cont
+
+extendVarEnvLne :: [(Id, HowBound)] -> LneM a -> LneM a
+extendVarEnvLne ids_w_howbound expr env lvs_cont
+  = expr (extendVarEnvList env ids_w_howbound) lvs_cont
+
+lookupVarLne :: Id -> LneM HowBound
+lookupVarLne v env lvs_cont
+  = returnLne (
+      case (lookupVarEnv env v) of
+       Just xx -> xx
+       Nothing -> ImportBound
+    ) env lvs_cont
+
+-- The result of lookupLiveVarsForSet, a set of live variables, is
+-- only ever tacked onto a decorated expression. It is never used as
+-- the basis of a control decision, which might give a black hole.
+
+lookupLiveVarsForSet :: FreeVarsInfo -> LneM StgLiveVars
+
+lookupLiveVarsForSet fvs env lvs_cont
+  = returnLne (unionVarSets (map do_one (getFVs fvs)))
+             env lvs_cont
+  where
+    do_one v
+      = if isLocalId v then
+           case (lookupVarEnv env v) of
+             Just (LetrecBound _ lvs) -> extendVarSet lvs v
+             Just _                   -> unitVarSet v
+             Nothing -> pprPanic "lookupVarEnv/do_one:" (ppr v)
+       else
+           emptyVarSet
 \end{code}
 
+
 %************************************************************************
 %*                                                                     *
-\subsection[coreToStg-misc]{Miscellaneous helping functions}
+\subsection[Free-var info]{Free variable information}
 %*                                                                     *
 %************************************************************************
 
-There's not anything interesting we can ASSERT about \tr{var} if it
-isn't in the StgEnv. (WDP 94/06)
-
 \begin{code}
-stgLookup :: StgEnv -> Id -> Id
-stgLookup env var = case (lookupVarEnv env var) of
-                     Nothing  -> var
-                     Just var -> var
+type FreeVarsInfo = VarEnv (Var, Bool, StgBinderInfo)
+       -- If f is mapped to noBinderInfo, that means
+       -- that f *is* mentioned (else it wouldn't be in the
+       -- IdEnv at all), but only in a saturated applications.
+       --
+       -- All case/lambda-bound things are also mapped to
+       -- noBinderInfo, since we aren't interested in their
+       -- occurence info.
+       --
+       -- The Bool is True <=> the Id is top level letrec bound
+       --
+       -- For ILX we track free var info for type variables too;
+       -- hence VarEnv not IdEnv
+
+type EscVarsSet = IdSet
 \end{code}
 
-Invent a fresh @Id@:
 \begin{code}
-newStgVar :: Type -> UniqSM Id
-newStgVar ty
- = getUniqueUs                 `thenUs` \ uniq ->
-   returnUs (mkSysLocal SLIT("stg") uniq ty)
-\end{code}
+emptyFVInfo :: FreeVarsInfo
+emptyFVInfo = emptyVarEnv
 
-\begin{code}
-newLocalId env id
-  | externallyVisibleId id
-  = returnUs (env, id)
+singletonFVInfo :: Id -> HowBound -> StgBinderInfo -> FreeVarsInfo
+singletonFVInfo id ImportBound              info = emptyVarEnv
+singletonFVInfo id (LetrecBound top_level _) info = unitVarEnv id (id, top_level, info)
+singletonFVInfo id other                    info = unitVarEnv id (id, False,     info)
 
-  | otherwise
-  =    -- Local binder, give it a new unique Id.
-    getUniqueUs                        `thenUs` \ uniq ->
-    let
-      id'     = setIdUnique id uniq
-      new_env = extendVarEnv env id id'
-    in
-    returnUs (new_env, id')
+tyvarFVInfo :: TyVarSet -> FreeVarsInfo
+tyvarFVInfo tvs = foldVarSet add emptyFVInfo tvs
+               where
+                 add tv fvs = extendVarEnv fvs tv (tv, False, noBinderInfo)
 
--- we overload the demandInfo field of an Id to indicate whether the Id is definitely
--- evaluated or not (i.e. whether it is a case binder).  This can be used to eliminate
--- some redundant cases (c.f. dataToTag# above).
+unionFVInfo :: FreeVarsInfo -> FreeVarsInfo -> FreeVarsInfo
+unionFVInfo fv1 fv2 = plusVarEnv_C plusFVInfo fv1 fv2
 
-newEvaldLocalId env id
-  = getUniqueUs                        `thenUs` \ uniq ->
-    let
-      id'     = setIdUnique id uniq `modifyIdInfo` setDemandInfo wwStrict
-      new_env = extendVarEnv env id id'
-    in
-    returnUs (new_env, id')
-
-newLocalIds :: StgEnv -> [Id] -> UniqSM (StgEnv, [Id])
-newLocalIds env []
-  = returnUs (env, [])
-newLocalIds env (b:bs)
-  = newLocalId env b   `thenUs` \ (env', b') ->
-    newLocalIds env' bs        `thenUs` \ (env'', bs') ->
-    returnUs (env'', b':bs')
-\end{code}
+unionFVInfos :: [FreeVarsInfo] -> FreeVarsInfo
+unionFVInfos fvs = foldr unionFVInfo emptyFVInfo fvs
+
+minusFVBinders :: FreeVarsInfo -> [Id] -> FreeVarsInfo
+minusFVBinders fv ids = fv `delVarEnvList` ids
+
+elementOfFVInfo :: Id -> FreeVarsInfo -> Bool
+elementOfFVInfo id fvs = maybeToBool (lookupVarEnv fvs id)
+
+lookupFVInfo :: FreeVarsInfo -> Id -> StgBinderInfo
+-- Find how the given Id is used.
+-- Externally visible things may be used any old how
+lookupFVInfo fvs id 
+  | isExternallyVisibleName (idName id) = noBinderInfo
+  | otherwise = case lookupVarEnv fvs id of
+                       Nothing         -> noBinderInfo
+                       Just (_,_,info) -> info
 
+getFVs :: FreeVarsInfo -> [Id] -- Non-top-level things only
+getFVs fvs = [id | (id,False,_) <- rngVarEnv fvs]
 
+getFVSet :: FreeVarsInfo -> IdSet
+getFVSet fvs = mkVarSet (getFVs fvs)
+
+plusFVInfo (id1,top1,info1) (id2,top2,info2)
+  = ASSERT (id1 == id2 && top1 == top2)
+    (id1, top1, combineStgBinderInfo info1 info2)
+\end{code}
+
+Misc.
 \begin{code}
-mkStgBinds :: [StgFloatBind] -> StgExpr -> StgExpr
-mkStgBinds binds body = foldr mkStgBind body binds
-
-mkStgBind (CaseBind bndr rhs) body
-  | isUnLiftedType bndr_ty
-  = mkStgCase rhs bndr (StgPrimAlts bndr_ty [] (StgBindDefault body))
-  | otherwise
-  = mkStgCase rhs bndr (StgAlgAlts bndr_ty [] (StgBindDefault body))
-  where
-    bndr_ty = idType bndr
+filterStgBinders :: [Var] -> [Var]
+filterStgBinders bndrs
+  | opt_KeepStgTypes = bndrs
+  | otherwise       = filter isId bndrs
+\end{code}
 
-mkStgBind (LetBind bndr rhs) body
-  | isUnboxedTupleType bndr_ty
-  = panic "mkStgBinds: unboxed tuple"
-  | isUnLiftedType bndr_ty
-  = mkStgCase rhs bndr (StgPrimAlts bndr_ty [] (StgBindDefault body))
 
-  | otherwise
-  = StgLet (StgNonRec bndr (exprToRhs rhs)) body
+\begin{code}
+       -- Ignore all notes except SCC
+myCollectBinders expr
+  = go [] expr
   where
-    bndr_ty = idType bndr
-
-mkStgCase (StgLet bind expr) bndr alts
-  = StgLet bind (mkStgCase expr bndr alts)
-mkStgCase scrut bndr alts
-  = StgCase scrut bOGUS_LVs bOGUS_LVs bndr noSRT alts
+    go bs (Lam b e)          = go (b:bs) e
+    go bs e@(Note (SCC _) _) = (reverse bs, e) 
+    go bs (Note _ e)         = go bs e
+    go bs e                 = (reverse bs, e)
+
+myCollectArgs :: CoreExpr -> (Id, [CoreArg])
+       -- We assume that we only have variables
+       -- in the function position by now
+myCollectArgs expr
+  = go expr []
+  where
+    go (Var v)          as = (v, as)
+    go (App f a) as        = go f (a:as)
+    go (Note (SCC _) e) as = pprPanic "CoreToStg.myCollectArgs" (ppr expr)
+    go (Note n e)       as = go e as
+    go _               as = pprPanic "CoreToStg.myCollectArgs" (ppr expr)
 \end{code}