javadoc: further documentaion…