even more javadocs