little more javadocs