Extended readme and updated comments.

Collection of small updates, most comments. And extended readme.