Code formatting tweaks.
Notes about case.
Improved usage documentation.
Fixed indenting.
Added more context to what is returned.
Added parameter names.