edits
[lambda.git] / zipper-lists-continuations.mdwn
index 08170a3..5980c6f 100644 (file)
@@ -33,16 +33,17 @@ then the choice of unit and bind is natural:
 
 Since the type of an `'a reader` is `env -> 'a` (by definition),
 the type of the `r_unit` function is `'a -> env -> 'a`, which is a
-specific case of the type of the *K* combinator.  It makes sense
+specific case of the type of the *K* combinator.  So it makes sense
 that *K* is the unit for the reader monad.
 
 Since the type of the `bind` operator is required to be
 
     r_bind : ('a reader) -> ('a -> 'b reader) -> ('b reader)
 
-We can reason our way to the correct `bind` function as follows. We start by declaring the type:
+We can reason our way to the correct `bind` function as follows. We
+start by declaring the types determined by the definition of a bind operation:
 
-    let r_bind (u : 'a reader) (f : 'a -> 'b reader) : ('b reader) =
+    let r_bind (u : 'a reader) (f : 'a -> 'b reader) : ('b reader) = ...
 
 Now we have to open up the `u` box and get out the `'a` object in order to
 feed it to `f`.  Since `u` is a function from environments to
@@ -127,10 +128,11 @@ 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
-words, `fun x -> [x]` is a reasonable guess for a unit.
+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
-type `'a`, and we want to make some use of each of them.  The only
+type `'a`, and we want to make some use of each of them (rather than
+arbitrarily throwing some of them away).  The only
 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
@@ -138,13 +140,14 @@ 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
 the object returned by the second argument of `bind` to always be of
 type `'b list list`.  We can elimiate that restriction by flattening
-the list of lists into a single list.  So there is some logic to the
+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
 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 is
-a primitive Ocaml type.  However, we know several ways of implementing
+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
 3 lists (the right fold implementation), though it's important to
 wonder how things would change if we used some other strategy for
@@ -157,8 +160,8 @@ Church numerals with extra bits embdded in them:
     list with three elements:  fun f z -> f 3 (f 2 (f 1 z))
 
 and so on.  To save time, we'll let the OCaml interpreter infer the
-principle types of these functions (rather than deducing what the
-types should be):
+principle types of these functions (rather than inferring what the
+types should be ourselves):
 
        # fun f z -> z;;
        - : 'a -> 'b -> 'b = <fun>
@@ -171,7 +174,8 @@ types should be):
 
 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 bit thrown in
+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
 (in this case, an int).
 
 So here's our type constructor for our hand-rolled lists:
@@ -203,14 +207,21 @@ Unpacking the types gives:
             (f : 'a -> ('c -> 'd -> 'd) -> 'd -> 'd)
             : ('c -> 'd -> 'd) -> 'd -> 'd = ...
 
+Perhaps a bit intimiating.
 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
 deeply embedded branches: complex structure created by repeated
 application of simple rules.
 
+The best way to follow the next long, somewhat intricate paragraph
+immediately following is to take this type and try to construct a term
+for it, just as we did for the monads above.  If you suceed, the
+discussion will just make brilliant sense.  If you get stuck, the
+discussion will explain how to proceed.
+
 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` as an
-argument 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:
+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:
 
        ... u (fun (a : 'a) (b : 'b) -> ... f a ... ) ...