more fixes and feature addition based on golang-nuts comments. Improved tests and docs with examples