Documentation formatting improvements, light refactoring.

[mralexgray]

Hope you don't mind these changes. Great utility, these are all simply efforts to make it easier to read/comprehend/use. Tests are passing with flying colors.