Improve docs, and make the variable names consistent

Expanded most of the documentation, and renamed some of the variables
so that variables that are mutated are (almost) always called dst.
LogSpan returns the modified dst slice to allow for "range  LogSpan(dst, l, u)". Maybe move the code example into a box?