[project @ 1998-12-02 13:17:09 by simonm]
[ghc-hetmet.git] / ghc / compiler / prelude / PrelVals.lhs
index 733c49b..541dceb 100644 (file)
@@ -1,5 +1,5 @@
 %
-% (c) The GRASP/AQUA Project, Glasgow University, 1992-1996
+% (c) The GRASP/AQUA Project, Glasgow University, 1992-1998
 %
 \section[PrelVals]{Prelude values the compiler ``knows about''}
 
@@ -10,8 +10,7 @@ module PrelVals where
 
 import {-# SOURCE #-} CoreUnfold ( mkUnfolding )
 
-import Id              ( Id, mkVanillaId, mkTemplateLocals  )
-import SpecEnv         ( SpecEnv, emptySpecEnv )
+import Id              ( Id, mkVanillaId, setIdInfo, mkTemplateLocals  )
 
 -- friends:
 import PrelMods
@@ -23,34 +22,55 @@ import CoreSyn              -- quite a bit
 import IdInfo          -- quite a bit
 import Name            ( mkWiredInIdName, Module )
 import Type            
-import TyVar           ( openAlphaTyVar, openAlphaTyVars, alphaTyVar, betaTyVar, TyVar )
+import Var             ( TyVar )
 import Unique          -- lots of *Keys
-import Util            ( panic )
+
+import IOExts
 \end{code}
 
-\begin{code}
--- only used herein:
+%************************************************************************
+%*                                                                     *
+\subsection{Un-definable}
+%*                                                                     *
+%************************************************************************
 
-mk_inline_unfolding expr = setUnfoldingInfo (mkUnfolding expr) $
-                          setInlinePragInfo IWantToBeINLINEd  noIdInfo
+These two can't be defined in Haskell.
 
-exactArityInfo n = exactArity n `setArityInfo` noIdInfo
 
-pcMiscPrelId :: Unique{-IdKey-} -> Module -> FAST_STRING -> Type -> IdInfo -> Id
+unsafeCoerce# isn't so much a PrimOp as a phantom identifier, that
+just gets expanded into a type coercion wherever it occurs.  Hence we
+add it as a built-in Id with an unfolding here.
 
-pcMiscPrelId key mod occ ty info
-  = let
-       name = mkWiredInIdName key mod occ imp
-       imp  = mkVanillaId name ty info -- the usual case...
-    in
-    imp
-    -- We lie and say the thing is imported; otherwise, we get into
-    -- a mess with dependency analysis; e.g., core2stg may heave in
-    -- random calls to GHCbase.unpackPS__.  If GHCbase is the module
-    -- being compiled, then it's just a matter of luck if the definition
-    -- will be in "the right place" to be in scope.
+The type variables we use here are "open" type variables: this means
+they can unify with both unlifted and lifted types.  Hence we provide
+another gun with which to shoot yourself in the foot.
+
+\begin{code}
+unsafeCoerceId
+  = pcMiscPrelId unsafeCoerceIdKey pREL_GHC SLIT("unsafeCoerce#") ty
+       (mk_inline_unfolding template)
+  where
+    (alphaTyVar:betaTyVar:_) = openAlphaTyVars
+    alphaTy  = mkTyVarTy alphaTyVar
+    betaTy   = mkTyVarTy betaTyVar
+    ty = mkForAllTys [alphaTyVar,betaTyVar] (mkFunTy alphaTy betaTy)
+    [x] = mkTemplateLocals [alphaTy]
+    template = mkLams [alphaTyVar,betaTyVar,x] $
+              Note (Coerce betaTy alphaTy) (Var x)
+\end{code}
+
+
+@realWorld#@ used to be a magic literal, \tr{void#}.  If things get
+nasty as-is, change it back to a literal (@Literal@).
+
+\begin{code}
+realWorldPrimId
+  = pcMiscPrelId realWorldPrimIdKey pREL_GHC SLIT("realWorld#")
+       realWorldStatePrimTy
+       noCafIdInfo
 \end{code}
 
+
 %************************************************************************
 %*                                                                     *
 \subsection[PrelVals-error-related]{@error@ and friends; @trace@}
@@ -65,7 +85,8 @@ strings---this saves space!
 
 @absentErr@ is a thing we put in for ``absent'' arguments.  They jolly
 well shouldn't be yanked on, but if one is, then you will get a
-friendly message from @absentErr@ (rather a totally random crash).
+friendly message from @absentErr@ (rather than a totally random
+crash).
 
 @parError@ is a special version of @error@ which the compiler does
 not know to be a bottoming Id.  It is used in the @_par_@ and @_seq_@
@@ -75,7 +96,7 @@ templates, but we don't ever expect to generate code for it.
 pc_bottoming_Id key mod name ty
  = pcMiscPrelId key mod name ty bottoming_info
  where
-    bottoming_info = mkBottomStrictnessInfo `setStrictnessInfo` noIdInfo
+    bottoming_info = mkBottomStrictnessInfo `setStrictnessInfo` noCafIdInfo
        -- these "bottom" out, no matter what their arguments
 
 eRROR_ID
@@ -105,7 +126,7 @@ aBSENT_ERROR_ID
 
 pAR_ERROR_ID
   = pcMiscPrelId parErrorIdKey pREL_ERR SLIT("parError")
-    (mkSigmaTy [openAlphaTyVar] [] openAlphaTy) noIdInfo
+    (mkSigmaTy [openAlphaTyVar] [] openAlphaTy) noCafIdInfo
 
 openAlphaTy = mkTyVarTy openAlphaTyVar
 
@@ -116,583 +137,38 @@ errorTy  = mkSigmaTy [openAlphaTyVar] [] (mkFunTys [mkListTy charTy] openAlphaTy
     -- returns, so the return type is irrelevant.
 \end{code}
 
-unsafeCoerce# isn't so much a PrimOp as a phantom identifier, that
-just gets expanded into a type coercion wherever it occurs.  Hence we
-add it as a built-in Id with an unfolding here.
-
-\begin{code}
-unsafeCoerceId
-  = pcMiscPrelId unsafeCoerceIdKey pREL_GHC SLIT("unsafeCoerce#") ty
-       (mk_inline_unfolding template)
-  where
-     (alphaTyVar:betaTyVar:_) = openAlphaTyVars
-     alphaTy  = mkTyVarTy alphaTyVar
-     betaTy   = mkTyVarTy betaTyVar
-     ty = mkForAllTys [alphaTyVar,betaTyVar] (mkFunTy alphaTy betaTy)
-     [x] = mkTemplateLocals [alphaTy]
-     template = mkLam [alphaTyVar,betaTyVar] [x] $
-              Note (Coerce betaTy alphaTy) (Var x)
-
-\end{code}
-
-We want \tr{GHCbase.trace} to be wired in
-because we don't want the strictness analyser to get ahold of it,
-decide that the second argument is strict, evaluate that first (!!),
-and make a jolly old mess.
-\begin{code}
-tRACE_ID
-  = pcMiscPrelId traceIdKey pREL_IO_BASE SLIT("trace") traceTy
-       (pcGenerateSpecs traceIdKey tRACE_ID noIdInfo traceTy `setSpecInfo` noIdInfo)
-  where
-    traceTy = mkSigmaTy [alphaTyVar] [] (mkFunTys [mkListTy charTy, alphaTy] alphaTy)
-\end{code}
 
 %************************************************************************
 %*                                                                     *
-\subsection[PrelVals-Integer-support]{To support @Integer@ and @String@ literals}
+\subsection{Utilities}
 %*                                                                     *
 %************************************************************************
 
-\begin{code}
-packStringForCId
-  = pcMiscPrelId packCStringIdKey{-ToDo:rename-} pREL_PACK SLIT("packCString#")
-       (mkFunTys [stringTy] byteArrayPrimTy) noIdInfo
-
---------------------------------------------------------------------
-
-unpackCStringId
-  = pcMiscPrelId unpackCStringIdKey pREL_PACK SLIT("unpackCString#")
-                (mkFunTys [addrPrimTy{-a char *-}] stringTy) noIdInfo
--- Andy says:
---     (FunTy addrPrimTy{-a char *-} stringTy) (exactArityInfo 1)
--- but I don't like wired-in IdInfos (WDP)
-
-unpackCString2Id -- for cases when a string has a NUL in it
-  = pcMiscPrelId unpackCString2IdKey pREL_PACK SLIT("unpackNBytes#")
-                (mkFunTys [addrPrimTy{-a char *-}, intPrimTy{-length-}] stringTy)
-                noIdInfo
-
---------------------------------------------------------------------
-unpackCStringAppendId
-  = pcMiscPrelId unpackCStringAppendIdKey pREL_PACK SLIT("unpackAppendCString#")
-               (mkFunTys [addrPrimTy{-a "char *" pointer-},stringTy] stringTy)
-               (exactArityInfo 2)
-
-unpackCStringFoldrId
-  = pcMiscPrelId unpackCStringFoldrIdKey pREL_PACK SLIT("unpackFoldrCString#")
-               (mkSigmaTy [alphaTyVar] []
-               (mkFunTys [addrPrimTy{-a "char *" pointer-},
-                          mkFunTys [charTy, alphaTy] alphaTy,
-                          alphaTy]
-                         alphaTy))
-               (exactArityInfo 3)
-\end{code}
-
-OK, this is Will's idea: we should have magic values for Integers 0,
-+1, +2, and -1 (go ahead, fire me):
+Note IMustBeINLINEd below.  These things have the same status as
+constructor functions, i.e. they will *always* be inlined, wherever
+they occur.
 
 \begin{code}
-integerZeroId
-  = pcMiscPrelId integerZeroIdKey     pREL_NUM SLIT("integer_0")  integerTy noIdInfo
-integerPlusOneId
-  = pcMiscPrelId integerPlusOneIdKey  pREL_NUM SLIT("integer_1")  integerTy noIdInfo
-integerPlusTwoId
-  = pcMiscPrelId integerPlusTwoIdKey  pREL_NUM SLIT("integer_2")  integerTy noIdInfo
-integerMinusOneId
-  = pcMiscPrelId integerMinusOneIdKey pREL_NUM SLIT("integer_m1") integerTy noIdInfo
-\end{code}
-
-%************************************************************************
-%*                                                                     *
-\subsection[PrelVals-parallel]{@seq@ and @par@: for parallel operation (only)}
-%*                                                                     *
-%************************************************************************
-
-\begin{code}
-{- OUT:
---------------------------------------------------------------------
--- seqId :: "seq", used w/ GRIP, etc., is really quite similar to
--- dangerousEval
-{-
-   OLDER:
-   seq = /\ a b -> \ x y -> case x of { _ -> y }
-
-   OLD:
-   seq = /\ a b -> \ x y -> case seq# x y of { _Lift y' -> y' }
-
-   NEW (95/05):
-   seq = /\ a b -> \ x::a y::b -> case seq# x of { 0# -> parError#; _ -> y; }
-
--}
-
-seqId = pcMiscPrelId seqIdKey pRELUDE SLIT("seq")
-                 (mkSigmaTy [alphaTyVar, betaTyVar] []
-                   (mkFunTys [alphaTy, betaTy] betaTy))
-                 (mk_inline_unfolding seq_template)
-  where
-    [x, y, z]
-      = mkTemplateLocals [
-       {-x-} alphaTy,
-       {-y-} betaTy,
-       {-z-} intPrimTy
-       ]
-
-    seq_template
-      = mkLam [alphaTyVar, betaTyVar] [x, y] (
-               Case (Prim SeqOp [TyArg alphaTy, VarArg x]) (
-                 PrimAlts
-                   [(mkMachInt 0, mkTyApp (Var pAR_ERROR_ID) [betaTy])]
-                   (BindDefault z (Var y))))
-
---------------------------------------------------------------------
--- parId :: "par", also used w/ GRIP, etc.
-{-
-    OLDER:
-
-    par = /\ a b -> \ x y -> case (par# (case x of { _ -> () })) of { _ -> y }
-
-    OLD:
-
-    par = /\ a b -> \ x y -> case par# x y of { _Lift y' -> y' }
-
-    NEW (95/05):
-
-    par = /\ a b -> \ x::a y::b -> case par# x of { 0# -> parError#; _ -> y; }
-
--}
-parId = pcMiscPrelId parIdKey cONC_BASE SLIT("par")
-                 (mkSigmaTy [alphaTyVar, betaTyVar] []
-                   (mkFunTys [alphaTy, betaTy] betaTy))
-                 (mk_inline_unfolding par_template)
-  where
-    [x, y, z]
-      = mkTemplateLocals [
-       {-x-} alphaTy,
-       {-y-} betaTy,
-       {-z-} intPrimTy
-       ]
-
-    par_template
-      = mkLam [alphaTyVar, betaTyVar] [x, y] (
-               Case (Prim ParOp [TyArg alphaTy, VarArg x]) (
-                 PrimAlts
-                   [(mkMachInt 0, mkTyApp (Var pAR_ERROR_ID) [betaTy])]
-                   (BindDefault z (Var y))))
-
--- forkId :: "fork", for *required* concurrent threads
-{-
-   _fork_ = /\ a b -> \ x::a y::b -> case fork# x of { 0# -> parError#; _ -> y; }
--}
-forkId = pcMiscPrelId forkIdKey cONC_BASE SLIT("fork")
-                 (mkSigmaTy [alphaTyVar, betaTyVar] []
-                   (mkFunTys [alphaTy, betaTy] betaTy))
-                 (mk_inline_unfolding fork_template)
-  where
-    [x, y, z]
-      = mkTemplateLocals [
-       {-x-} alphaTy,
-       {-y-} betaTy,
-       {-z-} intPrimTy
-       ]
-
-    fork_template
-      = mkLam [alphaTyVar, betaTyVar] [x, y] (
-               Case (Prim ForkOp [TyArg alphaTy, VarArg x]) (
-                 PrimAlts
-                   [(mkMachInt 0, mkTyApp (Var pAR_ERROR_ID) [betaTy])]
-                   (BindDefault z (Var y))))
--}
-\end{code}
-
-GranSim ones:
-\begin{code}
-{- OUT:
-parLocalId = pcMiscPrelId parLocalIdKey cONC_BASE SLIT("parLocal")
-                 (mkSigmaTy [alphaTyVar, betaTyVar] []
-                   (mkFunTys [intPrimTy, intPrimTy, intPrimTy, intPrimTy, alphaTy, betaTy] betaTy))
-                 (mk_inline_unfolding parLocal_template)
-  where
-    -- Annotations: w: name, g: gran. info, s: size info, p: par info  -- HWL
-    [w, g, s, p, x, y, z]
-      = mkTemplateLocals [
-       {-w-} intPrimTy,
-       {-g-} intPrimTy,
-       {-s-} intPrimTy,
-       {-p-} intPrimTy,
-       {-x-} alphaTy,
-       {-y-} betaTy,
-       {-z-} intPrimTy
-       ]
-
-    parLocal_template
-      = mkLam [alphaTyVar, betaTyVar] [w, g, s, p, x, y] (
-               Case (Prim ParLocalOp [TyArg alphaTy, TyArg betaTy, VarArg x, VarArg w, VarArg g, VarArg s, VarArg p, VarArg y]) (
-                 PrimAlts
-                   [(mkMachInt 0, mkTyApp (Var pAR_ERROR_ID) [betaTy])]
-                   (BindDefault z (Var y))))
-
-parGlobalId = pcMiscPrelId parGlobalIdKey cONC_BASE SLIT("parGlobal")
-                 (mkSigmaTy [alphaTyVar, betaTyVar] []
-                   (mkFunTys [intPrimTy, intPrimTy, intPrimTy, intPrimTy, alphaTy, betaTy] betaTy))
-                 (mk_inline_unfolding parGlobal_template)
-  where
-    -- Annotations: w: name, g: gran. info, s: size info, p: par info  -- HWL
-    [w, g, s, p, x, y, z]
-      = mkTemplateLocals [
-       {-w-} intPrimTy,
-       {-g-} intPrimTy,
-       {-s-} intPrimTy,
-       {-p-} intPrimTy,
-       {-x-} alphaTy,
-       {-y-} betaTy,
-       {-z-} intPrimTy
-       ]
-
-    parGlobal_template
-      = mkLam [alphaTyVar, betaTyVar] [w, g, s, p, x, y] (
-               Case (Prim ParGlobalOp [TyArg alphaTy, TyArg betaTy, VarArg x, VarArg w, VarArg g, VarArg s, VarArg p, VarArg y]) (
-                 PrimAlts
-                   [(mkMachInt 0, mkTyApp (Var pAR_ERROR_ID) [betaTy])]
-                   (BindDefault z (Var y))))
-
-
-parAtId = pcMiscPrelId parAtIdKey cONC_BASE SLIT("parAt")
-                 (mkSigmaTy [alphaTyVar, betaTyVar] []
-                   (mkFunTys [intPrimTy, intPrimTy, intPrimTy, intPrimTy,
-                              alphaTy, betaTy, gammaTy] gammaTy))
-                 (mk_inline_unfolding parAt_template)
-  where
-    -- Annotations: w: name, g: gran. info, s: size info, p: par info  -- HWL
-    [w, g, s, p, v, x, y, z]
-      = mkTemplateLocals [
-       {-w-} intPrimTy,
-       {-g-} intPrimTy,
-       {-s-} intPrimTy,
-       {-p-} intPrimTy,
-       {-v-} alphaTy,
-       {-x-} betaTy,
-       {-y-} gammaTy,
-       {-z-} intPrimTy
-       ]
-
-    parAt_template
-      = mkLam [alphaTyVar, betaTyVar, gammaTyVar] [w, g, s, p, v, x, y] (
-               Case (Prim ParAtOp [TyArg alphaTy, TyArg betaTy, TyArg gammaTy, VarArg x, VarArg v, VarArg w, VarArg g, VarArg s, VarArg p, VarArg y]) (
-                 PrimAlts
-                   [(mkMachInt 0, mkTyApp (Var pAR_ERROR_ID) [gammaTy])]
-                   (BindDefault z (Var y))))
-
-parAtAbsId = pcMiscPrelId parAtAbsIdKey cONC_BASE SLIT("parAtAbs")
-                 (mkSigmaTy [alphaTyVar, betaTyVar] []
-                   (mkFunTys [intPrimTy, intPrimTy, intPrimTy, intPrimTy, intPrimTy, alphaTy, betaTy] betaTy))
-                 (mk_inline_unfolding parAtAbs_template)
-  where
-    -- Annotations: w: name, g: gran. info, s: size info, p: par info  -- HWL
-    [w, g, s, p, v, x, y, z]
-      = mkTemplateLocals [
-       {-w-} intPrimTy,
-       {-g-} intPrimTy,
-       {-s-} intPrimTy,
-       {-p-} intPrimTy,
-       {-v-} intPrimTy,
-       {-x-} alphaTy,
-       {-y-} betaTy,
-       {-z-} intPrimTy
-       ]
-
-    parAtAbs_template
-      = mkLam [alphaTyVar, betaTyVar] [w, g, s, p, v, x, y] (
-               Case (Prim ParAtAbsOp [TyArg alphaTy, TyArg betaTy, VarArg x, VarArg v, VarArg w, VarArg g, VarArg s, VarArg p, VarArg y]) (
-                 PrimAlts
-                   [(mkMachInt 0, mkTyApp (Var pAR_ERROR_ID) [betaTy])]
-                   (BindDefault z (Var y))))
-
-parAtRelId = pcMiscPrelId parAtRelIdKey cONC_BASE SLIT("parAtRel")
-                 (mkSigmaTy [alphaTyVar, betaTyVar] []
-                   (mkFunTys [intPrimTy, intPrimTy, intPrimTy, intPrimTy, intPrimTy, alphaTy, betaTy] betaTy))
-                 (mk_inline_unfolding parAtRel_template)
-  where
-    -- Annotations: w: name, g: gran. info, s: size info, p: par info  -- HWL
-    [w, g, s, p, v, x, y, z]
-      = mkTemplateLocals [
-       {-w-} intPrimTy,
-       {-g-} intPrimTy,
-       {-s-} intPrimTy,
-       {-p-} intPrimTy,
-       {-v-} intPrimTy,
-       {-x-} alphaTy,
-       {-y-} betaTy,
-       {-z-} intPrimTy
-       ]
-
-    parAtRel_template
-      = mkLam [alphaTyVar, betaTyVar] [w, g, s, p, v, x, y] (
-               Case (Prim ParAtRelOp [TyArg alphaTy, TyArg betaTy, VarArg x, VarArg v, VarArg w, VarArg g, VarArg s, VarArg p, VarArg y]) (
-                 PrimAlts
-                   [(mkMachInt 0, mkTyApp (Var pAR_ERROR_ID) [betaTy])]
-                   (BindDefault z (Var y))))
-
-parAtForNowId = pcMiscPrelId parAtForNowIdKey cONC_BASE SLIT("parAtForNow")
-                 (mkSigmaTy [alphaTyVar, betaTyVar] []
-                   (mkFunTys [intPrimTy, intPrimTy, intPrimTy, intPrimTy,
-                               alphaTy, betaTy, gammaTy] gammaTy))
-                 (mk_inline_unfolding parAtForNow_template)
-  where
-    -- Annotations: w: name, g: gran. info, s: size info, p: par info  -- HWL
-    [w, g, s, p, v, x, y, z]
-      = mkTemplateLocals [
-       {-w-} intPrimTy,
-       {-g-} intPrimTy,
-       {-s-} intPrimTy,
-       {-p-} intPrimTy,
-       {-v-} alphaTy,
-       {-x-} betaTy,
-       {-y-} gammaTy,
-       {-z-} intPrimTy
-       ]
-
-    parAtForNow_template
-      = mkLam [alphaTyVar, betaTyVar, gammaTyVar] [w, g, s, p, v, x, y] (
-               Case (Prim ParAtForNowOp [TyArg alphaTy, TyArg betaTy, TyArg gammaTy, VarArg x, VarArg v, VarArg w, VarArg g, VarArg s, VarArg p, VarArg y]) (
-                 PrimAlts
-                   [(mkMachInt 0, mkTyApp (Var pAR_ERROR_ID) [gammaTy])]
-                   (BindDefault z (Var y))))
-
--- copyable and noFollow are currently merely hooks: they are translated into
--- calls to the macros COPYABLE and NOFOLLOW                            -- HWL 
-
-copyableId = pcMiscPrelId copyableIdKey cONC_BASE SLIT("copyable")
-                 (mkSigmaTy [alphaTyVar] []
-                   alphaTy)
-                 (mk_inline_unfolding copyable_template)
-  where
-    -- Annotations: x: closure that's tagged to by copyable
-    [x, z]
-      = mkTemplateLocals [
-       {-x-} alphaTy,
-       {-z-} alphaTy
-       ]
-
-    copyable_template
-      = mkLam [alphaTyVar] [x] ( Prim CopyableOp [TyArg alphaTy, VarArg x] )
-
-noFollowId = pcMiscPrelId noFollowIdKey cONC_BASE SLIT("noFollow")
-                 (mkSigmaTy [alphaTyVar] []
-                   alphaTy)
-                 (mk_inline_unfolding noFollow_template)
-  where
-    -- Annotations: x: closure that's tagged to not follow
-    [x, z]
-      = mkTemplateLocals [
-       {-x-} alphaTy,
-       {-z-} alphaTy
-       ]
-
-    noFollow_template
-      = mkLam [alphaTyVar] [x] ( Prim NoFollowOp [TyArg alphaTy, VarArg x] )
--}
-\end{code}
-
-@realWorld#@ used to be a magic literal, \tr{void#}.  If things get
-nasty as-is, change it back to a literal (@Literal@).
-\begin{code}
-realWorldPrimId
-  = pcMiscPrelId realWorldPrimIdKey pREL_GHC SLIT("realWorld#")
-       realWorldStatePrimTy
-       noIdInfo
-\end{code}
-
-\begin{code}
-voidId = pc_bottoming_Id voidIdKey pREL_BASE SLIT("void") voidTy
-\end{code}
-
-%************************************************************************
-%*                                                                     *
-\subsection[PrelVals-foldr-build]{Values known about for ``foldr/build''}
-%*                                                                     *
-%************************************************************************
-
-\begin{code}
-buildId
-  = pcMiscPrelId buildIdKey pREL_ERR SLIT("build") buildTy
-       noIdInfo
-       {- LATER:`addUnfoldInfo` mkMagicUnfolding buildIdKey)
-               `addStrictnessInfo` mkStrictnessInfo [WwStrict] False)
-               `addArgUsageInfo` mkArgUsageInfo [ArgUsage 2])
-               `setSpecInfo` pcGenerateSpecs buildIdKey buildId noIdInfo{-ToDo-} buildTy)
-        -}
-       -- cheating, but since _build never actually exists ...
-  where
-    -- The type of this strange object is:
-    --  \/ a . (\/ b . (a -> b -> b) -> b -> b) -> [a]
-
-    buildTy = mkSigmaTy [alphaTyVar] [] (mkFunTys [build_ty] (mkListTy alphaTy))
-       where
-           build_ty = mkSigmaTy [betaTyVar] []
-                       (mkFunTys [mkFunTys [alphaTy, betaTy] betaTy, betaTy] betaTy)
-\end{code}
-
-@mkBuild@ is sugar for building a build!
-
-@mkbuild ty tv c n e@ $Rightarrow$ @build ty (/\ tv -> \ c n -> e)@
-@ty@ is the type of the list.
-@tv@ is always a new type variable.
-@c,n@ are Id's for the abstract cons and nil, @g@ for let binding the argument argument.
-       c :: a -> b -> b
-       n :: b
-       v :: (\/ b . (a -> b -> b) -> b -> b) -> [a]
---  \/ a .  (\/ b . (a -> b -> b) -> b -> b) -> [a]
-@e@ is the object right inside the @build@
+mk_inline_unfolding expr = setUnfoldingInfo (mkUnfolding expr) $
+                          setInlinePragInfo IMustBeINLINEd  noIdInfo
 
-\begin{code}
-mkBuild :: Type
-       -> TyVar
-       -> Id
-       -> Id
-       -> Id
-       -> CoreExpr -- template
-       -> CoreExpr -- template
-
-mkBuild ty tv c n g expr
-  = Let (NonRec g (mkLam [tv] [c,n] expr))
-       (App (mkTyApp (Var buildId) [ty]) (VarArg g))
-\end{code}
+exactArityInfo n = exactArity n `setArityInfo` noIdInfo
 
-\begin{code}
-augmentId
-  = pcMiscPrelId augmentIdKey pREL_ERR SLIT("augment") augmentTy
-       noIdInfo
-       {- LATER:`addUnfoldInfo` mkMagicUnfolding augmentIdKey)
-               `addStrictnessInfo` mkStrictnessInfo [WwStrict,WwLazy False] False)
-               `addArgUsageInfo` mkArgUsageInfo [ArgUsage 2,UnknownArgUsage])
-       -}
-       -- cheating, but since _augment never actually exists ...
-  where
-    -- The type of this strange object is:
-    --  \/ a . (\/ b . (a -> b -> b) -> b -> b) -> [a] -> [a]
+pcMiscPrelId :: Unique{-IdKey-} -> Module -> FAST_STRING -> Type -> IdInfo -> Id
 
-    augmentTy = mkSigmaTy [alphaTyVar] [] (mkFunTys [aug_ty, mkListTy alphaTy] (mkListTy alphaTy))
-       where
-           aug_ty = mkSigmaTy [betaTyVar] []
-                       (mkFunTys [mkFunTys [alphaTy, betaTy] betaTy, betaTy] betaTy)
-\end{code}
+pcMiscPrelId key mod occ ty info
+  = let
+       name = mkWiredInIdName key mod occ imp
+       imp  = mkVanillaId name ty `setIdInfo` info -- the usual case...
+    in
+    imp
+    -- We lie and say the thing is imported; otherwise, we get into
+    -- a mess with dependency analysis; e.g., core2stg may heave in
+    -- random calls to GHCbase.unpackPS__.  If GHCbase is the module
+    -- being compiled, then it's just a matter of luck if the definition
+    -- will be in "the right place" to be in scope.
 
-\begin{code}
-foldrId = pcMiscPrelId foldrIdKey pREL_BASE SLIT("foldr")
-                foldrTy idInfo
-  where
-       foldrTy =
-         mkSigmaTy [alphaTyVar, betaTyVar] []
-               (mkFunTys [mkFunTys [alphaTy, betaTy] betaTy, betaTy, mkListTy alphaTy] betaTy)
-
-       idInfo = noIdInfo
-               {- LATER: mkStrictnessInfo [WwLazy False,WwLazy False,WwStrict] False `setStrictnessInfo` 
-                exactArity 3 `setArityInfo`
-                mkUpdateInfo [2,2,1] `setUpdateInfo` 
-                pcGenerateSpecs foldrIdKey foldrId noIdInfo{-ToDo-} foldrTy `setSpecInfo`
-                noIdInfo
-               -}
-
-foldlId = pcMiscPrelId foldlIdKey pREL_LIST SLIT("foldl")
-                foldlTy idInfo
-  where
-       foldlTy =
-         mkSigmaTy [alphaTyVar, betaTyVar] []
-               (mkFunTys [mkFunTys [alphaTy, betaTy] alphaTy, alphaTy, mkListTy betaTy] alphaTy)
-
-       idInfo = noIdInfo
-                       {- LATER: `addUnfoldInfo` mkMagicUnfolding foldlIdKey)
-                       `addStrictnessInfo` mkStrictnessInfo [WwLazy False,WwLazy False,WwStrict] False)
-                       `addArityInfo` exactArity 3)
-                       `addUpdateInfo` mkUpdateInfo [2,2,1])
-                       `setSpecInfo` pcGenerateSpecs foldlIdKey foldlId noIdInfo{-ToDo-} foldlTy)
-               -}
-
--- A bit of magic goes no here. We translate appendId into ++,
--- you have to be carefull when you actually compile append:
---     xs ++ ys = augment (\ c n -> foldr c n xs) ys
---              {- unfold augment -}
---              = foldr (:) ys xs
---              {- fold foldr to append -}
---              = ys `appendId` xs
---              = ys ++ xs             -- ugg!
--- *BUT* you want (++) and not _append in your interfaces.
---
--- So you have to turn *off* unfolding of foldr inside FoldrBuild.hs inside
--- the prelude.
---
-{- OLD: doesn't apply with 1.3
-appendId
-  = pcMiscPrelId appendIdKey mONAD SLIT("++") appendTy idInfo
-  where
-    appendTy =
-      (mkSigmaTy [alphaTyVar] []
-           (mkFunTys [mkListTy alphaTy, mkListTy alphaTy] (mkListTy alphaTy)))
-    idInfo = (((noIdInfo
-               `addStrictnessInfo` mkStrictnessInfo [WwStrict,WwLazy False] False)
-               `addArityInfo` exactArity 2)
-               `addUpdateInfo` mkUpdateInfo [1,2])
--}
+-- very useful...
+noCafIdInfo = NoCafRefs `setCafInfo` noIdInfo
 \end{code}
 
-%************************************************************************
-%*                                                                     *
-\subsection[PrelUtils-specialisations]{Specialisations for builtin values}
-%*                                                                     *
-%************************************************************************
-
-The specialisations which exist for the builtin values must be recorded in
-their IdInfos.
-
-NOTE: THE USES OF THE pcGenerate... FUNCTIONS MUST CORRESPOND
-      TO THE SPECIALISATIONS DECLARED IN THE PRELUDE !!!
-
-HACK: We currently use the same unique for the specialised Ids.
-
-The list @specing_types@ determines the types for which specialised
-versions are created. Note: This should correspond with the
-types passed to the pre-processor with the -genSPECS arg (see ghc.lprl).
-
-ToDo: Create single mkworld definition which is grabbed here and in ghc.lprl
-
-\begin{code}
-pcGenerateSpecs :: Unique -> Id -> IdInfo -> Type -> IdSpecEnv
-pcGenerateSpecs key id info ty
-  = emptySpecEnv
-
-{- LATER:
-
-pc_gen_specs True key id info ty
-
-pc_gen_specs is_id key id info ty
- = mkSpecEnv spec_infos
- where
-   spec_infos = [ let spec_ty = specialiseTy ty spec_tys 0
-                     spec_id = if is_id
-                               then mkSpecId key {- HACK WARNING: same unique! -}
-                                             id spec_tys spec_ty info
-                               else panic "SpecData:SpecInfo:SpecId"
-                 in
-                 SpecInfo spec_tys (length ctxts) spec_id
-               | spec_tys <- specialisations ]
-
-   (tyvars, ctxts, _) = splitSigmaTy ty
-   no_tyvars         = length tyvars
-
-   specialisations    = if no_tyvars == 0
-                       then []
-                       else tail (cross_product no_tyvars specing_types)
-
-                       -- N.B. tail removes fully polymorphic specialisation
-
-cross_product 0 tys = []
-cross_product 1 tys = map (:[]) tys
-cross_product n tys = concat [map (:cp) tys | cp <- cross_product (n-1) tys]
-
-
-specing_types = [Nothing,
-                Just charPrimTy,
-                Just doublePrimTy,
-                Just intPrimTy ]
--}
-\end{code}