Added to doctoring about what a couple of functions return.

Test coverage is at 66%.