That is the F's done.

docs/reference/first.md

@@ -2,28 +2,22 @@
 
 ## first
 
-Basis Function Combinator
+Function
 
-    ([a1 ...1] -- a1)
+Replace a list with its first item.
 
-Gentzen diagram.
+       [a ...]
+    --------------
+          a
 
 ### Definition
 
-if not basis.
+> [uncons] [pop]
-
-### Derivation
-
-if not basis.
-
-### Source
-
-if basis
-
-### Discussion
-
-Lorem ipsum.
 
 ### Crosslinks
 
-Lorem ipsum.
+[second]
+[third]
+[fourth]
+[rest]
+

docs/reference/first_two.md

@@ -2,28 +2,23 @@
 
 ## first_two
 
-Basis Function Combinator
+Function
 
-    ([a1 a2 ...1] -- a1 a2)
+Replace a list with its first two items.
 
-Gentzen diagram.
+       [a b ...] first_two
+    -------------------------
+               a b
 
 ### Definition
 
-if not basis.
+> [uncons] [first]
-
-### Derivation
-
-if not basis.
-
-### Source
-
-if basis
-
-### Discussion
-
-Lorem ipsum.
 
 ### Crosslinks
 
-Lorem ipsum.
+[first]
+[second]
+[third]
+[fourth]
+[rest]
+

docs/reference/flatten.md

@@ -2,28 +2,44 @@
 
 ## flatten
 
-Basis Function Combinator
+Function
 
-\<{} \[concat\] step
+Given a list of lists, concatinate them.
 
-Gentzen diagram.
+### Example
+
+       [[1 2] [3 [4] 5] [6 7]] flatten
+    -------------------------------------
+              [1 2 3 [4] 5 6 7]
 
 ### Definition
 
-if not basis.
+> [\<\{\}] \[[concat]\] [step]
-
-### Derivation
-
-if not basis.
-
-### Source
-
-if basis
 
 ### Discussion
 
-Lorem ipsum.
+Note that only one "level" of lists is flattened.  In the example above
+`[4]` is not unquoted.
 
 ### Crosslinks
 
-Lorem ipsum.
+[concat]
+[first]
+[first_two]
+[fourth]
+[getitem]
+[remove]
+[rest]
+[reverse]
+[rrest]
+[second]
+[shift]
+[shunt]
+[size]
+[sort]
+[split_at]
+[split_list]
+[swaack]
+[third]
+[zip]
+

docs/reference/floor.md

@@ -2,30 +2,12 @@
 
 ## floor
 
-Basis Function Combinator
+Basis Function
 
-Return the floor of x as an Integral.
+Return the largest integer \<= x.
-
-This is the largest integer \<= x.
-
-Gentzen diagram.
-
-### Definition
-
-if not basis.
-
-### Derivation
-
-if not basis.
-
-### Source
-
-if basis
 
 ### Discussion
 
-Lorem ipsum.
+This function doesn't make sense (yet) to have because there are (as yet)
+only integers in the system.
 
-### Crosslinks
-
-Lorem ipsum.

docs/reference/floordiv.md

@@ -2,28 +2,21 @@
 
 ## floordiv
 
-Basis Function Combinator
+Basis Function
 
-Same as a // b.
+I don't know why this is called "floor" div, I think it rounds its
+result down (not towards zero or up.)
 
-Gentzen diagram.
+       a b floordiv
-
+    ------------------
-### Definition
+          (a/b)
-
-if not basis.
-
-### Derivation
-
-if not basis.
-
-### Source
-
-if basis
 
 ### Discussion
 
-Lorem ipsum.
+All the division commands need to be revisited when the "numeric tower"
+for Thun gets nailed down.
 
 ### Crosslinks
 
-Lorem ipsum.
+[divmod]
+

docs/reference/fork.md

@@ -2,28 +2,25 @@
 
 ## fork
 
-Basis Function Combinator
+Combinator
 
-\[i\] app2
+Run two quoted programs in parallel and replace them with their results.
 
-Gentzen diagram.
+       ... [F] [G] fork
+    ----------------------
+           ... f g
 
 ### Definition
 
-if not basis.
+> \[[i]\] [app2]
-
-### Derivation
-
-if not basis.
-
-### Source
-
-if basis
 
 ### Discussion
 
-Lorem ipsum.
+The basic parallelism combinator, the two programs are run independently.
 
 ### Crosslinks
 
-Lorem ipsum.
+[cleave]
+[clop]
+[map]
+

docs/reference/fourth.md

@@ -2,28 +2,22 @@
 
 ## fourth
 
-Basis Function Combinator
+Function
 
-    ([a1 a2 a3 a4 ...1] -- a4)
+Replace a list with its fourth item.
 
-Gentzen diagram.
+       [a b c d ...] fourth
+    --------------------------
+              d
 
 ### Definition
 
-if not basis.
+> [rest] [third]
-
-### Derivation
-
-if not basis.
-
-### Source
-
-if basis
-
-### Discussion
-
-Lorem ipsum.
 
 ### Crosslinks
 
-Lorem ipsum.
+[first]
+[second]
+[third]
+[rest]
+

docs/reference/mkref/Functor-Reference.md

@@ -1397,213 +1397,184 @@ Lorem ipsum.
 
 ## first
 
-Basis Function Combinator
+Function
 
-    ([a1 ...1] -- a1)
+Replace a list with its first item.
 
-Gentzen diagram.
+       [a ...]
+    --------------
+          a
 
 ### Definition
 
-if not basis.
+> [uncons] [pop]
-
-### Derivation
-
-if not basis.
-
-### Source
-
-if basis
-
-### Discussion
-
-Lorem ipsum.
 
 ### Crosslinks
 
-Lorem ipsum.
+[second]
+[third]
+[fourth]
+[rest]
+
 
 ------------------------------------------------------------------------
 
 ## first_two
 
-Basis Function Combinator
+Function
 
-    ([a1 a2 ...1] -- a1 a2)
+Replace a list with its first two items.
 
-Gentzen diagram.
+       [a b ...] first_two
+    -------------------------
+               a b
 
 ### Definition
 
-if not basis.
+> [uncons] [first]
-
-### Derivation
-
-if not basis.
-
-### Source
-
-if basis
-
-### Discussion
-
-Lorem ipsum.
 
 ### Crosslinks
 
-Lorem ipsum.
+[first]
+[second]
+[third]
+[fourth]
+[rest]
+
 
 ------------------------------------------------------------------------
 
 ## flatten
 
-Basis Function Combinator
+Function
 
-\<{} \[concat\] step
+Given a list of lists, concatinate them.
 
-Gentzen diagram.
+### Example
+
+       [[1 2] [3 [4] 5] [6 7]] flatten
+    -------------------------------------
+              [1 2 3 [4] 5 6 7]
 
 ### Definition
 
-if not basis.
+> [\<\{\}] \[[concat]\] [step]
-
-### Derivation
-
-if not basis.
-
-### Source
-
-if basis
 
 ### Discussion
 
-Lorem ipsum.
+Note that only one "level" of lists is flattened.  In the example above
+`[4]` is not unquoted.
 
 ### Crosslinks
 
-Lorem ipsum.
+[concat]
+[first]
+[first_two]
+[fourth]
+[getitem]
+[remove]
+[rest]
+[reverse]
+[rrest]
+[second]
+[shift]
+[shunt]
+[size]
+[sort]
+[split_at]
+[split_list]
+[swaack]
+[third]
+[zip]
+
 
 ------------------------------------------------------------------------
 
 ## floor
 
-Basis Function Combinator
+Basis Function
 
-Return the floor of x as an Integral.
+Return the largest integer \<= x.
-
-This is the largest integer \<= x.
-
-Gentzen diagram.
-
-### Definition
-
-if not basis.
-
-### Derivation
-
-if not basis.
-
-### Source
-
-if basis
 
 ### Discussion
 
-Lorem ipsum.
+This function doesn't make sense (yet) to have because there are (as yet)
+only integers in the system.
 
-### Crosslinks
-
-Lorem ipsum.
 
 ------------------------------------------------------------------------
 
 ## floordiv
 
-Basis Function Combinator
+Basis Function
 
-Same as a // b.
+I don't know why this is called "floor" div, I think it rounds its
+result down (not towards zero or up.)
 
-Gentzen diagram.
+       a b floordiv
-
+    ------------------
-### Definition
+          (a/b)
-
-if not basis.
-
-### Derivation
-
-if not basis.
-
-### Source
-
-if basis
 
 ### Discussion
 
-Lorem ipsum.
+All the division commands need to be revisited when the "numeric tower"
+for Thun gets nailed down.
 
 ### Crosslinks
 
-Lorem ipsum.
+[divmod]
+
 
 ------------------------------------------------------------------------
 
 ## fork
 
-Basis Function Combinator
+Combinator
 
-\[i\] app2
+Run two quoted programs in parallel and replace them with their results.
 
-Gentzen diagram.
+       ... [F] [G] fork
+    ----------------------
+           ... f g
 
 ### Definition
 
-if not basis.
+> \[[i]\] [app2]
-
-### Derivation
-
-if not basis.
-
-### Source
-
-if basis
 
 ### Discussion
 
-Lorem ipsum.
+The basic parallelism combinator, the two programs are run independently.
 
 ### Crosslinks
 
-Lorem ipsum.
+[cleave]
+[clop]
+[map]
+
 
 ------------------------------------------------------------------------
 
 ## fourth
 
-Basis Function Combinator
+Function
 
-    ([a1 a2 a3 a4 ...1] -- a4)
+Replace a list with its fourth item.
 
-Gentzen diagram.
+       [a b c d ...] fourth
+    --------------------------
+              d
 
 ### Definition
 
-if not basis.
+> [rest] [third]
-
-### Derivation
-
-if not basis.
-
-### Source
-
-if basis
-
-### Discussion
-
-Lorem ipsum.
 
 ### Crosslinks
 
-Lorem ipsum.
+[first]
+[second]
+[third]
+[rest]
+
 
 ------------------------------------------------------------------------