Github user anmolnar commented on the issue: https://github.com/apache/zookeeper/pull/582 Thanks @eolivelli . It makes perfect sense to me now. Adding more docs (especially javadoc in this case) is always a good idea. Copying the above description to javadoc is sufficient I believe. I'm happy to commit once you're ready and have a green build.
---