tweak ass10
[lambda.git] / manipulating_trees_with_monads.mdwn
index 3247ce6..0d9e33d 100644 (file)
@@ -6,17 +6,17 @@ Manipulating trees with monads
 This topic develops an idea based on a suggestion of Ken Shan's.
 We'll build a series of functions that operate on trees, doing various
 things, including updating leaves with a Reader monad, counting nodes
 This topic develops an idea based on a suggestion of Ken Shan's.
 We'll build a series of functions that operate on trees, doing various
 things, including updating leaves with a Reader monad, counting nodes
-with a State monad, replacing leaves with a List monad, and converting
+with a State monad, copying the tree with a List monad, and converting
 a tree into a list of leaves with a Continuation monad.  It will turn
 out that the continuation monad can simulate the behavior of each of
 the other monads.
 
 a tree into a list of leaves with a Continuation monad.  It will turn
 out that the continuation monad can simulate the behavior of each of
 the other monads.
 
-From an engineering standpoint, we'll build a tree transformer that
+From an engineering standpoint, we'll build a tree machine that
 deals in monads.  We can modify the behavior of the system by swapping
 one monad for another.  We've already seen how adding a monad can add
 a layer of funtionality without disturbing the underlying system, for
 instance, in the way that the Reader monad allowed us to add a layer
 deals in monads.  We can modify the behavior of the system by swapping
 one monad for another.  We've already seen how adding a monad can add
 a layer of funtionality without disturbing the underlying system, for
 instance, in the way that the Reader monad allowed us to add a layer
-of intensionality to an extensional grammar, but we have not yet seen
+of intensionality to an extensional grammar. But we have not yet seen
 the utility of replacing one monad with other.
 
 First, we'll be needing a lot of trees for the remainder of the
 the utility of replacing one monad with other.
 
 First, we'll be needing a lot of trees for the remainder of the
@@ -52,9 +52,9 @@ Our first task will be to replace each leaf with its double:
            | Node (l, r) -> Node (tree_map leaf_modifier l,
                                   tree_map leaf_modifier r);;
 
            | Node (l, r) -> Node (tree_map leaf_modifier l,
                                   tree_map leaf_modifier r);;
 
-`tree_map` takes a function that transforms old leaves into new leaves,
-and maps that function over all the leaves in the tree, leaving the
-structure of the tree unchanged.  For instance:
+`tree_map` takes a tree and a function that transforms old leaves into
+new leaves, and maps that function over all the leaves in the tree,
+leaving the structure of the tree unchanged.  For instance:
 
        let double i = i + i;;
        tree_map double t1;;
 
        let double i = i + i;;
        tree_map double t1;;
@@ -76,7 +76,7 @@ We could have built the doubling operation right into the `tree_map`
 code.  However, because we've made what to do to each leaf a
 parameter, we can decide to do something else to the leaves without
 needing to rewrite `tree_map`.  For instance, we can easily square
 code.  However, because we've made what to do to each leaf a
 parameter, we can decide to do something else to the leaves without
 needing to rewrite `tree_map`.  For instance, we can easily square
-each leaf instead by supplying the appropriate `int -> int` operation
+each leaf instead, by supplying the appropriate `int -> int` operation
 in place of `double`:
 
        let square i = i * i;;
 in place of `double`:
 
        let square i = i * i;;
@@ -95,26 +95,26 @@ a Reader monad---is to have the `tree_map` function return a (monadized)
 tree that is ready to accept any `int -> int` function and produce the
 updated tree.
 
 tree that is ready to accept any `int -> int` function and produce the
 updated tree.
 
-       \f      .
-          _____|____
-          |        |
-          .        .
-        __|___   __|___
-        |    |   |    |
-       f 2  f 3  f 5  .
-                    __|___
-                    |    |
-                   f 7  f 11
+       fun e ->    .
+              _____|____
+              |        |
+              .        .
+            __|___   __|___
+            |    |   |    |
+           e 2  e 3  e 5  .
+                        __|___
+                        |    |
+                       e 7  e 11
 
 That is, we want to transform the ordinary tree `t1` (of type `int
 tree`) into a reader monadic object of type `(int -> int) -> int
 tree`: something that, when you apply it to an `int -> int` function
 
 That is, we want to transform the ordinary tree `t1` (of type `int
 tree`) into a reader monadic object of type `(int -> int) -> int
 tree`: something that, when you apply it to an `int -> int` function
-`f` returns an `int tree` in which each leaf `i` has been replaced
-with `f i`.
+`e` returns an `int tree` in which each leaf `i` has been replaced
+with `e i`.
 
 [Application note: this kind of reader object could provide a model
 for Kaplan's characters.  It turns an ordinary tree into one that
 
 [Application note: this kind of reader object could provide a model
 for Kaplan's characters.  It turns an ordinary tree into one that
-expects contextual information (here, the `λ f`) that can be
+expects contextual information (here, the `e`) that can be
 used to compute the content of indexicals embedded arbitrarily deeply
 in the tree.]
 
 used to compute the content of indexicals embedded arbitrarily deeply
 in the tree.]
 
@@ -127,17 +127,22 @@ will be some function of type `int -> int`. "Looking up" some `int` in
 the environment will return us the `int` that comes out the other side
 of that function.
 
 the environment will return us the `int` that comes out the other side
 of that function.
 
-       type 'a reader = (int -> int) -> 'a;;  (* mnemonic: e for environment *)
+       type 'a reader = (int -> int) -> 'a;;
        let reader_unit (a : 'a) : 'a reader = fun _ -> a;;
        let reader_unit (a : 'a) : 'a reader = fun _ -> a;;
-       let reader_bind (u: 'a reader) (f : 'a -> 'b reader) : 'b reader = fun e -> f (u e) e;;
+       let reader_bind (u: 'a reader) (f : 'a -> 'b reader) : 'b reader =
+         fun e -> f (u e) e;;
 
 It would be a simple matter to turn an *integer* into an `int reader`:
 
 
 It would be a simple matter to turn an *integer* into an `int reader`:
 
-       let int_readerize : int -> int reader = fun (a : int) -> fun (modifier : int -> int) -> modifier a;;
-       int_readerize 2 (fun i -> i + i);;
+       let asker : int -> int reader =
+         fun (a : int) ->
+           fun (modifier : int -> int) -> modifier a;;
+       asker 2 (fun i -> i + i);;
        - : int = 4
 
        - : int = 4
 
-But how do we do the analagous transformation when our `int`s are scattered over the leaves of a tree? How do we turn an `int tree` into a reader?
+`asker a` is a monadic box that waits for an an environment (here, the argument `modifier`) and returns what that environment maps `a` to.
+
+How do we do the analagous transformation when our `int`s are scattered over the leaves of a tree? How do we turn an `int tree` into a reader?
 A tree is not the kind of thing that we can apply a
 function of type `int -> int` to.
 
 A tree is not the kind of thing that we can apply a
 function of type `int -> int` to.
 
@@ -151,7 +156,7 @@ But we can do this:
                                 reader_unit (Node (l', r'))));;
 
 This function says: give me a function `f` that knows how to turn
                                 reader_unit (Node (l', r'))));;
 
 This function says: give me a function `f` that knows how to turn
-something of type `'a` into an `'b reader`---this is a function of the same type that you could bind an `'a reader` to---and I'll show you how to
+something of type `'a` into an `'b reader`---this is a function of the same type that you could bind an `'a reader` to, such as `asker` or `reader_unit`---and I'll show you how to
 turn an `'a tree` into an `'b tree reader`.  That is, if you show me how to do this:
 
                      ------------
 turn an `'a tree` into an `'b tree reader`.  That is, if you show me how to do this:
 
                      ------------
@@ -185,17 +190,17 @@ Then we can expect that supplying it to our `int tree reader` will double all th
 In more fanciful terms, the `tree_monadize` function builds plumbing that connects all of the leaves of a tree into one connected monadic network; it threads the
 `'b reader` monad through the original tree's leaves.
 
 In more fanciful terms, the `tree_monadize` function builds plumbing that connects all of the leaves of a tree into one connected monadic network; it threads the
 `'b reader` monad through the original tree's leaves.
 
-       # tree_monadize int_readerize t1 double;;
+       # tree_monadize asker t1 double;;
        - : int tree =
        Node (Node (Leaf 4, Leaf 6), Node (Leaf 10, Node (Leaf 14, Leaf 22)))
 
 Here, our environment is the doubling function (`fun i -> i + i`).  If
 we apply the very same `int tree reader` (namely, `tree_monadize
        - : int tree =
        Node (Node (Leaf 4, Leaf 6), Node (Leaf 10, Node (Leaf 14, Leaf 22)))
 
 Here, our environment is the doubling function (`fun i -> i + i`).  If
 we apply the very same `int tree reader` (namely, `tree_monadize
-int_readerize t1`) to a different `int -> int` function---say, the
+asker t1`) to a different `int -> int` function---say, the
 squaring function, `fun i -> i * i`---we get an entirely different
 result:
 
 squaring function, `fun i -> i * i`---we get an entirely different
 result:
 
-       # tree_monadize int_readerize t1 square;;
+       # tree_monadize asker t1 square;;
        - : int tree =
        Node (Node (Leaf 4, Leaf 9), Node (Leaf 25, Node (Leaf 49, Leaf 121)))
 
        - : int tree =
        Node (Node (Leaf 4, Leaf 9), Node (Leaf 25, Node (Leaf 49, Leaf 121)))
 
@@ -222,88 +227,95 @@ modification whatsoever, except for replacing the (parametric) type
 
 Then we can count the number of leaves in the tree:
 
 
 Then we can count the number of leaves in the tree:
 
-       # tree_monadize (fun a -> fun s -> (a, s+1)) t1 0;;
+       # let incrementer = fun a ->
+           fun s -> (a, s+1);;
+       
+       # tree_monadize incrementer t1 0;;
        - : int tree * int =
        (Node (Node (Leaf 2, Leaf 3), Node (Leaf 5, Node (Leaf 7, Leaf 11))), 5)
        
        - : int tree * int =
        (Node (Node (Leaf 2, Leaf 3), Node (Leaf 5, Node (Leaf 7, Leaf 11))), 5)
        
-           .
-        ___|___
-        |     |
-        .     .
-       _|__  _|__         , 5
-       |  |  |  |
-       2  3  5  .
-               _|__
-               |  |
-               7  11
+               .
+            ___|___
+            |     |
+            .     .
+        (  _|__  _|__     ,   5 )
+           |  |  |  |
+           2  3  5  .
+                   _|__
+                   |  |
+                   7  11
 
 Note that the value returned is a pair consisting of a tree and an
 integer, 5, which represents the count of the leaves in the tree.
 
 
 Note that the value returned is a pair consisting of a tree and an
 integer, 5, which represents the count of the leaves in the tree.
 
-Why does this work? Because the operation `fun a -> fun s -> (a, s+1)`
-takes an `int` and wraps it in an `int state` monadic box that
-increments the state. When we give that same operations to our
+Why does this work? Because the operation `incrementer`
+takes an argument `a` and wraps it in an State monadic box that
+increments the store and leaves behind a wrapped `a`. When we give that same operations to our
 `tree_monadize` function, it then wraps an `int tree` in a box, one
 `tree_monadize` function, it then wraps an `int tree` in a box, one
-that does the same state-incrementing for each of its leaves.
+that does the same store-incrementing for each of its leaves.
 
 
-We can use the state monad to replace leaves with a number
+We can use the state monad to annotate leaves with a number
 corresponding to that leave's ordinal position.  When we do so, we
 reveal the order in which the monadic tree forces evaluation:
 
 corresponding to that leave's ordinal position.  When we do so, we
 reveal the order in which the monadic tree forces evaluation:
 
-        # tree_monadize (fun a -> fun s -> (s+1, s+1)) t1 0;;
-        - : int tree * int =
-        (Node (Node (Leaf 1, Leaf 2), Node (Leaf 3, Node (Leaf 4, Leaf 5))), 5)
+       # tree_monadize (fun a -> fun s -> ((a,s+1), s+1)) t1 0;;
+       - : int tree * int =
+         (Node
+           (Node (Leaf (2, 1), Leaf (3, 2)),
+            Node
+             (Leaf (5, 3),
+              Node (Leaf (7, 4), Leaf (11, 5)))),
+         5)
 
 
-The key thing to notice is that instead of copying `a` into the
-monadic box, we throw away the `a` and put a copy of the state in
-instead.
+The key thing to notice is that instead of just wrapping `a` in the
+monadic box, we wrap a pair of `a` and the current store.
 
 
-Reversing the order requires reversing the order of the state_bind
+Reversing the annotation order requires reversing the order of the `state_bind`
 operations.  It's not obvious that this will type correctly, so think
 it through:
 
        let rec tree_monadize_rev (f : 'a -> 'b state) (t : 'a tree) : 'b tree state =
 operations.  It's not obvious that this will type correctly, so think
 it through:
 
        let rec tree_monadize_rev (f : 'a -> 'b state) (t : 'a tree) : 'b tree state =
-           match t with
+         match t with
            | Leaf a -> state_bind (f a) (fun b -> state_unit (Leaf b))
            | Node (l, r) -> state_bind (tree_monadize f r) (fun r' ->     (* R first *)
                               state_bind (tree_monadize f l) (fun l'->    (* Then L  *)
                                 state_unit (Node (l', r'))));;
            | Leaf a -> state_bind (f a) (fun b -> state_unit (Leaf b))
            | Node (l, r) -> state_bind (tree_monadize f r) (fun r' ->     (* R first *)
                               state_bind (tree_monadize f l) (fun l'->    (* Then L  *)
                                 state_unit (Node (l', r'))));;
+       
+       # tree_monadize_rev (fun a -> fun s -> ((a,s+1), s+1)) t1 0;;
+       - : int tree * int =
+         (Node
+           (Node (Leaf (2, 5), Leaf (3, 4)),
+            Node
+             (Leaf (5, 3),
+              Node (Leaf (7, 2), Leaf (11, 1)))),
+         5)
 
 
-        # tree_monadize_rev (fun a -> fun s -> (s+1, s+1)) t1 0;;
-        - : int tree * int =
-        (Node (Node (Leaf 5, Leaf 4), Node (Leaf 3, Node (Leaf 2, Leaf 1))), 5)
-
-We will need below to depend on controlling the order in which nodes
-are visited when we use the continuation monad to solve the
-same-fringe problem.
+Later, we will talk more about controlling the order in which nodes are visited.
 
 One more revealing example before getting down to business: replacing
 
 One more revealing example before getting down to business: replacing
-`state` everywhere in `tree_monadize` with `list` gives us
+`state` everywhere in `tree_monadize` with `list` lets us do:
 
 
-       # tree_monadize (fun i -> [ [i; square i] ]) t1;;
-       - : int list tree list =
-       [Node
-         (Node (Leaf [2; 4], Leaf [3; 9]),
-          Node (Leaf [5; 25], Node (Leaf [7; 49], Leaf [11; 121])))]
+       # let decider i = if i = 2 then [20; 21] else [i];;
+       # tree_monadize decider t1;;
+       - : int tree List_monad.m =
+       [
+         Node (Node (Leaf 20, Leaf 3), Node (Leaf 5, Node (Leaf 7, Leaf 11)));
+         Node (Node (Leaf 21, Leaf 3), Node (Leaf 5, Node (Leaf 7, Leaf 11)))
+       ]
 
 
-Unlike the previous cases, instead of turning a tree into a function
-from some input to a result, this transformer replaces each `int` with
-a list of `int`'s. We might also have done this with a Reader monad, though then our environments would need to be of type `int -> int list`. Experiment with what happens if you supply the `tree_monadize` based on the List monad an operation like `fun i -> [2*i; 3*i]`. Use small trees for your experiment.
 
 
-[Why is the argument to `tree_monadize` `int -> int list list` instead
-of `int -> int list`?  Well, as usual, the List monad bind operation
-will erase the outer list box, so if we want to replace the leaves
-with lists, we have to nest the replacement lists inside a disposable
-box.]
+Unlike the previous cases, instead of turning a tree into a function
+from some input to a result, this monadized tree gives us back a list of trees,
+one for each choice of `int`s for its leaves.
 
 Now for the main point.  What if we wanted to convert a tree to a list
 of leaves?
 
 
 Now for the main point.  What if we wanted to convert a tree to a list
 of leaves?
 
-       type ('a, 'r) continuation = ('a -> 'r) -> 'r;;
+       type ('r,'a) continuation = ('a -> 'r) -> 'r;;
        let continuation_unit a = fun k -> k a;;
        let continuation_bind u f = fun k -> u (fun a -> f a k);;
        
        let continuation_unit a = fun k -> k a;;
        let continuation_bind u f = fun k -> u (fun a -> f a k);;
        
-       let rec tree_monadize (f : 'a -> ('b, 'r) continuation) (t : 'a tree) : ('b tree, 'r) continuation =
+       let rec tree_monadize (f : 'a -> ('r,'b) continuation) (t : 'a tree) : ('r,'b tree) continuation =
            match t with
            | Leaf a -> continuation_bind (f a) (fun b -> continuation_unit (Leaf b))
            | Node (l, r) -> continuation_bind (tree_monadize f l) (fun l' ->
            match t with
            | Leaf a -> continuation_bind (f a) (fun b -> continuation_unit (Leaf b))
            | Node (l, r) -> continuation_bind (tree_monadize f l) (fun l' ->
@@ -315,15 +327,15 @@ We use the Continuation monad described above, and insert the
 
 So for example, we compute:
 
 
 So for example, we compute:
 
-       # tree_monadize (fun a -> fun k -> a :: k a) t1 (fun t -> []);;
+       # tree_monadize (fun a k -> a :: k ()) t1 (fun _ -> []);;
        - : int list = [2; 3; 5; 7; 11]
 
 We have found a way of collapsing a tree into a list of its
 leaves. Can you trace how this is working? Think first about what the
        - : int list = [2; 3; 5; 7; 11]
 
 We have found a way of collapsing a tree into a list of its
 leaves. Can you trace how this is working? Think first about what the
-operation `fun a -> fun k -> a :: k a` does when you apply it to a
+operation `fun a k -> a :: k a` does when you apply it to a
 plain `int`, and the continuation `fun _ -> []`. Then given what we've
 said about `tree_monadize`, what should we expect `tree_monadize (fun
 plain `int`, and the continuation `fun _ -> []`. Then given what we've
 said about `tree_monadize`, what should we expect `tree_monadize (fun
-a -> fun k -> a :: k a` to do?
+a -> fun k -> a :: k a)` to do?
 
 Soon we'll return to the same-fringe problem.  Since the
 simple but inefficient way to solve it is to map each tree to a list
 
 Soon we'll return to the same-fringe problem.  Since the
 simple but inefficient way to solve it is to map each tree to a list
@@ -349,27 +361,17 @@ interesting functions for the first argument of `tree_monadize`:
        - : int tree =
        Node (Node (Leaf 4, Leaf 9), Node (Leaf 25, Node (Leaf 49, Leaf 121)))
 
        - : int tree =
        Node (Node (Leaf 4, Leaf 9), Node (Leaf 25, Node (Leaf 49, Leaf 121)))
 
-       (* Simulating the int list tree list *)
-       # tree_monadize (fun a -> fun k -> k [a; square a]) t1 (fun t -> t);;
-       - : int list tree =
-       Node
-        (Node (Leaf [2; 4], Leaf [3; 9]),
-         Node (Leaf [5; 25], Node (Leaf [7; 49], Leaf [11; 121])))
-
        (* Counting leaves *)
        # tree_monadize (fun a -> fun k -> 1 + k a) t1 (fun t -> 0);;
        - : int = 5
 
        (* Counting leaves *)
        # tree_monadize (fun a -> fun k -> 1 + k a) t1 (fun t -> 0);;
        - : int = 5
 
-[To be fixed: exactly which kind of monad each of these computations simulates.]
-
-We could simulate the tree state example too by setting the relevant 
-type to `('a, 'state -> 'result) continuation`.
-In fact, Andre Filinsky has suggested that the continuation monad is
-able to simulate any other monad (Google for "mother of all monads").
+It's not immediately obvious to us how to simulate the List monadization of the tree using this technique.
 
 
-We would eventually want to generalize the continuation type to
+We could simulate the tree annotating example by setting the relevant 
+type to `(store -> 'result, 'a) continuation`.
 
 
-       type ('a, 'b, 'c) continuation = ('a -> 'b) -> 'c;;
+Andre Filinsky has proposed that the continuation monad is
+able to simulate any other monad (Google for "mother of all monads").
 
 If you want to see how to parameterize the definition of the `tree_monadize` function, so that you don't have to keep rewriting it for each new monad, see [this code](/code/tree_monadize.ml).
 
 
 If you want to see how to parameterize the definition of the `tree_monadize` function, so that you don't have to keep rewriting it for each new monad, see [this code](/code/tree_monadize.ml).
 
@@ -389,8 +391,8 @@ natural language meaning.
 
 **Quantification and default quantifier scope construal**.  
 
 
 **Quantification and default quantifier scope construal**.  
 
-We saw in the copy-string example and in the same-fringe example that
-local properties of a tree (whether a character is `S` or not, which
+We saw in the copy-string example ("abSd") and in the same-fringe example that
+local properties of a structure (whether a character is `'S'` or not, which
 integer occurs at some leaf position) can control global properties of
 the computation (whether the preceeding string is copied or not,
 whether the computation halts or proceeds).  Local control of
 integer occurs at some leaf position) can control global properties of
 the computation (whether the preceeding string is copied or not,
 whether the computation halts or proceeds).  Local control of
@@ -408,65 +410,57 @@ direct object position, and a universal quantifier that takes scope
 over the whole sentence.  If we have a lexical meaning function like
 the following:
 
 over the whole sentence.  If we have a lexical meaning function like
 the following:
 
-<pre>
-let lex (s:string) k = match s with 
-  | "everyone" -> Node (Leaf "forall x", k "x")
-  | "someone" -> Node (Leaf "exists y", k "y")
-  | _ -> k s;;
-
-let sentence1 = Node (Leaf "John", 
-                      Node (Node (Leaf "saw", 
-                                  Leaf "everyone"), 
-                            Leaf "yesterday"));;
-</pre>
+       let lex (s:string) k = match s with 
+         | "everyone" -> Node (Leaf "forall x", k "x")
+         | "someone" -> Node (Leaf "exists y", k "y")
+         | _ -> k s;;
 
 Then we can crudely approximate quantification as follows:
 
 
 Then we can crudely approximate quantification as follows:
 
-<pre>
-# tree_monadize lex sentence1 (fun x -> x);;
-- : string tree =
-Node
- (Leaf "forall x",
-  Node (Leaf "John", Node (Node (Leaf "saw", Leaf "x"), Leaf "yesterday")))
-</pre>
+       # let sentence1 = Node (Leaf "John", 
+                                                 Node (Node (Leaf "saw", 
+                                                                         Leaf "everyone"), 
+                                                               Leaf "yesterday"));;
+
+       # tree_monadize lex sentence1 (fun x -> x);;
+       - : string tree =
+       Node
+        (Leaf "forall x",
+         Node (Leaf "John", Node (Node (Leaf "saw", Leaf "x"), Leaf "yesterday")))
 
 In order to see the effects of evaluation order, 
 observe what happens when we combine two quantifiers in the same
 sentence:
 
 
 In order to see the effects of evaluation order, 
 observe what happens when we combine two quantifiers in the same
 sentence:
 
-<pre>
-# let sentence2 = Node (Leaf "everyone", Node (Leaf "saw", Leaf "someone"));;
-# tree_monadize lex sentence2 (fun x -> x);;
-- : string tree =
-Node
- (Leaf "forall x",
-  Node (Leaf "exists y", Node (Leaf "x", Node (Leaf "saw", Leaf "y"))))
-</pre>
+       # let sentence2 = Node (Leaf "everyone", Node (Leaf "saw", Leaf "someone"));;
+       # tree_monadize lex sentence2 (fun x -> x);;
+       - : string tree =
+       Node
+        (Leaf "forall x",
+         Node (Leaf "exists y", Node (Leaf "x", Node (Leaf "saw", Leaf "y"))))
 
 The universal takes scope over the existential.  If, however, we
 
 The universal takes scope over the existential.  If, however, we
-replace the usual tree_monadizer with tree_monadizer_rev, we get
+replace the usual `tree_monadizer` with `tree_monadizer_rev`, we get
 inverse scope:
 
 inverse scope:
 
-<pre>
-# tree_monadize_rev lex sentence2 (fun x -> x);;
-- : string tree =
-Node
- (Leaf "exists y",
-  Node (Leaf "forall x", Node (Leaf "x", Node (Leaf "saw", Leaf "y"))))
-</pre>
+       # tree_monadize_rev lex sentence2 (fun x -> x);;
+       - : string tree =
+       Node
+        (Leaf "exists y",
+         Node (Leaf "forall x", Node (Leaf "x", Node (Leaf "saw", Leaf "y"))))
 
 There are many crucially important details about quantification that
 
 There are many crucially important details about quantification that
-are being simplified here, and the continuation treatment here is not
+are being simplified here, and the continuation treatment used here is not
 scalable for a number of reasons.  Nevertheless, it will serve to give
 an idea of how continuations can provide insight into the behavior of
 scalable for a number of reasons.  Nevertheless, it will serve to give
 an idea of how continuations can provide insight into the behavior of
-quantifiers.  
+quantifiers.
 
 
 
 
-The Binary Tree monad
----------------------
+The Tree monad
+==============
 
 
-Of course, by now you may have realized that we have discovered a new
-monad, the Binary Tree monad.  Just as mere lists are in fact a monad,
+Of course, by now you may have realized that we are working with a new
+monad, the binary, leaf-labeled Tree monad.  Just as mere lists are in fact a monad,
 so are trees.  Here is the type constructor, unit, and bind:
 
        type 'a tree = Leaf of 'a | Node of ('a tree) * ('a tree);;
 so are trees.  Here is the type constructor, unit, and bind:
 
        type 'a tree = Leaf of 'a | Node of ('a tree) * ('a tree);;
@@ -484,20 +478,20 @@ To check the other two laws, we need to make the following
 observation: it is easy to prove based on `tree_bind` by a simple
 induction on the structure of the first argument that the tree
 resulting from `bind u f` is a tree with the same strucure as `u`,
 observation: it is easy to prove based on `tree_bind` by a simple
 induction on the structure of the first argument that the tree
 resulting from `bind u f` is a tree with the same strucure as `u`,
-except that each leaf `a` has been replaced with `f a`:
+except that each leaf `a` has been replaced with the tree returned by `f a`:
 
                        .                         .
                      __|__                     __|__
 
                        .                         .
                      __|__                     __|__
-                     |   |                     |   |
+                     |   |                    /\   |
                      a1  .                   f a1  .
                         _|__                     __|__
                      a1  .                   f a1  .
                         _|__                     __|__
-                        |  |                     |   |
+                        |  |                     |   /\
                         .  a5                    .  f a5
           bind         _|__       f   =        __|__
                         .  a5                    .  f a5
           bind         _|__       f   =        __|__
-                       |  |                    |   |
+                       |  |                    |   /\
                        .  a4                   .  f a4
                      __|__                   __|___
                        .  a4                   .  f a4
                      __|__                   __|___
-                     |   |                   |    |
+                     |   |                  /\    /\
                      a2  a3                f a2  f a3
 
 Given this equivalence, the right identity law
                      a2  a3                f a2  f a3
 
 Given this equivalence, the right identity law
@@ -535,7 +529,7 @@ Now when we bind this tree to `g`, we get
 
 At this point, it should be easy to convince yourself that
 using the recipe on the right hand side of the associative law will
 
 At this point, it should be easy to convince yourself that
 using the recipe on the right hand side of the associative law will
-built the exact same final tree.
+build the exact same final tree.
 
 So binary trees are a monad.
 
 
 So binary trees are a monad.
 
@@ -548,25 +542,5 @@ that is intended to represent non-deterministic computations as a tree.
 What's this have to do with tree\_monadize?
 --------------------------------------------
 
 What's this have to do with tree\_monadize?
 --------------------------------------------
 
-So we've defined a Tree monad:
-
-       type 'a tree = Leaf of 'a | Node of ('a tree) * ('a tree);;
-       let tree_unit (a: 'a) : 'a tree = Leaf a;;
-       let rec tree_bind (u : 'a tree) (f : 'a -> 'b tree) : 'b tree =
-           match u with
-           | Leaf a -> f a
-           | Node (l, r) -> Node (tree_bind l f, tree_bind r f);;
-
-What's this have to do with the `tree_monadize` functions we defined earlier?
-
-       let rec tree_monadize (f : 'a -> 'b reader) (t : 'a tree) : 'b tree reader =
-           match t with
-           | Leaf a -> reader_bind (f a) (fun b -> reader_unit (Leaf b))
-           | Node (l, r) -> reader_bind (tree_monadize f l) (fun l' ->
-                              reader_bind (tree_monadize f r) (fun r' ->
-                                reader_unit (Node (l', r'))));;
-
-... and so on for different monads?
-
-The answer is that each of those `tree_monadize` functions is adding a Tree monad *layer* to a pre-existing Reader (and so on) monad. We discuss that further here: [[Monad Transformers]].
+Our different implementations of `tree_monadize` above were different *layerings* of the Tree monad with other monads (Reader, State, List, and Continuation). We'll explore that further here: [[Monad Transformers]].