manip trees: tweaks
[lambda.git] / list_monad_as_continuation_monad.mdwn
index b4158b1..e4772f8 100644 (file)
@@ -10,7 +10,7 @@ Rethinking the list monad
 To construct a monad, the key element is to settle on a type
 constructor, and the monad more or less naturally follows from that.
 We'll remind you of some examples of how monads follow from the type
-constructor in a moment.  This will involve some review of familair
+constructor in a moment.  This will involve some review of familiar
 material, but it's worth doing for two reasons: it will set up a
 pattern for the new discussion further below, and it will tie together
 some previously unconnected elements of the course (more specifically,
@@ -76,7 +76,7 @@ The **State Monad** is similar.  Once we've decided to use the following type co
 
 Then our unit is naturally:
 
-       let s_unit (a : 'a) : ('a state) = fun (s : store) -> (a, s)
+       let s_unit (a : 'a) : 'a state = fun (s : store) -> (a, s)
 
 And we can reason our way to the bind function in a way similar to the reasoning given above. First, we need to apply `f` to the contents of the `u` box:
 
@@ -88,7 +88,7 @@ need to posit a store `s` that we can apply `u` to.  Once we do so,
 however, we won't have an `'a`; we'll have a pair whose first element
 is an `'a`.  So we have to unpack the pair:
 
-       ... let (a, s') = u s in ... (f a) ...
+       ... let (a, s') = u s in ... f a ...
 
 Abstracting over the `s` and adjusting the types gives the result:
 
@@ -112,21 +112,21 @@ will provide a connection with continuations.
 Recall that `List.map` takes a function and a list and returns the
 result to applying the function to the elements of the list:
 
-       List.map (fun i -> [i;i+1]) [1;2] ~~> [[1; 2]; [2; 3]]
+       List.map (fun i -> [i; i+1]) [1; 2] ~~> [[1; 2]; [2; 3]]
 
-and List.concat takes a list of lists and erases the embdded list
+and `List.concat` takes a list of lists and erases the embedded list
 boundaries:
 
        List.concat [[1; 2]; [2; 3]] ~~> [1; 2; 2; 3]
 
 And sure enough,
 
-       l_bind [1;2] (fun i -> [i, i+1]) ~~> [1; 2; 2; 3]
+       l_bind [1; 2] (fun i -> [i; i+1]) ~~> [1; 2; 2; 3]
 
 Now, why this unit, and why this bind?  Well, ideally a unit should
 not throw away information, so we can rule out `fun x -> []` as an
 ideal unit.  And units should not add more information than required,
-so there's no obvious reason to prefer `fun x -> [x,x]`.  In other
+so there's no obvious reason to prefer `fun x -> [xx]`.  In other
 words, `fun x -> [x]` is a reasonable choice for a unit.
 
 As for bind, an `'a list` monadic object contains a lot of objects of
@@ -136,22 +136,22 @@ thing we know for sure we can do with an object of type `'a` is apply
 the function of type `'a -> 'a list` to them.  Once we've done so, we
 have a collection of lists, one for each of the `'a`'s.  One
 possibility is that we could gather them all up in a list, so that
-`bind' [1;2] (fun i -> [i;i]) ~~> [[1;1];[2;2]]`.  But that restricts
+`bind' [1; 2] (fun i -> [i; i]) ~~> [[1; 1]; [2; 2]]`.  But that restricts
 the object returned by the second argument of `bind` to always be of
-type `'b list list`.  We can elimiate that restriction by flattening
+type `'b list list`.  We can eliminate that restriction by flattening
 the list of lists into a single list: this is
-just List.concat applied to the output of List.map.  So there is some logic to the
+just `List.concat` applied to the output of `List.map`.  So there is some logic to the
 choice of unit and bind for the list monad.
 
 Yet we can still desire to go deeper, and see if the appropriate bind
 behavior emerges from the types, as it did for the previously
 considered monads.  But we can't do that if we leave the list type as
-a primitive Ocaml type.  However, we know several ways of implementing
-lists using just functions.  In what follows, we're going to use type
+a primitive OCaml type.  However, we know several ways of implementing
+lists using just functions.  In what follows, we're going to use version
 3 lists, the right fold implementation (though it's important and
 intriguing to wonder how things would change if we used some other
-strategy for implementating lists).  These were the lists that made
-lists look like Church numerals with extra bits embdded in them:
+strategy for implementing lists).  These were the lists that made
+lists look like Church numerals with extra bits embedded in them:
 
        empty list:                fun f z -> z
        list with one element:     fun f z -> f 1 z
@@ -174,7 +174,7 @@ types should be ourselves):
 We can see what the consistent, general principle types are at the end, so we
 can stop. These types should remind you of the simply-typed lambda calculus
 types for Church numerals (`(o -> o) -> o -> o`) with one extra type
-thrown in, the type of the element a the head of the list
+thrown in, the type of the element at the head of the list
 (in this case, an int).
 
 So here's our type constructor for our hand-rolled lists:
@@ -182,23 +182,23 @@ So here's our type constructor for our hand-rolled lists:
        type 'b list' = (int -> 'b -> 'b) -> 'b -> 'b
 
 Generalizing to lists that contain any kind of element (not just
-ints), we have
+`int`s), we have
 
        type ('a, 'b) list' = ('a -> 'b -> 'b) -> 'b -> 'b
 
 So an `('a, 'b) list'` is a list containing elements of type `'a`,
 where `'b` is the type of some part of the plumbing.  This is more
 general than an ordinary OCaml list, but we'll see how to map them
-into OCaml lists soon.  We don't need to fully grasp the role of the `'b`'s
+into OCaml lists soon.  We don't need to fully grasp the role of the `'b`s
 in order to proceed to build a monad:
 
        l'_unit (a : 'a) : ('a, 'b) list = fun a -> fun k z -> k a z
 
-No problem.  Arriving at bind is a little more complicated, but
-exactly the same principles apply, you just have to be careful and
-systematic about it.
+Take an `'a` and return its v3-style singleton. No problem.  Arriving at bind
+is a little more complicated, but exactly the same principles apply, you just
+have to be careful and systematic about it.
 
-       l'_bind (u : ('a,'b) list') (f : 'a -> ('c, 'd) list') : ('c, 'd) list'  = ...
+       l'_bind (u : ('a, 'b) list') (f : 'a -> ('c, 'd) list') : ('c, 'd) list'  = ...
 
 Unpacking the types gives:
 
@@ -206,28 +206,27 @@ Unpacking the types gives:
                (f : 'a -> ('c -> 'd -> 'd) -> 'd -> 'd)
                   : ('c -> 'd -> 'd) -> 'd -> 'd = ...
 
-Perhaps a bit intimiating.
+Perhaps a bit intimidating.
 But it's a rookie mistake to quail before complicated types. You should
-be no more intimiated by complex types than by a linguistic tree with
+be no more intimidated by complex types than by a linguistic tree with
 deeply embedded branches: complex structure created by repeated
 application of simple rules.
 
-[This would be a good time to try to build your own term for the types
-just given.  Doing so (or attempting to do so) will make the next
+[This would be a good time to try to reason your way to your own term having the type just specified.  Doing so (or attempting to do so) will make the next
 paragraph much easier to follow.]
 
 As usual, we need to unpack the `u` box.  Examine the type of `u`.
 This time, `u` will only deliver up its contents if we give `u` an
 argument that is a function expecting an `'a` and a `'b`. `u` will
-fold that function over its type `'a` members, and that's how we'll get the `'a`s we need. Thus:
+fold that function over its type `'a` members, and that's where we can get at the `'a`s we need. Thus:
 
        ... u (fun (a : 'a) (b : 'b) -> ... f a ... ) ...
 
-In order for `u` to have the kind of argument it needs, the `... (f a) ...` has to evaluate to a result of type `'b`. The easiest way to do this is to collapse (or "unify") the types `'b` and `'d`, with the result that `f a` will have type `('c -> 'b -> 'b) -> 'b -> 'b`. Let's postulate an argument `k` of type `('c -> 'b -> 'b)` and supply it to `(f a)`:
+In order for `u` to have the kind of argument it needs, the `fun a b -> ... f a ...` has to have type `'a -> 'b -> 'b`; so the `... f a ...` has to evaluate to a result of type `'b`. The easiest way to do this is to collapse (or "unify") the types `'b` and `'d`, with the result that `f a` will have type `('c -> 'b -> 'b) -> 'b -> 'b`. Let's postulate an argument `k` of type `('c -> 'b -> 'b)` and supply it to `f a`:
 
        ... u (fun (a : 'a) (b : 'b) -> ... f a k ... ) ...
 
-Now we have an argument `b` of type `'b`, so we can supply that to `(f a) k`, getting a result of type `'b`, as we need:
+Now the function we're supplying to `u` also receives an argument `b` of type `'b`, so we can supply that to `f a k`, getting a result of type `'b`, as we need:
 
        ... u (fun (a : 'a) (b : 'b) -> f a k b) ...
 
@@ -252,8 +251,8 @@ Now let's think about what this does. It's a wrapper around `u`. In order to beh
 
 Suppose we have a list' whose contents are `[1; 2; 4; 8]`---that is, our list' will be `fun f z -> f 1 (f 2 (f 4 (f 8 z)))`. We call that list' `u`. Suppose we also have a function `f` that for each `int` we give it, gives back a list of the divisors of that `int` that are greater than 1. Intuitively, then, binding `u` to `f` should give us:
 
-       concat (map f u) =
-       concat [[]; [2]; [2; 4]; [2; 4; 8]] =
+       List.concat (List.map f u) =
+       List.concat [[]; [2]; [2; 4]; [2; 4; 8]] =
        [2; 2; 4; 2; 4; 8]
 
 Or rather, it should give us a list' version of that, which takes a function `k` and value `z` as arguments, and returns the right fold of `k` and `z` over those elements. What does our formula
@@ -272,18 +271,18 @@ do? Well, for each element `a` in `u`, it applies `f` to that `a`, getting one o
 So if, for example, we let `k` be `+` and `z` be `0`, then the computation would proceed:
 
        0 ==>
-       right-fold + and 0 over [2; 4; 8] = ((2+4+8+0) ==>
-       right-fold + and 2+4+8+0 over [2; 4] = 2+4+(2+4+8+0) ==>
-       right-fold + and 2+4+2+4+8+0 over [2] = 2+(2+4+(2+4+8+0)) ==>
-       right-fold + and 2+2+4+2+4+8+0 over [] = 2+(2+4+(2+4+8+0))
+       right-fold + and 0 over [2; 4; 8] = 2+4+8+(0) ==>
+       right-fold + and 2+4+8+0 over [2; 4] = 2+4+(2+4+8+(0)) ==>
+       right-fold + and 2+4+2+4+8+0 over [2] = 2+(2+4+(2+4+8+(0))) ==>
+       right-fold + and 2+2+4+2+4+8+0 over [] = 2+(2+4+(2+4+8+(0)))
 
-which indeed is the result of right-folding + and 0 over `[2; 2; 4; 2; 4; 8]`. If you trace through how this works, you should be able to persuade yourself that our formula:
+which indeed is the result of right-folding `+` and `0` over `[2; 2; 4; 2; 4; 8]`. If you trace through how this works, you should be able to persuade yourself that our formula:
 
        fun k z -> u (fun a b -> f a k b) z
 
-will deliver just the same folds, for arbitrary choices of `k` and `z` (with the right types), and arbitrary list's `u` and appropriately-typed `f`s, as
+will deliver just the same folds, for arbitrary choices of `k` and `z` (with the right types), and arbitrary `list'`s `u` and appropriately-typed `f`s, as
 
-       fun k z -> List.fold_right k (concat (map f u)) z
+       fun k z -> List.fold_right k (List.concat (List.map f u)) z
 
 would.
 
@@ -293,7 +292,7 @@ For future reference, we might make two eta-reductions to our formula, so that w
 
 Let's make some more tests:
 
-       l_bind [1;2] (fun i -> [i, i+1]) ~~> [1; 2; 2; 3]
+       l_bind [1; 2] (fun i -> [i; i+1]) ~~> [1; 2; 2; 3]
        
        l'_bind (fun f z -> f 1 (f 2 z))
            (fun i -> fun f z -> f i (f (i+1) z)) ~~> <fun>
@@ -358,6 +357,8 @@ This can be eta-reduced to:
 
        let l'_unit a = fun k -> k a
 
+and:
+
        let l'_bind u f =
            (* we mentioned three versions of this, the fully eta-expanded: *)
            fun k z -> u (fun a b -> f a k b) z