The I's are done.

docs/reference/hypot.md

@@ -5,7 +5,7 @@
 Function
 
              x y hypot
-    --------------------------
+    ---------------------------
        sqrt(sqr(x) + sqr(y))
 
 ### Definition

docs/reference/id.md

@@ -2,28 +2,10 @@
 
 ## id
 
-Basis Function Combinator
+Basis Function
 
 The identity function.
 
-Gentzen diagram.
-
-### Definition
-
-if not basis.
-
-### Derivation
-
-if not basis.
-
-### Source
-
-if basis
-
 ### Discussion
 
-Lorem ipsum.
+Does nothing.  It's kind of a mathematical thing, but it occasionally comes in handy.
-
-### Crosslinks
-
-Lorem ipsum.

docs/reference/ifte.md

@@ -2,42 +2,20 @@
 
 ## ifte
 
-Basis Function Combinator
+Combinator
 
-If-Then-Else Combinator :
+If-Then-Else combinator, a common and convenient specialization of [branch].
 
-    ... [if] [then] [else] ifte
+            [if] [then] [else] ifte
-    ---------------------------------------------------
+    ---------------------------------------
-    ... [[else] [then]] [...] [if] infra select i
+       [if] nullary [else] [then] branch
-
-
-
-
-    ... [if] [then] [else] ifte
-    -------------------------------------------------------
-    ... [else] [then] [...] [if] infra first choice i
-
-Has the effect of grabbing a copy of the stack on which to run the
-if-part using infra.
-
-Gentzen diagram.
 
 ### Definition
 
-if not basis.
+> \[[nullary]\] [dipd] [swap] [branch]
-
-### Derivation
-
-if not basis.
-
-### Source
-
-if basis
-
-### Discussion
-
-Lorem ipsum.
 
 ### Crosslinks
 
-Lorem ipsum.
+[branch]
+[loop]
+[while]

docs/reference/infra.md

@@ -2,19 +2,18 @@
 
 ## infra
 
-(Combinator)
+Combinator
 
 Accept a quoted program and a list on the stack and run the program with
 the list as its stack.  Does not affect the stack (below the list.)
 
-       ... [a b c] [Q] infra
+       ... x y z [a b c] [Q] infra
-    ---------------------------
+    ---------------------------------
-        c b a Q [...] swaack
+        c b a Q [z y x ...] swaack
 
 ### Definition
 
-    swons swaack [i] dip swaack
+> [swons] [swaack] \[[i]\] [dip] [swaack]
-
 
 ### Discussion
 

docs/reference/infrst.md

@@ -2,28 +2,11 @@
 
 ## infrst
 
-Basis Function Combinator
+Combinator
 
-infra first
+Does [infra] and then extracts the [first] item from the resulting list.
-
-Gentzen diagram.
 
 ### Definition
 
-if not basis.
+> [infra] [first]
 
-### Derivation
-
-if not basis.
-
-### Source
-
-if basis
-
-### Discussion
-
-Lorem ipsum.
-
-### Crosslinks
-
-Lorem ipsum.

docs/reference/inscribe.md

@@ -2,32 +2,17 @@
 
 ## inscribe
 
-Basis Function Combinator
-
 Create a new Joy function definition in the Joy dictionary. A definition
-is given as a quote with a name followed by a Joy expression. for
+is given as a quote with a name followed by a Joy expression.
-example:
 
-> \[sqr dup mul\] inscribe
+### Example
 
-Gentzen diagram.
+    [sqr dup mul] inscribe
-
-### Definition
-
-if not basis.
-
-### Derivation
-
-if not basis.
-
-### Source
-
-if basis
 
 ### Discussion
 
-Lorem ipsum.
+This is the only function that modifies the dictionary.  It's provided as a 
+convenience, for tinkering with new definitions before entering them into
+the `defs.txt` file.  It can be abused, which you should avoid unless you
+know what you're doing.
 
-### Crosslinks
-
-Lorem ipsum.

docs/reference/mkref/Functor-Reference.md

@@ -1842,7 +1842,7 @@ item on the top of the stack is a quoted symbol.
 Function
 
              x y hypot
-    --------------------------
+    ---------------------------
        sqrt(sqr(x) + sqr(y))
 
 ### Definition
@@ -1881,75 +1881,35 @@ example, the [x] combinator can be defined as `dup i`.
 
 ## id
 
-Basis Function Combinator
+Basis Function
 
 The identity function.
 
-Gentzen diagram.
-
-### Definition
-
-if not basis.
-
-### Derivation
-
-if not basis.
-
-### Source
-
-if basis
-
 ### Discussion
 
-Lorem ipsum.
+Does nothing.  It's kind of a mathematical thing, but it occasionally comes in handy.
-
-### Crosslinks
-
-Lorem ipsum.
 
 ------------------------------------------------------------------------
 
 ## ifte
 
-Basis Function Combinator
+Combinator
 
-If-Then-Else Combinator :
+If-Then-Else combinator, a common and convenient specialization of [branch].
 
-    ... [if] [then] [else] ifte
+            [if] [then] [else] ifte
-    ---------------------------------------------------
+    ---------------------------------------
-    ... [[else] [then]] [...] [if] infra select i
+       [if] nullary [else] [then] branch
-
-
-
-
-    ... [if] [then] [else] ifte
-    -------------------------------------------------------
-    ... [else] [then] [...] [if] infra first choice i
-
-Has the effect of grabbing a copy of the stack on which to run the
-if-part using infra.
-
-Gentzen diagram.
 
 ### Definition
 
-if not basis.
+> \[[nullary]\] [dipd] [swap] [branch]
-
-### Derivation
-
-if not basis.
-
-### Source
-
-if basis
-
-### Discussion
-
-Lorem ipsum.
 
 ### Crosslinks
 
-Lorem ipsum.
+[branch]
+[loop]
+[while]
 
 ------------------------------------------------------------------------
 
@@ -2003,19 +1963,18 @@ In some cases (like the example above) this is the same effect as using [app2] b
 
 ## infra
 
-(Combinator)
+Combinator
 
 Accept a quoted program and a list on the stack and run the program with
 the list as its stack.  Does not affect the stack (below the list.)
 
-       ... [a b c] [Q] infra
+       ... x y z [a b c] [Q] infra
-    ---------------------------
+    ---------------------------------
-        c b a Q [...] swaack
+        c b a Q [z y x ...] swaack
 
 ### Definition
 
-    swons swaack [i] dip swaack
+> [swons] [swaack] \[[i]\] [dip] [swaack]
-
 
 ### Discussion
 
@@ -2033,65 +1992,33 @@ kind of "pocket universe".  If the list represents a datastructure then
 
 ## infrst
 
-Basis Function Combinator
+Combinator
 
-infra first
+Does [infra] and then extracts the [first] item from the resulting list.
-
-Gentzen diagram.
 
 ### Definition
 
-if not basis.
+> [infra] [first]
 
-### Derivation
-
-if not basis.
-
-### Source
-
-if basis
-
-### Discussion
-
-Lorem ipsum.
-
-### Crosslinks
-
-Lorem ipsum.
 
 ------------------------------------------------------------------------
 
 ## inscribe
 
-Basis Function Combinator
-
 Create a new Joy function definition in the Joy dictionary. A definition
-is given as a quote with a name followed by a Joy expression. for
+is given as a quote with a name followed by a Joy expression.
-example:
 
-> \[sqr dup mul\] inscribe
+### Example
 
-Gentzen diagram.
+    [sqr dup mul] inscribe
-
-### Definition
-
-if not basis.
-
-### Derivation
-
-if not basis.
-
-### Source
-
-if basis
 
 ### Discussion
 
-Lorem ipsum.
+This is the only function that modifies the dictionary.  It's provided as a 
+convenience, for tinkering with new definitions before entering them into
+the `defs.txt` file.  It can be abused, which you should avoid unless you
+know what you're doing.
 
-### Crosslinks
-
-Lorem ipsum.
 
 ------------------------------------------------------------------------