Improvements in Zookeeper Consumer

* Correct behaviour during consumer rebalancing
* Correct behaviour for minor APIs like close(), pending(), seek() etc.
* Improved documentation