minor doc fix
rework the bind function, more doc, unit tests failing
bind is now more robust, all tests passing