more javadoc for the binding api