selected edits of the guide

Taken from 37e4b8d1c277672ed948fb5638154bf3c057c2cc of
https://github.com/bluemont/ragel.git (branch doc-edit-1). Used
--word-diff=color to find changes among the whitespace and folding changes. The
word-diff seemed to break down about half way through the patch and nothing was
taken from that section.
port the OCaml doc changes back to the .txt file
port to colm 0.8
merged ocaml doc updates
fixed warnings in co-routine code

Follow co-routine rentry with {} instead of setting some unused variable.
Eliminates warnings and is all-around better.
moved the user state of pair iter into the pair iter class
ignore tmp.rl because it's my common testing file
PairIter -> RangePairIter. Will add ValPairIter for conditions.
cloned RangePairIter as ValPairIter

Will remove range support from ValPairIter. Using it for iterating condition
list pairs. Can then unify the lowKey and highKey of CondAp.
removed the range overlap and breaking from ValPairIter
added 'crack' to the list of languages known by xml code generator
put NextTrans in pair iters so we can specialize it per val and range
eliminated ranges from condition transitions

Condition values benefit very little from range-base orientation. We likely
have groups of values with bits both on and off, but only the lowest bit makes
the values adjacent in a numerical ordering. Some other ordering that lends
itself to optimization may be found, but leaving that to some later date (once
the current implementation is functional).
divided key into range key and cond key
cleaned up embedCondition

No real code changes, just updated comments and removed some dead code.
merge in new items when expanding condition lists
when expanding the source list we can't attach
added reduce cond set, the condition equivalent of the reduced trans set
include the outConds in the comparison of RedTransAp
some work on constructing the condition list inside a transition