README small fixes.
TODO added.
New tests, improimproved invalid parameter handling and improved documentation.