Re-sequenced the function descriptions so that the formatting is described
before the assumption is made that the reader has a clue about the formatting.
Moved examples to be closer to the functions being demonstrated.
Added example of saferepr() result.