missing returns on err
examples/docs using hooks
simplify, env is private to iteration
add all.iterCtx a private user storage obj

all.iterCtx = {} and is private for each iteration which
makes it easy to save state and retrieve for later operations.
0.6.0