Improve comments and method names. Also add new convenient method.
Clarify readme.