Minor doc cleanups, test cases updates and fixes #17

Closed camros closed 8 years ago