[project @ 2000-03-23 17:45:17 by simonpj]
[ghc-hetmet.git] / ghc / compiler / hsSyn / HsDecls.lhs
index 18f817a..6b7b509 100644 (file)
 %
-% (c) The GRASP/AQUA Project, Glasgow University, 1992-1996
+% (c) The GRASP/AQUA Project, Glasgow University, 1992-1998
 %
 \section[HsDecls]{Abstract syntax: global declarations}
 
-Definitions for: @FixityDecl@, @TyDecl@ and @ConDecl@, @ClassDecl@,
-@InstDecl@, @DefaultDecl@.
+Definitions for: @TyDecl@ and @ConDecl@, @ClassDecl@,
+@InstDecl@, @DefaultDecl@ and @ForeignDecl@.
 
 \begin{code}
-#include "HsVersions.h"
-
-module HsDecls where
+module HsDecls (
+       HsDecl(..), TyClDecl(..), InstDecl(..), RuleDecl(..), RuleBndr(..),
+       DefaultDecl(..), ForeignDecl(..), ForKind(..),
+       ExtName(..), isDynamicExtName, extNameStatic,
+       ConDecl(..), ConDetails(..), BangType(..),
+       IfaceSig(..),  SpecDataSig(..), 
+       hsDeclName, tyClDeclName, isClassDecl, isSynDecl, isDataDecl, countTyClDecls
+    ) where
 
-import Ubiq{-uitous-}
+#include "HsVersions.h"
 
 -- friends:
-import HsLoop          ( nullMonoBinds, MonoBinds, Sig )
-import HsPragmas       ( DataPragmas, ClassPragmas,
-                         InstancePragmas, ClassOpPragmas
-                       )
+import HsBinds         ( HsBinds, MonoBinds, Sig, FixitySig(..), nullMonoBinds )
+import HsExpr          ( HsExpr )
+import HsPragmas       ( DataPragmas, ClassPragmas )
 import HsTypes
+import HsCore          ( UfExpr, UfBinder, IfaceSig(..), UfRuleBody )
+import BasicTypes      ( Fixity, NewOrData(..) )
+import CallConv                ( CallConv, pprCallConv )
+import Var             ( TyVar )
 
 -- others:
-import Outputable
-import Pretty
-import ProtoName       ( cmpProtoName, ProtoName )
+import PprType
+import {-# SOURCE #-} FunDeps ( pprFundeps )
+import CStrings                ( CLabelString )
+import Outputable      
 import SrcLoc          ( SrcLoc )
-import Util            ( cmpList, panic#{-ToDo:rm eventually-} )
+import Util
 \end{code}
 
+
 %************************************************************************
 %*                                                                     *
-\subsection[FixityDecl]{A fixity declaration}
+\subsection[HsDecl]{Declarations}
 %*                                                                     *
 %************************************************************************
 
-These are only used in generating interfaces at the moment.  They are
-not used in pretty-printing.
+\begin{code}
+data HsDecl name pat
+  = TyClD      (TyClDecl name pat)
+  | InstD      (InstDecl  name pat)
+  | DefD       (DefaultDecl name)
+  | ValD       (HsBinds name pat)
+  | ForD        (ForeignDecl name)
+  | SigD       (IfaceSig name)
+  | FixD       (FixitySig name)
+  | RuleD      (RuleDecl name pat)
+
+-- NB: all top-level fixity decls are contained EITHER
+-- EITHER FixDs
+-- OR     in the ClassDecls in TyClDs
+--
+-- The former covers
+--     a) data constructors
+--     b) class methods (but they can be also done in the
+--             signatures of class decls)
+--     c) imported functions (that have an IfacSig)
+--     d) top level decls
+--
+-- The latter is for class methods only
+\end{code}
 
 \begin{code}
-data FixityDecl name
-  = InfixL     name Int
-  | InfixR     name Int
-  | InfixN     name Int
+#ifdef DEBUG
+hsDeclName :: (Outputable name, Outputable pat)
+          => HsDecl name pat -> name
+#endif
+hsDeclName (TyClD decl)                                 = tyClDeclName decl
+hsDeclName (SigD  (IfaceSig name _ _ _))        = name
+hsDeclName (InstD (InstDecl _ _ _ name _))       = name
+hsDeclName (ForD  (ForeignDecl name _ _ _ _ _))  = name
+hsDeclName (FixD  (FixitySig name _ _))                 = name
+-- Others don't make sense
+#ifdef DEBUG
+hsDeclName x                                 = pprPanic "HsDecls.hsDeclName" (ppr x)
+#endif
+
+tyClDeclName :: TyClDecl name pat -> name
+tyClDeclName (TyData _ _ name _ _ _ _ _)            = name
+tyClDeclName (TySynonym name _ _ _)                 = name
+tyClDeclName (ClassDecl _ name _ _ _ _ _ _ _ _ _ _) = name
 \end{code}
 
 \begin{code}
-instance (NamedThing name, Outputable name)
-     => Outputable (FixityDecl name) where
-    ppr sty (InfixL var prec)  = print_it sty "l" prec var
-    ppr sty (InfixR var prec)  = print_it sty "r" prec var
-    ppr sty (InfixN var prec)  = print_it sty ""  prec var
-
-print_it sty suff prec var
-  = ppBesides [ppStr "infix", ppStr suff, ppSP, ppInt prec, ppSP, pprOp sty var]
+instance (Outputable name, Outputable pat)
+       => Outputable (HsDecl name pat) where
+
+    ppr (TyClD dcl)  = ppr dcl
+    ppr (SigD sig)   = ppr sig
+    ppr (ValD binds) = ppr binds
+    ppr (DefD def)   = ppr def
+    ppr (InstD inst) = ppr inst
+    ppr (ForD fd)    = ppr fd
+    ppr (FixD fd)    = ppr fd
+    ppr (RuleD rd)   = ppr rd
 \end{code}
 
+
 %************************************************************************
 %*                                                                     *
 \subsection[TyDecl]{@data@, @newtype@ or @type@ (synonym) type declaration}
@@ -62,68 +112,105 @@ print_it sty suff prec var
 %************************************************************************
 
 \begin{code}
-data TyDecl name
-  = TyData     (Context name)  -- context
-               name            -- type constructor
-               [name]          -- type variables
-               [ConDecl name]  -- data constructors (empty if abstract)
-               (Maybe [name])  -- derivings; Nothing => not specified
-                               -- (i.e., derive default); Just [] => derive
-                               -- *nothing*; Just <list> => as you would
-                               -- expect...
+data TyClDecl name pat
+  = TyData     NewOrData
+               (HsContext name) -- context
+               name             -- type constructor
+               [HsTyVar name]   -- type variables
+               [ConDecl name]   -- data constructors (empty if abstract)
+               (Maybe [name])   -- derivings; Nothing => not specified
+                                -- (i.e., derive default); Just [] => derive
+                                -- *nothing*; Just <list> => as you would
+                                -- expect...
                (DataPragmas name)
                SrcLoc
 
-  | TyNew      (Context name)  -- context
-               name            -- type constructor
-               [name]          -- type variables
-               [ConDecl name]  -- data constructor (empty if abstract)
-               (Maybe [name])  -- derivings; as above
-               (DataPragmas name)
+  | TySynonym  name            -- type constructor
+               [HsTyVar name]  -- type variables
+               (HsType name)   -- synonym expansion
                SrcLoc
 
-  | TySynonym  name            -- type constructor
-               [name]          -- type variables
-               (MonoType name) -- synonym expansion
+  | ClassDecl  (HsContext name)        -- context...
+               name                    -- name of the class
+               [HsTyVar name]          -- the class type variables
+               [([name], [name])]      -- functional dependencies
+               [Sig name]              -- methods' signatures
+               (MonoBinds name pat)    -- default methods
+               (ClassPragmas name)
+               name name name [name]   -- The names of the tycon, datacon wrapper, datacon worker,
+                                       -- and superclass selectors for this class.
+                                       -- These are filled in as the ClassDecl is made.
                SrcLoc
+\end{code}
+
+\begin{code}
+countTyClDecls :: [TyClDecl name pat] -> (Int, Int, Int, Int)
+       -- class, data, newtype, synonym decls
+countTyClDecls decls 
+ = (length [() | ClassDecl _ _ _ _ _ _ _ _ _ _ _ _ <- decls],
+    length [() | TyData DataType _ _ _ _ _ _ _     <- decls],
+    length [() | TyData NewType  _ _ _ _ _ _ _     <- decls],
+    length [() | TySynonym _ _ _ _                <- decls])
 
+isDataDecl, isSynDecl, isClassDecl :: TyClDecl name pat -> Bool
+
+isSynDecl (TySynonym _ _ _ _) = True
+isSynDecl other                      = False
+
+isDataDecl (TyData _ _ _ _ _ _ _ _) = True
+isDataDecl other                   = False
+
+isClassDecl (ClassDecl _ _ _ _ _ _ _ _ _ _ _ _) = True
+isClassDecl other                              = False
 \end{code}
 
 \begin{code}
-instance (NamedThing name, Outputable name)
-             => Outputable (TyDecl name) where
+instance (Outputable name, Outputable pat)
+             => Outputable (TyClDecl name pat) where
 
-    ppr sty (TySynonym tycon tyvars mono_ty src_loc)
-      = ppHang (pp_decl_head sty SLIT("type") ppNil tycon tyvars)
-            4 (ppCat [ppEquals, ppr sty mono_ty])
+    ppr (TySynonym tycon tyvars mono_ty src_loc)
+      = hang (pp_decl_head SLIT("type") empty tycon tyvars)
+            4 (ppr mono_ty)
 
-    ppr sty (TyData context tycon tyvars condecls derivings pragmas src_loc)
-      = pp_tydecl sty
-                 (pp_decl_head sty SLIT("data") (pprContext sty context) tycon tyvars)
-                 (pp_condecls sty condecls)
+    ppr (TyData new_or_data context tycon tyvars condecls derivings pragmas src_loc)
+      = pp_tydecl
+                 (pp_decl_head keyword (pprHsContext context) tycon tyvars)
+                 (pp_condecls condecls)
                  derivings
+      where
+       keyword = case new_or_data of
+                       NewType  -> SLIT("newtype")
+                       DataType -> SLIT("data")
+
+    ppr (ClassDecl context clas tyvars fds sigs methods pragmas _ _ _ _ src_loc)
+      | null sigs      -- No "where" part
+      = top_matter
+
+      | otherwise      -- Laid out
+      = sep [hsep [top_matter, ptext SLIT("where {")],
+              nest 4 (vcat [sep (map ppr_sig sigs),
+                                  ppr methods,
+                                  char '}'])]
+      where
+        top_matter = hsep [ptext SLIT("class"), pprHsContext context,
+                            ppr clas, hsep (map (ppr) tyvars), pprFundeps fds]
+       ppr_sig sig = ppr sig <> semi
 
-    ppr sty (TyNew context tycon tyvars condecl derivings pragmas src_loc)
-      = pp_tydecl sty
-                 (pp_decl_head sty SLIT("newtype") (pprContext sty context) tycon tyvars)
-                 (pp_condecls sty condecl)
-                 derivings
 
-pp_decl_head sty str pp_context tycon tyvars
-  = ppCat [ppPStr str, pp_context, ppr sty tycon, interppSP sty tyvars]
+pp_decl_head str pp_context tycon tyvars
+  = hsep [ptext str, pp_context, ppr tycon,
+          interppSP tyvars, ptext SLIT("=")]
 
-pp_condecls sty [] = ppNil -- abstract datatype
-pp_condecls sty (c:cs)
-  = ppSep (ppBeside (ppStr "= ") (ppr sty c)
-          : map (\ x -> ppBeside (ppStr "| ") (ppr sty x)) cs)
+pp_condecls []     = empty             -- Curious!
+pp_condecls (c:cs) = sep (ppr c : map (\ c -> ptext SLIT("|") <+> ppr c) cs)
 
-pp_tydecl sty pp_head pp_decl_rhs derivings
-  = ppHang pp_head 4 (ppSep [
+pp_tydecl pp_head pp_decl_rhs derivings
+  = hang pp_head 4 (sep [
        pp_decl_rhs,
        case derivings of
-         Nothing -> ppNil
-         Just ds -> ppBeside (ppPStr SLIT("deriving "))
-                       (ppParens (ppInterleave ppComma (map (ppr sty) ds)))])
+         Nothing          -> empty
+         Just ds          -> hsep [ptext SLIT("deriving"), parens (interpp'SP ds)]
+    ])
 \end{code}
 
 A type for recording what types a datatype should be specialised to.
@@ -133,14 +220,14 @@ for an datatype declaration.
 \begin{code}
 data SpecDataSig name
   = SpecDataSig name           -- tycon to specialise
-               (MonoType name)
+               (HsType name)
                SrcLoc
 
-instance (NamedThing name, Outputable name)
+instance (Outputable name)
              => Outputable (SpecDataSig name) where
 
-    ppr sty (SpecDataSig tycon ty _)
-      = ppCat [ppStr "{-# SPECIALIZE data", ppr sty ty, ppStr "#-}"]
+    ppr (SpecDataSig tycon ty _)
+      = hsep [text "{-# SPECIALIZE data", ppr ty, text "#-}"]
 \end{code}
 
 %************************************************************************
@@ -151,170 +238,107 @@ instance (NamedThing name, Outputable name)
 
 \begin{code}
 data ConDecl name
-  = ConDecl    name            -- prefix-style con decl
-               [BangType name]
+  = ConDecl    name                    -- Constructor name; this is used for the
+                                       -- DataCon itself, and for the user-callable wrapper Id
+
+               name                    -- Name of the constructor's 'worker Id'
+                                       -- Filled in as the ConDecl is built
+
+               [HsTyVar name]          -- Existentially quantified type variables
+               (HsContext name)        -- ...and context
+                                       -- If both are empty then there are no existentials
+
+               (ConDetails name)
                SrcLoc
 
-  | ConOpDecl  (BangType name) -- infix-style con decl
-               name
+data ConDetails name
+  = VanillaCon                 -- prefix-style con decl
+               [BangType name]
+
+  | InfixCon                   -- infix-style con decl
+               (BangType name)
                (BangType name)
-               SrcLoc
 
-  | RecConDecl name
+  | RecCon                     -- record-style con decl
                [([name], BangType name)]       -- list of "fields"
-               SrcLoc
 
-  | NewConDecl  name           -- newtype con decl
-               (MonoType name)
-               SrcLoc
+  | NewCon                     -- newtype con decl, possibly with a labelled field.
+               (HsType name)
+               (Maybe name)    -- Just x => labelled field 'x'
 
 data BangType name
-  = Banged   (MonoType name)
-  | Unbanged (MonoType name)
+  = Banged   (HsType name)     -- HsType: to allow Haskell extensions
+  | Unbanged (HsType name)     -- (MonoType only needed for straight Haskell)
+  | Unpacked (HsType name)     -- Field is strict and to be unpacked if poss.
 \end{code}
 
-In checking interfaces, we need to ``compare'' @ConDecls@.  Use with care!
 \begin{code}
-eqConDecls cons1 cons2
-  = case (cmpList cmp cons1 cons2) of { EQ_ -> True; _ -> False }
+instance (Outputable name) => Outputable (ConDecl name) where
+    ppr (ConDecl con _ tvs cxt con_details  loc)
+      = sep [pprForAll tvs, pprHsContext cxt, ppr_con_details con con_details]
+
+ppr_con_details con (InfixCon ty1 ty2)
+  = hsep [ppr_bang ty1, ppr con, ppr_bang ty2]
+
+ppr_con_details con (VanillaCon tys)
+  = ppr con <+> hsep (map (ppr_bang) tys)
+
+ppr_con_details con (NewCon ty Nothing)
+  = ppr con <+> pprParendHsType ty
+
+ppr_con_details con (NewCon ty (Just x))
+  = ppr con <+> braces pp_field 
+   where
+    pp_field = ppr x <+> dcolon <+> pprParendHsType ty
+ppr_con_details con (RecCon fields)
+  = ppr con <+> braces (hsep (punctuate comma (map ppr_field fields)))
   where
-    cmp (ConDecl n1 tys1 _) (ConDecl n2 tys2 _)
-      = case cmpProtoName n1 n2 of
-         EQ_ -> cmpList cmp_bang_ty tys1 tys2
-         xxx -> xxx
-    cmp (ConOpDecl _ _ _ _) _  = panic# "eqConDecls:ConOpDecl"
-    cmp (RecConDecl _ _ _)  _  = panic# "eqConDecls:RecConDecl"
-    cmp (NewConDecl _ _ _)  _  = panic# "eqConDecls:NewConDecl"
-    -------------
-
-    cmp_ty = cmpMonoType cmpProtoName
-    -------------
-    cmp_bang_ty (Banged   ty1) (Banged   ty2) = cmp_ty ty1 ty2
-    cmp_bang_ty (Unbanged ty1) (Unbanged ty2) = cmp_ty ty1 ty2
-    cmp_bang_ty (Banged   _)   _             = LT_
-    cmp_bang_ty _             _              = GT_
-\end{code}
+    ppr_field (ns, ty) = hsep (map (ppr) ns) <+> 
+                        dcolon <+>
+                        ppr_bang ty
 
-\begin{code}
-instance (NamedThing name, Outputable name) => Outputable (ConDecl name) where
-
-    ppr sty (ConDecl con tys _)
-      = ppCat [pprNonOp sty con, ppInterleave ppNil (map (ppr_bang sty) tys)]
-    ppr sty (ConOpDecl ty1 op ty2 _)
-      = ppCat [ppr_bang sty ty1, pprOp sty op, ppr_bang sty ty2]
-    ppr sty (NewConDecl con ty _)
-      = ppCat [pprNonOp sty con, pprParendMonoType sty ty]
-    ppr sty (RecConDecl con fields _)
-      = ppCat [pprNonOp sty con, ppChar '{',
-              ppInterleave pp'SP (map pp_field fields), ppChar '}']
-      where
-       pp_field (n, ty) = ppCat [ppr sty n, ppPStr SLIT("::"), ppr_bang sty ty]
-
-ppr_bang sty (Banged   ty) = ppBeside (ppChar '!') (pprParendMonoType sty ty)
-ppr_bang sty (Unbanged ty) = pprParendMonoType sty ty
+ppr_bang (Banged   ty) = ptext SLIT("!") <> pprParendHsType ty
+ppr_bang (Unbanged ty) = pprParendHsType ty
+ppr_bang (Unpacked ty) = ptext SLIT("! !") <> pprParendHsType ty
 \end{code}
 
-%************************************************************************
-%*                                                                     *
-\subsection[ClassDecl]{A class declaration}
-%*                                                                     *
-%************************************************************************
-
-\begin{code}
-data ClassDecl tyvar uvar name pat
-  = ClassDecl  (Context name)                  -- context...
-               name                            -- name of the class
-               name                            -- the class type variable
-               [Sig name]                      -- methods' signatures
-               (MonoBinds tyvar uvar name pat) -- default methods
-               (ClassPragmas name)
-               SrcLoc
-\end{code}
-
-\begin{code}
-instance (NamedThing name, Outputable name, Outputable pat,
-         Eq tyvar, Outputable tyvar, Eq uvar, Outputable uvar)
-               => Outputable (ClassDecl tyvar uvar name pat) where
-
-    ppr sty (ClassDecl context clas tyvar sigs methods pragmas src_loc)
-     = ppAboves [ppCat [ppStr "class", pprContext sty context, ppr sty clas,
-                       ppr sty tyvar, ppStr "where"],
-                       -- ToDo: really shouldn't print "where" unless there are sigs
-                ppNest 4 (ppAboves (map (ppr sty) sigs)),
-                ppNest 4 (ppr sty methods),
-                ppNest 4 (ppr sty pragmas)]
-\end{code}
 
 %************************************************************************
 %*                                                                     *
-\subsection[InstDecl]{An instance declaration (also, @SpecInstSig@)}
+\subsection[InstDecl]{An instance declaration
 %*                                                                     *
 %************************************************************************
 
 \begin{code}
-data InstDecl tyvar uvar name pat
-  = InstDecl   name            -- Class
-
-               (PolyType name) -- Context => Instance-type
+data InstDecl name pat
+  = InstDecl   (HsType name)   -- Context => Class Instance-type
                                -- Using a polytype means that the renamer conveniently
                                -- figures out the quantified type variables for us.
 
-               (MonoBinds tyvar uvar name pat)
+               (MonoBinds name pat)
 
-               Bool            -- True <=> This instance decl is from the
-                               -- module being compiled; False <=> It is from
-                               -- an imported interface.
+               [Sig name]              -- User-supplied pragmatic info
 
-               FAST_STRING     -- The name of the module where the instance decl
-                               -- originally came from; easy enough if it's
-                               -- the module being compiled; otherwise, the
-                               -- info comes from a pragma.
+               name                    -- Name for the dictionary function
 
-               [Sig name]              -- actually user-supplied pragmatic info
-               (InstancePragmas name)  -- interface-supplied pragmatic info
                SrcLoc
 \end{code}
 
 \begin{code}
-instance (NamedThing name, Outputable name, Outputable pat,
-         Eq tyvar, Outputable tyvar, Eq uvar, Outputable uvar)
-             => Outputable (InstDecl tyvar uvar name pat) where
-
-    ppr sty (InstDecl clas ty binds local modname uprags pragmas src_loc)
-      = let
-           (context, inst_ty)
-             = case ty of
-                 HsPreForAllTy c t -> (c, t)
-                 HsForAllTy  _ c t -> (c, t)
-
-           top_matter = ppCat [ppStr "instance", pprContext sty context,
-                               ppr sty clas, pprParendMonoType sty inst_ty]
-       in
-       if nullMonoBinds binds && null uprags then
-           ppAbove top_matter (ppNest 4 (ppr sty pragmas))
+instance (Outputable name, Outputable pat)
+             => Outputable (InstDecl name pat) where
+
+    ppr (InstDecl inst_ty binds uprags dfun_name src_loc)
+      = getPprStyle $ \ sty ->
+        if ifaceStyle sty || (nullMonoBinds binds && null uprags) then
+           hsep [ptext SLIT("instance"), ppr inst_ty]
        else
-           ppAboves [
-             ppCat [top_matter, ppStr "where"],
-             if null uprags then ppNil else ppNest 4 (ppr sty uprags),
-             ppNest 4 (ppr sty binds),
-             ppNest 4 (ppr sty pragmas) ]
+          vcat [hsep [ptext SLIT("instance"), ppr inst_ty, ptext SLIT("where")],
+                nest 4 (ppr uprags),
+                nest 4 (ppr binds) ]
 \end{code}
 
-A type for recording what instances the user wants to specialise;
-called a ``Sig'' because it's sort of like a ``type signature'' for an
-instance.
-\begin{code}
-data SpecInstSig name
-  = SpecInstSig  name              -- class
-                (MonoType name)    -- type to specialise to
-                SrcLoc
-
-instance (NamedThing name, Outputable name)
-             => Outputable (SpecInstSig name) where
-
-    ppr sty (SpecInstSig clas ty _)
-      = ppCat [ppStr "{-# SPECIALIZE instance", ppr sty clas, ppr sty ty, ppStr "#-}"]
-\end{code}
 
 %************************************************************************
 %*                                                                     *
@@ -328,12 +352,116 @@ syntax, and that restriction must be checked in the front end.
 
 \begin{code}
 data DefaultDecl name
-  = DefaultDecl        [MonoType name]
+  = DefaultDecl        [HsType name]
                SrcLoc
 
-instance (NamedThing name, Outputable name)
+instance (Outputable name)
              => Outputable (DefaultDecl name) where
 
-    ppr sty (DefaultDecl tys src_loc)
-      = ppBeside (ppPStr SLIT("default ")) (ppParens (interpp'SP sty tys))
+    ppr (DefaultDecl tys src_loc)
+      = ptext SLIT("default") <+> parens (interpp'SP tys)
+\end{code}
+
+%************************************************************************
+%*                                                                     *
+\subsection{Foreign function interface declaration}
+%*                                                                     *
+%************************************************************************
+
+\begin{code}
+data ForeignDecl name = 
+   ForeignDecl 
+        name 
+       ForKind   
+       (HsType name)
+       ExtName
+       CallConv
+       SrcLoc
+
+instance (Outputable name)
+             => Outputable (ForeignDecl name) where
+
+    ppr (ForeignDecl nm imp_exp ty ext_name cconv src_loc)
+      = ptext SLIT("foreign") <+> ppr_imp_exp <+> pprCallConv cconv <+> 
+        ppr ext_name <+> ppr_unsafe <+> ppr nm <+> dcolon <+> ppr ty
+        where
+         (ppr_imp_exp, ppr_unsafe) =
+          case imp_exp of
+            FoLabel     -> (ptext SLIT("label"), empty)
+            FoExport    -> (ptext SLIT("export"), empty)
+            FoImport us 
+               | us        -> (ptext SLIT("import"), ptext SLIT("unsafe"))
+               | otherwise -> (ptext SLIT("import"), empty)
+
+data ForKind
+ = FoLabel
+ | FoExport
+ | FoImport Bool -- True  => unsafe call.
+
+data ExtName
+ = Dynamic 
+ | ExtName CLabelString        -- The external name of the foreign thing,
+          (Maybe CLabelString) -- and optionally its DLL or module name
+                               -- Both of these are completely unencoded; 
+                               -- we just print them as they are
+
+isDynamicExtName :: ExtName -> Bool
+isDynamicExtName Dynamic = True
+isDynamicExtName _      = False
+
+extNameStatic :: ExtName -> CLabelString
+extNameStatic (ExtName f _) = f
+extNameStatic Dynamic      = panic "staticExtName: Dynamic - shouldn't ever happen."
+
+
+instance Outputable ExtName where
+  ppr Dynamic     = ptext SLIT("dynamic")
+  ppr (ExtName nm mb_mod) = 
+     case mb_mod of { Nothing -> empty; Just m -> doubleQuotes (ptext m) } <+> 
+     doubleQuotes (ptext nm)
+
+\end{code}
+
+%************************************************************************
+%*                                                                     *
+\subsection{Transformation rules}
+%*                                                                     *
+%************************************************************************
+
+\begin{code}
+data RuleDecl name pat
+  = RuleDecl
+       FAST_STRING             -- Rule name
+       [name]                  -- Forall'd tyvars, filled in by the renamer with
+                               -- tyvars mentioned in sigs; then filled out by typechecker
+       [RuleBndr name]         -- Forall'd term vars
+       (HsExpr name pat)       -- LHS
+       (HsExpr name pat)       -- RHS
+       SrcLoc          
+
+  | IfaceRuleDecl              -- One that's come in from an interface file
+       name
+       (UfRuleBody name)
+       SrcLoc          
+
+data RuleBndr name
+  = RuleBndr name
+  | RuleBndrSig name (HsType name)
+
+instance (Outputable name, Outputable pat)
+             => Outputable (RuleDecl name pat) where
+  ppr (RuleDecl name tvs ns lhs rhs loc)
+       = sep [text "{-# RULES" <+> doubleQuotes (ptext name),
+              pp_forall, ppr lhs, equals <+> ppr rhs,
+               text "#-}" ]
+       where
+         pp_forall | null tvs && null ns = empty
+                   | otherwise           = text "forall" <+> 
+                                           fsep (map ppr tvs ++ map ppr ns)
+                                           <> dot
+  ppr (IfaceRuleDecl var body loc) = text "An imported rule..."
+
+instance Outputable name => Outputable (RuleBndr name) where
+   ppr (RuleBndr name) = ppr name
+   ppr (RuleBndrSig name ty) = ppr name <> dcolon <> ppr ty
 \end{code}