reorganized examples directory
[coq-hetmet.git] / examples / tutorial.hs
diff --git a/examples/tutorial.hs b/examples/tutorial.hs
deleted file mode 100644 (file)
index 7668eab..0000000
+++ /dev/null
@@ -1,827 +0,0 @@
-{-# OPTIONS_GHC -XModalTypes -XScopedTypeVariables -XFlexibleContexts -XMultiParamTypeClasses -ddump-types -XNoMonoPatBinds -XFlexibleInstances -XGADTs -XUndecidableInstances #-}
-module GArrowsTutorial
-where
-import Data.Bits
-import Data.Bool (not)
-import GHC.HetMet.CodeTypes hiding ((-))
-import GHC.HetMet.GArrow
-import Control.Category
-import Control.Arrow
-import Prelude hiding ( id, (.) )
-
--- The best way to understand heterogeneous metaprogramming and
--- generalized arrows is to play around with this file, poking at the
--- examples until they fail to typecheck -- you'll learn a lot that
--- way!
-
--- Once you've built the modified compiler, you can compile this file
--- with:
---
---    $ inplace/bin/ghc-stage2 tutorial.hs
---
-
--- -XModalTypes adds a new syntactical expression, "code brackets":
-code_fst = <[ \(x,y) -> x ]>
-
--- This new expression is the introduction form for modal types:
-code_fst :: forall a b g. <[ (a,b) -> a ]>@g
-
--- Think of <[T]>@g as being the type of programs written in language
--- "g" which, when "executed", return a value of type "T".  I mention
--- "language g" because the *heterogeneous* aspect of HetMet means
--- that we can limit the sorts of constructs allowed inside the code
--- brackets, permitting only a subset of Haskell (you have to use
--- Haskell syntax, though).
-
--- There is a second new expression form, "~~", called "escape":
-
-code_fst_fst = <[ \z -> ~~code_fst (~~code_fst z) ]>
-
--- Note that ~~ binds more tightly than any other operator.  There is
--- an alternate version, "~~$", which binds more weakly than any other
--- operator (this is really handy sometimes!).  To demonstrate this,
--- the next two expressions differ only in superficial syntax:
-
-example1    foo bar = <[ ~~$ foo bar  ]>
-example2    foo bar = <[ ~~( foo bar) ]>
--- example3 foo bar = <[ ~~  foo bar  ]>
-
--- ... but the third one is completely different (and in fact, doesn't
--- even parse, but we'll get to that in a moment)
-
--- The escape operation must appear within code brackets.  In truth,
--- it is really a "hole" punched in the code brackets -- the thing to
--- which the escape operator gets applied is typed as if it were
--- *outside* the code brackets.  It must have type <[T]>, and the
--- escape operator allows it to be used *inside* code brackets as if
--- it had type "T".
-
--- So, the escape operator is basically a way of pasting code
--- fragments into each other.
-
--- This is where those type variables after the "@" sign come in: if
--- you paste two pieces of code into a third, all three must be
--- written in the same language.  We express this by unifying their
--- tyvars:
-
-compose_code :: forall g a b c. <[a->b]>@g -> <[b->c]>@g -> <[a->c]>@g
-compose_code x y = <[ \z -> ~~y (~~x z) ]>
-
--- Now, try commenting out the type ascription above and uncommenting
--- any of these three:
---
--- compose_code :: forall g h a b c. <[a->b]>@h -> <[b->c]>@g -> <[a->c]>@g
--- compose_code :: forall g h a b c. <[a->b]>@g -> <[b->c]>@h -> <[a->c]>@g
--- compose_code :: forall g h a b c. <[a->b]>@g -> <[b->c]>@g -> <[a->c]>@h
---
-
--- The typechecker won't let you get away with that -- you're trying
--- to force a type which is "too polymorphic" onto paste2.  If the
--- compiler allowed that, the resulting metaprogram might try to
--- splice together programs written in different languages, resulting
--- in mayhem.
-
--- NEW SCOPING RULES: The syntactical depth (or just "depth") of an
--- expression is the number of surrounding code-brackets minus the
--- number of surrounding escapes (this is strictly a syntax concept
--- and has NOTHING to do with the type system!).  It is very important
--- to keep in mind that the scope of a bound variable extends only to
--- expressions at the same depth!  To demonstrate, the following
--- expression will fail to parse:
-
--- badness = \x -> <[ x ]>
-
--- ...and in the following expression, the occurrence of "x" is bound
--- by the first (outer) lambda, not the second one:
-
-no_shadowing_here = \x -> <[ \x -> ~~x ]>
-
--- Lastly, you can wrap code-brackets around an identifier in a
--- top-level, let, or where binding.  Notice how GHC doesn't complain
--- here about defining an identifier twice!
-
-foo       =    \x         -> x+1
-<[ foo ]> = <[ \(x::Bool) -> x   ]>
-
--- Now you can use foo (the second one!) inside code-brackets:
-
-bar x = <[ foo ~~x ]>
-
-bar :: forall g. <[Bool]>@g -> <[Bool]>@g
-
--- In fact, the identifiers have completely unrelated types.  Which
--- brings up another important point: types are ALWAYS assigned
--- "relative to" depth zero.  So although we imagine "foo" existing at
--- depth-one, its type is quite firmly established as <[ Bool -> Bool ]>
-
--- It has to be this way -- to see why, consider a term which is more
--- polymorphic than "foo":
-
-<[ foo' ]> = <[ \x -> x ]>
-
--- Its type is:
-
-<[ foo' ]> :: forall a g . <[ a -> a ]>@g
-
--- ...and there's no way to express the g-polymorphism entirely from
--- within the brackets.
-
--- So why does all of this matter?  Mainly so that we can continue to use .  We'd like
--- the "+" operator to work "as expected" -- in other words, we'd like
--- people to be able to write things like
-
-increment_at_level1 = <[ \x -> x + 1 ]>
-
--- However, in unmodified haskell an identifier like (+) may have only
--- one type.  In this case that type is:
---
---     (+) :: Num a => a -> a -> a
---
--- Now, we could simply decree that when (+) appears inside code
--- brackets, an "implicit ~~" is inserted, so the desugared expression
--- is:
---
---    increment_at_level1 = <[ \x -> ~~(+) x 1 ]> 
---
--- unfortunately this isn't going to work for guest languages that
--- don't have higher-order functions.  Haskell uses curried arguments
--- because it has higher-order functions, but in a first-order guest
--- language a more sensible type for (+) would be:
---
---    (+) :: Num a => (a,a) -> a
--- 
--- ... or even something less polymorphic, like
---
---    (+) :: (Int,Int) -> Int
---
--- so to maintain flexibility, we allow an identifier to have
--- different types at different syntactic depths; this way type
--- choices made for Haskell don't get imposed on guest languages that
--- are missing some of its features.
--- 
--- In hindsight, what we REALLY want is for increment_at_level1 to
--- be desugared like this (much like the Arrow (|...|) syntax):
---
---   increment_at_level1 = <[ \x -> ~~( <[x]> + <[1]> ) ]>
---
--- ... because then we can declare
---
---   instance Num a => Num <[a]> where ...
---
--- or just
---
---   instance Num <[Int]> where ...
---
--- unfortunately there's a major problem: knowing how to do this sort
--- of desugaring requires knowing the *arity* of a function.  For
--- symbols we can kludge it by checking Haskell's parsing rules (there
--- are only a handful of unary symbols; all others are binary), but
--- this is crude and won't work at all for non-symbol identifiers.
--- And we can look at a type like x->y->z and say "oh, that's a
--- two-argument function", but sometimes GHC doesn't know the complete
--- type of an identifier in the midst of unification (i.e. "x has type
--- Int->a for some a, where a could be Int or Int->Int"), so guessing
--- the arity from the type cannot be done during parsing, which is
--- when we need to do this.
---
--- Okay, I think that's more or less a brain dump of why I changed the
--- scoping rules and the problems with the other solutions I tried.
---
--- I am very interested in hearing any suggestions on better ways of
--- dealing with this, so long as you can still use operators like (+)
--- in guest languages without higher-order functions.
---
-
-
-
-
-
-
--- The rest of this file contains a bunch of example programs:
--- exponentiation, dot-product, a bunch of classic MetaML idioms, and
--- a translation of Nanevski+Pfenning's two-stage regex matcher.
-
-
-
-
-
-
---------------------------------------------------------------------------------
--- Ye Olde and Most Venerable "pow" Function
-
-pow :: forall c. GuestIntegerLiteral c => GuestLanguageMult c Integer => Integer -> <[ Integer -> Integer ]>@c
-pow n =
-   if n==0
-   then <[ \x -> 1 ]>
-   else <[ \x -> x * ~~(pow (n - 1)) x ]>
-
-
--- a more efficient two-level pow
-pow' :: forall c. GuestIntegerLiteral c => GuestLanguageMult c Integer => Integer -> <[ Integer -> Integer ]>@c
-pow' 0  = <[ \x -> 1 ]>
-pow' 1  = <[ \x -> x ]>
-pow' n  = if   n `mod` 2==0
-          then <[ \x -> (\y -> y*y) (~~(pow' $ n `shiftR` 2) x) ]>
-          else <[ \x -> x * ~~(pow' $ n-1) x ]>
-
-
-
-
-
-
-
-
-
-
---------------------------------------------------------------------------------
--- Dot Product
---
---  This shows how to build a two-level program one step at a time by
---  slowly rearranging it until the brackets can be inserted.
---
-
--- a one-level function to compute the dot product of two vectors
-dotproduct :: [Int] -> [Int] -> Int
-dotproduct v1 v2 =
-  case v1 of
-    []     -> 0
-    (a:ax) -> case v2 of
-                   []     -> 0
-                   (b:bx) ->
-                       (a*b)+(dotproduct ax bx)
-
--- A slightly modified version of the dot product: note that we
--- check for zeroes and ones to avoid multiplying.  In a one-level
--- program this yields no advantage, however!
-dotproduct' :: [Int] -> [Int] -> Int
-dotproduct' v1 v2 =
-  case v1 of
-    []     -> 0
-    (0:ax) -> case v2 of
-                   []     -> 0
-                   (b:bx) -> (dotproduct' ax bx)
-    (1:ax) -> case v2 of
-                   []     -> 0
-                   (b:bx) -> b+(dotproduct' ax bx)
-    (a:ax) -> case v2 of
-                   []     -> 0
-                   (b:bx) ->
-                       (a*b)+(dotproduct' ax bx)
-
--- A two-level version of the dot product.  Note how we ask for the first
--- vector, then produce a program which is optimized for multiplying
--- by that particular vector.  If there are zeroes or ones in the
--- original vector, we will emit code which is faster than a one-level
--- dot product.
-
-dotproduct'' :: forall g.
-                GuestLanguageAdd         g Integer =>
-                GuestLanguageMult        g Integer =>
-                GuestIntegerLiteral      g         =>
-                [Integer] -> <[ [Integer] -> Integer ]>@g
-dotproduct'' v1 =
-  case v1 of
-    []     -> <[ \v2 -> 0 ]>
-    (0:ax) -> <[ \v2 -> case v2 of
-                          []     -> 0
-                          (b:bx) -> ~~(dotproduct'' ax) bx ]>
-    (1:ax) -> <[ \v2 -> case v2 of
-                          []     -> 0
-                          (b:bx) -> b + ~~(dotproduct'' ax) bx ]>
-
-    (a:ax) -> <[ \v2 -> case v2 of
-                          []     -> 0
-                          (b:bx) -> ~~(guestIntegerLiteral a) * b + ~~(dotproduct'' ax) bx ]>
-
-
-
-
---------------------------------------------------------------------------------
--- Taha-Sheard "isomorphism for code types"
-
-back  :: forall a b c. (<[b]>@a -> <[c]>@a) -> <[ b->c ]>@a
-back  = \f -> <[ \x -> ~~(f <[x]>) ]>
-
-forth :: forall a b c. <[b->c]>@a -> (<[b]>@a -> <[c]>@a)
-forth = \f -> \x -> <[ ~~f ~~x ]>
-
-
-
---------------------------------------------------------------------------------
--- Examples of "running" code; these examples illustrate the sorts of
--- scoping problems that the Taha-Nielsen environment classifiers look
--- for in the context of HOMOGENEOUS metaprogramming.  You can't
--- actually define these functions for ALL generalized arrows -- only
--- those for which you've defined some sort of interpretation in Haskell.
-
-run :: forall a. (forall b. <[a]>@b) -> a
-run = undefined
-
--- the typchecker correctly rejects this bogosity if you uncomment it:
--- bogus = <[ \x -> ~~( run <[ x ]> ) ]>
-
--- The Calcano-Moggi-Taha paper on environment classifier inference
--- had a special type for closed code and two special expressions
--- "close" and "open".  These are unnecessary in SystemFC1 where we
--- can use higher-rank polymorphism to get the same result (although
--- in truth it's cheating a bit since their type inference is
--- decidable with no annotations, whereas Rank-N inference is not):
-
-data ClosedCode a = ClosedCode (forall b. <[a]>@b)
-
-open :: forall a b. ClosedCode a -> <[a]>@b
-open (ClosedCode x) = x
-
-close :: (forall b. <[a]>@b) -> ClosedCode a
-close x = ClosedCode x
-
-run_closed :: ClosedCode a -> a
-run_closed = undefined
-
-
-
---------------------------------------------------------------------------------
--- A two-level Regular Expression matcher, adapted from Nanevski+Pfenning, Figure 6
-data Regex
- = Empty
- | Plus  Regex Regex 
- | Times Regex Regex
- | Star  Regex
- | Const Char
-
-class Stream a where
-  s_empty :: a -> Bool
-  s_head  :: a -> Char
-  s_tail  :: a -> a
-
--- a continuation-passing-style matcher
-
-accept :: Stream s => Regex -> (s -> Bool) -> s -> Bool
-
-accept Empty k s          =
-  k s
-
-accept (Plus e1 e2) k s   =
- (accept e1 k s) || (accept e2 k s)
-
-accept (Times e1 e2) k s  =
- (accept e1 (accept e2 k)) s
-
-accept (Star e) k s       =
- (k s) || (accept e (\s' -> accept (Star e) k s') s)
- -- FIXME: this will loop forever if you give it (Star x) where x can
- -- match the empty string
-
-accept (Const c) k s      =
- if s_empty s 
- then False
- else (s_head s) == c && k (s_tail s)
-
-class GuestStream g a where
-  <[ gs_empty ]> :: <[ a -> Bool ]>@g
-  <[ gs_head  ]> :: <[ a -> Char ]>@g
-  <[ gs_tail  ]> :: <[ a -> a    ]>@g
-
-class GuestEqChar g where
-  <[ (==) ]> :: <[ Char -> Char -> Bool ]>@g
-
-staged_accept ::
-    Regex
-    -> forall c s.
-         GuestStream c s =>
-         GuestCharLiteral c =>
-         GuestLanguageBool c =>
-         GuestEqChar c =>
-         <[ s -> Bool ]>@c
-      -> <[ s -> Bool ]>@c
-
-staged_accept Empty k            =
-   <[ \s -> gs_empty s ]>
-
--- note that code for "k" gets duplicated here
-staged_accept (Plus e1 e2) k     =
-   <[ \s -> (~~(staged_accept e1 k) s) || (~~(staged_accept e2 k) s) ]>
-
-staged_accept (Times e1 e2) k    =
-   <[ \s -> ~~(staged_accept e1 (staged_accept e2 k)) s ]>
-
-staged_accept (Star e) k         =
-   loop
-    where
-    -- loop :: <[s -> Bool]>@g
-     loop =  <[ \s -> ~~k s || ~~(staged_accept e loop) s ]>
-    -- note that loop is not (forall c s. <[s -> Bool]>@c)
-    -- because "k" is free in loop; it is analogous to the free
-    -- environment variable in Nanevski's example
-
-
-staged_accept (Const c) k        =
-    <[ \s -> if gs_empty s 
-             then false
-             else (gs_head s) == ~~(guestCharLiteral c) && ~~k (gs_tail s) ]>
-
-
--- this type won't work unless the case for (Star e) is commented out;
--- see loop above
---      Regex
---      -> (forall c s.
---          GuestStream c s =>
---          GuestLanguageBool c =>
---          GuestEqChar c =>
---          <[s -> Bool]>@c)
---     -> (forall c s.
---          GuestStream c s =>
---          GuestLanguageBool c =>
---          GuestEqChar c =>
---          <[s -> Bool]>@c)
-
-
-
-
---------------------------------------------------------------------------------
--- Unflattening
-
--- The current implementation has problems with literals at level>0;
--- there are special-purpose hacks for Int and Char, but none for
--- unit.  So I use this instead as a placeholder for <[ () ]>
-
-<[ u ]> = Prelude.error "FIXME"
-
--- This more or less "undoes" the flatten function.  People often ask
--- me how you "translate generalized arrows back into multi-level
--- terms".. I'm not sure why you'd want to do that, but this is how:
-newtype Code x y = Code { unCode :: forall a. <[ x -> y ]>@a }
-
-instance Category Code where
-  id             = Code <[ \x -> x ]>
-  f . g          = Code <[ \x -> ~~(unCode f) (~~(unCode g) x) ]>
-
-instance GArrow Code (,) () where
-  ga_first     f = Code <[ \(x,y) -> ((~~(unCode f) x),y) ]>
-  ga_second    f = Code <[ \(x,y) -> (x         ,(~~(unCode f) y)) ]>
-  ga_cancell     = Code <[ \(_,x) -> x ]>
-
-  ga_cancelr     = Code <[ \(x,_) -> x ]>
-  ga_uncancell   = Code <[ \x -> (u,x) ]>
-  ga_uncancelr   = Code <[ \x -> (x,u) ]>
-  ga_assoc       = Code <[ \((x,y),z) -> (x,(y,z)) ]>
-  ga_unassoc     = Code <[ \(x,(y,z)) -> ((x,y),z) ]>
-
-
-
---------------------------------------------------------------------------------
--- BiGArrows
-
-class GArrow g (**) u => BiGArrow g (**) u where
-  -- Note that we trust the user's pair of functions actually are
-  -- mutually inverse; confirming this in the type system would
-  -- require very powerful dependent types (such as Coq's).  However,
-  -- the consequences of failure here are much more mild than failures
-  -- in BiArrow.inv: if the functions below are not mutually inverse,
-  -- the LoggingBiGArrow will simply compute the wrong result rather
-  -- than fail in some manner outside the language's semantics.
-  biga_arr :: (x -> y) -> (y -> x) -> g x y
-  biga_inv :: g x y -> g y x
-
--- For any GArrow instance, its mutually inverse pairs form a BiGArrow
-data GArrow g (**) u => GArrowInversePair g (**) u x y =
-    GArrowInversePair { forward :: g x y , backward :: g y x }
-instance GArrow g (**) u => Category (GArrowInversePair g (**) u) where
-  id    = GArrowInversePair { forward = id , backward = id }
-  f . g = GArrowInversePair { forward = (forward f) . (forward g) , backward = (backward g) . (backward f) }
-instance GArrow g (**) u => GArrow (GArrowInversePair g (**) u) (**) u where
-  ga_first     f = GArrowInversePair { forward = ga_first  (forward f), backward = ga_first  (backward f) }
-  ga_second    f = GArrowInversePair { forward = ga_second (forward f), backward = ga_second (backward f) }
-  ga_cancell     = GArrowInversePair { forward = ga_cancell           , backward = ga_uncancell }
-  ga_cancelr     = GArrowInversePair { forward = ga_cancelr           , backward = ga_uncancelr }
-  ga_uncancell   = GArrowInversePair { forward = ga_uncancell         , backward = ga_cancell   }
-  ga_uncancelr   = GArrowInversePair { forward = ga_uncancelr         , backward = ga_cancelr   }
-  ga_assoc       = GArrowInversePair { forward = ga_assoc             , backward = ga_unassoc   }
-  ga_unassoc     = GArrowInversePair { forward = ga_unassoc           , backward = ga_assoc     }
-instance GArrowSwap g (**) u => GArrowSwap (GArrowInversePair g (**) u) (**) u where
-  ga_swap = GArrowInversePair { forward = ga_swap , backward = ga_swap }
--- but notice that we can't (in general) get
--- instance GArrowDrop g => GArrowDrop (GArrowInversePair g) where ...
-
-
--- For that, we need PreLenses, which "log the history" where necessary.
--- I call this a "PreLens" because it consists of the data required
--- for a Lens (as in BCPierce's Lenses) but does not necessarily
--- satisfy the putget/getput laws.  Specifically, the "extra stuff" we
--- store is the inversion function.
-newtype PreLens x y = PreLens { preLens :: x -> (y , y->x) }
-
-instance Category PreLens where
-  id    = PreLens { preLens = \x -> (x, (\x -> x)) }
-  f . g = PreLens { preLens = \x -> let (gx,g') = (preLens g) x in let (fgx,f') = (preLens f) gx in (fgx , \q -> g' (f' q)) }
-
-instance GArrow PreLens (,) () where
-  ga_first     f = PreLens { preLens = \(x,z) -> let (y,f') = (preLens f) x in ((y,z),(\(q1,q2) -> (f' q1,q2))) }
-  ga_second    f = PreLens { preLens = \(z,x) -> let (y,f') = (preLens f) x in ((z,y),(\(q1,q2) -> (q1,f' q2))) }
-  ga_cancell     = PreLens { preLens = \(_,x) -> (x,            (\x -> ((),x))) }
-  ga_cancelr     = PreLens { preLens = \(x,_) -> (x,            (\x -> (x,()))) }
-  ga_uncancell   = PreLens { preLens = \x     -> (((),x),       (\(_,x) -> x)) }
-  ga_uncancelr   = PreLens { preLens = \x     -> ((x,()),       (\(x,_) -> x)) }
-  ga_assoc       = PreLens { preLens = \((x,y),z) -> ( (x,(y,z)) , (\(x,(y,z)) -> ((x,y),z)) ) }
-  ga_unassoc     = PreLens { preLens = \(x,(y,z)) -> ( ((x,y),z) , (\((x,y),z) -> (x,(y,z))) ) }
-
-instance GArrowDrop PreLens (,) () where
-  ga_drop        = PreLens { preLens = \x     -> (()    , (\() -> x)) }
-instance GArrowCopy PreLens (,) () where
-  ga_copy        = PreLens { preLens = \x     -> ((x,x) , fst) }
-instance GArrowSwap PreLens (,) () where
-  ga_swap        = PreLens { preLens = \(x,y) -> ((y,x) , (\(z,q) -> (q,z))) }
-
-
-
-data Lens x y where
-  Lens :: forall x y c1 c2 . ((x,c1)->(y,c2)) -> ((y,c2)->(x,c1)) -> Lens x y
-{-
--- can we make lenses out of GArrows other than (->)?
-instance Category Lens where
-  id                          = Lens (\x -> x) (\x -> x)
-  (Lens g1 g2) . (Lens f1 f2) = Lens (\(x,(c1,c2)) -> let (y,fc) = f1 (x,c1) in  let (z,gc) = g1 (y,c2) in  (z,(fc,gc)))
-                                     (\(z,(c1,c2)) -> let (y,gc) = g2 (z,c2) in  let (x,fc) = f2 (y,c1) in  (x,(fc,gc)))
-
-instance GArrow Lens (,) () where
-  ga_first     (Lens f1 f2) = Lens (\((x1,x2),c) -> let (y,c') = f1 (x1,c) in ((y,x2),c'))
-                                   (\((x1,x2),c) -> let (y,c') = f2 (x1,c) in ((y,x2),c'))
-  ga_second    (Lens f1 f2) = Lens (\((x1,x2),c) -> let (y,c') = f1 (x2,c) in ((x1,y),c'))
-                                   (\((x1,x2),c) -> let (y,c') = f2 (x2,c) in ((x1,y),c'))
-  ga_cancell                = Lens (\(((),x),()) -> (    x ,())) 
-                                   (\(    x ,()) -> (((),x),()))
-  ga_uncancell              = Lens (\(    x ,()) -> (((),x),()))
-                                   (\(((),x),()) -> (    x ,())) 
-  ga_cancelr                = Lens (\((x,()),()) -> (    x ,())) 
-                                   (\( x    ,()) -> ((x,()),()))
-  ga_uncancelr              = Lens (\( x    ,()) -> ((x,()),()))
-                                   (\((x,()),()) -> (    x ,())) 
-  ga_assoc                  = Lens (\(((x,y),z),()) -> ((x,(y,z)),()))
-                                   (\((x,(y,z)),()) -> (((x,y),z),()))
-  ga_unassoc                = Lens (\((x,(y,z)),()) -> (((x,y),z),()))
-                                   (\(((x,y),z),()) -> ((x,(y,z)),()))
-
-instance GArrowDrop Lens (,) () where
-  ga_drop        = Lens (\(x,()) -> ((),x)) (\((),x) -> (x,()))
-instance GArrowCopy Lens (,) () where
-  ga_copy        = Lens (\(x,()) -> ((x,x),())) (\((x,_),()) -> (x,()))
-instance GArrowSwap Lens (,) () where
-  ga_swap        = Lens (\((x,y),()) -> ((y,x),())) (\((x,y),()) -> ((y,x),()))
-
-instance BiGArrow Lens (,) () where
-  biga_arr f f'  = Lens (\(x,()) -> ((f x),())) (\(x,()) -> ((f' x),()))
-  biga_inv (Lens f1 f2) = Lens f2 f1
--}
-
-
---------------------------------------------------------------------------------
--- An example generalized arrow
-
---  *** this will be finished and posted by 14-Mar-2011; the code
---  *** below is just a sketch ***
-
-{-
--- A verilog module is an SDoc (chunk of text) giving the module's
--- definition.  The UniqueSupply avoids name clashes.
-data VerilogModule =
-  VerilogModule
-    [VerilogModule]     -- dependencies
-    String ->           -- module name
-    (Tree String ->        -- input port names
-     Tree String ->        -- output port names
-     SDoc)              -- raw verilog code for the body
-    
-
-instance Show VerilogModule where
-  show VerilogModule dep name body =
-    "module "++name++"(FIXME)"++(body FIXME FIXME)
-
-data VerilogWrappedType a =
-  { vwt_rep :: String }
-
--- A "verilog garrow" from A to B is, concretely, the source code for a
--- verilog module having input ports of type A and output ports of type B;
--- the UniqueSupply lets us generate names.
-data GArrowVerilog a b = 
-  UniqueSupply ->
-  VerilogWrappedType a ->
-  VerilogWrappedType b ->
-  GArrowVerilog SDoc
-
-instance GArrow GArrowVerilog (,) where
-  ga_id            =  VerilogModule [] "ga_id"   (\ inp outp -> zipTree ... "assign "++outp++" = "++inp)
-  ga_comp      f g =  VerilogModule [] "ga_comp" 
-  ga_first     :: g x y -> g (x ** z) (y ** z)
-  ga_second    f   =  ga_comp (ga_comp ga_swap (ga_first f)) ga_swap
-  ga_cancell   f   =  VerilogModule [] "ga_cancell" (\ [in1,in2] [outp]      -> "assign "++outp++" = "++in2)
-  ga_cancelr   f   =  VerilogModule [] "ga_cancelr" (\ [in1,in2] [outp]      -> "assign "++outp++" = "++in1)
-  ga_uncancell f   =  VerilogModule [] "ga_cancelr" (\ [in1]     [out1,out2] -> "assign "++out1++"=1'b0;\n assign"++out2++"="++in1)
-  ga_uncancelr f   =  VerilogModule [] "ga_cancelr" (\ [in1]     [out1,out2] -> "assign "++out2++"=1'b0;\n assign"++out1++"="++in1)
-  ga_assoc     f   =  
-  ga_unassoc   :: g (x**(y**z)) ((x**y)**z)
-
-instance GArrowDrop GArrowVerilog (,) where
-  ga_drop      =
-
-instance GArrowCopy GArrowVerilog (,) where
-  ga_copy      =
-
-instance GArrowSwap GArrowVerilog (,) where
-  ga_swap      =
-
-instance GArrowLoop GArrowVerilog (,) where
-  ga_loop      =
-
-instance GArrowLiteral GArrowVerilog (,) where
-  ga_literal   =
--}
-
-
-
-
-
-{-
-lambda calculus interpreter
-
-data Val =
-  Num Int
-| Fun <[Val -> Val]>
-
-This requires higher-order functions in the second level...
-
-eval :: Exp -> a Env Val
-eval (Var s)        = <[ lookup s ]>
-eval (Add e1 e2)    = <[ let (Num v1) = ~(eval e1)
-                      in let (Num v2) = ~(eval e2)
-                      in (Num (v1+v2)) ]>
-eval (If  e1 e2 e3) = <[ let v1 = ~(eval e1) in
-                      in if v1
-                         then ~(eval e2)
-                         else ~(eval e3) ]>
-eval (Lam x  e)     = ???
-
-eval (Var s) = proc env ->
-                returnA -< fromJust (lookup s env)
-eval (Add e1 e2) = proc env ->
-                (eval e1 -< env) `bind` \ ~(Num u) ->
-                (eval e2 -< env) `bind` \ ~(Num v) ->
-                returnA -< Num (u + v)
-eval (If e1 e2 e3) = proc env ->
-                (eval e1 -< env) `bind` \ ~(Bl b) ->
-                if b    then eval e2 -< env
-                        else eval e3 -< env
-eval (Lam x e) = proc env ->
-                returnA -< Fun (proc v -> eval e -< (x,v):env)
-eval (App e1 e2) = proc env ->
-                (eval e1 -< env) `bind` \ ~(Fun f) ->
-                (eval e2 -< env) `bind` \ v ->
-                f -< v
-
-eval (Var s)       = <[ \env -> fromJust (lookup s env)             ]>
-eval (Add e1 e2)   = <[ \env -> (~(eval e1) env) + (~(eval e2) env) ]>
-eval (If e1 e2 e3) = <[ \env -> if   ~(eval e1) env
-                                then ~(eval e2) env
-                                else ~(eval e2) env
-eval (Lam x e)     = <[ \env -> Fun (\v -> ~(eval e) ((x,v):env)) ]>
-eval (App e1 e2)   = <[ \env -> case ~(eval e1) env of
-                                   (Fun f) -> f (~(eval e2) env) ]>
-eval (Var s)     <[env]> = <[ fromJust (lookup s env)             ]>
-eval (Add e1 e2) <[env]> = <[ (~(eval e1) env) + (~(eval e2) env) ]>
--}
-
-
-
-
-
-{-
-immutable heap with cycles
-
--- an immutable heap; maps Int->(Int,Int)
-
-alloc  :: A (Int,Int) Int
-lookup :: A Int       (Int,Int)
-
-onetwocycle :: A (Int,Int) (Int,Int)
-onetwocycle =
-  proc \(x,y)-> do
-                 x' <- alloc -< (1,y)
-                 y' <- alloc -< (2,x)
-                 return (x',y')
-\end{verbatim}
-
-\begin{verbatim}
-alloc  :: <[ (Int,Int) ->  Int      ]>
-lookup :: <[ Int       -> (Int,Int) ]>
-
-onetwocycle :: <[ (Int,Int) ]> -> <[ (Int,Int) ]>
-onetwocycle x y = <[
-  let    x' = ~alloc (1,~y)
-  in let y' = ~alloc (2,~x)
-  in (x',y')
-]>
-
-onetwocycle' :: <[ (Int,Int) -> (Int,Int) ]>
-onetwocycle' = back2 onetwocycle
-\end{verbatim}
--}
-
-
-
-
-{-
-The example may seem a little contrived, but its purpose is to
-illustrate the be- haviour when the argument of mapC refers both to
-its parameter and a free vari- able (n).
-
-\begin{verbatim}
--- we can use mapA rather than mapC (from page 100)
-
-mapA f = proc xs -> case xs of
-[] -> returnA -< [] x:xs’ -> do y <- f -< x
-ys’ <- mapA f -< xs’ returnA -< y:ys
-
-example2 =
-   <[ \(n,xs) -> 
-       ~(mapA <[ \x-> (~(delay 0) n, x) ]> )
-        xs
-    ]>
-
-<[ example2 (n,xs) =
-   ~(mapA <[ \x-> (~(delay 0) n, x) ]> ) xs ]>
-\end{verbatim}
--}
-
-
-
-
-
-
-{-
-delaysA =
-   arr listcase >>>
-    arr (const []) |||
-     (arr id *** (delaysA >>> delay []) >>>
-       arr (uncurry (:)))
-
-nor :: SF (Bool,Bool) Bool
-nor = arr (not.uncurry (||))
-
-edge :: SF Bool Bool
-edge =
-   proc a -> do
-   b <- delay False -< a
-   returnA -< a && not b
-
-flipflop =
-   proc (reset,set) -> do
-   rec c <- delay False -< nor
-   reset d d <- delay True -< nor set c
-   returnA -< (c,d)
-
-halfAdd :: Arrow arr => arr (Bool,Bool) (Bool,Bool)
-halfAdd =
-   proc (x,y) -> returnA -< (x&&y, x/=y)
-
-fullAdd ::
-   Arrow arr => arr (Bool,Bool,Bool) (Bool,Bool)
-fullAdd =
-   proc (x,y,c) -> do
-   (c1,s1) <- halfAdd -< (x,y)
-   (c2,s2) <- halfAdd -< (s1,c)
-   returnA -< (c1||c2,s2)
-
-Here is the appendix of Hughes04:
-module Circuits where
-import Control.Arrow import List
-class ArrowLoop a => ArrowCircuit a where delay :: b -> a b b
-nor :: Arrow a => a (Bool,Bool) Bool nor = arr (not.uncurry (||))
-flipflop :: ArrowCircuit a => a (Bool,Bool) (Bool,Bool) flipflop = loop (arr (\((a,b),~(c,d)) -> ((a,d),(b,c))) >>>
-nor *** nor >>> delay (False,True) >>> arr id &&& arr id)
-class Signal a where showSignal :: [a] -> String
-instance Signal Bool where showSignal bs = concat top++"\n"++concat bot++"\n"
-where (top,bot) = unzip (zipWith sh (False:bs) bs) sh True True = ("__"," ") sh True False = (" ","|_") sh False True = (" _","| ")
-sh False False = (" ","__")
-instance (Signal a,Signal b) => Signal showSignal xys = showSignal (map fst showSignal (map snd
-instance Signal a => Signal [a] where showSignal = concat . map showSignal
-sig = concat . map (uncurry replicate)
-(a,b) where xys) ++ xys)
-. transpose
-flipflopInput = sig [(5,(False,False)),(2,(False,True)),(5,(False,False)),
-(2,(True,False)),(5,(False,False)),(2,(True,True)), (6,(False,False))]
-
-
-
-
-
--- from Hughes' "programming with Arrows"
-
-mapC :: ArrowChoice arr => arr (env,a) b -> arr (env,[a]) [b] mapC c = proc (env,xs) ->
-case xs of [] -> returnA -< [] x:xs’ -> do y <- c -< (env,x)
-ys <- mapC c -< (env,xs’) returnA -< y:ys
-
-example2 = proc (n,xs) -> (| mapC (\x-> do delay 0 -< n
-&&& do returnA -< x) |) xs
--}
-
-
-